@zhuoyuezs/ml-platform 0.2.3-alpha.1 → 0.2.3-alpha.2

package/README.md

@@ -107,6 +107,12 @@ ml-platform build-dataset /absolute/path/to/manifest.json --wait
 ml-platform --help
 ```
 
+定时预测上报的目标配置使用 `ml_data_platform.destination_profile/v2`
+和声明式 `payload_mapping`。在启用计划前，可用
+`ml-platform preview-destination-profile PROFILE_JSON STANDARD_PAYLOAD_JSON`
+查看映射后的请求体；具体合同和暂停/恢复流程见随包安装的
+`prediction-report-management` Skill。旧 v1 Profile 不可在 v2 API 上执行。
+
 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:f03d10f0de78e4ff456a6718b5b74b7fd001598f5a5963985d97d0b99403c0a5",
-      "size_bytes": 12756
+      "sha256": "sha256:e0bf5707e13eb8bc36b530741a476827eef8263f23ff796f064dc0bfae9a8bfb",
+      "size_bytes": 14154
     },
     {
       "path": "runtime/business-client/package-lock.json",
-      "sha256": "sha256:ebc31820ae0d2985879efd87ba4b0d8843e44a175d4c9e1dc557737893f8bdae",
+      "sha256": "sha256:fcc57e214724294f6208ec192dbe42b9cabbb6324945b0e93471bf991f76f0bc",
       "size_bytes": 1628
     },
     {
       "path": "runtime/business-client/package.json",
-      "sha256": "sha256:4685ca172b5b23bd5de53bcccbd7f7412df281eff67533d72d1b598c63a28b47",
+      "sha256": "sha256:61b2a01e7611af07ad49a1789cbaddb5f8ec36d70b78ef72d54227039990e8dc",
       "size_bytes": 671
     },
     {
@@ -22,8 +22,8 @@
     },
     {
       "path": "runtime/business-client/src/cli.js",
-      "sha256": "sha256:ecdc7d2e93323a4dd04514573219061f54db6583d955dfa82afc482abcd3335a",
-      "size_bytes": 66532
+      "sha256": "sha256:3913154693561ea4cea1538f560bf5e4f4b4488398abf69332f23f302481ee04",
+      "size_bytes": 66966
     },
     {
       "path": "runtime/business-client/src/config.js",
@@ -192,8 +192,8 @@
     },
     {
       "path": "skills/prediction-report-management/SKILL.md",
-      "sha256": "sha256:32abad9d9a152680d126cf1fa3df921a367a9ad9eb0aaaf3ce48b05538b4fbd5",
-      "size_bytes": 4365
+      "sha256": "sha256:35242893137502ece779eb3b66f0d5a2e36d10dd944af5e2fead20547c7866e3",
+      "size_bytes": 5923
     },
     {
       "path": "skills/prediction-report-management/agents/openai.yaml",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuoyuezs/ml-platform",
-  "version": "0.2.3-alpha.1",
+  "version": "0.2.3-alpha.2",
   "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:eaa88929b414e386294287009b4ecb25e26d1eb39403469ef649af145b2208de",
-    "version": "0.8.3"
+    "sha256": "sha256:a002eb1fb35605ad13ad071b2131233fd4b798e3438984ae1c4c6f4ddf262902",
+    "version": "0.8.4"
   },
   "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.3-alpha.1",
+  "release_version": "0.2.3-alpha.2",
   "runtime_requirements": {
     "node": ">=18",
     "os": [
@@ -37,34 +37,34 @@
   "skills": {
     "data-source-exploration": {
       "path": "skills/data-source-exploration",
-      "requires_cli": ">=0.8.3 <0.9.0",
-      "revision": "0.2.3-alpha.1",
+      "requires_cli": ">=0.8.4 <0.9.0",
+      "revision": "0.2.3-alpha.2",
       "sha256": "sha256:2fa1e1802d799ee0c47b10263f2fde57b604e505fea5c98bfa23f51f382bbf69"
     },
     "feature-management": {
       "path": "skills/feature-management",
-      "requires_cli": ">=0.8.3 <0.9.0",
-      "revision": "0.2.3-alpha.1",
+      "requires_cli": ">=0.8.4 <0.9.0",
+      "revision": "0.2.3-alpha.2",
       "sha256": "sha256:6dfa708172c3b5b23af75997c82a6d43bc2eb8ca67cc2275c8b95022455b0c42"
     },
     "model-deployment-management": {
       "path": "skills/model-deployment-management",
-      "requires_cli": ">=0.8.3 <0.9.0",
-      "revision": "0.2.3-alpha.1",
+      "requires_cli": ">=0.8.4 <0.9.0",
+      "revision": "0.2.3-alpha.2",
       "sha256": "sha256:d3f3fe0e4a11b93d8f6f57758164aa236b84a49c1b9f0d0b700fd9d6d615a8d7"
     },
     "model-lifecycle-management": {
       "path": "skills/model-lifecycle-management",
-      "requires_cli": ">=0.8.3 <0.9.0",
-      "revision": "0.2.3-alpha.1",
+      "requires_cli": ">=0.8.4 <0.9.0",
+      "revision": "0.2.3-alpha.2",
       "sha256": "sha256:8822fbec7037c2312d18b1d18648b60757fc569e6bf5f2856ea41592f3ba987d"
     },
     "prediction-report-management": {
       "path": "skills/prediction-report-management",
-      "requires_cli": ">=0.8.3 <0.9.0",
-      "revision": "0.2.3-alpha.1",
-      "sha256": "sha256:a0210cd93244bce41e5b71f8dc70c6c4a79973968cd22af7e0e0102eae3efaa3"
+      "requires_cli": ">=0.8.4 <0.9.0",
+      "revision": "0.2.3-alpha.2",
+      "sha256": "sha256:3a6991eec5cfa6bf30eaf43295f0c7d5c1e70e4f638904dfde1be2a39965d64f"
     }
   },
-  "source_commit": "07c13464f3ed2c10644ba6707d329b54f48e725d"
+  "source_commit": "bd2e27ea798072563389c412ec4cae2a61296ba6"
 }

package/runtime/business-client/README.md

@@ -84,13 +84,27 @@ Deployment Controller 管理的部署，不把模型中心回写的 delivery 状
 
 ```json
 {
-  "schema_version": "ml_data_platform.destination_profile/v1",
+  "schema_version": "ml_data_platform.destination_profile/v2",
   "name": "forecast_sink",
   "version": "v1",
   "environment": "test",
   "base_url": "https://integration.example.invalid/api",
   "path": "/forecast/report",
-  "payload_mapping": "forecast-report-v1",
+  "payload_mapping": {
+    "schema_version": "ml_data_platform.report_mapping/v1",
+    "body": {
+      "deviceCode": {"source": "entity.site", "type": "string"},
+      "cutoffTime": {"source": "cutoff_time", "type": "string"},
+      "source": {"constant": "ITSMP", "type": "string"},
+      "values": {
+        "source": "predictions", "type": "array",
+        "items": {"fields": {
+          "time": {"source": "target_time", "type": "string"},
+          "value": {"source": "value", "type": "number", "scale": 1.0, "offset": 0.0}
+        }}
+      }
+    }
+  },
   "authentication": {
     "kind": "token_endpoint",
     "token_request": {
@@ -111,14 +125,22 @@ Deployment Controller 管理的部署，不把模型中心回写的 delivery 状
 }
 ```
 
-`token_path`、业务成功码和 `/forecast/report` 只是示例，必须按目标接口的真实响应和路径配置。
-若响应提供有效期，可设置 `expires_in_path` 与 `expires_in_unit`；否则服务端默认按 7200 秒缓存，
+标准上下文包含 `run_id`、`schedule_id`、`deployment_id`、`deployment_revision`、`model_artifact_id`、
+`cutoff_time`、`entity`、`horizon`、`output_window`、`prediction_hash` 和标准化的
+`predictions`。每个 prediction point 至少包含 `series_index`、`value`，序列结果通常还包含
+`target_time`。`source` 引用平台标准预测结果中的字段；`fields` 生成嵌套对象，`items` 将数组逐项转换，
+`constant` 写入固定值，`template` 可拼接已存在的字符串字段。`format` 可格式化时间，
+`scale` 和 `offset` 可执行受控数值换算，`type` 校验最终类型。`token_path`、业务成功码和
+`/forecast/report` 只是示例，必须按目标接口的真实响应和路径配置。
+映射字段缺失或类型不匹配时不会发送请求，Run 会记录 `payload_mapping_failed`。若响应提供有效期，可设置 `expires_in_path` 与 `expires_in_unit`；否则服务端默认按 7200 秒缓存，
 并在 `refresh_skew_seconds` 前刷新。不同环境应使用不同 Profile 版本或名称；修改目标地址、
-认证规则或凭据时创建新版本。`get`/`list` 只返回凭据已配置的脱敏标记，无法取回明文。
+认证规则、映射或凭据时创建新版本。`get`/`list` 只返回凭据已配置的脱敏标记，无法取回明文。
 
 ```bash
 ml-platform --profile server validate-destination-profile /absolute/path/to/profile.json
 ml-platform --profile server create-destination-profile /absolute/path/to/profile.json
+ml-platform --profile server preview-destination-profile /absolute/path/to/profile.json \
+  /absolute/path/to/standard-prediction.json
 ml-platform --profile server list-destination-profiles --limit 50 --offset 0
 ml-platform --profile server get-destination-profile forecast_sink v1
 ```

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

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

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

@@ -40,7 +40,7 @@ const BUSINESS_COMMANDS = new Set([
     "get-deployment", "wait-deployment", "reconcile-deployment", "approve-deployment",
     "promote-deployment", "rollback-deployment", "suspend-deployment", "resume-deployment",
     "undeploy-deployment", "get-deployment-events", "predict-deployment",
-    "validate-destination-profile", "create-destination-profile", "list-destination-profiles", "get-destination-profile",
+    "validate-destination-profile", "create-destination-profile", "preview-destination-profile", "list-destination-profiles", "get-destination-profile",
     "create-prediction-report-schedule", "list-prediction-report-schedules", "get-prediction-report-schedule",
     "update-prediction-report-schedule", "pause-prediction-report-schedule", "resume-prediction-report-schedule",
     "list-prediction-report-runs", "get-prediction-report-run",
@@ -172,6 +172,7 @@ const COMMAND_USAGE = {
     "predict-deployment": "predict-deployment DEPLOYMENT_ID REQUEST_JSON",
     "create-destination-profile": "create-destination-profile PROFILE_JSON",
     "validate-destination-profile": "validate-destination-profile PROFILE_JSON",
+    "preview-destination-profile": "preview-destination-profile PROFILE_JSON STANDARD_PAYLOAD_JSON",
     "list-destination-profiles": "list-destination-profiles [--limit N] [--offset N]",
     "get-destination-profile": "get-destination-profile NAME VERSION",
     "create-prediction-report-schedule": "create-prediction-report-schedule SCHEDULE_JSON",
@@ -877,6 +878,12 @@ async function runBusinessCli(argv) {
     else if (["create-destination-profile", "validate-destination-profile"].includes(options.command)) {
         result = await client(options).post(options.command === "create-destination-profile" ? "/destination-profiles" : "/destination-profiles/validate", readSpec(positional(rest, "profile JSON")));
     }
+    else if (options.command === "preview-destination-profile") {
+        result = await client(options).post("/destination-profiles/preview", {
+            profile: readSpec(positional(rest, "profile JSON")),
+            payload: readSpec(positional(rest, "standard payload JSON")),
+        });
+    }
     else if (options.command === "list-destination-profiles") {
         result = await listCollection(client(options), "/destination-profiles", {}, rest);
     }

package/skills/prediction-report-management/SKILL.md

@@ -29,26 +29,62 @@ policy. A report run may be `SKIPPED` when the selected revision is not READY.
 ## Configure a destination
 
 The `PROFILE_JSON` argument is a local JSON file, not inline JSON. Include
-`schema_version`, `name`, `version`, `base_url`, `path`, authentication, and
-response success rules as required by the target. For token-based auth, set
-`authentication.token_request` parameters and `token_path`; configure both
-token and report business success rules when HTTP 2xx alone is insufficient.
+`schema_version: ml_data_platform.destination_profile/v2`, `name`,
+`version`, `base_url`, `path`, a declarative
+`payload_mapping`, authentication, and response success rules as required by
+the target. For token-based auth, set `authentication.token_request` parameters
+and `token_path`; configure both token and report business success rules when
+HTTP 2xx alone is insufficient.
+
+`payload_mapping` has `schema_version: ml_data_platform.report_mapping/v1`
+and a non-empty `body` object. This maps each normalized prediction point:
+
+```json
+{
+  "schema_version": "ml_data_platform.report_mapping/v1",
+  "body": {
+    "values": {
+      "source": "predictions",
+      "items": {"fields": {"value": {"source": "value", "type": "number"}}}
+    }
+  }
+}
+```
+
+A point always has `series_index` and `value`; `target_time` is present only
+when Serving returns it.
 
 ```bash
 ml-platform --profile server validate-destination-profile PROFILE_JSON
 ml-platform --profile server create-destination-profile PROFILE_JSON
+ml-platform --profile server preview-destination-profile PROFILE_JSON STANDARD_PAYLOAD_JSON
 ml-platform --profile server get-destination-profile NAME v1
 ```
 
 Validation checks schema and local policy; it does **not** call the token or
 report endpoint. Versions are immutable. Changes to URL, auth, token extraction,
-or success rules require a new profile version and a schedule update to point
-to it. `get` and `list` redact credential values; they cannot reconstruct the
+mapping, or success rules require a new profile version and a schedule update
+to point to it. Profiles stored with the former v1 schema cannot be executed
+under the v2 API; create a v2 profile and update the paused schedule first.
+`get` and `list` redact credential values; they cannot reconstruct the
 original file. Keep credential-bearing JSON outside the repository, restrict
 file access, and do not print its contents or put secrets in shell arguments,
 logs, examples, or Agent answers. Destination URL and token credentials are
 business configuration submitted through this API, not Kubernetes Secrets.
 
+Mapping sources use standard report fields such as `run_id`, `schedule_id`,
+`deployment_id`, `cutoff_time`, `entity`, and `predictions`. Use `fields` for
+nested objects, `items` for array conversion, `constant` for fixed values,
+`template` for string composition, and `format`, `scale`, `offset`, and `type`
+for bounded transformations and validation. Arbitrary code and expressions are
+not supported. A missing field or type failure produces
+`payload_mapping_failed` before any HTTP request is made.
+
+Use `preview-destination-profile` with a standard prediction payload to inspect
+the exact mapped business body before creating or enabling a schedule. Preview
+does not call the token endpoint, does not send the report, and does not store
+the profile or sample payload.
+
 ## Manage a schedule
 
 Creating a schedule starts reporting when `enabled` is true. Obtain explicit