@ixxrllg/localmind 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ixxrllg and LocalMind contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,290 @@
+# LocalMind
+
+**Give every AI agent perfect memory of your codebase — offline.**
+
+LocalMind is a local-first knowledge & context engine for developers and AI coding agents. It indexes your repository into a searchable knowledge base (BM25 + optional embeddings), builds a lightweight import graph, answers questions with citations, and exposes everything through a **CLI** and an **MCP server**.
+
+[![Node.js](https://img.shields.io/badge/node-%3E%3D22.5-brightgreen)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-ready-purple)](https://modelcontextprotocol.io/)
+[![GitHub stars](https://img.shields.io/github/stars/ixxrllg/localmind?style=social)](https://github.com/ixxrllg/localmind)
+[![GitHub issues](https://img.shields.io/github/issues/ixxrllg/localmind)](https://github.com/ixxrllg/localmind/issues)
+
+---
+
+## Why LocalMind?
+
+| Pain | LocalMind |
+|------|-----------|
+| AI agents forget project context | Persistent local index + MCP tools |
+| Cloud RAG leaks private code | 100% local by default (SQLite) |
+| Grep is not enough for questions | BM25 ranking + extractive / generative answers |
+| “What depends on this file?” | Import / link knowledge graph |
+
+Works **without API keys**. Optional OpenAI or Ollama for embeddings and generative answers.
+
+---
+
+## Quick start
+
+**Requirements:** Node.js ≥ 22.5
+
+### Install from npm
+
+```bash
+npm install -g @ixxrllg/localmind
+
+# in any project
+localmind init
+localmind index
+localmind ask "Where is authentication handled?"
+localmind search "jwt middleware"
+localmind status
+```
+
+Or without global install:
+
+```bash
+npx @ixxrllg/localmind init
+npx @ixxrllg/localmind index
+npx @ixxrllg/localmind ask "Where is authentication handled?"
+```
+
+### From source
+
+```bash
+git clone https://github.com/ixxrllg/localmind.git
+cd localmind
+npm install
+npm run build
+node dist/bin/localmind.js init --root /path/to/your/project
+```
+
+---
+
+## CLI
+
+| Command | Description |
+|---------|-------------|
+| `localmind init` | Create `.localmind/config.json` + SQLite DB |
+| `localmind index` | Walk repo, chunk files, build inverted index (+ optional embeddings) |
+| `localmind index --full` | Force full re-index |
+| `localmind search <query>` | Ranked code/doc search |
+| `localmind ask <question>` | Q&A with citations |
+| `localmind related <path>` | Files linked via imports / markdown links |
+| `localmind status` | Index statistics |
+| `localmind mcp` | Start MCP server on **stdio** |
+| `localmind config` | Show / update config |
+
+Global options:
+
+```
+-r, --root <path>   Project root (default: cwd)
+-q, --quiet
+--verbose
+```
+
+### Examples
+
+```bash
+localmind init --provider ollama
+localmind index
+localmind search "chunkText overlap" --mode bm25
+localmind ask "How are files ignored during indexing?" --extractive
+localmind related src/indexer/indexer.ts
+localmind status --json
+```
+
+---
+
+## MCP (Cursor / Claude Code / agents)
+
+```bash
+localmind mcp --root /path/to/your/project
+```
+
+Example MCP config (Cursor / Claude Desktop):
+
+```json
+{
+  "mcpServers": {
+    "localmind": {
+      "command": "node",
+      "args": [
+        "/absolute/path/to/localmind/dist/bin/localmind.js",
+        "mcp",
+        "--root",
+        "/absolute/path/to/your/project"
+      ]
+    }
+  }
+}
+```
+
+> Replace paths with your clone of [ixxrllg/localmind](https://github.com/ixxrllg/localmind) and the project you want indexed.
+
+### Tools
+
+| Tool | Purpose |
+|------|---------|
+| `search_code` | Semantic/lexical search over the index |
+| `ask_codebase` | Question answering with citations |
+| `find_related_files` | Graph neighborhood for a path |
+| `explain_file` | Dump indexed chunks for a file / line range |
+| `index_status` | Stats |
+| `reindex` | Incremental or full re-index |
+
+---
+
+## How it works
+
+```
+your repo
+   │
+   ▼
+ walker + ignore rules (.gitignore, defaults)
+   │
+   ▼
+ line-aware chunker ──► SQLite
+   │                      ├─ files / chunks
+   │                      ├─ BM25 inverted index (terms + postings)
+   │                      ├─ import/link edges
+   │                      └─ optional embeddings
+   ▼
+ search (BM25 / vector / hybrid) ──► ask (extractive or LLM)
+   │
+   ▼
+ CLI  ·  MCP  ·  library API
+```
+
+- **Storage:** `.localmind/localmind.db` (Node built-in `node:sqlite`)
+- **Default search:** BM25 (no network, no models)
+- **Optional:** OpenAI / Ollama embeddings + chat
+
+---
+
+## Configuration
+
+`.localmind/config.json` (created by `init`):
+
+```json
+{
+  "version": 1,
+  "provider": "none",
+  "include": [],
+  "exclude": [],
+  "maxFileBytes": 524288,
+  "chunkSize": 1200,
+  "chunkOverlap": 150,
+  "incremental": true
+}
+```
+
+### Environment (optional)
+
+See `.env.example`:
+
+| Variable | Role |
+|----------|------|
+| `OPENAI_API_KEY` | Embeddings + generative answers |
+| `OPENAI_BASE_URL` | Compatible gateways |
+| `OPENAI_MODEL` | Chat model (default `gpt-4o-mini`) |
+| `OPENAI_EMBEDDING_MODEL` | Default `text-embedding-3-small` |
+| `OLLAMA_BASE_URL` | Default `http://127.0.0.1:11434` |
+| `OLLAMA_MODEL` / `OLLAMA_EMBEDDING_MODEL` | Local models |
+
+```bash
+localmind config --provider openai
+# or
+localmind config --provider ollama
+```
+
+---
+
+## Library API
+
+```ts
+import {
+  initConfig,
+  loadConfig,
+  runIndex,
+  openDb,
+  closeDb,
+  search,
+  ask,
+} from "@ixxrllg/localmind";
+
+const { config } = initConfig({ root: process.cwd() });
+await runIndex(config, { full: true });
+
+const db = openDb(config.root);
+const hits = await search(db, "authentication middleware");
+const answer = await ask(db, config, "How does auth work?");
+closeDb(db);
+```
+
+---
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+npm run dev -- init
+npm run dev -- index
+npm run dev -- ask "What is LocalMind?"
+```
+
+Requirements:
+
+- **Node.js ≥ 22.5** (uses built-in `node:sqlite`)
+
+---
+
+## Project layout
+
+```
+src/
+  bin/localmind.ts     CLI entry
+  cli/                 Commander program + formatting
+  core/                config, paths, SQLite
+  indexer/             walk, chunk, relations, index pipeline
+  search/              tokenize, BM25, embeddings, hybrid
+  ask/                 extractive + generative Q&A
+  graph/               related files
+  mcp/                 MCP server + tools
+  index.ts             public exports
+tests/                 unit + integration
+```
+
+---
+
+## Roadmap
+
+- [ ] File watcher / live re-index
+- [ ] Tree-sitter aware chunking
+- [ ] sqlite-vec acceleration
+- [ ] Web UI for exploration
+- [ ] Multi-repo workspaces
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). Issues and PRs welcome.
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+## Author
+
+Maintained by [@ixxrllg](https://github.com/ixxrllg).
+
+---
+
+<p align="center">
+  <b>Star ⭐ this repo if LocalMind saves you a context switch.</b><br/>
+  Built for agents. Useful for humans.
+</p>

package/dist/ask/answer.d.ts

@@ -0,0 +1,9 @@
+import type { Db } from "../core/db.js";
+import type { AskResult, LocalMindConfig, ProviderKind } from "../types.js";
+export interface AskOptions {
+    limit?: number;
+    mode?: "auto" | "extractive" | "generative";
+    provider?: ProviderKind;
+}
+export declare function ask(db: Db, config: LocalMindConfig, question: string, options?: AskOptions): Promise<AskResult>;
+//# sourceMappingURL=answer.d.ts.map

package/dist/ask/answer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer.d.ts","sourceRoot":"","sources":["../../src/ask/answer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAa,MAAM,aAAa,CAAC;AAGvF,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,CAAC;IAC5C,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,wBAAsB,GAAG,CACvB,EAAE,EAAE,EAAE,EACN,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,SAAS,CAAC,CA2DpB"}

package/dist/ask/answer.js

@@ -0,0 +1,183 @@
+import { search } from "../search/search.js";
+export async function ask(db, config, question, options = {}) {
+    const started = Date.now();
+    const q = question.trim();
+    if (!q) {
+        return {
+            question,
+            answer: "Please provide a non-empty question.",
+            mode: "extractive",
+            provider: "none",
+            hits: [],
+            tookMs: 0,
+        };
+    }
+    const provider = options.provider ?? config.provider;
+    const hits = await search(db, q, {
+        limit: options.limit ?? 6,
+        mode: provider === "none" ? "bm25" : "hybrid",
+        provider,
+    });
+    const wantGenerative = options.mode === "generative" ||
+        (options.mode !== "extractive" && provider !== "none");
+    if (wantGenerative && hits.length) {
+        try {
+            const answer = await generateAnswer(q, hits, provider);
+            return {
+                question: q,
+                answer,
+                mode: "generative",
+                provider,
+                hits,
+                tookMs: Date.now() - started,
+            };
+        }
+        catch (err) {
+            const fallback = buildExtractiveAnswer(q, hits);
+            return {
+                question: q,
+                answer: `${fallback}\n\n_(Generative answer failed: ${err instanceof Error ? err.message : String(err)}; showing extractive result.)_`,
+                mode: "extractive",
+                provider,
+                hits,
+                tookMs: Date.now() - started,
+            };
+        }
+    }
+    return {
+        question: q,
+        answer: buildExtractiveAnswer(q, hits),
+        mode: "extractive",
+        provider: "none",
+        hits,
+        tookMs: Date.now() - started,
+    };
+}
+function buildExtractiveAnswer(question, hits) {
+    if (!hits.length) {
+        return [
+            `No relevant context found for: "${question}"`,
+            "",
+            "Tips:",
+            "- Run `localmind index` after code changes",
+            "- Try more specific identifiers (function/class names)",
+            "- Check `localmind status` for index size",
+        ].join("\n");
+    }
+    const lines = [
+        `## Answer (extractive)`,
+        "",
+        `Based on ${hits.length} relevant chunk(s) in the local index:`,
+        "",
+    ];
+    for (const hit of hits) {
+        const snippet = trimSnippet(hit.content, 500);
+        lines.push(`### ${hit.rank}. \`${hit.path}\` (L${hit.startLine}–${hit.endLine})`);
+        lines.push(`Score: ${hit.score.toFixed(4)}`);
+        lines.push("```" + fenceLang(hit.language));
+        lines.push(snippet);
+        lines.push("```");
+        lines.push("");
+    }
+    lines.push("---");
+    lines.push("Citations only — no LLM was used. Set provider to `openai` or `ollama` (and API env vars) for generative answers.");
+    return lines.join("\n");
+}
+function trimSnippet(text, max) {
+    const t = text.trim();
+    if (t.length <= max)
+        return t;
+    return t.slice(0, max).trimEnd() + "\n…";
+}
+function fenceLang(language) {
+    const map = {
+        typescript: "ts",
+        javascript: "js",
+        python: "python",
+        rust: "rust",
+        go: "go",
+        markdown: "md",
+        json: "json",
+        yaml: "yaml",
+        shell: "bash",
+    };
+    return map[language] ?? language;
+}
+async function generateAnswer(question, hits, provider) {
+    const context = hits
+        .map((h, i) => `[${i + 1}] ${h.path}:${h.startLine}-${h.endLine}\n${h.content}`)
+        .join("\n\n---\n\n");
+    const system = [
+        "You are LocalMind, a precise codebase assistant.",
+        "Answer using ONLY the provided context chunks.",
+        "Cite sources as [n] with file paths.",
+        "If the context is insufficient, say what is missing.",
+        "Be concise and technical.",
+    ].join(" ");
+    const user = `Question: ${question}\n\nContext:\n${context}`;
+    if (provider === "openai" || (provider === "none" && process.env.OPENAI_API_KEY)) {
+        return openaiChat(system, user);
+    }
+    if (provider === "ollama") {
+        return ollamaChat(system, user);
+    }
+    throw new Error("No generative provider configured");
+}
+async function openaiChat(system, user) {
+    const apiKey = process.env.OPENAI_API_KEY;
+    if (!apiKey)
+        throw new Error("OPENAI_API_KEY is not set");
+    const baseUrl = (process.env.OPENAI_BASE_URL?.trim() || "https://api.openai.com/v1").replace(/\/$/, "");
+    const model = process.env.OPENAI_MODEL?.trim() || "gpt-4o-mini";
+    const res = await fetch(`${baseUrl}/chat/completions`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+            model,
+            temperature: 0.2,
+            messages: [
+                { role: "system", content: system },
+                { role: "user", content: user },
+            ],
+        }),
+    });
+    if (!res.ok) {
+        throw new Error(`OpenAI chat failed (${res.status}): ${await res.text()}`);
+    }
+    const data = (await res.json());
+    const content = data.choices?.[0]?.message?.content?.trim();
+    if (!content)
+        throw new Error("Empty OpenAI response");
+    return content;
+}
+async function ollamaChat(system, user) {
+    const baseUrl = (process.env.OLLAMA_BASE_URL?.trim() ||
+        process.env.OLLAMA_HOST?.trim() ||
+        "http://127.0.0.1:11434").replace(/\/$/, "");
+    const model = process.env.OLLAMA_MODEL?.trim() || "llama3.2";
+    const res = await fetch(`${baseUrl}/api/chat`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            model,
+            stream: false,
+            messages: [
+                { role: "system", content: system },
+                { role: "user", content: user },
+            ],
+            options: { temperature: 0.2 },
+        }),
+    });
+    if (!res.ok) {
+        throw new Error(`Ollama chat failed (${res.status}): ${await res.text()}`);
+    }
+    const data = (await res.json());
+    const content = data.message?.content?.trim();
+    if (!content)
+        throw new Error("Empty Ollama response");
+    return content;
+}
+//# sourceMappingURL=answer.js.map

package/dist/ask/answer.js.map

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

package/dist/bin/localmind.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=localmind.d.ts.map

package/dist/bin/localmind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localmind.d.ts","sourceRoot":"","sources":["../../src/bin/localmind.ts"],"names":[],"mappings":""}

package/dist/bin/localmind.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { runCli } from "../cli/program.js";
+runCli(process.argv).catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    console.error(`localmind: ${message}`);
+    if (err instanceof Error && err.stack && process.env.DEBUG) {
+        console.error(err.stack);
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=localmind.js.map

package/dist/bin/localmind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localmind.js","sourceRoot":"","sources":["../../src/bin/localmind.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC1C,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,KAAK,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;IACvC,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QAC3D,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli/format.d.ts

@@ -0,0 +1,7 @@
+import type { AskResult, IndexStats, SearchHit, StatusInfo } from "../types.js";
+export declare function printInitResult(root: string, created: boolean): void;
+export declare function printIndexStats(stats: IndexStats): void;
+export declare function printStatus(status: StatusInfo): void;
+export declare function printSearchHits(hits: SearchHit[]): void;
+export declare function printAskResult(result: AskResult, json?: boolean): void;
+//# sourceMappingURL=format.d.ts.map

package/dist/cli/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/cli/format.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGhF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CASpE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAQvD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAYpD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,CAuBvD;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,UAAQ,GAAG,IAAI,CAYpE"}

package/dist/cli/format.js

@@ -0,0 +1,67 @@
+import pc from "picocolors";
+import { formatBytes } from "../status.js";
+export function printInitResult(root, created) {
+    if (created) {
+        console.log(pc.green("✔") + ` LocalMind initialized in ${pc.bold(root)}`);
+        console.log(`  Config: ${pc.dim(".localmind/config.json")}`);
+        console.log(`  Next:   ${pc.cyan("localmind index")}`);
+    }
+    else {
+        console.log(pc.yellow("⚠") + ` Already initialized: ${root}`);
+        console.log(`  Use ${pc.cyan("--force")} to reinitialize.`);
+    }
+}
+export function printIndexStats(stats) {
+    console.log(pc.green("✔") + " Index complete");
+    console.log(`  Scanned:  ${stats.filesScanned}`);
+    console.log(`  Indexed:  ${stats.filesIndexed}`);
+    console.log(`  Skipped:  ${stats.filesSkipped}`);
+    console.log(`  Removed:  ${stats.filesRemoved}`);
+    console.log(`  Chunks:   ${stats.chunksCreated}`);
+    console.log(`  Duration: ${(stats.durationMs / 1000).toFixed(2)}s`);
+}
+export function printStatus(status) {
+    console.log(pc.bold("LocalMind status"));
+    console.log(`  Root:       ${status.root}`);
+    console.log(`  Provider:   ${status.config.provider}`);
+    console.log(`  Files:      ${status.fileCount}`);
+    console.log(`  Chunks:     ${status.chunkCount}`);
+    console.log(`  Terms:      ${status.termCount}`);
+    console.log(`  Graph edges:${status.edgeCount}`);
+    console.log(`  Embeddings: ${status.embeddingCount}`);
+    console.log(`  DB size:    ${formatBytes(status.dbSizeBytes)}`);
+    console.log(`  Last index: ${status.lastIndexedAt ?? "never"}`);
+    console.log(`  DB path:    ${pc.dim(status.dbPath)}`);
+}
+export function printSearchHits(hits) {
+    if (!hits.length) {
+        console.log(pc.yellow("No results."));
+        return;
+    }
+    for (const hit of hits) {
+        console.log(pc.cyan(`#${hit.rank}`) +
+            ` ${pc.bold(hit.path)}` +
+            pc.dim(`:${hit.startLine}-${hit.endLine}`) +
+            pc.dim(`  score=${hit.score.toFixed(4)}`));
+        const preview = hit.content
+            .split("\n")
+            .slice(0, 6)
+            .map((l) => "    " + l)
+            .join("\n");
+        console.log(pc.dim(preview));
+        if (hit.content.split("\n").length > 6) {
+            console.log(pc.dim("    …"));
+        }
+        console.log();
+    }
+}
+export function printAskResult(result, json = false) {
+    if (json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(result.answer);
+    console.log();
+    console.log(pc.dim(`mode=${result.mode} provider=${result.provider} hits=${result.hits.length} took=${result.tookMs}ms`));
+}
+//# sourceMappingURL=format.js.map

package/dist/cli/format.js.map

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

package/dist/cli/program.d.ts

@@ -0,0 +1,4 @@
+import { Command } from "commander";
+export declare function buildProgram(): Command;
+export declare function runCli(argv?: string[]): Promise<void>;
+//# sourceMappingURL=program.d.ts.map

package/dist/cli/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/cli/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyBpC,wBAAgB,YAAY,IAAI,OAAO,CA6OtC;AAeD,wBAAsB,MAAM,CAAC,IAAI,WAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/D"}