@zhuoyuezs/ml-platform 0.1.19 → 0.2.1

package/README.md

@@ -95,12 +95,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` 用于新契约的编写和发布流程。
 

package/checksums.json

@@ -2,17 +2,17 @@
   "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:386e8b46ae8e6d7fd83e247b0412560710bee263c2545b593c5442b8f1363765",
+      "sha256": "sha256:43cc5d0a9326cf77ebba8062569feca6ebe986938fad6322647f4d96e3178ec5",
       "size_bytes": 381
     },
     {
       "path": "runtime/business-client/package.json",
-      "sha256": "sha256:83e60780d91abc78420a533ba0f8ea184f31886f963ca6f1554da819530a6335",
+      "sha256": "sha256:68f1e248612f027e3d28c5de9f2679bd77a2692ef2748e4e92a0d9c59b07d1a6",
       "size_bytes": 501
     },
     {
@@ -22,8 +22,8 @@
     },
     {
       "path": "runtime/business-client/src/cli.js",
-      "sha256": "sha256:255c1ddf9521f7d6b336122a4678b1e9aab34e1ff4e894395a9e69316bacb4ad",
-      "size_bytes": 54119
+      "sha256": "sha256:b282fbbcb8e999ec44cf5bf36a17e02dcf23851971994d1556753e4a0b216d0e",
+      "size_bytes": 54352
     },
     {
       "path": "runtime/business-client/src/config.js",
@@ -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.1.19",
+  "version": "0.2.1",
   "description": "ML 数据平台 business CLI 与 Agent Skills 管理工具",
   "bin": {
     "ml-platform": "scripts/main.js"

package/release.json

@@ -13,8 +13,8 @@
     "entrypoint": "src/cli.js",
     "name": "ml-platform",
     "path": "runtime/business-client",
-    "sha256": "sha256:94d80ebfe36808fa5c0ed5585a002d8c77cb95c16b5f1ec856e5725d0d4b347f",
-    "version": "0.7.8"
+    "sha256": "sha256:ce26f9355c6eed92173b478fac809d0d1c87bc59d342b37e8e12262f488bbdfa",
+    "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.1.19",
+  "release_version": "0.2.1",
   "runtime_requirements": {
     "node": ">=18",
     "os": [
@@ -37,22 +37,22 @@
   "skills": {
     "feature-management": {
       "path": "skills/feature-management",
-      "requires_cli": ">=0.7.8 <0.8.0",
-      "revision": "0.1.19",
+      "requires_cli": ">=0.8.1 <0.9.0",
+      "revision": "0.2.1",
       "sha256": "sha256:d32f0306f129d7bf76eb037fe239c84dd3c29c64b61600799d6e40320784bb10"
     },
     "model-deployment-management": {
       "path": "skills/model-deployment-management",
-      "requires_cli": ">=0.7.8 <0.8.0",
-      "revision": "0.1.19",
-      "sha256": "sha256:d81becca0076d0513e7b8277e7584d9f810db755aa56e79235df68d0f7a7659b"
+      "requires_cli": ">=0.8.1 <0.9.0",
+      "revision": "0.2.1",
+      "sha256": "sha256:e7d87c272a0dcc028ea628d5e36f5b7e52ed27cb9c1bc17ea76527478e28b46d"
     },
     "model-lifecycle-management": {
       "path": "skills/model-lifecycle-management",
-      "requires_cli": ">=0.7.8 <0.8.0",
-      "revision": "0.1.19",
-      "sha256": "sha256:5a911eff6a4c188d8e3709f37e4f37819effea61db9f5a015e6ec4dddd4a0ec7"
+      "requires_cli": ">=0.8.1 <0.9.0",
+      "revision": "0.2.1",
+      "sha256": "sha256:aaa3fdb54c0ff9e8dfa0f71e67d072830786e5e3d4803ba3962dff723d159386"
     }
   },
-  "source_commit": "ff73d381b4b895ea46ca764d9ad1bf32920faee1"
+  "source_commit": "93fcb433438db8409e3b762a0cad44c3abc12b8b"
 }

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,12 +1,12 @@
 {
   "name": "@zhuoyuezs/ml-platform-business-client",
-  "version": "0.7.8",
+  "version": "0.8.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@zhuoyuezs/ml-platform-business-client",
-      "version": "0.7.8",
+      "version": "0.8.1",
       "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.7.8",
+  "version": "0.8.1",
   "private": true,
   "description": "JavaScript implementation of the ML Platform business client",
   "bin": {

package/runtime/business-client/src/cli.js

@@ -147,7 +147,7 @@ const COMMAND_USAGE = {
   "list-deployment-targets": "list-deployment-targets",
   "validate-deployment": "validate-deployment SPEC_JSON --evaluation-id ID",
   "create-deployment": "create-deployment SPEC_JSON --evaluation-id ID",
-  "list-deployments": "list-deployments [--service SERVICE] [--environment ENV] [--state STATE] [-q QUERY] [--limit N] [--offset N]",
+  "list-deployments": "list-deployments [--service SERVICE] [--environment ENV] [--package-id ID] [--package-version VERSION] [--model-artifact-id ID] [--state STATE] [-q QUERY] [--limit N] [--offset N]",
   "get-deployment": "get-deployment DEPLOYMENT_ID",
   "wait-deployment": "wait-deployment DEPLOYMENT_ID [--poll-interval SECONDS] [--wait-timeout-seconds SECONDS]",
   "reconcile-deployment": "reconcile-deployment DEPLOYMENT_ID",
@@ -511,6 +511,9 @@ async function runBusinessCli(argv) {
     const params = {
       service: take(rest, "--service"),
       environment: take(rest, "--environment"),
+      package_id: take(rest, "--package-id"),
+      package_version: take(rest, "--package-version"),
+      model_artifact_id: take(rest, "--model-artifact-id"),
       state: take(rest, "--state"),
       q: take(rest, "--q", take(rest, "-q")),
     };

package/skills/model-deployment-management/references/operations.md

@@ -29,6 +29,21 @@ Use `get-deployment` to inspect the full revision history and endpoints. Use
 `list-deployments` for discovery and `get-deployment-events` for paginated
 audit evidence.
 
+Discover deployments associated with a packaged model without knowing the
+deployment ID first:
+
+```bash
+ml-platform --profile server list-deployments \
+  --package-id <package-id> \
+  --package-version <package-version> \
+  --model-artifact-id <artifact-id>
+```
+
+The filters may be used independently and combined with `--service`,
+`--environment`, `--state`, `--q`, `--limit`, and `--offset`. These results are
+ITSMP platform deployments; external model-center delivery callbacks are a
+separate status surface.
+
 For direct model access, declare `service_exposure.type=NodePort` in the same
 validated DeploymentSpec. After the revision is `READY`, read the observed
 `nodeport` endpoint instead of constructing a Service name. Given an observed

package/skills/model-lifecycle-management/references/evaluation.md

@@ -27,6 +27,16 @@ Inspect `get-metric-definition regression.mae v1` before relying on this metric.
 Release mode additionally requires at least one required validation rule with a
 business-approved threshold; do not invent thresholds to obtain PASS.
 
+For a fixed-length multi-step forecast, `regression.mae` and
+`regression.rmse` cover only the terminal point at the maximum trained horizon.
+Use `regression.trajectory_mae` and `regression.trajectory_rmse` for a release
+gate over the complete trajectory. These metrics flatten every valid
+`(anchor, horizon_step)` cell; they do not multiply the terminal metric by the
+prediction length. Inspect `forecast_metrics.parquet` for the per-step curve.
+When a trajectory metric is requested, prediction coverage requires every step
+of an anchor to be finite. A non-forecast ModelArtifact is rejected before
+Worker execution.
+
 Example `evaluation-request.json` shape; replace illustrative identities before
 validation or submission:
 

package/skills/model-lifecycle-management/references/training-contracts.md

@@ -265,7 +265,11 @@ contracts. Training `evaluation.split=auto` prefers nonempty test, then validati
 then train; choose an explicit split when reserving the test set for final review.
 Training metrics are not a governed EvaluationResult or release gate pass.
 
-For sequence outputs, current training and governed evaluation apply regression
-metrics to the terminal point at the trained maximum horizon. They do not yet
-provide per-step or whole-trajectory release gates; record this limitation when
-reporting evidence for a multi-point package.
+For sequence outputs, training feedback and governed `regression.mae` /
+`regression.rmse` retain terminal-point semantics at the trained maximum
+horizon. Governed evaluation additionally supports
+`regression.trajectory_mae` and `regression.trajectory_rmse`: they aggregate all
+valid `(anchor, horizon_step)` cells, while `forecast_metrics.parquet` records
+the per-step curve. Use a trajectory metric for multi-point release gates; do
+not multiply the terminal metric by `prediction_length` or report it as whole-
+trajectory quality.