lmgrep 0.1.18 → 0.2.1

package/dist/infrastructure/fs/ConfigLoader.js

@@ -0,0 +1,194 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+import { parse } from "yaml";
+import { z } from "zod";
+/**
+ * Loads configuration from two kinds of file, split by what the settings
+ * actually describe.
+ *
+ * **Machine settings** — which model to embed with, which to answer with,
+ * where those servers listen — describe *this computer's* inference setup.
+ * They live in one global file. They used to be settable per project too,
+ * which was the single most confusing thing about lmgrep: the model determines
+ * what a stored vector *means*, so a project file could silently point an
+ * index at incompatible embeddings, and `status` would report an effective
+ * model without saying which of three files produced it.
+ *
+ * **Project settings** — what to ignore, which extensions to index — describe
+ * *this repository*, are worth committing, and mean the same thing on every
+ * machine that checks it out.
+ *
+ * Machine keys found in a project file are reported and ignored rather than
+ * applied. Wanting a different model for one project is a real thing to want;
+ * it is now spelled as a different database (`--database`), because the model
+ * is a property of an index rather than of a directory.
+ */
+export class ConfigLoader {
+    /** Settings that describe this machine's inference setup. */
+    static MACHINE_SCHEMA = z.object({
+        model: z
+            .string()
+            .regex(/^.+:.+$/, 'Model must be in "provider:model" format (e.g. "ollama:nomic-embed-text")'),
+        provider: z.string().optional(),
+        baseURL: z.string().url().optional(),
+        local: z.boolean().optional(),
+        batchSize: z.number().int().positive().default(100),
+        dimensions: z.number().int().positive().optional(),
+        queryPrefix: z.string().optional(),
+        documentPrefix: z.string().optional(),
+        maxTokens: z.number().int().positive().optional(),
+        chatModel: z
+            .string()
+            .regex(/^.+:.+$/, 'chatModel must be in "provider:model" format (e.g. "lmstudio:qwen/qwen3.5-9b")')
+            .optional(),
+        chatProvider: z.string().optional(),
+        chatBaseURL: z.string().url().optional(),
+        chatMaxSteps: z.number().int().positive().optional(),
+        chatTimeoutMs: z.number().int().positive().optional(),
+    });
+    /** Settings that describe a repository. */
+    static PROJECT_SCHEMA = z.object({
+        ignore: z.array(z.string()).optional(),
+        extensions: z
+            .object({
+            include: z.array(z.string()).optional(),
+            exclude: z.array(z.string()).optional(),
+        })
+            .optional(),
+    });
+    static FILE_NAME = "config.yml";
+    static PROJECT_FILE_NAMES = [".lmgrep.yml", ".lmgrep.yaml"];
+    static DEFAULTS = { batchSize: 100 };
+    /** Populated by {@link load}: what was read, and what was ignored. */
+    sources = [];
+    warnings = [];
+    load(cwd) {
+        const layers = [];
+        // Home-level files are machine settings wherever they sit; the bare
+        // ~/.lmgrep.yml predates the XDG path and is still honoured so an
+        // upgrade does not silently unconfigure anyone.
+        const legacy = this.readMachineFile(join(homedir(), ".lmgrep.yml"), "deprecated");
+        if (legacy)
+            layers.push(legacy);
+        const global = this.readMachineFile(this.globalConfigPath());
+        if (global)
+            layers.push(global);
+        const project = this.readProjectFile(cwd);
+        if (project)
+            layers.push(project);
+        if (layers.length === 0) {
+            throw new Error("No configuration found. Run `lmgrep init` to set up your embedding model.");
+        }
+        return this.validate(Object.assign({ ...ConfigLoader.DEFAULTS }, ...layers));
+    }
+    /**
+     * The XDG-compliant global config directory.
+     *   Linux:  $XDG_CONFIG_HOME/lmgrep  or  ~/.config/lmgrep
+     *   macOS:  ~/Library/Application Support/lmgrep
+     */
+    configDirectory() {
+        if (platform() === "darwin") {
+            return join(homedir(), "Library", "Application Support", "lmgrep");
+        }
+        const xdg = process.env.XDG_CONFIG_HOME;
+        return join(xdg || join(homedir(), ".config"), "lmgrep");
+    }
+    globalConfigPath() {
+        return join(this.configDirectory(), ConfigLoader.FILE_NAME);
+    }
+    /** Path of the project file in `cwd`, whether or not it exists. */
+    projectConfigPath(cwd) {
+        for (const name of ConfigLoader.PROJECT_FILE_NAMES) {
+            if (existsSync(join(cwd, name)))
+                return join(cwd, name);
+        }
+        return join(cwd, ConfigLoader.PROJECT_FILE_NAMES[0]);
+    }
+    /**
+     * Parse a single machine config file, ignoring the layering.
+     *
+     * `init` rewrites one specific file, so it needs that file's own contents —
+     * merging layers here would copy one file's settings into another.
+     */
+    readFile(path) {
+        const raw = this.parseYaml(path);
+        if (!raw)
+            return undefined;
+        return ConfigLoader.MACHINE_SCHEMA.partial().parse(this.pick(raw, ConfigLoader.machineKeys()));
+    }
+    readMachineFile(path, deprecated) {
+        const raw = this.parseYaml(path);
+        if (!raw)
+            return undefined;
+        const projectKeys = ConfigLoader.projectKeys().filter((k) => k in raw);
+        if (projectKeys.length > 0) {
+            this.warnings.push(`${path}: ${projectKeys.join(", ")} ${projectKeys.length === 1 ? "is a project setting" : "are project settings"} — ` +
+                "move to .lmgrep.yml in the repository it applies to.");
+        }
+        const parsed = ConfigLoader.MACHINE_SCHEMA.partial().parse(this.pick(raw, ConfigLoader.machineKeys()));
+        // Deprecation is not warned about here: `lmgrep status` marks the
+        // location in its provenance listing, which is where someone is
+        // actually looking at their configuration. Printing it before every
+        // search would be noise on the one path that must stay quiet.
+        this.sources.push({
+            path,
+            scope: "machine",
+            keys: Object.keys(parsed),
+            ...(deprecated ? { deprecated: true } : {}),
+        });
+        return parsed;
+    }
+    readProjectFile(cwd) {
+        for (const name of ConfigLoader.PROJECT_FILE_NAMES) {
+            const path = join(cwd, name);
+            const raw = this.parseYaml(path);
+            if (!raw)
+                continue;
+            const machineKeys = ConfigLoader.machineKeys().filter((k) => k in raw);
+            if (machineKeys.length > 0) {
+                // Named individually because the consequence differs per key:
+                // a stray `model` here silently decided what an index meant.
+                this.warnings.push(`${path}: ignoring ${machineKeys.join(", ")} — these describe your machine, ` +
+                    `not this repository. Set them in ${this.globalConfigPath()}. ` +
+                    "For a project-specific model, index it under `--in <name>` instead.");
+            }
+            const parsed = ConfigLoader.PROJECT_SCHEMA.parse(this.pick(raw, ConfigLoader.projectKeys()));
+            this.sources.push({
+                path,
+                scope: "project",
+                keys: Object.keys(parsed),
+            });
+            return parsed;
+        }
+        return undefined;
+    }
+    parseYaml(path) {
+        if (!existsSync(path))
+            return undefined;
+        const parsed = parse(readFileSync(path, "utf-8"));
+        if (parsed == null || typeof parsed !== "object")
+            return undefined;
+        return parsed;
+    }
+    pick(raw, keys) {
+        const out = {};
+        for (const key of keys)
+            if (key in raw)
+                out[key] = raw[key];
+        return out;
+    }
+    static machineKeys() {
+        return Object.keys(ConfigLoader.MACHINE_SCHEMA.shape);
+    }
+    static projectKeys() {
+        return Object.keys(ConfigLoader.PROJECT_SCHEMA.shape);
+    }
+    validate(config) {
+        if (!config.model) {
+            throw new Error(`No model configured. Run \`lmgrep init\` to detect your setup, or set \`model\` in ${this.globalConfigPath()}.`);
+        }
+        return config;
+    }
+}
+//# sourceMappingURL=ConfigLoader.js.map

package/dist/infrastructure/fs/ConfigLoader.js.map

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

package/dist/infrastructure/fs/DatabaseLocks.d.ts

@@ -0,0 +1,52 @@
+import type { LockPort } from "../../domain/ports/LockPort.js";
+/**
+ * The two locks a database has, which exist for different reasons and are
+ * therefore scoped differently.
+ *
+ * The **write mutex** (`.writelock`) is per *database*, because that is what
+ * concurrent writers actually contend for: two indexers writing the same
+ * tables race into duplicate rows. It is held only around a build.
+ *
+ * The **maintainer** lock is per *worktree*. Watching is inherently per
+ * working tree — a watcher scans its own root and maintains its own branch's
+ * manifest — but worktrees of one repository share a single database. Keying
+ * this lock by database, as it once was, meant the first worktree to start
+ * silently prevented every sibling from ever watching, leaving their branches
+ * to go stale with no indication. It also doubles as the liveness registry
+ * `lmgrep status` reads, which is why the owning worktree is recorded in it.
+ *
+ * Both live in the state directory rather than beside the database. Locks
+ * coordinate processes on *this machine*; a database now lives inside a
+ * repository, which may be on a network filesystem, may be read-only, and is
+ * the wrong place to record which local pid is busy with it. Keeping them
+ * together in one directory is also what lets `status` find every running
+ * lmgrep by reading a single directory.
+ */
+export declare class DatabaseLocks implements LockPort {
+    private readonly databasePath;
+    /** Working tree this process would be responsible for. */
+    private readonly workspaceRoot;
+    private static readonly DEFAULT_WAIT_MS;
+    private static readonly DEFAULT_POLL_MS;
+    /** Enough to separate worktrees without making the filename unreadable. */
+    private static readonly ROOT_DIGEST_LENGTH;
+    private readonly maintainer;
+    private readonly writer;
+    constructor(locksDirectory: string, databasePath: string, 
+    /** Working tree this process would be responsible for. */
+    workspaceRoot: string);
+    acquireMaintainer(): boolean;
+    releaseMaintainer(): void;
+    isMaintained(): boolean;
+    /**
+     * Run `fn` holding the write mutex. Waits for a busy lock, taking over one
+     * whose owner has died. Throws if it cannot be acquired in time — better to
+     * fail than to write concurrently and duplicate rows.
+     */
+    withWriteLock<T>(fn: () => Promise<T>, options?: {
+        waitMs?: number;
+        pollMs?: number;
+    }): Promise<T>;
+    /** Short stable name for a path, used to key lock files. */
+    private static digestOf;
+}

package/dist/infrastructure/fs/DatabaseLocks.js

@@ -0,0 +1,92 @@
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+import { PidFileLock } from "./PidFileLock.js";
+/**
+ * The two locks a database has, which exist for different reasons and are
+ * therefore scoped differently.
+ *
+ * The **write mutex** (`.writelock`) is per *database*, because that is what
+ * concurrent writers actually contend for: two indexers writing the same
+ * tables race into duplicate rows. It is held only around a build.
+ *
+ * The **maintainer** lock is per *worktree*. Watching is inherently per
+ * working tree — a watcher scans its own root and maintains its own branch's
+ * manifest — but worktrees of one repository share a single database. Keying
+ * this lock by database, as it once was, meant the first worktree to start
+ * silently prevented every sibling from ever watching, leaving their branches
+ * to go stale with no indication. It also doubles as the liveness registry
+ * `lmgrep status` reads, which is why the owning worktree is recorded in it.
+ *
+ * Both live in the state directory rather than beside the database. Locks
+ * coordinate processes on *this machine*; a database now lives inside a
+ * repository, which may be on a network filesystem, may be read-only, and is
+ * the wrong place to record which local pid is busy with it. Keeping them
+ * together in one directory is also what lets `status` find every running
+ * lmgrep by reading a single directory.
+ */
+export class DatabaseLocks {
+    databasePath;
+    workspaceRoot;
+    static DEFAULT_WAIT_MS = 120_000;
+    static DEFAULT_POLL_MS = 200;
+    /** Enough to separate worktrees without making the filename unreadable. */
+    static ROOT_DIGEST_LENGTH = 12;
+    maintainer;
+    writer;
+    constructor(locksDirectory, databasePath, 
+    /** Working tree this process would be responsible for. */
+    workspaceRoot) {
+        this.databasePath = databasePath;
+        this.workspaceRoot = workspaceRoot;
+        const database = DatabaseLocks.digestOf(databasePath);
+        this.maintainer = new PidFileLock(join(locksDirectory, `${database}@${DatabaseLocks.digestOf(workspaceRoot)}.lock`));
+        this.writer = new PidFileLock(join(locksDirectory, `${database}.writelock`));
+    }
+    acquireMaintainer() {
+        // The database path goes in the payload because it is no longer in the
+        // filename: a digest cannot be reversed, and `status` needs to name the
+        // index a process is holding.
+        return this.maintainer.tryAcquire({
+            root: this.workspaceRoot,
+            database: this.databasePath,
+        });
+    }
+    releaseMaintainer() {
+        this.maintainer.release();
+    }
+    isMaintained() {
+        return this.maintainer.isHeldByLiveProcess();
+    }
+    /**
+     * Run `fn` holding the write mutex. Waits for a busy lock, taking over one
+     * whose owner has died. Throws if it cannot be acquired in time — better to
+     * fail than to write concurrently and duplicate rows.
+     */
+    async withWriteLock(fn, options = {}) {
+        const waitMs = options.waitMs ?? DatabaseLocks.DEFAULT_WAIT_MS;
+        const pollMs = options.pollMs ?? DatabaseLocks.DEFAULT_POLL_MS;
+        let waited = 0;
+        while (!this.writer.tryAcquire()) {
+            if (waited >= waitMs) {
+                throw new Error("Could not acquire the index write lock — another indexer is busy. " +
+                    "Try again once it finishes.");
+            }
+            await new Promise((r) => setTimeout(r, pollMs));
+            waited += pollMs;
+        }
+        try {
+            return await fn();
+        }
+        finally {
+            this.writer.releaseIfOwned();
+        }
+    }
+    /** Short stable name for a path, used to key lock files. */
+    static digestOf(path) {
+        return createHash("sha256")
+            .update(path)
+            .digest("hex")
+            .slice(0, DatabaseLocks.ROOT_DIGEST_LENGTH);
+    }
+}
+//# sourceMappingURL=DatabaseLocks.js.map

package/dist/infrastructure/fs/DatabaseLocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseLocks.js","sourceRoot":"","sources":["../../../src/infrastructure/fs/DatabaseLocks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,aAAa;IAWP;IAEA;IAZV,MAAM,CAAU,eAAe,GAAG,OAAO,CAAC;IAC1C,MAAM,CAAU,eAAe,GAAG,GAAG,CAAC;IAC9C,2EAA2E;IACnE,MAAM,CAAU,kBAAkB,GAAG,EAAE,CAAC;IAE/B,UAAU,CAAc;IACxB,MAAM,CAAc;IAErC,YACC,cAAsB,EACL,YAAoB;IACrC,0DAA0D;IACzC,aAAqB;QAFrB,iBAAY,GAAZ,YAAY,CAAQ;QAEpB,kBAAa,GAAb,aAAa,CAAQ;QAEtC,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACtD,IAAI,CAAC,UAAU,GAAG,IAAI,WAAW,CAChC,IAAI,CACH,cAAc,EACd,GAAG,QAAQ,IAAI,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAC3D,CACD,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,IAAI,WAAW,CAC5B,IAAI,CAAC,cAAc,EAAE,GAAG,QAAQ,YAAY,CAAC,CAC7C,CAAC;IACH,CAAC;IAED,iBAAiB;QAChB,uEAAuE;QACvE,wEAAwE;QACxE,8BAA8B;QAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YACjC,IAAI,EAAE,IAAI,CAAC,aAAa;YACxB,QAAQ,EAAE,IAAI,CAAC,YAAY;SAC3B,CAAC,CAAC;IACJ,CAAC;IAED,iBAAiB;QAChB,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,YAAY;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAClB,EAAoB,EACpB,UAAgD,EAAE;QAElD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC,eAAe,CAAC;QAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC,eAAe,CAAC;QAE/D,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;YAClC,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CACd,oEAAoE;oBACnE,6BAA6B,CAC9B,CAAC;YACH,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;YAChD,MAAM,IAAI,MAAM,CAAC;QAClB,CAAC;QAED,IAAI,CAAC;YACJ,OAAO,MAAM,EAAE,EAAE,CAAC;QACnB,CAAC;gBAAS,CAAC;YACV,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC9B,CAAC;IACF,CAAC;IAED,4DAA4D;IACpD,MAAM,CAAC,QAAQ,CAAC,IAAY;QACnC,OAAO,UAAU,CAAC,QAAQ,CAAC;aACzB,MAAM,CAAC,IAAI,CAAC;aACZ,MAAM,CAAC,KAAK,CAAC;aACb,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAC9C,CAAC"}

package/dist/infrastructure/fs/DiskUsage.d.ts

@@ -0,0 +1,6 @@
+/** Recursive on-disk size, for reporting what an index actually costs. */
+export declare class DiskUsage {
+    /** Bytes used by `path` and everything under it; 0 when unreadable. */
+    static of(path: string): number;
+    static format(bytes: number): string;
+}

package/dist/infrastructure/fs/DiskUsage.js

@@ -0,0 +1,41 @@
+import { readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+/** Recursive on-disk size, for reporting what an index actually costs. */
+export class DiskUsage {
+    /** Bytes used by `path` and everything under it; 0 when unreadable. */
+    static of(path) {
+        let total = 0;
+        let entries;
+        try {
+            entries = readdirSync(path, { withFileTypes: true });
+        }
+        catch {
+            return 0;
+        }
+        for (const entry of entries) {
+            const child = join(path, entry.name);
+            if (entry.isDirectory()) {
+                total += DiskUsage.of(child);
+                continue;
+            }
+            try {
+                total += statSync(child).size;
+            }
+            catch {
+                // Vanished mid-walk; the number is a report, not an invariant.
+            }
+        }
+        return total;
+    }
+    static format(bytes) {
+        const units = ["B", "KB", "MB", "GB", "TB"];
+        let value = bytes;
+        let unit = 0;
+        while (value >= 1024 && unit < units.length - 1) {
+            value /= 1024;
+            unit++;
+        }
+        return `${value < 10 && unit > 0 ? value.toFixed(1) : Math.round(value)}${units[unit]}`;
+    }
+}
+//# sourceMappingURL=DiskUsage.js.map

package/dist/infrastructure/fs/DiskUsage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiskUsage.js","sourceRoot":"","sources":["../../../src/infrastructure/fs/DiskUsage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,0EAA0E;AAC1E,MAAM,OAAO,SAAS;IACrB,uEAAuE;IACvE,MAAM,CAAC,EAAE,CAAC,IAAY;QACrB,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,OAAmC,CAAC;QACxC,IAAI,CAAC;YACJ,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,CAAC,CAAC;QACV,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACzB,KAAK,IAAI,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;gBAC7B,SAAS;YACV,CAAC;YACD,IAAI,CAAC;gBACJ,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACR,+DAA+D;YAChE,CAAC;QACF,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,KAAa;QAC1B,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5C,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,OAAO,KAAK,IAAI,IAAI,IAAI,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjD,KAAK,IAAI,IAAI,CAAC;YACd,IAAI,EAAE,CAAC;QACR,CAAC;QACD,OAAO,GAAG,KAAK,GAAG,EAAE,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;IACzF,CAAC;CACD"}

package/dist/infrastructure/fs/IndexableFileRules.d.ts

@@ -0,0 +1,33 @@
+import type { ExtensionRules } from "../../domain/ports/WorkspacePort.js";
+/**
+ * Decides which files are worth indexing.
+ *
+ * Two independent filters: an extension allow-list (is this even source?) and
+ * ignore patterns (should this source be skipped?). Ignore rules come from the
+ * built-in list, the user's config, `.gitignore` and `.lmgrepignore`, plus
+ * nested `.gitignore` files further down the tree.
+ */
+export declare class IndexableFileRules {
+    private readonly cwd;
+    static readonly DEFAULT_IGNORE: string[];
+    static readonly CODE_EXTENSIONS: Set<string>;
+    private readonly root;
+    private readonly extensions;
+    private readonly nested;
+    constructor(cwd: string, extraIgnore?: string[], extensionRules?: ExtensionRules);
+    /** Whether the path's extension is one we index at all. */
+    hasIndexableExtension(filePath: string): boolean;
+    /** Whether the root-level ignore rules exclude this path. */
+    isIgnored(filePath: string): boolean;
+    /**
+     * Load `.gitignore` files sitting in subdirectories, so a nested ignore
+     * applies to its own subtree the way git applies it.
+     */
+    loadNestedIgnores(relativePaths: readonly string[]): void;
+    /** Whether any nested `.gitignore` excludes this path. */
+    isIgnoredByNested(filePath: string): boolean;
+    /** Full decision for a scanned path. */
+    admits(filePath: string): boolean;
+    private static buildIgnore;
+    private static buildExtensions;
+}

package/dist/infrastructure/fs/IndexableFileRules.js

@@ -0,0 +1,177 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, extname, join } from "node:path";
+import ignore from "ignore";
+/**
+ * Decides which files are worth indexing.
+ *
+ * Two independent filters: an extension allow-list (is this even source?) and
+ * ignore patterns (should this source be skipped?). Ignore rules come from the
+ * built-in list, the user's config, `.gitignore` and `.lmgrepignore`, plus
+ * nested `.gitignore` files further down the tree.
+ */
+export class IndexableFileRules {
+    cwd;
+    static DEFAULT_IGNORE = [
+        "node_modules",
+        ".git",
+        "dist",
+        "build",
+        ".next",
+        "__pycache__",
+        ".venv",
+        "vendor",
+        "target",
+        ".lmgrep",
+        "*.min.js",
+        "*.min.css",
+        "*.map",
+        "*.lock",
+        "pnpm-lock.yaml",
+        "package-lock.json",
+        "yarn.lock",
+        "*.png",
+        "*.jpg",
+        "*.jpeg",
+        "*.gif",
+        "*.ico",
+        "*.woff",
+        "*.woff2",
+        "*.ttf",
+        "*.eot",
+        "*.svg",
+        "*.zip",
+        "*.tar",
+        "*.gz",
+        "*.bin",
+        "*.exe",
+        "*.dll",
+        "*.so",
+        "*.dylib",
+        "*.wasm",
+    ];
+    static CODE_EXTENSIONS = new Set([
+        ".js",
+        ".ts",
+        ".jsx",
+        ".tsx",
+        ".py",
+        ".rs",
+        ".go",
+        ".rb",
+        ".c",
+        ".h",
+        ".cpp",
+        ".hpp",
+        ".cc",
+        ".swift",
+        ".json",
+        ".yaml",
+        ".yml",
+        ".toml",
+        ".lua",
+        ".scala",
+        ".zig",
+        ".md",
+        ".markdown",
+        ".mdx",
+        ".sh",
+        ".bash",
+        ".sql",
+        ".graphql",
+        ".gql",
+        ".proto",
+        ".html",
+        ".css",
+        ".scss",
+        ".vue",
+        ".svelte",
+        ".nix",
+        ".tf",
+        ".hcl",
+        ".kt",
+        ".java",
+        ".php",
+        ".cs",
+        ".rst",
+        ".adoc",
+    ]);
+    root;
+    extensions;
+    nested = new Map();
+    constructor(cwd, extraIgnore, extensionRules) {
+        this.cwd = cwd;
+        this.root = IndexableFileRules.buildIgnore(cwd, extraIgnore);
+        this.extensions = IndexableFileRules.buildExtensions(extensionRules);
+    }
+    /** Whether the path's extension is one we index at all. */
+    hasIndexableExtension(filePath) {
+        return this.extensions.has(extname(filePath));
+    }
+    /** Whether the root-level ignore rules exclude this path. */
+    isIgnored(filePath) {
+        try {
+            return this.root.ignores(filePath);
+        }
+        catch {
+            // `ignore` rejects paths it considers malformed; treat those as
+            // ignorable rather than letting one bad name abort a whole scan.
+            return true;
+        }
+    }
+    /**
+     * Load `.gitignore` files sitting in subdirectories, so a nested ignore
+     * applies to its own subtree the way git applies it.
+     */
+    loadNestedIgnores(relativePaths) {
+        for (const f of relativePaths) {
+            if (f.endsWith("/.gitignore") || f === ".gitignore")
+                continue;
+            const dir = dirname(f);
+            if (dir === "." || this.nested.has(dir))
+                continue;
+            const nestedPath = join(this.cwd, dir, ".gitignore");
+            if (!existsSync(nestedPath))
+                continue;
+            const rules = ignore();
+            rules.add(readFileSync(nestedPath, "utf-8"));
+            this.nested.set(dir, rules);
+        }
+    }
+    /** Whether any nested `.gitignore` excludes this path. */
+    isIgnoredByNested(filePath) {
+        for (const [dir, rules] of this.nested) {
+            if (!filePath.startsWith(`${dir}/`))
+                continue;
+            if (rules.ignores(filePath.slice(dir.length + 1)))
+                return true;
+        }
+        return false;
+    }
+    /** Full decision for a scanned path. */
+    admits(filePath) {
+        return (this.hasIndexableExtension(filePath) &&
+            !this.isIgnored(filePath) &&
+            !this.isIgnoredByNested(filePath));
+    }
+    static buildIgnore(cwd, extra) {
+        const rules = ignore();
+        rules.add([...IndexableFileRules.DEFAULT_IGNORE]);
+        if (extra)
+            rules.add(extra);
+        for (const name of [".gitignore", ".lmgrepignore"]) {
+            const path = join(cwd, name);
+            if (existsSync(path))
+                rules.add(readFileSync(path, "utf-8"));
+        }
+        return rules;
+    }
+    static buildExtensions(rules) {
+        const exts = new Set(IndexableFileRules.CODE_EXTENSIONS);
+        for (const e of rules?.include ?? [])
+            exts.add(e);
+        for (const e of rules?.exclude ?? [])
+            exts.delete(e);
+        return exts;
+    }
+}
+//# sourceMappingURL=IndexableFileRules.js.map

package/dist/infrastructure/fs/IndexableFileRules.js.map

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

package/dist/infrastructure/fs/Loggers.d.ts

@@ -0,0 +1,14 @@
+import type { LoggerPort } from "../../domain/ports/LoggerPort.js";
+/** Timestamped output on stdout/stderr, for foreground commands. */
+export declare class ConsoleLogger implements LoggerPort {
+    info(message: string): void;
+    error(message: string): void;
+}
+/**
+ * Discards everything. Used by the MCP server, whose stdout is a protocol
+ * stream — a stray log line there corrupts the transport.
+ */
+export declare class SilentLogger implements LoggerPort {
+    info(): void;
+    error(): void;
+}

package/dist/infrastructure/fs/Loggers.js

@@ -0,0 +1,18 @@
+/** Timestamped output on stdout/stderr, for foreground commands. */
+export class ConsoleLogger {
+    info(message) {
+        console.log(`[${new Date().toISOString()}] ${message}`);
+    }
+    error(message) {
+        console.error(`[${new Date().toISOString()}] ${message}`);
+    }
+}
+/**
+ * Discards everything. Used by the MCP server, whose stdout is a protocol
+ * stream — a stray log line there corrupts the transport.
+ */
+export class SilentLogger {
+    info() { }
+    error() { }
+}
+//# sourceMappingURL=Loggers.js.map