lmgrep 0.1.18 → 0.2.0

package/dist/presentation/cli/Cli.js

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

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

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

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

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

package/dist/presentation/cli/CliOptions.js

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

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

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

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

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

package/dist/presentation/cli/CommandContext.js

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

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

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

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