@zhuoyuezs/ml-platform 0.2.0 → 0.2.2-alpha.0

package/scripts/main.js

@@ -1,22 +1,21 @@
 #!/usr/bin/env node
-
 "use strict";
-
+Object.defineProperty(exports, "__esModule", { value: true });
 const path = require("path");
 const { spawnSync } = require("child_process");
-const {
-  doctor,
-  install,
-  migrate,
-  parseOptions,
-  status,
-} = require("./lib");
-
+const { doctor, install, migrate, parseOptions, status, } = require("./lib");
 const MANAGEMENT_COMMANDS = new Set(["install", "upgrade", "migrate", "status", "doctor"]);
 const BUSINESS_ENTRY = path.resolve(__dirname, "..", "runtime", "business-client", "src", "cli.js");
-
 function usage() {
-  return `用法:
+    let businessCommands;
+    try {
+        businessCommands = [...loadBusinessCommands()].map((command) => `  ${command}`).join("\n");
+    }
+    catch (error) {
+        const reason = String(error.message).split("\n", 1)[0];
+        businessCommands = `  [不可用] ${reason}`;
+    }
+    return `用法:
   ml-platform install [--scope user|project] [--json]
   ml-platform upgrade [--scope user|project] [--json]
   ml-platform migrate [--scope user|project] [--json]
@@ -43,142 +42,156 @@ function usage() {
 安装管理命令:
   install, upgrade, migrate, status, doctor
 
-其余已注册业务命令由同一份 JavaScript Business CLI 执行。
+业务命令:
+${businessCommands}
+
+查看具体命令参数:
+  ml-platform <business-command> --help
 `;
 }
-
 function managementUsage(command) {
-  const signatures = {
-    install: "install [--scope user|project] [--project-dir PATH] [--json]",
-    upgrade: "upgrade [--scope user|project] [--project-dir PATH] [--json]",
-    migrate: "migrate [--scope user|project] [--project-dir PATH] [--json]",
-    status: "status [--scope user|project] [--project-dir PATH] [--json]",
-    doctor: "doctor [--scope user|project] [--project-dir PATH] [--api-url URL] [--json]",
-  };
-  return `用法: ml-platform ${signatures[command]}\n`;
+    const signatures = {
+        install: "install [--scope user|project] [--project-dir PATH] [--json]",
+        upgrade: "upgrade [--scope user|project] [--project-dir PATH] [--json]",
+        migrate: "migrate [--scope user|project] [--project-dir PATH] [--json]",
+        status: "status [--scope user|project] [--project-dir PATH] [--json]",
+        doctor: "doctor [--scope user|project] [--project-dir PATH] [--api-url URL] [--json]",
+    };
+    return `用法: ml-platform ${signatures[command]}\n`;
 }
-
 function printJson(payload) {
-  process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
+    process.stdout.write(`${JSON.stringify(payload, null, 2)}\n`);
 }
-
 function formatSummary(command, payload) {
-  if (command === "status") {
-    const lines = [`ML Platform: ${payload.installed ? "已安装" : "未安装"}`];
-    if (payload.installed_release) lines.push(`Release: ${payload.installed_release}`);
-    if (payload.cli?.version) lines.push(`CLI: ${payload.cli.version} (${payload.cli.path})`);
-    if (payload.skill?.revision) lines.push(`Skill: ${payload.skill.name}@${payload.skill.revision} (${payload.skill.path})`);
-    if (payload.record_error) lines.push(`错误: ${payload.record_error}`);
-    return `${lines.join("\n")}\n`;
-  }
-  if (command === "doctor") {
-    if (!Array.isArray(payload.checks)) {
-      return `ML Platform 检查失败: ${payload.error || "未知错误"}\n`;
+    if (command === "status") {
+        const lines = [`ML Platform: ${payload.installed ? "已安装" : "未安装"}`];
+        if (payload.installed_release)
+            lines.push(`Release: ${payload.installed_release}`);
+        if (payload.cli?.version)
+            lines.push(`CLI: ${payload.cli.version} (${payload.cli.path})`);
+        if (payload.skill?.revision)
+            lines.push(`Skill: ${payload.skill.name}@${payload.skill.revision} (${payload.skill.path})`);
+        if (payload.record_error)
+            lines.push(`错误: ${payload.record_error}`);
+        return `${lines.join("\n")}\n`;
+    }
+    if (command === "doctor") {
+        if (!Array.isArray(payload.checks)) {
+            return `ML Platform 检查失败: ${payload.error || "未知错误"}\n`;
+        }
+        const failed = payload.checks.filter((check) => check.ok === false);
+        const passed = payload.checks.filter((check) => check.ok === true);
+        const skipped = payload.checks.filter((check) => check.skipped);
+        const lines = [
+            `ML Platform 检查: ${payload.ok ? "通过" : "失败"}`,
+            `Release: ${payload.release_version || "未知"}  CLI: ${payload.cli_version || "未知"}`,
+            `检查项: ${passed.length} 通过, ${failed.length} 失败, ${skipped.length} 跳过`,
+        ];
+        const api = payload.checks.find((check) => check.name === "platform_api");
+        if (api?.api_url)
+            lines.push(`API: ${api.api_url} (${api.source})`);
+        else if (api?.skipped)
+            lines.push(`API: 未配置 (${api.reason})`);
+        for (const check of failed)
+            lines.push(`失败: ${check.name} - ${check.error || check.detail || "检查未通过"}`);
+        return `${lines.join("\n")}\n`;
     }
-    const failed = payload.checks.filter((check) => check.ok === false);
-    const passed = payload.checks.filter((check) => check.ok === true);
-    const skipped = payload.checks.filter((check) => check.skipped);
+    const actionLabels = {
+        installed: "安装完成",
+        upgraded: "升级完成",
+        unchanged: "已是当前版本",
+        migrated: "迁移完成",
+    };
     const lines = [
-      `ML Platform 检查: ${payload.ok ? "通过" : "失败"}`,
-      `Release: ${payload.release_version || "未知"}  CLI: ${payload.cli_version || "未知"}`,
-      `检查项: ${passed.length} 通过, ${failed.length} 失败, ${skipped.length} 跳过`,
+        `ML Platform: ${actionLabels[payload.action] || payload.action || (payload.ok ? "完成" : "失败")}`,
     ];
-    const api = payload.checks.find((check) => check.name === "platform_api");
-    if (api?.api_url) lines.push(`API: ${api.api_url} (${api.source})`);
-    else if (api?.skipped) lines.push(`API: 未配置 (${api.reason})`);
-    for (const check of failed) lines.push(`失败: ${check.name} - ${check.error || check.detail || "检查未通过"}`);
+    if (payload.release_version)
+        lines.push(`Release: ${payload.release_version}  CLI: ${payload.cli_version}`);
+    if (payload.cli_shim)
+        lines.push(`命令: ${payload.cli_shim}`);
+    if (payload.skill_root)
+        lines.push(`Skill: ${payload.skill_root}`);
+    if (payload.path_ready === false && payload.path_setup)
+        lines.push(`PATH: ${payload.path_setup}`);
+    if (payload.restart_agent_session)
+        lines.push("请重启 Agent 会话以加载最新 Skill。");
     return `${lines.join("\n")}\n`;
-  }
-  const actionLabels = {
-    installed: "安装完成",
-    upgraded: "升级完成",
-    unchanged: "已是当前版本",
-    migrated: "迁移完成",
-  };
-  const lines = [
-    `ML Platform: ${actionLabels[payload.action] || payload.action || (payload.ok ? "完成" : "失败")}`,
-  ];
-  if (payload.release_version) lines.push(`Release: ${payload.release_version}  CLI: ${payload.cli_version}`);
-  if (payload.cli_shim) lines.push(`命令: ${payload.cli_shim}`);
-  if (payload.skill_root) lines.push(`Skill: ${payload.skill_root}`);
-  if (payload.path_ready === false && payload.path_setup) lines.push(`PATH: ${payload.path_setup}`);
-  if (payload.restart_agent_session) lines.push("请重启 Agent 会话以加载最新 Skill。");
-  return `${lines.join("\n")}\n`;
 }
-
 function printResult(command, payload, summary) {
-  if (summary) process.stdout.write(formatSummary(command, payload));
-  else printJson(payload);
+    if (summary)
+        process.stdout.write(formatSummary(command, payload));
+    else
+        printJson(payload);
 }
-
 function loadBusinessCommands() {
-  try {
-    const { BUSINESS_COMMANDS } = require(BUSINESS_ENTRY);
-    if (!(BUSINESS_COMMANDS instanceof Set)) throw new Error("BUSINESS_COMMANDS export is missing");
-    return BUSINESS_COMMANDS;
-  } catch (error) {
-    throw new Error(`Business CLI 不完整: ${error.message}`);
-  }
+    try {
+        const { BUSINESS_COMMANDS } = require(BUSINESS_ENTRY);
+        if (!(BUSINESS_COMMANDS instanceof Set))
+            throw new Error("BUSINESS_COMMANDS export is missing");
+        return BUSINESS_COMMANDS;
+    }
+    catch (error) {
+        throw new Error(`Business CLI 不完整: ${error.message}`);
+    }
 }
-
 function dispatchBusiness(argv) {
-  const commands = loadBusinessCommands();
-  if (!argv.some((arg) => commands.has(arg))) {
-    throw new Error(`未知命令: ${argv.find((arg) => !arg.startsWith("-")) || argv[0]}`);
-  }
-  const result = spawnSync(process.execPath, [BUSINESS_ENTRY, ...argv], {
-    stdio: "inherit",
-    env: process.env,
-  });
-  if (result.error) throw result.error;
-  return result.status === null ? 1 : result.status;
+    const commands = loadBusinessCommands();
+    if (!argv.some((arg) => commands.has(arg))) {
+        throw new Error(`未知命令: ${argv.find((arg) => !arg.startsWith("-")) || argv[0]}`);
+    }
+    const result = spawnSync(process.execPath, [BUSINESS_ENTRY, ...argv], {
+        stdio: "inherit",
+        env: process.env,
+    });
+    if (result.error)
+        throw result.error;
+    return result.status === null ? 1 : result.status;
 }
-
 function main(argv) {
-  const [command, ...rest] = argv;
-  if (!command || command === "help" || command === "--help" || command === "-h") {
-    process.stdout.write(usage());
-    return 0;
-  }
-  if (!MANAGEMENT_COMMANDS.has(command)) return dispatchBusiness(argv);
-
-  if (rest.includes("--help") || rest.includes("-h")) {
-    process.stdout.write(managementUsage(command));
-    return 0;
-  }
-
-  const options = parseOptions(rest);
-  if (command === "install" || command === "upgrade") {
-    if (command === "upgrade") options.upgrade = true;
-    printResult(command, install(options), options.summary);
-    return 0;
-  }
-  if (command === "migrate") {
-    const result = migrate(options);
-    printResult(command, result, options.summary);
-    return result.ok ? 0 : 1;
-  }
-  if (command === "status") {
-    const result = status(options);
+    const [command, ...rest] = argv;
+    if (!command || command === "help" || command === "--help" || command === "-h") {
+        process.stdout.write(usage());
+        return 0;
+    }
+    if (!MANAGEMENT_COMMANDS.has(command))
+        return dispatchBusiness(argv);
+    if (rest.includes("--help") || rest.includes("-h")) {
+        process.stdout.write(managementUsage(command));
+        return 0;
+    }
+    const options = parseOptions(rest);
+    if (command === "install" || command === "upgrade") {
+        if (command === "upgrade")
+            options.upgrade = true;
+        printResult(command, install(options), options.summary);
+        return 0;
+    }
+    if (command === "migrate") {
+        const result = migrate(options);
+        printResult(command, result, options.summary);
+        return result.ok ? 0 : 1;
+    }
+    if (command === "status") {
+        const result = status(options);
+        printResult(command, result, options.summary);
+        return result.ok ? 0 : 1;
+    }
+    const result = doctor(options);
     printResult(command, result, options.summary);
     return result.ok ? 0 : 1;
-  }
-  const result = doctor(options);
-  printResult(command, result, options.summary);
-  return result.ok ? 0 : 1;
 }
-
 if (require.main === module) {
-  try {
-    process.exitCode = main(process.argv.slice(2));
-  } catch (error) {
-    if (process.argv.slice(2).includes("--json")) {
-      process.stderr.write(`${JSON.stringify({ ok: false, error: error.message }, null, 2)}\n`);
-    } else {
-      process.stderr.write(`ML Platform: 失败\n错误: ${error.message}\n`);
+    try {
+        process.exitCode = main(process.argv.slice(2));
+    }
+    catch (error) {
+        if (process.argv.slice(2).includes("--json")) {
+            process.stderr.write(`${JSON.stringify({ ok: false, error: error.message }, null, 2)}\n`);
+        }
+        else {
+            process.stderr.write(`ML Platform: 失败\n错误: ${error.message}\n`);
+        }
+        process.exitCode = 2;
     }
-    process.exitCode = 2;
-  }
 }
-
 module.exports = { BUSINESS_ENTRY, MANAGEMENT_COMMANDS, dispatchBusiness, formatSummary, main, managementUsage, usage };

package/scripts/verify-release-package.js

@@ -1,28 +1,24 @@
 #!/usr/bin/env node
 "use strict";
-
+Object.defineProperty(exports, "__esModule", { value: true });
 const path = require("node:path");
-
 const { verifyPackage } = require("./lib");
-
 function verifyReleasePackage(packageRoot = path.resolve(__dirname, "..")) {
-  try {
-    return verifyPackage(packageRoot);
-  } catch (error) {
-    throw new Error(
-      `拒绝发布未验证的 ML Platform 包：${error.message}。`
-      + " 请只发布 build_ml_platform_release.py 生成的 .tgz 归档。",
-    );
-  }
+    try {
+        return verifyPackage(packageRoot);
+    }
+    catch (error) {
+        throw new Error(`拒绝发布未验证的 ML Platform 包：${error.message}。`
+            + " 请只发布 build_ml_platform_release.py 生成的 .tgz 归档。");
+    }
 }
-
 if (require.main === module) {
-  try {
-    verifyReleasePackage();
-  } catch (error) {
-    process.stderr.write(`${error.message}\n`);
-    process.exitCode = 1;
-  }
+    try {
+        verifyReleasePackage();
+    }
+    catch (error) {
+        process.stderr.write(`${error.message}\n`);
+        process.exitCode = 1;
+    }
 }
-
 module.exports = { verifyReleasePackage };

package/skills/model-deployment-management/references/operations.md

@@ -29,6 +29,21 @@ Use `get-deployment` to inspect the full revision history and endpoints. Use
 `list-deployments` for discovery and `get-deployment-events` for paginated
 audit evidence.
 
+Discover deployments associated with a packaged model without knowing the
+deployment ID first:
+
+```bash
+ml-platform --profile server list-deployments \
+  --package-id <package-id> \
+  --package-version <package-version> \
+  --model-artifact-id <artifact-id>
+```
+
+The filters may be used independently and combined with `--service`,
+`--environment`, `--state`, `--q`, `--limit`, and `--offset`. These results are
+ITSMP platform deployments; external model-center delivery callbacks are a
+separate status surface.
+
 For direct model access, declare `service_exposure.type=NodePort` in the same
 validated DeploymentSpec. After the revision is `READY`, read the observed
 `nodeport` endpoint instead of constructing a Service name. Given an observed

package/skills/model-lifecycle-management/references/evaluation.md

@@ -27,6 +27,16 @@ Inspect `get-metric-definition regression.mae v1` before relying on this metric.
 Release mode additionally requires at least one required validation rule with a
 business-approved threshold; do not invent thresholds to obtain PASS.
 
+For a fixed-length multi-step forecast, `regression.mae` and
+`regression.rmse` cover only the terminal point at the maximum trained horizon.
+Use `regression.trajectory_mae` and `regression.trajectory_rmse` for a release
+gate over the complete trajectory. These metrics flatten every valid
+`(anchor, horizon_step)` cell; they do not multiply the terminal metric by the
+prediction length. Inspect `forecast_metrics.parquet` for the per-step curve.
+When a trajectory metric is requested, prediction coverage requires every step
+of an anchor to be finite. A non-forecast ModelArtifact is rejected before
+Worker execution.
+
 Example `evaluation-request.json` shape; replace illustrative identities before
 validation or submission:
 

package/skills/model-lifecycle-management/references/training-contracts.md

@@ -265,7 +265,11 @@ contracts. Training `evaluation.split=auto` prefers nonempty test, then validati
 then train; choose an explicit split when reserving the test set for final review.
 Training metrics are not a governed EvaluationResult or release gate pass.
 
-For sequence outputs, current training and governed evaluation apply regression
-metrics to the terminal point at the trained maximum horizon. They do not yet
-provide per-step or whole-trajectory release gates; record this limitation when
-reporting evidence for a multi-point package.
+For sequence outputs, training feedback and governed `regression.mae` /
+`regression.rmse` retain terminal-point semantics at the trained maximum
+horizon. Governed evaluation additionally supports
+`regression.trajectory_mae` and `regression.trajectory_rmse`: they aggregate all
+valid `(anchor, horizon_step)` cells, while `forecast_metrics.parquet` records
+the per-step curve. Use a trajectory metric for multi-point release gates; do
+not multiply the terminal metric by `prediction_length` or report it as whole-
+trajectory quality.