@aipt/idp-cli 0.1.1 → 0.1.2

package/bin/idp.mjs

@@ -6,6 +6,7 @@ import { spawnSync } from 'node:child_process';
 
 const repoRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
 const spacesRoot = resolve(repoRoot, '..');
+const cliVersion = JSON.parse(await import('node:fs/promises').then(({ readFile }) => readFile(resolve(repoRoot, 'package.json'), 'utf8'))).version;
 
 function executable(path) {
   try { accessSync(path, constants.X_OK); return true; } catch { return false; }
@@ -101,6 +102,7 @@ function help() {
 
 try {
   const { cwd, json, rest } = parseGlobal(process.argv.slice(2));
+  if (rest[0] === '--version' || rest[0] === 'version') { console.log(json ? JSON.stringify({ schemaVersion: 1, command: 'version', version: cliVersion }) : cliVersion); process.exit(0); }
   if (rest.length === 0 || rest[0] === '--help' || rest[0] === 'help') { help(); process.exit(0); }
   const [group, action, ...args] = rest;
   let status;

package/docs/command-reference.md

@@ -0,0 +1,10 @@
+# IDP CLI 命令入口
+
+`idp` 是薄门面，不复制 Dyyto Kernel 或 idp-deploy Kernel 的实现。
+
+- `idp --version --json`：显示当前门面版本及可执行路径。
+- `idp doctor --cwd <项目路径>`：检查开发和交付 Kernel。
+- 工程采用、Catalog、Plan/Apply/Verify 委托给 `dyyto`。
+- Config Dir、本地 Docker、镜像与私有化交付委托给 `idpctl`。
+
+项目必须使用 Bootstrap 产生的工具链锁，禁止依靠任意全局最新版形成不可复现行为。

package/docs/features/cli-package-distribution/DESIGN.md

@@ -0,0 +1,6 @@
+# IDP CLI 双 Registry 包发布设计
+
+- 状态：approved
+- 批准依据：用户明确要求将 `idp`、`idpctl`、`dyyto` 等工程 CLI 发布到私有与公开 npm Registry。
+
+`@aipt/idp-cli` 是薄入口包，只包含 `bin/idp.mjs` 与 README，不复制 Dyyto Kernel 或 idp-deploy。发布前必须运行测试、审计 tarball，发布后分别从两个 Registry 回读版本并在仓库外临时目录执行 `idp --help`。同一版本已存在但摘要不同则停止，不覆盖或 unpublish。

package/docs/features/developer-cli/DESIGN.md

@@ -0,0 +1,48 @@
+# 开发者统一 CLI DESIGN
+
+状态：approved  
+批准依据：用户于 2026-09-01 确认三环境、三层 CLI 总体方案并授权实现。
+
+## 目标
+
+提供 `idp` 薄门面，让开发者发现上下文、获得中文反馈，并显式委托两个既有 Kernel：
+
+- `dyyto`：工程脚手架、能力采用、开发与验证；
+- `idpctl`：交付、环境、GitOps 与部署运维。
+
+本地没有 Kubernetes、ACK、ACR、KMS、SLS 或 ARMS 时，工程创建、检查和能力操作仍可进行。只有委托的具体部署动作自行检查其前置条件。
+
+## 公共契约
+
+| 入口 | 委托 |
+| --- | --- |
+| `idp doctor` | 只读发现 Git、Dyyto、idpctl、kubectl 与当前工程；不连接或推断目标集群 |
+| `idp app create` | `dyyto create` |
+| `idp app inspect` | `dyyto inspect` |
+| `idp capability ...` | 参数原样委托 `dyyto ...` |
+| `idp delivery ...` | 参数原样委托 `idpctl ...` |
+| `idp environment ...` | 参数原样委托 `idpctl ...` |
+
+所有 `...` 都是 argv，不经 shell。`--cwd` 只由门面消费；`--json` 为门面 doctor 输出格式，其他命令原样传给 Kernel。
+
+## 上下文发现
+
+顺序固定：显式环境变量（`IDP_DYYTO_BIN`、`IDP_DEPLOY_BIN`）→ PATH 可执行文件 → 当前仓库同级标准目录。发现结果只决定可执行入口，不推断业务事实。
+
+## 失败与恢复
+
+- Kernel 缺失：在启动前失败并给出中文修复建议。
+- Kernel 非零退出：保留其 stdout、stderr 和退出码，不包装成成功。
+- 当前目录不存在：在启动前失败。
+- 委托中断：转发 SIGINT/SIGTERM，不产生中间状态。
+- 门面自身不写消费者仓库，因此无 Preimage；所有写入与恢复仍由 Kernel 负责。
+
+## 脚手架与人工验收
+
+`npm run example` 在 `.examples/delegation` 创建临时 fixture consumer，以契约 Kernel 验证 argv、cwd、退出码和无 Kubernetes 行为；结束可执行 `npm run example:clean` 清理。真实工程采用仍必须使用 Dyyto Catalog、Plan、Apply、Verifier 链路，门面不生成旁路模板。
+
+## 非目标
+
+- 不实现 Portal、AI Runtime 或产品领域能力；
+- 不实现 CI、Registry、GitOps 或 Kubernetes 控制器；
+- 不把不存在的 `build trigger` 等未来命令伪装成已完成能力。

package/documentation-manifest.json

@@ -1,9 +1,10 @@
 {
   "schemaVersion": 1,
   "package": "@aipt/idp-cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "documents": [
     { "id": "idp-integration", "path": "docs/integration.md", "digest": "sha256:ad16f812d516763140c14efe8a0afb275b420987d23e0d6071fbbb7312b7324c" },
-    { "id": "tool-delegation", "path": "docs/tool-delegation.md", "digest": "sha256:8dc76242bd21bfbd477609b1e3459e96fd092504bfe9e9b4b81db2d5391270a2" }
+    { "id": "tool-delegation", "path": "docs/tool-delegation.md", "digest": "sha256:8dc76242bd21bfbd477609b1e3459e96fd092504bfe9e9b4b81db2d5391270a2" },
+    { "id": "idp-command-reference", "path": "docs/command-reference.md", "digest": "sha256:cf523daf3bb9a6883c1c0f1c5b411aef49f42985ab101980df7b5213e6d44d4a" }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipt/idp-cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "IDP 开发者统一入口，委托 Dyyto 与 idp-deploy 执行工程和交付能力。",
   "type": "module",
   "bin": {
@@ -8,8 +8,7 @@
   },
   "files": [
     "bin",
-    "docs/integration.md",
-    "docs/tool-delegation.md",
+    "docs",
     "documentation-manifest.json",
     "README.md"
   ],