@wirecat/cli-core 0.482.0 → 0.483.0

package/CHANGELOG.md

@@ -7,6 +7,16 @@ shape of this file.
 
 ## Unreleased
 
+## 0.483.0 — 30.10.2026
+
+### Fixed
+
+- **An MCP server answers each tool call about 6 ms sooner in tg.** The command tree is still built fresh for every
+  call, because each call attaches its own hooks and options to it. Two checks that gave the same answer every time now
+  run once per process: the shared command contracts once per program definition, and each list's query fields once
+  (with `@wirecat/cli-base` 0.65.2, now the pinned version). A CLI that builds a new definition object still gets the
+  check for it.
+
 ## 0.482.0 — 29.10.2026
 
 ### Changed — may break callers

package/dist/cli/messenger/statistics-query.js

@@ -61,9 +61,12 @@ const FIELD_SPECS = [
     },
 ];
 const fieldsFor = (report) => FIELD_SPECS.filter(({ name }) => FIELDS[report].includes(name));
-export const withStatisticsQuery = (command, report) => {
-    const extra = fieldsFor(report);
-    const query = defineQuery({
+const registries = new Map();
+const registryOf = (report) => {
+    const known = registries.get(report);
+    if (known)
+        return known;
+    const registry = defineQuery({
         entity: report.endsWith("top") ? "ranking" : "admin_report",
         backend: "sql",
         fields: [
@@ -71,9 +74,15 @@ export const withStatisticsQuery = (command, report) => {
                 ...field,
                 example: field.name === "text" ? "text:invoice" : field.name === "topic" ? "topic:42" : field.example,
             })),
-            ...extra,
+            ...fieldsFor(report),
         ],
     });
+    registries.set(report, registry);
+    return registry;
+};
+export const withStatisticsQuery = (command, report) => {
+    const extra = fieldsFor(report);
+    const query = registryOf(report);
     annotate(command, { query });
     command.addHelpText("after", `\n${fieldsHelp({ fields: extra }, LIST_QUERY_GUIDE)}\nReport predicates are positive AND terms; the remaining query selects stored messages.\n`);
     return command;

package/dist/cli/program.d.ts

@@ -30,7 +30,7 @@ export interface ProgramOptions {
  * The command tree, built fresh on each call. Commander is global state by default —
  * `exitOverride` and the write hooks turn it into a value a test can drive.
  */
-export declare const createProgram: ({ app, commands, configure, firstScreen }: ProgramDefinition, { out, err }?: ProgramOptions) => Command;
+export declare const createProgram: (definition: ProgramDefinition, { out, err }?: ProgramOptions) => Command;
 export type RunOptions = BaseEnvironment & Record<string, unknown>;
 /**
  * An interactive command run without a terminal — an agent's `session start qr` — waits on a person scanning a

package/dist/cli/program.js

@@ -32,11 +32,14 @@ import { absolutePaths, relayTarget } from "./relay-route.js";
 import { NoProfileHere, namedProfile, settingsFor, } from "./settings.js";
 import { assertSharedContracts } from "./shared-contracts.js";
 import { commandAt, failureSteps, lineOf, withLines } from "./steps.js";
+// An MCP server builds the tree on every tool call; the contracts of one definition's tree do not change between builds.
+const contractsChecked = new WeakSet();
 /**
  * The command tree, built fresh on each call. Commander is global state by default —
  * `exitOverride` and the write hooks turn it into a value a test can drive.
  */
-export const createProgram = ({ app, commands, configure, firstScreen }, { out, err } = {}) => {
+export const createProgram = (definition, { out, err } = {}) => {
+    const { app, commands, configure, firstScreen } = definition;
     const program = new Command();
     const mounted = commands();
     const messenger = app.messenger !== false;
@@ -75,7 +78,10 @@ export const createProgram = ({ app, commands, configure, firstScreen }, { out,
     for (const command of mounted)
         program.addCommand(command);
     configure?.(program);
-    assertSharedContracts(program);
+    if (!contractsChecked.has(definition)) {
+        assertSharedContracts(program);
+        contractsChecked.add(definition);
+    }
     installHelp(program, { pitch: app.description, ...firstScreen });
     // Commander builds a usage line from the command tree, where the profile is not a word.
     if (firstScreen?.profile !== false)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.482.0",
+  "version": "0.483.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",
@@ -247,7 +247,7 @@
     "@types/node": "^22.20.5",
     "@types/pngjs": "6.0.5",
     "@vitest/coverage-v8": "^5.0.5",
-    "@wirecat/cli-base": "0.65.0",
+    "@wirecat/cli-base": "0.65.2",
     "@wirecat/cli-core-legacy-tags": "npm:@wirecat/cli-core@0.414.0",
     "commander": "15.0.0",
     "cspell": "10.4.0",