@the-librarian/cli 1.0.0-rc.3

package/dist/harnesses/claude.js

@@ -0,0 +1,88 @@
+// Claude Code harness.
+//
+// Drives the `claude` CLI's native plugin/marketplace commands — we never
+// hand-edit Claude config. The marketplace is `JimJafar/the-librarian`;
+// the plugin is `the-librarian@the-librarian` (name@marketplace).
+//
+//   detect    `claude` on PATH AND `claude plugin list` shows our plugin
+//   install   `claude plugin marketplace add JimJafar/the-librarian`
+//             then `claude plugin install the-librarian@the-librarian`
+//   uninstall `claude plugin remove the-librarian@the-librarian`
+//             then `claude plugin marketplace remove the-librarian`
+//   update    re-run install (idempotent; pulls the current version)
+//
+// The token plays no part here — Claude's MCP auth is configured by the
+// plugin itself — so nothing token-shaped is ever passed or logged.
+import { run, which } from "../exec.js";
+const CLI = "claude";
+const MARKETPLACE = "JimJafar/the-librarian";
+const MARKETPLACE_ID = "the-librarian";
+const PLUGIN = "the-librarian@the-librarian";
+const PLUGIN_NAME = "the-librarian";
+/** Friendly error when the harness CLI isn't installed. */
+function notFound() {
+    return new Error("Claude Code CLI not found on PATH (expected `claude`).");
+}
+/**
+ * Pull our plugin's version out of `claude plugin list` output, which
+ * formats loosely across versions. We look for a line mentioning the
+ * plugin and a trailing semver-ish token; absence is `undefined`.
+ */
+function parsePluginVersion(listOutput) {
+    for (const line of listOutput.split("\n")) {
+        if (!line.includes(PLUGIN_NAME))
+            continue;
+        const m = /\bv?(\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?)\b/.exec(line);
+        if (m?.[1])
+            return m[1];
+    }
+    return undefined;
+}
+/** True iff `claude plugin list` output shows our plugin as present. */
+function pluginListed(listOutput) {
+    return listOutput.split("\n").some((line) => line.includes(PLUGIN_NAME));
+}
+export const claude = {
+    id: "claude",
+    displayName: "Claude Code",
+    async detect() {
+        if (!(await which(CLI)))
+            return { installed: false };
+        const { stdout, code } = await run(CLI, ["plugin", "list"]);
+        if (code !== 0 || !pluginListed(stdout))
+            return { installed: false };
+        const version = parsePluginVersion(stdout);
+        return version === undefined ? { installed: true } : { installed: true, version };
+    },
+    async install(_cfg) {
+        if (!(await which(CLI)))
+            throw notFound();
+        // marketplace add is idempotent in the CLI; installing again is a no-op
+        // re-resolve, so a second `install` neither errors nor duplicates.
+        const add = await run(CLI, ["plugin", "marketplace", "add", MARKETPLACE]);
+        if (add.code !== 0) {
+            throw new Error(`claude plugin marketplace add failed: ${oneLine(add.stderr || add.stdout)}`);
+        }
+        const install = await run(CLI, ["plugin", "install", PLUGIN]);
+        if (install.code !== 0) {
+            throw new Error(`claude plugin install failed: ${oneLine(install.stderr || install.stdout)}`);
+        }
+    },
+    async uninstall() {
+        if (!(await which(CLI)))
+            return; // nothing to remove if the CLI is gone
+        // Removing an absent plugin / marketplace is a no-op; we don't fail the
+        // uninstall on a "not installed" exit, only surface genuine errors.
+        await run(CLI, ["plugin", "remove", PLUGIN]);
+        await run(CLI, ["plugin", "marketplace", "remove", MARKETPLACE_ID]);
+    },
+    async update(cfg) {
+        // Re-running install pulls the marketplace's current version.
+        await this.install(cfg);
+    },
+};
+/** Collapse multi-line CLI error text to a single tidy line. */
+function oneLine(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=claude.js.map

package/dist/harnesses/claude.js.map

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

package/dist/harnesses/cli.d.ts

@@ -0,0 +1,4 @@
+import type { HarnessId } from "./types.js";
+/** Harness id → the native CLI binary it drives, or `null` if file-based. */
+export declare const HARNESS_CLI: Record<HarnessId, string | null>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/harnesses/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/harnesses/cli.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,6EAA6E;AAC7E,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAMxD,CAAC"}

package/dist/harnesses/cli.js

@@ -0,0 +1,16 @@
+// Which native CLI binary (if any) each harness drives.
+//
+// The `HarnessModule` interface deliberately doesn't expose this — the
+// modules are thin and uniform. But the orchestration layer needs it for two
+// things: choosing the default install set (harnesses whose CLI is on PATH)
+// and the `doctor` report ("which harness CLIs are present?"). File-based
+// harnesses (opencode, hermes) have no CLI gate, so they map to `null`.
+/** Harness id → the native CLI binary it drives, or `null` if file-based. */
+export const HARNESS_CLI = {
+    claude: "claude",
+    codex: "codex",
+    opencode: null,
+    hermes: null,
+    pi: "pi",
+};
+//# sourceMappingURL=cli.js.map

package/dist/harnesses/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/harnesses/cli.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,uEAAuE;AACvE,6EAA6E;AAC7E,4EAA4E;AAC5E,0EAA0E;AAC1E,wEAAwE;AAIxE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAqC;IAC3D,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;IACZ,EAAE,EAAE,IAAI;CACT,CAAC"}

package/dist/harnesses/codex.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessModule } from "./types.js";
+export declare const codex: HarnessModule;
+//# sourceMappingURL=codex.d.ts.map

package/dist/harnesses/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/harnesses/codex.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAC;AA6F/D,eAAO,MAAM,KAAK,EAAE,aAuDnB,CAAC"}

package/dist/harnesses/codex.js

@@ -0,0 +1,183 @@
+// Codex harness.
+//
+// Prefers the native `codex` CLI; falls back to editing the config file
+// directly only when `codex` isn't on PATH but the config is still
+// writable (so a partial Codex setup can still be wired up).
+//
+//   detect    `~/.codex/config.toml` has a `[mcp_servers.librarian]` table
+//   install   `codex mcp add librarian --url <U>
+//                 --bearer-token-env-var LIBRARIAN_AGENT_TOKEN`
+//             (fallback: write the table into config.toml)
+//   uninstall `codex mcp remove librarian` (fallback: strip the table)
+//   update    re-run install (idempotent)
+//
+// Token handling (spec §9): the token's *value* never enters config or the
+// command line. Codex stores only the env-var NAME `LIBRARIAN_AGENT_TOKEN`;
+// it resolves the value at request time. We pass `cfg.mcpUrl` (not the
+// token) on the CLI, so nothing secret is ever logged.
+import fs from "node:fs";
+import path from "node:path";
+import { run, which } from "../exec.js";
+import { codexConfigPath } from "../paths.js";
+const CLI = "codex";
+const SERVER_ID = "librarian";
+const TOKEN_ENV_VAR = "LIBRARIAN_AGENT_TOKEN";
+const TABLE_HEADER = "[mcp_servers.librarian]";
+// The config-shape version we stamp, so detect can report something even
+// though TOML carries no native version for an MCP entry.
+const CONFIG_VERSION = "1";
+const VERSION_MARKER = "# librarian-config-version =";
+/** Read config.toml, or "" if it doesn't exist yet. */
+function readConfig() {
+    try {
+        return fs.readFileSync(codexConfigPath(), "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+/** True iff the config text already declares our MCP server table. */
+function hasTable(config) {
+    return config.split("\n").some((line) => line.trim() === TABLE_HEADER);
+}
+/** Parse the stamped config-shape version from a managed comment, if any. */
+function parseConfigVersion(config) {
+    for (const line of config.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith(VERSION_MARKER)) {
+            const v = trimmed
+                .slice(VERSION_MARKER.length)
+                .trim()
+                .replace(/^["']|["']$/g, "");
+            if (v)
+                return v;
+        }
+    }
+    return undefined;
+}
+/** Append our managed table to existing config text (idempotent caller). */
+function withTable(config, cfg) {
+    const block = [
+        `${VERSION_MARKER} "${CONFIG_VERSION}"`,
+        TABLE_HEADER,
+        `url = ${tomlString(cfg.mcpUrl)}`,
+        `bearer_token_env_var = ${tomlString(TOKEN_ENV_VAR)}`,
+    ].join("\n");
+    const base = config.length === 0 || config.endsWith("\n") ? config : `${config}\n`;
+    const sep = base.length === 0 ? "" : "\n";
+    return `${base}${sep}${block}\n`;
+}
+/** Strip our managed table (and its version marker) from config text. */
+function withoutTable(config) {
+    const lines = config.split("\n");
+    const out = [];
+    let skipping = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === VERSION_MARKER || trimmed.startsWith(VERSION_MARKER)) {
+            // Drop a marker line immediately preceding our table.
+            continue;
+        }
+        if (trimmed === TABLE_HEADER) {
+            skipping = true;
+            continue;
+        }
+        if (skipping) {
+            // A new table header (or end of our keys) ends the skip region.
+            if (/^\[.+\]$/.test(trimmed)) {
+                skipping = false;
+                out.push(line);
+                continue;
+            }
+            if (trimmed === "" || /^[A-Za-z0-9_]+\s*=/.test(trimmed)) {
+                continue; // a key/blank inside our table — drop it
+            }
+            skipping = false;
+        }
+        out.push(line);
+    }
+    // Tidy trailing blank lines.
+    while (out.length > 0 && out[out.length - 1] === "")
+        out.pop();
+    return out.length === 0 ? "" : `${out.join("\n")}\n`;
+}
+function writeConfig(content) {
+    const file = codexConfigPath();
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, content, "utf8");
+}
+export const codex = {
+    id: "codex",
+    displayName: "Codex",
+    async detect() {
+        const config = readConfig();
+        if (!hasTable(config))
+            return { installed: false };
+        const version = parseConfigVersion(config) ?? CONFIG_VERSION;
+        return { installed: true, version };
+    },
+    async install(cfg) {
+        if (await which(CLI)) {
+            // Idempotent: if our table is already present, do nothing.
+            if (hasTable(readConfig()))
+                return;
+            const result = await run(CLI, [
+                "mcp",
+                "add",
+                SERVER_ID,
+                "--url",
+                cfg.mcpUrl,
+                "--bearer-token-env-var",
+                TOKEN_ENV_VAR,
+            ]);
+            if (result.code !== 0) {
+                throw new Error(`codex mcp add failed: ${oneLine(result.stderr || result.stdout)}`);
+            }
+            // Stamp our config-shape version alongside the CLI-written table so
+            // detect can report it (the CLI doesn't write the marker comment).
+            stampVersionIfMissing();
+            return;
+        }
+        // Fallback: no `codex` on PATH. We can still write the config file.
+        const config = readConfig();
+        if (hasTable(config))
+            return; // idempotent
+        writeConfig(withTable(config, cfg));
+    },
+    async uninstall() {
+        if (await which(CLI)) {
+            // `codex mcp remove` is a no-op when the server is absent.
+            await run(CLI, ["mcp", "remove", SERVER_ID]);
+        }
+        // Always clean the config text too (covers the CLI-absent path and the
+        // version marker the CLI doesn't manage).
+        const config = readConfig();
+        if (hasTable(config) || parseConfigVersion(config) !== undefined) {
+            writeConfig(withoutTable(config));
+        }
+    },
+    async update(cfg) {
+        // Re-applying is idempotent; install short-circuits when present.
+        await this.install(cfg);
+    },
+};
+/** If the table exists but our version marker doesn't, add the marker. */
+function stampVersionIfMissing() {
+    const config = readConfig();
+    if (!hasTable(config) || parseConfigVersion(config) !== undefined)
+        return;
+    const lines = config.split("\n");
+    const idx = lines.findIndex((line) => line.trim() === TABLE_HEADER);
+    if (idx === -1)
+        return;
+    lines.splice(idx, 0, `${VERSION_MARKER} "${CONFIG_VERSION}"`);
+    writeConfig(lines.join("\n"));
+}
+/** Double-quote a TOML string value with minimal escaping. */
+function tomlString(value) {
+    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+function oneLine(text) {
+    return text.replace(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=codex.js.map

package/dist/harnesses/codex.js.map

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

package/dist/harnesses/hermes.d.ts

@@ -0,0 +1,16 @@
+import type { HarnessModule } from "./types.js";
+export declare const PINNED_REF = "v1.0.0-rc.3";
+/**
+ * Fetches the Hermes adapter for a pinned ref and returns the absolute
+ * path to a directory whose contents ARE the adapter (the equivalent of
+ * `integrations/hermes/librarian/`). The caller copies from there.
+ *
+ * Injectable so tests substitute a local fixture instead of the network.
+ */
+export type AdapterFetcher = (ref: string) => Promise<string>;
+/** Override the adapter fetcher (tests inject a local-fixture fetcher). */
+export declare function setAdapterFetcher(next: AdapterFetcher): void;
+/** Restore the default (network) adapter fetcher (tests). */
+export declare function resetAdapterFetcher(): void;
+export declare const hermes: HarnessModule;
+//# sourceMappingURL=hermes.d.ts.map

package/dist/harnesses/hermes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes.d.ts","sourceRoot":"","sources":["../../src/harnesses/hermes.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAC;AAK/D,eAAO,MAAM,UAAU,gBAAgB,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAqC9D,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAE5D;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAoDD,eAAO,MAAM,MAAM,EAAE,aA+CpB,CAAC"}

package/dist/harnesses/hermes.js

@@ -0,0 +1,154 @@
+// Hermes harness.
+//
+// Hermes has no native install command for a memory provider, so we:
+//   - copy the adapter into `~/.hermes/plugins/librarian`, and
+//   - set `memory.provider = librarian` in `~/.hermes/config.json`.
+//
+//   detect    plugin dir present AND provider set to "librarian"
+//             version comes from the adapter's `plugin.yaml`
+//   uninstall remove the plugin dir + unset the provider key
+//   update    re-fetch + re-copy the adapter (idempotent)
+//
+// ARTIFACT SOURCING. On a user's machine the adapter does NOT live in the
+// repo — the CLI must fetch it from a pinned release. We download a tarball
+// of the pinned ref from GitHub's codeload endpoint
+//   https://codeload.github.com/JimJafar/the-librarian/tar.gz/refs/tags/<ref>
+// and extract `integrations/hermes/librarian/**` out of it with `tar`. The
+// FETCH is injectable (`setAdapterFetcher`): tests inject a fetcher that
+// returns a local fixture dir, so nothing touches the network. The pinned
+// ref defaults to the repo's current release tag (PINNED_REF).
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { run } from "../exec.js";
+import { hermesConfigPath, hermesHomeDir, hermesPluginDir } from "../paths.js";
+const PROVIDER_ID = "librarian";
+// The pinned monorepo release we fetch the adapter from. Default to the
+// repo's current release tag; the phase gate owns version bumps.
+export const PINNED_REF = "v1.0.0-rc.3";
+/** The default fetcher: codeload tarball → `tar` extract → adapter dir. */
+const defaultFetcher = async (ref) => {
+    const url = `https://codeload.github.com/JimJafar/the-librarian/tar.gz/refs/tags/${ref}`;
+    const work = fs.mkdtempSync(path.join(os.tmpdir(), "librarian-hermes-fetch-"));
+    const tarball = path.join(work, "src.tar.gz");
+    const res = await fetch(url, { redirect: "error" });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch Hermes adapter (${ref}): HTTP ${res.status}`);
+    }
+    const buf = Buffer.from(await res.arrayBuffer());
+    fs.writeFileSync(tarball, buf);
+    // codeload nests the adapter at
+    //   the-librarian-<ref>/integrations/hermes/librarian/**
+    // — four leading path components. Strip all four so the adapter's own
+    // files (plugin.yaml, …) land at the extraction root, which is what the
+    // caller copies into `~/.hermes/plugins/librarian/`.
+    const out = path.join(work, "adapter");
+    fs.mkdirSync(out, { recursive: true });
+    const extract = await run("tar", [
+        "-xzf",
+        tarball,
+        "-C",
+        out,
+        "--strip-components=4",
+        "--wildcards",
+        "*/integrations/hermes/librarian/*",
+    ]);
+    if (extract.code !== 0) {
+        throw new Error(`Failed to extract Hermes adapter: ${(extract.stderr || "").trim()}`);
+    }
+    return out;
+};
+let fetcher = defaultFetcher;
+/** Override the adapter fetcher (tests inject a local-fixture fetcher). */
+export function setAdapterFetcher(next) {
+    fetcher = next;
+}
+/** Restore the default (network) adapter fetcher (tests). */
+export function resetAdapterFetcher() {
+    fetcher = defaultFetcher;
+}
+function readHermesConfig() {
+    try {
+        const raw = fs.readFileSync(hermesConfigPath(), "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeHermesConfig(config) {
+    fs.mkdirSync(hermesHomeDir(), { recursive: true });
+    fs.writeFileSync(hermesConfigPath(), `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+/** True iff `memory.provider` is set to our provider id. */
+function providerSet() {
+    const config = readHermesConfig();
+    return config?.memory?.provider === PROVIDER_ID;
+}
+/** Parse `version:` from the installed adapter's plugin.yaml, if present. */
+function readAdapterVersion() {
+    try {
+        const raw = fs.readFileSync(path.join(hermesPluginDir(), "plugin.yaml"), "utf8");
+        for (const line of raw.split("\n")) {
+            const m = /^\s*version\s*:\s*["']?([^"'#\s]+)/.exec(line);
+            if (m?.[1])
+                return m[1];
+        }
+    }
+    catch {
+        // dir/file gone — no version
+    }
+    return undefined;
+}
+/** Recursively copy a directory tree (Node 22 `fs.cpSync`). */
+function copyDir(from, to) {
+    fs.rmSync(to, { recursive: true, force: true });
+    fs.mkdirSync(path.dirname(to), { recursive: true });
+    fs.cpSync(from, to, { recursive: true });
+}
+export const hermes = {
+    id: "hermes",
+    displayName: "Hermes",
+    async detect() {
+        const dirPresent = fs.existsSync(hermesPluginDir());
+        if (!dirPresent || !providerSet())
+            return { installed: false };
+        const version = readAdapterVersion();
+        return version === undefined ? { installed: true } : { installed: true, version };
+    },
+    async install(_cfg) {
+        // Fetch the adapter for the pinned ref (network by default; a local
+        // fixture in tests) and copy it into place — overwriting any prior copy
+        // so re-running is idempotent.
+        const adapterDir = await fetcher(PINNED_REF);
+        copyDir(adapterDir, hermesPluginDir());
+        // Set memory.provider = librarian, preserving any other config keys.
+        const config = readHermesConfig() ?? {};
+        const memory = (config.memory && typeof config.memory === "object" ? config.memory : {});
+        memory.provider = PROVIDER_ID;
+        config.memory = memory;
+        writeHermesConfig(config);
+    },
+    async uninstall() {
+        // Remove the plugin dir (no-op if already gone).
+        fs.rmSync(hermesPluginDir(), { recursive: true, force: true });
+        // Unset memory.provider only if it's ours, preserving other keys.
+        const config = readHermesConfig();
+        if (config?.memory && typeof config.memory === "object") {
+            if (config.memory.provider === PROVIDER_ID) {
+                delete config.memory.provider;
+                if (Object.keys(config.memory).length === 0)
+                    delete config.memory;
+                writeHermesConfig(config);
+            }
+        }
+    },
+    async update(cfg) {
+        await this.install(cfg);
+    },
+};
+//# sourceMappingURL=hermes.js.map

package/dist/harnesses/hermes.js.map

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

package/dist/harnesses/index.d.ts

@@ -0,0 +1,12 @@
+import type { HarnessId, HarnessModule } from "./types.js";
+/** Every harness module, keyed by id. */
+export declare const registry: Record<HarnessId, HarnessModule>;
+/** The harness ids in canonical display order. */
+export declare const HARNESS_IDS: readonly HarnessId[];
+/** All harness modules in canonical display order. */
+export declare const allHarnesses: readonly HarnessModule[];
+/** True iff `id` names a known harness. */
+export declare function isHarnessId(id: string): id is HarnessId;
+export type { HarnessConfig, HarnessModule, DetectResult, HarnessId } from "./types.js";
+export { NotImplemented } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harnesses/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3D,yCAAyC;AACzC,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,aAAa,CAMrD,CAAC;AAEF,kDAAkD;AAClD,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAAoD,CAAC;AAEjG,sDAAsD;AACtD,eAAO,MAAM,YAAY,EAAE,SAAS,aAAa,EAA0C,CAAC;AAE5F,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,EAAE,IAAI,SAAS,CAEvD;AAED,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/harnesses/index.js

@@ -0,0 +1,29 @@
+// The harness registry: id → module.
+//
+// The single source of truth for "which harnesses exist". Commands iterate
+// this in declaration order (the order the dashboard and prompts show them).
+// The next wave swaps the stub modules for real implementations without
+// touching this file.
+import { claude } from "./claude.js";
+import { codex } from "./codex.js";
+import { hermes } from "./hermes.js";
+import { opencode } from "./opencode.js";
+import { pi } from "./pi.js";
+/** Every harness module, keyed by id. */
+export const registry = {
+    claude,
+    codex,
+    opencode,
+    hermes,
+    pi,
+};
+/** The harness ids in canonical display order. */
+export const HARNESS_IDS = ["claude", "codex", "opencode", "hermes", "pi"];
+/** All harness modules in canonical display order. */
+export const allHarnesses = HARNESS_IDS.map((id) => registry[id]);
+/** True iff `id` names a known harness. */
+export function isHarnessId(id) {
+    return Object.prototype.hasOwnProperty.call(registry, id);
+}
+export { NotImplemented } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/harnesses/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/harnesses/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,wEAAwE;AACxE,sBAAsB;AAEtB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAG7B,yCAAyC;AACzC,MAAM,CAAC,MAAM,QAAQ,GAAqC;IACxD,MAAM;IACN,KAAK;IACL,QAAQ;IACR,MAAM;IACN,EAAE;CACH,CAAC;AAEF,kDAAkD;AAClD,MAAM,CAAC,MAAM,WAAW,GAAyB,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;AAEjG,sDAAsD;AACtD,MAAM,CAAC,MAAM,YAAY,GAA6B,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;AAE5F,2CAA2C;AAC3C,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC5D,CAAC;AAGD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/harnesses/opencode.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessModule } from "./types.js";
+export declare const opencode: HarnessModule;
+//# sourceMappingURL=opencode.d.ts.map

package/dist/harnesses/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../src/harnesses/opencode.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAC;AA4E/D,eAAO,MAAM,QAAQ,EAAE,aAuEtB,CAAC"}