@zhuoyuezs/ml-platform 0.1.1 → 0.1.3

package/DEVELOPMENT.md

@@ -10,10 +10,14 @@
 - Skill 直接调用正式命令 `ml-platform`，不嵌入 CLI runtime。
 - 正式 npm 包只有 `@zhuoyuezs/ml-platform`，正式 bin 只有 `ml-platform`。
 - `business-client-js/` 是 CLI 唯一源码，`skills/feature-management/` 是 Skill 唯一源码。
-- `npx --registry=https://registry.npmjs.org/ @zhuoyuezs/ml-platform@<version> install` 是统一安装入口。
+- `npx @zhuoyuezs/ml-platform@<version> install` 是面向用户的统一安装入口；默认目标是 Codex
+  用户级 Skill，不要求额外安装参数。
+- 管理命令默认输出简洁结果；Agent 和 CI 显式使用 `--json` 获取稳定结构化输出。
 - npm `postinstall` 不得修改 Agent Skills 目录。
 - Python business client 只保留为迁移 oracle，不进入 release。
 - Codex CLI 不重新打包；当前只支持唯一自研 Host。
+- builder 使用 Python，因此开发构建命令仍通过 `uv run ...` 启动；最终 npm 包和用户侧
+  `ml-platform` 运行时只依赖 Node.js，不依赖 Python 或 `uv`。
 
 ## 2. 源码与归档
 
@@ -37,6 +41,7 @@ package/
 │   └── lib.js
 ├── runtime/business-client/
 ├── skills/feature-management/
+├── release-policy.json
 ├── release.json
 ├── checksums.json
 ├── README.md
@@ -46,6 +51,10 @@ package/
 严格 `files` allowlist 必须排除 `node_modules`、测试 oracle、旧 wheel、Skill runtime、旧 wrapper、
 Host 副本、日志、会话数据、attic、凭证和实验文件。
 
+最终发布单元是 builder 生成并通过 smoke test 的 `.tgz`，不是 `dist/package/` 目录。目录只用于
+生成和检查归档；正式发布必须直接上传同一个 `.tgz`，避免 npm 在发布时重新打包出另一份未经
+验收的字节流。
+
 ## 3. Step-by-step 实施计划
 
 每一步单独实现、补测试并验收；上一阶段未通过时不进入下一阶段。
@@ -55,10 +64,14 @@ Host 副本、日志、会话数据、attic、凭证和实验文件。
 - 补齐全部 Python CLI 命令和参数契约；
 - 对齐 JSON stdout、stderr 和退出码；
 - 补齐数值参数、子命令 help、路径展开和 HTTP 错误测试；
+- 已注册 Dataset 支持 `get-dataset`、`resolve-dataset` 和
+  `build-registered-dataset` API-first 流程，不依赖本地 Manifest；
+- Catalog 规范化保留 `project`，Registry 只读元数据与可发布契约分离，目标 project
+  不一致时在访问 Registry 前失败；
 - 扩大 Catalog normalization differential tests；
 - 完成 Job、Artifact、inference 和 Operator upload 负向测试；
 - 删除正式运行路径中的旧产品名兼容；
-- 独立执行 `npm pack --dry-run`、clean install 和 CLI smoke test。
+- 独立执行 `npm pack --json --dry-run` 机器可读清单校验、clean install 和 CLI smoke test。
 
 完成标准：Python 只剩 oracle 作用，正式 CLI 不需要 Python、`uv` 或第三方 npm runtime 依赖。
 
@@ -103,7 +116,8 @@ Host 副本、日志、会话数据、attic、凭证和实验文件。
 
 - `install/upgrade/status/doctor` 进入 installer；
 - 全部业务命令进入同一 business client；
-- 未知命令和参数返回结构化非零错误；
+- 未知命令和参数返回非零错误；`--json` 模式返回结构化错误；
+- 管理命令默认人类可读，`--json` 保持稳定的 Agent/CI 契约；
 - 安装事务支持 staging、lock、ownership 和 rollback；
 - `status` 报告 CLI release、Skill revision、scope 和路径；
 - `doctor` 校验 package、CLI、Skill、record、PATH 和可选 API health；
@@ -124,21 +138,23 @@ Host 副本、日志、会话数据、attic、凭证和实验文件。
 - Skill validator 和 forward tests；
 - npm installer tests；
 - release builder；
-- `npm pack --dry-run`；
+- `npm pack --json --dry-run` 机器可读文件清单和最终归档校验；
 - `.tgz.sha256`；
 - clean npx install，删除 npx cache 后重测；
 - `status`、`doctor` 和只读业务命令；
+- 零参数用户级安装、当前目录项目级安装和显式 `--json` 输出；
 - Codex project/user scope 和显式 Skills 目录；
 - 最终归档敏感文件和重复 client 检查。
 
-完成标准：同一个不可变 `.tgz` 通过全部验收。仍不执行 npmjs 或其他外部发布。
+完成标准：同一个不可变 `.tgz` 通过全部验收，并作为唯一允许发布的输入。没有明确发布授权时，
+仍不执行 npmjs 或其他外部发布。
 
 ## 4. package.json
 
 ```json
 {
   "name": "@zhuoyuezs/ml-platform",
-  "version": "0.1.1",
+  "version": "<release-version>",
   "bin": {
     "ml-platform": "scripts/main.js"
   },
@@ -146,6 +162,7 @@ Host 副本、日志、会话数据、attic、凭证和实验文件。
     "scripts",
     "runtime",
     "skills",
+    "release-policy.json",
     "release.json",
     "checksums.json",
     "README.md",
@@ -154,6 +171,10 @@ Host 副本、日志、会话数据、attic、凭证和实验文件。
   "engines": {
     "node": ">=18"
   },
+  "os": [
+    "darwin",
+    "linux"
+  ],
   "license": "UNLICENSED",
   "publishConfig": {
     "access": "public",
@@ -164,6 +185,18 @@ Host 副本、日志、会话数据、attic、凭证和实验文件。
 
 不得配置用于安装 Skills 的 `postinstall`。
 
+发布前还必须检查以下 package metadata：
+
+- `package.json.version` 与目标 release version 一致；
+- `repository`、`homepage`、`bugs` 和 license 与真实仓库及授权策略一致；
+- `engines.node` 与实际测试矩阵一致；
+- 支持的 OS 与安装器实现一致。当前持久 shim 是 Unix 可执行脚本；在补充 Windows `.cmd` shim
+  和 Windows clean-install 测试前，不得在文档中声称支持 Windows。
+
+当前 Git remote 是内部仓库，公共 npm 包不得把内部仓库地址写入 `repository`、`homepage` 或
+`bugs`。在存在可公开访问的代码或支持页面前保持这些字段缺省；`UNLICENSED` 表示公开下载不等于
+授予源码许可证。
+
 ## 5. Release v2 约束
 
 release manifest 必须记录：
@@ -172,18 +205,72 @@ release manifest 必须记录：
 - source commit；
 - CLI name、version、path、entrypoint 和 tree digest；
 - Skill revision、path、CLI compatibility range 和 tree digest；
-- Agent adapters；
+- 支持的 Agent 安装适配器 `agent_adapters`；
 - Node.js 要求和 API compatibility contract；
 - 不参与组件 digest 的生成时间。
 
 `checksums.json` 覆盖 `runtime/` 和 `skills/` 全部文件，按路径排序并使用 canonical JSON。
 
-## 6. 安全与发布限制
+## 6. 发布前一致性门禁
+
+每次发布前必须满足：
+
+1. `package.json.version`、builder 参数、`release.json.release_version` 和 Skill revision 一致；
+2. business client version 与 `release.json.cli.version` 一致，且满足 Skill 的 `requires_cli`；
+3. release source 已提交，`source_commit` 能代表实际归档内容；
+4. README 已同步本次真实行为，staged package 和最终归档包含同一份 README；
+5. `npm pack --json --dry-run` 的 `files` 列表通过 allowlist 校验；
+6. release payload 不含内部地址、凭证、过期实施状态或未实现能力描述；
+7. 最终 `.tgz`、`.tgz.sha256`、clean install 和删除 npm cache 后的持久 CLI 测试全部通过；
+8. stable 版本使用 `latest` dist-tag；预发布版本使用独立 tag，不得提前覆盖 `latest`。
+
+README 更新是发布门禁，不是发布后的补充工作。面向用户的 README 保持简洁，只描述安装、配置、
+验证、常用命令、scope 选择和故障处理；架构与发布细节留在开发者文档中。
+
+## 7. 安装命令接口
+
+普通用户只需要：
+
+```bash
+npx @zhuoyuezs/ml-platform@<version> install
+```
+
+默认值固定为 `agent=codex`、`scope=user`、简洁输出。项目级安装只增加
+`--scope project`，并默认把当前目录作为项目根目录。只有命令不在项目根目录执行时才提供
+`--project-dir PATH`。
+
+保留两种 scope 是因为它们解决不同的隔离需求：`user` 适合一个开发者在多个 Codex 项目共享
+同一 Skill，`project` 适合项目独立安装、校验和升级。它们不是两套发布物，也不会复制 CLI；
+持久 CLI 始终只有一份，scope 只决定 Skill 和安装记录的位置。
+
+公开常用选项是 `--scope user|project`、`--project-dir PATH`、`--json` 和迁移旧 Skill 时使用的
+`--backup-unmanaged`。`--agent`、`--skills-dir`、`--state-dir`、`--bin-dir`、
+`--allow-downgrade`、`--no-prewarm` 和兼容形式 `install --upgrade` 是适配、恢复或隔离测试接口，
+不进入快速开始。
+`--summary` 作为旧版兼容别名保留；默认已经是简洁输出，新调用不需要添加它。
+
+## 8. 安全与发布限制
 
 - 不将凭证写入 npm 包、Skill、安装记录或测试 fixture；
 - 不在安装时访问或修改 ML Platform Registry；
 - 远程验收只执行获批的只读命令；
 - 不发布模型训练、模型服务、Kubernetes 或平台服务端；
-- 正式 npm 发布必须从 builder 生成的 `dist/package/` 执行 `npm publish --access public`；
+- 正式 npm 发布必须直接上传 builder 生成并验收过的
+  `dist/zhuoyuezs-ml-platform-<version>.tgz`，不得从源码或 staged 目录重新打包发布；
 - 不执行 GitHub Release 或其他未授权的外部发布；
 - candidate 验证后不得用相同版本重新构建不同内容。
+
+当前允许使用 npm 账号 2FA 完成人工发布。后续迁移到受控 CI 时，优先使用 npm Trusted
+Publishing 和 OIDC，并在受支持的公开 CI 环境执行 `npm publish --provenance`。本地登录不能
+替代 CI provenance，未建立可信发布工作流前不得宣称包具有对应来源证明。
+
+## 9. 参考与取舍
+
+- [npm package.json](https://docs.npmjs.com/cli/v11/configuring-npm/package-json/)：`bin`、`files`、
+  `engines`、`publishConfig` 等公开包契约；
+- [npm pack](https://docs.npmjs.com/cli/v11/commands/npm-pack)：发布归档和机器可读 dry-run；
+- [npm 生命周期脚本](https://docs.npmjs.com/cli/v11/using-npm/scripts)：安装和发布脚本边界；
+- [npm provenance](https://docs.npmjs.com/generating-provenance-statements/) 与
+  [Trusted Publishers](https://docs.npmjs.com/trusted-publishers/)：后续可信发布路径；
+- [飞书 CLI](https://github.com/larksuite/cli/blob/main/README.zh.md)：借鉴单命令安装、持久 CLI、
+  人类/Agent 分层说明和人类可读输出，不照搬其 native binary `postinstall` 下载模式。

package/README.md

@@ -1,76 +1,127 @@
 # ML Platform
 
-ML Platform 的 JavaScript CLI 和 `feature-management` Agent Skill。运行时只需要 Node.js 18+，
-不需要 Python 或 `uv`。
+ML Platform 的 JavaScript CLI 和 `feature-management` Agent Skill。CLI 与 Skill 由同一个 npm
+release 安装和升级，运行时不需要 Python 或 `uv`。
+
+## 环境要求
+
+- macOS 或 Linux；
+- Node.js 18+ 和 npm/npx；
+- Codex 环境；项目级安装时需要一个真实项目目录。
 
 ## 安装
 
-在 Codex 项目根目录运行：
+直接安装：
 
 ```bash
-npx --yes --registry=https://registry.npmjs.org/ \
-  @zhuoyuezs/ml-platform@latest install \
-  --agent codex \
-  --scope project \
-  --project-dir "$PWD"
+npx @zhuoyuezs/ml-platform@latest install
 ```
 
-安装器会创建持久命令 `~/.local/bin/ml-platform`，并将 Skill 安装到：
+这条命令不需要额外参数。默认安装持久化的 `ml-platform` 命令，并将 Skill 安装到
+`~/.codex/skills/feature-management/`，供当前用户的 Codex 使用。安装后重启终端和 Agent 会话。
 
-```text
-<project>/.agents/skills/feature-management/
+只在当前项目使用 Skill 时，在项目根目录运行：
+
+```bash
+npx @zhuoyuezs/ml-platform@latest install --scope project
 ```
 
-如果输出 `path_ready: false`，按 `path_setup` 提示配置 PATH，然后重启终端和 Agent。
+此时 Skill 安装到当前目录的 `.agents/skills/feature-management/`。如果命令不在项目根目录运行，
+再使用 `--project-dir /absolute/path/to/project` 显式指定项目。
+
+### 安装参数
+
+`install` 是安装子命令，必须提供；其余选项都不是普通安装的必填项。
 
-用户级安装：
+常用选项：
+
+| 选项 | 默认值 | 含义 |
+| --- | --- | --- |
+| `--scope user` | `user` | 用户级安装，Skill 写入 `~/.codex/skills/` |
+| `--scope project` | - | 项目级安装，Skill 只对指定项目生效 |
+| `--project-dir PATH` | 当前目录 | 指定项目根目录，仅在项目级安装时需要关注 |
+| `--json` | 关闭 | 输出供 Agent 和 CI 解析的稳定 JSON；省略时输出简洁结果 |
+| `--backup-unmanaged` | 关闭 | 目标位置已有旧版或非本包管理的 Skill 时，先备份再安装 |
+
+高级选项：
+
+| 选项 | 默认值 | 含义 |
+| --- | --- | --- |
+| `--agent codex` | `codex` | 指定 Codex；普通用户无需填写 |
+| `--agent pi\|custom` | - | 指定其他 Agent 目录规则，必须同时提供 `--skills-dir` |
+| `--skills-dir PATH` | 根据 Agent 和 scope 推导 | 直接指定 Agent Skills 根目录 |
+| `--state-dir PATH` | `~/.local/share/ml-platform` | 自定义持久 CLI 和安装状态目录 |
+| `--bin-dir PATH` | `~/.local/bin` | 自定义 `ml-platform` 命令 shim 目录 |
+| `--allow-downgrade` | 关闭 | 明确允许安装低于当前版本的 release |
+| `--no-prewarm` | 关闭 | 跳过安装后的 CLI 启动校验，主要用于测试或受限环境 |
+| `--upgrade` | 关闭 | `install --upgrade` 的兼容形式；新调用优先使用独立的 `upgrade` 子命令 |
+| `--summary` | 开启 | 兼容旧调用的简洁输出别名；新命令直接省略输出选项即可 |
+
+`npx --yes` 可以跳过 npm 的下载确认；`--registry` 只在需要覆盖本机 npm registry 配置时使用。
+它们是 npm/npx 的选项，不是 `ml-platform` 的安装参数。
+
+## 配置
+
+API 地址由用户或部署环境提供，不固化在 npm 包或 Skill 中：
 
 ```bash
-npx --yes --registry=https://registry.npmjs.org/ \
-  @zhuoyuezs/ml-platform@latest install \
-  --agent codex \
-  --scope user
+ml-platform configure --api-url https://your-ml-platform.example.com
+ml-platform show-config
+ml-platform health
 ```
 
-## 迁移旧 Skill
+解析顺序是：命令行 `--api-url`、`ML_PLATFORM_API_URL`、`configure` 保存的地址。
 
-如果目标位置已有旧 Python Skill、实验 symlink 或其他未托管 Skill，确认后显式备份并安装：
+## 验证
 
 ```bash
-npx --yes --registry=https://registry.npmjs.org/ \
-  @zhuoyuezs/ml-platform@latest install \
-  --agent codex \
-  --scope project \
-  --project-dir "$PWD" \
-  --backup-unmanaged
+ml-platform version
+ml-platform status
+ml-platform doctor
 ```
 
-安装器会保留带时间戳的备份，不会直接删除原 Skill。
+管理命令默认输出简洁结果；Agent 和 CI 使用 `--json` 获取稳定 JSON。`doctor` 会使用当前有效
+API 配置；未配置 API 时只跳过联网检查，其余安装完整性检查仍会执行。
 
-## 使用
+验证项目级安装时，在项目根目录使用 `ml-platform status --scope project` 和
+`ml-platform doctor --scope project`。
+
+## 常用命令
 
 ```bash
-ml-platform configure --api-url http://<host>:<port>
-ml-platform health
 ml-platform list-parameters
+ml-platform list-datasets --project <project>
+ml-platform get-dataset <dataset_id> <dataset_version> --project <project>
+ml-platform resolve-dataset <dataset_id> <dataset_version> --project <project>
+ml-platform build-registered-dataset <dataset_id> <dataset_version> --project <project> --wait
 ml-platform apply /absolute/path/to/catalog --dry-run
-ml-platform status --agent codex --scope project --project-dir "$PWD"
-ml-platform doctor --agent codex --scope project --project-dir "$PWD"
+ml-platform build-dataset /absolute/path/to/manifest.json --wait
+ml-platform --help
 ```
 
-查看完整命令：
+前四个 Dataset 命令直接使用远程 Registry/API，适合 Agent 对已发布版本执行发现、只读诊断和
+受控构建，不要求本地存在 Catalog。`apply`、`resolve-manifest` 和带本地 JSON 路径的
+`build-dataset` 用于新契约的编写和发布流程。
+
+## 迁移旧 Skill
+
+目标目录存在旧 Python Skill、实验 symlink 或其他未托管 Skill 时，确认后显式备份：
 
 ```bash
-ml-platform --help
+npx --yes --registry=https://registry.npmjs.org/ \
+  @zhuoyuezs/ml-platform@latest install \
+  --scope project \
+  --project-dir /absolute/path/to/project \
+  --backup-unmanaged
 ```
 
+安装器保留带时间戳的备份，不会静默覆盖用户文件。
+
 ## 包内容
 
 - 一份 JavaScript business CLI；
 - 一份纯 `feature-management` Skill；
-- 显式安装、升级、迁移、状态、校验和回滚逻辑。
-
-本包不包含 Codex CLI、Python business-client wheel、Agent Host、平台服务端、模型训练或
-Kubernetes 部署。
+- 显式安装、升级、状态、校验和回滚逻辑。
 
-开发和发布约束见 [DEVELOPMENT.md](DEVELOPMENT.md)。
+不包含 Codex CLI、Python business-client wheel、Agent Host、平台服务端、模型训练或 Kubernetes
+部署。开发和发布约束见 [DEVELOPMENT.md](DEVELOPMENT.md)。

package/checksums.json

@@ -2,28 +2,28 @@
   "files": [
     {
       "path": "runtime/business-client/README.md",
-      "sha256": "sha256:165a2bd2bb51b61e0967b0b75fb51840b18e825fcf3198c7eee73cc74565ae5d",
-      "size_bytes": 637
+      "sha256": "sha256:4bca6d490a0ac3de54accb8f9f43003cdfb0c187bcf1acefea48728b16001e94",
+      "size_bytes": 1233
     },
     {
       "path": "runtime/business-client/package-lock.json",
-      "sha256": "sha256:d35849fa8c24520e4a33e18aa0366fb8d453a5df55516b45e9561db5e18cbedd",
+      "sha256": "sha256:a253eb945f8666779adfbf9e7009c539b450746298f145bbe4d0b2ca5f4cbe35",
       "size_bytes": 381
     },
     {
       "path": "runtime/business-client/package.json",
-      "sha256": "sha256:990c111ce4d345c660ec1136b81ac71f161217abf7716358d64bc8e1ac979c15",
+      "sha256": "sha256:bf29516fcbd162fe051f6ea142bd604dead0be99c461bc184a59e7c526766aa4",
       "size_bytes": 426
     },
     {
       "path": "runtime/business-client/src/catalog.js",
-      "sha256": "sha256:33b5da9f4b7fc200b1c5cee38d18fcec56bb2b2b022a473d8f8f47441ea2fb7b",
-      "size_bytes": 51193
+      "sha256": "sha256:d37f8069027350a3b698af2e9121067e77feb995980bbb226e45e7cdf9130db1",
+      "size_bytes": 53751
     },
     {
       "path": "runtime/business-client/src/cli.js",
-      "sha256": "sha256:0e344399795bb0c7804c057b6063f7e6d3720a7f4fe0cf8400fa362d62d03f56",
-      "size_bytes": 15765
+      "sha256": "sha256:51d2056d8f1c12c3e669b597415bd2c2b911c9a8d44ce4721ee9ff63c9922679",
+      "size_bytes": 19305
     },
     {
       "path": "runtime/business-client/src/config.js",
@@ -37,8 +37,8 @@
     },
     {
       "path": "skills/feature-management/SKILL.md",
-      "sha256": "sha256:5a5c935296b245a0f480dce967d122ff1085d543831b8ce6077e4959f658f5e4",
-      "size_bytes": 17823
+      "sha256": "sha256:ffd68632b98f51b15e18f225ee83452d6548969e799af727ea9f9efae7300cfb",
+      "size_bytes": 19156
     },
     {
       "path": "skills/feature-management/agents/openai.yaml",
@@ -92,8 +92,8 @@
     },
     {
       "path": "skills/feature-management/references/commands.md",
-      "sha256": "sha256:4840af5c181ee3b9596548686f2eca2ca7a4acfcd6adcd9afa01f447187ea659",
-      "size_bytes": 8812
+      "sha256": "sha256:1c1de0e9c5d40ab57374f59b32a04b92648d1e6abecd4962965ddd887a4e0242",
+      "size_bytes": 9999
     },
     {
       "path": "skills/feature-management/references/contracts.md",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuoyuezs/ml-platform",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "ML 数据平台 business CLI 与 Agent Skills 管理工具",
   "bin": {
     "ml-platform": "scripts/main.js"
@@ -21,6 +21,10 @@
   "engines": {
     "node": ">=18"
   },
+  "os": [
+    "darwin",
+    "linux"
+  ],
   "license": "UNLICENSED",
   "publishConfig": {
     "access": "public",

package/release-policy.json

@@ -27,5 +27,15 @@
     ".sqlite",
     ".sqlite3",
     ".whl"
+  ],
+  "forbidden_content_patterns": [
+    {
+      "name": "private_ipv4_url",
+      "pattern": "https?://(?:10(?:\\.\\d{1,3}){3}|192\\.168(?:\\.\\d{1,3}){2}|172\\.(?:1[6-9]|2\\d|3[01])(?:\\.\\d{1,3}){2})(?::\\d+)?"
+    },
+    {
+      "name": "stale_packaging_status",
+      "pattern": "the packaging stage is not implemented\\s+yet"
+    }
   ]
 }

package/release.json

@@ -13,10 +13,10 @@
     "entrypoint": "src/cli.js",
     "name": "ml-platform",
     "path": "runtime/business-client",
-    "sha256": "sha256:6a43efb51ba1f878b11537d63e79c04cb798e7f456cb29f87fd0aac742794fdd",
-    "version": "0.5.0"
+    "sha256": "sha256:f782ec0cda02a69cf3fcc9dfccd7f29793bdbd91a8092d56e4073f09547fbf78",
+    "version": "0.6.0"
   },
-  "policy_sha256": "sha256:fe4d32b6b7b955061a93731eb25eca1727af6c2b9db79339b5e1fd55f6a2ada4",
+  "policy_sha256": "sha256:02fbde0134696b78c0c365d6e0b76c9814227208da5b2b3d4e5dbd82dc4a3606",
   "public_schema_versions": [
     "ml_data_platform.catalog/v1",
     "ml_data_platform.parameter/v1",
@@ -25,18 +25,22 @@
     "ml_data_platform.feature_set/v1",
     "ml_data_platform.dataset_manifest/v1"
   ],
-  "release_version": "0.1.1",
+  "release_version": "0.1.3",
   "runtime_requirements": {
-    "node": ">=18"
+    "node": ">=18",
+    "os": [
+      "darwin",
+      "linux"
+    ]
   },
   "schema_version": "data_platform.ml_platform_release/v2",
   "skills": {
     "feature-management": {
       "path": "skills/feature-management",
-      "requires_cli": ">=0.5.0 <0.6.0",
-      "revision": "0.1.1",
-      "sha256": "sha256:f7c2ba836338602f6f01ebec18b595a366f5dd1bcbfcb58e249cda5c10bd61dd"
+      "requires_cli": ">=0.6.0 <0.7.0",
+      "revision": "0.1.3",
+      "sha256": "sha256:e0ec0b304bb9f511eb5a5c53a32b76dcfede8bcdce70e3ff516eb4143a6c04f2"
     }
   },
-  "source_commit": "07e4f763c89c574d417e37d23d84cf5bc04120d7"
+  "source_commit": "f63960b92fce9eb9360dd6ad64d10f26f5dd72db"
 }

package/runtime/business-client/README.md

@@ -12,3 +12,16 @@ node business-client-js/src/cli.js --help
 当前包保持 `private: true`，用于独立开发、测试和迁移验证，不作为第二个正式 npm 产品发布。
 正式 npm 封装阶段会把这份源码作为 `@zhuoyuezs/ml-platform` 的唯一 CLI runtime，并继续只暴露
 `ml-platform` 命令。
+
+已注册 Dataset 的 API-first 流程不依赖本地 Catalog：
+
+```bash
+ml-platform list-datasets --project <project>
+ml-platform get-dataset <dataset_id> <dataset_version> --project <project>
+ml-platform resolve-dataset <dataset_id> <dataset_version> --project <project>
+ml-platform build-registered-dataset <dataset_id> <dataset_version> \
+  --project <project> --wait
+```
+
+`resolve-manifest` 和 `build-dataset <manifest.json>` 仍用于尚未注册的本地契约。Catalog
+normalizer 保留并校验非默认 `project`；`apply --project` 与 Catalog 内项目不一致时拒绝执行。

package/runtime/business-client/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@zhuoyuezs/ml-platform-business-client",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@zhuoyuezs/ml-platform-business-client",
-      "version": "0.5.0",
+      "version": "0.6.0",
       "license": "UNLICENSED",
       "bin": {
         "ml-platform": "src/cli.js"

package/runtime/business-client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuoyuezs/ml-platform-business-client",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": true,
   "description": "JavaScript parity implementation of the ML Platform business client",
   "bin": {