@mohantn/gate-keeper 2.1.0

package/dist/graph/graph-export.js

@@ -0,0 +1,264 @@
+"use strict";
+/**
+ * Graph export engine — produces graphify-compatible JSON, GraphML, and Neo4j Cypher.
+ *
+ * All formats capture the full node+edge structure so external tools (graph
+ * databases, visualizers, other repos) can consume gate-keeper analysis.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exportToJson = exportToJson;
+exports.exportToGraphML = exportToGraphML;
+exports.exportToNeo4j = exportToNeo4j;
+exports.exportToSvg = exportToSvg;
+exports.mergeGraphs = mergeGraphs;
+exports.exportGraph = exportGraph;
+const graph_algorithms_1 = require("./graph-algorithms");
+const surprising_connections_1 = require("./surprising-connections");
+const question_suggester_1 = require("./question-suggester");
+// ── JSON (graphify-compatible) ─────────────────────────────
+function exportToJson(nodes, edges, cycles, opts) {
+    const repoRoot = opts.repoRoot ?? '';
+    const centrality = (0, graph_algorithms_1.computeCentrality)(nodes, edges);
+    const godNodes = centrality.slice(0, 10).map(c => ({
+        id: c.path,
+        label: c.label,
+        inDegree: c.inDegree,
+        outDegree: c.outDegree,
+        totalDegree: c.totalDegree,
+        rating: c.rating,
+    }));
+    const surprising = repoRoot
+        ? (0, surprising_connections_1.findSurprisingConnections)(nodes, edges, repoRoot, 10)
+        : [];
+    const questions = repoRoot
+        ? (0, question_suggester_1.suggestQuestions)(nodes, edges, repoRoot, 5)
+        : [];
+    const graph = {
+        version: '2.0',
+        generatedAt: Date.now(),
+        repo: repoRoot,
+        overallRating: opts.overallRating ?? null,
+        nodes: nodes.map(n => ({
+            id: n.id,
+            type: 'file',
+            label: n.label,
+            rating: n.rating,
+            metrics: n.metrics ?? {},
+            violations: (n.violations ?? []).map(v => ({ type: v.type, severity: v.severity })),
+        })),
+        edges: edges.map(e => ({
+            source: e.source,
+            target: e.target,
+            type: (e.type ?? 'IMPORT').toUpperCase(),
+            confidence: 'EXTRACTED',
+            weight: e.strength ?? 1,
+        })),
+        godNodes,
+        surprisingConnections: surprising,
+        suggestedQuestions: questions.map(q => q.question),
+        cycles: cycles.map(c => c.nodes),
+    };
+    return JSON.stringify(graph, null, 2);
+}
+// ── GraphML ────────────────────────────────────────────────
+function exportToGraphML(nodes, edges) {
+    const lines = [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<graphml xmlns="http://graphml.graphdrawing.org/graphml">',
+        '  <key id="rating" for="node" attr.name="rating" attr.type="double"/>',
+        '  <key id="linesOfCode" for="node" attr.name="linesOfCode" attr.type="int"/>',
+        '  <key id="label" for="node" attr.name="label" attr.type="string"/>',
+        '  <key id="edgeType" for="edge" attr.name="type" attr.type="string"/>',
+        '  <key id="weight" for="edge" attr.name="weight" attr.type="double"/>',
+        '  <graph id="G" edgedefault="directed">',
+    ];
+    for (const n of nodes) {
+        const safeId = escapeXml(n.id);
+        lines.push(`    <node id="${safeId}">`);
+        lines.push(`      <data key="label">${escapeXml(n.label)}</data>`);
+        lines.push(`      <data key="rating">${n.rating}</data>`);
+        if (n.metrics?.linesOfCode !== undefined) {
+            lines.push(`      <data key="linesOfCode">${n.metrics.linesOfCode}</data>`);
+        }
+        lines.push('    </node>');
+    }
+    for (let i = 0; i < edges.length; i++) {
+        const e = edges[i];
+        lines.push(`    <edge id="e${i}" source="${escapeXml(e.source)}" target="${escapeXml(e.target)}">`);
+        lines.push(`      <data key="edgeType">${escapeXml(e.type ?? 'IMPORT')}</data>`);
+        lines.push(`      <data key="weight">${e.strength ?? 1}</data>`);
+        lines.push('    </edge>');
+    }
+    lines.push('  </graph>');
+    lines.push('</graphml>');
+    return lines.join('\n');
+}
+// ── Neo4j Cypher ───────────────────────────────────────────
+function exportToNeo4j(nodes, edges) {
+    const lines = [
+        '// Gate Keeper — Neo4j Cypher import script',
+        '// Run: cypher-shell < graph.cypher',
+        '',
+        '// Clear existing (optional):',
+        '// MATCH (n:File) DETACH DELETE n;',
+        '',
+        '// Nodes',
+    ];
+    for (const n of nodes) {
+        const props = [
+            `id: ${cyStr(n.id)}`,
+            `label: ${cyStr(n.label)}`,
+            `rating: ${n.rating}`,
+        ];
+        if (n.metrics?.linesOfCode !== undefined)
+            props.push(`linesOfCode: ${n.metrics.linesOfCode}`);
+        if (n.metrics?.cyclomaticComplexity !== undefined)
+            props.push(`complexity: ${n.metrics.cyclomaticComplexity}`);
+        lines.push(`CREATE (:File {${props.join(', ')}});`);
+    }
+    lines.push('', '// Relationships');
+    for (const e of edges) {
+        const relType = (e.type ?? 'IMPORT').replace(/\W/g, '_').toUpperCase();
+        lines.push(`MATCH (a:File {id: ${cyStr(e.source)}}), (b:File {id: ${cyStr(e.target)}}) ` +
+            `CREATE (a)-[:${relType} {weight: ${e.strength ?? 1}}]->(b);`);
+    }
+    return lines.join('\n');
+}
+// ── SVG (circular layout) ──────────────────────────────────
+/**
+ * Render the graph as SVG using a circular node layout.
+ * Nodes are placed evenly around a circle; edges are straight lines.
+ * Node colour encodes rating; node radius encodes in-degree.
+ */
+function exportToSvg(nodes, edges, opts = {}) {
+    const W = opts.width ?? 900;
+    const H = opts.height ?? 900;
+    const cx = W / 2;
+    const cy = H / 2;
+    const layoutR = Math.min(W, H) * 0.38;
+    const MIN_NR = 5;
+    const MAX_NR = 14;
+    // Compute in-degree for node sizing
+    const inDeg = new Map(nodes.map(n => [n.id, 0]));
+    for (const e of edges)
+        inDeg.set(e.target, (inDeg.get(e.target) ?? 0) + 1);
+    const maxIn = Math.max(1, ...inDeg.values());
+    // Circular positions
+    const pos = new Map();
+    nodes.forEach((n, i) => {
+        const angle = (2 * Math.PI * i) / Math.max(nodes.length, 1) - Math.PI / 2;
+        pos.set(n.id, { x: cx + layoutR * Math.cos(angle), y: cy + layoutR * Math.sin(angle) });
+    });
+    const ratingColor = (r) => r >= 8 ? '#4caf50' : r >= 6 ? '#ffc107' : r >= 4 ? '#ff9800' : '#f44336';
+    const nodeRadius = (id) => {
+        const d = inDeg.get(id) ?? 0;
+        return MIN_NR + ((d / maxIn) * (MAX_NR - MIN_NR));
+    };
+    const lines = [
+        `<svg xmlns="http://www.w3.org/2000/svg" width="${W}" height="${H}" viewBox="0 0 ${W} ${H}">`,
+        `<defs>`,
+        `  <marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5"`,
+        `    markerWidth="6" markerHeight="6" orient="auto-start-reverse">`,
+        `    <path d="M 0 0 L 10 5 L 0 10 z" fill="#ccc"/>`,
+        `  </marker>`,
+        `</defs>`,
+        `<style>`,
+        `  text { font-family: sans-serif; font-size: 9px; fill: #333; pointer-events: none; }`,
+        `  .edge { stroke: #ccc; stroke-width: 1; fill: none; marker-end: url(#arrow); }`,
+        `  .node { cursor: pointer; }`,
+        `  .node:hover circle { stroke-width: 3; }`,
+        `</style>`,
+        `<rect width="${W}" height="${H}" fill="#fafafa"/>`,
+        `<g class="edges">`,
+    ];
+    for (const e of edges) {
+        const s = pos.get(e.source);
+        const t = pos.get(e.target);
+        if (!s || !t || e.source === e.target)
+            continue;
+        // Shorten line so it doesn't overlap node circles
+        const tr = nodeRadius(e.target);
+        const dx = t.x - s.x;
+        const dy = t.y - s.y;
+        const len = Math.sqrt(dx * dx + dy * dy);
+        const ux = len > 0 ? dx / len : 0;
+        const uy = len > 0 ? dy / len : 0;
+        const tx = t.x - ux * (tr + 2);
+        const ty = t.y - uy * (tr + 2);
+        lines.push(`  <line class="edge" x1="${s.x.toFixed(1)}" y1="${s.y.toFixed(1)}" ` +
+            `x2="${tx.toFixed(1)}" y2="${ty.toFixed(1)}"/>`);
+    }
+    lines.push(`</g>`, `<g class="nodes">`);
+    for (const n of nodes) {
+        const p = pos.get(n.id);
+        if (!p)
+            continue;
+        const r = nodeRadius(n.id);
+        const color = ratingColor(n.rating);
+        const lx = p.x + r + 3;
+        const ly = p.y + 3;
+        lines.push(`  <g class="node">`, `    <title>${escapeXml(n.label)}: ${n.rating}/10, ` +
+            `${n.metrics?.linesOfCode ?? '?'} LOC, in-degree ${inDeg.get(n.id) ?? 0}</title>`, `    <circle cx="${p.x.toFixed(1)}" cy="${p.y.toFixed(1)}" r="${r.toFixed(1)}" ` +
+            `fill="${color}" stroke="white" stroke-width="1.5"/>`, `    <text x="${lx.toFixed(1)}" y="${ly.toFixed(1)}">${escapeXml(n.label)}</text>`, `  </g>`);
+    }
+    // Legend
+    const legend = [
+        { color: '#4caf50', label: '≥8 Excellent' },
+        { color: '#ffc107', label: '6–7.9 Good' },
+        { color: '#ff9800', label: '4–5.9 Poor' },
+        { color: '#f44336', label: '<4 Critical' },
+    ];
+    lines.push(`</g>`, `<g class="legend" transform="translate(12,${H - 80})">`);
+    legend.forEach(({ color, label }, i) => {
+        const y = i * 18;
+        lines.push(`  <circle cx="7" cy="${y}" r="6" fill="${color}"/>`, `  <text x="16" y="${y + 4}">${label}</text>`);
+    });
+    lines.push(`</g>`, `<text x="${W - 10}" y="${H - 6}" font-size="8" fill="#aaa" text-anchor="end">` +
+        `Gate Keeper — ${nodes.length} files, ${edges.length} edges</text>`, `</svg>`);
+    return lines.join('\n');
+}
+function mergeGraphs(graphA, graphB) {
+    const nodeMap = new Map();
+    const conflicts = [];
+    for (const n of graphA.nodes)
+        nodeMap.set(n.id, n);
+    for (const n of graphB.nodes) {
+        const existing = nodeMap.get(n.id);
+        if (existing && existing.rating !== n.rating) {
+            // Conflict: take the minimum rating (conservative / most honest)
+            const resolved = Math.min(existing.rating, n.rating);
+            conflicts.push({ id: n.id, ratingA: existing.rating, ratingB: n.rating, resolved });
+            nodeMap.set(n.id, { ...n, rating: resolved });
+        }
+        else {
+            nodeMap.set(n.id, n);
+        }
+    }
+    // Union edges, deduplicating by source+target
+    const edgeSet = new Set();
+    const edges = [];
+    for (const e of [...graphA.edges, ...graphB.edges]) {
+        const key = `${e.source}→${e.target}`;
+        if (!edgeSet.has(key)) {
+            edgeSet.add(key);
+            edges.push(e);
+        }
+    }
+    return { nodes: [...nodeMap.values()], edges, conflicts };
+}
+// ── Dispatch ───────────────────────────────────────────────
+function exportGraph(nodes, edges, cycles, opts) {
+    switch (opts.format) {
+        case 'json': return exportToJson(nodes, edges, cycles, opts);
+        case 'graphml': return exportToGraphML(nodes, edges);
+        case 'neo4j': return exportToNeo4j(nodes, edges);
+        case 'svg': return exportToSvg(nodes, edges);
+    }
+}
+function escapeXml(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+function cyStr(s) {
+    return `'${s.replace(/'/g, "\\'")}'`;
+}
+//# sourceMappingURL=graph-export.js.map

package/dist/graph/graph-export.js.map

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

package/dist/graph/graph-report.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Narrative knowledge-graph report generator (graphify-style GRAPH_REPORT.md).
+ *
+ * Produces a Markdown document with:
+ *  - God nodes (highest centrality)
+ *  - Surprising cross-module connections
+ *  - Auto-generated suggested questions
+ *  - Architecture overview (module breakdown + cycles)
+ *
+ * Pure function — no I/O, no daemon dependency.
+ */
+interface GNode {
+    id: string;
+    label: string;
+    rating: number;
+    metrics?: {
+        linesOfCode?: number;
+    };
+}
+interface GEdge {
+    source: string;
+    target: string;
+}
+interface CycleInfo {
+    nodes: string[];
+}
+export interface GraphReportOptions {
+    topGodNodes?: number;
+    topSurprising?: number;
+    maxQuestions?: number;
+}
+export declare function generateGraphReport(nodes: ReadonlyArray<GNode>, edges: ReadonlyArray<GEdge>, cycles: ReadonlyArray<CycleInfo>, repoRoot: string, overallRating: number | null, opts?: GraphReportOptions): string;
+export {};
+//# sourceMappingURL=graph-report.d.ts.map

package/dist/graph/graph-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-report.d.ts","sourceRoot":"","sources":["../../src/graph/graph-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,UAAU,KAAK;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE;AACjG,UAAU,KAAK;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAClD,UAAU,SAAS;IAAG,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE;AAEvC,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,EAC3B,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,EAC3B,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,IAAI,GAAE,kBAAuB,GAC5B,MAAM,CAqGR"}

package/dist/graph/graph-report.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Narrative knowledge-graph report generator (graphify-style GRAPH_REPORT.md).
+ *
+ * Produces a Markdown document with:
+ *  - God nodes (highest centrality)
+ *  - Surprising cross-module connections
+ *  - Auto-generated suggested questions
+ *  - Architecture overview (module breakdown + cycles)
+ *
+ * Pure function — no I/O, no daemon dependency.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateGraphReport = generateGraphReport;
+const path = __importStar(require("path"));
+const graph_algorithms_1 = require("./graph-algorithms");
+const surprising_connections_1 = require("./surprising-connections");
+const question_suggester_1 = require("./question-suggester");
+function generateGraphReport(nodes, edges, cycles, repoRoot, overallRating, opts = {}) {
+    const { topGodNodes = 5, topSurprising = 5, maxQuestions = 5 } = opts;
+    const repoName = path.basename(repoRoot);
+    const centrality = (0, graph_algorithms_1.computeCentrality)(nodes, edges);
+    const godNodes = centrality.slice(0, topGodNodes);
+    const surprising = (0, surprising_connections_1.findSurprisingConnections)(nodes, edges, repoRoot, topSurprising);
+    const questions = (0, question_suggester_1.suggestQuestions)(nodes, edges, repoRoot, maxQuestions);
+    const lines = [];
+    lines.push(`# Knowledge Graph: ${repoName}`);
+    lines.push('');
+    lines.push(`**Files:** ${nodes.length} | **Relationships:** ${edges.length} | ` +
+        `**Overall Quality:** ${overallRating?.toFixed(1) ?? 'N/A'}/10 | ` +
+        `**Cycles:** ${cycles.length}`);
+    lines.push('');
+    // God Nodes
+    if (godNodes.length > 0) {
+        lines.push('## God Nodes (Highest Blast Radius)');
+        lines.push('_These files are most dangerous to change — many others depend on them._');
+        lines.push('');
+        for (let i = 0; i < godNodes.length; i++) {
+            const n = godNodes[i];
+            const rel = path.relative(repoRoot, n.path);
+            const riskIcon = n.rating < 6 ? '🔴' : n.rating < 8 ? '🟡' : '🟢';
+            lines.push(`${i + 1}. ${riskIcon} **${rel}** — ${n.totalDegree} connections ` +
+                `(in: ${n.inDegree}, out: ${n.outDegree}), rating ${n.rating}/10`);
+        }
+        lines.push('');
+    }
+    // Surprising Connections
+    if (surprising.length > 0) {
+        lines.push('## Surprising Connections');
+        lines.push('_Cross-module dependencies that may indicate unexpected coupling._');
+        lines.push('');
+        for (const s of surprising) {
+            const src = path.relative(repoRoot, s.source);
+            const tgt = path.relative(repoRoot, s.target);
+            lines.push(`- **${src}** → **${tgt}**`);
+            lines.push(`  _${s.explanation}_`);
+        }
+        lines.push('');
+    }
+    // Suggested Questions
+    if (questions.length > 0) {
+        lines.push('## Suggested Questions');
+        lines.push('_Questions the graph is positioned to answer with a single MCP call._');
+        lines.push('');
+        questions.forEach((q, i) => {
+            lines.push(`${i + 1}. ${q.question}`);
+            lines.push(`   → \`${q.tool}\` with \`${JSON.stringify(q.params)}\``);
+        });
+        lines.push('');
+    }
+    // Architecture Overview
+    lines.push('## Architecture Overview');
+    const moduleCounts = new Map();
+    const moduleRatings = new Map();
+    for (const n of nodes) {
+        const mod = (0, surprising_connections_1.getModule)(n.id, repoRoot);
+        moduleCounts.set(mod, (moduleCounts.get(mod) ?? 0) + 1);
+        (moduleRatings.get(mod) ?? moduleRatings.set(mod, []).get(mod)).push(n.rating);
+    }
+    const moduleList = [...moduleCounts.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 8);
+    lines.push('');
+    lines.push('| Module | Files | Avg Rating |');
+    lines.push('|--------|-------|------------|');
+    for (const [mod, count] of moduleList) {
+        const ratings = moduleRatings.get(mod) ?? [];
+        const avg = ratings.length > 0
+            ? (ratings.reduce((s, r) => s + r, 0) / ratings.length).toFixed(1)
+            : 'N/A';
+        lines.push(`| ${mod} | ${count} | ${avg}/10 |`);
+    }
+    if (cycles.length > 0) {
+        lines.push('');
+        lines.push(`⚠️ **${cycles.length} circular dependency cycle${cycles.length !== 1 ? 's' : ''} detected** ` +
+            `— each costs −1.0 rating. Run \`get_graph_summary\` to see the full list.`);
+    }
+    lines.push('');
+    lines.push('---');
+    lines.push(`_Generated by Gate Keeper at ${new Date().toISOString()}_`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=graph-report.js.map

package/dist/graph/graph-report.js.map

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

package/dist/graph/graph-summary.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Pre-computed analytics for the dependency graph response.
+ *
+ * Surfaces the signals AI agents otherwise have to derive with custom code:
+ * rating distribution, top fan-in / fan-out hotspots, worst-rated files, and
+ * cross-module coupling. All functions are pure and operate on the raw
+ * GraphResponse shape from the daemon.
+ */
+export interface GraphNodeInput {
+    id: string;
+    rating: number;
+    label?: string;
+    metrics: {
+        linesOfCode: number;
+    };
+    violations: ReadonlyArray<unknown>;
+}
+export interface GraphEdgeInput {
+    source: string;
+    target: string;
+    type: string;
+}
+export interface CycleInput {
+    nodes: string[];
+}
+export interface HotspotEntry {
+    path: string;
+    inDegree: number;
+    outDegree: number;
+    rating: number;
+    loc: number;
+    /** High fan-in + below-threshold rating = hub that's risky to change */
+    fragileHub?: boolean;
+}
+export interface WorstFileEntry {
+    path: string;
+    rating: number;
+    loc: number;
+    violations: number;
+}
+export interface ModuleCouplingEntry {
+    from: string;
+    to: string;
+    count: number;
+}
+export interface RatingDistribution {
+    excellent: number;
+    good: number;
+    warning: number;
+    critical: number;
+}
+export interface GraphSummary {
+    fileCount: number;
+    edgeCount: number;
+    cycleCount: number;
+    avgRating: number;
+    ratingDistribution: RatingDistribution;
+    mostDependedOn: HotspotEntry[];
+    mostDependencies: HotspotEntry[];
+    worstFiles: WorstFileEntry[];
+    moduleCoupling: ModuleCouplingEntry[];
+}
+/** Derive a stable module label from a file path, handling sub-projects. */
+export declare function moduleOf(filePath: string, repo: string): string;
+export declare function buildGraphSummary(nodes: ReadonlyArray<GraphNodeInput>, edges: ReadonlyArray<GraphEdgeInput>, cycles: ReadonlyArray<CycleInput>, repo: string): GraphSummary;
+/** Format the summary as compact markdown for the human-readable channel. */
+export declare function formatGraphSummaryMarkdown(summary: GraphSummary, repo: string): string;
+//# sourceMappingURL=graph-summary.d.ts.map

package/dist/graph/graph-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-summary.d.ts","sourceRoot":"","sources":["../../src/graph/graph-summary.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACjC,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,cAAc,EAAE,mBAAmB,EAAE,CAAC;CACvC;AAOD,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAO/D;AAuFD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,EACpC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,EACpC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EACjC,IAAI,EAAE,MAAM,GACX,YAAY,CAmBd;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CA6DtF"}