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

package/config.json

@@ -416,7 +416,7 @@
     },
     {
       "name": "mcp-get-cache-diff",
-      "description": "比对云端与本地缓存，直接回答「还差哪些区间、多少个文件、多大」。只读，不创建任务，不改本地缓存。Data 返回 series、nextAction、assessment、evidence 和 resultKind=cache-diff（结果类型标记，向用户转述时可忽略）：series 每项含 missing（本地没有的区间）与 changed（已覆盖但元数据对不上的区间），两者都已按序列合并相邻与交叠段。\n\n**changed 的文件同样要整份重下，所以补齐全部缺口的下载量是 missingBytes 与 changedBytes 两者之和**；向用户报体量时必须相加，只报 missingBytes 会少算。nextAction=plan-download 只表示返回的有效 series 中发现缺口；report-unknown 表示上游响应没有提供足够的全请求覆盖证据，不能据此声称本地已经齐了，须同时说明 assessment 和 evidence。本工具需要云端枚举，开销相当于一次下载的列举阶段，不要在轮询循环里反复调用。",
+      "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.7",
+  "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

@@ -26176,7 +26176,16 @@ function hasInvalidCacheDiffWindow(value) {
 }
 function formatCacheDiffResult(rawResult) {
   if (!isRecord2(rawResult)) return rawResult;
-  if (isRecord2(rawResult.Data) && rawResult.Data.resultKind === CACHE_DIFF_RESULT_KIND && typeof rawResult.Data.assessment === "string" && isRecord2(rawResult.Data.evidence)) 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");
@@ -26235,6 +26244,7 @@ function formatCacheDiffResult(rawResult) {
       nextAction,
       assessment,
       evidence: {
+        requestCoverage: "unverified",
         resultsShape,
         resultCount: results.length,
         interpretedSeries: series.length,
@@ -27711,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 {
@@ -27728,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/....