@wirecat/cli-core 0.461.0 → 0.462.0

package/CHANGELOG.md

@@ -7,6 +7,25 @@ shape of this file.
 
 ## Unreleased
 
+## 0.462.0 — 27.10.2026
+
+### Changed — may break callers
+
+- **`skill show`, `skill status` and `skill install` answer `--json` in the one-thing envelope**
+  ([WC-OUT-4](https://github.com/WireCatLabs/cli-base/blob/main/docs/standards/output.md#wc-out-4--answer-every-json-request-with-one-envelope-a-list-or-one-thing)),
+  `{ item, meta }`, and `--jsonl` as one item line and the end line, like every other command and as their declared
+  output schema already said; they printed the bare object. MCP tool answers change the same way. `commands --json`
+  does not change. A caller reads the old fields under `item`: the `install/windows.ps1` installers of tg-cli, max-cli
+  and whatsapp-cli read `$skill.written`, and tests in tg-cli (`src/archive.test.ts`), max-cli
+  (`src/commands/skill.test.ts`) and cli-template (`src/roots.test.ts`) read the bare shape.
+
+### Fixed
+
+- **An empty `messages` search no longer suggests `messages sync --all --background`.** `coverage.next` and the
+  `messages.sync` step now name one chat (`<cli> messages sync <chat>`: the selected chat, or the most active one
+  that was never fetched or is behind), and the search help says to offer it and run it only after the owner
+  approves. A sync downloads from the owner's account, so an agent must not start an unbounded one on its own.
+
 ## 0.461.0 — 27.10.2026
 
 ### Changed — may break callers

package/dist/cli/messenger/messages-search-command.js

@@ -43,9 +43,9 @@ export const messagesSearchCommand = (messenger) => {
         .option("--timezone <zone>", "the IANA timezone for calendar date boundaries")
         .addHelpText("after", SAVE_HELP)
         .addHelpText("after", `${syncsFirst(messenger)
-        ? `Search reads the local archive: a chat never fetched is not searched. Prepare it once with
-\`${messenger.app.command} messages sync --all --background\` (the last 90 days of every chat); the answer's
-coverage says what was searched and coverage.next what would improve it.`
+        ? `Search reads the local archive: a chat never fetched is not searched. The answer's coverage says what was
+searched and coverage.next names one chat that would improve it. A sync downloads from the owner's account, so
+offer \`${messenger.app.command} messages sync <chat>\` and run it only once the owner approves.`
         : `Search reads the local archive: what \`${messenger.app.command} serve\` has kept since the account was linked.
 Keep serve running so new messages are searchable.`} Notes are
 \`${messenger.app.command} search notes\`, messages and notes at once \`${messenger.app.command} search all\`; for mail,

package/dist/cli/messenger/search-answers.js

@@ -72,12 +72,9 @@ export const coverageGaps = (found, shown) => {
     const stale = found.refreshed?.complete === false;
     if (!coverage?.next && !stale)
         return { next: [], missing: [] };
+    const chat = coverage?.chat ?? coverage?.attention[0]?.chatId;
     return {
-        next: [
-            nextStep("messages.sync", {
-                args: coverage?.chat === undefined ? { all: true, background: true } : { chat: coverage.chat },
-            }),
-        ],
+        next: chat === undefined ? [] : [nextStep("messages.sync", { args: { chat } })],
         missing: [
             {
                 field: "coverage",

package/dist/cli/skill-command.js

@@ -2,6 +2,7 @@ import { annotate } from "@wirecat/cli-base/commands";
 import { skillCommand as sharedSkillCommand } from "@wirecat/cli-base/skill";
 import { environmentOf, outputFor } from "./context.js";
 import { grantsAuthority } from "./effects.js";
+import { printItem } from "./envelope.js";
 /**
  * `skill show` and `skill install`. `skill` is the CLI's own SKILL.md, shipped beside `dist/` in the
  * package and in a checkout alike, so the skill printed is always this version's.
@@ -9,7 +10,10 @@ import { grantsAuthority } from "./effects.js";
 export const skillCommand = (app, skill) => {
     const command = sharedSkillCommand(app, skill, (command) => {
         const { env } = environmentOf(command);
-        return { ...outputFor(command), ...(env ? { env } : {}) };
+        const output = outputFor(command);
+        // cli-base prints each answer bare; the envelope is cli-core's.
+        const renderer = { ...output.renderer, result: (value) => printItem(output, value) };
+        return { ...output, renderer, ...(env ? { env } : {}) };
     }, SHARED_SKILLS);
     // An installed skill is instructions every later agent follows.
     const install = command.commands.find((sub) => sub.name() === "install");

package/dist/services/messages-search.js

@@ -235,12 +235,9 @@ export const coverageOf = async (store, { scopeAccounts, selectedChat }, messeng
     const completeness = [];
     const stats = new Map();
     let inventoryComplete = scopeAccounts.length > 0;
-    let ownInventory = true;
     for (const selected of scopeAccounts) {
         if (!(await store.sync.syncState(selected, CHAT_LIST_KEY))) {
             inventoryComplete = false;
-            if (messenger.provider === undefined || selected.provider === messenger.provider)
-                ownInventory = false;
         }
         const chatIds = selectedChat
             ? selected.provider === selectedChat.account.provider && selected.account === selectedChat.account.account
@@ -274,15 +271,11 @@ export const coverageOf = async (store, { scopeAccounts, selectedChat }, messeng
     const behindCount = own.filter(behind).length;
     // A chat held back to a window stays partial for good, so only what a fetch would change is advised.
     const command = messenger.app?.command;
-    const next = command === undefined
+    // One named chat, never `--all`: a download is the owner's call and stays bounded to what they approve.
+    const syncChat = selectedChat ? (neverFetched || behindCount ? selectedChat : null) : (attention[0] ?? null);
+    const next = command === undefined || !syncChat || !syncsOneChat(messenger)
         ? null
-        : selectedChat
-            ? (neverFetched || behindCount) && syncsOneChat(messenger)
-                ? `${command} messages sync ${selectedChat.chatId}`
-                : null
-            : (neverFetched || behindCount || !ownInventory) && messenger.history !== "store"
-                ? `${command} messages sync --all --background`
-                : null;
+        : `${command} messages sync ${syncChat.chatId}`;
     const state = selectedChat && completeness.length > 0 && completeness.every(({ state }) => state === "complete")
         ? "complete"
         : completeness.some(({ state }) => state !== "unknown")

package/package.json

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