@zltquant/zlt-mcp 0.6.1-beta.6 → 0.6.1-beta.8

package/config.json

@@ -416,7 +416,7 @@
     },
     {
       "name": "mcp-get-cache-diff",
-      "description": "比对云端与本地缓存，直接回答「还差哪些区间、多少个文件、多大」。只读，不创建任务，不改本地缓存。Data 返回 series、nextAction 和 resultKind=cache-diff（结果类型标记，向用户转述时可忽略）：series 每项含 missing（本地没有的区间）与 changed（已覆盖但元数据对不上的区间），两者都已按序列合并相邻与交叠段。\n\n**changed 的文件同样要整份重下，所以补齐全部缺口的下载量是 missingBytes 与 changedBytes 两者之和**；向用户报体量时必须相加，只报 missingBytes 会少算。nextAction=up-to-date 表示本地已经齐了。本工具需要云端枚举，开销相当于一次下载的列举阶段，不要在轮询循环里反复调用。",
+      "description": "比对云端与本地缓存，直接回答「还差哪些区间、多少个文件、多大」。只读，不创建任务，不改本地缓存。Data 返回 series、nextAction、assessment、evidence 和 resultKind=cache-diff（结果类型标记，向用户转述时可忽略）：series 每项含 missing（本地没有的区间）与 changed（已覆盖但元数据对不上的区间），两者都已按序列合并相邻与交叠段。\n\n**changed 的文件同样要整份重下，所以补齐已返回缺口的下载量是 missingBytes 与 changedBytes 两者之和**；向用户报体量时必须相加，只报 missingBytes 会少算。nextAction=plan-download 只表示返回的有效 series 中发现缺口；cachediff 是差异结果，不是云端目录，未返回的 series 状态未知。evidence.requestCoverage=unverified 表示上游没有证明响应覆盖调用方的完整请求范围。report-unknown 时停止作请求级结论；不要靠扩大日期、无界重试或承诺重新下载即可一致来补造覆盖证据。本工具需要云端枚举，开销相当于一次下载的列举阶段，不要在轮询循环里反复调用。",
       "inputSchema": {
         "type": "object",
         "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zltquant/zlt-mcp",
-  "version": "0.6.1-beta.6",
+  "version": "0.6.1-beta.8",
   "description": "智量通 ZLT Quant MCP server（Windows x64；量化策略创建与本地回测）",
   "bin": {
     "zlt-mcp": "./zlt-mcp-proxy.bundle.cjs"

package/zlt-mcp-proxy.bundle.cjs

@@ -26171,17 +26171,39 @@ function toCacheDiffWindows(value) {
   }
   return unionDataRangeIntervals(intervals).map(([startDate, endDate]) => ({ startDate, endDate }));
 }
+function hasInvalidCacheDiffWindow(value) {
+  return value.some((item) => !isRecord2(item) || !compactDataRangeDate(item.begin ?? item.start) || !compactDataRangeDate(item.end));
+}
 function formatCacheDiffResult(rawResult) {
   if (!isRecord2(rawResult)) return rawResult;
-  if (isRecord2(rawResult.Data) && rawResult.Data.resultKind === CACHE_DIFF_RESULT_KIND) return rawResult;
+  if (isRecord2(rawResult.Data) && rawResult.Data.resultKind === CACHE_DIFF_RESULT_KIND && typeof rawResult.Data.assessment === "string" && isRecord2(rawResult.Data.evidence)) {
+    if (rawResult.Data.evidence.requestCoverage === "unverified") return rawResult;
+    return {
+      ...rawResult,
+      Data: {
+        ...rawResult.Data,
+        evidence: { ...rawResult.Data.evidence, requestCoverage: "unverified" }
+      }
+    };
+  }
   const { Data: upstream, ...envelope } = rawResult;
   const payload = isRecord2(upstream) ? upstream : {};
+  const hasResultsField = Object.prototype.hasOwnProperty.call(payload, "results");
   const results = Array.isArray(payload.results) ? payload.results : [];
+  const resultsShape = !hasResultsField ? "missing" : !Array.isArray(payload.results) ? "invalid" : results.length === 0 ? "empty" : "array";
   const series = [];
+  let uncertainSeries = 0;
   for (const item of results) {
-    if (!isRecord2(item)) continue;
-    const token = splitDataTypeToken(typeof item.data_type === "string" ? item.data_type : "");
+    if (!isRecord2(item) || typeof item.data_type !== "string" || item.data_type.length === 0) continue;
+    const differenceFields = ["missing", "changed", "files"];
+    const presentFields = differenceFields.filter((field) => Object.prototype.hasOwnProperty.call(item, field));
+    if (presentFields.length === 0 || presentFields.some((field) => !Array.isArray(item[field]))) continue;
+    const token = splitDataTypeToken(item.data_type);
+    const missing = Array.isArray(item.missing) ? item.missing : [];
+    const changed = Array.isArray(item.changed) ? item.changed : [];
     const files = Array.isArray(item.files) ? item.files : [];
+    const hasUnusableMember = hasInvalidCacheDiffWindow(missing) || hasInvalidCacheDiffWindow(changed) || files.some((file) => !isRecord2(file) || file.state !== "missing" && file.state !== "changed");
+    if (hasUnusableMember) uncertainSeries += 1;
     let missingFiles = 0;
     let changedFiles = 0;
     let missingBytes = 0;
@@ -26200,8 +26222,8 @@ function formatCacheDiffResult(rawResult) {
       market: describeDataRangeMarket(item.exchange_id, MARKET_ID_TO_NAME, MARKET_CODE_TO_NAME),
       datatype: DATATYPE_TO_NAME[token.family] || token.family || "\u672A\u77E5\u9891\u7387",
       sectype: describeDataRangeSecurityClass(void 0, token.securityClass, SECTYPE_TO_NAME),
-      missing: toCacheDiffWindows(item.missing),
-      changed: toCacheDiffWindows(item.changed),
+      missing: toCacheDiffWindows(missing),
+      changed: toCacheDiffWindows(changed),
       missingFiles,
       changedFiles,
       missingBytes,
@@ -26210,12 +26232,25 @@ function formatCacheDiffResult(rawResult) {
   }
   const errNo = Number(rawResult.ErrNo);
   const upstreamFailed = Number.isFinite(errNo) && errNo !== 0;
-  const hasWork = series.some((s) => s.missing.length > 0 || s.changed.length > 0);
+  const hasWork = series.some((s) => s.missing.length > 0 || s.changed.length > 0 || s.missingFiles > 0 || s.changedFiles > 0);
+  const rejectedSeries = results.length - series.length;
+  const partialResult = resultsShape === "array" && (rejectedSeries > 0 || uncertainSeries > 0);
+  const assessment = upstreamFailed ? "upstream-error" : partialResult ? "partial-result" : resultsShape !== "array" ? "indeterminate-result" : hasWork ? "differences-found" : "no-differences-in-returned-series";
+  const nextAction = upstreamFailed ? "report-error" : partialResult || resultsShape !== "array" || !hasWork ? "report-unknown" : "plan-download";
   return {
     ...envelope,
     Data: {
       series: upstreamFailed ? [] : series,
-      nextAction: upstreamFailed ? "report-error" : hasWork ? "plan-download" : "up-to-date",
+      nextAction,
+      assessment,
+      evidence: {
+        requestCoverage: "unverified",
+        resultsShape,
+        resultCount: results.length,
+        interpretedSeries: series.length,
+        rejectedSeries,
+        uncertainSeries
+      },
       resultKind: CACHE_DIFF_RESULT_KIND
     }
   };
@@ -27686,6 +27721,15 @@ function runtimeRecoveryStopData(message, extra = {}, handler = "runtimeStart")
 var CLI_NAME = "zlt-mcp";
 var CLI_FALLBACK_PACKAGE_NAME = "@zltquant/zlt-mcp";
 var CLI_FALLBACK_VERSION = "0.5.0-beta.0";
+function writeCliArgumentError(message, write2) {
+  write2(message);
+  if (!message.includes("unknown option")) return;
+  if (message.includes("--registry")) {
+    write2("CLI argument error: toolExecution=not_started; no tool was called. --registry is an npm/npx option, not a zlt-mcp or tool option. Put it before the package name: npx --yes --registry=https://registry.npmjs.org @zltquant/zlt-mcp@<version> <command>. The override applies to one invocation; repeat it on every npx command before claiming that command used the official registry.\n");
+    return;
+  }
+  write2("CLI argument error: toolExecution=not_started; no tool was called. Tool fields belong inside one JSON object passed to --args-json (or --args-file), not --flags or key=value arguments. Use call --help and list --tool <tool-name> --json, correct the arguments, then retry.\n");
+}
 if (process.argv.length <= 2) {
   startMcpServer();
 } else {
@@ -27703,15 +27747,8 @@ if (process.argv.length <= 2) {
       startRuntime: false
     }));
   });
-  program2.name(CLI_NAME).description("MCP proxy for ZLTHost IPC service").version(resolveCliVersion()).addHelpText("after", "\nDiscovery: list for names; list --tool <name> --json for one complete input schema.\nUse call --help for input, output and diagnostic handling.");
-  program2.command("call <tool>").description("Call any MCP tool through the bundled MCP server").configureOutput({
-    outputError: (message, write2) => {
-      write2(message);
-      if (message.includes("unknown option")) {
-        write2("CLI argument error: toolExecution=not_started; no tool was called. Tool fields belong inside one JSON object passed to --args-json (or --args-file), not --flags or key=value arguments. Use call --help and list --tool <tool-name> --json, correct the arguments, then retry.\n");
-      }
-    }
-  }).option("--args-json <json>", "JSON object containing tool arguments").option("--args-file <path>", "Read the JSON argument object from a file").option("--output-json <path>", "Save the complete result to a new JSON file and print a compact receipt").option("--timeout-ms <ms>", "MCP request inactivity timeout in milliseconds").option("--max-total-timeout-ms <ms>", "Optional hard upper bound for the call, including install/backtest wait").option("--no-progress", "Suppress progress diagnostics on stderr").addHelpText("after", `
+  program2.name(CLI_NAME).description("MCP proxy for ZLTHost IPC service").version(resolveCliVersion()).configureOutput({ outputError: writeCliArgumentError }).addHelpText("after", "\nDiscovery: list for names; list --tool <name> --json for one complete input schema.\nUse call --help for input, output and diagnostic handling.\nFor npx registry selection, put --registry before the package name; it is not a zlt-mcp option.");
+  program2.command("call <tool>").description("Call any MCP tool through the bundled MCP server").configureOutput({ outputError: writeCliArgumentError }).option("--args-json <json>", "JSON object containing tool arguments").option("--args-file <path>", "Read the JSON argument object from a file").option("--output-json <path>", "Save the complete result to a new JSON file and print a compact receipt").option("--timeout-ms <ms>", "MCP request inactivity timeout in milliseconds").option("--max-total-timeout-ms <ms>", "Optional hard upper bound for the call, including install/backtest wait").option("--no-progress", "Suppress progress diagnostics on stderr").addHelpText("after", `
 Input: omitted arguments mean {}; use --args-json for small objects and --args-file
 for nested configuration or shell-sensitive text. Follow the selected tool schema
 from list --tool <name> --json. Windows paths must be native paths (C:/...), not /c/....