mapra 0.1.0

package/dist/analyzer/conventions.js

@@ -0,0 +1,81 @@
+/**
+ * Convention Detector — identifies import patterns repeated across files of the same type.
+ *
+ * A "convention" is a dependency imported by >= 60% of files with a given type
+ * (e.g., 8/12 API routes import Sentry). Minimum 3 files of that type required.
+ */
+const CONVENTION_THRESHOLD = 0.6;
+const VIOLATION_THRESHOLD = 0.7;
+const MIN_TYPE_COUNT = 3;
+/**
+ * Detect import conventions from graph data.
+ * Returns conventions sorted by coverage descending.
+ */
+export function detectConventions(nodes, edges) {
+    const nodeMap = new Map(nodes.map((n) => [n.id, n]));
+    // Group non-test, non-config nodes by type
+    const byType = new Map();
+    for (const node of nodes) {
+        if (node.type === "test" || node.type === "config" || node.type === "schema")
+            continue;
+        const existing = byType.get(node.type) ?? [];
+        existing.push(node);
+        byType.set(node.type, existing);
+    }
+    // Build forward adjacency from non-test edges
+    const imports = new Map();
+    for (const edge of edges) {
+        if (edge.type === "tests")
+            continue;
+        const set = imports.get(edge.from) ?? new Set();
+        set.add(edge.to);
+        imports.set(edge.from, set);
+    }
+    const conventions = [];
+    for (const [type, typeNodes] of byType) {
+        if (typeNodes.length < MIN_TYPE_COUNT)
+            continue;
+        // Count how many nodes of this type import each dependency
+        const depCounts = new Map();
+        for (const node of typeNodes) {
+            const deps = imports.get(node.id);
+            if (!deps)
+                continue;
+            for (const dep of deps) {
+                depCounts.set(dep, (depCounts.get(dep) ?? 0) + 1);
+            }
+        }
+        // Check each dependency against threshold
+        for (const [dep, count] of depCounts) {
+            const coverage = count / typeNodes.length;
+            if (coverage < CONVENTION_THRESHOLD)
+                continue;
+            // Skip self-type dependencies (api-route importing another api-route isn't a convention)
+            const depNode = nodeMap.get(dep);
+            if (depNode?.type === type)
+                continue;
+            // Find violators: files of this type that DON'T import the convention dep
+            // Only populate for conventions with >= 70% adoption (strong conventions)
+            let violators = [];
+            if (coverage >= VIOLATION_THRESHOLD) {
+                violators = typeNodes
+                    .filter((n) => {
+                    const deps = imports.get(n.id);
+                    return !deps || !deps.has(dep);
+                })
+                    .map((n) => n.id);
+            }
+            conventions.push({
+                anchorFile: dep,
+                anchorExports: depNode?.exports?.filter((e) => e !== "default") ?? [],
+                consumerType: type,
+                adoption: count,
+                total: typeNodes.length,
+                coverage,
+                violators,
+            });
+        }
+    }
+    return conventions.sort((a, b) => b.coverage - a.coverage);
+}
+//# sourceMappingURL=conventions.js.map

package/dist/analyzer/conventions.js.map

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

package/dist/analyzer/git-hash.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Git Hash Utility — resolves the current HEAD short hash.
+ *
+ * Used to embed commit identity in .mapra headers for staleness detection.
+ */
+/**
+ * Get the short git hash of the current HEAD commit.
+ * Returns null if not in a git repo or git is unavailable.
+ */
+export declare function getGitHash(rootDir: string): string | null;
+//# sourceMappingURL=git-hash.d.ts.map

package/dist/analyzer/git-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-hash.d.ts","sourceRoot":"","sources":["../../src/analyzer/git-hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYzD"}

package/dist/analyzer/git-hash.js

@@ -0,0 +1,25 @@
+/**
+ * Git Hash Utility — resolves the current HEAD short hash.
+ *
+ * Used to embed commit identity in .mapra headers for staleness detection.
+ */
+import { execSync } from "child_process";
+/**
+ * Get the short git hash of the current HEAD commit.
+ * Returns null if not in a git repo or git is unavailable.
+ */
+export function getGitHash(rootDir) {
+    try {
+        const hash = execSync("git rev-parse --short HEAD", {
+            cwd: rootDir,
+            encoding: "utf-8",
+            timeout: 5000,
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+        return hash || null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=git-hash.js.map

package/dist/analyzer/git-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-hash.js","sourceRoot":"","sources":["../../src/analyzer/git-hash.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,4BAA4B,EAAE;YAClD,GAAG,EAAE,OAAO;YACZ,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,IAAI,IAAI,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/analyzer/graph-utils.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Shared graph utilities — adjacency builders, BFS, module ID helpers.
+ * Used by blast-radius and future analyzers (keystones, dead wood, etc.).
+ */
+import type { StrandEdge } from "../scanner/index.js";
+/**
+ * Build reverse adjacency: for each node, who imports it.
+ * Optionally excludes test edges (type === "tests") and/or
+ * edges where the source node is a test file (by ID).
+ */
+export declare function buildReverseAdjacency(edges: StrandEdge[], excludeTestEdges?: boolean, testNodeIds?: Set<string>): Map<string, Set<string>>;
+/**
+ * Build forward adjacency: for each node, who does it import.
+ * Optionally excludes test edges.
+ */
+export declare function buildForwardAdjacency(edges: StrandEdge[], excludeTestEdges?: boolean): Map<string, Set<string>>;
+/**
+ * Count inbound edges per node.
+ * Optionally excludes test edges.
+ */
+export declare function countInboundEdges(edges: StrandEdge[], excludeTestEdges?: boolean): Map<string, number>;
+/**
+ * BFS from startId through adjacency map.
+ * Returns Map<nodeId, depth> of all reachable nodes (excluding start).
+ * Handles cycles safely via visited set.
+ */
+export declare function bfs(startId: string, adjacency: Map<string, Set<string>>): Map<string, number>;
+/**
+ * Extract coarse module ID from a file path.
+ * Uses first 2 path segments: "src/lib", "src/app", etc.
+ * Root-level files return the first segment.
+ */
+export declare function getModuleId(nodePath: string): string;
+/**
+ * Count distinct modules among a set of node IDs.
+ */
+export declare function countDistinctModules(nodeIds: Iterable<string>): number;
+/**
+ * BFS with parent tracking — like bfs() but also records which node
+ * discovered each visited node. Used for cascade path reconstruction.
+ */
+export declare function bfsWithParents(startId: string, adjacency: Map<string, Set<string>>): {
+    depths: Map<string, number>;
+    parents: Map<string, string>;
+};
+//# sourceMappingURL=graph-utils.d.ts.map

package/dist/analyzer/graph-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-utils.d.ts","sourceRoot":"","sources":["../../src/analyzer/graph-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EAAE,EACnB,gBAAgB,UAAQ,EACxB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAW1B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EAAE,EACnB,gBAAgB,UAAQ,GACvB,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAU1B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EAAE,EACnB,gBAAgB,UAAQ,GACvB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CASrB;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GAClC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAiCrB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAMtE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GAClC;IAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAmC/D"}

package/dist/analyzer/graph-utils.js

@@ -0,0 +1,145 @@
+/**
+ * Shared graph utilities — adjacency builders, BFS, module ID helpers.
+ * Used by blast-radius and future analyzers (keystones, dead wood, etc.).
+ */
+/**
+ * Build reverse adjacency: for each node, who imports it.
+ * Optionally excludes test edges (type === "tests") and/or
+ * edges where the source node is a test file (by ID).
+ */
+export function buildReverseAdjacency(edges, excludeTestEdges = false, testNodeIds) {
+    const rev = new Map();
+    for (const edge of edges) {
+        if (excludeTestEdges && edge.type === "tests")
+            continue;
+        if (testNodeIds && testNodeIds.has(edge.from))
+            continue;
+        if (!rev.has(edge.to))
+            rev.set(edge.to, new Set());
+        rev.get(edge.to).add(edge.from);
+    }
+    return rev;
+}
+/**
+ * Build forward adjacency: for each node, who does it import.
+ * Optionally excludes test edges.
+ */
+export function buildForwardAdjacency(edges, excludeTestEdges = false) {
+    const fwd = new Map();
+    for (const edge of edges) {
+        if (excludeTestEdges && edge.type === "tests")
+            continue;
+        if (!fwd.has(edge.from))
+            fwd.set(edge.from, new Set());
+        fwd.get(edge.from).add(edge.to);
+    }
+    return fwd;
+}
+/**
+ * Count inbound edges per node.
+ * Optionally excludes test edges.
+ */
+export function countInboundEdges(edges, excludeTestEdges = false) {
+    const counts = new Map();
+    for (const edge of edges) {
+        if (excludeTestEdges && edge.type === "tests")
+            continue;
+        counts.set(edge.to, (counts.get(edge.to) || 0) + 1);
+    }
+    return counts;
+}
+/**
+ * BFS from startId through adjacency map.
+ * Returns Map<nodeId, depth> of all reachable nodes (excluding start).
+ * Handles cycles safely via visited set.
+ */
+export function bfs(startId, adjacency) {
+    const visited = new Set([startId]);
+    const depths = new Map();
+    const queue = [];
+    // Seed queue with direct neighbors
+    const neighbors = adjacency.get(startId);
+    if (neighbors) {
+        for (const n of neighbors) {
+            if (!visited.has(n)) {
+                visited.add(n);
+                depths.set(n, 1);
+                queue.push({ id: n, depth: 1 });
+            }
+        }
+    }
+    let head = 0;
+    while (head < queue.length) {
+        const { id, depth } = queue[head++];
+        const next = adjacency.get(id);
+        if (!next)
+            continue;
+        for (const n of next) {
+            if (!visited.has(n)) {
+                visited.add(n);
+                depths.set(n, depth + 1);
+                queue.push({ id: n, depth: depth + 1 });
+            }
+        }
+    }
+    return depths;
+}
+/**
+ * Extract coarse module ID from a file path.
+ * Uses first 2 path segments: "src/lib", "src/app", etc.
+ * Root-level files return the first segment.
+ */
+export function getModuleId(nodePath) {
+    const parts = nodePath.split("/");
+    return parts.length > 2
+        ? parts.slice(0, 2).join("/")
+        : (parts[0] ?? nodePath);
+}
+/**
+ * Count distinct modules among a set of node IDs.
+ */
+export function countDistinctModules(nodeIds) {
+    const modules = new Set();
+    for (const id of nodeIds) {
+        modules.add(getModuleId(id));
+    }
+    return modules.size;
+}
+/**
+ * BFS with parent tracking — like bfs() but also records which node
+ * discovered each visited node. Used for cascade path reconstruction.
+ */
+export function bfsWithParents(startId, adjacency) {
+    const visited = new Set([startId]);
+    const depths = new Map();
+    const parents = new Map();
+    const queue = [];
+    const neighbors = adjacency.get(startId);
+    if (neighbors) {
+        for (const n of neighbors) {
+            if (!visited.has(n)) {
+                visited.add(n);
+                depths.set(n, 1);
+                parents.set(n, startId);
+                queue.push({ id: n, depth: 1 });
+            }
+        }
+    }
+    let head = 0;
+    while (head < queue.length) {
+        const { id, depth } = queue[head++];
+        const next = adjacency.get(id);
+        if (!next)
+            continue;
+        for (const n of next) {
+            if (!visited.has(n)) {
+                visited.add(n);
+                depths.set(n, depth + 1);
+                parents.set(n, id);
+                queue.push({ id: n, depth: depth + 1 });
+            }
+        }
+    }
+    return { depths, parents };
+}
+//# sourceMappingURL=graph-utils.js.map

package/dist/analyzer/graph-utils.js.map

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

package/dist/analyzer/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Graph Analyzer — entry point for structural analysis.
+ *
+ * Builds shared data structures once, passes them to individual analyzers.
+ * Currently: blast radius. Designed to extend with keystones, dead wood, symbiosis.
+ */
+import type { StrandGraph } from "../scanner/index.js";
+import { type BlastResult } from "./blast-radius.js";
+import { type ChurnResult } from "./churn.js";
+import { type Convention } from "./conventions.js";
+import { type CoChangePair } from "./co-change.js";
+/**
+ * Returns true for files that are noise in analytical sections:
+ * - `.generated.{ts,tsx,js,jsx}` — auto-generated code
+ * - `.d.ts` — TypeScript declaration files (ambient types, not business logic)
+ */
+export declare function isNoiseFile(filePath: string): boolean;
+export interface GraphAnalysis {
+    risk: BlastResult[];
+    deadCode: string[];
+    churn: Map<string, ChurnResult>;
+    conventions: Convention[];
+    coChanges: CoChangePair[];
+}
+/**
+ * Analyze a strand graph for structural risk patterns.
+ * Returns sorted results ready for rendering.
+ */
+export declare function analyzeGraph(graph: StrandGraph, rootDir?: string): GraphAnalysis;
+export type { BlastResult } from "./blast-radius.js";
+export type { ChurnResult } from "./churn.js";
+export type { Convention } from "./conventions.js";
+export type { CoChangePair } from "./co-change.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analyzer/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,qBAAqB,CAAC;AAEnE,OAAO,EACL,KAAK,WAAW,EAEjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,KAAK,UAAU,EAAqB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAmBD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAChC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,CAoChF;AAED,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/analyzer/index.js

@@ -0,0 +1,63 @@
+/**
+ * Graph Analyzer — entry point for structural analysis.
+ *
+ * Builds shared data structures once, passes them to individual analyzers.
+ * Currently: blast radius. Designed to extend with keystones, dead wood, symbiosis.
+ */
+import { buildReverseAdjacency } from "./graph-utils.js";
+import { computeAllBlastRadii, } from "./blast-radius.js";
+import { computeChurn } from "./churn.js";
+import { detectConventions } from "./conventions.js";
+import { computeCoChanges } from "./co-change.js";
+/**
+ * Returns true for files that are noise in analytical sections:
+ * - `.generated.{ts,tsx,js,jsx}` — auto-generated code
+ * - `.d.ts` — TypeScript declaration files (ambient types, not business logic)
+ */
+export function isNoiseFile(filePath) {
+    return /\.generated\.(ts|tsx|js|jsx)$|\.d\.ts$/.test(filePath);
+}
+/**
+ * Files managed by dependency injection — typed as utility but not dead code.
+ * These are loaded by DI containers (NestJS, Angular) at runtime, not via
+ * static imports, so they have zero inbound edges in the import graph.
+ */
+const DI_ENTRY_PATTERNS = [
+    /\.service\.(ts|js)$/,
+    /\.repository\.(ts|js)$/,
+    /\.resolver\.(ts|js)$/,
+    /\.gateway\.(ts|js)$/,
+    /\.subscriber\.(ts|js)$/,
+];
+function isDiEntryPoint(filePath) {
+    return DI_ENTRY_PATTERNS.some(re => re.test(filePath));
+}
+/**
+ * Analyze a strand graph for structural risk patterns.
+ * Returns sorted results ready for rendering.
+ */
+export function analyzeGraph(graph, rootDir) {
+    // Collect test node IDs for filtering
+    const testNodeIds = new Set(graph.nodes.filter(n => n.type === "test").map(n => n.id));
+    // Build reverse adjacency once, excluding test edges and test-sourced edges
+    const reverseAdj = buildReverseAdjacency(graph.edges, true, testNodeIds);
+    // Compute blast radii
+    const blastMap = computeAllBlastRadii(reverseAdj);
+    // Sort by amplificationRatio descending
+    const risk = [...blastMap.values()].sort((a, b) => b.amplificationRatio - a.amplificationRatio);
+    // Dead code: files with no inbound edges (not routes, configs, or tests)
+    const SKIP_TYPES = new Set([
+        "route", "api-route", "config", "test", "layout", "middleware",
+    ]);
+    const deadCode = graph.nodes
+        .filter((n) => !SKIP_TYPES.has(n.type) &&
+        !isNoiseFile(n.id) &&
+        !isDiEntryPoint(n.id) &&
+        !reverseAdj.has(n.id))
+        .map((n) => n.id);
+    const churn = rootDir ? computeChurn(rootDir) : new Map();
+    const conventions = detectConventions(graph.nodes, graph.edges);
+    const coChanges = rootDir ? computeCoChanges(rootDir, graph.edges) : [];
+    return { risk, deadCode, churn, conventions, coChanges };
+}
+//# sourceMappingURL=index.js.map

package/dist/analyzer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analyzer/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAEL,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAoB,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAmB,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAqB,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAErE;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,wCAAwC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED;;;;GAIG;AACH,MAAM,iBAAiB,GAAG;IACxB,qBAAqB;IACrB,wBAAwB;IACxB,sBAAsB;IACtB,qBAAqB;IACrB,wBAAwB;CACzB,CAAC;AAEF,SAAS,cAAc,CAAC,QAAgB;IACtC,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAkB,EAAE,OAAgB;IAC/D,sCAAsC;IACtC,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAC1D,CAAC;IAEF,4EAA4E;IAC5E,MAAM,UAAU,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAEzE,sBAAsB;IACtB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAElD,wCAAwC;IACxC,MAAM,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACtC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,kBAAkB,GAAG,CAAC,CAAC,kBAAkB,CACtD,CAAC;IAEF,yEAAyE;IACzE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAqB;QAC7C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY;KAC/D,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK;SACzB,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QACvB,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAClB,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACxB;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAEpB,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAuB,CAAC;IAC/E,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAExE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AAC3D,CAAC"}

package/dist/cli/hooks.d.ts

@@ -0,0 +1,24 @@
+export declare const MAPRA_HOOK_START = "# --- mapra auto-update (do not edit) ---";
+export declare const MAPRA_HOOK_END = "# --- end mapra ---";
+declare const HOOK_TYPES: readonly ["post-commit", "post-merge", "post-checkout"];
+type HookType = (typeof HOOK_TYPES)[number];
+export declare function generateTrampoline(hookType: HookType): string;
+export declare function installHook(hooksDir: string, hookType: HookType): void;
+export declare function uninstallHook(hooksDir: string, hookType: HookType): void;
+/**
+ * Resolve the hooks directory: checks core.hooksPath first, falls back to .git/hooks.
+ */
+export declare function getHooksDir(targetPath: string): string | null;
+/**
+ * Install all three mapra hook trampolines.
+ */
+export declare function installAllHooks(targetPath: string): {
+    installed: string[];
+    skipped: string | null;
+};
+/**
+ * Uninstall all mapra hook trampolines.
+ */
+export declare function uninstallAllHooks(targetPath: string): void;
+export {};
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/cli/hooks.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB,8CAA8C,CAAC;AAC5E,eAAO,MAAM,cAAc,wBAAwB,CAAC;AAEpD,QAAA,MAAM,UAAU,yDAA0D,CAAC;AAC3E,KAAK,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAc7D;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAwBtE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAsBxE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA+B7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAgBnG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAO1D"}

package/dist/cli/hooks.js

@@ -0,0 +1,126 @@
+import * as fs from "fs";
+import * as path from "path";
+import { execFileSync } from "child_process";
+export const MAPRA_HOOK_START = "# --- mapra auto-update (do not edit) ---";
+export const MAPRA_HOOK_END = "# --- end mapra ---";
+const HOOK_TYPES = ["post-commit", "post-merge", "post-checkout"];
+export function generateTrampoline(hookType) {
+    const lines = ["#!/bin/sh", MAPRA_HOOK_START];
+    if (hookType === "post-checkout") {
+        // $3=1 means branch switch; $3=0 means file checkout — skip file checkouts
+        lines.push('[ "$3" = "1" ] && [ -f .mapra/hook.mjs ] && node .mapra/hook.mjs &');
+    }
+    else {
+        lines.push("[ -f .mapra/hook.mjs ] && node .mapra/hook.mjs &");
+    }
+    lines.push(MAPRA_HOOK_END, "");
+    return lines.join("\n");
+}
+export function installHook(hooksDir, hookType) {
+    const hookPath = path.join(hooksDir, hookType);
+    const block = generateTrampoline(hookType);
+    if (fs.existsSync(hookPath)) {
+        const existing = fs.readFileSync(hookPath, "utf-8");
+        // Already installed — skip
+        if (existing.includes(MAPRA_HOOK_START))
+            return;
+        // Append to existing hook
+        const separator = existing.endsWith("\n") ? "" : "\n";
+        const content = existing + separator + block;
+        fs.writeFileSync(hookPath, content.replace(/\r\n/g, "\n"));
+    }
+    else {
+        fs.writeFileSync(hookPath, block.replace(/\r\n/g, "\n"));
+    }
+    // Set executable bit (no-op on Windows, needed on Unix)
+    try {
+        fs.chmodSync(hookPath, 0o755);
+    }
+    catch {
+        /* ignore on systems that don't support chmod */
+    }
+}
+export function uninstallHook(hooksDir, hookType) {
+    const hookPath = path.join(hooksDir, hookType);
+    if (!fs.existsSync(hookPath))
+        return;
+    const content = fs.readFileSync(hookPath, "utf-8");
+    if (!content.includes(MAPRA_HOOK_START))
+        return;
+    // Remove the mapra block (including markers)
+    const startIdx = content.indexOf(MAPRA_HOOK_START);
+    const endIdx = content.indexOf(MAPRA_HOOK_END);
+    if (startIdx === -1 || endIdx === -1)
+        return;
+    const before = content.slice(0, startIdx);
+    const after = content.slice(endIdx + MAPRA_HOOK_END.length + 1); // +1 for trailing \n
+    const remaining = (before + after).trim();
+    if (!remaining || remaining === "#!/bin/sh") {
+        fs.unlinkSync(hookPath);
+    }
+    else {
+        fs.writeFileSync(hookPath, remaining + "\n");
+    }
+}
+/**
+ * Resolve the hooks directory: checks core.hooksPath first, falls back to .git/hooks.
+ */
+export function getHooksDir(targetPath) {
+    // Check core.hooksPath first
+    try {
+        const customPath = execFileSync("git", ["config", "core.hooksPath"], {
+            cwd: targetPath,
+            encoding: "utf-8",
+            timeout: 5000,
+        }).trim();
+        if (customPath) {
+            const resolved = path.isAbsolute(customPath)
+                ? customPath
+                : path.join(targetPath, customPath);
+            return resolved;
+        }
+    }
+    catch {
+        // core.hooksPath not set — fall through
+    }
+    // Use git rev-parse to handle worktrees, submodules, and normal repos
+    try {
+        const gitCommonDir = execFileSync("git", ["rev-parse", "--git-common-dir"], {
+            cwd: targetPath,
+            encoding: "utf-8",
+            timeout: 5000,
+        }).trim();
+        return path.join(path.resolve(targetPath, gitCommonDir), "hooks");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Install all three mapra hook trampolines.
+ */
+export function installAllHooks(targetPath) {
+    const hooksDir = getHooksDir(targetPath);
+    if (!hooksDir) {
+        return { installed: [], skipped: "No .git directory found" };
+    }
+    fs.mkdirSync(hooksDir, { recursive: true });
+    const installed = [];
+    for (const hookType of HOOK_TYPES) {
+        installHook(hooksDir, hookType);
+        installed.push(hookType);
+    }
+    return { installed, skipped: null };
+}
+/**
+ * Uninstall all mapra hook trampolines.
+ */
+export function uninstallAllHooks(targetPath) {
+    const hooksDir = getHooksDir(targetPath);
+    if (!hooksDir)
+        return;
+    for (const hookType of HOOK_TYPES) {
+        uninstallHook(hooksDir, hookType);
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/cli/hooks.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * mapra CLI
+ *
+ * Commands:
+ *   mapra setup [path]    Generate .mapra and wire CLAUDE.md (first-time setup)
+ *   mapra generate [path] Scan codebase and write .mapra file
+ *   mapra update [path]   Regenerate .mapra in place (alias for generate in cwd)
+ *   mapra init [path]     Wire .mapra into project's CLAUDE.md
+ *   mapra status [path]   Show current mapra setup state
+ *   mapra check [path]    Check if .mapra is current or stale (git hash comparison)
+ *   mapra validate-plan <plan.md> [--since YYYY-MM-DD] [--checkpoints]  Cross-reference plan against .mapra
+ *   mapra batch <config.json> [--resume]  Run batch experiment from config
+ *   mapra analyze <results.json> [--advise] [--judge-check]  Analyze experiment results
+ *   mapra query <type> <file> [--json]  Query structural data (blast_radius, risk_profile, test_map)
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG"}