@zhuoyuezs/ml-platform 0.1.9 → 0.1.10

package/README.md

@@ -1,6 +1,6 @@
 # ML Platform
 
-ML Platform 的 JavaScript CLI 和 `feature-management` Agent Skill。CLI 与 Skill 由同一个 npm
+ML Platform 的 JavaScript CLI、`feature-management` 与 `model-lifecycle-management` Agent Skill。CLI 与 Skill 由同一个 npm
 release 安装和升级，运行时不需要 Python 或 `uv`。
 
 ## 环境要求
@@ -17,8 +17,8 @@ release 安装和升级，运行时不需要 Python 或 `uv`。
 npx @zhuoyuezs/ml-platform@latest install
 ```
 
-这条命令不需要额外参数。默认安装持久化的 `ml-platform` 命令，并将 Skill 安装到
-`~/.codex/skills/feature-management/`，供当前用户的 Codex 使用。安装后重启终端和 Agent 会话。
+这条命令不需要额外参数。默认安装持久化的 `ml-platform` 命令，并将两个 Skill 安装到
+`~/.codex/skills/`，供当前用户的 Codex 使用。安装后重启终端和 Agent 会话。
 
 只在当前项目使用 Skill 时，在项目根目录运行：
 
@@ -103,6 +103,10 @@ ml-platform --help
 受控构建，不要求本地存在 Catalog。`apply`、`resolve-manifest` 和带本地 JSON 路径的
 `build-dataset` 用于新契约的编写和发布流程。
 
+Parameter JSON 可同时声明离线 `source` 和可选的实时 `online_source`。通过
+`ml-platform add-parameter <spec.json>` 或 Catalog `apply` 正常发布即可；客户端原样提交
+字段，离线构建使用 `source`，`fetch-inference-data` 使用 `online_source`。
+
 ## 迁移旧 Skill
 
 目标目录存在旧 Python Skill、实验 symlink 或其他未托管 Skill 时，确认后显式备份：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuoyuezs/ml-platform",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "ML 数据平台 business CLI 与 Agent Skills 管理工具",
   "bin": {
     "ml-platform": "scripts/main.js"

package/checksums.json

@@ -1,155 +0,0 @@
-{
-  "files": [
-    {
-      "path": "runtime/business-client/README.md",
-      "sha256": "sha256:02e6561b80cbef3cce2fd690750d863d8afb9c45bf5ccfcce3e3e2b082ff0761",
-      "size_bytes": 3780
-    },
-    {
-      "path": "runtime/business-client/package-lock.json",
-      "sha256": "sha256:d5e7102ec51df3192ae901908f36cf0380aba5a0421b9824877403ab034d6740",
-      "size_bytes": 381
-    },
-    {
-      "path": "runtime/business-client/package.json",
-      "sha256": "sha256:9e815ffe0487eb216447f4a4b31d248fe37392e08f0fd4bae2aba9c4f4285547",
-      "size_bytes": 501
-    },
-    {
-      "path": "runtime/business-client/src/catalog.js",
-      "sha256": "sha256:8dcc4c4baff7f292a6fb09d6f82693b5ce7da16b9f0a9e03b22e1f18e893240f",
-      "size_bytes": 53659
-    },
-    {
-      "path": "runtime/business-client/src/cli.js",
-      "sha256": "sha256:6ee4ed29a9df9f462502ccc0e10d5d9109bf00b52b8c27c9808730c7d8520592",
-      "size_bytes": 44480
-    },
-    {
-      "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:5b3ce57d84f11188579227dd42617075f87534ac113a3f37b3543c85c0ff0b3d",
-      "size_bytes": 31114
-    },
-    {
-      "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:d9ff95edb3ac50cb590df640c5034d45ddd5b758431a4ae2e69eb807bb659314",
-      "size_bytes": 28449
-    },
-    {
-      "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:98437e919b6d76822b2a3521713400b2c73ae42fbe5086f2e0b864aadd6cbf55",
-      "size_bytes": 3464
-    },
-    {
-      "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:8435283061d740e57aafc90fa402cd89adcd8e2e957805b3d435ea4ba1f8721c",
-      "size_bytes": 3142
-    },
-    {
-      "path": "skills/model-lifecycle-management/references/training-contracts.md",
-      "sha256": "sha256:1d1fa51ef7deb6abf178cf019eb69e8ee6a93ecb018029780f01a33696473dd6",
-      "size_bytes": 8229
-    },
-    {
-      "path": "skills/model-lifecycle-management/references/training.md",
-      "sha256": "sha256:370d5e663292ce1bdcf0eb88c133c07a77f57dd31e21748906c92aa3407c4e95",
-      "size_bytes": 4516
-    }
-  ],
-  "schema_version": "data_platform.ml_platform_checksums/v1"
-}

package/release.json

@@ -1,52 +0,0 @@
-{
-  "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:fb2ebe76ddba0ccfcd052741e8e290e25fc2897df7656d48267e82fe6be06d1c",
-    "version": "0.7.0"
-  },
-  "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.9",
-  "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.0 <0.8.0",
-      "revision": "0.1.9",
-      "sha256": "sha256:82a49a3f636d4e1a4b5adf28cbcab533168e3aa5fc3014f096149055e7745624"
-    },
-    "model-lifecycle-management": {
-      "path": "skills/model-lifecycle-management",
-      "requires_cli": ">=0.7.0 <0.8.0",
-      "revision": "0.1.9",
-      "sha256": "sha256:b84505ee632967d019e97f89292c0041f8b722bd320e7d68d170e41131edaff7"
-    }
-  },
-  "source_commit": "5f855cd27f7951b739424704ea7dc15d714aeb5d"
-}

package/runtime/business-client/README.md

@@ -1,78 +0,0 @@
-# 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 内项目不一致时拒绝执行。
-
-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
-```
-
-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

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

package/runtime/business-client/package.json

@@ -1,23 +0,0 @@
-{
-  "name": "@zhuoyuezs/ml-platform-business-client",
-  "version": "0.7.0",
-  "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": {}
-}