@aipt/cli 0.1.0 → 0.1.13

package/README.md

@@ -1,8 +1,101 @@
 # @aipt/cli
 
+`dyyto integrations --project <project>` 输出 Package、公共导入、代码资产、所有权、Lock/Evidence 和未纳管依赖；增加 `--json` 可保存完整审计清单。
+
 Dyyto Engineering Platform 的正式命令行 Composition Root。
 
-当前已实现稳定的 help、version、human/JSON renderer、错误退出码，以及正式 `create/plan/upgrade/apply/verify/inspect/recover`。领域规划、文件写入、验证提交与恢复必须委托给 `@aipt/platform-kernel`，不得在 CLI 内复制规则。
+CLI 是无服务入口，不包含 Portal 或在线 AI Runtime。人类与 vibe coding 代理通过同一个只读目录发现能力：
+
+```bash
+dyyto catalog search --query typescript --kind capability --json
+dyyto catalog show --ref package:@aipt/platform-kernel@0.1.0 --json
+dyyto mcp serve
+```
+
+MCP 使用 stdin/stdout JSON-RPC，公开 `dyyto_catalog_search` 与 `dyyto_catalog_show`，不监听端口、不读取业务数据、不执行 Catalog 中的代码。
+
+首个正式工程模板：
+
+```bash
+dyyto create ./my-library \
+  --template template.typescript-library@1.0.0 \
+  --name @scope/my-library --version 0.1.0 --license MIT \
+  --publish-access public \
+  --repository https://github.com/owner/my-library
+dyyto apply --project ./my-library --approve <planId>
+corepack pnpm --dir ./my-library install
+dyyto build --project ./my-library
+dyyto test --project ./my-library
+dyyto package --project ./my-library
+dyyto verify --project ./my-library
+```
+
+统一命令只执行 Template Release 白名单中的固定映射；不接受任意 executable、script 或参数。项目仍保留标准 pnpm scripts，脱离 Dyyto 也可正常开发。
+
+创建 React 组件库时只需更换模板；其余生命周期命令完全一致：
+
+```bash
+dyyto create ./my-components \
+  --template template.react-component-library@1.0.0 \
+  --name @scope/my-components --version 0.1.0 --license MIT \
+  --publish-access public \
+  --repository https://github.com/owner/my-components
+dyyto apply --project ./my-components --approve <planId>
+corepack pnpm --dir ./my-components install
+dyyto build --project ./my-components
+dyyto test --project ./my-components
+dyyto package --project ./my-components
+dyyto verify --project ./my-components
+```
+
+React 与 React DOM 以 peer dependency 接入，不打入组件库 bundle；产物包含 ESM、类型声明和显式 `./style.css` 出口。Storybook 不属于基础模板，后续以可增删的独立 Capability 接入。
+
+创建 Next.js 全栈应用时使用私有应用 identity；`dev` 保持前台运行，`test` 同时执行 Vitest 与 Playwright，`package` 生成可直接由 Node 启动的 standalone 目录：
+
+```bash
+dyyto create ./my-app \
+  --template template.nextjs-full-stack-application@1.0.0 \
+  --name my-app
+dyyto apply --project ./my-app --approve <planId>
+corepack pnpm --dir ./my-app install
+dyyto dev --project ./my-app
+dyyto build --project ./my-app
+dyyto test --project ./my-app
+dyyto package --project ./my-app
+dyyto verify --project ./my-app
+```
+
+基础模板固定为 App Router + Node runtime，不包含数据库、认证、Docker 或云部署配置。
+
+当前已实现稳定的 help、version、human/JSON renderer、错误退出码，以及正式 `create/plan/add feature/upgrade/apply/verify/inspect/recover`。领域规划、文件写入、验证提交与恢复必须委托给 `@aipt/platform-kernel`，不得在 CLI 内复制规则。
+
+向已采用 Profile 的项目添加工程能力：
+
+```bash
+dyyto add feature --project ./my-project \
+  --capability foundation.project-documentation@1.0.0
+dyyto apply --project ./my-project --approve <planId>
+dyyto verify --project ./my-project
+```
+
+`add feature` 只创建可审阅 Plan；Apply 才更新 Manifest 与 owned asset，Verify 成功后在保留 Profile Lock 的同时追加 Feature Lock。
+
+为已 Verify 的 Node、Web 或 Next.js Application 声明统一 Config Dir：
+
+```bash
+dyyto add feature --project ./my-project \
+  --capability foundation.environment-schema@2.0.0
+dyyto apply --project ./my-project --approve <planId>
+dyyto verify --project ./my-project
+```
+
+该能力生成 `config/application-config.json`，只声明非敏感值和 `*_FILE` Binding。
+它不会创建宿主 `$IDP_CONFIG_DIR`、`.env`、Secret 或证书；这些内容由外部部署控制面物化。
+现有不可变 Profile/Template 不会被回写，因此这是可部署 Application 脚手架当前必选的后续
+Capability，而不是旧 `create` 命令已经自动包含的资产。普通 Add 不删除其他 Owner 的
+`.env.example`；已经采用 `1.1.0` 的项目必须升级到 `2.0.0`，才会通过正式 Upgrade Plan
+退出旧 `.env.example` 与 `.env.local` 指引。未来只通过新的 Profile/Recipe Release 聚合这两步，
+不恢复根 `config:init`。npm 与 React Library 不采用运行时 Config Dir。
 
 安全升级已采用的 workspace root：
 
@@ -26,7 +119,7 @@ pnpm dyyto -- --version --json
 
 ```bash
 pnpm --dir apps/cli run pack:artifact
-corepack pnpm add --ignore-scripts /absolute/path/to/aipt-cli-0.1.0.tgz
+corepack pnpm add --ignore-scripts /absolute/path/to/aipt-cli-<version>.tgz
 ```
 
 发布包是自包含 CLI bundle，内置经过 integrity 校验的 Capability Catalog，不依赖 Dyyto workspace link。
@@ -40,7 +133,8 @@ dyyto create ./my-package \
   --version 0.1.0 \
   --license MIT \
   --publish-access public \
-  --capability foundation.standalone-npm-package@1.0.0
+  --repository https://github.com/owner/my-package \
+  --capability foundation.standalone-npm-package@1.1.0
 ```
 
 `apply` 后由开发者显式安装依赖，`verify` 会依次执行 typecheck、test、build 与 npm pack dry-run，并在全部通过后提交 Evidence 与 Project Lock。
@@ -59,7 +153,8 @@ dyyto add package \
   --version 0.1.0 \
   --license MIT \
   --publish-access public \
-  --capability foundation.workspace-npm-package@1.0.0
+  --repository https://github.com/owner/shared \
+  --capability foundation.workspace-npm-package@1.1.0
 ```
 
 Root 和 Unit 各自审批 Plan、提交 Evidence/Lock；依赖只需在 workspace root 安装一次，Unit 不生成嵌套 workspace。
@@ -93,15 +188,29 @@ Artifact Delivery：
 
 ```bash
 # public npm package：默认 npmjs.org
-dyyto delivery plan --project ./my-package --kind npm-publish
+dyyto delivery plan --project ./my-package --kind npm-publish \
+  --provider github-actions --repository owner/repository \
+  --workflow owner/repository/.github/workflows/release.yml@refs/heads/main \
+  --ref refs/heads/main --environment npm
 dyyto delivery apply --project ./my-package --approve <planId>
 dyyto delivery inspect --project ./my-package --plan <planId>
+dyyto delivery inspect --project ./my-package --plan <planId> --stage-artifact /path/to/reviewed.tgz
 
 # Node Application：默认本地 Docker
 dyyto delivery plan --project ./my-workspace/apps/api --kind application-deploy
 dyyto delivery apply --project ./my-workspace/apps/api --approve <planId>
 dyyto delivery inspect --project ./my-workspace/apps/api --plan <planId>
 
+# Hosted CSR：不可变对象 + Receipt 指针，不是 SSR
+dyyto delivery plan --project ./my-site --kind hosted-static
+dyyto delivery apply --project ./my-site --approve <planId>
+dyyto delivery inspect --project ./my-site --plan <planId>
+
+# Hosted SSR：Next standalone，走 application-deploy，不得把 OSS HTML 当请求期渲染
+dyyto delivery plan --project ./my-workspace/apps/site --kind application-deploy
+dyyto delivery apply --project ./my-workspace/apps/site --approve <planId>
+dyyto delivery inspect --project ./my-workspace/apps/site --plan <planId>
+
 # 运行时错误（本地 Collector 只绑定 127.0.0.1）
 dyyto observe serve --workspace ./my-workspace
 dyyto observe release register --project ./my-workspace/apps/web