lmgrep 0.1.17 → 0.2.0

package/dist/infrastructure/treesitter/TreeSitterChunker.js

@@ -0,0 +1,163 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { Language, Parser } from "web-tree-sitter";
+import { Chunk } from "../../domain/corpus/Chunk.js";
+import { CodeLocation } from "../../domain/corpus/CodeLocation.js";
+import { ContentHash } from "../../domain/corpus/ContentHash.js";
+import { ChunkContextBuilder } from "./ChunkContextBuilder.js";
+import { LanguageCatalog } from "./LanguageCatalog.js";
+import { SlidingWindowChunker } from "./SlidingWindowChunker.js";
+/**
+ * Splits source into chunks along AST boundaries.
+ *
+ * Node-bounded chunks are what make results readable: a hit is a whole
+ * function or class, not an arbitrary window through the middle of one. Files
+ * with no grammar, or no chunkable structure, fall back to a sliding window.
+ */
+export class TreeSitterChunker {
+    catalog;
+    context;
+    fallback;
+    /** Chunks larger than this are split by recursing into their children. */
+    static MAX_CHUNK_TOKENS = 8192;
+    /** A one-line fragment shorter than this is noise, not a unit of code. */
+    static MIN_CHUNK_CHARS = 50;
+    parser;
+    loaded = new Map();
+    constructor(catalog = new LanguageCatalog(), context = new ChunkContextBuilder(), fallback = new SlidingWindowChunker()) {
+        this.catalog = catalog;
+        this.context = context;
+        this.fallback = fallback;
+    }
+    async chunk(filePath, cwd) {
+        const language = this.catalog.forFile(filePath);
+        if (!language)
+            return this.fallback.chunk(filePath, cwd);
+        // Parser.init() must run before any Language.load(): it bootstraps the
+        // wasm runtime that grammar loading calls into. Reversing these two
+        // lines fails with "cannot read loadWebAssemblyModule of undefined".
+        const parser = await this.getParser();
+        const grammar = await this.loadGrammar(language);
+        if (!grammar)
+            return this.fallback.chunk(filePath, cwd);
+        parser.setLanguage(grammar);
+        const source = readFileSync(join(cwd, filePath), "utf-8");
+        const tree = parser.parse(source);
+        if (!tree)
+            return this.fallback.chunk(filePath, cwd);
+        const chunks = language.id === "markdown"
+            ? this.chunkMarkdown(tree.rootNode, filePath, source)
+            : this.collect(tree.rootNode, language, filePath, source, []);
+        return chunks.length > 0 ? chunks : this.fallback.chunk(filePath, cwd);
+    }
+    /**
+     * Markdown needs its own pass: the block grammar nests `section` nodes by
+     * heading level, so emitting them whole would collapse a document into one
+     * chunk. Splitting at every heading the grammar reports (so a `#` inside a
+     * fenced code block is not mistaken for one) gives complete,
+     * non-overlapping, heading-granular chunks instead.
+     */
+    chunkMarkdown(root, filePath, source) {
+        const lines = source.split("\n");
+        const headingRows = [];
+        const visit = (node) => {
+            if (node.type === "atx_heading" || node.type === "setext_heading") {
+                headingRows.push(node.startPosition.row);
+            }
+            for (const child of node.children)
+                visit(child);
+        };
+        visit(root);
+        const starts = [...new Set([0, ...headingRows])].sort((a, b) => a - b);
+        const chunks = [];
+        for (let i = 0; i < starts.length; i++) {
+            const start = starts[i];
+            const end = i + 1 < starts.length ? starts[i + 1] : lines.length;
+            const content = lines.slice(start, end).join("\n");
+            if (content.trim().length === 0)
+                continue;
+            const heading = (lines[start] ?? "").replace(/^\s*#+\s*/, "").trim();
+            chunks.push(new Chunk({
+                location: new CodeLocation(filePath, start + 1, end),
+                type: "section",
+                name: heading.slice(0, 80) || `lines_${start + 1}_${end}`,
+                content,
+                context: this.context.buildFileOnly(filePath),
+                hash: ContentHash.of(content),
+            }));
+        }
+        return chunks;
+    }
+    collect(node, language, filePath, source, chunks) {
+        if (!language.chunkTypes.includes(node.type)) {
+            for (const child of node.children) {
+                this.collect(child, language, filePath, source, chunks);
+            }
+            return chunks;
+        }
+        const content = node.text;
+        // Too large to embed whole: descend instead, so a big class becomes its
+        // methods rather than being truncated or skipped.
+        const estimatedTokens = Math.ceil(content.length / 4);
+        if (estimatedTokens > TreeSitterChunker.MAX_CHUNK_TOKENS &&
+            this.hasChunkableDescendants(node, language)) {
+            for (const child of node.children) {
+                this.collect(child, language, filePath, source, chunks);
+            }
+            return chunks;
+        }
+        // A short one-liner carries no retrievable meaning on its own.
+        if (content.split("\n").length < 2 &&
+            content.length < TreeSitterChunker.MIN_CHUNK_CHARS) {
+            return chunks;
+        }
+        chunks.push(new Chunk({
+            location: new CodeLocation(filePath, node.startPosition.row + 1, node.endPosition.row + 1),
+            type: node.type,
+            name: this.nodeName(node) ?? `anonymous_${node.startPosition.row}`,
+            content,
+            context: this.context.build(node, filePath, source, language),
+            hash: ContentHash.of(content),
+        }));
+        return chunks;
+    }
+    hasChunkableDescendants(node, language) {
+        for (const child of node.children) {
+            if (language.chunkTypes.includes(child.type))
+                return true;
+            if (this.hasChunkableDescendants(child, language))
+                return true;
+        }
+        return false;
+    }
+    nodeName(node) {
+        return (node.childForFieldName("name") ??
+            node.children.find((c) => c.type === "identifier" ||
+                c.type === "type_identifier" ||
+                // nix binds its target via an attrpath (e.g. `outputs = ...`)
+                c.type === "attrpath"))?.text;
+    }
+    async getParser() {
+        if (!this.parser) {
+            await Parser.init();
+            this.parser = new Parser();
+        }
+        return this.parser;
+    }
+    /**
+     * Grammars are cached for the process lifetime. They are wasm modules whose
+     * linear memory only ever grows, so loading one repeatedly would leak.
+     */
+    async loadGrammar(language) {
+        const cached = this.loaded.get(language.id);
+        if (cached)
+            return cached;
+        const wasmPath = this.catalog.wasmPathFor(language);
+        if (!wasmPath)
+            return undefined;
+        const grammar = await Language.load(wasmPath);
+        this.loaded.set(language.id, grammar);
+        return grammar;
+    }
+}
+//# sourceMappingURL=TreeSitterChunker.js.map

package/dist/infrastructure/treesitter/TreeSitterChunker.js.map

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

package/dist/mcp.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export {};
+import "./infrastructure/lancedb/NativeTuning.js";

package/dist/mcp.js

@@ -1,67 +1,21 @@
 #!/usr/bin/env node
 process.title = "lmgrep-mcp";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
-import { createLmgrepCore } from "./lib/search-tool.js";
-const core = await createLmgrepCore({ cwd: process.cwd() });
-const server = new McpServer({
-    name: "lmgrep",
-    version: "0.1.0",
-});
-const searchTool = server.tool("search", core.buildSearchDescription(), {
-    query: z.string().describe(core.searchParams.query.description),
-    limit: z
-        .number()
-        .optional()
-        .default(core.searchParams.limit.default)
-        .describe(core.searchParams.limit.description),
-    filePrefix: z
-        .string()
-        .optional()
-        .describe(core.searchParams.filePrefix.description),
-    type: z
-        .array(z.string())
-        .optional()
-        .describe(core.searchParams.type.description),
-    language: z
-        .array(z.string())
-        .optional()
-        .describe(core.searchParams.language.description),
-    project: z
-        .string()
-        .optional()
-        .describe(core.searchParams.project.description),
-}, async (args) => {
-    const result = await core.executeSearch(args);
-    return {
-        content: [{ type: "text", text: result.text }],
-        ...(result.isError ? { isError: true } : {}),
-    };
-});
-server.tool("list_other_indexed_projects", core.listProjectsDescription, {}, async () => {
-    const result = await core.executeListProjects();
-    return { content: [{ type: "text", text: result.text }] };
-});
-core.onHealthChange(() => {
-    searchTool.update({ description: core.buildSearchDescription() });
-});
-core.startHealthLoop();
+// Must come first — sets TOKIO/RAYON/UV thread caps before the LanceDB native
+// binding initializes its runtime.
+import "./infrastructure/lancedb/NativeTuning.js";
+import { LmgrepCore } from "./presentation/mcp/LmgrepCore.js";
+import { LmgrepMcpServer } from "./presentation/mcp/McpServer.js";
+const core = await LmgrepCore.open({
+    cwd: process.cwd(),
+    database: process.env.LMGREP_DATABASE || undefined,
+});
+const shutdown = () => {
+    core.dispose().finally(() => process.exit(0));
+};
 process.on("exit", () => {
     core.dispose().catch(() => { });
 });
-process.on("SIGINT", () => {
-    core.dispose().finally(() => process.exit(0));
-});
-process.on("SIGTERM", () => {
-    core.dispose().finally(() => process.exit(0));
-});
-async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-}
-main().catch((err) => {
-    console.error("lmgrep MCP server error:", err);
-    process.exit(1);
-});
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);
+await new LmgrepMcpServer(core).serve();
 //# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":";AACA,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC;AAE7B,8EAA8E;AAC9E,mCAAmC;AACnC,OAAO,0CAA0C,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC;IAClC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAClB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,SAAS;CAClD,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,GAAS,EAAE;IAC3B,IAAI,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC,CAAC;AACF,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;IACvB,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AAChC,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAEhC,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC"}

package/dist/presentation/cli/Cli.d.ts

@@ -0,0 +1,31 @@
+import { CommandContext } from "./CommandContext.js";
+/**
+ * Assembles and runs the command-line interface.
+ *
+ * Two things here are deliberate. A bare `lmgrep <words>` searches, because
+ * searching is what lmgrep is for and it should not cost a subcommand. And the
+ * help is grouped, because a flat list of a dozen commands says nothing about
+ * which two anyone actually needs — the first group is the whole product, and
+ * the rest is setup you do once.
+ */
+export declare class Cli {
+    private readonly context;
+    /** Help grouping, by command name. Order here is order in `--help`. */
+    private static readonly GROUPS;
+    private readonly program;
+    constructor(context?: CommandContext);
+    run(argv?: string[]): Promise<void>;
+    /**
+     * Treat a leading word that is not a command as the start of a query.
+     *
+     * The ambiguity is real but small: `lmgrep status` is the command, not a
+     * search for the word "status". Anything of more than one word, and
+     * anything that is not a command name, searches — which covers every query
+     * a person would actually type.
+     */
+    private withImplicitSearch;
+    private commandNames;
+    private group;
+    private static looksLikeStdioLaunch;
+    private commands;
+}

package/dist/presentation/cli/Cli.js

@@ -0,0 +1,120 @@
+import { Command } from "commander";
+import { CommandContext } from "./CommandContext.js";
+import { AskCommand } from "./commands/AskCommand.js";
+import { CompletionsCommand } from "./commands/CompletionsCommand.js";
+import { ConfigCommands } from "./commands/ConfigCommands.js";
+import { IndexCommand } from "./commands/IndexCommand.js";
+import { ProjectsCommand } from "./commands/ProjectsCommand.js";
+import { SearchCommand } from "./commands/SearchCommand.js";
+import { ServerCommands } from "./commands/ServerCommands.js";
+import { ShareCommands } from "./commands/ShareCommands.js";
+import { StatusCommand } from "./commands/StatusCommand.js";
+/**
+ * Assembles and runs the command-line interface.
+ *
+ * Two things here are deliberate. A bare `lmgrep <words>` searches, because
+ * searching is what lmgrep is for and it should not cost a subcommand. And the
+ * help is grouped, because a flat list of a dozen commands says nothing about
+ * which two anyone actually needs — the first group is the whole product, and
+ * the rest is setup you do once.
+ */
+export class Cli {
+    context;
+    /** Help grouping, by command name. Order here is order in `--help`. */
+    static GROUPS = [
+        ["Searching:", ["search", "ask"]],
+        ["Your projects:", ["index", "status", "projects"]],
+        ["Setup:", ["init", "config", "mcp", "completions"]],
+        ["Other:", ["serve", "share", "import"]],
+    ];
+    program = new Command();
+    constructor(context = new CommandContext()) {
+        this.context = context;
+        this.program
+            .name("lmgrep")
+            .description("Semantic code search, powered by a local embedding model")
+            .version("0.1.0")
+            .showHelpAfterError()
+            .addHelpText("after", "\nA bare query searches:  lmgrep how are webhooks authenticated" +
+            "\nFirst time here:        lmgrep init  →  lmgrep index");
+        for (const command of this.commands())
+            command.register(this.program);
+        this.group();
+    }
+    async run(argv = process.argv) {
+        // With no arguments and both streams piped, this was launched as an
+        // MCP server over stdio rather than by a human at a terminal.
+        if (Cli.looksLikeStdioLaunch(argv)) {
+            await import("../../mcp.js");
+            return;
+        }
+        try {
+            await this.program.parseAsync(this.withImplicitSearch(argv));
+        }
+        catch (err) {
+            // Every failure reaching here is a user-facing condition — no
+            // index, an unreachable provider, incompatible embeddings — not a
+            // defect. Report the message and set an exit code; a stack trace
+            // would only bury it. Guarding once here means no command can
+            // forget to.
+            this.context.fail(err);
+        }
+    }
+    /**
+     * Treat a leading word that is not a command as the start of a query.
+     *
+     * The ambiguity is real but small: `lmgrep status` is the command, not a
+     * search for the word "status". Anything of more than one word, and
+     * anything that is not a command name, searches — which covers every query
+     * a person would actually type.
+     */
+    withImplicitSearch(argv) {
+        const rest = argv.slice(2);
+        const first = rest[0];
+        if (!first || first.startsWith("-"))
+            return argv;
+        if (this.commandNames().has(first))
+            return argv;
+        return [...argv.slice(0, 2), "search", ...rest];
+    }
+    commandNames() {
+        const names = new Set(["help"]);
+        for (const command of this.program.commands) {
+            names.add(command.name());
+            for (const alias of command.aliases())
+                names.add(alias);
+        }
+        return names;
+    }
+    group() {
+        const groupOf = new Map();
+        for (const [group, names] of Cli.GROUPS) {
+            for (const name of names)
+                groupOf.set(name, group);
+        }
+        for (const command of this.program.commands) {
+            const group = groupOf.get(command.name());
+            if (group)
+                command.helpGroup(group);
+        }
+    }
+    static looksLikeStdioLaunch(argv) {
+        return (argv.slice(2).length === 0 &&
+            !process.stdin.isTTY &&
+            !process.stdout.isTTY);
+    }
+    commands() {
+        return [
+            new SearchCommand(this.context),
+            new AskCommand(this.context),
+            new IndexCommand(this.context),
+            new StatusCommand(this.context),
+            new ProjectsCommand(this.context),
+            new ConfigCommands(this.context),
+            new ServerCommands(this.context),
+            new ShareCommands(this.context),
+            new CompletionsCommand(this.context),
+        ];
+    }
+}
+//# sourceMappingURL=Cli.js.map

package/dist/presentation/cli/Cli.js.map

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

package/dist/presentation/cli/CliOptions.d.ts

@@ -0,0 +1,18 @@
+import type { Command } from "commander";
+/** The one option every command shares, and its help text. */
+export declare class CliOptions {
+    /**
+     * `--in` replaced three overlapping options — `--project`, `--across` and
+     * `--database` — which were three spellings of "somewhere other than here".
+     *
+     * A value with a separator is a project directory, because that is what
+     * people have to hand; a bare name is a standalone index kept in the state
+     * directory, for corpora that are not repositories.
+     */
+    static readonly TARGET: string;
+    static target(command: Command): Command;
+    /** Commander calls this once per occurrence of a repeatable option. */
+    private static collect;
+    /** The single target a write command operates on, if any. */
+    static single(targets: string[] | undefined): string | undefined;
+}

package/dist/presentation/cli/CliOptions.js

@@ -0,0 +1,25 @@
+/** The one option every command shares, and its help text. */
+export class CliOptions {
+    /**
+     * `--in` replaced three overlapping options — `--project`, `--across` and
+     * `--database` — which were three spellings of "somewhere other than here".
+     *
+     * A value with a separator is a project directory, because that is what
+     * people have to hand; a bare name is a standalone index kept in the state
+     * directory, for corpora that are not repositories.
+     */
+    static TARGET = "Project directory, or the name of a standalone index. " +
+        "Repeat to search several at once; use `.` to include the current project.";
+    static target(command) {
+        return command.option("--in <project-or-name>", CliOptions.TARGET, CliOptions.collect, []);
+    }
+    /** Commander calls this once per occurrence of a repeatable option. */
+    static collect(value, previous) {
+        return [...previous, value];
+    }
+    /** The single target a write command operates on, if any. */
+    static single(targets) {
+        return targets && targets.length > 0 ? targets[0] : undefined;
+    }
+}
+//# sourceMappingURL=CliOptions.js.map

package/dist/presentation/cli/CliOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CliOptions.js","sourceRoot":"","sources":["../../../src/presentation/cli/CliOptions.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,MAAM,OAAO,UAAU;IACtB;;;;;;;OAOG;IACH,MAAM,CAAU,MAAM,GACrB,wDAAwD;QACxD,2EAA2E,CAAC;IAE7E,MAAM,CAAC,MAAM,CAAC,OAAgB;QAC7B,OAAO,OAAO,CAAC,MAAM,CACpB,wBAAwB,EACxB,UAAU,CAAC,MAAM,EACjB,UAAU,CAAC,OAAO,EAClB,EAAc,CACd,CAAC;IACH,CAAC;IAED,uEAAuE;IAC/D,MAAM,CAAC,OAAO,CAAC,KAAa,EAAE,QAAkB;QACvD,OAAO,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,6DAA6D;IAC7D,MAAM,CAAC,MAAM,CAAC,OAA6B;QAC1C,OAAO,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC"}

package/dist/presentation/cli/CommandContext.d.ts

@@ -0,0 +1,50 @@
+import type { Lmgrep } from "../../application/Lmgrep.js";
+import { LmgrepFactory } from "../../application/LmgrepFactory.js";
+import { Renderer } from "./Renderer.js";
+/** Options every command accepts. */
+export interface GlobalOptions {
+    /** Repeatable `--in` targets. Write commands use only the first. */
+    in?: string[];
+}
+/**
+ * Shared plumbing for CLI commands: opening an Lmgrep, closing it again, and
+ * turning a thrown error into an exit code.
+ *
+ * Commands run through {@link withLmgrep} rather than opening their own, so no
+ * command can forget to close the database — a leaked LanceDB connection keeps
+ * a native runtime and its buffers alive for the life of the process.
+ */
+export declare class CommandContext {
+    readonly renderer: Renderer;
+    private readonly factory;
+    constructor(renderer?: Renderer, factory?: LmgrepFactory);
+    get cwd(): string;
+    open(options: GlobalOptions): Promise<Lmgrep>;
+    /**
+     * Split `--in` values into the three things they can mean.
+     *
+     * The first path-like value replaces the working directory — "act as if I
+     * were there" — which is what makes `status --in ../other` and
+     * `search --in ../other` mean the obvious thing without a second flag. Any
+     * further paths are additional projects to search. A bare name selects a
+     * standalone index instead.
+     */
+    static targets(options: GlobalOptions): {
+        cwd: string;
+        name?: string;
+        across: string[];
+    };
+    /** Open, run, and always close — even when `run` throws. */
+    withLmgrep<T>(options: GlobalOptions, run: (lmgrep: Lmgrep) => Promise<T>): Promise<T | undefined>;
+    /**
+     * Report a failure the way a CLI should: message on stderr, non-zero exit,
+     * no stack trace. Errors reaching here are user-facing conditions (no
+     * index, bad path, unreachable provider), not defects. Called once from
+     * {@link Cli.run} so no command can forget to.
+     */
+    fail(error: unknown): void;
+    static isPathLike(value: string): boolean;
+    static integer(value: string | undefined, fallback: number): number;
+    /** Parse a comma-separated option into trimmed values. */
+    static list(value?: string): string[] | undefined;
+}

package/dist/presentation/cli/CommandContext.js

@@ -0,0 +1,88 @@
+import { resolve } from "node:path";
+import { LmgrepFactory } from "../../application/LmgrepFactory.js";
+import { Renderer } from "./Renderer.js";
+/**
+ * Shared plumbing for CLI commands: opening an Lmgrep, closing it again, and
+ * turning a thrown error into an exit code.
+ *
+ * Commands run through {@link withLmgrep} rather than opening their own, so no
+ * command can forget to close the database — a leaked LanceDB connection keeps
+ * a native runtime and its buffers alive for the life of the process.
+ */
+export class CommandContext {
+    renderer;
+    factory;
+    constructor(renderer = new Renderer(), factory = new LmgrepFactory()) {
+        this.renderer = renderer;
+        this.factory = factory;
+    }
+    get cwd() {
+        return process.cwd();
+    }
+    async open(options) {
+        const targets = CommandContext.targets(options);
+        return this.factory.open({
+            cwd: targets.cwd,
+            database: targets.name,
+            onWarning: (message) => this.renderer.error(message),
+        });
+    }
+    /**
+     * Split `--in` values into the three things they can mean.
+     *
+     * The first path-like value replaces the working directory — "act as if I
+     * were there" — which is what makes `status --in ../other` and
+     * `search --in ../other` mean the obvious thing without a second flag. Any
+     * further paths are additional projects to search. A bare name selects a
+     * standalone index instead.
+     */
+    static targets(options) {
+        const values = options.in ?? [];
+        const paths = values.filter((v) => CommandContext.isPathLike(v));
+        const name = values.find((v) => !CommandContext.isPathLike(v));
+        return {
+            cwd: paths[0] ? resolve(process.cwd(), paths[0]) : process.cwd(),
+            name,
+            across: paths.slice(1),
+        };
+    }
+    /** Open, run, and always close — even when `run` throws. */
+    async withLmgrep(options, run) {
+        const lmgrep = await this.open(options);
+        try {
+            return await run(lmgrep);
+        }
+        finally {
+            await lmgrep.close();
+        }
+    }
+    /**
+     * Report a failure the way a CLI should: message on stderr, non-zero exit,
+     * no stack trace. Errors reaching here are user-facing conditions (no
+     * index, bad path, unreachable provider), not defects. Called once from
+     * {@link Cli.run} so no command can forget to.
+     */
+    fail(error) {
+        this.renderer.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    }
+    static isPathLike(value) {
+        return (value.includes("/") ||
+            value.includes("\\") ||
+            value === "." ||
+            value === "..");
+    }
+    static integer(value, fallback) {
+        if (value === undefined)
+            return fallback;
+        const n = Number.parseInt(value, 10);
+        return Number.isNaN(n) ? fallback : n;
+    }
+    /** Parse a comma-separated option into trimmed values. */
+    static list(value) {
+        if (!value)
+            return undefined;
+        return value.split(",").map((s) => s.trim());
+    }
+}
+//# sourceMappingURL=CommandContext.js.map

package/dist/presentation/cli/CommandContext.js.map

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