lmgrep 0.1.18 → 0.2.0

package/dist/presentation/cli/commands/SearchCommand.js

@@ -0,0 +1,55 @@
+import { CliOptions } from "../CliOptions.js";
+import { CommandContext as Ctx } from "../CommandContext.js";
+/**
+ * `lmgrep search` — the primary read path, and what a bare `lmgrep <query>`
+ * runs.
+ *
+ * The options here are the ones a person can answer from what they already
+ * know: how many results, where to look, which languages. Three that used to
+ * exist are gone because they could only be set by trial and error —
+ * `--min-score` needs the score distribution of your embedding model,
+ * `--type` needs tree-sitter's per-language node names, and `--not` doubled
+ * the cost of a query to express something a better query expresses anyway.
+ */
+export class SearchCommand {
+    context;
+    constructor(context) {
+        this.context = context;
+    }
+    register(program) {
+        CliOptions.target(program
+            .command("search <query...>")
+            .description("Search the codebase using natural language")
+            .option("-m, --limit <n>", "Max results", "25")
+            .option("--under <path>", "Only search files under this path")
+            .option("--language <exts>", "Only search these file extensions (comma-separated, e.g. .ts,.py)")
+            .option("--compact", "Print matching file paths only")
+            .option("--json", "Print results as JSON")).action((query, options) => this.run(query.join(" "), options));
+    }
+    async run(query, options) {
+        const { across } = Ctx.targets(options);
+        await this.context.withLmgrep(options, async (lmgrep) => {
+            const hits = await lmgrep.search(query, {
+                limit: Ctx.integer(options.limit, 25),
+                filePrefix: options.under,
+                language: Ctx.list(options.language),
+                across: across.length > 0 ? across : undefined,
+            });
+            const { renderer } = this.context;
+            if (options.json) {
+                renderer.json(hits.toArray());
+                return;
+            }
+            if (hits.isEmpty) {
+                renderer.line("No results found.");
+                return;
+            }
+            if (options.compact) {
+                renderer.hitPaths(hits.toArray());
+                return;
+            }
+            renderer.hits(hits.toArray());
+        });
+    }
+}
+//# sourceMappingURL=SearchCommand.js.map

package/dist/presentation/cli/commands/SearchCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchCommand.js","sourceRoot":"","sources":["../../../../src/presentation/cli/commands/SearchCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,cAAc,IAAI,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAU7D;;;;;;;;;;GAUG;AACH,MAAM,OAAO,aAAa;IACI;IAA7B,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,QAAQ,CAAC,OAAgB;QACxB,UAAU,CAAC,MAAM,CAChB,OAAO;aACL,OAAO,CAAC,mBAAmB,CAAC;aAC5B,WAAW,CAAC,4CAA4C,CAAC;aACzD,MAAM,CAAC,iBAAiB,EAAE,aAAa,EAAE,IAAI,CAAC;aAC9C,MAAM,CAAC,gBAAgB,EAAE,mCAAmC,CAAC;aAC7D,MAAM,CACN,mBAAmB,EACnB,mEAAmE,CACnE;aACA,MAAM,CAAC,WAAW,EAAE,gCAAgC,CAAC;aACrD,MAAM,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAC3C,CAAC,MAAM,CAAC,CAAC,KAAe,EAAE,OAAsB,EAAE,EAAE,CACpD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAClC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,GAAG,CAAC,KAAa,EAAE,OAAsB;QACtD,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACvD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;gBACvC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;gBACrC,UAAU,EAAE,OAAO,CAAC,KAAK;gBACzB,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;gBACpC,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;aAC9C,CAAC,CAAC;YAEH,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;YAClC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBAClB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC9B,OAAO;YACR,CAAC;YACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClB,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;gBACnC,OAAO;YACR,CAAC;YACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACrB,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;gBAClC,OAAO;YACR,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}

package/dist/presentation/cli/commands/ServerCommands.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../CommandContext.js";
+/**
+ * `serve` and `mcp` — the two long-running modes.
+ *
+ * Both keep the process alive deliberately: `serve` watches for changes, and
+ * `mcp` speaks the protocol over stdio until its client disconnects.
+ */
+export declare class ServerCommands {
+    private readonly context;
+    constructor(context: CommandContext);
+    register(program: Command): void;
+}

package/dist/presentation/cli/commands/ServerCommands.js

@@ -0,0 +1,40 @@
+import { CliOptions } from "../CliOptions.js";
+/**
+ * `serve` and `mcp` — the two long-running modes.
+ *
+ * Both keep the process alive deliberately: `serve` watches for changes, and
+ * `mcp` speaks the protocol over stdio until its client disconnects.
+ */
+export class ServerCommands {
+    context;
+    constructor(context) {
+        this.context = context;
+    }
+    register(program) {
+        CliOptions.target(program
+            .command("serve")
+            .description("Watch this project and re-index as files change")).action(async (options) => {
+            const lmgrep = await this.context.open(options);
+            const stop = lmgrep.watch();
+            // Deliberately not closed: the watcher owns this process until
+            // it is signalled.
+            const shutdown = () => {
+                stop();
+                void lmgrep.close().finally(() => process.exit(0));
+            };
+            process.on("SIGINT", shutdown);
+            process.on("SIGTERM", shutdown);
+        });
+        CliOptions.target(program
+            .command("mcp")
+            .description("Start the MCP server (stdio transport)")).action(async (options) => {
+            // The entry point reads its target from the environment, so it can
+            // be launched either as `lmgrep mcp` or as `lmgrep-mcp`.
+            const target = options.in?.[0];
+            if (target)
+                process.env.LMGREP_DATABASE = target;
+            await import("../../../mcp.js");
+        });
+    }
+}
+//# sourceMappingURL=ServerCommands.js.map

package/dist/presentation/cli/commands/ServerCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerCommands.js","sourceRoot":"","sources":["../../../../src/presentation/cli/commands/ServerCommands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACG;IAA7B,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,QAAQ,CAAC,OAAgB;QACxB,UAAU,CAAC,MAAM,CAChB,OAAO;aACL,OAAO,CAAC,OAAO,CAAC;aAChB,WAAW,CAAC,iDAAiD,CAAC,CAChE,CAAC,MAAM,CAAC,KAAK,EAAE,OAAsB,EAAE,EAAE;YACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAChD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;YAC5B,+DAA+D;YAC/D,mBAAmB;YACnB,MAAM,QAAQ,GAAG,GAAS,EAAE;gBAC3B,IAAI,EAAE,CAAC;gBACP,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACpD,CAAC,CAAC;YACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,MAAM,CAChB,OAAO;aACL,OAAO,CAAC,KAAK,CAAC;aACd,WAAW,CAAC,wCAAwC,CAAC,CACvD,CAAC,MAAM,CAAC,KAAK,EAAE,OAAsB,EAAE,EAAE;YACzC,mEAAmE;YACnE,yDAAyD;YACzD,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,eAAe,GAAG,MAAM,CAAC;YACjD,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}

package/dist/presentation/cli/commands/ShareCommands.d.ts

@@ -0,0 +1,22 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../CommandContext.js";
+/**
+ * `export` and `import` — moving an index between machines or databases.
+ *
+ * Both exist to avoid re-embedding, which is the expensive part of indexing.
+ * `import` accepts either a peer share code or a local database path, since
+ * "get this index from somewhere else" is one intent to the user.
+ */
+export declare class ShareCommands {
+    private readonly context;
+    constructor(context: CommandContext);
+    register(program: Command): void;
+    private registerExport;
+    private runExport;
+    private registerImport;
+    private runImport;
+    private importFromPeer;
+    private importFromDatabase;
+    /** The pieces every share operation needs, resolved from the cwd. */
+    private resolve;
+}

package/dist/presentation/cli/commands/ShareCommands.js

@@ -0,0 +1,134 @@
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { ModelIdentity } from "../../../domain/project/ModelIdentity.js";
+import { ProjectLocator } from "../../../domain/project/ProjectLocator.js";
+import { ConfigLoader } from "../../../infrastructure/fs/ConfigLoader.js";
+import { ProjectMetadataStore } from "../../../infrastructure/fs/ProjectMetadataStore.js";
+import { StateDirectory } from "../../../infrastructure/fs/StateDirectory.js";
+import { GitClient } from "../../../infrastructure/git/GitClient.js";
+import { DatabaseImporter } from "../../../infrastructure/lancedb/DatabaseImporter.js";
+import { LanceTables } from "../../../infrastructure/lancedb/LanceTables.js";
+import { RowReplication } from "../../../infrastructure/lancedb/RowReplication.js";
+import { IndexShare } from "../../../infrastructure/p2p/IndexShare.js";
+import { ShareCode } from "../../../infrastructure/p2p/ShareCode.js";
+/**
+ * `export` and `import` — moving an index between machines or databases.
+ *
+ * Both exist to avoid re-embedding, which is the expensive part of indexing.
+ * `import` accepts either a peer share code or a local database path, since
+ * "get this index from somewhere else" is one intent to the user.
+ */
+export class ShareCommands {
+    context;
+    constructor(context) {
+        this.context = context;
+    }
+    register(program) {
+        this.registerExport(program);
+        this.registerImport(program);
+    }
+    registerExport(program) {
+        program
+            .command("share")
+            .description("Offer this project's index to a peer over P2P")
+            .action(() => this.runExport());
+    }
+    async runExport() {
+        const { renderer } = this.context;
+        const { branch, location, metadata } = this.resolve();
+        const tables = new LanceTables(location, branch);
+        const share = new IndexShare(new RowReplication(tables, branch));
+        const { code, done } = await share.send(metadata, {
+            onProgress: (sent, total) => process.stderr.write(`\rSending: ${sent}/${total} chunks`),
+        });
+        renderer.line(`Share code: ${code}`);
+        renderer.line("Waiting for peer... (Ctrl+C to cancel)\n");
+        await done;
+        process.stderr.write("\n");
+        renderer.line("Transfer complete.");
+        tables.close();
+    }
+    registerImport(program) {
+        program
+            .command("import <source>")
+            .description("Import chunks from a peer (share code) or another lmgrep database (path)")
+            .option("--reset", "Reset the current index before importing")
+            .action((source, options) => this.runImport(source, options));
+    }
+    async runImport(source, options) {
+        if (ShareCode.looksLikeCode(source)) {
+            await this.importFromPeer(source, options);
+            return;
+        }
+        await this.importFromDatabase(source, options);
+    }
+    async importFromPeer(source, options) {
+        const { renderer } = this.context;
+        const code = ShareCode.parse(source);
+        if (!code)
+            throw new Error(`Not a valid share code: ${source}`);
+        renderer.line("Connecting to peer...");
+        const lmgrep = await this.context.open({});
+        if (options.reset)
+            await lmgrep.maintenance.reset();
+        const { branch, location, metadata } = this.resolve();
+        await lmgrep.close();
+        const tables = new LanceTables(location, branch);
+        const share = new IndexShare(new RowReplication(tables, branch));
+        const result = await share.receive(code, metadata, {
+            onProgress: (received, total) => process.stderr.write(`\rReceiving: ${received}/${total} chunks`),
+            onMeta: (meta) => renderer.line(`Peer index: ${meta.chunkCount} chunks` +
+                (meta.model ? `, model: ${meta.model}` : "") +
+                (meta.dimensions ? `, ${meta.dimensions} dims` : "")),
+            onWarning: (message) => renderer.error(message),
+        });
+        process.stderr.write("\n");
+        renderer.line(`Imported ${result.chunks} chunks and ${result.files} file hashes from peer.`);
+        tables.close();
+    }
+    async importFromDatabase(source, options) {
+        const { renderer } = this.context;
+        const cwd = this.context.cwd;
+        const { branch, location, store } = this.resolve();
+        const sourcePath = resolve(cwd, source);
+        if (!existsSync(sourcePath)) {
+            throw new Error(`Database not found: ${sourcePath}`);
+        }
+        if (resolve(sourcePath) === resolve(location)) {
+            throw new Error("Source and destination are the same database.");
+        }
+        const lmgrep = await this.context.open({});
+        if (options.reset)
+            await lmgrep.maintenance.reset();
+        await lmgrep.close();
+        const tables = new LanceTables(location, branch);
+        const { chunks, files } = await new DatabaseImporter(tables, branch).importFrom(sourcePath);
+        tables.close();
+        renderer.line(`Imported ${chunks} chunks and ${files} file hashes from ${sourcePath}`);
+        // The source's model is what these vectors mean; without a matching
+        // local model the import is unusable, so say so explicitly.
+        const sourceMeta = store.read(sourcePath);
+        if (sourceMeta?.model) {
+            const family = ModelIdentity.of(sourceMeta.model).family;
+            renderer.line(`\nThis index was built with "${sourceMeta.model}" (${family}` +
+                `${sourceMeta.dimensions ? `, ${sourceMeta.dimensions} dims` : ""}).`);
+            renderer.line("Set that model in your machine config (`lmgrep config`) to search these vectors.");
+        }
+    }
+    /** The pieces every share operation needs, resolved from the cwd. */
+    resolve() {
+        const state = new StateDirectory();
+        const config = new ConfigLoader().load(this.context.cwd);
+        const locator = new ProjectLocator(new GitClient(), state, ModelIdentity.of(config.model), config.dimensions);
+        const store = new ProjectMetadataStore();
+        const database = locator.resolveDatabase(this.context.cwd);
+        return {
+            locator,
+            branch: database.branch,
+            location: database.path,
+            metadata: store.read(database.path),
+            store,
+        };
+    }
+}
+//# sourceMappingURL=ShareCommands.js.map

package/dist/presentation/cli/commands/ShareCommands.js.map

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

package/dist/presentation/cli/commands/StatusCommand.d.ts

@@ -0,0 +1,15 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../CommandContext.js";
+/**
+ * `lmgrep status` — is search working, and if not, what to do.
+ *
+ * It leads with that one answer. The statistics behind it used to *be* the
+ * output, which left every reader to work out the verdict themselves from
+ * fifteen lines of counts and latencies.
+ */
+export declare class StatusCommand {
+    private readonly context;
+    constructor(context: CommandContext);
+    register(program: Command): void;
+    private run;
+}

package/dist/presentation/cli/commands/StatusCommand.js

@@ -0,0 +1,53 @@
+import { WorkingTreeDiff } from "../../../application/operations/WorkingTreeDiff.js";
+import { StateDirectory } from "../../../infrastructure/fs/StateDirectory.js";
+import { Workspace } from "../../../infrastructure/fs/Workspace.js";
+import { ProcessRegistry } from "../../../infrastructure/process/ProcessRegistry.js";
+import { CliOptions } from "../CliOptions.js";
+/**
+ * `lmgrep status` — is search working, and if not, what to do.
+ *
+ * It leads with that one answer. The statistics behind it used to *be* the
+ * output, which left every reader to work out the verdict themselves from
+ * fifteen lines of counts and latencies.
+ */
+export class StatusCommand {
+    context;
+    constructor(context) {
+        this.context = context;
+    }
+    register(program) {
+        CliOptions.target(program
+            .command("status")
+            .description("Report whether search works, and why not")
+            .option("-v, --verbose", "Also show index statistics and probes")
+            .option("-c, --changes", "Scan for files changed since the last index")
+            .option("--json", "Print status as JSON")).action((options) => this.run(options));
+    }
+    async run(options) {
+        const processes = new ProcessRegistry(new StateDirectory()).discoverRunning();
+        await this.context.withLmgrep(options, async (lmgrep) => {
+            const info = await lmgrep.status();
+            const { renderer } = this.context;
+            const changes = options.changes
+                ? new WorkingTreeDiff(new Workspace()).compute(info.projectRoot, await lmgrep.currentManifest())
+                : undefined;
+            if (options.json) {
+                renderer.json({ ...info, processes, ...(changes ? { changes } : {}) });
+                return;
+            }
+            renderer.statusVerdict(info);
+            renderer.statusHeader(info);
+            renderer.statusConfig(info);
+            if (options.verbose) {
+                renderer.statusStats(info);
+                renderer.statusChecks(info);
+                renderer.runningProcesses(processes);
+            }
+            if (changes) {
+                renderer.line("\nScanning for changes...");
+                renderer.changes(changes);
+            }
+        });
+    }
+}
+//# sourceMappingURL=StatusCommand.js.map

package/dist/presentation/cli/commands/StatusCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusCommand.js","sourceRoot":"","sources":["../../../../src/presentation/cli/commands/StatusCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,oDAAoD,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,oDAAoD,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAS9C;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACI;IAA7B,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,QAAQ,CAAC,OAAgB;QACxB,UAAU,CAAC,MAAM,CAChB,OAAO;aACL,OAAO,CAAC,QAAQ,CAAC;aACjB,WAAW,CAAC,0CAA0C,CAAC;aACvD,MAAM,CAAC,eAAe,EAAE,uCAAuC,CAAC;aAChE,MAAM,CAAC,eAAe,EAAE,6CAA6C,CAAC;aACtE,MAAM,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAC1C,CAAC,MAAM,CAAC,CAAC,OAAsB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAEO,KAAK,CAAC,GAAG,CAAC,OAAsB;QACvC,MAAM,SAAS,GAAG,IAAI,eAAe,CACpC,IAAI,cAAc,EAAE,CACpB,CAAC,eAAe,EAAE,CAAC;QAEpB,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACvD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;YAElC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO;gBAC9B,CAAC,CAAC,IAAI,eAAe,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,OAAO,CAC5C,IAAI,CAAC,WAAW,EAChB,MAAM,MAAM,CAAC,eAAe,EAAE,CAC9B;gBACF,CAAC,CAAC,SAAS,CAAC;YAEb,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBAClB,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBACvE,OAAO;YACR,CAAC;YAED,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YAC7B,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAC5B,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAE5B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACrB,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC3B,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;gBAC5B,QAAQ,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;YACtC,CAAC;YAED,IAAI,OAAO,EAAE,CAAC;gBACb,QAAQ,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;gBAC3C,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}

package/dist/presentation/mcp/HitFormatter.d.ts

@@ -0,0 +1,17 @@
+import type { ResearchResult } from "../../application/research/ResearchAgent.js";
+import type { Hit } from "../../domain/retrieval/Hit.js";
+/**
+ * Renders results as the plain text an MCP client receives.
+ *
+ * Format is chosen for an agent reader, not a human one: location and context
+ * come first so a hit can be acted on without a follow-up file read, which is
+ * the whole point of returning the source inline.
+ */
+export declare class HitFormatter {
+    static hits(hits: readonly Hit[]): string;
+    static answer(result: ResearchResult): string;
+    static projects(projects: ReadonlyArray<{
+        root: string;
+        remote?: string;
+    }>): string;
+}

package/dist/presentation/mcp/HitFormatter.js

@@ -0,0 +1,42 @@
+/**
+ * Renders results as the plain text an MCP client receives.
+ *
+ * Format is chosen for an agent reader, not a human one: location and context
+ * come first so a hit can be acted on without a follow-up file read, which is
+ * the whole point of returning the source inline.
+ */
+export class HitFormatter {
+    static hits(hits) {
+        return hits
+            .map((hit) => {
+            const header = `${hit.location} [${hit.type}] ${hit.name} ` +
+                `(score: ${hit.score.toFixed(3)})`;
+            const parts = [header];
+            if (hit.context)
+                parts.push(hit.context);
+            parts.push(hit.content);
+            return parts.join("\n");
+        })
+            .join("\n\n---\n\n");
+    }
+    static answer(result) {
+        const parts = [result.answer];
+        if (result.sources.length > 0) {
+            parts.push(`\nSources:\n${result.sources
+                .map((s) => `[${s.n}] ${s.path}:${s.startLine}-${s.endLine}`)
+                .join("\n")}`);
+        }
+        const queries = result.trace.flatMap((t) => t.kind === "search" ? [`"${t.query}"`] : []);
+        const meta = `${result.steps} steps, ${(result.elapsedMs / 1000).toFixed(0)}s` +
+            `${result.degraded ? ", degraded" : ""}`;
+        parts.push(queries.length > 0
+            ? `\n(searched ${queries.join(", ")} · ${meta})`
+            : `\n(${meta})`);
+        return parts.join("\n");
+    }
+    static projects(projects) {
+        const lines = projects.map((p) => [p.root, ...(p.remote ? [`(${p.remote})`] : [])].join(" "));
+        return `Indexed projects:\n${lines.map((l) => `- ${l}`).join("\n")}`;
+    }
+}
+//# sourceMappingURL=HitFormatter.js.map

package/dist/presentation/mcp/HitFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HitFormatter.js","sourceRoot":"","sources":["../../../src/presentation/mcp/HitFormatter.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACxB,MAAM,CAAC,IAAI,CAAC,IAAoB;QAC/B,OAAO,IAAI;aACT,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACZ,MAAM,MAAM,GACX,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,GAAG;gBAC5C,WAAW,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;YACpC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC;YACvB,IAAI,GAAG,CAAC,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC,CAAC;aACD,IAAI,CAAC,aAAa,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,MAAsB;QACnC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE9B,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CACT,eAAe,MAAM,CAAC,OAAO;iBAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;iBAC5D,IAAI,CAAC,IAAI,CAAC,EAAE,CACd,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAC1C,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAC3C,CAAC;QACF,MAAM,IAAI,GACT,GAAG,MAAM,CAAC,KAAK,WAAW,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;YACjE,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CACT,OAAO,CAAC,MAAM,GAAG,CAAC;YACjB,CAAC,CAAC,eAAe,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,GAAG;YAChD,CAAC,CAAC,MAAM,IAAI,GAAG,CAChB,CAAC;QAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,QAAQ,CACd,QAA0D;QAE1D,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAChC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAC1D,CAAC;QACF,OAAO,sBAAsB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACtE,CAAC;CACD"}

package/dist/presentation/mcp/IndexWatchController.d.ts

@@ -0,0 +1,17 @@
+import type { Lmgrep } from "../../application/Lmgrep.js";
+/**
+ * Owns the file watcher's lifecycle for a long-running server.
+ *
+ * Starting is idempotent and conditional: only one process can hold a
+ * database's maintainer lock, so a second server on the same project simply
+ * never starts watching rather than failing.
+ */
+export declare class IndexWatchController {
+    private readonly lmgrep;
+    private readonly isIndexed;
+    private stop;
+    private disposed;
+    constructor(lmgrep: Lmgrep, isIndexed: () => boolean);
+    ensureStarted(): void;
+    release(): void;
+}

package/dist/presentation/mcp/IndexWatchController.js

@@ -0,0 +1,31 @@
+/**
+ * Owns the file watcher's lifecycle for a long-running server.
+ *
+ * Starting is idempotent and conditional: only one process can hold a
+ * database's maintainer lock, so a second server on the same project simply
+ * never starts watching rather than failing.
+ */
+export class IndexWatchController {
+    lmgrep;
+    isIndexed;
+    stop;
+    disposed = false;
+    constructor(lmgrep, isIndexed) {
+        this.lmgrep = lmgrep;
+        this.isIndexed = isIndexed;
+    }
+    ensureStarted() {
+        if (this.stop || this.disposed)
+            return;
+        // Nothing to watch until the project has an index.
+        if (!this.isIndexed())
+            return;
+        this.stop = this.lmgrep.watch();
+    }
+    release() {
+        this.disposed = true;
+        this.stop?.();
+        this.stop = undefined;
+    }
+}
+//# sourceMappingURL=IndexWatchController.js.map

package/dist/presentation/mcp/IndexWatchController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexWatchController.js","sourceRoot":"","sources":["../../../src/presentation/mcp/IndexWatchController.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IAKd;IACA;IALV,IAAI,CAA2B;IAC/B,QAAQ,GAAG,KAAK,CAAC;IAEzB,YACkB,MAAc,EACd,SAAwB;QADxB,WAAM,GAAN,MAAM,CAAQ;QACd,cAAS,GAAT,SAAS,CAAe;IACvC,CAAC;IAEJ,aAAa;QACZ,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QACvC,mDAAmD;QACnD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;IAED,OAAO;QACN,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACvB,CAAC;CACD"}

package/dist/presentation/mcp/LmgrepCore.d.ts

@@ -0,0 +1,66 @@
+import { type HealthState } from "../../application/operations/HealthMonitor.js";
+import { ToolDescriptions } from "./ToolDescriptions.js";
+export type { HealthState } from "../../application/operations/HealthMonitor.js";
+export interface SearchArgs {
+    query: string;
+    limit?: number;
+    filePrefix?: string;
+    type?: string[];
+    language?: string[];
+    project?: string;
+}
+export interface ToolResult {
+    text: string;
+    isError?: boolean;
+}
+/** An indexed project other than the current one. */
+export interface OtherProject {
+    root: string;
+    remote?: string;
+}
+/**
+ * The tool surface shared by the MCP server and the Pi extension.
+ *
+ * It owns the health story: an agent must be told, in the tool description
+ * itself, when search cannot work and what to do instead — a tool that silently
+ * returns nothing teaches the agent to stop using it.
+ */
+export declare class LmgrepCore {
+    private readonly lmgrep;
+    private readonly health;
+    private readonly watching;
+    private readonly registry;
+    readonly askAvailable: boolean;
+    private constructor();
+    static open(options: {
+        cwd: string;
+        database?: string;
+    }): Promise<LmgrepCore>;
+    get cwd(): string;
+    get searchParams(): typeof ToolDescriptions.SEARCH_PARAMS;
+    get listProjectsDescription(): string;
+    get askParam(): {
+        description: string;
+    };
+    get askDescription(): string;
+    currentHealth(): HealthState;
+    onHealthChange(listener: (state: HealthState) => void): () => void;
+    start(): void;
+    buildSearchDescription(): string;
+    executeSearch(args: SearchArgs): Promise<ToolResult>;
+    executeAsk(args: {
+        question: string;
+    }): Promise<ToolResult>;
+    executeListProjects(): Promise<ToolResult>;
+    dispose(): Promise<void>;
+    /** Shared failure handling: report, and arm recovery polling. */
+    private guarded;
+    /**
+     * Projects an agent can actually reach with the `project` parameter.
+     *
+     * Standalone indexes are excluded: they are addressed by name, and their
+     * recorded root is merely where they were built from, so offering one as a
+     * project path would resolve to a different database.
+     */
+    private otherProjects;
+}