@the-librarian/cli 1.0.0-rc.21

package/dist/prompt.js

@@ -0,0 +1,165 @@
+// A tiny `node:readline`-based prompt layer, injectable for tests.
+//
+// Two surfaces:
+//   - `selectHarnesses(available)` — a numbered multi-select; the user types
+//     numbers (`1 3`), `all`, or `none`.
+//   - `promptText(question, opts)` — a single line; `secret` suppresses the
+//     echo (for the token).
+//
+// EVERYTHING is injectable so tests never touch a real TTY or stdin:
+//   - pass a `prompt` fn to answer questions deterministically, OR
+//   - pass `input`/`output` streams the readline reads from / writes to.
+// Non-interactive (no TTY, no injected prompt) NEVER hangs: `selectHarnesses`
+// falls back to "everything available", and `promptText` returns the default
+// (or throws a clear error when a required value has no default).
+import readline from "node:readline";
+/** A clear, typed error thrown when a required value can't be obtained. */
+export class MissingValueError extends Error {
+    constructor(what) {
+        super(`${what} is required but no value was provided (non-interactive run).`);
+        this.name = "MissingValueError";
+    }
+}
+/** Build a Prompter over the given options (defaults to the real stdio). */
+export function createPrompter(options = {}) {
+    const input = options.input ?? process.stdin;
+    const output = options.output ?? process.stdout;
+    const interactive = options.interactive ??
+        (options.prompt !== undefined ? true : Boolean(input.isTTY));
+    // ONE line reader (over ONE readline interface) for this prompter's whole
+    // lifetime. Created lazily on the first real prompt — so a non-interactive
+    // or injected-`prompt` run never opens stdin — and reused for EVERY question.
+    //
+    // The old code built a FRESH `createInterface` per question and `rl.close()`d
+    // it. Closing the first interface discarded the input buffered past its line,
+    // so a second read over a single shared stream (e.g. a piped
+    // `librarian install <<EOF`, where both answers arrive in one chunk) never
+    // saw its input and the read hung — `resolveConfig` then threw "required".
+    // `close()` (called from the command lifecycle) tears the reader down exactly
+    // once so the open readline doesn't keep the Node event loop alive.
+    let reader;
+    const lineReader = () => {
+        if (!reader)
+            reader = createLineReader(input, output);
+        return reader;
+    };
+    const ask = options.prompt ?? ((question, opts) => lineReader().ask(question, opts.secret));
+    return {
+        async selectHarnesses(available) {
+            if (available.length === 0)
+                return [];
+            if (!interactive && options.prompt === undefined) {
+                // No way to ask — default to every available harness.
+                return available.map((h) => h.id);
+            }
+            write(output, "Select harnesses to install:\n");
+            available.forEach((h, i) => write(output, `  ${i + 1}) ${h.label}\n`));
+            write(output, "Enter numbers (e.g. 1 3), 'all', or 'none' [all]: ");
+            const answer = (await ask("", { secret: false })).trim();
+            return resolveSelection(answer, available);
+        },
+        async promptText(question, opts = {}) {
+            const hasDefault = opts.default !== undefined;
+            if (!interactive && options.prompt === undefined) {
+                if (hasDefault)
+                    return opts.default;
+                throw new MissingValueError(question);
+            }
+            const hint = hasDefault && !opts.secret ? ` [${opts.default}]` : "";
+            const raw = (await ask(`${question}${hint}: `, { secret: Boolean(opts.secret) })).trim();
+            if (raw.length === 0 && hasDefault)
+                return opts.default;
+            if (raw.length === 0 && !hasDefault)
+                throw new MissingValueError(question);
+            return raw;
+        },
+        close() {
+            // Idempotent: only the shared reader (if one was ever opened) is torn
+            // down. An open readline keeps the Node event loop alive, so the command
+            // lifecycle MUST call this once prompting is done or the process hangs.
+            if (reader) {
+                reader.close();
+                reader = undefined;
+            }
+        },
+    };
+}
+/** Map a multi-select answer string to the chosen harness ids. */
+export function resolveSelection(answer, available) {
+    const normalized = answer.trim().toLowerCase();
+    if (normalized === "" || normalized === "all")
+        return available.map((h) => h.id);
+    if (normalized === "none")
+        return [];
+    const picked = new Set();
+    for (const token of normalized.split(/[\s,]+/).filter(Boolean)) {
+        const n = Number.parseInt(token, 10);
+        if (Number.isInteger(n) && n >= 1 && n <= available.length) {
+            const choice = available[n - 1];
+            if (choice)
+                picked.add(choice.id);
+        }
+    }
+    return available.filter((h) => picked.has(h.id)).map((h) => h.id);
+}
+// --- readline plumbing ---------------------------------------------------
+function write(output, text) {
+    output.write(text);
+}
+function createLineReader(input, output) {
+    const rl = readline.createInterface({ input, output, terminal: true });
+    const queue = [];
+    let waiting = null;
+    rl.on("line", (line) => {
+        if (waiting) {
+            const resolve = waiting;
+            waiting = null;
+            resolve(line);
+        }
+        else {
+            queue.push(line);
+        }
+    });
+    // The original echo writer; restored after each secret question so a later
+    // non-secret prompt renders normally. Typed to allow `undefined` so the
+    // restore assignment is sound under `exactOptionalPropertyTypes`.
+    const ref = rl;
+    const nextLine = () => new Promise((resolve) => {
+        const queued = queue.shift();
+        if (queued !== undefined)
+            resolve(queued);
+        else
+            waiting = resolve;
+    });
+    return {
+        async ask(question, secret) {
+            if (!secret) {
+                if (question)
+                    write(output, question);
+                return nextLine();
+            }
+            // Mute the echo just for this question: swallow each typed character so
+            // the token never renders, passing only newlines through. Restore the
+            // original writer afterwards so a following non-secret prompt echoes.
+            const original = ref._writeToOutput;
+            ref._writeToOutput = (s) => {
+                if (s.includes("\n") || s.includes("\r"))
+                    original?.call(rl, s);
+            };
+            try {
+                if (question)
+                    write(output, question);
+                const line = await nextLine();
+                return line;
+            }
+            finally {
+                ref._writeToOutput = original;
+                write(output, "\n");
+            }
+        },
+        close() {
+            rl.close();
+        },
+    };
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,45 @@
+import { type Shell } from "./env.js";
+import { type Prompter } from "./prompt.js";
+export interface CliResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface RuntimeOptions {
+    /** Override the home dir (tests). Defaults to the real `os.homedir()`. */
+    home?: string;
+    /** Override the detected shell (tests / `--shell`). */
+    shell?: Shell;
+    /** Inject a prompter (tests). Defaults to a real stdio-backed prompter. */
+    prompter?: Prompter;
+    /**
+     * The process environment to read existing `LIBRARIAN_*` vars from (BUG 2).
+     * Injectable so tests never touch the real `process.env` and never log a
+     * token. Defaults to `process.env` in `runInstall`.
+     */
+    env?: NodeJS.ProcessEnv;
+    /**
+     * Whether the run is interactive (a TTY is attached). Gates `server up`'s
+     * best-effort offers (the Tailscale offer; the `0.0.0.0` confirm). Defaults
+     * to `process.stdin.isTTY` — a non-interactive run never silently exposes the
+     * server beyond localhost (it keeps `127.0.0.1`). Injectable for tests.
+     */
+    interactive?: boolean;
+    /**
+     * The host platform, defaulting to `process.platform`. Threads into the
+     * `server` ops that branch on it: preflight's daemon hint and boot
+     * persistence (Linux systemd vs the macOS deferred notice). Injectable so the
+     * darwin path is testable from a Linux host.
+     */
+    platform?: NodeJS.Platform;
+}
+/**
+ * The CLI entrypoint. Dispatches to the command handlers and — crucially —
+ * turns any escaped error into one clean stderr line + exit 1, so a failure
+ * never leaks a stack trace into the user's terminal (house rule: "never
+ * leak a stack trace"). `MissingValueError` (a required prompt with no value
+ * in a non-interactive run) gets a specific, actionable message.
+ */
+export declare function runCli(argv: string[], options?: RuntimeOptions): Promise<CliResult>;
+export declare function usage(): string;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAGnD,OAAO,EAAqC,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAY/E,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC5B;AAID;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,CAY7F;AAgUD,wBAAgB,KAAK,IAAI,MAAM,CAyB9B"}

package/dist/runtime.js

@@ -0,0 +1,370 @@
+// The `librarian` CLI runtime — an async function over argv.
+//
+// `runCli(argv, options)` resolves to `{ stdout, stderr, exitCode }` so the
+// bin entry shapes it into a real process exit and tests assert against
+// captured output without spawning a subprocess. Everything that touches the
+// system is injectable through `options`: `home` (temp dir), `shell`, a
+// `prompter` (prompt answers), and the per-module seams the commands pull in
+// (`setRunner` / `setHomeOverride` / `setAdapterFetcher` / `setLatestFetcher`
+// / `setServerProbe`). NOTHING here touches the real system, network, or
+// stdin in tests.
+import { runInstall } from "./commands/install.js";
+import { runUninstall } from "./commands/uninstall.js";
+import { runUpdate } from "./commands/update.js";
+import { formatConfig, readConfig, redact, setConfig } from "./config.js";
+import { doctor } from "./doctor.js";
+import { detectShell } from "./env.js";
+import { allHarnesses } from "./harnesses/index.js";
+import { flagBool, flagString, parseArgs } from "./parse-args.js";
+import { createPrompter, MissingValueError } from "./prompt.js";
+import { runAdmin } from "./server/admin.js";
+import { disableBoot, enableBoot } from "./server/boot.js";
+import { runDown } from "./server/down.js";
+import { serverUsage } from "./server/index.js";
+import { runLogs } from "./server/logs.js";
+import { serverStatus } from "./server/status.js";
+import { runUp } from "./server/up.js";
+import { runUpdate as runServerUpdate } from "./server/update.js";
+import { status } from "./status.js";
+import { cliVersion } from "./version.js";
+const PHASE_2_STUBS = new Set(["report", "self-update"]);
+/**
+ * The CLI entrypoint. Dispatches to the command handlers and — crucially —
+ * turns any escaped error into one clean stderr line + exit 1, so a failure
+ * never leaks a stack trace into the user's terminal (house rule: "never
+ * leak a stack trace"). `MissingValueError` (a required prompt with no value
+ * in a non-interactive run) gets a specific, actionable message.
+ */
+export async function runCli(argv, options = {}) {
+    try {
+        return await dispatch(argv, options);
+    }
+    catch (error) {
+        if (error instanceof MissingValueError) {
+            return err("MCP URL and token are required — re-run interactively, or pass --mcp-url/--token.");
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return err(`librarian: ${message}`);
+    }
+}
+async function dispatch(argv, options) {
+    const [command, ...rest] = argv;
+    if (!command || command === "--help" || command === "-h" || command === "help") {
+        return ok(usage());
+    }
+    if (command === "--version" || command === "-v" || command === "version") {
+        return ok(cliVersion());
+    }
+    if (command === "config") {
+        return runConfig(rest, options);
+    }
+    if (command === "install") {
+        return runInstallCommand(rest, options);
+    }
+    if (command === "uninstall") {
+        return runUninstallCommand(rest, options);
+    }
+    if (command === "update") {
+        return runUpdateCommand(rest, options);
+    }
+    if (command === "status") {
+        return ok(await status(options.home));
+    }
+    if (command === "doctor") {
+        // Diagnostic: exits 0 even when it flags problems.
+        return ok(await doctor(options.home));
+    }
+    if (command === "server") {
+        return runServerCommand(rest, options);
+    }
+    if (PHASE_2_STUBS.has(command)) {
+        return runPhase2Stub(command);
+    }
+    return err(`Unknown command: ${command}\n\n${usage()}`);
+}
+// --- config (fully implemented) ------------------------------------------
+function runConfig(rest, options) {
+    const { flags } = parseArgs(rest);
+    const mcpUrl = flagString(flags["mcp-url"]) ?? flagString(flags.url);
+    const token = flagString(flags.token);
+    const shell = options.shell ?? resolveShellFlag(flags);
+    const wantsSet = mcpUrl !== undefined || token !== undefined;
+    if (wantsSet) {
+        const updated = setConfig({ mcpUrl, token }, { home: options.home, shell });
+        // Confirm what changed WITHOUT echoing the token.
+        return ok(["Updated config.", "", formatConfig(redact(updated))].join("\n"));
+    }
+    const current = readConfig(options.home);
+    if (!current) {
+        return ok([
+            "No config set yet.",
+            "",
+            "Set it with:",
+            "  librarian config --mcp-url <url> --token <token>",
+        ].join("\n"));
+    }
+    return ok(formatConfig(redact(current)));
+}
+function resolveShellFlag(flags) {
+    const raw = flagString(flags.shell);
+    if (!raw)
+        return undefined;
+    return detectShell(raw);
+}
+// --- harness-touching commands -------------------------------------------
+async function runInstallCommand(rest, options) {
+    const { positionals, flags } = parseArgs(rest);
+    const shell = options.shell ?? resolveShellFlag(flags);
+    const prompter = options.prompter ?? createPrompter();
+    try {
+        const outcome = await runInstall(positionals, {
+            home: options.home,
+            shell,
+            prompter,
+            env: options.env,
+        });
+        // A mid-install failure makes the command non-zero so scripts notice; a
+        // pure skip (CLI absent) is a success.
+        return outcome.failed.length > 0 ? errOut(outcome.output) : ok(outcome.output);
+    }
+    finally {
+        // Tear down the shared readline (BUG 1) so an open interface doesn't keep
+        // the event loop alive and hang the process after the command completes.
+        prompter.close();
+    }
+}
+async function runUninstallCommand(rest, options) {
+    const { positionals, flags } = parseArgs(rest);
+    const shell = options.shell ?? resolveShellFlag(flags);
+    const prompter = options.prompter ?? createPrompter();
+    try {
+        const outcome = await runUninstall(positionals, { home: options.home, shell, prompter });
+        return outcome.failed.length > 0 ? errOut(outcome.output) : ok(outcome.output);
+    }
+    finally {
+        prompter.close();
+    }
+}
+async function runUpdateCommand(rest, options) {
+    const { positionals } = parseArgs(rest);
+    const outcome = await runUpdate(positionals, { home: options.home });
+    return outcome.failed.length > 0 ? errOut(outcome.output) : ok(outcome.output);
+}
+// --- server command group (self-host) ------------------------------------
+/**
+ * `librarian server [subcommand]`. With no subcommand (or `--help`/`-h`) it
+ * prints the command surface (§4). Implemented: `up` (S2/S3), `down` / `logs` /
+ * `status` (S4), `update` (S5), `enable-boot` / `disable-boot` (S6), `admin`
+ * (S7a). An unknown subcommand errors with the surface. Preflight + the
+ * `docker.ts` seam (S1) back every container op.
+ */
+async function runServerCommand(rest, options) {
+    const [subcommand, ...subRest] = rest;
+    if (!subcommand || subcommand === "--help" || subcommand === "-h") {
+        return ok(serverUsage());
+    }
+    if (subcommand === "up") {
+        return runServerUpCommand(subRest, options);
+    }
+    if (subcommand === "update") {
+        return runServerUpdateCommand(subRest, options);
+    }
+    if (subcommand === "down") {
+        return runServerDownCommand();
+    }
+    if (subcommand === "logs") {
+        return runServerLogsCommand(subRest);
+    }
+    if (subcommand === "status") {
+        return runServerStatusCommand(subRest, options);
+    }
+    if (subcommand === "enable-boot") {
+        return runServerEnableBootCommand(options);
+    }
+    if (subcommand === "disable-boot") {
+        return runServerDisableBootCommand(options);
+    }
+    if (subcommand === "admin") {
+        return runServerAdminCommand(subRest, options);
+    }
+    return err(`Unknown server subcommand: ${subcommand}\n\n${serverUsage()}`);
+}
+/**
+ * `librarian server up [flags]` (S2, localhost path). Parses the flags, builds
+ * a prompter (for the loop-closer env offer), and runs the orchestrated flow.
+ * A failure surfaces as one clean stderr line via the top-level catch — no
+ * stack trace, and the master key (carried only on the success stdout) never
+ * reaches an error path.
+ */
+async function runServerUpCommand(rest, options) {
+    const { flags } = parseArgs(rest);
+    const prompter = options.prompter ?? createPrompter();
+    // Interactivity gates the best-effort offers (Tailscale; the `0.0.0.0`
+    // confirm). Explicit override wins; otherwise a TTY means interactive. A
+    // non-interactive run never silently exposes the server beyond localhost.
+    const interactive = options.interactive ?? Boolean(process.stdin.isTTY);
+    try {
+        const result = await runUp({
+            ref: flagString(flags.ref),
+            dir: flagString(flags.dir),
+            host: flagString(flags.host),
+            dataVolume: flagString(flags["data-volume"]),
+            enableBoot: flagBool(flags["enable-boot"]),
+            yes: flagBool(flags.yes),
+        }, {
+            home: options.home,
+            prompter,
+            interactive,
+            ...(options.platform ? { platform: options.platform } : {}),
+        });
+        return ok(result.output);
+    }
+    finally {
+        prompter.close();
+    }
+}
+/**
+ * `librarian server enable-boot` (S6). On Linux, installs + enables the systemd
+ * unit that starts the existing named container on boot (the unit references the
+ * container by name and carries NO secret). On macOS, prints the deferred notice
+ * and exits 0 (NOT an error). A real failure surfaces as one clean stderr line.
+ */
+async function runServerEnableBootCommand(options) {
+    const result = await enableBoot(options.platform ? { platform: options.platform } : {});
+    return ok(result.output);
+}
+/**
+ * `librarian server disable-boot` (S6). On Linux, disables + removes the systemd
+ * unit and reloads systemd; safe if already disabled/absent (a teaching message,
+ * no crash). On macOS, prints the deferred notice and exits 0.
+ */
+async function runServerDisableBootCommand(options) {
+    const result = await disableBoot(options.platform ? { platform: options.platform } : {});
+    return ok(result.output);
+}
+/**
+ * `librarian server admin <backup|restore|auth|rebuild> [args…]` (S7a). Runs a
+ * curated admin verb inside the running container via
+ * `docker exec [-it] the-librarian the-librarian <verb> [args…]` (spec §7). The
+ * args are passed through VERBATIM — so we do NOT run them through `parseArgs`
+ * (that would reorder/strip flags); the in-container CLI parses them. An
+ * interactive run adds `-it` so the CLI can prompt (e.g. `restore`'s
+ * `--secret-key`). A rejected verb or a down container surfaces as one clean
+ * stderr line via the top-level catch, with no `docker exec`.
+ */
+async function runServerAdminCommand(subRest, options) {
+    const interactive = options.interactive ?? Boolean(process.stdin.isTTY);
+    const result = await runAdmin(subRest, {
+        interactive,
+        ...(options.platform ? { platform: options.platform } : {}),
+    });
+    return ok(result.output);
+}
+/**
+ * `librarian server update [--ref <tag|main>] [--yes]` (S5). Re-pins the deploy
+ * dir to the resolved ref, rebuilds the image, recreates the container
+ * (PRESERVING the data volume), waits for health (rolling back on failure), and
+ * applies pending data-dir migrations. Idempotent: already at the ref + healthy
+ * → a clean no-op. The agent token is reused from the running container (clients
+ * keep working) and never reaches an error path or a file. A failure surfaces as
+ * one clean stderr line via the top-level catch (already secret-redacted).
+ */
+async function runServerUpdateCommand(rest, options) {
+    const { flags } = parseArgs(rest);
+    const result = await runServerUpdate({
+        ref: flagString(flags.ref),
+        dir: flagString(flags.dir),
+        yes: flagBool(flags.yes),
+        home: options.home,
+    });
+    return ok(result.output);
+}
+/**
+ * `librarian server down` (S4). Stops the container — DATA SACRED (it issues
+ * only `docker stop`, never any `rm`/volume op). A not-running container is a
+ * friendly success; a real failure surfaces via the top-level catch as one
+ * clean stderr line. No flags today.
+ */
+async function runServerDownCommand() {
+    const result = await runDown({});
+    return ok(result.output);
+}
+/**
+ * `librarian server logs [-f] [--service mcp|dashboard|all]` (S4). `-f` is a
+ * short flag the tiny parser treats as a positional, so we accept it there (or
+ * `--follow`). `--service` selects which of the two co-located services to show
+ * (filtered from the combined stream). A bad `--service` value is a teaching
+ * error via the top-level catch.
+ *
+ * A FOLLOW (`-f`) streams its lines straight to `process.stdout` LIVE inside
+ * `runLogs` (a tail never closes on its own — buffering it to return here is the
+ * old hang), so there's no captured `output` to print; we just propagate the
+ * followed process's exit code. The one-shot path returns its captured output.
+ */
+async function runServerLogsCommand(rest) {
+    const { positionals, flags } = parseArgs(rest);
+    const follow = positionals.includes("-f") || flagBool(flags.follow) || flagBool(flags.f);
+    const result = await runLogs({ follow, service: flagString(flags.service) });
+    if (follow) {
+        // Lines already streamed live; pass through the follow's exit code.
+        return { stdout: "", stderr: "", exitCode: result.exitCode ?? 0 };
+    }
+    return ok(result.output);
+}
+/**
+ * `librarian server status` (S4). Reports running/health (from `docker inspect`)
+ * and the deployed-vs-latest badge (deploy-state ref vs `fetchLatestVersion`).
+ * Offline/unknown degrades to `unknown`/`?` and still exits 0 — only a missing
+ * docker (preflight) makes it non-zero, via the top-level catch.
+ */
+async function runServerStatusCommand(rest, options) {
+    const { flags } = parseArgs(rest);
+    const result = await serverStatus({ home: options.home, dir: flagString(flags.dir) });
+    return ok(result.output);
+}
+// --- Phase 2 stubs (friendly "coming later") -----------------------------
+function runPhase2Stub(command) {
+    const detail = command === "report"
+        ? "Server reporting (the dashboard's Installs view) arrives in a later release."
+        : "Self-update of the CLI arrives in a later release. For now: `npm i -g @the-librarian/cli`.";
+    return ok(`librarian ${command}: coming in a later release.\n\n${detail}`);
+}
+// --- usage ---------------------------------------------------------------
+export function usage() {
+    const harnesses = allHarnesses.map((h) => h.id).join(", ");
+    return [
+        "Usage: librarian <command> [harness…] [flags]",
+        "",
+        "Commands:",
+        "  install   [harness…]   Install The Librarian into one or more harnesses",
+        "  uninstall [harness…]   Remove The Librarian from one or more harnesses",
+        "  update    [harness…]   Update the integration to the current version",
+        "  status                 Live table of harness / installed / version",
+        "  doctor                 Diagnose token, server reachability, harness CLIs",
+        "  config                 Show or set MCP URL, token, server URL",
+        "  server                 Self-host the Librarian server (run `server` for its commands)",
+        "  self-update            Update the librarian CLI itself",
+        "  report                 Push this machine's state to the server",
+        "",
+        "Flags:",
+        "  --mcp-url <url>        config: set the MCP endpoint URL",
+        "  --token <token>        config: set the bearer token (never printed)",
+        "  --shell <bash|zsh|fish>  override shell detection for the rc block",
+        "  -h, --help            Show this help",
+        "  -v, --version         Show the CLI version",
+        "",
+        `Harnesses: ${harnesses}`,
+    ].join("\n");
+}
+// --- result helpers ------------------------------------------------------
+function ok(stdout) {
+    return { stdout, stderr: "", exitCode: 0 };
+}
+function err(stderr) {
+    return { stdout: "", stderr, exitCode: 1 };
+}
+/** A non-zero result that still carries its (already-formatted) report on stdout. */
+function errOut(stdout) {
+    return { stdout, stderr: "", exitCode: 1 };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/semver.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Compare two version strings. Returns <0 if `a` precedes `b`, >0 if `a`
+ * follows `b`, 0 if equal or either is unparseable (so an unknown version
+ * never reads as "behind").
+ */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * True iff `installed` is strictly behind `latest`. Either side being unknown
+ * (empty / unparseable) yields `false` — the caller renders `?`, never a
+ * false "update available".
+ */
+export declare function isBehind(installed: string, latest: string): boolean;
+//# sourceMappingURL=semver.d.ts.map

package/dist/semver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.d.ts","sourceRoot":"","sources":["../src/semver.ts"],"names":[],"mappings":"AAoCA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAqB5D;AAyBD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAGnE"}