@monoes/monograph 1.0.0 → 1.2.0

package/dist/src/analysis/feature-flags-config.d.ts

@@ -0,0 +1,8 @@
+export interface SdkPattern {
+    packageName: string;
+    displayName: string;
+    callPatterns: RegExp[];
+}
+export declare const KNOWN_SDK_PATTERNS: SdkPattern[];
+export declare function detectSdkFromPackageJson(deps: Record<string, string>): SdkPattern[];
+//# sourceMappingURL=feature-flags-config.d.ts.map

package/dist/src/analysis/feature-flags-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags-config.d.ts","sourceRoot":"","sources":["../../../src/analysis/feature-flags-config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,eAAO,MAAM,kBAAkB,EAAE,UAAU,EAoC1C,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,UAAU,EAAE,CAEnF"}

package/dist/src/analysis/feature-flags-config.js

@@ -0,0 +1,41 @@
+export const KNOWN_SDK_PATTERNS = [
+    {
+        packageName: 'launchdarkly-js-client-sdk',
+        displayName: 'LaunchDarkly',
+        callPatterns: [/ldClient\.variation\s*\(/, /\.variation\s*\(/],
+    },
+    {
+        packageName: '@statsig/js-client',
+        displayName: 'Statsig',
+        callPatterns: [/\.checkGate\s*\(/, /\.getExperiment\s*\(/, /Statsig\.checkGate/],
+    },
+    {
+        packageName: 'unleash-client',
+        displayName: 'Unleash',
+        callPatterns: [/\.isEnabled\s*\(/, /unleash\.isEnabled/],
+    },
+    {
+        packageName: '@growthbook/growthbook',
+        displayName: 'GrowthBook',
+        callPatterns: [/\.isOn\s*\(/, /\.evalFeature\s*\(/, /growthbook\.isOn/],
+    },
+    {
+        packageName: 'configcat-js',
+        displayName: 'ConfigCat',
+        callPatterns: [/\.getValueAsync\s*\(/, /configcat\.getValue/],
+    },
+    {
+        packageName: 'flagsmith',
+        displayName: 'Flagsmith',
+        callPatterns: [/flagsmith\.hasFeature\s*\(/, /flagsmith\.getValue\s*\(/],
+    },
+    {
+        packageName: '@splitsoftware/splitio',
+        displayName: 'Split',
+        callPatterns: [/\.getTreatment\s*\(/, /splitClient\.getTreatment/],
+    },
+];
+export function detectSdkFromPackageJson(deps) {
+    return KNOWN_SDK_PATTERNS.filter(sdk => deps[sdk.packageName] !== undefined);
+}
+//# sourceMappingURL=feature-flags-config.js.map

package/dist/src/analysis/feature-flags-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags-config.js","sourceRoot":"","sources":["../../../src/analysis/feature-flags-config.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,kBAAkB,GAAiB;IAC9C;QACE,WAAW,EAAE,4BAA4B;QACzC,WAAW,EAAE,cAAc;QAC3B,YAAY,EAAE,CAAC,0BAA0B,EAAE,kBAAkB,CAAC;KAC/D;IACD;QACE,WAAW,EAAE,oBAAoB;QACjC,WAAW,EAAE,SAAS;QACtB,YAAY,EAAE,CAAC,kBAAkB,EAAE,sBAAsB,EAAE,oBAAoB,CAAC;KACjF;IACD;QACE,WAAW,EAAE,gBAAgB;QAC7B,WAAW,EAAE,SAAS;QACtB,YAAY,EAAE,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;KACzD;IACD;QACE,WAAW,EAAE,wBAAwB;QACrC,WAAW,EAAE,YAAY;QACzB,YAAY,EAAE,CAAC,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,CAAC;KACxE;IACD;QACE,WAAW,EAAE,cAAc;QAC3B,WAAW,EAAE,WAAW;QACxB,YAAY,EAAE,CAAC,sBAAsB,EAAE,qBAAqB,CAAC;KAC9D;IACD;QACE,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE,WAAW;QACxB,YAAY,EAAE,CAAC,4BAA4B,EAAE,0BAA0B,CAAC;KACzE;IACD;QACE,WAAW,EAAE,wBAAwB;QACrC,WAAW,EAAE,OAAO;QACpB,YAAY,EAAE,CAAC,qBAAqB,EAAE,2BAA2B,CAAC;KACnE;CACF,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,IAA4B;IACnE,OAAO,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,SAAS,CAAC,CAAC;AAC/E,CAAC"}

package/dist/src/analysis/feature-flags.d.ts

@@ -0,0 +1,35 @@
+export type FlagKind = 'EnvironmentVariable' | 'SdkCall' | 'ConfigObject';
+export type FlagConfidence = 'High' | 'Medium' | 'Low';
+export interface FeatureFlag {
+    filePath: string;
+    flagName: string;
+    kind: FlagKind;
+    confidence: FlagConfidence;
+    line: number;
+    col: number;
+    sdkName?: string;
+    guardLineStart?: number;
+    guardLineEnd?: number;
+    guardedDeadExports?: string[];
+}
+export interface FlagsConfig {
+    sdkPatterns: string[];
+    envPrefixes: string[];
+}
+export declare const DEFAULT_FLAGS_CONFIG: FlagsConfig;
+export declare function analyzeFeatureFlags(rootDir: string, config?: FlagsConfig): FeatureFlag[];
+export declare function crossReferenceWithDeadCode(flags: FeatureFlag[], deadExports: Array<{
+    filePath: string;
+    name: string;
+    line: number;
+}>): FeatureFlag[];
+export interface FlagsSummary {
+    totalFlags: number;
+    byKind: Record<FlagKind, number>;
+    byConfidence: Record<FlagConfidence, number>;
+    uniqueFlagNames: number;
+    filesWithFlags: number;
+    deadCodeOverlaps: number;
+}
+export declare function summarizeFlags(flags: FeatureFlag[]): FlagsSummary;
+//# sourceMappingURL=feature-flags.d.ts.map

package/dist/src/analysis/feature-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../src/analysis/feature-flags.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,QAAQ,GAAG,qBAAqB,GAAG,SAAS,GAAG,cAAc,CAAC;AAC1E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,cAAc,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,oBAAoB,EAAE,WAWlC,CAAC;AA0FF,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,WAAkC,GACzC,WAAW,EAAE,CAaf;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,WAAW,EAAE,EACpB,WAAW,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GACnE,WAAW,EAAE,CAUf;AAeD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,YAAY,CAiBjE"}

package/dist/src/analysis/feature-flags.js

@@ -0,0 +1,171 @@
+import { readFileSync, readdirSync, statSync } from 'fs';
+import { join, extname } from 'path';
+export const DEFAULT_FLAGS_CONFIG = {
+    envPrefixes: ['FEATURE_', 'FF_', 'FLAG_', 'ENABLE_', 'DISABLE_', 'AB_', 'EXP_', 'EXPERIMENT_'],
+    sdkPatterns: [
+        'launchdarkly', 'ld-client', '@launchdarkly',
+        'statsig', '@statsig',
+        'unleash', 'unleash-client',
+        'growthbook', '@growthbook',
+        'configcat', 'config-cat',
+        'flagsmith',
+        'split-io', '@splitsoftware',
+    ],
+};
+// SDK method patterns that signal flag evaluation
+const SDK_CALL_PATTERNS = [
+    /\.variation\s*\(/,
+    /\.isEnabled\s*\(/,
+    /\.checkGate\s*\(/,
+    /\.getExperiment\s*\(/,
+    /\.isOn\s*\(/,
+    /\.getFeature\s*\(/,
+    /\.getTreatment\s*\(/,
+    /\.evaluate\s*\(/,
+    /featureIsEnabled\s*\(/,
+    /getFlag\s*\(/,
+    /flagEnabled\s*\(/,
+];
+const ENV_VAR_RE = /process\.env\.([A-Z][A-Z0-9_]+)/g;
+const CONFIG_OBJECT_RE = /(?:featureFlags?|flags?|features?)\s*[\[.]\s*['"]([A-Za-z][A-Za-z0-9_-]*)['"]|(?:isEnabled|isActive|isOn)\s*\(\s*['"]([A-Za-z][A-Za-z0-9_-]*)['"]/g;
+function isSourceFile(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    return ['.ts', '.tsx', '.js', '.jsx', '.mts', '.mjs', '.cts', '.cjs'].includes(ext);
+}
+function detectFlagsInLine(line, lineNum, filePath, config) {
+    const found = [];
+    // Environment variable flags
+    let m;
+    const envRe = new RegExp(ENV_VAR_RE.source, 'g');
+    while ((m = envRe.exec(line)) !== null) {
+        const varName = m[1];
+        const isFlag = config.envPrefixes.some(p => varName.startsWith(p));
+        if (isFlag) {
+            found.push({
+                filePath, flagName: varName, kind: 'EnvironmentVariable',
+                confidence: 'High', line: lineNum, col: m.index + 1,
+            });
+        }
+    }
+    // SDK call patterns
+    for (const pattern of SDK_CALL_PATTERNS) {
+        const sdkMatch = pattern.exec(line);
+        if (sdkMatch) {
+            // Try to extract the flag name from the first string argument
+            const argMatch = line.slice(sdkMatch.index).match(/\(\s*['"]([^'"]+)['"]/);
+            if (argMatch) {
+                found.push({
+                    filePath, flagName: argMatch[1], kind: 'SdkCall',
+                    confidence: 'High', line: lineNum, col: sdkMatch.index + 1,
+                    sdkName: detectSdkName(line),
+                });
+            }
+        }
+    }
+    // Config object heuristics
+    const configRe = new RegExp(CONFIG_OBJECT_RE.source, 'g');
+    while ((m = configRe.exec(line)) !== null) {
+        const flagName = m[1] ?? m[2];
+        if (flagName) {
+            found.push({
+                filePath, flagName, kind: 'ConfigObject',
+                confidence: 'Medium', line: lineNum, col: m.index + 1,
+            });
+        }
+    }
+    return found;
+}
+function detectSdkName(line) {
+    const lower = line.toLowerCase();
+    if (lower.includes('launchdarkly') || lower.includes('ldclient'))
+        return 'LaunchDarkly';
+    if (lower.includes('statsig'))
+        return 'Statsig';
+    if (lower.includes('unleash'))
+        return 'Unleash';
+    if (lower.includes('growthbook'))
+        return 'GrowthBook';
+    if (lower.includes('configcat'))
+        return 'ConfigCat';
+    if (lower.includes('flagsmith'))
+        return 'Flagsmith';
+    if (lower.includes('split'))
+        return 'Split';
+    return 'unknown';
+}
+export function analyzeFeatureFlags(rootDir, config = DEFAULT_FLAGS_CONFIG) {
+    const flags = [];
+    walkDir(rootDir, filePath => {
+        if (!isSourceFile(filePath))
+            return;
+        let content;
+        try {
+            content = readFileSync(filePath, 'utf8');
+        }
+        catch {
+            return;
+        }
+        const lines = content.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const detected = detectFlagsInLine(lines[i], i + 1, filePath, config);
+            flags.push(...detected);
+        }
+    });
+    return flags;
+}
+export function crossReferenceWithDeadCode(flags, deadExports) {
+    return flags.map(flag => {
+        if (flag.guardLineStart == null || flag.guardLineEnd == null)
+            return flag;
+        const guarded = deadExports
+            .filter(e => e.filePath === flag.filePath &&
+            e.line >= (flag.guardLineStart ?? 0) &&
+            e.line <= (flag.guardLineEnd ?? Infinity))
+            .map(e => e.name);
+        return guarded.length > 0 ? { ...flag, guardedDeadExports: guarded } : flag;
+    });
+}
+function walkDir(dir, fn) {
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry === 'node_modules' || entry === '.git' || entry === 'dist' || entry === 'build')
+            continue;
+        const full = join(dir, entry);
+        let st;
+        try {
+            st = statSync(full);
+        }
+        catch {
+            continue;
+        }
+        if (st.isDirectory())
+            walkDir(full, fn);
+        else if (st.isFile())
+            fn(full);
+    }
+}
+export function summarizeFlags(flags) {
+    return {
+        totalFlags: flags.length,
+        byKind: {
+            EnvironmentVariable: flags.filter(f => f.kind === 'EnvironmentVariable').length,
+            SdkCall: flags.filter(f => f.kind === 'SdkCall').length,
+            ConfigObject: flags.filter(f => f.kind === 'ConfigObject').length,
+        },
+        byConfidence: {
+            High: flags.filter(f => f.confidence === 'High').length,
+            Medium: flags.filter(f => f.confidence === 'Medium').length,
+            Low: flags.filter(f => f.confidence === 'Low').length,
+        },
+        uniqueFlagNames: new Set(flags.map(f => f.flagName)).size,
+        filesWithFlags: new Set(flags.map(f => f.filePath)).size,
+        deadCodeOverlaps: flags.filter(f => (f.guardedDeadExports?.length ?? 0) > 0).length,
+    };
+}
+//# sourceMappingURL=feature-flags.js.map

package/dist/src/analysis/feature-flags.js.map

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

package/dist/src/analysis/file-classifier.d.ts

@@ -0,0 +1,4 @@
+export type FileType = 'CODE' | 'DOCUMENT' | 'PAPER' | 'IMAGE' | 'VIDEO';
+export declare function classifyFile(pathOrUrl: string): FileType;
+export declare function classifyContent(text: string): FileType;
+//# sourceMappingURL=file-classifier.d.ts.map

package/dist/src/analysis/file-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-classifier.d.ts","sourceRoot":"","sources":["../../../src/analysis/file-classifier.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AA0CzE,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CAgBxD;AAmBD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAItD"}

package/dist/src/analysis/file-classifier.js

@@ -0,0 +1,74 @@
+import { extname } from 'path';
+const CODE_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.py', '.pyw', '.java', '.kt', '.kts', '.go',
+    '.rs', '.rb', '.php', '.swift', '.cs', '.cpp',
+    '.c', '.h', '.hpp', '.cc', '.m', '.r', '.scala',
+    '.lua', '.sh', '.bash', '.zsh', '.ps1', '.psm1',
+    '.sql', '.graphql', '.gql', '.proto', '.yaml', '.yml',
+    '.toml', '.json', '.xml', '.html', '.css', '.scss',
+    '.sass', '.less', '.vue', '.svelte', '.astro',
+]);
+const DOCUMENT_EXTENSIONS = new Set([
+    '.md', '.mdx', '.rst', '.txt', '.pdf', '.docx',
+    '.doc', '.odt', '.rtf', '.tex', '.adoc',
+]);
+const IMAGE_EXTENSIONS = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.svg', '.webp',
+    '.ico', '.bmp', '.tiff', '.tif',
+]);
+const VIDEO_EXTENSIONS = new Set([
+    '.mp4', '.mkv', '.avi', '.mov', '.webm', '.flv',
+    '.wmv', '.m4v',
+]);
+const PAPER_URL_PATTERNS = [
+    /arxiv\.org/,
+    /semanticscholar\.org/,
+    /openreview\.net/,
+    /dl\.acm\.org/,
+    /ieeexplore\.ieee\.org/,
+    /springer\.com\/article/,
+];
+const PAPER_FILENAME_SIGNALS = [
+    /(^|[^a-zA-Z])(attention|transformer|neural|deep.?learn|bert|gpt|llm|arxiv)([^a-zA-Z]|$)/i,
+    /\d{4}\.\d{4,5}/,
+];
+export function classifyFile(pathOrUrl) {
+    if (PAPER_URL_PATTERNS.some(p => p.test(pathOrUrl)))
+        return 'PAPER';
+    const ext = extname(pathOrUrl).toLowerCase();
+    if (IMAGE_EXTENSIONS.has(ext))
+        return 'IMAGE';
+    if (VIDEO_EXTENSIONS.has(ext))
+        return 'VIDEO';
+    if (DOCUMENT_EXTENSIONS.has(ext)) {
+        if (ext === '.pdf' && PAPER_FILENAME_SIGNALS.some(p => p.test(pathOrUrl)))
+            return 'PAPER';
+        return 'DOCUMENT';
+    }
+    if (CODE_EXTENSIONS.has(ext))
+        return 'CODE';
+    return 'CODE';
+}
+const PAPER_CONTENT_SIGNALS = [
+    /\\cite\{/,
+    /\[\d{1,3}\](?:\[\d{1,3}\])+/,
+    /\bEq(?:uation|n)?\.\s*\d+/i,
+    /\bdoi:\s*10\.\d{4,}/i,
+    /^Abstract\b/im,
+    /\bWe propose\b/i,
+    /\bProceedings\s+of\b/i,
+    /\b(Journal|Preprint|arXiv)\b/i,
+    /\d{4}\.\d{4,5}/,
+    /\b\d+\(\d+\):\d+-\d+\b/,
+    /\\bibliography\{/,
+    /\bTable of Contents\b.*\n.*\bIntroduction\b/is,
+];
+const PAPER_CONTENT_THRESHOLD = 1;
+export function classifyContent(text) {
+    const matches = PAPER_CONTENT_SIGNALS.filter(p => p.test(text)).length;
+    if (matches >= PAPER_CONTENT_THRESHOLD)
+        return 'PAPER';
+    return 'DOCUMENT';
+}
+//# sourceMappingURL=file-classifier.js.map

package/dist/src/analysis/file-classifier.js.map

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

package/dist/src/analysis/git-changed-files.d.ts

@@ -0,0 +1,9 @@
+export declare function validateGitRef(ref: string): void;
+export declare function resolveGitToplevel(cwd: string): string;
+export declare function collectGitPaths(root: string, since?: string): string[];
+export declare function tryGetChangedFiles(root: string, since?: string): string[] | null;
+export declare function filterResultsByChangedFiles<T extends {
+    filePath: string;
+}>(results: T[], changedFiles: string[]): T[];
+export declare function getChangedFilesSince(root: string, since: string): string[];
+//# sourceMappingURL=git-changed-files.d.ts.map

package/dist/src/analysis/git-changed-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-changed-files.d.ts","sourceRoot":"","sources":["../../../src/analysis/git-changed-files.ts"],"names":[],"mappings":"AAMA,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBtE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAQhF;AAED,wBAAgB,2BAA2B,CAAC,CAAC,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EACxE,OAAO,EAAE,CAAC,EAAE,EACZ,YAAY,EAAE,MAAM,EAAE,GACrB,CAAC,EAAE,CAGL;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAG1E"}

package/dist/src/analysis/git-changed-files.js

@@ -0,0 +1,58 @@
+import { execSync } from 'node:child_process';
+import * as path from 'node:path';
+const GIT_REF_ALLOWLIST = /^[a-zA-Z0-9._/~^@{}[\]:-]+$/;
+const DANGEROUS_PATTERNS = /\.\.|`|\$\(|;|&&|\|\|/;
+export function validateGitRef(ref) {
+    if (!GIT_REF_ALLOWLIST.test(ref) || DANGEROUS_PATTERNS.test(ref)) {
+        throw new Error(`Invalid git ref: ${JSON.stringify(ref)} — only alphanumeric, dots, slashes, hyphens, and common git ref characters are allowed`);
+    }
+}
+export function resolveGitToplevel(cwd) {
+    try {
+        return execSync('git rev-parse --show-toplevel', { cwd, encoding: 'utf8' }).trim();
+    }
+    catch {
+        return cwd;
+    }
+}
+export function collectGitPaths(root, since) {
+    try {
+        let cmd;
+        if (since) {
+            validateGitRef(since);
+            cmd = `git diff --name-only --diff-filter=ACM ${since}`;
+        }
+        else {
+            cmd = 'git ls-files';
+        }
+        const output = execSync(cmd, { cwd: root, encoding: 'utf8' });
+        return output
+            .split('\n')
+            .map(l => l.trim())
+            .filter(l => l.length > 0)
+            .map(l => path.resolve(root, l));
+    }
+    catch {
+        return [];
+    }
+}
+export function tryGetChangedFiles(root, since) {
+    if (!since)
+        return null;
+    try {
+        validateGitRef(since);
+        return collectGitPaths(root, since);
+    }
+    catch {
+        return null;
+    }
+}
+export function filterResultsByChangedFiles(results, changedFiles) {
+    const changedSet = new Set(changedFiles.map(f => path.normalize(f)));
+    return results.filter(r => changedSet.has(path.normalize(r.filePath)));
+}
+export function getChangedFilesSince(root, since) {
+    validateGitRef(since);
+    return collectGitPaths(root, since);
+}
+//# sourceMappingURL=git-changed-files.js.map

package/dist/src/analysis/git-changed-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-changed-files.js","sourceRoot":"","sources":["../../../src/analysis/git-changed-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,iBAAiB,GAAG,6BAA6B,CAAC;AACxD,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAEnD,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,yFAAyF,CAAC,CAAC;IACpJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,+BAA+B,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,KAAc;IAC1D,IAAI,CAAC;QACH,IAAI,GAAW,CAAC;QAChB,IAAI,KAAK,EAAE,CAAC;YACV,cAAc,CAAC,KAAK,CAAC,CAAC;YACtB,GAAG,GAAG,0CAA0C,KAAK,EAAE,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,cAAc,CAAC;QACvB,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9D,OAAO,MAAM;aACV,KAAK,CAAC,IAAI,CAAC;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aAClB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;aACzB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,KAAc;IAC7D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,CAAC;QACH,cAAc,CAAC,KAAK,CAAC,CAAC;QACtB,OAAO,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,OAAY,EACZ,YAAsB;IAEtB,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,KAAa;IAC9D,cAAc,CAAC,KAAK,CAAC,CAAC;IACtB,OAAO,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC"}

package/dist/src/analysis/health-baseline.d.ts

@@ -0,0 +1,20 @@
+export interface HealthFileCounts {
+    complexityModerate: number;
+    complexityHigh: number;
+    complexityCritical: number;
+    crapModerate: number;
+    crapHigh: number;
+    crapCritical: number;
+}
+export interface HealthBaselineData {
+    counts: Map<string, HealthFileCounts>;
+}
+export interface HealthFinding {
+    filePath: string;
+    kind: 'complexity_moderate' | 'complexity_high' | 'complexity_critical' | 'crap_moderate' | 'crap_high' | 'crap_critical';
+    functionName?: string;
+    line?: number;
+}
+export declare function buildHealthBaseline(findings: HealthFinding[], root: string): HealthBaselineData;
+export declare function filterNewHealthFindings(current: HealthFinding[], baseline: HealthBaselineData, root: string): HealthFinding[];
+//# sourceMappingURL=health-baseline.d.ts.map

package/dist/src/analysis/health-baseline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-baseline.d.ts","sourceRoot":"","sources":["../../../src/analysis/health-baseline.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,qBAAqB,GAAG,iBAAiB,GAAG,qBAAqB,GAAG,eAAe,GAAG,WAAW,GAAG,eAAe,CAAC;IAC1H,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAgCD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAE/F;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,EAAE,EACxB,QAAQ,EAAE,kBAAkB,EAC5B,IAAI,EAAE,MAAM,GACX,aAAa,EAAE,CAqBjB"}

package/dist/src/analysis/health-baseline.js

@@ -0,0 +1,57 @@
+function toRelativePath(filePath, root) {
+    const normalized = filePath.replace(/\\/g, '/');
+    const rootNorm = root.replace(/\\/g, '/').replace(/\/$/, '') + '/';
+    return normalized.startsWith(rootNorm) ? normalized.slice(rootNorm.length) : normalized;
+}
+function buildCountsFromFindings(findings, root) {
+    const map = new Map();
+    const zero = () => ({
+        complexityModerate: 0, complexityHigh: 0, complexityCritical: 0,
+        crapModerate: 0, crapHigh: 0, crapCritical: 0,
+    });
+    for (const f of findings) {
+        const key = toRelativePath(f.filePath, root);
+        const counts = map.get(key) ?? zero();
+        const fieldMap = {
+            'complexity_moderate': 'complexityModerate',
+            'complexity_high': 'complexityHigh',
+            'complexity_critical': 'complexityCritical',
+            'crap_moderate': 'crapModerate',
+            'crap_high': 'crapHigh',
+            'crap_critical': 'crapCritical',
+        };
+        const field = fieldMap[f.kind];
+        if (field)
+            counts[field]++;
+        map.set(key, counts);
+    }
+    return map;
+}
+export function buildHealthBaseline(findings, root) {
+    return { counts: buildCountsFromFindings(findings, root) };
+}
+export function filterNewHealthFindings(current, baseline, root) {
+    // Build counts from CURRENT findings (not the baseline) to compare per-kind per-file
+    const currentCounts = buildCountsFromFindings(current, root);
+    return current.filter(f => {
+        const key = toRelativePath(f.filePath, root);
+        const saved = baseline.counts.get(key);
+        if (!saved)
+            return true;
+        const fieldMap = {
+            'complexity_moderate': 'complexityModerate',
+            'complexity_high': 'complexityHigh',
+            'complexity_critical': 'complexityCritical',
+            'crap_moderate': 'crapModerate',
+            'crap_high': 'crapHigh',
+            'crap_critical': 'crapCritical',
+        };
+        const field = fieldMap[f.kind];
+        if (!field)
+            return true;
+        const currentCount = currentCounts.get(key)?.[field] ?? 0;
+        const savedCount = saved[field];
+        return currentCount > savedCount;
+    });
+}
+//# sourceMappingURL=health-baseline.js.map

package/dist/src/analysis/health-baseline.js.map

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

package/dist/src/analysis/issue-filters.d.ts

@@ -0,0 +1,28 @@
+export type IssueFilterKey = 'unusedFiles' | 'unusedExports' | 'unusedDeps' | 'unusedTypes' | 'privateTypeLeaks' | 'unusedEnumMembers' | 'unusedClassMembers' | 'unresolvedImports' | 'unlistedDeps' | 'duplicateExports' | 'circularDeps' | 'boundaryViolations' | 'staleSuppressions';
+export interface IssueFilters {
+    unusedFiles: boolean;
+    unusedExports: boolean;
+    unusedDeps: boolean;
+    unusedTypes: boolean;
+    privateTypeLeaks: boolean;
+    unusedEnumMembers: boolean;
+    unusedClassMembers: boolean;
+    unresolvedImports: boolean;
+    unlistedDeps: boolean;
+    duplicateExports: boolean;
+    circularDeps: boolean;
+    boundaryViolations: boolean;
+    staleSuppressions: boolean;
+}
+export declare const ALL_FILTERS_OFF: IssueFilters;
+export declare const ALL_FILTERS_ON: IssueFilters;
+/** Returns true if at least one filter is active. */
+export declare function anyFiltersActive(filters: IssueFilters): boolean;
+/** When a caller passes an explicit list of check names, turn those on and all others off. */
+export declare function activateExplicitOptIns(checks: IssueFilterKey[]): IssueFilters;
+/** Zero out result fields that are disabled in the filters.
+ *  Works with any object whose keys overlap IssueFilterKey names. */
+export declare function applyIssueFilters<T extends Record<string, unknown>>(results: T, filters: IssueFilters): T;
+/** Parse a comma-separated string of filter keys into an IssueFilters object. */
+export declare function parseIssueFilters(csv: string): IssueFilters;
+//# sourceMappingURL=issue-filters.d.ts.map

package/dist/src/analysis/issue-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-filters.d.ts","sourceRoot":"","sources":["../../../src/analysis/issue-filters.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GACtB,aAAa,GAAG,eAAe,GAAG,YAAY,GAAG,aAAa,GAC9D,kBAAkB,GAAG,mBAAmB,GAAG,oBAAoB,GAC/D,mBAAmB,GAAG,cAAc,GAAG,kBAAkB,GACzD,cAAc,GAAG,oBAAoB,GAAG,mBAAmB,CAAC;AAEhE,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,eAAe,EAAE,YAK7B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,YAK5B,CAAC;AAEF,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAE/D;AAED,8FAA8F;AAC9F,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,YAAY,CAI7E;AAED;qEACqE;AACrE,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,OAAO,EAAE,CAAC,EACV,OAAO,EAAE,YAAY,GACpB,CAAC,CAuBH;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAG3D"}

package/dist/src/analysis/issue-filters.js

@@ -0,0 +1,57 @@
+// Selective issue filters — zero out AnalysisResults fields so callers can
+// run any subset of checks in one pass without rerunning the pipeline.
+export const ALL_FILTERS_OFF = {
+    unusedFiles: false, unusedExports: false, unusedDeps: false, unusedTypes: false,
+    privateTypeLeaks: false, unusedEnumMembers: false, unusedClassMembers: false,
+    unresolvedImports: false, unlistedDeps: false, duplicateExports: false,
+    circularDeps: false, boundaryViolations: false, staleSuppressions: false,
+};
+export const ALL_FILTERS_ON = {
+    unusedFiles: true, unusedExports: true, unusedDeps: true, unusedTypes: true,
+    privateTypeLeaks: true, unusedEnumMembers: true, unusedClassMembers: true,
+    unresolvedImports: true, unlistedDeps: true, duplicateExports: true,
+    circularDeps: true, boundaryViolations: true, staleSuppressions: true,
+};
+/** Returns true if at least one filter is active. */
+export function anyFiltersActive(filters) {
+    return Object.values(filters).some(Boolean);
+}
+/** When a caller passes an explicit list of check names, turn those on and all others off. */
+export function activateExplicitOptIns(checks) {
+    const result = { ...ALL_FILTERS_OFF };
+    for (const key of checks)
+        result[key] = true;
+    return result;
+}
+/** Zero out result fields that are disabled in the filters.
+ *  Works with any object whose keys overlap IssueFilterKey names. */
+export function applyIssueFilters(results, filters) {
+    const out = { ...results };
+    const keyMap = {
+        unusedFiles: 'deadFiles',
+        unusedExports: 'unusedExports',
+        unusedDeps: 'unusedDependencies',
+        unusedTypes: 'unusedTypes',
+        privateTypeLeaks: 'privateTypeLeaks',
+        unusedEnumMembers: 'unusedEnumMembers',
+        unusedClassMembers: 'unusedClassMembers',
+        unresolvedImports: 'unresolvedImports',
+        unlistedDeps: 'unlistedDependencies',
+        duplicateExports: 'duplicateExports',
+        circularDeps: 'circularDependencies',
+        boundaryViolations: 'boundaryViolations',
+        staleSuppressions: 'staleSuppressions',
+    };
+    for (const [filterKey, resultKey] of Object.entries(keyMap)) {
+        if (!filters[filterKey] && resultKey in out) {
+            out[resultKey] = Array.isArray(out[resultKey]) ? [] : undefined;
+        }
+    }
+    return out;
+}
+/** Parse a comma-separated string of filter keys into an IssueFilters object. */
+export function parseIssueFilters(csv) {
+    const keys = csv.split(',').map(s => s.trim()).filter(Boolean);
+    return activateExplicitOptIns(keys);
+}
+//# sourceMappingURL=issue-filters.js.map

package/dist/src/analysis/issue-filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue-filters.js","sourceRoot":"","sources":["../../../src/analysis/issue-filters.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,uEAAuE;AAwBvE,MAAM,CAAC,MAAM,eAAe,GAAiB;IAC3C,WAAW,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK;IAC/E,gBAAgB,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK;IAC5E,iBAAiB,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK;IACtE,YAAY,EAAE,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK;CACzE,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAiB;IAC1C,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI;IAC3E,gBAAgB,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI;IACzE,iBAAiB,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI;IACnE,YAAY,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI;CACtE,CAAC;AAEF,qDAAqD;AACrD,MAAM,UAAU,gBAAgB,CAAC,OAAqB;IACpD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,sBAAsB,CAAC,MAAwB;IAC7D,MAAM,MAAM,GAAG,EAAE,GAAG,eAAe,EAAE,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;qEACqE;AACrE,MAAM,UAAU,iBAAiB,CAC/B,OAAU,EACV,OAAqB;IAErB,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3B,MAAM,MAAM,GAA4C;QACtD,WAAW,EAAE,WAAW;QACxB,aAAa,EAAE,eAAe;QAC9B,UAAU,EAAE,oBAAoB;QAChC,WAAW,EAAE,aAAa;QAC1B,gBAAgB,EAAE,kBAAkB;QACpC,iBAAiB,EAAE,mBAAmB;QACtC,kBAAkB,EAAE,oBAAoB;QACxC,iBAAiB,EAAE,mBAAmB;QACtC,YAAY,EAAE,sBAAsB;QACpC,gBAAgB,EAAE,kBAAkB;QACpC,YAAY,EAAE,sBAAsB;QACpC,kBAAkB,EAAE,oBAAoB;QACxC,iBAAiB,EAAE,mBAAmB;KACvC,CAAC;IACF,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAA+B,EAAE,CAAC;QAC1F,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;YAC3C,GAA+B,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/F,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAqB,CAAC;IACnF,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC"}