lmgrep 0.1.18 → 0.2.1

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

@@ -0,0 +1,90 @@
+import type { TidyReport } from "../../application/Lmgrep.js";
+import type { Inventory } from "../../application/operations/IndexInventory.js";
+import type { StatusInfo } from "../../application/operations/StatusService.js";
+import type { ProjectIndex } from "../../domain/ports/ProjectIndexesPort.js";
+import type { TraceEntry } from "../../domain/research/ResearchTrace.js";
+import type { Hit } from "../../domain/retrieval/Hit.js";
+import type { RunningProcess } from "../../infrastructure/process/ProcessRegistry.js";
+/**
+ * All terminal output for the CLI.
+ *
+ * Separated from the commands so that what a command *does* and how it *reads*
+ * are independently changeable — the commands became testable the moment they
+ * stopped calling console.log directly.
+ */
+export declare class Renderer {
+    private readonly out;
+    private static readonly RULE_WIDTH;
+    constructor(out?: (line: string) => void);
+    line(text?: string): void;
+    rule(): void;
+    json(value: unknown): void;
+    /**
+     * Full result view: a ruled header, the context block, then the source.
+     *
+     * The score is always shown. It used to be behind `--scores`, which meant
+     * the one number that says how much to trust a result was hidden by
+     * default and cost a flag to see.
+     */
+    hits(hits: readonly Hit[]): void;
+    /** Just the distinct file paths, in first-hit order. */
+    hitPaths(hits: readonly Hit[]): void;
+    /** One research step, written to stderr so stdout stays pipeable. */
+    static formatTrace(entry: TraceEntry): string;
+    /**
+     * The verdict, first and alone.
+     *
+     * Everything below it is detail for when the answer is "no". This line is
+     * the whole reason to run the command.
+     */
+    statusVerdict(info: StatusInfo): void;
+    /** Configuration and paths — shown even when there is no index yet. */
+    statusHeader(info: StatusInfo): void;
+    /**
+     * Which file supplied which settings.
+     *
+     * Worth a section of its own because the alternative is guessing. With two
+     * files able to set the same key, an effective value printed on its own
+     * tells you what lmgrep decided but not where to go to change it — which
+     * is the actual question when the answer surprises you.
+     */
+    statusConfig(info: StatusInfo): void;
+    statusStats(info: StatusInfo): void;
+    /**
+     * How searches are answered.
+     *
+     * Worth its own line because the difference is invisible otherwise: without
+     * an index every query scans every embedding, costing roughly the index's
+     * size in memory and an order of magnitude in latency. Nothing else tells
+     * the user that is happening.
+     */
+    private vectorIndex;
+    statusChecks(info: StatusInfo): void;
+    /** Who else is holding this index, and whether they are watching it. */
+    runningProcesses(processes: readonly RunningProcess[]): void;
+    /** Working-tree drift, truncated so a large diff stays readable. */
+    changes(changes: {
+        added: string[];
+        modified: string[];
+        deleted: string[];
+    }): void;
+    private changeGroup;
+    /**
+     * Warn that this run builds a *second* index for the project.
+     *
+     * Silent unless another model's index already exists, which is the only
+     * case where a full re-embed is about to happen for a reason the user may
+     * not have intended.
+     */
+    newModelNotice(others: readonly ProjectIndex[]): void;
+    /** What a maintenance pass changed; silent when it changed nothing. */
+    maintenance(report: TidyReport): void;
+    /**
+     * Every index on this machine.
+     *
+     * Sorted by size and leading with the total, because the question this
+     * answers is almost always "what is using my disk, and can I delete it".
+     */
+    inventory(inventory: Inventory): void;
+    error(message: string): void;
+}

package/dist/presentation/cli/Renderer.js

@@ -0,0 +1,290 @@
+import { DiskUsage } from "../../infrastructure/fs/DiskUsage.js";
+/**
+ * All terminal output for the CLI.
+ *
+ * Separated from the commands so that what a command *does* and how it *reads*
+ * are independently changeable — the commands became testable the moment they
+ * stopped calling console.log directly.
+ */
+export class Renderer {
+    out;
+    static RULE_WIDTH = 60;
+    constructor(out = console.log) {
+        this.out = out;
+    }
+    line(text = "") {
+        this.out(text);
+    }
+    rule() {
+        this.out("─".repeat(Renderer.RULE_WIDTH));
+    }
+    json(value) {
+        this.out(JSON.stringify(value, null, 2));
+    }
+    /**
+     * Full result view: a ruled header, the context block, then the source.
+     *
+     * The score is always shown. It used to be behind `--scores`, which meant
+     * the one number that says how much to trust a result was hidden by
+     * default and cost a flag to see.
+     */
+    hits(hits) {
+        for (const hit of hits) {
+            const score = ` (${hit.score.toFixed(3)})`;
+            this.out(`\n${"─".repeat(Renderer.RULE_WIDTH)}`);
+            this.out(`${hit.location} [${hit.type}] ${hit.name}${score}`);
+            this.rule();
+            this.out(hit.context);
+            this.out("");
+            this.out(hit.content);
+        }
+    }
+    /** Just the distinct file paths, in first-hit order. */
+    hitPaths(hits) {
+        const seen = new Set();
+        for (const hit of hits) {
+            if (seen.has(hit.location.filePath))
+                continue;
+            seen.add(hit.location.filePath);
+            this.out(hit.location.filePath);
+        }
+    }
+    /** One research step, written to stderr so stdout stays pipeable. */
+    static formatTrace(entry) {
+        return entry.kind === "search"
+            ? `  search  "${entry.query}" → ${entry.hits} hits`
+            : `  · ${entry.message}`;
+    }
+    /**
+     * The verdict, first and alone.
+     *
+     * Everything below it is detail for when the answer is "no". This line is
+     * the whole reason to run the command.
+     */
+    statusVerdict(info) {
+        if (!info.verdict.searchable) {
+            this.out(`Not searchable — ${info.verdict.reason}`);
+            this.out(`  Fix: ${info.verdict.fix}`);
+            return;
+        }
+        this.out("Searchable.");
+        if (info.verdict.note)
+            this.out(`  Note: ${info.verdict.note}`);
+    }
+    /** Configuration and paths — shown even when there is no index yet. */
+    statusHeader(info) {
+        this.out(`\nProject: ${info.projectRoot}`);
+        if (info.prefix)
+            this.out(`Subdirectory: ${info.prefix}`);
+        this.out(`Index:   ${info.databasePath}`);
+        this.out(`Model:   ${info.config.model}`);
+        if (info.config.baseURL)
+            this.out(`Server:  ${info.config.baseURL}`);
+    }
+    /**
+     * Which file supplied which settings.
+     *
+     * Worth a section of its own because the alternative is guessing. With two
+     * files able to set the same key, an effective value printed on its own
+     * tells you what lmgrep decided but not where to go to change it — which
+     * is the actual question when the answer surprises you.
+     */
+    statusConfig(info) {
+        this.out("\nConfiguration:");
+        if (info.configSources.length === 0) {
+            this.out("  (none — defaults only)");
+            return;
+        }
+        for (const source of info.configSources) {
+            const marks = [
+                source.scope === "project" ? "project" : "machine",
+                source.deprecated ? "deprecated location" : undefined,
+            ].filter(Boolean);
+            this.out(`  ${source.path}  [${marks.join(", ")}]`);
+            this.out(`    ${source.keys.join(", ") || "(nothing applied)"}`);
+        }
+        if (info.configSources.length > 1) {
+            this.out("  Later files override earlier ones, key by key.");
+        }
+    }
+    statusStats(info) {
+        this.out("\nIndex stats:");
+        this.out(`  Files: ${info.fileCount}`);
+        this.out(`  Chunks: ${info.chunkCount}`);
+        this.out(`  Unique hashes: ${info.uniqueHashes}`);
+        if (info.indexModel)
+            this.out(`  Index model: ${info.indexModel}`);
+        if (info.indexDimensions) {
+            this.out(`  Dimensions: ${info.indexDimensions}`);
+        }
+        // A gap between rows and distinct hashes means duplicate chunks, which
+        // `lmgrep compact` removes.
+        if (info.chunkCount !== info.uniqueHashes) {
+            this.out(`  Duplicates: ${info.chunkCount - info.uniqueHashes}`);
+        }
+        this.vectorIndex(info.vectorIndex);
+    }
+    /**
+     * How searches are answered.
+     *
+     * Worth its own line because the difference is invisible otherwise: without
+     * an index every query scans every embedding, costing roughly the index's
+     * size in memory and an order of magnitude in latency. Nothing else tells
+     * the user that is happening.
+     */
+    vectorIndex(state) {
+        if (state.built) {
+            this.out(state.unindexed > 0
+                ? `  Vector index: yes (${state.unindexed} rows awaiting the next optimize)`
+                : "  Vector index: yes");
+            return;
+        }
+        if (!state.worthBuilding) {
+            this.out("  Vector index: not needed at this size");
+            return;
+        }
+        this.out("  Vector index: MISSING — every search scans all " +
+            `${state.rows} embeddings. Run \`lmgrep index\` to build it.`);
+    }
+    statusChecks(info) {
+        this.out("\nEmbedding check:");
+        if (info.embeddingOk) {
+            this.out(`  OK (${info.embeddingLatencyMs}ms)`);
+        }
+        else {
+            this.out("  FAILED");
+            for (const line of (info.embeddingError ?? "").split("\n")) {
+                if (info.embeddingError)
+                    this.out(`  ${line}`);
+            }
+        }
+        this.out("\nSearch check:");
+        if (info.searchOk) {
+            this.out(`  OK (${info.searchResultCount} result, ${info.searchLatencyMs}ms)`);
+        }
+        else if (info.embeddingOk && info.fileCount > 0) {
+            this.out("  FAILED (query returned no results)");
+        }
+        else {
+            this.out("  SKIPPED");
+        }
+    }
+    /** Who else is holding this index, and whether they are watching it. */
+    runningProcesses(processes) {
+        if (processes.length === 0) {
+            this.out("\nNo running lmgrep processes.");
+            return;
+        }
+        this.out("\nRunning processes:");
+        for (const proc of processes) {
+            const label = proc.kind === "mcp"
+                ? "MCP server"
+                : proc.kind === "serve"
+                    ? "serve"
+                    : "CLI";
+            this.out(`  ${label} (pid ${proc.pid})${proc.watching ? ", watching" : ""}`);
+            this.out(`    project: ${proc.projectRoot ?? "unknown"}`);
+            if (proc.databasePath)
+                this.out(`    index:   ${proc.databasePath}`);
+        }
+    }
+    /** Working-tree drift, truncated so a large diff stays readable. */
+    changes(changes) {
+        const total = changes.added.length + changes.modified.length + changes.deleted.length;
+        if (total === 0) {
+            this.out("  No changes detected.");
+            return;
+        }
+        this.changeGroup("Added", "+", changes.added);
+        this.changeGroup("Modified", "~", changes.modified);
+        this.changeGroup("Deleted", "-", changes.deleted);
+        this.out("\n  Run `lmgrep index` to update the index.");
+    }
+    changeGroup(label, marker, files) {
+        if (files.length === 0)
+            return;
+        const SHOWN = 10;
+        this.out(`  ${label}: ${files.length}`);
+        for (const f of files.slice(0, SHOWN))
+            this.out(`    ${marker} ${f}`);
+        if (files.length > SHOWN) {
+            this.out(`    ... and ${files.length - SHOWN} more`);
+        }
+    }
+    /**
+     * Warn that this run builds a *second* index for the project.
+     *
+     * Silent unless another model's index already exists, which is the only
+     * case where a full re-embed is about to happen for a reason the user may
+     * not have intended.
+     */
+    newModelNotice(others) {
+        if (others.length === 0)
+            return;
+        this.out("This project is already indexed with " +
+            others
+                .map((o) => `${o.model ?? "an unrecorded model"} (${DiskUsage.format(o.bytes)})`)
+                .join(", "));
+        this.out("Embedding it again under the newly configured model. The existing index is kept —");
+        this.out("setting `model` back returns to it instantly. `lmgrep projects` lists both.\n");
+    }
+    /** What a maintenance pass changed; silent when it changed nothing. */
+    maintenance(report) {
+        const { duplicateIds, staleVersions, before, after } = report.deduped;
+        if (duplicateIds + staleVersions > 0) {
+            this.out(`Removed ${duplicateIds} duplicate and ${staleVersions} superseded chunks (${before} → ${after}).`);
+        }
+        for (const table of report.optimized.tables) {
+            if (table.action === "created") {
+                this.out(`Built vector index on ${table.table} (${table.rows} rows).`);
+            }
+            else if (table.action === "dropped") {
+                this.out(`Dropped the unused ${table.table} table (${table.rows} rows).`);
+            }
+        }
+    }
+    /**
+     * Every index on this machine.
+     *
+     * Sorted by size and leading with the total, because the question this
+     * answers is almost always "what is using my disk, and can I delete it".
+     */
+    inventory(inventory) {
+        if (inventory.entries.length === 0) {
+            this.out("No indexes on this machine yet. Run `lmgrep index` in a project.");
+            return;
+        }
+        for (const entry of inventory.entries) {
+            const marks = [
+                entry.kind === "legacy" ? "legacy" : undefined,
+                entry.name ? "standalone" : undefined,
+                entry.state === "orphaned" ? "project gone" : undefined,
+                entry.state === "unattributable" ? "unattributable" : undefined,
+            ].filter(Boolean);
+            this.out(`${DiskUsage.format(entry.bytes).padStart(7)}  ${entry.name ?? entry.root ?? "(unknown project)"}` +
+                (marks.length > 0 ? `  [${marks.join(", ")}]` : ""));
+            this.out(`         ${entry.model ?? "unknown model"}${entry.dimensions ? ` · ${entry.dimensions} dims` : ""}`);
+            this.out(`         ${entry.databasePath}`);
+        }
+        this.out(`\n${inventory.entries.length} index(es), ${DiskUsage.format(inventory.totalBytes)} total.`);
+        const legacy = inventory.entries.filter((e) => e.kind === "legacy").length;
+        const dead = inventory.entries.filter((e) => e.state === "orphaned").length;
+        const unknown = inventory.entries.filter((e) => e.state === "unattributable").length;
+        if (legacy > 0) {
+            this.out(`${legacy} still in the state directory — run \`lmgrep projects adopt\` in each project to move them in.`);
+        }
+        if (dead > 0) {
+            this.out(`${dead} whose project no longer exists — \`lmgrep projects gc\` reclaims them.`);
+        }
+        if (unknown > 0) {
+            this.out(`${unknown} record no project — \`lmgrep projects gc --unknown\` includes them.`);
+        }
+        if (inventory.dangling > 0) {
+            this.out(`${inventory.dangling} stale pointer(s) to deleted indexes — \`lmgrep projects gc\` forgets them.`);
+        }
+    }
+    error(message) {
+        console.error(message);
+    }
+}
+//# sourceMappingURL=Renderer.js.map

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

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

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

@@ -0,0 +1,14 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../CommandContext.js";
+/**
+ * `lmgrep ask` — a synthesized, cited answer.
+ *
+ * The live trace goes to stderr and the answer to stdout, so the command stays
+ * pipeable while still showing progress on a run that can take minutes.
+ */
+export declare class AskCommand {
+    private readonly context;
+    constructor(context: CommandContext);
+    register(program: Command): void;
+    private run;
+}

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

@@ -0,0 +1,48 @@
+import { CliOptions } from "../CliOptions.js";
+import { Renderer } from "../Renderer.js";
+/**
+ * `lmgrep ask` — a synthesized, cited answer.
+ *
+ * The live trace goes to stderr and the answer to stdout, so the command stays
+ * pipeable while still showing progress on a run that can take minutes.
+ */
+export class AskCommand {
+    context;
+    constructor(context) {
+        this.context = context;
+    }
+    register(program) {
+        CliOptions.target(program
+            .command("ask <question...>")
+            .description("Answer a question with a local research loop (search, read, synthesize)")
+            .option("--json", "Print the full result (answer, sources, trace) as JSON")
+            .option("--quiet", "Suppress the live research trace on stderr")).action((question, options) => this.run(question.join(" "), options));
+    }
+    async run(question, options) {
+        const { renderer } = this.context;
+        await this.context.withLmgrep(options, async (lmgrep) => {
+            const result = await lmgrep.ask(question, options.quiet
+                ? undefined
+                : (entry) => process.stderr.write(`${Renderer.formatTrace(entry)}\n`));
+            if (options.json) {
+                renderer.json(result);
+                return;
+            }
+            if (!options.quiet)
+                process.stderr.write("\n");
+            renderer.line(result.answer);
+            if (result.sources.length > 0) {
+                renderer.line("\nSources:");
+                for (const s of result.sources) {
+                    renderer.line(`  [${s.n}] ${s.path}:${s.startLine}-${s.endLine}`);
+                }
+            }
+            const seconds = (result.elapsedMs / 1000).toFixed(1);
+            const degraded = result.degraded
+                ? " (degraded: synthesis unavailable)"
+                : "";
+            process.stderr.write(`\n(${result.steps} steps, ${seconds}s)${degraded}\n`);
+        });
+    }
+}
+//# sourceMappingURL=AskCommand.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AskCommand.js","sourceRoot":"","sources":["../../../../src/presentation/cli/commands/AskCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAO1C;;;;;GAKG;AACH,MAAM,OAAO,UAAU;IACO;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,CACX,yEAAyE,CACzE;aACA,MAAM,CACN,QAAQ,EACR,wDAAwD,CACxD;aACA,MAAM,CAAC,SAAS,EAAE,4CAA4C,CAAC,CACjE,CAAC,MAAM,CAAC,CAAC,QAAkB,EAAE,OAAmB,EAAE,EAAE,CACpD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CACrC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,GAAG,CAAC,QAAgB,EAAE,OAAmB;QACtD,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAClC,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACvD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAC9B,QAAQ,EACR,OAAO,CAAC,KAAK;gBACZ,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CACtE,CAAC;YAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBAClB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACtB,OAAO;YACR,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,KAAK;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/C,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAE7B,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC5B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBAChC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBACnE,CAAC;YACF,CAAC;YAED,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACrD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ;gBAC/B,CAAC,CAAC,oCAAoC;gBACtC,CAAC,CAAC,EAAE,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,MAAM,MAAM,CAAC,KAAK,WAAW,OAAO,KAAK,QAAQ,IAAI,CACrD,CAAC;QACH,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}

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

@@ -0,0 +1,18 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../CommandContext.js";
+/** `lmgrep completions` — shell completion scripts. */
+export declare class CompletionsCommand {
+    private readonly context;
+    /** Preferred first: a user-local path needs no privileges. */
+    private static readonly ZSH_CANDIDATES;
+    constructor(context: CommandContext);
+    register(program: Command): void;
+    private runZsh;
+    /**
+     * The first candidate directory that exists and is writable, or that we can
+     * create. `$fpath` is consulted too, since a user's zsh setup may put
+     * site-functions somewhere unusual.
+     */
+    private findSiteFunctions;
+    private fpathEntries;
+}

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

@@ -0,0 +1,96 @@
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** `lmgrep completions` — shell completion scripts. */
+export class CompletionsCommand {
+    context;
+    /** Preferred first: a user-local path needs no privileges. */
+    static ZSH_CANDIDATES = [
+        join(homedir(), ".local", "share", "zsh", "site-functions"),
+        "/usr/local/share/zsh/site-functions",
+        "/usr/share/zsh/site-functions",
+    ];
+    constructor(context) {
+        this.context = context;
+    }
+    register(program) {
+        const completions = program
+            .command("completions")
+            .description("Output shell completions");
+        completions
+            .command("zsh")
+            .description("Output zsh completions")
+            .option("--install", "Install to site-functions and reload completions")
+            .action((options) => this.runZsh(options));
+    }
+    runZsh(options) {
+        const { renderer } = this.context;
+        // Resolved relative to the built script, since the package ships the
+        // completions directory alongside dist/.
+        const script = readFileSync(join(import.meta.dirname, "..", "..", "..", "..", "completions", "_lmgrep"), "utf-8");
+        if (!options.install) {
+            renderer.line(script);
+            return;
+        }
+        const target = this.findSiteFunctions();
+        if (!target) {
+            renderer.error("Could not find a writable zsh site-functions directory.\n" +
+                "Output manually with: lmgrep completions zsh > /path/to/_lmgrep");
+            process.exitCode = 1;
+            return;
+        }
+        mkdirSync(target, { recursive: true });
+        writeFileSync(join(target, "_lmgrep"), script);
+        renderer.line(`Installed completions to ${join(target, "_lmgrep")}`);
+        renderer.line("Restart your shell or run: exec zsh");
+    }
+    /**
+     * The first candidate directory that exists and is writable, or that we can
+     * create. `$fpath` is consulted too, since a user's zsh setup may put
+     * site-functions somewhere unusual.
+     */
+    findSiteFunctions() {
+        const candidates = [...CompletionsCommand.ZSH_CANDIDATES];
+        for (const entry of this.fpathEntries()) {
+            if (entry.includes("site-functions") && !candidates.includes(entry)) {
+                candidates.push(entry);
+            }
+        }
+        for (const candidate of candidates) {
+            try {
+                if (existsSync(candidate)) {
+                    // Probe rather than trust: an existing directory may be
+                    // root-owned.
+                    const probe = join(candidate, ".lmgrep-test");
+                    writeFileSync(probe, "");
+                    rmSync(probe);
+                    return candidate;
+                }
+                if (existsSync(join(candidate, ".."))) {
+                    mkdirSync(candidate, { recursive: true });
+                    return candidate;
+                }
+            }
+            catch {
+                // Not writable — try the next candidate.
+            }
+        }
+        return undefined;
+    }
+    fpathEntries() {
+        try {
+            return execSync("zsh -c 'echo $fpath'", {
+                stdio: ["ignore", "pipe", "ignore"],
+                timeout: 3000,
+            })
+                .toString()
+                .trim()
+                .split(" ");
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=CompletionsCommand.js.map

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

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

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

@@ -0,0 +1,56 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../CommandContext.js";
+/**
+ * `init` and `config` — getting a working configuration.
+ *
+ * Both write exactly one file: the machine config. Which model to embed with
+ * describes this computer, not any repository, so there is one place it can
+ * live and one file to edit when it is wrong.
+ *
+ * `init` no longer has to reason about which model an existing index was built
+ * with. Indexes are stored per model, so choosing a different one selects a
+ * different database rather than corrupting the meaning of an existing one —
+ * an entire class of "you must pick a compatible model" logic that stopped
+ * being necessary the moment the storage layout changed.
+ */
+export declare class ConfigCommands {
+    private readonly context;
+    constructor(context: CommandContext);
+    register(program: Command): void;
+    private registerInit;
+    private runInit;
+    /**
+     * Keep the model the config already names, when the runtime still offers it.
+     *
+     * Detection reads whatever the server lists first or happens to have
+     * loaded, and both move — LM Studio reorders by recency and unloads when
+     * idle. A model written in the config is a decision; re-deriving one from
+     * volatile state would silently swap it.
+     */
+    private keepConfigured;
+    /**
+     * Prefixes to write: the ones already configured win, since they may be
+     * hand-tuned for a model this table knows nothing about, and an empty
+     * document prefix is a deliberate setting rather than an absent one.
+     */
+    private prefixesFor;
+    private selectEmbeddingModel;
+    /**
+     * Pick a model for `ask`, but only one the runtime typed as a chat model.
+     * Guessing here surfaces as a confusing failure much later, at answer time.
+     */
+    private selectChatModel;
+    /**
+     * Name the models not chosen.
+     *
+     * The pick is a guess whenever nothing is loaded, and switching means
+     * editing one config line — but only if the user knows what else was
+     * there. Switching is now cheap and reversible, since each model keeps its
+     * own index, but it still costs a re-embed the first time.
+     */
+    private reportAlternatives;
+    private reportNoRuntime;
+    private preview;
+    private write;
+    private registerConfig;
+}