@opencodehub/cli 0.1.0

package/dist/commands/init.js

@@ -0,0 +1,315 @@
+/**
+ * `codehub init` — bootstrap a repository for OpenCodeHub in one command.
+ *
+ * Project-scope installer. Copies plugin assets (skills/agents/commands/hooks)
+ * into `<repo>/.claude/`, writes `.mcp.json` so Claude Code launches the
+ * `codehub` MCP server, appends `.codehub/` to `.gitignore`, and seeds a
+ * starter `opencodehub.policy.yaml` (commented out; rules ship in spec 002).
+ *
+ * Why project scope:
+ *   - Checking `.claude/` into git means every teammate's Claude Code
+ *     auto-discovers the plugin on clone. No per-machine install.
+ *   - Keeps the plugin pinned to the repo's graph schema; upgrades are
+ *     explicit (`codehub init --upgrade`) rather than ambient.
+ *
+ * Hook rewrite note:
+ *   The plugin's `hooks.json` uses `${CLAUDE_PLUGIN_ROOT}` which is only
+ *   bound for user-scope plugins. Project-scope hooks must use
+ *   `${CLAUDE_PROJECT_DIR}/.claude` for Claude Code to find the shell
+ *   scripts. We rewrite the token at install time and write the result
+ *   to `.claude/settings.json` (the project-scope equivalent of
+ *   `hooks.json`).
+ *
+ * Idempotence: re-running with identical args produces byte-identical
+ * output. Re-running against an existing `.claude/` refuses unless
+ * `--force` is set, and the error lists every conflicting file.
+ *
+ * Filesystem access goes through the same `FsApi` seam used by
+ * `commands/setup.ts` so tests run against an in-memory implementation.
+ */
+import { statSync } from "node:fs";
+import { access, 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 { dirname, join, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { writeFileAtomic as defaultWriteFileAtomic } from "../fs-atomic.js";
+import { runSetup } from "./setup.js";
+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 access(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    async readdir(path) {
+        return (await fsReaddir(path, { withFileTypes: false }));
+    },
+    async rename(src, dest) {
+        await fsRename(src, dest);
+    },
+    async rm(path, opts) {
+        await fsRm(path, opts);
+    },
+    async statIsDirectory(path) {
+        try {
+            const st = await fsStat(path);
+            return st.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    },
+};
+/**
+ * Entry point for `codehub init`. Returns a structured result; throws on
+ * unrecoverable error (e.g., plugin source missing, conflicts without
+ * `--force`).
+ */
+export async function runInit(opts = {}) {
+    const fs = opts.fs ?? DEFAULT_FS;
+    const log = opts.log ?? ((msg) => console.warn(msg));
+    const warn = opts.warn ?? ((msg) => console.warn(msg));
+    const repoRoot = resolve(opts.repo ?? process.cwd());
+    const sourceDir = opts.sourceDir ?? defaultPluginSourceDir();
+    const claudeDir = resolve(repoRoot, ".claude");
+    const force = opts.force === true;
+    if (!(await fs.exists(sourceDir))) {
+        throw new Error(`codehub init: plugin source not found at ${sourceDir}. Re-install the codehub CLI or run from a workspace checkout.`);
+    }
+    const plan = await buildInstallPlan(fs, sourceDir, claudeDir);
+    if (!force) {
+        const conflicts = await detectConflicts(fs, plan);
+        if (conflicts.length > 0) {
+            const lines = conflicts.map((p) => `  - ${relative(repoRoot, p)}`).join("\n");
+            throw new Error(`codehub init: refusing to overwrite ${conflicts.length} existing file(s):\n${lines}\nRe-run with --force to overwrite.`);
+        }
+    }
+    for (const step of plan) {
+        await fs.mkdir(dirname(step.targetPath));
+        if (step.source === "copy") {
+            await fs.copyFile(step.sourcePath, step.targetPath);
+        }
+        else {
+            await fs.writeFileAtomic(step.targetPath, step.contents);
+        }
+    }
+    const filesCopied = plan.length;
+    log(`codehub init: installed ${filesCopied} file(s) under ${relative(repoRoot, claudeDir)}/`);
+    // Write project-scope hooks — rewrite of the plugin's hooks.json.
+    const hooksTarget = resolve(claudeDir, "settings.json");
+    const hooksWritten = await writeProjectScopeHooks(fs, sourceDir, hooksTarget, log, warn);
+    // MCP entry via the existing setup pipeline (single editor: claude-code).
+    let mcpResult = null;
+    if (opts.skipMcp !== true) {
+        const setupOpts = {
+            editors: ["claude-code"],
+            projectRoot: repoRoot,
+            fs,
+            log,
+            warn,
+            ...(opts.home !== undefined ? { home: opts.home } : {}),
+        };
+        const results = await runSetup(setupOpts);
+        mcpResult = results[0] ?? null;
+    }
+    // Append `.codehub/` to .gitignore (idempotent).
+    const gitignoreUpdated = await ensureGitignoreEntry(fs, repoRoot, ".codehub/", log);
+    // Seed opencodehub.policy.yaml (commented-out starter).
+    let policySeeded = false;
+    if (opts.skipPolicy !== true) {
+        policySeeded = await seedPolicyFile(fs, repoRoot, log);
+    }
+    return {
+        repoRoot,
+        sourceDir,
+        claudeDir,
+        filesCopied,
+        hooksWrittenTo: hooksWritten ? hooksTarget : null,
+        mcpResult,
+        gitignoreUpdated,
+        policySeeded,
+    };
+}
+async function buildInstallPlan(fs, sourceDir, claudeDir) {
+    const plan = [];
+    // The plugin root maps onto `.claude/` directly: skills → .claude/skills,
+    // agents → .claude/agents, commands → .claude/commands, hooks → .claude/hooks.
+    for (const entry of ["skills", "agents", "commands", "hooks"]) {
+        const src = join(sourceDir, entry);
+        const dest = join(claudeDir, entry);
+        if (!(await fs.exists(src)))
+            continue;
+        await collectCopySteps(fs, src, dest, plan);
+    }
+    return plan;
+}
+async function collectCopySteps(fs, src, dest, out) {
+    if (!fs.readdir) {
+        throw new Error("FsApi.readdir is required for init plan building");
+    }
+    const entries = await fs.readdir(src);
+    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) {
+            await collectCopySteps(fs, from, to, out);
+        }
+        else {
+            out.push({ source: "copy", sourcePath: from, targetPath: to });
+        }
+    }
+}
+async function detectConflicts(fs, plan) {
+    const conflicts = [];
+    for (const step of plan) {
+        if (await fs.exists(step.targetPath))
+            conflicts.push(step.targetPath);
+    }
+    return conflicts;
+}
+/**
+ * Convert the plugin's user-scope `hooks.json` into a project-scope
+ * `.claude/settings.json`. Claude Code resolves `${CLAUDE_PROJECT_DIR}` at
+ * runtime to the repo root, so we rewrite `${CLAUDE_PLUGIN_ROOT}` → that.
+ */
+async function writeProjectScopeHooks(fs, sourceDir, targetPath, log, warn) {
+    const pluginHooksPath = join(sourceDir, "hooks.json");
+    if (!(await fs.exists(pluginHooksPath))) {
+        warn(`codehub init: plugin hooks.json missing at ${pluginHooksPath}; skipping project-scope hook wire-up.`);
+        return false;
+    }
+    const raw = await fs.readFile(pluginHooksPath);
+    const rewritten = raw
+        // biome-ignore lint/suspicious/noTemplateCurlyInString: literal token to substitute
+        .replaceAll("${CLAUDE_PLUGIN_ROOT}", "${CLAUDE_PROJECT_DIR}/.claude");
+    const parsed = JSON.parse(rewritten);
+    // Merge into existing .claude/settings.json if present. Only the `hooks`
+    // key is upserted; every sibling key is preserved.
+    const existing = (await fs.exists(targetPath)) ? await fs.readFile(targetPath) : undefined;
+    const doc = existing && existing.trim().length > 0 ? JSON.parse(existing) : {};
+    doc["hooks"] = parsed["hooks"];
+    const merged = `${JSON.stringify(doc, null, 2)}\n`;
+    if (existing === merged) {
+        log(`codehub init: ${relative(dirname(dirname(targetPath)), targetPath)} already up to date`);
+        return true;
+    }
+    await fs.writeFileAtomic(targetPath, merged);
+    log(`codehub init: wrote hooks to ${targetPath}`);
+    return true;
+}
+async function ensureGitignoreEntry(fs, repoRoot, line, log) {
+    const target = join(repoRoot, ".gitignore");
+    const existing = (await fs.exists(target)) ? await fs.readFile(target) : "";
+    const lines = existing.split(/\r?\n/);
+    const alreadyPresent = lines.some((l) => l.trim() === line.trim());
+    if (alreadyPresent)
+        return false;
+    const suffix = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+    const appended = `${existing}${suffix}# OpenCodeHub local state\n${line}\n`;
+    await fs.writeFileAtomic(target, appended);
+    log(`codehub init: appended "${line}" to .gitignore`);
+    return true;
+}
+const POLICY_STARTER = `# OpenCodeHub policy (v1 — starter, all rules commented out)
+#
+# Consumed by 'codehub verdict' (ships in spec 002 P1). Uncomment the
+# rule types you want to enforce. Schema:
+#   packages/policy/schemas/policy-v1.json (once spec 002 lands)
+#
+# See ADR 0007 for scope rationale. Self-hosted OSS only — no calls
+# to any OpenCodeHub-operated service from this file or from the CI
+# actions that consume it.
+#
+# version: 1
+#
+# auto_approve:
+#   require:
+#     - blast_radius.tier: ">= 3"       # only tier-3-or-safer PRs auto-approve
+#     - findings.severity_error: 0
+#     - license_audit.violations: 0
+#
+# rules:
+#   - id: no-disallowed-licenses
+#     type: license_allowlist
+#     deny: ["GPL-3.0", "AGPL-3.0"]
+#
+#   - id: require-storage-owner
+#     type: ownership_required
+#     paths: ["packages/storage/**"]
+#     require_approval_from: ["@storage-team"]
+#
+#   - id: blast-radius-cap
+#     type: blast_radius_max
+#     max_tier: 2
+`;
+async function seedPolicyFile(fs, repoRoot, log) {
+    const target = join(repoRoot, "opencodehub.policy.yaml");
+    if (await fs.exists(target))
+        return false;
+    await fs.writeFileAtomic(target, POLICY_STARTER);
+    log(`codehub init: seeded opencodehub.policy.yaml (all rules commented out)`);
+    return true;
+}
+/**
+ * Resolve the bundled plugin source dir.
+ *
+ * When running from source inside the monorepo (e.g. `pnpm -F cli dev`),
+ * walk up to the repo root and read `plugins/opencodehub/`. When running
+ * from the published `dist/`, use the `dist/plugin-assets/` tree produced
+ * by `scripts/copy-plugin-assets.mjs`.
+ */
+function defaultPluginSourceDir() {
+    const thisFile = fileURLToPath(import.meta.url);
+    let dir = dirname(thisFile);
+    // First check: bundled dist assets (standard install case).
+    const bundled = join(dir, "..", "plugin-assets");
+    try {
+        const st = statSyncSafe(bundled);
+        if (st?.isDirectory())
+            return resolve(bundled);
+    }
+    catch {
+        // keep looking
+    }
+    // Fallback: walk up looking for `plugins/opencodehub/` (monorepo-source case).
+    for (let i = 0; i < 8; i += 1) {
+        const candidate = join(dir, "plugins", "opencodehub");
+        try {
+            const st = statSyncSafe(candidate);
+            if (st?.isDirectory())
+                return candidate;
+        }
+        catch {
+            // keep walking
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return resolve(dirname(thisFile), "..", "..", "..", "..", "plugins", "opencodehub");
+}
+function statSyncSafe(path) {
+    try {
+        return statSync(path);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/list.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `codehub list` — print one row per registered repo.
+ *
+ * Output is a plain-text table on stdout so users can pipe it through `awk`
+ * or similar. No JSON mode in MVP.
+ *
+ * Health check: each row gets an annotation column that flags dangling
+ * registry entries (path missing on disk) and missing graph DBs. A dangling
+ * entry happens when a repo is moved/deleted without running `codehub clean`
+ * — the registry keeps the stale pointer and every subsequent group / MCP
+ * lookup silently half-works. Surface it.
+ */
+export interface ListOptions {
+    readonly home?: string;
+}
+export declare function runList(opts?: ListOptions): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,OAAO,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CASnE"}

package/dist/commands/list.js

@@ -0,0 +1,79 @@
+/**
+ * `codehub list` — print one row per registered repo.
+ *
+ * Output is a plain-text table on stdout so users can pipe it through `awk`
+ * or similar. No JSON mode in MVP.
+ *
+ * Health check: each row gets an annotation column that flags dangling
+ * registry entries (path missing on disk) and missing graph DBs. A dangling
+ * entry happens when a repo is moved/deleted without running `codehub clean`
+ * — the registry keeps the stale pointer and every subsequent group / MCP
+ * lookup silently half-works. Surface it.
+ */
+import { existsSync } from "node:fs";
+import { codehubIsIndexed } from "../lib/is-indexed.js";
+import { readRegistry } from "../registry.js";
+export async function runList(opts = {}) {
+    const registryOpts = opts.home !== undefined ? { home: opts.home } : {};
+    const registry = await readRegistry(registryOpts);
+    const entries = Object.values(registry);
+    if (entries.length === 0) {
+        console.warn("No repos indexed yet. Run `codehub analyze` in a git repo.");
+        return;
+    }
+    printTable(entries);
+}
+function classifyHealth(entry) {
+    if (!existsSync(entry.path))
+        return "path-missing";
+    // Backend-aware probe: any of `meta.json`, `graph.duckdb`, or
+    // `graph.lbug` under `.codehub/` counts as "indexed". The legacy
+    // hard-coded `graph.duckdb` check pre-dated the M3 backend split and
+    // would have flagged every `CODEHUB_STORE=lbug` repo as broken.
+    if (!codehubIsIndexed(entry.path))
+        return "graph-missing";
+    return "ok";
+}
+function healthLabel(h) {
+    switch (h) {
+        case "ok":
+            return "ok";
+        case "path-missing":
+            return "⚠ missing path";
+        case "graph-missing":
+            return "⚠ no index";
+    }
+}
+function printTable(entries) {
+    const rows = entries.map((e) => {
+        const health = classifyHealth(e);
+        return {
+            name: e.name,
+            path: e.path,
+            lastCommit: e.lastCommit ? e.lastCommit.slice(0, 8) : "-",
+            indexedAt: e.indexedAt.slice(0, 19),
+            nodes: String(e.nodeCount),
+            health: healthLabel(health),
+        };
+    });
+    const headers = ["NAME", "PATH", "COMMIT", "INDEXED_AT", "NODES", "HEALTH"];
+    const widths = headers.map((h) => h.length);
+    for (const r of rows) {
+        widths[0] = Math.max(widths[0] ?? 0, r.name.length);
+        widths[1] = Math.max(widths[1] ?? 0, r.path.length);
+        widths[2] = Math.max(widths[2] ?? 0, r.lastCommit.length);
+        widths[3] = Math.max(widths[3] ?? 0, r.indexedAt.length);
+        widths[4] = Math.max(widths[4] ?? 0, r.nodes.length);
+        widths[5] = Math.max(widths[5] ?? 0, r.health.length);
+    }
+    const line = (cols) => cols.map((c, i) => c.padEnd(widths[i] ?? 0)).join("  ");
+    console.log(line(headers));
+    for (const r of rows) {
+        console.log(line([r.name, r.path, r.lastCommit, r.indexedAt, r.nodes, r.health]));
+    }
+    const unhealthy = rows.filter((r) => r.health !== "ok");
+    if (unhealthy.length > 0) {
+        console.warn(`\n${unhealthy.length} of ${rows.length} entries need attention. Run \`codehub clean <path>\` to remove a dangling entry, or re-analyze a missing graph.`);
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

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

package/dist/commands/mcp.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `codehub mcp` — launch the stdio MCP server.
+ *
+ * Surfaces a friendly error instead of a cryptic import failure when
+ * `@opencodehub/mcp` has not been built yet.
+ */
+export declare function runMcp(): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CA2B5C"}

package/dist/commands/mcp.js

@@ -0,0 +1,28 @@
+/**
+ * `codehub mcp` — launch the stdio MCP server.
+ *
+ * Surfaces a friendly error instead of a cryptic import failure when
+ * `@opencodehub/mcp` has not been built yet.
+ */
+export async function runMcp() {
+    let mod;
+    try {
+        // Dynamic string import so TypeScript does not require the dependency to
+        // be built at CLI build time. The @opencodehub/mcp package owns startStdioServer.
+        const specifier = "@opencodehub/mcp";
+        mod = await import(specifier);
+    }
+    catch (err) {
+        console.error(`codehub mcp: the @opencodehub/mcp package is not built yet. Build it first.\n` +
+            `  cause: ${err.message}`);
+        process.exit(2);
+    }
+    const candidate = mod;
+    if (typeof candidate.startStdioServer !== "function") {
+        console.error("codehub mcp: @opencodehub/mcp does not export startStdioServer(). " +
+            "Rebuild @opencodehub/mcp so it exports startStdioServer().");
+        process.exit(2);
+    }
+    await candidate.startStdioServer();
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,KAAK,UAAU,MAAM;IAC1B,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,yEAAyE;QACzE,kFAAkF;QAClF,MAAM,SAAS,GAAG,kBAAkB,CAAC;QACrC,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACX,+EAA+E;YAC7E,YAAa,GAAa,CAAC,OAAO,EAAE,CACvC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,GAEjB,CAAC;IACF,IAAI,OAAO,SAAS,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACrD,OAAO,CAAC,KAAK,CACX,oEAAoE;YAClE,4DAA4D,CAC/D,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,CAAC,gBAAgB,EAAE,CAAC;AACrC,CAAC"}

package/dist/commands/open-store.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Resolve a repo path — from `--repo <name>` if given, else from the CWD —
+ * and open a read-only `Store` (composed graph + temporal). Used by
+ * `query`, `context`, `impact`, `sql`, and `detect-changes`.
+ *
+ * Returns the canonical {@link Store} envelope from `@opencodehub/storage`
+ * so callers can route graph-tier queries through `store.graph` and
+ * temporal-tier queries (cochanges, summaries, `--sql` escape hatch)
+ * through `store.temporal`. Backend selection follows the standard
+ * `openStore` resolution (env-driven `CODEHUB_STORE`, with auto-detect
+ * when unset).
+ */
+import { type Store } from "@opencodehub/storage";
+export interface OpenStoreOptions {
+    readonly repo?: string;
+    readonly home?: string;
+    readonly readOnly?: boolean;
+    readonly backend?: "auto" | "duck" | "lbug";
+}
+export interface OpenStoreResult {
+    readonly repoPath: string;
+    readonly store: Store;
+}
+export declare function openStoreForCommand(opts: OpenStoreOptions): Promise<OpenStoreResult>;
+//# sourceMappingURL=open-store.d.ts.map

package/dist/commands/open-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-store.d.ts","sourceRoot":"","sources":["../../src/commands/open-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAA4B,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAG5E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CAC7C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAkB1F"}

package/dist/commands/open-store.js

@@ -0,0 +1,47 @@
+/**
+ * Resolve a repo path — from `--repo <name>` if given, else from the CWD —
+ * and open a read-only `Store` (composed graph + temporal). Used by
+ * `query`, `context`, `impact`, `sql`, and `detect-changes`.
+ *
+ * Returns the canonical {@link Store} envelope from `@opencodehub/storage`
+ * so callers can route graph-tier queries through `store.graph` and
+ * temporal-tier queries (cochanges, summaries, `--sql` escape hatch)
+ * through `store.temporal`. Backend selection follows the standard
+ * `openStore` resolution (env-driven `CODEHUB_STORE`, with auto-detect
+ * when unset).
+ */
+import { resolve } from "node:path";
+import { openStore, resolveDbPath } from "@opencodehub/storage";
+import { readRegistry } from "../registry.js";
+export async function openStoreForCommand(opts) {
+    const repoPath = await resolveRepoPath(opts);
+    const dbPath = resolveDbPath(repoPath);
+    const store = await openStore({
+        path: dbPath,
+        backend: opts.backend ?? "auto",
+        readOnly: opts.readOnly ?? true,
+    });
+    // The legacy CLI entry point opened the DuckDB connection eagerly and
+    // every command consumed an already-open store. The `openStore` factory
+    // only constructs adapters; opening is the lifecycle owner's job. Keep
+    // that contract by opening both views here so command handlers stay a
+    // simple try/finally pair around the work.
+    await store.graph.open();
+    if (store.graphFile !== store.temporalFile) {
+        await store.temporal.open();
+    }
+    return { repoPath, store };
+}
+async function resolveRepoPath(opts) {
+    if (opts.repo !== undefined) {
+        const registryOpts = opts.home !== undefined ? { home: opts.home } : {};
+        const registry = await readRegistry(registryOpts);
+        const hit = registry[opts.repo];
+        if (hit)
+            return resolve(hit.path);
+        // Accept a raw path too.
+        return resolve(opts.repo);
+    }
+    return resolve(process.cwd());
+}
+//# sourceMappingURL=open-store.js.map

package/dist/commands/open-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-store.js","sourceRoot":"","sources":["../../src/commands/open-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAc,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAc9C,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAsB;IAC9D,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC;QAC5B,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,MAAM;QAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;KAChC,CAAC,CAAC;IACH,sEAAsE;IACtE,wEAAwE;IACxE,uEAAuE;IACvE,sEAAsE;IACtE,2CAA2C;IAC3C,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC;QAC3C,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAsB;IACnD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,YAAY,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,GAAG;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,yBAAyB;QACzB,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/dist/commands/pack.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `codehub pack [path]` — produce a single-file repo snapshot suitable
+ * for dropping into an LLM context window, via the `repomix` CLI.
+ *
+ * Repomix is invoked with `--style xml --compress` by default so the
+ * output is Anthropic-friendly and tree-sitter-signature-compressed. The
+ * command is an OUTPUT-side convenience; OpenCodeHub does NOT use
+ * repomix for indexing or embedding (see ADR 0004).
+ *
+ * This is a thin wrapper — we shell to `npx repomix@<pin>` so operators
+ * can override by running repomix directly. The wrapper exists to make
+ * the output path discoverable and to put the produced file under
+ * `.codehub/pack/` so it's ignored by the standard gitignore pattern.
+ */
+export interface PackOptions {
+    /** Output style: xml (default, Anthropic-friendly), markdown, json, or plain. */
+    readonly style?: "xml" | "markdown" | "json" | "plain";
+    /** When true (default) apply `--compress` for tree-sitter signature compression. */
+    readonly compress?: boolean;
+    /** When true, strip comments in the packed output. */
+    readonly removeComments?: boolean;
+    /** Custom output file path. Defaults to `<repo>/.codehub/pack/repo.<ext>`. */
+    readonly outputPath?: string;
+    /** Pin for `npx repomix@<pin>`. Defaults to the latest verified-compatible version. */
+    readonly repomixVersion?: string;
+    /** Timeout in ms. Defaults to 5 minutes. */
+    readonly timeoutMs?: number;
+}
+export interface PackResult {
+    readonly outputPath: string;
+    readonly bytes: number;
+    readonly durationMs: number;
+}
+export declare function runPack(path: string, opts?: PackOptions): Promise<PackResult>;
+//# sourceMappingURL=pack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../../src/commands/pack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IACvD,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,uFAAuF;IACvF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CA+CvF"}