@optave/codegraph 3.1.5 → 3.3.0

package/dist/features/cfg.js

@@ -0,0 +1,372 @@
+/**
+ * Intraprocedural Control Flow Graph (CFG) construction from tree-sitter AST.
+ *
+ * Builds basic-block CFGs for individual functions, stored in cfg_blocks + cfg_edges tables.
+ * Opt-in via `build --cfg`. Supports JS/TS/TSX, Python, Go, Rust, Java, C#, Ruby, PHP.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { CFG_RULES } from '../ast-analysis/rules/index.js';
+import { makeCfgRules as _makeCfgRules, buildExtensionSet, buildExtToLangMap, } from '../ast-analysis/shared.js';
+import { walkWithVisitors } from '../ast-analysis/visitor.js';
+import { createCfgVisitor } from '../ast-analysis/visitors/cfg-visitor.js';
+import { deleteCfgForNode, getCfgBlocks, getCfgEdges, getFunctionNodeId, hasCfgTables, openReadonlyOrFail, } from '../db/index.js';
+import { debug, info } from '../infrastructure/logger.js';
+import { paginateResult } from '../shared/paginate.js';
+import { findNodes } from './shared/find-nodes.js';
+// Re-export for backward compatibility
+export { _makeCfgRules as makeCfgRules, CFG_RULES };
+const CFG_EXTENSIONS = buildExtensionSet(CFG_RULES);
+// ─── Core Algorithm: AST → CFG ──────────────────────────────────────────
+/**
+ * Build a control flow graph for a single function AST node.
+ *
+ * Thin wrapper around the CFG visitor — runs walkWithVisitors on the function
+ * node and returns the first result. All CFG construction logic lives in
+ * `ast-analysis/visitors/cfg-visitor.js`.
+ *
+ * @param {object} functionNode - tree-sitter function AST node
+ * @param {string} langId - language identifier
+ * @returns {{ blocks: object[], edges: object[], cyclomatic: number }} - CFG blocks, edges, and derived cyclomatic
+ */
+export function buildFunctionCFG(functionNode, langId) {
+    const rules = CFG_RULES.get(langId);
+    if (!rules)
+        return { blocks: [], edges: [], cyclomatic: 0 };
+    const visitor = createCfgVisitor(rules);
+    const walkerOpts = {
+        functionNodeTypes: new Set(rules.functionNodes),
+        nestingNodeTypes: new Set(),
+        getFunctionName: (node) => {
+            const nameNode = node.childForFieldName('name');
+            return nameNode ? nameNode.text : null;
+        },
+    };
+    const results = walkWithVisitors(functionNode, [visitor], langId, walkerOpts);
+    const cfgResults = results.cfg || [];
+    if (cfgResults.length === 0)
+        return { blocks: [], edges: [], cyclomatic: 0 };
+    const r = cfgResults.find((result) => result.funcNode === functionNode);
+    if (!r)
+        return { blocks: [], edges: [], cyclomatic: 0 };
+    return { blocks: r.blocks, edges: r.edges, cyclomatic: r.cyclomatic };
+}
+// ─── Build-Time Helpers ─────────────────────────────────────────────────
+async function initCfgParsers(fileSymbols) {
+    let needsFallback = false;
+    for (const [relPath, symbols] of fileSymbols) {
+        if (!symbols._tree) {
+            const ext = path.extname(relPath).toLowerCase();
+            if (CFG_EXTENSIONS.has(ext)) {
+                const hasNativeCfg = symbols.definitions
+                    .filter((d) => (d.kind === 'function' || d.kind === 'method') && d.line)
+                    .every((d) => d.cfg === null || d.cfg?.blocks?.length);
+                if (!hasNativeCfg) {
+                    needsFallback = true;
+                    break;
+                }
+            }
+        }
+    }
+    let parsers = null;
+    let getParserFn = null;
+    if (needsFallback) {
+        const { createParsers } = await import('../domain/parser.js');
+        parsers = await createParsers();
+        const mod = await import('../domain/parser.js');
+        getParserFn = mod.getParser;
+    }
+    return { parsers, getParserFn };
+}
+function getTreeAndLang(symbols, relPath, rootDir, extToLang, parsers, getParserFn) {
+    const ext = path.extname(relPath).toLowerCase();
+    let tree = symbols._tree;
+    let langId = symbols._langId;
+    const allNative = symbols.definitions
+        .filter((d) => (d.kind === 'function' || d.kind === 'method') && d.line)
+        .every((d) => d.cfg === null || d.cfg?.blocks?.length);
+    if (!tree && !allNative) {
+        if (!getParserFn)
+            return null;
+        langId = extToLang.get(ext);
+        if (!langId || !CFG_RULES.has(langId))
+            return null;
+        const absPath = path.join(rootDir, relPath);
+        let code;
+        try {
+            code = fs.readFileSync(absPath, 'utf-8');
+        }
+        catch (e) {
+            debug(`cfg: cannot read ${relPath}: ${e.message}`);
+            return null;
+        }
+        const parser = getParserFn(parsers, absPath);
+        if (!parser)
+            return null;
+        try {
+            tree = parser.parse(code);
+        }
+        catch (e) {
+            debug(`cfg: parse failed for ${relPath}: ${e.message}`);
+            return null;
+        }
+    }
+    if (!langId) {
+        langId = extToLang.get(ext);
+        if (!langId)
+            return null;
+    }
+    return { tree, langId };
+}
+function buildVisitorCfgMap(tree, cfgRules, symbols, langId) {
+    const needsVisitor = tree &&
+        symbols.definitions.some((d) => (d.kind === 'function' || d.kind === 'method') &&
+            d.line &&
+            d.cfg !== null &&
+            !d.cfg?.blocks?.length);
+    if (!needsVisitor)
+        return null;
+    const visitor = createCfgVisitor(cfgRules);
+    const walkerOpts = {
+        functionNodeTypes: new Set(cfgRules.functionNodes),
+        nestingNodeTypes: new Set(),
+        getFunctionName: (node) => {
+            const nameNode = node.childForFieldName('name');
+            return nameNode ? nameNode.text : null;
+        },
+    };
+    const walkResults = walkWithVisitors(tree.rootNode, [visitor], langId, walkerOpts);
+    const cfgResults = walkResults.cfg || [];
+    const visitorCfgByLine = new Map();
+    for (const r of cfgResults) {
+        if (r.funcNode) {
+            const line = r.funcNode.startPosition.row + 1;
+            if (!visitorCfgByLine.has(line))
+                visitorCfgByLine.set(line, []);
+            visitorCfgByLine.get(line).push(r);
+        }
+    }
+    return visitorCfgByLine;
+}
+function persistCfg(cfg, nodeId, insertBlock, insertEdge) {
+    const blockDbIds = new Map();
+    for (const block of cfg.blocks) {
+        const result = insertBlock.run(nodeId, block.index, block.type, block.startLine, block.endLine, block.label);
+        blockDbIds.set(block.index, result.lastInsertRowid);
+    }
+    for (const edge of cfg.edges) {
+        const sourceDbId = blockDbIds.get(edge.sourceIndex);
+        const targetDbId = blockDbIds.get(edge.targetIndex);
+        if (sourceDbId && targetDbId) {
+            insertEdge.run(nodeId, sourceDbId, targetDbId, edge.kind);
+        }
+    }
+}
+// ─── Build-Time: Compute CFG for Changed Files ─────────────────────────
+/**
+ * Build CFG data for all function/method definitions and persist to DB.
+ *
+ * @param {object} db - open better-sqlite3 database (read-write)
+ * @param {Map<string, object>} fileSymbols - Map<relPath, { definitions, _tree, _langId }>
+ * @param {string} rootDir - absolute project root path
+ * @param {object} [_engineOpts] - engine options (unused; always uses WASM for AST)
+ */
+export async function buildCFGData(db, fileSymbols, rootDir, _engineOpts) {
+    const extToLang = buildExtToLangMap();
+    const { parsers, getParserFn } = await initCfgParsers(fileSymbols);
+    const insertBlock = db.prepare(`INSERT INTO cfg_blocks (function_node_id, block_index, block_type, start_line, end_line, label)
+     VALUES (?, ?, ?, ?, ?, ?)`);
+    const insertEdge = db.prepare(`INSERT INTO cfg_edges (function_node_id, source_block_id, target_block_id, kind)
+     VALUES (?, ?, ?, ?)`);
+    let analyzed = 0;
+    const tx = db.transaction(() => {
+        for (const [relPath, symbols] of fileSymbols) {
+            const ext = path.extname(relPath).toLowerCase();
+            if (!CFG_EXTENSIONS.has(ext))
+                continue;
+            const treeLang = getTreeAndLang(symbols, relPath, rootDir, extToLang, parsers, getParserFn);
+            if (!treeLang)
+                continue;
+            const { tree, langId } = treeLang;
+            const cfgRules = CFG_RULES.get(langId);
+            if (!cfgRules)
+                continue;
+            const visitorCfgByLine = buildVisitorCfgMap(tree, cfgRules, symbols, langId);
+            for (const def of symbols.definitions) {
+                if (def.kind !== 'function' && def.kind !== 'method')
+                    continue;
+                if (!def.line)
+                    continue;
+                const nodeId = getFunctionNodeId(db, def.name, relPath, def.line);
+                if (!nodeId)
+                    continue;
+                let cfg = null;
+                if (def.cfg?.blocks?.length) {
+                    cfg = def.cfg;
+                }
+                else if (visitorCfgByLine) {
+                    const candidates = visitorCfgByLine.get(def.line);
+                    const r = !candidates
+                        ? undefined
+                        : candidates.length === 1
+                            ? candidates[0]
+                            : (candidates.find((c) => {
+                                const n = c.funcNode.childForFieldName('name');
+                                return n && n.text === def.name;
+                            }) ?? candidates[0]);
+                    if (r)
+                        cfg = { blocks: r.blocks, edges: r.edges };
+                }
+                if (!cfg || cfg.blocks.length === 0)
+                    continue;
+                deleteCfgForNode(db, nodeId);
+                persistCfg(cfg, nodeId, insertBlock, insertEdge);
+                analyzed++;
+            }
+        }
+    });
+    tx();
+    if (analyzed > 0) {
+        info(`CFG: ${analyzed} functions analyzed`);
+    }
+}
+// ─── Query-Time Functions ───────────────────────────────────────────────
+const CFG_DEFAULT_KINDS = ['function', 'method'];
+/**
+ * Load CFG data for a function from the database.
+ *
+ * @param {string} name - Function name (partial match)
+ * @param {string} [customDbPath] - Path to graph.db
+ * @param {object} [opts] - Options
+ * @returns {{ function: object, blocks: object[], edges: object[], summary: object }}
+ */
+export function cfgData(name, customDbPath, opts = {}) {
+    const db = openReadonlyOrFail(customDbPath);
+    try {
+        const noTests = opts.noTests || false;
+        if (!hasCfgTables(db)) {
+            return {
+                name,
+                results: [],
+                warning: 'No CFG data found. Rebuild with `codegraph build` (CFG is now included by default).',
+            };
+        }
+        const nodes = findNodes(db, name, { noTests, file: opts.file, kind: opts.kind }, CFG_DEFAULT_KINDS);
+        if (nodes.length === 0) {
+            return { name, results: [] };
+        }
+        const results = nodes.map((node) => {
+            const cfgBlocks = getCfgBlocks(db, node.id);
+            const cfgEdges = getCfgEdges(db, node.id);
+            return {
+                name: node.name,
+                kind: node.kind,
+                file: node.file,
+                line: node.line,
+                blocks: cfgBlocks.map((b) => ({
+                    index: b.block_index,
+                    type: b.block_type,
+                    startLine: b.start_line,
+                    endLine: b.end_line,
+                    label: b.label,
+                })),
+                edges: cfgEdges.map((e) => ({
+                    source: e.source_index,
+                    sourceType: e.source_type,
+                    target: e.target_index,
+                    targetType: e.target_type,
+                    kind: e.kind,
+                })),
+                summary: {
+                    blockCount: cfgBlocks.length,
+                    edgeCount: cfgEdges.length,
+                },
+            };
+        });
+        return paginateResult({ name, results }, 'results', opts);
+    }
+    finally {
+        db.close();
+    }
+}
+// ─── Export Formats ─────────────────────────────────────────────────────
+/**
+ * Convert CFG data to DOT format for Graphviz rendering.
+ */
+export function cfgToDOT(cfgResult) {
+    const lines = [];
+    for (const r of cfgResult.results) {
+        lines.push(`digraph "${r.name}" {`);
+        lines.push('  rankdir=TB;');
+        lines.push('  node [shape=box, fontname="monospace", fontsize=10];');
+        for (const block of r.blocks) {
+            const label = blockLabel(block);
+            const shape = block.type === 'entry' || block.type === 'exit' ? 'ellipse' : 'box';
+            const style = block.type === 'condition' || block.type === 'loop_header'
+                ? ', style=filled, fillcolor="#ffffcc"'
+                : '';
+            lines.push(`  B${block.index} [label="${label}", shape=${shape}${style}];`);
+        }
+        for (const edge of r.edges) {
+            const style = edgeStyle(edge.kind);
+            lines.push(`  B${edge.source} -> B${edge.target} [label="${edge.kind}"${style}];`);
+        }
+        lines.push('}');
+    }
+    return lines.join('\n');
+}
+/**
+ * Convert CFG data to Mermaid format.
+ */
+export function cfgToMermaid(cfgResult) {
+    const lines = [];
+    for (const r of cfgResult.results) {
+        lines.push(`graph TD`);
+        lines.push(`  subgraph "${r.name}"`);
+        for (const block of r.blocks) {
+            const label = blockLabel(block);
+            if (block.type === 'entry' || block.type === 'exit') {
+                lines.push(`    B${block.index}(["${label}"])`);
+            }
+            else if (block.type === 'condition' || block.type === 'loop_header') {
+                lines.push(`    B${block.index}{"${label}"}`);
+            }
+            else {
+                lines.push(`    B${block.index}["${label}"]`);
+            }
+        }
+        for (const edge of r.edges) {
+            const label = edge.kind;
+            lines.push(`    B${edge.source} -->|${label}| B${edge.target}`);
+        }
+        lines.push('  end');
+    }
+    return lines.join('\n');
+}
+function blockLabel(block) {
+    const loc = block.startLine && block.endLine
+        ? ` L${block.startLine}${block.endLine !== block.startLine ? `-${block.endLine}` : ''}`
+        : '';
+    const label = block.label ? ` (${block.label})` : '';
+    return `${block.type}${label}${loc}`;
+}
+function edgeStyle(kind) {
+    if (kind === 'exception')
+        return ', color=red, fontcolor=red';
+    if (kind === 'branch_true')
+        return ', color=green, fontcolor=green';
+    if (kind === 'branch_false')
+        return ', color=red, fontcolor=red';
+    if (kind === 'loop_back')
+        return ', style=dashed, color=blue';
+    if (kind === 'loop_exit')
+        return ', color=orange';
+    if (kind === 'return')
+        return ', color=purple';
+    if (kind === 'break')
+        return ', color=orange, style=dashed';
+    if (kind === 'continue')
+        return ', color=blue, style=dashed';
+    return '';
+}
+//# sourceMappingURL=cfg.js.map

package/dist/features/cfg.js.map

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

package/dist/features/check.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Parse unified diff output, extracting both new-side (+) and old-side (-) ranges.
+ * Old-side ranges are needed for signature detection (DB line numbers = pre-change).
+ *
+ * @param {string} diffOutput - Raw `git diff --unified=0` output
+ * @returns {{ changedRanges: Map<string, {start:number,end:number}[]>, oldRanges: Map<string, {start:number,end:number}[]>, newFiles: Set<string> }}
+ */
+export function parseDiffOutput(diffOutput: string): {
+    changedRanges: Map<string, {
+        start: number;
+        end: number;
+    }[]>;
+    oldRanges: Map<string, {
+        start: number;
+        end: number;
+    }[]>;
+    newFiles: Set<string>;
+};
+/**
+ * Predicate 1: Assert no dependency cycles involve changed files.
+ */
+export function checkNoNewCycles(db: any, changedFiles: any, noTests: any): {
+    passed: boolean;
+    cycles: string[][];
+};
+/**
+ * Predicate 2: Assert no function exceeds N transitive callers.
+ */
+export function checkMaxBlastRadius(db: any, changedRanges: any, threshold: any, noTests: any, maxDepth: any): {
+    passed: boolean;
+    maxFound: number;
+    threshold: any;
+    violations: {
+        name: any;
+        kind: any;
+        file: any;
+        line: any;
+        transitiveCallers: number;
+    }[];
+};
+/**
+ * Predicate 3: Assert no function declaration lines were modified.
+ * Uses old-side hunk ranges (which correspond to DB line numbers from last build).
+ */
+export function checkNoSignatureChanges(db: any, oldRanges: any, noTests: any): {
+    passed: boolean;
+    violations: {
+        name: any;
+        kind: any;
+        file: any;
+        line: any;
+    }[];
+};
+/**
+ * Predicate 4: Assert no cross-owner boundary violations among changed files.
+ */
+export function checkNoBoundaryViolations(db: any, changedFiles: any, repoRoot: any, noTests: any): {
+    passed: boolean;
+    violations: never[];
+    note: string;
+} | {
+    passed: boolean;
+    violations: {
+        from: any;
+        to: any;
+        edgeKind: any;
+    }[];
+    note?: undefined;
+};
+/**
+ * Run validation predicates against git changes.
+ *
+ * @param {string} [customDbPath] - Path to graph.db
+ * @param {object} opts
+ * @param {string} [opts.ref] - Git ref to diff against
+ * @param {boolean} [opts.staged] - Analyze staged changes
+ * @param {boolean} [opts.cycles] - Enable cycles predicate
+ * @param {number} [opts.blastRadius] - Blast radius threshold
+ * @param {boolean} [opts.signatures] - Enable signatures predicate
+ * @param {boolean} [opts.boundaries] - Enable boundaries predicate
+ * @param {number} [opts.depth] - Max BFS depth (default: 3)
+ * @param {boolean} [opts.noTests] - Exclude test files
+ * @returns {{ predicates: object[], summary: object, passed: boolean }}
+ */
+export function checkData(customDbPath?: string, opts?: {
+    ref?: string | undefined;
+    staged?: boolean | undefined;
+    cycles?: boolean | undefined;
+    blastRadius?: number | undefined;
+    signatures?: boolean | undefined;
+    boundaries?: boolean | undefined;
+    depth?: number | undefined;
+    noTests?: boolean | undefined;
+}): {
+    predicates: object[];
+    summary: object;
+    passed: boolean;
+};
+//# sourceMappingURL=check.d.ts.map

package/dist/features/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/features/check.js"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,4CAHW,MAAM,GACJ;IAAE,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE;QAAC,KAAK,EAAC,MAAM,CAAC;QAAA,GAAG,EAAC,MAAM,CAAA;KAAC,EAAE,CAAC,CAAC;IAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE;QAAC,KAAK,EAAC,MAAM,CAAC;QAAA,GAAG,EAAC,MAAM,CAAA;KAAC,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,CA0CnJ;AAID;;GAEG;AACH;;;EAIC;AAED;;GAEG;AACH;;;;;;;;;;;EA2CC;AAED;;;GAGG;AACH;;;;;;;;EA6BC;AAED;;GAEG;AACH;;;;;;;;;;;;EAmCC;AAID;;;;;;;;;;;;;;GAcG;AACH,yCAZW,MAAM,SAEd;IAAsB,GAAG;IACF,MAAM;IACN,MAAM;IACP,WAAW;IACV,UAAU;IACV,UAAU;IACX,KAAK;IACJ,OAAO;CAC9B,GAAU;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAyHtE"}