@zhuoyuezs/ml-platform 0.1.3 → 0.1.5

package/CI-ARTIFACT.md

@@ -0,0 +1,21 @@
+# CI npm artifact
+
+每次 `dev`/`main` 分支更新、合并请求或从 GitLab UI 手动运行的 Pipeline 都会生成完整的
+`@zhuoyuezs/ml-platform` tarball。
+GitLab pipeline 的 `npm:ml-platform-release` job 会将 `business-client-js` 放入正式包的
+`runtime/business-client`，并上传已验收的 `.tgz` 与 `.sha256` 文件。
+
+创建与 `npm/ml-platform/package.json` 版本一致的 SemVer tag（例如 `v0.1.5`）后，
+同一个已验收归档会自动发布到 npmjs。发布 job 需要在 GitLab CI/CD Variables 中配置
+受保护且 masked 的 `NPM_TOKEN`；普通分支、手动 Pipeline 和 Merge Request 不会发布 npm。
+
+下载 artifact 后只需要 Node.js 18+：
+
+```bash
+sha256sum -c zhuoyuezs-ml-platform-*.tgz.sha256
+npm install --global ./zhuoyuezs-ml-platform-*.tgz
+ml-platform version
+```
+
+运行已安装的 CLI 不需要 Python、`uv`、Git 仓库或平台源码。`uv` 只在 CI 构建阶段用于
+执行现有的 release staging 脚本。

package/DEVELOPMENT.md

@@ -146,8 +146,9 @@ Host 副本、日志、会话数据、attic、凭证和实验文件。
 - Codex project/user scope 和显式 Skills 目录；
 - 最终归档敏感文件和重复 client 检查。
 
-完成标准：同一个不可变 `.tgz` 通过全部验收，并作为唯一允许发布的输入。没有明确发布授权时，
-仍不执行 npmjs 或其他外部发布。
+完成标准：同一个不可变 `.tgz` 通过全部验收，并作为唯一允许发布的输入。GitLab CI 仅在
+SemVer tag（`vX.Y.Z` 或 `X.Y.Z`）与 `package.json.version` 一致、且配置了 `NPM_TOKEN` 时
+自动执行 npmjs 发布；dev、main 和 Merge Request pipeline 只生成并保存 artifact。
 
 ## 4. package.json
 
@@ -260,9 +261,10 @@ npx @zhuoyuezs/ml-platform@<version> install
 - 不执行 GitHub Release 或其他未授权的外部发布；
 - candidate 验证后不得用相同版本重新构建不同内容。
 
-当前允许使用 npm 账号 2FA 完成人工发布。后续迁移到受控 CI 时，优先使用 npm Trusted
-Publishing 和 OIDC，并在受支持的公开 CI 环境执行 `npm publish --provenance`。本地登录不能
-替代 CI provenance，未建立可信发布工作流前不得宣称包具有对应来源证明。
+受控 GitLab CI 使用 masked/protected 的 `NPM_TOKEN` 临时配置 npm auth，并发布 builder 生成的
+同一个 `.tgz`；token 不写入仓库或归档。本地登录不能替代 CI provenance，当前 token 发布也不
+宣称包具有 provenance 来源证明。后续可迁移到 npm Trusted Publishing 和 OIDC，并在受支持的
+公开 CI 环境执行 `npm publish --provenance`。
 
 ## 9. 参考与取舍
 

package/checksums.json

@@ -2,43 +2,43 @@
   "files": [
     {
       "path": "runtime/business-client/README.md",
-      "sha256": "sha256:4bca6d490a0ac3de54accb8f9f43003cdfb0c187bcf1acefea48728b16001e94",
-      "size_bytes": 1233
+      "sha256": "sha256:72b0cbbb18a7d0f1bca5d97706588fbebcd2781833ae023bae0317be13342601",
+      "size_bytes": 1880
     },
     {
       "path": "runtime/business-client/package-lock.json",
-      "sha256": "sha256:a253eb945f8666779adfbf9e7009c539b450746298f145bbe4d0b2ca5f4cbe35",
+      "sha256": "sha256:d5e7102ec51df3192ae901908f36cf0380aba5a0421b9824877403ab034d6740",
       "size_bytes": 381
     },
     {
       "path": "runtime/business-client/package.json",
-      "sha256": "sha256:bf29516fcbd162fe051f6ea142bd604dead0be99c461bc184a59e7c526766aa4",
-      "size_bytes": 426
+      "sha256": "sha256:b784fa27db6e40f72da11b9bca007155146174bc33edc4511c61d4ea4af93cf1",
+      "size_bytes": 508
     },
     {
       "path": "runtime/business-client/src/catalog.js",
-      "sha256": "sha256:d37f8069027350a3b698af2e9121067e77feb995980bbb226e45e7cdf9130db1",
-      "size_bytes": 53751
+      "sha256": "sha256:afc2ba28eee2d1dcd833a2e5c4ac923421dc60302b31bf985aa638849bbf3d36",
+      "size_bytes": 54246
     },
     {
       "path": "runtime/business-client/src/cli.js",
-      "sha256": "sha256:51d2056d8f1c12c3e669b597415bd2c2b911c9a8d44ce4721ee9ff63c9922679",
-      "size_bytes": 19305
+      "sha256": "sha256:f2634e346a4c5bdc42c81e316791906f809b768a77672e36d29cc51410c010ed",
+      "size_bytes": 29818
     },
     {
       "path": "runtime/business-client/src/config.js",
-      "sha256": "sha256:81022c2fc2a21cac8a12fd2c93b5defa18665a4d4a583a86e9eb54587650f47b",
-      "size_bytes": 1960
+      "sha256": "sha256:4190e09c339a3f0b2861ca7dbc96fe2aa3bdd7927a5e1c4a4c00103a53236bd8",
+      "size_bytes": 2186
     },
     {
       "path": "runtime/business-client/src/http.js",
-      "sha256": "sha256:0744596f8ae0beb60f317c06eccd87f3d5d0dc0ccba15668432a7a47c692aec9",
-      "size_bytes": 9450
+      "sha256": "sha256:e515b39f19e7b5e7d6c2388e9cf2d8e2c9fd18b585bb53bd4f8eeeb7412af81c",
+      "size_bytes": 15192
     },
     {
       "path": "skills/feature-management/SKILL.md",
-      "sha256": "sha256:ffd68632b98f51b15e18f225ee83452d6548969e799af727ea9f9efae7300cfb",
-      "size_bytes": 19156
+      "sha256": "sha256:7b58cc4ff2a7b83a29a6dbf9ad54e9e4a02efd332cd01c5d8fb83020b51ea506",
+      "size_bytes": 29676
     },
     {
       "path": "skills/feature-management/agents/openai.yaml",
@@ -52,18 +52,18 @@
     },
     {
       "path": "skills/feature-management/assets/catalog-template/datasets/example_temperature_training.v1.json",
-      "sha256": "sha256:c4b4c811cd7dc90ba014e3be0b38fdc357bc83c224e5df614ab9168ce7fbcc0c",
-      "size_bytes": 562
+      "sha256": "sha256:4dbe304631d6ecbf60b19d7c5a377178e0593525362f5fe509c60622b99e8a46",
+      "size_bytes": 900
     },
     {
       "path": "skills/feature-management/assets/catalog-template/feature_sets/example_temperature_core.v1.json",
-      "sha256": "sha256:bca7e24927d8aef2fc7f48df327bf56a25c77591332b97b0d2a548708126ec88",
-      "size_bytes": 315
+      "sha256": "sha256:22f37b954200864c19ed5593ab8455f562cc3dee7e05a0b01d5856a163dc0660",
+      "size_bytes": 352
     },
     {
       "path": "skills/feature-management/assets/catalog-template/features/example_temperature_mean_5m.v1.json",
-      "sha256": "sha256:36eb3878125e337bf2afced7b363c56833266a529ce311fffd8f8b146f361739",
-      "size_bytes": 572
+      "sha256": "sha256:7e58fa9c6a5ef581866d5cae598682de73e5ef3ce49fdd630432bada3a8a41a1",
+      "size_bytes": 807
     },
     {
       "path": "skills/feature-management/assets/catalog-template/operator_package/pyproject.toml",
@@ -77,33 +77,38 @@
     },
     {
       "path": "skills/feature-management/assets/catalog-template/operator_package/tests/test_operator.py",
-      "sha256": "sha256:b758f343225365cf8361ae6c7a7e130502d339cc4ffe2be13d75c728ce9ec71a",
-      "size_bytes": 1842
+      "sha256": "sha256:6fe073e07ed57d0fb4e782150153556b97c5b873b9eb2dad45df0d7f522d8650",
+      "size_bytes": 3678
     },
     {
       "path": "skills/feature-management/assets/catalog-template/operators/example_temperature_features.v1.json",
-      "sha256": "sha256:5d188372b2c7721c95bd91bdaa871368fca1ce5d43965db22494ee8c895fa516",
-      "size_bytes": 916
+      "sha256": "sha256:646965a05b982ae291960b23f359403c69bf8a173d6cc65d706fb2dc53ab030b",
+      "size_bytes": 1277
     },
     {
       "path": "skills/feature-management/assets/catalog-template/parameters/example_temperature.v1.json",
-      "sha256": "sha256:df65f46f67b320d7edf940c8f11d153f0869ecfc52fc4336f31358f6ecc7783d",
-      "size_bytes": 1451
+      "sha256": "sha256:28c7d3576c4b7e94c1e9db7f95f26d83ee2e10dc9f81ec6223f4fbd9b2f5eeda",
+      "size_bytes": 1488
     },
     {
       "path": "skills/feature-management/references/commands.md",
-      "sha256": "sha256:1c1de0e9c5d40ab57374f59b32a04b92648d1e6abecd4962965ddd887a4e0242",
-      "size_bytes": 9999
+      "sha256": "sha256:c20ccf9ad8d505a1880a7e35773edb5040bbbcfeba3a64316e3148a6e337bdc2",
+      "size_bytes": 11546
     },
     {
       "path": "skills/feature-management/references/contracts.md",
-      "sha256": "sha256:b15cf8e0379c9ac2d0ecbc70a63635472da91956c3917318593cd5dc1f93695a",
-      "size_bytes": 26166
+      "sha256": "sha256:913d5f0ad52b5183aa3a4bdeef2b6974f7757842300f547679fee38552792892",
+      "size_bytes": 27738
     },
     {
       "path": "skills/feature-management/references/operator-authoring.md",
-      "sha256": "sha256:c2afb155a1c3379935f70fe0b68c1918a58a790ee470bea2b7516f54502c6ca0",
-      "size_bytes": 5510
+      "sha256": "sha256:2ecfccbc9fe771bc1103db679d67af78847307eeb440f680f4055c35405ac923",
+      "size_bytes": 6089
+    },
+    {
+      "path": "skills/feature-management/references/platform-capability-guide.md",
+      "sha256": "sha256:40d0f43a30688c5852ef09203ec35b4dc2c6b9db4bc7dd26dfae52e12d10e9ee",
+      "size_bytes": 4257
     }
   ],
   "schema_version": "data_platform.ml_platform_checksums/v1"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhuoyuezs/ml-platform",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "ML 数据平台 business CLI 与 Agent Skills 管理工具",
   "bin": {
     "ml-platform": "scripts/main.js"
@@ -13,10 +13,13 @@
     "release.json",
     "checksums.json",
     "README.md",
-    "DEVELOPMENT.md"
+    "DEVELOPMENT.md",
+    "CI-ARTIFACT.md"
   ],
   "scripts": {
-    "test": "node --test test/*.test.js"
+    "test": "node --test test/*.test.js",
+    "api:check": "node ../../scripts/check_api_contract.js",
+    "pack": "npm pack"
   },
   "engines": {
     "node": ">=18"

package/release.json

@@ -13,8 +13,8 @@
     "entrypoint": "src/cli.js",
     "name": "ml-platform",
     "path": "runtime/business-client",
-    "sha256": "sha256:f782ec0cda02a69cf3fcc9dfccd7f29793bdbd91a8092d56e4073f09547fbf78",
-    "version": "0.6.0"
+    "sha256": "sha256:b509f9ccdedc4aa5d4d01c77609e4a16020ac6f74c62efc3af861877d897fe94",
+    "version": "0.7.0"
   },
   "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.3",
+  "release_version": "0.1.5",
   "runtime_requirements": {
     "node": ">=18",
     "os": [
@@ -37,10 +37,10 @@
   "skills": {
     "feature-management": {
       "path": "skills/feature-management",
-      "requires_cli": ">=0.6.0 <0.7.0",
-      "revision": "0.1.3",
-      "sha256": "sha256:e0ec0b304bb9f511eb5a5c53a32b76dcfede8bcdce70e3ff516eb4143a6c04f2"
+      "requires_cli": ">=0.7.0 <0.8.0",
+      "revision": "0.1.5",
+      "sha256": "sha256:ea7ef622f10300a3b5ee200adcf10070d18fadfb899d1bf2cc031ef42ffc5c03"
     }
   },
-  "source_commit": "f63960b92fce9eb9360dd6ad64d10f26f5dd72db"
+  "source_commit": "d18a5b535a2a6c41fe4732e8e73739f2728c1e58"
 }

package/runtime/business-client/README.md

@@ -25,3 +25,20 @@ ml-platform build-registered-dataset <dataset_id> <dataset_version> \
 
 `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
+```
+
+仓库中的 `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
+```

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

@@ -1,12 +1,12 @@
 {
   "name": "@zhuoyuezs/ml-platform-business-client",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@zhuoyuezs/ml-platform-business-client",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "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.6.0",
+  "version": "0.7.0",
   "private": true,
   "description": "JavaScript parity implementation of the ML Platform business client",
   "bin": {
@@ -11,7 +11,9 @@
     "README.md"
   ],
   "scripts": {
-    "test": "node --test test/*.test.js"
+    "test": "node --test test/*.test.js",
+    "api:check": "node ../scripts/check_api_contract.js",
+    "pack": "npm pack"
   },
   "engines": {
     "node": ">=18"

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

@@ -60,6 +60,8 @@ function normalizeCodeArtifact(value) { object(value, "operator code_artifact");
 function normalizeParameter(payload) {
   exactKeys(payload, ["schema_version", "project", "name", "display_name", "version", "data_type", "unit", "expected_frequency", "source", "time_semantics", "availability_sla", "value_field", "quality_rules", "rounding", "owner"], ["name", "display_name", "version", "source"], "parameter");
   const source = object(payload.source, "parameter source");
+  if (Object.prototype.hasOwnProperty.call(source, "parameters")) throw new Error("parameter source uses unsupported field 'parameters'; use 'params'");
+  if (source.mode === "sql" && typeof source.sql === "string" && source.sql.trimEnd().endsWith(";")) throw new Error("SQL Parameter source.sql must not end with a semicolon");
   const time = object(defaultIfAbsent(payload, "time_semantics", {}), "parameter time_semantics");
   return { schema_version: pythonString(defaultIfAbsent(payload, "schema_version", "ml_data_platform.parameter/v1")), project: identifier(defaultIfAbsent(payload, "project", "default"), "parameter project"), name: identifier(payload.name, "parameter name"), display_name: requiredString(payload.display_name, "parameter display_name"), version: identifier(payload.version, "parameter version"), data_type: pythonString(defaultIfAbsent(payload, "data_type", "time_series")), unit: pythonString(defaultIfAbsent(payload, "unit", "")), expected_frequency: pythonString(defaultIfAbsent(payload, "expected_frequency", "10min")), source: { adapter: pythonString(defaultIfAbsent(source, "adapter", "synthetic")), mode: choice(defaultIfAbsent(source, "mode", "direct_column"), ["direct_column", "sql", "derived"], "parameter source mode"), source_metric: optionalString(source.source_metric, "source_metric"), source_group: optionalString(source.source_group, "source_group"), measurement: optionalString(source.measurement, "measurement"), field: optionalString(source.field, "field"), tags: stringMap(defaultIfAbsent(source, "tags", {}), "source tags"), schema: optionalString(aliasIfAbsent(source, "schema", "schema_name"), "schema"), table: optionalString(source.table, "table"), time_column: optionalString(source.time_column, "time_column"), value_column: optionalString(source.value_column, "value_column"), metric_name_column: optionalString(source.metric_name_column, "metric_name_column"), metric_name: optionalString(source.metric_name, "metric_name"), unit_column: optionalString(source.unit_column, "unit_column"), unit: optionalString(aliasIfAbsent(source, "unit", "source_unit"), "source unit"), filters: stringMap(defaultIfAbsent(source, "filters", {}), "source filters"), sql: optionalString(source.sql, "source sql"), params: object(defaultIfAbsent(source, "params", {}), "source params") }, time_semantics: { event_time_field: pythonString(defaultIfAbsent(time, "event_time_field", "event_time")), ingested_at_field: pythonString(defaultIfAbsent(time, "ingested_at_field", "ingested_at")), timezone: pythonString(defaultIfAbsent(time, "timezone", "Asia/Shanghai")), availability: normalizeAvailability(time.availability) }, availability_sla: normalizeAvailabilitySla(payload.availability_sla), value_field: pythonString(defaultIfAbsent(payload, "value_field", "value")), quality_rules: normalizeQualityRules(object(defaultIfAbsent(payload, "quality_rules", {}), "parameter quality_rules")), rounding: normalizeRounding(payload.rounding), owner: pythonString(defaultIfAbsent(payload, "owner", "demo")) };
 }
@@ -165,7 +167,7 @@ function requiresPackage(spec) { return ["custom_python", "feature", "spark_udf"
 function validateCatalog(catalog, current) {
   const parameters = new Set([...current.parameters.keys(), ...catalog.parameters.map(key)]); const operators = new Map([...current.operators, ...catalog.operators.map((x) => [key(x.spec), x.spec])]); const features = new Map([...current.features, ...catalog.features.map((x) => [key(x), x])]); const featureSets = new Map([...current.feature_sets, ...catalog.feature_sets.map((x) => [key(x), x])]);
   for (const item of catalog.operators) if (!item.package_path && requiresPackage(item.spec)) throw new Error(`catalog operator ${key(item.spec)} requires a wheel package path`);
-  for (const feature of catalog.features) { for (const input of feature.inputs) if (!parameters.has(parameterReferenceKey(input))) throw new Error(`catalog feature ${key(feature)} references missing parameter ${parameterReferenceKey(input)}`); const operatorKey = `${feature.operator}:${feature.operator_version}`; const operator = operators.get(operatorKey); if (!operator) throw new Error(`catalog feature ${key(feature)} references missing operator ${operatorKey}`); if (operator.type !== "feature") throw new Error(`catalog feature ${key(feature)} requires OperatorSpec.type='feature'`); const declaredInputs = new Set(operator.input_schema.parameters ?? []); if (declaredInputs.size) for (const input of feature.inputs) if (!declaredInputs.has(parameterReferenceKey(input))) throw new Error(`catalog feature ${key(feature)} input is not declared by ${operatorKey}`); const columns = operator.output_schema.columns ?? []; if (columns.length && !columns.includes(feature.output_column)) throw new Error(`catalog feature ${key(feature)} output_column is not declared by ${operatorKey}`); }
+  for (const feature of catalog.features) { for (const input of feature.inputs) if (!parameters.has(parameterReferenceKey(input))) throw new Error(`catalog feature ${key(feature)} references missing parameter ${parameterReferenceKey(input)}`); const operatorKey = `${feature.operator}:${feature.operator_version}`; const operator = operators.get(operatorKey); if (!operator) throw new Error(`catalog feature ${key(feature)} references missing operator ${operatorKey}`); if (operator.type !== "feature") throw new Error(`catalog feature ${key(feature)} requires OperatorSpec.type='feature'`); const declaredInputs = new Set(operator.input_schema.parameters ?? []); if (declaredInputs.size) for (const input of feature.inputs) { const inputKey = parameterReferenceKey(input); const qualifiedInputKey = `${operator.project ?? feature.project ?? "default"}/${inputKey}`; if (!declaredInputs.has(inputKey) && !declaredInputs.has(qualifiedInputKey)) throw new Error(`catalog feature ${key(feature)} input is not declared by ${operatorKey}`); } const columns = operator.output_schema.columns ?? []; if (columns.length && !columns.includes(feature.output_column)) throw new Error(`catalog feature ${key(feature)} output_column is not declared by ${operatorKey}`); }
   for (const set of catalog.feature_sets) { const names = []; for (const item of set.features) { const feature = features.get(referenceKey(item)); if (!feature) throw new Error(`catalog feature set ${key(set)} references missing feature ${referenceKey(item)}`); names.push(feature.name); } unique(names, `catalog feature set ${key(set)} final output names`); }
   for (const dataset of catalog.datasets) {
     const datasetId = datasetKey(dataset); const declared = new Set();

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

@@ -14,7 +14,12 @@ const BUSINESS_COMMANDS = new Set([
   "configure", "show-config", "health", "list-parameters", "list-operators", "list-features",
   "list-feature-sets", "list-datasets", "get-dataset", "list-jobs", "resolve-manifest",
   "resolve-dataset", "build-dataset", "build-registered-dataset",
-  "get-job", "wait-job", "get-dataset-artifact", "download-dataset-artifact", "fetch-inference-data", "apply",
+  "get-parameter", "get-feature", "get-feature-set", "get-operator",
+  "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-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", "apply",
 ]);
 
 const COMMAND_USAGE = {
@@ -26,21 +31,44 @@ const COMMAND_USAGE = {
   "list-projects": "list-projects",
   "get-project": "get-project NAME",
   "delete-project": "delete-project NAME",
-  "list-parameters": "list-parameters [--project PROJECT] [-q QUERY] [--limit N] [--offset N]",
-  "list-operators": "list-operators [--project PROJECT] [-q QUERY] [--limit N] [--offset N]",
-  "list-features": "list-features [--project PROJECT] [-q QUERY] [--limit N] [--offset N]",
-  "list-feature-sets": "list-feature-sets [--project PROJECT] [-q QUERY] [--limit N] [--offset N]",
-  "list-datasets": "list-datasets [--project PROJECT] [-q QUERY] [--limit N] [--offset N]",
+  "list-parameters": "list-parameters [--project PROJECT] [--name NAME] [--version VERSION] [-q QUERY] [--limit N] [--offset N] [--all]",
+  "list-operators": "list-operators [--project PROJECT] [--name NAME] [--version VERSION] [-q QUERY] [--limit N] [--offset N] [--all]",
+  "list-features": "list-features [--project PROJECT] [--name NAME] [--version VERSION] [-q QUERY] [--limit N] [--offset N] [--all]",
+  "list-feature-sets": "list-feature-sets [--project PROJECT] [--name NAME] [--version VERSION] [-q QUERY] [--limit N] [--offset N] [--all]",
+  "list-datasets": "list-datasets [--project PROJECT] [--dataset-id ID] [--dataset-version VERSION] [-q QUERY] [--limit N] [--offset N] [--include-deleted] [--all]",
+  "get-parameter": "get-parameter NAME VERSION [--project PROJECT]",
+  "get-feature": "get-feature NAME VERSION [--project PROJECT]",
+  "get-feature-set": "get-feature-set NAME VERSION [--project PROJECT]",
+  "get-operator": "get-operator NAME VERSION [--project PROJECT]",
+  "list-parameter-versions": "list-parameter-versions NAME [--project PROJECT] [--limit N] [--offset N] [--all]",
+  "list-feature-versions": "list-feature-versions NAME [--project PROJECT] [--limit N] [--offset N] [--all]",
+  "list-feature-set-versions": "list-feature-set-versions NAME [--project PROJECT] [--limit N] [--offset N] [--all]",
+  "list-operator-versions": "list-operator-versions NAME [--project PROJECT] [--limit N] [--offset N] [--all]",
+  "add-parameter": "add-parameter SPEC_JSON",
+  "add-feature": "add-feature SPEC_JSON",
+  "add-feature-set": "add-feature-set SPEC_JSON",
+  "add-operator": "add-operator SPEC_JSON",
+  "publish-operator": "publish-operator SPEC_JSON --package PATH",
+  "add-dataset": "add-dataset MANIFEST_JSON [--force]",
+  "update-dataset": "update-dataset MANIFEST_JSON [--force]",
+  "delete-dataset": "delete-dataset DATASET_ID DATASET_VERSION [--project PROJECT]",
+  "list-dataset-artifacts": "list-dataset-artifacts [--project PROJECT] [--dataset-id ID] [--dataset-version VERSION] [--include-deleted] [--limit N] [--offset N]",
   "get-dataset": "get-dataset DATASET_ID DATASET_VERSION [--project PROJECT] [--include-deleted]",
-  "list-jobs": "list-jobs [-q QUERY] [--limit N] [--offset N]",
+  "list-jobs": "list-jobs [filters] [-q QUERY] [--limit N] [--offset N] [--all]",
   "resolve-manifest": "resolve-manifest MANIFEST [--out PATH]",
   "resolve-dataset": "resolve-dataset DATASET_ID DATASET_VERSION [--project PROJECT] [--out PATH]",
-  "build-dataset": "build-dataset MANIFEST [--source-mode direct] [--upload-chronon-metadata] [--partition-duration DURATION] [--max-parallelism N] [--no-resume] [--wait] [--poll-interval SECONDS] [--wait-timeout-seconds SECONDS]",
-  "build-registered-dataset": "build-registered-dataset DATASET_ID DATASET_VERSION [--project PROJECT] [--source-mode direct] [--upload-chronon-metadata] [--partition-duration DURATION] [--max-parallelism N] [--no-resume] [--wait] [--poll-interval SECONDS] [--wait-timeout-seconds SECONDS]",
+  "build-dataset": "build-dataset MANIFEST [--engine chronon] [--source-mode direct] [--upload-chronon-metadata] [--partition-duration DURATION] [--max-parallelism N] [--no-resume] [--wait] [--poll-interval SECONDS] [--wait-timeout-seconds SECONDS]",
+  "build-registered-dataset": "build-registered-dataset DATASET_ID DATASET_VERSION [--project PROJECT] [--engine chronon] [--source-mode direct] [--upload-chronon-metadata] [--partition-duration DURATION] [--max-parallelism N] [--no-resume] [--wait] [--poll-interval SECONDS] [--wait-timeout-seconds SECONDS]",
   "get-job": "get-job JOB_ID",
   "wait-job": "wait-job JOB_ID [--poll-interval SECONDS] [--wait-timeout-seconds SECONDS]",
+  "retry-job": "retry-job JOB_ID",
+  "cancel-job": "cancel-job JOB_ID",
+  "register-operator": "register-operator SPEC_JSON",
+  "show-operator-specs": "show-operator-specs [--project PROJECT] [-q QUERY] [--limit N] [--offset N]",
+  "delete-operator": "delete-operator NAME VERSION [--project PROJECT]",
+  "run-operator": "run-operator NAME VERSION [--project PROJECT] [--config JSON]",
   "get-dataset-artifact": "get-dataset-artifact DATASET_ID MANIFEST_HASH [--project PROJECT]",
-  "download-dataset-artifact": "download-dataset-artifact DATASET_ID MANIFEST_HASH [--project PROJECT] --out-dir PATH [--force]",
+  "download-dataset-artifact": "download-dataset-artifact DATASET_ID MANIFEST_HASH [--project PROJECT] --out-dir PATH [--file PATH] [--force]",
   "fetch-inference-data": "fetch-inference-data MANIFEST --cutoff-time TIMESTAMP [--max-workers N] [--max-source-lag-hours HOURS] [--no-validate-freshness] [--allow-missing]",
   apply: "apply CATALOG_DIRECTORY [--dry-run] [--project PROJECT]",
 };
@@ -52,7 +80,10 @@ function usage(command) {
 }
 
 function parse(args) {
-  const options = { profile: "server", timeout: finiteNumber(process.env.ML_PLATFORM_API_TIMEOUT_SECONDS ?? 30, "--request-timeout-seconds") };
+  const timeoutValue = process.env.ML_PLATFORM_API_TIMEOUT_SECONDS
+    || process.env.DATA_PLATFORM_DEMO_API_TIMEOUT_SECONDS
+    || 30;
+  const options = { profile: "server", timeout: finiteNumber(timeoutValue, "--request-timeout-seconds") };
   let index = 0;
   while (index < args.length && args[index].startsWith("--")) {
     const flag = args[index++];
@@ -66,7 +97,7 @@ function parse(args) {
   if (!(options.timeout > 0)) throw new Error("--request-timeout-seconds must be positive");
   options.command = args[index++];
   options.rest = args.slice(index);
-  options.apiUrl ??= process.env.ML_PLATFORM_API_URL || loadApiUrl();
+  options.apiUrl ??= process.env.ML_PLATFORM_API_URL || process.env.DATA_PLATFORM_DEMO_API_URL || loadApiUrl();
   return options;
 }
 
@@ -105,7 +136,7 @@ function positional(rest, label) { const value = rest.shift(); if (!value || val
 
 function client(options) {
   if (options.profile !== "server") throw new Error("the business client supports only --profile server");
-  if (!options.apiUrl) throw new Error("server profile requires --api-url, ML_PLATFORM_API_URL, or a saved configure target");
+  if (!options.apiUrl) throw new Error("server profile requires --api-url, ML_PLATFORM_API_URL, DATA_PLATFORM_DEMO_API_URL, or a saved configure target");
   return new PlatformApiClient(options.apiUrl, options.timeout);
 }
 
@@ -116,6 +147,7 @@ function readObject(file) {
 }
 
 function readDataset(file) { return normalizeDataset(readObject(file)); }
+function readSpec(file) { return readObject(file); }
 
 function datasetEndpoint(project, datasetId, datasetVersion) {
   return `/datasets/${encodeURIComponent(project)}/${encodeURIComponent(datasetId)}/${encodeURIComponent(datasetVersion)}`;
@@ -128,6 +160,8 @@ async function registeredDataset(api, project, datasetId, datasetVersion, includ
 }
 
 function buildOptions(rest) {
+  const engine = take(rest, "--engine", "chronon");
+  if (engine !== "chronon") throw new Error("--engine must be chronon");
   const sourceMode = take(rest, "--source-mode");
   if (sourceMode !== undefined && sourceMode !== "direct") throw new Error("--source-mode must be direct");
   const maxParallelism = integer(take(rest, "--max-parallelism", 1), "--max-parallelism");
@@ -139,6 +173,7 @@ function buildOptions(rest) {
   const waitTimeout = rawTimeout === undefined ? undefined : finiteNumber(rawTimeout, "--wait-timeout-seconds");
   if (waitTimeout !== undefined && !(waitTimeout > 0)) throw new Error("--wait-timeout-seconds must be positive");
   return {
+    engine,
     sourceMode,
     upload: boolean(rest, "--upload-chronon-metadata"),
     partitionDuration: take(rest, "--partition-duration"),
@@ -151,7 +186,7 @@ function buildOptions(rest) {
 }
 
 async function submitBuild(api, manifest, build) {
-  let result = await api.post("/datasets/build", manifest, { engine: "chronon", source_mode: build.sourceMode, upload_chronon_metadata: build.upload, partition_duration: build.partitionDuration, max_parallelism: build.maxParallelism, resume: build.resume });
+  let result = await api.post("/datasets/build", manifest, { engine: build.engine, source_mode: build.sourceMode, upload_chronon_metadata: build.upload, partition_duration: build.partitionDuration, max_parallelism: build.maxParallelism, resume: build.resume });
   let exitCode = 0;
   if (build.wait) {
     if (!result || typeof result !== "object" || !result.job_id) throw new Error("server build did not return a job_id to wait for");
@@ -205,20 +240,54 @@ async function runBusinessCli(argv) {
   } else if (options.command === "list-projects") result = await client(options).get("/projects");
   else if (options.command === "get-project") result = await client(options).get(`/projects/${encodeURIComponent(positional(rest, "project name"))}`);
   else if (options.command === "delete-project") result = await client(options).delete(`/projects/${encodeURIComponent(positional(rest, "project name"))}`);
-  else if (options.command === "get-dataset") {
+  else if (["add-parameter", "add-feature", "add-feature-set", "add-operator", "register-operator"].includes(options.command)) {
+    const spec = readSpec(positional(rest, "spec JSON"));
+    const endpoint = { "add-parameter": "/parameters", "add-feature": "/features", "add-feature-set": "/feature-sets", "add-operator": "/operators", "register-operator": "/operators" }[options.command];
+    result = await client(options).post(endpoint, spec);
+  } else if (options.command === "publish-operator") {
+    const specPath = positional(rest, "OperatorSpec JSON"); const packagePath = take(rest, "--package");
+    if (!packagePath) throw new Error("--package is required");
+    const spec = readSpec(specPath); const api = client(options); const project = spec.project || "default";
+    const upload = await api.uploadOperatorPackage(project, spec.name, spec.version, packagePath);
+    if (!upload || typeof upload.code_artifact !== "object") throw new Error("operator package upload response has no code_artifact");
+    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 === "get-dataset") {
     const datasetId = positional(rest, "dataset id"); const datasetVersion = positional(rest, "dataset version"); const project = take(rest, "--project", "default");
     result = await registeredDataset(client(options), project, datasetId, datasetVersion, boolean(rest, "--include-deleted"));
-  }
-  else if (options.command.startsWith("list-") && options.command !== "list-jobs") {
+  } else if (["get-parameter", "get-feature", "get-feature-set", "get-operator"].includes(options.command)) {
+    const resource = options.command.slice(4);
+    const endpoint = resource === "feature-set" ? "feature-sets" : `${resource}s`;
+    const name = positional(rest, `${resource} name`);
+    const version = positional(rest, `${resource} version`);
+    const project = take(rest, "--project", "default");
+    result = await client(options).get(`/${endpoint}/${encodeURIComponent(project)}/${encodeURIComponent(name)}/${encodeURIComponent(version)}`);
+  } else if (["list-parameter-versions", "list-feature-versions", "list-feature-set-versions", "list-operator-versions"].includes(options.command)) {
+    const resource = options.command.replace(/^list-/, "").replace(/-versions$/, "");
+    const endpoint = resource === "feature-set" ? "feature-sets" : `${resource}s`;
+    const name = positional(rest, `${resource} name`);
+    const project = take(rest, "--project", "default");
+    const allPages = boolean(rest, "--all");
+    const rawLimit = take(rest, "--limit"); const rawOffset = take(rest, "--offset");
+    if (allPages && (rawLimit !== undefined || rawOffset !== undefined)) throw new Error("--all cannot be combined with --limit or --offset");
+    if (allPages) result = await fetchAll(client(options), `/${endpoint}/${encodeURIComponent(project)}/${encodeURIComponent(name)}`);
+    else { const limit = Number(rawLimit ?? 50); const offset = Number(rawOffset ?? 0); if (!Number.isInteger(limit) || limit < 1 || limit > 500) throw new Error("limit must be between 1 and 500"); if (!Number.isInteger(offset) || offset < 0) throw new Error("offset must be >= 0"); result = await client(options).get(`/${endpoint}/${encodeURIComponent(project)}/${encodeURIComponent(name)}`, { limit, offset }); }
+  } else if (options.command.startsWith("list-") && !["list-jobs", "list-dataset-artifacts"].includes(options.command)) {
     const endpoints = { "list-parameters": "/parameters", "list-operators": "/operators", "list-features": "/features", "list-feature-sets": "/feature-sets", "list-datasets": "/datasets" };
     const project = take(rest, "--project");
-    const query = take(rest, "--q", take(rest, "-q")); const rawLimit = take(rest, "--limit"); const rawOffset = take(rest, "--offset");
-    if (rawLimit !== undefined || rawOffset !== undefined) { const limit = Number(rawLimit ?? 50); const offset = Number(rawOffset ?? 0); if (!Number.isInteger(limit) || limit < 1 || limit > 500) throw new Error("limit must be between 1 and 500"); if (!Number.isInteger(offset) || offset < 0) throw new Error("offset must be >= 0"); result = await client(options).get(endpoints[options.command], { q: query, limit, offset, project }); }
-    else result = await fetchAll(client(options), endpoints[options.command], { q: query, project });
+    const name = take(rest, "--name"); const version = take(rest, "--version");
+    const query = take(rest, "--q", take(rest, "-q")); const includeDeleted = options.command === "list-datasets" && boolean(rest, "--include-deleted"); const rawLimit = take(rest, "--limit"); const rawOffset = take(rest, "--offset");
+    const allPages = boolean(rest, "--all");
+    if (allPages && (rawLimit !== undefined || rawOffset !== undefined)) throw new Error("--all cannot be combined with --limit or --offset");
+    if (allPages) result = await fetchAll(client(options), endpoints[options.command], { q: query, project, name, version, include_deleted: includeDeleted });
+    else { const limit = Number(rawLimit ?? 50); const offset = Number(rawOffset ?? 0); if (!Number.isInteger(limit) || limit < 1 || limit > 500) throw new Error("limit must be between 1 and 500"); if (!Number.isInteger(offset) || offset < 0) throw new Error("offset must be >= 0"); result = await client(options).get(endpoints[options.command], { q: query, limit, offset, project, name, version, include_deleted: includeDeleted }); }
   } else if (options.command === "list-jobs") {
     const query = take(rest, "--q", take(rest, "-q")); const rawLimit = take(rest, "--limit"); const rawOffset = take(rest, "--offset");
-    if (rawLimit !== undefined || rawOffset !== undefined) { const limit = Number(rawLimit ?? 50); const offset = Number(rawOffset ?? 0); if (!Number.isInteger(limit) || limit < 1 || limit > 500) throw new Error("limit must be between 1 and 500"); if (!Number.isInteger(offset) || offset < 0) throw new Error("offset must be >= 0"); result = await client(options).get("/jobs", { q: query, limit, offset }); }
-    else result = await fetchAll(client(options), "/jobs", { q: query });
+    const filters = {}; for (const field of ["project", "dataset-id", "dataset-version", "manifest-hash", "status", "parent-job-id", "created-from", "created-to", "updated-from", "updated-to"]) filters[field.replaceAll("-", "_")] = take(rest, `--${field}`);
+    const allPages = boolean(rest, "--all");
+    if (allPages && (rawLimit !== undefined || rawOffset !== undefined)) throw new Error("--all cannot be combined with --limit or --offset");
+    if (allPages) result = await fetchAll(client(options), "/jobs", { q: query, ...filters });
+    else { const limit = Number(rawLimit ?? 50); const offset = Number(rawOffset ?? 0); if (!Number.isInteger(limit) || limit < 1 || limit > 500) throw new Error("limit must be between 1 and 500"); if (!Number.isInteger(offset) || offset < 0) throw new Error("offset must be >= 0"); result = await client(options).get("/jobs", { q: query, limit, offset, ...filters }); }
   }
   else if (options.command === "resolve-manifest") {
     const manifest = positional(rest, "manifest");
@@ -239,19 +308,49 @@ async function runBusinessCli(argv) {
     const datasetId = positional(rest, "dataset id"); const datasetVersion = positional(rest, "dataset version"); const project = take(rest, "--project", "default"); const build = buildOptions(rest); const api = client(options);
     const manifest = normalizeRegistryDataset(await registeredDataset(api, project, datasetId, datasetVersion));
     ({ result, exitCode } = await submitBuild(api, manifest, build));
+  } else if (["add-dataset", "update-dataset"].includes(options.command)) {
+    const manifest = readDataset(positional(rest, "manifest JSON")); const force = boolean(rest, "--force"); const project = manifest.project || "default";
+    if (options.command === "add-dataset") result = await client(options).post("/datasets", manifest, { force });
+    else result = await client(options).put(`/datasets/${encodeURIComponent(project)}/${encodeURIComponent(manifest.dataset_id)}/${encodeURIComponent(manifest.dataset_version)}`, manifest, { force });
+  } else if (options.command === "delete-dataset") {
+    const id = positional(rest, "dataset id"); const version = positional(rest, "dataset version"); const project = take(rest, "--project", "default");
+    result = await client(options).delete(`/datasets/${encodeURIComponent(project)}/${encodeURIComponent(id)}/${encodeURIComponent(version)}`);
+  } else if (options.command === "list-dataset-artifacts") {
+    const project = take(rest, "--project"); const datasetId = take(rest, "--dataset-id"); const datasetVersion = take(rest, "--dataset-version"); const includeDeleted = boolean(rest, "--include-deleted");
+    result = await listCollection(client(options), "/dataset-artifacts", { project, dataset_id: datasetId, dataset_version: datasetVersion, include_deleted: includeDeleted }, rest);
+  } else if (options.command === "show-operator-specs") {
+    const project = take(rest, "--project"); const query = take(rest, "--q", take(rest, "-q"));
+    result = await listCollection(client(options), "/operators", { project, q: query }, rest);
+  } else if (options.command === "delete-operator") {
+    const name = positional(rest, "operator name"); const version = positional(rest, "operator version"); const project = take(rest, "--project", "default");
+    result = await client(options).delete(`/operators/${encodeURIComponent(project)}/${encodeURIComponent(name)}/${encodeURIComponent(version)}`);
+  } else if (options.command === "run-operator") {
+    const name = positional(rest, "operator name"); const version = positional(rest, "operator version"); const project = take(rest, "--project", "default"); const rawConfig = take(rest, "--config", "{}");
+    let config; try { config = JSON.parse(rawConfig); } catch (_) { throw new Error("--config must be valid JSON"); }
+    result = await client(options).post(`/operators/${encodeURIComponent(project)}/${encodeURIComponent(name)}/${encodeURIComponent(version)}/run`, config);
   } else if (options.command === "get-job") result = await client(options).get(`/jobs/${encodeURIComponent(positional(rest, "job id"))}`);
   else if (options.command === "wait-job") {
     const jobId = positional(rest, "job id"); const poll = finiteNumber(take(rest, "--poll-interval", 2), "--poll-interval"); const rawTimeout = take(rest, "--wait-timeout-seconds");
     result = await waitForJob(client(options), jobId, poll, rawTimeout === undefined ? undefined : finiteNumber(rawTimeout, "--wait-timeout-seconds"));
     if (["failed", "cancelled"].includes(result.status)) exitCode = 1;
   }
+  else if (options.command === "cancel-job") {
+    result = await client(options).post(`/jobs/${encodeURIComponent(positional(rest, "job id"))}/cancel`);
+  }
+  else if (options.command === "retry-job") {
+    result = await client(options).post(`/jobs/${encodeURIComponent(positional(rest, "job id"))}/retry`);
+  }
   else if (options.command === "get-dataset-artifact") {
     const dataset = positional(rest, "dataset id"); const hash = positional(rest, "manifest hash"); const project = take(rest, "--project", "default");
     result = await client(options).get(`/dataset-artifacts/${encodeURIComponent(project)}/${encodeURIComponent(dataset)}/${encodeURIComponent(hash)}`);
   } else if (options.command === "download-dataset-artifact") {
     const dataset = positional(rest, "dataset id"); const hash = positional(rest, "manifest hash"); const project = take(rest, "--project", "default"); const outDir = take(rest, "--out-dir");
     if (!outDir) throw new Error("--out-dir is required");
-    result = await client(options).downloadDatasetArtifact(project, dataset, hash, resolvedPath(outDir), boolean(rest, "--force"));
+    const files = [];
+    while (rest.includes("--file")) files.push(take(rest, "--file"));
+    result = files.length
+      ? await client(options).downloadDatasetArtifactFiles(project, dataset, hash, files, resolvedPath(outDir), boolean(rest, "--force"))
+      : await client(options).downloadDatasetArtifact(project, dataset, hash, resolvedPath(outDir), boolean(rest, "--force"));
   } else if (options.command === "fetch-inference-data") {
     const manifest = positional(rest, "manifest"); const cutoffTime = take(rest, "--cutoff-time"); if (!cutoffTime) throw new Error("--cutoff-time is required");
     const realtime = {}; const maxWorkers = take(rest, "--max-workers"); const maxLag = take(rest, "--max-source-lag-hours"); if (maxWorkers !== undefined) { realtime.max_workers = integer(maxWorkers, "--max-workers"); if (realtime.max_workers < 1) throw new Error("--max-workers must be at least 1"); } if (maxLag !== undefined) { realtime.max_source_lag_hours = finiteNumber(maxLag, "--max-source-lag-hours"); if (realtime.max_source_lag_hours < 0) throw new Error("--max-source-lag-hours must be non-negative"); } if (boolean(rest, "--no-validate-freshness")) realtime.validate_freshness = false; if (boolean(rest, "--allow-missing")) realtime.allow_missing = true;
@@ -267,7 +366,16 @@ async function runBusinessCli(argv) {
 
 async function fetchAll(api, endpoint, params = {}) { const items = []; for (let offset = 0; ; offset += 500) { const page = await api.get(endpoint, { ...params, limit: 500, offset }); if (Array.isArray(page)) return page; if (!page || !Array.isArray(page.items)) throw new Error(`${endpoint} returned an invalid paginated response`); items.push(...page.items); if (page.total == null || items.length >= page.total || page.items.length < 500) return items; } }
 
-module.exports = { BUSINESS_COMMANDS, fetchAll, parse, runBusinessCli, usage, waitForJob };
+async function listCollection(api, endpoint, params, rest) {
+  const rawLimit = take(rest, "--limit"); const rawOffset = take(rest, "--offset");
+  if (rawLimit === undefined && rawOffset === undefined) return fetchAll(api, endpoint, params);
+  const limit = Number(rawLimit ?? 50); const offset = Number(rawOffset ?? 0);
+  if (!Number.isInteger(limit) || limit < 1 || limit > 500) throw new Error("limit must be between 1 and 500");
+  if (!Number.isInteger(offset) || offset < 0) throw new Error("offset must be >= 0");
+  return api.get(endpoint, { ...params, limit, offset });
+}
+
+module.exports = { BUSINESS_COMMANDS, fetchAll, listCollection, parse, runBusinessCli, usage, waitForJob };
 
 if (require.main === module) {
   runBusinessCli(process.argv.slice(2)).then((code) => { process.exitCode = code; }).catch((error) => {