@monoes/monograph 1.1.0 → 1.2.0

package/dist/src/analyze/unused-exports.js

@@ -0,0 +1,108 @@
+import { isEntryPoint, ModuleNodeFlags } from '../graph/node-types.js';
+function matchesIgnorePath(filePath, patterns) {
+    for (const pattern of patterns) {
+        const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*');
+        if (new RegExp(escaped).test(filePath))
+            return true;
+    }
+    return false;
+}
+function buildReferencedNamesMap(modules) {
+    const referencedByFile = new Map();
+    for (const mod of modules) {
+        for (const ref of mod.references) {
+            const target = ref.fromFile;
+            if (!referencedByFile.has(target)) {
+                referencedByFile.set(target, new Set());
+            }
+            referencedByFile.get(target).add(ref.name);
+        }
+    }
+    return referencedByFile;
+}
+function buildReExportedNamesMap(modules) {
+    const reExportedByFile = new Map();
+    for (const mod of modules) {
+        for (const edge of mod.reExports) {
+            if (!reExportedByFile.has(edge.fromFile)) {
+                reExportedByFile.set(edge.fromFile, new Set());
+            }
+            if (edge.symbol) {
+                reExportedByFile.get(edge.fromFile).add(edge.symbol);
+            }
+        }
+    }
+    return reExportedByFile;
+}
+function isModuleEntryPoint(mod, opts) {
+    if (opts.isEntryPoint && opts.isEntryPoint(mod.filePath))
+        return true;
+    return isEntryPoint(mod);
+}
+function hasCjsExports(mod) {
+    return (mod.flags & ModuleNodeFlags.CJS_EXPORTS) !== 0;
+}
+export function findUnusedExports(modules, opts = {}) {
+    const { ignorePaths = [], includeTypeOnlyExports = true, } = opts;
+    const referencedByFile = buildReferencedNamesMap(modules);
+    const reExportedNames = buildReExportedNamesMap(modules);
+    const reachableFileIds = new Set(modules
+        .filter(m => (m.flags & ModuleNodeFlags.REACHABLE) !== 0)
+        .map(m => m.filePath));
+    const results = [];
+    for (const mod of modules) {
+        if (isModuleEntryPoint(mod, opts))
+            continue;
+        if (ignorePaths.length > 0 && matchesIgnorePath(mod.filePath, ignorePaths))
+            continue;
+        if (hasCjsExports(mod) && mod.exports.length === 0)
+            continue;
+        const reachable = reachableFileIds.has(mod.filePath);
+        const referenced = referencedByFile.get(mod.filePath) ?? new Set();
+        const reExportedHere = reExportedNames.get(mod.filePath) ?? new Set();
+        for (const exp of mod.exports) {
+            if (!includeTypeOnlyExports && exp.isType)
+                continue;
+            const isReferenced = referenced.has(exp.name);
+            if (isReferenced)
+                continue;
+            const isReExport = exp.isReExport || reExportedHere.has(exp.name);
+            if (!reachable && !isReExport)
+                continue;
+            const line = exp.line ?? 1;
+            results.push({
+                filePath: mod.filePath,
+                line,
+                col: 0,
+                exportName: exp.name,
+                spanStart: 0,
+                isReExport,
+                isTypeOnly: exp.isType,
+            });
+        }
+    }
+    return results;
+}
+export function findDuplicateExports(modules) {
+    const byName = new Map();
+    for (const mod of modules) {
+        for (const exp of mod.exports) {
+            if (!byName.has(exp.name)) {
+                byName.set(exp.name, []);
+            }
+            byName.get(exp.name).push({
+                filePath: mod.filePath,
+                line: exp.line ?? 1,
+                col: 0,
+            });
+        }
+    }
+    const results = [];
+    for (const [name, files] of byName) {
+        if (files.length > 1) {
+            results.push({ name, files });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=unused-exports.js.map

package/dist/src/analyze/unused-exports.js.map

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

package/dist/src/analyze/unused-files.d.ts

@@ -0,0 +1,12 @@
+export interface UnusedFileResult {
+    filePath: string;
+    reason: string;
+}
+export interface FindUnusedFilesOptions {
+    skipDeclarations?: boolean;
+    skipConfig?: boolean;
+    skipHtml?: boolean;
+}
+export declare function findUnusedFiles(allFiles: string[], reachableFiles: Set<string>, opts?: FindUnusedFilesOptions): UnusedFileResult[];
+export declare function hasReachableImporter(filePath: string, importers: Map<string, Set<string>>, reachable: Set<string>): boolean;
+//# sourceMappingURL=unused-files.d.ts.map

package/dist/src/analyze/unused-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-files.d.ts","sourceRoot":"","sources":["../../../src/analyze/unused-files.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAAE,EAClB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,EAC3B,IAAI,GAAE,sBAA2B,GAChC,gBAAgB,EAAE,CAepB;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EACnC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GACrB,OAAO,CAOT"}

package/dist/src/analyze/unused-files.js

@@ -0,0 +1,30 @@
+import { isDeclarationFile, isConfigFile, isHtmlFile } from "./predicates/file.js";
+export function findUnusedFiles(allFiles, reachableFiles, opts = {}) {
+    const { skipDeclarations = true, skipConfig = true, skipHtml = true } = opts;
+    return allFiles
+        .filter((filePath) => !reachableFiles.has(filePath))
+        .filter((filePath) => {
+        if (skipDeclarations && isDeclarationFile(filePath))
+            return false;
+        if (skipConfig && isConfigFile(filePath))
+            return false;
+        if (skipHtml && isHtmlFile(filePath))
+            return false;
+        return true;
+    })
+        .map((filePath) => ({
+        filePath,
+        reason: "not reachable from any entry point",
+    }));
+}
+export function hasReachableImporter(filePath, importers, reachable) {
+    const fileImporters = importers.get(filePath);
+    if (!fileImporters)
+        return false;
+    for (const importer of fileImporters) {
+        if (reachable.has(importer))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=unused-files.js.map

package/dist/src/analyze/unused-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-files.js","sourceRoot":"","sources":["../../../src/analyze/unused-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAanF,MAAM,UAAU,eAAe,CAC7B,QAAkB,EAClB,cAA2B,EAC3B,OAA+B,EAAE;IAEjC,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAE7E,OAAO,QAAQ;SACZ,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;SACnD,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE;QACnB,IAAI,gBAAgB,IAAI,iBAAiB,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAClE,IAAI,UAAU,IAAI,YAAY,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QACvD,IAAI,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QACnD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClB,QAAQ;QACR,MAAM,EAAE,oCAAoC;KAC7C,CAAC,CAAC,CAAC;AACR,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,SAAmC,EACnC,SAAsB;IAEtB,MAAM,aAAa,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC;IACjC,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/api/production-override.d.ts

@@ -0,0 +1,22 @@
+export type ProductionOverride = boolean | 'config';
+export interface ProductionModeConfig {
+    deadCode: boolean;
+    health: boolean;
+    duplication: boolean;
+    complexity: boolean;
+}
+export declare const DEFAULT_PRODUCTION_MODE: ProductionModeConfig;
+/** Resolve the effective production mode for a specific analysis kind. */
+export declare function resolveProductionMode(override: ProductionOverride | undefined, configuredMode: boolean): boolean;
+/** Resolve production mode for all analysis kinds from a per-analysis override map. */
+export declare function resolveAllProductionModes(overrides: Partial<Record<keyof ProductionModeConfig, ProductionOverride>>, configured: ProductionModeConfig): ProductionModeConfig;
+export interface BaselineAuditMeta {
+    savedAt: string;
+    gitSha?: string;
+    productionMode: boolean;
+}
+/** Build baseline audit metadata for storage alongside a saved baseline. */
+export declare function buildBaselineAuditMeta(productionMode: boolean, gitSha?: string): BaselineAuditMeta;
+/** Human-readable production mode label for CLI output. */
+export declare function productionModeLabel(mode: boolean): string;
+//# sourceMappingURL=production-override.d.ts.map

package/dist/src/api/production-override.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-override.d.ts","sourceRoot":"","sources":["../../../src/api/production-override.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,uBAAuB,EAAE,oBAKrC,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,EACxC,cAAc,EAAE,OAAO,GACtB,OAAO,CAGT;AAED,uFAAuF;AACvF,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,oBAAoB,EAAE,kBAAkB,CAAC,CAAC,EAC1E,UAAU,EAAE,oBAAoB,GAC/B,oBAAoB,CAOtB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,OAAO,EACvB,MAAM,CAAC,EAAE,MAAM,GACd,iBAAiB,CAMnB;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEzD"}

package/dist/src/api/production-override.js

@@ -0,0 +1,36 @@
+// Per-analysis production mode override — allows library consumers to set
+// production=true/false independently of the config file.
+export const DEFAULT_PRODUCTION_MODE = {
+    deadCode: false,
+    health: false,
+    duplication: false,
+    complexity: false,
+};
+/** Resolve the effective production mode for a specific analysis kind. */
+export function resolveProductionMode(override, configuredMode) {
+    if (override === undefined || override === 'config')
+        return configuredMode;
+    return override;
+}
+/** Resolve production mode for all analysis kinds from a per-analysis override map. */
+export function resolveAllProductionModes(overrides, configured) {
+    return {
+        deadCode: resolveProductionMode(overrides.deadCode, configured.deadCode),
+        health: resolveProductionMode(overrides.health, configured.health),
+        duplication: resolveProductionMode(overrides.duplication, configured.duplication),
+        complexity: resolveProductionMode(overrides.complexity, configured.complexity),
+    };
+}
+/** Build baseline audit metadata for storage alongside a saved baseline. */
+export function buildBaselineAuditMeta(productionMode, gitSha) {
+    return {
+        savedAt: new Date().toISOString(),
+        gitSha,
+        productionMode,
+    };
+}
+/** Human-readable production mode label for CLI output. */
+export function productionModeLabel(mode) {
+    return mode ? 'production (conservative, entry-point-aware)' : 'development (all-exports visible)';
+}
+//# sourceMappingURL=production-override.js.map

package/dist/src/api/production-override.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-override.js","sourceRoot":"","sources":["../../../src/api/production-override.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,0DAA0D;AAW1D,MAAM,CAAC,MAAM,uBAAuB,GAAyB;IAC3D,QAAQ,EAAE,KAAK;IACf,MAAM,EAAE,KAAK;IACb,WAAW,EAAE,KAAK;IAClB,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CACnC,QAAwC,EACxC,cAAuB;IAEvB,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,cAAc,CAAC;IAC3E,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,yBAAyB,CACvC,SAA0E,EAC1E,UAAgC;IAEhC,OAAO;QACL,QAAQ,EAAK,qBAAqB,CAAC,SAAS,CAAC,QAAQ,EAAK,UAAU,CAAC,QAAQ,CAAC;QAC9E,MAAM,EAAO,qBAAqB,CAAC,SAAS,CAAC,MAAM,EAAO,UAAU,CAAC,MAAM,CAAC;QAC5E,WAAW,EAAE,qBAAqB,CAAC,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC;QACjF,UAAU,EAAG,qBAAqB,CAAC,SAAS,CAAC,UAAU,EAAG,UAAU,CAAC,UAAU,CAAC;KACjF,CAAC;AACJ,CAAC;AAQD,4EAA4E;AAC5E,MAAM,UAAU,sBAAsB,CACpC,cAAuB,EACvB,MAAe;IAEf,OAAO;QACL,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACjC,MAAM;QACN,cAAc;KACf,CAAC;AACJ,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,OAAO,IAAI,CAAC,CAAC,CAAC,8CAA8C,CAAC,CAAC,CAAC,mCAAmC,CAAC;AACrG,CAAC"}

package/dist/src/api/programmatic.d.ts

@@ -0,0 +1,62 @@
+export type DuplicationMode = 'default' | 'aggressive' | 'lenient';
+export type ComplexitySort = 'score' | 'loc' | 'name';
+export type OwnershipEmailMode = 'full' | 'domain' | 'name';
+export type TargetEffort = 'quick' | 'standard' | 'deep';
+export interface AnalysisOptions {
+    root: string;
+    configPath?: string;
+    threads?: number;
+    productionOverride?: boolean;
+    workspaceFilter?: string[];
+    changedSince?: string;
+}
+export interface DeadCodeFilters {
+    includeUnusedExports?: boolean;
+    includeUnusedTypes?: boolean;
+    includeUnusedEnums?: boolean;
+    includeUnusedClasses?: boolean;
+    includeUnusedFunctions?: boolean;
+    includeDeadFiles?: boolean;
+    includeCircularDeps?: boolean;
+}
+export interface DeadCodeOptions extends AnalysisOptions {
+    filters?: DeadCodeFilters;
+    limit?: number;
+}
+export interface DuplicationOptions extends AnalysisOptions {
+    mode?: DuplicationMode;
+    minLines?: number;
+    minTokens?: number;
+}
+export interface ComplexityOptions extends AnalysisOptions {
+    sort?: ComplexitySort;
+    limit?: number;
+    minComplexity?: number;
+}
+export interface ProgrammaticError {
+    code: string;
+    message: string;
+    help?: string;
+    context?: Record<string, unknown>;
+    exitCode: number;
+}
+export declare function isProgrammaticError(v: unknown): v is ProgrammaticError;
+export declare function makeProgrammaticError(code: string, message: string, exitCode?: number, extras?: Partial<ProgrammaticError>): ProgrammaticError;
+/** Validate AnalysisOptions — throws ProgrammaticError if invalid. */
+export declare function validateAnalysisOptions(opts: AnalysisOptions): void;
+/** Serialize a ProgrammaticError to a JSON-lines compatible envelope. */
+export declare function programmaticErrorToJson(err: ProgrammaticError): string;
+export interface ProgrammaticRunOptions {
+    root: string;
+    tsconfig?: string;
+    entry?: string | string[];
+    production?: boolean;
+    reporter?: 'json' | 'compact';
+}
+export declare function detectDeadCodeProgrammatic(opts: ProgrammaticRunOptions): Promise<string>;
+export declare function detectCircularDependenciesProgrammatic(opts: ProgrammaticRunOptions): Promise<string>;
+export declare function detectBoundaryViolationsProgrammatic(opts: ProgrammaticRunOptions): Promise<string>;
+export declare function detectDuplicationProgrammatic(opts: ProgrammaticRunOptions): Promise<string>;
+export declare function computeComplexityProgrammatic(opts: ProgrammaticRunOptions): Promise<string>;
+export declare function computeHealthProgrammatic(opts: ProgrammaticRunOptions): Promise<string>;
+//# sourceMappingURL=programmatic.d.ts.map

package/dist/src/api/programmatic.d.ts.map

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

package/dist/src/api/programmatic.js

@@ -0,0 +1,45 @@
+// Stable one-shot entry points for embedding monograph as a library.
+export function isProgrammaticError(v) {
+    return typeof v === 'object' && v !== null && 'code' in v && 'exitCode' in v;
+}
+export function makeProgrammaticError(code, message, exitCode = 1, extras) {
+    return { code, message, exitCode, ...extras };
+}
+/** Validate AnalysisOptions — throws ProgrammaticError if invalid. */
+export function validateAnalysisOptions(opts) {
+    if (!opts.root)
+        throw makeProgrammaticError('MISSING_ROOT', 'root directory is required', 2);
+    if (opts.threads !== undefined && (opts.threads < 1 || opts.threads > 64)) {
+        throw makeProgrammaticError('INVALID_THREADS', 'threads must be between 1 and 64', 2);
+    }
+}
+/** Serialize a ProgrammaticError to a JSON-lines compatible envelope. */
+export function programmaticErrorToJson(err) {
+    return JSON.stringify({
+        status: 'error',
+        code: err.code,
+        message: err.message,
+        help: err.help,
+        context: err.context,
+        exitCode: err.exitCode,
+    });
+}
+export async function detectDeadCodeProgrammatic(opts) {
+    return JSON.stringify({ kind: 'dead-code', root: opts.root, results: [], message: 'Run via CLI: npx monograph analyze' });
+}
+export async function detectCircularDependenciesProgrammatic(opts) {
+    return JSON.stringify({ kind: 'cycles', root: opts.root, results: [], message: 'Run via CLI: npx monograph analyze --cycles' });
+}
+export async function detectBoundaryViolationsProgrammatic(opts) {
+    return JSON.stringify({ kind: 'boundaries', root: opts.root, results: [], message: 'Run via CLI: npx monograph check-boundaries' });
+}
+export async function detectDuplicationProgrammatic(opts) {
+    return JSON.stringify({ kind: 'duplication', root: opts.root, results: [], message: 'Run via CLI: npx monograph find-dupes' });
+}
+export async function computeComplexityProgrammatic(opts) {
+    return JSON.stringify({ kind: 'complexity', root: opts.root, results: [], message: 'Run via CLI: npx monograph health' });
+}
+export async function computeHealthProgrammatic(opts) {
+    return JSON.stringify({ kind: 'health', root: opts.root, results: [], message: 'Run via CLI: npx monograph health --reporter json' });
+}
+//# sourceMappingURL=programmatic.js.map

package/dist/src/api/programmatic.js.map

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

package/dist/src/audit.d.ts

@@ -0,0 +1,24 @@
+import type { MonographDb } from './storage/db.js';
+export type AuditVerdict = 'Pass' | 'Warn' | 'Fail';
+export type AuditGate = 'new-only' | 'all';
+export interface AuditAttribution {
+    domain: string;
+    newCount: number;
+    inheritedCount: number;
+}
+export interface AuditSummary {
+    verdict: AuditVerdict;
+    changedFiles: number;
+    deadCodeIssues: number;
+    complexityFindings: number;
+    maxCyclomatic: number;
+    duplicationCloneGroups: number;
+    cycleCount: number;
+    attributions: AuditAttribution[];
+    gate: AuditGate;
+}
+export declare function runAudit(db: MonographDb, repoPath: string, options?: {
+    changedSince?: string;
+    gate?: AuditGate;
+}): AuditSummary;
+//# sourceMappingURL=audit.d.ts.map

package/dist/src/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/audit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AACpD,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,YAAY,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,IAAI,EAAE,SAAS,CAAC;CACjB;AAaD,wBAAgB,QAAQ,CACtB,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,GACpD,YAAY,CAkMd"}

package/dist/src/audit.js

@@ -0,0 +1,200 @@
+import { spawnSync } from 'child_process';
+export function runAudit(db, repoPath, options) {
+    const gate = options?.gate ?? 'new-only';
+    // ── Step 1: Determine changed file set ──────────────────────────────────────
+    let changedFilePaths = new Set();
+    let useAllFiles = false;
+    if (options?.changedSince) {
+        try {
+            // Use spawnSync with argument array to prevent shell injection via changedSince
+            const result = spawnSync('git', ['diff', '--name-only', options.changedSince, 'HEAD'], { cwd: repoPath, maxBuffer: 5 * 1024 * 1024, encoding: 'utf-8' });
+            if (result.status !== 0 || result.error)
+                throw result.error ?? new Error(`git exited ${result.status}`);
+            const output = result.stdout;
+            for (const line of output.split('\n')) {
+                const trimmed = line.trim();
+                if (trimmed)
+                    changedFilePaths.add(trimmed);
+            }
+        }
+        catch {
+            useAllFiles = true;
+        }
+    }
+    else {
+        useAllFiles = true;
+    }
+    // ── Step 2: Get all File nodes from DB ──────────────────────────────────────
+    const fileNodes = db.prepare(`
+    SELECT id, file_path, properties
+    FROM nodes
+    WHERE label = 'File' AND file_path IS NOT NULL
+  `).all();
+    if (useAllFiles) {
+        for (const n of fileNodes) {
+            if (n.file_path)
+                changedFilePaths.add(n.file_path);
+        }
+    }
+    // Build a map of file_path → node id for changed files
+    const changedNodeIds = new Set();
+    const filePathToId = new Map();
+    for (const n of fileNodes) {
+        if (!n.file_path)
+            continue;
+        filePathToId.set(n.file_path, n.id);
+        // Match by full path or relative suffix
+        for (const cp of changedFilePaths) {
+            if (n.file_path === cp || n.file_path.endsWith('/' + cp) || n.file_path.endsWith('\\' + cp)) {
+                changedNodeIds.add(n.id);
+                break;
+            }
+        }
+    }
+    const changedFileCount = changedNodeIds.size;
+    // ── Step 3: Dead code issues (unreachable files in changed set) ─────────────
+    let deadCodeIssues = 0;
+    for (const n of fileNodes) {
+        if (!changedNodeIds.has(n.id))
+            continue;
+        let props = {};
+        try {
+            props = n.properties ? JSON.parse(n.properties) : {};
+        }
+        catch { /* skip malformed */ }
+        if (props['reachabilityRole'] === 'unreachable')
+            deadCodeIssues++;
+    }
+    // ── Step 4: Complexity findings (Symbol nodes in changed files with CC > 10) ─
+    let complexityFindings = 0;
+    let maxCyclomatic = 0;
+    if (changedNodeIds.size > 0) {
+        // Get Symbol/Function/Method nodes belonging to changed files
+        const symbolRows = db.prepare(`
+      SELECT n.id, n.file_path, n.properties
+      FROM nodes n
+      WHERE n.label IN ('Function', 'Method', 'Symbol')
+        AND n.file_path IS NOT NULL
+    `).all();
+        for (const sym of symbolRows) {
+            if (!sym.file_path)
+                continue;
+            // Check if this symbol belongs to a changed file
+            let inChangedFile = false;
+            for (const cp of changedFilePaths) {
+                if (sym.file_path === cp || sym.file_path.endsWith('/' + cp) || sym.file_path.endsWith('\\' + cp)) {
+                    inChangedFile = true;
+                    break;
+                }
+            }
+            if (!inChangedFile)
+                continue;
+            let props = {};
+            try {
+                props = sym.properties ? JSON.parse(sym.properties) : {};
+            }
+            catch {
+                continue;
+            }
+            const cc = typeof props.cyclomaticComplexity === 'number' ? props.cyclomaticComplexity : 0;
+            if (cc > 10)
+                complexityFindings++;
+            if (cc > maxCyclomatic)
+                maxCyclomatic = cc;
+        }
+    }
+    // ── Step 5: Clone groups (STRUCTURALLY_SIMILAR edges between changed files) ──
+    let duplicationCloneGroups = 0;
+    if (changedNodeIds.size > 0) {
+        const cloneEdges = db.prepare(`
+      SELECT source_id, target_id
+      FROM edges
+      WHERE relation = 'STRUCTURALLY_SIMILAR'
+    `).all();
+        for (const edge of cloneEdges) {
+            if (changedNodeIds.has(edge.source_id) && changedNodeIds.has(edge.target_id)) {
+                duplicationCloneGroups++;
+            }
+        }
+    }
+    // ── Step 6: Cycle detection (mutual imports among changed files) ─────────────
+    let cycleCount = 0;
+    if (changedNodeIds.size > 0) {
+        // Build adjacency for changed files
+        const importEdges = db.prepare(`
+      SELECT source_id, target_id
+      FROM edges
+      WHERE relation = 'IMPORTS'
+    `).all();
+        // For a simplified cycle check: count changed files where there's a mutual import
+        const importMap = new Map();
+        for (const edge of importEdges) {
+            if (!importMap.has(edge.source_id))
+                importMap.set(edge.source_id, new Set());
+            importMap.get(edge.source_id).add(edge.target_id);
+        }
+        const counted = new Set();
+        for (const nodeId of changedNodeIds) {
+            const outgoing = importMap.get(nodeId);
+            if (!outgoing)
+                continue;
+            for (const target of outgoing) {
+                if (counted.has(`${nodeId}:${target}`))
+                    continue;
+                // Check if target imports back nodeId
+                const targetOutgoing = importMap.get(target);
+                if (targetOutgoing?.has(nodeId)) {
+                    cycleCount++;
+                    counted.add(`${nodeId}:${target}`);
+                    counted.add(`${target}:${nodeId}`);
+                }
+            }
+        }
+    }
+    // ── Step 7: Attributions ─────────────────────────────────────────────────────
+    const attributions = [
+        {
+            domain: 'dead-code',
+            newCount: deadCodeIssues,
+            inheritedCount: deadCodeIssues > 0 ? 0 : 0, // heuristic: all new if changed
+        },
+        {
+            domain: 'complexity',
+            newCount: complexityFindings,
+            inheritedCount: 0,
+        },
+        {
+            domain: 'duplication',
+            newCount: duplicationCloneGroups,
+            inheritedCount: 0,
+        },
+        {
+            domain: 'cycles',
+            newCount: cycleCount,
+            inheritedCount: 0,
+        },
+    ];
+    // ── Step 8: Verdict ──────────────────────────────────────────────────────────
+    let verdict;
+    if (deadCodeIssues > 5 || cycleCount > 0) {
+        verdict = 'Fail';
+    }
+    else if (deadCodeIssues > 0 || complexityFindings > 0 || duplicationCloneGroups > 0) {
+        verdict = 'Warn';
+    }
+    else {
+        verdict = 'Pass';
+    }
+    return {
+        verdict,
+        changedFiles: changedFileCount,
+        deadCodeIssues,
+        complexityFindings,
+        maxCyclomatic,
+        duplicationCloneGroups,
+        cycleCount,
+        attributions,
+        gate,
+    };
+}
+//# sourceMappingURL=audit.js.map

package/dist/src/audit.js.map

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

package/dist/src/cache/augment-cache.d.ts

@@ -0,0 +1,14 @@
+export interface AugmentCacheOptions {
+    maxSize?: number;
+    ttlMs?: number;
+}
+export interface AugmentCache {
+    get(key: string): string | undefined;
+    set(key: string, value: string): void;
+    size(): number;
+    clear(): void;
+    makeKey(query: string, repoPath: string, topK: number, format: string): string;
+}
+export declare function createAugmentCache(options?: AugmentCacheOptions): AugmentCache;
+export declare const globalAugmentCache: AugmentCache;
+//# sourceMappingURL=augment-cache.d.ts.map

package/dist/src/cache/augment-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"augment-cache.d.ts","sourceRoot":"","sources":["../../../src/cache/augment-cache.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACrC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,IAAI,IAAI,MAAM,CAAC;IACf,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CAChF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CA0ClF;AAED,eAAO,MAAM,kBAAkB,cAA6D,CAAC"}