@optave/codegraph 3.2.0 → 3.3.0

package/dist/domain/graph/builder/stages/detect-changes.js

@@ -0,0 +1,358 @@
+/**
+ * Stage: detectChanges
+ *
+ * Three-tier change detection cascade + incremental reverse-dependency handling.
+ * Sets ctx.parseChanges, ctx.metadataUpdates, ctx.removed, ctx.isFullBuild, ctx.earlyExit.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { closeDb } from '../../../../db/index.js';
+import { debug, info } from '../../../../infrastructure/logger.js';
+import { normalizePath } from '../../../../shared/constants.js';
+import { parseFilesAuto } from '../../../parser.js';
+import { readJournal, writeJournalHeader } from '../../journal.js';
+import { fileHash, fileStat, purgeFilesFromGraph, readFileSafe } from '../helpers.js';
+// ── Three-tier change detection ─────────────────────────────────────────
+/**
+ * Determine which files have changed since last build.
+ * Tier 0 — Journal: O(changed) when watcher was running
+ * Tier 1 — mtime+size: O(n) stats, O(changed) reads
+ * Tier 2 — Hash comparison: O(changed) reads (fallback from Tier 1)
+ */
+function getChangedFiles(db, allFiles, rootDir) {
+    let hasTable = false;
+    try {
+        db.prepare('SELECT 1 FROM file_hashes LIMIT 1').get();
+        hasTable = true;
+    }
+    catch {
+        /* table doesn't exist */
+    }
+    if (!hasTable) {
+        return {
+            changed: allFiles.map((f) => ({ file: f })),
+            removed: [],
+            isFullBuild: true,
+        };
+    }
+    const existing = new Map(db
+        .prepare('SELECT file, hash, mtime, size FROM file_hashes')
+        .all()
+        .map((r) => [r.file, r]));
+    const removed = detectRemovedFiles(existing, allFiles, rootDir);
+    // Tier 0: Journal
+    const journalResult = tryJournalTier(db, existing, rootDir, removed);
+    if (journalResult)
+        return journalResult;
+    // Tier 1 + 2: mtime/size fast-path → hash comparison
+    return mtimeAndHashTiers(existing, allFiles, rootDir, removed);
+}
+function detectRemovedFiles(existing, allFiles, rootDir) {
+    const currentFiles = new Set();
+    for (const file of allFiles) {
+        currentFiles.add(normalizePath(path.relative(rootDir, file)));
+    }
+    const removed = [];
+    for (const existingFile of existing.keys()) {
+        if (!currentFiles.has(existingFile)) {
+            removed.push(existingFile);
+        }
+    }
+    return removed;
+}
+function tryJournalTier(db, existing, rootDir, removed) {
+    const journal = readJournal(rootDir);
+    if (!journal.valid)
+        return null;
+    const dbMtimes = db.prepare('SELECT MAX(mtime) as latest FROM file_hashes').get();
+    const latestDbMtime = dbMtimes?.latest || 0;
+    const hasJournalEntries = journal.changed.length > 0 || journal.removed.length > 0;
+    if (!hasJournalEntries || journal.timestamp < latestDbMtime) {
+        debug(`Tier 0: skipped (${hasJournalEntries ? 'timestamp stale' : 'no entries'}), falling to Tier 1`);
+        return null;
+    }
+    debug(`Tier 0: journal valid, ${journal.changed.length} changed, ${journal.removed.length} removed`);
+    const changed = [];
+    for (const relPath of journal.changed) {
+        const absPath = path.join(rootDir, relPath);
+        const stat = fileStat(absPath);
+        if (!stat)
+            continue;
+        let content;
+        try {
+            content = readFileSafe(absPath);
+        }
+        catch {
+            continue;
+        }
+        const hash = fileHash(content);
+        const record = existing.get(relPath);
+        if (!record || record.hash !== hash) {
+            changed.push({ file: absPath, content, hash, relPath, stat });
+        }
+    }
+    const removedSet = new Set(removed);
+    for (const relPath of journal.removed) {
+        if (existing.has(relPath))
+            removedSet.add(relPath);
+    }
+    return { changed, removed: [...removedSet], isFullBuild: false };
+}
+function mtimeAndHashTiers(existing, allFiles, rootDir, removed) {
+    // Tier 1: mtime+size fast-path
+    const needsHash = [];
+    const skipped = [];
+    for (const file of allFiles) {
+        const relPath = normalizePath(path.relative(rootDir, file));
+        const record = existing.get(relPath);
+        if (!record) {
+            needsHash.push({ file, relPath });
+            continue;
+        }
+        const stat = fileStat(file);
+        if (!stat)
+            continue;
+        const storedMtime = record.mtime || 0;
+        const storedSize = record.size || 0;
+        if (storedSize > 0 && Math.floor(stat.mtimeMs) === storedMtime && stat.size === storedSize) {
+            skipped.push(relPath);
+            continue;
+        }
+        needsHash.push({ file, relPath, stat });
+    }
+    if (needsHash.length > 0) {
+        debug(`Tier 1: ${skipped.length} skipped by mtime+size, ${needsHash.length} need hash check`);
+    }
+    // Tier 2: Hash comparison
+    const changed = [];
+    for (const item of needsHash) {
+        let content;
+        try {
+            content = readFileSafe(item.file);
+        }
+        catch {
+            continue;
+        }
+        const hash = fileHash(content);
+        const stat = item.stat || fileStat(item.file);
+        const record = existing.get(item.relPath);
+        if (!record || record.hash !== hash) {
+            changed.push({ file: item.file, content, hash, relPath: item.relPath, stat });
+        }
+        else if (stat) {
+            changed.push({
+                file: item.file,
+                content,
+                hash,
+                relPath: item.relPath,
+                stat,
+                metadataOnly: true,
+            });
+        }
+    }
+    const parseChanged = changed.filter((c) => !c.metadataOnly);
+    if (needsHash.length > 0) {
+        debug(`Tier 2: ${parseChanged.length} actually changed, ${changed.length - parseChanged.length} metadata-only`);
+    }
+    return { changed, removed, isFullBuild: false };
+}
+// ── Pending analysis ────────────────────────────────────────────────────
+/**
+ * Run pending analysis pass when no file changes but analysis tables are empty.
+ */
+async function runPendingAnalysis(ctx) {
+    const { db, opts, engineOpts, allFiles, rootDir } = ctx;
+    const needsCfg = opts.cfg !== false &&
+        (() => {
+            try {
+                return db.prepare('SELECT COUNT(*) as c FROM cfg_blocks').get().c === 0;
+            }
+            catch {
+                return true;
+            }
+        })();
+    const needsDataflow = opts.dataflow !== false &&
+        (() => {
+            try {
+                return db.prepare('SELECT COUNT(*) as c FROM dataflow').get().c === 0;
+            }
+            catch {
+                return true;
+            }
+        })();
+    if (!needsCfg && !needsDataflow)
+        return false;
+    info('No file changes. Running pending analysis pass...');
+    const analysisOpts = {
+        ...engineOpts,
+        dataflow: needsDataflow && opts.dataflow !== false,
+    };
+    const analysisSymbols = await parseFilesAuto(allFiles, rootDir, analysisOpts);
+    if (needsCfg) {
+        const { buildCFGData } = await import('../../../../features/cfg.js');
+        await buildCFGData(db, analysisSymbols, rootDir, engineOpts);
+    }
+    if (needsDataflow) {
+        const { buildDataflowEdges } = await import('../../../../features/dataflow.js');
+        await buildDataflowEdges(db, analysisSymbols, rootDir, engineOpts);
+    }
+    return true;
+}
+// ── Metadata self-heal ──────────────────────────────────────────────────
+function healMetadata(ctx) {
+    const { db, metadataUpdates } = ctx;
+    if (!metadataUpdates || metadataUpdates.length === 0)
+        return;
+    try {
+        const healHash = db.prepare('INSERT OR REPLACE INTO file_hashes (file, hash, mtime, size) VALUES (?, ?, ?, ?)');
+        const healTx = db.transaction(() => {
+            for (const item of metadataUpdates) {
+                const mtime = item.stat ? Math.floor(item.stat.mtimeMs) : 0;
+                const size = item.stat ? item.stat.size : 0;
+                healHash.run(item.relPath, item.hash, mtime, size);
+            }
+        });
+        healTx();
+        debug(`Self-healed mtime/size for ${metadataUpdates.length} files`);
+    }
+    catch {
+        /* ignore heal errors */
+    }
+}
+// ── Reverse-dependency cascade ──────────────────────────────────────────
+function findReverseDependencies(db, changedRelPaths, rootDir) {
+    const reverseDeps = new Set();
+    if (changedRelPaths.size === 0)
+        return reverseDeps;
+    const findReverseDepsStmt = db.prepare(`
+    SELECT DISTINCT n_src.file FROM edges e
+    JOIN nodes n_src ON e.source_id = n_src.id
+    JOIN nodes n_tgt ON e.target_id = n_tgt.id
+    WHERE n_tgt.file = ? AND n_src.file != n_tgt.file AND n_src.kind != 'directory'
+  `);
+    for (const relPath of changedRelPaths) {
+        for (const row of findReverseDepsStmt.all(relPath)) {
+            if (!changedRelPaths.has(row.file) && !reverseDeps.has(row.file)) {
+                const absPath = path.join(rootDir, row.file);
+                if (fs.existsSync(absPath)) {
+                    reverseDeps.add(row.file);
+                }
+            }
+        }
+    }
+    return reverseDeps;
+}
+function purgeAndAddReverseDeps(ctx, changePaths, reverseDeps) {
+    const { db, rootDir } = ctx;
+    if (changePaths.length > 0 || ctx.removed.length > 0) {
+        purgeFilesFromGraph(db, [...ctx.removed, ...changePaths], { purgeHashes: false });
+    }
+    if (reverseDeps.size > 0) {
+        const deleteOutgoingEdgesForFile = db.prepare('DELETE FROM edges WHERE source_id IN (SELECT id FROM nodes WHERE file = ?)');
+        for (const relPath of reverseDeps) {
+            deleteOutgoingEdgesForFile.run(relPath);
+        }
+        for (const relPath of reverseDeps) {
+            const absPath = path.join(rootDir, relPath);
+            ctx.parseChanges.push({ file: absPath, relPath, _reverseDepOnly: true });
+        }
+    }
+}
+// ── Shared helpers ───────────────────────────────────────────────────────
+function detectHasEmbeddings(db) {
+    try {
+        db.prepare('SELECT 1 FROM embeddings LIMIT 1').get();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ── Scoped build path ───────────────────────────────────────────────────
+function handleScopedBuild(ctx) {
+    const { db, rootDir, opts } = ctx;
+    ctx.hasEmbeddings = detectHasEmbeddings(db);
+    const changePaths = ctx.parseChanges.map((item) => item.relPath || normalizePath(path.relative(rootDir, item.file)));
+    let reverseDeps = new Set();
+    if (!opts.noReverseDeps) {
+        const changedRelPaths = new Set([...changePaths, ...ctx.removed]);
+        reverseDeps = findReverseDependencies(db, changedRelPaths, rootDir);
+    }
+    // Purge changed + removed files, then add reverse-deps
+    purgeAndAddReverseDeps(ctx, changePaths, reverseDeps);
+    info(`Scoped rebuild: ${changePaths.length} changed, ${ctx.removed.length} removed, ${reverseDeps.size} reverse-deps`);
+}
+// ── Full/incremental build path ─────────────────────────────────────────
+function handleFullBuild(ctx) {
+    const { db } = ctx;
+    const hasEmbeddings = detectHasEmbeddings(db);
+    ctx.hasEmbeddings = hasEmbeddings;
+    const deletions = 'PRAGMA foreign_keys = OFF; DELETE FROM cfg_edges; DELETE FROM cfg_blocks; DELETE FROM node_metrics; DELETE FROM edges; DELETE FROM function_complexity; DELETE FROM dataflow; DELETE FROM ast_nodes; DELETE FROM nodes; PRAGMA foreign_keys = ON;';
+    db.exec(hasEmbeddings
+        ? `${deletions.replace('PRAGMA foreign_keys = ON;', '')} DELETE FROM embeddings; PRAGMA foreign_keys = ON;`
+        : deletions);
+}
+function handleIncrementalBuild(ctx) {
+    const { db, rootDir, opts } = ctx;
+    ctx.hasEmbeddings = detectHasEmbeddings(db);
+    let reverseDeps = new Set();
+    if (!opts.noReverseDeps) {
+        const changedRelPaths = new Set();
+        for (const item of ctx.parseChanges) {
+            changedRelPaths.add(item.relPath || normalizePath(path.relative(rootDir, item.file)));
+        }
+        for (const relPath of ctx.removed) {
+            changedRelPaths.add(relPath);
+        }
+        reverseDeps = findReverseDependencies(db, changedRelPaths, rootDir);
+    }
+    info(`Incremental: ${ctx.parseChanges.length} changed, ${ctx.removed.length} removed${reverseDeps.size > 0 ? `, ${reverseDeps.size} reverse-deps` : ''}`);
+    if (ctx.parseChanges.length > 0)
+        debug(`Changed files: ${ctx.parseChanges.map((c) => c.relPath).join(', ')}`);
+    if (ctx.removed.length > 0)
+        debug(`Removed files: ${ctx.removed.join(', ')}`);
+    const changePaths = ctx.parseChanges.map((item) => item.relPath || normalizePath(path.relative(rootDir, item.file)));
+    purgeAndAddReverseDeps(ctx, changePaths, reverseDeps);
+}
+// ── Main entry point ────────────────────────────────────────────────────
+/**
+ * @param {import('../context.js').PipelineContext} ctx
+ */
+export async function detectChanges(ctx) {
+    const { db, allFiles, rootDir, incremental, forceFullRebuild, opts } = ctx;
+    // Scoped builds already set parseChanges in collectFiles
+    if (opts.scope) {
+        handleScopedBuild(ctx);
+        return;
+    }
+    const increResult = incremental && !forceFullRebuild
+        ? getChangedFiles(db, allFiles, rootDir)
+        : { changed: allFiles.map((f) => ({ file: f })), removed: [], isFullBuild: true };
+    ctx.removed = increResult.removed;
+    ctx.isFullBuild = increResult.isFullBuild;
+    ctx.parseChanges = increResult.changed.filter((c) => !c.metadataOnly);
+    ctx.metadataUpdates = increResult.changed.filter((c) => c.metadataOnly);
+    // Early exit: no changes detected
+    if (!ctx.isFullBuild && ctx.parseChanges.length === 0 && ctx.removed.length === 0) {
+        const ranAnalysis = await runPendingAnalysis(ctx);
+        if (ranAnalysis) {
+            closeDb(db);
+            writeJournalHeader(rootDir, Date.now());
+            ctx.earlyExit = true;
+            return;
+        }
+        healMetadata(ctx);
+        info('No changes detected. Graph is up to date.');
+        closeDb(db);
+        writeJournalHeader(rootDir, Date.now());
+        ctx.earlyExit = true;
+        return;
+    }
+    if (ctx.isFullBuild) {
+        handleFullBuild(ctx);
+    }
+    else {
+        handleIncrementalBuild(ctx);
+    }
+}
+//# sourceMappingURL=detect-changes.js.map

package/dist/domain/graph/builder/stages/detect-changes.js.map

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

package/dist/domain/graph/builder/stages/finalize.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @param {import('../context.js').PipelineContext} ctx
+ */
+export function finalize(ctx: import("../context.js").PipelineContext): Promise<void>;
+//# sourceMappingURL=finalize.d.ts.map

package/dist/domain/graph/builder/stages/finalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize.d.ts","sourceRoot":"","sources":["../../../../../src/domain/graph/builder/stages/finalize.js"],"names":[],"mappings":"AAiBA;;GAEG;AACH,8BAFW,OAAO,eAAe,EAAE,eAAe,iBAwHjD"}

package/dist/domain/graph/builder/stages/finalize.js

@@ -0,0 +1,123 @@
+/**
+ * Stage: finalize
+ *
+ * WASM cleanup, stats logging, drift detection, build metadata, registry, journal.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { performance } from 'node:perf_hooks';
+import { closeDb, getBuildMeta, setBuildMeta } from '../../../../db/index.js';
+import { debug, info, warn } from '../../../../infrastructure/logger.js';
+import { writeJournalHeader } from '../../journal.js';
+const __builderDir = path.dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Z]:)/i, '$1'));
+const CODEGRAPH_VERSION = JSON.parse(fs.readFileSync(path.join(__builderDir, '..', '..', '..', '..', '..', 'package.json'), 'utf-8')).version;
+/**
+ * @param {import('../context.js').PipelineContext} ctx
+ */
+export async function finalize(ctx) {
+    const { db, allSymbols, rootDir, isFullBuild, hasEmbeddings, config, opts, schemaVersion } = ctx;
+    const t0 = performance.now();
+    // Release cached WASM trees
+    for (const [, symbols] of allSymbols) {
+        if (symbols._tree && typeof symbols._tree.delete === 'function') {
+            try {
+                symbols._tree.delete();
+            }
+            catch { }
+        }
+        symbols._tree = null;
+        symbols._langId = null;
+    }
+    const nodeCount = db.prepare('SELECT COUNT(*) as c FROM nodes').get().c;
+    const actualEdgeCount = db.prepare('SELECT COUNT(*) as c FROM edges').get().c;
+    info(`Graph built: ${nodeCount} nodes, ${actualEdgeCount} edges`);
+    info(`Stored in ${ctx.dbPath}`);
+    // Incremental drift detection
+    if (!isFullBuild) {
+        const prevNodes = getBuildMeta(db, 'node_count');
+        const prevEdges = getBuildMeta(db, 'edge_count');
+        if (prevNodes && prevEdges) {
+            const prevN = Number(prevNodes);
+            const prevE = Number(prevEdges);
+            if (prevN > 0) {
+                const nodeDrift = Math.abs(nodeCount - prevN) / prevN;
+                const edgeDrift = prevE > 0 ? Math.abs(actualEdgeCount - prevE) / prevE : 0;
+                const driftThreshold = config.build?.driftThreshold ?? 0.2;
+                if (nodeDrift > driftThreshold || edgeDrift > driftThreshold) {
+                    warn(`Incremental build diverged significantly from previous counts (nodes: ${prevN}→${nodeCount} [${(nodeDrift * 100).toFixed(1)}%], edges: ${prevE}→${actualEdgeCount} [${(edgeDrift * 100).toFixed(1)}%], threshold: ${(driftThreshold * 100).toFixed(0)}%). Consider rebuilding with --no-incremental.`);
+                }
+            }
+        }
+    }
+    // Orphaned embeddings warning
+    if (hasEmbeddings) {
+        try {
+            const orphaned = db
+                .prepare('SELECT COUNT(*) as c FROM embeddings WHERE node_id NOT IN (SELECT id FROM nodes)')
+                .get().c;
+            if (orphaned > 0) {
+                warn(`${orphaned} embeddings are orphaned (nodes changed). Run "codegraph embed" to refresh.`);
+            }
+        }
+        catch {
+            /* ignore — embeddings table may have been dropped */
+        }
+    }
+    // Unused exports warning
+    try {
+        const unusedCount = db
+            .prepare(`SELECT COUNT(*) as c FROM nodes
+       WHERE exported = 1 AND kind != 'file'
+         AND id NOT IN (
+           SELECT DISTINCT e.target_id FROM edges e
+           JOIN nodes caller ON e.source_id = caller.id
+           JOIN nodes target ON e.target_id = target.id
+           WHERE e.kind = 'calls' AND caller.file != target.file
+         )`)
+            .get().c;
+        if (unusedCount > 0) {
+            warn(`${unusedCount} exported symbol${unusedCount > 1 ? 's have' : ' has'} zero cross-file consumers. Run "codegraph exports <file> --unused" to inspect.`);
+        }
+    }
+    catch {
+        /* exported column may not exist on older DBs */
+    }
+    // Persist build metadata
+    try {
+        setBuildMeta(db, {
+            engine: ctx.engineName,
+            engine_version: ctx.engineVersion || '',
+            codegraph_version: CODEGRAPH_VERSION,
+            schema_version: String(schemaVersion),
+            built_at: new Date().toISOString(),
+            node_count: nodeCount,
+            edge_count: actualEdgeCount,
+        });
+    }
+    catch (err) {
+        warn(`Failed to write build metadata: ${err.message}`);
+    }
+    closeDb(db);
+    // Write journal header after successful build
+    writeJournalHeader(rootDir, Date.now());
+    // Auto-registration
+    if (!opts.skipRegistry) {
+        const { tmpdir } = await import('node:os');
+        const tmpDir = path.resolve(tmpdir());
+        const resolvedRoot = path.resolve(rootDir);
+        if (resolvedRoot.startsWith(tmpDir)) {
+            debug(`Skipping auto-registration for temp directory: ${resolvedRoot}`);
+        }
+        else {
+            try {
+                const { registerRepo } = await import('../../../../infrastructure/registry.js');
+                registerRepo(rootDir);
+            }
+            catch (err) {
+                debug(`Auto-registration failed: ${err.message}`);
+            }
+        }
+    }
+    ctx.timing.finalizeMs = performance.now() - t0;
+}
+//# sourceMappingURL=finalize.js.map

package/dist/domain/graph/builder/stages/finalize.js.map

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

package/dist/domain/graph/builder/stages/insert-nodes.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @param {import('../context.js').PipelineContext} ctx
+ */
+export function insertNodes(ctx: import("../context.js").PipelineContext): Promise<void>;
+//# sourceMappingURL=insert-nodes.d.ts.map

package/dist/domain/graph/builder/stages/insert-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insert-nodes.d.ts","sourceRoot":"","sources":["../../../../../src/domain/graph/builder/stages/insert-nodes.js"],"names":[],"mappings":"AA+JA;;GAEG;AACH,iCAFW,OAAO,eAAe,EAAE,eAAe,iBA0CjD"}