{"_id":"@dspedorco/a2htrans","_rev":"7-ee8c2bce16d0459ad402c0d581287f5b","name":"@dspedorco/a2htrans","dist-tags":{"latest":"0.1.6"},"versions":{"0.1.2":{"name":"@dspedorco/a2htrans","version":"0.1.2","keywords":["a2htrans","harmonyos","android","skill","claude-code","cursor","opencode","codex"],"license":"MIT","_id":"@dspedorco/a2htrans@0.1.2","maintainers":[{"name":"dspedor","email":"2497052937@qq.com"}],"bin":{"hm":"dist/cli/index.js","a2htrans":"dist/cli/index.js"},"dist":{"shasum":"76fef8f4ebb3c746e27a1a6669a09650af75871d","tarball":"https://registry.npmjs.org/@dspedorco/a2htrans/-/a2htrans-0.1.2.tgz","fileCount":50,"integrity":"sha512-/nYbqBrI/2xL6bWz6qT2n5g5tIqsW7z1AKS5XhZms0l0WwgRv2BnwNNsspcn+V9P+GSjTaLATF2kna67SHz3zw==","signatures":[{"sig":"MEYCIQDYQGMaY0FdTz7bFPIiNwy5PLDvKS3hS+f/1y6Iz4F3uQIhAJVcG+Vfz1llvkeSl7e4VL82XmEr8qbuMipY5wmtHAew","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":687661},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"2a3852502da0126545b754d9473388c5b33ec882","scripts":{"dev":"tsx src/cli/index.ts","build":"node scripts/build.js","prepack":"node scripts/build.js","prepare":"node scripts/build.js"},"_npmUser":{"name":"dspedor","email":"2497052937@qq.com"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.","_npmVersion":"10.8.2","description":"A2HTrans (Android-to-HarmonyOS) skill + agent installer. Run `hm setup` to distribute conversion skills and subagents into Claude Code, Cursor, OpenCode, and Codex.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"commander":"^14.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","typescript":"^5.4.5","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/a2htrans_0.1.2_1779092748742_0.3052142524953967","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@dspedorco/a2htrans","version":"0.1.3","keywords":["a2htrans","harmonyos","android","skill","claude-code","cursor","opencode","codex","mcp"],"license":"MIT","_id":"@dspedorco/a2htrans@0.1.3","maintainers":[{"name":"dspedor","email":"2497052937@qq.com"}],"bin":{"hm":"dist/cli/index.js","a2htrans":"dist/cli/index.js"},"dist":{"shasum":"d13a3e8744e43955c56221f2af912f23ccccea95","tarball":"https://registry.npmjs.org/@dspedorco/a2htrans/-/a2htrans-0.1.3.tgz","fileCount":55,"integrity":"sha512-pRqyHj4xEYZdwQz4Zj3HLNwy22ongKm7VtFiMoBYOEEOP1LJp1u0Wj+3Kccvi8fCy3Jvq8Ozzzg7eshxlQNT9g==","signatures":[{"sig":"MEUCIQDTNcp2hospnKF+k8lNTVUIIXNHGIGg8irptuFcAejoPwIgR3Q94HGjiMe/qbfGi8A61ppEJWgQNY9S9WNfAunqUw4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":729760},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"8cc950d7bdf553593503d58d9f788959af56f747","scripts":{"dev":"tsx src/cli/index.ts","build":"node scripts/build.js","prepack":"node scripts/build.js","prepare":"node scripts/build.js"},"_npmUser":{"name":"dspedor","email":"2497052937@qq.com"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.","_npmVersion":"10.8.2","description":"A2HTrans (Android-to-HarmonyOS) skill + agent installer. Run `hm setup` to distribute conversion skills and subagents into Claude Code, Cursor, OpenCode, and Codex.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"fs-extra":"11.3.0","commander":"^14.0.0","simple-git":"^3.25.0","arkanalyzer":"^1.0.19","jsonc-parser":"^3.3.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","esbuild":"^0.28.0","typescript":"^5.4.5","@types/node":"^22.0.0","@types/fs-extra":"^9.0.13"},"_npmOperationalInternal":{"tmp":"tmp/a2htrans_0.1.3_1779348338042_0.8141959478121013","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@dspedorco/a2htrans","version":"0.1.4","keywords":["a2htrans","harmonyos","android","skill","claude-code","cursor","opencode","codex","mcp"],"license":"MIT","_id":"@dspedorco/a2htrans@0.1.4","maintainers":[{"name":"dspedor","email":"2497052937@qq.com"}],"bin":{"hm":"dist/cli/index.js","a2htrans":"dist/cli/index.js"},"dist":{"shasum":"08f306fd7a19af887b6f01f661205de02540bc1c","tarball":"https://registry.npmjs.org/@dspedorco/a2htrans/-/a2htrans-0.1.4.tgz","fileCount":55,"integrity":"sha512-Hl50tR1zVMwm/pf6QvifbakxrVt8PmSGEQ5IsXfSBUSPP8DtJkQrQVwapatkR1fASQ6KFevGzrtaJBZgkmaQ3w==","signatures":[{"sig":"MEUCIAXPgA7iYiYtQ/BOSykCMIz7J8rFocx1jBygMkjxius2AiEA7Z0/ATmfqamtrnRyUjL6RDSm67kJ5LeoQdlTswbTlvw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":729807},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"1154540600ad0efddd71cd9d08c0d2baae0812e3","scripts":{"dev":"tsx src/cli/index.ts","build":"node scripts/build.js","prepack":"node scripts/build.js","prepare":"node scripts/build.js"},"_npmUser":{"name":"dspedor","email":"2497052937@qq.com"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.","_npmVersion":"10.8.2","description":"A2HTrans (Android-to-HarmonyOS) skill + agent installer. Run `hm setup` to distribute conversion skills and subagents into Claude Code, Cursor, OpenCode, and Codex.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"fs-extra":"11.3.0","commander":"^14.0.0","simple-git":"^3.25.0","arkanalyzer":"^1.0.19","jsonc-parser":"^3.3.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","esbuild":"^0.28.0","typescript":"^5.4.5","@types/node":"^22.0.0","@types/fs-extra":"^9.0.13"},"_npmOperationalInternal":{"tmp":"tmp/a2htrans_0.1.4_1779351736867_0.3479163216237873","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@dspedorco/a2htrans","version":"0.1.5","keywords":["a2htrans","harmonyos","android","skill","claude-code","cursor","opencode","codex","mcp"],"license":"MIT","_id":"@dspedorco/a2htrans@0.1.5","maintainers":[{"name":"dspedor","email":"2497052937@qq.com"}],"bin":{"hm":"dist/cli/index.js","a2htrans":"dist/cli/index.js"},"dist":{"shasum":"2cfcd590b71ad11f6746969b0bca8c1da72f6b2c","tarball":"https://registry.npmjs.org/@dspedorco/a2htrans/-/a2htrans-0.1.5.tgz","fileCount":55,"integrity":"sha512-xX5CpyC4lokrE+VivcehH0vFzEUnvZVEDZxNlaHK5RsbeQeGtANozdOUsTDjc7XW53KUTw87okqsDKaViBMkOw==","signatures":[{"sig":"MEYCIQD8DsO+18axTSitDa201aqU1LiqrxfEfhyI4VYl3b157QIhAJK+xGkKuvC7AnTXcYs5QSRLt7YiLPLr/hcG4O7xOtNT","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":729685},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"dbed56f95cad162cb2f69cba6145f19b099a736e","scripts":{"dev":"tsx src/cli/index.ts","build":"node scripts/build.js","prepack":"node scripts/build.js","prepare":"node scripts/build.js"},"_npmUser":{"name":"dspedor","email":"2497052937@qq.com"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.","_npmVersion":"10.8.2","description":"A2HTrans (Android-to-HarmonyOS) skill + agent installer. Run `hm setup` to distribute conversion skills and subagents into Claude Code, Cursor, OpenCode, and Codex.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"fs-extra":"11.3.0","commander":"^14.0.0","simple-git":"^3.25.0","arkanalyzer":"^1.0.19","jsonc-parser":"^3.3.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","esbuild":"^0.28.0","typescript":"^5.4.5","@types/node":"^22.0.0","@types/fs-extra":"^9.0.13"},"_npmOperationalInternal":{"tmp":"tmp/a2htrans_0.1.5_1779352490932_0.49656390351363267","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@dspedorco/a2htrans","version":"0.1.6","keywords":["a2htrans","harmonyos","android","skill","claude-code","cursor","opencode","codex","mcp"],"license":"MIT","_id":"@dspedorco/a2htrans@0.1.6","maintainers":[{"name":"dspedor","email":"2497052937@qq.com"}],"bin":{"hm":"dist/cli/index.js","a2htrans":"dist/cli/index.js"},"dist":{"shasum":"31ce42e1de9e65c5ed24730166d97faa36cd4d3b","tarball":"https://registry.npmjs.org/@dspedorco/a2htrans/-/a2htrans-0.1.6.tgz","fileCount":57,"integrity":"sha512-OF+CZDjH23wSQ0uH6MUyQ7or4cAkwASPrG8UHcJrvf6UbnQt9lJHIq8Yu2kJYNSGOnzwoqiMS82AC5FoOdQVfQ==","signatures":[{"sig":"MEQCIB7oAyIU7knZsFgImZ3hinkRAQ0yOVA3VbaNRHi8MaJaAiAE+xxRokP0Qtv0H5Zx4t3+kStiKmDlw+INxyE+lINrdw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":734014},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"6f4311900fad03989e86aefe5f33735ca2c55ccc","scripts":{"dev":"tsx src/cli/index.ts","build":"node scripts/build.js","prepack":"node scripts/build.js","prepare":"node scripts/build.js"},"_npmUser":{"name":"dspedor","email":"2497052937@qq.com"},"deprecated":"Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.","_npmVersion":"10.8.2","description":"A2HTrans (Android-to-HarmonyOS) skill + agent installer. Run `hm setup` to distribute conversion skills and subagents into Claude Code, Cursor, OpenCode, and Codex.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"fs-extra":"11.3.0","commander":"^14.0.0","simple-git":"^3.25.0","arkanalyzer":"^1.0.19","jsonc-parser":"^3.3.1","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","esbuild":"^0.28.0","typescript":"^5.4.5","@types/node":"^22.0.0","@types/fs-extra":"^9.0.13"},"_npmOperationalInternal":{"tmp":"tmp/a2htrans_0.1.6_1779353745333_0.19445862944815517","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-05-18T08:25:48.625Z","modified":"2026-05-26T10:30:30.976Z","0.1.2":"2026-05-18T08:25:48.882Z","0.1.3":"2026-05-21T07:25:38.213Z","0.1.4":"2026-05-21T08:22:17.033Z","0.1.5":"2026-05-21T08:34:51.171Z","0.1.6":"2026-05-21T08:55:45.550Z"},"license":"MIT","keywords":["a2htrans","harmonyos","android","skill","claude-code","cursor","opencode","codex","mcp"],"description":"A2HTrans (Android-to-HarmonyOS) skill + agent installer. Run `hm setup` to distribute conversion skills and subagents into Claude Code, Cursor, OpenCode, and Codex.","maintainers":[{"email":"support@npmjs.com","name":"npm-support"}],"readme":"# a2htrans\n\n> Skill + agent installer for the **A2HTrans** Android-to-HarmonyOS conversion toolkit. One command (`hm setup`) distributes **13 skills** and **20 subagents** (plus their associated script bundles) into Claude Code, Cursor, OpenCode, and Codex.\n\nThe skills and agents are converted from the upstream [`android-harmonyos-converter`](https://github.com/) Claude Code plugin so they can be installed cross-editor via npm.\n\n---\n\n## Install\n\nGlobal install — exposes both `a2htrans` and the short alias `hm` on `PATH`:\n\n```bash\nnpm install -g a2htrans\nhm setup\n```\n\nOne-shot via `npx` (no global install required):\n\n```bash\nnpx a2htrans setup\n# or\nnpx hm setup\n```\n\nRequires Node.js **≥ 18**.\n\n---\n\n## What `hm setup` does\n\n1. **Detects** each supported editor by checking whether its standard config directory exists under `$HOME`.\n2. For every editor that exists, **copies**:\n - every skill folder under `skills/` → `/skills//` (recursive — preserves `references/`, `tools/`, etc.)\n - every agent under `agents/` → `/agents/` (recursive — preserves sibling `/scripts/` and `config/` subtrees)\n3. Editors whose marker directory is missing are reported as **`skipped`** — nothing is written for them.\n4. The install is **idempotent** — re-running overwrites the same files with the latest bundled content. It never touches existing files under `/skills/` or `/agents/` that don't share a name with a bundled item, so other tools' skills are left alone.\n\n### Target directories\n\n| Editor | Marker | Skills target | Agents target |\n| ------------ | ----------------------- | ---------------------------------- | -------------------------------- |\n| Claude Code | `~/.claude/` | `~/.claude/skills/` | `~/.claude/agents/` |\n| Cursor | `~/.cursor/` | `~/.cursor/skills/` | `~/.cursor/agents/` |\n| OpenCode | `~/.config/opencode/` | `~/.config/opencode/skills/` | `~/.config/opencode/agents/` |\n| Codex | `~/.codex/` | `~/.agents/skills/` | `~/.codex/agents/` |\n\n> Codex deliberately uses two roots: the shared Agent-Skills convention `~/.agents/skills/` for skills, and the editor-scoped `~/.codex/agents/` for subagent definitions.\n\n### Example output\n\n```\n A2HTrans Setup\n ===============\n\n Configured:\n + Claude Code skills (13 → ~/.claude/skills)\n + Claude Code agents (20 → ~/.claude/agents)\n + Cursor skills (13 → ~/.cursor/skills)\n + Cursor agents (20 → ~/.cursor/agents)\n\n Skipped:\n - OpenCode (not installed)\n - Codex (not installed)\n\n Source skills: /usr/local/lib/node_modules/a2htrans/skills\n Source agents: /usr/local/lib/node_modules/a2htrans/agents\n\n Done. Re-open your editor for the new skills/agents to be picked up.\n```\n\n---\n\n## Skills shipped (13)\n\nListed roughly in pipeline order:\n\n| Skill | Purpose |\n| ---------------------------------- | ------------------------------------------------------------- |\n| `a2htrans-requirements-analysis` | Analyze Android project → `requirements-analysis.md` |\n| `a2htrans-architecture-design` | Requirements → `feature.md` HarmonyOS architecture blueprint |\n| `a2htrans-spec-generate` | `.txt` requirement folder → per-requirement spec markdown |\n| `a2htrans-ui-dev` | Full Android → HarmonyOS UI migration pipeline (6 phases) |\n| `a2htrans-logic-dev` | Implement HarmonyOS ArkTS logic from a spec document |\n| `a2htrans-build` | Build HarmonyOS project (signed/unsigned), produce `.hap` |\n| `a2htrans-code-review` | Per-scenario review of HarmonyOS code at a commit |\n| `a2htrans-fix` | Auto-dispatch fixer (build / self-test / review / general) |\n| `a2htrans-self-test` | On-device functional verification of a HAP via AutoTest |\n| `a2htrans-integration-test` | End-to-end integration test of the built app |\n| `a2htrans-dev-pipeline` | Full 11-agent Android → HarmonyOS conversion pipeline |\n| `a2htrans-human-ai-fix` | Collaborative fix with `[Human-AI]` audit-trail commit |\n| `a2htrans-tool-setup` | Interactively populate `converter-config.json` tool paths |\n\nEach skill is a directory of the form `skills//SKILL.md`, with frontmatter `name` + trigger `description` so agentic editors can match them against user requests.\n\n> ⚠️ `a2htrans-tool-setup` configures **the converter's tool paths** (DevEco Studio, Harmony SDK, Node, Python). It is **not** the same as the `hm setup` CLI command (which installs skills + agents into editors).\n\n---\n\n## Agents shipped (20 + 2 script bundles)\n\nFlat `.md` files in `agents/`, two of which (`logic-coding`, `logic-developer-v6`) have sibling script directories with helper Python scripts (DeepWiki query, codelinter, wave-verification, error recording, etc.):\n\n`architecture-designer`, `build-engineer`, `build-fixer`, `code-reviewer`, `integration-tester`, `logic-coding` (+ `scripts/`: platform context query, DeepWiki, codelinter), `logic-coding-minimal`, `logic-context-builder`, `logic-context-builder-minimal`, `logic-developer`, `logic-developer-v6` (+ `scripts/`: project index builder, wave verification, error ledger, codelinter, DeepWiki tests), `requirements-analyst`, `review-fixer`, `self-test-fixer`, `self-test-setup`, `self-tester`, `self-tester-zwk`, `spec-generator`, `ui-developer`, `ui-developer-analysis`.\n\n---\n\n## Commands\n\n```bash\nhm setup # install skills + agents into detected editors\nhm --version # show installed version\nhm --help # list commands\n\n# `a2htrans` works identically — both aliases point to the same CLI:\na2htrans setup\na2htrans --help\n```\n\n---\n\n## Development\n\n```bash\n# 1. Install dev deps (commander, tsx, typescript). The `prepare` hook\n# automatically runs the build, so `dist/` is ready right after this.\nnpm install\n\n# 2. Run the CLI from source (TypeScript via tsx — no rebuild needed):\nnpm run dev -- setup\n\n# 3. Production build (writes dist/cli/*.js, chmod +x on the entry):\nnpm run build\n\n# 4. Inspect the would-be npm tarball without publishing:\nnpm pack --dry-run\n```\n\n### Repo layout\n\n```\na2htrans/\n├── package.json # bin: { a2htrans, hm }, files: [dist, skills, agents]\n├── tsconfig.json\n├── scripts/build.js # tsc + chmod +x dist/cli/index.js\n├── src/cli/\n│ ├── index.ts # commander entry, registers `setup`\n│ └── setup.ts # editor detection + installSkillsTo / installAgentsTo\n├── skills/ # 13 skill folders, each with SKILL.md\n└── agents/ # 20 .md agent files + 2 script bundles\n```\n\n### Publishing checklist\n\n1. Bump `version` in `package.json`.\n2. `npm pack --dry-run` — confirm `dist/` + `skills/` + `agents/` are included and the total file count matches expectations.\n3. `npm publish` (after `npm login`).\n\n---\n\n## License\n\nThe CLI shell (`src/`, `scripts/`, `package.json`, `README.md`) is **MIT**.\n\nThe bundled skill and agent content under `skills/` and `agents/` is sourced from the upstream **android-harmonyos-converter** Claude Code plugin and is redistributed under its respective licence. Refer to the upstream project for the canonical license terms.\n","readmeFilename":"README.md"}