@aipt/cli 0.1.26 → 0.1.30

package/README.md

@@ -13,7 +13,7 @@ Dyyto Engineering Platform 的正式命令行 Composition Root。CLI 负责工
 `C:\Users\<用户名>\Desktop\works\sources`。注意命令中必须输入半角 ASCII `~`，不能输入中文全角“～”。
 
 ```bash
-corepack pnpm dlx @aipt/idp-setup@0.1.3 init \
+corepack pnpm dlx @aipt/idp-setup@0.1.4 init \
   --root ~/Desktop/works/sources
 
 source ~/Desktop/works/sources/config/idp/generated/sources.env
@@ -26,12 +26,9 @@ idp-setup doctor --root ~/Desktop/works/sources
 
 ```bash
 idp-setup bootstrap --project /absolute/workspace-or-project
-
-dyyto context --project /absolute/workspace-or-project
-dyyto doctor --project /absolute/workspace-or-project
 ```
 
-Bootstrap 安装并锁定精确 `dyyto`、`idp`、`idpctl` 版本，并生成 Codex、Claude Code、Cursor 与 Antigravity 的薄 Agent 入口。安装完成后只使用 npm package 声明的 bin：
+Bootstrap 安装并锁定精确 `dyyto`、`idp`、`idpctl` 版本，生成 Codex、Claude Code、Cursor 与 Antigravity 的薄 Agent 入口，并统一完成上下文、配置与 Doctor 就绪检查。安装完成后只使用 npm package 声明的 bin：
 
 ```bash
 dyyto --version --json
@@ -197,6 +194,32 @@ corepack pnpm add --ignore-scripts /absolute/path/to/aipt-cli-<version>.tgz
 
 ## 6. Package 流程
 
+发布必须使用 `idp-setup` 初始化并加载的外部 `IDP_CONFIG_DIR`，Registry URL 与 Token
+不得通过命令行传入。私有凭据读取 `components/dyyto/.env` 中的 `DYYTO_NPMRC_FILE`，
+公共凭据读取 `secrets/npm-public/npmrc`。
+
+```bash
+source "$IDP_CONFIG_DIR/generated/sources.env"
+
+dyyto package publish plan \
+  --package-dir ./packages/example \
+  --target all \
+  --json
+
+dyyto package publish apply \
+  --package-dir ./packages/example \
+  --approve 'sha256:<完整Plan ID>' \
+  --json
+
+dyyto package publish inspect \
+  --package-dir ./packages/example \
+  --plan 'sha256:<完整Plan ID>' \
+  --json
+```
+
+`plan` 只生成按摘要寻址的 tarball 与不可变 Plan；`apply` 重新验证 `package.json`
+Preimage、tarball digest 和远程冲突后才发布；`inspect` 只读核对两个 Registry。
+
 创建独立 npm 包：
 
 ```bash
@@ -263,6 +286,18 @@ Web Application 锁定 React 19、Vite 8 和 TypeScript 6 的精确版本。Veri
 
 本地 Application 配置先通过 `idpctl app config-init` 物化到 `$APP_CONFIG_DIR`，然后再生成和应用部署 Plan：
 
+只读检查应优先使用正式 Readiness 命令；它在配置尚未完成时仍返回结构化状态，不创建目录或 Secret：
+
+```bash
+export APP_CONFIG_DIR=/absolute/config/app
+dyyto config readiness --project /absolute/workspace/apps/api --json
+dyyto config readiness --workspace /absolute/workspace --json
+dyyto config readiness --workspace /absolute/workspace --check --json
+dyyto config inspect --project /absolute/workspace/apps/api --json
+```
+
+`readiness` 用于判断 `not-declared | missing | incomplete | ready | invalid`；工作区模式按 `pnpm-workspace.yaml` 和每个 Unit Manifest 稳定发现全部 Application，单项失败不阻断其他结果。`--check` 在全部就绪时退出 0，存在待配置项时退出 3，存在无效配置时退出 4。`inspect` 是严格投影，配置不完整时以非零状态退出。`.env.example` 只用于未迁移历史项目的兼容维护提示，不是正式配置事实源。
+
 ```bash
 idpctl app config-init \
   --project /absolute/workspace/apps/api \