@bugsbunnycodes1998/cartographer-core 0.1.0

package/dist/analysis/semantic/prompts.js

@@ -0,0 +1,134 @@
+/**
+ * Prompt template functions for hierarchical LLM summarization.
+ *
+ * Each function returns a { system, user } pair suitable for passing to
+ * OpenAIClient.completeJSON(). All prompts request JSON output with a strict schema.
+ */
+const MAX_CONTENT_LINES = 500;
+/**
+ * Truncate source content to a maximum number of lines, appending a marker if truncated.
+ */
+function truncateContent(content, maxLines = MAX_CONTENT_LINES) {
+    const lines = content.split("\n");
+    if (lines.length <= maxLines) {
+        return content;
+    }
+    return lines.slice(0, maxLines).join("\n") + `\n[... ${lines.length - maxLines} more lines]`;
+}
+export function fileSummaryPrompt(filePath, content, functionSummaries, imports, exports) {
+    const truncated = truncateContent(content);
+    const system = `You are a code analyst. Respond with JSON only.
+You analyze source code files and produce structured summaries.
+Your response MUST be a valid JSON object with exactly this schema:
+{
+  "role": "<one sentence describing what this file does>",
+  "responsibilities": ["<responsibility 1>", "<responsibility 2>", ...],
+  "layer": "<one of: api, middleware, business_logic, data_access, utility, configuration, presentation, infrastructure, testing>",
+  "importance_score": <number 1-10>,
+  "tags": ["<tag1>", "<tag2>", ...]
+}`;
+    const functionSection = functionSummaries.length > 0
+        ? `\nKey functions:\n${functionSummaries.map((f) => `- ${f}`).join("\n")}`
+        : "";
+    const importSection = imports.length > 0 ? `\nImports:\n${imports.map((i) => `- ${i}`).join("\n")}` : "";
+    const exportSection = exports.length > 0 ? `\nExports:\n${exports.map((e) => `- ${e}`).join("\n")}` : "";
+    const user = `Analyze this source file and produce a structured summary.
+
+File: ${filePath}
+${importSection}
+${exportSection}
+${functionSection}
+
+Source code:
+\`\`\`
+${truncated}
+\`\`\``;
+    return { system, user };
+}
+export function moduleSummaryPrompt(moduleName, fileSummaries, dependencies) {
+    const system = `You are a software architect. Respond with JSON only.
+You analyze modules (groups of related files) and produce structured summaries.
+Your response MUST be a valid JSON object with exactly this schema:
+{
+  "purpose": "<one sentence describing the module's purpose>",
+  "pattern": "<architectural pattern used, e.g. MVC controller layer, service layer, utility library>",
+  "responsibilities": ["<responsibility 1>", "<responsibility 2>", ...],
+  "risks": ["<risk 1>", "<risk 2>", ...],
+  "layer": "<one of: api, middleware, business_logic, data_access, utility, configuration, presentation, infrastructure, testing>"
+}`;
+    const filesSection = fileSummaries.map((f) => `- ${f.path}: ${f.role}`).join("\n");
+    const depsSection = dependencies.length > 0
+        ? `\nDependencies (modules this module imports from):\n${dependencies.map((d) => `- ${d}`).join("\n")}`
+        : "\nNo external module dependencies.";
+    const user = `Analyze this module and produce a structured summary.
+
+Module: ${moduleName}
+
+Files in this module:
+${filesSection}
+${depsSection}`;
+    return { system, user };
+}
+export function expeditionPrompt(question, callGraphSummary, moduleSummaries) {
+    const system = `You are a codebase tour guide. Respond with JSON only.
+You create guided tours (expeditions) through a codebase visualized as a 3D city.
+Each tour is a sequence of steps that visit specific nodes in the graph.
+
+Your response MUST be a valid JSON object with exactly this schema:
+{
+  "title": "<short title for the tour, max 60 chars>",
+  "description": "<one sentence describing the tour>",
+  "steps": [
+    {
+      "nodeId": "<the exact node ID to visit, e.g. mod:auth or file:src/auth/token.ts or fn:src/auth/token.ts:validateToken>",
+      "zoomLevel": <0 for satellite/module overview, 1 for neighborhood/file level, 2 for street/detail level, 3 for interior/function level>,
+      "narration": "<1-2 sentences explaining what the viewer is seeing and why it matters>",
+      "highlightEdges": [],
+      "highlightNodes": ["<additional node IDs to highlight>"],
+      "duration": <seconds to stay on this step, 4-10>,
+      "action": null
+    }
+  ]
+}
+
+IMPORTANT:
+- Only use nodeIds that appear in the provided module/file/function list.
+- Keep tours between 4-12 steps.
+- Start with broad overview (zoomLevel 0-1) and zoom in (zoomLevel 2-3) for important details.
+- Make narration conversational and insightful, not just restating the node name.`;
+    const modulesSection = moduleSummaries.join("\n");
+    const callGraphSection = callGraphSummary
+        ? `\nCall graph (caller -> callee):\n${callGraphSummary}`
+        : "\nNo call graph data available.";
+    const user = `Create a guided tour answering this question: "${question}"
+
+Available modules and summaries:
+${modulesSection}
+${callGraphSection}`;
+    return { system, user };
+}
+export function systemSummaryPrompt(moduleSummaries, dependencyGraph) {
+    const system = `You are a software architect. Respond with JSON only.
+You analyze entire codebases and produce high-level architectural summaries.
+Your response MUST be a valid JSON object with exactly this schema:
+{
+  "architecture_style": "<e.g. layered monolith, microservices, modular monolith, MVC, etc.>",
+  "narrative": "<2-4 sentence description of what this system does and how it is organized>",
+  "patterns": ["<pattern 1>", "<pattern 2>", ...],
+  "anti_patterns": ["<anti-pattern or risk 1>", ...],
+  "critical_path": ["<module name 1>", "<module name 2>", ...]
+}`;
+    const modulesSection = moduleSummaries.map((m) => `- ${m.name}: ${m.purpose}`).join("\n");
+    const graphSection = dependencyGraph.length > 0
+        ? dependencyGraph.map((e) => `  ${e.from} -> ${e.to}`).join("\n")
+        : "  (no inter-module dependencies)";
+    const user = `Analyze this codebase and produce a high-level architectural summary.
+
+Modules:
+${modulesSection}
+
+Module dependency graph:
+${graphSection}`;
+    return { system, user };
+}
+//# sourceMappingURL=prompts.js.map

package/dist/analysis/semantic/prompts.js.map

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

package/dist/analysis/semantic/summarizer.d.ts

@@ -0,0 +1,36 @@
+import type Database from "better-sqlite3";
+import type { FileAnalysis, ModuleInfo, GraphEdge, ProgressEvent } from "../../types/index.js";
+import { OpenAIClient } from "./openai-client.js";
+export interface FileSummary {
+    summary: string;
+    explanation: string;
+    layer: string;
+    tags: string[];
+}
+export interface ModuleSummary {
+    summary: string;
+    explanation: string;
+    layer: string;
+    tags: string[];
+}
+export interface SummarizationResult {
+    fileSummaries: Map<string, FileSummary>;
+    moduleSummaries: Map<string, ModuleSummary>;
+    systemSummary: {
+        architectureStyle: string;
+        narrative: string;
+    } | null;
+    totalTokensUsed: number;
+}
+/**
+ * Run hierarchical LLM summarization across the analyzed codebase.
+ *
+ * Phase 1: File-level (gpt-4o-mini, batched with concurrency)
+ * Phase 2: Module-level (gpt-4o, sequential per module)
+ * Phase 3: System-level (gpt-4o, single call)
+ *
+ * Results are cached in SQLite by content hash. If a file has not changed,
+ * its cached summary is reused.
+ */
+export declare function summarizeHierarchically(client: OpenAIClient, db: Database.Database, analyses: FileAnalysis[], modules: ModuleInfo[], moduleEdges: GraphEdge[], rootDir: string, onProgress?: (event: ProgressEvent) => void): Promise<SummarizationResult>;
+//# sourceMappingURL=summarizer.d.ts.map

package/dist/analysis/semantic/summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.d.ts","sourceRoot":"","sources":["../../../src/analysis/semantic/summarizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAclD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACxC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC5C,aAAa,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACvE,eAAe,EAAE,MAAM,CAAC;CACzB;AA0BD;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,YAAY,EACpB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,EAAE,UAAU,EAAE,EACrB,WAAW,EAAE,SAAS,EAAE,EACxB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAC1C,OAAO,CAAC,mBAAmB,CAAC,CAgR9B"}

package/dist/analysis/semantic/summarizer.js

@@ -0,0 +1,229 @@
+import { relative } from "node:path";
+import { OpenAIClient } from "./openai-client.js";
+import { createCacheKey, getCachedResult, setCachedResult } from "./cache.js";
+import { fileSummaryPrompt, moduleSummaryPrompt, systemSummaryPrompt } from "./prompts.js";
+import { logger } from "../../logger.js";
+function normalizePath(p) {
+    return p.replace(/\\/g, "/");
+}
+/** Models used at each summarization level. */
+const FILE_MODEL = "gpt-4o-mini";
+const MODULE_MODEL = "gpt-4o";
+const SYSTEM_MODEL = "gpt-4o";
+/**
+ * Run hierarchical LLM summarization across the analyzed codebase.
+ *
+ * Phase 1: File-level (gpt-4o-mini, batched with concurrency)
+ * Phase 2: Module-level (gpt-4o, sequential per module)
+ * Phase 3: System-level (gpt-4o, single call)
+ *
+ * Results are cached in SQLite by content hash. If a file has not changed,
+ * its cached summary is reused.
+ */
+export async function summarizeHierarchically(client, db, analyses, modules, moduleEdges, rootDir, onProgress) {
+    let totalTokensUsed = 0;
+    const fileSummaries = new Map();
+    const moduleSummaries = new Map();
+    let systemSummary = null;
+    // ── Phase 1: File-level summaries ──────────────────────────────
+    onProgress?.({
+        stage: "llm",
+        message: "Summarizing files...",
+        current: 0,
+        total: analyses.length,
+    });
+    const filePromises = analyses.map((analysis, index) => async () => {
+        const relPath = normalizePath(relative(rootDir, analysis.filePath));
+        const cacheKey = createCacheKey(analysis.content);
+        const cached = getCachedResult(db, cacheKey, "file");
+        if (cached) {
+            try {
+                const parsed = JSON.parse(cached);
+                fileSummaries.set(relPath, {
+                    summary: parsed.role,
+                    explanation: parsed.responsibilities.join("; "),
+                    layer: parsed.layer,
+                    tags: parsed.tags,
+                });
+                onProgress?.({
+                    stage: "llm",
+                    message: `Summarizing files... (cached: ${analysis.filePath})`,
+                    current: index + 1,
+                    total: analyses.length,
+                });
+                return;
+            }
+            catch {
+                logger.warn(`Corrupt cache entry for ${analysis.filePath}, re-summarizing`);
+            }
+        }
+        try {
+            const functionSummaries = analysis.functions.map((fn) => `${fn.name}(${fn.params.join(", ")})${fn.returnType ? `: ${fn.returnType}` : ""} — complexity: ${fn.complexity}`);
+            const imports = analysis.imports.map((imp) => `${imp.names.join(", ")} from "${imp.source}"`);
+            const exports = analysis.exports.map((exp) => `${exp.name} (${exp.kind})`);
+            const prompt = fileSummaryPrompt(analysis.filePath, analysis.content, functionSummaries, imports, exports);
+            const { result, tokensUsed } = await client.completeJSON([
+                { role: "system", content: prompt.system },
+                { role: "user", content: prompt.user },
+            ], FILE_MODEL);
+            totalTokensUsed += tokensUsed;
+            fileSummaries.set(relPath, {
+                summary: result.role,
+                explanation: Array.isArray(result.responsibilities)
+                    ? result.responsibilities.join("; ")
+                    : String(result.responsibilities ?? ""),
+                layer: result.layer,
+                tags: Array.isArray(result.tags) ? result.tags : [],
+            });
+            setCachedResult(db, cacheKey, FILE_MODEL, "file", JSON.stringify(result), tokensUsed);
+        }
+        catch (err) {
+            logger.warn(`Failed to summarize file ${relPath}: ${String(err)}`);
+        }
+        onProgress?.({
+            stage: "llm",
+            message: `Summarizing files...`,
+            current: index + 1,
+            total: analyses.length,
+        });
+    });
+    // Execute file summaries with concurrency (managed by OpenAIClient's p-limit)
+    await Promise.all(filePromises.map((fn) => fn()));
+    // ── Phase 2: Module-level summaries ────────────────────────────
+    onProgress?.({
+        stage: "llm",
+        message: "Summarizing modules...",
+        current: 0,
+        total: modules.length,
+    });
+    for (let i = 0; i < modules.length; i++) {
+        const mod = modules[i];
+        // Build file summaries for this module
+        const moduleFileSummaries = [];
+        for (const filePath of mod.files) {
+            const summary = fileSummaries.get(filePath);
+            if (summary) {
+                moduleFileSummaries.push({ path: filePath, role: summary.summary });
+            }
+        }
+        // Find dependencies of this module
+        const dependencies = moduleEdges
+            .filter((e) => e.sourceId === mod.id)
+            .map((e) => e.targetId.replace(/^mod:/, ""));
+        const cacheKey = createCacheKey(mod.name, ...moduleFileSummaries.map((f) => `${f.path}:${f.role}`), ...dependencies);
+        const cached = getCachedResult(db, cacheKey, "module");
+        if (cached) {
+            try {
+                const parsed = JSON.parse(cached);
+                moduleSummaries.set(mod.id, {
+                    summary: parsed.purpose,
+                    explanation: parsed.responsibilities.join("; "),
+                    layer: parsed.layer,
+                    tags: parsed.risks,
+                });
+                onProgress?.({
+                    stage: "llm",
+                    message: `Summarizing modules... (cached: ${mod.name})`,
+                    current: i + 1,
+                    total: modules.length,
+                });
+                continue;
+            }
+            catch {
+                logger.warn(`Corrupt cache entry for module ${mod.name}, re-summarizing`);
+            }
+        }
+        if (moduleFileSummaries.length === 0) {
+            onProgress?.({
+                stage: "llm",
+                message: `Summarizing modules... (skipped: ${mod.name}, no file summaries)`,
+                current: i + 1,
+                total: modules.length,
+            });
+            continue;
+        }
+        try {
+            const prompt = moduleSummaryPrompt(mod.name, moduleFileSummaries, dependencies);
+            const { result, tokensUsed } = await client.completeJSON([
+                { role: "system", content: prompt.system },
+                { role: "user", content: prompt.user },
+            ], MODULE_MODEL);
+            totalTokensUsed += tokensUsed;
+            moduleSummaries.set(mod.id, {
+                summary: result.purpose,
+                explanation: Array.isArray(result.responsibilities)
+                    ? result.responsibilities.join("; ")
+                    : String(result.responsibilities ?? ""),
+                layer: result.layer,
+                tags: Array.isArray(result.risks) ? result.risks : [],
+            });
+            setCachedResult(db, cacheKey, MODULE_MODEL, "module", JSON.stringify(result), tokensUsed);
+        }
+        catch (err) {
+            logger.warn(`Failed to summarize module ${mod.name}: ${String(err)}`);
+        }
+        onProgress?.({
+            stage: "llm",
+            message: `Summarizing modules...`,
+            current: i + 1,
+            total: modules.length,
+        });
+    }
+    // ── Phase 3: System-level summary ─────────────────────────────
+    onProgress?.({ stage: "llm", message: "Generating system summary..." });
+    const allModuleSummaries = [];
+    for (const mod of modules) {
+        const summary = moduleSummaries.get(mod.id);
+        if (summary) {
+            allModuleSummaries.push({ name: mod.name, purpose: summary.summary });
+        }
+    }
+    const depGraph = moduleEdges
+        .filter((e) => e.kind === "imports")
+        .map((e) => ({
+        from: e.sourceId.replace(/^mod:/, ""),
+        to: e.targetId.replace(/^mod:/, ""),
+    }));
+    if (allModuleSummaries.length > 0) {
+        const cacheKey = createCacheKey(...allModuleSummaries.map((m) => `${m.name}:${m.purpose}`), ...depGraph.map((e) => `${e.from}->${e.to}`));
+        const cached = getCachedResult(db, cacheKey, "system");
+        if (cached) {
+            try {
+                const parsed = JSON.parse(cached);
+                systemSummary = {
+                    architectureStyle: parsed.architecture_style,
+                    narrative: parsed.narrative,
+                };
+            }
+            catch {
+                logger.warn("Corrupt cache entry for system summary, re-summarizing");
+            }
+        }
+        if (!systemSummary) {
+            try {
+                const prompt = systemSummaryPrompt(allModuleSummaries, depGraph);
+                const { result, tokensUsed } = await client.completeJSON([
+                    { role: "system", content: prompt.system },
+                    { role: "user", content: prompt.user },
+                ], SYSTEM_MODEL);
+                totalTokensUsed += tokensUsed;
+                systemSummary = {
+                    architectureStyle: result.architecture_style,
+                    narrative: result.narrative,
+                };
+                setCachedResult(db, cacheKey, SYSTEM_MODEL, "system", JSON.stringify(result), tokensUsed);
+            }
+            catch (err) {
+                logger.warn(`Failed to generate system summary: ${String(err)}`);
+            }
+        }
+    }
+    onProgress?.({ stage: "llm", message: "LLM summarization complete." });
+    return {
+        fileSummaries,
+        moduleSummaries,
+        systemSummary,
+        totalTokensUsed,
+    };
+}
+//# sourceMappingURL=summarizer.js.map

package/dist/analysis/semantic/summarizer.js.map

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

package/dist/analysis/ts-js-visitor.d.ts

@@ -0,0 +1,4 @@
+import type Parser from "web-tree-sitter";
+import type { FileAnalysis } from "../types/index.js";
+export declare function visitFile(content: string, tree: Parser.Tree, filePath: string): FileAnalysis;
+//# sourceMappingURL=ts-js-visitor.d.ts.map

package/dist/analysis/ts-js-visitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-js-visitor.d.ts","sourceRoot":"","sources":["../../src/analysis/ts-js-visitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAA2E,MAAM,mBAAmB,CAAC;AA4Y/H,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,CAAC,IAAI,EACjB,QAAQ,EAAE,MAAM,GACf,YAAY,CAmCd"}