@zhuoyuezs/ml-platform 0.2.0 → 0.2.2-alpha.0

package/DEVELOPMENT.md

@@ -9,13 +9,14 @@
 - Business CLI 与 Skill 是并列组件；CLI 不属于 Skill。
 - Skill 直接调用正式命令 `ml-platform`，不嵌入 CLI runtime。
 - 正式 npm 包只有 `@zhuoyuezs/ml-platform`，正式 bin 只有 `ml-platform`。
-- `business-client-js/` 是 CLI 唯一源码，仓库 `skills/` 下三个受支持 Skill 是各自唯一源码。
+- `business-client-js/src-ts/` 是 business CLI 的唯一 TypeScript 源码，`src/` 是供 Node.js 和
+  release payload 使用的编译输出；仓库 `skills/` 下三个受支持 Skill 是各自唯一源码。
 - `npx @zhuoyuezs/ml-platform@<version> install` 是面向用户的统一安装入口；默认目标是 Codex
   用户级 Skill，不要求额外安装参数。
 - 管理命令默认输出简洁结果；Agent 和 CI 显式使用 `--json` 获取稳定结构化输出。
 - npm `postinstall` 不得修改 Agent Skills 目录。
 - Python business client 与迁移 oracle 已删除；release builder 继续防御性排除 Python
-  runtime、wheel 和旧 wrapper，npm 包只携带 JavaScript CLI 与纯 Skill payload。
+  runtime、wheel 和旧 wrapper，npm 包只携带由 TypeScript 编译的 JavaScript CLI 与纯 Skill payload。
 - Codex CLI 不重新打包；当前只支持唯一自研 Host。
 - builder 使用 Python，因此开发构建命令仍通过 `uv run ...` 启动；最终 npm 包和用户侧
   `ml-platform` 运行时只依赖 Node.js，不依赖 Python 或 `uv`。
@@ -26,6 +27,9 @@
 
 ```text
 business-client-js/
+├── src-ts/                       TypeScript business CLI source
+└── src/                          generated Node.js runtime
+npm/ml-platform/src/               TypeScript installer and dispatcher source
 skills/feature-management/
 skills/model-lifecycle-management/
 skills/model-deployment-management/
@@ -40,8 +44,8 @@ agent_poc/codex-host/
 package/
 ├── package.json
 ├── scripts/
-│   ├── main.js
-│   └── lib.js
+│   ├── main.js                   generated dispatcher
+│   └── lib.js                    generated installer library
 ├── runtime/business-client/
 ├── skills/<skill-name>/
 ├── release-policy.json
@@ -156,6 +160,11 @@ SemVer tag（`vX.Y.Z` 或 `X.Y.Z`）与 `package.json.version` 一致、且配
 
 ## 4. package.json
 
+`npm/ml-platform/src/` 与 `business-client-js/src-ts/` 是可编辑 TypeScript 源码。分别运行
+`npm run build --prefix npm/ml-platform` 和 `npm run build --prefix business-client-js` 后，生成的
+CommonJS 文件位于 `npm/ml-platform/scripts/` 与 `business-client-js/src/`。发布归档只包含这些
+Node.js runtime 文件，不携带 TypeScript 编译器或 `node_modules`。
+
 ```json
 {
   "name": "@zhuoyuezs/ml-platform",
@@ -246,7 +255,16 @@ npx @zhuoyuezs/ml-platform@<version> install
 
 保留两种 scope 是因为它们解决不同的隔离需求：`user` 适合一个开发者在多个 Codex 项目共享
 同一 Skill，`project` 适合项目独立安装、校验和升级。它们不是两套发布物，也不会复制 CLI；
-持久 CLI 始终只有一份，scope 只决定 Skill 和安装记录的位置。
+持久 CLI 始终只有一份，scope 只决定 Skill 和安装记录的位置。共享 runtime 在 state 目录的
+`installations.json` 登记每个已安装 scope。升级共享 CLI 前，安装器会遍历所有已登记 scope 的
+全部 Skill `requires_cli`；候选 CLI 不兼容任何一个 scope 时，整个升级在替换前失败。`status`
+同时返回 scope 的 `installed_release` 与共享 runtime 的 `runtime_release`，CLI 版本始终以实际
+runtime 为准，不从某个 scope 的历史安装记录推断。
+
+`doctor` 会校验当前 scope 的每个已登记 Skill、共享 runtime、shim 和 registry。相同 release 的
+`install` 发现某个受管 Skill 缺失或摘要被篡改时会重新写入该 scope 的全部 Skill，返回 `repaired`。
+旧安装记录可读取；要纳入跨 scope 兼容性保护，每个旧 scope 需至少执行一次当前安装器的
+`install --upgrade` 完成 registry 登记。
 
 公开常用选项是 `--scope user|project`、`--project-dir PATH`、`--json` 和迁移旧 Skill 时使用的
 `--backup-unmanaged`。`--agent`、`--skills-dir`、`--state-dir`、`--bin-dir`、

package/README.md

@@ -1,6 +1,6 @@
 # ML Platform
 
-ML Platform 的 JavaScript CLI、`feature-management`、`model-lifecycle-management` 与
+ML Platform 的 TypeScript CLI（编译为 Node.js JavaScript runtime）、`feature-management`、`model-lifecycle-management` 与
 `model-deployment-management` Agent Skill。CLI 与 Skill 由同一个 npm
 release 安装和升级，运行时不需要 Python 或 `uv`。
 
@@ -82,7 +82,10 @@ ml-platform doctor
 ```
 
 管理命令默认输出简洁结果；Agent 和 CI 使用 `--json` 获取稳定 JSON。`doctor` 会使用当前有效
-API 配置；未配置 API 时只跳过联网检查，其余安装完整性检查仍会执行。
+API 配置；未配置 API 时只跳过联网检查，其余安装完整性检查仍会执行。完整性检查覆盖当前 scope
+的全部受管 Skill、共享 CLI、shim 和 scope registry；同版本安装会自动恢复缺失或被篡改的受管
+Skill。`status --json` 中 `installed_release` 是当前 scope 的 Skill release，`runtime_release` 和
+`cli` 则表示实际共享 CLI runtime。
 
 验证项目级安装时，在项目根目录使用 `ml-platform status --scope project` 和
 `ml-platform doctor --scope project`。
@@ -95,12 +98,13 @@ 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 list-deployments --package-id <package-id> --package-version <package-version>
 ml-platform apply /absolute/path/to/catalog --dry-run
 ml-platform build-dataset /absolute/path/to/manifest.json --wait
 ml-platform --help
 ```
 
-前四个 Dataset 命令直接使用远程 Registry/API，适合 Agent 对已发布版本执行发现、只读诊断和
+Dataset 查询和 `list-deployments` 直接使用远程 Registry/API，适合 Agent 对已发布版本执行发现、只读诊断和
 受控构建，不要求本地存在 Catalog。`apply`、`resolve-manifest` 和带本地 JSON 路径的
 `build-dataset` 用于新契约的编写和发布流程。
 
@@ -124,7 +128,7 @@ npx --yes --registry=https://registry.npmjs.org/ \
 
 ## 包内容
 
-- 一份 JavaScript business CLI；
+- 一份由 TypeScript 编译的 business CLI；
 - 三份纯 Skill：`feature-management`、`model-lifecycle-management` 与
   `model-deployment-management`；
 - 显式安装、升级、状态、校验和回滚逻辑。

package/checksums.json

@@ -2,38 +2,38 @@
   "files": [
     {
       "path": "runtime/business-client/README.md",
-      "sha256": "sha256:61708adaee4479fe138ac5e6df1adc02be09cfeb6c30a7f9211ccc372c0e8ced",
-      "size_bytes": 7553
+      "sha256": "sha256:7e84fad64f8ee6c7aae467b7947123f3a490b799ec5ffa24fd008e0fa37b133e",
+      "size_bytes": 7898
     },
     {
       "path": "runtime/business-client/package-lock.json",
-      "sha256": "sha256:ff46c68537d57d95b324318ab10a0b70847afa6db15a9223b74b6bc074925a5c",
-      "size_bytes": 381
+      "sha256": "sha256:7fc827b514bf44b2b216eeaa3ba2638739ebd4691fe77093322fd882e2cb11f3",
+      "size_bytes": 1628
     },
     {
       "path": "runtime/business-client/package.json",
-      "sha256": "sha256:3a82339cbb18e0e205647860f72a4a1ecbaf3182e22431c7810dd5e3e32bac19",
-      "size_bytes": 501
+      "sha256": "sha256:a497a296ed8b70323bf6a306f92ad7cadd693613d1f8c9fe2df00a045603aee0",
+      "size_bytes": 671
     },
     {
       "path": "runtime/business-client/src/catalog.js",
-      "sha256": "sha256:9de30ed45b99e3be6ca23f0f0087cbbbf91f644f032273ccf3bec00e8062062e",
-      "size_bytes": 56271
+      "sha256": "sha256:9ace0708c04aed8876e8d5b8eba9241f32e98757ca19d14fb00c30ba2de662cf",
+      "size_bytes": 58679
     },
     {
       "path": "runtime/business-client/src/cli.js",
-      "sha256": "sha256:255c1ddf9521f7d6b336122a4678b1e9aab34e1ff4e894395a9e69316bacb4ad",
-      "size_bytes": 54119
+      "sha256": "sha256:2c8c2ccc5ca9d09ac787ea68af928cb4cd63d3348c0b40bfc1898dd2dcb0edec",
+      "size_bytes": 58618
     },
     {
       "path": "runtime/business-client/src/config.js",
-      "sha256": "sha256:4190e09c339a3f0b2861ca7dbc96fe2aa3bdd7927a5e1c4a4c00103a53236bd8",
-      "size_bytes": 2186
+      "sha256": "sha256:8c9666c089dac373e5b849dd13312f25edce77b70e8f1e69b85fc5863a16c4ce",
+      "size_bytes": 2408
     },
     {
       "path": "runtime/business-client/src/http.js",
-      "sha256": "sha256:e515b39f19e7b5e7d6c2388e9cf2d8e2c9fd18b585bb53bd4f8eeeb7412af81c",
-      "size_bytes": 15192
+      "sha256": "sha256:4ae9e9ec10a74f36ed19ca7a63b0ba58a34cedea13ed95131ef1d07cd7d9e674",
+      "size_bytes": 17176
     },
     {
       "path": "skills/feature-management/SKILL.md",
@@ -132,8 +132,8 @@
     },
     {
       "path": "skills/model-deployment-management/references/operations.md",
-      "sha256": "sha256:93977ec65a8b1ac51a5134ab98ac095e177de537c81f0db447ad97fb8a7e910f",
-      "size_bytes": 4455
+      "sha256": "sha256:b6d8ac126033a1e3b463b53474f0b27d8687e1a7b05eb973d3aad79259838ac6",
+      "size_bytes": 4968
     },
     {
       "path": "skills/model-deployment-management/references/troubleshooting.md",
@@ -157,8 +157,8 @@
     },
     {
       "path": "skills/model-lifecycle-management/references/evaluation.md",
-      "sha256": "sha256:099fc54af2a1d8bed287f9e557cee8583558e594880235c32b89276b385cce90",
-      "size_bytes": 8858
+      "sha256": "sha256:4314e65b162f0a72c5c5e6411186340661c853551dc8b2ebce3597680acef117",
+      "size_bytes": 9477
     },
     {
       "path": "skills/model-lifecycle-management/references/packaging.md",
@@ -167,8 +167,8 @@
     },
     {
       "path": "skills/model-lifecycle-management/references/training-contracts.md",
-      "sha256": "sha256:28fe32b2673db8f6cb1e02053bf5709826786e48dbe9951eac7bb4d98368d0c4",
-      "size_bytes": 12644
+      "sha256": "sha256:d2b1f4089cd622589fabd50fe1600edfa6c330f4a7516734fe2316fcec7bb1e0",
+      "size_bytes": 12893
     },
     {
       "path": "skills/model-lifecycle-management/references/training.md",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuoyuezs/ml-platform",
-  "version": "0.2.0",
+  "version": "0.2.2-alpha.0",
   "description": "ML 数据平台 business CLI 与 Agent Skills 管理工具",
   "bin": {
     "ml-platform": "scripts/main.js"
@@ -17,10 +17,12 @@
     "CI-ARTIFACT.md"
   ],
   "scripts": {
-    "test": "node --test test/*.test.js",
+    "build": "tsc --project tsconfig.json && chmod +x scripts/main.js scripts/verify-release-package.js",
+    "test": "npm run build && node --test test/*.test.js",
+    "test:compiled": "node --test test/*.test.js",
     "api:check": "node ../../scripts/check_api_contract.js",
     "pack": "npm pack",
-    "prepublishOnly": "node scripts/verify-release-package.js"
+    "prepublishOnly": "npm run build && node scripts/verify-release-package.js"
   },
   "engines": {
     "node": ">=18"
@@ -33,5 +35,9 @@
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.3"
   }
 }

package/release.json

@@ -13,8 +13,8 @@
     "entrypoint": "src/cli.js",
     "name": "ml-platform",
     "path": "runtime/business-client",
-    "sha256": "sha256:41f143a9451dbd740ec08070a33e21d4580e246cf4b282e0ffda6d9f6f9f880a",
-    "version": "0.8.0"
+    "sha256": "sha256:6491b970b094de9514aacdf21a90e8f8f57d429f37a0f762747b2dca4a4d6df2",
+    "version": "0.8.1"
   },
   "policy_sha256": "sha256:02fbde0134696b78c0c365d6e0b76c9814227208da5b2b3d4e5dbd82dc4a3606",
   "public_schema_versions": [
@@ -25,7 +25,7 @@
     "ml_data_platform.feature_set/v1",
     "ml_data_platform.dataset_manifest/v1"
   ],
-  "release_version": "0.2.0",
+  "release_version": "0.2.2-alpha.0",
   "runtime_requirements": {
     "node": ">=18",
     "os": [
@@ -37,22 +37,22 @@
   "skills": {
     "feature-management": {
       "path": "skills/feature-management",
-      "requires_cli": ">=0.8.0 <0.9.0",
-      "revision": "0.2.0",
+      "requires_cli": ">=0.8.1 <0.9.0",
+      "revision": "0.2.2-alpha.0",
       "sha256": "sha256:d32f0306f129d7bf76eb037fe239c84dd3c29c64b61600799d6e40320784bb10"
     },
     "model-deployment-management": {
       "path": "skills/model-deployment-management",
-      "requires_cli": ">=0.8.0 <0.9.0",
-      "revision": "0.2.0",
-      "sha256": "sha256:d81becca0076d0513e7b8277e7584d9f810db755aa56e79235df68d0f7a7659b"
+      "requires_cli": ">=0.8.1 <0.9.0",
+      "revision": "0.2.2-alpha.0",
+      "sha256": "sha256:e7d87c272a0dcc028ea628d5e36f5b7e52ed27cb9c1bc17ea76527478e28b46d"
     },
     "model-lifecycle-management": {
       "path": "skills/model-lifecycle-management",
-      "requires_cli": ">=0.8.0 <0.9.0",
-      "revision": "0.2.0",
-      "sha256": "sha256:5a911eff6a4c188d8e3709f37e4f37819effea61db9f5a015e6ec4dddd4a0ec7"
+      "requires_cli": ">=0.8.1 <0.9.0",
+      "revision": "0.2.2-alpha.0",
+      "sha256": "sha256:aaa3fdb54c0ff9e8dfa0f71e67d072830786e5e3d4803ba3962dff723d159386"
     }
   },
-  "source_commit": "aa4c64af0715b168edd4d50766f7b6bf851763ff"
+  "source_commit": "581b69e5c0a7c21dc3ebadd23121231974214b13"
 }

package/runtime/business-client/README.md

@@ -64,10 +64,15 @@ ml-platform validate-deployment /absolute/path/to/deployment.json \
 ml-platform create-deployment /absolute/path/to/deployment.json \
   --evaluation-id <pass-evaluation-id>
 ml-platform wait-deployment <deployment-id> --wait-timeout-seconds 1800
+ml-platform list-deployments --package-id <package-id> \
+  --package-version <package-version> --model-artifact-id <artifact-id>
 ml-platform get-deployment <deployment-id>
 ml-platform get-deployment-events <deployment-id> --limit 100 --offset 0
 ```
 
+`list-deployments` 也支持按 `service`、`environment`、`state` 和自由文本 `q` 过滤，返回平台
+Deployment Controller 管理的部署，不把模型中心回写的 delivery 状态当作平台部署。
+
 `READY` 必须同时包含 `ReplicasReady=true`、`ArtifactsVerified=true` 和
 `SmokePredictionPassed=true`。`get-deployment` 返回控制器实际观察到的 endpoint 元数据；
 本地 CLI 不推测 Kubernetes Service 名称。部署后验证优先使用控制面代理：

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

@@ -1,19 +1,54 @@
 {
   "name": "@zhuoyuezs/ml-platform-business-client",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@zhuoyuezs/ml-platform-business-client",
-      "version": "0.8.0",
+      "version": "0.8.1",
       "license": "UNLICENSED",
       "bin": {
         "ml-platform": "src/cli.js"
       },
+      "devDependencies": {
+        "@types/node": "^22.10.0",
+        "typescript": "^5.7.3"
+      },
       "engines": {
         "node": ">=18"
       }
+    },
+    "node_modules/@types/node": {
+      "version": "22.20.3",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.20.3.tgz",
+      "integrity": "sha512-DZmzkmwHzXrLPAXPyKNDzlIwMMUZCVacoD25ywdy5YTKGbOx/2ld+Q38Im2zJ0vBuZP5Prd3VZutKZyXwkOS8A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~6.21.0"
+      }
+    },
+    "node_modules/typescript": {
+      "version": "5.9.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "6.21.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
+      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
+      "dev": true,
+      "license": "MIT"
     }
   }
 }

package/runtime/business-client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuoyuezs/ml-platform-business-client",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "private": true,
   "description": "JavaScript implementation of the ML Platform business client",
   "bin": {
@@ -11,7 +11,8 @@
     "README.md"
   ],
   "scripts": {
-    "test": "node --test test/*.test.js",
+    "build": "tsc --project tsconfig.json && chmod +x src/cli.js",
+    "test": "npm run build && node --test test/*.test.js",
     "api:check": "node ../scripts/check_api_contract.js",
     "pack": "npm pack"
   },
@@ -19,5 +20,9 @@
     "node": ">=18"
   },
   "license": "UNLICENSED",
-  "dependencies": {}
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.3"
+  }
 }