@wirecat/cli-base 0.0.0-stage → 0.22.0

package/dist/standards/vocabulary.js

@@ -0,0 +1,242 @@
+import * as v from "valibot";
+import { duplicates, parseRegistry, text, word } from "./registry.js";
+export const FLAG_TYPES = [
+    "switch",
+    "count",
+    "number",
+    "string",
+    "id",
+    "time",
+    "duration",
+    "choice",
+    "list",
+    "path",
+    "cursor",
+];
+const verbSchema = v.strictObject({ word, meaning: text, replaces: v.optional(v.array(word)) });
+const nounSchema = v.strictObject({
+    word,
+    meaning: text,
+    // A collection is named in the plural; a singular is what a profile has exactly one of.
+    kind: v.picklist(["collection", "singular"]),
+    replaces: v.optional(v.array(word)),
+});
+const viewSchema = v.strictObject({ word, meaning: text });
+const rootSchema = v.strictObject({ word, meaning: text });
+const flagSchema = v.strictObject({
+    name: v.pipe(v.string(), v.regex(/^--[a-z][a-z0-9]*(-[a-z0-9]+)*$/, "a long flag: --lower-case-words")),
+    value: v.optional(v.pipe(v.string(), v.regex(/^<[a-z][a-z0-9-|]*>$/, "a value name such as <n>"))),
+    type: v.picklist(FLAG_TYPES),
+    meaning: text,
+    unit: v.optional(text),
+});
+export const vocabularySchema = v.strictObject({
+    verbs: v.array(verbSchema),
+    nouns: v.array(nounSchema),
+    views: v.array(viewSchema),
+    roots: v.array(rootSchema),
+    flags: v.array(flagSchema),
+});
+/** One word, one meaning within its kind: a second entry for the same verb, noun, view, root or flag is refused. */
+export const defineVocabulary = (input) => parseRegistry("vocabulary", vocabularySchema, input, (vocabulary) => {
+    const problems = [];
+    const kinds = {
+        verbs: vocabulary.verbs.map((entry) => entry.word),
+        nouns: vocabulary.nouns.map((entry) => entry.word),
+        views: vocabulary.views.map((entry) => entry.word),
+        roots: vocabulary.roots.map((entry) => entry.word),
+        flags: vocabulary.flags.map((entry) => entry.name),
+    };
+    for (const [kind, words] of Object.entries(kinds))
+        for (const repeated of duplicates(words))
+            problems.push(`${kind}: "${repeated}" is listed twice`);
+    for (const flag of vocabulary.flags)
+        if ((flag.type === "switch") !== (flag.value === undefined))
+            problems.push(`flags: ${flag.name} — a switch has no value name; every other type has one`);
+    const verbs = new Set(kinds.verbs);
+    for (const verb of vocabulary.verbs)
+        for (const old of verb.replaces ?? [])
+            if (verbs.has(old))
+                problems.push(`verbs: "${verb.word}" replaces "${old}", which is itself a verb`);
+    return problems;
+});
+const verbs = [
+    ["list", "show many"],
+    ["show", "show one"],
+    ["search", "find by text; the description says where it looks"],
+    ["related", "what is nearest in meaning to one thing, without a query"],
+    ["info", "facts about a singular thing itself: where it is, its size, its version, its schema"],
+    ["status", "how a thing stands right now"],
+    ["check", "verify, and change nothing; the answer says what is wrong and how to fix it"],
+    ["test", "run rules over what is already stored and say what they would have done, doing none of it"],
+    ["pause", "stop what a running process does for a profile, without stopping the process"],
+    ["resume", "restart what pause stopped"],
+    ["create", "make a thing"],
+    ["delete", "destroy a thing"],
+    ["add", "put an existing thing into a set"],
+    ["remove", "take a thing out of a set"],
+    ["clear", "empty a set"],
+    ["update", "change a thing's fields"],
+    ["set", "set one named key"],
+    ["unset", "remove one named key"],
+    ["rename", "change a thing's name only"],
+    ["start", "start a running process, or a login session"],
+    ["stop", "stop a running process"],
+    ["restart", "stop and start a running process"],
+    ["end", "end a login session"],
+    ["install", "install a system unit"],
+    ["uninstall", "remove a system unit"],
+    ["cancel", "stop a job or a pending thing"],
+    [
+        "sync",
+        "bring the local store up to date from the source: only what changed, or the whole list where the source cannot say",
+    ],
+    ["fetch", "one bounded pull of one named thing into the store, not a catch-up"],
+    ["export", "write from the store to a file"],
+    ["import", "bring a file or list the user gives into the store or the messenger, once"],
+    ["download", "save a file from the source to this machine"],
+    ["transcribe", "turn speech into text"],
+    ["extract", "read the text inside files already on this machine into the store"],
+    ["migrate", "bring a file up to this build's schema"],
+    ["backup", "copy a file somewhere safe"],
+    ["restore", "put a backup back in its place"],
+    ["repair", "bring a file's tables to this build's shape without deleting anything"],
+    ["link", "record that two identities are one person"],
+    ["unlink", "undo a link"],
+    ["lookup", "ask the messenger who is behind a phone number"],
+    ["inspect", "look at a link without joining it"],
+    ["send", "send a message"],
+    ["edit", "change a sent message"],
+    ["forward", "send an existing message on to another chat"],
+    ["pin", "pin a message or chat"],
+    ["unpin", "unpin a message or chat"],
+    ["vote", "answer a poll"],
+    ["close", "close a thing that stays: a poll, a task"],
+    ["join", "join a chat"],
+    ["leave", "leave a chat"],
+    ["block", "block a person"],
+    ["unblock", "unblock a person"],
+    ["mark-read", "mark a chat read; the other person sees it"],
+    ["reset", "replace a thing; the old one stops working"],
+    ["moderate", "apply a chat's rules: delete what breaks them, act on who broke them"],
+    ["confirm", "the owner accepts what an agent proposed"],
+    ["reject", "the owner refuses what an agent proposed"],
+    ["move", "move a file in the source"],
+    ["copy", "copy a file in the source"],
+];
+const replaces = {
+    list: ["ls"],
+    show: ["get", "view"],
+    search: ["find", "query"],
+    delete: ["rm", "trash"],
+    create: ["mkdir"],
+    update: ["plan"],
+    set: ["configure"],
+    sync: ["refresh"],
+    check: ["audit", "preflight"],
+    status: ["readiness"],
+    confirm: ["accept", "approve"],
+    reject: ["decline", "deny"],
+};
+const collections = [
+    ["chats", "conversations in a messenger"],
+    ["contacts", "identities in a messenger's contact list"],
+    ["messages", "posts in a messenger chat, or emails"],
+    ["polls", "polls in a chat"],
+    ["reactions", "reactions to a message"],
+    ["recipients", "who a message goes to"],
+    ["replies", "the automatic replies of a profile"],
+    ["sends", "messages waiting to be sent, or sent by this tool"],
+    ["runs", "past runs of this tool"],
+    ["topics", "forum topics in a group"],
+    ["models", "local or remote models"],
+    ["tags", "labels the owner puts on things"],
+    ["searches", "the owner's saved searches"],
+    ["copies", "tables kept aside by a repair"],
+    ["attachments", "files of stored messages"],
+    ["tasks", "what waits on the owner"],
+    ["members", "people in a chat"],
+    ["admins", "administrators of a chat"],
+    ["tracking", "the chats whose member lists are fetched daily"],
+    ["documents", "files imported from Google Drive or Docs, or linked in a chat"],
+    ["notes", "text the owner writes, or files from a notes folder"],
+    ["projects", "the owner's work units with a task key"],
+    ["organizations", "companies, teams, families or communities"],
+    ["identities", "accounts of a person in one messenger or mailbox"],
+    ["facts", "what happened, with evidence"],
+    ["memories", "what an agent concluded, with evidence and scope"],
+    ["relationships", "confirmed or suggested links between people, organizations and projects"],
+];
+const singulars = [
+    ["session", "this tool's login"],
+    ["account", "the messenger or mail account behind a profile"],
+    ["config", "a profile's settings"],
+    ["server", "the long-running process of a profile"],
+    ["store", "the local SQLite database the tools share"],
+    ["skill", "the agent skill file of this tool"],
+    ["cache", "max's per-profile cache"],
+    ["flood", "what the messenger told this profile to hold off on"],
+];
+const views = [
+    ["logs", "the log of a running process"],
+    ["events", "what happened in a thing over time"],
+    ["scheduled", "what is scheduled to happen"],
+    ["context", "what surrounds one thing"],
+    ["path", "where a thing is on this machine"],
+    ["config", "the configuration a thing needs"],
+    ["history", "past uses of a thing"],
+    ["top", "a ranked view under stats"],
+    ["official", "the view the messenger itself computed, under stats"],
+];
+const roots = [
+    ["inbox", "what waits across every chat"],
+    ["review", "go through what needs the owner"],
+    ["watch", "follow new events as they come"],
+    ["serve", "the long-running process"],
+    ["doctor", "check this machine's setup"],
+    ["upgrade", "install a newer version of this tool"],
+    ["commands", "the command tree as data"],
+    ["complete", "shell completion"],
+    ["mcp", "the MCP server and its setup"],
+    ["bot", "the profile's bot account"],
+    ["stats", "statistics"],
+    ["search", "searches across resources"],
+];
+const flags = [
+    { name: "--limit", value: "<n>", type: "count", meaning: "how many items", unit: "items" },
+    { name: "--page", value: "<n>", type: "count", meaning: "which page, from 1, where the source has no cursor" },
+    {
+        name: "--page-size",
+        value: "<n>",
+        type: "count",
+        meaning: "how many items one request to the source asks for",
+        unit: "items",
+    },
+    { name: "--cursor", value: "<cursor>", type: "cursor", meaning: "continue from where the previous page ended" },
+    { name: "--before-id", value: "<id>", type: "id", meaning: "read what came before this message id" },
+    { name: "--after-id", value: "<id>", type: "id", meaning: "read what came after this message id" },
+    { name: "--before-time", value: "<time>", type: "time", meaning: "read what came before this time" },
+    { name: "--after-time", value: "<time>", type: "time", meaning: "read what came after this time" },
+    { name: "--since-time", value: "<time>", type: "time", meaning: "only what came since this time" },
+    { name: "--at-time", value: "<time>", type: "time", meaning: "do it at this time" },
+    { name: "--before-n", value: "<n>", type: "count", meaning: "how many messages before it", unit: "messages" },
+    { name: "--after-n", value: "<n>", type: "count", meaning: "how many messages after it", unit: "messages" },
+    { name: "--timeout", value: "<duration>", type: "duration", meaning: "give up after this long" },
+    { name: "--dry-run", type: "switch", meaning: "judge and plan; do nothing" },
+];
+/** The words every CLI on cli-base is judged against. Seeded from STANDARD's command-name rules and the glossary. */
+export const VOCABULARY = defineVocabulary({
+    verbs: verbs.map(([entry, meaning]) => ({
+        word: entry,
+        meaning,
+        ...(replaces[entry] ? { replaces: replaces[entry] } : {}),
+    })),
+    nouns: [
+        ...collections.map(([entry, meaning]) => ({ word: entry, meaning, kind: "collection" })),
+        ...singulars.map(([entry, meaning]) => ({ word: entry, meaning, kind: "singular" })),
+    ],
+    views: views.map(([entry, meaning]) => ({ word: entry, meaning })),
+    roots: roots.map(([entry, meaning]) => ({ word: entry, meaning })),
+    flags,
+});
+//# sourceMappingURL=vocabulary.js.map

package/dist/standards/vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.js","sourceRoot":"","sources":["../../src/standards/vocabulary.ts"],"names":[],"mappings":"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"}

package/dist/streams.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The line every machine mode depends on: **stdout carries data, stderr carries everything
+ * else.** Two functions and no formatting decisions — the renderer that chooses tables, colour
+ * and spinners is `CLI-5` and sits on top of this, never beside it.
+ */
+export interface Streams {
+    data: (text: string) => void;
+    diagnostic: (text: string) => void;
+    /**
+     * A line that replaces itself — a progress counter, and nothing else.
+     *
+     * It lives here rather than beside the renderer so that a test capturing streams captures this
+     * too: the invariant it could break is rule 3, and an output channel the machine-output test
+     * cannot see is exactly how that gets broken quietly. An empty string clears the line.
+     */
+    progress?: (text: string) => void;
+}
+export declare const processStreams: Streams;
+/** Collects both halves separately, so a test can assert nothing leaked across. */
+export declare const captureStreams: () => Streams & {
+    stdout: string[];
+    stderr: string[];
+};
+//# sourceMappingURL=streams.d.ts.map

package/dist/streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../src/streams.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAClC;AAED,eAAO,MAAM,cAAc,EAAE,OAY5B,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,cAAc,QAAO,OAAO,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAW/E,CAAA"}

package/dist/streams.js

@@ -0,0 +1,26 @@
+export const processStreams = {
+    data: (text) => {
+        process.stdout.write(`${text}\n`);
+    },
+    diagnostic: (text) => {
+        process.stderr.write(`${text}\n`);
+    },
+    progress: (text) => {
+        // Carriage return and no newline, so the next line overwrites this one. Padded to the width of
+        // what was there before, or the tail of a longer previous line is left on screen.
+        process.stderr.write(`\r${text.padEnd(72)}${text === "" ? "\r" : ""}`);
+    },
+};
+/** Collects both halves separately, so a test can assert nothing leaked across. */
+export const captureStreams = () => {
+    const stdout = [];
+    const stderr = [];
+    return {
+        stdout,
+        stderr,
+        data: (text) => stdout.push(text),
+        diagnostic: (text) => stderr.push(text),
+        progress: (text) => stderr.push(text),
+    };
+};
+//# sourceMappingURL=streams.js.map

package/dist/streams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.js","sourceRoot":"","sources":["../src/streams.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAA;IACnC,CAAC;IACD,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAA;IACnC,CAAC;IACD,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;QACjB,+FAA+F;QAC/F,kFAAkF;QAClF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACxE,CAAC;CACF,CAAA;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAqD,EAAE;IACnF,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,OAAO;QACL,MAAM;QACN,MAAM;QACN,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QACjC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QACvC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;KACtC,CAAA;AACH,CAAC,CAAA"}

package/dist/testing/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The seams a test needs, so that "no test touched the real machine" is a property of the code
+ * rather than a hope about every test remembering to opt out.
+ */
+export { brokenKeyring, memoryKeyring } from "../keyring.js";
+export { captureStreams } from "../streams.js";
+import type { MonotonicClock, SleepLike, WallClock } from "../time.js";
+export interface FakeClock {
+    clock: MonotonicClock;
+    now: WallClock;
+    sleep: SleepLike;
+    /** Every sleep asked for, in order, with the reason the caller gave. Nothing actually waits. */
+    waits: {
+        ms: number;
+        reason?: string;
+    }[];
+    advance(ms: number): void;
+}
+/**
+ * Time that never passes unless a test says so. A retry test that really sleeps 250 ms is a retry
+ * 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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEtE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,cAAc,CAAA;IACrB,GAAG,EAAE,SAAS,CAAA;IACd,KAAK,EAAE,SAAS,CAAA;IAChB,gGAAgG;IAChG,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACxC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,wBAAkB,SAiBvC,CAAA"}

package/dist/testing/index.js

@@ -0,0 +1,29 @@
+/**
+ * The seams a test needs, so that "no test touched the real machine" is a property of the code
+ * rather than a hope about every test remembering to opt out.
+ */
+export { brokenKeyring, memoryKeyring } from "../keyring.js";
+export { captureStreams } from "../streams.js";
+/**
+ * Time that never passes unless a test says so. A retry test that really sleeps 250 ms is a retry
+ * test nobody runs, so `sleep` resolves at once and records what it was asked for.
+ */
+export const fakeClock = (startMs = 0) => {
+    let elapsed = startMs;
+    const waits = [];
+    return {
+        waits,
+        clock: () => elapsed,
+        now: () => new Date(startMs + elapsed),
+        sleep: async (ms, signal, reason) => {
+            if (signal?.aborted)
+                throw new DOMException("The operation was aborted.", "AbortError");
+            waits.push(reason === undefined ? { ms } : { ms, reason });
+            elapsed += ms;
+        },
+        advance: (ms) => {
+            elapsed += ms;
+        },
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAa9C;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAO,GAAG,CAAC,EAAa,EAAE;IAClD,IAAI,OAAO,GAAG,OAAO,CAAA;IACrB,MAAM,KAAK,GAAsC,EAAE,CAAA;IAEnD,OAAO;QACL,KAAK;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO;QACpB,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACtC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAClC,IAAI,MAAM,EAAE,OAAO;gBAAE,MAAM,IAAI,YAAY,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAA;YACvF,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;YAC1D,OAAO,IAAI,EAAE,CAAA;QACf,CAAC;QACD,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE;YACd,OAAO,IAAI,EAAE,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/time.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The two clocks and the one timer core needs. All three are injectable, which is what makes
+ * timeout and backoff testable without anything actually waiting.
+ */
+/**
+ * Why the client is waiting. The real sleep ignores it; a test uses it to tell an attempt's
+ * deadline apart from a delay between attempts, which are the only two reasons core ever waits.
+ * Without it a test that records waits sees both and cannot assert on either.
+ */
+export type SleepReason = "timeout" | "retry";
+/** Rejects with an `AbortError` if the signal fires first, the way `fetch` does. */
+export type SleepLike = (ms: number, signal?: AbortSignal, reason?: SleepReason) => Promise<void>;
+/** Monotonic milliseconds. Durations come from here; a wall clock can step backwards. */
+export type MonotonicClock = () => number;
+/** Wall time. Timestamps that a person or another system will read come from here. */
+export type WallClock = () => Date;
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,CAAA;AAE7C,oFAAoF;AACpF,MAAM,MAAM,SAAS,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAEjG,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,MAAM,MAAM,CAAA;AAEzC,sFAAsF;AACtF,MAAM,MAAM,SAAS,GAAG,MAAM,IAAI,CAAA;AAElC,eAAO,MAAM,UAAU,QAAO,YAA4E,CAAA;AAE1G,eAAO,MAAM,SAAS,EAAE,SAgBpB,CAAA;AAEJ,eAAO,MAAM,SAAS,EAAE,cAAwC,CAAA;AAEhE,eAAO,MAAM,SAAS,EAAE,SAA4B,CAAA"}

package/dist/time.js

@@ -0,0 +1,19 @@
+/**
+ * The two clocks and the one timer core needs. All three are injectable, which is what makes
+ * timeout and backoff testable without anything actually waiting.
+ */
+export const abortError = () => new DOMException("The operation was aborted.", "AbortError");
+export const realSleep = (ms, signal) => new Promise((resolve, reject) => {
+    if (signal?.aborted) {
+        reject(abortError());
+        return;
+    }
+    const timer = setTimeout(resolve, ms);
+    signal?.addEventListener("abort", () => {
+        clearTimeout(timer);
+        reject(abortError());
+    }, { once: true });
+});
+export const monotonic = () => performance.now();
+export const wallClock = () => new Date();
+//# sourceMappingURL=time.js.map

package/dist/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAiB,EAAE,CAAC,IAAI,YAAY,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAA;AAE1G,MAAM,CAAC,MAAM,SAAS,GAAc,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CACjD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;IAC9B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;QACpB,OAAM;IACR,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IACrC,MAAM,EAAE,gBAAgB,CACtB,OAAO,EACP,GAAG,EAAE;QACH,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;IACtB,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAA;AACH,CAAC,CAAC,CAAA;AAEJ,MAAM,CAAC,MAAM,SAAS,GAAmB,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAA;AAEhE,MAAM,CAAC,MAAM,SAAS,GAAc,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAA"}

package/dist/update/index.d.ts

@@ -0,0 +1,76 @@
+export { executableEnvironment, executableOnPath } from "../executable.js";
+import * as v from "valibot";
+import type { FetchLike } from "../http/index.js";
+export type Installer = "pnpm" | "npm" | "bun" | "npx" | "checkout" | "unknown";
+/**
+ * Read from where the running file really lives — `realpath` of the script, not `which`: the
+ * command on `PATH` is a shim or a link, and only its target says who installed it. Paths measured
+ * on 2026-09-24 by installing into throwaway prefixes.
+ */
+export declare const installerOf: (scriptPath: string) => Installer;
+/** The argv that updates a global install, or `undefined` where there is nothing to run. */
+export declare const updateCommand: (installer: Installer, packageName: string) => string[] | undefined;
+/** Plain `x.y.z` only: a pre-release is never offered, so it never counts as newer. */
+export declare const isNewer: (candidate: string, current: string) => boolean;
+/** The `latest` version on npm, or `undefined` on any failure — a hint may never fail a command. */
+export declare const latestVersion: (packageName: string, fetch: FetchLike, { timeoutMs }?: {
+    timeoutMs?: number;
+}) => Promise<string | undefined>;
+export declare const CHECK_EVERY_MS: number;
+export interface NotifyContext {
+    /** `pretty`, `json` or `jsonl` — the line exists only for the first. */
+    format: string;
+    stderrIsTTY: boolean;
+    quiet: boolean;
+    /** The setting; `false` turns the check off. */
+    enabled: boolean;
+    installer: Installer;
+    env: Readonly<Record<string, string | undefined>>;
+    /** Extra variables that turn it off, for the CLI's own prefix: `MAX_NO_UPDATE_CHECK`. */
+    offVariables?: readonly string[];
+}
+/** Whether a person is at a terminal who could be told — the only case a check is worth making. */
+export declare const mayNotify: ({ format, stderrIsTTY, quiet, enabled, installer, env, offVariables, }: NotifyContext) => boolean;
+declare const updateState: v.ObjectSchema<{
+    readonly checkedAt: v.NumberSchema<undefined>;
+    readonly latest: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** When the skill hint (`cli-base/skill`) was last shown — the other daily notice kept in this file. */
+    readonly skillHintAt: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>;
+export type UpdateState = v.InferOutput<typeof updateState>;
+/** The file as it is, `checkedAt: 0` when it is missing or unreadable. */
+export declare const readNoticeState: (path: string) => UpdateState;
+/** What the last check found. A missing or unreadable file is "never checked", not an error. */
+export declare const readUpdateState: (path: string) => UpdateState | undefined;
+/**
+ * Merged into the file as it is at the moment of writing: the update notice reads before it asks
+ * npm and writes after, and the skill hint may have written in between.
+ */
+export declare const writeUpdateState: (path: string, state: Partial<UpdateState>) => void;
+export declare const checkIsDue: (state: UpdateState | undefined, now: number) => boolean;
+/** Resolve Windows shims from explicit PATH entries; cross-spawn quotes them through the trusted shell. */
+export declare const spawnPlan: ([command, ...args]: readonly string[], platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv, exists?: (path: string) => boolean) => {
+    file: string;
+    args: string[];
+    shell: boolean;
+};
+/** Runs the update and answers its exit code. stdout stays one result: the package manager's output goes to stderr. */
+export declare const runUpdate: (argv: readonly string[]) => number;
+export interface NoticeRequest extends NotifyContext {
+    /** The words the CLI was run with, to leave `update` and `complete` alone. */
+    argv: readonly string[];
+    packageName: string;
+    /** The command a person types: `braze`, `max`. */
+    command: string;
+    version: string;
+    /** Where the last answer from npm is kept — the CLI's state directory. */
+    statePath: string;
+    fetch: FetchLike;
+    now?: () => number;
+}
+/**
+ * The daily "a newer version exists" line, or `undefined`. Meant to be started beside the command
+ * and awaited after it, so asking npm costs the command nothing; any failure is silence.
+ */
+export declare const updateNotice: ({ argv, packageName, command, version, statePath, fetch, now, ...context }: NoticeRequest) => Promise<string | undefined>;
+//# sourceMappingURL=index.d.ts.map

package/dist/update/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/update/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAE1E,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,CAAA;AAE/E;;;;GAIG;AACH,eAAO,MAAM,WAAW,eAAgB,MAAM,KAAG,SAOhD,CAAA;AAED,4FAA4F;AAC5F,eAAO,MAAM,aAAa,cAAe,SAAS,eAAe,MAAM,KAAG,MAAM,EAAE,GAAG,SAYpF,CAAA;AAED,uFAAuF;AACvF,eAAO,MAAM,OAAO,cAAe,MAAM,WAAW,MAAM,KAAG,OAS5D,CAAA;AAED,oGAAoG;AACpG,eAAO,MAAM,aAAa,gBACX,MAAM,SACZ,SAAS,kBACM;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,KAC3C,OAAO,CAAC,MAAM,GAAG,SAAS,CAY5B,CAAA;AAED,eAAO,MAAM,cAAc,QAAsB,CAAA;AAEjD,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,OAAO,CAAA;IACpB,KAAK,EAAE,OAAO,CAAA;IACd,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,SAAS,CAAA;IACpB,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;IACjD,yFAAyF;IACzF,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACjC;AAED,mGAAmG;AACnG,eAAO,MAAM,SAAS,2EAQnB,aAAa,KAAG,OAQuB,CAAA;AAE1C,QAAA,MAAM,WAAW;;;IAGf,wGAAwG;;aAExG,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,WAAW,CAAC,CAAA;AAE3D,0EAA0E;AAC1E,eAAO,MAAM,eAAe,SAAU,MAAM,KAAG,WAM9C,CAAA;AAED,gGAAgG;AAChG,eAAO,MAAM,eAAe,SAAU,MAAM,KAAG,WAAW,GAAG,SAG5D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,SAAU,MAAM,SAAS,OAAO,CAAC,WAAW,CAAC,KAAG,IAM5E,CAAA;AAED,eAAO,MAAM,UAAU,UAAW,WAAW,GAAG,SAAS,OAAO,MAAM,KAAG,OACT,CAAA;AAEhE,2GAA2G;AAC3G,eAAO,MAAM,SAAS,uBACA,SAAS,MAAM,EAAE,aAC3B,MAAM,CAAC,QAAQ,QACpB,MAAM,CAAC,UAAU,WACd,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO;;;;CAC4D,CAAA;AAE/F,uHAAuH;AACvH,eAAO,MAAM,SAAS,SAAU,SAAS,MAAM,EAAE,KAAG,MASnD,CAAA;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,8EAA8E;IAC9E,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,SAAS,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,+EAStB,aAAa,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAsB5C,CAAA"}