@wirecat/cli-core 0.445.0 → 0.447.0

package/CHANGELOG.md

@@ -5,6 +5,30 @@ Notable changes to `@wirecat/cli-core` (`@wirecat/cli-messaging` up to 0.261.0,
 minor version may break callers, and says how under "Changed — may break callers". `pnpm docs:check` checks the
 shape of this file.
 
+## 0.447.0 — 26.10.2026
+
+### Added
+
+- **The parity manifest knows `session start --answer-stdin`**, in tg and max: the flag that lets WireCat Desktop
+  answer a sign-in's questions on stdin (`signInSteps`, 0.443.0). WhatsApp's QR sign-in asks nothing, so wa does not
+  take it yet.
+
+### Fixed
+
+- **`--discover`'s reranker reads only the first 300 characters of the message a hit replies to.** The parent came
+  first in full, and a long one filled the reranker's 512 tokens, so the hit itself was cut off and the model scored
+  the parent instead (18 of 119 replies in one real chat). With the parent cut, the six known questions on that
+  chat kept every answer in the first five, and the reranker does about 40% less work.
+
+## 0.446.0 — 26.10.2026
+
+### Fixed
+
+- **`checkGuide` accepts a step that runs a group with an action of its own**, such as `mcp` now that it has
+  `mcp server`; before, it asked for one of the group's subcommands.
+- **The `mcp server` group states its effects** (reads locally), as a CLI that requires effects on every command
+  expects.
+
 ## 0.445.0 — 26.10.2026
 
 ### Added

package/dist/cli/guide.js

@@ -291,7 +291,9 @@ export const checkStep = (program, run) => {
     const beforeDashes = rest.slice(index, rest.includes("--") ? rest.indexOf("--") : undefined);
     if (help && beforeDashes.some((word) => word === help.long || word === help.short))
         return [];
-    if (at.commands.length > 0)
+    // A group with an action of its own runs as typed: `mcp` serves, `mcp server start` is its child.
+    const runsItself = at._actionHandler != null;
+    if (at.commands.length > 0 && !runsItself)
         return [`needs one of: ${at.commands.map((one) => one.name()).join(", ")}`];
     for (const command of chain)
         silent(command);

package/dist/cli/mcp-server-command.js

@@ -46,7 +46,7 @@ const clientLines = (clients) => clients.length === 0
  * None of it is offered over MCP: status holds a live login code.
  */
 export const mcpServerCommand = ({ example, defaultPort = MCP_HTTP_DEFAULT_PORT, target, answer, system, }) => {
-    const command = annotate(new Command("server"), { mcp: false })
+    const command = annotate(new Command("server"), { effects: LOCAL_READ, mcp: false })
         .summary("run the HTTP MCP server in the background")
         .description("start, stop and check `mcp --http` in the background; status shows the login code for a browser app");
     const machine = (self) => system?.(self) ?? thisMachine();

package/dist/services/messages-discovery.d.ts

@@ -54,3 +54,11 @@ export declare const searchDiscovery: (store: MessageStore, account: AccountKey,
 export declare const nearEligible: (store: MessageStore, account: AccountKey, request: SearchQuery, messenger: Partial<Pick<MessengerTraits, "savedChatId" | "app" | "history" | "provider">>, ranked: MeaningRanked, scope: string) => Promise<(FoundMessage & {
     cosine: number;
 })[]>;
+/** What the reranker reads of a hit, as the benchmark gave it: its reply parent first, each line headed by where, who and when. */
+type Said = {
+    senderName: string | null;
+    timestamp: string | null;
+    text: string;
+};
+export declare const pairInput: (hit: FoundMessage, parent: Said | null | undefined) => string;
+export {};

package/dist/services/messages-discovery.js

@@ -289,9 +289,14 @@ const fusedWithMeaning = (words, near, described) => {
     });
     return [...merged.values()].sort((a, b) => b.rrf - a.rrf).map(({ hit, rrf }) => ({ ...hit, score: rrf }));
 };
-const pairInput = (hit, parent) => {
+/**
+ * Only the start of the parent: whole, a long one filled the model's 512 tokens and cut off the hit it was scoring
+ * (18 of 119 replies in one real chat). Cut to 300 characters, every answer on the six known questions stayed.
+ */
+const PARENT_CHARACTERS = 300;
+export const pairInput = (hit, parent) => {
     const line = (m) => `[${hit.chatTitle ?? hit.chatId} · ${m.senderName ?? "unknown"} · ${m.timestamp?.slice(0, 10) ?? "undated"}] ${m.text}`;
-    return (parent ? [parent, hit] : [hit]).map(line).join("\n");
+    return (parent ? [line(parent).slice(0, PARENT_CHARACTERS), line(hit)] : [line(hit)]).join("\n");
 };
 const accountOfHit = (hit) => {
     const { provider, account } = parseLocator(hit.locator);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.445.0",
+  "version": "0.447.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",

package/parity.json

@@ -68,6 +68,9 @@
       "value": "<model>",
       "meaning": "only the stored answers this model gave"
     },
+    "--answer-stdin": {
+      "meaning": "with --json and no terminal: print each question as a `needs` line on stderr and read its answer, one line, from stdin"
+    },
     "--answerer": {
       "value": "<person>",
       "meaning": "stored name, alias, @username, ID or scoped person locator; ambiguous names require a choice; repeat it for more"
@@ -4193,6 +4196,10 @@
     "session start": {
       "in": "all",
       "options": {
+        "--answer-stdin": {
+          "in": ["tg", "max"],
+          "reason": "only tg and max ask questions during sign-in (app keys, codes, a 2FA or cloud password); WhatsApp's QR sign-in asks nothing, and its phone login is not ported to signInSteps yet"
+        },
         "--app": {
           "in": ["tg"],
           "reason": "Telegram asks each client for its own app from my.telegram.org; MAX has no such step; WhatsApp has no application registration"