@zhuoyuezs/ml-platform 0.2.10 → 0.2.11

package/checksums.json

@@ -2,17 +2,17 @@
   "files": [
     {
       "path": "runtime/business-client/README.md",
-      "sha256": "sha256:9f81e4400f46c53952a0df6f7442d4c0b58cff4ca1be61f1daf785e111b3f8eb",
-      "size_bytes": 20557
+      "sha256": "sha256:9b56dde8e0db3a426e45b70595558b3ff461b79a867913a36978db90b963dfc0",
+      "size_bytes": 21439
     },
     {
       "path": "runtime/business-client/package-lock.json",
-      "sha256": "sha256:9d19700ee4b348406bd0134f0539c37c2800e41a87dc130c1b0476eb2d23b931",
+      "sha256": "sha256:aaed1feb38250bcfa11284f54ff715dadadf848efece51b23aa133f110bd1358",
       "size_bytes": 1628
     },
     {
       "path": "runtime/business-client/package.json",
-      "sha256": "sha256:d967d64289276cf1ce94f826a138f60fc93982b7478c1fb9f78f068f47f9d803",
+      "sha256": "sha256:bb5daa3e966f815c89ff5517962ddfe8a0dd5b767a2130d26c27c9cd987a8a0f",
       "size_bytes": 671
     },
     {
@@ -27,8 +27,8 @@
     },
     {
       "path": "runtime/business-client/src/cli.js",
-      "sha256": "sha256:143ce6e82d861fae647384e3617ec0f0222fef7c8e7b546ca67393fba8bd08b5",
-      "size_bytes": 85198
+      "sha256": "sha256:d3d2eb31c4508e532f634a63a057e2737bf60c4f7ccd966d156f71ab3e40fcbf",
+      "size_bytes": 85426
     },
     {
       "path": "runtime/business-client/src/config.js",
@@ -37,8 +37,8 @@
     },
     {
       "path": "runtime/business-client/src/http.js",
-      "sha256": "sha256:91dc66d086deb5b5c0fd016560e6fddd369ccce9d430ce8f926bcae3f324cc86",
-      "size_bytes": 29035
+      "sha256": "sha256:2387545e4548c60148b69a3bf5a8ae98a369e387e54de47da4327a957f541c35",
+      "size_bytes": 29525
     },
     {
       "path": "skills/data-source-exploration/SKILL.md",
@@ -57,8 +57,8 @@
     },
     {
       "path": "skills/feature-management/SKILL.md",
-      "sha256": "sha256:f7777f43adf83cf4ee663c1e993f2f3d6221054f02e3cdcd24e65db36990141e",
-      "size_bytes": 36116
+      "sha256": "sha256:df6ca953ce7b1ad8dc8edb7a47cde02fc9cb6a70c1bf3a9a47d68b01ad642256",
+      "size_bytes": 36599
     },
     {
       "path": "skills/feature-management/agents/openai.yaml",
@@ -112,8 +112,8 @@
     },
     {
       "path": "skills/feature-management/references/commands.md",
-      "sha256": "sha256:248721ee995ebb20ea44a263f528e1af6004f7af55d31503185f6269744dee8d",
-      "size_bytes": 18829
+      "sha256": "sha256:8298c55378579aad151b86ff8a00d0c7cf992378b7c6af262d94564544dc4a3c",
+      "size_bytes": 19411
     },
     {
       "path": "skills/feature-management/references/contracts.md",
@@ -167,8 +167,8 @@
     },
     {
       "path": "skills/model-lifecycle-management/SKILL.md",
-      "sha256": "sha256:099973e2dd334beac12e275ee184d3ce500f6c307ae339e3400e585d8ad88a8e",
-      "size_bytes": 7833
+      "sha256": "sha256:920473f386f191e7492088e6d84bf33458ee57e97fb8b1db1d7274722ae871ad",
+      "size_bytes": 8043
     },
     {
       "path": "skills/model-lifecycle-management/agents/openai.yaml",
@@ -217,8 +217,8 @@
     },
     {
       "path": "skills/model-lifecycle-management/references/zero-shot-inference.md",
-      "sha256": "sha256:4ea224be54a7b0fc7754bdaa41df0f3b14c56f5134afc3951e91e59844108f90",
-      "size_bytes": 2350
+      "sha256": "sha256:cae4675f0ae6f57482bcc7d2df956ee10495709f09f1d118b7a8bb565f1227f1",
+      "size_bytes": 5402
     },
     {
       "path": "skills/prediction-report-management/SKILL.md",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuoyuezs/ml-platform",
-  "version": "0.2.10",
+  "version": "0.2.11",
   "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:5b83423598eb2c8afae8765e4315a9432cc026d1779348808c6516432820e67e",
-    "version": "0.8.7"
+    "sha256": "sha256:b6e415ea6031b7dd7c838f09c50c1b22501591754c6deedbdcd444d39eb498f7",
+    "version": "0.8.8"
   },
   "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.10",
+  "release_version": "0.2.11",
   "runtime_requirements": {
     "node": ">=18",
     "os": [
@@ -37,34 +37,34 @@
   "skills": {
     "data-source-exploration": {
       "path": "skills/data-source-exploration",
-      "requires_cli": ">=0.8.7 <0.9.0",
-      "revision": "0.2.10",
+      "requires_cli": ">=0.8.8 <0.9.0",
+      "revision": "0.2.11",
       "sha256": "sha256:9614e6901fcfeac7e0779caee7a8ab1df40b39d08161967e51b459c266b82f90"
     },
     "feature-management": {
       "path": "skills/feature-management",
-      "requires_cli": ">=0.8.7 <0.9.0",
-      "revision": "0.2.10",
-      "sha256": "sha256:c2f109d11ddfdfe9deaa2da077cd11f374bc8cef0db6155572fbb24defab39f7"
+      "requires_cli": ">=0.8.8 <0.9.0",
+      "revision": "0.2.11",
+      "sha256": "sha256:f9ec42124113d63a261e31d0f06959f2c7420370dfc1b6a84fcb2f5011310c45"
     },
     "model-deployment-management": {
       "path": "skills/model-deployment-management",
-      "requires_cli": ">=0.8.7 <0.9.0",
-      "revision": "0.2.10",
+      "requires_cli": ">=0.8.8 <0.9.0",
+      "revision": "0.2.11",
       "sha256": "sha256:ef13c737a098e9a582dfa6f7c54777c00a9efbc7af894c7aea35b9db4a97aa15"
     },
     "model-lifecycle-management": {
       "path": "skills/model-lifecycle-management",
-      "requires_cli": ">=0.8.7 <0.9.0",
-      "revision": "0.2.10",
-      "sha256": "sha256:02fc9451ae888bec7ae1aa38bf51c3c8f657c6f899506ce323f17552b2dd31a0"
+      "requires_cli": ">=0.8.8 <0.9.0",
+      "revision": "0.2.11",
+      "sha256": "sha256:5f95a65d649c946ab64f72b127ad8861e20623b05b6a937cad953a4eb2eadfe3"
     },
     "prediction-report-management": {
       "path": "skills/prediction-report-management",
-      "requires_cli": ">=0.8.7 <0.9.0",
-      "revision": "0.2.10",
+      "requires_cli": ">=0.8.8 <0.9.0",
+      "revision": "0.2.11",
       "sha256": "sha256:399e5838604b5ce0248be702b70be2deaaf8f644e5518c91c45d21e0d2f43e53"
     }
   },
-  "source_commit": "b9b4ec03474a9ff7b11bae35eacf8302bcb97d0c"
+  "source_commit": "c4ba6b6d1f0010eabbc269db5a8642b0c137944d"
 }

package/runtime/business-client/README.md

@@ -58,6 +58,16 @@ ml-platform list-feature-versions <name> --project <project> --all
 ml-platform list-jobs --project <project> --status succeeded --all
 ```
 
+本地 CSV/Parquet 可上传为不可变 Parameter source，再通过 `add-parameter` 注册显式列映射；后续仍使用既有 Feature、FeatureSet 和 Dataset build 流程生成标准 DatasetArtifact：
+
+```bash
+ml-platform upload-source-file /absolute/path/to/measurements.csv
+ml-platform add-parameter /absolute/path/to/parameter.json
+ml-platform build-registered-dataset <dataset_id> <dataset_version> --project <project> --wait
+```
+
+上传响应提供 `object_uri`、`object_sha256`、格式和列预览。Parameter 的 `source.adapter` 使用 `local_file`，并显式设置 `object_uri`、`object_sha256`、`file_format`、`time_column` 和 `value_column`；筛选条件使用 `filters`。上传不会推断业务字段、注册资产或创建 DatasetArtifact。当前首期支持单文件，不支持 ZIP/多文件合并或直接将原始文件作为训练数据集。
+
 平台资源生命周期与部署绑定的因果上下文读取也由同一 CLI 覆盖：
 
 ```bash

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

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

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

@@ -31,7 +31,7 @@ const BUSINESS_COMMANDS = new Set([
     "get-parameter-lifecycle", "get-feature-lifecycle", "get-feature-set-lifecycle", "get-parameter-freshness",
     "list-parameter-references", "list-feature-references", "list-feature-set-references",
     "list-parameter-versions", "list-feature-versions", "list-feature-set-versions", "list-operator-versions",
-    "add-parameter", "add-feature", "add-feature-set", "add-operator", "publish-operator",
+    "add-parameter", "add-feature", "add-feature-set", "add-operator", "publish-operator", "upload-source-file",
     "add-dataset", "update-dataset", "delete-dataset", "list-dataset-artifacts",
     "register-operator", "show-operator-specs", "delete-operator", "run-operator",
     "get-job", "wait-job", "retry-job", "cancel-job", "get-dataset-artifact", "download-dataset-artifact", "fetch-inference-data", "fetch-inference-context", "predict-model", "apply",
@@ -122,6 +122,7 @@ const COMMAND_USAGE = {
     "add-feature-set": "add-feature-set SPEC_JSON",
     "add-operator": "add-operator SPEC_JSON",
     "publish-operator": "publish-operator SPEC_JSON --package PATH",
+    "upload-source-file": "upload-source-file FILE",
     "add-dataset": "add-dataset MANIFEST_JSON [--force]",
     "update-dataset": "update-dataset MANIFEST_JSON [--force]",
     "delete-dataset": "delete-dataset DATASET_ID DATASET_VERSION [--project PROJECT]",
@@ -624,6 +625,9 @@ async function runBusinessCli(argv, output = { write: text => process.stdout.wri
         const published = { ...spec, code_hash: upload.code_artifact.sha256, package_uri: upload.code_artifact.uri, code_artifact: upload.code_artifact };
         result = { status: "published", profile: "server", path: null, operator: published, registration: await api.post("/operators", published) };
     }
+    else if (options.command === "upload-source-file") {
+        result = await client(options).uploadSourceFile(positional(rest, "source file"));
+    }
     else if (options.command === "get-dataset") {
         const datasetId = positional(rest, "dataset id");
         const datasetVersion = positional(rest, "dataset version");

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

@@ -212,6 +212,15 @@ class PlatformApiClient {
             params: { filename: path.basename(resolved) }, body: fs.readFileSync(resolved), contentType: "application/octet-stream",
         });
     }
+    uploadSourceFile(filePath) {
+        const resolved = path.resolve(expandHome(filePath));
+        if (!fs.existsSync(resolved) || !fs.statSync(resolved).isFile())
+            throw new Error(`source file not found: ${resolved}`);
+        const filename = path.basename(resolved).replace(/["\r\n]/g, "_");
+        return this.request("POST", "/source-files", {
+            params: { filename }, body: fs.readFileSync(resolved), contentType: "application/octet-stream",
+        });
+    }
     async downloadDatasetArtifact(project, datasetId, manifestHash, outputDir, force = false) {
         const target = path.resolve(expandHome(outputDir));
         if (fs.existsSync(target) && fs.readdirSync(target).length) {

package/skills/feature-management/SKILL.md

@@ -53,7 +53,8 @@ Keep these evidence rules active in every workflow:
 5. Read [references/commands.md](references/commands.md) immediately before a platform CLI action: discovery, validation, publication, build, realtime fetch, or artifact download. A local-only draft that is forbidden to call the CLI does not need this reference.
 6. Use [assets/catalog-template](assets/catalog-template) as a copyable starting point for a new end-to-end catalog. Rename every `example_*` identifier and update every referenced path before validation.
 7. Read [references/data-platform-mapping.md](references/data-platform-mapping.md) when binding published external data-platform Mapping outputs to Parameters.
-8. Read [references/platform-capability-guide.md](references/platform-capability-guide.md) only when selecting an asset type or explaining a platform capability. Do not load it merely to write a confirmed local draft; it is never evidence for unresolved business semantics.
+8. For a local CSV or Parquet input, use `upload-source-file FILE` from [references/commands.md](references/commands.md). Treat the returned content-addressed URI and SHA-256 as an immutable `local_file` Parameter source; inspect the returned columns and explicitly define the Parameter before creating Features. Uploading a file does not publish a DatasetArtifact or start training. ZIPs, directory joins, and direct precomputed Artifact imports are not supported by this workflow.
+9. Read [references/platform-capability-guide.md](references/platform-capability-guide.md) only when selecting an asset type or explaining a platform capability. Do not load it merely to write a confirmed local draft; it is never evidence for unresolved business semantics.
 
 ## Initialize The Client
 

package/skills/feature-management/references/commands.md

@@ -162,6 +162,18 @@ ml-platform --profile server apply <catalog-directory> --project <project>
 Parameter -> Operator package/Operator -> Feature -> FeatureSet -> Dataset
 ```
 
+For a local CSV or Parquet source, upload the immutable source object first:
+
+```bash
+ml-platform --profile server upload-source-file ./measurements.parquet
+```
+
+Use the response `object_uri`, `object_sha256`, `file_format`, and `columns` in an explicit
+`ParameterSpec.source` with `adapter: "local_file"`, `time_column`, and `value_column`. The
+platform then reads the Parameter through the normal Dataset build and Operator chain. Uploading
+a file alone never publishes a DatasetArtifact and never starts training; ZIPs and multi-file joins
+require a separate manifest contract.
+
 The cross-store publication is not transactional. If an error occurs, report the returned progress summary and rerun only after understanding which immutable assets were already published.
 
 ## Resolve And Build A Dataset

package/skills/model-lifecycle-management/SKILL.md

@@ -63,6 +63,9 @@ the user wants synchronous zero-shot forecasting from JSON or CSV. This path
 uses the platform-owned `chronos2_forecaster` model name, not a public project
 or contract version, and does not create a TrainingRun, ModelArtifact,
 PredictionJob or prediction result record.
+Before sending a prediction, use the reference's complete request example and
+preflight checklist. The nested schema is a strict versioned contract; do not
+discover its fields through successive 422 responses.
 
 ## Shared Gates
 

package/skills/model-lifecycle-management/references/zero-shot-inference.md

@@ -29,6 +29,74 @@ ml-platform --profile server predict-foundation \
 
 The endpoint is `POST /foundation-models/chronos2_forecaster/predict`.
 
+### Complete request shape and preflight
+
+Build the whole request from the versioned schema before calling the CLI. This
+minimal example uses three hourly historical observations and forecasts six
+steps. Replace the timestamps and values with the user's data, keeping the
+timestamp grid aligned to `frequency` and ending exactly at `cutoff_time`.
+
+```json
+{
+  "input": {"transport": "json_records"},
+  "schema": {
+    "schema_version": "ml_data_platform.prediction_input_schema/v1",
+    "layout": "long",
+    "timestamp_column": "timestamp",
+    "series_keys": [],
+    "targets": ["temperature"],
+    "past_covariates": [],
+    "known_future_covariates": [],
+    "frequency": "1h",
+    "timezone": "UTC",
+    "cutoff_time": "2026-01-01T02:00:00Z"
+  },
+  "records": [
+    {"timestamp": "2026-01-01T00:00:00Z", "temperature": 20.1},
+    {"timestamp": "2026-01-01T01:00:00Z", "temperature": 20.3},
+    {"timestamp": "2026-01-01T02:00:00Z", "temperature": 20.2}
+  ],
+  "forecast": {
+    "horizon_steps": 6,
+    "statistics": ["median"]
+  }
+}
+```
+
+Before the one prediction call, verify all of the following:
+
+- `schema.schema_version` is exactly `ml_data_platform.prediction_input_schema/v1`;
+- `input.transport` is `json_records`, and the top-level keys are `input`,
+  `schema`, `records` and `forecast`;
+- every record has exactly the timestamp, series-key, target, past-covariate
+  and known-future-covariate columns declared in `schema`; role names are
+  disjoint;
+- `schema.cutoff_time` is timezone-aware, appears as the final historical
+  timestamp in every series, and all historical timestamps form a regular grid
+  at `schema.frequency` with no duplicates or gaps;
+- historical target values are numeric and non-null; do not include rows after
+  cutoff unless known-future covariates are declared;
+- `forecast.horizon_steps` is a positive integer within the discovered active
+  release's `max_prediction_length`; it counts frequency intervals, not a
+  duration string. There is no `output_window` field in this API contract;
+- request rows and serialized bytes are within the discovered release limits.
+
+When known-future covariates are used, declare them in
+`schema.known_future_covariates`, include their historical values as well, and
+provide exactly one future row for every forecast step. Future target values
+must be null. Do not add future rows when no known-future covariates are
+declared.
+
+If the CLI rejects the request, inspect the complete structured error once and
+compare its named field/value with this contract and the discovered release
+capabilities. Correct only a confirmed mismatch, then make at most one
+corrected retry. Do not guess a schema version, rename fields speculatively, or
+loop through 422s. If the error conflicts with this versioned contract or does
+not identify a correctable input issue, stop and report the response for
+server-side contract investigation. Report success only when the CLI returns a
+successful prediction response; include its request/prediction ID and returned
+release identity when present.
+
 ## CSV prediction
 
 CSV uses the same schema and forecast JSON as the JSON path. The CLI sends one