lmgrep 0.1.17 → 0.2.0

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":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EACN,UAAU,EACV,SAAS,EACT,YAAY,EACZ,MAAM,EACN,aAAa,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,uDAAuD;AACvD,MAAM,OAAO,kBAAkB;IAQD;IAP7B,8DAA8D;IACtD,MAAM,CAAU,cAAc,GAAG;QACxC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,CAAC;QAC3D,qCAAqC;QACrC,+BAA+B;KAC/B,CAAC;IAEF,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,QAAQ,CAAC,OAAgB;QACxB,MAAM,WAAW,GAAG,OAAO;aACzB,OAAO,CAAC,aAAa,CAAC;aACtB,WAAW,CAAC,0BAA0B,CAAC,CAAC;QAE1C,WAAW;aACT,OAAO,CAAC,KAAK,CAAC;aACd,WAAW,CAAC,wBAAwB,CAAC;aACrC,MAAM,CAAC,WAAW,EAAE,kDAAkD,CAAC;aACvE,MAAM,CAAC,CAAC,OAA8B,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,CAAC;IAEO,MAAM,CAAC,OAA8B;QAC5C,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAClC,qEAAqE;QACrE,yCAAyC;QACzC,MAAM,MAAM,GAAG,YAAY,CAC1B,IAAI,CACH,MAAM,CAAC,IAAI,CAAC,OAAO,EACnB,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,aAAa,EACb,SAAS,CACT,EACD,OAAO,CACP,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO;QACR,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACb,QAAQ,CAAC,KAAK,CACb,2DAA2D;gBAC1D,iEAAiE,CAClE,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACR,CAAC;QAED,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC,4BAA4B,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;QACrE,QAAQ,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACK,iBAAiB;QACxB,MAAM,UAAU,GAAG,CAAC,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;QAC1D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YACzC,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC;QACF,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACpC,IAAI,CAAC;gBACJ,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC3B,wDAAwD;oBACxD,cAAc;oBACd,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;oBAC9C,aAAa,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACzB,MAAM,CAAC,KAAK,CAAC,CAAC;oBACd,OAAO,SAAS,CAAC;gBAClB,CAAC;gBACD,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;oBACvC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC1C,OAAO,SAAS,CAAC;gBAClB,CAAC;YACF,CAAC;YAAC,MAAM,CAAC;gBACR,yCAAyC;YAC1C,CAAC;QACF,CAAC;QACD,OAAO,SAAS,CAAC;IAClB,CAAC;IAEO,YAAY;QACnB,IAAI,CAAC;YACJ,OAAO,QAAQ,CAAC,sBAAsB,EAAE;gBACvC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;gBACnC,OAAO,EAAE,IAAI;aACb,CAAC;iBACA,QAAQ,EAAE;iBACV,IAAI,EAAE;iBACN,KAAK,CAAC,GAAG,CAAC,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,EAAE,CAAC;QACX,CAAC;IACF,CAAC"}

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

@@ -0,0 +1,55 @@
+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 write;
+    private registerConfig;
+}

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

@@ -0,0 +1,204 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { ModelIdentity } from "../../../domain/project/ModelIdentity.js";
+import { EmbeddingPrefixes } from "../../../infrastructure/ai/EmbeddingPrefixes.js";
+import { LocalRuntimeDetector } from "../../../infrastructure/ai/LocalRuntimeDetector.js";
+import { ConfigLoader } from "../../../infrastructure/fs/ConfigLoader.js";
+import { ConfigTemplate } from "../ConfigTemplate.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 class ConfigCommands {
+    context;
+    constructor(context) {
+        this.context = context;
+    }
+    register(program) {
+        this.registerInit(program);
+        this.registerConfig(program);
+    }
+    registerInit(program) {
+        program
+            .command("init")
+            .description("Detect your local models and write the machine config")
+            .option("--force", "Overwrite the existing config")
+            .action((options) => this.runInit(options));
+    }
+    async runInit(options) {
+        const { renderer } = this.context;
+        const loader = new ConfigLoader();
+        const configPath = loader.globalConfigPath();
+        if (existsSync(configPath) && !options.force) {
+            renderer.error(`Config already exists at ${configPath}. Use --force to re-detect, or \`lmgrep config\` to edit.`);
+            process.exitCode = 1;
+            return;
+        }
+        // The config already at this path is an explicit prior choice.
+        const previous = loader.readFile(configPath);
+        const runtime = await new LocalRuntimeDetector().detectBest();
+        if (!runtime) {
+            this.reportNoRuntime();
+            this.write(configPath, ConfigTemplate.render());
+            renderer.line(`\nWrote ${configPath} (set a model before indexing)`);
+            return;
+        }
+        renderer.line(`Found ${runtime.label}.`);
+        const model = this.keepConfigured(runtime, previous?.model, "embedding") ??
+            this.selectEmbeddingModel(runtime);
+        const chatModel = this.keepConfigured(runtime, previous?.chatModel, "chat") ??
+            this.selectChatModel(runtime);
+        this.write(configPath, ConfigTemplate.render({
+            model: model ? `${runtime.providerId}:${model}` : undefined,
+            baseURL: model ? runtime.baseURL : undefined,
+            providerPackage: model ? runtime.providerPackage : undefined,
+            local: model ? true : undefined,
+            chatModel: chatModel ? `${runtime.providerId}:${chatModel}` : undefined,
+            prefixes: this.prefixesFor(model, previous),
+            // Carried through rather than regenerated: this is tuning the
+            // user chose, and init has no better answer than they did.
+            batchSize: previous?.batchSize,
+            maxTokens: previous?.maxTokens,
+            dimensions: previous?.dimensions,
+        }));
+        renderer.line(`Wrote ${configPath}`);
+    }
+    /**
+     * 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.
+     */
+    keepConfigured(runtime, configured, kind) {
+        if (!configured)
+            return undefined;
+        const reference = ModelIdentity.of(configured);
+        if (reference.provider !== runtime.providerId)
+            return undefined;
+        if (!runtime.models.some((m) => m.id === reference.family)) {
+            this.context.renderer.line(`Configured ${kind} model "${reference.family}" is no longer available in ${runtime.label}.`);
+            return undefined;
+        }
+        this.context.renderer.line(`Keeping configured ${kind} model: ${reference.family}`);
+        return reference.family;
+    }
+    /**
+     * 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.
+     */
+    prefixesFor(model, previous) {
+        if (previous?.queryPrefix !== undefined) {
+            return {
+                query: previous.queryPrefix,
+                document: previous.documentPrefix ?? "",
+            };
+        }
+        return model ? EmbeddingPrefixes.forModel(model) : undefined;
+    }
+    selectEmbeddingModel(runtime) {
+        const { renderer } = this.context;
+        const embedders = LocalRuntimeDetector.embeddingModels(runtime);
+        // Runtimes that do not type their models still list them; treat the
+        // untyped ones as last-resort candidates.
+        const candidates = [
+            ...embedders,
+            ...LocalRuntimeDetector.untypedModels(runtime),
+        ];
+        const picked = embedders[0] ?? candidates[0];
+        if (!picked) {
+            renderer.line(`\nNo models available in ${runtime.label}.`);
+            renderer.line("Install an embedding model (e.g. nomic-embed-text), then run `lmgrep init` again.");
+            return undefined;
+        }
+        renderer.line(`Using embedding model: ${picked.id}${picked.loaded ? " (loaded)" : ""}`);
+        if (picked.kind !== "embedding") {
+            renderer.line("  (this model's type could not be confirmed — check it is an embedder)");
+        }
+        this.reportAlternatives(candidates, picked.id);
+        const prefixes = EmbeddingPrefixes.forModel(picked.id);
+        if (prefixes) {
+            renderer.line(`  ${prefixes.family} is asymmetric — writing its required prefixes`);
+        }
+        return picked.id;
+    }
+    /**
+     * 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.
+     */
+    selectChatModel(runtime) {
+        const [picked] = LocalRuntimeDetector.chatModels(runtime);
+        if (!picked)
+            return undefined;
+        this.context.renderer.line(`Using chat model for \`ask\`: ${picked.id}${picked.loaded ? " (loaded)" : ""}`);
+        return picked.id;
+    }
+    /**
+     * 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.
+     */
+    reportAlternatives(candidates, chosen) {
+        const others = candidates.filter((m) => m.id !== chosen);
+        if (others.length === 0)
+            return;
+        this.context.renderer.line(`  Also available: ${others.map((m) => m.id).join(", ")}`);
+        this.context.renderer.line("  Change `model` in the config to switch.");
+    }
+    reportNoRuntime() {
+        const { renderer } = this.context;
+        renderer.line("No local embedding server detected.\n");
+        renderer.line("Start one of:");
+        renderer.line("  Ollama     curl -fsSL https://ollama.com/install.sh | sh");
+        renderer.line("  LM Studio  https://lmstudio.ai — enable the local server");
+        renderer.line("");
+        renderer.line("Then run `lmgrep init` again to auto-configure, or edit the config by hand.");
+    }
+    write(configPath, contents) {
+        mkdirSync(dirname(configPath), { recursive: true });
+        writeFileSync(configPath, contents);
+    }
+    registerConfig(program) {
+        program
+            .command("config")
+            .description("Open the machine config in your editor")
+            .action(() => {
+            const { renderer } = this.context;
+            const configPath = new ConfigLoader().globalConfigPath();
+            if (!existsSync(configPath)) {
+                renderer.error(`No config found at ${configPath}. Run \`lmgrep init\` first.`);
+                process.exitCode = 1;
+                return;
+            }
+            const editorCommand = process.env.VISUAL ?? process.env.EDITOR ?? "vi";
+            renderer.line(`Opening ${configPath}`);
+            // $EDITOR may carry flags ("code -w"), so split those off — but
+            // pass the path as its own argv entry, or a directory with
+            // spaces (macOS "Application Support") gets re-split.
+            const [editor, ...args] = editorCommand.trim().split(/\s+/);
+            const result = spawnSync(editor, [...args, configPath], {
+                stdio: "inherit",
+            });
+            if (result.error || (result.status != null && result.status !== 0)) {
+                renderer.error(`Could not open editor "${editorCommand}". Set $EDITOR or $VISUAL.`);
+                process.exitCode = 1;
+            }
+        });
+    }
+}
+//# sourceMappingURL=ConfigCommands.js.map

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

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

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

@@ -0,0 +1,18 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../CommandContext.js";
+/**
+ * `lmgrep index` — adopt a project, and keep it current.
+ *
+ * This is the one moment a user consents to lmgrep reading a whole repository
+ * and spending time embedding it, which is why it stays an explicit command
+ * rather than something a search triggers. Everything that used to be a
+ * separate chore afterwards — reconciling the manifest, dropping duplicate
+ * rows, compacting fragments, training the vector index — happens here, at the
+ * one moment someone is already waiting and watching.
+ */
+export declare class IndexCommand {
+    private readonly context;
+    constructor(context: CommandContext);
+    register(program: Command): void;
+    private run;
+}

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

@@ -0,0 +1,54 @@
+import { CliOptions } from "../CliOptions.js";
+/**
+ * `lmgrep index` — adopt a project, and keep it current.
+ *
+ * This is the one moment a user consents to lmgrep reading a whole repository
+ * and spending time embedding it, which is why it stays an explicit command
+ * rather than something a search triggers. Everything that used to be a
+ * separate chore afterwards — reconciling the manifest, dropping duplicate
+ * rows, compacting fragments, training the vector index — happens here, at the
+ * one moment someone is already waiting and watching.
+ */
+export class IndexCommand {
+    context;
+    constructor(context) {
+        this.context = context;
+    }
+    register(program) {
+        CliOptions.target(program
+            .command("index")
+            .description("Index this project for semantic search")
+            .option("-r, --reset", "Discard the index and rebuild from scratch")
+            .option("-v, --verbose", "Show file-by-file progress")
+            .option("-s, --since <duration>", "Only consider files modified within duration (e.g. 10m, 2h, 1d)")
+            .option("-d, --dry", "Report what would be indexed, and stop")).action((options) => this.run(options));
+    }
+    async run(options) {
+        await this.context.withLmgrep(options, async (lmgrep) => {
+            // Said before the work starts, not after: embedding a repository
+            // with a newly configured model can take a long time, and someone
+            // who only meant to try a model out should get the chance to put
+            // the old one back instead of watching it run.
+            this.context.renderer.newModelNotice(lmgrep.alternatives.others());
+            const result = await lmgrep.build({
+                reset: options.reset,
+                verbose: options.verbose,
+                since: options.since,
+                dry: options.dry,
+                // A foreground command the user is watching, so it is the right
+                // place to pay the one-time ANN training cost.
+                createIndex: true,
+            });
+            if (options.dry)
+                return;
+            // Only after a run that changed something: deduplication reads
+            // every row, and paying that on `lmgrep index` over an unchanged
+            // repository would make the no-op case the slow one.
+            if (result.succeeded > 0 || result.removed > 0) {
+                this.context.renderer.maintenance(await lmgrep.tidy());
+            }
+            this.context.renderer.line(`\nIndex: ${lmgrep.location.path}`);
+        });
+    }
+}
+//# sourceMappingURL=IndexCommand.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IndexCommand.js","sourceRoot":"","sources":["../../../../src/presentation/cli/commands/IndexCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAU9C;;;;;;;;;GASG;AACH,MAAM,OAAO,YAAY;IACK;IAA7B,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;IAExD,QAAQ,CAAC,OAAgB;QACxB,UAAU,CAAC,MAAM,CAChB,OAAO;aACL,OAAO,CAAC,OAAO,CAAC;aAChB,WAAW,CAAC,wCAAwC,CAAC;aACrD,MAAM,CAAC,aAAa,EAAE,4CAA4C,CAAC;aACnE,MAAM,CAAC,eAAe,EAAE,4BAA4B,CAAC;aACrD,MAAM,CACN,wBAAwB,EACxB,iEAAiE,CACjE;aACA,MAAM,CAAC,WAAW,EAAE,wCAAwC,CAAC,CAC/D,CAAC,MAAM,CAAC,CAAC,OAAqB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAEO,KAAK,CAAC,GAAG,CAAC,OAAqB;QACtC,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACvD,iEAAiE;YACjE,kEAAkE;YAClE,iEAAiE;YACjE,+CAA+C;YAC/C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;YAEnE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;gBACjC,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,gEAAgE;gBAChE,+CAA+C;gBAC/C,WAAW,EAAE,IAAI;aACjB,CAAC,CAAC;YAEH,IAAI,OAAO,CAAC,GAAG;gBAAE,OAAO;YACxB,+DAA+D;YAC/D,iEAAiE;YACjE,qDAAqD;YACrD,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACxD,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}

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

@@ -0,0 +1,48 @@
+import type { Command } from "commander";
+import type { CommandContext } from "../CommandContext.js";
+/**
+ * `lmgrep projects` — every index on this machine, and what to do about it.
+ *
+ * This is the answer to the state lmgrep used to accumulate silently. An index
+ * now lives inside the repository it describes, so deleting the clone deletes
+ * the index; but installs that predate that still hold databases in the state
+ * directory, pointing at working trees that may be long gone. `adopt` moves
+ * one into its repository without re-embedding, `rm` deletes one, and `gc`
+ * removes the ones whose project no longer exists.
+ */
+export declare class ProjectsCommand {
+    private readonly context;
+    private readonly state;
+    private readonly metadata;
+    private readonly registry;
+    constructor(context: CommandContext);
+    register(program: Command): void;
+    private list;
+    /**
+     * Move a legacy database into its repository.
+     *
+     * Worth doing rather than re-indexing because the expensive part of an
+     * index is the embedding, not the storage — a large corpus is minutes of
+     * model time to rebuild and a rename to move. The destination is derived
+     * from the model the database *was built with*, not the one currently
+     * configured, so it lands where searches with that model will look.
+     */
+    private adopt;
+    private remove;
+    /**
+     * Delete indexes whose project is gone.
+     *
+     * "Records no project" is excluded unless asked for. It is a recursive
+     * delete, and an index with no metadata is not evidence that its project
+     * vanished — only that nothing was written down about it. Treating the two
+     * as one would have made `gc` destroy far more than it claimed to.
+     */
+    private collect;
+    /** Whether a legacy entry describes the project at `cwd`. */
+    private sameProject;
+    /** Rename when possible; copy across filesystems, which repos often are. */
+    private move;
+    private inventory;
+    private locator;
+    private confirm;
+}