{"_id":"@atom-workflow-agent/cli","name":"@atom-workflow-agent/cli","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.1":{"name":"@atom-workflow-agent/cli","version":"0.1.1","description":"Command-line composition root for Atom Workflow Agent.","license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/joekbits/atom-workflow-agent.git","directory":"apps/cli"},"homepage":"https://github.com/joekbits/atom-workflow-agent/tree/main/apps/cli#readme","bugs":{"url":"https://github.com/joekbits/atom-workflow-agent/issues"},"keywords":["agent","atom","workflow","cli"],"type":"module","exports":{".":{"types":"./dist/app.d.ts","default":"./dist/app.js"},"./cli":"./dist/index.js"},"bin":{"atomflow":"dist/index.js"},"publishConfig":{"access":"public","provenance":true},"engines":{"node":">=22"},"dependencies":{"@atom-workflow-agent/atom-catalog":"0.1.0","@atom-workflow-agent/acp-provider":"0.1.0","@atom-workflow-agent/contracts":"0.1.0","@atom-workflow-agent/atom-sdk":"0.1.0","@atom-workflow-agent/select-atom":"1.0.0","@atom-workflow-agent/workflow-engine":"0.1.0","@atom-workflow-agent/workflow-compiler":"0.1.0","@atom-workflow-agent/acp-sdk":"0.1.0","@atom-workflow-agent/atom-executor":"0.1.0","@atom-workflow-agent/workflow-ui":"0.1.0","@atom-workflow-agent/workflow-planner":"0.1.0","@atom-workflow-agent/workflow-inspector":"0.1.0"},"scripts":{"build":"tsc -p tsconfig.json","typecheck":"tsc -p tsconfig.json --noEmit","test":"vitest run","dev":"pnpm run build && node dist/index.js","start":"node dist/index.js"},"_id":"@atom-workflow-agent/cli@0.1.1","_integrity":"sha512-mOEVWWsceWWFumnp1SYkoK29kvq6OfR90aEauVi0nPXN+x5VCMfN2muaHCkGLV/E/SwbTmrBeUNeTYZSVqalBg==","_resolved":"/private/tmp/atomflow-npm-release-20260902-1720/atom-workflow-agent-cli-0.1.1.tgz","_from":"file:/private/tmp/atomflow-npm-release-20260902-1720/atom-workflow-agent-cli-0.1.1.tgz","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-mOEVWWsceWWFumnp1SYkoK29kvq6OfR90aEauVi0nPXN+x5VCMfN2muaHCkGLV/E/SwbTmrBeUNeTYZSVqalBg==","shasum":"0ea37c20e8e3a0b605a19cd6cae4a4ad9427f810","tarball":"https://registry.npmjs.org/@atom-workflow-agent/cli/-/cli-0.1.1.tgz","fileCount":96,"unpackedSize":460622,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIFKCwKYf97F8PRtB4z35XITA0XfV0TngbsR4f5yi2/wLAiA8+JD2uPeDN5VgLfvkM7NQYZ9xutmibClWratZJScSHA=="}]},"_npmUser":{"name":"joekbits","email":"wangfeihong868@foxmail.com"},"directories":{},"maintainers":[{"name":"joekbits","email":"wangfeihong868@foxmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cli_0.1.1_1788342363808_0.7853413068280535"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-02T09:46:03.627Z","0.1.1":"2026-09-02T09:46:03.969Z","modified":"2026-09-02T09:46:04.235Z"},"maintainers":[{"name":"joekbits","email":"wangfeihong868@foxmail.com"}],"description":"Command-line composition root for Atom Workflow Agent.","homepage":"https://github.com/joekbits/atom-workflow-agent/tree/main/apps/cli#readme","keywords":["agent","atom","workflow","cli"],"repository":{"type":"git","url":"git+https://github.com/joekbits/atom-workflow-agent.git","directory":"apps/cli"},"bugs":{"url":"https://github.com/joekbits/atom-workflow-agent/issues"},"license":"Apache-2.0","readme":"# `@atom-workflow-agent/cli`\n\n[English](README.md) | [简体中文](README.zh-CN.md)\n\nCLI 是本地应用的组合根，也是用户、Host Skill 和自动化共用的稳定机器协议。\n\n## 适用场景\n\n- 发现 Atom 并独立运行；\n- 初始化本地项目并生成带 fixture 的 Atom Package；\n- 规划、校验、保存、验证和执行 Workflow Revision；\n- 查看、跟随、暂停、恢复、重试和取消 Run；\n- 探测 Codex/Trae ACP Provider 与模型；\n- 启动本地只读 Inspector。\n\n先通过 `npm install --global @atom-workflow-agent/cli` 安装用户入口，再运行 `atomflow --help` 查看权威命令列表。常用入口：\n\n```bash\natomflow project init\natomflow atom create --id <namespace.name>\natomflow atom check --atom <id@version>\natomflow atom dev --atom <id@version> --fixture <file>\natomflow workflow validate --file <workflow.json>\natomflow workflow save --file <workflow.json> --source host\natomflow workflow graph --workflow <名称>\natomflow workflow run --workflow <名称@版本> --input '<json>'\natomflow run diagnose --run-id <run-id>\n```\n\n## 输出协议\n\n- stdout 只输出一个带版本的 JSON 结果信封；\n- 进度和诊断写入 stderr；\n- `--quiet` 会隐藏非错误进度；\n- 支持 `-` 的文件参数会从 stdin 读取 JSON；\n- 取消操作退出码为 `130`，用法错误退出码为 `2`。\n\n调用方不应解析人类可读的进度文本，应使用 JSON 信封、持久化 ID 和明确的后续命令。\n\n## 维护者指南\n\n以下内容面向在 Monorepo 中开发的贡献者。\n\n- `src/app.ts` 负责顶层参数分发和帮助文本；\n- `src/local/local-project-service.ts` 负责幂等初始化、Atom 脚手架、状态占用统计和安全清理预览；\n- `src/workflow/workflow-command.ts` 负责命令分发，分域服务契约位于 `workflow-command-service.ts`；\n- `workflow-command-input.ts` 负责 JSON/stdin 参数解析，`workflow-command-progress.ts` 负责人类可读的 stderr 进度；\n- `src/workflow/workflow-project-config.ts` 只负责项目配置与默认 Planner 模型解析；\n- `src/workflow/planning-cli-service.ts` 是 Planner 工具子进程的 Catalog/Workspace 小服务，不创建 Runtime；\n- `src/providers/acp-planning-model-adapter.ts` 将 ACP 适配为 Planner 的通用模型端口；\n- Provider 诊断位于 `src/commands/` 和 `src/providers/`；\n- 新命令必须在 `tests/` 增加 CLI 测试，包括 stdout/stderr 和退出码断言。\n\nCLI 只组合底层 Package，不应实现领域 Atom 行为，也不应复制 Compiler 或 Engine 规则。\n\n```bash\npnpm --filter @atom-workflow-agent/cli typecheck\npnpm --filter @atom-workflow-agent/cli test\n```\n\n完整流程见 [CLI 参考](../../docs/cli.zh-CN.md)，包边界见[架构文档](../../docs/architecture.zh-CN.md)。\n","readmeFilename":"README.zh-CN.md","_rev":"1-840885bf0fd7b7c40ed290e7625524ab"}