@wirecat/cli-core 0.394.0 → 0.396.0

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

@@ -181,21 +181,24 @@ export const serverCommand = (messenger, options = {}) => {
         return ["--idle", idle];
     };
     const withIdle = (sub) => options.idle ? sub.option("--idle <duration>", "stop after this long with nobody using it — 15m, 1h") : sub;
-    withIdle(destroysNothing(annotate(command.command("start"), { effects: LOCAL_WRITE })).description("start serve in the background — through the unit if one is installed — and answer once it connects")).action(async function () {
+    withIdle(destroysNothing(annotate(command.command("start"), { effects: LOCAL_WRITE, examples: [`${app.command} personal server start`] })).description("start serve in the background — through the unit if one is installed — and answer once it connects")).action(async function () {
         await start(prepare(this), idleArgs(this));
     });
-    destroysNothing(annotate(command.command("stop"), { effects: LOCAL_WRITE }))
+    destroysNothing(annotate(command.command("stop"), { effects: LOCAL_WRITE, examples: [`${app.command} personal server stop`] }))
         .description("stop this profile's serve — through the unit if it runs under one")
         .action(async function () {
         await stop(prepare(this));
     });
-    withIdle(destroysNothing(annotate(command.command("restart"), { effects: LOCAL_WRITE })).description("stop it and start it again")).action(async function () {
+    withIdle(destroysNothing(annotate(command.command("restart"), {
+        effects: LOCAL_WRITE,
+        examples: [`${app.command} personal server restart`],
+    })).description("stop it and start it again")).action(async function () {
         const args = idleArgs(this);
         const prepared = prepare(this);
         await stop({ ...prepared, say: () => { } });
         await start(prepared, args);
     });
-    annotate(command.command("status"), { effects: LOCAL_READ })
+    annotate(command.command("status"), { effects: LOCAL_READ, examples: [`${app.command} personal server status`] })
         .description("whether serve runs for this profile, since when, who started it, and the unit if there is one")
         .action(async function () {
         const prepared = prepare(this);
@@ -261,7 +264,10 @@ export const serverCommand = (messenger, options = {}) => {
             ...flood.deadlines.map((one) => `Asked to wait before ${one.operation}${one.chatId ? ` in chat ${one.chatId}` : ""} until ${clock(one.until)}.`),
         ], outdated ? [nextStep("server.restart", { args: {} })] : []);
     });
-    annotate(command.command("logs"), { effects: LOCAL_READ })
+    annotate(command.command("logs"), {
+        effects: LOCAL_READ,
+        examples: [`${app.command} personal server logs --limit 20`],
+    })
         .description("serve's latest log lines — from the journal under systemd, else its log file")
         .option("-n, --limit <n>", "how many lines", (value) => wholeNumber(value), 50)
         .action(async function () {
@@ -272,7 +278,10 @@ export const serverCommand = (messenger, options = {}) => {
             context.renderer.note(`no log yet for profile ${unit.profile}`);
         renderAnswer(this, context, wholeList("server logs", text.split("\n").filter(Boolean)), () => text ? readableLog(text.replace(/\n$/, "")) : "");
     });
-    grantsAuthority(annotate(command.command("install"), { effects: LOCAL_WRITE }))
+    grantsAuthority(annotate(command.command("install"), {
+        effects: LOCAL_WRITE,
+        examples: [`${app.command} personal server install`],
+    }))
         .description("write a systemd user unit or a launchd agent for this profile; starts nothing")
         .action(function () {
         const { context, platform, unit, say } = prepare(this);
@@ -287,7 +296,10 @@ export const serverCommand = (messenger, options = {}) => {
             `A daily follow-up review is off. To turn it on: ${app.command} ${unit.profile} schedule agent follow-ups claude "${followUpsPrompt(app.command)}" --at 08:30`,
         ]);
     });
-    grantsAuthority(annotate(command.command("uninstall"), { effects: LOCAL_WRITE }))
+    grantsAuthority(annotate(command.command("uninstall"), {
+        effects: LOCAL_WRITE,
+        examples: [`${app.command} personal server uninstall`],
+    }))
         .description("remove this profile's unit; stop it first")
         .action(async function () {
         const { context, platform, unit, say } = prepare(this);

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

@@ -2,9 +2,9 @@ import { Command } from "commander";
 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/tasks-command.js

@@ -130,7 +130,10 @@ export const tasksCommand = (messenger) => {
         ? "agent"
         : "owner";
     const tasks = new Command("tasks").description("what waits on you — unanswered questions, mentions, requests, promises — kept in the local store; review and serve add them");
-    withQuery(annotate(tasks.command("list"), { effects: LOCAL_READ }).description("tasks, oldest first, with their message or note source"), TASK_QUERY)
+    withQuery(annotate(tasks.command("list"), {
+        effects: LOCAL_READ,
+        examples: [`${tool} personal tasks list --limit 10`],
+    }).description("tasks, oldest first, with their message or note source"), TASK_QUERY)
         .option("--limit <n>", "how many", positiveCount("--limit"))
         .action(async function (words) {
         const context = messengerContext(this, messenger);
@@ -146,7 +149,10 @@ export const tasksCommand = (messenger) => {
         if (found.items.length === 0 && context.format === "pretty")
             context.renderer.note("no tasks — review, inbox and messages sync add them as questions arrive");
     });
-    planOptions(destroysNothing(annotate(tasks.command("add"), { effects: LOCAL_WRITE }))
+    planOptions(destroysNothing(annotate(tasks.command("add"), {
+        effects: LOCAL_WRITE,
+        examples: [`${tool} personal tasks add note:101 --type promise --category documents --title "Review draft"`],
+    }))
         .description("add a task for a stored message or note — a promise, a request")
         .argument("<message>", "a message locator, msg:<provider>/<account>/<chat>/<message>, or note:<id>")
         .requiredOption("--type <type>", "the task's type: question, request, mention or promise", taskTypeOf)
@@ -176,7 +182,10 @@ export const tasksCommand = (messenger) => {
         else if (followUpOf && context.format === "pretty")
             context.renderer.note(`${task.key ?? task.id} follows up ${followUpOf.key} (${followUpOf.status}), which stays closed: linked follow-up-of`);
     });
-    planOptions(destroysNothing(annotate(tasks.command("plan"), { effects: LOCAL_WRITE }))
+    planOptions(destroysNothing(annotate(tasks.command("plan"), {
+        effects: LOCAL_WRITE,
+        examples: [`${tool} personal tasks plan DOC-12 --title "Review draft"`],
+    }))
         .summary("set a task's title, description, due date, next check, category and assignee")
         .description("set a task's title, description, due date, next check, category and assignee; nothing reaches the messenger")
         .argument("<task>", "the task's id or key, as tasks list shows it")
@@ -189,7 +198,10 @@ export const tasksCommand = (messenger) => {
         const planned = await context.withServices((services) => services.tasks.plan(id, plan, writerOf(this)));
         renderAnswer(this, context, itemOf(snakeKeys(planned)), () => `${card(planned)}\n`);
     });
-    destroysNothing(annotate(tasks.command("link"), { effects: LOCAL_WRITE }))
+    destroysNothing(annotate(tasks.command("link"), {
+        effects: LOCAL_WRITE,
+        examples: [`${tool} personal tasks link DOC-12 https://example.com/draft`],
+    }))
         .description("link a task to messages, chats, people or URLs — or to another task: task:<id>")
         .argument("<task>", "the task's id or key, as tasks list shows it")
         .argument("[targets...]", "msg: locators, person:<id>, document:<id>, note:<id>, a URL; or task:<id>, which links two project tasks")
@@ -209,7 +221,7 @@ export const tasksCommand = (messenger) => {
         if (!("relations" in linked) && linked.review && context.format === "pretty")
             context.renderer.note(`${linked.review} possible duplicate pair(s) went to tasks duplicates`);
     });
-    annotate(tasks.command("show"), { effects: LOCAL_READ })
+    annotate(tasks.command("show"), { effects: LOCAL_READ, examples: [`${tool} personal tasks show DOC-12`] })
         .description("one task: its plan and everything linked to it")
         .argument("<task>", "the task's id or key, as tasks list shows it")
         .action(async function (id) {
@@ -307,7 +319,7 @@ export const tasksCommand = (messenger) => {
         const unmerged = await context.withServices((services) => services.tasks.unmerge(dup, writerOf(this)));
         renderAnswer(this, context, itemOf(snakeKeys(unmerged)), () => `${card(unmerged.task)}\n`);
     });
-    withQuery(annotate(tasks.command("agenda"), { effects: LOCAL_READ })
+    withQuery(annotate(tasks.command("agenda"), { effects: LOCAL_READ, examples: [`${tool} personal tasks agenda`] })
         .summary("what needs a look today: tasks due, chats you owe or wait on, what you are owed")
         .description("what needs a look today, from the local store and without message text: tasks overdue, due or to check, " +
         "chats where you owe an answer, chats where you wait for one, open tasks someone else does"), AGENDA_QUERY)

package/dist/cli/program.js

@@ -20,6 +20,7 @@ import { changesAuthorityNow, isLogin, isStoreChange, judgedEffects, judgedTarge
 import { itemOf, renderAnswer, snakeKeys } from "./envelope.js";
 import { byteCount, DEFAULT_COMMAND_MS, DEFAULT_OUTPUT_BYTES, execution } from "./execution.js";
 import { installHelp } from "./help/first-screen.js";
+import { showInputFields } from "./input-fields.js";
 import { MAX_BUFFERED_INPUT, provideInputPolicy } from "./input-policy.js";
 import { checkJson, liftJson } from "./json-fields.js";
 import { movedPath, movedPointer } from "./moved.js";
@@ -354,7 +355,7 @@ const runOnce = async (argv, definition, options) => {
         // Only before `--`: what follows is a positional, an agent's text among them, never a command word.
         const end = lifted.indexOf("--");
         for (const words of [flags, end < 0 ? lifted : lifted.slice(0, end)])
-            refuseJoinedPath(program, words.filter((word) => !word.startsWith("-")));
+            refuseJoinedPath(program, words.filter((word) => !word.startsWith("-")), profile !== undefined && !/\s/.test(profile) ? [profile] : []);
     }
     catch (failure) {
         const settled = await settleFailure(failure, { definition, program, rest: lifted, profile, options });
@@ -420,7 +421,8 @@ const runOnce = async (argv, definition, options) => {
                 error.code === "commander.unknownCommand" &&
                 rest[0] !== undefined &&
                 !commandWords(program).has(rest[0])) {
-                message += ` "${profile}" is not a command, so it was read as a profile name — which left "${rest[0]}" to be one.`;
+                message = message.trimEnd();
+                message += ` — "${profile}" is not a command, so it was read as a profile name — which left "${rest[0]}" to be one.`;
             }
             const failure = new CliError("validation_error", message);
             const settled = await settleFailure(failure, { definition, program, rest, profile, options });
@@ -577,6 +579,7 @@ const failed = ({ app }, program, rest, error, settled, debug) => {
         targets: judgedTargets(program),
         ...(effects ? { effects } : {}),
     });
+    showInputFields(object, (path && commandAt(program, path)) || program);
     const command = path || app.command;
     return {
         object,

package/dist/cli/runs/command.js

@@ -18,7 +18,11 @@ export const runsCommand = (app) => {
             throw new CliError("not_found", `no recorded run "${id}" — \`${lineOf(from, "runs list")}\` shows them`);
         return found;
     };
-    annotate(command.command("list"), { effects: LOCAL_READ, mcp: false })
+    annotate(command.command("list"), {
+        effects: LOCAL_READ,
+        mcp: false,
+        examples: [`${app.command} runs list --limit 10`],
+    })
         .description("recorded runs, newest first")
         .option("--limit <n>", "how many to show", positiveCount("--limit"), 20)
         .option("--page <n>", "which page, starting at 1", positiveCount("--page"), 1)
@@ -32,7 +36,7 @@ export const runsCommand = (app) => {
         if (runs.length === 0)
             renderer.note("nothing recorded — a run is kept with `--record`, or when it fails");
     });
-    annotate(command.command("show"), { effects: LOCAL_READ, mcp: false })
+    annotate(command.command("show"), { effects: LOCAL_READ, mcp: false, examples: [`${app.command} runs show run-101`] })
         .argument("<run-id>", `an id from \`${app.command} runs list\``)
         .description("one run: what it was, how it ended, and every event it logged")
         .option("--problems", "only failed responses, warnings and crashes")
@@ -53,7 +57,10 @@ export const runsCommand = (app) => {
         if (shown.length < events.length)
             renderer.note(`${events.length - shown.length} other events — \`${lineOf(this, `runs show ${id}`)}\` shows them all`);
     });
-    annotate(command.command("search"), { effects: LOCAL_READ })
+    annotate(command.command("search"), {
+        effects: LOCAL_READ,
+        examples: [`${app.command} runs search timeout --limit 10`],
+    })
         .description("search recorded diagnostic metadata and events; no message contents")
         .argument("[query]", "case-insensitive literal diagnostic text")
         .addOption(new Option("--status <status>", "run outcome").choices(["success", "failed", "partial", "running"]))
@@ -79,7 +86,7 @@ export const runsCommand = (app) => {
             since_time: options.sinceTime,
         }));
     });
-    annotate(command.command("path"), { effects: NO_EFFECTS, mcp: false })
+    annotate(command.command("path"), { effects: NO_EFFECTS, mcp: false, examples: [`${app.command} runs path run-101`] })
         .argument("<run-id>", `an id from \`${app.command} runs list\``)
         .description("the directory holding one run")
         .action(function (id) {

package/dist/cli/skill-command.js

@@ -13,8 +13,13 @@ export const skillCommand = (app, skill) => {
     }, SHARED_SKILLS);
     // An installed skill is instructions every later agent follows.
     const install = command.commands.find((sub) => sub.name() === "install");
-    if (install)
+    if (install) {
         grantsAuthority(install);
+        annotate(install, { examples: [`${app.command} skill install --for agents`] });
+    }
+    const show = command.commands.find((sub) => sub.name() === "show");
+    if (show)
+        annotate(show, { examples: [`${app.command} skill show`, `${app.command} skill show follow-ups`] });
     return annotate(command, { mcp: false });
 };
 /** Skills this package ships for every CLI on it, printed by `skill show <name>`: `skills/` beside `dist/` and `src/`. */

package/dist/entities/evidence.d.ts

@@ -21,6 +21,11 @@ export declare const contribution: v.StrictObjectSchema<{
         readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
         readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+        readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly from: v.StringSchema<undefined>;
+            readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
         readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
         readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
             readonly coverage: v.NumberSchema<undefined>;
@@ -202,6 +207,11 @@ export declare const contribution: v.StrictObjectSchema<{
             readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
             readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+            readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                readonly from: v.StringSchema<undefined>;
+                readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
             readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
             readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly coverage: v.NumberSchema<undefined>;
@@ -421,6 +431,11 @@ export declare const contribution: v.StrictObjectSchema<{
         readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
         readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+        readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly from: v.StringSchema<undefined>;
+            readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
         readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
         readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
             readonly coverage: v.NumberSchema<undefined>;
@@ -602,6 +617,11 @@ export declare const contribution: v.StrictObjectSchema<{
             readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
             readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+            readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                readonly from: v.StringSchema<undefined>;
+                readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
             readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
             readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly coverage: v.NumberSchema<undefined>;
@@ -857,6 +877,11 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
         readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
         readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+        readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly from: v.StringSchema<undefined>;
+            readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
         readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
         readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
             readonly coverage: v.NumberSchema<undefined>;
@@ -1038,6 +1063,11 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
             readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
             readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+            readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                readonly from: v.StringSchema<undefined>;
+                readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
             readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
             readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly coverage: v.NumberSchema<undefined>;
@@ -1257,6 +1287,11 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
         readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
         readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+        readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly from: v.StringSchema<undefined>;
+            readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
         readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
         readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
             readonly coverage: v.NumberSchema<undefined>;
@@ -1438,6 +1473,11 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
             readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
             readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+            readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                readonly from: v.StringSchema<undefined>;
+                readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
             readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
             readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly coverage: v.NumberSchema<undefined>;

package/dist/entities/index.d.ts

@@ -69,6 +69,11 @@ export declare const ENTITIES: {
         readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
         readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+        readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly from: v.StringSchema<undefined>;
+            readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
         readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
         readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
             readonly coverage: v.NumberSchema<undefined>;
@@ -250,6 +255,11 @@ export declare const ENTITIES: {
         readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
         readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+        readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly from: v.StringSchema<undefined>;
+            readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
         readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
         readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
             readonly coverage: v.NumberSchema<undefined>;
@@ -431,6 +441,11 @@ export declare const ENTITIES: {
             readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
             readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+            readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                readonly from: v.StringSchema<undefined>;
+                readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
             readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
             readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly coverage: v.NumberSchema<undefined>;
@@ -591,7 +606,7 @@ export declare const ENTITIES: {
                 }, undefined>, undefined>;
             }, undefined>, undefined>;
             readonly provider_metadata: v.OptionalSchema<v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>, undefined>;
-        }, "chat_title" | "context" | "discovery" | "email" | "excerpt" | "found_in" | "matched_in" | "ref" | "score" | "sender_name" | "timestamp">;
+        }, "chat_title" | "context" | "corrections" | "discovery" | "email" | "excerpt" | "found_in" | "match" | "matched_in" | "ref" | "score" | "sender_name" | "timestamp">;
         readonly "~standard": v.StandardProps<{
             ref: string;
             chat_title?: string | null | undefined;
@@ -600,6 +615,11 @@ export declare const ENTITIES: {
             excerpt?: string | undefined;
             matched_in?: "context" | "file" | "filename" | "picture" | "text" | "transcript" | undefined;
             score?: number | undefined;
+            match?: "beginnings" | "corrected" | "words" | undefined;
+            corrections?: {
+                from: string;
+                to: string[];
+            }[] | undefined;
             found_in?: "archive" | "both" | "server" | undefined;
             discovery?: {
                 coverage: number;
@@ -658,6 +678,11 @@ export declare const ENTITIES: {
             excerpt?: string | undefined;
             matched_in?: "context" | "file" | "filename" | "picture" | "text" | "transcript" | undefined;
             score?: number | undefined;
+            match?: "beginnings" | "corrected" | "words" | undefined;
+            corrections?: {
+                from: string;
+                to: string[];
+            }[] | undefined;
             found_in?: "archive" | "both" | "server" | undefined;
             discovery?: {
                 coverage: number;
@@ -717,6 +742,11 @@ export declare const ENTITIES: {
             excerpt?: string | undefined;
             matched_in?: "context" | "file" | "filename" | "picture" | "text" | "transcript" | undefined;
             score?: number | undefined;
+            match?: "beginnings" | "corrected" | "words" | undefined;
+            corrections?: {
+                from: string;
+                to: string[];
+            }[] | undefined;
             found_in?: "archive" | "both" | "server" | undefined;
             discovery?: {
                 coverage: number;
@@ -777,6 +807,11 @@ export declare const ENTITIES: {
                 excerpt?: string | undefined;
                 matched_in?: "context" | "file" | "filename" | "picture" | "text" | "transcript" | undefined;
                 score?: number | undefined;
+                match?: "beginnings" | "corrected" | "words" | undefined;
+                corrections?: {
+                    from: string;
+                    to: string[];
+                }[] | undefined;
                 found_in?: "archive" | "both" | "server" | undefined;
                 discovery?: {
                     coverage: number;
@@ -836,6 +871,11 @@ export declare const ENTITIES: {
                 excerpt?: string | undefined;
                 matched_in?: "context" | "file" | "filename" | "picture" | "text" | "transcript" | undefined;
                 score?: number | undefined;
+                match?: "beginnings" | "corrected" | "words" | undefined;
+                corrections?: {
+                    from: string;
+                    to: string[];
+                }[] | undefined;
                 found_in?: "archive" | "both" | "server" | undefined;
                 discovery?: {
                     coverage: number;
@@ -910,6 +950,11 @@ export declare const ENTITIES: {
         readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
         readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+        readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly from: v.StringSchema<undefined>;
+            readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
         readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
         readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
             readonly coverage: v.NumberSchema<undefined>;
@@ -1091,6 +1136,11 @@ export declare const ENTITIES: {
             readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
             readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+            readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                readonly from: v.StringSchema<undefined>;
+                readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
             readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
             readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly coverage: v.NumberSchema<undefined>;
@@ -2857,7 +2907,7 @@ export declare const ENTITIES: {
     readonly saved_search: v.StrictObjectSchema<{
         readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
         readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-        readonly command: v.PicklistSchema<["search", "stats", "message-top", "author-top", "admin-statistics"], undefined>;
+        readonly command: v.PicklistSchema<["search", "stats", "message-top", "author-top", "admin-statistics", "meetings-search"], undefined>;
         readonly params: v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>;
         readonly language: v.StringSchema<undefined>;
         readonly version: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>;
@@ -3264,6 +3314,11 @@ export declare const ENTITIES: {
             readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
             readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+            readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                readonly from: v.StringSchema<undefined>;
+                readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
             readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
             readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly coverage: v.NumberSchema<undefined>;
@@ -3445,6 +3500,11 @@ export declare const ENTITIES: {
                 readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                 readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
                 readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+                readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                    readonly from: v.StringSchema<undefined>;
+                    readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>, undefined>, undefined>;
                 readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
                 readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
                     readonly coverage: v.NumberSchema<undefined>;
@@ -3664,6 +3724,11 @@ export declare const ENTITIES: {
             readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
             readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+            readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                readonly from: v.StringSchema<undefined>;
+                readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>, undefined>;
             readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
             readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly coverage: v.NumberSchema<undefined>;
@@ -3845,6 +3910,11 @@ export declare const ENTITIES: {
                 readonly excerpt: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                 readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
                 readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+                readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+                    readonly from: v.StringSchema<undefined>;
+                    readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>, undefined>, undefined>;
                 readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
                 readonly discovery: v.OptionalSchema<v.StrictObjectSchema<{
                     readonly coverage: v.NumberSchema<undefined>;

package/dist/entities/index.js

@@ -61,6 +61,8 @@ export const ENTITIES = {
         "excerpt",
         "matched_in",
         "score",
+        "match",
+        "corrections",
         "found_in",
         "discovery",
         "context",

package/dist/entities/message.d.ts

@@ -25,6 +25,15 @@ export declare const message: v.StrictObjectSchema<{
     /** `picture`: the picture search lane found it by what the picture shows; it follows the text hits. */
     readonly matched_in: v.OptionalSchema<v.PicklistSchema<["text", "transcript", "filename", "file", "context", "picture"], undefined>, undefined>;
     readonly score: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    /**
+     * `corrected`: a query word matched only a spelling speech recognition garbled in a voice note's transcript,
+     * listed in `corrections`. `words` and `beginnings`: what a discovery search matched.
+     */
+    readonly match: v.OptionalSchema<v.PicklistSchema<["words", "beginnings", "corrected"], undefined>, undefined>;
+    readonly corrections: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+        readonly from: v.StringSchema<undefined>;
+        readonly to: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
     /** Where a search found it: the local archive, the messenger's server, or both. */
     readonly found_in: v.OptionalSchema<v.PicklistSchema<["archive", "server", "both"], undefined>, undefined>;
     /** A discovery search's partial match: how much of the question it covers, and which words it lacks. */

package/dist/entities/message.js

@@ -37,6 +37,12 @@ export const message = v.strictObject({
     /** `picture`: the picture search lane found it by what the picture shows; it follows the text hits. */
     matched_in: v.optional(v.picklist(["text", "transcript", "filename", "file", "context", "picture"])),
     score: v.optional(v.number()),
+    /**
+     * `corrected`: a query word matched only a spelling speech recognition garbled in a voice note's transcript,
+     * listed in `corrections`. `words` and `beginnings`: what a discovery search matched.
+     */
+    match: v.optional(v.picklist(["words", "beginnings", "corrected"])),
+    corrections: v.optional(v.array(v.strictObject({ from: text, to: v.array(text) }))),
     /** Where a search found it: the local archive, the messenger's server, or both. */
     found_in: v.optional(v.picklist(["archive", "server", "both"])),
     /** A discovery search's partial match: how much of the question it covers, and which words it lacks. */

package/dist/entities/saved-search.d.ts

@@ -4,7 +4,7 @@ export declare const savedSearch: v.StrictObjectSchema<{
     readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
     /** `null` for a run in the history. */
     readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
-    readonly command: v.PicklistSchema<["search", "stats", "message-top", "author-top", "admin-statistics"], undefined>;
+    readonly command: v.PicklistSchema<["search", "stats", "message-top", "author-top", "admin-statistics", "meetings-search"], undefined>;
     /** The query and the options it runs with, as the command took them. */
     readonly params: v.RecordSchema<v.StringSchema<undefined>, v.UnknownSchema, undefined>;
     readonly language: v.StringSchema<undefined>;

package/dist/entities/saved-search.js

@@ -5,7 +5,7 @@ export const savedSearch = v.strictObject({
     id,
     /** `null` for a run in the history. */
     name: v.nullable(text),
-    command: v.picklist(["search", "stats", "message-top", "author-top", "admin-statistics"]),
+    command: v.picklist(["search", "stats", "message-top", "author-top", "admin-statistics", "meetings-search"]),
     /** The query and the options it runs with, as the command took them. */
     params: v.record(v.string(), v.unknown()),
     language: text,

package/dist/errors/reasons.d.ts

@@ -1,5 +1,6 @@
 import type { FailureContext } from "@wirecat/cli-base";
 import type { ErrorReason } from "@wirecat/cli-base/standards";
+export declare const INPUT_FIELD_REASONS: ErrorReason[];
 /** Every reason this package raises; cli-base's own are known to the handler already. */
 export declare const REASONS: ErrorReason[];
 /**

package/dist/errors/reasons.js

@@ -51,6 +51,7 @@ const OTHERS = [
     validation("ranking.invalid", "the ranking is not valid"),
     validation("selection.changed", "the stored selection changed meanwhile"),
     validation("selection.invalid", "the selection is not valid"),
+    validation("search.kind", "the saved search belongs to another kind of search: messages or meetings"),
     ["selection.out-of-scope", "permission_error", "the selection reaches outside what this profile may read"],
     validation("stemmer.invalid", "the stemmer is not valid for that script"),
     validation("stemmer.newer", "the stems were built by a newer tool"),
@@ -77,9 +78,24 @@ const OTHERS = [
     validation("vocabulary.over-entry-budget", "the vocabulary has too many entries"),
     ["vocabulary.stale", "configuration_error", "the vocabulary changed meanwhile"],
 ];
+export const INPUT_FIELD_REASONS = defineReasons([
+    {
+        reason: "input.field-conflict",
+        code: "validation_error",
+        message: "the input fields conflict",
+        details: ["fields"],
+    },
+    {
+        reason: "input.field-unsupported",
+        code: "validation_error",
+        message: "the input field is not supported",
+        details: ["fields"],
+    },
+]);
 /** Every reason this package raises; cli-base's own are known to the handler already. */
 export const REASONS = defineReasons([
     ...QUERY_REASONS,
+    ...INPUT_FIELD_REASONS,
     ...[...QUERY, ...OTHERS].map(([reason, code, message]) => ({
         reason,
         code,