@monoes/monograph 1.1.0 → 1.2.1

package/dist/src/graph/codeowners-extended.d.ts

@@ -0,0 +1,42 @@
+export interface CodeOwnerRuleMatch {
+    ownerCount: number;
+    owners: string[];
+    sectionName: string | null;
+    matchedRule: string;
+}
+export interface SectionMatch {
+    sectionName: string | null;
+    sectionOwners: string[];
+    matchedRule: string;
+}
+export interface CodeOwnersLike {
+    ownerAndRuleOf?: (path: string) => CodeOwnerRuleMatch | null;
+    sectionAndOwnersOf?: (path: string) => SectionMatch | null;
+    hasSections?: boolean;
+    ownersOf: (path: string) => string[] | null;
+}
+export declare const UNOWNED_LABEL = "(unowned)";
+export declare const NO_SECTION_LABEL = "(no section)";
+export declare function ownerCountOf(co: CodeOwnersLike, relativePath: string): number | null;
+export declare function sectionOf(co: CodeOwnersLike, relativePath: string): string | null | undefined;
+export declare function sectionAndOwnersOf(co: CodeOwnersLike, relativePath: string): SectionMatch | null;
+export declare function hasGitLabSections(co: CodeOwnersLike): boolean;
+export declare function ownerLabel(co: CodeOwnersLike, relativePath: string): string;
+export interface OwnershipAggregate {
+    /** Paths that have no owner. */
+    unowned: string[];
+    /** Map from owner handle → list of owned file paths. */
+    byOwner: Map<string, string[]>;
+    /** Total files analyzed. */
+    totalFiles: number;
+}
+/**
+ * Aggregate ownership across a list of relative paths in a single pass.
+ * Each file is attributed to its primary owner (first in the owners list).
+ */
+export declare function aggregateOwnership(co: CodeOwnersLike, relativePaths: string[]): OwnershipAggregate;
+/**
+ * Format an OwnershipAggregate as structured text for LLM consumption.
+ */
+export declare function formatOwnershipReport(agg: OwnershipAggregate): string;
+//# sourceMappingURL=codeowners-extended.d.ts.map

package/dist/src/graph/codeowners-extended.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeowners-extended.d.ts","sourceRoot":"","sources":["../../../src/graph/codeowners-extended.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,kBAAkB,GAAG,IAAI,CAAC;IAC7D,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI,CAAC;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,GAAG,IAAI,CAAC;CAC7C;AAED,eAAO,MAAM,aAAa,cAAc,CAAC;AACzC,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,wBAAgB,YAAY,CAAC,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASpF;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAK7F;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAGhG;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,GAAG,OAAO,CAE7D;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAS3E;AAED,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wDAAwD;IACxD,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,cAAc,EAClB,aAAa,EAAE,MAAM,EAAE,GACtB,kBAAkB,CAiBpB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAcrE"}

package/dist/src/graph/codeowners-extended.js

@@ -0,0 +1,85 @@
+export const UNOWNED_LABEL = '(unowned)';
+export const NO_SECTION_LABEL = '(no section)';
+export function ownerCountOf(co, relativePath) {
+    if (co.ownerAndRuleOf) {
+        const match = co.ownerAndRuleOf(relativePath);
+        if (!match)
+            return null;
+        return match.ownerCount;
+    }
+    const owners = co.ownersOf(relativePath);
+    if (owners === null)
+        return null;
+    return owners.length;
+}
+export function sectionOf(co, relativePath) {
+    if (!co.sectionAndOwnersOf)
+        return undefined;
+    const match = co.sectionAndOwnersOf(relativePath);
+    if (!match)
+        return undefined;
+    return match.sectionName;
+}
+export function sectionAndOwnersOf(co, relativePath) {
+    if (!co.sectionAndOwnersOf)
+        return null;
+    return co.sectionAndOwnersOf(relativePath) ?? null;
+}
+export function hasGitLabSections(co) {
+    return co.hasSections ?? false;
+}
+export function ownerLabel(co, relativePath) {
+    const owners = co.ownersOf(relativePath);
+    if (owners === null)
+        return UNOWNED_LABEL;
+    if (owners.length === 0) {
+        const section = sectionOf(co, relativePath);
+        if (section === null)
+            return NO_SECTION_LABEL;
+        return UNOWNED_LABEL;
+    }
+    return owners[0];
+}
+/**
+ * Aggregate ownership across a list of relative paths in a single pass.
+ * Each file is attributed to its primary owner (first in the owners list).
+ */
+export function aggregateOwnership(co, relativePaths) {
+    const unowned = [];
+    const byOwner = new Map();
+    for (const path of relativePaths) {
+        const owners = co.ownersOf(path);
+        if (!owners || owners.length === 0) {
+            unowned.push(path);
+        }
+        else {
+            const primary = owners[0];
+            let bucket = byOwner.get(primary);
+            if (!bucket) {
+                bucket = [];
+                byOwner.set(primary, bucket);
+            }
+            bucket.push(path);
+        }
+    }
+    return { unowned, byOwner, totalFiles: relativePaths.length };
+}
+/**
+ * Format an OwnershipAggregate as structured text for LLM consumption.
+ */
+export function formatOwnershipReport(agg) {
+    const lines = [
+        `Ownership report: ${agg.totalFiles} files, ${agg.byOwner.size} owner(s), ${agg.unowned.length} unowned`,
+        '',
+    ];
+    // Sort owners by file count descending
+    const sorted = Array.from(agg.byOwner.entries()).sort((a, b) => b[1].length - a[1].length);
+    for (const [owner, files] of sorted) {
+        lines.push(`  ${owner}: ${files.length} file(s)`);
+    }
+    if (agg.unowned.length > 0) {
+        lines.push(`  ${UNOWNED_LABEL}: ${agg.unowned.length} file(s)`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=codeowners-extended.js.map

package/dist/src/graph/codeowners-extended.js.map

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

package/dist/src/graph/codeowners-gitlab.d.ts

@@ -0,0 +1,50 @@
+export declare const UNOWNED_LABEL = "UNOWNED";
+export declare const NO_SECTION_LABEL = "(no section)";
+export declare const CODEOWNERS_PROBE_PATHS: string[];
+export interface SectionHeader {
+    name: string;
+    optional: boolean;
+    minApprovals?: number;
+    defaultOwners: string[];
+}
+export declare function parseSectionHeader(line: string): SectionHeader | null;
+export interface CodeownersEntry {
+    pattern: string;
+    owners: string[];
+    section?: string;
+    negated: boolean;
+}
+export declare function parseCodeownersWithSections(content: string): CodeownersEntry[];
+export declare function matchOwners(entries: CodeownersEntry[], filePath: string): {
+    owners: string[];
+    section?: string;
+};
+/** Single-call helper — avoids triple matchOwners invocations when callers need all three fields. */
+export declare function singleFileOwnership(entries: CodeownersEntry[], filePath: string): {
+    section: string;
+    owners: string[];
+    ownerCount: number;
+};
+export declare function ownerCountOf(entries: CodeownersEntry[], filePath: string): number;
+export declare function sectionOf(entries: CodeownersEntry[], filePath: string): string;
+export declare function sectionAndOwnersOf(entries: CodeownersEntry[], filePath: string): {
+    section: string;
+    owners: string[];
+};
+export declare function hasSections(entries: CodeownersEntry[]): boolean;
+export interface CodeownersGitlabReport {
+    totalEntries: number;
+    hasSections: boolean;
+    sectionNames: string[];
+    ownershipSummary: Array<{
+        file: string;
+        section: string;
+        owners: string[];
+    }>;
+}
+/**
+ * Format a batch file-ownership report for LLM consumption.
+ * Uses singleFileOwnership() to avoid N*3 matchOwners scans.
+ */
+export declare function formatCodeownersGitlab(entries: CodeownersEntry[], filePaths: string[]): string;
+//# sourceMappingURL=codeowners-gitlab.d.ts.map

package/dist/src/graph/codeowners-gitlab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeowners-gitlab.d.ts","sourceRoot":"","sources":["../../../src/graph/codeowners-gitlab.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,YAAY,CAAC;AACvC,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,eAAO,MAAM,sBAAsB,UAKlC,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAUrE;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CA0B9E;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAUhH;AAYD,qGAAqG;AACrG,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAG3I;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAGtH;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAE/D;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC9E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CA2B9F"}

package/dist/src/graph/codeowners-gitlab.js

@@ -0,0 +1,126 @@
+export const UNOWNED_LABEL = 'UNOWNED';
+export const NO_SECTION_LABEL = '(no section)';
+export const CODEOWNERS_PROBE_PATHS = [
+    'CODEOWNERS',
+    'docs/CODEOWNERS',
+    '.github/CODEOWNERS',
+    '.gitlab/CODEOWNERS',
+];
+const SECTION_HEADER_RE = /^(\^)?\[([^\]]+)\](?:\[(\d+)\])?\s*(.*)?$/;
+export function parseSectionHeader(line) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith('[') && !trimmed.startsWith('^['))
+        return null;
+    const m = trimmed.match(SECTION_HEADER_RE);
+    if (!m)
+        return null;
+    const optional = m[1] === '^';
+    const name = m[2].trim();
+    const minApprovals = m[3] ? parseInt(m[3], 10) : undefined;
+    const defaultOwners = (m[4] ?? '').trim().split(/\s+/).filter(Boolean);
+    return { name, optional, minApprovals, defaultOwners };
+}
+export function parseCodeownersWithSections(content) {
+    const entries = [];
+    let currentSection;
+    let sectionDefaults = [];
+    for (const raw of content.split('\n')) {
+        const line = raw.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const sectionHeader = parseSectionHeader(line);
+        if (sectionHeader) {
+            currentSection = sectionHeader.name;
+            sectionDefaults = sectionHeader.defaultOwners;
+            if (sectionDefaults.length > 0) {
+                entries.push({ pattern: '**/*', owners: sectionDefaults, section: currentSection, negated: false });
+            }
+            continue;
+        }
+        const negated = line.startsWith('!');
+        const rest = negated ? line.slice(1).trim() : line;
+        const parts = rest.split(/\s+/);
+        const pattern = parts[0];
+        if (!pattern)
+            continue;
+        const owners = negated ? [] : parts.slice(1);
+        entries.push({ pattern, owners, section: currentSection, negated });
+    }
+    return entries;
+}
+export function matchOwners(entries, filePath) {
+    // Import minimatch dynamically to avoid circular deps — use simple suffix matching as fallback
+    for (let i = entries.length - 1; i >= 0; i--) {
+        const entry = entries[i];
+        if (pathMatchesPattern(filePath, entry.pattern)) {
+            if (entry.negated)
+                return { owners: [], section: entry.section };
+            return { owners: entry.owners, section: entry.section };
+        }
+    }
+    return { owners: [], section: undefined };
+}
+function pathMatchesPattern(filePath, pattern) {
+    const norm = filePath.replace(/\\/g, '/');
+    const pat = pattern.replace(/\\/g, '/');
+    if (pat === '**/*')
+        return true;
+    if (pat.startsWith('**'))
+        return norm.endsWith(pat.slice(2));
+    if (pat.startsWith('/'))
+        return norm === pat.slice(1) || norm.startsWith(pat.slice(1) + '/');
+    if (pat.endsWith('/'))
+        return norm.startsWith(pat);
+    return norm === pat || norm.endsWith('/' + pat) || norm.startsWith(pat + '/');
+}
+/** Single-call helper — avoids triple matchOwners invocations when callers need all three fields. */
+export function singleFileOwnership(entries, filePath) {
+    const { owners, section } = matchOwners(entries, filePath);
+    return { section: section ?? NO_SECTION_LABEL, owners, ownerCount: owners.length };
+}
+export function ownerCountOf(entries, filePath) {
+    return matchOwners(entries, filePath).owners.length;
+}
+export function sectionOf(entries, filePath) {
+    return matchOwners(entries, filePath).section ?? NO_SECTION_LABEL;
+}
+export function sectionAndOwnersOf(entries, filePath) {
+    const { owners, section } = matchOwners(entries, filePath);
+    return { section: section ?? NO_SECTION_LABEL, owners };
+}
+export function hasSections(entries) {
+    return entries.some(e => e.section !== undefined);
+}
+/**
+ * Format a batch file-ownership report for LLM consumption.
+ * Uses singleFileOwnership() to avoid N*3 matchOwners scans.
+ */
+export function formatCodeownersGitlab(entries, filePaths) {
+    if (entries.length === 0)
+        return 'No CODEOWNERS entries found.';
+    const sections = new Set();
+    const rows = [];
+    for (const fp of filePaths) {
+        const { section, owners } = singleFileOwnership(entries, fp);
+        sections.add(section);
+        rows.push({ file: fp, section, owners });
+    }
+    const unowned = rows.filter(r => r.owners.length === 0);
+    const lines = [
+        `CODEOWNERS (GitLab) — ${entries.length} entries, ${sections.size} section(s)`,
+        `Sections: ${[...sections].join(', ') || '(none)'}`,
+        `Files scanned: ${filePaths.length}  Unowned: ${unowned.length}`,
+        '',
+    ];
+    for (const r of rows) {
+        const ownerStr = r.owners.length > 0 ? r.owners.join(' ') : UNOWNED_LABEL;
+        lines.push(`  ${r.file}  [${r.section}]  ${ownerStr}`);
+    }
+    if (unowned.length > 0) {
+        lines.push('', `Unowned files (${unowned.length}):`);
+        for (const r of unowned)
+            lines.push(`  ${r.file}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=codeowners-gitlab.js.map

package/dist/src/graph/codeowners-gitlab.js.map

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

package/dist/src/graph/codeowners.d.ts

@@ -0,0 +1,30 @@
+import type Database from 'better-sqlite3';
+export interface CodeownersEntry {
+    pattern: string;
+    owners: string[];
+}
+export interface OwnershipResult {
+    filePath: string;
+    declaredOwners: string[];
+    unowned: boolean;
+}
+export declare function parseCodeowners(repoRoot: string): CodeownersEntry[];
+export interface CompiledEntry {
+    owners: string[];
+    re: RegExp;
+}
+/**
+ * Compile an array of CodeownersEntry into CompiledEntry objects so that
+ * globToRegex() runs exactly once per pattern instead of once per file lookup.
+ */
+export declare function compileEntries(entries: CodeownersEntry[]): CompiledEntry[];
+export declare function resolveOwnerCompiled(compiled: CompiledEntry[], filePath: string): string[];
+export declare function resolveOwner(entries: CodeownersEntry[], filePath: string): string[];
+export declare function annotateOwnership(db: Database.Database, repoRoot: string): {
+    annotated: number;
+    unowned: number;
+};
+export declare function groupByOwner<T extends {
+    filePath?: string | null;
+}>(findings: T[], entries: CodeownersEntry[]): Map<string, T[]>;
+//# sourceMappingURL=codeowners.d.ts.map

package/dist/src/graph/codeowners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeowners.d.ts","sourceRoot":"","sources":["../../../src/graph/codeowners.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAqDD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE,CAgCnE;AAID,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE,CAE1E;AAID,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAO1F;AAID,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAanF;AAGD,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,GACf;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAiCxC;AAKD,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACjE,QAAQ,EAAE,CAAC,EAAE,EACb,OAAO,EAAE,eAAe,EAAE,GACzB,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CA4BlB"}

package/dist/src/graph/codeowners.js

@@ -0,0 +1,175 @@
+import { existsSync, readFileSync } from 'fs';
+import { join, relative } from 'path';
+// Convert a CODEOWNERS glob pattern to a RegExp
+function globToRegex(pattern) {
+    // Strip leading slash (anchors to root — handle separately)
+    const anchored = pattern.startsWith('/');
+    let p = pattern;
+    if (anchored)
+        p = p.slice(1);
+    // Trailing slash: match directory and everything beneath it
+    const dirOnly = p.endsWith('/');
+    if (dirOnly)
+        p = p.slice(0, -1);
+    // Escape special regex chars except * and ?
+    p = p.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+    // ** → match anything (including slashes)
+    p = p.replace(/\*\*/g, '§DOUBLESTAR§');
+    // * → match anything except slash
+    p = p.replace(/\*/g, '[^/]*');
+    // ? → match any single char except slash
+    p = p.replace(/\?/g, '[^/]');
+    // Restore **
+    p = p.replace(/§DOUBLESTAR§/g, '.*');
+    let regexStr;
+    if (anchored) {
+        // Anchored to repo root
+        if (dirOnly) {
+            regexStr = `^${p}(/|$)`;
+        }
+        else if (p.includes('/')) {
+            // has slash → match full path from root
+            regexStr = `^${p}(/.*)?$`;
+        }
+        else {
+            regexStr = `^${p}(/.*)?$`;
+        }
+    }
+    else if (p.includes('/')) {
+        // Contains slash but not anchored → match from root
+        regexStr = `(^|/)${p}(/.*)?$`;
+    }
+    else {
+        // No slash → match filename anywhere in tree
+        if (dirOnly) {
+            regexStr = `(^|/)${p}(/|$)`;
+        }
+        else {
+            regexStr = `(^|/)${p}(/.*)?$`;
+        }
+    }
+    return new RegExp(regexStr);
+}
+// Parse CODEOWNERS from repoRoot/.github/CODEOWNERS, repoRoot/CODEOWNERS, or repoRoot/docs/CODEOWNERS
+// Last matching rule wins (GitHub semantics)
+export function parseCodeowners(repoRoot) {
+    const candidates = [
+        join(repoRoot, '.github', 'CODEOWNERS'),
+        join(repoRoot, 'CODEOWNERS'),
+        join(repoRoot, 'docs', 'CODEOWNERS'),
+    ];
+    let content = null;
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            content = readFileSync(candidate, 'utf-8');
+            break;
+        }
+    }
+    if (!content)
+        return [];
+    const entries = [];
+    for (const rawLine of content.split('\n')) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const parts = line.split(/\s+/);
+        const pattern = parts[0];
+        const owners = parts.slice(1).filter(o => o.startsWith('@') || o.includes('@'));
+        if (pattern) {
+            entries.push({ pattern, owners });
+        }
+    }
+    return entries;
+}
+/**
+ * Compile an array of CodeownersEntry into CompiledEntry objects so that
+ * globToRegex() runs exactly once per pattern instead of once per file lookup.
+ */
+export function compileEntries(entries) {
+    return entries.map(e => ({ owners: e.owners, re: globToRegex(e.pattern) }));
+}
+// Resolve owner for a single file path using precompiled regexes.
+// Last matching entry wins (GitHub semantics).
+export function resolveOwnerCompiled(compiled, filePath) {
+    const normalised = filePath.replace(/\\/g, '/').replace(/^\.\//, '');
+    let lastMatch = null;
+    for (const entry of compiled) {
+        if (entry.re.test(normalised))
+            lastMatch = entry;
+    }
+    return lastMatch ? lastMatch.owners : [];
+}
+// Resolve owner for a single file path (relative to repoRoot)
+// Last matching entry wins
+export function resolveOwner(entries, filePath) {
+    // Normalize path to use forward slashes, remove leading ./
+    const normalised = filePath.replace(/\\/g, '/').replace(/^\.\//, '');
+    let lastMatch = null;
+    for (const entry of entries) {
+        const regex = globToRegex(entry.pattern);
+        if (regex.test(normalised)) {
+            lastMatch = entry;
+        }
+    }
+    return lastMatch ? lastMatch.owners : [];
+}
+// Annotate all File nodes in the DB with their owners (stored in properties.codeowners)
+export function annotateOwnership(db, repoRoot) {
+    const entries = parseCodeowners(repoRoot);
+    // Compile regexes once for all file nodes — avoids O(files * patterns) re-compilations.
+    const compiled = compileEntries(entries);
+    const fileNodes = db
+        .prepare(`SELECT id, file_path, properties FROM nodes WHERE label = 'File' AND file_path IS NOT NULL`)
+        .all();
+    let annotated = 0;
+    let unowned = 0;
+    const update = db.prepare(`UPDATE nodes SET properties = ? WHERE id = ?`);
+    const updateAll = db.transaction(() => {
+        for (const node of fileNodes) {
+            const relPath = relative(repoRoot, node.file_path).replace(/\\/g, '/');
+            const owners = resolveOwnerCompiled(compiled, relPath);
+            const existing = node.properties ? JSON.parse(node.properties) : {};
+            const updated = { ...existing, codeowners: owners };
+            update.run(JSON.stringify(updated), node.id);
+            if (owners.length > 0) {
+                annotated++;
+            }
+            else {
+                unowned++;
+            }
+        }
+    });
+    updateAll();
+    return { annotated, unowned };
+}
+// Group a list of findings by owner
+// Findings with no filePath or no matching pattern bucket under 'unowned'
+// If a file has multiple owners, the finding appears under each owner key
+export function groupByOwner(findings, entries) {
+    // Compile patterns once for all findings to avoid O(findings * patterns) regex constructions.
+    const compiled = compileEntries(entries);
+    const result = new Map();
+    for (const finding of findings) {
+        if (!finding.filePath) {
+            const bucket = result.get('unowned') ?? [];
+            bucket.push(finding);
+            result.set('unowned', bucket);
+            continue;
+        }
+        const owners = resolveOwnerCompiled(compiled, finding.filePath);
+        if (owners.length === 0) {
+            const bucket = result.get('unowned') ?? [];
+            bucket.push(finding);
+            result.set('unowned', bucket);
+        }
+        else {
+            for (const owner of owners) {
+                const bucket = result.get(owner) ?? [];
+                bucket.push(finding);
+                result.set(owner, bucket);
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=codeowners.js.map

package/dist/src/graph/codeowners.js.map

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

package/dist/src/graph/complexity.d.ts

@@ -0,0 +1,49 @@
+import type { MonographDb } from '../storage/db.js';
+export interface FunctionComplexity {
+    nodeId: string;
+    name: string;
+    filePath: string | null;
+    startLine: number | null;
+    endLine: number | null;
+    cyclomaticComplexity: number;
+    cognitiveComplexity: number;
+    linesOfCode: number;
+    paramCount: number;
+    crapScore: number;
+}
+export interface ComplexityReport {
+    functions: FunctionComplexity[];
+    p50cc: number;
+    p90cc: number;
+    p95cc: number;
+    highComplexityCount: number;
+    criticalCount: number;
+}
+/**
+ * Compute CRAP score for a function.
+ * Formula: CC² × (1 - coverage)³ + CC
+ * where coverage is a 0-1 fraction (0 = no tests, 1 = fully covered).
+ */
+export declare function computeCrapScore(cc: number, coverage: number): number;
+/**
+ * Compute cyclomatic and cognitive complexity for all Function/Method nodes
+ * in the knowledge graph. Uses graph degree as a proxy for decision points
+ * since AST is not available at this layer.
+ *
+ * - Cyclomatic complexity proxy: outgoing CALLS × 0.5 + outgoing ACCESSES × 0.2 + 1
+ * - Cognitive complexity proxy: (endLine - startLine) / 10, capped at 20
+ * - LOC: endLine - startLine + 1 (or 1 if missing)
+ * - CRAP: computed with coverage = 0 (worst-case, no test data available)
+ *
+ * Batches all SQL work to avoid N+1 queries (2 GROUP BY queries replace 2×N individual queries).
+ */
+export declare function computeComplexity(db: MonographDb): ComplexityReport;
+/**
+ * Format a ComplexityReport as structured text with file:line hints for LLM navigation.
+ *
+ * @param report - ComplexityReport from computeComplexity()
+ * @param topN - number of worst offenders to list (default 10)
+ * @returns structured text suitable for LLM consumption
+ */
+export declare function formatComplexity(report: ComplexityReport, topN?: number): string;
+//# sourceMappingURL=complexity.d.ts.map

package/dist/src/graph/complexity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complexity.d.ts","sourceRoot":"","sources":["../../../src/graph/complexity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrE;AAQD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,GAAG,gBAAgB,CA8FnE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,SAAK,GAAG,MAAM,CA4C5E"}