@wirecat/cli-core 0.425.0 → 0.427.0

package/CHANGELOG.md

@@ -7,6 +7,51 @@ shape of this file.
 
 ## Unreleased
 
+## 0.427.0 — 25.10.2026
+
+### Added
+
+- **Every CLI on cli-core gets `skill status` and `skill show --for claude|agents`** from cli-base 0.56.0. `skill
+  status` says, for each agent, whether its installed SKILL.md matches this version; `skill show --for` prints the copy
+  installed there, so a host can show what `skill install` would change.
+- **`store info` for every WireCat tool, and whether this tool can read the store.** `storeInfo(env)` returns the answer for a tool that builds its own program (drive, memo); `storeInfoCommand()` is the `info` command and `sharedStoreCommand()` a `store` group holding it, for a tool on `createProgram` with no `store` of its own (zm). `schema` gains `reason` (`missing`, `older`, `current`, `newer` — this tool may still write it — or `too_new`) and `upgrade`: `{ version, min_compatible }` the file will be at after this tool's next run, or `null`, so a caller can name every other tool whose `speaks` is below that minimum before it updates. `writable` keeps saying whether this tool can open the file. The answer has `clients`, each tool that opened the store with its `version`, cli-core `core`, `speaks` and `seen_at`. A missing store answers with this tool's `schema` too, and a file that does not open with `schema.speaks`.
+- **`store tables list` lists every table of the archive, and `store info` describes the file itself.** WireCat
+  Desktop's Storage page showed totals but not which tables the archive holds, its migrations or the last backup, and
+  the app may not open the file. `store tables list [query...]` answers each table's `name`, `kind` (`data`,
+  `search_index`, `search_index_part`, `internal`) and `rows`, read-only; a search index's rows stay `null`, since
+  counting them scans the whole index. `--full` adds `bytes`, the pages a table and its indexes hold, which reads the
+  whole file: under a second when it is in memory, ten seconds to two minutes when not, on a 3 GB store. Under Bun,
+  whose SQLite has no `dbstat`, `--full` says so. `store info` gains `journal_mode`, `pages` (`size`, `count`, and
+  `free`, the pages a `VACUUM` would give back), `migrations` (every applied version with its `min_compatible` and
+  `applied_at`) and `backup`, the time, file and check from the `backups/last.json` marker a backup job leaves beside
+  the store (`null` without one). The resource word `tables` comes from cli-base
+  ([WireCatLabs/cli-base#334](https://github.com/WireCatLabs/cli-base/pull/334)).
+
+### Changed — may break callers
+
+- **cli-core needs `@wirecat/cli-base` 0.56.** The peer range moves from `>=0.53.0 <0.54.0` to `>=0.56.0 <0.57.0`. A
+  CLI that pins cli-base moves its pin with this release. cli-base 0.54 and 0.55 change the release lock and the
+  changelog guard, which a CLI adopts through community's standards sync, and 0.56 adds the `missing-run-log` lint
+  rule: a CLI without `runs` fails `cli-dev lint` until it registers `runsCommand(app)`.
+
+### Fixed
+
+- **`store info` opens the store read-only.** It no longer sets the journal mode, and a store too new for this tool answers with its schema and empty `rows` instead of failing to count tables it may have renamed.
+
+## 0.426.0 — 25.10.2026
+
+### Added
+
+- **`profileFree(command)` and `takesProfile(command)` from `/cli`: a CLI marks the commands that read no profile, and help asks its own command tree.** A marked command, and every command under it, gets no `personal` in its help example and no `<profile>` in its usage line: `drive doctor`, `drive api list`, not `drive personal doctor`. `PROFILE_FREE` (`commands`, `complete`, `guide`, `help`, `skill`, `upgrade`) still counts for every CLI. drive and zm mark their own housekeeping commands to use it.
+- **`storeChangeRefusal(app)` and `previewFlag(program)` from `/cli`.**
+
+### Changed — may break callers
+
+- **Help and examples that cli-core writes no longer speak of messages to a CLI that is not a messenger, or show a command that does something unasked.** The first screen's "Works with" says zm and drive are "searchable with your other WireCat data", in every CLI (tg, max and wa included). `guide`'s example names the CLI's first scenario (`tg guide catch-up --json`) in place of `<name>`, and is left out when the CLI has none. `models download` (the messenger `models` command) says its size and examples the default text model only, not `parakeet-v3`. `meetings scheduled` and `meetings prepare` example `--dry-run` where the program has it. `commands`' argument example is `commands info` for a CLI that is not a messenger. The `<PREFIX>_READ_ONLY` refusal of a store change says "change the local store" for such a CLI; tg, max and wa keep "change the message store".
+- **"Availability: available for this profile" is shown only where a profile is in play.** A CLI whose first screen has `profile: false` (memo), and a command that reads no profile, show the line only when the command is unavailable, with its reason.
+- **`createProgram` puts no `<profile>` in the usage line of a CLI whose first screen has `profile: false`**, nor of a `profileFree` command.
+- **A guide scenario step may start with a profile word** (`tg personal chats list`), so scenarios can name the profile as the command line requires. `checkStep` skips a first word that is not a command and is a usable profile name; its "steps leave out the profile" refusal is gone.
+
 ## 0.425.0 — 25.10.2026
 
 ### Added

package/dist/cli/commands-command.js

@@ -28,7 +28,7 @@ export const commandsCommand = (app) => {
                 reason: "output.one-object",
             });
     })
-        .argument("[path...]", "one command path, for example: search messages; inspect other groups in separate calls")
+        .argument("[path...]", `one command path, for example: ${app.messenger === false ? "commands info" : "search messages"}; inspect other groups in separate calls`)
         .action(function (path) {
         const root = rootOf(this);
         const output = outputFor(this);

package/dist/cli/effects.d.ts

@@ -48,6 +48,10 @@ export declare const changesStore: <T extends Command>(command: T) => T;
  */
 export declare const isStoreChange: (command: Command) => boolean;
 export declare const STORE_CHANGE_REFUSAL = "change the message store";
+/** ` --dry-run` where the program has it, so an example of a command that calls a provider calls nothing. */
+export declare const previewFlag: (program: Command) => string;
+/** What a read-only refusal says the command would do: the store holds more than messages outside a messenger. */
+export declare const storeChangeRefusal: (app: Pick<AppIdentity, "messenger">) => string;
 /** Under `<PREFIX>_READ_ONLY`, refuses a change to the store — for a caller outside `run()`, an MCP tool. */
 export declare const refuseStoreChange: (app: AppIdentity, env: NodeJS.ProcessEnv) => void;
 /**

package/dist/cli/effects.js

@@ -79,11 +79,15 @@ export const isStoreChange = (command) => {
         !changesAuthority(command));
 };
 export const STORE_CHANGE_REFUSAL = "change the message store";
+/** ` --dry-run` where the program has it, so an example of a command that calls a provider calls nothing. */
+export const previewFlag = (program) => program.options.some((option) => option.long === "--dry-run") ? " --dry-run" : "";
+/** What a read-only refusal says the command would do: the store holds more than messages outside a messenger. */
+export const storeChangeRefusal = (app) => app.messenger === false ? "change the local store" : STORE_CHANGE_REFUSAL;
 /** Under `<PREFIX>_READ_ONLY`, refuses a change to the store — for a caller outside `run()`, an MCP tool. */
 export const refuseStoreChange = (app, env) => {
     const lock = readOnlyLockOf(app, env);
     if (lock)
-        throw readOnlyRefusal(lock, STORE_CHANGE_REFUSAL);
+        throw readOnlyRefusal(lock, storeChangeRefusal(app));
 };
 const pathOf = (command) => {
     const words = [];

package/dist/cli/guide.d.ts

@@ -49,7 +49,7 @@ export declare const loadScenarios: (directory: string) => Promise<{
 }>;
 /**
  * `<tool> guide` lists the tool's scenarios and the ones it works with; `<tool> guide <name>` prints one: the goal,
- * each step as a command and why, and what to look at. The files are read when the command runs, never when the
+ * each step as a command and why, and what to look at. The files are parsed when the command runs, never when the
  * program is built. `checkGuide` validates them in the tool's CI.
  */
 export declare const guideCommand: (app: Pick<AppIdentity, "command">, options: GuideOptions) => Command;

package/dist/cli/guide.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 import { environmentOf, outputFor } from "./context.js";
 import { NO_EFFECTS } from "./effects.js";
 import { itemOf, listOf, renderAnswer } from "./envelope.js";
-import { PROFILE_FREE } from "./profile.js";
+import { commandWords, PROFILE_FREE, usableProfileName } from "./profile.js";
 /** memo's cross-tool scenarios: the one source of the titles every tool lists, and memo's files must carry. */
 export const MEMO_SCENARIOS = {
     personBrief: { tool: "memo", name: "person-brief", title: "One person across every tool" },
@@ -79,6 +79,19 @@ export const loadScenarios = async (directory) => {
         problems: parsed.flatMap(({ problems }) => problems),
     };
 };
+/** Only the file names, for the example: building the program parses no scenario. */
+const firstScenarioName = (directory) => {
+    try {
+        return readdirSync(directory)
+            .filter((file) => file.endsWith(".md") && file.toLowerCase() !== "readme.md")
+            .map((file) => basename(file, ".md"))
+            .filter((name) => NAME.test(name))
+            .sort()[0];
+    }
+    catch {
+        return undefined;
+    }
+};
 const guides = new WeakMap();
 const rows = (pairs) => {
     const width = pairs.reduce((most, [left]) => Math.max(most, left.length), 0) + 2;
@@ -110,13 +123,14 @@ const scenarioText = (cli, scenario, profile) => [
 ].join("\n");
 /**
  * `<tool> guide` lists the tool's scenarios and the ones it works with; `<tool> guide <name>` prints one: the goal,
- * each step as a command and why, and what to look at. The files are read when the command runs, never when the
+ * each step as a command and why, and what to look at. The files are parsed when the command runs, never when the
  * program is built. `checkGuide` validates them in the tool's CI.
  */
 export const guideCommand = (app, options) => {
+    const first = firstScenarioName(options.directory);
     const command = annotate(new Command("guide"), {
         effects: NO_EFFECTS,
-        examples: [`${app.command} guide`, `${app.command} guide <name> --json`],
+        examples: [`${app.command} guide`, ...(first ? [`${app.command} guide ${first} --json`] : [])],
     })
         .description("scenarios: the commands for a common task, in order, and why each")
         .argument("[name]", "one scenario; without it, the list")
@@ -242,6 +256,18 @@ const ownerOf = (chain, flag) => {
     }
     return undefined;
 };
+const isCommandWord = (program, word) => word !== undefined && commandWords(program).has(word);
+const isProfileWord = (word) => {
+    if (word === undefined || word.startsWith("-"))
+        return false;
+    try {
+        usableProfileName(word);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
 /** What is wrong with one step on this program: the path, each option and its value, the arguments. Never runs it. */
 export const checkStep = (program, run) => {
     const [tool, ...rest] = words(run);
@@ -249,7 +275,8 @@ export const checkStep = (program, run) => {
         return [`starts with "${tool ?? ""}", not ${program.name()}`];
     const chain = [program];
     let at = program;
-    let index = 0;
+    // The first word may be the profile, as the command line takes it: `tg personal chats list`.
+    let index = isCommandWord(program, rest[0]) || !isProfileWord(rest[0]) ? 0 : 1;
     for (; index < rest.length; index++) {
         const next = at.commands.find((one) => one.name() === rest[index] || one.aliases().includes(rest[index] ?? ""));
         if (!next)
@@ -257,8 +284,9 @@ export const checkStep = (program, run) => {
         chain.unshift(next);
         at = next;
     }
+    // A mistyped command reads like a profile word; when nothing follows that is a command, name the first word.
     if (at === program)
-        return [`no command "${rest[0] ?? ""}" — steps leave out the profile`];
+        return [`no command "${rest[0] ?? ""}"`];
     const help = at._getHelpOption();
     const beforeDashes = rest.slice(index, rest.includes("--") ? rest.indexOf("--") : undefined);
     if (help && beforeDashes.some((word) => word === help.long || word === help.short))

package/dist/cli/help/command-help.js

@@ -2,7 +2,7 @@ import { metaOf } from "@wirecat/cli-base/commands";
 import { writes } from "@wirecat/cli-base/standards";
 import { commandPathOf, outputOf } from "../command-contract.js";
 import { environmentOf } from "../context.js";
-import { PROFILE_FREE } from "../profile.js";
+import { takesProfile } from "../profile.js";
 import { commandAt } from "../steps.js";
 import { short } from "./commands-text.js";
 /** Argument names onto the kinds `domain/references.ts` names; a plural takes the same kind. */
@@ -177,7 +177,7 @@ export const EXAMPLE_PROFILE = "personal";
 const withProfile = (command, example) => {
     const root = rootOf(command);
     const top = commandPathOf(command)[0];
-    if (!profiled.has(root) || top === undefined || PROFILE_FREE.has(top))
+    if (!profiled.has(root) || top === undefined || !takesProfile(command))
         return example;
     const prefix = `${root.name()} ${top}`;
     return example === prefix || example.startsWith(`${prefix} `)
@@ -203,11 +203,16 @@ export const commandHelpText = (command) => {
         ...metaOf(command),
         path: commandPathOf(command),
     });
-    const access = availability
-        ? rows("Availability:", [
-            availability.available ? "available for this profile" : `unavailable — ${availability.reason}`,
-        ])
-        : [];
+    // "Available for this profile" says nothing where no profile is in play: a tool without profiles, or a command
+    // that reads none.
+    const profileMatters = profiled.has(rootOf(command)) && takesProfile(command);
+    const access = !availability
+        ? []
+        : availability.available
+            ? profileMatters
+                ? rows("Availability:", ["available for this profile"])
+                : []
+            : rows("Availability:", [`unavailable — ${availability.reason}`]);
     return [
         "",
         ...access,

package/dist/cli/help/first-screen.js

@@ -25,12 +25,12 @@ export const WIRECAT_TOOLS = [
     {
         command: "zm",
         package: "@wirecat/zoom-cli",
-        does: "Zoom meetings: transcripts and summaries, searchable with your messages",
+        does: "Zoom meetings: transcripts and summaries, searchable with your other WireCat data",
     },
     {
         command: "drive",
         package: "@wirecat/drive-cli",
-        does: "Google Drive and Docs as local text, searchable with your messages",
+        does: "Google Drive and Docs as local text, searchable with your other WireCat data",
     },
     {
         command: "memo",

package/dist/cli/index.d.ts

@@ -60,7 +60,7 @@ export { sharedCommandTemplate } from "./contract-templates.js";
 export { type Closeable, withDeadline } from "./deadline.js";
 export { DEFAULT_CONFIG, ensureDefaultConfig } from "./default-config.js";
 export { DISCOVERY_DESCRIPTIONS } from "./discovery-descriptions.js";
-export { changesAuthority, changesAuthorityAt, changesAuthorityNow, destroysNothing, FETCH, grantsAuthority, isLogin, isOtherServiceCall, isStoreChange, judgedEffects, judgedTargets, LOCAL_READ, LOCAL_WRITE, logsInOrOut, NO_EFFECTS, ownerOnlyOption, REMOTE_READ, REMOTE_WRITE, reachesOtherService, refuseUnderReadOnly, } from "./effects.js";
+export { changesAuthority, changesAuthorityAt, changesAuthorityNow, destroysNothing, FETCH, grantsAuthority, isLogin, isOtherServiceCall, isStoreChange, judgedEffects, judgedTargets, LOCAL_READ, LOCAL_WRITE, logsInOrOut, NO_EFFECTS, ownerOnlyOption, previewFlag, REMOTE_READ, REMOTE_WRITE, reachesOtherService, refuseUnderReadOnly, storeChangeRefusal, } from "./effects.js";
 export { type CliEntry, type EntryContext, type EntryIo, startCli } from "./entry.js";
 export { type AnswerOutput, answerSchema, type Body, type ItemBody, isBody, itemAnswer, itemOf, jsonlRecords, judgedAnswer, type ListBody, type ListInput, listOf, metaNow, printItem, renderAnswer, sealed, snakeKeys, snakeKeysKeeping, } from "./envelope.js";
 export { withAbort } from "./execution.js";
@@ -100,7 +100,7 @@ export { type Saving, stored } from "./messenger/stored.js";
 export { MODEL_CATALOGUE_QUERY, type ModelCatalogueOptions } from "./model-catalogue-command.js";
 export { window, withPaging } from "./paging.js";
 export { knownBeside, knownPermissionKeys, type PermissionKeyOf, unknownPermissionIssues, unknownPermissionKeys, } from "./permission-keys.js";
-export { asFirstWord, commandWords, liftProfile, refuseCommandName, rootOf, usableProfileName } from "./profile.js";
+export { asFirstWord, commandWords, liftProfile, profileFree, refuseCommandName, rootOf, takesProfile, usableProfileName, } from "./profile.js";
 export { createProgram, type ProgramDefinition, type ProgramOptions, type RunOptions, run } from "./program.js";
 export { fieldsOf, projectFields } from "./result-fields.js";
 export { type Config, type Configuration, count, first, flag, fromFile, type GlobalFlags, NONE_NAMED, namedProfile, type ProfileKind, plain, type ResolveOptions, type Settings, type SettingsExtension, type SettingsExtensionContext, type Source, settingsFor, } from "./settings.js";
@@ -109,5 +109,6 @@ export { AGENTS, type Agent, agentFor, screenFor } from "./setup-screen.js";
 export { accountCommand, addMeetingBatchCommand, addMeetingPreparationCommand, addMeetingProjectCandidatesCommand, addMeetingSeriesInventoryCommand, attachmentsCommand, botAdminsCommand, botCommand, botMcpCommand, botMembersCommand, botMessagesCommand, callsCommand, chatsCommand, commandsCommand, completeCommand, configCommand, contactsCommand, conversationsCommand, deleteCommand, doctorCommand, editCommand, floodCommand, forwardCommand, generatedApiCommand, guideCommand, imagesCommand, inboxCommand, markReadCommand, mcpCommand, mentionsCommand, messagesCommand, metadataCommand, modelCatalogueCommand, modelsCommand, pinCommand, pollsCommand, reactionsCommand, recipientsCommand, repliesCommand, reviewCommand, runsCommand, scheduleCommand, searchCommand, searchesCommand, sendCommand, sendsCommand, serveCommand, serverCommand, skillCommand, starCommands, statsCommand, stickersCommand, storeCommand, tagsCommand, tasksCommand, tasksStatsCommand, topicsCommand, unpinCommand, upgradeCommand, watchCommand, } from "./shared-command-exports.js";
 export { assertSharedContracts, customizeSharedCommand, hasSharedContract, overrideSharedContract, type SharedContractOverride, sharedContractOverrides, sharedContracts, } from "./shared-contracts.js";
 export { runnable, withSafety } from "./steps.js";
+export { type StoreInfo, sharedStoreCommand, storeInfo, storeInfoCommand } from "./store-info.js";
 export { changeStoreSetting, isStoreSetting, STORE_SETTINGS, storeSettings } from "./store-settings.js";
 export { restartServers, type UpgradeContext } from "./upgrade-command.js";

package/dist/cli/index.js

@@ -53,7 +53,7 @@ export { sharedCommandTemplate } from "./contract-templates.js";
 export { withDeadline } from "./deadline.js";
 export { DEFAULT_CONFIG, ensureDefaultConfig } from "./default-config.js";
 export { DISCOVERY_DESCRIPTIONS } from "./discovery-descriptions.js";
-export { changesAuthority, changesAuthorityAt, changesAuthorityNow, destroysNothing, FETCH, grantsAuthority, isLogin, isOtherServiceCall, isStoreChange, judgedEffects, judgedTargets, LOCAL_READ, LOCAL_WRITE, logsInOrOut, NO_EFFECTS, ownerOnlyOption, REMOTE_READ, REMOTE_WRITE, reachesOtherService, refuseUnderReadOnly, } from "./effects.js";
+export { changesAuthority, changesAuthorityAt, changesAuthorityNow, destroysNothing, FETCH, grantsAuthority, isLogin, isOtherServiceCall, isStoreChange, judgedEffects, judgedTargets, LOCAL_READ, LOCAL_WRITE, logsInOrOut, NO_EFFECTS, ownerOnlyOption, previewFlag, REMOTE_READ, REMOTE_WRITE, reachesOtherService, refuseUnderReadOnly, storeChangeRefusal, } from "./effects.js";
 export { startCli } from "./entry.js";
 export { answerSchema, isBody, itemAnswer, itemOf, jsonlRecords, judgedAnswer, listOf, metaNow, printItem, renderAnswer, sealed, snakeKeys, snakeKeysKeeping, } from "./envelope.js";
 export { withAbort } from "./execution.js";
@@ -91,7 +91,7 @@ export { stored } from "./messenger/stored.js";
 export { MODEL_CATALOGUE_QUERY } from "./model-catalogue-command.js";
 export { window, withPaging } from "./paging.js";
 export { knownBeside, knownPermissionKeys, unknownPermissionIssues, unknownPermissionKeys, } from "./permission-keys.js";
-export { asFirstWord, commandWords, liftProfile, refuseCommandName, rootOf, usableProfileName } from "./profile.js";
+export { asFirstWord, commandWords, liftProfile, profileFree, refuseCommandName, rootOf, takesProfile, usableProfileName, } from "./profile.js";
 export { createProgram, run } from "./program.js";
 export { fieldsOf, projectFields } from "./result-fields.js";
 export { count, first, flag, fromFile, NONE_NAMED, namedProfile, plain, settingsFor, } from "./settings.js";
@@ -100,5 +100,6 @@ export { AGENTS, agentFor, screenFor } from "./setup-screen.js";
 export { accountCommand, addMeetingBatchCommand, addMeetingPreparationCommand, addMeetingProjectCandidatesCommand, addMeetingSeriesInventoryCommand, attachmentsCommand, botAdminsCommand, botCommand, botMcpCommand, botMembersCommand, botMessagesCommand, callsCommand, chatsCommand, commandsCommand, completeCommand, configCommand, contactsCommand, conversationsCommand, deleteCommand, doctorCommand, editCommand, floodCommand, forwardCommand, generatedApiCommand, guideCommand, imagesCommand, inboxCommand, markReadCommand, mcpCommand, mentionsCommand, messagesCommand, metadataCommand, modelCatalogueCommand, modelsCommand, pinCommand, pollsCommand, reactionsCommand, recipientsCommand, repliesCommand, reviewCommand, runsCommand, scheduleCommand, searchCommand, searchesCommand, sendCommand, sendsCommand, serveCommand, serverCommand, skillCommand, starCommands, statsCommand, stickersCommand, storeCommand, tagsCommand, tasksCommand, tasksStatsCommand, topicsCommand, unpinCommand, upgradeCommand, watchCommand, } from "./shared-command-exports.js";
 export { assertSharedContracts, customizeSharedCommand, hasSharedContract, overrideSharedContract, sharedContractOverrides, sharedContracts, } from "./shared-contracts.js";
 export { runnable, withSafety } from "./steps.js";
+export { sharedStoreCommand, storeInfo, storeInfoCommand } from "./store-info.js";
 export { changeStoreSetting, isStoreSetting, STORE_SETTINGS, storeSettings } from "./store-settings.js";
 export { restartServers } from "./upgrade-command.js";

package/dist/cli/meeting-preparation-command.js

@@ -1,6 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import { annotate } from "@wirecat/cli-base/commands";
-import { REMOTE_READ } from "./effects.js";
+import { previewFlag, REMOTE_READ } from "./effects.js";
 import { communicationOptions } from "./meeting-communications.js";
 import { readMeetingPreparation } from "./meeting-preparation-read.js";
 const integer = (value) => {
@@ -48,6 +48,6 @@ export const addMeetingPreparationCommand = (program, deps) => {
         origin: "handwritten",
         effects: REMOTE_READ,
         output: { entity: "meeting_preparation" },
-        examples: [`${program.name()} meetings prepare 123 --json`],
+        examples: [`${program.name()} meetings prepare 123${previewFlag(program)} --json`],
     });
 };

package/dist/cli/meeting-series-inventory-command.js

@@ -1,6 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import { annotate } from "@wirecat/cli-base/commands";
-import { REMOTE_READ } from "./effects.js";
+import { previewFlag, REMOTE_READ } from "./effects.js";
 import { readMeetingSeriesInventory } from "./meeting-series-inventory-read.js";
 const integer = (value) => {
     if (!/^[1-9]\d*$/.test(value) || !Number.isSafeInteger(Number(value)))
@@ -32,6 +32,6 @@ export const addMeetingSeriesInventoryCommand = (program, deps) => {
         effects: REMOTE_READ,
         offline: false,
         output: { entity: "meeting_series_inventory" },
-        examples: [`${program.name()} meetings scheduled --json`],
+        examples: [`${program.name()} meetings scheduled${previewFlag(program)} --json`],
     });
 };

package/dist/cli/messenger/models-command.js

@@ -165,9 +165,10 @@ export const modelsCommand = (messenger) => {
     reachesOtherService(annotate(models.command("download"), {
         effects: FETCH,
         output: { entity: "model" },
-        examples: [`${tool} models download parakeet-v3`, `${tool} models download ${DEFAULT_TEXT_MODEL}`],
+        examples: [`${tool} models download ${DEFAULT_TEXT_MODEL}`],
     }))
-        .description("download and verify one speech or embedding model")
+        .summary("download and verify one speech or embedding model")
+        .description("download and verify one speech or embedding model: tens to hundreds of MB, each size in models list")
         .argument("<model>", "a model id from models list")
         .option("--accept-terms", "accept the model's licence terms, for a model that has its own")
         .action(async function (id, options) {

package/dist/cli/messenger/store-maintenance-command.d.ts

@@ -3,9 +3,9 @@ import type { CacheDatabase } from "../../store/driver.js";
 import type { Messenger } from "./context.js";
 /** `doctor`'s short summary of the store. Must answer for a broken file, so an error is a field. */
 export declare const storeSummary: (env: NodeJS.ProcessEnv) => Promise<{
-    error?: undefined;
     path: string;
     exists: boolean;
+    error?: undefined;
 } | {
     path: string;
     exists: boolean;

package/dist/cli/messenger/store-maintenance-command.js

@@ -7,31 +7,27 @@ import { holdersOf } from "../../background/processes.js";
 import { RULES_VERSION } from "../../conversations/link.js";
 import { syncsOneChat } from "../../ports/traits.js";
 import { isSealed, sealFile, unsealFile } from "../../sealed.js";
-import { MIGRATIONS, migrate } from "../../store/migrations.js";
+import { fileSchemaOf, SPEAKS, writableBy } from "../../store/compatibility.js";
+import { migrate } from "../../store/migrations.js";
 import { openCache } from "../../store/open.js";
 import { storePath } from "../../store/path.js";
 import { deleteCopy, repairStore } from "../../store/repair.js";
-import { drainNoteIndex, fillSearchIndex, fillStems, involvementStoreOver, noteIndexState, openSqlite, openStore, orphanPointers, pendingNormalization, resetAttachmentWords, resetNoteIndex, resetSearchIndex, resetStems, rowCounts, searchIndexState, stemmerCache, stemsState, storeContents, } from "../../store/store.js";
+import { drainNoteIndex, fillSearchIndex, fillStems, involvementStoreOver, noteIndexState, openStore, orphanPointers, pendingNormalization, resetAttachmentWords, resetNoteIndex, resetSearchIndex, resetStems, searchIndexState, stemmerCache, stemsState, } from "../../store/store.js";
 import { environmentOf, outputFor } from "../context.js";
 import { destroysNothing, LOCAL_READ, LOCAL_WRITE } from "../effects.js";
 import { itemOf, renderAnswer, snakeKeys } from "../envelope.js";
 import { lineOf, nextStep } from "../steps.js";
+import { storeInfoCommand } from "../store-info.js";
 import { answerOf } from "./ask.js";
 import { ENCRYPT_OPTION, passwordOf } from "./password.js";
 import { servingProfiles } from "./serve-command.js";
-const SPEAKS = MIGRATIONS.at(-1)?.version ?? 0;
+import { storeTablesCommand } from "./store-tables-command.js";
 const SEARCH_INDEXES = ["messages_fts", "chats_fts", "identities_fts"];
 /** Contentless: it has no table to be compared with, only its own structure to check. */
 const WORD_INDEX = "message_words";
-/** An empty file is normal: `openStore` creates it before the first migration runs. */
 const schemaOf = (database) => {
-    const tracked = database.prepare("SELECT 1 FROM sqlite_master WHERE name = 'schema_migrations'").get();
-    const row = tracked
-        ? database.prepare("SELECT version, min_compatible FROM schema_migrations ORDER BY version DESC LIMIT 1").get()
-        : undefined;
-    const version = Number(row?.version ?? 0);
-    const minCompatible = Number(row?.min_compatible ?? 0);
-    return { version, minCompatible, writable: version <= SPEAKS || minCompatible <= SPEAKS };
+    const file = fileSchemaOf(database);
+    return { ...file, writable: writableBy(file) };
 };
 const count = (database, table) => Number(database.prepare(`SELECT count(*) AS n FROM ${table}`).get()?.n ?? 0);
 /** Before version 6 the column does not exist, and a file behind this build is not migrated here. */
@@ -49,16 +45,6 @@ const reading = async (path, read) => {
         database.close();
     }
 };
-/** For a command that only reads: the connection refuses writes, and opening sets no journal mode. */
-const readingOnly = async (path, read) => {
-    const { database } = await openSqlite(path, { readOnly: true });
-    try {
-        return read(database);
-    }
-    finally {
-        database.close();
-    }
-};
 /** `doctor`'s short summary of the store. Must answer for a broken file, so an error is a field. */
 export const storeSummary = async (env) => {
     const path = storePath(env);
@@ -84,7 +70,7 @@ export const storeSummary = async (env) => {
 /** A maintenance answer: one item, snake_case, its hints as steps where a registered one fits. */
 const result = (command, value, next = []) => renderAnswer(command, outputFor(command), itemOf(snakeKeys(value), { next }));
 export const storeMaintenanceCommands = (messenger) => [
-    infoCommand(),
+    storeInfoCommand(),
     checkCommand(messenger),
     migrateCommand(messenger),
     reindexCommand(messenger),
@@ -94,6 +80,7 @@ export const storeMaintenanceCommands = (messenger) => [
     repairCommand(messenger),
     resetCommand(messenger),
     copiesCommand(),
+    storeTablesCommand(messenger),
 ];
 /** Renaming tables under a running `serve` would pull them from under its statements. */
 const refuseWhileServing = (command, messenger) => {
@@ -162,31 +149,6 @@ const copiesCommand = () => new Command("copies").description("the tables `store
     const deleted = await reading(path, (database) => deleteCopy(database, name));
     result(this, { path, deleted });
 }));
-const infoCommand = () => annotate(new Command("info"), { output: { entity: "store_info" }, effects: LOCAL_READ })
-    .summary("the local archive's format, size and contents")
-    .description("the store file: where it is, its size, its schema and how many rows it holds, by provider, chat kind, account, year (UTC) and attachment kind, over every account; changes nothing")
-    .action(async function () {
-    const path = storePath(environmentOf(this).env ?? process.env);
-    if (!existsSync(path)) {
-        result(this, { path, exists: false });
-        return;
-    }
-    const read = readingOnly(path, (database) => {
-        const { version, minCompatible, writable } = schemaOf(database);
-        return {
-            path,
-            exists: true,
-            bytes: { file: bytesOf(path), wal: bytesOf(`${path}-wal`) },
-            schema: { version, minCompatible, speaks: SPEAKS, writable },
-            rows: version > 0 ? rowCounts(database) : {},
-            pendingNormalization: pendingIfKnown(database),
-            wordIndex: searchIndexState(database) ?? null,
-            stemIndex: stemsState(database) ?? null,
-            ...(version > 0 ? storeContents(database) : {}),
-        };
-    });
-    result(this, await read.catch((error) => ({ path, exists: true, opens: false, error: messageOf(error) })));
-});
 /**
  * Reports and never repairs. The per-chat completeness is what tells "nothing was said" from "not
  * fetched" (NEED-399 A). Times are the chat's newest message by the messenger's list against the

package/dist/cli/messenger/store-tables-command.d.ts

@@ -0,0 +1,5 @@
+import { type QueryRegistry } from "@wirecat/cli-base/query";
+import { Command } from "commander";
+import type { Messenger } from "./context.js";
+export declare const STORE_TABLES_QUERY: QueryRegistry;
+export declare const storeTablesCommand: (messenger: Messenger) => Command;

package/dist/cli/messenger/store-tables-command.js

@@ -0,0 +1,59 @@
+import { existsSync } from "node:fs";
+import { CliError } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { queryFieldsOf } from "@wirecat/cli-base/query";
+import { Command } from "commander";
+import { storeTable } from "../../entities/store-table.js";
+import { storePath } from "../../store/path.js";
+import { readStoreTables } from "../../store/store.js";
+import { environmentOf, outputFor } from "../context.js";
+import { LOCAL_READ } from "../effects.js";
+import { listOf, renderAnswer } from "../envelope.js";
+import { queryTerms, typedQuery, withQuery } from "../list-query.js";
+const PATH = "store tables list";
+export const STORE_TABLES_QUERY = {
+    entity: "store_table",
+    backend: "native",
+    fields: queryFieldsOf(storeTable, {
+        native: ["name", "kind"],
+        examples: { name: "name:messages", kind: "kind:data" },
+    }).map((field) => field.native
+        ? { ...field, operators: field.operators.filter((operator) => operator === "term" || operator === "phrase") }
+        : field),
+};
+const filterOf = (words) => {
+    const terms = queryTerms(words, STORE_TABLES_QUERY, PATH);
+    const name = terms.get("name");
+    const kind = terms.get("kind");
+    return { ...(name === undefined ? {} : { name }), ...(kind === undefined ? {} : { kind }) };
+};
+export const storeTablesCommand = (messenger) => {
+    const tables = new Command("tables").description("the tables of the local archive");
+    withQuery(annotate(tables.command("list"), {
+        effects: LOCAL_READ,
+        examples: [
+            `${messenger.app.command} store tables list`,
+            `${messenger.app.command} store tables list kind:data`,
+            `${messenger.app.command} store tables list --full --json`,
+        ],
+    }), STORE_TABLES_QUERY)
+        .summary("every table of the local archive, with its kind and row count")
+        .description("every table of the local archive: its kind (data, search index, part of a search index, internal) and its " +
+        "rows, a search index's rows not counted; --full adds each table's size on disk, which reads the whole file " +
+        "(about ten seconds for 3 GB); changes nothing")
+        .action(async function (words) {
+        const filter = filterOf(words);
+        const { full } = this.optsWithGlobals();
+        const path = storePath(environmentOf(this).env ?? process.env);
+        if (!existsSync(path))
+            throw new CliError("not_found", `no store at ${path}`);
+        const items = await readStoreTables(path, { filter, sizes: full === true });
+        renderAnswer(this, outputFor(this), listOf(PATH, {
+            items,
+            limit: Math.max(1, items.length),
+            has_more: false,
+            args: words.length ? { query: typedQuery(words) } : {},
+        }));
+    });
+    return tables;
+};

package/dist/cli/profile.d.ts

@@ -4,6 +4,13 @@ export declare const asFirstWord: (profile: string) => string;
 export declare const usableProfileName: (profile: string) => string;
 /** The top-level commands that never read a profile; every other one is `<tool> <profile> …`. */
 export declare const PROFILE_FREE: ReadonlySet<string>;
+/**
+ * Marks a command, and every command under it, as one that reads no profile, so help shows it without one:
+ * `drive doctor`, not `drive personal doctor`. Which commands those are is the CLI's to say.
+ */
+export declare const profileFree: <T extends Command>(command: T) => T;
+/** Whether the command line puts a profile before this command: not for `PROFILE_FREE` or a `profileFree` one. */
+export declare const takesProfile: (command: Command) => boolean;
 /**
  * Every word that means a command at the top level. Taken off the built program rather than
  * written out, because a list written out goes stale the day a command is added — and `help` is in

package/dist/cli/profile.js

@@ -16,6 +16,25 @@ export const usableProfileName = (profile) => {
 };
 /** The top-level commands that never read a profile; every other one is `<tool> <profile> …`. */
 export const PROFILE_FREE = new Set(["commands", "complete", "guide", "help", "skill", "upgrade"]);
+const freeOfProfile = new WeakSet();
+/**
+ * Marks a command, and every command under it, as one that reads no profile, so help shows it without one:
+ * `drive doctor`, not `drive personal doctor`. Which commands those are is the CLI's to say.
+ */
+export const profileFree = (command) => {
+    freeOfProfile.add(command);
+    return command;
+};
+/** Whether the command line puts a profile before this command: not for `PROFILE_FREE` or a `profileFree` one. */
+export const takesProfile = (command) => {
+    let top;
+    for (let at = command; at?.parent; at = at.parent) {
+        if (freeOfProfile.has(at))
+            return false;
+        top = at;
+    }
+    return top !== undefined && !PROFILE_FREE.has(top.name());
+};
 /**
  * Every word that means a command at the top level. Taken off the built program rather than
  * written out, because a list written out goes stale the day a command is added — and `help` is in

package/dist/cli/program.js

@@ -18,7 +18,7 @@ import { commandAvailability } from "./command-availability.js";
 import { commandPathOf } from "./command-contract.js";
 import { outputFor, provide } from "./context.js";
 import { refuseWriteBeforeConnecting } from "./early-refusal.js";
-import { changesAuthorityAt, changesAuthorityNow, isLogin, isStoreChange, judgedEffects, judgedTargets, STORE_CHANGE_REFUSAL, } from "./effects.js";
+import { changesAuthorityAt, changesAuthorityNow, isLogin, isStoreChange, judgedEffects, judgedTargets, storeChangeRefusal, } from "./effects.js";
 import { itemOf, renderAnswer, snakeKeys } from "./envelope.js";
 import { byteCount, DEFAULT_COMMAND_MS, DEFAULT_OUTPUT_BYTES, execution } from "./execution.js";
 import { setupAtStart } from "./first-run.js";
@@ -27,7 +27,7 @@ import { showInputFields } from "./input-fields.js";
 import { MAX_BUFFERED_INPUT, provideInputPolicy } from "./input-policy.js";
 import { checkJson, liftJson } from "./json-fields.js";
 import { PreviewComplete, preview } from "./preview.js";
-import { commandWords, liftProfile, PROFILE_FREE, sampleCommand, valuedOptions } from "./profile.js";
+import { commandWords, liftProfile, sampleCommand, takesProfile, valuedOptions } from "./profile.js";
 import { absolutePaths, relayTarget } from "./relay-route.js";
 import { NoProfileHere, namedProfile, settingsFor, } from "./settings.js";
 import { assertSharedContracts } from "./shared-contracts.js";
@@ -74,14 +74,15 @@ export const createProgram = ({ app, commands, configure, firstScreen }, { out,
     assertSharedContracts(program);
     installHelp(program, { pitch: app.description, ...firstScreen });
     // Commander builds a usage line from the command tree, where the profile is not a word.
-    for (const top of program.commands) {
-        if (PROFILE_FREE.has(top.name()))
-            continue;
-        forEachCommand(top, (command) => command.configureHelp({
-            ...command.configureHelp(),
-            commandUsage: (shown) => `${app.command} <profile>${new Help().commandUsage(shown).slice(app.command.length)}`,
-        }));
-    }
+    if (firstScreen?.profile !== false)
+        for (const top of program.commands)
+            forEachCommand(top, (command) => command.configureHelp({
+                ...command.configureHelp(),
+                commandUsage: (shown) => {
+                    const usage = new Help().commandUsage(shown);
+                    return takesProfile(shown) ? `${app.command} <profile>${usage.slice(app.command.length)}` : usage;
+                },
+            }));
     // Depth-first: Commander does not pass `configureOutput` down to a command added with
     // `addCommand`, so `tg messages --help` would write to the real terminal.
     if (out || err) {
@@ -284,7 +285,7 @@ const runOnce = async (argv, definition, options) => {
         if (lock && isLogin(action) && !flags.dryRun)
             throw readOnlyRefusal(lock, "log in or out");
         if (lock && isStoreChange(action) && !flags.dryRun)
-            throw readOnlyRefusal(lock, STORE_CHANGE_REFUSAL);
+            throw readOnlyRefusal(lock, storeChangeRefusal(definition.app));
         refuseWriteBeforeConnecting(action, {
             app: definition.app,
             env: commandEnv,