codesift-mcp 0.1.0

package/dist/storage/usage-tracker.d.ts

@@ -0,0 +1,35 @@
+export interface UsageEntry {
+    ts: number;
+    tool: string;
+    repo: string;
+    args_summary: Record<string, unknown>;
+    elapsed_ms: number;
+    result_tokens: number;
+    result_chunks: number;
+    session_id: string;
+}
+/**
+ * Build a lightweight args summary for a given tool call.
+ * Extracts only the small, useful fields — never full source or query results.
+ */
+export declare function buildArgsSummary(tool: string, args: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Estimate the number of discrete result items (chunks, symbols, files, etc.)
+ * from the tool result object.
+ */
+export declare function extractResultChunks(data: unknown): number;
+/**
+ * Log a usage entry to ~/.codesift/usage.jsonl.
+ * Non-blocking: errors are silently caught and logged to stderr.
+ */
+export declare function trackUsage(entry: UsageEntry): Promise<void>;
+/**
+ * High-level helper: track a completed tool call.
+ * Called at the end of each tool handler after the result is computed.
+ */
+export declare function trackToolCall(tool: string, args: Record<string, unknown>, resultText: string, resultData: unknown, elapsedMs: number): void;
+/**
+ * Get the current session ID (for testing or display).
+ */
+export declare function getSessionId(): string;
+//# sourceMappingURL=usage-tracker.d.ts.map

package/dist/storage/usage-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-tracker.d.ts","sourceRoot":"","sources":["../../src/storage/usage-tracker.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAeD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiIzB;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAqBzD;AAQD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,MAAM,GAChB,IAAI,CAcN;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/storage/usage-tracker.js

@@ -0,0 +1,245 @@
+import { appendFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { randomUUID } from "node:crypto";
+// ---------------------------------------------------------------------------
+// Session ID — unique per process lifetime
+// ---------------------------------------------------------------------------
+const SESSION_ID = randomUUID();
+// ---------------------------------------------------------------------------
+// Path
+// ---------------------------------------------------------------------------
+function getUsagePath() {
+    const dataDir = process.env["CODESIFT_DATA_DIR"] ?? join(homedir(), ".codesift");
+    return join(dataDir, "usage.jsonl");
+}
+// ---------------------------------------------------------------------------
+// Args summary builders — lightweight, never includes large content
+// ---------------------------------------------------------------------------
+/**
+ * Build a lightweight args summary for a given tool call.
+ * Extracts only the small, useful fields — never full source or query results.
+ */
+export function buildArgsSummary(tool, args) {
+    const summary = {};
+    // Common fields — always include if present
+    if (typeof args["query"] === "string") {
+        summary["query"] = args["query"].slice(0, 200);
+    }
+    if (typeof args["repo"] === "string") {
+        summary["repo"] = args["repo"];
+    }
+    switch (tool) {
+        case "codebase_retrieval": {
+            const queries = args["queries"];
+            if (Array.isArray(queries)) {
+                summary["query_count"] = queries.length;
+                summary["query_types"] = queries.map((q) => (typeof q === "object" && q !== null ? q["type"] : "unknown"));
+            }
+            if (typeof args["token_budget"] === "number") {
+                summary["token_budget"] = args["token_budget"];
+            }
+            break;
+        }
+        case "search_symbols": {
+            if (typeof args["kind"] === "string")
+                summary["kind"] = args["kind"];
+            if (typeof args["top_k"] === "number")
+                summary["top_k"] = args["top_k"];
+            if (typeof args["file_pattern"] === "string")
+                summary["file_pattern"] = args["file_pattern"];
+            if (typeof args["include_source"] === "boolean")
+                summary["include_source"] = args["include_source"];
+            break;
+        }
+        case "search_text": {
+            if (typeof args["regex"] === "boolean")
+                summary["regex"] = args["regex"];
+            if (typeof args["context_lines"] === "number")
+                summary["context_lines"] = args["context_lines"];
+            if (typeof args["file_pattern"] === "string")
+                summary["file_pattern"] = args["file_pattern"];
+            if (typeof args["max_results"] === "number")
+                summary["max_results"] = args["max_results"];
+            break;
+        }
+        case "get_file_tree": {
+            if (typeof args["path_prefix"] === "string")
+                summary["path_prefix"] = args["path_prefix"];
+            if (typeof args["name_pattern"] === "string")
+                summary["name_pattern"] = args["name_pattern"];
+            if (typeof args["depth"] === "number")
+                summary["depth"] = args["depth"];
+            break;
+        }
+        case "get_file_outline": {
+            if (typeof args["file_path"] === "string")
+                summary["file_path"] = args["file_path"];
+            break;
+        }
+        case "get_symbol": {
+            if (typeof args["symbol_id"] === "string")
+                summary["symbol_id"] = args["symbol_id"];
+            break;
+        }
+        case "get_symbols": {
+            const ids = args["symbol_ids"];
+            if (Array.isArray(ids))
+                summary["symbol_count"] = ids.length;
+            break;
+        }
+        case "find_and_show": {
+            if (typeof args["include_refs"] === "boolean")
+                summary["include_refs"] = args["include_refs"];
+            break;
+        }
+        case "find_references": {
+            if (typeof args["symbol_name"] === "string")
+                summary["symbol_name"] = args["symbol_name"];
+            if (typeof args["file_pattern"] === "string")
+                summary["file_pattern"] = args["file_pattern"];
+            break;
+        }
+        case "trace_call_chain": {
+            if (typeof args["symbol_name"] === "string")
+                summary["symbol_name"] = args["symbol_name"];
+            if (typeof args["direction"] === "string")
+                summary["direction"] = args["direction"];
+            if (typeof args["depth"] === "number")
+                summary["depth"] = args["depth"];
+            break;
+        }
+        case "impact_analysis": {
+            if (typeof args["since"] === "string")
+                summary["since"] = args["since"];
+            if (typeof args["until"] === "string")
+                summary["until"] = args["until"];
+            if (typeof args["depth"] === "number")
+                summary["depth"] = args["depth"];
+            break;
+        }
+        case "assemble_context": {
+            if (typeof args["token_budget"] === "number")
+                summary["token_budget"] = args["token_budget"];
+            break;
+        }
+        case "get_knowledge_map": {
+            if (typeof args["focus"] === "string")
+                summary["focus"] = args["focus"];
+            if (typeof args["depth"] === "number")
+                summary["depth"] = args["depth"];
+            break;
+        }
+        case "diff_outline":
+        case "changed_symbols": {
+            if (typeof args["since"] === "string")
+                summary["since"] = args["since"];
+            if (typeof args["until"] === "string")
+                summary["until"] = args["until"];
+            break;
+        }
+        case "index_folder": {
+            if (typeof args["path"] === "string")
+                summary["path"] = args["path"];
+            if (typeof args["incremental"] === "boolean")
+                summary["incremental"] = args["incremental"];
+            break;
+        }
+        case "index_repo": {
+            if (typeof args["url"] === "string")
+                summary["url"] = args["url"];
+            if (typeof args["branch"] === "string")
+                summary["branch"] = args["branch"];
+            break;
+        }
+        case "generate_claude_md": {
+            if (typeof args["output_path"] === "string")
+                summary["output_path"] = args["output_path"];
+            break;
+        }
+        // list_repos, invalidate_cache, get_repo_outline, usage_stats — no extra args needed
+    }
+    return summary;
+}
+// ---------------------------------------------------------------------------
+// Result metrics extraction
+// ---------------------------------------------------------------------------
+/**
+ * Estimate the number of discrete result items (chunks, symbols, files, etc.)
+ * from the tool result object.
+ */
+export function extractResultChunks(data) {
+    if (Array.isArray(data))
+        return data.length;
+    if (typeof data === "object" && data !== null) {
+        const obj = data;
+        // codebase_retrieval → results array
+        if (Array.isArray(obj["results"]))
+            return obj["results"].length;
+        // various tools returning arrays under common keys
+        if (Array.isArray(obj["symbols"]))
+            return obj["symbols"].length;
+        if (Array.isArray(obj["files"]))
+            return obj["files"].length;
+        if (Array.isArray(obj["matches"]))
+            return obj["matches"].length;
+        if (Array.isArray(obj["references"]))
+            return obj["references"].length;
+        if (Array.isArray(obj["repos"]))
+            return obj["repos"].length;
+        // single item results
+        if (typeof obj["id"] === "string")
+            return 1;
+    }
+    return 0;
+}
+// ---------------------------------------------------------------------------
+// Core tracking function
+// ---------------------------------------------------------------------------
+let dirEnsured = false;
+/**
+ * Log a usage entry to ~/.codesift/usage.jsonl.
+ * Non-blocking: errors are silently caught and logged to stderr.
+ */
+export async function trackUsage(entry) {
+    try {
+        const usagePath = getUsagePath();
+        if (!dirEnsured) {
+            const dataDir = process.env["CODESIFT_DATA_DIR"] ?? join(homedir(), ".codesift");
+            await mkdir(dataDir, { recursive: true });
+            dirEnsured = true;
+        }
+        const line = JSON.stringify(entry) + "\n";
+        await appendFile(usagePath, line, "utf-8");
+    }
+    catch (err) {
+        // Never throw — tracking is best-effort
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`[usage-tracker] Failed to log usage: ${message}`);
+    }
+}
+/**
+ * High-level helper: track a completed tool call.
+ * Called at the end of each tool handler after the result is computed.
+ */
+export function trackToolCall(tool, args, resultText, resultData, elapsedMs) {
+    const entry = {
+        ts: Date.now(),
+        tool,
+        repo: typeof args["repo"] === "string" ? args["repo"] : "",
+        args_summary: buildArgsSummary(tool, args),
+        elapsed_ms: Math.round(elapsedMs),
+        result_tokens: Math.ceil(resultText.length / 4),
+        result_chunks: extractResultChunks(resultData),
+        session_id: SESSION_ID,
+    };
+    // Fire and forget — never block the tool response
+    trackUsage(entry).catch(() => { });
+}
+/**
+ * Get the current session ID (for testing or display).
+ */
+export function getSessionId() {
+    return SESSION_ID;
+}
+//# sourceMappingURL=usage-tracker.js.map

package/dist/storage/usage-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-tracker.js","sourceRoot":"","sources":["../../src/storage/usage-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,8EAA8E;AAC9E,2CAA2C;AAC3C,8EAA8E;AAE9E,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC;AAiBhC,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E,SAAS,YAAY;IACnB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;IACjF,OAAO,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AACtC,CAAC;AAED,8EAA8E;AAC9E,oEAAoE;AACpE,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,IAA6B;IAE7B,MAAM,OAAO,GAA4B,EAAE,CAAC;IAE5C,4CAA4C;IAC5C,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;YAChC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;gBACxC,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,GAAG,CAClC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAE,CAA6B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAC3G,CAAC;YACJ,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC7C,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;YACjD,CAAC;YACD,MAAM;QACR,CAAC;QAED,KAAK,gBAAgB,CAAC,CAAC,CAAC;YACtB,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YACrE,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxE,IAAI,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;YAC7F,IAAI,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,SAAS;gBAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACpG,MAAM;QACR,CAAC;QAED,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS;gBAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACzE,IAAI,OAAO,IAAI,CAAC,eAAe,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;YAChG,IAAI,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;YAC7F,IAAI,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1F,MAAM;QACR,CAAC;QAED,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,IAAI,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1F,IAAI,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;YAC7F,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxE,MAAM;QACR,CAAC;QAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,IAAI,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;YACpF,MAAM;QACR,CAAC;QAED,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,IAAI,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;YACpF,MAAM;QACR,CAAC;QAED,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;YAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;gBAAE,OAAO,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;YAC7D,MAAM;QACR,CAAC;QAED,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,IAAI,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,SAAS;gBAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;YAC9F,MAAM;QACR,CAAC;QAED,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,IAAI,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1F,IAAI,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;YAC7F,MAAM;QACR,CAAC;QAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,IAAI,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1F,IAAI,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;YACpF,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxE,MAAM;QACR,CAAC;QAED,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxE,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxE,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxE,MAAM;QACR,CAAC;QAED,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,IAAI,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;YAC7F,MAAM;QACR,CAAC;QAED,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxE,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxE,MAAM;QACR,CAAC;QAED,KAAK,cAAc,CAAC;QACpB,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxE,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;YACxE,MAAM;QACR,CAAC;QAED,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YACrE,IAAI,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,SAAS;gBAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;YAC3F,MAAM;QACR,CAAC;QAED,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;YAClE,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC3E,MAAM;QACR,CAAC;QAED,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,IAAI,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1F,MAAM;QACR,CAAC;QAED,qFAAqF;IACvF,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC;IAE5C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,IAA+B,CAAC;QAE5C,qCAAqC;QACrC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;QAEhE,mDAAmD;QACnD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;QAChE,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;QAChE,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC;QACtE,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAE5D,sBAAsB;QACtB,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAiB;IAChD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QAEjC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;YACjF,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1C,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;QAC1C,MAAM,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,wCAAwC;QACxC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,wCAAwC,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,IAA6B,EAC7B,UAAkB,EAClB,UAAmB,EACnB,SAAiB;IAEjB,MAAM,KAAK,GAAe;QACxB,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;QACd,IAAI;QACJ,IAAI,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;QAC1D,YAAY,EAAE,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC;QAC1C,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;QACjC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/C,aAAa,EAAE,mBAAmB,CAAC,UAAU,CAAC;QAC9C,UAAU,EAAE,UAAU;KACvB,CAAC;IAEF,kDAAkD;IAClD,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/storage/watcher.d.ts

@@ -0,0 +1,12 @@
+import { type FSWatcher } from "chokidar";
+export type { FSWatcher };
+/**
+ * Start watching a repo root for file changes.
+ * Calls onChange with the relative file path, debounced per file at 500ms.
+ */
+export declare function startWatcher(repoRoot: string, onChange: (filePath: string) => void): FSWatcher;
+/**
+ * Stop a file watcher and clean up all debounce timers.
+ */
+export declare function stopWatcher(watcher: FSWatcher): Promise<void>;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/storage/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/storage/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAGjD,YAAY,EAAE,SAAS,EAAE,CAAC;AAqB1B;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GACnC,SAAS,CAmCX;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAWnE"}

package/dist/storage/watcher.js

@@ -0,0 +1,66 @@
+import { watch } from "chokidar";
+import { relative } from "node:path";
+const IGNORE_PATTERNS = [
+    "**/node_modules/**",
+    "**/.git/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/coverage/**",
+    "**/.codesift/**",
+    "**/.next/**",
+    "**/__pycache__/**",
+    "**/.pytest_cache/**",
+    "**/generated/**",
+    "**/audit-results/**",
+    "**/.backup/**",
+    "**/jscpd-report/**",
+];
+// WeakMap to track debounce timers per watcher for cleanup
+const watcherTimers = new WeakMap();
+/**
+ * Start watching a repo root for file changes.
+ * Calls onChange with the relative file path, debounced per file at 500ms.
+ */
+export function startWatcher(repoRoot, onChange) {
+    const debounceTimers = new Map();
+    const debouncedOnChange = (absolutePath) => {
+        const relativePath = relative(repoRoot, absolutePath);
+        const existing = debounceTimers.get(relativePath);
+        if (existing !== undefined) {
+            clearTimeout(existing);
+        }
+        const timer = setTimeout(() => {
+            debounceTimers.delete(relativePath);
+            onChange(relativePath);
+        }, 500);
+        debounceTimers.set(relativePath, timer);
+    };
+    const watcher = watch(repoRoot, {
+        ignored: IGNORE_PATTERNS,
+        persistent: true,
+        ignoreInitial: true,
+        awaitWriteFinish: {
+            stabilityThreshold: 200,
+            pollInterval: 50,
+        },
+    });
+    watcher.on("add", debouncedOnChange);
+    watcher.on("change", debouncedOnChange);
+    watcherTimers.set(watcher, debounceTimers);
+    return watcher;
+}
+/**
+ * Stop a file watcher and clean up all debounce timers.
+ */
+export async function stopWatcher(watcher) {
+    const timers = watcherTimers.get(watcher);
+    if (timers) {
+        for (const timer of timers.values()) {
+            clearTimeout(timer);
+        }
+        timers.clear();
+        watcherTimers.delete(watcher);
+    }
+    await watcher.close();
+}
+//# sourceMappingURL=watcher.js.map

package/dist/storage/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/storage/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAkB,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAIrC,MAAM,eAAe,GAAG;IACtB,oBAAoB;IACpB,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,gBAAgB;IAChB,iBAAiB;IACjB,aAAa;IACb,mBAAmB;IACnB,qBAAqB;IACrB,iBAAiB;IACjB,qBAAqB;IACrB,eAAe;IACf,oBAAoB;CACrB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,aAAa,GAAG,IAAI,OAAO,EAAyD,CAAC;AAE3F;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,QAAoC;IAEpC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAyC,CAAC;IAExE,MAAM,iBAAiB,GAAG,CAAC,YAAoB,EAAQ,EAAE;QACvD,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAEtD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAClD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,YAAY,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YACpC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACzB,CAAC,EAAE,GAAG,CAAC,CAAC;QAER,cAAc,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE;QAC9B,OAAO,EAAE,eAAe;QACxB,UAAU,EAAE,IAAI;QAChB,aAAa,EAAE,IAAI;QACnB,gBAAgB,EAAE;YAChB,kBAAkB,EAAE,GAAG;YACvB,YAAY,EAAE,EAAE;SACjB;KACF,CAAC,CAAC;IAEH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAExC,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAE3C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAkB;IAClD,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACpC,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;AACxB,CAAC"}

package/dist/tools/context-tools.d.ts

@@ -0,0 +1,31 @@
+import type { CodeSymbol } from "../types.js";
+export interface AssembleContextResult {
+    symbols: CodeSymbol[];
+    total_tokens: number;
+    truncated: boolean;
+}
+export interface KnowledgeMapModule {
+    path: string;
+    symbol_count: number;
+}
+export interface KnowledgeMapEdge {
+    from: string;
+    to: string;
+}
+export interface KnowledgeMap {
+    modules: KnowledgeMapModule[];
+    edges: KnowledgeMapEdge[];
+}
+/**
+ * Assemble a context window of relevant code for a query.
+ * Uses BM25 search to find the most relevant symbols and accumulates
+ * them until the token budget is reached.
+ */
+export declare function assembleContext(repo: string, query: string, tokenBudget?: number): Promise<AssembleContextResult>;
+/**
+ * Build a module dependency map for a repository.
+ * Parses import statements from each file's symbols to discover edges.
+ * Optionally filters to modules matching a focus path.
+ */
+export declare function getKnowledgeMap(repo: string, focus?: string, depth?: number): Promise<KnowledgeMap>;
+//# sourceMappingURL=context-tools.d.ts.map

package/dist/tools/context-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-tools.d.ts","sourceRoot":"","sources":["../../src/tools/context-tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,aAAa,CAAC;AAEzD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAUD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,qBAAqB,CAAC,CA8BhC;AA8DD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,CAAC,CA8BvB"}

package/dist/tools/context-tools.js

@@ -0,0 +1,219 @@
+import { getBM25Index, getCodeIndex } from "./index-tools.js";
+import { searchBM25 } from "../search/bm25.js";
+import { loadConfig } from "../config.js";
+/**
+ * Estimate token count from source text.
+ * Rough heuristic: ~4 characters per token.
+ */
+function estimateTokens(source) {
+    return Math.ceil(source.length / 4);
+}
+/**
+ * Assemble a context window of relevant code for a query.
+ * Uses BM25 search to find the most relevant symbols and accumulates
+ * them until the token budget is reached.
+ */
+export async function assembleContext(repo, query, tokenBudget) {
+    const bm25Index = await getBM25Index(repo);
+    if (!bm25Index) {
+        throw new Error(`Repository not found: ${repo}`);
+    }
+    const config = loadConfig();
+    const budget = tokenBudget ?? config.defaultTokenBudget;
+    const topK = 20;
+    const results = searchBM25(bm25Index, query, topK, config.bm25FieldWeights);
+    const symbols = [];
+    let totalTokens = 0;
+    let truncated = false;
+    for (const result of results) {
+        const source = result.symbol.source ?? "";
+        const tokens = estimateTokens(source);
+        if (totalTokens + tokens > budget) {
+            truncated = true;
+            break;
+        }
+        symbols.push(result.symbol);
+        totalTokens += tokens;
+    }
+    return { symbols, total_tokens: totalTokens, truncated };
+}
+// Patterns for detecting import statements across common languages
+const IMPORT_PATTERNS = [
+    // ES modules: import ... from '...' or import ... from "..."
+    /import\s+.*?\s+from\s+['"]([^'"]+)['"]/g,
+    // Dynamic import: import('...')
+    /import\s*\(\s*['"]([^'"]+)['"]\s*\)/g,
+    // CommonJS: require('...')
+    /require\s*\(\s*['"]([^'"]+)['"]\s*\)/g,
+];
+/**
+ * Extract import paths from a source string.
+ * Returns relative paths only (skips node_modules / bare specifiers).
+ */
+function extractImports(source) {
+    const imports = new Set();
+    for (const pattern of IMPORT_PATTERNS) {
+        // Reset lastIndex for global regex
+        pattern.lastIndex = 0;
+        let match;
+        while ((match = pattern.exec(source)) !== null) {
+            const importPath = match[1];
+            if (importPath && importPath.startsWith(".")) {
+                imports.add(importPath);
+            }
+        }
+    }
+    return [...imports];
+}
+/**
+ * Normalize an import path relative to the importing file.
+ * Resolves "./foo" and "../bar" relative to the importer's directory.
+ */
+function resolveImportPath(importerFile, importPath) {
+    const importerDir = importerFile.includes("/")
+        ? importerFile.slice(0, importerFile.lastIndexOf("/"))
+        : ".";
+    const parts = importerDir.split("/");
+    for (const segment of importPath.split("/")) {
+        if (segment === ".")
+            continue;
+        if (segment === "..") {
+            parts.pop();
+        }
+        else {
+            parts.push(segment);
+        }
+    }
+    let resolved = parts.join("/");
+    // Strip file extension for matching (imports often omit .ts/.js)
+    resolved = resolved.replace(/\.(ts|tsx|js|jsx|mjs|cjs)$/, "");
+    return resolved;
+}
+/**
+ * Build a module dependency map for a repository.
+ * Parses import statements from each file's symbols to discover edges.
+ * Optionally filters to modules matching a focus path.
+ */
+export async function getKnowledgeMap(repo, focus, depth) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository not found: ${repo}`);
+    }
+    const maxDepth = depth ?? 3;
+    // Build module list from files
+    const moduleMap = new Map();
+    for (const file of index.files) {
+        moduleMap.set(file.path, {
+            path: file.path,
+            symbol_count: file.symbol_count,
+        });
+    }
+    // Collect all import edges by scanning symbol source
+    const edges = collectEdges(index, moduleMap);
+    // If no focus, return the full graph (limited by depth from roots)
+    if (!focus) {
+        return {
+            modules: [...moduleMap.values()],
+            edges,
+        };
+    }
+    // Filter to focus path and neighbors within depth
+    return filterToFocus(moduleMap, edges, focus, maxDepth);
+}
+/**
+ * Scan all symbols to collect import edges between modules.
+ */
+function collectEdges(index, moduleMap) {
+    const edgeSet = new Set();
+    const edges = [];
+    // Build a set of normalized module paths for matching
+    const normalizedPaths = new Map();
+    for (const file of index.files) {
+        const normalized = file.path.replace(/\.(ts|tsx|js|jsx|mjs|cjs)$/, "");
+        normalizedPaths.set(normalized, file.path);
+        // Also handle index files: "foo/index" -> "foo"
+        if (normalized.endsWith("/index")) {
+            normalizedPaths.set(normalized.slice(0, -6), file.path);
+        }
+    }
+    for (const sym of index.symbols) {
+        if (!sym.source)
+            continue;
+        const importPaths = extractImports(sym.source);
+        for (const importPath of importPaths) {
+            const resolved = resolveImportPath(sym.file, importPath);
+            const targetFile = normalizedPaths.get(resolved);
+            if (!targetFile || targetFile === sym.file)
+                continue;
+            const edgeKey = `${sym.file}->${targetFile}`;
+            if (edgeSet.has(edgeKey))
+                continue;
+            edgeSet.add(edgeKey);
+            // Ensure both modules exist in the map
+            if (moduleMap.has(sym.file) && moduleMap.has(targetFile)) {
+                edges.push({ from: sym.file, to: targetFile });
+            }
+        }
+    }
+    return edges;
+}
+/**
+ * Filter the graph to only modules matching the focus path
+ * and their neighbors up to maxDepth hops.
+ */
+function filterToFocus(moduleMap, edges, focus, maxDepth) {
+    // Build adjacency lists (bidirectional for neighbor traversal)
+    const adjacency = new Map();
+    for (const edge of edges) {
+        let fromSet = adjacency.get(edge.from);
+        if (!fromSet) {
+            fromSet = new Set();
+            adjacency.set(edge.from, fromSet);
+        }
+        fromSet.add(edge.to);
+        let toSet = adjacency.get(edge.to);
+        if (!toSet) {
+            toSet = new Set();
+            adjacency.set(edge.to, toSet);
+        }
+        toSet.add(edge.from);
+    }
+    // Find seed modules matching the focus path
+    const seeds = new Set();
+    for (const [path] of moduleMap) {
+        if (path.includes(focus)) {
+            seeds.add(path);
+        }
+    }
+    // BFS from seeds up to maxDepth
+    const reachable = new Set(seeds);
+    let frontier = [...seeds];
+    for (let d = 0; d < maxDepth; d++) {
+        const nextFrontier = [];
+        for (const node of frontier) {
+            const neighbors = adjacency.get(node);
+            if (!neighbors)
+                continue;
+            for (const neighbor of neighbors) {
+                if (!reachable.has(neighbor)) {
+                    reachable.add(neighbor);
+                    nextFrontier.push(neighbor);
+                }
+            }
+        }
+        if (nextFrontier.length === 0)
+            break;
+        frontier = nextFrontier;
+    }
+    // Filter modules and edges to reachable set
+    const filteredModules = [];
+    for (const path of reachable) {
+        const mod = moduleMap.get(path);
+        if (mod) {
+            filteredModules.push(mod);
+        }
+    }
+    const filteredEdges = edges.filter((e) => reachable.has(e.from) && reachable.has(e.to));
+    return { modules: filteredModules, edges: filteredEdges };
+}
+//# sourceMappingURL=context-tools.js.map

package/dist/tools/context-tools.js.map

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