vemora 0.1.0-alpha.8

package/dist/commands/brief.js

@@ -0,0 +1,73 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBrief = runBrief;
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../core/config");
+const knowledge_1 = require("../storage/knowledge");
+const summaries_1 = require("../storage/summaries");
+/**
+ * Prints a compact session primer (~L0 + L1 in mempalace terms):
+ *   - Project overview (from vemora summarize)
+ *   - High-confidence knowledge entries
+ *
+ * Designed to be run at the start of an LLM session to re-establish context
+ * without loading the full index. Optimised for minimal token use.
+ */
+async function runBrief(rootDir, options = {}) {
+    const config = (0, config_1.loadConfig)(rootDir);
+    const summaryStorage = new summaries_1.SummaryStorage(rootDir);
+    const knowledgeStorage = new knowledge_1.KnowledgeStorage(rootDir);
+    const projectSummary = summaryStorage.loadProjectSummary();
+    const allEntries = knowledgeStorage.load();
+    const entries = options.all
+        ? allEntries
+        : allEntries.filter((e) => e.confidence === "high");
+    // ── Header ───────────────────────────────────────────────────────────────────
+    console.log(chalk_1.default.bold(`# ${config.projectName} — session brief`));
+    console.log();
+    // ── L0: Project overview ─────────────────────────────────────────────────────
+    if (projectSummary) {
+        console.log(chalk_1.default.bold("## Overview"));
+        console.log(projectSummary.overview);
+        console.log();
+    }
+    else {
+        console.log(chalk_1.default.gray("No project overview available. Run `vemora summarize` to generate one."));
+        console.log();
+    }
+    // ── L1: High-confidence knowledge ────────────────────────────────────────────
+    if (entries.length > 0) {
+        const label = options.all ? "Knowledge" : "Critical knowledge";
+        console.log(chalk_1.default.bold(`## ${label} (${entries.length})`));
+        console.log();
+        const byCategory = new Map();
+        for (const e of entries) {
+            const list = byCategory.get(e.category) ?? [];
+            list.push(e);
+            byCategory.set(e.category, list);
+        }
+        for (const [cat, catEntries] of byCategory) {
+            console.log(chalk_1.default.underline(cat));
+            for (const e of catEntries) {
+                console.log(`- **${e.title}**`);
+                // Print body but cap at 120 chars to keep the primer tight
+                const body = e.body.length > 120 ? e.body.slice(0, 117) + "…" : e.body;
+                console.log(`  ${chalk_1.default.gray(body)}`);
+            }
+            console.log();
+        }
+    }
+    else {
+        const hint = options.all
+            ? "No knowledge entries found. Use `vemora remember` to add some."
+            : "No high-confidence entries found. Use `vemora knowledge list` to review all entries.";
+        console.log(chalk_1.default.gray(hint));
+        console.log();
+    }
+    // ── Footer hint ──────────────────────────────────────────────────────────────
+    console.log(chalk_1.default.gray(`Tip: run \`vemora knowledge list --root .\` for the full knowledge base.`));
+}
+//# sourceMappingURL=brief.js.map

package/dist/commands/brief.js.map

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

package/dist/commands/chat.d.ts

@@ -0,0 +1,7 @@
+export interface ChatOptions {
+    provider?: string;
+    model?: string;
+    topK?: number;
+}
+export declare function runChat(rootDir: string, options?: ChatOptions): Promise<void>;
+//# sourceMappingURL=chat.d.ts.map

package/dist/commands/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAwLf"}

package/dist/commands/chat.js

@@ -0,0 +1,161 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runChat = runChat;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const readline_1 = __importDefault(require("readline"));
+const config_1 = require("../core/config");
+const factory_1 = require("../embeddings/factory");
+const factory_2 = require("../llm/factory");
+const bm25_1 = require("../search/bm25");
+const formatter_1 = require("../search/formatter");
+const hybrid_1 = require("../search/hybrid");
+const rerank_1 = require("../search/rerank");
+const cache_1 = require("../storage/cache");
+const repository_1 = require("../storage/repository");
+const summaries_1 = require("../storage/summaries");
+async function runChat(rootDir, options = {}) {
+    const config = (0, config_1.loadConfig)(rootDir);
+    const repo = new repository_1.RepositoryStorage(rootDir);
+    const cacheStorage = new cache_1.EmbeddingCacheStorage(config.projectId);
+    const summaryStorage = new summaries_1.SummaryStorage(rootDir);
+    const chunks = repo.loadChunks();
+    const symbols = repo.loadSymbols();
+    const depGraph = repo.loadDeps();
+    const callGraph = repo.loadCallGraph();
+    const fileSummaries = summaryStorage.hasFileSummaries()
+        ? summaryStorage.loadFileSummaries()
+        : {};
+    const projectSummary = summaryStorage.loadProjectSummary();
+    // Use the provider from CLI options, then from config, then default to openai
+    const providerType = (options.provider ||
+        config.summarization?.provider ||
+        "openai");
+    const llmConfig = {
+        ...(config.summarization || {}),
+        provider: providerType,
+        model: config.summarization?.model ?? "gpt-4o-mini",
+    };
+    if (options.model)
+        llmConfig.model = options.model;
+    const llm = (0, factory_2.createLLMProvider)(llmConfig);
+    const history = [];
+    const rl = readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: chalk_1.default.blue.bold("You > "),
+    });
+    console.log(chalk_1.default.bold("\nWelcome to vemora chat!"));
+    console.log(chalk_1.default.gray(`Project: ${config.projectName}`));
+    console.log(chalk_1.default.gray('Type your question about the codebase. Type "exit" or "quit" to stop.\n'));
+    rl.prompt();
+    rl.on("line", async (line) => {
+        const input = line.trim();
+        if (!input) {
+            rl.prompt();
+            return;
+        }
+        if (input.toLowerCase() === "exit" || input.toLowerCase() === "quit") {
+            rl.close();
+            return;
+        }
+        // 1. Search for context based on user input
+        const spinner = (0, ora_1.default)("Searching for context...").start();
+        let contextStr = "";
+        try {
+            let results = [];
+            const useKeyword = config.embedding.provider === "none";
+            if (useKeyword) {
+                results = (0, bm25_1.computeBM25Scores)(input, chunks, symbols, options.topK || 5);
+            }
+            else {
+                const cache = cacheStorage.load();
+                if (cache &&
+                    (cache.chunkIds?.length || Object.keys(cache.embeddings ?? {}).length)) {
+                    const provider = (0, factory_1.createEmbeddingProvider)(config.embedding);
+                    const [queryEmbedding] = await provider.embed([input]);
+                    // Use hybrid search for better quality
+                    results = await (0, hybrid_1.hybridSearch)(input, queryEmbedding, chunks, cache, symbols, {
+                        topK: 25, // Get more for reranking
+                    });
+                    // Always rerank for chat to ensure best quality
+                    results = await (0, rerank_1.rerankResults)(input, results, options.topK || 5);
+                }
+                else {
+                    results = (0, bm25_1.computeBM25Scores)(input, chunks, symbols, options.topK || 5);
+                }
+            }
+            contextStr = (0, formatter_1.formatMarkdown)(input, results, depGraph, fileSummaries, callGraph, {
+                // Pass callGraph here
+                format: "markdown",
+                topK: options.topK || 5,
+            });
+            spinner.succeed("Context found");
+        }
+        catch (err) {
+            spinner.fail(`Context search failed: ${err.message}`);
+        }
+        // 2. Build the prompt
+        // We inject the project summary and the specific relevant code found
+        const systemPrompt = `You are an expert software engineer assistant. 
+You have access to the following project context to help you answer:
+
+${projectSummary ? `PROJECT OVERVIEW:\n${projectSummary.overview}\n\n` : ""}
+RELEVANT CODE CHUNKS:
+${contextStr}
+
+Use this context to provide accurate, specific, and helpful answers about the codebase.
+If the information is not in the context, be honest about it.`;
+        // 3. Prepare message history
+        // For now, we update the system prompt per message to reflect new context
+        // This is a simple implementation; a better one would prune old context
+        const currentMessages = [
+            { role: "system", content: systemPrompt },
+            ...history,
+            { role: "user", content: input },
+        ];
+        // 4. Call LLM
+        const llmSpinner = (0, ora_1.default)("LLM is thinking...").start();
+        try {
+            let fullResponse = "";
+            process.stdout.write(`\n${chalk_1.default.green.bold("AI >")} `);
+            await llm.chat(currentMessages, {
+                model: options.model || config.summarization?.model || "gpt-4o-mini",
+                onToken: (token) => {
+                    if (llmSpinner.isSpinning) {
+                        llmSpinner.stop();
+                    }
+                    process.stdout.write(token);
+                    fullResponse += token;
+                },
+            });
+            if (llmSpinner.isSpinning) {
+                llmSpinner.stop();
+            }
+            console.log("\n");
+            // Update history
+            history.push({ role: "user", content: input });
+            history.push({ role: "assistant", content: fullResponse });
+            // Limit history to last 10 messages to avoid token bloat
+            if (history.length > 10) {
+                history.splice(0, 2);
+            }
+        }
+        catch (err) {
+            if (llmSpinner.isSpinning) {
+                llmSpinner.fail(`LLM call failed: ${err.message}`);
+            }
+            else {
+                console.error(chalk_1.default.red(`\nLLM call failed: ${err.message}`));
+            }
+        }
+        rl.prompt();
+    }).on("close", () => {
+        console.log(chalk_1.default.bold("\nGoodbye!"));
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=chat.js.map

package/dist/commands/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/commands/chat.ts"],"names":[],"mappings":";;;;;AA8BA,0BA2LC;AAzND,kDAA0B;AAC1B,8CAAsB;AACtB,wDAAgC;AAChC,2CAA4C;AAQ5C,mDAAgE;AAEhE,4CAAmD;AAEnD,yCAAmD;AACnD,mDAAqD;AACrD,6CAAgD;AAChD,6CAAiD;AAEjD,4CAAyD;AACzD,sDAA0D;AAC1D,oDAAsD;AAQ/C,KAAK,UAAU,OAAO,CAC3B,OAAe,EACf,UAAuB,EAAE;IAEzB,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,OAAO,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,8BAAiB,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,IAAI,6BAAqB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,cAAc,GAAG,IAAI,0BAAc,CAAC,OAAO,CAAC,CAAC;IAEnD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAoB,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClD,MAAM,SAAS,GAAc,IAAI,CAAC,aAAa,EAAE,CAAC;IAClD,MAAM,aAAa,GAAqB,cAAc,CAAC,gBAAgB,EAAE;QACvE,CAAC,CAAC,cAAc,CAAC,iBAAiB,EAAE;QACpC,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,cAAc,GAAG,cAAc,CAAC,kBAAkB,EAAE,CAAC;IAE3D,8EAA8E;IAC9E,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,QAAQ;QACpC,MAAM,CAAC,aAAa,EAAE,QAAQ;QAC9B,QAAQ,CAAoC,CAAC;IAC/C,MAAM,SAAS,GAAwB;QACrC,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC;QAC/B,QAAQ,EAAE,YAAY;QACtB,KAAK,EAAE,MAAM,CAAC,aAAa,EAAE,KAAK,IAAI,aAAa;KACpD,CAAC;IACF,IAAI,OAAO,CAAC,KAAK;QAAE,SAAS,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAEnD,MAAM,GAAG,GAAG,IAAA,2BAAiB,EAAC,SAAS,CAAC,CAAC;IACzC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,MAAM,EAAE,GAAG,kBAAQ,CAAC,eAAe,CAAC;QAClC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;KAClC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CACR,yEAAyE,CAC1E,CACF,CAAC;IAEF,EAAE,CAAC,MAAM,EAAE,CAAC;IAEZ,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,EAAE,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;YACrE,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QAED,4CAA4C;QAC5C,MAAM,OAAO,GAAG,IAAA,aAAG,EAAC,0BAA0B,CAAC,CAAC,KAAK,EAAE,CAAC;QACxD,IAAI,UAAU,GAAG,EAAE,CAAC;QAEpB,IAAI,CAAC;YACH,IAAI,OAAO,GAAmB,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,KAAK,MAAM,CAAC;YAExD,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,GAAG,IAAA,wBAAiB,EAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;YACzE,CAAC;iBAAM,CAAC;gBACN,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;gBAClC,IACE,KAAK;oBACL,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EACtE,CAAC;oBACD,MAAM,QAAQ,GAAG,IAAA,iCAAuB,EAAC,MAAM,CAAC,SAAS,CAAC,CAAC;oBAC3D,MAAM,CAAC,cAAc,CAAC,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;oBAEvD,uCAAuC;oBACvC,OAAO,GAAG,MAAM,IAAA,qBAAY,EAC1B,KAAK,EACL,cAAc,EACd,MAAM,EACN,KAAK,EACL,OAAO,EACP;wBACE,IAAI,EAAE,EAAE,EAAE,yBAAyB;qBACpC,CACF,CAAC;oBAEF,gDAAgD;oBAChD,OAAO,GAAG,MAAM,IAAA,sBAAa,EAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;gBACnE,CAAC;qBAAM,CAAC;oBACN,OAAO,GAAG,IAAA,wBAAiB,EACzB,KAAK,EACL,MAAM,EACN,OAAO,EACP,OAAO,CAAC,IAAI,IAAI,CAAC,CAClB,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,UAAU,GAAG,IAAA,0BAAc,EACzB,KAAK,EACL,OAAO,EACP,QAAQ,EACR,aAAa,EACb,SAAS,EACT;gBACE,sBAAsB;gBACtB,MAAM,EAAE,UAAU;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;aACxB,CACF,CAAC;YAEF,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,0BAA2B,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,sBAAsB;QACtB,qEAAqE;QACrE,MAAM,YAAY,GAAG;;;EAGvB,cAAc,CAAC,CAAC,CAAC,sBAAsB,cAAc,CAAC,QAAQ,MAAM,CAAC,CAAC,CAAC,EAAE;;EAEzE,UAAU;;;8DAGkD,CAAC;QAE3D,6BAA6B;QAC7B,0EAA0E;QAC1E,wEAAwE;QACxE,MAAM,eAAe,GAAkB;YACrC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE;YACzC,GAAG,OAAO;YACV,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;SACjC,CAAC;QAEF,cAAc;QACd,MAAM,UAAU,GAAG,IAAA,aAAG,EAAC,oBAAoB,CAAC,CAAC,KAAK,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,IAAI,YAAY,GAAG,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,eAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAEvD,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE;gBAC9B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,aAAa,EAAE,KAAK,IAAI,aAAa;gBACpE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;oBACjB,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;wBAC1B,UAAU,CAAC,IAAI,EAAE,CAAC;oBACpB,CAAC;oBACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBAC5B,YAAY,IAAI,KAAK,CAAC;gBACxB,CAAC;aACF,CAAC,CAAC;YAEH,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;gBAC1B,UAAU,CAAC,IAAI,EAAE,CAAC;YACpB,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAElB,iBAAiB;YACjB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;YAE3D,yDAAyD;YACzD,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;gBACxB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;gBAC1B,UAAU,CAAC,IAAI,CAAC,oBAAqB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAChE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CACX,eAAK,CAAC,GAAG,CAAC,sBAAuB,GAAa,CAAC,OAAO,EAAE,CAAC,CAC1D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,EAAE,CAAC,MAAM,EAAE,CAAC;IACd,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QAClB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/context.d.ts

@@ -0,0 +1,61 @@
+import type { CallGraph, Chunk, DependencyGraph, FileSummaryIndex, KnowledgeEntry, SearchResult } from "../core/types";
+export interface ContextOptions {
+    /** A natural-language query describing the task */
+    query?: string;
+    /** A specific file to include in full context */
+    file?: string;
+    /** Number of search results to pull in (default: 5) */
+    topK?: number;
+    /** Force keyword search */
+    keyword?: boolean;
+    /** Output format: markdown (default), plain, or terse (ultra-compact for small models) */
+    format?: "markdown" | "plain" | "terse";
+    /** Show full code (no line cap) */
+    showCode?: boolean;
+    /** Use cross-encoder reranking */
+    rerank?: boolean;
+    /** Use hybrid search (vector + BM25) */
+    hybrid?: boolean;
+    /** Hybrid weight for vector search (0-1) */
+    alpha?: number;
+    /**
+     * Maximum tokens to include across all retrieved chunks.
+     * Applied after retrieval and reranking. The first result is always kept.
+     */
+    budget?: number;
+    /** Apply Maximal Marginal Relevance reranking to reduce redundant results */
+    mmr?: boolean;
+    /** MMR diversity weight: 0=max diversity, 1=pure relevance (default: 0.5) */
+    lambda?: number;
+    /** Merge adjacent or overlapping chunks from the same file */
+    merge?: boolean;
+    /** Max line gap between chunks to still merge them (default: 3) */
+    mergeGap?: number;
+    /**
+     * Emit a structured context block organised by semantic role:
+     * Entry Point → Direct Dependencies → Called By → Types & Interfaces → Related Patterns.
+     * Reduces token usage and improves LLM comprehension compared to a flat ranked list.
+     */
+    structured?: boolean;
+    /** Filter out chunks already seen in the current session */
+    session?: boolean;
+    /** Reset the session before this query (implies session tracking) */
+    fresh?: boolean;
+}
+export declare function runContext(rootDir: string, options?: ContextOptions): Promise<void>;
+/**
+ * Procedural function to build the actual context string.
+ * This is separated from runContext to allow for benchmarking and testing.
+ *
+ * When `options.structured` is true and results are available, delegates to
+ * `generateStructuredContextString` which organises output by semantic role
+ * (Entry Point → Direct Dependencies → Called By → Types & Interfaces → Related Patterns)
+ * instead of a flat ranked list.
+ *
+ * @param allChunks - Full chunk corpus, required for structured mode dep resolution.
+ *                    Optional for backward compatibility with bench.ts.
+ */
+export declare function generateContextString(config: {
+    projectName: string;
+}, results: SearchResult[], depGraph: DependencyGraph, callGraph: CallGraph, fileSummaries: FileSummaryIndex, projectOverview: string | null, options: ContextOptions, rootDir: string, allChunks?: Chunk[], knowledgeEntries?: KnowledgeEntry[]): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/commands/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/commands/context.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,SAAS,EACT,KAAK,EACL,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,YAAY,EACb,MAAM,eAAe,CAAC;AAsBvB,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IACxC,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAID,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAwMf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,EAC/B,OAAO,EAAE,YAAY,EAAE,EACvB,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,gBAAgB,EAC/B,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,KAAK,EAAO,EACvB,gBAAgB,GAAE,cAAc,EAAO,GACtC,MAAM,CA6VR"}