@optave/codegraph 3.2.0 → 3.3.1

package/dist/features/check.js

@@ -0,0 +1,296 @@
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { findDbPath, openReadonlyOrFail } from '../db/index.js';
+import { bfsTransitiveCallers } from '../domain/analysis/impact.js';
+import { findCycles } from '../domain/graph/cycles.js';
+import { loadConfig } from '../infrastructure/config.js';
+import { isTestFile } from '../infrastructure/test-filter.js';
+import { matchOwners, parseCodeowners } from './owners.js';
+// ─── Diff Parser ──────────────────────────────────────────────────────
+/**
+ * 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) {
+    const changedRanges = new Map();
+    const oldRanges = new Map();
+    const newFiles = new Set();
+    let currentFile = null;
+    let prevIsDevNull = false;
+    for (const line of diffOutput.split('\n')) {
+        if (line.startsWith('--- /dev/null')) {
+            prevIsDevNull = true;
+            continue;
+        }
+        if (line.startsWith('--- ')) {
+            prevIsDevNull = false;
+            continue;
+        }
+        const fileMatch = line.match(/^\+\+\+ b\/(.+)/);
+        if (fileMatch) {
+            currentFile = fileMatch[1];
+            if (!changedRanges.has(currentFile))
+                changedRanges.set(currentFile, []);
+            if (!oldRanges.has(currentFile))
+                oldRanges.set(currentFile, []);
+            if (prevIsDevNull)
+                newFiles.add(currentFile);
+            prevIsDevNull = false;
+            continue;
+        }
+        const hunkMatch = line.match(/^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/);
+        if (hunkMatch && currentFile) {
+            const oldStart = parseInt(hunkMatch[1], 10);
+            const oldCount = parseInt(hunkMatch[2] || '1', 10);
+            if (oldCount > 0) {
+                oldRanges.get(currentFile).push({ start: oldStart, end: oldStart + oldCount - 1 });
+            }
+            const newStart = parseInt(hunkMatch[3], 10);
+            const newCount = parseInt(hunkMatch[4] || '1', 10);
+            if (newCount > 0) {
+                changedRanges.get(currentFile).push({ start: newStart, end: newStart + newCount - 1 });
+            }
+        }
+    }
+    return { changedRanges, oldRanges, newFiles };
+}
+// ─── Predicates ───────────────────────────────────────────────────────
+/**
+ * Predicate 1: Assert no dependency cycles involve changed files.
+ */
+export function checkNoNewCycles(db, changedFiles, noTests) {
+    const cycles = findCycles(db, { fileLevel: true, noTests });
+    const involved = cycles.filter((cycle) => cycle.some((f) => changedFiles.has(f)));
+    return { passed: involved.length === 0, cycles: involved };
+}
+/**
+ * Predicate 2: Assert no function exceeds N transitive callers.
+ */
+export function checkMaxBlastRadius(db, changedRanges, threshold, noTests, maxDepth) {
+    const violations = [];
+    let maxFound = 0;
+    for (const [file, ranges] of changedRanges) {
+        if (noTests && isTestFile(file))
+            continue;
+        const defs = db
+            .prepare(`SELECT * FROM nodes WHERE file = ? AND kind IN ('function', 'method', 'class') ORDER BY line`)
+            .all(file);
+        for (let i = 0; i < defs.length; i++) {
+            const def = defs[i];
+            const endLine = def.end_line || (defs[i + 1] ? defs[i + 1].line - 1 : 999999);
+            let overlaps = false;
+            for (const range of ranges) {
+                if (range.start <= endLine && range.end >= def.line) {
+                    overlaps = true;
+                    break;
+                }
+            }
+            if (!overlaps)
+                continue;
+            const { totalDependents: totalCallers } = bfsTransitiveCallers(db, def.id, {
+                noTests,
+                maxDepth,
+            });
+            if (totalCallers > maxFound)
+                maxFound = totalCallers;
+            if (totalCallers > threshold) {
+                violations.push({
+                    name: def.name,
+                    kind: def.kind,
+                    file: def.file,
+                    line: def.line,
+                    transitiveCallers: totalCallers,
+                });
+            }
+        }
+    }
+    return { passed: violations.length === 0, maxFound, threshold, violations };
+}
+/**
+ * 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, oldRanges, noTests) {
+    const violations = [];
+    for (const [file, ranges] of oldRanges) {
+        if (ranges.length === 0)
+            continue;
+        if (noTests && isTestFile(file))
+            continue;
+        const defs = db
+            .prepare(`SELECT name, kind, file, line FROM nodes WHERE file = ? AND kind IN ('function', 'method', 'class') ORDER BY line`)
+            .all(file);
+        for (const def of defs) {
+            for (const range of ranges) {
+                if (def.line >= range.start && def.line <= range.end) {
+                    violations.push({
+                        name: def.name,
+                        kind: def.kind,
+                        file: def.file,
+                        line: def.line,
+                    });
+                    break;
+                }
+            }
+        }
+    }
+    return { passed: violations.length === 0, violations };
+}
+/**
+ * Predicate 4: Assert no cross-owner boundary violations among changed files.
+ */
+export function checkNoBoundaryViolations(db, changedFiles, repoRoot, noTests) {
+    const parsed = parseCodeowners(repoRoot);
+    if (!parsed) {
+        return { passed: true, violations: [], note: 'No CODEOWNERS file found — skipped' };
+    }
+    const changedSet = changedFiles instanceof Set ? changedFiles : new Set(changedFiles);
+    const edges = db
+        .prepare(`SELECT e.kind AS edgeKind,
+              s.file AS srcFile, t.file AS tgtFile
+       FROM edges e
+       JOIN nodes s ON e.source_id = s.id
+       JOIN nodes t ON e.target_id = t.id
+       WHERE e.kind = 'calls'`)
+        .all();
+    const violations = [];
+    for (const e of edges) {
+        if (noTests && (isTestFile(e.srcFile) || isTestFile(e.tgtFile)))
+            continue;
+        if (!changedSet.has(e.srcFile) && !changedSet.has(e.tgtFile))
+            continue;
+        const srcOwners = matchOwners(e.srcFile, parsed.rules).sort().join(',');
+        const tgtOwners = matchOwners(e.tgtFile, parsed.rules).sort().join(',');
+        if (srcOwners !== tgtOwners) {
+            violations.push({
+                from: e.srcFile,
+                to: e.tgtFile,
+                edgeKind: e.edgeKind,
+            });
+        }
+    }
+    return { passed: violations.length === 0, violations };
+}
+// ─── Main ─────────────────────────────────────────────────────────────
+/**
+ * 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, opts = {}) {
+    const db = openReadonlyOrFail(customDbPath);
+    try {
+        const dbPath = findDbPath(customDbPath);
+        const repoRoot = path.resolve(path.dirname(dbPath), '..');
+        const noTests = opts.noTests || false;
+        const maxDepth = opts.depth || 3;
+        // Load config defaults for check predicates
+        // NOTE: opts.config is loaded from process.cwd() at startup (via CLI context),
+        // which may differ from the DB's parent repo root when --db points to an external
+        // project. This is an acceptable trade-off to avoid duplicate I/O on the hot path.
+        const config = opts.config || loadConfig(repoRoot);
+        const checkConfig = config.check || {};
+        // Resolve which predicates are enabled: CLI flags ?? config ?? built-in defaults
+        const enableCycles = opts.cycles ?? checkConfig.cycles ?? true;
+        const enableSignatures = opts.signatures ?? checkConfig.signatures ?? true;
+        const enableBoundaries = opts.boundaries ?? checkConfig.boundaries ?? true;
+        const blastRadiusThreshold = opts.blastRadius ?? checkConfig.blastRadius ?? null;
+        // Verify git repo
+        let checkDir = repoRoot;
+        let isGitRepo = false;
+        while (checkDir) {
+            if (fs.existsSync(path.join(checkDir, '.git'))) {
+                isGitRepo = true;
+                break;
+            }
+            const parent = path.dirname(checkDir);
+            if (parent === checkDir)
+                break;
+            checkDir = parent;
+        }
+        if (!isGitRepo) {
+            return { error: `Not a git repository: ${repoRoot}` };
+        }
+        // Run git diff
+        let diffOutput;
+        try {
+            const args = opts.staged
+                ? ['diff', '--cached', '--unified=0', '--no-color']
+                : ['diff', opts.ref || 'HEAD', '--unified=0', '--no-color'];
+            diffOutput = execFileSync('git', args, {
+                cwd: repoRoot,
+                encoding: 'utf-8',
+                maxBuffer: 10 * 1024 * 1024,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+        }
+        catch (e) {
+            return { error: `Failed to run git diff: ${e.message}` };
+        }
+        if (!diffOutput.trim()) {
+            return {
+                predicates: [],
+                summary: { total: 0, passed: 0, failed: 0, changedFiles: 0, newFiles: 0 },
+                passed: true,
+            };
+        }
+        const { changedRanges, oldRanges, newFiles } = parseDiffOutput(diffOutput);
+        if (changedRanges.size === 0) {
+            return {
+                predicates: [],
+                summary: { total: 0, passed: 0, failed: 0, changedFiles: 0, newFiles: 0 },
+                passed: true,
+            };
+        }
+        const changedFiles = new Set(changedRanges.keys());
+        // Execute enabled predicates
+        const predicates = [];
+        if (enableCycles) {
+            const result = checkNoNewCycles(db, changedFiles, noTests);
+            predicates.push({ name: 'cycles', ...result });
+        }
+        if (blastRadiusThreshold != null) {
+            const result = checkMaxBlastRadius(db, changedRanges, blastRadiusThreshold, noTests, maxDepth);
+            predicates.push({ name: 'blast-radius', ...result });
+        }
+        if (enableSignatures) {
+            const result = checkNoSignatureChanges(db, oldRanges, noTests);
+            predicates.push({ name: 'signatures', ...result });
+        }
+        if (enableBoundaries) {
+            const result = checkNoBoundaryViolations(db, changedFiles, repoRoot, noTests);
+            predicates.push({ name: 'boundaries', ...result });
+        }
+        const passedCount = predicates.filter((p) => p.passed).length;
+        const failedCount = predicates.length - passedCount;
+        return {
+            predicates,
+            summary: {
+                total: predicates.length,
+                passed: passedCount,
+                failed: failedCount,
+                changedFiles: changedFiles.size,
+                newFiles: newFiles.size,
+            },
+            passed: failedCount === 0,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/features/check.js.map

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

package/dist/features/cochange.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Scan git history and return parsed commit data.
+ * @param {string} repoRoot - Absolute path to the git repo root
+ * @param {object} [opts]
+ * @param {string} [opts.since] - Git date expression (e.g. "1 year ago")
+ * @param {string} [opts.afterSha] - Only include commits after this SHA
+ * @returns {{ commits: Array<{sha: string, epoch: number, files: string[]}> }}
+ */
+export function scanGitHistory(repoRoot: string, opts?: {
+    since?: string | undefined;
+    afterSha?: string | undefined;
+}): {
+    commits: Array<{
+        sha: string;
+        epoch: number;
+        files: string[];
+    }>;
+};
+/**
+ * Compute co-change pairs from parsed commit data.
+ * @param {Array<{sha: string, epoch: number, files: string[]}>} commits
+ * @param {object} [opts]
+ * @param {number} [opts.minSupport=3] - Minimum number of co-occurrences
+ * @param {number} [opts.maxFilesPerCommit=50] - Skip commits with too many files
+ * @param {Set<string>} [opts.knownFiles] - If provided, only include pairs where both files are in this set
+ * @returns {Map<string, {commitCount: number, jaccard: number, lastEpoch: number}>}
+ */
+export function computeCoChanges(commits: Array<{
+    sha: string;
+    epoch: number;
+    files: string[];
+}>, opts?: {
+    minSupport?: number | undefined;
+    maxFilesPerCommit?: number | undefined;
+    knownFiles?: Set<string> | undefined;
+}): Map<string, {
+    commitCount: number;
+    jaccard: number;
+    lastEpoch: number;
+}>;
+/**
+ * Analyze git history and populate co-change data in the database.
+ * @param {string} [customDbPath] - Path to graph.db
+ * @param {object} [opts]
+ * @param {string} [opts.since] - Git date expression
+ * @param {number} [opts.minSupport] - Minimum co-occurrence count
+ * @param {number} [opts.maxFilesPerCommit] - Max files per commit
+ * @param {boolean} [opts.full] - Force full re-scan
+ * @returns {{ pairsFound: number, commitsScanned: number, since: string, minSupport: number }}
+ */
+export function analyzeCoChanges(customDbPath?: string, opts?: {
+    since?: string | undefined;
+    minSupport?: number | undefined;
+    maxFilesPerCommit?: number | undefined;
+    full?: boolean | undefined;
+}): {
+    pairsFound: number;
+    commitsScanned: number;
+    since: string;
+    minSupport: number;
+};
+/**
+ * Query co-change partners for a specific file.
+ * @param {string} file - File path (partial match supported)
+ * @param {string} [customDbPath]
+ * @param {object} [opts]
+ * @param {number} [opts.limit=20]
+ * @param {number} [opts.minJaccard=0.3]
+ * @param {boolean} [opts.noTests]
+ * @returns {{ file: string, partners: Array, meta: object }}
+ */
+export function coChangeData(file: string, customDbPath?: string, opts?: {
+    limit?: number | undefined;
+    minJaccard?: number | undefined;
+    noTests?: boolean | undefined;
+}): {
+    file: string;
+    partners: any[];
+    meta: object;
+};
+/**
+ * Query top global co-change pairs.
+ * @param {string} [customDbPath]
+ * @param {object} [opts]
+ * @param {number} [opts.limit=20]
+ * @param {number} [opts.minJaccard=0.3]
+ * @param {boolean} [opts.noTests]
+ * @returns {{ pairs: Array, meta: object }}
+ */
+export function coChangeTopData(customDbPath?: string, opts?: {
+    limit?: number | undefined;
+    minJaccard?: number | undefined;
+    noTests?: boolean | undefined;
+}): {
+    pairs: any[];
+    meta: object;
+};
+/**
+ * Batch-query co-change partners for a set of files.
+ * Takes an already-open readonly DB handle (for diff-impact integration).
+ * @param {string[]} files - File paths to query
+ * @param {import('better-sqlite3').Database} db - Already-open DB handle
+ * @param {object} [opts]
+ * @param {number} [opts.minJaccard=0.3]
+ * @param {number} [opts.limit=20]
+ * @param {boolean} [opts.noTests]
+ * @returns {Array<{file: string, coupledWith: string, commitCount: number, jaccard: number}>}
+ */
+export function coChangeForFiles(files: string[], db: any, opts?: {
+    minJaccard?: number | undefined;
+    limit?: number | undefined;
+    noTests?: boolean | undefined;
+}): Array<{
+    file: string;
+    coupledWith: string;
+    commitCount: number;
+    jaccard: number;
+}>;
+//# sourceMappingURL=cochange.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cochange.d.ts","sourceRoot":"","sources":["../../src/features/cochange.js"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AACH,yCANW,MAAM,SAEd;IAAsB,KAAK;IACL,QAAQ;CAC9B,GAAU;IAAE,OAAO,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAC,CAAC,CAAA;CAAE,CA6C7E;AAED;;;;;;;;GAQG;AACH,0CAPW,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,SAE5D;IAAsB,UAAU;IACV,iBAAiB;IACZ,UAAU;CACrC,GAAU,GAAG,CAAC,MAAM,EAAE;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAC,CAAC,CAoDlF;AAED;;;;;;;;;GASG;AACH,gDARW,MAAM,SAEd;IAAsB,KAAK;IACL,UAAU;IACV,iBAAiB;IAChB,IAAI;CAC3B,GAAU;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAsH7F;AAED;;;;;;;;;GASG;AACH,mCARW,MAAM,iBACN,MAAM,SAEd;IAAsB,KAAK;IACL,UAAU;IACT,OAAO;CAC9B,GAAU;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,QAAQ;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAoD3D;AAED;;;;;;;;GAQG;AACH,+CAPW,MAAM,SAEd;IAAsB,KAAK;IACL,UAAU;IACT,OAAO;CAC9B,GAAU;IAAE,KAAK,QAAQ;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA4C1C;AAED;;;;;;;;;;GAUG;AACH,wCARW,MAAM,EAAE,kBAGhB;IAAsB,UAAU;IACV,KAAK;IACJ,OAAO;CAC9B,GAAU,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,CAAC,CAqC5F"}