repocairn 0.1.1

package/README.md

@@ -0,0 +1,130 @@
+# repocairn
+
+**Persistent, token-efficient repository memory for AI tools.**
+
+`repocairn` builds a compact index of every file in a repo — exported symbols, resolved import graph, and a one-paragraph LLM summary per file — and keeps it current incrementally (only changed files are re-indexed). Any AI tool can then query that memory instead of re-reading the codebase: as an **MCP server**, a **CLI**, or a **TypeScript library**.
+
+The index lives at `.repocairn/index.json`, committed to the repo: transparent, versioned with the code, shared by local runs, CI, and every tool on the team.
+
+## Quick start
+
+```bash
+npm install -g repocairn   # or: npm i -D repocairn
+
+# One-shot onboarding: config + git hooks + first index (llm off by default)
+repocairn init
+
+# Optional: enable LLM summaries in package.json#repocairn or .repocairn.yml (`llm: true`)
+# then: repocairn index --llm
+```
+
+`init` writes `package.json#repocairn` (or `.repocairn.yml` with `--yml`), installs **pre-commit** / **pre-push** hooks that re-index only the files you touch, and builds `.repocairn/index.json`. Commit the index so agents and CI can read it. repocairn itself has **no CI integration** — hooks keep the brain fresh locally.
+
+Manual updates anytime: `repocairn index` (respects config `llm` / `ignore`; `--llm` / `--no-llm` override).
+
+## MCP server — plug the memory into any AI assistant
+
+```bash
+# Claude Code
+claude mcp add repocairn -- repocairn mcp
+
+# Cursor / Windsurf / any MCP client (.mcp.json / mcp.json)
+{
+  "mcpServers": {
+    "repocairn": { "command": "repocairn", "args": ["mcp"] }
+  }
+}
+```
+
+Tools exposed:
+
+| Tool | What it answers |
+|---|---|
+| `get_context` | "What depends on these files?" — token-budgeted summaries + symbols of importers, imports, and the files themselves |
+| `search_symbols` | "Where is X?" — substring search over exported symbols and paths |
+| `file_info` | "Tell me about this file" — summary, symbols, imports, and importers |
+
+## Config
+
+Precedence: `.repocairn.yml` → `package.json#repocairn` → defaults.
+
+```yaml
+# .repocairn.yml
+hooks:
+  pre-commit: true
+  pre-push: true
+llm: false          # default — no API key needed for hooks
+ignore: []
+```
+
+## CLI
+
+```bash
+repocairn init [--yml] [--no-hooks] [--no-index] [--force]
+repocairn hook pre-commit|pre-push                      # used by git hooks
+repocairn index [--full] [--llm|--no-llm] [--ignore <glob>]...
+repocairn context src/auth.ts src/db.ts --budget 8000   # context for a change
+repocairn query login                                   # symbol/path search
+repocairn query src/auth.ts --file                      # one file's full record
+repocairn setup                                         # wire MCP into AI tools
+repocairn mcp                                           # stdio MCP server
+```
+
+## Library
+
+```ts
+import { runIndex, loadIndex, selectContext, searchSymbols } from "repocairn";
+
+await runIndex({ cwd, llm: true });
+const index = await loadIndex(cwd);
+const { rendered } = selectContext(index!, ["src/auth.ts"], 8000);
+```
+
+`selectContext` is deterministic — no LLM call. For each changed file the import graph yields its **importers** first (the code that breaks if the change is wrong), then its imports, ranked by how many changed files they touch, packed into the token budget.
+
+## Providers
+
+Anthropic is the default (schema-constrained output via the official SDK). Any OpenAI-compatible endpoint also works:
+
+| Provider | Env vars |
+|---|---|
+| Anthropic (default) | `ANTHROPIC_API_KEY` (model defaults to `claude-opus-4-8`; override with `REPOCAIRN_MODEL`) |
+| OpenRouter | `OPENROUTER_API_KEY` + `REPOCAIRN_MODEL` |
+| OpenAI | `OPENAI_API_KEY` + `REPOCAIRN_MODEL` |
+| Any OpenAI-compatible endpoint | `REPOCAIRN_BASE_URL` + `REPOCAIRN_API_KEY` + `REPOCAIRN_MODEL` |
+
+Force a provider with `REPOCAIRN_PROVIDER=anthropic|openai|openrouter|openai-compatible`. `PR_REVIEW_*` spellings are accepted as aliases.
+
+## Staying in sync after code changes
+
+Not automatic-on-every-save, and not a full rebuild each time — it's git-triggered and hash-incremental:
+
+- **When it regenerates**: the `pre-commit` hook (installed by `repocairn init`) re-indexes exactly the files you `git add`, on every commit. `pre-push` catches anything that slipped through (e.g. `git commit --no-verify`) by diffing the commits about to be pushed. No hook, no daemon, no polling — if you never commit, the index never moves. Manual trigger anytime: `repocairn index`.
+- **How it knows what changed**: each file's sha1 content hash is stored in `.repocairn/index.json`. On update, only files whose hash differs from what's stored (or that are new) get re-extracted and re-summarized (`planIndexUpdate` in `src/indexer.ts`). Files deleted from disk are pruned from the index. Untouched files are copied over as-is — **not** re-read, re-parsed, or re-summarized.
+- **Why it's cheap**: symbol/import extraction (AST via TS compiler API or tree-sitter) is fast and free — it's the LLM summary call per file that costs money/time, and that's exactly what hash-skipping avoids re-paying for. A 1-line commit touching 1 file does 1 file's worth of work, not the whole repo's, regardless of repo size.
+- **Full rebuild**: `repocairn index --full` (or `init --force`) ignores hashes and re-does every file — use after upgrading repocairn itself (extraction logic changed) or if the index looks corrupted, not for routine use.
+
+## Index format
+
+Per file: content hash (sha1), exported symbol signatures, resolved imports (language-dependent, see below), and a one-paragraph LLM summary. Re-runs re-extract and re-summarize **only files whose hash changed**; deleted files are pruned. Keys are sorted for stable git diffs.
+
+### Language support
+
+| Language | Symbols | Imports resolved | Notes |
+|---|---|---|---|
+| TypeScript / JavaScript (`.ts .tsx .mts .cts .js .jsx .mjs .cjs`) | ✅ real AST (TS compiler API) | ✅ full relative-import resolution | Also drives `.vue`/`.svelte` via their `<script>` block |
+| Python (`.py`) | ✅ tree-sitter AST | ✅ dotted module paths (`from a.b import`, relative levels) | |
+| C / C++ (`.c .h .cpp .hpp`) | ✅ tree-sitter AST | ✅ literal `#include "x.h"` (same-dir or repo-root) | Doesn't follow compiler `-I` search paths, doesn't descend into `#ifdef`/`#if` blocks, angle-bracket `<system.h>` includes skipped |
+| PHP (`.php`) | ✅ tree-sitter AST | ✅ literal `require`/`require_once`/`include`/`include_once` with a plain string arg | `use Foo\Bar;` (PSR-4 autoload) not resolved — needs `composer.json` awareness; `__DIR__ . '/x.php'` concatenations skipped |
+| Go, Rust, Java, Kotlin, C# | ✅ tree-sitter AST | ❌ symbols only | Import specs are module/package paths (`go.mod`, crate tree, classpath, `.csproj`), not file paths — resolving them needs build-manifest awareness repocairn doesn't have yet |
+| Ruby (`.rb`) | ✅ tree-sitter AST | ❌ symbols only | `require`/`require_relative` not resolved yet (known gap — `require_relative` is a literal relative path and would be a cheap follow-up) |
+| Swift (`.swift`) | ⚠️ regex fallback only | ⚠️ regex best-effort | No tree-sitter support: the bundled `tree-sitter-swift.wasm` corrupts the shared WASM heap on real-world source under this package's runtime (confirmed on real repos — one file poisons memory for every later parse in the process, eventually OOMing), and no working alternative build is available |
+| Anything else | ⚠️ regex fallback | ⚠️ regex best-effort | Line-pattern heuristics (`def`/`class`/`func`/`import`/`require`/etc.), same-dir/repo-root resolution |
+
+Symbols-only languages still feed the index and `get_context`/`search_symbols` — they just don't contribute import-graph edges (no importer/imports ranking in `selectContext` for those files' cross-references).
+
+Built as the memory layer of [secondpair](../..), which reviews PRs with whole-repo context from this index.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import path from "node:path";
+import pc from "picocolors";
+import { loadRepoCairnConfig } from "./config.js";
+import { selectContext } from "./graph.js";
+import { runHook } from "./hooks.js";
+import { runIndex } from "./index-command.js";
+import { runInit } from "./init.js";
+import { runMcpServer } from "./mcp.js";
+import { getFileInfo, searchSymbols } from "./query.js";
+import { runSetup, TARGETS } from "./setup.js";
+import { indexPath, loadIndex } from "./store.js";
+const program = new Command();
+const log = (msg) => console.error(pc.dim(msg));
+const collect = (v, acc) => [...acc, v];
+async function requireIndex(cwd) {
+    const index = await loadIndex(cwd);
+    if (!index) {
+        throw new Error(`No index at ${indexPath(cwd)}. Run \`repocairn index\` first.`);
+    }
+    return index;
+}
+function resolveLlmFlag(configLlm) {
+    if (process.argv.includes("--no-llm"))
+        return false;
+    if (process.argv.includes("--llm"))
+        return true;
+    return configLlm;
+}
+program
+    .name("repocairn")
+    .description("Persistent repository memory for AI tools — symbols, import graph and LLM summaries per file")
+    .version("0.1.0");
+program
+    .command("init")
+    .description("Write config, install git hooks, and build the first index")
+    .option("--yml", "write .repocairn.yml instead of package.json#repocairn", false)
+    .option("--no-hooks", "skip installing git hooks")
+    .option("--no-index", "skip the initial index build")
+    .option("--force", "overwrite existing hooks / config", false)
+    .option("--dir <path>", "repository root", process.cwd())
+    .action(async (opts) => {
+    const cwd = path.resolve(opts.dir);
+    const result = await runInit(cwd, {
+        yml: opts.yml,
+        noHooks: opts.hooks === false,
+        noIndex: opts.index === false,
+        force: opts.force,
+        log,
+    });
+    for (const s of result.steps)
+        console.log(pc.green(`✔ ${s}`));
+    console.log(pc.dim("Next: commit .repocairn/index.json so agents and CI can read the brain. Optional: repocairn setup"));
+});
+program
+    .command("hook <phase>")
+    .description("Run from git hooks: pre-commit | pre-push")
+    .option("--dir <path>", "repository root", process.cwd())
+    .action(async (phase, opts) => {
+    if (phase !== "pre-commit" && phase !== "pre-push") {
+        throw new Error(`Unknown hook phase "${phase}". Use pre-commit or pre-push.`);
+    }
+    const cwd = path.resolve(opts.dir);
+    let stdinText = "";
+    if (phase === "pre-push" && !process.stdin.isTTY) {
+        const chunks = [];
+        for await (const chunk of process.stdin)
+            chunks.push(chunk);
+        stdinText = Buffer.concat(chunks).toString("utf8");
+    }
+    const result = await runHook(cwd, phase, { stdinText, log });
+    if (result.skipped && result.reason && result.reason !== "no paths") {
+        log(`Skipped: ${result.reason}`);
+    }
+    if (result.stats) {
+        console.log(pc.green(`Index updated: ${result.stats.indexed} indexed, ${result.stats.removed} removed (${result.stats.total} files).`));
+    }
+});
+program
+    .command("index")
+    .description("Build or incrementally update the repo index (.repocairn/index.json)")
+    .option("--full", "re-index every file regardless of content hash", false)
+    .option("--llm", "force LLM summaries on (overrides config)")
+    .option("--no-llm", "skip LLM summaries (overrides config)")
+    .option("--ignore <glob>", "extra ignore pattern (repeatable)", collect, [])
+    .option("--dir <path>", "repository root", process.cwd())
+    .action(async (opts) => {
+    const cwd = path.resolve(opts.dir);
+    const config = await loadRepoCairnConfig(cwd);
+    const llm = resolveLlmFlag(config.llm);
+    const ignore = [...config.ignore, ...opts.ignore];
+    const stats = await runIndex({ cwd, full: opts.full, llm, ignore, log });
+    console.log(pc.green(`Index updated: ${stats.indexed} indexed, ${stats.unchanged} unchanged, ${stats.removed} removed (${stats.total} files).`));
+});
+program
+    .command("context <files...>")
+    .description("Print token-budgeted repo context (importers, imports, summaries) for the given files")
+    .option("--budget <tokens>", "approximate token budget", (v) => parseInt(v, 10), 8000)
+    .option("--dir <path>", "repository root", process.cwd())
+    .action(async (files, opts) => {
+    const index = await requireIndex(path.resolve(opts.dir));
+    const { entries, rendered } = selectContext(index, files, opts.budget);
+    if (entries.length === 0) {
+        console.log(pc.yellow("No context found for those files in the index."));
+        return;
+    }
+    console.log(rendered);
+});
+program
+    .command("query <term>")
+    .description("Search indexed file paths and exported symbols; use `query <path> --file` for one file's full record")
+    .option("--file", "treat the term as an exact file path and print its full record", false)
+    .option("--limit <n>", "max results", (v) => parseInt(v, 10), 20)
+    .option("--dir <path>", "repository root", process.cwd())
+    .action(async (term, opts) => {
+    const index = await requireIndex(path.resolve(opts.dir));
+    if (opts.file) {
+        const info = getFileInfo(index, term);
+        if (!info)
+            throw new Error(`"${term}" is not in the index.`);
+        console.log(JSON.stringify(info, null, 2));
+        return;
+    }
+    const matches = searchSymbols(index, term, opts.limit);
+    if (matches.length === 0) {
+        console.log(pc.yellow(`No matches for "${term}".`));
+        return;
+    }
+    for (const m of matches) {
+        console.log(pc.bold(m.path));
+        for (const s of m.symbols)
+            console.log(`  ${s}`);
+        if (m.summary)
+            console.log(pc.dim(`  ${m.summary}`));
+    }
+});
+program
+    .command("setup")
+    .description("Detect installed AI tools and wire repocairn in: MCP registration, usage rule, skill")
+    .option("-t, --target <id>", "set up a specific target, repeatable (skips detection)", collect, [])
+    .option("--list", "list known targets")
+    .option("--dir <path>", "repository root", process.cwd())
+    .action(async (opts) => {
+    if (opts.list) {
+        for (const t of TARGETS)
+            console.log(`${t.id.padEnd(10)} ${t.label}`);
+        return;
+    }
+    const steps = await runSetup(path.resolve(opts.dir), { targets: opts.target });
+    if (steps.length === 0) {
+        console.log(pc.green("Already set up — nothing to do."));
+        return;
+    }
+    for (const s of steps)
+        console.log(pc.green(`✔ ${s}`));
+    console.log(pc.dim("Commit these files so the whole team shares the memory."));
+});
+program
+    .command("mcp")
+    .description("Run an MCP server (stdio) exposing the repo memory to AI tools")
+    .option("--dir <path>", "repository root", process.cwd())
+    .action(async (opts) => {
+    await runMcpServer(path.resolve(opts.dir));
+});
+program.parseAsync().catch((err) => {
+    console.error(pc.red(err instanceof Error ? err.message : String(err)));
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+export declare const REPOCAIRN_YML = ".repocairn.yml";
+export declare const PACKAGE_JSON = "package.json";
+declare const configSchema: z.ZodObject<{
+    hooks: z.ZodOptional<z.ZodObject<{
+        "pre-commit": z.ZodOptional<z.ZodBoolean>;
+        "pre-push": z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    llm: z.ZodOptional<z.ZodBoolean>;
+    ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type RepoCairnConfig = {
+    hooks: {
+        "pre-commit": boolean;
+        "pre-push": boolean;
+    };
+    llm: boolean;
+    ignore: string[];
+};
+export declare const DEFAULT_REPOCAIRN_CONFIG: RepoCairnConfig;
+export declare function mergeRepoCairnConfig(partial: z.infer<typeof configSchema> | undefined): RepoCairnConfig;
+/**
+ * Load config: `.repocairn.yml` wins over `package.json#repocairn`, else defaults.
+ */
+export declare function loadRepoCairnConfig(cwd: string): Promise<RepoCairnConfig>;
+/** Serialize config for `.repocairn.yml`. */
+export declare function formatRepoCairnYml(config: RepoCairnConfig): string;
+export {};

package/dist/config.js

@@ -0,0 +1,84 @@
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import YAML from "yaml";
+import { z } from "zod";
+import { readJsonFile } from "./store.js";
+export const REPOCAIRN_YML = ".repocairn.yml";
+export const PACKAGE_JSON = "package.json";
+const hooksSchema = z
+    .object({
+    "pre-commit": z.boolean().optional(),
+    "pre-push": z.boolean().optional(),
+})
+    .strict()
+    .optional();
+const configSchema = z
+    .object({
+    hooks: hooksSchema,
+    llm: z.boolean().optional(),
+    ignore: z.array(z.string()).optional(),
+})
+    .strict();
+export const DEFAULT_REPOCAIRN_CONFIG = {
+    hooks: { "pre-commit": true, "pre-push": true },
+    llm: false,
+    ignore: [],
+};
+export function mergeRepoCairnConfig(partial) {
+    const p = partial ?? {};
+    return {
+        hooks: {
+            "pre-commit": p.hooks?.["pre-commit"] ?? DEFAULT_REPOCAIRN_CONFIG.hooks["pre-commit"],
+            "pre-push": p.hooks?.["pre-push"] ?? DEFAULT_REPOCAIRN_CONFIG.hooks["pre-push"],
+        },
+        llm: p.llm ?? DEFAULT_REPOCAIRN_CONFIG.llm,
+        ignore: p.ignore ?? [],
+    };
+}
+/**
+ * Load config: `.repocairn.yml` wins over `package.json#repocairn`, else defaults.
+ */
+export async function loadRepoCairnConfig(cwd) {
+    const ymlPath = path.join(cwd, REPOCAIRN_YML);
+    if (existsSync(ymlPath)) {
+        const raw = YAML.parse(await readFile(ymlPath, "utf8")) ?? {};
+        return parsePartial(raw, REPOCAIRN_YML);
+    }
+    const pkgPath = path.join(cwd, PACKAGE_JSON);
+    if (existsSync(pkgPath)) {
+        let pkg;
+        try {
+            pkg = await readJsonFile(pkgPath);
+        }
+        catch {
+            return { ...DEFAULT_REPOCAIRN_CONFIG, ignore: [] };
+        }
+        if (pkg && typeof pkg === "object" && "repocairn" in pkg) {
+            const block = pkg.repocairn;
+            if (block !== undefined && block !== null) {
+                return parsePartial(block, `${PACKAGE_JSON}#repocairn`);
+            }
+        }
+    }
+    return { ...DEFAULT_REPOCAIRN_CONFIG, ignore: [] };
+}
+function parsePartial(raw, label) {
+    const parsed = configSchema.safeParse(raw ?? {});
+    if (!parsed.success) {
+        const issues = parsed.error.issues
+            .map((i) => `  ${i.path.join(".") || "(root)"}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Invalid ${label}:\n${issues}`);
+    }
+    return mergeRepoCairnConfig(parsed.data);
+}
+/** Serialize config for `.repocairn.yml`. */
+export function formatRepoCairnYml(config) {
+    return YAML.stringify({
+        hooks: config.hooks,
+        llm: config.llm,
+        ignore: config.ignore,
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAC9C,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC;KACD,MAAM,EAAE;KACR,QAAQ,EAAE,CAAC;AAEd,MAAM,YAAY,GAAG,CAAC;KACnB,MAAM,CAAC;IACN,KAAK,EAAE,WAAW;IAClB,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvC,CAAC;KACD,MAAM,EAAE,CAAC;AAQZ,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,KAAK,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;IAC/C,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,EAAE;CACX,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,OAAiD;IACpF,MAAM,CAAC,GAAG,OAAO,IAAI,EAAE,CAAC;IACxB,OAAO;QACL,KAAK,EAAE;YACL,YAAY,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC,IAAI,wBAAwB,CAAC,KAAK,CAAC,YAAY,CAAC;YACrF,UAAU,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,UAAU,CAAC,IAAI,wBAAwB,CAAC,KAAK,CAAC,UAAU,CAAC;SAChF;QACD,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,wBAAwB,CAAC,GAAG;QAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;KACvB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAW;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9D,OAAO,YAAY,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,IAAI,GAAY,CAAC;QACjB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,GAAG,wBAAwB,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACrD,CAAC;QACD,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,WAAW,IAAI,GAAG,EAAE,CAAC;YACzD,MAAM,KAAK,GAAI,GAA8B,CAAC,SAAS,CAAC;YACxD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,OAAO,YAAY,CAAC,KAAK,EAAE,GAAG,YAAY,YAAY,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,wBAAwB,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,YAAY,CAAC,GAAY,EAAE,KAAa;IAC/C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAC7D,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,MAAM,MAAM,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,kBAAkB,CAAC,MAAuB;IACxD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;AACL,CAAC"}

package/dist/git-paths.d.ts

@@ -0,0 +1,20 @@
+export type HookPhase = "pre-commit" | "pre-push";
+export declare function filterHookPaths(paths: string[], ignore?: string[]): string[];
+/** Staged paths for pre-commit (added/changed/renamed + deleted). */
+export declare function listStagedPaths(cwd: string, ignore?: string[]): Promise<{
+    update: string[];
+    removed: string[];
+}>;
+/** Files changed in a commit range (pre-push). */
+export declare function listRangePaths(cwd: string, range: string, ignore?: string[]): Promise<{
+    update: string[];
+    removed: string[];
+}>;
+/**
+ * Resolve push ranges from pre-push stdin lines:
+ * `<local_ref> <local_sha> <remote_ref> <remote_sha>`
+ */
+export declare function listPushPaths(cwd: string, stdinText: string, ignore?: string[]): Promise<{
+    update: string[];
+    removed: string[];
+}>;

package/dist/git-paths.js

@@ -0,0 +1,108 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { isIndexableSourcePath } from "./indexer.js";
+const exec = promisify(execFile);
+async function gitLines(cwd, args) {
+    const { stdout } = await exec("git", args, { cwd, maxBuffer: 32 * 1024 * 1024 });
+    return stdout
+        .split("\n")
+        .map((l) => l.trim())
+        .filter(Boolean);
+}
+export function filterHookPaths(paths, ignore = []) {
+    return paths.filter((f) => isIndexableSourcePath(f, ignore));
+}
+/** Staged paths for pre-commit (added/changed/renamed + deleted). */
+export async function listStagedPaths(cwd, ignore = []) {
+    const changed = await gitLines(cwd, [
+        "diff",
+        "--cached",
+        "--name-only",
+        "--diff-filter=ACMR",
+    ]);
+    const deleted = await gitLines(cwd, [
+        "diff",
+        "--cached",
+        "--name-only",
+        "--diff-filter=D",
+    ]);
+    return {
+        update: filterHookPaths(changed, ignore),
+        removed: filterHookPaths(deleted, ignore),
+    };
+}
+/** Files changed in a commit range (pre-push). */
+export async function listRangePaths(cwd, range, ignore = []) {
+    const changed = await gitLines(cwd, ["diff", "--name-only", "--diff-filter=ACMR", range]);
+    const deleted = await gitLines(cwd, ["diff", "--name-only", "--diff-filter=D", range]);
+    return {
+        update: filterHookPaths(changed, ignore),
+        removed: filterHookPaths(deleted, ignore),
+    };
+}
+/**
+ * Resolve push ranges from pre-push stdin lines:
+ * `<local_ref> <local_sha> <remote_ref> <remote_sha>`
+ */
+export async function listPushPaths(cwd, stdinText, ignore = []) {
+    const lines = stdinText
+        .split("\n")
+        .map((l) => l.trim())
+        .filter(Boolean);
+    const update = new Set();
+    const removed = new Set();
+    const add = async (range) => {
+        const r = await listRangePaths(cwd, range, ignore);
+        for (const p of r.update)
+            update.add(p);
+        for (const p of r.removed)
+            removed.add(p);
+    };
+    if (lines.length === 0) {
+        const range = await resolveDefaultPushRange(cwd);
+        if (range)
+            await add(range);
+        return { update: [...update], removed: [...removed] };
+    }
+    for (const line of lines) {
+        const parts = line.split(/\s+/);
+        if (parts.length < 4)
+            continue;
+        const localSha = parts[1];
+        const remoteSha = parts[3];
+        const zero = /^0+$/;
+        if (zero.test(localSha))
+            continue;
+        const range = zero.test(remoteSha) ? localSha : `${remoteSha}..${localSha}`;
+        await add(range);
+    }
+    return { update: [...update], removed: [...removed] };
+}
+async function resolveDefaultPushRange(cwd) {
+    try {
+        const { stdout } = await exec("git", ["rev-parse", "--abbrev-ref", "@{push}"], { cwd });
+        const remoteBranch = stdout.trim();
+        if (remoteBranch)
+            return `${remoteBranch}..HEAD`;
+    }
+    catch {
+        /* fall through */
+    }
+    try {
+        const { stdout } = await exec("git", ["merge-base", "HEAD", "origin/main"], { cwd });
+        const base = stdout.trim();
+        if (base)
+            return `${base}..HEAD`;
+    }
+    catch {
+        /* fall through */
+    }
+    try {
+        await exec("git", ["rev-parse", "HEAD~1"], { cwd });
+        return "HEAD~1..HEAD";
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=git-paths.js.map

package/dist/git-paths.js.map

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

package/dist/graph.d.ts

@@ -0,0 +1,20 @@
+import type { CodemapIndex } from "./types.js";
+export interface ContextEntry {
+    path: string;
+    /** Why this file was selected. */
+    relation: "importer" | "import" | "changed";
+    summary: string;
+    symbols: string[];
+}
+/** Rough token estimate: ~4 characters per token. */
+export declare function estimateTokens(text: string): number;
+/**
+ * Select codemap context for a set of changed files, packed into a token budget.
+ * Priority: direct importers of changed files (they break when the change is wrong),
+ * then direct imports (the APIs the change relies on), then the changed files'
+ * own summaries. Deterministic — no LLM call.
+ */
+export declare function selectContext(index: CodemapIndex, changedFiles: string[], tokenBudget: number): {
+    entries: ContextEntry[];
+    rendered: string;
+};