@the-librarian/cli 1.0.0-rc.3

package/dist/prompt.d.ts

@@ -0,0 +1,46 @@
+import type { Readable, Writable } from "node:stream";
+export interface PromptTextOptions {
+    /** Value used when the user just hits enter (or in non-interactive mode). */
+    default?: string;
+    /** Don't echo the typed characters (used for the token). */
+    secret?: boolean;
+}
+/**
+ * The injectable prompt function. Given a fully-rendered question (the caller
+ * has already appended any `[default]` hint), it resolves the user's raw
+ * answer. `secret` lets a fake distinguish a token prompt if it wants to.
+ */
+export type PromptFn = (question: string, opts: {
+    secret: boolean;
+}) => Promise<string>;
+export interface Prompter {
+    selectHarnesses(available: HarnessChoice[]): Promise<string[]>;
+    promptText(question: string, opts?: PromptTextOptions): Promise<string>;
+}
+/** A pickable harness in the multi-select. */
+export interface HarnessChoice {
+    id: string;
+    label: string;
+}
+export interface PrompterOptions {
+    /** Inject a deterministic answer function (tests). Wins over streams. */
+    prompt?: PromptFn;
+    /** The stream questions are read from. Defaults to `process.stdin`. */
+    input?: Readable;
+    /** The stream prompts/labels are written to. Defaults to `process.stdout`. */
+    output?: Writable;
+    /**
+     * Force interactive vs non-interactive. Defaults to whether `input` is a
+     * TTY. Non-interactive never blocks on a read.
+     */
+    interactive?: boolean;
+}
+/** A clear, typed error thrown when a required value can't be obtained. */
+export declare class MissingValueError extends Error {
+    constructor(what: string);
+}
+/** Build a Prompter over the given options (defaults to the real stdio). */
+export declare function createPrompter(options?: PrompterOptions): Prompter;
+/** Map a multi-select answer string to the chosen harness ids. */
+export declare function resolveSelection(answer: string, available: HarnessChoice[]): string[];
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAExF,MAAM,WAAW,QAAQ;IACvB,eAAe,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACzE;AAED,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,uEAAuE;IACvE,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,2EAA2E;AAC3E,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,IAAI,EAAE,MAAM;CAIzB;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAqCtE;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAarF"}

package/dist/prompt.js

@@ -0,0 +1,115 @@
+// 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));
+    const ask = options.prompt ?? ((question, opts) => readLine(input, output, 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;
+        },
+    };
+}
+/** 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);
+}
+/** Read one line, optionally with the echo muted (secret entry). */
+function readLine(input, output, question, secret) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input,
+            output,
+            terminal: true,
+        });
+        if (secret) {
+            // Mute the echo: overwrite each keystroke so the token never renders.
+            const muteWrite = rl._writeToOutput;
+            rl._writeToOutput = (s) => {
+                if (s.includes("\n") || s.includes("\r")) {
+                    muteWrite?.call(rl, s);
+                }
+                // else: swallow the character so it isn't echoed.
+            };
+            if (question)
+                write(output, question);
+            rl.question("", (answer) => {
+                write(output, "\n");
+                rl.close();
+                resolve(answer);
+            });
+            return;
+        }
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer);
+        });
+    });
+}
+//# 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,25 @@
+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 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;AAI/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;CACrB;AAID;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,SAAS,CAAC,CAY7F;AAiHD,wBAAgB,KAAK,IAAI,MAAM,CAwB9B"}

package/dist/runtime.js

@@ -0,0 +1,169 @@
+// 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 { flagString, parseArgs } from "./parse-args.js";
+import { createPrompter, MissingValueError } from "./prompt.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 (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();
+    const outcome = await runInstall(positionals, { home: options.home, shell, prompter });
+    // 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);
+}
+async function runUninstallCommand(rest, options) {
+    const { positionals, flags } = parseArgs(rest);
+    const shell = options.shell ?? resolveShellFlag(flags);
+    const prompter = options.prompter ?? createPrompter();
+    const outcome = await runUninstall(positionals, { home: options.home, shell, prompter });
+    return outcome.failed.length > 0 ? errOut(outcome.output) : ok(outcome.output);
+}
+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);
+}
+// --- 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",
+        "  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"}

package/dist/semver.js

@@ -0,0 +1,98 @@
+// A tiny, dependency-light semver-ish comparison.
+//
+// We only need "is the installed version behind the latest release?" — not a
+// full spec-compliant semver implementation. This tolerates the prerelease
+// shapes the monorepo actually ships (`1.0.0`, `1.0.0-rc.2`, `v1.2.3`) and
+// degrades gracefully on anything it can't parse (returns 0 → "equal", so an
+// unparseable version is never reported as an update).
+//
+// Precedence rules (subset of semver §11):
+//   - numeric release fields compare numerically (1.2.0 < 1.10.0);
+//   - a version WITH a prerelease has LOWER precedence than the same version
+//     WITHOUT one (1.0.0-rc.1 < 1.0.0);
+//   - prerelease identifiers compare left-to-right; numeric identifiers
+//     compare numerically, others lexically, numeric < non-numeric.
+/** Strip a leading `v` and any build-metadata (`+…`) we don't compare on. */
+function parse(version) {
+    const trimmed = version.trim().replace(/^v/i, "");
+    if (!trimmed)
+        return null;
+    const [core, ...preParts] = trimmed.split("-");
+    // Drop build metadata (`+sha`) from the prerelease tail and the core.
+    const prerelease = preParts.join("-").split("+")[0] ?? "";
+    const coreNoBuild = (core ?? "").split("+")[0] ?? "";
+    const release = coreNoBuild.split(".").map((n) => Number.parseInt(n, 10));
+    if (release.length === 0 || release.some((n) => Number.isNaN(n)))
+        return null;
+    return {
+        release,
+        prerelease: prerelease.length > 0 ? prerelease.split(".") : [],
+    };
+}
+/**
+ * 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 function compareVersions(a, b) {
+    const pa = parse(a);
+    const pb = parse(b);
+    if (!pa || !pb)
+        return 0;
+    const len = Math.max(pa.release.length, pb.release.length);
+    for (let i = 0; i < len; i += 1) {
+        const da = pa.release[i] ?? 0;
+        const db = pb.release[i] ?? 0;
+        if (da !== db)
+            return da < db ? -1 : 1;
+    }
+    // Equal release fields → a version with a prerelease is LOWER than one
+    // without (1.0.0-rc.1 < 1.0.0).
+    const aPre = pa.prerelease.length > 0;
+    const bPre = pb.prerelease.length > 0;
+    if (aPre && !bPre)
+        return -1;
+    if (!aPre && bPre)
+        return 1;
+    if (!aPre && !bPre)
+        return 0;
+    return comparePrerelease(pa.prerelease, pb.prerelease);
+}
+function comparePrerelease(a, b) {
+    const len = Math.max(a.length, b.length);
+    for (let i = 0; i < len; i += 1) {
+        // A longer prerelease list (with all-else-equal prefixes) has higher
+        // precedence (rc.1 < rc.1.1).
+        if (i >= a.length)
+            return -1;
+        if (i >= b.length)
+            return 1;
+        const ai = a[i] ?? "";
+        const bi = b[i] ?? "";
+        const an = /^\d+$/.test(ai);
+        const bn = /^\d+$/.test(bi);
+        if (an && bn) {
+            const na = Number.parseInt(ai, 10);
+            const nb = Number.parseInt(bi, 10);
+            if (na !== nb)
+                return na < nb ? -1 : 1;
+            continue;
+        }
+        if (an !== bn)
+            return an ? -1 : 1; // numeric identifiers rank below alphanumeric
+        if (ai !== bi)
+            return ai < bi ? -1 : 1;
+    }
+    return 0;
+}
+/**
+ * True iff `installed` is strictly behind `latest`. Either side being unknown
+ * (empty / unparseable) yields `false` — the caller renders `?`, never a
+ * false "update available".
+ */
+export function isBehind(installed, latest) {
+    if (!installed || !latest)
+        return false;
+    return compareVersions(installed, latest) < 0;
+}
+//# sourceMappingURL=semver.js.map

package/dist/semver.js.map

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

package/dist/status.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Resolve the monorepo's latest release version (the tag, `v`-stripped), or
+ * `null` on ANY failure (offline, timeout, non-2xx, unparseable). Injectable
+ * so tests never hit the network.
+ */
+export type LatestFetcher = () => Promise<string | null>;
+/** Override the latest-version fetcher (tests inject a canned/failing one). */
+export declare function setLatestFetcher(next: LatestFetcher): void;
+/** Restore the default (network) latest-version fetcher (tests). */
+export declare function resetLatestFetcher(): void;
+/** The default fetcher, exported for direct use / testing of the GET itself. */
+export declare const fetchLatestVersion: LatestFetcher;
+/**
+ * Probe every harness in parallel and the latest version once, returning the
+ * rendered table. `home` is injectable for tests.
+ */
+export declare function status(home?: string): Promise<string>;
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AA0BzD,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAE1D;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,EAAE,aAAqC,CAAC;AAWvE;;;GAGG;AACH,wBAAsB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY3D"}

package/dist/status.js

@@ -0,0 +1,113 @@
+// `librarian status` — live-probe every harness and render a plain table.
+//
+// Columns: harness · installed · version · latest · update? · url.
+//   - installed/version come from each harness's live `detect()` (never a
+//     cached file — spec §9);
+//   - `latest` is the monorepo's latest GitHub release tag, fetched once and
+//     shared across rows;
+//   - `update?` is `yes`/`no`/`?` — `?` whenever the installed version or the
+//     latest version is unknown, so an offline run never lies;
+//   - `url` is the configured MCP URL (from `readConfig`), shown only when a
+//     harness is installed.
+//
+// The "latest" fetch is INJECTABLE (`setLatestFetcher`) and OFFLINE-TOLERANT:
+// any failure resolves to `null`, latest renders `unknown`, and `update?`
+// renders `?`. The CLI never crashes because GitHub was unreachable.
+import { readConfig } from "./config.js";
+import { allHarnesses } from "./harnesses/index.js";
+import { isBehind } from "./semver.js";
+/** GitHub releases API for the monorepo (latest published release). */
+const LATEST_RELEASE_URL = "https://api.github.com/repos/JimJafar/the-librarian/releases/latest";
+/** A short timeout so an unreachable network never hangs `status`. */
+const FETCH_TIMEOUT_MS = 3000;
+const defaultLatestFetcher = async () => {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    try {
+        const res = await fetch(LATEST_RELEASE_URL, {
+            redirect: "error",
+            signal: controller.signal,
+            headers: { Accept: "application/vnd.github+json" },
+        });
+        if (!res.ok)
+            return null;
+        const body = (await res.json());
+        const tag = typeof body.tag_name === "string" ? body.tag_name.trim() : "";
+        if (!tag)
+            return null;
+        return tag.replace(/^v/i, "");
+    }
+    catch {
+        // Offline, DNS failure, timeout, redirect, bad JSON — all → unknown.
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+};
+let latestFetcher = defaultLatestFetcher;
+/** Override the latest-version fetcher (tests inject a canned/failing one). */
+export function setLatestFetcher(next) {
+    latestFetcher = next;
+}
+/** Restore the default (network) latest-version fetcher (tests). */
+export function resetLatestFetcher() {
+    latestFetcher = defaultLatestFetcher;
+}
+/** The default fetcher, exported for direct use / testing of the GET itself. */
+export const fetchLatestVersion = () => latestFetcher();
+/**
+ * Probe every harness in parallel and the latest version once, returning the
+ * rendered table. `home` is injectable for tests.
+ */
+export async function status(home) {
+    const [detections, latest] = await Promise.all([
+        Promise.all(allHarnesses.map((h) => h.detect())),
+        fetchLatestVersion(),
+    ]);
+    const cfg = readConfig(home);
+    const mcpUrl = cfg?.mcpUrl ?? "";
+    const rows = allHarnesses.map((h, i) => toRow(h, detections[i] ?? { installed: false }, latest, mcpUrl));
+    return renderTable(rows, latest);
+}
+function toRow(harness, detect, latest, mcpUrl) {
+    const version = detect.version ?? "";
+    const update = !detect.installed
+        ? "no"
+        : !version || !latest
+            ? "?"
+            : isBehind(version, latest)
+                ? "yes"
+                : "no";
+    return {
+        harness: harness.displayName,
+        installed: detect.installed,
+        version: detect.installed ? version || "(unknown)" : "—",
+        latest: latest ?? "unknown",
+        update,
+        url: detect.installed ? mcpUrl || "—" : "—",
+    };
+}
+// --- plain-text table rendering (aligned, no table lib) ------------------
+const HEADERS = ["HARNESS", "INSTALLED", "VERSION", "LATEST", "UPDATE?", "URL"];
+function renderTable(rows, latest) {
+    const cells = rows.map((r) => [
+        r.harness,
+        r.installed ? "yes" : "no",
+        r.version,
+        r.latest,
+        r.update,
+        r.url,
+    ]);
+    const widths = HEADERS.map((h, col) => Math.max(h.length, ...cells.map((row) => (row[col] ?? "").length)));
+    const line = (parts) => parts
+        .map((part, col) => part.padEnd(widths[col] ?? part.length))
+        .join("  ")
+        .trimEnd();
+    const out = [line(HEADERS), ...cells.map(line)];
+    if (latest === null) {
+        out.push("", "latest version unknown (could not reach GitHub) — update column shows ?");
+    }
+    return out.join("\n");
+}
+//# sourceMappingURL=status.js.map