lmgrep 0.1.17 → 0.2.0

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

@@ -0,0 +1,31 @@
+/** Everything `init` managed to work out about the local setup. */
+export interface DetectedSettings {
+    model?: string;
+    baseURL?: string;
+    providerPackage?: string;
+    local?: boolean;
+    chatModel?: string;
+    prefixes?: {
+        query: string;
+        document: string;
+        family?: string;
+    };
+    /** Deliberate tuning from an existing config, carried through untouched. */
+    batchSize?: number;
+    maxTokens?: number;
+    dimensions?: number;
+}
+/**
+ * The starter `config.yml` written by `lmgrep init`.
+ *
+ * Every optional setting is present but commented out. That is deliberate: it
+ * doubles as the reference documentation a user actually reads, so an option
+ * they never knew existed is one line away rather than in a README.
+ *
+ * Only machine settings appear here. `ignore` and `extensions` describe a
+ * repository and belong in its `.lmgrep.yml`, where they can be committed and
+ * mean the same thing on every machine that checks it out.
+ */
+export declare class ConfigTemplate {
+    static render(detected?: DetectedSettings): string;
+}

package/dist/presentation/cli/ConfigTemplate.js

@@ -0,0 +1,83 @@
+/**
+ * The starter `config.yml` written by `lmgrep init`.
+ *
+ * Every optional setting is present but commented out. That is deliberate: it
+ * doubles as the reference documentation a user actually reads, so an option
+ * they never knew existed is one line away rather than in a README.
+ *
+ * Only machine settings appear here. `ignore` and `extensions` describe a
+ * repository and belong in its `.lmgrep.yml`, where they can be committed and
+ * mean the same thing on every machine that checks it out.
+ */
+export class ConfigTemplate {
+    static render(detected) {
+        const modelLine = detected?.model
+            ? `model: ${detected.model}`
+            : "# model: ollama:nomic-embed-text  # ← set your model here";
+        const baseURLLine = detected?.baseURL
+            ? `baseURL: ${detected.baseURL}`
+            : "# baseURL: http://localhost:11434/v1";
+        const providerLine = detected?.providerPackage
+            ? `provider: "${detected.providerPackage}"`
+            : '# provider: "@ai-sdk/openai-compatible"';
+        const localLine = detected?.local ? "local: true" : "# local: true";
+        // Asymmetric models need these and fail silently without them, so they
+        // are written out rather than left commented.
+        const prefixLines = detected?.prefixes
+            ? [
+                detected.prefixes.family
+                    ? `# ${detected.prefixes.family} models are asymmetric — these prefixes are required.`
+                    : "# Prefixes required by this model.",
+                `queryPrefix: ${JSON.stringify(detected.prefixes.query)}`,
+                `documentPrefix: ${JSON.stringify(detected.prefixes.document)}`,
+            ].join("\n")
+            : [
+                '# queryPrefix: "search_query: "',
+                '# documentPrefix: "search_document: "',
+            ].join("\n");
+        const chatLine = detected?.chatModel
+            ? `chatModel: ${detected.chatModel}`
+            : "# chatModel: lmstudio:qwen/qwen3.5-9b";
+        return `# lmgrep — this machine's inference setup.
+#
+# These settings say which local models to use and where they listen. They are
+# not per project: each model keeps its own index, so changing \`model\` here
+# selects a different database rather than invalidating an existing one.
+#
+# Per-repository settings (ignore patterns, file extensions) go in a
+# .lmgrep.yml inside that repository.
+#
+# Quick start with Ollama:
+#   1. Install: curl -fsSL https://ollama.com/install.sh | sh
+#   2. Pull a model: ollama pull nomic-embed-text
+#   3. Run: lmgrep init --force  (to auto-detect)
+
+# Embedding model in "provider:model" format
+${modelLine}
+
+# Base URL for the embedding API
+${baseURLLine}
+
+# AI SDK package providing the model
+${providerLine}
+
+# Provider runs locally, so health checks may probe it freely
+${localLine}
+
+# Batch size for embedding API calls
+batchSize: ${detected?.batchSize ?? 100}
+
+${prefixLines}
+
+# Generative model for \`lmgrep ask\`. Optional — without it, \`ask\` is hidden.
+${chatLine}
+
+# Optional: embedding dimensions (if model supports it)
+${detected?.dimensions ? `dimensions: ${detected.dimensions}` : "# dimensions: 384"}
+
+# Optional: max tokens per chunk (estimated at 4 chars/token)
+${detected?.maxTokens ? `maxTokens: ${detected.maxTokens}` : "# maxTokens: 8192"}
+`;
+    }
+}
+//# sourceMappingURL=ConfigTemplate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigTemplate.js","sourceRoot":"","sources":["../../../src/presentation/cli/ConfigTemplate.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,cAAc;IAC1B,MAAM,CAAC,MAAM,CAAC,QAA2B;QACxC,MAAM,SAAS,GAAG,QAAQ,EAAE,KAAK;YAChC,CAAC,CAAC,UAAU,QAAQ,CAAC,KAAK,EAAE;YAC5B,CAAC,CAAC,2DAA2D,CAAC;QAC/D,MAAM,WAAW,GAAG,QAAQ,EAAE,OAAO;YACpC,CAAC,CAAC,YAAY,QAAQ,CAAC,OAAO,EAAE;YAChC,CAAC,CAAC,sCAAsC,CAAC;QAC1C,MAAM,YAAY,GAAG,QAAQ,EAAE,eAAe;YAC7C,CAAC,CAAC,cAAc,QAAQ,CAAC,eAAe,GAAG;YAC3C,CAAC,CAAC,yCAAyC,CAAC;QAC7C,MAAM,SAAS,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC;QAEpE,uEAAuE;QACvE,8CAA8C;QAC9C,MAAM,WAAW,GAAG,QAAQ,EAAE,QAAQ;YACrC,CAAC,CAAC;gBACA,QAAQ,CAAC,QAAQ,CAAC,MAAM;oBACvB,CAAC,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,MAAM,uDAAuD;oBACtF,CAAC,CAAC,oCAAoC;gBACvC,gBAAgB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;gBACzD,mBAAmB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;aAC/D,CAAC,IAAI,CAAC,IAAI,CAAC;YACb,CAAC,CAAC;gBACA,iCAAiC;gBACjC,uCAAuC;aACvC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEf,MAAM,QAAQ,GAAG,QAAQ,EAAE,SAAS;YACnC,CAAC,CAAC,cAAc,QAAQ,CAAC,SAAS,EAAE;YACpC,CAAC,CAAC,uCAAuC,CAAC;QAE3C,OAAO;;;;;;;;;;;;;;;EAeP,SAAS;;;EAGT,WAAW;;;EAGX,YAAY;;;EAGZ,SAAS;;;aAGE,QAAQ,EAAE,SAAS,IAAI,GAAG;;EAErC,WAAW;;;EAGX,QAAQ;;;EAGR,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,eAAe,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,mBAAmB;;;EAGjF,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,cAAc,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,mBAAmB;CAC/E,CAAC;IACD,CAAC;CACD"}

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":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAGjE;;;;;;GAMG;AACH,MAAM,OAAO,QAAQ;IAGS;IAFrB,MAAM,CAAU,UAAU,GAAG,EAAE,CAAC;IAExC,YAA6B,MAA8B,OAAO,CAAC,GAAG;QAAzC,QAAG,GAAH,GAAG,CAAsC;IAAG,CAAC;IAE1E,IAAI,CAAC,IAAI,GAAG,EAAE;QACb,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAED,IAAI;QACH,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC,KAAc;QAClB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,IAAoB;QACxB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;YAC3C,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACjD,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC;YAC9D,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACF,CAAC;IAED,wDAAwD;IACxD,QAAQ,CAAC,IAAoB;QAC5B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAAE,SAAS;YAC9C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;IACF,CAAC;IAED,qEAAqE;IACrE,MAAM,CAAC,WAAW,CAAC,KAAiB;QACnC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAC7B,CAAC,CAAC,cAAc,KAAK,CAAC,KAAK,OAAO,KAAK,CAAC,IAAI,OAAO;YACnD,CAAC,CAAC,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,IAAgB;QAC7B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YACpD,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACvC,OAAO;QACR,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI;YAAE,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,uEAAuE;IACvE,YAAY,CAAC,IAAgB;QAC5B,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,IAAgB;QAC5B,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;YACrC,OAAO;QACR,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG;gBACb,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;gBAClD,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,SAAS;aACrD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpD,IAAI,CAAC,GAAG,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;QAC9D,CAAC;IACF,CAAC;IAED,WAAW,CAAC,IAAgB;QAC3B,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAClD,IAAI,IAAI,CAAC,UAAU;YAAE,IAAI,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACnE,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,uEAAuE;QACvE,4BAA4B;QAC5B,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;YAC3C,IAAI,CAAC,GAAG,CAAC,iBAAiB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACK,WAAW,CAAC,KAAgC;QACnD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CACP,KAAK,CAAC,SAAS,GAAG,CAAC;gBAClB,CAAC,CAAC,wBAAwB,KAAK,CAAC,SAAS,mCAAmC;gBAC5E,CAAC,CAAC,qBAAqB,CACxB,CAAC;YACF,OAAO;QACR,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;YACpD,OAAO;QACR,CAAC;QACD,IAAI,CAAC,GAAG,CACP,mDAAmD;YAClD,GAAG,KAAK,CAAC,IAAI,gDAAgD,CAC9D,CAAC;IACH,CAAC;IAED,YAAY,CAAC,IAAgB;QAC5B,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,kBAAkB,KAAK,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACrB,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5D,IAAI,IAAI,CAAC,cAAc;oBAAE,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAChD,CAAC;QACF,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC5B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,CACP,SAAS,IAAI,CAAC,iBAAiB,YAAY,IAAI,CAAC,eAAe,KAAK,CACpE,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACP,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACvB,CAAC;IACF,CAAC;IAED,wEAAwE;IACxE,gBAAgB,CAAC,SAAoC;QACpD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;YAC3C,OAAO;QACR,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,KAAK,GACV,IAAI,CAAC,IAAI,KAAK,KAAK;gBAClB,CAAC,CAAC,YAAY;gBACd,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO;oBACtB,CAAC,CAAC,OAAO;oBACT,CAAC,CAAC,KAAK,CAAC;YACX,IAAI,CAAC,GAAG,CACP,KAAK,KAAK,SAAS,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAClE,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,WAAW,IAAI,SAAS,EAAE,CAAC,CAAC;YAC1D,IAAI,IAAI,CAAC,YAAY;gBAAE,IAAI,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QACtE,CAAC;IACF,CAAC;IAED,oEAAoE;IACpE,OAAO,CAAC,OAIP;QACA,MAAM,KAAK,GACV,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QACzE,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;YACnC,OAAO;QACR,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;IACzD,CAAC;IAEO,WAAW,CAAC,KAAa,EAAE,MAAc,EAAE,KAAe;QACjE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/B,MAAM,KAAK,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,OAAO,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QACtE,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,MAAM,GAAG,KAAK,OAAO,CAAC,CAAC;QACtD,CAAC;IACF,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAC,MAA+B;QAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAChC,IAAI,CAAC,GAAG,CACP,uCAAuC;YACtC,MAAM;iBACJ,GAAG,CACH,CAAC,CAAC,EAAE,EAAE,CACL,GAAG,CAAC,CAAC,KAAK,IAAI,qBAAqB,KAAK,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CACrE;iBACA,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QACF,IAAI,CAAC,GAAG,CACP,mFAAmF,CACnF,CAAC;QACF,IAAI,CAAC,GAAG,CACP,+EAA+E,CAC/E,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,WAAW,CAAC,MAAkB;QAC7B,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;QACtE,IAAI,YAAY,GAAG,aAAa,GAAG,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,GAAG,CACP,WAAW,YAAY,kBAAkB,aAAa,uBAAuB,MAAM,MAAM,KAAK,IAAI,CAClG,CAAC;QACH,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChC,IAAI,CAAC,GAAG,CAAC,yBAAyB,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC;YACxE,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvC,IAAI,CAAC,GAAG,CACP,sBAAsB,KAAK,CAAC,KAAK,WAAW,KAAK,CAAC,IAAI,SAAS,CAC/D,CAAC;YACH,CAAC;QACF,CAAC;IACF,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,SAAoB;QAC7B,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,GAAG,CACP,kEAAkE,CAClE,CAAC;YACF,OAAO;QACR,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG;gBACb,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;gBAC9C,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;gBACrC,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;gBACvD,KAAK,CAAC,KAAK,KAAK,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;aAC/D,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAClB,IAAI,CAAC,GAAG,CACP,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,mBAAmB,EAAE;gBACjG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACpD,CAAC;YACF,IAAI,CAAC,GAAG,CACP,YAAY,KAAK,CAAC,KAAK,IAAI,eAAe,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,UAAU,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CACpG,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC,GAAG,CACP,KAAK,SAAS,CAAC,OAAO,CAAC,MAAM,eAAe,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,CAC3F,CAAC;QAEF,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,MAAM,CAAC;QAC3E,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;QAC5E,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,gBAAgB,CACnC,CAAC,MAAM,CAAC;QACT,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YAChB,IAAI,CAAC,GAAG,CACP,GAAG,MAAM,gGAAgG,CACzG,CAAC;QACH,CAAC;QACD,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;YACd,IAAI,CAAC,GAAG,CACP,GAAG,IAAI,yEAAyE,CAChF,CAAC;QACH,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CACP,GAAG,OAAO,sEAAsE,CAChF,CAAC;QACH,CAAC;QACD,IAAI,SAAS,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,GAAG,CACP,GAAG,SAAS,CAAC,QAAQ,6EAA6E,CAClG,CAAC;QACH,CAAC;IACF,CAAC;IAED,KAAK,CAAC,OAAe;QACpB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC"}

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