@mka-rainmaker/ama 0.1.0

package/dist/indexer/indexer.js

@@ -0,0 +1,392 @@
+import * as crypto from "node:crypto";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { BaselineAnalyzer } from "../analyzers/baseline/analyzer.js";
+import { cSpec, cppSpec } from "../analyzers/baseline/c.js";
+import { csharpSpec } from "../analyzers/baseline/csharp.js";
+import { goSpec } from "../analyzers/baseline/go.js";
+import { javaSpec } from "../analyzers/baseline/java.js";
+import { javascriptSpec } from "../analyzers/baseline/javascript.js";
+import { kotlinSpec } from "../analyzers/baseline/kotlin.js";
+import { phpSpec } from "../analyzers/baseline/php.js";
+import { pythonSpec } from "../analyzers/baseline/python.js";
+import { rustSpec } from "../analyzers/baseline/rust.js";
+import { swiftSpec } from "../analyzers/baseline/swift.js";
+import { AnalyzerRegistry } from "../analyzers/registry.js";
+import { SfcAnalyzer } from "../analyzers/sfc/analyzer.js";
+import { TypeScriptAnalyzer } from "../analyzers/typescript/analyzer.js";
+import { deriveDispatchEdges } from "../graph/index.js";
+import { InMemoryStore } from "../store/memory.js";
+import { MAX_FILE_SIZE_BYTES, isIgnoredPath, loadIgnoreRules, withNestedIgnore, } from "./ignore.js";
+/**
+ * Bumped whenever the persisted store's schema or the shape of what we write
+ * into it changes. A persisted index stamped with a different version is treated
+ * as unusable and rebuilt rather than reopened.
+ */
+const SCHEMA_VERSION = 4; // 2: provenance (m8k.1); 3: source-location (hft.9); 4: call sites (hft.10)
+/** Absolute directories far too broad to index — likely to pull in secrets,
+ *  exhaust memory, or never finish. A real project lives in a subdirectory, so
+ *  refusing these never blocks legitimate use. (ama-m8k.10) */
+const UNSAFE_DIRS = new Set([
+    "/usr",
+    "/etc",
+    "/bin",
+    "/sbin",
+    "/var",
+    "/opt",
+    "/lib",
+    "/dev",
+    "/proc",
+    "/System",
+    "/Library",
+].map((p) => path.resolve(p)));
+/** Throw if `root` resolves to the filesystem root, the user's home directory,
+ *  or a well-known system directory — a guardrail so a stray `index_repository`
+ *  call (an agent, a typo) can't walk the whole machine. (ama-m8k.10) */
+export function assertSafeRoot(root) {
+    const abs = path.resolve(root);
+    if (abs === path.parse(abs).root || abs === path.resolve(os.homedir()) || UNSAFE_DIRS.has(abs)) {
+        throw new Error(`Refusing to index ${abs}: that's the filesystem root, your home directory, or a system directory — far too broad. Point Ama at a specific project directory.`);
+    }
+}
+/**
+ * Turns a directory into a graph: discover source files, hand each to the
+ * analyzer that claims its extension, and collect the resulting nodes/edges
+ * into a store. All files for one analyzer are analyzed together so it can
+ * resolve cross-file references (e.g. an import's call target).
+ */
+export class Indexer {
+    registry;
+    createStore;
+    constructor(registry, 
+    /** How to create the backing store for a (resolved) project root — swap this to
+     *  persist to SQLite. The root is passed so a multi-project session can give each
+     *  project an independent store; a factory that ignores it and returns one shared
+     *  store would alias every project onto the last index. (ama-mnj) */
+    createStore = () => new InMemoryStore()) {
+        this.registry = registry;
+        this.createStore = createStore;
+    }
+    /** The (language, tier) that owns a file, or undefined if no analyzer claims it.
+     *  Lets a caller recompute per-language coverage live from the current file set,
+     *  so index_status's census stays correct after incremental syncs — not only
+     *  after a full index, which is the only thing that writes the cached coverage
+     *  metadata. (ama-okg) */
+    languageOf(rel) {
+        const analyzer = this.registry.forFile(rel);
+        return analyzer ? { language: analyzer.language, tier: analyzer.tier } : undefined;
+    }
+    async index(root) {
+        // Refuse dangerously broad roots before touching the filesystem.
+        assertSafeRoot(root);
+        // A clear error beats a raw ENOTDIR/ENOENT when the root isn't a directory.
+        if (!fs.statSync(root, { throwIfNoEntry: false })?.isDirectory()) {
+            throw new Error(`Not a directory: ${root}`);
+        }
+        // Discover files BEFORE touching the store: a failing walk must not clear a
+        // persistent store reused across indexes — that corrupts the live index.
+        // Walking first keeps a failed re-index a no-op.
+        const skippedLarge = [];
+        const files = discoverFiles(root, (rel) => skippedLarge.push(rel));
+        if (skippedLarge.length > 0) {
+            // Honest about omissions, like the per-analyzer isolation below: a file too big
+            // to parse safely is left out, but said so on stderr (stdout is JSON-RPC only).
+            console.error(`[ama] skipped ${skippedLarge.length} file(s) over the ` +
+                `${MAX_FILE_SIZE_BYTES / 1024 / 1024} MB parse cap (too large to index): ` +
+                skippedLarge.join(", "));
+        }
+        const store = this.createStore(root);
+        store.clear(); // a persistent store may hold a previous index; rebuild clean
+        const byAnalyzer = new Map();
+        for (const rel of files) {
+            const analyzer = this.registry.forFile(rel);
+            if (!analyzer)
+                continue;
+            const list = byAnalyzer.get(analyzer);
+            if (list)
+                list.push(rel);
+            else
+                byAnalyzer.set(analyzer, [rel]);
+        }
+        const languages = [];
+        const resolution = { callsTotal: 0, callsResolved: 0, unresolved: {} };
+        let fileCount = 0;
+        for (const [analyzer, files] of byAnalyzer) {
+            // Isolate each analyzer: a crash on one language's batch (a pathological
+            // file, an analyzer bug) must not abort the whole index — the other
+            // languages still produce a usable graph. The failure is reported to
+            // stderr (never silently dropped) and that language is left out of
+            // coverage so the index honestly reflects what was analyzed. (ama-m8k.9)
+            let result;
+            try {
+                result = await analyzer.analyze(root, files);
+            }
+            catch (err) {
+                console.error(`[ama] ${analyzer.language} analyzer failed on ${files.length} file(s); ` +
+                    `skipping them. ${err instanceof Error ? err.message : String(err)}`);
+                continue;
+            }
+            for (const n of result.nodes)
+                store.addNode(n);
+            for (const e of result.edges)
+                store.addEdge(e);
+            for (const rel of files) {
+                const meta = fingerprint(root, rel);
+                if (meta)
+                    store.recordFile(meta);
+                else
+                    store.removeFile(rel); // vanished mid-index — drop its just-added nodes
+            }
+            fileCount += files.length;
+            if (result.resolution) {
+                resolution.callsTotal += result.resolution.callsTotal;
+                resolution.callsResolved += result.resolution.callsResolved;
+                for (const [name, n] of Object.entries(result.resolution.unresolved)) {
+                    resolution.unresolved[name] = (resolution.unresolved[name] ?? 0) + n;
+                }
+            }
+            languages.push({
+                language: analyzer.language,
+                tier: analyzer.tier,
+                files: files.length,
+            });
+        }
+        // Persist enough to reopen this index next process without re-analyzing:
+        // coverage + resolution (for index_status), the root it was built for, and
+        // the schema version that wrote it.
+        store.setMeta("ama:coverage", JSON.stringify({ fileCount, languages }));
+        store.setMeta("ama:resolution", JSON.stringify(resolution));
+        store.setMeta("ama:root", root);
+        store.setMeta("ama:schema", String(SCHEMA_VERSION));
+        return {
+            store,
+            stats: {
+                root,
+                nodeCount: store.nodeCount,
+                edgeCount: store.edgeCount,
+                fileCount,
+                languages,
+                resolution,
+            },
+        };
+    }
+    /**
+     * Reopen a previously-persisted index without re-analyzing: open the store and,
+     * if it holds a usable index for `root` (matching schema version and root, with
+     * nodes present), reconstruct its {@link IndexStats} from the persisted
+     * coverage metadata. Returns undefined — and closes the freshly-opened store —
+     * when there is nothing usable (an empty in-memory store, a different root, or
+     * an incompatible schema), so the caller falls back to a full {@link index}.
+     */
+    async open(root) {
+        const store = this.createStore(root);
+        const coverageRaw = store.getMeta("ama:coverage");
+        const usable = store.getMeta("ama:schema") === String(SCHEMA_VERSION) &&
+            store.getMeta("ama:root") === root &&
+            store.nodeCount > 0 &&
+            coverageRaw !== undefined;
+        if (!usable) {
+            store.close();
+            return undefined;
+        }
+        const { fileCount, languages } = JSON.parse(coverageRaw);
+        // Resolution coverage is additive — an index written before ama-m8k.12 simply
+        // lacks it, so it stays undefined rather than gating reopen.
+        const resolutionRaw = store.getMeta("ama:resolution");
+        const parsedResolution = resolutionRaw
+            ? JSON.parse(resolutionRaw)
+            : undefined;
+        // An index written before ama-qbn has no `unresolved` map; default it so the
+        // field is always present once `resolution` is.
+        const resolution = parsedResolution
+            ? { ...parsedResolution, unresolved: parsedResolution.unresolved ?? {} }
+            : undefined;
+        return {
+            store,
+            stats: {
+                root,
+                nodeCount: store.nodeCount,
+                edgeCount: store.edgeCount,
+                fileCount,
+                languages,
+                ...(resolution ? { resolution } : {}),
+            },
+        };
+    }
+    /**
+     * Re-index a single changed file into an existing store, in place. Re-analyzes
+     * just `rel` and reconciles its delta (so an edit churns only what changed);
+     * if `rel` was deleted or is no longer analyzable, its data is dropped instead.
+     * Edges from `rel` into files this pass never walks still resolve, because the
+     * analyzer falls back to location-derived ids for nodes already in the store.
+     */
+    async reindexFile(store, root, rel) {
+        const abs = path.resolve(root, rel);
+        const analyzer = this.registry.forFile(rel);
+        const meta = analyzer && fs.existsSync(abs) ? fingerprint(root, rel) : null;
+        if (!analyzer || !meta) {
+            store.removeFile(rel); // unhandled language, or the file is gone
+        }
+        else {
+            const { nodes, edges } = await analyzer.analyze(root, [rel]);
+            store.reconcileFile(rel, nodes, edges);
+            store.recordFile(meta);
+        }
+        // Dispatch fan-out (interface/override) is a whole-graph inference: a single-file
+        // analyze can't see other files' implementers, so reconcileFile would drop this
+        // file's cross-file dispatch edges. Re-derive them over the full store after the
+        // structural change, restoring full-index parity. (ama-tr1)
+        redispatch(store);
+    }
+    /**
+     * Catch-up reconcile: compare the tree on disk against the stored fingerprints
+     * and re-index everything that drifted — files added or modified since the
+     * last index, and files that have since vanished. Detection is cheap
+     * (size + mtime, with a content hash only as the tiebreaker), and unchanged
+     * files are skipped entirely. The manual counterpart to the live watcher.
+     */
+    async sync(store, root) {
+        const changed = [];
+        const removed = [];
+        const current = new Set();
+        for (const rel of discoverFiles(root)) {
+            if (this.registry.forFile(rel))
+                current.add(rel);
+        }
+        for (const rel of current) {
+            const meta = store.getFile(rel);
+            if (meta && !isStale(root, rel, meta))
+                continue;
+            await this.reindexFile(store, root, rel);
+            changed.push(rel);
+        }
+        for (const meta of store.allFiles()) {
+            if (!current.has(meta.path)) {
+                await this.reindexFile(store, root, meta.path); // gone on disk → removeFile
+                removed.push(meta.path);
+            }
+        }
+        return { changed, removed };
+    }
+}
+/**
+ * An indexer wired with the analyzers Ama ships today. Pass a `createStore`
+ * factory to persist into SQLite instead of the default in-memory store.
+ */
+export function createDefaultIndexer(createStore) {
+    const registry = new AnalyzerRegistry();
+    registry.register(new TypeScriptAnalyzer());
+    registry.register(new BaselineAnalyzer(pythonSpec));
+    registry.register(new BaselineAnalyzer(javascriptSpec));
+    registry.register(new BaselineAnalyzer(javaSpec));
+    registry.register(new BaselineAnalyzer(csharpSpec));
+    registry.register(new BaselineAnalyzer(goSpec));
+    registry.register(new BaselineAnalyzer(rustSpec));
+    registry.register(new BaselineAnalyzer(phpSpec));
+    registry.register(new BaselineAnalyzer(cSpec));
+    registry.register(new BaselineAnalyzer(cppSpec));
+    registry.register(new BaselineAnalyzer(kotlinSpec));
+    registry.register(new BaselineAnalyzer(swiftSpec));
+    registry.register(new SfcAnalyzer("vue", [".vue"]));
+    registry.register(new SfcAnalyzer("svelte", [".svelte"]));
+    return new Indexer(registry, createStore);
+}
+/**
+ * Re-derive the whole-graph dispatch edges (interface/override fan-out) over the
+ * full store, replacing the prior ones. A full index gets these from the analyzer's
+ * per-batch pass, but a single-file reindex can't (it lacks other files' subtypes),
+ * so we recompute them store-wide after every reindex — clearing the stale tagged
+ * set and re-adding the fresh derivation keeps incremental sync at full-index
+ * parity. (ama-tr1) */
+function redispatch(store) {
+    const nodes = [...store.allNodes()];
+    const base = store.allEdges().filter((e) => e.provenance !== "dispatch");
+    store.replaceEdgesByProvenance("dispatch", deriveDispatchEdges(nodes, base));
+}
+/** Fingerprint a file for staleness tracking: size, mtime, and content hash.
+ *  Returns null when the file has vanished (gone between discovery and now — an
+ *  editor's atomic save or temp file) so the caller can drop it instead of
+ *  crashing the index. (ama-7r5) */
+export function fingerprint(root, rel) {
+    const abs = path.resolve(root, rel);
+    try {
+        const stat = fs.statSync(abs);
+        const hash = crypto.createHash("sha1").update(fs.readFileSync(abs)).digest("hex");
+        return { path: rel, size: stat.size, mtimeMs: stat.mtimeMs, hash };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Whether a file differs from its recorded fingerprint. Size and mtime are the
+ * cheap first check; the content hash is consulted only when they are
+ * inconclusive (mtime can change without the bytes changing), so an unchanged
+ * file is never re-hashed. A file that has vanished counts as stale, so the
+ * caller reindexes it and its `existsSync` check reconciles the removal. (ama-7r5)
+ */
+export function isStale(root, rel, meta) {
+    const abs = path.resolve(root, rel);
+    let stat;
+    try {
+        stat = fs.statSync(abs);
+    }
+    catch {
+        return true;
+    }
+    if (stat.size === meta.size && stat.mtimeMs === meta.mtimeMs)
+        return false;
+    try {
+        const hash = crypto.createHash("sha1").update(fs.readFileSync(abs)).digest("hex");
+        return hash !== meta.hash;
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Repo-relative paths of every file under `root`, skipping ignored trees. Files over the
+ * parse cap are left out; `onSkipLarge` is invoked with each so a caller can report them
+ * instead of dropping them silently. (ama-j0y)
+ */
+function discoverFiles(root, onSkipLarge) {
+    const rootRules = loadIgnoreRules(root); // dotfiles + IGNORED_DIRS + the root .gitignore
+    const out = [];
+    const walk = (dir, dirRel, parent) => {
+        // A directory's own .gitignore augments the rules for its subtree, dir-relative
+        // (the root's is already folded into `rootRules`). (ama-pyk)
+        const rules = dirRel === "" ? parent : withNestedIgnore(dir, dirRel, parent);
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            const abs = path.join(dir, entry.name);
+            const rel = path.relative(root, abs);
+            // Path-aware so anchored .gitignore patterns (/build, pkg/internal) match
+            // root-relatively, not at any depth; covers dotfiles + names/globs too. (ama-yhu)
+            if (isIgnoredPath(rel, rules))
+                continue;
+            if (entry.isDirectory())
+                walk(abs, rel, rules);
+            else if (entry.isFile()) {
+                // Skip oversized files (minified bundles, data blobs) — the same cap the
+                // watcher enforces, so the initial index and re-index agree. Report the skip
+                // (never silently dropped, like the per-analyzer isolation) so a caller knows a
+                // file was omitted. A vanished file is just skipped.
+                let size;
+                try {
+                    size = fs.statSync(abs).size;
+                }
+                catch {
+                    continue;
+                }
+                if (size > MAX_FILE_SIZE_BYTES) {
+                    onSkipLarge?.(rel);
+                    continue;
+                }
+                out.push(rel);
+            }
+        }
+    };
+    walk(root, "", rootRules);
+    return out;
+}
+//# sourceMappingURL=indexer.js.map

package/dist/indexer/indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.js","sourceRoot":"","sources":["../../src/indexer/indexer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAEL,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAqBrB;;;;GAIG;AACH,MAAM,cAAc,GAAG,CAAC,CAAC,CAAC,4EAA4E;AAUtG;;+DAE+D;AAC/D,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB;IACE,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,SAAS;IACT,UAAU;CACX,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAC9B,CAAC;AAEF;;yEAEyE;AACzE,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,GAAG,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,GAAG,KAAK,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/F,MAAM,IAAI,KAAK,CACb,qBAAqB,GAAG,sIAAsI,CAC/J,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,OAAO;IAEC;IAKA;IANnB,YACmB,QAA0B;IAC3C;;;yEAGqE;IACpD,cAAuC,GAAG,EAAE,CAAC,IAAI,aAAa,EAAE;QALhE,aAAQ,GAAR,QAAQ,CAAkB;QAK1B,gBAAW,GAAX,WAAW,CAAqD;IAChF,CAAC;IAEJ;;;;8BAI0B;IAC1B,UAAU,CAAC,GAAW;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5C,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,iEAAiE;QACjE,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,4EAA4E;QAC5E,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,4EAA4E;QAC5E,yEAAyE;QACzE,iDAAiD;QACjD,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACnE,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,gFAAgF;YAChF,gFAAgF;YAChF,OAAO,CAAC,KAAK,CACX,iBAAiB,YAAY,CAAC,MAAM,oBAAoB;gBACtD,GAAG,mBAAmB,GAAG,IAAI,GAAG,IAAI,sCAAsC;gBAC1E,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAC1B,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACrC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,8DAA8D;QAE7E,MAAM,UAAU,GAAG,IAAI,GAAG,EAAsB,CAAC;QACjD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5C,IAAI,CAAC,QAAQ;gBAAE,SAAS;YACxB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;;gBACpB,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,SAAS,GAAuB,EAAE,CAAC;QACzC,MAAM,UAAU,GAAoB,EAAE,UAAU,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QACxF,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3C,yEAAyE;YACzE,oEAAoE;YACpE,qEAAqE;YACrE,mEAAmE;YACnE,yEAAyE;YACzE,IAAI,MAAsB,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CACX,SAAS,QAAQ,CAAC,QAAQ,uBAAuB,KAAK,CAAC,MAAM,YAAY;oBACvE,kBAAkB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACvE,CAAC;gBACF,SAAS;YACX,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK;gBAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC/C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK;gBAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC/C,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;gBACxB,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBACpC,IAAI,IAAI;oBAAE,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;;oBAC5B,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,iDAAiD;YAC/E,CAAC;YACD,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC;YAC1B,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,UAAU,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC;gBACtD,UAAU,CAAC,aAAa,IAAI,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC;gBAC5D,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;oBACrE,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBACvE,CAAC;YACH,CAAC;YACD,SAAS,CAAC,IAAI,CAAC;gBACb,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,KAAK,EAAE,KAAK,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;QAED,yEAAyE;QACzE,2EAA2E;QAC3E,oCAAoC;QACpC,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QACxE,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QAC5D,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAChC,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;QAEpD,OAAO;YACL,KAAK;YACL,KAAK,EAAE;gBACL,IAAI;gBACJ,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,SAAS;gBACT,SAAS;gBACT,UAAU;aACX;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAClD,MAAM,MAAM,GACV,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,MAAM,CAAC,cAAc,CAAC;YACtD,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,IAAI;YAClC,KAAK,CAAC,SAAS,GAAG,CAAC;YACnB,WAAW,KAAK,SAAS,CAAC;QAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,KAAK,CAAC,KAAK,EAAE,CAAC;YACd,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAGtD,CAAC;QACF,8EAA8E;QAC9E,6DAA6D;QAC7D,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACtD,MAAM,gBAAgB,GAAG,aAAa;YACpC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAqB;YAChD,CAAC,CAAC,SAAS,CAAC;QACd,6EAA6E;QAC7E,gDAAgD;QAChD,MAAM,UAAU,GAAG,gBAAgB;YACjC,CAAC,CAAC,EAAE,GAAG,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,CAAC,UAAU,IAAI,EAAE,EAAE;YACxE,CAAC,CAAC,SAAS,CAAC;QACd,OAAO;YACL,KAAK;YACL,KAAK,EAAE;gBACL,IAAI;gBACJ,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,SAAS;gBACT,SAAS;gBACT,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtC;SACF,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAC,KAAY,EAAE,IAAY,EAAE,GAAW;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,QAAQ,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5E,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YACvB,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,0CAA0C;QACnE,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7D,KAAK,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACvC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,kFAAkF;QAClF,gFAAgF;QAChF,iFAAiF;QACjF,4DAA4D;QAC5D,UAAU,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,KAAY,EAAE,IAAY;QACnC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnD,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC;gBAAE,SAAS;YAChD,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,4BAA4B;gBAC5E,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAqC;IACxE,MAAM,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;uBAMuB;AACvB,SAAS,UAAU,CAAC,KAAY;IAC9B,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IACzE,KAAK,CAAC,wBAAwB,CAAC,UAAU,EAAE,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;oCAGoC;AACpC,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,GAAW;IACnD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClF,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,GAAW,EAAE,IAAc;IAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACpC,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3E,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClF,OAAO,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,IAAY,EAAE,WAAmC;IACtE,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,gDAAgD;IACzF,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,MAAc,EAAE,MAAmB,EAAQ,EAAE;QACtE,gFAAgF;QAChF,6DAA6D;QAC7D,MAAM,KAAK,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7E,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACjE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YACrC,0EAA0E;YAC1E,kFAAkF;YAClF,IAAI,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC;gBAAE,SAAS;YACxC,IAAI,KAAK,CAAC,WAAW,EAAE;gBAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;iBAC1C,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBACxB,yEAAyE;gBACzE,6EAA6E;gBAC7E,gFAAgF;gBAChF,qDAAqD;gBACrD,IAAI,IAAY,CAAC;gBACjB,IAAI,CAAC;oBACH,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC/B,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;gBACD,IAAI,IAAI,GAAG,mBAAmB,EAAE,CAAC;oBAC/B,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;oBACnB,SAAS;gBACX,CAAC;gBACD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;IAC1B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/indexer/watcher.d.ts

@@ -0,0 +1,50 @@
+/**
+ * How a {@link FileWatcher} receives raw change events: given the root and a
+ * callback, wire up event delivery and return a handle to stop it. Injectable
+ * so tests can drive events synchronously instead of waiting on OS file-event
+ * latency (the source of flaky timing tests); the default is {@link fsWatchSource}.
+ */
+export type WatchSource = (root: string, onEvent: (rel: string) => void) => {
+    close(): void;
+};
+export interface FileWatcherOptions {
+    /** Files larger than this are not reported (default 1 MB). */
+    maxFileSizeBytes?: number;
+    /** Event source (default: fs.watch). Tests inject a synchronous source. */
+    source?: WatchSource;
+}
+/**
+ * Recursively watches a directory and reports each file that changes, as a
+ * repo-relative path, applying the same ignore rules as the indexer (dot-paths,
+ * `node_modules`/`dist`/… , and files over a size cap). It does *not* classify
+ * create vs. modify vs. delete — the consumer re-indexes the path and lets the
+ * indexer decide (a vanished file is reconciled away). Debouncing bursts of
+ * edits is a separate concern (ama-gd5.3); this emits raw change events.
+ *
+ * Built on Node's native `fs.watch` to avoid a dependency. Recursive watching
+ * is supported on macOS and Windows; on Linux the recursive option may not be
+ * available, in which case this watches only the top level.
+ */
+export declare class FileWatcher {
+    private readonly root;
+    private readonly onChange;
+    private subscription?;
+    private readonly maxFileSizeBytes;
+    private readonly source;
+    /** Loaded once so the watched set matches what the index built (incl .gitignore). */
+    private readonly ignoreRules;
+    /** Per-directory accumulated rules (root + each ancestor's nested .gitignore),
+     *  memoized so a burst of events in one directory reads each .gitignore once. */
+    private readonly rulesByDir;
+    constructor(root: string, onChange: (rel: string) => void, options?: FileWatcherOptions);
+    start(): void;
+    close(): void;
+    /** Ignore rules in effect inside `dirRel`: the root rules plus every ancestor
+     *  directory's nested .gitignore, each rebased to its directory, so a changed
+     *  file is judged exactly as the discovery walk would (ama-pyk). Memoized per
+     *  directory; like the root rules, a .gitignore edited after start isn't
+     *  reloaded — restart the watcher for that. (ama-ezf) */
+    private rulesForDir;
+    private handle;
+}
+//# sourceMappingURL=watcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/indexer/watcher.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,KAAK;IAAE,KAAK,IAAI,IAAI,CAAA;CAAE,CAAC;AAU9F,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,WAAW;IAWpB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAX3B,OAAO,CAAC,YAAY,CAAC,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,qFAAqF;IACrF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C;qFACiF;IACjF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;gBAG1C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAChD,OAAO,GAAE,kBAAuB;IAOlC,KAAK,IAAI,IAAI;IAKb,KAAK,IAAI,IAAI;IAKb;;;;6DAIyD;IACzD,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,MAAM;CAef"}

package/dist/indexer/watcher.js

@@ -0,0 +1,86 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { MAX_FILE_SIZE_BYTES, isIgnoredPath, loadIgnoreRules, withNestedIgnore, } from "./ignore.js";
+/** The production source: Node's native recursive `fs.watch`. */
+const fsWatchSource = (root, onEvent) => {
+    const watcher = fs.watch(root, { recursive: true }, (_event, filename) => {
+        if (filename !== null)
+            onEvent(filename.toString());
+    });
+    return { close: () => watcher.close() };
+};
+/**
+ * Recursively watches a directory and reports each file that changes, as a
+ * repo-relative path, applying the same ignore rules as the indexer (dot-paths,
+ * `node_modules`/`dist`/… , and files over a size cap). It does *not* classify
+ * create vs. modify vs. delete — the consumer re-indexes the path and lets the
+ * indexer decide (a vanished file is reconciled away). Debouncing bursts of
+ * edits is a separate concern (ama-gd5.3); this emits raw change events.
+ *
+ * Built on Node's native `fs.watch` to avoid a dependency. Recursive watching
+ * is supported on macOS and Windows; on Linux the recursive option may not be
+ * available, in which case this watches only the top level.
+ */
+export class FileWatcher {
+    root;
+    onChange;
+    subscription;
+    maxFileSizeBytes;
+    source;
+    /** Loaded once so the watched set matches what the index built (incl .gitignore). */
+    ignoreRules;
+    /** Per-directory accumulated rules (root + each ancestor's nested .gitignore),
+     *  memoized so a burst of events in one directory reads each .gitignore once. */
+    rulesByDir = new Map();
+    constructor(root, onChange, options = {}) {
+        this.root = root;
+        this.onChange = onChange;
+        this.maxFileSizeBytes = options.maxFileSizeBytes ?? MAX_FILE_SIZE_BYTES;
+        this.source = options.source ?? fsWatchSource;
+        this.ignoreRules = loadIgnoreRules(root);
+    }
+    start() {
+        if (this.subscription)
+            return;
+        this.subscription = this.source(this.root, (rel) => this.handle(rel));
+    }
+    close() {
+        this.subscription?.close();
+        this.subscription = undefined;
+    }
+    /** Ignore rules in effect inside `dirRel`: the root rules plus every ancestor
+     *  directory's nested .gitignore, each rebased to its directory, so a changed
+     *  file is judged exactly as the discovery walk would (ama-pyk). Memoized per
+     *  directory; like the root rules, a .gitignore edited after start isn't
+     *  reloaded — restart the watcher for that. (ama-ezf) */
+    rulesForDir(dirRel) {
+        if (dirRel === "" || dirRel === ".")
+            return this.ignoreRules;
+        const cached = this.rulesByDir.get(dirRel);
+        if (cached)
+            return cached;
+        const parent = path.dirname(dirRel);
+        const rules = withNestedIgnore(path.join(this.root, dirRel), dirRel, this.rulesForDir(parent === "." ? "" : parent));
+        this.rulesByDir.set(dirRel, rules);
+        return rules;
+    }
+    handle(rel) {
+        const dir = path.dirname(rel);
+        if (isIgnoredPath(rel, this.rulesForDir(dir === "." ? "" : dir)))
+            return;
+        let stat;
+        try {
+            stat = fs.statSync(path.join(this.root, rel));
+        }
+        catch {
+            // The path is gone (a deletion) — still report it so the consumer can drop it.
+            this.onChange(rel);
+            return;
+        }
+        // A directory event or an oversized file is not something to re-index.
+        if (!stat.isFile() || stat.size > this.maxFileSizeBytes)
+            return;
+        this.onChange(rel);
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/indexer/watcher.js.map

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

package/dist/mcp/build-info.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A stamp identifying the running server build, surfaced on `index_status` so a
+ * caller (e.g. the self-improvement loop's Step 0) can detect a stale server —
+ * one started before the latest commit. It is captured ONCE at module load, so
+ * `revision` reflects the code the process was launched with, not live HEAD: if
+ * you commit without restarting, the stamp lags HEAD and the staleness shows.
+ */
+export interface ServerStamp {
+    /** Package version from package.json. */
+    version: string;
+    /** Git HEAD revision at server start, or null when run outside a git repo. */
+    revision: string | null;
+}
+/** Captured once at module load — the code the running server was started with. */
+export declare const serverStamp: ServerStamp;
+//# sourceMappingURL=build-info.d.ts.map

package/dist/mcp/build-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.d.ts","sourceRoot":"","sources":["../../src/mcp/build-info.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AA8CD,mFAAmF;AACnF,eAAO,MAAM,WAAW,EAAE,WAGzB,CAAC"}

package/dist/mcp/build-info.js

@@ -0,0 +1,54 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+const here = path.dirname(fileURLToPath(import.meta.url));
+// src/mcp/build-info.ts and dist/mcp/build-info.js both sit two levels under
+// the repo root, so the same relative hop finds package.json and .git either way.
+const repoRoot = path.resolve(here, "../..");
+function readVersion(root) {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+/** Resolve HEAD to a commit SHA from the filesystem (loose ref, then packed-refs). */
+function readRevision(root) {
+    try {
+        const gitDir = path.join(root, ".git");
+        const head = fs.readFileSync(path.join(gitDir, "HEAD"), "utf8").trim();
+        const ref = head.match(/^ref:\s*(.+)$/)?.[1];
+        if (!ref) {
+            // Detached HEAD: the HEAD file holds the SHA directly.
+            return /^[0-9a-f]{40}$/.test(head) ? head : null;
+        }
+        try {
+            const loose = fs.readFileSync(path.join(gitDir, ref), "utf8").trim();
+            if (/^[0-9a-f]{40}$/.test(loose))
+                return loose;
+        }
+        catch {
+            // No loose ref file — fall through to packed-refs.
+        }
+        const packed = fs.readFileSync(path.join(gitDir, "packed-refs"), "utf8");
+        for (const line of packed.split("\n")) {
+            if (!line || line.startsWith("#") || line.startsWith("^"))
+                continue;
+            const [sha, name] = line.split(" ");
+            if (name === ref && sha)
+                return sha;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Captured once at module load — the code the running server was started with. */
+export const serverStamp = {
+    version: readVersion(repoRoot),
+    revision: readRevision(repoRoot),
+};
+//# sourceMappingURL=build-info.js.map

package/dist/mcp/build-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-info.js","sourceRoot":"","sources":["../../src/mcp/build-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAgBzC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,6EAA6E;AAC7E,kFAAkF;AAClF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAE7C,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAE9E,CAAC;QACF,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACvE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,uDAAuD;YACvD,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,CAAC;QACD,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YACrE,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;QACD,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;QACzE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YACpE,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,IAAI,KAAK,GAAG,IAAI,GAAG;gBAAE,OAAO,GAAG,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC;IAC9B,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC;CACjC,CAAC"}