@opencodehub/cli 0.1.0

package/dist/commands/setup.js

@@ -0,0 +1,370 @@
+/**
+ * `codehub setup` — detects installed editors and writes an MCP server entry
+ * for `codehub` into each one's config file.
+ *
+ * We deliberately do *not* probe each editor to confirm it is "installed" —
+ * writing to a config path is idempotent and safe, and a user can run setup
+ * before installing an editor. Instead we:
+ *   1. Determine the invocation (`codehub mcp`) with optional Windows wrap.
+ *   2. For each selected editor, read the existing config, back it up, and
+ *      atomically write the merged version that adds or replaces the
+ *      `codehub` entry.
+ *
+ * Filesystem access goes through the `FsApi` seam so tests can run against an
+ * in-memory implementation.
+ */
+import { statSync } from "node:fs";
+import { copyFile as fsCopyFile, mkdir as fsMkdir, readdir as fsReaddir, readFile as fsReadFile, rename as fsRename, rm as fsRm, stat as fsStat, } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { runSetupCobolProleap, } from "../cobol-proleap-setup.js";
+import { ALL_EDITOR_IDS, createClaudeCodeWriter, createCodexWriter, createCursorWriter, createOpenCodeWriter, createWindsurfWriter, maybeWrapForWindows, } from "../editors/index.js";
+import { downloadEmbedderWeights, } from "../embedder-downloader.js";
+import { writeFileAtomic as defaultWriteFileAtomic } from "../fs-atomic.js";
+import { installAllScipTools, installScipTool, isScipTool, SCIP_TOOL_ORDER, } from "../scip-downloader.js";
+export { runSetupCobolProleap };
+/** Default implementation that calls through to real `fs`. */
+export const DEFAULT_FS = {
+    async readFile(path) {
+        return await fsReadFile(path, "utf8");
+    },
+    async writeFileAtomic(path, contents) {
+        await defaultWriteFileAtomic(path, contents, { raw: true });
+    },
+    async copyFile(src, dest) {
+        await fsCopyFile(src, dest);
+    },
+    async mkdir(path) {
+        await fsMkdir(path, { recursive: true });
+    },
+    async exists(path) {
+        try {
+            await fsStat(path);
+            return true;
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return false;
+            throw err;
+        }
+    },
+    async readdir(path) {
+        return await fsReaddir(path);
+    },
+    async rename(src, dest) {
+        await fsRename(src, dest);
+    },
+    async rm(path, opts) {
+        await fsRm(path, { recursive: opts?.recursive ?? false, force: opts?.force ?? false });
+    },
+    async statIsDirectory(path) {
+        const st = await fsStat(path);
+        return st.isDirectory();
+    },
+};
+/** Public entry point. Returns per-editor results for programmatic callers. */
+export async function runSetup(opts = {}) {
+    const editors = opts.editors ?? ALL_EDITOR_IDS;
+    const fs = opts.fs ?? DEFAULT_FS;
+    const log = opts.log ?? ((msg) => console.warn(msg));
+    const warn = opts.warn ?? ((msg) => console.warn(msg));
+    const invocation = maybeWrapForWindows(opts.invocation ?? defaultInvocation(), opts.platform !== undefined ? { platform: opts.platform } : {});
+    const writers = editors.map((id) => buildWriter(id, opts));
+    const results = [];
+    for (const writer of writers) {
+        try {
+            const result = opts.undo
+                ? await undoSingle(writer, fs, log)
+                : await writeSingle(writer, invocation, fs, log);
+            results.push(result);
+        }
+        catch (err) {
+            const message = err.message;
+            warn(`codehub setup (${writer.id}): ${message}`);
+            results.push({
+                editor: writer.id,
+                configPath: writer.configPath,
+                action: "skipped",
+            });
+        }
+    }
+    return results;
+}
+function defaultInvocation() {
+    return { command: "codehub", args: ["mcp"], env: {} };
+}
+function buildWriter(id, opts) {
+    const projectRoot = opts.projectRoot ?? process.cwd();
+    const homeOpt = opts.home !== undefined ? { home: opts.home } : {};
+    switch (id) {
+        case "claude-code":
+            return createClaudeCodeWriter({ projectRoot });
+        case "cursor":
+            return createCursorWriter(homeOpt);
+        case "codex":
+            return createCodexWriter(homeOpt);
+        case "windsurf":
+            return createWindsurfWriter(homeOpt);
+        case "opencode":
+            return createOpenCodeWriter({ projectRoot });
+    }
+}
+async function writeSingle(writer, invocation, fs, log) {
+    const target = writer.configPath;
+    const parent = dirname(target);
+    await fs.mkdir(parent);
+    const existing = (await fs.exists(target)) ? await fs.readFile(target) : undefined;
+    const merged = writer.merge(existing, invocation);
+    // Record a backup on every overwrite. Fresh writes don't need a .bak.
+    let backupPath;
+    if (existing !== undefined) {
+        backupPath = `${target}.bak`;
+        await fs.copyFile(target, backupPath);
+    }
+    if (existing !== undefined && existing === merged) {
+        log(`codehub setup (${writer.id}): already up to date at ${target}`);
+        return {
+            editor: writer.id,
+            configPath: target,
+            action: "unchanged",
+            ...(backupPath !== undefined ? { backupPath } : {}),
+        };
+    }
+    await fs.writeFileAtomic(target, merged);
+    log(`codehub setup (${writer.id}): wrote MCP entry to ${target}`);
+    return {
+        editor: writer.id,
+        configPath: target,
+        action: "wrote",
+        ...(backupPath !== undefined ? { backupPath } : {}),
+    };
+}
+/**
+ * Public entry point for `codehub setup --embeddings`.
+ *
+ * Downloads the five pinned gte-modernbert-base files into the target dir with
+ * streaming SHA256 verification and atomic rename. Returns the downloader
+ * summary so programmatic callers can assert on byte counts and locations.
+ */
+export async function runSetupEmbeddings(opts = {}) {
+    const log = opts.log ?? ((msg) => console.warn(msg));
+    const warn = opts.warn ?? ((msg) => console.warn(msg));
+    const variant = opts.variant ?? "fp32";
+    log(`codehub setup --embeddings: starting ${variant} download ` +
+        `(${variant === "fp32" ? "~90 MB" : "~23 MB"})`);
+    const downloaderOpts = {
+        variant,
+        ...(opts.modelDir !== undefined ? { modelDir: opts.modelDir } : {}),
+        ...(opts.force !== undefined ? { force: opts.force } : {}),
+        ...(opts.fetchImpl !== undefined ? { fetchImpl: opts.fetchImpl } : {}),
+        ...(opts.onProgress !== undefined ? { onProgress: opts.onProgress } : {}),
+    };
+    try {
+        const result = await downloadEmbedderWeights(downloaderOpts);
+        const mb = (result.totalBytes / 1024 / 1024).toFixed(1);
+        log(`codehub setup --embeddings: downloaded ${result.downloaded} file(s), ` +
+            `skipped ${result.skipped} (${mb} MB new) → ${result.modelDir}`);
+        log("codehub setup --embeddings: Done. " + "Run `codehub analyze --embeddings` to use them.");
+        return result;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        warn(`codehub setup --embeddings: ${message}`);
+        throw err;
+    }
+}
+/**
+ * Public entry point for `codehub setup --scip=<tool>` / `--scip=all`.
+ *
+ * Dispatches to {@link installScipTool} for one tool, or
+ * {@link installAllScipTools} for the full set. Never throws — every error is
+ * surfaced on `stderr` via `warn` and collected into the `failed` array so
+ * `--scip=all` completes the surviving tools instead of short-circuiting on
+ * the first missing .NET SDK.
+ */
+export async function runSetupScip(opts) {
+    const log = opts.log ?? ((msg) => console.warn(msg));
+    const warn = opts.warn ?? ((msg) => console.warn(msg));
+    const installOpts = {
+        ...(opts.destDir !== undefined ? { destDir: opts.destDir } : {}),
+        ...(opts.force !== undefined ? { force: opts.force } : {}),
+        ...(opts.fetchImpl !== undefined ? { fetchImpl: opts.fetchImpl } : {}),
+        ...(opts.allowPlaceholder !== undefined ? { allowPlaceholder: opts.allowPlaceholder } : {}),
+        log,
+    };
+    const installed = [];
+    const failed = [];
+    if (opts.tool === "all") {
+        log(`codehub setup --scip=all: installing ${SCIP_TOOL_ORDER.join(", ")}`);
+        const results = await installAllScipTools(installOpts);
+        for (const r of results) {
+            if ("error" in r) {
+                warn(`codehub setup --scip=${r.tool}: ${r.error.message}`);
+                failed.push({ tool: r.tool, error: r.error });
+            }
+            else {
+                installed.push(r);
+            }
+        }
+    }
+    else {
+        log(`codehub setup --scip=${opts.tool}: starting`);
+        try {
+            const result = await installScipTool(opts.tool, installOpts);
+            installed.push(result);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            warn(`codehub setup --scip=${opts.tool}: ${error.message}`);
+            failed.push({ tool: opts.tool, error });
+        }
+    }
+    const summary = installed
+        .map((r) => r.dotnetToolHint !== undefined
+        ? `scip-${r.tool} (run \`${r.dotnetToolHint}\`)`
+        : `scip-${r.tool} ${r.installed ? "installed" : "skipped"} at ${r.path}`)
+        .join(", ");
+    if (summary.length > 0) {
+        log(`codehub setup --scip: ${summary}`);
+    }
+    if (failed.length > 0) {
+        warn(`codehub setup --scip: ${failed.length} tool(s) failed`);
+    }
+    return { installed, failed };
+}
+/**
+ * Parse the CLI `--scip=<value>` flag. Accepts a tool name or the literal
+ * `"all"`. Throws on anything else so typos surface instead of silently
+ * defaulting.
+ */
+export function parseScipFlag(raw) {
+    const trimmed = raw.trim();
+    if (trimmed === "all")
+        return "all";
+    if (isScipTool(trimmed))
+        return trimmed;
+    throw new Error(`Unknown --scip value: "${raw}". Expected one of: ${[...SCIP_TOOL_ORDER, "all"].join(", ")}`);
+}
+/**
+ * Public entry point for `codehub setup --plugin`.
+ *
+ * Walks `sourceDir` and mirrors it into `<home>/.claude/plugins/opencodehub/`.
+ * Both the temp dir and the final rename go through `FsApi` so tests can run
+ * against an in-memory implementation.
+ */
+export async function runSetupPlugin(opts = {}) {
+    const fs = opts.fs ?? DEFAULT_FS;
+    const log = opts.log ?? ((msg) => console.warn(msg));
+    const warn = opts.warn ?? ((msg) => console.warn(msg));
+    const home = opts.home ?? homedir();
+    const sourceDir = opts.sourceDir ?? defaultPluginSourceDir();
+    const targetRoot = resolve(home, ".claude", "plugins");
+    const targetDir = resolve(targetRoot, "opencodehub");
+    const tempDir = `${targetDir}.tmp-${process.pid}`;
+    if (!(await fs.exists(sourceDir))) {
+        const message = `codehub setup --plugin: source not found at ${sourceDir}`;
+        warn(message);
+        throw new Error(message);
+    }
+    await fs.mkdir(targetRoot);
+    // Wipe any stale tmp dir from a prior crash before we start. Best-effort.
+    if (fs.rm && (await fs.exists(tempDir))) {
+        await fs.rm(tempDir, { recursive: true, force: true });
+    }
+    const filesCopied = await copyTree(fs, sourceDir, tempDir);
+    // Swap: remove old install, rename temp into place. This is "atomic
+    // enough" — the window between rm and rename is narrow and leaves no
+    // half-written plugin because the temp dir was fully built first.
+    if (fs.rm && (await fs.exists(targetDir))) {
+        await fs.rm(targetDir, { recursive: true, force: true });
+    }
+    if (fs.rename) {
+        await fs.rename(tempDir, targetDir);
+    }
+    else {
+        // Fallback for FsApi implementations without rename: walk the temp
+        // tree and copy entries into the final target. Only used by in-memory
+        // test doubles that don't implement rename.
+        await copyTree(fs, tempDir, targetDir);
+        if (fs.rm)
+            await fs.rm(tempDir, { recursive: true, force: true });
+    }
+    log(`codehub setup --plugin: installed ${filesCopied} file(s) to ${targetDir}`);
+    return { sourceDir, targetDir, filesCopied };
+}
+/**
+ * Resolve the default plugin source dir.
+ *
+ * When running from source (`packages/cli/src/commands/setup.ts`) or from
+ * `dist/commands/setup.js` inside a pnpm workspace, the repo root is three
+ * directories above this file. We walk up from `import.meta.url` until we
+ * find a `plugins/opencodehub` dir.
+ */
+function defaultPluginSourceDir() {
+    const thisFile = fileURLToPath(import.meta.url);
+    let dir = dirname(thisFile);
+    for (let i = 0; i < 8; i += 1) {
+        const candidate = join(dir, "plugins", "opencodehub");
+        try {
+            // Sync check is fine here — this runs once per setup invocation.
+            const st = statSyncSafe(candidate);
+            if (st?.isDirectory())
+                return candidate;
+        }
+        catch {
+            // keep walking
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Fall back to the conventional location relative to the compiled
+    // `dist/commands/setup.js`. If this doesn't exist, the caller will get a
+    // clean "source not found" error.
+    return resolve(dirname(thisFile), "..", "..", "..", "..", "plugins", "opencodehub");
+}
+function statSyncSafe(path) {
+    try {
+        return statSync(path);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Recursively copy every regular file under `src` into `dest`. Returns count. */
+async function copyTree(fs, src, dest) {
+    await fs.mkdir(dest);
+    if (!fs.readdir) {
+        throw new Error("FsApi.readdir is required for plugin installation");
+    }
+    const entries = await fs.readdir(src);
+    let count = 0;
+    for (const name of entries) {
+        const from = join(src, name);
+        const to = join(dest, name);
+        const isDir = fs.statIsDirectory ? await fs.statIsDirectory(from) : false;
+        if (isDir) {
+            count += await copyTree(fs, from, to);
+        }
+        else {
+            await fs.copyFile(from, to);
+            count += 1;
+        }
+    }
+    return count;
+}
+async function undoSingle(writer, fs, log) {
+    const target = writer.configPath;
+    const backupPath = `${target}.bak`;
+    if (!(await fs.exists(backupPath))) {
+        log(`codehub setup --undo (${writer.id}): no backup found at ${backupPath}`);
+        return { editor: writer.id, configPath: target, action: "skipped" };
+    }
+    const backup = await fs.readFile(backupPath);
+    await fs.writeFileAtomic(target, backup);
+    log(`codehub setup --undo (${writer.id}): restored ${target} from ${backupPath}`);
+    return { editor: writer.id, configPath: target, action: "restored", backupPath };
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

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

package/dist/commands/sql.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `codehub sql <query>` — run a read-only SQL statement against the local
+ * temporal store. The `assertReadOnlySql` guard inside the temporal adapter
+ * rejects any mutation, and a per-statement JS timer interrupts long
+ * queries.
+ *
+ * Routes through `store.temporal.exec()` rather than the graph-tier
+ * escape hatch — `--sql` is the one CLI surface that consumes the
+ * tabular view directly. Graph-only commands stay on
+ * `store.graph.<finder>()`.
+ */
+export interface SqlOptions {
+    readonly repo?: string;
+    readonly home?: string;
+    readonly timeoutMs?: number;
+    readonly json?: boolean;
+}
+export declare function runSql(sql: string, opts?: SqlOptions): Promise<void>;
+//# sourceMappingURL=sql.d.ts.map

package/dist/commands/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/commands/sql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAY9E"}

package/dist/commands/sql.js

@@ -0,0 +1,51 @@
+/**
+ * `codehub sql <query>` — run a read-only SQL statement against the local
+ * temporal store. The `assertReadOnlySql` guard inside the temporal adapter
+ * rejects any mutation, and a per-statement JS timer interrupts long
+ * queries.
+ *
+ * Routes through `store.temporal.exec()` rather than the graph-tier
+ * escape hatch — `--sql` is the one CLI surface that consumes the
+ * tabular view directly. Graph-only commands stay on
+ * `store.graph.<finder>()`.
+ */
+import { openStoreForCommand } from "./open-store.js";
+export async function runSql(sql, opts = {}) {
+    const { store } = await openStoreForCommand(opts);
+    try {
+        const rows = await store.temporal.exec(sql, [], { timeoutMs: opts.timeoutMs ?? 5_000 });
+        if (opts.json || rows.length === 0) {
+            console.log(JSON.stringify(rows, null, 2));
+            return;
+        }
+        printTable(rows);
+    }
+    finally {
+        await store.close();
+    }
+}
+function printTable(rows) {
+    const first = rows[0];
+    if (!first)
+        return;
+    const cols = Object.keys(first);
+    const widths = cols.map((c) => c.length);
+    const str = (v) => {
+        if (v === null || v === undefined)
+            return "";
+        if (Array.isArray(v))
+            return `[${v.map((x) => String(x)).join(",")}]`;
+        return String(v);
+    };
+    for (const row of rows) {
+        cols.forEach((c, i) => {
+            widths[i] = Math.max(widths[i] ?? 0, str(row[c]).length);
+        });
+    }
+    const line = (vals) => vals.map((v, i) => v.padEnd(widths[i] ?? 0)).join("  ");
+    console.log(line(cols));
+    for (const row of rows) {
+        console.log(line(cols.map((c) => str(row[c]))));
+    }
+}
+//# sourceMappingURL=sql.js.map

package/dist/commands/sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.js","sourceRoot":"","sources":["../../src/commands/sql.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAStD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,GAAW,EAAE,OAAmB,EAAE;IAC7D,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,KAAK,EAAE,CAAC,CAAC;QACxF,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAwC;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,CAAC,CAAU,EAAU,EAAE;QACjC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QACtE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACpB,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,IAAuB,EAAU,EAAE,CAC/C,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACxB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `codehub status [path]` — show the recorded index state for a repo.
+ *
+ * Reads `<repo>/.codehub/meta.json` and prints schemaVersion, lastCommit,
+ * node/edge counts, and a best-effort staleness envelope. Staleness is
+ * computed by `@opencodehub/analysis` when available; otherwise we fall back
+ * to a simple `lastCommit` / registry check.
+ */
+export interface StatusOptions {
+    readonly home?: string;
+}
+export declare function runStatus(path: string, opts?: StatusOptions): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CrF"}

package/dist/commands/status.js

@@ -0,0 +1,66 @@
+/**
+ * `codehub status [path]` — show the recorded index state for a repo.
+ *
+ * Reads `<repo>/.codehub/meta.json` and prints schemaVersion, lastCommit,
+ * node/edge counts, and a best-effort staleness envelope. Staleness is
+ * computed by `@opencodehub/analysis` when available; otherwise we fall back
+ * to a simple `lastCommit` / registry check.
+ */
+import { resolve } from "node:path";
+import { readStoreMeta } from "@opencodehub/storage";
+import { listGroups } from "../groups.js";
+import { readRegistry } from "../registry.js";
+export async function runStatus(path, opts = {}) {
+    const repoPath = resolve(path);
+    const meta = await readStoreMeta(repoPath);
+    if (!meta) {
+        console.warn(`No index found at ${repoPath}. Run \`codehub analyze\`.`);
+        return;
+    }
+    const registryOpts = opts.home !== undefined ? { home: opts.home } : {};
+    const registry = await readRegistry(registryOpts);
+    const registryHit = Object.values(registry).find((e) => resolve(e.path) === repoPath);
+    console.log(`path:           ${repoPath}`);
+    console.log(`schemaVersion:  ${meta.schemaVersion}`);
+    console.log(`indexedAt:      ${meta.indexedAt}`);
+    console.log(`lastCommit:     ${meta.lastCommit ?? "-"}`);
+    console.log(`nodes:          ${meta.nodeCount}`);
+    console.log(`edges:          ${meta.edgeCount}`);
+    if (registryHit === undefined) {
+        console.log("registry:       missing — run `codehub analyze` to re-register");
+    }
+    else {
+        console.log("registry:       ok");
+    }
+    // Surface every group the current repo belongs to, alphabetically.
+    if (registryHit !== undefined) {
+        const groups = await listGroups(registryOpts);
+        const memberOf = groups
+            .filter((g) => g.repos.some((r) => r.name === registryHit.name))
+            .map((g) => g.name)
+            .sort();
+        console.log(`groups:         ${memberOf.length > 0 ? memberOf.join(", ") : "(none)"}`);
+    }
+    // Optional deeper staleness check via @opencodehub/analysis if wired.
+    const staleness = await tryComputeStaleness(repoPath, meta.lastCommit);
+    if (staleness !== undefined) {
+        console.log(`stale:          ${staleness.isStale ? "yes" : "no"}`);
+        if (staleness.hint) {
+            console.log(`hint:           ${staleness.hint}`);
+        }
+    }
+}
+async function tryComputeStaleness(repoPath, lastCommit) {
+    try {
+        const specifier = "@opencodehub/analysis";
+        const mod = (await import(specifier));
+        if (typeof mod.computeStaleness === "function") {
+            return await mod.computeStaleness(repoPath, lastCommit);
+        }
+    }
+    catch {
+        // Analysis package not built yet or export missing; fall through.
+    }
+    return undefined;
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/verdict-render.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Pure render helpers for `codehub verdict`.
+ *
+ * The CLI supports three output formats:
+ *   - `summary`   — chalk-free ANSI pretty-print for human eyes in a TTY.
+ *                   Honors `NO_COLOR` and falls back to plain text when
+ *                   stdout is not a TTY (piped or redirected).
+ *   - `markdown`  — the PR-comment markdown string already synthesized by
+ *                   the analysis module. Safe to pipe directly into
+ *                   `gh pr comment`.
+ *   - `json`      — pretty-printed JSON document of the entire response.
+ *
+ * Renderers are pure: they take a {@link VerdictResponse} and return a
+ * string. Side-effect output (stdout, exit code) is the caller's concern.
+ *
+ * The CLI also defines its own exit-code ladder (0/1/2/3) for the
+ * `--exit-code` flag. That ladder is stricter than
+ * `VerdictResponse.exitCode` (which maxes out at 2 per the analysis
+ * module's original PRD contract) so CI pipes get distinct signals for
+ * `single_review` vs `dual_review` vs `block`.
+ */
+import type { VerdictResponse, VerdictTier } from "@opencodehub/analysis";
+export declare function cliExitCodeForTier(tier: VerdictTier): 0 | 1 | 2 | 3;
+export declare function renderJson(verdict: VerdictResponse): string;
+export declare function renderMarkdown(verdict: VerdictResponse): string;
+export interface RenderSummaryOptions {
+    /** Defaults to `process.stdout.isTTY`. */
+    readonly isTty?: boolean;
+    /** Defaults to whether `NO_COLOR` is set and non-empty. */
+    readonly noColor?: boolean;
+}
+export declare function renderSummary(verdict: VerdictResponse, opts?: RenderSummaryOptions): string;
+//# sourceMappingURL=verdict-render.d.ts.map

package/dist/commands/verdict-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict-render.d.ts","sourceRoot":"","sources":["../../src/commands/verdict-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAW1E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAEnE;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAE3D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAY/D;AA+BD,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,GAAE,oBAAyB,GAAG,MAAM,CA+D/F"}