@monoes/monomindcli 1.6.4 → 1.6.6

package/bundled-graph/dist/src/extract/tree-sitter-runner.d.ts

@@ -0,0 +1,48 @@
+import type { ExtractionResult } from '../types.js';
+import type { LanguageExtractor } from './types.js';
+type ParserInstance = {
+    setLanguage(lang: unknown): void;
+    parse(src: string): {
+        rootNode: SyntaxNodeLike;
+    };
+};
+export type SyntaxNodeLike = {
+    type: string;
+    text: string;
+    startPosition: {
+        row: number;
+        column: number;
+    };
+    endPosition: {
+        row: number;
+        column: number;
+    };
+    children: SyntaxNodeLike[];
+    childForFieldName(name: string): SyntaxNodeLike | null;
+    descendantsOfType(type: string | string[]): SyntaxNodeLike[];
+};
+/**
+ * Returns true when node-tree-sitter is installed and loadable.
+ */
+export declare function isTreeSitterAvailable(): boolean;
+/**
+ * Attempts to create a configured Parser for the given language identifier.
+ * Returns null when tree-sitter or the grammar is not installed.
+ */
+export declare function tryLoadParser(language: string): ParserInstance | null;
+export declare function walk(node: SyntaxNodeLike, visitor: (n: SyntaxNodeLike) => void): void;
+/**
+ * Parses a source file and delegates to the given LanguageExtractor.
+ * The extractor receives the file path and raw content; it owns the AST
+ * traversal internally (using tryLoadParser / walk from this module).
+ *
+ * Falls back gracefully: if tree-sitter cannot be loaded the extractor is still
+ * called with the raw content and is expected to use its regex fallback.
+ */
+export declare function parseFile(filePath: string, content: string, extractor: LanguageExtractor): ExtractionResult;
+/**
+ * Convenience helper: read a file from disk and parse it.
+ */
+export declare function parseFileFromDisk(filePath: string, extractor: LanguageExtractor): ExtractionResult;
+export {};
+//# sourceMappingURL=tree-sitter-runner.d.ts.map

package/bundled-graph/dist/src/extract/tree-sitter-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-sitter-runner.d.ts","sourceRoot":"","sources":["../../../src/extract/tree-sitter-runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpD,KAAK,cAAc,GAAG;IACpB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,cAAc,CAAA;KAAE,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,WAAW,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IACvD,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC;CAC9D,CAAC;AA4BF;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAG/C;AAuBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CA2BrE;AAID,wBAAgB,IAAI,CAClB,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,GACnC,IAAI,CAKN;AAID;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,iBAAiB,GAC3B,gBAAgB,CAclB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,iBAAiB,GAC3B,gBAAgB,CAgBlB"}

package/bundled-graph/dist/src/extract/tree-sitter-runner.js

@@ -0,0 +1,137 @@
+import { readFileSync } from 'fs';
+// ---- availability probe ----
+let _treeSitterAvailable = null;
+let _ParserCtor = null;
+function probeTreeSitter() {
+    if (_treeSitterAvailable !== null)
+        return;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const mod = require('node-tree-sitter');
+        const ctor = mod.default !== undefined
+            ? mod.default
+            : mod;
+        if (typeof ctor === 'function') {
+            _ParserCtor = ctor;
+            _treeSitterAvailable = true;
+        }
+        else {
+            _treeSitterAvailable = false;
+        }
+    }
+    catch {
+        _treeSitterAvailable = false;
+    }
+}
+/**
+ * Returns true when node-tree-sitter is installed and loadable.
+ */
+export function isTreeSitterAvailable() {
+    probeTreeSitter();
+    return _treeSitterAvailable === true;
+}
+// ---- language grammar loader ----
+const LANGUAGE_MODULE_MAP = {
+    typescript: 'tree-sitter-typescript',
+    tsx: 'tree-sitter-typescript',
+    javascript: 'tree-sitter-javascript',
+    jsx: 'tree-sitter-javascript',
+    python: 'tree-sitter-python',
+    go: 'tree-sitter-go',
+    rust: 'tree-sitter-rust',
+    java: 'tree-sitter-java',
+    c: 'tree-sitter-c',
+    cpp: 'tree-sitter-cpp',
+    csharp: 'tree-sitter-c-sharp',
+    ruby: 'tree-sitter-ruby',
+    kotlin: 'tree-sitter-kotlin',
+    swift: 'tree-sitter-swift',
+    scala: 'tree-sitter-scala',
+    php: 'tree-sitter-php',
+};
+/**
+ * Attempts to create a configured Parser for the given language identifier.
+ * Returns null when tree-sitter or the grammar is not installed.
+ */
+export function tryLoadParser(language) {
+    if (!isTreeSitterAvailable() || _ParserCtor === null)
+        return null;
+    const moduleName = LANGUAGE_MODULE_MAP[language];
+    if (!moduleName)
+        return null;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const grammarMod = require(moduleName);
+        // tree-sitter-typescript exposes { typescript, tsx } sub-grammars
+        let grammar;
+        if (language === 'typescript' || language === 'tsx') {
+            grammar =
+                grammarMod[language] ??
+                    grammarMod['default'] ??
+                    grammarMod;
+        }
+        else {
+            grammar = grammarMod['default'] ?? grammarMod;
+        }
+        const parser = new _ParserCtor();
+        parser.setLanguage(grammar);
+        return parser;
+    }
+    catch {
+        return null;
+    }
+}
+// ---- depth-first AST walker ----
+export function walk(node, visitor) {
+    visitor(node);
+    for (const child of node.children) {
+        walk(child, visitor);
+    }
+}
+// ---- main entry point ----
+/**
+ * Parses a source file and delegates to the given LanguageExtractor.
+ * The extractor receives the file path and raw content; it owns the AST
+ * traversal internally (using tryLoadParser / walk from this module).
+ *
+ * Falls back gracefully: if tree-sitter cannot be loaded the extractor is still
+ * called with the raw content and is expected to use its regex fallback.
+ */
+export function parseFile(filePath, content, extractor) {
+    try {
+        return extractor.extract(filePath, content);
+    }
+    catch (err) {
+        return {
+            nodes: [],
+            edges: [],
+            filesProcessed: 1,
+            fromCache: 0,
+            errors: [
+                `parseFile error for ${filePath}: ${err instanceof Error ? err.message : String(err)}`,
+            ],
+        };
+    }
+}
+/**
+ * Convenience helper: read a file from disk and parse it.
+ */
+export function parseFileFromDisk(filePath, extractor) {
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf8');
+    }
+    catch (err) {
+        return {
+            nodes: [],
+            edges: [],
+            filesProcessed: 1,
+            fromCache: 0,
+            errors: [
+                `Failed to read ${filePath}: ${err instanceof Error ? err.message : String(err)}`,
+            ],
+        };
+    }
+    return parseFile(filePath, content, extractor);
+}
+//# sourceMappingURL=tree-sitter-runner.js.map

package/bundled-graph/dist/src/extract/tree-sitter-runner.js.map

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

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

@@ -0,0 +1,7 @@
+import type { ExtractionResult } from '../types.js';
+export interface LanguageExtractor {
+    language: string;
+    extensions: string[];
+    extract(filePath: string, content: string): ExtractionResult;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/extract/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAAC;CAC9D"}

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

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

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

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

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

@@ -0,0 +1,28 @@
+export { buildGraph } from './pipeline.js';
+export { FileCache } from './cache.js';
+export { collectFiles, loadIgnorePatterns, corpusHealth } from './detect.js';
+export { buildGraph as buildGraphologyGraph } from './build.js';
+export { detectCommunities, cohesionScore, splitOversizedCommunities } from './cluster.js';
+export { buildAnalysis, godNodes, surprisingConnections, graphStats, suggestQuestions, graphDiff } from './analyze.js';
+export { saveGraph, loadGraph, graphExists, getGraphPath } from './export.js';
+export { exportHTML } from './visualize.js';
+export { generateReport } from './report.js';
+export { extractSemantic } from './extract/semantic.js';
+export type { SemanticFile, SemanticOptions } from './extract/semantic.js';
+export { isTreeSitterAvailable, tryLoadParser, parseFile, parseFileFromDisk } from './extract/tree-sitter-runner.js';
+export type { LanguageExtractor } from './extract/types.js';
+export { typescriptExtractor } from './extract/languages/typescript.js';
+export { pythonExtractor } from './extract/languages/python.js';
+export { goExtractor } from './extract/languages/go.js';
+export { rustExtractor } from './extract/languages/rust.js';
+export { javaExtractor } from './extract/languages/java.js';
+export { cExtractor } from './extract/languages/c.js';
+export { cppExtractor } from './extract/languages/cpp.js';
+export { csharpExtractor } from './extract/languages/csharp.js';
+export { rubyExtractor } from './extract/languages/ruby.js';
+export { kotlinExtractor } from './extract/languages/kotlin.js';
+export { swiftExtractor } from './extract/languages/swift.js';
+export { scalaExtractor } from './extract/languages/scala.js';
+export { phpExtractor } from './extract/languages/php.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,UAAU,IAAI,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,qBAAqB,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACvH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACrH,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,mBAAmB,YAAY,CAAC"}

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

@@ -0,0 +1,26 @@
+export { buildGraph } from './pipeline.js';
+export { FileCache } from './cache.js';
+export { collectFiles, loadIgnorePatterns, corpusHealth } from './detect.js';
+export { buildGraph as buildGraphologyGraph } from './build.js';
+export { detectCommunities, cohesionScore, splitOversizedCommunities } from './cluster.js';
+export { buildAnalysis, godNodes, surprisingConnections, graphStats, suggestQuestions, graphDiff } from './analyze.js';
+export { saveGraph, loadGraph, graphExists, getGraphPath } from './export.js';
+export { exportHTML } from './visualize.js';
+export { generateReport } from './report.js';
+export { extractSemantic } from './extract/semantic.js';
+export { isTreeSitterAvailable, tryLoadParser, parseFile, parseFileFromDisk } from './extract/tree-sitter-runner.js';
+// Language extractors
+export { typescriptExtractor } from './extract/languages/typescript.js';
+export { pythonExtractor } from './extract/languages/python.js';
+export { goExtractor } from './extract/languages/go.js';
+export { rustExtractor } from './extract/languages/rust.js';
+export { javaExtractor } from './extract/languages/java.js';
+export { cExtractor } from './extract/languages/c.js';
+export { cppExtractor } from './extract/languages/cpp.js';
+export { csharpExtractor } from './extract/languages/csharp.js';
+export { rubyExtractor } from './extract/languages/ruby.js';
+export { kotlinExtractor } from './extract/languages/kotlin.js';
+export { swiftExtractor } from './extract/languages/swift.js';
+export { scalaExtractor } from './extract/languages/scala.js';
+export { phpExtractor } from './extract/languages/php.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,UAAU,IAAI,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,qBAAqB,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACvH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAErH,sBAAsB;AACtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { BuildOptions, GraphAnalysis, SerializedGraph, GraphQuestion } from './types.js';
+/**
+ * Main entry point for building a knowledge graph from a codebase.
+ *
+ * Orchestrates file collection, per-file extraction (with caching),
+ * graph construction via graphology, community detection, and serialisation.
+ *
+ * @param projectPath - Absolute path to the root of the codebase to analyse.
+ * @param options     - Optional build configuration.
+ * @returns           - Serialized graph + analysis summary.
+ */
+export interface BuildResult {
+    graph: SerializedGraph;
+    analysis: GraphAnalysis;
+    questions: GraphQuestion[];
+    corpusWarnings: string[];
+    filesProcessed: number;
+    fromCache: number;
+    graphPath: string;
+    reportPath: string;
+    /** Graph quality scalar: avgCohesion × ln(1 + avgDegree). Higher is better. */
+    graphQuality: number;
+    /** Experiment loop status — mirrors autoresearch's keep/discard protocol. */
+    experimentStatus: 'BASELINE' | 'KEEP' | 'DISCARD';
+}
+export declare function buildGraph(projectPath: string, options?: BuildOptions): Promise<BuildResult>;
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EAEZ,aAAa,EACb,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AA2HpB;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,aAAa,CAAC;IACxB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,gBAAgB,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;CACnD;AAED,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA+JtB"}

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

@@ -0,0 +1,269 @@
+import { join } from 'path';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { collectFiles, corpusHealth } from './detect.js';
+import { FileCache } from './cache.js';
+import { buildGraph as buildGraphologyGraph } from './build.js';
+import { detectCommunities, cohesionScore } from './cluster.js';
+import { buildAnalysis, suggestQuestions } from './analyze.js';
+import { saveGraph } from './export.js';
+import { exportHTML } from './visualize.js';
+import { generateReport } from './report.js';
+import { typescriptExtractor } from './extract/languages/typescript.js';
+import { parseFile } from './extract/tree-sitter-runner.js';
+const DEFAULT_OUTPUT_SUBDIR = '.monomind/graph';
+// ---------------------------------------------------------------------------
+// Experiment loop — adapted from autoresearch's program.md protocol
+//
+// Every buildGraph call appends one row to results.tsv with a quality scalar,
+// then decides BASELINE / KEEP / DISCARD by comparing against the best known
+// result.  The quality metric mirrors autoresearch's val_bpb (a single number
+// to optimise), but for graph structure rather than language model perplexity.
+// ---------------------------------------------------------------------------
+const RESULTS_TSV_HEADER = 'timestamp\tnodes\tedges\tcommunities\tavg_cohesion\tavg_degree\tgraph_quality\tfiles_processed\tstatus\tdescription\n';
+/**
+ * Graph quality scalar.
+ *
+ * avgCohesion × ln(1 + avgDegree)
+ *
+ * Rewards both tight community structure (cohesion) and overall connectivity
+ * (avgDegree).  Higher is better — directly comparable across builds, like
+ * autoresearch's vocab-size-independent bits-per-byte metric.
+ */
+function computeGraphQuality(avgCohesion, nodes, edges) {
+    const avgDegree = nodes > 0 ? (2 * edges) / nodes : 0;
+    return avgCohesion * Math.log(1 + avgDegree);
+}
+/** Read results.tsv and return the best graph_quality seen so far (BASELINE or KEEP rows). */
+function readBestQuality(tsvPath) {
+    if (!existsSync(tsvPath))
+        return -Infinity;
+    try {
+        const lines = readFileSync(tsvPath, 'utf-8').split('\n').filter(Boolean);
+        let best = -Infinity;
+        for (const line of lines.slice(1)) { // skip header
+            const cols = line.split('\t');
+            const status = cols[8]; // status column
+            const quality = parseFloat(cols[6] ?? '0'); // graph_quality column
+            if ((status === 'BASELINE' || status === 'KEEP') && !isNaN(quality)) {
+                if (quality > best)
+                    best = quality;
+            }
+        }
+        return best;
+    }
+    catch {
+        return -Infinity;
+    }
+}
+/** Append one experiment row to results.tsv. Creates file + header if needed. */
+function appendResultsTsv(tsvPath, metrics) {
+    const avgDegree = metrics.nodes > 0 ? (2 * metrics.edges) / metrics.nodes : 0;
+    const description = `${metrics.nodes}n/${metrics.edges}e coh=${metrics.avgCohesion.toFixed(3)} deg=${avgDegree.toFixed(1)}`;
+    const row = [
+        new Date().toISOString(),
+        metrics.nodes,
+        metrics.edges,
+        metrics.communities,
+        metrics.avgCohesion.toFixed(4),
+        avgDegree.toFixed(2),
+        metrics.graphQuality.toFixed(6),
+        metrics.filesProcessed,
+        metrics.status,
+        description,
+    ].join('\t') + '\n';
+    try {
+        if (!existsSync(tsvPath)) {
+            writeFileSync(tsvPath, RESULTS_TSV_HEADER + row, 'utf-8');
+        }
+        else {
+            const existing = readFileSync(tsvPath, 'utf-8');
+            writeFileSync(tsvPath, existing + row, 'utf-8');
+        }
+    }
+    catch { /* TSV tracking is non-fatal */ }
+}
+// Map language identifiers to the extractors we have available.
+// python and go extractors are loaded lazily when their modules exist.
+const EXTRACTOR_MAP = {
+    typescript: typescriptExtractor,
+    javascript: typescriptExtractor, // TS extractor handles JS via regex + tree-sitter-javascript
+};
+/** Attempt to load python/go extractors that may be present in the extract/languages dir. */
+async function tryLoadExtractor(language) {
+    if (EXTRACTOR_MAP[language])
+        return EXTRACTOR_MAP[language];
+    try {
+        const mod = await import(`./extract/languages/${language}.js`);
+        const extractor = (mod[`${language}Extractor`] ?? mod['default']);
+        if (extractor)
+            EXTRACTOR_MAP[language] = extractor;
+        return extractor;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function buildGraph(projectPath, options = {}) {
+    // Resolve output directory
+    const outputDir = options.outputDir ?? join(projectPath, DEFAULT_OUTPUT_SUBDIR);
+    mkdirSync(outputDir, { recursive: true });
+    const cache = new FileCache(outputDir);
+    // 1. Collect files + corpus health check
+    const files = collectFiles(projectPath, options);
+    const corpusWarnings = corpusHealth(files);
+    // 2. Extract nodes/edges from each file (cache-aware)
+    const merged = {
+        nodes: [],
+        edges: [],
+        hyperedges: [],
+        filesProcessed: 0,
+        fromCache: 0,
+        errors: [],
+    };
+    for (const file of files) {
+        let content;
+        try {
+            content = readFileSync(file.path, 'utf-8');
+        }
+        catch (err) {
+            merged.errors.push(`Cannot read ${file.path}: ${String(err)}`);
+            continue;
+        }
+        const cacheKey = cache.key(file.path, content);
+        let result = cache.get(cacheKey);
+        if (result) {
+            merged.fromCache += 1;
+        }
+        else {
+            const extractor = file.language
+                ? await tryLoadExtractor(file.language)
+                : undefined;
+            if (extractor) {
+                result = parseFile(file.path, content, extractor);
+            }
+            else {
+                result = extractGeneric(file.path, content);
+            }
+            cache.set(cacheKey, result);
+        }
+        merged.nodes.push(...result.nodes);
+        merged.edges.push(...result.edges);
+        if (result.hyperedges)
+            merged.hyperedges.push(...result.hyperedges);
+        merged.filesProcessed += 1;
+        merged.errors.push(...result.errors);
+    }
+    // 3. Build graphology graph (dedup + stub endpoints)
+    const graph = buildGraphologyGraph(merged);
+    // 4. Community detection (Louvain with directory-based fallback)
+    await detectCommunities(graph);
+    // 5. Degree annotation
+    graph.forEachNode((id) => {
+        graph.setNodeAttribute(id, 'degree', graph.degree(id));
+    });
+    // 6. Build analysis (god nodes, surprise edges, communities, stats)
+    const analysis = buildAnalysis(graph, outputDir);
+    // 6b. Suggest questions the graph can answer
+    const questions = suggestQuestions(graph, analysis.communities);
+    // 6c. Compute cohesion scores per community
+    const cohesionScores = {};
+    for (const [cidStr, memberIds] of Object.entries(analysis.communities)) {
+        cohesionScores[Number(cidStr)] = cohesionScore(graph, memberIds);
+    }
+    // 6d. Graph quality metric + experiment loop (autoresearch protocol)
+    const cohesionValues = Object.values(cohesionScores);
+    const avgCohesion = cohesionValues.length > 0
+        ? cohesionValues.reduce((a, b) => a + b, 0) / cohesionValues.length
+        : 0;
+    const graphQuality = computeGraphQuality(avgCohesion, graph.order, graph.size);
+    const tsvPath = join(outputDir, 'results.tsv');
+    const prevBest = readBestQuality(tsvPath);
+    const experimentStatus = prevBest === -Infinity
+        ? 'BASELINE'
+        : graphQuality > prevBest * 1.001 // 0.1% improvement threshold
+            ? 'KEEP'
+            : 'DISCARD';
+    appendResultsTsv(tsvPath, {
+        nodes: graph.order,
+        edges: graph.size,
+        communities: analysis.stats.communities,
+        avgCohesion,
+        graphQuality,
+        filesProcessed: merged.filesProcessed,
+        status: experimentStatus,
+    });
+    // 7. Persist to disk
+    saveGraph(graph, outputDir, projectPath);
+    const graphPath = join(outputDir, 'graph.json');
+    // 7b. Generate and save markdown report (non-fatal)
+    const reportPath = join(outputDir, 'GRAPH_REPORT.md');
+    try {
+        const totalWords = merged.nodes.reduce((sum, n) => sum + (n.linesOfCode ?? 0) * 10, 0);
+        const reportMd = generateReport(graph, analysis, cohesionScores, {
+            projectPath,
+            questions,
+            corpusStats: corpusWarnings.length > 0
+                ? { totalFiles: files.length, totalWords, warning: corpusWarnings[0] }
+                : { totalFiles: files.length, totalWords },
+        });
+        writeFileSync(reportPath, reportMd, 'utf-8');
+    }
+    catch { /* report generation is non-fatal */ }
+    // 8. Serialize to the public return type
+    const serialized = {
+        version: '1.0.0',
+        builtAt: new Date().toISOString(),
+        projectPath,
+        directed: true,
+        multigraph: false,
+        nodes: graph.nodes().map((id) => ({
+            id,
+            ...graph.getNodeAttributes(id),
+        })),
+        links: graph.edges().map((edgeId) => ({
+            source: graph.source(edgeId),
+            target: graph.target(edgeId),
+            ...graph.getEdgeAttributes(edgeId),
+        })),
+    };
+    // 9. Generate interactive HTML visualization (non-fatal)
+    try {
+        exportHTML(serialized, outputDir);
+    }
+    catch {
+        // Visualization is best-effort; never block the build
+    }
+    return {
+        graph: serialized,
+        analysis,
+        questions,
+        corpusWarnings,
+        filesProcessed: merged.filesProcessed,
+        fromCache: merged.fromCache,
+        graphPath,
+        reportPath,
+        graphQuality,
+        experimentStatus,
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal: minimal fallback for languages without a dedicated extractor
+// ---------------------------------------------------------------------------
+function extractGeneric(filePath, content) {
+    return {
+        nodes: [
+            {
+                id: filePath,
+                label: filePath.split('/').pop() ?? filePath,
+                fileType: 'code',
+                sourceFile: filePath,
+                linesOfCode: content.split('\n').length,
+            },
+        ],
+        edges: [],
+        filesProcessed: 1,
+        fromCache: 0,
+        errors: [],
+    };
+}
+//# sourceMappingURL=pipeline.js.map

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

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

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

@@ -0,0 +1,26 @@
+import type Graph from 'graphology';
+import type { GraphAnalysis, GraphQuestion } from './types.js';
+export interface CorpusStats {
+    totalFiles: number;
+    totalWords: number;
+    warning?: string;
+}
+export interface ReportOptions {
+    projectPath?: string;
+    tokenCost?: {
+        input: number;
+        output: number;
+    };
+    corpusStats?: CorpusStats;
+    questions?: GraphQuestion[];
+}
+/**
+ * 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 declare function generateReport(graph: Graph, analysis: GraphAnalysis, cohesionScores?: Record<number, number>, options?: ReportOptions): string;
+//# sourceMappingURL=report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/report.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG/D,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;CAC7B;AAkCD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,aAAa,EACvB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAkMR"}