@optave/codegraph 3.2.0 → 3.3.0

package/dist/features/owners.js

@@ -0,0 +1,289 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { findDbPath, openReadonlyOrFail } from '../db/index.js';
+import { normalizeFileFilter } from '../db/query-builder.js';
+import { isTestFile } from '../infrastructure/test-filter.js';
+// ─── CODEOWNERS Parsing ──────────────────────────────────────────────
+const CODEOWNERS_PATHS = ['CODEOWNERS', '.github/CODEOWNERS', 'docs/CODEOWNERS'];
+/** @type {Map<string, { rules: Array, path: string, mtime: number }>} */
+const codeownersCache = new Map();
+/**
+ * Find and parse a CODEOWNERS file from the standard locations.
+ * Results are cached per rootDir and invalidated when the file's mtime changes.
+ * @param {string} rootDir - Repository root directory
+ * @returns {{ rules: Array<{pattern: string, owners: string[], regex: RegExp}>, path: string } | null}
+ */
+export function parseCodeowners(rootDir) {
+    const cached = codeownersCache.get(rootDir);
+    for (const rel of CODEOWNERS_PATHS) {
+        const fullPath = path.join(rootDir, rel);
+        if (fs.existsSync(fullPath)) {
+            const mtime = fs.statSync(fullPath).mtimeMs;
+            if (cached && cached.path === rel && cached.mtime === mtime) {
+                return { rules: cached.rules, path: cached.path };
+            }
+            const content = fs.readFileSync(fullPath, 'utf-8');
+            const rules = parseCodeownersContent(content);
+            codeownersCache.set(rootDir, { rules, path: rel, mtime });
+            return { rules, path: rel };
+        }
+    }
+    codeownersCache.delete(rootDir);
+    return null;
+}
+/** Clear the parseCodeowners cache (for testing). */
+export function clearCodeownersCache() {
+    codeownersCache.clear();
+}
+/**
+ * Parse CODEOWNERS file content into rules.
+ * @param {string} content - Raw CODEOWNERS file content
+ * @returns {Array<{pattern: string, owners: string[], regex: RegExp}>}
+ */
+export function parseCodeownersContent(content) {
+    const rules = [];
+    for (const raw of content.split('\n')) {
+        const line = raw.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const parts = line.split(/\s+/);
+        if (parts.length < 2)
+            continue;
+        const pattern = parts[0];
+        const owners = parts.slice(1).filter((p) => p.startsWith('@') || /^[^@\s]+@[^@\s]+$/.test(p));
+        if (owners.length === 0)
+            continue;
+        rules.push({ pattern, owners, regex: patternToRegex(pattern) });
+    }
+    return rules;
+}
+/**
+ * Convert a CODEOWNERS glob pattern to a RegExp.
+ *
+ * CODEOWNERS semantics:
+ * - Leading `/` anchors to repo root; without it, matches anywhere
+ * - `*` matches anything except `/`
+ * - `**` matches everything including `/`
+ * - Trailing `/` matches directory contents
+ * - A bare filename like `Makefile` matches anywhere
+ */
+export function patternToRegex(pattern) {
+    let p = pattern;
+    const anchored = p.startsWith('/');
+    if (anchored)
+        p = p.slice(1);
+    const dirMatch = p.endsWith('/');
+    if (dirMatch)
+        p = p.slice(0, -1);
+    // Escape regex specials except * and ?
+    let regex = p.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+    // Replace ? first (single non-slash char) before ** handling
+    regex = regex.replace(/\?/g, '[^/]');
+    // Handle **/ (zero or more directories) and /** (everything below)
+    // Use placeholders to prevent single-* replacement from clobbering
+    regex = regex.replace(/\*\*\//g, '<DSS>');
+    regex = regex.replace(/\/\*\*/g, '<DSE>');
+    regex = regex.replace(/\*\*/g, '<DS>');
+    regex = regex.replace(/\*/g, '[^/]*');
+    regex = regex.replace(/<DSS>/g, '(.*/)?');
+    regex = regex.replace(/<DSE>/g, '/.*');
+    regex = regex.replace(/<DS>/g, '.*');
+    if (dirMatch) {
+        // Pattern like `docs/` matches everything under docs/
+        regex = anchored ? `^${regex}/` : `(?:^|/)${regex}/`;
+    }
+    else if (anchored) {
+        regex = `^${regex}$`;
+    }
+    else if (!regex.includes('/')) {
+        // Bare filename like `Makefile` or `*.js` — match anywhere
+        regex = `(?:^|/)${regex}$`;
+    }
+    else {
+        // Pattern with path separators but not anchored — match at start or after /
+        regex = `(?:^|/)${regex}$`;
+    }
+    return new RegExp(regex);
+}
+/**
+ * Find the owners for a file path. CODEOWNERS uses last-match-wins semantics.
+ * @param {string} filePath - Relative file path (forward slashes)
+ * @param {Array<{pattern: string, owners: string[], regex: RegExp}>} rules
+ * @returns {string[]}
+ */
+export function matchOwners(filePath, rules) {
+    let owners = [];
+    for (const rule of rules) {
+        if (rule.regex.test(filePath)) {
+            owners = rule.owners;
+        }
+    }
+    return owners;
+}
+// ─── Data Functions ──────────────────────────────────────────────────
+/**
+ * Lightweight helper for diff-impact integration.
+ * Returns owner mapping for a list of file paths.
+ * @param {string[]} filePaths - Relative file paths
+ * @param {string} repoRoot - Repository root directory
+ * @returns {{ owners: Map<string, string[]>, affectedOwners: string[], suggestedReviewers: string[] }}
+ */
+export function ownersForFiles(filePaths, repoRoot) {
+    const parsed = parseCodeowners(repoRoot);
+    if (!parsed)
+        return { owners: new Map(), affectedOwners: [], suggestedReviewers: [] };
+    const ownersMap = new Map();
+    const ownerSet = new Set();
+    for (const file of filePaths) {
+        const fileOwners = matchOwners(file, parsed.rules);
+        ownersMap.set(file, fileOwners);
+        for (const o of fileOwners)
+            ownerSet.add(o);
+    }
+    const affectedOwners = [...ownerSet].sort();
+    return { owners: ownersMap, affectedOwners, suggestedReviewers: affectedOwners };
+}
+/**
+ * Full ownership data for the graph.
+ * @param {string} [customDbPath]
+ * @param {object} [opts]
+ * @param {string} [opts.owner] - Filter to a specific owner
+ * @param {string} [opts.file] - Filter by partial file path
+ * @param {string} [opts.kind] - Filter by symbol kind
+ * @param {boolean} [opts.noTests] - Exclude test files
+ * @param {boolean} [opts.boundary] - Show cross-owner boundary edges
+ */
+export function ownersData(customDbPath, opts = {}) {
+    const db = openReadonlyOrFail(customDbPath);
+    try {
+        const dbPath = findDbPath(customDbPath);
+        const repoRoot = path.resolve(path.dirname(dbPath), '..');
+        const parsed = parseCodeowners(repoRoot);
+        if (!parsed) {
+            return {
+                codeownersFile: null,
+                files: [],
+                symbols: [],
+                boundaries: [],
+                summary: {
+                    totalFiles: 0,
+                    ownedFiles: 0,
+                    unownedFiles: 0,
+                    coveragePercent: 0,
+                    ownerCount: 0,
+                    byOwner: [],
+                },
+            };
+        }
+        // Get all distinct files from nodes
+        let allFiles = db
+            .prepare('SELECT DISTINCT file FROM nodes')
+            .all()
+            .map((r) => r.file);
+        if (opts.noTests)
+            allFiles = allFiles.filter((f) => !isTestFile(f));
+        const fileFilters = normalizeFileFilter(opts.file);
+        if (fileFilters.length > 0) {
+            allFiles = allFiles.filter((f) => fileFilters.some((filter) => f.includes(filter)));
+        }
+        // Map files to owners
+        const fileOwners = allFiles.map((file) => ({
+            file,
+            owners: matchOwners(file, parsed.rules),
+        }));
+        // Build owner-to-files index
+        const ownerIndex = new Map();
+        let ownedCount = 0;
+        for (const fo of fileOwners) {
+            if (fo.owners.length > 0)
+                ownedCount++;
+            for (const o of fo.owners) {
+                if (!ownerIndex.has(o))
+                    ownerIndex.set(o, []);
+                ownerIndex.get(o).push(fo.file);
+            }
+        }
+        // Filter files if --owner specified
+        let filteredFiles = fileOwners;
+        if (opts.owner) {
+            filteredFiles = fileOwners.filter((fo) => fo.owners.includes(opts.owner));
+        }
+        // Get symbols for filtered files
+        const fileSet = new Set(filteredFiles.map((fo) => fo.file));
+        let symbols = db
+            .prepare('SELECT name, kind, file, line FROM nodes')
+            .all()
+            .filter((n) => fileSet.has(n.file));
+        if (opts.noTests)
+            symbols = symbols.filter((s) => !isTestFile(s.file));
+        if (opts.kind)
+            symbols = symbols.filter((s) => s.kind === opts.kind);
+        const symbolsWithOwners = symbols.map((s) => ({
+            ...s,
+            owners: matchOwners(s.file, parsed.rules),
+        }));
+        // Boundary analysis — cross-owner call edges
+        const boundaries = [];
+        if (opts.boundary) {
+            const edges = db
+                .prepare(`SELECT e.id, e.kind AS edgeKind,
+                  s.name AS srcName, s.kind AS srcKind, s.file AS srcFile, s.line AS srcLine,
+                  t.name AS tgtName, t.kind AS tgtKind, t.file AS tgtFile, t.line AS tgtLine
+           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();
+            for (const e of edges) {
+                if (opts.noTests && (isTestFile(e.srcFile) || isTestFile(e.tgtFile)))
+                    continue;
+                const srcOwners = matchOwners(e.srcFile, parsed.rules);
+                const tgtOwners = matchOwners(e.tgtFile, parsed.rules);
+                // Cross-boundary: different owner sets
+                const srcKey = srcOwners.sort().join(',');
+                const tgtKey = tgtOwners.sort().join(',');
+                if (srcKey !== tgtKey) {
+                    boundaries.push({
+                        from: {
+                            name: e.srcName,
+                            kind: e.srcKind,
+                            file: e.srcFile,
+                            line: e.srcLine,
+                            owners: srcOwners,
+                        },
+                        to: {
+                            name: e.tgtName,
+                            kind: e.tgtKind,
+                            file: e.tgtFile,
+                            line: e.tgtLine,
+                            owners: tgtOwners,
+                        },
+                        edgeKind: e.edgeKind,
+                    });
+                }
+            }
+        }
+        // Summary
+        const byOwner = [...ownerIndex.entries()]
+            .map(([owner, files]) => ({ owner, fileCount: files.length }))
+            .sort((a, b) => b.fileCount - a.fileCount);
+        return {
+            codeownersFile: parsed.path,
+            files: filteredFiles,
+            symbols: symbolsWithOwners,
+            boundaries,
+            summary: {
+                totalFiles: allFiles.length,
+                ownedFiles: ownedCount,
+                unownedFiles: allFiles.length - ownedCount,
+                coveragePercent: allFiles.length > 0 ? Math.round((ownedCount / allFiles.length) * 100) : 0,
+                ownerCount: ownerIndex.size,
+                byOwner,
+            },
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=owners.js.map

package/dist/features/owners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owners.js","sourceRoot":"","sources":["../../src/features/owners.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,wEAAwE;AAExE,MAAM,gBAAgB,GAAG,CAAC,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;AAEjF,yEAAyE;AACzE,MAAM,eAAe,GAAG,IAAI,GAAG,EAAE,CAAC;AAElC;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAO;IACrC,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE5C,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACzC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YAC5C,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YACpD,CAAC;YACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,KAAK,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;YAC9C,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1D,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,oBAAoB;IAClC,eAAe,CAAC,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAO;IAC5C,MAAM,KAAK,GAAG,EAAE,CAAC;IACjB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9F,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAClC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,OAAO;IACpC,IAAI,CAAC,GAAG,OAAO,CAAC;IAChB,MAAM,QAAQ,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE7B,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,QAAQ;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEjC,uCAAuC;IACvC,IAAI,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAEnD,6DAA6D;IAC7D,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAErC,mEAAmE;IACnE,mEAAmE;IACnE,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1C,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1C,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC1C,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvC,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAErC,IAAI,QAAQ,EAAE,CAAC;QACb,sDAAsD;QACtD,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,UAAU,KAAK,GAAG,CAAC;IACvD,CAAC;SAAM,IAAI,QAAQ,EAAE,CAAC;QACpB,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC;IACvB,CAAC;SAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,2DAA2D;QAC3D,KAAK,GAAG,UAAU,KAAK,GAAG,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,4EAA4E;QAC5E,KAAK,GAAG,UAAU,KAAK,GAAG,CAAC;IAC7B,CAAC;IAED,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,QAAQ,EAAE,KAAK;IACzC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,wEAAwE;AAExE;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,SAAS,EAAE,QAAQ;IAChD,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,kBAAkB,EAAE,EAAE,EAAE,CAAC;IAEtF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACnD,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,UAAU;YAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IACD,MAAM,cAAc,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC;AACnF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,YAAY,EAAE,IAAI,GAAG,EAAE;IAChD,MAAM,EAAE,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;QAE1D,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,cAAc,EAAE,IAAI;gBACpB,KAAK,EAAE,EAAE;gBACT,OAAO,EAAE,EAAE;gBACX,UAAU,EAAE,EAAE;gBACd,OAAO,EAAE;oBACP,UAAU,EAAE,CAAC;oBACb,UAAU,EAAE,CAAC;oBACb,YAAY,EAAE,CAAC;oBACf,eAAe,EAAE,CAAC;oBAClB,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE,EAAE;iBACZ;aACF,CAAC;QACJ,CAAC;QAED,oCAAoC;QACpC,IAAI,QAAQ,GAAG,EAAE;aACd,OAAO,CAAC,iCAAiC,CAAC;aAC1C,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEtB,IAAI,IAAI,CAAC,OAAO;YAAE,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACtF,CAAC;QAED,sBAAsB;QACtB,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI;YACJ,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC;SACxC,CAAC,CAAC,CAAC;QAEJ,6BAA6B;QAC7B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;QAC7B,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,UAAU,EAAE,CAAC;YACvC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;gBAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;oBAAE,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9C,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,IAAI,aAAa,GAAG,UAAU,CAAC;QAC/B,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5E,CAAC;QAED,iCAAiC;QACjC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,IAAI,OAAO,GAAG,EAAE;aACb,OAAO,CAAC,0CAA0C,CAAC;aACnD,GAAG,EAAE;aACL,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAEtC,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACvE,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;QAErE,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,GAAG,CAAC;YACJ,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC;SAC1C,CAAC,CAAC,CAAC;QAEJ,6CAA6C;QAC7C,MAAM,UAAU,GAAG,EAAE,CAAC;QACtB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,EAAE;iBACb,OAAO,CACN;;;;;;kCAMwB,CACzB;iBACA,GAAG,EAAE,CAAC;YAET,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;oBAAE,SAAS;gBAC/E,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvD,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvD,uCAAuC;gBACvC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC1C,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;oBACtB,UAAU,CAAC,IAAI,CAAC;wBACd,IAAI,EAAE;4BACJ,IAAI,EAAE,CAAC,CAAC,OAAO;4BACf,IAAI,EAAE,CAAC,CAAC,OAAO;4BACf,IAAI,EAAE,CAAC,CAAC,OAAO;4BACf,IAAI,EAAE,CAAC,CAAC,OAAO;4BACf,MAAM,EAAE,SAAS;yBAClB;wBACD,EAAE,EAAE;4BACF,IAAI,EAAE,CAAC,CAAC,OAAO;4BACf,IAAI,EAAE,CAAC,CAAC,OAAO;4BACf,IAAI,EAAE,CAAC,CAAC,OAAO;4BACf,IAAI,EAAE,CAAC,CAAC,OAAO;4BACf,MAAM,EAAE,SAAS;yBAClB;wBACD,QAAQ,EAAE,CAAC,CAAC,QAAQ;qBACrB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,UAAU;QACV,MAAM,OAAO,GAAG,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;aACtC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;aAC7D,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;QAE7C,OAAO;YACL,cAAc,EAAE,MAAM,CAAC,IAAI;YAC3B,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,iBAAiB;YAC1B,UAAU;YACV,OAAO,EAAE;gBACP,UAAU,EAAE,QAAQ,CAAC,MAAM;gBAC3B,UAAU,EAAE,UAAU;gBACtB,YAAY,EAAE,QAAQ,CAAC,MAAM,GAAG,UAAU;gBAC1C,eAAe,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3F,UAAU,EAAE,UAAU,CAAC,IAAI;gBAC3B,OAAO;aACR;SACF,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/features/sequence.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Build sequence diagram data by BFS-forward from an entry point.
+ *
+ * @param {string} name - Symbol name to trace from
+ * @param {string} [dbPath]
+ * @param {object} [opts]
+ * @param {number} [opts.depth=10]
+ * @param {boolean} [opts.noTests]
+ * @param {string} [opts.file]
+ * @param {string} [opts.kind]
+ * @param {boolean} [opts.dataflow]
+ * @param {number} [opts.limit]
+ * @param {number} [opts.offset]
+ * @returns {{ entry, participants, messages, depth, totalMessages, truncated }}
+ */
+export function sequenceData(name: string, dbPath?: string, opts?: {
+    depth?: number | undefined;
+    noTests?: boolean | undefined;
+    file?: string | undefined;
+    kind?: string | undefined;
+    dataflow?: boolean | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}): {
+    entry: any;
+    participants: any;
+    messages: any;
+    depth: any;
+    totalMessages: any;
+    truncated: any;
+};
+export { sequenceToMermaid } from "../presentation/sequence-renderer.js";
+//# sourceMappingURL=sequence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../../src/features/sequence.js"],"names":[],"mappings":"AAuNA;;;;;;;;;;;;;;GAcG;AACH,mCAZW,MAAM,WACN,MAAM,SAEd;IAAsB,KAAK;IACJ,OAAO;IACR,IAAI;IACJ,IAAI;IACH,QAAQ;IACT,KAAK;IACL,MAAM;CAC5B,GAAU;IAAE,KAAK,MAAC;IAAC,YAAY,MAAC;IAAC,QAAQ,MAAC;IAAC,KAAK,MAAC;IAAC,aAAa,MAAC;IAAC,SAAS,MAAA;CAAE,CAsE9E"}

package/dist/features/sequence.js

@@ -0,0 +1,269 @@
+/**
+ * Sequence diagram generation – Mermaid sequenceDiagram from call graph edges.
+ *
+ * Participants are files (not individual functions). Calls within the same file
+ * become self-messages. This keeps diagrams readable and matches typical
+ * sequence-diagram conventions.
+ */
+import { openRepo } from '../db/index.js';
+import { SqliteRepository } from '../db/repository/sqlite-repository.js';
+import { findMatchingNodes } from '../domain/queries.js';
+import { loadConfig } from '../infrastructure/config.js';
+import { isTestFile } from '../infrastructure/test-filter.js';
+import { paginateResult } from '../shared/paginate.js';
+import { FRAMEWORK_ENTRY_PREFIXES } from './structure.js';
+// ─── Alias generation ────────────────────────────────────────────────
+/**
+ * Build short participant aliases from file paths with collision handling.
+ * e.g. "src/builder.js" → "builder", but if two files share basename,
+ * progressively add parent dirs: "src/builder" vs "lib/builder".
+ */
+function buildAliases(files) {
+    const aliases = new Map();
+    const basenames = new Map();
+    // Group by basename
+    for (const file of files) {
+        const base = file
+            .split('/')
+            .pop()
+            .replace(/\.[^.]+$/, '');
+        if (!basenames.has(base))
+            basenames.set(base, []);
+        basenames.get(base).push(file);
+    }
+    for (const [base, paths] of basenames) {
+        if (paths.length === 1) {
+            aliases.set(paths[0], base);
+        }
+        else {
+            // Collision — progressively add parent dirs until aliases are unique
+            for (let depth = 2; depth <= 10; depth++) {
+                const trial = new Map();
+                let allUnique = true;
+                const seen = new Set();
+                for (const p of paths) {
+                    const parts = p.replace(/\.[^.]+$/, '').split('/');
+                    const alias = parts
+                        .slice(-depth)
+                        .join('_')
+                        .replace(/[^a-zA-Z0-9_-]/g, '_');
+                    trial.set(p, alias);
+                    if (seen.has(alias))
+                        allUnique = false;
+                    seen.add(alias);
+                }
+                if (allUnique || depth === 10) {
+                    for (const [p, alias] of trial) {
+                        aliases.set(p, alias);
+                    }
+                    break;
+                }
+            }
+        }
+    }
+    return aliases;
+}
+// ─── Helpers ─────────────────────────────────────────────────────────
+function findEntryNode(repo, name, opts) {
+    let matchNode = findMatchingNodes(repo, name, opts)[0] ?? null;
+    if (!matchNode) {
+        for (const prefix of FRAMEWORK_ENTRY_PREFIXES) {
+            matchNode = findMatchingNodes(repo, `${prefix}${name}`, opts)[0] ?? null;
+            if (matchNode)
+                break;
+        }
+    }
+    return matchNode;
+}
+function bfsCallees(repo, matchNode, maxDepth, noTests) {
+    const visited = new Set([matchNode.id]);
+    let frontier = [matchNode.id];
+    const messages = [];
+    const fileSet = new Set([matchNode.file]);
+    const idToNode = new Map();
+    idToNode.set(matchNode.id, matchNode);
+    let truncated = false;
+    for (let d = 1; d <= maxDepth; d++) {
+        const nextFrontier = [];
+        for (const fid of frontier) {
+            const callees = repo.findCallees(fid);
+            const caller = idToNode.get(fid);
+            for (const c of callees) {
+                if (noTests && isTestFile(c.file))
+                    continue;
+                fileSet.add(c.file);
+                messages.push({
+                    from: caller.file,
+                    to: c.file,
+                    label: c.name,
+                    type: 'call',
+                    depth: d,
+                });
+                if (visited.has(c.id))
+                    continue;
+                visited.add(c.id);
+                nextFrontier.push(c.id);
+                idToNode.set(c.id, c);
+            }
+        }
+        frontier = nextFrontier;
+        if (frontier.length === 0)
+            break;
+        if (d === maxDepth && frontier.length > 0) {
+            const hasMoreCalls = frontier.some((fid) => repo.findCallees(fid).length > 0);
+            if (hasMoreCalls)
+                truncated = true;
+        }
+    }
+    return { messages, fileSet, idToNode, truncated };
+}
+function annotateDataflow(repo, messages, idToNode) {
+    const hasTable = repo.hasDataflowTable();
+    if (!hasTable || !(repo instanceof SqliteRepository))
+        return;
+    const db = repo.db;
+    const nodeByNameFile = new Map();
+    for (const n of idToNode.values()) {
+        nodeByNameFile.set(`${n.name}|${n.file}`, n);
+    }
+    const getReturns = db.prepare(`SELECT d.expression FROM dataflow d
+         WHERE d.source_id = ? AND d.kind = 'returns'`);
+    const getFlowsTo = db.prepare(`SELECT d.expression FROM dataflow d
+         WHERE d.target_id = ? AND d.kind = 'flows_to'
+         ORDER BY d.param_index`);
+    const seenReturns = new Set();
+    for (const msg of [...messages]) {
+        if (msg.type !== 'call')
+            continue;
+        const targetNode = nodeByNameFile.get(`${msg.label}|${msg.to}`);
+        if (!targetNode)
+            continue;
+        const returnKey = `${msg.to}->${msg.from}:${msg.label}`;
+        if (seenReturns.has(returnKey))
+            continue;
+        const returns = getReturns.all(targetNode.id);
+        if (returns.length > 0) {
+            seenReturns.add(returnKey);
+            const expr = returns[0].expression || 'result';
+            messages.push({
+                from: msg.to,
+                to: msg.from,
+                label: expr,
+                type: 'return',
+                depth: msg.depth,
+            });
+        }
+    }
+    for (const msg of messages) {
+        if (msg.type !== 'call')
+            continue;
+        const targetNode = nodeByNameFile.get(`${msg.label}|${msg.to}`);
+        if (!targetNode)
+            continue;
+        const params = getFlowsTo.all(targetNode.id);
+        if (params.length > 0) {
+            const paramNames = params
+                .map((p) => p.expression)
+                .filter(Boolean)
+                .slice(0, 3);
+            if (paramNames.length > 0) {
+                msg.label = `${msg.label}(${paramNames.join(', ')})`;
+            }
+        }
+    }
+}
+function buildParticipants(fileSet, entryFile) {
+    const aliases = buildAliases([...fileSet]);
+    const participants = [...fileSet].map((file) => ({
+        id: aliases.get(file),
+        label: file.split('/').pop(),
+        file,
+    }));
+    participants.sort((a, b) => {
+        if (a.file === entryFile)
+            return -1;
+        if (b.file === entryFile)
+            return 1;
+        return a.file.localeCompare(b.file);
+    });
+    return { participants, aliases };
+}
+// ─── Core data function ──────────────────────────────────────────────
+/**
+ * Build sequence diagram data by BFS-forward from an entry point.
+ *
+ * @param {string} name - Symbol name to trace from
+ * @param {string} [dbPath]
+ * @param {object} [opts]
+ * @param {number} [opts.depth=10]
+ * @param {boolean} [opts.noTests]
+ * @param {string} [opts.file]
+ * @param {string} [opts.kind]
+ * @param {boolean} [opts.dataflow]
+ * @param {number} [opts.limit]
+ * @param {number} [opts.offset]
+ * @returns {{ entry, participants, messages, depth, totalMessages, truncated }}
+ */
+export function sequenceData(name, dbPath, opts = {}) {
+    const { repo, close } = openRepo(dbPath, opts);
+    try {
+        const config = opts.config || loadConfig();
+        const maxDepth = opts.depth || config.analysis?.sequenceDepth || 10;
+        const noTests = opts.noTests || false;
+        const matchNode = findEntryNode(repo, name, opts);
+        if (!matchNode) {
+            return {
+                entry: null,
+                participants: [],
+                messages: [],
+                depth: maxDepth,
+                totalMessages: 0,
+                truncated: false,
+            };
+        }
+        const entry = {
+            name: matchNode.name,
+            file: matchNode.file,
+            kind: matchNode.kind,
+            line: matchNode.line,
+        };
+        const { messages, fileSet, idToNode, truncated } = bfsCallees(repo, matchNode, maxDepth, noTests);
+        if (opts.dataflow && messages.length > 0) {
+            annotateDataflow(repo, messages, idToNode);
+        }
+        messages.sort((a, b) => {
+            if (a.depth !== b.depth)
+                return a.depth - b.depth;
+            if (a.type === 'call' && b.type === 'return')
+                return -1;
+            if (a.type === 'return' && b.type === 'call')
+                return 1;
+            return 0;
+        });
+        const { participants, aliases } = buildParticipants(fileSet, entry.file);
+        for (const msg of messages) {
+            msg.from = aliases.get(msg.from);
+            msg.to = aliases.get(msg.to);
+        }
+        const base = {
+            entry,
+            participants,
+            messages,
+            depth: maxDepth,
+            totalMessages: messages.length,
+            truncated,
+        };
+        const result = paginateResult(base, 'messages', { limit: opts.limit, offset: opts.offset });
+        if (opts.limit !== undefined || opts.offset !== undefined) {
+            const activeFiles = new Set(result.messages.flatMap((m) => [m.from, m.to]));
+            result.participants = result.participants.filter((p) => activeFiles.has(p.id));
+        }
+        return result;
+    }
+    finally {
+        close();
+    }
+}
+// Re-export Mermaid renderer from presentation layer
+export { sequenceToMermaid } from '../presentation/sequence-renderer.js';
+//# sourceMappingURL=sequence.js.map

package/dist/features/sequence.js.map

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

package/dist/features/shared/find-nodes.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Look up node(s) by name with optional file/kind/noTests filtering.
+ *
+ * @param {object} db - open SQLite database handle
+ * @param {string} name - symbol name (partial LIKE match)
+ * @param {object} [opts] - { kind, file, noTests }
+ * @param {string[]} defaultKinds - fallback kinds when opts.kind is not set
+ * @returns {object[]} matching node rows
+ */
+export function findNodes(db: object, name: string, opts?: object, defaultKinds?: string[]): object[];
+//# sourceMappingURL=find-nodes.d.ts.map

package/dist/features/shared/find-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-nodes.d.ts","sourceRoot":"","sources":["../../../src/features/shared/find-nodes.js"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,8BANW,MAAM,QACN,MAAM,SACN,MAAM,iBACN,MAAM,EAAE,GACN,MAAM,EAAE,CAoBpB"}