@actiondock/cli 2.0.9 → 2.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/README.md +17 -0
  2. package/dist/index.js +45803 -35787
  3. package/package.json +7 -7
  4. package/src/commands/action/create.ts +129 -0
  5. package/src/commands/action/index.ts +27 -0
  6. package/src/commands/action/list.ts +247 -0
  7. package/src/commands/action/run.ts +197 -0
  8. package/src/commands/action/show.ts +128 -0
  9. package/src/commands/action/sync.ts +76 -0
  10. package/src/commands/action/validate.ts +102 -0
  11. package/src/commands/action.ts +1 -633
  12. package/src/commands/build.ts +19 -17
  13. package/src/commands/config.ts +168 -69
  14. package/src/commands/doctor.ts +44 -42
  15. package/src/commands/export.ts +9 -9
  16. package/src/commands/index.ts +33 -1
  17. package/src/commands/info.ts +93 -74
  18. package/src/commands/init.ts +2 -2
  19. package/src/commands/link.ts +3 -4
  20. package/src/commands/mcp.ts +6 -10
  21. package/src/commands/playbook.ts +289 -161
  22. package/src/commands/profile.ts +125 -92
  23. package/src/commands/runs.ts +92 -49
  24. package/src/commands/serve.ts +3 -4
  25. package/src/commands/state.ts +145 -64
  26. package/src/commands/test.ts +1 -1
  27. package/src/index.ts +39 -3
  28. package/src/utils/bytes.ts +1 -35
  29. package/src/utils/filter.ts +2 -24
package/README.md CHANGED
@@ -71,6 +71,23 @@ ad build
71
71
 
72
72
  ---
73
73
 
74
+ ## 通用选项与机器调用契约
75
+
76
+ 所有 CLI 子命令均支持前置或后置传入通用控制选项：
77
+
78
+ - `-v, -V, --version`：打印版本号并以状态码 0 退出。
79
+ - `-h, --help`：打印命令帮助并退出。
80
+ - `--json`：以标准 JSON 格式输出结果。
81
+ - `--envelope`：将输出包装为标准信封结构对象（包含 `ok: true, data: T` 或 `ok: false, error: { code, message, details }`）。
82
+ - `--data-dir <path>`：指定自定义数据存储目录，实现多测试或多任务数据隔离。
83
+
84
+ ### 精确目标解析机制
85
+
86
+ - **严格目标定位**：通过 `-P, --package <id|path>` 指定目标包。系统严格区分物理路径与注册表包标识符，若目标不存在则坚决不向当前目录或父级目录隐式回退，直接以参数校验错误退出（状态码 2）。
87
+ - **多目标检索契约**：在执行多目标检索（如 `ad info [keywords]` 或 `ad action list [keywords]`）时，若无任何匹配项，在机器模式下始终返回确定性空数组结构并以状态码 0 退出，绝不因空搜索产生异常中断。
88
+
89
+ ---
90
+
74
91
  ## 常用命令速查
75
92
 
76
93
  | 命令 | 说明 |