@wirecat/cli-base 0.45.0 → 0.46.0

package/dist/query/fields.d.ts

@@ -51,4 +51,3 @@ export interface FieldAnnotations {
  * boolean → bool, `reference` → ref; an array takes its item's type. Objects and records are not fields.
  */
 export declare const queryFieldsOf: (schema: v.GenericSchema, annotations?: FieldAnnotations) => FieldSpec[];
-//# sourceMappingURL=fields.d.ts.map

package/dist/query/fields.js

@@ -84,4 +84,3 @@ export const queryFieldsOf = (schema, annotations = {}) => {
         : [];
     return [...own, ...relations, ...states];
 };
-//# sourceMappingURL=fields.js.map

package/dist/query/help.d.ts

@@ -2,4 +2,3 @@ import type { QueryRegistry } from "./fields.js";
 export declare const QUERY_SYNTAX = "field:value \u00B7 \"a phrase\" \u00B7 word* \u00B7 AND OR NOT \u00B7 ( ) \u00B7 [a TO b] \u00B7 > >= < <=";
 /** The Fields section of a list's help: one line per field it filters by, its defaults, the syntax and the guide. */
 export declare const fieldsHelp: (registry: Pick<QueryRegistry, "fields" | "defaults"> & Partial<Pick<QueryRegistry, "backend">>, guide?: string) => string;
-//# sourceMappingURL=help.d.ts.map

package/dist/query/help.js

@@ -15,4 +15,3 @@ export const fieldsHelp = (registry, guide) => {
         ...(guide ? [`Guide: ${guide}`] : []),
     ].join("\n");
 };
-//# sourceMappingURL=help.js.map

package/dist/query/index.d.ts

@@ -10,4 +10,3 @@ export { implicitTextTerms, type ParseOptions, parseLucene } from "./parser.js";
 export { defineQuery, describeQuery, exampleProblems, type FieldInfo, QUERY_REASONS, type QueryInfo, } from "./registry.js";
 export { type Occur, type Operator, type Predicate, QUERY_LIMITS, type QueryAst, type QueryContext, type QueryNode, queryAstSchema, queryError, queryNodeSchema, type Span, walkQuery, } from "./types.js";
 export { fieldsNamed, type ValidateOptions, validateQuery } from "./validate.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/query/index.js

@@ -10,4 +10,3 @@ export { implicitTextTerms, parseLucene } from "./parser.js";
 export { defineQuery, describeQuery, exampleProblems, QUERY_REASONS, } from "./registry.js";
 export { QUERY_LIMITS, queryAstSchema, queryError, queryNodeSchema, walkQuery, } from "./types.js";
 export { fieldsNamed, validateQuery } from "./validate.js";
-//# sourceMappingURL=index.js.map

package/dist/query/parser.d.ts

@@ -6,4 +6,3 @@ export interface ParseOptions extends QueryContext {
 export declare const parseLucene: (text: string, { defaultField, ...context }?: ParseOptions) => QueryAst;
 /** Bare terms eligible for forgiving retrieval; explicit syntax keeps strict semantics. */
 export declare const implicitTextTerms: (text: string) => Set<number>;
-//# sourceMappingURL=parser.d.ts.map

package/dist/query/parser.js

@@ -320,4 +320,3 @@ export const implicitTextTerms = (text) => {
         ? [token.span.start]
         : []));
 };
-//# sourceMappingURL=parser.js.map

package/dist/query/registry.d.ts

@@ -20,4 +20,3 @@ export declare const QUERY_REASONS: {
     details: string[];
     step?: string | undefined;
 }[];
-//# sourceMappingURL=registry.d.ts.map

package/dist/query/registry.js

@@ -74,4 +74,3 @@ export const QUERY_REASONS = defineReasons([
     message,
     details: [...SPAN, ...details],
 })));
-//# sourceMappingURL=registry.js.map

package/dist/query/types.d.ts

@@ -50,4 +50,3 @@ export interface QueryContext {
 }
 export declare function queryError(reason: string, span: Span, alternative?: string, context?: QueryContext, details?: Record<string, unknown>): never;
 export declare const walkQuery: (node: QueryNode) => Predicate[];
-//# sourceMappingURL=types.d.ts.map

package/dist/query/types.js

@@ -41,4 +41,3 @@ export function queryError(reason, span, alternative, context = {}, details = {}
     });
 }
 export const walkQuery = (node) => node.kind === "predicate" ? [node] : node.clauses.flatMap(({ node }) => walkQuery(node));
-//# sourceMappingURL=types.js.map

package/dist/query/validate.d.ts

@@ -8,4 +8,3 @@ export interface ValidateOptions extends QueryContext {
 export declare const validateQuery: (ast: QueryAst, registry: QueryRegistry, options?: ValidateOptions) => QueryAst;
 /** The fields a query names, so a default on a field the query names is lifted. */
 export declare const fieldsNamed: (ast: QueryAst) => Set<string>;
-//# sourceMappingURL=validate.d.ts.map

package/dist/query/validate.js

@@ -79,4 +79,3 @@ export const validateQuery = (ast, registry, options = {}) => {
 };
 /** The fields a query names, so a default on a field the query names is lifted. */
 export const fieldsNamed = (ast) => new Set(walkQuery(ast.root).map((node) => node.field));
-//# sourceMappingURL=validate.js.map

package/dist/release/fold.d.ts

@@ -13,4 +13,3 @@ export declare const foldUnreleased: (text: string, version: string, unreleased?
  * when no heading repeats there. The caller makes sure the version is not on npm.
  */
 export declare const mergeRepeatedHeadings: (text: string, version: string) => string | undefined;
-//# sourceMappingURL=fold.d.ts.map

package/dist/release/fold.js

@@ -66,4 +66,3 @@ export const mergeRepeatedHeadings = (text, version) => {
         return undefined;
     return [preamble, render(section.title, [section]), ...rest].join("\n");
 };
-//# sourceMappingURL=fold.js.map

package/dist/release/index.d.ts

@@ -36,4 +36,3 @@ export declare const versionScript: (root: string, argv: readonly string[], file
     code: 0 | 1 | 2;
     message: string;
 };
-//# sourceMappingURL=index.d.ts.map

package/dist/release/index.js

@@ -89,4 +89,3 @@ export const versionScript = (root, argv, file = "src/version.ts") => {
         };
     return { code: 0, message: `version ${declared} — package.json and ${file} agree` };
 };
-//# sourceMappingURL=index.js.map

package/dist/release/markdown.d.ts

@@ -38,4 +38,3 @@ export type DocsRules = {
     skipLink?: (target: string, destination: string) => boolean;
 };
 export declare const docsProblems: (root: string, { files, ids, userPage, correction, skipLink }: DocsRules) => string[];
-//# sourceMappingURL=markdown.d.ts.map

package/dist/release/markdown.js

@@ -167,4 +167,3 @@ export const docsProblems = (root, { files, ids, userPage = () => false, correct
     }
     return problems;
 };
-//# sourceMappingURL=markdown.js.map

package/dist/release/structure.d.ts

@@ -13,4 +13,3 @@ export type StructureRules = {
  * is the contributors' index and stays out of the sidebar.
  */
 export declare const structureProblems: (root: string, { docs, required, external }?: StructureRules) => string[];
-//# sourceMappingURL=structure.d.ts.map

package/dist/release/structure.js

@@ -71,4 +71,3 @@ export const structureProblems = (root, { docs = "docs", required = REQUIRED_PAG
     }
     return problems;
 };
-//# sourceMappingURL=structure.js.map

package/dist/renderer.d.ts

@@ -31,4 +31,3 @@ export interface RendererOptions {
  * output still gives you the content and not the commentary.
  */
 export declare const createRenderer: ({ format, color, streams, quiet, }: RendererOptions) => Renderer;
-//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.js

@@ -52,4 +52,3 @@ export const createRenderer = ({ format, color, streams = processStreams, quiet
         stream: (items) => streams.data(JSON.stringify([...items])),
     };
 };
-//# sourceMappingURL=renderer.js.map

package/dist/result-fields.d.ts

@@ -1,4 +1,3 @@
 export declare const fieldsOf: (value: string) => string[];
 /** Projects payload paths through objects and arrays, retaining result coverage and continuation. */
 export declare const projectFields: (value: unknown, fields: readonly string[]) => unknown;
-//# sourceMappingURL=result-fields.d.ts.map

package/dist/result-fields.js

@@ -77,4 +77,3 @@ export const projectFields = (value, fields) => {
     validate(fields);
     return project(value, fields);
 };
-//# sourceMappingURL=result-fields.js.map

package/dist/retry.d.ts

@@ -15,4 +15,3 @@ export declare const DEFAULT_RETRY: RetryConfig;
  * `attempt` is the attempt that just failed, counting from 1.
  */
 export declare const backoffMs: (attempt: number, config: RetryConfig, random: () => number) => number;
-//# sourceMappingURL=retry.d.ts.map

package/dist/retry.js

@@ -15,4 +15,3 @@ export const backoffMs = (attempt, config, random) => {
     const ceiling = Math.min(config.maxDelayMs, config.baseDelayMs * 2 ** (attempt - 1));
     return Math.round(random() * ceiling);
 };
-//# sourceMappingURL=retry.js.map

package/dist/sanitize.d.ts

@@ -22,4 +22,3 @@ export declare const visibleControls: (text: string) => string;
  * sender's name would otherwise print as a line of its own, indistinguishable from real output.
  */
 export declare const singleLine: (text: string) => string;
-//# sourceMappingURL=sanitize.d.ts.map

package/dist/sanitize.js

@@ -49,4 +49,3 @@ export const visibleControls = (text) => {
  * sender's name would otherwise print as a line of its own, indistinguishable from real output.
  */
 export const singleLine = (text) => visibleControls(text).replace(LINE_BREAKS, escaped);
-//# sourceMappingURL=sanitize.js.map

package/dist/skill/index.d.ts

@@ -75,4 +75,3 @@ export interface SkillResource {
  */
 export declare const skillResource: (app: SkillApp, skill: URL) => SkillResource;
 export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/skill/index.js

@@ -185,4 +185,3 @@ export const skillResource = (app, skill) => {
         instruction: `- The full guide is the resource ${uri}; \`${app.command} skill install\` installs it as an agent skill.`,
     };
 };
-//# sourceMappingURL=index.js.map

package/dist/standards/audit.d.ts

@@ -37,4 +37,3 @@ export type RequiredRoot = v.InferOutput<typeof requiredRootSchema>;
 export declare const defineRequiredRoots: (input: unknown) => RequiredRoot[];
 export declare const REQUIRED_ROOTS: RequiredRoot[];
 export {};
-//# sourceMappingURL=audit.d.ts.map

package/dist/standards/audit.js

@@ -69,4 +69,3 @@ export const REQUIRED_ROOTS = defineRequiredRoots([
     { path: ["mcp"], meaning: "the MCP server" },
     { path: ["upgrade"], meaning: "updates the CLI" },
 ]);
-//# sourceMappingURL=audit.js.map

package/dist/standards/effects.d.ts

@@ -9,4 +9,3 @@ export type Effects = v.InferOutput<typeof effectsSchema>;
 export type EffectLevel = (typeof EFFECT_LEVELS)[number];
 /** Unknown effects count as a write: a command nobody described is never retried or run on its own. */
 export declare const writes: (effects: Effects | undefined) => boolean;
-//# sourceMappingURL=effects.d.ts.map

package/dist/standards/effects.js

@@ -7,4 +7,3 @@ export const effectsSchema = v.strictObject({
 });
 /** Unknown effects count as a write: a command nobody described is never retried or run on its own. */
 export const writes = (effects) => effects === undefined || effects.remote === "write" || effects.local === "write";
-//# sourceMappingURL=effects.js.map

package/dist/standards/errors.d.ts

@@ -70,4 +70,3 @@ export declare const COMMON_DETAILS: readonly ["attempts", "status", "request_id
 /** One reason per code, used when the code site named none, the crash, and the reasons cli-base raises itself. */
 export declare const BASE_REASONS: ErrorReason[];
 export {};
-//# sourceMappingURL=errors.d.ts.map

package/dist/standards/errors.js

@@ -94,4 +94,3 @@ export const BASE_REASONS = defineReasons([
     { reason: "command.cancelled", code: "cancelled", message: "the command was cancelled", details: [] },
     { reason: CRASH_REASON, code: CRASH_CODE, message: "the command failed; this is a bug", details: [] },
 ]);
-//# sourceMappingURL=errors.js.map

package/dist/standards/fields.d.ts

@@ -7,4 +7,3 @@ export type FieldRule = v.InferOutput<typeof fieldRuleSchema>;
 export declare const defineFieldRules: (input: unknown) => FieldRule[];
 export declare const FIELD_RULES: FieldRule[];
 export {};
-//# sourceMappingURL=fields.d.ts.map

package/dist/standards/fields.js

@@ -14,4 +14,3 @@ export const FIELD_RULES = defineFieldRules([
         rule: "absent: not asked for or not known; `null`: known to have no value; `[]`: known to be empty, never `null`; `0`: measured, never a stand-in for unknown",
     },
 ]);
-//# sourceMappingURL=fields.js.map

package/dist/standards/flags-how.d.ts

@@ -1,3 +1,2 @@
 import type { VocabularyFlag } from "./vocabulary.js";
 export declare const HOW_FLAGS: VocabularyFlag[];
-//# sourceMappingURL=flags-how.d.ts.map

package/dist/standards/flags-how.js

@@ -965,4 +965,3 @@ export const HOW_FLAGS = [
         meaning: "how returned cell values are represented: formatted display values, unformatted values or formulas",
     },
 ];
-//# sourceMappingURL=flags-how.js.map

package/dist/standards/flags-what.d.ts

@@ -1,3 +1,2 @@
 import type { VocabularyFlag } from "./vocabulary.js";
 export declare const WHAT_FLAGS: VocabularyFlag[];
-//# sourceMappingURL=flags-what.d.ts.map

package/dist/standards/flags-what.js

@@ -833,4 +833,3 @@ export const WHAT_FLAGS = [
         meaning: "cell values as JSON rows for an explicit range update or row append; not a list filter",
     },
 ];
-//# sourceMappingURL=flags-what.js.map

package/dist/standards/identifiers.d.ts

@@ -9,4 +9,3 @@ export declare const defineIdentifiers: (input: unknown) => Identifier[];
 /** The ids a CLI's answers, errors and logs carry; one name each. */
 export declare const IDENTIFIERS: Identifier[];
 export {};
-//# sourceMappingURL=identifiers.d.ts.map

package/dist/standards/identifiers.js

@@ -21,4 +21,3 @@ export const IDENTIFIERS = defineIdentifiers([
     { key: "request_id", meaning: "the provider's own reference for one request, as it sent it" },
     { key: "trace_id", meaning: "the distributed trace a run belongs to, from `traceparent`" },
 ]);
-//# sourceMappingURL=identifiers.js.map

package/dist/standards/index.d.ts

@@ -4,4 +4,3 @@ export { defineLogEvents, isContentKey, LOG_ATTRIBUTE_KEYS, LOG_EVENTS, LOG_SEVE
 export { type Issue, type ItemEnvelope, isoTime, issueSchema, itemEnvelopeSchema, jsonlEndSchema, jsonlItemSchema, jsonlOf, type ListEnvelope, listEnvelopeSchema, MAX_NEXT_STEPS, type Meta, type Missing, metaSchema, missingSchema, type NextStep, nextStepSchema, type Page, pageSchema, reference, } from "./output.js";
 export { fill, jsonSchemaOf, RegistryError } from "./registry.js";
 export { defineSteps, SAME_COMMAND, STEPS, type StepDefinition, type StepInput, type StepTarget, stepOf, } from "./steps.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/standards/index.js

@@ -4,4 +4,3 @@ export { defineLogEvents, isContentKey, LOG_ATTRIBUTE_KEYS, LOG_EVENTS, LOG_SEVE
 export { isoTime, issueSchema, itemEnvelopeSchema, jsonlEndSchema, jsonlItemSchema, jsonlOf, listEnvelopeSchema, MAX_NEXT_STEPS, metaSchema, missingSchema, nextStepSchema, pageSchema, reference, } from "./output.js";
 export { fill, jsonSchemaOf, RegistryError } from "./registry.js";
 export { defineSteps, SAME_COMMAND, STEPS, stepOf, } from "./steps.js";
-//# sourceMappingURL=index.js.map

package/dist/standards/lint.d.ts

@@ -37,4 +37,3 @@ export declare const rulesForReview: (lists: readonly (readonly Override[])[]) =
     overrides: number;
 }[];
 export {};
-//# sourceMappingURL=lint.d.ts.map

package/dist/standards/lint.js

@@ -144,4 +144,3 @@ export const rulesForReview = (lists) => {
         .map(([rule, overrides]) => ({ rule, overrides }))
         .sort((a, b) => b.overrides - a.overrides || (a.rule < b.rule ? -1 : 1));
 };
-//# sourceMappingURL=lint.js.map

package/dist/standards/log.d.ts

@@ -48,4 +48,3 @@ export declare const logAttributesJsonSchema: (allow?: readonly string[]) => Rec
  */
 export declare const traceIdOf: (traceparent: unknown) => string | undefined;
 export {};
-//# sourceMappingURL=log.d.ts.map

package/dist/standards/log.js

@@ -112,4 +112,3 @@ export const traceIdOf = (traceparent) => {
         return undefined;
     return traceId;
 };
-//# sourceMappingURL=log.js.map

package/dist/standards/output.d.ts

@@ -220,4 +220,3 @@ export declare const jsonlEndSchema: v.StrictObjectSchema<{
 }, undefined>;
 /** A list answer as JSON lines, the end line last. */
 export declare const jsonlOf: <T>({ items, page, meta }: ListEnvelope<T>) => string;
-//# sourceMappingURL=output.d.ts.map

package/dist/standards/output.js

@@ -88,4 +88,3 @@ export const jsonlOf = ({ items, page, meta }) => [
     ...items.map((data) => JSON.stringify({ type: "item", data })),
     JSON.stringify({ type: "end", complete: meta.complete, ...(meta.issues ? { issues: meta.issues } : {}), page }),
 ].join("\n");
-//# sourceMappingURL=output.js.map

package/dist/standards/registry.d.ts

@@ -17,4 +17,3 @@ export declare const jsonSchemaOf: (schema: v.GenericSchema, definitions?: Recor
 export declare const placeholders: (template: string) => string[];
 /** Fills `{name}` from `values`; a placeholder with no value throws, so a half-filled sentence never ships. */
 export declare const fill: (template: string, values: Readonly<Record<string, string | number>>) => string;
-//# sourceMappingURL=registry.d.ts.map

package/dist/standards/registry.js

@@ -40,4 +40,3 @@ export const fill = (template, values) => template.replace(PLACEHOLDER, (_, name
         throw new Error(`no value for {${name}} in "${template}"`);
     return String(value);
 });
-//# sourceMappingURL=registry.js.map

package/dist/standards/steps.d.ts

@@ -43,4 +43,3 @@ export declare const stepOf: (definition: StepDefinition, input?: StepInput) =>
 /** The steps every CLI has; each package adds its own with `defineSteps`. */
 export declare const STEPS: StepDefinition[];
 export {};
-//# sourceMappingURL=steps.d.ts.map

package/dist/standards/steps.js

@@ -85,4 +85,3 @@ export const STEPS = defineSteps([
         why: "{shown} shown, more exist",
     },
 ]);
-//# sourceMappingURL=steps.js.map

package/dist/standards/tables.d.ts

@@ -3,4 +3,3 @@ export { defineFieldRules, FIELD_RULES, type FieldRule } from "./fields.js";
 export { defineIdentifiers, IDENTIFIERS, type Identifier } from "./identifiers.js";
 export { baselineProblems, baselineSchema, defineLintRules, LINT_RULES, LINT_SEVERITIES, type LintRule, type LintSeverity, OVERRIDE_BUDGET, OVERRIDE_RULE_REVIEW, type Override, overridesProblems, overridesSchema, rulesForReview, } from "./lint.js";
 export { defineVocabulary, FLAG_ROLES, FLAG_TYPES, type FlagRole, type FlagType, VOCABULARY, type Vocabulary, type VocabularyFlag, type VocabularyNoun, type VocabularyVerb, vocabularySchema, } from "./vocabulary.js";
-//# sourceMappingURL=tables.d.ts.map

package/dist/standards/tables.js

@@ -3,4 +3,3 @@ export { defineFieldRules, FIELD_RULES } from "./fields.js";
 export { defineIdentifiers, IDENTIFIERS } from "./identifiers.js";
 export { baselineProblems, baselineSchema, defineLintRules, LINT_RULES, LINT_SEVERITIES, OVERRIDE_BUDGET, OVERRIDE_RULE_REVIEW, overridesProblems, overridesSchema, rulesForReview, } from "./lint.js";
 export { defineVocabulary, FLAG_ROLES, FLAG_TYPES, VOCABULARY, vocabularySchema, } from "./vocabulary.js";
-//# sourceMappingURL=tables.js.map

package/dist/standards/vocabulary.d.ts

@@ -57,4 +57,3 @@ export type FlagType = (typeof FLAG_TYPES)[number];
 export declare const defineVocabulary: (input: unknown) => Vocabulary;
 /** The words every CLI on cli-base is judged against. Seeded from STANDARD's command-name rules and the glossary. */
 export declare const VOCABULARY: Vocabulary;
-//# sourceMappingURL=vocabulary.d.ts.map

package/dist/standards/vocabulary.js

@@ -277,6 +277,7 @@ const roots = [
     ["doctor", "check this machine's setup"],
     ["upgrade", "install a newer version of this tool"],
     ["commands", "the command tree as data"],
+    ["guide", "scenarios: the commands for a common task, in order, and why each"],
     ["complete", "shell completion"],
     ["mcp", "the MCP server and its setup"],
     ["bot", "the profile's bot account"],
@@ -298,4 +299,3 @@ export const VOCABULARY = defineVocabulary({
     roots: roots.map(([entry, meaning]) => ({ word: entry, meaning })),
     flags: [...HOW_FLAGS, ...WHAT_FLAGS],
 });
-//# sourceMappingURL=vocabulary.js.map

package/dist/streams.d.ts

@@ -22,4 +22,3 @@ export declare const captureStreams: () => Streams & {
     stdout: string[];
     stderr: string[];
 };
-//# sourceMappingURL=streams.d.ts.map

package/dist/streams.js

@@ -27,4 +27,3 @@ export const captureStreams = () => {
         progress: (text) => stderr.push(text),
     };
 };
-//# sourceMappingURL=streams.js.map

package/dist/testing/index.d.ts

@@ -25,4 +25,3 @@ export interface FakeClock {
  * test nobody runs, so `sleep` resolves at once and records what it was asked for.
  */
 export declare const fakeClock: (startMs?: number) => FakeClock;
-//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.js

@@ -34,4 +34,3 @@ export const fakeClock = (startMs = 0) => {
         },
     };
 };
-//# sourceMappingURL=index.js.map

package/dist/testing/network.d.ts

@@ -12,4 +12,3 @@ export declare const installNetworkGuard: () => void;
  * `onTestFinished(allowNetwork())`. For the rare test whose subject is the network itself.
  */
 export declare const allowNetwork: () => (() => void);
-//# sourceMappingURL=network.d.ts.map

package/dist/testing/network.js

@@ -114,4 +114,3 @@ export const allowNetwork = () => {
         state().allowed--;
     };
 };
-//# sourceMappingURL=network.js.map

package/dist/testing/sandbox.d.ts

@@ -21,4 +21,3 @@ export declare const REAL_KEYRING_REACHED = "a test reached the real OS keyring
  * `keyring.ts` loads) and from the working directory (a CLI's own copy). Never removed.
  */
 export declare const installThrowingKeyring: () => void;
-//# sourceMappingURL=sandbox.d.ts.map

package/dist/testing/sandbox.js

@@ -127,4 +127,3 @@ export const installThrowingKeyring = () => {
         };
     }
 };
-//# sourceMappingURL=sandbox.js.map

package/dist/testing/setup.d.ts

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=setup.d.ts.map

package/dist/testing/setup.js

@@ -10,4 +10,3 @@ const sandbox = enterSandbox();
 installThrowingKeyring();
 installNetworkGuard();
 afterAll(() => sandbox.restore());
-//# sourceMappingURL=setup.js.map

package/dist/time.d.ts

@@ -18,4 +18,3 @@ export declare const abortError: () => DOMException;
 export declare const realSleep: SleepLike;
 export declare const monotonic: MonotonicClock;
 export declare const wallClock: WallClock;
-//# sourceMappingURL=time.d.ts.map

package/dist/time.js

@@ -16,4 +16,3 @@ export const realSleep = (ms, signal) => new Promise((resolve, reject) => {
 });
 export const monotonic = () => performance.now();
 export const wallClock = () => new Date();
-//# sourceMappingURL=time.js.map

package/dist/update/index.d.ts

@@ -75,4 +75,3 @@ export interface NoticeRequest extends NotifyContext {
  * and awaited after it, so asking npm costs the command nothing; any failure is silence.
  */
 export declare const updateNotice: ({ argv, packageName, command, upgradeCommand, version, statePath, fetch, now, ...context }: NoticeRequest) => Promise<string | undefined>;
-//# sourceMappingURL=index.d.ts.map

package/dist/update/index.js

@@ -165,4 +165,3 @@ const commandWords = (argv) => {
     const end = argv.indexOf("--");
     return argv.slice(0, end < 0 ? undefined : end).filter((word) => !word.startsWith("-"));
 };
-//# sourceMappingURL=index.js.map

package/docs/standards/ci.md

@@ -65,7 +65,9 @@ cli-testing, cli-docs, plus community itself.
 ### WC-CI-5 · Run the full Linux validation on every pull request, and keep platform suites out
 
 - **Why:** a pull request that lowers coverage or breaks a contract must fail before it merges; once on `main` it
-  blocks every other branch and the next release. It costs about two and a half minutes per pull request.
+  blocks every other branch and the next release. It costs 2–3 minutes per pull request in the CLIs (measured: wa
+  2.9, tg 2.2, max 3.0) and about 8 in cli-core, where `test:coverage` alone takes 5m46s; splitting that job into
+  shards would need a new `node-ci.yml` input.
 - **Enforced by:** `pr.yml:validation`.
 - **Example:** `pr.yml` runs on `pull_request` and calls the repository's own `ci.yml`, the same full validation as
   `main` (WC-CI-7): lint, typecheck, `test:coverage` with the coverage floor, build, the contracts, the test matrix,
@@ -93,8 +95,8 @@ cli-testing, cli-docs, plus community itself.
   cli-base `macos.yml` for the path code. cli-docs and community run `security-pr.yml`, a new-commit secret scan;
   cli-docs validates its site before each deployment instead, and community has no build. Third-party security apps
   may post their own checks.
-- **Applies to:** the CLIs, cli-base, cli-core and cli-testing. cli-base has `pr.yml`; wa adds it in its
-  `ci/pr-validation` branch; tg, max, memo, drive, zoom, cli-core and cli-testing do not have it yet. **Since:**
+- **Applies to:** the CLIs, cli-base, cli-core and cli-testing. cli-base, whatsapp-cli, tg-cli, max-cli, cli-core
+  and cli-memo have `pr.yml`; drive-cli, zoom-cli and cli-testing do not have it yet. **Since:**
   cli-base 0.41.0 (pull request validation since cli-base 0.44.6). **Rulings:** none.
 
 ### WC-CI-6 · Run the changelog guard on every pull request
@@ -164,7 +166,11 @@ cli-testing, cli-docs, plus community itself.
 ### WC-CI-12 · Merge to `main` only through a pull request whose checks all passed
 
 - **Why:** a red merge breaks `main` for every parallel branch, and an admin merge skips the only gate there is.
-- **Enforced by:** review only.
+- **Enforced by:** `whatsapp-cli: main ruleset required checks` · `cli-core: main ruleset required checks` ·
+  `tg-cli: main ruleset required checks` · `max-cli: main ruleset required checks` ·
+  `cli-memo: main ruleset required checks`, plus the main ruleset of cli-base itself. In each repository with pr.yml,
+  the ruleset requires the pull request validation jobs besides the standards job. drive-cli, zoom-cli, cli-testing
+  and cli-docs have no pr.yml, so their rulesets require only the standards job, and review covers the rest.
 - **Example:** `gh pr checks <number>` shows every line as pass before `gh pr merge`. Never merge with `--admin`. A
   release changes `main` the same way
   ([WC-REL-2](releases.md#wc-rel-2--main-changes-only-through-a-pull-request-also-during-a-release)).

package/docs/standards/layout.md

@@ -24,7 +24,8 @@ Rule ids on this page are `WC-LAY-<n>`. How to read a rule, how ids work and whi
   - `contracts/`: the offline contract plan and its snapshots;
   - `config/wirecat/`: the shared presets;
   - `skills/`: the agent skill the package ships;
-  - `CHANGELOG.md`, `CLAUDE.md`, `CLEANUP.md`, `SECURITY.md`, `README.md`, `LICENSE`.
+  - `CHANGELOG.md`, `CLAUDE.md`, `SECURITY.md`, `README.md`, `LICENSE`;
+  - git-ignored, on the working machine only: `CLEANUP.md`, `HANDOFF.md`, plans and journals.
 - **Exceptions:** a folder the CLI has no use for may be missing; memo has no `contracts/` yet. A product folder may
   be added, such as `spec/` for a protocol or API description.
 - **Applies to:** all CLIs. **Since:** cli-base 0.41.0. **Rulings:** none.

package/docs/standards/permissions.md

@@ -22,7 +22,9 @@ has its own policy and guard, with its own `--read-only` flag; zoom only reads.
 writes", drive is a known gap.
 
 WC-PERM-10 and WC-PERM-11 need cli-core 0.321.0, which tg, max and wa pin. WC-PERM-12 as written needs cli-core
-0.337.0; before it, the lock let through some local writes that overwrite what the owner saved.
+0.337.0; before it, the lock let through some local writes that overwrite what the owner saved. A command other
+than `serve` and `watch` saves incoming history only from cli-core 0.343.0, and only when the messenger's adapter has
+`listen`. wa is the one messenger whose history lives in the store; it pins 0.341.0 and has no `listen` yet.
 
 ## Rules
 
@@ -181,14 +183,15 @@ recipient list) are refused too. A `--dry-run` preview still runs.
 - **Why:** an unattended agent needs one switch that the config file and `--permission` cannot undo, and that also
   keeps it from deleting or overwriting what the owner saved here.
 - **Enforced by:** `cli-core: src/cli/effects.test.ts` · `cli-core: src/mcp/vocabulary.test.ts` ·
-  `cli-core: src/mcp/mcp.test.ts`.
+  `cli-core: src/mcp/mcp.test.ts` · `cli-core: src/cli/messenger/connected.test.ts`.
 - **Example:** `schedule` starts an agent with `MAX_READ_ONLY=1`. It reads, drafts and adds tasks; `tags add` and
   `messages send` answer `permission_error`.
-- **Exceptions:** receiving goes on: syncs, fetches, and `serve` and `watch` saving incoming history. Local writes
-  marked `destroysNothing` run: what the store rebuilds (`store reindex`, `mentions rebuild`), a new file
-  (`store backup`, `store export`, `stats charts`), and the task writes the follow-ups skill makes on a timer, where
-  `tasks close` only suggests the close to the owner. Embedding and analysis on this machine run; sending text to an
-  outside service for them is refused.
+- **Exceptions:** receiving goes on: syncs, fetches, and saving incoming history. `serve` and `watch` save what
+  arrives; on a messenger whose history lives in the store and whose adapter has the optional `listen`, so does any
+  other command, an MCP session included (cli-core 0.343.0). Local writes marked `destroysNothing` run: what the store
+  rebuilds (`store reindex`, `mentions rebuild`), a new file (`store backup`, `store export`, `stats charts`), and the
+  task writes the follow-ups skill makes on a timer, where `tasks close` only suggests the close to the owner.
+  Embedding and analysis on this machine run; sending text to an outside service for them is refused.
 - **Applies to:** messenger CLIs. **Since:** cli-base 0.41.0. **Rulings:** none.
 
 ### WC-PERM-13 · Every write passes the write guard before it leaves

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-base",
-  "version": "0.45.0",
+  "version": "0.46.0",
   "description": "The parts every command line tool needs: output modes, terminal rendering, error model, exit codes, credentials, clocks",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",
@@ -8,6 +8,10 @@
     "type": "git",
     "url": "git+https://github.com/WireCatLabs/cli-base.git"
   },
+  "homepage": "https://github.com/WireCatLabs/cli-base#readme",
+  "bugs": {
+    "url": "https://github.com/WireCatLabs/cli-base/issues"
+  },
   "type": "module",
   "engines": {
     "node": ">=22"
@@ -18,6 +22,7 @@
     "config",
     "docs/standards",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE",
     "THIRD_PARTY_NOTICES"
   ],

package/dist/batch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../src/batch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAGjE,eAAO,MAAM,YAAY;;;;;EAKvB,CAAA;AAEF,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAC1C;AACD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;CAChF;AACD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,cAAc,CAAA;CACrD;AACD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,SAAS,EAAE,cAAc,CAAA;CAC1B;AACD,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,CAC1D;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAA;CAAE,CACrG,CAAA;AACD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,gBAAgB,EAAE,MAAM,CAAA;IACxB,cAAc,EAAE,OAAO,CAAA;CACxB;AAeD,mFAAmF;AACnF,eAAO,MAAM,YAAY,UAAW,MAAM,YAAY,SAAS,YAAY,EAAE,KAAG,oBAAoB,EAwCnG,CAAA;AAED,eAAO,MAAM,cAAc,WACjB,aAAa,CAAC,MAAM,GAAG,UAAU,CAAC,YACjC;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KAChC,OAAO,CAAC,MAAM,CAkBhB,CAAA;AAED,2FAA2F;AAC3F,eAAO,MAAM,QAAQ,aACT,SAAS,oBAAoB,EAAE,YAChC;IACP,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3B,KACA,OAAO,CAAC,WAAW,CA4ErB,CAAA;AAED,eAAO,MAAM,mBAAmB,WAAY,WAAW,UAAU,SAAS,MAAM,EAAE,KAAG,WAKnF,CAAA"}