mapra 0.1.0

package/dist/encoder/text-encode.js

@@ -0,0 +1,123 @@
+/**
+ * Text Encoder — generates a structured text representation of the same graph
+ * Used as the baseline comparison for the visual encoding experiment.
+ * This represents "the best text can do" — well-structured YAML-like format.
+ */
+export function encodeToText(graph, analysis, options) {
+    const bare = options?.bare ?? false;
+    let text = "";
+    // Layer 0: Identity
+    text += `# ${graph.projectName}\n`;
+    text += `Framework: ${graph.framework}\n`;
+    text += `Files: ${graph.totalFiles} | Lines: ${graph.totalLines.toLocaleString()}\n`;
+    text += `Modules: ${graph.modules.length}\n\n`;
+    // Layer 1: Module overview
+    text += `## Modules\n`;
+    for (const mod of graph.modules.sort((a, b) => b.totalLines - a.totalLines)) {
+        const entryCount = mod.entryPoints.length;
+        text += `- ${mod.name} (${mod.path}): ${mod.nodeCount} files, ${mod.totalLines} lines`;
+        if (entryCount > 0)
+            text += ` [${entryCount} entry points]`;
+        text += `\n`;
+    }
+    // Risk analysis (structural — skip in bare mode)
+    if (!bare && analysis && analysis.risk.length > 0) {
+        text += `\n## Risk (Change With Care)\n`;
+        const top = analysis.risk.slice(0, 8);
+        for (const r of top) {
+            text += `- ${r.nodeId}: ${r.affectedCount} affected, depth ${r.maxDepth}, ${r.modulesAffected} modules, amp ${r.amplificationRatio.toFixed(1)}\n`;
+        }
+        const remaining = analysis.risk.length - top.length;
+        if (remaining > 0) {
+            text += `  ... and ${remaining} more with blast radius > 1\n`;
+        }
+    }
+    // Layer 2: Routes and API
+    const apiRoutes = graph.nodes.filter((n) => n.type === "api-route");
+    const pages = graph.nodes.filter((n) => n.type === "route");
+    if (apiRoutes.length > 0) {
+        text += `\n## API Routes (${apiRoutes.length})\n`;
+        for (const route of apiRoutes) {
+            const methods = route.framework?.metadata?.methods?.join(", ") || "?";
+            const routePath = route.framework?.metadata?.routePath ||
+                route.path;
+            text += `- ${methods} ${routePath} (${route.lines} lines)\n`;
+        }
+    }
+    if (pages.length > 0) {
+        text += `\n## Pages (${pages.length})\n`;
+        for (const page of pages) {
+            const routePath = page.framework?.metadata?.routePath ||
+                page.path;
+            const client = page.framework?.metadata?.isClientComponent
+                ? " [client]"
+                : "";
+            text += `- ${routePath}${client} (${page.lines} lines)\n`;
+        }
+    }
+    // Components
+    const components = graph.nodes.filter((n) => n.type === "component");
+    if (components.length > 0) {
+        text += `\n## Components (${components.length})\n`;
+        const sorted = bare
+            ? [...components].sort((a, b) => a.name.localeCompare(b.name))
+            : [...components].sort((a, b) => b.complexity - a.complexity);
+        for (const comp of sorted.slice(0, 20)) {
+            if (bare) {
+                text += `- ${comp.name} (${comp.lines} lines)\n`;
+            }
+            else {
+                text += `- ${comp.name} (${comp.lines} lines, complexity: ${comp.complexity.toFixed(2)})\n`;
+            }
+        }
+        if (components.length > 20) {
+            text += `  ... and ${components.length - 20} more\n`;
+        }
+    }
+    // Schema
+    const schemas = graph.nodes.filter((n) => n.type === "schema");
+    if (schemas.length > 0) {
+        text += `\n## Data Schema\n`;
+        for (const schema of schemas) {
+            const models = schema.framework?.metadata?.models || [];
+            text += `- ${schema.name}: ${models.length} models (${models.join(", ")})\n`;
+        }
+    }
+    // Structural analysis sections — skip in bare mode
+    if (!bare) {
+        // High-complexity files
+        const complex = graph.nodes
+            .filter((n) => n.type !== "test" && n.type !== "config")
+            .sort((a, b) => b.complexity - a.complexity)
+            .slice(0, 10);
+        text += `\n## Complexity Hotspots (top 10)\n`;
+        for (const node of complex) {
+            text += `- ${node.path} (${node.lines} lines, ${node.imports.length} imports)\n`;
+        }
+        // Dependencies — most connected files
+        const edgeCounts = new Map();
+        for (const edge of graph.edges) {
+            edgeCounts.set(edge.to, (edgeCounts.get(edge.to) || 0) + 1);
+        }
+        const mostImported = [...edgeCounts.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10);
+        if (mostImported.length > 0) {
+            text += `\n## Most Depended-On Files\n`;
+            for (const [fileId, count] of mostImported) {
+                text += `- ${fileId} (imported by ${count} files)\n`;
+            }
+        }
+        // Test coverage
+        const testEdges = graph.edges.filter((e) => e.type === "tests");
+        const testedFiles = new Set(testEdges.map((e) => e.to));
+        const testableFiles = graph.nodes.filter((n) => n.type !== "test" && n.type !== "config");
+        const coveragePercent = testableFiles.length > 0
+            ? ((testedFiles.size / testableFiles.length) * 100).toFixed(0)
+            : "0";
+        text += `\n## Test Coverage\n`;
+        text += `${testEdges.length} test files covering ${testedFiles.size}/${testableFiles.length} files (${coveragePercent}%)\n`;
+    }
+    return text;
+}
+//# sourceMappingURL=text-encode.js.map

package/dist/encoder/text-encode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-encode.js","sourceRoot":"","sources":["../../src/encoder/text-encode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,MAAM,UAAU,YAAY,CAC1B,KAAkB,EAClB,QAAwB,EACxB,OAA2B;IAE3B,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,KAAK,CAAC;IACpC,IAAI,IAAI,GAAG,EAAE,CAAC;IAEd,oBAAoB;IACpB,IAAI,IAAI,KAAK,KAAK,CAAC,WAAW,IAAI,CAAC;IACnC,IAAI,IAAI,cAAc,KAAK,CAAC,SAAS,IAAI,CAAC;IAC1C,IAAI,IAAI,UAAU,KAAK,CAAC,UAAU,aAAa,KAAK,CAAC,UAAU,CAAC,cAAc,EAAE,IAAI,CAAC;IACrF,IAAI,IAAI,YAAY,KAAK,CAAC,OAAO,CAAC,MAAM,MAAM,CAAC;IAE/C,2BAA2B;IAC3B,IAAI,IAAI,cAAc,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5E,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC;QAC1C,IAAI,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,SAAS,WAAW,GAAG,CAAC,UAAU,QAAQ,CAAC;QACvF,IAAI,UAAU,GAAG,CAAC;YAAE,IAAI,IAAI,KAAK,UAAU,gBAAgB,CAAC;QAC5D,IAAI,IAAI,IAAI,CAAC;IACf,CAAC;IAED,iDAAiD;IACjD,IAAI,CAAC,IAAI,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,IAAI,IAAI,gCAAgC,CAAC;QACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;YACpB,IAAI,IAAI,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,aAAa,oBAAoB,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,eAAe,iBAAiB,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACpJ,CAAC;QACD,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QACpD,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,IAAI,IAAI,aAAa,SAAS,+BAA+B,CAAC;QAChE,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAE5D,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,IAAI,oBAAoB,SAAS,CAAC,MAAM,KAAK,CAAC;QAClD,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,OAAO,GACV,KAAK,CAAC,SAAS,EAAE,QAAmC,EAAE,OAAO,EAAE,IAAI,CAClE,IAAI,CACL,IAAI,GAAG,CAAC;YACX,MAAM,SAAS,GACZ,KAAK,CAAC,SAAS,EAAE,QAAmC,EAAE,SAAS;gBAChE,KAAK,CAAC,IAAI,CAAC;YACb,IAAI,IAAI,KAAK,OAAO,IAAI,SAAS,KAAK,KAAK,CAAC,KAAK,WAAW,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,IAAI,IAAI,eAAe,KAAK,CAAC,MAAM,KAAK,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,SAAS,GACZ,IAAI,CAAC,SAAS,EAAE,QAAmC,EAAE,SAAS;gBAC/D,IAAI,CAAC,IAAI,CAAC;YACZ,MAAM,MAAM,GACV,IAAI,CAAC,SAAS,EAAE,QACjB,EAAE,iBAAiB;gBAClB,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,EAAE,CAAC;YACP,IAAI,IAAI,KAAK,SAAS,GAAG,MAAM,KAAK,IAAI,CAAC,KAAK,WAAW,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,aAAa;IACb,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IACrE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,IAAI,IAAI,oBAAoB,UAAU,CAAC,MAAM,KAAK,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI;YACjB,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC9D,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QAChE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YACvC,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,WAAW,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,uBAAuB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;YAC9F,CAAC;QACH,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC3B,IAAI,IAAI,aAAa,UAAU,CAAC,MAAM,GAAG,EAAE,SAAS,CAAC;QACvD,CAAC;IACH,CAAC;IAED,SAAS;IACT,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC/D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,IAAI,IAAI,oBAAoB,CAAC;QAC7B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,MAAM,GACT,MAAM,CAAC,SAAS,EAAE,QAAkC,EAAE,MAAM,IAAI,EAAE,CAAC;YACtE,IAAI,IAAI,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/E,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,wBAAwB;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK;aACxB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;aACvD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;aAC3C,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEhB,IAAI,IAAI,qCAAqC,CAAC;QAC9C,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,MAAM,aAAa,CAAC;QACnF,CAAC;QAED,sCAAsC;QACtC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,YAAY,GAAG,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;aAC3C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aAC3B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEhB,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,IAAI,IAAI,+BAA+B,CAAC;YACxC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;gBAC3C,IAAI,IAAI,KAAK,MAAM,iBAAiB,KAAK,WAAW,CAAC;YACvD,CAAC;QACH,CAAC;QAED,gBAAgB;QAChB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;QAChE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACxD,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAChD,CAAC;QACF,MAAM,eAAe,GACnB,aAAa,CAAC,MAAM,GAAG,CAAC;YACtB,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;YAC9D,CAAC,CAAC,GAAG,CAAC;QAEV,IAAI,IAAI,sBAAsB,CAAC;QAC/B,IAAI,IAAI,GAAG,SAAS,CAAC,MAAM,wBAAwB,WAAW,CAAC,IAAI,IAAI,aAAa,CAAC,MAAM,WAAW,eAAe,MAAM,CAAC;IAC9H,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/query/blast-radius.d.ts

@@ -0,0 +1,14 @@
+import type { MapraCache } from "./cache.js";
+export interface BlastRadiusResult {
+    file: string;
+    directImporters: number;
+    affectedCount: number;
+    amplificationRatio: number;
+    cascadeDepth: number;
+    modulesAffected: number;
+    affectedModules: string[];
+    cascadePath: string[];
+}
+export declare function queryBlastRadius(fileId: string, cache: MapraCache): BlastRadiusResult;
+export declare function formatBlastRadius(result: BlastRadiusResult, json: boolean): string;
+//# sourceMappingURL=blast-radius.d.ts.map

package/dist/query/blast-radius.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blast-radius.d.ts","sourceRoot":"","sources":["../../src/query/blast-radius.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,iBAAiB,CA4CrF;AA+BD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAoBlF"}

package/dist/query/blast-radius.js

@@ -0,0 +1,81 @@
+// src/query/blast-radius.ts
+import * as path from "path";
+import { buildReverseAdjacency, bfsWithParents, getModuleId } from "../analyzer/graph-utils.js";
+export function queryBlastRadius(fileId, cache) {
+    // Use pre-computed risk data when available; only run BFS for cascade path
+    const precomputed = cache.analysis.risk.find(r => r.nodeId === fileId);
+    // Lazy BFS — only run when we need cascade path or fallback data
+    let _bfsResult;
+    let _reverseAdj;
+    function getBfs() {
+        if (!_bfsResult) {
+            const testNodeIds = new Set(cache.graph.nodes.filter(n => n.type === "test").map(n => n.id));
+            _reverseAdj = buildReverseAdjacency(cache.graph.edges, true, testNodeIds);
+            _bfsResult = bfsWithParents(fileId, _reverseAdj);
+        }
+        return _bfsResult;
+    }
+    const directImporters = precomputed?.directImporters ?? (() => {
+        getBfs();
+        return _reverseAdj.get(fileId)?.size ?? 0;
+    })();
+    const affectedCount = precomputed?.affectedCount ?? getBfs().depths.size;
+    const amplificationRatio = precomputed?.amplificationRatio ??
+        (directImporters > 0 ? Math.round((affectedCount / directImporters) * 10) / 10 : 0);
+    const cascadeDepth = precomputed?.maxDepth ?? (getBfs().depths.size > 0 ? Math.max(...getBfs().depths.values()) : 0);
+    const affectedModules = precomputed?.affectedModuleNames ??
+        [...new Set([...getBfs().depths.keys()].map(getModuleId))].sort();
+    const modulesAffected = precomputed?.modulesAffected ?? affectedModules.length;
+    // Cascade path always needs BFS
+    const { depths, parents } = getBfs();
+    return {
+        file: fileId,
+        directImporters,
+        affectedCount,
+        amplificationRatio,
+        cascadeDepth,
+        modulesAffected,
+        affectedModules,
+        cascadePath: reconstructCascadePath(fileId, depths, parents),
+    };
+}
+/** Trace from deepest BFS node back to start to get the longest cascade chain. */
+function reconstructCascadePath(startId, depths, parents) {
+    if (depths.size === 0)
+        return [];
+    let deepestNode = "";
+    let maxDepth = 0;
+    for (const [node, depth] of depths) {
+        if (depth > maxDepth) {
+            maxDepth = depth;
+            deepestNode = node;
+        }
+    }
+    const chain = [];
+    let current = deepestNode;
+    while (current !== startId) {
+        chain.unshift(current);
+        const parent = parents.get(current);
+        if (!parent)
+            break;
+        current = parent;
+    }
+    return chain;
+}
+export function formatBlastRadius(result, json) {
+    if (json)
+        return JSON.stringify(result, null, 2);
+    const lines = [];
+    lines.push(`${result.file}  \u00D7${result.directImporters}\u2192${result.affectedCount}  d${result.cascadeDepth}  amp${result.amplificationRatio}  ${result.modulesAffected}mod`);
+    if (result.affectedModules.length > 0) {
+        lines.push(`affected modules: ${result.affectedModules.join(", ")}`);
+    }
+    if (result.cascadePath.length > 0) {
+        const chain = result.cascadePath
+            .map((f, i) => `${path.basename(f)}(d${i + 1})`)
+            .join(" \u2192 ");
+        lines.push(`cascade: ${chain}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=blast-radius.js.map

package/dist/query/blast-radius.js.map

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

package/dist/query/cache.d.ts

@@ -0,0 +1,29 @@
+import type { StrandGraph } from "../scanner/index.js";
+import type { GraphAnalysis } from "../analyzer/index.js";
+export interface MapraCache {
+    version: 1;
+    generated: string;
+    gitHead?: string;
+    graph: StrandGraph;
+    analysis: GraphAnalysis;
+}
+/**
+ * Serialize StrandGraph + GraphAnalysis to .mapra-cache.json.
+ * Uses atomic write (tmp + rename) for safety.
+ */
+export declare function writeCache(targetPath: string, graph: StrandGraph, analysis: GraphAnalysis, gitHead?: string): void;
+/**
+ * Load and validate .mapra-cache.json from the given directory,
+ * walking up to git root if not found in startDir.
+ */
+export declare function loadCache(startDir?: string): MapraCache;
+/**
+ * Check if cache is stale relative to current git HEAD.
+ * Returns a warning string, or null if current/not-git.
+ */
+export declare function checkStaleness(cache: MapraCache): string | null;
+/**
+ * Append `.mapra-cache.json` to .gitignore if not already present.
+ */
+export declare function ensureCacheInGitignore(targetPath: string): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/query/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/query/cache.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAaD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAwBN;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,CAiCvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAuB/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAa/D"}

package/dist/query/cache.js

@@ -0,0 +1,138 @@
+// src/query/cache.ts — mapra cache management
+import * as fs from "fs";
+import * as path from "path";
+import { execSync } from "child_process";
+/**
+ * Serialize StrandGraph + GraphAnalysis to .mapra-cache.json.
+ * Uses atomic write (tmp + rename) for safety.
+ */
+export function writeCache(targetPath, graph, analysis, gitHead) {
+    const cache = {
+        version: 1,
+        generated: new Date().toISOString(),
+        ...(gitHead !== undefined ? { gitHead } : {}),
+        graph,
+        analysis: {
+            ...analysis,
+            churn: Object.fromEntries(analysis.churn),
+        },
+    };
+    const cachePath = path.join(targetPath, ".mapra-cache.json");
+    const tmpPath = cachePath + ".tmp";
+    const json = JSON.stringify(cache, null, 2);
+    fs.writeFileSync(tmpPath, json, "utf-8");
+    try {
+        fs.renameSync(tmpPath, cachePath);
+    }
+    catch {
+        fs.writeFileSync(cachePath, json, "utf-8");
+    }
+    finally {
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch { /* already renamed or gone */ }
+    }
+}
+/**
+ * Load and validate .mapra-cache.json from the given directory,
+ * walking up to git root if not found in startDir.
+ */
+export function loadCache(startDir) {
+    const dir = startDir ?? process.cwd();
+    const cachePath = findCacheFile(dir);
+    if (!cachePath) {
+        throw new Error("No .mapra-cache.json found. Run 'mapra generate' first.");
+    }
+    let raw;
+    try {
+        raw = fs.readFileSync(cachePath, "utf-8");
+    }
+    catch {
+        throw new Error("No .mapra-cache.json found. Run 'mapra generate' first.");
+    }
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(".mapra-cache.json is corrupted. Run 'mapra generate' to rebuild.");
+    }
+    if (data.version !== 1) {
+        throw new Error("Cache format is incompatible. Run 'mapra generate' to rebuild.");
+    }
+    return {
+        ...data,
+        analysis: {
+            ...data.analysis,
+            churn: new Map(Object.entries(data.analysis.churn)),
+        },
+    };
+}
+/**
+ * Check if cache is stale relative to current git HEAD.
+ * Returns a warning string, or null if current/not-git.
+ */
+export function checkStaleness(cache) {
+    if (!cache.gitHead)
+        return null;
+    try {
+        const currentHead = execSync("git rev-parse HEAD", {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+        if (currentHead === cache.gitHead)
+            return null;
+        try {
+            const count = execSync(`git rev-list --count ${cache.gitHead}..HEAD`, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+            return `\u26A0 cache generated before ${count} commits \u2014 run 'mapra generate' to refresh`;
+        }
+        catch {
+            return "\u26A0 cache may be stale \u2014 run 'mapra generate' to refresh";
+        }
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Append `.mapra-cache.json` to .gitignore if not already present.
+ */
+export function ensureCacheInGitignore(targetPath) {
+    const gitignorePath = path.join(targetPath, ".gitignore");
+    const entry = ".mapra-cache.json";
+    let content = "";
+    try {
+        content = fs.readFileSync(gitignorePath, "utf-8");
+    }
+    catch { /* file doesn't exist yet */ }
+    if (content.split("\n").some(line => line.trim() === entry))
+        return;
+    const separator = content.length > 0 && !content.endsWith("\n") ? "\n" : "";
+    fs.writeFileSync(gitignorePath, content + separator + entry + "\n", "utf-8");
+}
+/** Walk up from startDir to git root looking for .mapra-cache.json. */
+function findCacheFile(startDir) {
+    let dir = path.resolve(startDir);
+    let gitRoot = null;
+    try {
+        gitRoot = path.resolve(execSync("git rev-parse --show-toplevel", {
+            cwd: dir,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim());
+    }
+    catch { /* not a git repo */ }
+    while (true) {
+        const candidate = path.join(dir, ".mapra-cache.json");
+        if (fs.existsSync(candidate))
+            return candidate;
+        if (gitRoot && path.resolve(dir) === gitRoot)
+            return null;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/query/cache.js.map

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

package/dist/query/index.d.ts

@@ -0,0 +1,2 @@
+export declare function runQueryCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/query/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AASA,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCnE"}

package/dist/query/index.js

@@ -0,0 +1,46 @@
+// src/query/index.ts
+import { loadCache, checkStaleness } from "./cache.js";
+import { resolveFile } from "./resolve.js";
+import { queryBlastRadius, formatBlastRadius } from "./blast-radius.js";
+import { queryTestMap, formatTestMap } from "./test-map.js";
+import { queryRiskProfile, formatRiskProfile } from "./risk-profile.js";
+const QUERY_TYPES = ["blast_radius", "risk_profile", "test_map"];
+export async function runQueryCommand(args) {
+    const jsonFlag = args.includes("--json");
+    const positionalArgs = args.filter(a => !a.startsWith("--"));
+    const queryType = positionalArgs[0];
+    const fileArg = positionalArgs[1];
+    if (!queryType || !fileArg) {
+        console.error("Usage: mapra query <type> <file> [--json]");
+        console.error(`Types: ${QUERY_TYPES.join(", ")}`);
+        process.exit(1);
+    }
+    if (!QUERY_TYPES.includes(queryType)) {
+        console.error(`Error: Unknown query type '${queryType}'. Available: ${QUERY_TYPES.join(", ")}`);
+        process.exit(1);
+    }
+    const cache = loadCache();
+    const staleness = checkStaleness(cache);
+    if (staleness)
+        console.error(staleness);
+    const nodeIds = cache.graph.nodes.map(n => n.id);
+    const fileId = resolveFile(nodeIds, fileArg);
+    switch (queryType) {
+        case "blast_radius": {
+            const result = queryBlastRadius(fileId, cache);
+            console.log(formatBlastRadius(result, jsonFlag));
+            break;
+        }
+        case "test_map": {
+            const result = queryTestMap(fileId, cache);
+            console.log(formatTestMap(result, jsonFlag));
+            break;
+        }
+        case "risk_profile": {
+            const result = queryRiskProfile(fileId, cache);
+            console.log(formatRiskProfile(result, jsonFlag));
+            break;
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAExE,MAAM,WAAW,GAAG,CAAC,cAAc,EAAE,cAAc,EAAE,UAAU,CAAU,CAAC;AAE1E,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAc;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAElC,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC3D,OAAO,CAAC,KAAK,CAAC,UAAU,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,SAAuC,CAAC,EAAE,CAAC;QACnE,OAAO,CAAC,KAAK,CAAC,8BAA8B,SAAS,iBAAiB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,SAAS;QAAE,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAExC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE7C,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;YACjD,MAAM;QACR,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;YAC7C,MAAM;QACR,CAAC;QACD,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;YACjD,MAAM;QACR,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/query/resolve.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolve user-provided file path against cached node IDs.
+ * Supports exact match, backslash normalization, and suffix matching.
+ * Throws with actionable error messages on ambiguous or missing matches.
+ */
+export declare function resolveFile(nodeIds: string[], input: string): string;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/query/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/query/resolve.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAqBpE"}

package/dist/query/resolve.js

@@ -0,0 +1,24 @@
+// src/query/resolve.ts
+/**
+ * Resolve user-provided file path against cached node IDs.
+ * Supports exact match, backslash normalization, and suffix matching.
+ * Throws with actionable error messages on ambiguous or missing matches.
+ */
+export function resolveFile(nodeIds, input) {
+    const normalized = input.replace(/\\/g, "/").replace(/^\//, "");
+    // Exact match (O(1) via Set)
+    const idSet = new Set(nodeIds);
+    if (idSet.has(normalized))
+        return normalized;
+    // Suffix match
+    const suffix = "/" + normalized;
+    const matches = nodeIds.filter(id => id.endsWith(suffix));
+    if (matches.length === 1)
+        return matches[0];
+    if (matches.length > 1) {
+        const candidates = matches.map(m => "  " + m).join("\n");
+        throw new Error(`Multiple matches for '${input}':\n${candidates}\nSpecify the full path.`);
+    }
+    throw new Error(`'${input}' not found in cache. Check the path or run 'mapra generate'.`);
+}
+//# sourceMappingURL=resolve.js.map

package/dist/query/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/query/resolve.ts"],"names":[],"mappings":"AAAA,uBAAuB;AAEvB;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,OAAiB,EAAE,KAAa;IAC1D,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEhE,6BAA6B;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAE7C,eAAe;IACf,MAAM,MAAM,GAAG,GAAG,GAAG,UAAU,CAAC;IAChC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAE1D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC;IAE7C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,IAAI,KAAK,CACb,yBAAyB,KAAK,OAAO,UAAU,0BAA0B,CAC1E,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,+DAA+D,CAAC,CAAC;AAC5F,CAAC"}

package/dist/query/risk-profile.d.ts

@@ -0,0 +1,30 @@
+import type { MapraCache } from "./cache.js";
+import { type TestMapResult } from "./test-map.js";
+export interface RiskProfileResult {
+    file: string;
+    risk: {
+        directImporters: number;
+        affectedCount: number;
+        cascadeDepth: number;
+        amplificationRatio: number;
+        modulesAffected: number;
+        affectedModules: string[];
+    } | null;
+    churn: {
+        commits30d: number;
+        linesAdded: number;
+        linesRemoved: number;
+        lastCommitMsg: string;
+    } | null;
+    coChangePartners: Array<{
+        file: string;
+        count: number;
+        confidence: number;
+        linked: boolean;
+    }>;
+    tests: TestMapResult;
+    conventionViolations: string[];
+}
+export declare function queryRiskProfile(fileId: string, cache: MapraCache): RiskProfileResult;
+export declare function formatRiskProfile(result: RiskProfileResult, json: boolean): string;
+//# sourceMappingURL=risk-profile.d.ts.map

package/dist/query/risk-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk-profile.d.ts","sourceRoot":"","sources":["../../src/query/risk-profile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QACJ,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,GAAG,IAAI,CAAC;IACT,KAAK,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,IAAI,CAAC;IACT,gBAAgB,EAAE,KAAK,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;IACH,KAAK,EAAE,aAAa,CAAC;IACrB,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,iBAAiB,CAiDrF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAuDlF"}