seer-mcp 0.1.0

package/dist/indexer/externaldeps.js

@@ -0,0 +1,288 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractExternalDependencies = extractExternalDependencies;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const fast_glob_1 = __importDefault(require("fast-glob"));
+/**
+ * Walk the repo for known package manifests and emit one row per declared
+ * dependency. Idempotent: clears `external_dependencies` and re-inserts every
+ * call, so deletions in package.json are reflected on the next index.
+ *
+ * Supported ecosystems:
+ *   npm    package.json / package-lock.json / pnpm-lock.yaml (deps only)
+ *   cargo  Cargo.toml (Cargo.lock not parsed — duplicates would be noisy)
+ *   pypi   requirements.txt, pyproject.toml (PEP 621 [project.dependencies])
+ *   go     go.mod
+ *
+ * Manifest discovery uses fast-glob with the same ignores as the rest of the
+ * indexer (no node_modules, no vendor) so monorepos can be picked up from
+ * `packages/foo/package.json`.
+ */
+async function extractExternalDependencies(repoRoot, store) {
+    const abs = path_1.default.resolve(repoRoot);
+    const manifestPatterns = [
+        'package.json',
+        '**/package.json',
+        'Cargo.toml',
+        '**/Cargo.toml',
+        'pyproject.toml',
+        '**/pyproject.toml',
+        'requirements*.txt',
+        '**/requirements*.txt',
+        'go.mod',
+        '**/go.mod',
+    ];
+    const ignored = [
+        'node_modules/**', '**/node_modules/**',
+        'vendor/**', '**/vendor/**', 'vendored/**', '**/vendored/**',
+        'third_party/**', '**/third_party/**', 'thirdparty/**', '**/thirdparty/**',
+        'target/**', '**/target/**',
+        'dist/**', '**/dist/**',
+        '.git/**',
+    ];
+    const matches = await (0, fast_glob_1.default)(manifestPatterns, {
+        cwd: abs, ignore: ignored, onlyFiles: true, followSymbolicLinks: false, dot: false,
+        unique: true,
+    });
+    store.clearExternalDeps();
+    let inserted = 0;
+    for (const rel of matches) {
+        const filePath = path_1.default.join(abs, rel);
+        let content;
+        try {
+            content = fs_1.default.readFileSync(filePath, 'utf8');
+        }
+        catch {
+            continue;
+        }
+        if (rel.endsWith('package.json') || rel === 'package.json') {
+            inserted += parsePackageJson(content, rel, store);
+        }
+        else if (rel.endsWith('Cargo.toml') || rel === 'Cargo.toml') {
+            inserted += parseCargoToml(content, rel, store);
+        }
+        else if (rel.endsWith('pyproject.toml') || rel === 'pyproject.toml') {
+            inserted += parsePyproject(content, rel, store);
+        }
+        else if (rel.endsWith('.txt')) {
+            inserted += parseRequirementsTxt(content, rel, store);
+        }
+        else if (rel.endsWith('go.mod') || rel === 'go.mod') {
+            inserted += parseGoMod(content, rel, store);
+        }
+    }
+    return inserted;
+}
+function parsePackageJson(content, manifestPath, store) {
+    let json;
+    try {
+        json = JSON.parse(content);
+    }
+    catch {
+        return 0;
+    }
+    if (!json || typeof json !== 'object')
+        return 0;
+    let count = 0;
+    const groups = [
+        [json.dependencies, 0],
+        [json.devDependencies, 1],
+        [json.peerDependencies, 0],
+        [json.optionalDependencies, 0],
+    ];
+    for (const [group, isDev] of groups) {
+        if (!group || typeof group !== 'object')
+            continue;
+        for (const [name, version] of Object.entries(group)) {
+            if (!name)
+                continue;
+            store.insertExternalDep('npm', name, typeof version === 'string' ? version : null, manifestPath, isDev);
+            count++;
+        }
+    }
+    return count;
+}
+function parseCargoToml(content, manifestPath, store) {
+    // Lightweight TOML parser for [dependencies] / [dev-dependencies] sections.
+    // We intentionally don't pull in a full TOML lib — Cargo manifests are
+    // well-formed enough that a section-aware line walk suffices.
+    let count = 0;
+    let section = '';
+    for (const rawLine of content.split('\n')) {
+        const line = rawLine.replace(/#.*$/, '').trim();
+        if (!line)
+            continue;
+        const sectionMatch = line.match(/^\[(.+?)\]$/);
+        if (sectionMatch) {
+            section = sectionMatch[1].trim();
+            continue;
+        }
+        const inDeps = section === 'dependencies' || section === 'dev-dependencies' || section === 'build-dependencies';
+        if (!inDeps)
+            continue;
+        const eq = line.indexOf('=');
+        if (eq < 0)
+            continue;
+        const name = line.slice(0, eq).trim();
+        const rest = line.slice(eq + 1).trim();
+        if (!name || /[\[{]/.test(name))
+            continue;
+        let version = null;
+        const strMatch = rest.match(/^"([^"]+)"/);
+        if (strMatch)
+            version = strMatch[1];
+        else {
+            const inlineVer = rest.match(/version\s*=\s*"([^"]+)"/);
+            if (inlineVer)
+                version = inlineVer[1];
+        }
+        const isDev = section === 'dev-dependencies' ? 1 : 0;
+        store.insertExternalDep('cargo', name, version, manifestPath, isDev);
+        count++;
+    }
+    return count;
+}
+function parsePyproject(content, manifestPath, store) {
+    // [project] dependencies / optional-dependencies — Poetry uses
+    // [tool.poetry.dependencies] in addition. We handle both.
+    let count = 0;
+    let section = '';
+    let inList = false;
+    let buf = [];
+    const flushList = (isDev) => {
+        for (const item of buf) {
+            const m = item.match(/^"([^"]+)"|^'([^']+)'/);
+            if (!m)
+                continue;
+            const spec = (m[1] ?? m[2] ?? '').trim();
+            if (!spec)
+                continue;
+            // Strip extras / version: "package[extras]>=1.2.3"
+            const nameMatch = spec.match(/^([A-Za-z0-9_.\-]+)/);
+            if (!nameMatch)
+                continue;
+            const name = nameMatch[1];
+            const versionMatch = spec.slice(nameMatch[0].length).match(/[<>=~!^].+/);
+            const version = versionMatch ? versionMatch[0].trim() : null;
+            store.insertExternalDep('pypi', name, version, manifestPath, isDev);
+            count++;
+        }
+        buf = [];
+    };
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const raw = lines[i];
+        const line = raw.replace(/#.*$/, '').trim();
+        const sectionMatch = line.match(/^\[(.+?)\]$/);
+        if (sectionMatch) {
+            if (inList) {
+                flushList(section.includes('dev') ? 1 : 0);
+                inList = false;
+            }
+            section = sectionMatch[1].trim();
+            continue;
+        }
+        if (section === 'project' || section === 'tool.poetry.dependencies' || section === 'tool.poetry.dev-dependencies') {
+            // [project] dependencies = ["pkg>=1.0", ...]
+            if (section === 'project' && /^dependencies\s*=\s*\[/.test(line)) {
+                inList = true;
+                const after = line.replace(/^dependencies\s*=\s*\[/, '');
+                if (after.includes(']')) {
+                    for (const item of after.replace(/\].*$/, '').split(','))
+                        buf.push(item.trim());
+                    flushList(0);
+                    inList = false;
+                }
+                else {
+                    buf.push(after);
+                }
+                continue;
+            }
+            if (inList) {
+                if (line.includes(']')) {
+                    for (const item of line.replace(/\].*$/, '').split(','))
+                        if (item.trim())
+                            buf.push(item.trim());
+                    flushList(0);
+                    inList = false;
+                }
+                else {
+                    for (const item of line.split(','))
+                        if (item.trim())
+                            buf.push(item.trim());
+                }
+                continue;
+            }
+            if (section.startsWith('tool.poetry') && /^[A-Za-z0-9_.\-]+\s*=/.test(line)) {
+                const eq = line.indexOf('=');
+                const name = line.slice(0, eq).trim();
+                const rest = line.slice(eq + 1).trim();
+                const verMatch = rest.match(/^"([^"]+)"/);
+                const version = verMatch ? verMatch[1] : null;
+                const isDev = section.includes('dev') ? 1 : 0;
+                store.insertExternalDep('pypi', name, version, manifestPath, isDev);
+                count++;
+            }
+        }
+    }
+    if (inList)
+        flushList(section.includes('dev') ? 1 : 0);
+    return count;
+}
+function parseRequirementsTxt(content, manifestPath, store) {
+    let count = 0;
+    const isDev = /dev|test/i.test(manifestPath) ? 1 : 0;
+    for (const raw of content.split('\n')) {
+        const line = raw.replace(/#.*$/, '').trim();
+        if (!line || line.startsWith('-'))
+            continue;
+        const m = line.match(/^([A-Za-z0-9_.\-]+)/);
+        if (!m)
+            continue;
+        const name = m[1];
+        const rest = line.slice(m[0].length);
+        const ver = rest.match(/[<>=~!^].+/);
+        store.insertExternalDep('pypi', name, ver ? ver[0].trim() : null, manifestPath, isDev);
+        count++;
+    }
+    return count;
+}
+function parseGoMod(content, manifestPath, store) {
+    let count = 0;
+    let inRequire = false;
+    for (const raw of content.split('\n')) {
+        const line = raw.replace(/\/\/.*$/, '').trim();
+        if (!line)
+            continue;
+        if (line.startsWith('require (')) {
+            inRequire = true;
+            continue;
+        }
+        if (line === ')') {
+            inRequire = false;
+            continue;
+        }
+        if (line.startsWith('require ')) {
+            // single-line: `require mod v1.2.3`
+            const parts = line.slice('require '.length).trim().split(/\s+/);
+            if (parts.length >= 2) {
+                store.insertExternalDep('go', parts[0], parts[1], manifestPath, 0);
+                count++;
+            }
+            continue;
+        }
+        if (inRequire) {
+            const parts = line.split(/\s+/);
+            if (parts.length >= 2 && !/^\/\//.test(parts[0])) {
+                store.insertExternalDep('go', parts[0], parts[1], manifestPath, 0);
+                count++;
+            }
+        }
+    }
+    return count;
+}
+//# sourceMappingURL=externaldeps.js.map

package/dist/indexer/externaldeps.js.map

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

package/dist/indexer/freshness.d.ts

@@ -0,0 +1,48 @@
+import { Indexer } from './index.js';
+import { Store } from '../db/store.js';
+/**
+ * Quick freshness check + targeted re-index for MCP/CLI queries.
+ *
+ * Design contract: the watcher (when running) keeps the index warm by marking
+ * files dirty in the background. JIT sync runs before every query as the
+ * correctness layer — it does the actual reindex of dirty files so a query
+ * returning right now reflects the current workspace state.
+ *
+ * Implementation: discover the workspace, compare on-disk content hashes
+ * against what the DB says, and only reindex files whose hash changed.
+ * Unchanged files are skipped entirely; we don't touch the parser for them.
+ *
+ * The intentional bias here is correctness over latency: we re-discover the
+ * full workspace each time so newly-added or newly-renamed files are not
+ * missed. For very large repos this is still cheap (a glob + dir walk
+ * over 10-100k files is sub-second) compared to a single tree-sitter parse,
+ * and you only do it once per JIT call.
+ */
+export interface FreshnessReport {
+    /** Files where the on-disk hash differed from the DB. Reindexed. */
+    dirtyReindexed: number;
+    /** Files that vanished from disk since the last index. Pruned. */
+    removed: number;
+    /** Files newly seen this run (not in the DB yet). Indexed. */
+    added: number;
+    /** Total wall time in ms. */
+    elapsedMs: number;
+}
+/**
+ * Inspect a workspace for changes since the last index, then reindex only
+ * the files that need it. Designed to run before every MCP query.
+ *
+ * @param store     a writable Store (NOT readonly — we may need to mutate)
+ * @param indexer   an Indexer over the same store
+ * @param repoRoot  the workspace path used at index time
+ * @param options.maxDirty  cap reindex work per call. When the dirty set is
+ *   larger than this, we still run a full `indexer.indexDirectory()` because
+ *   a partial JIT pass would leave the index inconsistent (resolveEdges
+ *   needs the full graph). Defaults to 200 — small enough to keep the
+ *   "type a few characters and ask" workflow snappy.
+ */
+export declare function jitSync(store: Store, indexer: Indexer, repoRoot: string, options?: {
+    maxDirty?: number;
+    verbose?: boolean;
+}): Promise<FreshnessReport>;
+//# sourceMappingURL=freshness.d.ts.map

package/dist/indexer/freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.d.ts","sourceRoot":"","sources":["../../src/indexer/freshness.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGvC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,cAAc,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAWD;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GACrD,OAAO,CAAC,eAAe,CAAC,CA2F1B"}

package/dist/indexer/freshness.js

@@ -0,0 +1,128 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jitSync = jitSync;
+const fs_1 = __importDefault(require("fs"));
+const crypto_1 = __importDefault(require("crypto"));
+const path_1 = __importDefault(require("path"));
+const discovery_js_1 = require("./discovery.js");
+/**
+ * Cheap content hash matching what the indexer uses internally. Kept here as
+ * a duplicate (not exported from indexer/index.ts) because the indexer's
+ * version is in the hot loop and we don't want to widen its export surface.
+ */
+function sha256Short(content) {
+    return crypto_1.default.createHash('sha256').update(content, 'utf8').digest('hex').slice(0, 16);
+}
+/**
+ * Inspect a workspace for changes since the last index, then reindex only
+ * the files that need it. Designed to run before every MCP query.
+ *
+ * @param store     a writable Store (NOT readonly — we may need to mutate)
+ * @param indexer   an Indexer over the same store
+ * @param repoRoot  the workspace path used at index time
+ * @param options.maxDirty  cap reindex work per call. When the dirty set is
+ *   larger than this, we still run a full `indexer.indexDirectory()` because
+ *   a partial JIT pass would leave the index inconsistent (resolveEdges
+ *   needs the full graph). Defaults to 200 — small enough to keep the
+ *   "type a few characters and ask" workflow snappy.
+ */
+async function jitSync(store, indexer, repoRoot, options = {}) {
+    const start = Date.now();
+    const maxDirty = options.maxDirty ?? 200;
+    const absRoot = path_1.default.resolve(repoRoot);
+    // 1. Snapshot what the DB knows.
+    const dbFiles = store.listFiles();
+    const dbByPath = new Map(dbFiles.map(f => [normalizeForCompare(f.path), f]));
+    // 2. Walk the workspace and find candidate files. discoverFiles() applies
+    //    the same ignore rules the indexer uses, so freshness can't be
+    //    misled by build artifacts or `vendor/` entries.
+    const discovered = await (0, discovery_js_1.discoverFiles)(absRoot);
+    const discoveredByPath = new Map();
+    for (const d of discovered) {
+        discoveredByPath.set(normalizeForCompare(d.absolutePath), d.relativePath);
+    }
+    // 3. Identify added / removed / candidate-dirty files.
+    const added = [];
+    const removed = [];
+    const candidateDirty = [];
+    for (const f of dbFiles) {
+        const key = normalizeForCompare(f.path);
+        if (!discoveredByPath.has(key)) {
+            removed.push(f.id);
+            continue;
+        }
+        candidateDirty.push(f);
+    }
+    for (const [key, _rel] of discoveredByPath) {
+        if (!dbByPath.has(key))
+            added.push(key);
+    }
+    // 4. Hash each candidate. Same trade-off as the indexer: read everything
+    //    we'd parse anyway, but if the hash matches we never spend time on
+    //    the parser. We stop early as soon as we cross `maxDirty` so a giant
+    //    change like a git checkout falls back to a full reindex.
+    const dirty = [];
+    for (const f of candidateDirty) {
+        if (dirty.length + added.length >= maxDirty)
+            break;
+        let content;
+        try {
+            content = await fs_1.default.promises.readFile(f.path, 'utf8');
+        }
+        catch {
+            // File became unreadable mid-check (rename, permission flip). Treat
+            // as removed so the next pass cleans it up.
+            removed.push(f.id);
+            continue;
+        }
+        const hash = sha256Short(content);
+        if (hash !== f.hash)
+            dirty.push(f.path);
+    }
+    const fullReindexNeeded = dirty.length + added.length >= maxDirty || removed.length > 0;
+    if (dirty.length === 0 && added.length === 0 && removed.length === 0) {
+        return { dirtyReindexed: 0, removed: 0, added: 0, elapsedMs: Date.now() - start };
+    }
+    if (fullReindexNeeded) {
+        // Cheaper to invoke the full pipeline than to surgically remove files
+        // and reconcile edge graphs. The indexer's cache means unchanged files
+        // are still skipped at parse time, so this is O(dirty + added + |touched|)
+        // not O(|workspace|).
+        // JIT pins parallel:false. The dirty set is small (≤ maxDirty=200) and
+        // worker spawn cost dominates the wins at this scale; serial is the
+        // right default for the snappy "edit + ask" loop. MCP servers that want
+        // parallel JIT can override later via an option.
+        const result = await indexer.indexDirectory(absRoot, { quiet: !options.verbose, parallel: false });
+        return {
+            dirtyReindexed: dirty.length,
+            removed: removed.length,
+            added: added.length,
+            elapsedMs: Date.now() - start + (result.elapsedMs ?? 0),
+        };
+    }
+    // Targeted JIT path: dirty/added files only, no full re-discovery. Reuse
+    // the indexer's machinery by calling indexDirectory — its cache skips
+    // unchanged files. This is dominated by the discovery walk we already did,
+    // so the marginal cost is small.
+    await indexer.indexDirectory(absRoot, { quiet: !options.verbose, parallel: false });
+    return {
+        dirtyReindexed: dirty.length,
+        removed: removed.length,
+        added: added.length,
+        elapsedMs: Date.now() - start,
+    };
+}
+/**
+ * Normalize a path for comparison across the OS-specific quirks we hit on
+ * Windows. We index with backslashes; discovery resolves through `path.join`
+ * which also produces backslashes. Read-only callers might pass a slash-form
+ * path through the MCP layer; lowercase folds Windows case-insensitivity.
+ */
+function normalizeForCompare(p) {
+    const norm = p.replace(/\\/g, '/');
+    return process.platform === 'win32' ? norm.toLowerCase() : norm;
+}
+//# sourceMappingURL=freshness.js.map

package/dist/indexer/freshness.js.map

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

package/dist/indexer/git.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Thin async wrapper around `git` so the rest of the indexer doesn't deal
+ * with child_process directly. All commands run with `cwd = repoRoot`.
+ *
+ * Errors are surfaced as `null` returns (not throws) so a non-git workspace
+ * silently no-ops. Callers should check the return value.
+ */
+export declare function isGitRepo(repoRoot: string): boolean;
+export declare function gitHeadSha(repoRoot: string): string | null;
+export declare function gitRemoteUrl(repoRoot: string, remote?: string): string | null;
+export interface FileChurnStats {
+    commitCount: number;
+    lastCommitSha: string | null;
+    lastCommitAt: number | null;
+    topAuthor: string | null;
+    secondAuthor: string | null;
+}
+/**
+ * Collect file-level churn stats by streaming `git log` once and bucketing
+ * per file. Uses `--follow` per-file would be ~slow on big repos, so we use
+ * a single `git log --name-only` pass and aggregate in JS. The trade-off is
+ * that renames lose their pre-rename history; callers documenting that fact
+ * matches the master guide's "honest about rename limits" stance.
+ */
+export declare function collectFileChurn(repoRoot: string, filesAbs: Iterable<string>): Promise<Map<string, FileChurnStats>>;
+export interface CommitMeta {
+    sha: string;
+    authorName: string | null;
+    authorEmail: string | null;
+    committedAt: number;
+    message: string;
+    /**
+     * The path the file had AT THIS COMMIT (forward-slash, repo-relative).
+     * Resolved from `git log --follow --name-status` so commits prior to a
+     * rename can still be looked up by the historical path. Null if the path
+     * couldn't be determined from log output (in which case callers should
+     * fall back to the current path).
+     */
+    pathAtCommit: string | null;
+}
+/**
+ * `git log` commits that touched a single file, newest first. Each commit
+ * includes its author info and full message. Used by the symbol-history pass.
+ *
+ * `--name-status` is added on top of `--follow` so we get a per-commit path —
+ * critical for the rename case: the historical commits touched the OLD path,
+ * but our usual `git show <sha> -- <currentPath>` would look at the wrong
+ * path and return empty hunks. With pathAtCommit threaded through to
+ * fileDiffInfo(), pre-rename history is preserved.
+ *
+ * Parser shape: we ask git for a per-commit header line prefixed `__C__`
+ * (sha, author, email, ISO date — all NUL-free fields tab-separated), then
+ * the commit body (terminated by a unique end marker `__BODY_END__`), then
+ * the name-status lines that git appends after each commit. The name-status
+ * block has one path entry per commit relative to this file's --follow chain:
+ * either `M\tpath`, `A\tpath`, `D\tpath`, or `R<score>\toldPath\tnewPath`.
+ *
+ * Using a custom body terminator (instead of git's default blank-line
+ * separator) lets us handle commit messages that themselves contain blank
+ * lines or `__C__` literals without re-introducing the old `__C__ff8` bug.
+ */
+export declare function commitsForFile(repoRoot: string, filePath: string, options?: {
+    limit?: number;
+    since?: number;
+}): Promise<CommitMeta[]>;
+/**
+ * Walk the line stream from `git log --follow --name-status` (with the
+ * `__C__` header / `__BODY_END__` body terminator format above) and emit
+ * one CommitMeta per `__C__` header. Exposed only for tests; the live
+ * pipeline goes through commitsForFile().
+ */
+export declare function parseFollowLog(buf: string): CommitMeta[];
+export interface DiffHunk {
+    oldStart: number;
+    oldLines: number;
+    newStart: number;
+    newLines: number;
+}
+export interface FileDiffInfo {
+    hunks: DiffHunk[];
+    /**
+     * True when the commit created the file (or — symmetrically — deleted it).
+     * In that case the diff has `--- /dev/null` (added) or `+++ /dev/null`
+     * (deleted) and EVERY symbol currently in the file should be attributed,
+     * because the file's current shape didn't exist before.
+     */
+    isFileAddition: boolean;
+}
+/**
+ * Diff hunks for a file changed by a single commit. `git show -U0 <sha>`
+ * handles the root commit transparently (no parent → diff against the empty
+ * tree), so the caller doesn't need to pass parentSha. `parentSha` is kept
+ * for compatibility but ignored.
+ */
+export declare function fileDiffHunks(repoRoot: string, _parentSha: string | null, sha: string, filePath: string): Promise<DiffHunk[]>;
+/** Like fileDiffHunks but returns extra metadata used for "this commit
+ *  created the file → match every symbol" heuristic.
+ *
+ * `filePath` may be either an absolute path or a repo-relative one. When the
+ * file was renamed across history, callers should pass the PATH-AT-COMMIT
+ * (resolved from `git log --follow --name-status`) so `git show` looks at
+ * the right side of the rename — passing the current path would return
+ * empty hunks for pre-rename commits and silently lose history.
+ */
+export declare function fileDiffInfo(repoRoot: string, sha: string, filePath: string): Promise<FileDiffInfo>;
+/**
+ * Diff numstat for one commit: returns added/removed line counts per file
+ * (or aggregated when filePath is given).
+ */
+export declare function commitNumstat(repoRoot: string, sha: string, filePath?: string): Promise<{
+    added: number;
+    removed: number;
+}>;
+/**
+ * git diff name-only between two refs. Defaults to HEAD vs the working
+ * tree (uncommitted changes) — used by `detect_changes`. Returns absolute
+ * paths (after path.resolve(repoRoot, rel)).
+ */
+export declare function gitChangedFiles(repoRoot: string, fromRef?: string, toRef?: string): string[];
+/**
+ * git diff -U0 hunks for one file between two refs (or working tree if refs
+ * omitted). Returns parsed hunk headers (line ranges in the new file) so
+ * `detect_changes` can compute which symbols overlap.
+ */
+export declare function fileDiffHunksSync(repoRoot: string, filePath: string, fromRef?: string, toRef?: string): DiffHunk[];
+/**
+ * Extract GitHub-style PR numbers from a commit message. We accept the
+ * common conventions:
+ *   "Merge pull request #1234 from ..."
+ *   "Fix something (#1234)"
+ *   "#1234"
+ *   "PR #1234"
+ *
+ * Returns the first matched PR number, or null.
+ */
+export declare function extractPrNumber(message: string): number | null;
+/**
+ * If `remoteUrl` is a GitHub URL (HTTPS or SSH), return the matching
+ * `https://github.com/<owner>/<repo>/pull/<n>` URL for a PR number.
+ * Returns null for non-GitHub remotes so we don't fabricate links to
+ * GitLab/Bitbucket/etc.
+ */
+export declare function githubPrUrl(remoteUrl: string | null, prNumber: number): string | null;
+//# sourceMappingURL=git.d.ts.map

package/dist/indexer/git.d.ts.map

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