lmgrep 0.1.18 → 0.2.1

package/dist/mcp.js

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

package/dist/mcp.js.map

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

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

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

package/dist/presentation/cli/Cli.js

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

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

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

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

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

package/dist/presentation/cli/CliOptions.js

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

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

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

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

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

package/dist/presentation/cli/CommandContext.js

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

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

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

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"}