refactor(cli)!: align commands with analysis run APIs

Replace legacy scheme commands with run-id based analysis and timeseries queries. Update sensor placement and SCADA routes, and refresh CLI help, tests, and usage guidance.

BREAKING CHANGE: legacy scheme, risk, and valve-close CLI command paths are removed.

cli/src/commands/data.ts

@@ -1,8 +1,8 @@
 import { SCADA_FIELDS, type ElementType } from "../core/constants.js";
 import { CliError } from "../core/errors.js";
-import { emitApi } from "../core/http.js";
-import { fieldsFor, optionalString, parseOptions, requiredString, requiredStringArray, validateChoice } from "../core/options.js";
-import { resolveScheme } from "../core/runtime.js";
+import { emitApi, requestAllPages } from "../core/http.js";
+import { fieldsFor, optionalNumber, optionalString, parseOptions, requiredString, requiredStringArray, validateChoice } from "../core/options.js";
+import { success } from "../core/output.js";
 import { parseTime } from "../core/time.js";
 import type { HandlerMap, RuntimeContext } from "../core/types.js";
 
@@ -42,14 +42,17 @@ function realtimeByTimeProperty(ctx: RuntimeContext, argv: string[]): Promise<vo
   });
 }
 
-function schemeLinks(ctx: RuntimeContext, argv: string[]): Promise<void> {
+function analysisSeries(ctx: RuntimeContext, argv: string[], type: ElementType): Promise<void> {
   const { values } = parseOptions(argv);
-  return emitApi(ctx, "读取方案管道数据成功", {
+  const runId = requiredString(values, "run-id");
+  const idOption = type === "pipe" ? "link" : "node";
+  const elementId = requiredString(values, idOption);
+  const elementPath = type === "pipe" ? "links" : "nodes";
+  return emitApi(ctx, type === "pipe" ? "读取分析管道字段成功" : "读取分析节点字段成功", {
     method: "GET",
-    path: "/timeseries/schemes/links",
+    path: `/timeseries/analysis/runs/${encodeURIComponent(runId)}/${elementPath}/${encodeURIComponent(elementId)}`,
     params: {
-      scheme_name: resolveScheme(ctx, optionalString(values, "scheme"), true),
-      scheme_type: optionalString(values, "scheme-type") || "simulation",
+      field: validateChoice(requiredString(values, "field"), fieldsFor(type), "--field"),
       start_time: parseTime(requiredString(values, "start-time"), "--start-time"),
       end_time: parseTime(requiredString(values, "end-time"), "--end-time"),
     },
@@ -57,40 +60,21 @@ function schemeLinks(ctx: RuntimeContext, argv: string[]): Promise<void> {
   });
 }
 
-function schemeNodeField(ctx: RuntimeContext, argv: string[]): Promise<void> {
+function analysisValues(ctx: RuntimeContext, argv: string[]): Promise<void> {
   const { values } = parseOptions(argv);
-  return emitApi(ctx, "读取方案节点字段成功", {
+  const type = validateChoice(requiredString(values, "type"), ["pipe", "junction"] as const, "--type");
+  return emitApi(ctx, "读取分析运行指定时刻结果成功", {
     method: "GET",
-    path: `/timeseries/schemes/nodes/${requiredString(values, "node")}/field`,
+    path: `/timeseries/analysis/runs/${encodeURIComponent(requiredString(values, "run-id"))}/values`,
     params: {
-      field: validateChoice(requiredString(values, "field"), fieldsFor("junction"), "--field"),
-      scheme_name: resolveScheme(ctx, optionalString(values, "scheme"), true),
-      scheme_type: optionalString(values, "scheme-type") || "simulation",
-      start_time: parseTime(requiredString(values, "start-time"), "--start-time"),
-      end_time: parseTime(requiredString(values, "end-time"), "--end-time"),
+      result_time: parseTime(requiredString(values, "time"), "--time"),
+      element_type: backendElementType(type),
+      field: validateChoice(requiredString(values, "field"), fieldsFor(type), "--field"),
     },
     requireProject: true,
   });
 }
 
-function schemeSimulation(ctx: RuntimeContext, argv: string[]): Promise<void> {
-  const { values } = parseOptions(argv);
-  const query = validateChoice(requiredString(values, "query"), ["by-id-time", "by-scheme-time-property"] as const, "--query");
-  const type = validateChoice(optionalString(values, "type") || "pipe", ["pipe", "junction"] as const, "--type") as ElementType;
-  const params: Record<string, unknown> = {
-    scheme_name: resolveScheme(ctx, optionalString(values, "scheme"), true),
-    scheme_type: optionalString(values, "scheme-type") || "simulation",
-    query_time: parseTime(requiredString(values, "time"), "--time"),
-    type: backendElementType(type),
-  };
-  if (query === "by-id-time") {
-    params.id = requiredString(values, "id");
-    return emitApi(ctx, "读取方案单点模拟数据成功", { method: "GET", path: "/timeseries/schemes/simulation-results", params, requireProject: true });
-  }
-  params.property = validateChoice(requiredString(values, "property"), fieldsFor(type), "--property");
-  return emitApi(ctx, "读取方案属性聚合数据成功", { method: "GET", path: "/timeseries/schemes/records", params, requireProject: true });
-}
-
 function scadaQuery(ctx: RuntimeContext, argv: string[]): Promise<void> {
   const { values } = parseOptions(argv, { "device-id": "repeat" });
   const params: Record<string, unknown> = {
@@ -110,8 +94,8 @@ function composite(ctx: RuntimeContext, argv: string[]): Promise<void> {
     start_time: parseTime(requiredString(values, "start-time"), "--start-time"),
     end_time: parseTime(requiredString(values, "end-time"), "--end-time"),
   };
-  const schemeName = resolveScheme(ctx, optionalString(values, "scheme"));
-  if (schemeName) Object.assign(params, { scheme_name: schemeName, scheme_type: optionalString(values, "scheme-type") || "simulation" });
+  const runId = optionalString(values, "run-id");
+  if (runId && kind !== "element-scada") params.run_id = runId;
   if (kind === "scada-simulation") params.device_ids = requiredStringArray(values, "feature").join(",");
   else if (kind === "element-simulation") params.feature_infos = requiredStringArray(values, "feature").join(",");
   else {
@@ -130,31 +114,28 @@ function composite(ctx: RuntimeContext, argv: string[]): Promise<void> {
 
 function pipelineHealth(ctx: RuntimeContext, argv: string[]): Promise<void> {
   const { values } = parseOptions(argv);
-  requiredString(values, "pipe");
-  requiredString(values, "start-time");
   return emitApi(ctx, "读取管道健康预测成功", {
     method: "GET",
     path: "/pipeline-health-predictions",
-    params: { query_time: parseTime(requiredString(values, "end-time"), "--end-time") },
+    params: { query_time: parseTime(requiredString(values, "time"), "--time") },
     requireProject: true,
   });
 }
 
 function dataScadaGet(ctx: RuntimeContext, argv: string[]): Promise<void> {
   const { values } = parseOptions(argv);
-  validateChoice(requiredString(values, "kind"), ["info"] as const, "--kind");
-  return emitApi(ctx, "读取 SCADA 数据成功", { method: "GET", path: "/scada-info/detail", params: { id: requiredString(values, "id") }, requireProject: true });
+  return emitApi(ctx, "读取 SCADA 设备成功", { method: "GET", path: "/scada-devices/detail", params: { device_id: requiredString(values, "device-id") }, requireProject: true });
 }
 
-function dataScadaList(ctx: RuntimeContext, argv: string[]): Promise<void> {
-  const { values } = parseOptions(argv);
-  validateChoice(requiredString(values, "kind"), ["info"] as const, "--kind");
-  return emitApi(ctx, "读取 SCADA 列表成功", { method: "GET", path: "/scada-info", requireProject: true });
-}
-
-function dataSchemeGet(ctx: RuntimeContext, argv: string[]): Promise<void> {
-  const { values } = parseOptions(argv);
-  return emitApi(ctx, "读取方案成功", { method: "GET", path: "/schemes/detail", params: { schema_name: requiredString(values, "name") }, requireProject: true });
+async function dataScadaList(ctx: RuntimeContext, argv: string[]): Promise<void> {
+  const { values } = parseOptions(argv, { "page-size": "integer" });
+  const pageSize = Math.min(1000, Math.max(1, optionalNumber(values, "page-size") ?? 1000));
+  const [data, durationMs] = await requestAllPages(
+    ctx,
+    { method: "GET", path: "/scada-devices", requireProject: true },
+    pageSize,
+  );
+  success("读取 SCADA 设备列表成功", data, ctx, durationMs);
 }
 
 export const dataHandlers: HandlerMap = {
@@ -162,15 +143,13 @@ export const dataHandlers: HandlerMap = {
   "data timeseries realtime nodes": (ctx, argv) => rangeGet(ctx, argv, "读取实时节点数据成功", "/timeseries/realtime/nodes"),
   "data timeseries realtime simulation-by-id-time": realtimeByIdTime,
   "data timeseries realtime simulation-by-time-property": realtimeByTimeProperty,
-  "data timeseries scheme links": schemeLinks,
-  "data timeseries scheme node-field": schemeNodeField,
-  "data timeseries scheme simulation": schemeSimulation,
+  "data timeseries analysis link-field": (ctx, argv) => analysisSeries(ctx, argv, "pipe"),
+  "data timeseries analysis node-field": (ctx, argv) => analysisSeries(ctx, argv, "junction"),
+  "data timeseries analysis values": analysisValues,
   "data timeseries scada query": scadaQuery,
   "data timeseries composite": composite,
-  "data timeseries composite pipeline-health": pipelineHealth,
+  "data pipeline-health": pipelineHealth,
   "data scada get": dataScadaGet,
   "data scada list": dataScadaList,
-  "data scheme schema": (ctx) => emitApi(ctx, "读取方案 schema 成功", { method: "GET", path: "/network-schemas/scheme", requireProject: true }),
-  "data scheme get": dataSchemeGet,
-  "data scheme list": (ctx) => emitApi(ctx, "读取方案列表成功", { method: "GET", path: "/schemes", requireProject: true }),
+  "data scada schema": (ctx) => emitApi(ctx, "读取 SCADA 设备 schema 成功", { method: "GET", path: "/network-schemas/scada-device", requireProject: true }),
 };