@wirecat/cli-core 0.405.0 → 0.407.0

package/CHANGELOG.md

@@ -5,7 +5,42 @@ 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.
 
-## Unreleased
+## 0.407.0 — 24.10.2026
+
+### Added
+
+- The `contact` entity has optional `email` and `phones` (number and label), for a source that knows them, such as zm's Zoom contacts.
+
+- Command discovery projections preserve the CLI document and command identities while selecting fields inside its command tree.
+
+- Portable ingestion, export, association, transcription and embedding receipts have shared entities and `meetingResultItem` serializers. Public IDs are strings; stored numeric IDs remain internal.
+
+- Meeting batch results declare their correlated success/error schemas. `answerEntity` can name a separate typed projection payload, preserving batch field selection inside each answer without weakening its outer result contract.
+
+## 0.406.0 — 24.10.2026
+
+### Added
+
+- `StoredMessages.threadMessages` lets an adapter read a provider thread from the shared message store without
+  keeping another copy. `HistoryBatch.deletions` applies chat-scoped tombstones from synced snapshots without
+  replaying those deletions as live events. `Messenger.readsComments` allows comment reads independently of
+  comment sending; unset, it keeps the existing capability behavior.
+- Speech model installation can verify existing files before reusing them (`verifyExisting`), so repair uses the shared checksum and download path.
+- Provider adapters can declare a typed answer with `answerEntity`, shared by command schemas, help and JSON field validation without changing a shared entity.
+
+### Fixed
+
+- Finite meeting inventory, project scanning and upgrade commands are available to the shared MCP catalogue. Profile permissions still apply; upgrade retains its authority grant.
+
+### Changed — may break callers
+
+- **Only canonical option spellings are accepted.** The hidden flag aliases introduced in 0.399.0 are removed: use the analysis/embedding/consent provider flags, `--claim`, `--answer-model`, `--template-mode`, `--text-file`, `--disappear-after` and the `kind:` query term. Retired flags are refused before command work.
+
+- **Shared command paths use the vocabulary.** Contacts use `info`, `events` and `aliases remove`; chat invite links use `links remove`, member checks use `check`, and join requests use `confirm` or `reject`. Metadata uses `show` and `sync`; task edits use `update`; derived tags and search indexes use `rebuild`. Discovery uses `commands info`; MCP configuration uses `mcp add` and `mcp check`.
+
+- **Explicit model and conversation commands.** Use `models list kind:audio` or `kind:text`, `models download <model>` and `models keys set/remove`. Conversation link construction is `conversations links rebuild`; vector reports and removal are `conversations embeddings status/clear`, while `conversations embed` still computes vectors. Duplicate candidates are `tasks duplicates list`. Report information is `doctor reports show`; `doctor reports create` writes the report. Bare groups only offer help. Retired spellings are refused with guidance to the canonical path; no compatibility command aliases are mounted. CLI and MCP use the same paths.
+
+- **Rename moved permission paths.** A saved key or startup override using a renamed path now stops with `configuration_error` and its exact replacement (including bot keys), before opening the store or performing the action. Canonical commands keep the migrated denial; retired CLI spellings cannot run.
 
 ## 0.405.0 — 24.10.2026
 

package/dist/botcheck/reasons.d.ts

@@ -1,4 +1,4 @@
-/** What `chats members audit` judges from a member list and the store. */
+/** What `chats members check` judges from a member list and the store. */
 export type AuditReason = "bot" | "scam" | "fake" | "deleted" | "no_photo" | "no_username" | "odd_name" | "never_wrote" | "link_first" | "burst_join" | "mass_invited";
 /** What only a look at one person adds: their profile, all their stored messages, the registries. */
 export type PersonReason = "new_account" | "no_bio" | "same_text" | "photo_recent" | RegistryReason;

package/dist/cli/analysis-choice.js

@@ -35,6 +35,6 @@ export const analysisChoice = (options, app, settings, env, keyring) => {
     const keyName = customUrl === undefined ? provider : endpointKeyName(baseUrl);
     const apiKey = embeddingKeys(app, env, keyring).read(keyName)?.key;
     if (!apiKey && customUrl === undefined)
-        throw new CliError("authentication_error", `no ${provider} key — use models text key set ${provider}`);
+        throw new CliError("authentication_error", `no ${provider} key — use models keys set ${provider}`);
     return { provider, model, baseUrl, ...(apiKey ? { apiKey } : {}) };
 };

package/dist/cli/answer-entity.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from "commander";
+import type * as v from "valibot";
+/** Provider-specific wire fields must not redefine an entity shared by every CLI. */
+export declare const answerEntity: (command: Command, name: string, schema: v.GenericSchema, options?: {
+    project?: v.GenericSchema;
+}) => Command;
+export declare const answerEntitySchema: (command: Command | undefined) => v.GenericSchema | undefined;
+export declare const answerProjectionSchema: (command: Command | undefined) => v.GenericSchema | undefined;

package/dist/cli/answer-entity.js

@@ -0,0 +1,31 @@
+import { annotate, metaOf } from "@wirecat/cli-base/commands";
+import { ENTITIES } from "../entities/index.js";
+const schemas = new WeakMap();
+/** Provider-specific wire fields must not redefine an entity shared by every CLI. */
+export const answerEntity = (command, name, schema, options = {}) => {
+    if (Object.hasOwn(ENTITIES, name))
+        throw new Error(`${name} is a shared entity; use its existing schema`);
+    if (!/^[a-z][a-z0-9_]*$/.test(name))
+        throw new Error("an answer entity needs a lowercase name");
+    if (!("entries" in schema) && schema.type !== "union")
+        throw new Error("an answer entity needs an object schema or a union of object schemas");
+    if (options.project && !("entries" in options.project) && options.project.type !== "union")
+        throw new Error("projection needs an object schema or a union of object schemas");
+    schemas.set(command, { name, schema, ...options });
+    return annotate(command, { output: { entity: name } });
+};
+export const answerEntitySchema = (command) => {
+    const output = command && metaOf(command).output;
+    if (!output)
+        return undefined;
+    const name = output.view ? `${output.entity}.${output.view}` : output.entity;
+    const shared = ENTITIES[name];
+    if (shared)
+        return shared;
+    const own = schemas.get(command);
+    return own?.name === name ? own.schema : undefined;
+};
+export const answerProjectionSchema = (command) => {
+    const own = command && schemas.get(command);
+    return own && metaOf(command).output?.entity === own.name ? own.project : undefined;
+};

package/dist/cli/command-contract.js

@@ -1,8 +1,8 @@
 import { CliError } from "@wirecat/cli-base";
 import { describeOptions, metaOf } from "@wirecat/cli-base/commands";
 import { jsonSchemaOf } from "@wirecat/cli-base/standards";
-import { ENTITIES } from "../entities/index.js";
 import { keyForCommand } from "../sends/permissions.js";
+import { answerEntitySchema, answerProjectionSchema } from "./answer-entity.js";
 import { answerSchema } from "./envelope.js";
 export const SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
 /**
@@ -10,10 +10,7 @@ export const SCHEMA_DIALECT = "https://json-schema.org/draft/2020-12/schema";
  * A command that declares none answers the same envelopes with items of any shape; `--jsonl` streams the items.
  */
 export const outputOf = (command) => {
-    const output = metaOf(command).output;
-    const entity = output
-        ? ENTITIES[(output.view ? `${output.entity}.${output.view}` : output.entity)]
-        : undefined;
+    const entity = answerEntitySchema(command);
     const { $schema: _, ...schema } = jsonSchemaOf(answerSchema(entity));
     const { $schema: __, ...item } = (entity ? jsonSchemaOf(entity) : {});
     const coverage = entity ? "declared-entity" : "envelope-with-open-items";
@@ -100,7 +97,9 @@ export const commandContract = (command) => {
         outputSchemaCoverage: output.coverage,
         jsonlSchema: { $schema: SCHEMA_DIALECT, ...output.item },
         jsonlSchemaCoverage: output.coverage,
-        projection: "--json=<fields> may omit item/object members; present members retain their types and envelopes are preserved",
+        projection: answerProjectionSchema(command)
+            ? "--json=<fields> selects inside each nested answer; correlation and envelopes are preserved"
+            : "--json=<fields> may omit item/object members; present members retain their types and envelopes are preserved",
         validation: {
             syntax: "declared",
             semantic: "command-and-provider-validation",

package/dist/cli/commands-command.js

@@ -50,7 +50,10 @@ export const commandsCommand = (app) => {
             exit_codes: { ok: 0, [CRASH_CODE]: GENERIC_FAILURE, ...EXIT_CODES },
         });
     });
-    command.addCommand(annotate(new Command("schema"), { effects: NO_EFFECTS })
+    command.addCommand(annotate(new Command("info"), {
+        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")
         .action(function (path) {

package/dist/cli/effects.js

@@ -124,7 +124,7 @@ export const ownerOnlyOption = (flags, description) => annotateOption(new Option
 export const judgedEffects = (effects) => effects && { remote: effects.remote, local: "none" };
 /**
  * An unasked step is judged stricter than a retry: only a fetch's local write is incidental. A command that reads
- * nothing remotely and writes here (`server restart`, `store reindex`) is the whole point of the step, so it waits
+ * nothing remotely and writes here (`server restart`, `store rebuild`) is the whole point of the step, so it waits
  * to be asked (RISK-1211).
  */
 const judgedStepEffects = (effects) => effects?.remote === "none" ? effects : judgedEffects(effects);

package/dist/cli/embedding-choice.d.ts

@@ -10,7 +10,7 @@ export interface ModelOptions {
     dims?: number;
     concurrency?: number;
 }
-/** A local model id, or a remote model with its key from `models text key set`. */
+/** A local model id, or a remote model with its key from `models keys set`. */
 export declare const embeddingChoice: ({ model, provider, embeddingProvider, baseUrl, dims, concurrency }: ModelOptions, app: AppIdentity, settings: AISettings, env: NodeJS.ProcessEnv, { needKey, keyring }?: {
     needKey?: boolean;
     keyring?: KeyringStore | undefined;

package/dist/cli/embedding-choice.js

@@ -5,7 +5,7 @@ import { DEFAULT_TEXT_MODEL } from "../embeddings/models.js";
 import { isLocal, remoteModel } from "../embeddings/remote.js";
 import { readOnlyLockOf, readOnlyRefusal } from "../ports/app.js";
 import { typedCommand } from "../runs/scope.js";
-/** A local model id, or a remote model with its key from `models text key set`. */
+/** A local model id, or a remote model with its key from `models keys set`. */
 export const embeddingChoice = ({ model, provider, embeddingProvider, baseUrl, dims, concurrency }, app, settings, env, { needKey = true, keyring } = {}) => {
     if (embeddingProvider !== undefined && provider !== undefined)
         throw new CliError("validation_error", "give --embedding-provider or its legacy --provider spelling, not both");
@@ -34,7 +34,7 @@ export const embeddingChoice = ({ model, provider, embeddingProvider, baseUrl, d
     const keyName = baseUrl === undefined ? "openai" : endpointKeyName(baseUrl);
     const key = embeddingKeys(app, env, keyring).read(keyName)?.key;
     if (!key && needKey && baseUrl === undefined) {
-        throw new CliError("authentication_error", `no OpenAI key — \`${typedCommand(app.command, "models text key set openai")}\`, or OPENAI_API_KEY`);
+        throw new CliError("authentication_error", `no OpenAI key — \`${typedCommand(app.command, "models keys set openai")}\`, or OPENAI_API_KEY`);
     }
     return { remote, ...(key ? { apiKey: key } : {}), ...(concurrency ? { concurrency } : {}) };
 };

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

@@ -112,8 +112,8 @@ const returnsOf = (command) => {
     const noun = (output.view ? `${output.entity} ${output.view}` : output.entity).replaceAll("_", " ");
     const more = fields.length > 8 ? `, and ${fields.length - 8} more` : "";
     const root = rootOf(command);
-    const schema = commandAt(root, "commands schema")
-        ? `; every field: ${root.name()} commands schema ${commandPathOf(command).join(" ")}`
+    const schema = commandAt(root, "commands info")
+        ? `; every field: ${root.name()} commands info ${commandPathOf(command).join(" ")}`
         : "";
     return `${noun} — ${fields.slice(0, 8).join(", ")}${more}${schema}`;
 };

package/dist/cli/index.d.ts

@@ -1,5 +1,6 @@
 export { AI_ENTRIES, AI_SETTING_KEYS, type AISettings, resolveAISettings } from "../analysis/settings.js";
 export { parseDuration } from "../domain/duration.js";
+export { syncProgress } from "../entities/store-records.js";
 export { isCliFailure, isCommanderFailure } from "../errors/failures.js";
 export { type AppErrors, failureContext } from "../errors/reasons.js";
 export { botInstructions } from "../mcp/bot/instructions.js";
@@ -10,6 +11,7 @@ export { callMeetingProjectCandidatesTool, meetingProjectCandidatesTool } from "
 export { callMeetingSeriesInventoryTool, meetingSeriesInventoryTool } from "../mcp/meeting-series-inventory.js";
 export { registerLinkConversationsPrompt } from "../mcp/prompts.js";
 export { agentBody, agentJson, agentResult, UNTRUSTED, UNTRUSTED_INSTRUCTION } from "../mcp/text.js";
+export { MEETING_RESULT_ENTITIES } from "../meetings/index.js";
 export { type AppIdentity, envName, readOnlyLockOf, readOnlyRefusal } from "../ports/app.js";
 export type { AccountEditing, AccountHealth, AccountRecords, AccountSettings, AccountStanding, AccountTools, After, BotChats, ChannelComments, ChatDeletion, ChatFolders, ChatReading, ContactBook, Download, ForumControl, ForumState, GroupAdmin, GroupModeration, HistoryBatch, HistoryChatEvent, HistoryReaction, HistoryStar, HistoryVote, InviteLinks, JoinRequests, LiveUpdates, MessageButtons, MessageEditing, MessageMedia, MessagePermalinks, MessagePins, MessagePolls, MessageReactions, MessageSearch, MessageStars, MessengerAdapter, MessengerCore, NewPoll, OfficialStats, PassiveUpdates, PersonProfiles, ProfileChange, ProfilePhotos, PushedHistory, ReadState, RemoteFile, ScheduledMessages, SenderIdentities, SenderSearch, SendOptions, Sent, ServerQuery, ServerReads, ThreadAddressing, TopicEditing, TopicHistory, TopicReadState, Transcript, } from "../ports/messenger.js";
 export type { Fetching, MediaOption, MessengerTraits } from "../ports/traits.js";
@@ -33,6 +35,7 @@ export { unanswered } from "../services/questions.js";
 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 { apiFlagOf, apiJson, apiOptionKey, apiPlainJson, checkApiBody, checkApiParameter, parseApiJson, readApiBody, } from "./bot/api-input.js";
@@ -53,8 +56,8 @@ export { loadSnakeCaseConfig } from "./config-keys.js";
 export { type AgentRun, type BaseContext, type BaseEnvironment, baseContext, environmentOf, outputFor, provide, secretInputOf, } from "./context.js";
 export { type Closeable, withDeadline } from "./deadline.js";
 export { DEFAULT_CONFIG, ensureDefaultConfig } from "./default-config.js";
-export { changesAuthority, changesAuthorityAt, 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, itemAnswer, itemOf, jsonlRecords, judgedAnswer, type ListBody, type ListInput, listOf, metaNow, printItem, renderAnswer, sealed, snakeKeys, snakeKeysKeeping, } from "./envelope.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";
@@ -73,6 +76,7 @@ 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";

package/dist/cli/index.js

@@ -1,5 +1,6 @@
 export { AI_ENTRIES, AI_SETTING_KEYS, resolveAISettings } from "../analysis/settings.js";
 export { parseDuration } from "../domain/duration.js";
+export { syncProgress } from "../entities/store-records.js";
 export { isCliFailure, isCommanderFailure } from "../errors/failures.js";
 export { failureContext } from "../errors/reasons.js";
 export { botInstructions } from "../mcp/bot/instructions.js";
@@ -8,6 +9,7 @@ export { callMeetingProjectCandidatesTool, meetingProjectCandidatesTool } from "
 export { callMeetingSeriesInventoryTool, meetingSeriesInventoryTool } from "../mcp/meeting-series-inventory.js";
 export { registerLinkConversationsPrompt } from "../mcp/prompts.js";
 export { agentBody, agentJson, agentResult, UNTRUSTED, UNTRUSTED_INSTRUCTION } from "../mcp/text.js";
+export { MEETING_RESULT_ENTITIES } from "../meetings/index.js";
 export { envName, readOnlyLockOf, readOnlyRefusal } from "../ports/app.js";
 export { senderFacts } from "../replies/dry-run.js";
 export { replyRenderer } from "../replies/rendering.js";
@@ -28,6 +30,7 @@ export { unanswered } from "../services/questions.js";
 export { openRequestTask } from "../services/task-rules.js";
 export { TASK_PAIR_QUERY, TASK_QUERY } from "../services/tasks.js";
 export { evaluateAgent, } from "./agent-evaluation.js";
+export { answerEntity } from "./answer-entity.js";
 export { botAdminsCommand, botMembersCommand } from "./bot/admins.js";
 export { generatedApiCommand } from "./bot/api.js";
 export { apiFlagOf, apiJson, apiOptionKey, apiPlainJson, checkApiBody, checkApiParameter, parseApiJson, readApiBody, } from "./bot/api-input.js";
@@ -48,8 +51,8 @@ export { loadSnakeCaseConfig } from "./config-keys.js";
 export { baseContext, environmentOf, outputFor, provide, secretInputOf, } from "./context.js";
 export { withDeadline } from "./deadline.js";
 export { DEFAULT_CONFIG, ensureDefaultConfig } from "./default-config.js";
-export { changesAuthority, changesAuthorityAt, 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 { answerSchema, itemAnswer, itemOf, jsonlRecords, judgedAnswer, listOf, metaNow, printItem, renderAnswer, sealed, snakeKeys, snakeKeysKeeping, } from "./envelope.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 { answerSchema, isBody, itemAnswer, itemOf, jsonlRecords, judgedAnswer, listOf, metaNow, printItem, renderAnswer, sealed, snakeKeys, snakeKeysKeeping, } from "./envelope.js";
 export { withAbort } from "./execution.js";
 export { askSetupQuestions, asksAtStart, LANGUAGES, setupAtStart, systemLanguage, } from "./first-run.js";
 export { checkGuide, checkStep, guideCommand, loadScenarios, MEMO_SCENARIOS, shellProblems, } from "./guide.js";
@@ -68,6 +71,7 @@ export { addMeetingPreparationCommand } from "./meeting-preparation-command.js";
 export { 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 { readMeetingSeriesInventory } from "./meeting-series-inventory-read.js";
 export { accountCommand } from "./messenger/account-command.js";

package/dist/cli/json-fields.js

@@ -1,6 +1,7 @@
 import { CliError } from "@wirecat/cli-base";
 import { metaOf } from "@wirecat/cli-base/commands";
 import { ENTITIES } from "../entities/index.js";
+import { answerEntitySchema, answerProjectionSchema } from "./answer-entity.js";
 const declaredEntity = (command) => {
     const output = command ? metaOf(command).output : undefined;
     return output && (output.view ? `${output.entity}.${output.view}` : output.entity);
@@ -37,8 +38,7 @@ export const answerFields = (command, resolve) => {
     const own = resolve?.(command);
     if (own !== undefined)
         return [...own];
-    const name = declaredEntity(command);
-    const schema = name === undefined ? undefined : ENTITIES[name];
+    const schema = answerProjectionSchema(command) ?? answerEntitySchema(command);
     return schemaFields(schema);
 };
 const PATHS = /^[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)*(,[a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)*)*$/;

package/dist/cli/meeting-batch.d.ts

@@ -1,5 +1,5 @@
 import { type BatchReport } from "@wirecat/cli-base";
-import type { Meta } from "@wirecat/cli-base/standards";
+import { type Meta } from "@wirecat/cli-base/standards";
 import { Command } from "commander";
 import { type MeetingBatchReader, type MeetingPassageOutputFormat } from "../meetings/index.js";
 import { type Body } from "./envelope.js";

package/dist/cli/meeting-batch.js

@@ -1,11 +1,16 @@
 import { BATCH_LIMITS, CliError, prepareBatch, runBatch, } from "@wirecat/cli-base";
 import { annotate } from "@wirecat/cli-base/commands";
+import { errorObjectSchema } from "@wirecat/cli-base/standards";
 import { Command, Option } from "commander";
+import * as v from "valibot";
+import { ENTITIES } from "../entities/index.js";
 import { failureContext } from "../errors/reasons.js";
 import { createMeetingPassageCommand, createMeetingSearchCommand, meetingHitSearchRequest, meetingPassageRequest, meetingSearchArguments, meetingSearchMeta, } from "../meetings/cli/index.js";
 import { meetingHitsList, parseMeetingReference, } from "../meetings/index.js";
 import { formatMeetingEvidenceText, formatMeetingPassage } from "../services/meeting-passage-format.js";
-import { itemOf, listOf } from "./envelope.js";
+import { answerEntity } from "./answer-entity.js";
+import { destroysNothing } from "./effects.js";
+import { answerSchema, itemOf, listOf } from "./envelope.js";
 const INDEX_BYTES = 4194304;
 const parse = (command, args) => {
     command
@@ -162,10 +167,23 @@ export const addMeetingBatchCommand = (program, deps) => {
             },
         }), report, format);
     });
-    return annotate(command, {
+    destroysNothing(command);
+    annotate(command, {
         origin: "handwritten",
         partial: true,
         effects: { remote: "none", local: "write" },
         examples: [`${program.name()} batch requests.json --json`],
     });
+    return answerEntity(command, "meeting_batch_result", batchResult, { project: batchPayload });
 };
+const batchPayload = v.union([ENTITIES.meeting_hit, ENTITIES.meeting_passage]);
+const correlated = { id: v.string(), command: v.array(v.string()) };
+const batchResult = v.union([
+    v.strictObject({ ...correlated, status: v.literal("ok"), answer: answerSchema(batchPayload), complete: v.boolean() }),
+    v.strictObject({
+        ...correlated,
+        status: v.picklist(["error", "not_run"]),
+        error: errorObjectSchema.entries.error,
+        complete: v.literal(false),
+    }),
+]);

package/dist/cli/meeting-project-candidates-command.js

@@ -31,7 +31,6 @@ export const addMeetingProjectCandidatesCommand = (program, deps) => {
         cursor: options.cursor,
     }, deps.signal()))), {
         origin: "handwritten",
-        mcp: false,
         effects: LOCAL_READ,
         output: { entity: "meeting_project_candidates" },
         examples: [`${program.name()} meetings projects scan meeting:1/2 --json`],

package/dist/cli/meeting-results.d.ts

@@ -0,0 +1,3 @@
+import { MEETING_RESULT_ENTITIES } from "../meetings/index.js";
+/** Store IDs stay numeric below the CLI; public receipts use the shared string IDs and validated wire fields. */
+export declare const meetingResultItem: (entity: keyof typeof MEETING_RESULT_ENTITIES, value: unknown) => unknown;

package/dist/cli/meeting-results.js

@@ -0,0 +1,31 @@
+import { CliError } from "@wirecat/cli-base";
+import * as v from "valibot";
+import { MEETING_RESULT_ENTITIES } from "../meetings/index.js";
+import { snakeKeys } from "./envelope.js";
+const ids = new Set([
+    "meeting_id",
+    "account_id",
+    "participant_id",
+    "event_id",
+    "previous_event_id",
+    "expected_event_id",
+    "next_transcript_id",
+]);
+const publicValue = (value, key = "") => {
+    if (typeof value === "number" && ids.has(key))
+        return String(value);
+    if (Array.isArray(value))
+        return value.map((item) => publicValue(item, key === "target_account_ids" ? "account_id" : ""));
+    if (value && typeof value === "object")
+        return Object.fromEntries(Object.entries(value).map(([name, item]) => [name, publicValue(item, name)]));
+    return value;
+};
+/** Store IDs stay numeric below the CLI; public receipts use the shared string IDs and validated wire fields. */
+export const meetingResultItem = (entity, value) => {
+    const parsed = v.safeParse(MEETING_RESULT_ENTITIES[entity], publicValue(snakeKeys(value)));
+    if (!parsed.success) {
+        const applied = value && typeof value === "object" && "applied" in value && value.applied === true;
+        throw new CliError(applied ? "outcome_unknown" : "invalid_response", `the command returned an invalid ${entity} answer`);
+    }
+    return parsed.output;
+};

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

@@ -31,7 +31,6 @@ export const addMeetingSeriesInventoryCommand = (program, deps) => {
         origin: "handwritten",
         effects: REMOTE_READ,
         offline: false,
-        mcp: false,
         output: { entity: "meeting_series_inventory" },
         examples: [`${program.name()} meetings scheduled --json`],
     });

package/dist/cli/messenger/admin-commands.js

@@ -69,14 +69,8 @@ const updateCommand = (messenger) => {
         update.option("--remove-photo", "take its photo away; not with --photo");
     for (const key of keys) {
         const option = new Option(`--${SETTING_FLAGS[key][0]}`, SETTING_FLAGS[key][1]);
-        if (key === "disappearingSeconds")
-            option.conflicts("disappearTime");
         update.addOption(option);
     }
-    if (keys.includes("disappearingSeconds"))
-        update.addOption(new Option("--disappear-time <duration|off>", "compatibility alias for --disappear-after")
-            .hideHelp()
-            .conflicts("disappearAfter"));
     return update.action(async function (chat) {
         const context = messengerContext(this, messenger);
         const { title, description, photo, removePhoto, ...rest } = this.opts();
@@ -92,7 +86,7 @@ const updateCommand = (messenger) => {
     });
 };
 const linkCommand = (messenger) => {
-    const link = new Command("link").description("a group's invite link");
+    const link = new Command("links").description("a group's invite link");
     annotate(link.command("show"), { output: { entity: "chat_invite" }, effects: REMOTE_READ })
         .description("the invite link, if you may see it")
         .argument("<chat>", messenger.chatArgument)
@@ -132,10 +126,13 @@ const linkCommand = (messenger) => {
             ].join("  ")));
         }));
     if (messenger.inviteLinkRevoke !== false)
-        link.addCommand(annotate(new Command("revoke"), { output: { entity: "chat_invite_change" }, effects: REMOTE_WRITE })
+        link.addCommand(annotate(new Command("remove"), {
+            output: { entity: "chat_invite_change" },
+            effects: REMOTE_WRITE,
+        })
             .description("stop one link; for the group's own link, the answer is the new one")
             .argument("<chat>", messenger.chatArgument)
-            .argument("<link>", "the link, as `chats link list` shows it")
+            .argument("<link>", "the link, as `chats links list` shows it")
             .action(async function (chat, link) {
             const context = messengerContext(this, messenger);
             renderItem(this, context, await context.withServices((services) => services.admin.revokeLink(chat, link)));
@@ -144,7 +141,7 @@ const linkCommand = (messenger) => {
         link.addCommand(annotate(new Command("update"), { output: { entity: "chat_invite_change" }, effects: REMOTE_WRITE })
             .description("change one of your invite links, the group's own one too")
             .argument("<chat>", messenger.chatArgument)
-            .argument("<link>", "the link, as `chats link list` shows it")
+            .argument("<link>", "the link, as `chats links list` shows it")
             .option("--approval", "who joins by it asks first, and an admin lets them in; it then has no use limit")
             .option("--no-approval", "anyone with it joins at once")
             .option("--expire-time <time>", "it stops working then: 2026-09-25T09:00 (local time), or 30m, 2h, 7d from now; `never` takes the expiry away")
@@ -219,11 +216,14 @@ const requestsCommand = (messenger) => {
     }));
     const everyone = messenger.joinRequestsAll !== false;
     const byLink = everyone && messenger.joinRequestsByLink !== false;
-    for (const [verb, accept, help] of [
-        ["accept", true, "let them in; the group sees them join"],
-        ["decline", false, "turn the request away"],
+    for (const [accept, help] of [
+        [true, "let them in; the group sees them join"],
+        [false, "turn the request away"],
     ]) {
-        const answer = annotate(new Command(verb), { output: { entity: "chat_request_change" }, effects: REMOTE_WRITE })
+        const answer = annotate(new Command(accept ? "confirm" : "reject"), {
+            output: { entity: "chat_request_change" },
+            effects: REMOTE_WRITE,
+        })
             .description(help)
             .argument("<chat>", messenger.chatArgument)
             .argument(everyone ? "[person]" : "<person>", "who asked: an id from `chats requests list`");

package/dist/cli/messenger/archive-commands.js

@@ -38,7 +38,7 @@ export const storeCommand = (messenger) => {
         "copies delete": "messages_copy_1",
         decrypt: "./backup.enc --output ./restored.db",
         export: '"Book club" --output ./messages.jsonl',
-        "gaps plan": '"Book club"',
+        "gaps show": '"Book club"',
         "gaps repair": '"Book club" --limit 100',
         info: "",
         "jobs cancel": "job-101",
@@ -47,7 +47,7 @@ export const storeCommand = (messenger) => {
         "jobs retry": "--failed",
         "jobs show": "",
         migrate: "",
-        reindex: "",
+        rebuild: "",
         repair: "--dry-run",
         reset: "",
         restore: "./backup.db",

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

@@ -27,7 +27,7 @@ const count = (value) => {
 const line = ({ status, ref, attachment, name, chars }) => `${status}  ${ref} #${attachment}${name ? `  ${name}` : ""}${chars === undefined ? "" : `  (${chars} characters)`}`;
 const summary = (run) => [
     `${run.extracted} extracted`,
-    run.needsAgent ? `${run.needsAgent} for an agent to read (attachments text set)` : "",
+    run.needsAgent ? `${run.needsAgent} for an agent to read (attachments update)` : "",
     run.failed ? `${run.failed} unreadable` : "",
     run.unchanged ? `${run.unchanged} unchanged` : "",
     run.notDownloaded ? `${run.notDownloaded} not downloaded (--download)` : "",
@@ -172,12 +172,11 @@ const showCommand = (messenger) => annotate(new Command("show"), {
         stop.release();
     }
 });
-const textCommand = (messenger) => {
-    const text = new Command("text").description("the text of one file, as an agent read it");
-    readsStdin(annotate(text.command("set"), {
+const textUpdateCommand = (messenger) => {
+    const update = readsStdin(annotate(new Command("update"), {
         output: { entity: "attachment_text_change" },
         effects: LOCAL_WRITE,
-        examples: [`${messenger.app.command} personal attachments text set "Book club" 101 --text-file ./transcript.txt`],
+        examples: [`${messenger.app.command} personal attachments update "Book club" 101 --text-file ./transcript.txt`],
     }), {
         name: "text",
         description: "the text of the file",
@@ -190,7 +189,7 @@ const textCommand = (messenger) => {
         .addOption(ownerOnlyOption("--text-file <path>", "read the text from this file; - or none reads stdin"))
         .action(async function (chat, message) {
         const context = messengerContext(this, messenger);
-        refuseLocalWrite(context, messenger.app.command, "attachments.text.set");
+        refuseLocalWrite(context, messenger.app.command, "attachments.update");
         const { attachment, textFile } = this.opts();
         const given = textFile === undefined || textFile === "-" ? await readAll(context.stdin) : readFileSync(textFile, "utf8");
         const done = await context.withServices((services) => services.attachments.setText({
@@ -201,7 +200,7 @@ const textCommand = (messenger) => {
         }));
         renderAnswer(this, context, itemOf(snakeKeys(done)), () => `${done.ref} #${done.attachment}  ${done.chars} characters kept\n`);
     });
-    return text;
+    return update;
 };
 /** Files of stored messages: what is in them, for `content:` in a search. Nothing here is sent. */
 export const attachmentsCommand = (messenger) => {
@@ -211,7 +210,7 @@ export const attachmentsCommand = (messenger) => {
         .addCommand(extractCommand(messenger))
         .addCommand(listCommand(messenger))
         .addCommand(showCommand(messenger))
-        .addCommand(textCommand(messenger));
+        .addCommand(textUpdateCommand(messenger));
     addMediaArchiveCommands(attachments, messenger);
     return attachments;
 };

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

@@ -107,7 +107,7 @@ export const syncCommand = (messenger) => {
         if (prepare) {
             validateCatchUpBounds(preparation);
             refuseLocalWrite(context, messenger.app.command, "conversations.links");
-            refuseLocalWrite(context, messenger.app.command, "conversations.embed");
+            refuseLocalWrite(context, messenger.app.command, "conversations.embeddings");
         }
         if (background) {
             const named = chat ?? ALL_CHATS;

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

@@ -182,19 +182,19 @@ export const chatShown = (account, card) => {
 };
 /** The lowest score `score>=n` asks for; the audit's own floor when the query names none. */
 export const scoreFloor = (ast) => {
-    const term = nativeTerms(ast, "chats members audit").get("score");
+    const term = nativeTerms(ast, "chats members check").get("score");
     if (!term)
         return AUDIT_MIN_SCORE;
     const upper = term.operator === "range" ? (term.upper ?? "*") : term.value;
     if (term.operator !== "range" || upper !== "*")
         queryError("query.unsupported-operator", term.span, "score takes a lower bound: score>=3", {
-            command: "chats members audit",
+            command: "chats members check",
             guide: LIST_QUERY_GUIDE,
         });
     const floor = Number(term.value);
     return Math.ceil(term.lower_inclusive === false ? floor + 1 : floor);
 };
-export const auditAnswer = (audit) => wholeList("chats members audit", audit.items.map(memberAnswer), {
+export const auditAnswer = (audit) => wholeList("chats members check", audit.items.map(memberAnswer), {
     ...(audit.more ? { meta: { truncated: true } } : {}),
     ...(audit.completeness && audit.completeness.state !== "complete"
         ? {

package/dist/cli/messenger/chat-lists.js

@@ -45,16 +45,16 @@ export const membersHistory = async (services, chat, query) => {
     });
 };
 export const membersAudit = async (services, chat, query, options) => {
-    const minScore = scoreFloor(listQuery(typedQuery(query), AUDIT_QUERY, "chats members audit"));
+    const minScore = scoreFloor(listQuery(typedQuery(query), AUDIT_QUERY, "chats members check"));
     const audit = await services.chats.audit(chat, { ...options, minScore });
     return { audit, body: auditAnswer(audit) };
 };
 /** The source takes a count but no offset, so page n reads n pages and shows the last. */
 export const inviteLinks = async (services, chat, query, { limit, page }) => {
-    const terms = nativeTerms(listQuery(typedQuery(query), LINKS_QUERY, "chats link list"), "chats link list");
+    const terms = nativeTerms(listQuery(typedQuery(query), LINKS_QUERY, "chats links list"), "chats links list");
     const revoked = terms.get("revoked")?.value.toLowerCase() === "true";
     const found = await services.admin.links(chat, { limit: limit * page, revoked });
-    return listOf("chats link list", {
+    return listOf("chats links list", {
         items: found.items.slice((page - 1) * limit).map(inviteLinkAnswer),
         limit,
         has_more: found.hasMore,