lmgrep 0.1.17 → 0.2.0

package/dist/infrastructure/ai/ProviderModuleLoader.js

@@ -0,0 +1,49 @@
+import { execSync } from "node:child_process";
+import { createRequire } from "node:module";
+import { join } from "node:path";
+/**
+ * Imports an AI SDK provider package.
+ *
+ * Providers are peer dependencies the user installs, so resolution has to
+ * reach beyond this package's own `node_modules`: an `npm i -g @ai-sdk/openai`
+ * is a normal setup and would otherwise fail to resolve.
+ */
+export class ProviderModuleLoader {
+    cache = new Map();
+    async load(packageName) {
+        const cached = this.cache.get(packageName);
+        if (cached)
+            return cached;
+        const loaded = await this.resolve(packageName);
+        this.cache.set(packageName, loaded);
+        return loaded;
+    }
+    async resolve(packageName) {
+        // Local resolution first — the common case.
+        try {
+            return await import(packageName);
+        }
+        catch { }
+        for (const globalPath of this.globalModulePaths()) {
+            try {
+                const req = createRequire(join(globalPath, ".placeholder"));
+                return await import(req.resolve(packageName));
+            }
+            catch { }
+        }
+        throw new Error(`Provider "${packageName}" is not installed. Run:\n\n  npm install -g ${packageName}\n`);
+    }
+    globalModulePaths() {
+        const paths = [];
+        for (const command of ["pnpm root -g", "npm root -g"]) {
+            try {
+                const out = execSync(command, { stdio: "pipe" }).toString().trim();
+                if (out)
+                    paths.push(out);
+            }
+            catch { }
+        }
+        return paths;
+    }
+}
+//# sourceMappingURL=ProviderModuleLoader.js.map

package/dist/infrastructure/ai/ProviderModuleLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderModuleLoader.js","sourceRoot":"","sources":["../../../src/infrastructure/ai/ProviderModuleLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IACf,KAAK,GAAG,IAAI,GAAG,EAAmC,CAAC;IAEpE,KAAK,CAAC,IAAI,CAAC,WAAmB;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC3C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,WAAmB;QACxC,4CAA4C;QAC5C,IAAI,CAAC;YACJ,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QAEV,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;YACnD,IAAI,CAAC;gBACJ,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;gBAC5D,OAAO,MAAM,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;YAC/C,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACX,CAAC;QAED,MAAM,IAAI,KAAK,CACd,aAAa,WAAW,gDAAgD,WAAW,IAAI,CACvF,CAAC;IACH,CAAC;IAEO,iBAAiB;QACxB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,OAAO,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC;gBACJ,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;gBACnE,IAAI,GAAG;oBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACX,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC;CACD"}

package/dist/infrastructure/ai/ProviderRegistry.d.ts

@@ -0,0 +1,37 @@
+import { ProviderModuleLoader } from "./ProviderModuleLoader.js";
+/** A `provider:model` string split into its parts. */
+export declare class ModelReference {
+    readonly provider: string;
+    readonly model: string;
+    readonly full: string;
+    private constructor();
+    static parse(value: string, label: string): ModelReference;
+}
+export interface ProviderRequest {
+    reference: ModelReference;
+    /** Package to import; defaults to `@ai-sdk/<provider>`. */
+    packageName?: string;
+    baseURL?: string;
+    /**
+     * Whether a configured `baseURL` should force use of the `create*` factory
+     * even when the module exports a ready-made default instance.
+     *
+     * It matters because a bare default export (e.g. `openai`) ignores baseURL
+     * and would silently talk to the cloud. The chat path sets this; the
+     * embedding path historically does not, and the two are kept distinct here
+     * rather than quietly unified.
+     */
+    preferFactoryWhenBaseUrlSet: boolean;
+}
+/**
+ * Turns a `provider:model` string plus config into a live AI SDK provider.
+ *
+ * Both the embedding and chat paths need the same import-and-instantiate
+ * dance, so it lives here once; the one place they genuinely differ is
+ * expressed as {@link ProviderRequest.preferFactoryWhenBaseUrlSet}.
+ */
+export declare class ProviderRegistry {
+    private readonly loader;
+    constructor(loader?: ProviderModuleLoader);
+    instantiate(request: ProviderRequest): Promise<unknown>;
+}

package/dist/infrastructure/ai/ProviderRegistry.js

@@ -0,0 +1,55 @@
+import { ProviderModuleLoader } from "./ProviderModuleLoader.js";
+/** A `provider:model` string split into its parts. */
+export class ModelReference {
+    provider;
+    model;
+    full;
+    constructor(provider, model, full) {
+        this.provider = provider;
+        this.model = model;
+        this.full = full;
+    }
+    static parse(value, label) {
+        const colon = value.indexOf(":");
+        if (colon === -1) {
+            throw new Error(`${label} must be in "provider:model" format. Got: "${value}"`);
+        }
+        return new ModelReference(value.slice(0, colon), value.slice(colon + 1), value);
+    }
+}
+/**
+ * Turns a `provider:model` string plus config into a live AI SDK provider.
+ *
+ * Both the embedding and chat paths need the same import-and-instantiate
+ * dance, so it lives here once; the one place they genuinely differ is
+ * expressed as {@link ProviderRequest.preferFactoryWhenBaseUrlSet}.
+ */
+export class ProviderRegistry {
+    loader;
+    constructor(loader = new ProviderModuleLoader()) {
+        this.loader = loader;
+    }
+    async instantiate(request) {
+        const providerName = request.reference.provider;
+        const packageName = request.packageName ?? `@ai-sdk/${providerName}`;
+        const module = await this.loader.load(packageName);
+        let instance = module[providerName];
+        const forceFactory = request.preferFactoryWhenBaseUrlSet && Boolean(request.baseURL);
+        if (!instance || forceFactory) {
+            const factoryKey = Object.keys(module).find((k) => k.startsWith("create"));
+            if (factoryKey) {
+                const factory = module[factoryKey];
+                instance = factory({
+                    name: providerName,
+                    ...(request.baseURL ? { baseURL: request.baseURL } : {}),
+                });
+            }
+        }
+        if (!instance) {
+            throw new Error(`Package "${packageName}" has no usable provider export. ` +
+                `Available: ${Object.keys(module).join(", ")}`);
+        }
+        return instance;
+    }
+}
+//# sourceMappingURL=ProviderRegistry.js.map

package/dist/infrastructure/ai/ProviderRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderRegistry.js","sourceRoot":"","sources":["../../../src/infrastructure/ai/ProviderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,sDAAsD;AACtD,MAAM,OAAO,cAAc;IAEhB;IACA;IACA;IAHV,YACU,QAAgB,EAChB,KAAa,EACb,IAAY;QAFZ,aAAQ,GAAR,QAAQ,CAAQ;QAChB,UAAK,GAAL,KAAK,CAAQ;QACb,SAAI,GAAJ,IAAI,CAAQ;IACnB,CAAC;IAEJ,MAAM,CAAC,KAAK,CAAC,KAAa,EAAE,KAAa;QACxC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACd,GAAG,KAAK,8CAA8C,KAAK,GAAG,CAC9D,CAAC;QACH,CAAC;QACD,OAAO,IAAI,cAAc,CACxB,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EACrB,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EACtB,KAAK,CACL,CAAC;IACH,CAAC;CACD;AAmBD;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IAEV;IADlB,YACkB,SAA+B,IAAI,oBAAoB,EAAE;QAAzD,WAAM,GAAN,MAAM,CAAmD;IACxE,CAAC;IAEJ,KAAK,CAAC,WAAW,CAAC,OAAwB;QACzC,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC;QAChD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,WAAW,YAAY,EAAE,CAAC;QACrE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEnD,IAAI,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;QAEpC,MAAM,YAAY,GACjB,OAAO,CAAC,2BAA2B,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,CAAC,QAAQ,IAAI,YAAY,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACjD,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CACtB,CAAC;YACF,IAAI,UAAU,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAErB,CAAC;gBACb,QAAQ,GAAG,OAAO,CAAC;oBAClB,IAAI,EAAE,YAAY;oBAClB,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxD,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACd,YAAY,WAAW,mCAAmC;gBACzD,cAAc,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/C,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IACjB,CAAC;CACD"}

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

@@ -0,0 +1,59 @@
+import type { ConfigSource } from "../../domain/config/ConfigSource.js";
+import type { LmgrepConfig } from "../../domain/config/LmgrepConfig.js";
+/**
+ * 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 declare class ConfigLoader {
+    /** Settings that describe this machine's inference setup. */
+    private static readonly MACHINE_SCHEMA;
+    /** Settings that describe a repository. */
+    private static readonly PROJECT_SCHEMA;
+    private static readonly FILE_NAME;
+    private static readonly PROJECT_FILE_NAMES;
+    private static readonly DEFAULTS;
+    /** Populated by {@link load}: what was read, and what was ignored. */
+    readonly sources: ConfigSource[];
+    readonly warnings: string[];
+    load(cwd: string): LmgrepConfig;
+    /**
+     * The XDG-compliant global config directory.
+     *   Linux:  $XDG_CONFIG_HOME/lmgrep  or  ~/.config/lmgrep
+     *   macOS:  ~/Library/Application Support/lmgrep
+     */
+    configDirectory(): string;
+    globalConfigPath(): string;
+    /** Path of the project file in `cwd`, whether or not it exists. */
+    projectConfigPath(cwd: string): string;
+    /**
+     * 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: string): Partial<LmgrepConfig> | undefined;
+    private readMachineFile;
+    private readProjectFile;
+    private parseYaml;
+    private pick;
+    private static machineKeys;
+    private static projectKeys;
+    private validate;
+}

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;
+}