@optave/codegraph 3.2.0 → 3.3.1

package/dist/domain/graph/change-journal.js

@@ -0,0 +1,120 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { debug, warn } from '../../infrastructure/logger.js';
+export const CHANGE_EVENTS_FILENAME = 'change-events.ndjson';
+export const DEFAULT_MAX_BYTES = 1024 * 1024; // 1 MB
+/**
+ * Returns the absolute path to the NDJSON change events file.
+ */
+export function changeEventsPath(rootDir) {
+    return path.join(rootDir, '.codegraph', CHANGE_EVENTS_FILENAME);
+}
+/**
+ * Compare old and new symbol arrays, returning added/removed/modified sets.
+ * Symbols are keyed on `name\0kind`. A symbol is "modified" if the same
+ * name+kind exists in both but the line changed.
+ *
+ * @param {Array<{name:string, kind:string, line:number}>} oldSymbols
+ * @param {Array<{name:string, kind:string, line:number}>} newSymbols
+ * @returns {{ added: Array, removed: Array, modified: Array }}
+ */
+export function diffSymbols(oldSymbols, newSymbols) {
+    const oldMap = new Map();
+    for (const s of oldSymbols) {
+        oldMap.set(`${s.name}\0${s.kind}`, s);
+    }
+    const newMap = new Map();
+    for (const s of newSymbols) {
+        newMap.set(`${s.name}\0${s.kind}`, s);
+    }
+    const added = [];
+    const removed = [];
+    const modified = [];
+    for (const [key, s] of newMap) {
+        const old = oldMap.get(key);
+        if (!old) {
+            added.push({ name: s.name, kind: s.kind, line: s.line });
+        }
+        else if (old.line !== s.line) {
+            modified.push({ name: s.name, kind: s.kind, line: s.line });
+        }
+    }
+    for (const [key, s] of oldMap) {
+        if (!newMap.has(key)) {
+            removed.push({ name: s.name, kind: s.kind });
+        }
+    }
+    return { added, removed, modified };
+}
+/**
+ * Assemble a single change event object.
+ */
+export function buildChangeEvent(file, event, symbolDiff, counts) {
+    return {
+        ts: new Date().toISOString(),
+        file,
+        event,
+        symbols: symbolDiff,
+        counts: {
+            nodes: { before: counts.nodesBefore ?? 0, after: counts.nodesAfter ?? 0 },
+            edges: { added: counts.edgesAdded ?? 0 },
+        },
+    };
+}
+/**
+ * Append change events as NDJSON lines to the change events file.
+ * Creates the .codegraph directory if needed. Non-fatal on failure.
+ */
+export function appendChangeEvents(rootDir, events) {
+    const filePath = changeEventsPath(rootDir);
+    const dir = path.dirname(filePath);
+    try {
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        const lines = `${events.map((e) => JSON.stringify(e)).join('\n')}\n`;
+        fs.appendFileSync(filePath, lines);
+        debug(`Appended ${events.length} change event(s) to ${filePath}`);
+    }
+    catch (err) {
+        warn(`Failed to append change events: ${err.message}`);
+        return;
+    }
+    try {
+        rotateIfNeeded(filePath, DEFAULT_MAX_BYTES);
+    }
+    catch {
+        /* rotation failure is non-fatal */
+    }
+}
+/**
+ * If the file exceeds maxBytes, keep the last ~half by finding
+ * the first newline at or after the midpoint and rewriting from there.
+ */
+export function rotateIfNeeded(filePath, maxBytes = DEFAULT_MAX_BYTES) {
+    let stat;
+    try {
+        stat = fs.statSync(filePath);
+    }
+    catch {
+        return; // file doesn't exist, nothing to rotate
+    }
+    if (stat.size <= maxBytes)
+        return;
+    try {
+        const buf = fs.readFileSync(filePath);
+        const mid = Math.floor(buf.length / 2);
+        const newlineIdx = buf.indexOf(0x0a, mid);
+        if (newlineIdx === -1) {
+            warn(`Change events file exceeds ${maxBytes} bytes but contains no line breaks; skipping rotation`);
+            return;
+        }
+        const kept = buf.slice(newlineIdx + 1);
+        fs.writeFileSync(filePath, kept);
+        debug(`Rotated change events: ${stat.size} → ${kept.length} bytes`);
+    }
+    catch (err) {
+        warn(`Failed to rotate change events: ${err.message}`);
+    }
+}
+//# sourceMappingURL=change-journal.js.map

package/dist/domain/graph/change-journal.js.map

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

package/dist/domain/graph/cycles.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Detect circular dependencies in the codebase using Tarjan's SCC algorithm.
+ * Dispatches to native Rust implementation when available, falls back to JS.
+ * @param {object} db - Open SQLite database
+ * @param {object} opts - { fileLevel: true, noTests: false }
+ * @returns {string[][]} Array of cycles, each cycle is an array of file paths
+ */
+export function findCycles(db: object, opts?: object): string[][];
+/**
+ * Pure-JS Tarjan's SCC implementation.
+ * Kept for backward compatibility — accepts raw {source, target}[] edges.
+ */
+export function findCyclesJS(edges: any): string[][];
+/**
+ * Format cycles for human-readable output.
+ */
+export function formatCycles(cycles: any): string;
+//# sourceMappingURL=cycles.d.ts.map

package/dist/domain/graph/cycles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycles.d.ts","sourceRoot":"","sources":["../../../src/domain/graph/cycles.js"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,+BAJW,MAAM,SACN,MAAM,GACJ,MAAM,EAAE,EAAE,CAsCtB;AAED;;;GAGG;AACH,qDAMC;AAED;;GAEG;AACH,kDAgBC"}

package/dist/domain/graph/cycles.js

@@ -0,0 +1,75 @@
+import { tarjan } from '../../graph/algorithms/tarjan.js';
+import { buildDependencyGraph } from '../../graph/builders/dependency.js';
+import { CodeGraph } from '../../graph/model.js';
+import { loadNative } from '../../infrastructure/native.js';
+/**
+ * Detect circular dependencies in the codebase using Tarjan's SCC algorithm.
+ * Dispatches to native Rust implementation when available, falls back to JS.
+ * @param {object} db - Open SQLite database
+ * @param {object} opts - { fileLevel: true, noTests: false }
+ * @returns {string[][]} Array of cycles, each cycle is an array of file paths
+ */
+export function findCycles(db, opts = {}) {
+    const fileLevel = opts.fileLevel !== false;
+    const noTests = opts.noTests || false;
+    const graph = buildDependencyGraph(db, { fileLevel, noTests });
+    // Build a label map: DB string ID → human-readable key
+    // File-level: file path; Function-level: name|file composite (for native Rust compat)
+    const idToLabel = new Map();
+    for (const [id, attrs] of graph.nodes()) {
+        if (fileLevel) {
+            idToLabel.set(id, attrs.file);
+        }
+        else {
+            idToLabel.set(id, `${attrs.label}|${attrs.file}`);
+        }
+    }
+    // Build edge array with human-readable keys (for native engine)
+    const edges = graph.toEdgeArray().map((e) => ({
+        source: idToLabel.get(e.source),
+        target: idToLabel.get(e.target),
+    }));
+    // Try native Rust implementation
+    const native = loadNative();
+    if (native) {
+        return native.detectCycles(edges);
+    }
+    // Fallback: JS Tarjan via graph subsystem
+    // Re-key graph with human-readable labels for consistent output
+    const labelGraph = new CodeGraph();
+    for (const { source, target } of edges) {
+        labelGraph.addEdge(source, target);
+    }
+    return tarjan(labelGraph);
+}
+/**
+ * Pure-JS Tarjan's SCC implementation.
+ * Kept for backward compatibility — accepts raw {source, target}[] edges.
+ */
+export function findCyclesJS(edges) {
+    const graph = new CodeGraph();
+    for (const { source, target } of edges) {
+        graph.addEdge(source, target);
+    }
+    return tarjan(graph);
+}
+/**
+ * Format cycles for human-readable output.
+ */
+export function formatCycles(cycles) {
+    if (cycles.length === 0) {
+        return 'No circular dependencies detected.';
+    }
+    const lines = [`Found ${cycles.length} circular dependency cycle(s):\n`];
+    for (let i = 0; i < cycles.length; i++) {
+        const cycle = cycles[i];
+        lines.push(`  Cycle ${i + 1} (${cycle.length} files):`);
+        for (const file of cycle) {
+            lines.push(`    -> ${file}`);
+        }
+        lines.push(`    -> ${cycle[0]} (back to start)`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=cycles.js.map

package/dist/domain/graph/cycles.js.map

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

package/dist/domain/graph/journal.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Read and validate the change journal.
+ * Returns { valid, timestamp, changed[], removed[] } or { valid: false }.
+ */
+export function readJournal(rootDir: any): {
+    valid: boolean;
+    timestamp?: undefined;
+    changed?: undefined;
+    removed?: undefined;
+} | {
+    valid: boolean;
+    timestamp: number;
+    changed: string[];
+    removed: string[];
+};
+/**
+ * Append changed/deleted paths to the journal.
+ * Creates the journal with a header if it doesn't exist.
+ */
+export function appendJournalEntries(rootDir: any, entries: any): void;
+/**
+ * Write a fresh journal header after a successful build.
+ * Atomic: write to temp file then rename.
+ */
+export function writeJournalHeader(rootDir: any, timestamp: any): void;
+export const JOURNAL_FILENAME: "changes.journal";
+//# sourceMappingURL=journal.d.ts.map

package/dist/domain/graph/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../../src/domain/graph/journal.js"],"names":[],"mappings":"AAOA;;;GAGG;AACH;;;;;;;;;;EA6CC;AAED;;;GAGG;AACH,uEAmBC;AAED;;;GAGG;AACH,uEAqBC;AAxGD,+BAAgC,iBAAiB,CAAC"}

package/dist/domain/graph/journal.js

@@ -0,0 +1,100 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { debug, warn } from '../../infrastructure/logger.js';
+export const JOURNAL_FILENAME = 'changes.journal';
+const HEADER_PREFIX = '# codegraph-journal v1 ';
+/**
+ * Read and validate the change journal.
+ * Returns { valid, timestamp, changed[], removed[] } or { valid: false }.
+ */
+export function readJournal(rootDir) {
+    const journalPath = path.join(rootDir, '.codegraph', JOURNAL_FILENAME);
+    let content;
+    try {
+        content = fs.readFileSync(journalPath, 'utf-8');
+    }
+    catch {
+        return { valid: false };
+    }
+    const lines = content.split('\n');
+    if (lines.length === 0 || !lines[0].startsWith(HEADER_PREFIX)) {
+        debug('Journal has malformed or missing header');
+        return { valid: false };
+    }
+    const timestamp = Number(lines[0].slice(HEADER_PREFIX.length).trim());
+    if (!Number.isFinite(timestamp) || timestamp <= 0) {
+        debug('Journal has invalid timestamp');
+        return { valid: false };
+    }
+    const changed = [];
+    const removed = [];
+    const seenChanged = new Set();
+    const seenRemoved = new Set();
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        if (line.startsWith('DELETED ')) {
+            const filePath = line.slice(8);
+            if (filePath && !seenRemoved.has(filePath)) {
+                seenRemoved.add(filePath);
+                removed.push(filePath);
+            }
+        }
+        else {
+            if (!seenChanged.has(line)) {
+                seenChanged.add(line);
+                changed.push(line);
+            }
+        }
+    }
+    return { valid: true, timestamp, changed, removed };
+}
+/**
+ * Append changed/deleted paths to the journal.
+ * Creates the journal with a header if it doesn't exist.
+ */
+export function appendJournalEntries(rootDir, entries) {
+    const dir = path.join(rootDir, '.codegraph');
+    const journalPath = path.join(dir, JOURNAL_FILENAME);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // If journal doesn't exist, create with a placeholder header
+    if (!fs.existsSync(journalPath)) {
+        fs.writeFileSync(journalPath, `${HEADER_PREFIX}0\n`);
+    }
+    const lines = entries.map((e) => {
+        if (e.deleted)
+            return `DELETED ${e.file}`;
+        return e.file;
+    });
+    fs.appendFileSync(journalPath, `${lines.join('\n')}\n`);
+}
+/**
+ * Write a fresh journal header after a successful build.
+ * Atomic: write to temp file then rename.
+ */
+export function writeJournalHeader(rootDir, timestamp) {
+    const dir = path.join(rootDir, '.codegraph');
+    const journalPath = path.join(dir, JOURNAL_FILENAME);
+    const tmpPath = `${journalPath}.tmp`;
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    try {
+        fs.writeFileSync(tmpPath, `${HEADER_PREFIX}${timestamp}\n`);
+        fs.renameSync(tmpPath, journalPath);
+    }
+    catch (err) {
+        warn(`Failed to write journal header: ${err.message}`);
+        // Clean up temp file if rename failed
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+//# sourceMappingURL=journal.js.map

package/dist/domain/graph/journal.js.map

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

package/dist/domain/graph/resolve.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Parse a bare specifier into { packageName, subpath }.
+ * Scoped: "@scope/pkg/sub" → { packageName: "@scope/pkg", subpath: "./sub" }
+ * Plain:  "pkg/sub"        → { packageName: "pkg", subpath: "./sub" }
+ * No sub: "pkg"            → { packageName: "pkg", subpath: "." }
+ */
+export function parseBareSpecifier(specifier: any): {
+    packageName: any;
+    subpath: string;
+} | null;
+/**
+ * Resolve a bare specifier through the package.json exports field.
+ * Returns an absolute path or null.
+ */
+export function resolveViaExports(specifier: any, rootDir: any): string | null;
+/** Clear the exports cache (for testing). */
+export function clearExportsCache(): void;
+/**
+ * Set the workspace map for a given rootDir.
+ * Called by the build pipeline after detecting workspaces.
+ * @param {string} rootDir
+ * @param {Map<string, { dir: string, entry: string|null }>} map
+ */
+export function setWorkspaces(rootDir: string, map: Map<string, {
+    dir: string;
+    entry: string | null;
+}>): void;
+/**
+ * Resolve a bare specifier through monorepo workspace packages.
+ *
+ * For "@myorg/utils" → finds the workspace package dir → resolves entry point.
+ * For "@myorg/utils/sub" → finds package dir → tries exports field → filesystem probe.
+ *
+ * @returns {string|null} Absolute path to resolved file, or null.
+ */
+export function resolveViaWorkspace(specifier: any, rootDir: any): string | null;
+/**
+ * Check if a resolved relative path was resolved via workspace detection.
+ * Used by computeConfidence to assign high confidence (0.95) to workspace imports.
+ */
+export function isWorkspaceResolved(resolvedPath: any): boolean;
+/** Clear workspace caches (for testing). */
+export function clearWorkspaceCache(): void;
+/**
+ * Convert JS alias format { baseUrl, paths: { pattern: [targets] } }
+ * to native format { baseUrl, paths: [{ pattern, targets }] }.
+ */
+export function convertAliasesForNative(aliases: any): {
+    baseUrl: any;
+    paths: {
+        pattern: string;
+        targets: any;
+    }[];
+} | null;
+/**
+ * Resolve a single import path.
+ * Tries native, falls back to JS.
+ */
+export function resolveImportPath(fromFile: any, importSource: any, rootDir: any, aliases: any): any;
+/**
+ * Compute proximity-based confidence for call resolution.
+ * Tries native, falls back to JS.
+ */
+export function computeConfidence(callerFile: any, targetFile: any, importedFrom: any): any;
+/**
+ * Batch resolve multiple imports in a single native call.
+ * Returns Map<"fromFile|importSource", resolvedPath> or null when native unavailable.
+ * @param {Array} inputs - Array of { fromFile, importSource }
+ * @param {string} rootDir - Project root
+ * @param {object} aliases - Path aliases
+ * @param {string[]} [knownFiles] - Optional file paths for FS cache (avoids syscalls)
+ */
+export function resolveImportsBatch(inputs: any[], rootDir: string, aliases: object, knownFiles?: string[]): Map<any, any> | null;
+export function computeConfidenceJS(callerFile: any, targetFile: any, importedFrom: any): 1 | 0.3 | 0.5 | 0.95 | 0.7;
+export function resolveImportPathJS(fromFile: any, importSource: any, rootDir: any, aliases: any): any;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/domain/graph/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/domain/graph/resolve.js"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH;;;SAkBC;AA4ED;;;GAGG;AACH,+EA0EC;AAED,6CAA6C;AAC7C,0CAEC;AAUD;;;;;GAKG;AACH,uCAHW,MAAM,OACN,GAAG,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAC,IAAI,CAAA;CAAE,CAAC,QAM1D;AASD;;;;;;;GAOG;AACH,mEAFa,MAAM,GAAC,IAAI,CA6DvB;AAED;;;GAGG;AACH,gEAEC;AAED,4CAA4C;AAC5C,4CAGC;AAID;;;GAGG;AACH;;;;;;SASC;AAqGD;;;GAGG;AACH,qGAgBC;AAED;;;GAGG;AACH,4FAUC;AAED;;;;;;;GAOG;AACH,4DAJW,MAAM,WACN,MAAM,eACN,MAAM,EAAE,wBAyBlB;AApFD,qHAWC;AA5DD,uGA+CC"}