@wirecat/cli-core 0.410.0 → 0.412.0

package/CHANGELOG.md

@@ -5,6 +5,50 @@ 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.412.0 — 24.10.2026
+
+### Added
+
+- **A stored provider registry** (available from cli-core 0.413.0). `registerProvider(store, { name, kind, aliases, command })` (from `@wirecat/cli-core/store`) writes a CLI's entry into `store_settings` under the key `providers`; every store handle loads the stored entries when it opens, so `kindOf`, `providerNamed` and `--source` in every CLI know a provider cli-core does not list. The built-ins stay the seed. `useProviders(entries)`, `kindIn(provider)`, `providerNamed`, `kindOf`, `providers()`, `KINDS` and `PROVIDERS` are exported from `@wirecat/cli-core`. Two entries that disagree on a kind, or an alias another provider has, are a `validation_error` naming both; a stored entry that clashes with a built-in is left out when the store opens, so it never stops the store opening.
+- **Knowledge lists filter at their native readers.** Organizations, projects, reminders and mail rules accept optional queries before SQL list bounds. Document tags and links accept native selectors, and meeting-link reads can select one URL before aggregation. Existing unfiltered calls keep their behavior.
+
+### Changed — may break callers
+
+- **A provider no registry entry names is skipped, never searched as messages** (available from cli-core 0.413.0). `search messages`, `search all` and `--source` lists report each of its accounts under `skipped` with the reason "unknown provider — run its CLI once" (code `not_found`). The account the search runs as is still read, whatever its provider. `kindOf` keeps its signature and its `messages` default; `kindIn` answers `undefined` for such a provider. `ListedAccount.kind` is now `Kind | undefined`.
+- **`KINDS` and `Kind` gain `events`** (available from cli-core 0.413.0). No search reads events yet; `--source events` says so.
+- **`bot store fetch` is now `bot messages sync`, and the `bot store` group is gone** (tg and max). It does what the personal `messages sync` does, so it carries the same name; `store` is for the local database. The old path answers with a pointer to the new one, and a saved `permissions.bot.store.fetch` is refused until it is renamed to `permissions.bot.messages.sync`. A CLI that customizes the command must move its override to the new path.
+
+### Fixed
+
+- **`config set` and `config unset` work while a moved permission key is saved.** Every other command still refuses the old key and names its replacement; `config unset permissions.<old>` and `config set permissions.<new>` now fix it instead of failing with the same error.
+- **`tasks update <task> --parent none` clears the parent.** The CLI keeps the sentinel through option parsing and converts it to null when building the plan, so Commander cannot turn it into an empty task id.
+
+## 0.411.0 — 24.10.2026
+
+### Added
+
+- **Stored events accept native queries on id, origin and timestamps.** SQLite applies filters before returning rows; stores without query support refuse a filtered request.
+- **Shared task updates include project priority and parent.** Project tasks can be updated without choosing a messenger account.
+
+- **`commands info --json` exports schemas, declared error reasons and explicit contract overrides.** Providers with
+  their own program shell use `addContractInfo`; field-only declarations are labelled separately from typed schemas.
+- **Provider model catalogues share `modelCatalogueCommand`.** Providers choose supported kinds and bind output,
+  environment and offline policy; native query filtering, model receipts and verified downloads stay in core.
+
+
+### Changed — may break callers
+
+- **Contact activity and diagnostic run times filter through native queries.** Use `contacts events <person> scope:work 'at:[2026-10-01 TO 2026-10-31]'` and `search runs 'started_at>=7d'` instead of their time/scope flags. Time bounds reach the native readers before pagination, and continuations preserve the query.
+- **Webhook setup adds another address with `--append`.** `--add <chat>` keeps its folder-edit meaning. Webhook answers omit an unrestricted or unknown type list instead of emitting `types: null`.
+
+- **Unknown chat rosters are omitted instead of returned as `members: null`.** An empty array means a known empty roster. Send-attempt output exposes only `operation_id`; legacy journal entries remain readable.
+- **Stored meeting topic labels use `--topic-name`.** `--topic` remains the messenger forum-topic id. Update meeting-search invocations and continuations to the unambiguous name.
+
+- **Core-owned command contracts reject silent edits after construction.** Use `overrideSharedContract` with a
+  specific reason and a callback before modifying an inherited definition. Exact before/after values remain visible
+  in contract discovery. Independent shell replacements pin static, reviewed declarations, so new Core defaults cannot be silently omitted. Provider-only commands may extend groups; inherited leaves retain their contracts.
+
 ## 0.410.0 — 24.10.2026
 
 ### Added

package/dist/cli/bot/command.js

@@ -16,12 +16,12 @@ import { botExamples } from "./examples.js";
 import { BOT_CHATS_QUERY, BOT_PROFILES_QUERY, botChatFilter, botProfileName } from "./list-queries.js";
 import { botMcpCommand } from "./mcp.js";
 import { botCan, botIdOf, botMessagesCommand } from "./messages.js";
+import { botMessagesSyncCommand } from "./messages-sync.js";
 import { botModerateCommand, botRulesCommand } from "./moderation.js";
 import { addBotCopyReads, botContactsCommand, botSearchCommand } from "./people.js";
 import { BOT_ACTIONS } from "./port.js";
 import { registryProfiles } from "./registry.js";
 import { botCallbacksCommand, botMenuCommand, botWebhooksCommand } from "./setup.js";
-import { botStoreCommand } from "./store.js";
 import { BotTokenStore } from "./token.js";
 import { botWatchCommand } from "./watch.js";
 /** Where each of the messenger's other secrets comes from, `null` when it is not set; never the value. */
@@ -105,6 +105,7 @@ const authCommand = (bot, tokenVariable) => {
     return auth;
 };
 const meCommand = (bot) => annotate(new Command("me"), { effects: REMOTE_READ, examples: botExamples(bot, "me") })
+    .summary("the bot this profile's token belongs to")
     .description("the bot this profile's token belongs to: id, name and username")
     .action(async function () {
     const context = online(botContext(this, bot), this);
@@ -288,6 +289,8 @@ const chatsCommand = (bot) => {
  */
 const withCopyReads = (messages, bot) => {
     addBotCopyReads(messages, bot);
+    if (bot.fetching)
+        messages.addCommand(botMessagesSyncCommand(bot, bot.fetching));
     return messages;
 };
 export const botCommand = (bot) => {
@@ -309,7 +312,5 @@ export const botCommand = (bot) => {
         .addCommand(botContactsCommand(bot));
     if (bot.identity)
         command.addCommand(meCommand(bot));
-    if (bot.fetching)
-        command.addCommand(botStoreCommand(bot, bot.fetching));
     return bot.mcp ? command.addCommand(botMcpCommand(bot)) : command;
 };

package/dist/cli/bot/messages-sync.d.ts

@@ -0,0 +1,7 @@
+import { Command } from "commander";
+import type { BotMessenger } from "./port.js";
+/**
+ * `bot messages sync`: a chat's history into the bot's local copy, newest to oldest and resumable, as the
+ * personal `messages sync` does. Mounted for a messenger whose Bot API pages back through a chat.
+ */
+export declare const botMessagesSyncCommand: (bot: BotMessenger, fetching: NonNullable<BotMessenger["fetching"]>) => Command;

package/dist/cli/bot/{store.js → messages-sync.js}

@@ -16,12 +16,11 @@ const wholeNumber = (value) => {
     return parsed;
 };
 /**
- * `bot store fetch`: a chat's history into the bot's local copy, newest to oldest and resumable, as the
+ * `bot messages sync`: a chat's history into the bot's local copy, newest to oldest and resumable, as the
  * personal `messages sync` does. Mounted for a messenger whose Bot API pages back through a chat.
  */
-export const botStoreCommand = (bot, fetching) => {
-    const command = new Command("store").description("the bot's local copy on this machine");
-    const fetch = annotate(command.command("fetch"), { effects: FETCH })
+export const botMessagesSyncCommand = (bot, fetching) => {
+    const fetch = annotate(new Command("sync"), { effects: FETCH })
         .description("fetch a chat's history into the bot's local copy, newest first; run it again to continue")
         .argument("<chat>", "a chat id, or the title of a chat this bot has seen")
         .option("--limit <n>", `at most this many messages in this run; ${fetching.maxPages * fetching.page} if not given`, wholeNumber)
@@ -85,5 +84,5 @@ export const botStoreCommand = (bot, fetching) => {
             stop.release();
         }
     });
-    return command;
+    return fetch;
 };

package/dist/cli/bot/port.d.ts

@@ -53,7 +53,7 @@ export interface BotHistory {
         messages: Message[];
         more: boolean;
     }>;
-    /** One page back from `before` (or from now), newest first: what `bot store fetch` walks. */
+    /** One page back from `before` (or from now), newest first: what `bot messages sync` walks. */
     historyBefore(chat: BotChatRef, window: {
         limit: number;
         before?: string;
@@ -250,7 +250,7 @@ export interface BotNativeApi {
 export interface BotConnectOptions {
     stop?: AbortSignal;
     events?: EventSink;
-    /** Only `bot store fetch` asks for a history reader; other commands stay on the Bot API. */
+    /** Only `bot messages sync` asks for a history reader; other commands stay on the Bot API. */
     history?: {
         from?: string;
         pauseMs: number;
@@ -267,7 +267,7 @@ export interface BotMessenger {
     name?: string;
     /** The admin rights `--can` offers; every shared one when unset. */
     adminRights?: readonly AdminRight[];
-    /** Whether `bot webhooks set --add` keeps the other addresses; a messenger with one address has no `--add`. */
+    /** Whether `bot webhooks set --append` keeps the other addresses; a messenger with one address has no `--add`. */
     manyWebhooks?: boolean;
     /** Secrets beside the token, each set with `bot auth set --secret <name>`; none when unset. */
     secrets?: readonly BotSecret[];
@@ -295,7 +295,7 @@ export interface BotMessenger {
     readSecret?: (command: Command, prompt: string) => Promise<string>;
     /** What kind of chat a stored message came from; without it a positive id is a dialog, a negative one a group. */
     chatKindOf?: (hit: StoredHit) => ChatKind;
-    /** How its history pages, for `bot store fetch`, which is mounted only when this is set. */
+    /** How its history pages, for `bot messages sync`, which is mounted only when this is set. */
     /** `from`: the help of `--until-id`, the message the fetch starts at; the option is mounted only when set. */
     fetching?: Fetching & {
         from?: string;

package/dist/cli/bot/setup.js

@@ -121,7 +121,10 @@ export const botWebhooksCommand = (bot) => {
         const context = online(botContext(this, bot), this);
         await context.run(async (events) => {
             const adapter = await context.authenticated({ events });
-            renderAnswer(this, context, wholeList("bot webhooks list", (await botCan(adapter, "webhooks", bot, "list its webhooks")()).map(snakeKeys)));
+            renderAnswer(this, context, wholeList("bot webhooks list", (await botCan(adapter, "webhooks", bot, "list its webhooks")()).map(({ url, types }) => ({
+                url,
+                ...(types == null ? {} : { types }),
+            }))));
         });
     });
     const set = annotate(command.command("set"), {
@@ -133,7 +136,7 @@ export const botWebhooksCommand = (bot) => {
         .option("--types <types>", "only these update types, comma-separated, in the messenger's words")
         .option("--secret-stdin", "a secret the messenger sends back with each update — asked for, or read from a pipe");
     if (bot.manyWebhooks)
-        set.option("--add", "keep the webhooks already set and add this one beside them");
+        set.option("--append", "keep the webhooks already set and add this one beside them");
     set.action(async function (url) {
         const context = online(botContext(this, bot), this);
         const options = this.opts();
@@ -141,10 +144,10 @@ export const botWebhooksCommand = (bot) => {
             const adapter = await context.authenticated({ events });
             const list = botCan(adapter, "webhooks", bot, "list its webhooks");
             const others = (await list()).filter((one) => one.url !== url);
-            if (others.length > 0 && !options.add) {
+            if (others.length > 0 && !options.append) {
                 throw new CliError("confirmation_required", `this bot already sends its updates to ${others.map((one) => one.url).join(", ")} — ` +
                     `remove it first with \`${context.words} webhooks delete <url>\`` +
-                    (bot.manyWebhooks ? ", or give --add to get every update at both" : ""));
+                    (bot.manyWebhooks ? ", or give --append to get every update at both" : ""));
             }
             const types = typesOf(options.types);
             const setWebhook = botCan(adapter, "setWebhook", bot, "set a webhook");
@@ -170,7 +173,10 @@ export const botWebhooksCommand = (bot) => {
             const adapter = await context.authenticated({ events });
             const remove = botCan(adapter, "deleteWebhook", bot, "delete a webhook");
             await botWrite(context, "bot.webhooks.delete", () => remove(url));
-            renderAnswer(this, context, wholeList("bot webhooks list", (await botCan(adapter, "webhooks", bot, "list its webhooks")()).map(snakeKeys)));
+            renderAnswer(this, context, wholeList("bot webhooks list", (await botCan(adapter, "webhooks", bot, "list its webhooks")()).map(({ url, types }) => ({
+                url,
+                ...(types == null ? {} : { types }),
+            }))));
         });
     });
     return command;

package/dist/cli/commands-command.js

@@ -4,6 +4,8 @@ import { CRASH_CODE } from "@wirecat/cli-base/standards";
 import { Command } from "commander";
 import { commandContract, commandPathOf, findCommand } from "./command-contract.js";
 import { environmentOf, outputFor } from "./context.js";
+import { contractEvidence } from "./contract-evidence.js";
+import { DISCOVERY_DESCRIPTIONS } from "./discovery-descriptions.js";
 import { NO_EFFECTS } from "./effects.js";
 import { renderDocument } from "./envelope.js";
 import { commandsText } from "./help/commands-text.js";
@@ -19,7 +21,7 @@ export const CONTRACT = 3;
  */
 export const commandsCommand = (app) => {
     const command = annotate(new Command("commands"), { effects: NO_EFFECTS })
-        .description("every command by section, one line each; --json: the contract, one path per call")
+        .description(DISCOVERY_DESCRIPTIONS.commands)
         .hook("preAction", (_command, action) => {
         if (action.optsWithGlobals().jsonl)
             throw new CliError("validation_error", "command discovery is one JSON object — use --json", {
@@ -59,22 +61,26 @@ export const commandsCommand = (app) => {
         effects: NO_EFFECTS,
         examples: [`${app.command} commands info messages list`],
     })
-        .description("one command's argv and result schemas, effects, permissions and retry guidance")
-        .argument("<path...>", "one command path, for example: stats messages show")
+        .description(DISCOVERY_DESCRIPTIONS.info)
+        .argument("[path...]", "one command path; without one, export schemas, error reasons and explicit overrides")
         .action(function (path) {
         renderDocument(outputFor(this), {
             cli: app.command,
             version: app.version,
             contract: CONTRACT,
-            ...commandContract(findCommand(rootOf(this), path)),
-            ...(() => {
-                const found = findCommand(rootOf(this), path);
-                const availability = environmentOf(this).discoveryAvailability?.({
-                    ...metaOf(found),
-                    path: commandPathOf(found),
-                });
-                return availability ? { availability } : {};
-            })(),
+            ...(path.length
+                ? {
+                    ...commandContract(findCommand(rootOf(this), path)),
+                    ...(() => {
+                        const found = findCommand(rootOf(this), path);
+                        const availability = environmentOf(this).discoveryAvailability?.({
+                            ...metaOf(found),
+                            path: commandPathOf(found),
+                        });
+                        return availability ? { availability } : {};
+                    })(),
+                }
+                : contractEvidence(rootOf(this), app.errors ? { errors: app.errors } : {})),
         });
     }));
     return command;

package/dist/cli/config-command.js

@@ -64,6 +64,7 @@ export const configCommand = (app, config, { permissionKey } = {}) => {
             const context = baseContext(this, (flags, options) => config.resolveSettings(flags, {
                 ...options,
                 needsProfile: !everyone && setting !== "default_profile" && !isStoreSetting(setting),
+                skipMovedPermissions: true,
             }));
             const { settings, renderer, env } = context;
             if (isStoreSetting(setting)) {

package/dist/cli/contract-evidence.d.ts

@@ -0,0 +1,26 @@
+import type { Command } from "commander";
+import { type AppErrors } from "../errors/reasons.js";
+import type { JsonFieldsResolver } from "./json-fields.js";
+export interface ContractEvidenceOptions {
+    fields?: JsonFieldsResolver;
+    errors?: AppErrors;
+}
+export declare const contractEvidence: (root: Command, { fields, errors }?: ContractEvidenceOptions) => {
+    schemas: {
+        [k: string]: {
+            $schema: string;
+        };
+    };
+    contracts: Record<string, unknown>;
+    field_only: string[];
+    reasons: readonly {
+        reason: string;
+        code: "authentication_error" | "cancelled" | "configuration_error" | "confirmation_required" | "internal_error" | "invalid_response" | "network_error" | "not_found" | "outcome_unknown" | "permission_error" | "provider_error" | "provider_unavailable" | "rate_limited" | "timeout" | "validation_error";
+        message: string;
+        details: string[];
+        step?: string | undefined;
+    }[] | undefined;
+    overrides: import("@wirecat/cli-base/commands").SharedContractOverride[];
+};
+/** Same discovery endpoint for the shared runner and providers with their own output/context adapters. */
+export declare const addContractInfo: (root: Command, output: (value: unknown) => void, options?: ContractEvidenceOptions) => Command;

package/dist/cli/contract-evidence.js

@@ -0,0 +1,58 @@
+import { CliError } from "@wirecat/cli-base";
+import { annotate, describeProgram, flatten } from "@wirecat/cli-base/commands";
+import { jsonSchemaOf } from "@wirecat/cli-base/standards";
+import { entityDefinitions } from "../entities/index.js";
+import { failureContext } from "../errors/reasons.js";
+import { answerEntitySchema } from "./answer-entity.js";
+import { commandContract, findCommand, SCHEMA_DIALECT } from "./command-contract.js";
+import { DISCOVERY_DESCRIPTIONS } from "./discovery-descriptions.js";
+import { NO_EFFECTS } from "./effects.js";
+import { sharedContractOverrides, sharedContracts } from "./shared-contracts.js";
+export const contractEvidence = (root, { fields, errors } = {}) => {
+    const schemas = { ...entityDefinitions() };
+    const fieldOnly = [];
+    for (const info of flatten(describeProgram(root))) {
+        if (!info.output)
+            continue;
+        const name = info.output.view ? `${info.output.entity}.${info.output.view}` : info.output.entity;
+        const command = findCommand(root, info.path);
+        const schema = answerEntitySchema(command);
+        if (schema)
+            schemas[name] = jsonSchemaOf(schema);
+        else if (schemas[name] === undefined) {
+            const names = fields?.(command);
+            if (names) {
+                schemas[name] = {
+                    type: "object",
+                    properties: Object.fromEntries(names.map((name) => [name, {}])),
+                    additionalProperties: false,
+                };
+                fieldOnly.push(name);
+            }
+        }
+    }
+    return {
+        schemas: Object.fromEntries(Object.entries(schemas).map(([name, schema]) => [name, { $schema: SCHEMA_DIALECT, ...schema }])),
+        contracts: sharedContracts(root),
+        field_only: [...new Set(fieldOnly)].sort(),
+        reasons: failureContext(errors).reasons,
+        overrides: sharedContractOverrides(root),
+    };
+};
+/** Same discovery endpoint for the shared runner and providers with their own output/context adapters. */
+export const addContractInfo = (root, output, options = {}) => {
+    const commands = root.commands.find((command) => command.name() === "commands");
+    if (!commands)
+        throw new CliError("configuration_error", "contract discovery needs the commands group");
+    const info = commands.commands.find((command) => command.name() === "info") ?? commands.command("info");
+    annotate(info, { effects: NO_EFFECTS, examples: [`${root.name()} commands info --json`] });
+    if (info.registeredArguments.length === 0)
+        info.argument("[path...]", "one command path; without one, schemas, error reasons and explicit overrides");
+    if (!info.options.some((option) => option.long === "--json") &&
+        !root.options.some((option) => option.long === "--json"))
+        info.option("--json", "print JSON");
+    info
+        .description(DISCOVERY_DESCRIPTIONS.info)
+        .action((path) => output(path.length ? commandContract(findCommand(root, path)) : contractEvidence(root, options)));
+    return info;
+};

package/dist/cli/contract-templates.d.ts

@@ -0,0 +1,4 @@
+import { Command } from "commander";
+import type { AppIdentity } from "../ports/app.js";
+/** Construction-only defaults for a CLI that explicitly binds an independent source or transport. */
+export declare const sharedCommandTemplate: (app: AppIdentity, name: "commands" | "doctor" | "mcp" | "search" | "notes" | "session" | "setup" | "meetings") => Command;

package/dist/cli/contract-templates.js

@@ -0,0 +1,83 @@
+import { CliError } from "@wirecat/cli-base";
+import { annotate, sharedCommand } from "@wirecat/cli-base/commands";
+import { Command } from "commander";
+import { note } from "../entities/note.js";
+import { addMeetingCommands } from "../meetings/cli/index.js";
+import { commandsCommand } from "./commands-command.js";
+import { LOCAL_READ, LOCAL_WRITE, NO_EFFECTS, REMOTE_WRITE } from "./effects.js";
+import { unfilteredQuery, withQuery } from "./list-query.js";
+import { doctorCommand } from "./messenger/doctor-command.js";
+import { mcpCommand } from "./messenger/mcp-command.js";
+import { searchCommand } from "./messenger/search-command.js";
+import { settingsFor } from "./settings.js";
+/** Construction-only defaults for a CLI that explicitly binds an independent source or transport. */
+export const sharedCommandTemplate = (app, name) => {
+    const unavailable = () => {
+        throw new CliError("configuration_error", "a command contract template cannot execute");
+    };
+    const messenger = {
+        app,
+        provider: app.command,
+        chatArgument: "a stored chat id or name",
+        topics: false,
+        history: "store",
+        resolveSettings: settingsFor(app).resolveSettings,
+        connect: async () => unavailable(),
+    };
+    const command = sharedCommand(() => {
+        if (name === "commands")
+            return commandsCommand(app);
+        if (name === "doctor")
+            return doctorCommand(messenger);
+        if (name === "mcp")
+            return mcpCommand(messenger);
+        if (name === "search")
+            return searchCommand(messenger);
+        if (name === "meetings") {
+            const root = new Command(app.command);
+            addMeetingCommands(root, {
+                get store() {
+                    return unavailable();
+                },
+                accountId: 0,
+                write: unavailable,
+            });
+            const meetings = root.commands.find((command) => command.name() === "meetings");
+            if (!meetings)
+                return unavailable();
+            return meetings;
+        }
+        if (name === "setup")
+            return annotate(new Command("setup"), { effects: REMOTE_WRITE, lifetime: "interactive", mcp: false })
+                .description("set up the account and connect an agent")
+                .option("--agent <agent>", "install instructions for this agent")
+                .option("--method <method>", "login method");
+        if (name === "session") {
+            const session = annotate(new Command("session"), { effects: NO_EFFECTS, mcp: false }).description("link this account, or end its login");
+            annotate(session.command("start"), { effects: REMOTE_WRITE, lifetime: "interactive" })
+                .description("link this account")
+                .argument("[method]", "login method");
+            annotate(session.command("end"), { effects: REMOTE_WRITE }).description("end this account's login");
+            return session;
+        }
+        const notes = annotate(new Command("notes"), { effects: NO_EFFECTS }).description("notes kept in the shared store");
+        withQuery(annotate(notes.command("list"), { effects: LOCAL_READ, output: { entity: "note" } }).description("list stored notes"), unfilteredQuery("note", note));
+        annotate(notes.command("show"), { effects: LOCAL_READ, output: { entity: "note" } })
+            .description("show one note")
+            .argument("<note>", "stored note reference");
+        annotate(notes.command("add"), { effects: LOCAL_WRITE, output: { entity: "note" } })
+            .description("write a note")
+            .argument("<text>", "note text")
+            .option("--subject <ref>", "stored resource the note describes");
+        annotate(notes.command("edit"), { effects: LOCAL_WRITE, output: { entity: "note" } })
+            .description("change a note")
+            .argument("<note>", "stored note reference")
+            .argument("<text>", "replacement text");
+        annotate(notes.command("remove"), { effects: LOCAL_WRITE })
+            .description("remove a note")
+            .argument("<note>", "stored note reference");
+        return notes;
+    })();
+    command.hook("preAction", unavailable);
+    return command;
+};

package/dist/cli/discovery-descriptions.d.ts

@@ -0,0 +1,4 @@
+export declare const DISCOVERY_DESCRIPTIONS: Readonly<{
+    commands: "every command by section; --json prints its contract, one path per call";
+    info: "one command contract, or all schemas, error reasons and explicit overrides";
+}>;

package/dist/cli/discovery-descriptions.js

@@ -0,0 +1,4 @@
+export const DISCOVERY_DESCRIPTIONS = Object.freeze({
+    commands: "every command by section; --json prints its contract, one path per call",
+    info: "one command contract, or all schemas, error reasons and explicit overrides",
+});

package/dist/cli/index.d.ts

@@ -37,108 +37,74 @@ export { openRequestTask } from "../services/task-rules.js";
 export { TASK_PAIR_QUERY, TASK_QUERY } from "../services/tasks.js";
 export { type AgentPolicy, type AgentTask, type EvaluationResult, evaluateAgent, type Observation, } from "./agent-evaluation.js";
 export { answerEntity } from "./answer-entity.js";
-export { botAdminsCommand, botMembersCommand } from "./bot/admins.js";
-export { type ApiCommandInput, type ApiCommands, generatedApiCommand } from "./bot/api.js";
+export type { ApiCommandInput, ApiCommands } from "./bot/api.js";
 export { apiFlagOf, apiJson, apiOptionKey, apiPlainJson, checkApiBody, checkApiParameter, parseApiJson, readApiBody, } from "./bot/api-input.js";
 export { prepareRpcApiBody, type RpcApiBody } from "./bot/api-rpc.js";
-export { botCommand } from "./bot/command.js";
 export { type BotContext, botContext, botWords } from "./bot/context.js";
 export { type BotCopy, botCopy } from "./bot/copy.js";
-export { botMcpCommand } from "./bot/mcp.js";
-export { botCan, botIdOf, botMessagesCommand } from "./bot/messages.js";
+export { botCan, botIdOf } from "./bot/messages.js";
 export { BOT_ACTIONS, type BotAction, type BotAdapter, type BotCallbacks, type BotChatAdmin, type BotChatAdmins, type BotChatMembers, type BotChatRef, type BotChatTools, type BotConnectOptions, type BotEvent, type BotHistory, type BotMcp, type BotMenu, type BotMenuEntry, type BotMessaging, type BotMessenger, type BotNativeApi, type BotNotice, type BotPeople, type BotPress, type BotSecret, type BotSendOptions, type BotUpdates, type BotUpdatesPage, type BotWebhook, type BotWebhookAnswer, type BotWebhookIntake, type BotWebhookRequest, type BotWebhooks, } from "./bot/port.js";
 export { botFiles, botsDirectory, ChatRegistry, registryProfiles, type SeenChat } from "./bot/registry.js";
 export { BotTokenStore, type BotTokenStoreOptions } from "./bot/token.js";
 export { PressLog, UpdatesCursor } from "./bot/updates.js";
 export type { CommandAvailability, DiscoveredCommand } from "./command-availability.js";
 export { commandContract, type JsonSchema, SCHEMA_DIALECT } from "./command-contract.js";
-export { CONTRACT, commandsCommand } from "./commands-command.js";
-export { configCommand, refuseUnknownKey } from "./config-command.js";
+export { CONTRACT } from "./commands-command.js";
+export { refuseUnknownKey } from "./config-command.js";
 export { loadSnakeCaseConfig } from "./config-keys.js";
 export { type AgentRun, type BaseContext, type BaseEnvironment, baseContext, environmentOf, outputFor, provide, secretInputOf, } from "./context.js";
+export { addContractInfo, type ContractEvidenceOptions, contractEvidence } from "./contract-evidence.js";
+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 { 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";
 export { askSetupQuestions, asksAtStart, type FirstRun, type FirstRunIo, LANGUAGES, setupAtStart, systemLanguage, } from "./first-run.js";
-export { checkGuide, checkStep, type GuideOptions, type GuideReference, type GuideStep, guideCommand, loadScenarios, MEMO_SCENARIOS, type Scenario, shellProblems, } from "./guide.js";
+export { checkGuide, checkStep, type GuideOptions, type GuideReference, type GuideStep, loadScenarios, MEMO_SCENARIOS, type Scenario, shellProblems, } from "./guide.js";
 export { type CommandHelp, commandHelp, commandHelpMarkdown, commandHelpText, exampleReport, type NextChoice, nextUsually, } from "./help/command-help.js";
 export { commandsText } from "./help/commands-text.js";
-export { type FirstScreen, type FirstScreenLine, firstScreen, installHelp, WIRECAT_TOOLS, } from "./help/first-screen.js";
+export { type FirstScreen, type FirstScreenLine, firstScreen, installHelp, WIRECAT_TOOLS } from "./help/first-screen.js";
 export { type HelpSection, inSection, SECTIONS } from "./help/sections.js";
 export { bufferedInput, type InputPolicy, inputPolicy, MAX_BUFFERED_INPUT, MAX_SECRET_INPUT, provideInputPolicy, } from "./input-policy.js";
 export { answerFields, checkJson, type EntityFields, entityFields, type JsonFieldsResolver, type JsonRequest, liftJson, } from "./json-fields.js";
 export { commandPath, LIST_QUERY_GUIDE, listQuery, nativeField, nativeTerms, pagedList, pageOf, type QueryWords, queryArgument, queryHelp, queryTerms, searchText, termField, timeBounds, typedQuery, unfilteredQuery, withQuery, } from "./list-query.js";
-export { addMeetingBatchCommand, formatMeetingBatch, prepareMeetingBatch } from "./meeting-batch.js";
+export { formatMeetingBatch, prepareMeetingBatch } from "./meeting-batch.js";
 export { meetingEvidenceItem, meetingPersonContextItem } from "./meeting-evidence-answer.js";
 export { parseEvidenceFindingsJson, parseMeetingFindingsJson } from "./meeting-findings-input.js";
 export { meetingPreparationAnswer } from "./meeting-preparation-answer.js";
-export { addMeetingPreparationCommand } from "./meeting-preparation-command.js";
 export { type MeetingPreparationReader, meetingPreparationInput, readMeetingPreparation, } from "./meeting-preparation-read.js";
-export { addMeetingProjectCandidatesCommand } from "./meeting-project-candidates-command.js";
 export { readMeetingProjectCandidates } from "./meeting-project-candidates-read.js";
 export { meetingResultItem } from "./meeting-results.js";
-export { addMeetingSeriesInventoryCommand } from "./meeting-series-inventory-command.js";
 export { type MeetingSeriesInventoryReader, readMeetingSeriesInventory } from "./meeting-series-inventory-read.js";
-export { accountCommand } from "./messenger/account-command.js";
 export { accountFileFor, profilesHere, rememberAccount } from "./messenger/accounts.js";
-export { storeCommand } from "./messenger/archive-commands.js";
-export { attachmentsCommand } from "./messenger/attachments-command.js";
-export { chatsCommand } from "./messenger/chats-command.js";
-export { markReadCommand } from "./messenger/chats-read-command.js";
-export { type CompletionOptions, completeCommand } from "./messenger/complete-command.js";
-export { contactsCommand } from "./messenger/contacts-command.js";
+export type { CompletionOptions } from "./messenger/complete-command.js";
 export { type ConnectOptions, connectFor, type Messenger, type MessengerContext, messengerContext, type ReadConnection, type StoredMessages, } from "./messenger/context.js";
-export { conversationsCommand } from "./messenger/conversations-command.js";
-export { doctorCommand } from "./messenger/doctor-command.js";
-export { floodCommand } from "./messenger/flood-command.js";
-export { recipientsCommand, sendsCommand } from "./messenger/guard-commands.js";
-export { imagesCommand } from "./messenger/images-command.js";
-export { inboxCommand } from "./messenger/inbox.js";
 export { COMMAND_NEEDS } from "./messenger/lacks.js";
-export { httpTokenFile, type McpEnvironment, mcpCommand, serverEntry } from "./messenger/mcp-command.js";
-export { mentionsCommand } from "./messenger/mentions-command.js";
+export { httpTokenFile, type McpEnvironment, serverEntry } from "./messenger/mcp-command.js";
 export { type MessageItem, messageItem, type ReadMessage } from "./messenger/message-items.js";
-export { messagesCommand, sendCommand } from "./messenger/messages-command.js";
-export { deleteCommand } from "./messenger/messages-delete-command.js";
-export { editCommand } from "./messenger/messages-edit-command.js";
-export { forwardCommand } from "./messenger/messages-forward-command.js";
-export { pinCommand, starCommands, unpinCommand } from "./messenger/messages-pin-command.js";
-export { metadataCommand } from "./messenger/metadata-command.js";
-export { modelsCommand } from "./messenger/models-command.js";
-export { pollsCommand } from "./messenger/polls-command.js";
 export { type ModeProblem, type PrivateFiles, privateFiles, withSqliteSidecars } from "./messenger/private-files.js";
-export { reactionsCommand } from "./messenger/reactions-command.js";
-export { callsCommand, stickersCommand } from "./messenger/records-command.js";
-export { repliesCommand } from "./messenger/replies-command.js";
 export { buildReport as buildDoctorReport, type Report as DoctorReport, type ReportContext as DoctorReportContext, reportFileName as doctorReportFileName, } from "./messenger/report.js";
-export { reviewCommand } from "./messenger/review.js";
-export { scheduleCommand } from "./messenger/schedule-command.js";
 export { allAnswer, allHitItem, type HitItem, type MessageHitItem, messageHitItem, type NoteHitItem, noteHitItem, } from "./messenger/search-answers.js";
-export { searchCommand } from "./messenger/search-command.js";
-export { SEARCHES_QUERY, searchesCommand } from "./messenger/searches-command.js";
-export { serveCommand, servingProfiles } from "./messenger/serve-command.js";
+export { SEARCHES_QUERY } from "./messenger/searches-command.js";
+export { servingProfiles } from "./messenger/serve-command.js";
 export { DAY_MS, FIRST_FETCH_MS, type MemberFetches, memberFetches } from "./messenger/serve-members.js";
 export { STEMS_EVERY_MS, STEMS_SLICE_MS, type StemFills, stemFills } from "./messenger/serve-stems.js";
-export { type Running, type ServerOptions, type ServerProcess, type ServerSystem, serverCommand, } from "./messenger/server-command.js";
-export { statsCommand } from "./messenger/stats-command.js";
+export type { Running, ServerOptions, ServerProcess, ServerSystem } from "./messenger/server-command.js";
 export { storeSummary } from "./messenger/store-maintenance-command.js";
 export { type Saving, stored } from "./messenger/stored.js";
-export { tagsCommand } from "./messenger/tags-command.js";
-export { tasksCommand, tasksStatsCommand } from "./messenger/tasks-command.js";
-export { topicsCommand } from "./messenger/topics-command.js";
-export { watchCommand } from "./messenger/watch-command.js";
+export { MODEL_CATALOGUE_QUERY, type ModelCatalogueOptions } from "./model-catalogue-command.js";
 export { window, withPaging } from "./paging.js";
-export { knownBeside, knownPermissionKeys, type PermissionKeyOf, unknownPermissionKeys, } from "./permission-keys.js";
-export { asFirstWord, commandWords, liftProfile, refuseCommandName, rootOf, usableProfileName, } from "./profile.js";
+export { knownBeside, knownPermissionKeys, type PermissionKeyOf, unknownPermissionKeys } from "./permission-keys.js";
+export { asFirstWord, commandWords, liftProfile, refuseCommandName, rootOf, usableProfileName } from "./profile.js";
 export { createProgram, type ProgramDefinition, type ProgramOptions, type RunOptions, run } from "./program.js";
 export { fieldsOf, projectFields } from "./result-fields.js";
-export { runsCommand } from "./runs/command.js";
 export { type Config, type Configuration, count, first, flag, fromFile, type GlobalFlags, NONE_NAMED, type ProfileKind, plain, type ResolveOptions, type Settings, type SettingsExtension, type SettingsExtensionContext, type Source, settingsFor, } from "./settings.js";
 export { type PermissionAnswer, readSetupAnswers, type SetupAnswers, setupPermissionCeiling } from "./setup-answers.js";
 export { AGENTS, type Agent, agentFor, screenFor } from "./setup-screen.js";
-export { skillCommand } from "./skill-command.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 { changeStoreSetting, isStoreSetting, STORE_SETTINGS, storeSettings } from "./store-settings.js";
-export { restartServers, type UpgradeContext, upgradeCommand } from "./upgrade-command.js";
+export { restartServers, type UpgradeContext } from "./upgrade-command.js";