@monoes/monomindcli 1.6.4 → 1.6.5

package/bundled-graph/dist/src/report.js

@@ -0,0 +1,214 @@
+/**
+ * Generate GRAPH_REPORT.md — the human-readable audit trail.
+ * Mirrors the output format of Python graphify's report.py.
+ */
+import { basename } from 'path';
+import { cohesionScore } from './cluster.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** True if the node label matches its own filename — AST file-hub node. */
+function isFileNode(graph, nodeId) {
+    const label = graph.getNodeAttribute(nodeId, 'label') || '';
+    const sourceFile = graph.getNodeAttribute(nodeId, 'sourceFile') || '';
+    if (!label || !sourceFile)
+        return false;
+    if (label === basename(sourceFile))
+        return true;
+    if (label.startsWith('.') && label.endsWith('()'))
+        return true;
+    return false;
+}
+/** Auto-derive a community label from its member nodes' source directories. */
+function communityLabel(graph, memberIds) {
+    const dirCounts = {};
+    for (const id of memberIds) {
+        const src = graph.getNodeAttribute(id, 'sourceFile') || '';
+        if (!src)
+            continue;
+        const parts = src.split('/');
+        const dir = parts.length > 1 ? parts[parts.length - 2] : parts[0];
+        dirCounts[dir] = (dirCounts[dir] ?? 0) + 1;
+    }
+    const sorted = Object.entries(dirCounts).sort(([, a], [, b]) => b - a);
+    return sorted.length > 0 ? sorted[0][0] : 'misc';
+}
+// ---------------------------------------------------------------------------
+// Main generator
+// ---------------------------------------------------------------------------
+/**
+ * Generate the full markdown report string.
+ *
+ * @param graph     - The annotated Graphology graph (with `community` attributes set)
+ * @param analysis  - Result of buildAnalysis()
+ * @param cohesionScores - Map of communityId → cohesion score (0–1)
+ * @param options   - Optional metadata (projectPath, tokenCost, corpusStats, questions)
+ */
+export function generateReport(graph, analysis, cohesionScores, options = {}) {
+    const today = new Date().toISOString().split('T')[0];
+    const root = options.projectPath ?? '.';
+    const scores = cohesionScores ?? {};
+    // Confidence breakdown
+    const totalEdges = graph.size || 1;
+    const confCounts = {};
+    const infScores = [];
+    graph.forEachEdge((_, attrs) => {
+        const c = attrs.confidence || 'EXTRACTED';
+        confCounts[c] = (confCounts[c] ?? 0) + 1;
+        if (c === 'INFERRED') {
+            const cs = attrs.confidenceScore;
+            if (cs !== undefined)
+                infScores.push(cs);
+        }
+    });
+    const extPct = Math.round((confCounts['EXTRACTED'] ?? 0) / totalEdges * 100);
+    const infPct = Math.round((confCounts['INFERRED'] ?? 0) / totalEdges * 100);
+    const ambPct = Math.round((confCounts['AMBIGUOUS'] ?? 0) / totalEdges * 100);
+    const infAvg = infScores.length > 0
+        ? (infScores.reduce((a, b) => a + b, 0) / infScores.length).toFixed(2)
+        : null;
+    const lines = [
+        `# Graph Report - ${root}  (${today})`,
+        '',
+        '## Corpus Check',
+    ];
+    // Corpus check
+    const cs = options.corpusStats;
+    if (cs?.warning) {
+        lines.push(`- ${cs.warning}`);
+    }
+    else if (cs) {
+        lines.push(`- ${cs.totalFiles} files · ~${cs.totalWords.toLocaleString()} words`);
+        lines.push('- Verdict: corpus is large enough that graph structure adds value.');
+    }
+    // Summary
+    const infEdgeCount = confCounts['INFERRED'] ?? 0;
+    const infTag = infAvg !== null
+        ? ` · INFERRED: ${infEdgeCount} edges (avg confidence: ${infAvg})`
+        : '';
+    const tokenCost = options.tokenCost;
+    lines.push('', '## Summary');
+    lines.push(`- ${graph.order} nodes · ${graph.size} edges · ${analysis.stats.communities} communities detected`);
+    lines.push(`- Extraction: ${extPct}% EXTRACTED · ${infPct}% INFERRED · ${ambPct}% AMBIGUOUS${infTag}`);
+    if (tokenCost) {
+        lines.push(`- Token cost: ${tokenCost.input.toLocaleString()} input · ${tokenCost.output.toLocaleString()} output`);
+    }
+    // God nodes
+    lines.push('', '## God Nodes (most connected - your core abstractions)');
+    analysis.godNodes.forEach((node, i) => {
+        lines.push(`${i + 1}. \`${node.label}\` - ${node.degree} edges`);
+    });
+    // Surprising connections
+    lines.push('', '## Surprising Connections (you probably didn\'t know these)');
+    if (analysis.surprises.length > 0) {
+        for (const s of analysis.surprises) {
+            const conf = s.confidence;
+            const confTag = conf === 'INFERRED'
+                ? `INFERRED ${s.confidenceScore?.toFixed(2) ?? ''}`
+                : conf;
+            const semTag = s.relation === 'semantically_similar_to' ? ' [semantically similar]' : '';
+            lines.push(`- \`${s.from}\` --${s.relation}--> \`${s.to}\`  [${confTag}]${semTag}`);
+            lines.push(`  ${s.fromFile} → ${s.toFile}`);
+        }
+    }
+    else {
+        lines.push('- None detected - all connections are within the same source files.');
+    }
+    // Hyperedges (stored in graph metadata)
+    const hyperedges = graph.getAttribute('hyperedges') ?? [];
+    if (hyperedges.length > 0) {
+        lines.push('', '## Hyperedges (group relationships)');
+        for (const h of hyperedges) {
+            const he = h;
+            const nodeLabels = (he.nodes ?? []).join(', ');
+            const conf = he.confidence ?? 'INFERRED';
+            const cs2 = he.confidenceScore;
+            const confTag = cs2 !== undefined ? `${conf} ${cs2.toFixed(2)}` : conf;
+            lines.push(`- **${he.label ?? ''}** — ${nodeLabels} [${confTag}]`);
+        }
+    }
+    // Communities
+    lines.push('', '## Communities');
+    for (const [cidStr, memberIds] of Object.entries(analysis.communities)) {
+        const cid = Number(cidStr);
+        const label = communityLabel(graph, memberIds);
+        const score = scores[cid] !== undefined ? scores[cid] : cohesionScore(graph, memberIds);
+        const realNodes = memberIds.filter((id) => graph.hasNode(id) && !isFileNode(graph, id));
+        const display = realNodes
+            .slice(0, 8)
+            .map((id) => graph.getNodeAttribute(id, 'label') || id);
+        const suffix = realNodes.length > 8 ? ` (+${realNodes.length - 8} more)` : '';
+        lines.push('');
+        lines.push(`### Community ${cid} - "${label}"`);
+        lines.push(`Cohesion: ${score.toFixed(2)}`);
+        lines.push(`Nodes (${realNodes.length}): ${display.join(', ')}${suffix}`);
+    }
+    // Ambiguous edges
+    const ambiguous = [];
+    graph.forEachEdge((_, attrs, source, target) => {
+        if (attrs.confidence === 'AMBIGUOUS') {
+            ambiguous.push({ u: source, v: target, attrs: attrs });
+        }
+    });
+    if (ambiguous.length > 0) {
+        lines.push('', '## Ambiguous Edges - Review These');
+        for (const { u, v, attrs } of ambiguous) {
+            const ul = graph.getNodeAttribute(u, 'label') || u;
+            const vl = graph.getNodeAttribute(v, 'label') || v;
+            lines.push(`- \`${ul}\` → \`${vl}\`  [AMBIGUOUS]`);
+            lines.push(`  ${attrs.sourceFile || ''} · relation: ${attrs.relation || 'unknown'}`);
+        }
+    }
+    // Knowledge gaps
+    const isolated = [];
+    graph.forEachNode((id) => {
+        if (graph.degree(id) <= 1 && !isFileNode(graph, id)) {
+            isolated.push(id);
+        }
+    });
+    const thinCommunities = Object.entries(analysis.communities).filter(([, nodes]) => nodes.length < 3);
+    const gapCount = isolated.length + thinCommunities.length;
+    if (gapCount > 0 || ambPct > 20) {
+        lines.push('', '## Knowledge Gaps');
+        if (isolated.length > 0) {
+            const labels = isolated
+                .slice(0, 5)
+                .map((id) => graph.getNodeAttribute(id, 'label') || id);
+            const suffix = isolated.length > 5 ? ` (+${isolated.length - 5} more)` : '';
+            lines.push(`- **${isolated.length} isolated node(s):** ${labels.map((l) => `\`${l}\``).join(', ')}${suffix}`);
+            lines.push('  These have ≤1 connection - possible missing edges or undocumented components.');
+        }
+        for (const [cidStr, nodes] of thinCommunities) {
+            const cid = Number(cidStr);
+            const label = communityLabel(graph, nodes);
+            const nodeLabels = nodes
+                .map((id) => graph.getNodeAttribute(id, 'label') || id);
+            lines.push(`- **Thin community \`${label}\`** (${nodes.length} nodes): ${nodeLabels.map((l) => `\`${l}\``).join(', ')}`);
+            lines.push('  Too small to be a meaningful cluster - may be noise or needs more connections extracted.');
+        }
+        if (ambPct > 20) {
+            lines.push(`- **High ambiguity: ${ambPct}% of edges are AMBIGUOUS.** Review the Ambiguous Edges section above.`);
+        }
+    }
+    // Suggested questions
+    const questions = options.questions ?? [];
+    if (questions.length > 0) {
+        lines.push('', '## Suggested Questions');
+        const noSignal = questions.length === 1 && questions[0].type === 'ISOLATED_NODE' && questions[0].nodes.length === 0;
+        if (noSignal) {
+            lines.push(`_${questions[0].question}_`);
+        }
+        else {
+            lines.push('_Questions this graph is uniquely positioned to answer:_');
+            lines.push('');
+            for (const q of questions) {
+                if (q.question) {
+                    lines.push(`- **${q.question}**`);
+                    lines.push(`  _Priority: ${q.priority}. Nodes: ${q.nodes.slice(0, 3).map((n) => `\`${n}\``).join(', ')}_`);
+                }
+            }
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=report.js.map

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

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

package/bundled-graph/dist/src/types.d.ts

@@ -0,0 +1,124 @@
+export type Confidence = 'EXTRACTED' | 'INFERRED' | 'AMBIGUOUS';
+export type FileType = 'code' | 'document' | 'paper' | 'image' | 'unknown';
+export interface GraphNode {
+    id: string;
+    label: string;
+    fileType: FileType;
+    sourceFile: string;
+    sourceLocation?: string;
+    community?: number;
+    degree?: number;
+    [key: string]: unknown;
+}
+export interface GraphEdge {
+    source: string;
+    target: string;
+    relation: string;
+    confidence: Confidence;
+    confidenceScore?: number;
+    sourceFile?: string;
+    sourceLocation?: string;
+    weight?: number;
+}
+export interface ExtractionResult {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    hyperedges?: HyperEdge[];
+    filesProcessed: number;
+    fromCache: number;
+    errors: string[];
+}
+export interface HyperEdge {
+    label: string;
+    nodes: string[];
+    confidence: Confidence;
+    confidenceScore?: number;
+}
+export interface GraphAnalysis {
+    godNodes: GodNode[];
+    surprises: SurpriseEdge[];
+    communities: Record<number, string[]>;
+    stats: GraphStats;
+}
+export interface GodNode {
+    id: string;
+    label: string;
+    degree: number;
+    community?: number;
+    sourceFile: string;
+    neighbors: string[];
+}
+export interface SurpriseEdge {
+    from: string;
+    fromCommunity: number;
+    fromFile: string;
+    to: string;
+    toCommunity: number;
+    toFile: string;
+    relation: string;
+    confidence: Confidence;
+    score: number;
+}
+export interface GraphStats {
+    nodes: number;
+    edges: number;
+    communities: number;
+    confidence: Record<Confidence, number>;
+    fileTypes: Record<string, number>;
+    topRelations: Record<string, number>;
+    isDirected: boolean;
+    graphPath?: string;
+}
+export interface SerializedGraph {
+    version: string;
+    builtAt: string;
+    projectPath: string;
+    nodes: Array<{
+        id: string;
+    } & Record<string, unknown>>;
+    links: Array<{
+        source: string;
+        target: string;
+    } & Record<string, unknown>>;
+    directed: boolean;
+    multigraph: boolean;
+}
+export interface BuildOptions {
+    codeOnly?: boolean;
+    outputDir?: string;
+    maxFileSizeBytes?: number;
+    excludePatterns?: string[];
+    languages?: string[];
+}
+export interface ClassifiedFile {
+    path: string;
+    fileType: FileType;
+    language?: string;
+    sizeBytes: number;
+}
+export interface GraphQuestion {
+    type: 'AMBIGUOUS_EDGE' | 'BRIDGE_NODE' | 'INFERRED_GOD_NODE' | 'ISOLATED_NODE' | 'LOW_COHESION_COMMUNITY';
+    question: string;
+    nodes: string[];
+    priority: 'high' | 'medium' | 'low';
+}
+export interface GraphDiff {
+    addedNodes: string[];
+    removedNodes: string[];
+    addedEdges: Array<{
+        source: string;
+        target: string;
+        relation: string;
+    }>;
+    removedEdges: Array<{
+        source: string;
+        target: string;
+        relation: string;
+    }>;
+    communityChanges: Array<{
+        node: string;
+        oldCommunity: number;
+        newCommunity: number;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/bundled-graph/dist/src/types.d.ts.map

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

package/bundled-graph/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/bundled-graph/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/bundled-graph/dist/src/visualize.d.ts

@@ -0,0 +1,4 @@
+import type { SerializedGraph } from './types.js';
+/** Export a rich, self-contained HTML knowledge graph explorer using vis-network. */
+export declare function exportHTML(serialized: SerializedGraph, outputDir: string): string;
+//# sourceMappingURL=visualize.d.ts.map

package/bundled-graph/dist/src/visualize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualize.d.ts","sourceRoot":"","sources":["../../src/visualize.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAoBlD,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAwjBjF"}