@zhuoyuezs/ml-platform 0.1.10 → 0.1.12

package/checksums.json

@@ -0,0 +1,155 @@
+{
+  "files": [
+    {
+      "path": "runtime/business-client/README.md",
+      "sha256": "sha256:b823c0cafc47478fa1297c7c2e61e15b537db155586dd012b40d678d788c3ce3",
+      "size_bytes": 5158
+    },
+    {
+      "path": "runtime/business-client/package-lock.json",
+      "sha256": "sha256:cfd3633238713a21444bd4d1810e7ee2c48557157f9817be9b0e7c59a4dc46b3",
+      "size_bytes": 381
+    },
+    {
+      "path": "runtime/business-client/package.json",
+      "sha256": "sha256:e6bd1fd8a9cf49366a97f10e03b368c448d33f48df38f036a96c2979f1a2ec1b",
+      "size_bytes": 501
+    },
+    {
+      "path": "runtime/business-client/src/catalog.js",
+      "sha256": "sha256:5625abc155779d827850de475db104995feadea6b64d56419e3665005669225f",
+      "size_bytes": 54291
+    },
+    {
+      "path": "runtime/business-client/src/cli.js",
+      "sha256": "sha256:5a31e407dba79205e56d2ed1e74260213d0b89c6bb5a665ec0f52e92927ebcaf",
+      "size_bytes": 44897
+    },
+    {
+      "path": "runtime/business-client/src/config.js",
+      "sha256": "sha256:4190e09c339a3f0b2861ca7dbc96fe2aa3bdd7927a5e1c4a4c00103a53236bd8",
+      "size_bytes": 2186
+    },
+    {
+      "path": "runtime/business-client/src/http.js",
+      "sha256": "sha256:e515b39f19e7b5e7d6c2388e9cf2d8e2c9fd18b585bb53bd4f8eeeb7412af81c",
+      "size_bytes": 15192
+    },
+    {
+      "path": "skills/feature-management/SKILL.md",
+      "sha256": "sha256:e5b927611cd401bc5e6160a2d358369efd0c4f65d3fe5cbf21bbab9adb6bd978",
+      "size_bytes": 31991
+    },
+    {
+      "path": "skills/feature-management/agents/openai.yaml",
+      "sha256": "sha256:a4c69cb062dc52749f0c0c96ad2d16f91f83ecedb44f78dcf662ef220273f24d",
+      "size_bytes": 325
+    },
+    {
+      "path": "skills/feature-management/assets/catalog-template/catalog.json",
+      "sha256": "sha256:b2bf887040479082d8f09e5d1027b5a98c7a02b14a784dbb170c29568f14304d",
+      "size_bytes": 606
+    },
+    {
+      "path": "skills/feature-management/assets/catalog-template/datasets/example_temperature_training.v1.json",
+      "sha256": "sha256:4dbe304631d6ecbf60b19d7c5a377178e0593525362f5fe509c60622b99e8a46",
+      "size_bytes": 900
+    },
+    {
+      "path": "skills/feature-management/assets/catalog-template/feature_sets/example_temperature_core.v1.json",
+      "sha256": "sha256:22f37b954200864c19ed5593ab8455f562cc3dee7e05a0b01d5856a163dc0660",
+      "size_bytes": 352
+    },
+    {
+      "path": "skills/feature-management/assets/catalog-template/features/example_temperature_mean_5m.v1.json",
+      "sha256": "sha256:7e58fa9c6a5ef581866d5cae598682de73e5ef3ce49fdd630432bada3a8a41a1",
+      "size_bytes": 807
+    },
+    {
+      "path": "skills/feature-management/assets/catalog-template/operator_package/pyproject.toml",
+      "sha256": "sha256:df8b4087cb20ecd86736fc69d013a665e7c3dfa7dab80ffbc23279158dae5451",
+      "size_bytes": 295
+    },
+    {
+      "path": "skills/feature-management/assets/catalog-template/operator_package/src/business_feature_operator_template/__init__.py",
+      "sha256": "sha256:46a572cbd603299cb18692548480462208ec7b2696ba4f2fd90e1b15697e1a4b",
+      "size_bytes": 1366
+    },
+    {
+      "path": "skills/feature-management/assets/catalog-template/operator_package/tests/test_operator.py",
+      "sha256": "sha256:6fe073e07ed57d0fb4e782150153556b97c5b873b9eb2dad45df0d7f522d8650",
+      "size_bytes": 3678
+    },
+    {
+      "path": "skills/feature-management/assets/catalog-template/operators/example_temperature_features.v1.json",
+      "sha256": "sha256:646965a05b982ae291960b23f359403c69bf8a173d6cc65d706fb2dc53ab030b",
+      "size_bytes": 1277
+    },
+    {
+      "path": "skills/feature-management/assets/catalog-template/parameters/example_temperature.v1.json",
+      "sha256": "sha256:28c7d3576c4b7e94c1e9db7f95f26d83ee2e10dc9f81ec6223f4fbd9b2f5eeda",
+      "size_bytes": 1488
+    },
+    {
+      "path": "skills/feature-management/references/commands.md",
+      "sha256": "sha256:c748f1877f6d2ac1f6ecc29e45cd270997cbd35b498a190decddb66c74b840ab",
+      "size_bytes": 13751
+    },
+    {
+      "path": "skills/feature-management/references/contracts.md",
+      "sha256": "sha256:4e10ba13399de17561a10b1dead4e2fcc57e0962cf81eba5131d12d66c4ce013",
+      "size_bytes": 29965
+    },
+    {
+      "path": "skills/feature-management/references/operator-authoring.md",
+      "sha256": "sha256:2ecfccbc9fe771bc1103db679d67af78847307eeb440f680f4055c35405ac923",
+      "size_bytes": 6089
+    },
+    {
+      "path": "skills/feature-management/references/platform-capability-guide.md",
+      "sha256": "sha256:6acb35f57e1bd6385702b6114e96c0ed1db34c9650d18658f74f212af9f91d14",
+      "size_bytes": 4423
+    },
+    {
+      "path": "skills/feature-management/references/supervised-datasets.md",
+      "sha256": "sha256:2c7a894330a649248e7f52c944422bcd7a3aba4558f7984d129dfd21c8736cf3",
+      "size_bytes": 4540
+    },
+    {
+      "path": "skills/model-lifecycle-management/SKILL.md",
+      "sha256": "sha256:faa4f8c0dbae7d1c1e2ca94499ce9b13cc8b52e8229154c05ac6282ea5e47788",
+      "size_bytes": 3610
+    },
+    {
+      "path": "skills/model-lifecycle-management/agents/openai.yaml",
+      "sha256": "sha256:37857849a8baa6b06b6d5d07ae6036080239356fcccd36f77bbdc52c1dfa283f",
+      "size_bytes": 249
+    },
+    {
+      "path": "skills/model-lifecycle-management/references/discovery.md",
+      "sha256": "sha256:c87a9efacb1a18125bc1ee1b3061c5a9b876355e238aa5f7f17a985014413281",
+      "size_bytes": 4899
+    },
+    {
+      "path": "skills/model-lifecycle-management/references/evaluation.md",
+      "sha256": "sha256:099fc54af2a1d8bed287f9e557cee8583558e594880235c32b89276b385cce90",
+      "size_bytes": 8858
+    },
+    {
+      "path": "skills/model-lifecycle-management/references/packaging.md",
+      "sha256": "sha256:0992f2f9104cb0d65a6325756108211d3f94856e05eca12640e9792c07e1108f",
+      "size_bytes": 3250
+    },
+    {
+      "path": "skills/model-lifecycle-management/references/training-contracts.md",
+      "sha256": "sha256:b6d72f37adf40c7d3832dbe46645cd416485411dcd48ea7b93f6072d458922c9",
+      "size_bytes": 11825
+    },
+    {
+      "path": "skills/model-lifecycle-management/references/training.md",
+      "sha256": "sha256:f7bb40919da78b99cad13d4f1f05fef136552409df5ba6e2838e1e6b4a2435a5",
+      "size_bytes": 5508
+    }
+  ],
+  "schema_version": "data_platform.ml_platform_checksums/v1"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuoyuezs/ml-platform",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "ML 数据平台 business CLI 与 Agent Skills 管理工具",
   "bin": {
     "ml-platform": "scripts/main.js"
@@ -19,7 +19,8 @@
   "scripts": {
     "test": "node --test test/*.test.js",
     "api:check": "node ../../scripts/check_api_contract.js",
-    "pack": "npm pack"
+    "pack": "npm pack",
+    "prepublishOnly": "node scripts/verify-release-package.js"
   },
   "engines": {
     "node": ">=18"

package/release.json

@@ -0,0 +1,52 @@
+{
+  "agent_adapters": [
+    "codex-user",
+    "codex-project",
+    "explicit-skills-dir"
+  ],
+  "api_compatibility": {
+    "contract": "current-unversioned",
+    "health_check_required": true,
+    "note": "The deployed API does not yet expose a machine-readable API version."
+  },
+  "cli": {
+    "entrypoint": "src/cli.js",
+    "name": "ml-platform",
+    "path": "runtime/business-client",
+    "sha256": "sha256:0c928cad92c70c10b00d58a8bd9bd95f0bf88ac2f876c7967c67c5b17bfbfa2c",
+    "version": "0.7.2"
+  },
+  "policy_sha256": "sha256:02fbde0134696b78c0c365d6e0b76c9814227208da5b2b3d4e5dbd82dc4a3606",
+  "public_schema_versions": [
+    "ml_data_platform.catalog/v1",
+    "ml_data_platform.parameter/v1",
+    "ml_data_platform.operator/v1",
+    "ml_data_platform.feature/v1",
+    "ml_data_platform.feature_set/v1",
+    "ml_data_platform.dataset_manifest/v1"
+  ],
+  "release_version": "0.1.12",
+  "runtime_requirements": {
+    "node": ">=18",
+    "os": [
+      "darwin",
+      "linux"
+    ]
+  },
+  "schema_version": "data_platform.ml_platform_release/v2",
+  "skills": {
+    "feature-management": {
+      "path": "skills/feature-management",
+      "requires_cli": ">=0.7.2 <0.8.0",
+      "revision": "0.1.12",
+      "sha256": "sha256:182b6f2df4fe58c946e482dfaf416c7d5b78c6fde9c8c8d7293103246618cb4e"
+    },
+    "model-lifecycle-management": {
+      "path": "skills/model-lifecycle-management",
+      "requires_cli": ">=0.7.2 <0.8.0",
+      "revision": "0.1.12",
+      "sha256": "sha256:61ba17f955b36d1c2e8329a10454d040ee7eca5afdb90ff0914d3f85b6e2d203"
+    }
+  },
+  "source_commit": "0246c26b396ce551fed3a9c8d4341a2230765025"
+}

package/runtime/business-client/README.md

@@ -0,0 +1,110 @@
+# Business Client JS
+
+工业时序智能建模平台唯一受支持的业务 CLI 与 API client 实现。客户端合同由平台
+OpenAPI 快照、JavaScript 单元测试和 npm 发布测试直接验证；
+本目录是业务 CLI 的唯一 JavaScript 实现源码，Skill 通过外部 `ml-platform` 命令调用它，
+不复制或内嵌本目录的 runtime。
+
+```bash
+npm test --prefix business-client-js
+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 内项目不一致时拒绝执行。
+
+同一 Parameter 需要从历史库训练、从实时库取数时，在 Parameter JSON 同时填写 `source` 与
+可选的 `online_source`，然后照常使用 `add-parameter` 或 Catalog `apply`；CLI 原样透传该
+字段，不需要额外参数。离线构建读取 `source`，实时因果读取自动选择 `online_source`。
+
+Registry 资产详情和版本发现使用与 `dev` OpenAPI 一致的命令：
+
+```bash
+ml-platform get-parameter <name> <version> --project <project>
+ml-platform get-feature <name> <version> --project <project>
+ml-platform list-feature-versions <name> --project <project> --all
+ml-platform list-jobs --project <project> --status succeeded --all
+```
+
+平台资源生命周期与部署绑定的因果上下文读取也由同一 CLI 覆盖：
+
+```bash
+ml-platform list-parameter-references <name> <version> --project <project>
+ml-platform get-parameter-lifecycle <name> <version> --project <project>
+ml-platform fetch-inference-context /absolute/path/to/request.json
+```
+
+已部署模型的标准推理使用 Serving URL，不使用控制面 `--api-url`。Chronos-2 v2 的
+`known_future` 协变量放在 inline 请求的 `inputs.future_covariates` 中；每个预测步一行，
+行数必须等于模型的 `prediction_length`。下例为 15 分钟频率、预测 30 分钟；预测明天时
+同样提供整天的所有未来步：
+
+```json
+{
+  "input_mode": "inline",
+  "cutoff_time": "2026-09-09T00:00:00+08:00",
+  "horizon": [{"duration": "PT30M"}],
+  "inputs": {
+    "timestamps": ["...", "2026-09-09T00:00:00+08:00"],
+    "values": [{"storage_soc": 51.2, "storage_power": 4.0}, {"storage_soc": 52.0, "storage_power": 3.8}],
+    "future_covariates": [
+      {"weather_temperature": 28.0, "peak_valley": 1},
+      {"weather_temperature": 27.5, "peak_valley": 1}
+    ]
+  }
+}
+```
+
+```bash
+ml-platform predict-model /absolute/path/to/request.json \
+  --serving-url https://storage-forecast.example
+```
+
+训练历史必须使用各个历史 cutoff 当时可取得的天气预报，不得以事后实测天气替代。
+
+Parameter、Feature、FeatureSet 的删除命令执行软删除，并支持带 actor、reason 和幂等键的
+恢复；调用方应在任何变更前查询直接与传递引用。
+
+仓库中的 `api-spec/latest.json` 从 `origin/dev` 生成。同步或验证契约时运行：
+
+```bash
+uv run python scripts/generate_openapi_schema.py --ref origin/dev
+uv run python scripts/generate_openapi_schema.py --ref origin/dev --check
+npm run api:check --prefix business-client-js
+```
+
+## Lifecycle discovery and preflight
+
+Use `get-model-runtime-release` to inspect approved trainer/device/image bindings
+and the effective evaluation identity. Find immutable resources with
+`list-training-runs`, `list-training-jobs`, `list-model-artifacts`,
+`list-evaluation-configs`, `list-evaluation-runs`, `list-evaluation-jobs`,
+`list-metric-definitions`, `list-executable-packages`, and `list-model-packages`.
+These commands accept `-q`, `--limit` (1–500), and `--offset`; responses contain
+`items`, `total`, `limit`, `offset`. Query matches serialized metadata substrings.
+Use the returned exact IDs with detail commands; Job lists contain immutable
+specs, while Job detail refreshes status.
+
+`validate-training-job REQUEST_JSON` and `validate-model-package REQUEST_JSON`
+resolve the same contracts as submission without registering or scheduling
+workloads. Read `submitted=false` and `unchecked`: successful preflight does not
+verify image pulls, cluster resources or runtime execution. Complete request
+examples and identity propagation are in the bundled model lifecycle Skill.
+
+Maintainers can export the current API, including uncommitted schema changes,
+with `uv run python scripts/generate_openapi_schema.py --working-tree` from the
+repository root; use `--check` with it to verify the committed snapshot.

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

@@ -0,0 +1,19 @@
+{
+  "name": "@zhuoyuezs/ml-platform-business-client",
+  "version": "0.7.2",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@zhuoyuezs/ml-platform-business-client",
+      "version": "0.7.2",
+      "license": "UNLICENSED",
+      "bin": {
+        "ml-platform": "src/cli.js"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    }
+  }
+}

package/runtime/business-client/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@zhuoyuezs/ml-platform-business-client",
+  "version": "0.7.2",
+  "private": true,
+  "description": "JavaScript implementation of the ML Platform business client",
+  "bin": {
+    "ml-platform": "src/cli.js"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.js",
+    "api:check": "node ../scripts/check_api_contract.js",
+    "pack": "npm pack"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "UNLICENSED",
+  "dependencies": {}
+}