@opencodehub/cli 0.1.0

package/dist/commands/bench.js

@@ -0,0 +1,283 @@
+/**
+ * `codehub bench` — acceptance-gate dashboard.
+ *
+ * Wraps `scripts/acceptance.sh` so we can invoke each gate as a discrete
+ * listr2 task, capture its exit code, and render the final summary as a
+ * cli-table3. Gates are hard-coded here to match the script's output —
+ * changing the script requires a matching edit here.
+ *
+ * Exit codes:
+ *   0  every mandatory gate PASSED
+ *   1  at least one gate FAILED
+ *   2  the acceptance script could not be located
+ *
+ * Like `doctor`, this never auto-heals and never writes to the repo; it
+ * only reports.
+ */
+import { spawn } from "node:child_process";
+import { access } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import Table from "cli-table3";
+import { Listr } from "listr2";
+/**
+ * Fixed roster of MVP acceptance gates. Order + ids mirror
+ * `scripts/acceptance.sh`; rendering is by this order so users see the
+ * same sequence whether they run the script directly or via `codehub
+ * bench`.
+ */
+export const MVP_GATES = [
+    { id: "install", title: "pnpm install --frozen-lockfile" },
+    { id: "build", title: "pnpm -r build" },
+    { id: "tests", title: "pnpm -r test" },
+    { id: "banned-strings", title: "banned-strings grep" },
+    { id: "licenses", title: "license allowlist" },
+    { id: "determinism", title: "determinism (double-run graphHash)" },
+    { id: "incremental", title: "incremental reindex timings" },
+    { id: "mcp-smoke", title: "MCP stdio boot smoke" },
+    { id: "eval", title: "Python eval harness (moved to opencodehub-testbed)" },
+    { id: "embeddings-determinism", title: "embeddings determinism" },
+    { id: "incremental-timing", title: "incremental timing on 100-file fixture" },
+    { id: "scanner-smoke", title: "scanner smoke (semgrep)" },
+    { id: "sarif-validation", title: "SARIF schema validation" },
+    { id: "license-audit-smoke", title: "license-audit smoke" },
+    { id: "verdict-smoke", title: "verdict smoke (2-commit fixture)" },
+    { id: "pack-determinism", title: "pack-determinism (code-pack ×2 → diff -r)" },
+    { id: "m7-parity-audit", title: "m7-parity-audit (analyze ×2 backends → graphHash)" },
+];
+/**
+ * Entrypoint for `codehub bench`. Returns the structured report so
+ * acceptance tests can assert the outcome without scraping stdout.
+ */
+export async function runBench(opts = {}) {
+    const script = await locateAcceptanceScript(opts.acceptanceScript);
+    if (!script) {
+        console.error("codehub bench: scripts/acceptance.sh not found — set --acceptance or run from the repo root.");
+        process.exitCode = 2;
+        return { rows: [], exitCode: 2 };
+    }
+    const rows = MVP_GATES.map((g) => ({
+        id: g.id,
+        title: g.title,
+        status: "pending",
+        detail: "",
+    }));
+    // Kick acceptance.sh in the background. We stream stdout line-by-line
+    // and parse every `[PASS] …` / `[FAIL] …` marker to advance the matching
+    // row. Timing for soft gates is rendered verbatim in the `detail` cell.
+    const stream = runScript(script);
+    const listr = new Listr(MVP_GATES.map((gate, idx) => ({
+        title: gate.title,
+        task: async (_ctx, task) => {
+            // Wait for this row's completion. We don't advance rows ahead of
+            // the stream — each row completes when the script's emitter calls
+            // applyLine() with a matching marker. This keeps the UI honest.
+            await waitUntil(() => rows[idx]?.status !== "pending");
+            const row = rows[idx];
+            if (!row)
+                return;
+            task.title = `${gate.title} — ${row.detail}`;
+            if (row.status === "fail") {
+                throw new Error(row.detail || "FAIL");
+            }
+        },
+    })), {
+        concurrent: false,
+        exitOnError: false,
+        renderer: opts.silent ? "silent" : "default",
+    });
+    // Capture listr2 failures but do not rethrow — we assemble the final
+    // report regardless.
+    const listrPromise = listr.run().catch(() => {
+        /* failures already captured in rows[i].status === "fail" */
+    });
+    stream.onLine((line) => {
+        applyLine(rows, line);
+    });
+    const code = await stream.done;
+    // Flush any rows that never received a marker (e.g. script crashed).
+    for (const row of rows) {
+        if (row.status === "pending") {
+            row.status = "skipped";
+            row.detail = "no [PASS]/[FAIL] marker — script crashed or was killed";
+        }
+    }
+    await listrPromise;
+    printTable(rows);
+    const exitCode = rows.some((r) => r.status === "fail") || code !== 0 ? 1 : 0;
+    process.exitCode = exitCode;
+    return { rows, exitCode };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Split a stdout/stderr stream into lines regardless of chunk boundaries. */
+function lineSplitter() {
+    let buf = "";
+    return {
+        push(chunk) {
+            buf += chunk;
+            const parts = buf.split("\n");
+            buf = parts.pop() ?? "";
+            return parts;
+        },
+        flush() {
+            if (buf.length === 0)
+                return [];
+            const out = [buf];
+            buf = "";
+            return out;
+        },
+    };
+}
+function runScript(scriptPath) {
+    const child = spawn("bash", [scriptPath], {
+        stdio: ["ignore", "pipe", "pipe"],
+        cwd: dirname(dirname(scriptPath)), // assume scripts/ is a sibling of packages/
+    });
+    const listeners = [];
+    const stdoutSplit = lineSplitter();
+    const stderrSplit = lineSplitter();
+    const emit = (line) => {
+        for (const l of listeners)
+            l(line);
+    };
+    child.stdout.on("data", (d) => {
+        for (const line of stdoutSplit.push(d.toString("utf8")))
+            emit(line);
+    });
+    child.stderr.on("data", (d) => {
+        // We echo stderr so users see banner messages, but don't parse it for
+        // gate status — acceptance.sh writes its markers to stdout.
+        for (const _line of stderrSplit.push(d.toString("utf8"))) {
+            /* intentionally discarded */
+        }
+    });
+    const done = new Promise((resolveProm) => {
+        child.on("error", () => resolveProm(127));
+        child.on("close", (code) => {
+            for (const line of stdoutSplit.flush())
+                emit(line);
+            stderrSplit.flush();
+            resolveProm(code ?? 0);
+        });
+    });
+    return {
+        onLine(cb) {
+            listeners.push(cb);
+        },
+        done,
+    };
+}
+/**
+ * Apply a single line from `acceptance.sh` to the gate table. We parse
+ * the `N/17: <title>` banner line to pick which row the next `[PASS] ...`
+ * or `[FAIL] ...` marker belongs to. Anything else is ignored (timing
+ * summaries live under a gate row as `......` notes).
+ */
+let currentGateIdx = -1;
+export function applyLine(rows, rawLine) {
+    const line = rawLine.trimEnd();
+    const banner = /^\d+\/\d+:\s+(.*)$/.exec(line);
+    if (banner) {
+        const title = banner[1] ?? "";
+        const idx = rows.findIndex((r) => r.title === title);
+        if (idx >= 0)
+            currentGateIdx = idx;
+        return;
+    }
+    const passMatch = /^\s*\[PASS\]\s+(.*)$/.exec(line);
+    if (passMatch && currentGateIdx >= 0) {
+        const row = rows[currentGateIdx];
+        if (row) {
+            row.status = "pass";
+            row.detail = passMatch[1] ?? "";
+        }
+        currentGateIdx = -1;
+        return;
+    }
+    const failMatch = /^\s*\[FAIL\]\s+(.*)$/.exec(line);
+    if (failMatch && currentGateIdx >= 0) {
+        const row = rows[currentGateIdx];
+        if (row) {
+            row.status = "fail";
+            row.detail = failMatch[1] ?? "";
+        }
+        currentGateIdx = -1;
+        return;
+    }
+    const skipMatch = /^\s*\[SKIP\]\s+(.*)$/.exec(line);
+    if (skipMatch && currentGateIdx >= 0) {
+        const row = rows[currentGateIdx];
+        if (row) {
+            row.status = "skipped";
+            row.detail = skipMatch[1] ?? "";
+        }
+        currentGateIdx = -1;
+        return;
+    }
+}
+async function waitUntil(predicate) {
+    while (!predicate()) {
+        await new Promise((r) => setTimeout(r, 50));
+    }
+}
+async function locateAcceptanceScript(override) {
+    if (override !== undefined) {
+        if (await pathExists(override))
+            return override;
+        return null;
+    }
+    // Walk up from this file to find scripts/acceptance.sh. The CLI ships
+    // at packages/cli/dist/commands/bench.js in the monorepo; scripts/ lives
+    // four levels above.
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [
+        resolve(here, "..", "..", "..", "..", "scripts", "acceptance.sh"),
+        resolve(process.cwd(), "scripts", "acceptance.sh"),
+    ];
+    for (const c of candidates) {
+        if (await pathExists(c))
+            return c;
+    }
+    return null;
+}
+async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function printTable(rows) {
+    const table = new Table({
+        head: ["GATE", "STATUS", "DETAIL"],
+        style: { head: [], border: [] },
+        colWidths: [36, 10, 72],
+        wordWrap: true,
+    });
+    for (const row of rows) {
+        const glyph = row.status === "pass"
+            ? "PASS"
+            : row.status === "fail"
+                ? "FAIL"
+                : row.status === "skipped"
+                    ? "SKIP"
+                    : "?";
+        table.push([row.title, glyph, row.detail]);
+    }
+    const passed = rows.filter((r) => r.status === "pass").length;
+    const failed = rows.filter((r) => r.status === "fail").length;
+    const skipped = rows.filter((r) => r.status === "skipped").length;
+    console.log(table.toString());
+    console.log(`bench: ${passed}/${rows.length} passed, ${failed} failed, ${skipped} skipped`);
+}
+// Guard against `scripts` discovery confusion when the CLI is installed
+// via `npm link` or similar.
+export { locateAcceptanceScript, pathExists };
+// Silence lint for the unused helper import; kept for future per-gate
+// path joining.
+void join;
+//# sourceMappingURL=bench.js.map

package/dist/commands/bench.js.map

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

package/dist/commands/ci-init.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `codehub ci-init` — emit opinionated CI workflow files for GitHub Actions
+ * and/or GitLab CI.
+ *
+ * Platform detection:
+ *   - probes `.github/workflows/` (GitHub) and `.gitlab-ci.yml` (GitLab)
+ *   - if both are absent, defaults to `github`
+ *   - if both are present, defaults to `both`
+ *   - `--platform <p>` always overrides detection
+ *
+ * Templates live under `src/commands/ci-templates/*.yml` and are copied into
+ * `dist/commands/ci-templates/` as a post-build step. Variables are
+ * substituted with plain `String.prototype.replaceAll` — no handlebars.
+ *
+ * Idempotence: re-running with identical args produces byte-identical files.
+ * Re-running against an existing file refuses unless `--force` is set, and
+ * the error lists every conflict.
+ */
+export interface CiInitCliOptions {
+    readonly repo?: string;
+    readonly platform?: "github" | "gitlab" | "both";
+    readonly force?: boolean;
+    readonly mainBranch?: string;
+}
+export declare function detectPlatform(repoRoot: string): Promise<"github" | "gitlab" | "both">;
+export declare function interpolate(template: string, vars: {
+    readonly MAIN_BRANCH: string;
+    readonly REPO_NAME: string;
+}): string;
+interface RenderPlan {
+    readonly outputPath: string;
+    readonly contents: string;
+}
+export declare function buildPlan(repoRoot: string, platform: "github" | "gitlab" | "both", mainBranch: string, repoName: string): Promise<readonly RenderPlan[]>;
+export declare function runCiInit(opts: CiInitCliOptions): Promise<void>;
+export {};
+//# sourceMappingURL=ci-init.d.ts.map

package/dist/commands/ci-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-init.d.ts","sourceRoot":"","sources":["../../src/commands/ci-init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AA6CD,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC,CAM5F;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACjE,MAAM,CAQR;AAQD,UAAU,UAAU;IAClB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,EACtC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAShC;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCrE"}

package/dist/commands/ci-init.js

@@ -0,0 +1,115 @@
+/**
+ * `codehub ci-init` — emit opinionated CI workflow files for GitHub Actions
+ * and/or GitLab CI.
+ *
+ * Platform detection:
+ *   - probes `.github/workflows/` (GitHub) and `.gitlab-ci.yml` (GitLab)
+ *   - if both are absent, defaults to `github`
+ *   - if both are present, defaults to `both`
+ *   - `--platform <p>` always overrides detection
+ *
+ * Templates live under `src/commands/ci-templates/*.yml` and are copied into
+ * `dist/commands/ci-templates/` as a post-build step. Variables are
+ * substituted with plain `String.prototype.replaceAll` — no handlebars.
+ *
+ * Idempotence: re-running with identical args produces byte-identical files.
+ * Re-running against an existing file refuses unless `--force` is set, and
+ * the error lists every conflict.
+ */
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { basename, dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const HERE = dirname(fileURLToPath(import.meta.url));
+const TEMPLATES_DIR = join(HERE, "ci-templates");
+const GITHUB_TEMPLATES = [
+    {
+        templateFile: "github-verdict.yml",
+        outputPath: (root) => join(root, ".github", "workflows", "opencodehub-verdict.yml"),
+    },
+    {
+        templateFile: "github-nightly.yml",
+        outputPath: (root) => join(root, ".github", "workflows", "opencodehub-nightly.yml"),
+    },
+    {
+        templateFile: "github-weekly.yml",
+        outputPath: (root) => join(root, ".github", "workflows", "opencodehub-weekly.yml"),
+    },
+    {
+        templateFile: "github-rescan.yml",
+        outputPath: (root) => join(root, ".github", "workflows", "opencodehub-rescan.yml"),
+    },
+];
+const GITLAB_TEMPLATES = [
+    {
+        templateFile: "gitlab-ci.yml",
+        outputPath: (root) => join(root, ".gitlab-ci.yml"),
+    },
+];
+async function pathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function detectPlatform(repoRoot) {
+    const hasGithub = await pathExists(join(repoRoot, ".github", "workflows"));
+    const hasGitlab = await pathExists(join(repoRoot, ".gitlab-ci.yml"));
+    if (hasGithub && hasGitlab)
+        return "both";
+    if (hasGitlab)
+        return "gitlab";
+    return "github";
+}
+export function interpolate(template, vars) {
+    return (template
+        // biome-ignore lint/suspicious/noTemplateCurlyInString: literal token to substitute
+        .replaceAll("${MAIN_BRANCH}", vars.MAIN_BRANCH)
+        // biome-ignore lint/suspicious/noTemplateCurlyInString: literal token to substitute
+        .replaceAll("${REPO_NAME}", vars.REPO_NAME));
+}
+function selectTemplates(platform) {
+    if (platform === "github")
+        return GITHUB_TEMPLATES;
+    if (platform === "gitlab")
+        return GITLAB_TEMPLATES;
+    return [...GITHUB_TEMPLATES, ...GITLAB_TEMPLATES];
+}
+export async function buildPlan(repoRoot, platform, mainBranch, repoName) {
+    const specs = selectTemplates(platform);
+    const out = [];
+    for (const spec of specs) {
+        const raw = await readFile(join(TEMPLATES_DIR, spec.templateFile), "utf8");
+        const rendered = interpolate(raw, { MAIN_BRANCH: mainBranch, REPO_NAME: repoName });
+        out.push({ outputPath: spec.outputPath(repoRoot), contents: rendered });
+    }
+    return out;
+}
+export async function runCiInit(opts) {
+    const repoRoot = resolve(opts.repo ?? process.cwd());
+    const mainBranch = opts.mainBranch ?? "main";
+    const repoName = basename(repoRoot);
+    const platform = opts.platform ?? (await detectPlatform(repoRoot));
+    const force = opts.force === true;
+    const plan = await buildPlan(repoRoot, platform, mainBranch, repoName);
+    if (!force) {
+        const conflicts = [];
+        for (const item of plan) {
+            if (await pathExists(item.outputPath)) {
+                conflicts.push(item.outputPath);
+            }
+        }
+        if (conflicts.length > 0) {
+            const lines = conflicts.map((p) => `  - ${p}`).join("\n");
+            throw new Error(`codehub ci-init: refusing to overwrite ${conflicts.length} existing file(s):\n${lines}\nRe-run with --force to overwrite.`);
+        }
+    }
+    for (const item of plan) {
+        await mkdir(dirname(item.outputPath), { recursive: true });
+        await writeFile(item.outputPath, item.contents, "utf8");
+    }
+    console.warn(`codehub ci-init: wrote ${plan.length} workflow file(s) for platform=${platform} (main branch: ${mainBranch}).`);
+}
+//# sourceMappingURL=ci-init.js.map

package/dist/commands/ci-init.js.map

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

package/dist/commands/clean.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `codehub clean [path]` — delete the `.codehub/` directory for a repo, and
+ * remove the registry entry.
+ *
+ * `--all` clears every repo listed in the registry, then truncates the
+ * registry file.
+ */
+export interface CleanOptions {
+    readonly all?: boolean;
+    readonly home?: string;
+}
+export declare function runClean(path: string, opts?: CleanOptions): Promise<void>;
+//# sourceMappingURL=clean.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BnF"}

package/dist/commands/clean.js

@@ -0,0 +1,38 @@
+/**
+ * `codehub clean [path]` — delete the `.codehub/` directory for a repo, and
+ * remove the registry entry.
+ *
+ * `--all` clears every repo listed in the registry, then truncates the
+ * registry file.
+ */
+import { rm } from "node:fs/promises";
+import { resolve } from "node:path";
+import { resolveRepoMetaDir } from "@opencodehub/storage";
+import { clearRegistry, findRegistryEntryByPath, readRegistry, removeFromRegistry, } from "../registry.js";
+export async function runClean(path, opts = {}) {
+    const registryOpts = opts.home !== undefined ? { home: opts.home } : {};
+    if (opts.all) {
+        const registry = await readRegistry(registryOpts);
+        let count = 0;
+        for (const entry of Object.values(registry)) {
+            try {
+                await rm(resolveRepoMetaDir(entry.path), { recursive: true, force: true });
+                count += 1;
+            }
+            catch (err) {
+                console.warn(`codehub clean: failed for ${entry.path}: ${err.message}`);
+            }
+        }
+        await clearRegistry(registryOpts);
+        console.warn(`codehub clean --all: removed ${count} index(es).`);
+        return;
+    }
+    const repoPath = resolve(path);
+    await rm(resolveRepoMetaDir(repoPath), { recursive: true, force: true });
+    const entry = await findRegistryEntryByPath(repoPath, registryOpts);
+    if (entry !== undefined) {
+        await removeFromRegistry(entry.name, registryOpts);
+    }
+    console.warn(`codehub clean: removed index at ${repoPath}`);
+}
+//# sourceMappingURL=clean.js.map

package/dist/commands/clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.js","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,YAAY,EACZ,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAOxB,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAqB,EAAE;IAClE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAExE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;QAClD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC3E,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,6BAA6B,KAAK,CAAC,IAAI,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;QACD,MAAM,aAAa,CAAC,YAAY,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,gCAAgC,KAAK,aAAa,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,MAAM,uBAAuB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACpE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,kBAAkB,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/commands/code-pack.d.ts

@@ -0,0 +1,105 @@
+/**
+ * `codehub code-pack [path]` — produce the deterministic 9-item BOM via
+ * `@opencodehub/pack`.
+ *
+ * Output goes to `<repo>/.codehub/packs/<packHash>/` so a pack's identity
+ * is encoded in its on-disk path. The function writes to a temp directory
+ * first, then renames into place once the manifest's `packHash` is known
+ * — this keeps the path-includes-hash invariant without requiring
+ * `generatePack` to know its own hash up front.
+ *
+ * Two engines are supported via the `--engine` flag:
+ *   - `pack` (DEFAULT) — `@opencodehub/pack`'s `generatePack`. Opens a
+ *     read-only graph store via `openStore({ readOnly: true })` and walks
+ *     the indexed graph to produce the 8 mandatory BOM items + manifest +
+ *     optional Parquet embeddings sidecar. The sidecar emitter lives in
+ *     `@opencodehub/pack`; cli/ passes the composed `Store` and pack
+ *     dispatches on `store.backend` (DuckDB COPY for `duck`, degraded
+ *     stamp for `lbug` v1).
+ *   - `repomix` — legacy single-file snapshot via `npx repomix`. Retained
+ *     under an opt-in flag for one milestone before removal. Internally
+ *     delegates to `runPack` so the repomix shell-out is implemented
+ *     exactly once.
+ *
+ * The CLI surface is:
+ *
+ *   codehub code-pack [path]
+ *     [--budget <N>]        token budget (default 100_000)
+ *     [--tokenizer <ID>]    "<vendor>:<name>@<pin>" (default openai:o200k_base@tiktoken-0.8.0)
+ *     [--out-dir <DIR>]     overrides the .codehub/packs/<packHash>/ default
+ *     [--engine pack|repomix]  default "pack"
+ *
+ * Exits non-zero on missing index (the pack engine requires `codehub
+ * analyze` to have already populated the graph store).
+ */
+import { generatePack, type PackManifest } from "@opencodehub/pack";
+import { type IGraphStore, type Store } from "@opencodehub/storage";
+import { runPack } from "./pack.js";
+/** Default token budget when `--budget` is omitted. */
+export declare const DEFAULT_BUDGET_TOKENS = 100000;
+/** Default tokenizer identifier when `--tokenizer` is omitted. */
+export declare const DEFAULT_TOKENIZER_ID = "openai:o200k_base@tiktoken-0.8.0";
+/** Default engine when `--engine` is omitted — the new `@opencodehub/pack` BOM. */
+export declare const DEFAULT_ENGINE: "pack" | "repomix";
+export interface CodePackArgs {
+    /** Path to the repo. Defaults to `process.cwd()` when omitted. */
+    readonly repo?: string;
+    /** Token budget passed to the AST chunker. Defaults to 100_000. */
+    readonly budget?: number;
+    /** Tokenizer identifier ("<vendor>:<name>@<pin>"). */
+    readonly tokenizer?: string;
+    /** Override the `.codehub/packs/<packHash>/` default. */
+    readonly outDir?: string;
+    /** Engine: "pack" (default) or "repomix" (legacy opt-in). */
+    readonly engine?: "pack" | "repomix";
+    /**
+     * Test seam — inject a custom `generatePack` so unit tests don't need
+     * to load native DuckDB bindings. Production callers leave this
+     * unset.
+     */
+    readonly _generatePack?: typeof generatePack;
+    /**
+     * Test seam — inject a pre-opened {@link Store} (or a graph-only
+     * stand-in via {@link IGraphStore}) so unit tests can stub the graph
+     * entirely. Production callers leave this unset; the command opens a
+     * composed store via `openStore` on demand. Backwards-compatible:
+     * tests that only need graph reads can keep passing a plain
+     * `IGraphStore` and the command auto-wraps it.
+     */
+    readonly _store?: Store | IGraphStore;
+    /**
+     * Test seam — inject a custom `runPack` so unit tests don't actually
+     * shell-out to `npx repomix`. Production callers leave this unset.
+     */
+    readonly _runRepomix?: typeof runPack;
+}
+export interface CodePackResult {
+    /** Final on-disk directory containing the BOM. */
+    readonly outDir: string;
+    /** SHA256 of the manifest's canonical JSON (excluding `packHash`). */
+    readonly packHash: string;
+    /**
+     * Number of artifacts on disk that contribute to the BOM (mandatory
+     * 8 BOM items + manifest = 9; +1 if the embeddings.parquet sidecar
+     * was emitted). For the repomix engine this is 1 — repomix produces a
+     * single output file rather than the 9-item BOM.
+     */
+    readonly bomItemCount: number;
+    /** The pack manifest. `null` for the repomix engine — it does not produce one. */
+    readonly manifest: PackManifest | null;
+    /** Engine that produced the result. */
+    readonly engine: "pack" | "repomix";
+    /**
+     * On the repomix path, the absolute path of the single repomix output
+     * file. Undefined on the pack path (the pack engine writes a
+     * directory; consumers should walk `outDir`).
+     */
+    readonly repomixOutputPath?: string;
+}
+export declare function runCodePack(args?: CodePackArgs): Promise<CodePackResult>;
+/**
+ * Read the on-disk size of `path`. Exported so the CLI's user-facing
+ * recap can format byte counts without re-walking the dir tree.
+ */
+export declare function statSizeOrZero(path: string): number;
+//# sourceMappingURL=code-pack.d.ts.map

package/dist/commands/code-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-pack.d.ts","sourceRoot":"","sources":["../../src/commands/code-pack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAOH,OAAO,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,KAAK,WAAW,EAA4B,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC9F,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,uDAAuD;AACvD,eAAO,MAAM,qBAAqB,SAAU,CAAC;AAE7C,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,qCAAqC,CAAC;AAEvE,mFAAmF;AACnF,eAAO,MAAM,cAAc,EAAE,MAAM,GAAG,SAAkB,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,YAAY,CAAC;IAC7C;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,OAAO,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IACvC,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,wBAAsB,WAAW,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAQlF;AAuHD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMnD"}