@optave/codegraph 3.1.5 → 3.3.0

package/dist/features/manifesto.js

@@ -0,0 +1,398 @@
+import { openReadonlyOrFail } from '../db/index.js';
+import { buildFileConditionSQL } from '../db/query-builder.js';
+import { findCycles } from '../domain/graph/cycles.js';
+import { loadConfig } from '../infrastructure/config.js';
+import { debug } from '../infrastructure/logger.js';
+import { paginateResult } from '../shared/paginate.js';
+import { evaluateBoundaries } from './boundaries.js';
+// ─── Rule Definitions ─────────────────────────────────────────────────
+/**
+ * All supported manifesto rules.
+ * level: 'function' | 'file' | 'graph'
+ * metric: DB column or special key
+ * defaults: { warn, fail } — null means disabled
+ */
+export const RULE_DEFS = [
+    {
+        name: 'cognitive',
+        level: 'function',
+        metric: 'cognitive',
+        defaults: { warn: 15, fail: null },
+        reportOnly: true,
+    },
+    {
+        name: 'cyclomatic',
+        level: 'function',
+        metric: 'cyclomatic',
+        defaults: { warn: 10, fail: null },
+        reportOnly: true,
+    },
+    {
+        name: 'maxNesting',
+        level: 'function',
+        metric: 'max_nesting',
+        defaults: { warn: 4, fail: null },
+        reportOnly: true,
+    },
+    {
+        name: 'importCount',
+        level: 'file',
+        metric: 'import_count',
+        defaults: { warn: null, fail: null },
+    },
+    {
+        name: 'exportCount',
+        level: 'file',
+        metric: 'export_count',
+        defaults: { warn: null, fail: null },
+    },
+    {
+        name: 'lineCount',
+        level: 'file',
+        metric: 'line_count',
+        defaults: { warn: null, fail: null },
+    },
+    { name: 'fanIn', level: 'file', metric: 'fan_in', defaults: { warn: null, fail: null } },
+    { name: 'fanOut', level: 'file', metric: 'fan_out', defaults: { warn: null, fail: null } },
+    { name: 'noCycles', level: 'graph', metric: 'noCycles', defaults: { warn: null, fail: null } },
+    {
+        name: 'boundaries',
+        level: 'graph',
+        metric: 'boundaries',
+        defaults: { warn: null, fail: null },
+    },
+];
+// ─── Helpers ──────────────────────────────────────────────────────────
+const NO_TEST_SQL = `
+  AND n.file NOT LIKE '%.test.%'
+  AND n.file NOT LIKE '%.spec.%'
+  AND n.file NOT LIKE '%__test__%'
+  AND n.file NOT LIKE '%__tests__%'
+  AND n.file NOT LIKE '%.stories.%'`;
+/**
+ * Deep-merge user config with RULE_DEFS defaults per rule.
+ * mergeConfig in config.js is shallow for nested objects, so we do per-rule merging here.
+ */
+function resolveRules(userRules) {
+    const resolved = {};
+    for (const def of RULE_DEFS) {
+        const user = userRules?.[def.name];
+        resolved[def.name] = {
+            warn: user?.warn !== undefined ? user.warn : def.defaults.warn,
+            fail: def.reportOnly ? null : user?.fail !== undefined ? user.fail : def.defaults.fail,
+        };
+    }
+    return resolved;
+}
+/**
+ * Check if a rule is enabled (has at least one non-null threshold).
+ */
+function isEnabled(thresholds) {
+    return thresholds.warn != null || thresholds.fail != null;
+}
+/**
+ * Check a numeric value against warn/fail thresholds, push violations.
+ */
+function checkThreshold(rule, thresholds, value, meta, violations) {
+    if (thresholds.fail != null && value >= thresholds.fail) {
+        violations.push({
+            rule,
+            level: 'fail',
+            value,
+            threshold: thresholds.fail,
+            ...meta,
+        });
+        return 'fail';
+    }
+    if (thresholds.warn != null && value >= thresholds.warn) {
+        violations.push({
+            rule,
+            level: 'warn',
+            value,
+            threshold: thresholds.warn,
+            ...meta,
+        });
+        return 'warn';
+    }
+    return 'pass';
+}
+// ─── Evaluators ───────────────────────────────────────────────────────
+function evaluateFunctionRules(db, rules, opts, violations, ruleResults) {
+    const functionDefs = RULE_DEFS.filter((d) => d.level === 'function');
+    const activeDefs = functionDefs.filter((d) => isEnabled(rules[d.name]));
+    if (activeDefs.length === 0) {
+        for (const def of functionDefs) {
+            ruleResults.push({
+                name: def.name,
+                level: def.level,
+                status: 'pass',
+                thresholds: rules[def.name],
+                violationCount: 0,
+            });
+        }
+        return;
+    }
+    let where = "WHERE n.kind IN ('function','method')";
+    const params = [];
+    if (opts.noTests)
+        where += NO_TEST_SQL;
+    {
+        const fc = buildFileConditionSQL(opts.file, 'n.file');
+        where += fc.sql;
+        params.push(...fc.params);
+    }
+    if (opts.kind) {
+        where += ' AND n.kind = ?';
+        params.push(opts.kind);
+    }
+    let rows;
+    try {
+        rows = db
+            .prepare(`SELECT n.name, n.kind, n.file, n.line,
+                fc.cognitive, fc.cyclomatic, fc.max_nesting
+         FROM function_complexity fc
+         JOIN nodes n ON fc.node_id = n.id
+         ${where}`)
+            .all(...params);
+    }
+    catch (err) {
+        debug('manifesto function query failed: %s', err.message);
+        rows = [];
+    }
+    // Track worst status per rule
+    const worst = {};
+    const counts = {};
+    for (const def of functionDefs) {
+        worst[def.name] = 'pass';
+        counts[def.name] = 0;
+    }
+    for (const row of rows) {
+        for (const def of activeDefs) {
+            const value = row[def.metric];
+            if (value == null)
+                continue;
+            const meta = { name: row.name, file: row.file, line: row.line };
+            const status = checkThreshold(def.name, rules[def.name], value, meta, violations);
+            if (status !== 'pass') {
+                counts[def.name]++;
+                if (status === 'fail')
+                    worst[def.name] = 'fail';
+                else if (worst[def.name] !== 'fail')
+                    worst[def.name] = 'warn';
+            }
+        }
+    }
+    for (const def of functionDefs) {
+        ruleResults.push({
+            name: def.name,
+            level: def.level,
+            status: worst[def.name],
+            thresholds: rules[def.name],
+            violationCount: counts[def.name],
+        });
+    }
+}
+function evaluateFileRules(db, rules, opts, violations, ruleResults) {
+    const fileDefs = RULE_DEFS.filter((d) => d.level === 'file');
+    const activeDefs = fileDefs.filter((d) => isEnabled(rules[d.name]));
+    if (activeDefs.length === 0) {
+        for (const def of fileDefs) {
+            ruleResults.push({
+                name: def.name,
+                level: def.level,
+                status: 'pass',
+                thresholds: rules[def.name],
+                violationCount: 0,
+            });
+        }
+        return;
+    }
+    let where = "WHERE n.kind = 'file'";
+    const params = [];
+    if (opts.noTests)
+        where += NO_TEST_SQL;
+    {
+        const fc = buildFileConditionSQL(opts.file, 'n.file');
+        where += fc.sql;
+        params.push(...fc.params);
+    }
+    let rows;
+    try {
+        rows = db
+            .prepare(`SELECT n.name, n.file, n.line,
+                nm.import_count, nm.export_count, nm.line_count,
+                nm.fan_in, nm.fan_out
+         FROM node_metrics nm
+         JOIN nodes n ON nm.node_id = n.id
+         ${where}`)
+            .all(...params);
+    }
+    catch (err) {
+        debug('manifesto file query failed: %s', err.message);
+        rows = [];
+    }
+    const worst = {};
+    const counts = {};
+    for (const def of fileDefs) {
+        worst[def.name] = 'pass';
+        counts[def.name] = 0;
+    }
+    for (const row of rows) {
+        for (const def of activeDefs) {
+            const value = row[def.metric];
+            if (value == null)
+                continue;
+            const meta = { name: row.name, file: row.file, line: row.line };
+            const status = checkThreshold(def.name, rules[def.name], value, meta, violations);
+            if (status !== 'pass') {
+                counts[def.name]++;
+                if (status === 'fail')
+                    worst[def.name] = 'fail';
+                else if (worst[def.name] !== 'fail')
+                    worst[def.name] = 'warn';
+            }
+        }
+    }
+    for (const def of fileDefs) {
+        ruleResults.push({
+            name: def.name,
+            level: def.level,
+            status: worst[def.name],
+            thresholds: rules[def.name],
+            violationCount: counts[def.name],
+        });
+    }
+}
+function evaluateGraphRules(db, rules, opts, violations, ruleResults) {
+    const thresholds = rules.noCycles;
+    if (!isEnabled(thresholds)) {
+        ruleResults.push({
+            name: 'noCycles',
+            level: 'graph',
+            status: 'pass',
+            thresholds,
+            violationCount: 0,
+        });
+        return;
+    }
+    const cycles = findCycles(db, { fileLevel: true, noTests: opts.noTests || false });
+    const hasCycles = cycles.length > 0;
+    if (!hasCycles) {
+        ruleResults.push({
+            name: 'noCycles',
+            level: 'graph',
+            status: 'pass',
+            thresholds,
+            violationCount: 0,
+        });
+        return;
+    }
+    // Determine level: fail takes precedence over warn
+    const level = thresholds.fail != null ? 'fail' : 'warn';
+    for (const cycle of cycles) {
+        violations.push({
+            rule: 'noCycles',
+            level,
+            name: `cycle(${cycle.length} files)`,
+            file: cycle.join(' → '),
+            line: null,
+            value: cycle.length,
+            threshold: 0,
+        });
+    }
+    ruleResults.push({
+        name: 'noCycles',
+        level: 'graph',
+        status: level,
+        thresholds,
+        violationCount: cycles.length,
+    });
+}
+function evaluateBoundaryRules(db, rules, config, opts, violations, ruleResults) {
+    const thresholds = rules.boundaries;
+    const boundaryConfig = config.manifesto?.boundaries;
+    // Auto-enable at warn level when boundary config exists but threshold not set
+    const effectiveThresholds = { ...thresholds };
+    if (boundaryConfig && !isEnabled(thresholds)) {
+        effectiveThresholds.warn = true;
+    }
+    if (!isEnabled(effectiveThresholds) || !boundaryConfig) {
+        ruleResults.push({
+            name: 'boundaries',
+            level: 'graph',
+            status: 'pass',
+            thresholds: effectiveThresholds,
+            violationCount: 0,
+        });
+        return;
+    }
+    const result = evaluateBoundaries(db, boundaryConfig, { noTests: opts.noTests || false });
+    const hasBoundaryViolations = result.violationCount > 0;
+    if (!hasBoundaryViolations) {
+        ruleResults.push({
+            name: 'boundaries',
+            level: 'graph',
+            status: 'pass',
+            thresholds: effectiveThresholds,
+            violationCount: 0,
+        });
+        return;
+    }
+    const level = effectiveThresholds.fail != null ? 'fail' : 'warn';
+    for (const v of result.violations) {
+        violations.push({
+            ...v,
+            level,
+        });
+    }
+    ruleResults.push({
+        name: 'boundaries',
+        level: 'graph',
+        status: level,
+        thresholds: effectiveThresholds,
+        violationCount: result.violationCount,
+    });
+}
+// ─── Public API ───────────────────────────────────────────────────────
+/**
+ * Evaluate all manifesto rules and return structured results.
+ *
+ * @param {string} [customDbPath] - Path to graph.db
+ * @param {object} [opts] - Options
+ * @param {boolean} [opts.noTests] - Exclude test files
+ * @param {string} [opts.file] - Filter by file (partial match)
+ * @param {string} [opts.kind] - Filter by symbol kind
+ * @returns {{ rules: object[], violations: object[], summary: object, passed: boolean }}
+ */
+export function manifestoData(customDbPath, opts = {}) {
+    const db = openReadonlyOrFail(customDbPath);
+    try {
+        const config = opts.config || loadConfig(process.cwd());
+        const rules = resolveRules(config.manifesto?.rules);
+        const violations = [];
+        const ruleResults = [];
+        evaluateFunctionRules(db, rules, opts, violations, ruleResults);
+        evaluateFileRules(db, rules, opts, violations, ruleResults);
+        evaluateGraphRules(db, rules, opts, violations, ruleResults);
+        evaluateBoundaryRules(db, rules, config, opts, violations, ruleResults);
+        const failViolations = violations.filter((v) => v.level === 'fail');
+        const summary = {
+            total: ruleResults.length,
+            passed: ruleResults.filter((r) => r.status === 'pass').length,
+            warned: ruleResults.filter((r) => r.status === 'warn').length,
+            failed: ruleResults.filter((r) => r.status === 'fail').length,
+            violationCount: violations.length,
+        };
+        const base = {
+            rules: ruleResults,
+            violations,
+            summary,
+            passed: failViolations.length === 0,
+        };
+        return paginateResult(base, 'violations', { limit: opts.limit, offset: opts.offset });
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=manifesto.js.map

package/dist/features/manifesto.js.map

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

package/dist/features/owners.d.ts

@@ -0,0 +1,123 @@
+/**
+ * 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: string): {
+    rules: Array<{
+        pattern: string;
+        owners: string[];
+        regex: RegExp;
+    }>;
+    path: string;
+} | null;
+/** Clear the parseCodeowners cache (for testing). */
+export function clearCodeownersCache(): void;
+/**
+ * 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: string): Array<{
+    pattern: string;
+    owners: string[];
+    regex: RegExp;
+}>;
+/**
+ * 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: any): RegExp;
+/**
+ * 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: string, rules: Array<{
+    pattern: string;
+    owners: string[];
+    regex: RegExp;
+}>): string[];
+/**
+ * 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: string[], repoRoot: string): {
+    owners: Map<string, string[]>;
+    affectedOwners: string[];
+    suggestedReviewers: string[];
+};
+/**
+ * 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?: string, opts?: {
+    owner?: string | undefined;
+    file?: string | undefined;
+    kind?: string | undefined;
+    noTests?: boolean | undefined;
+    boundary?: boolean | undefined;
+}): {
+    codeownersFile: null;
+    files: never[];
+    symbols: never[];
+    boundaries: never[];
+    summary: {
+        totalFiles: number;
+        ownedFiles: number;
+        unownedFiles: number;
+        coveragePercent: number;
+        ownerCount: number;
+        byOwner: never[];
+    };
+} | {
+    codeownersFile: string;
+    files: any;
+    symbols: any;
+    boundaries: {
+        from: {
+            name: any;
+            kind: any;
+            file: any;
+            line: any;
+            owners: string[];
+        };
+        to: {
+            name: any;
+            kind: any;
+            file: any;
+            line: any;
+            owners: string[];
+        };
+        edgeKind: any;
+    }[];
+    summary: {
+        totalFiles: any;
+        ownedFiles: number;
+        unownedFiles: number;
+        coveragePercent: number;
+        ownerCount: number;
+        byOwner: {
+            owner: any;
+            fileCount: any;
+        }[];
+    };
+};
+//# sourceMappingURL=owners.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"owners.d.ts","sourceRoot":"","sources":["../../src/features/owners.js"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,yCAHW,MAAM,GACJ;IAAE,KAAK,EAAE,KAAK,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAoBrG;AAED,qDAAqD;AACrD,6CAEC;AAED;;;;GAIG;AACH,gDAHW,MAAM,GACJ,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAAC,CAerE;AAED;;;;;;;;;GASG;AACH,qDAsCC;AAED;;;;;GAKG;AACH,sCAJW,MAAM,SACN,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAAC,GACvD,MAAM,EAAE,CAUpB;AAID;;;;;;GAMG;AACH,0CAJW,MAAM,EAAE,YACR,MAAM,GACJ;IAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAC;IAAC,kBAAkB,EAAE,MAAM,EAAE,CAAA;CAAE,CAerG;AAED;;;;;;;;;GASG;AACH,0CARW,MAAM,SAEd;IAAsB,KAAK;IACL,IAAI;IACJ,IAAI;IACH,OAAO;IACP,QAAQ;CACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6IA"}