@miller-tech/uap 1.222.0 → 2.1.4

package/dist/quality/crap.js

@@ -0,0 +1,54 @@
+/**
+ * CRAP (Change Risk Anti-Patterns) score: cc^2 * (1 - cov)^3 + cc
+ * where cc is cyclomatic complexity and cov is the line-coverage fraction.
+ *
+ * Function-level coverage is not reliably available from every provider, so
+ * the gate computes CRAP per function using the FILE's line-coverage fraction
+ * — an approximation documented in the policy. A file with 0% coverage makes
+ * CRAP = cc^2 + cc, so untested complex functions blow past the threshold
+ * fast, which is exactly the pressure the metric exists to apply.
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+export function crapScore(cyclomatic, coverageFraction) {
+    const c = Math.min(1, Math.max(0, coverageFraction));
+    return cyclomatic * cyclomatic * Math.pow(1 - c, 3) + cyclomatic;
+}
+/**
+ * Parse per-file line-coverage fractions from a vitest/istanbul
+ * coverage-summary.json (`<root>/coverage/coverage-summary.json`).
+ * Returns null when absent — coverage metrics are then skipped (fail-open
+ * with a logged warning), matching the missing-tool policy.
+ */
+export function loadCoverageSummary(root) {
+    const p = join(root, 'coverage', 'coverage-summary.json');
+    if (!existsSync(p))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(p, 'utf-8'));
+        const out = new Map();
+        for (const [file, data] of Object.entries(raw)) {
+            if (file === 'total')
+                continue;
+            const pct = data?.lines?.pct;
+            if (typeof pct === 'number')
+                out.set(file, pct / 100);
+        }
+        return out;
+    }
+    catch {
+        return null;
+    }
+}
+/** Resolve the coverage fraction for a scanned file, tolerating path shape. */
+export function coverageFor(coverage, root, file) {
+    const norm = file.replace(/\\/g, '/');
+    for (const [covFile, pct] of coverage) {
+        const cf = covFile.replace(/\\/g, '/');
+        if (cf === norm || cf === join(root, norm).replace(/\\/g, '/') || cf.endsWith(`/${norm}`)) {
+            return pct;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=crap.js.map

package/dist/quality/crap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crap.js","sourceRoot":"","sources":["../../src/quality/crap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,UAAU,SAAS,CAAC,UAAkB,EAAE,gBAAwB;IACpE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACrD,OAAO,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,UAAU,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,uBAAuB,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAG9C,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,IAAI,IAAI,KAAK,OAAO;gBAAE,SAAS;YAC/B,MAAM,GAAG,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC;YAC7B,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,QAA6B,EAAE,IAAY,EAAE,IAAY;IACnF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtC,KAAK,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,QAAQ,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;YAC1F,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/quality/languages.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Language detection + lexical facts for the built-in scanner.
+ *
+ * The scanner is a *fallback*: when lizard / rust-code-analysis are installed
+ * their (authoritative) numbers win. Without them the gate still needs teeth,
+ * so we approximate with a generic brace/indent model driven by the facts
+ * below. Heuristic by design — documented as such in the policy.
+ */
+export type CommentStyle = 'c' | 'hash';
+export interface LanguageFacts {
+    name: string;
+    commentStyle: CommentStyle;
+    /** True for indent-delimited languages (python): no braces delimit blocks. */
+    indentBased: boolean;
+    /**
+     * Decision keywords counted for cyclomatic complexity. Word-boundary matched
+     * against code with strings/comments stripped.
+     */
+    decisionWords: string[];
+    /** Operator decision tokens (counted like keywords): `&&`, `||`, `?` etc. */
+    decisionOps: string[];
+}
+export declare function languageForFile(path: string): LanguageFacts | null;
+export declare function stripNoise(content: string, style: CommentStyle): string;
+//# sourceMappingURL=languages.d.ts.map

package/dist/quality/languages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.d.ts","sourceRoot":"","sources":["../../src/quality/languages.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,YAAY,GAAG,GAAG,GAAG,MAAM,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;IAC3B,8EAA8E;IAC9E,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,6EAA6E;IAC7E,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAmED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAKlE;AAqDD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAiBvE"}

package/dist/quality/languages.js

@@ -0,0 +1,150 @@
+/**
+ * Language detection + lexical facts for the built-in scanner.
+ *
+ * The scanner is a *fallback*: when lizard / rust-code-analysis are installed
+ * their (authoritative) numbers win. Without them the gate still needs teeth,
+ * so we approximate with a generic brace/indent model driven by the facts
+ * below. Heuristic by design — documented as such in the policy.
+ */
+const C_FAMILY = {
+    commentStyle: 'c',
+    indentBased: false,
+    decisionWords: ['if', 'for', 'while', 'case', 'catch', 'elif'],
+    decisionOps: ['&&', '||', '?'],
+};
+const FACTS = {
+    typescript: { name: 'typescript', ...C_FAMILY },
+    javascript: { name: 'javascript', ...C_FAMILY },
+    java: { name: 'java', ...C_FAMILY },
+    csharp: { name: 'csharp', ...C_FAMILY },
+    cpp: { name: 'cpp', ...C_FAMILY },
+    c: { name: 'c', ...C_FAMILY },
+    go: {
+        name: 'go',
+        commentStyle: 'c',
+        indentBased: false,
+        decisionWords: ['if', 'for', 'case', 'select'],
+        decisionOps: ['&&', '||'],
+    },
+    rust: {
+        name: 'rust',
+        commentStyle: 'c',
+        indentBased: false,
+        decisionWords: ['if', 'for', 'while', 'loop', 'match', 'catch'],
+        decisionOps: ['&&', '||', '?'],
+    },
+    python: {
+        name: 'python',
+        commentStyle: 'hash',
+        indentBased: true,
+        decisionWords: ['if', 'elif', 'for', 'while', 'except', 'with', 'assert'],
+        decisionOps: ['and', 'or'],
+    },
+    ruby: {
+        name: 'ruby',
+        commentStyle: 'hash',
+        indentBased: false,
+        decisionWords: ['if', 'elsif', 'unless', 'while', 'until', 'when', 'rescue'],
+        decisionOps: ['&&', '||'],
+    },
+    php: { name: 'php', ...C_FAMILY },
+    swift: { name: 'swift', ...C_FAMILY },
+    kotlin: { name: 'kotlin', ...C_FAMILY },
+    scala: { name: 'scala', ...C_FAMILY },
+};
+const EXT_MAP = {
+    '.ts': 'typescript', '.tsx': 'typescript', '.mts': 'typescript', '.cts': 'typescript',
+    '.js': 'javascript', '.jsx': 'javascript', '.mjs': 'javascript', '.cjs': 'javascript',
+    '.py': 'python',
+    '.java': 'java',
+    '.cs': 'csharp',
+    '.cpp': 'cpp', '.cc': 'cpp', '.cxx': 'cpp', '.hpp': 'cpp', '.hxx': 'cpp',
+    '.c': 'c', '.h': 'c',
+    '.rs': 'rust',
+    '.go': 'go',
+    '.rb': 'ruby',
+    '.php': 'php',
+    '.swift': 'swift',
+    '.kt': 'kotlin', '.kts': 'kotlin',
+    '.scala': 'scala',
+};
+export function languageForFile(path) {
+    const m = /\.[^./\\]+$/.exec(path);
+    if (!m)
+        return null;
+    const key = EXT_MAP[m[0].toLowerCase()];
+    return key ? FACTS[key] : null;
+}
+const QUOTE_OF = { sq: "'", dq: '"', tpl: '`' };
+function codeStep(ch, next, style, out, i) {
+    if (ch === '/' && next === '/')
+        return { next: i + 2, state: 'line' };
+    if (ch === '/' && next === '*')
+        return { next: i + 2, state: 'block' };
+    if (style === 'hash' && ch === '#')
+        return { next: i + 1, state: 'line' };
+    if (ch === "'") {
+        out.push(' ');
+        return { next: i + 1, state: 'sq' };
+    }
+    if (ch === '"') {
+        out.push(' ');
+        return { next: i + 1, state: 'dq' };
+    }
+    if (ch === '`') {
+        out.push(' ');
+        return { next: i + 1, state: 'tpl' };
+    }
+    out.push(ch);
+    return { next: i + 1, state: 'code' };
+}
+function lineStep(ch, out, i) {
+    if (ch === '\n') {
+        out.push('\n');
+        return { next: i + 1, state: 'code' };
+    }
+    return { next: i + 1, state: 'line' };
+}
+function blockStep(ch, next, out, i) {
+    if (ch === '*' && next === '/')
+        return { next: i + 2, state: 'code' };
+    if (ch === '\n')
+        out.push('\n'); // keep line numbers stable
+    return { next: i + 1, state: 'block' };
+}
+function stringStep(ch, state, out, i) {
+    if (ch === '\\')
+        return { next: i + 2, state };
+    if (ch === QUOTE_OF[state])
+        return { next: i + 1, state: 'code' };
+    if (ch === '\n') {
+        out.push('\n');
+        // Unterminated single/double-quoted string ends at the newline; template
+        // literals span lines.
+        return { next: i + 1, state: state === 'tpl' ? 'tpl' : 'code' };
+    }
+    return { next: i + 1, state };
+}
+export function stripNoise(content, style) {
+    const out = [];
+    let state = 'code';
+    let i = 0;
+    const n = content.length;
+    while (i < n) {
+        const ch = content[i];
+        const next = i + 1 < n ? content[i + 1] : '';
+        let step;
+        if (state === 'code')
+            step = codeStep(ch, next, style, out, i);
+        else if (state === 'line')
+            step = lineStep(ch, out, i);
+        else if (state === 'block')
+            step = blockStep(ch, next, out, i);
+        else
+            step = stringStep(ch, state, out, i);
+        i = step.next;
+        state = step.state;
+    }
+    return out.join('');
+}
+//# sourceMappingURL=languages.js.map

package/dist/quality/languages.js.map

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

package/dist/quality/report.d.ts

@@ -0,0 +1,38 @@
+import { QualityConfig } from './config.js';
+import { Violation, MetricId } from './scanner.js';
+import { ToolStatus } from './tools.js';
+export interface QualityReport {
+    root: string;
+    filesScanned: number;
+    violations: Violation[];
+    blocking: Violation[];
+    grandfathered: Violation[];
+    improved: Array<{
+        violation: Violation;
+        baselineValue: number;
+    }>;
+    /** Metrics skipped because their tool/data source is unavailable. */
+    skipped: Array<{
+        metric: string;
+        reason: string;
+    }>;
+    tools: ToolStatus[];
+    pass: boolean;
+    baselinePresent: boolean;
+}
+/** Recursively collect scannable source files under root/src (or root). */
+export declare function collectSourceFiles(root: string, config: QualityConfig): string[];
+/** Files changed vs the upstream base PLUS staged/unstaged/untracked work —
+ * a per-commit gate that only sees committed diffs would miss the commit's
+ * actual content. */
+export declare function changedFiles(root: string, config: QualityConfig): string[];
+export interface ReportOptions {
+    /** Explicit relative file list; default: full scan of collectSourceFiles. */
+    files?: string[];
+    /** Skip external tools even when installed (fast path / tests). */
+    builtinOnly?: boolean;
+}
+/** Build the full quality report for a set of files. */
+export declare function buildReport(root: string, config: QualityConfig, options?: ReportOptions): QualityReport;
+export type { MetricId };
+//# sourceMappingURL=report.d.ts.map

package/dist/quality/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/quality/report.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAkC,QAAQ,EAAE,MAAM,cAAc,CAAC;AAInF,OAAO,EACL,UAAU,EACX,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,SAAS,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,qEAAqE;IACrE,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CA6BhF;AAED;;qBAEqB;AACrB,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CA6B1E;AAED,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,mEAAmE;IACnE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAkJD,wDAAwD;AACxD,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,aAAkB,GAC1B,aAAa,CA4Bf;AAED,YAAY,EAAE,QAAQ,EAAE,CAAC"}

package/dist/quality/report.js

@@ -0,0 +1,251 @@
+/**
+ * Quality report orchestration: collect files, run every available metric,
+ * merge external-tool numbers over built-in heuristics, compute CRAP from
+ * coverage, and split violations into blocking vs grandfathered via the
+ * ratchet baseline.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from 'fs';
+import { join, relative } from 'path';
+import { execSync } from 'child_process';
+import { isScannableSource, scanContent } from './scanner.js';
+import { analyzeComplexity } from './complexity.js';
+import { languageForFile } from './languages.js';
+import { crapScore, coverageFor, loadCoverageSummary } from './crap.js';
+import { jscpdViolations, lizardViolations, probeTools, rcaViolations, } from './tools.js';
+import { loadBaseline, ratchet } from './baseline.js';
+/** Recursively collect scannable source files under root/src (or root). */
+export function collectSourceFiles(root, config) {
+    const seeds = ['src', 'tools', 'scripts', 'web'].filter((d) => existsSync(join(root, d)));
+    const dirs = seeds.length > 0 ? seeds : ['.'];
+    const out = [];
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const name of entries) {
+            const p = join(dir, name);
+            let st;
+            try {
+                st = statSync(p);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                if (!config.excludeDirs.includes(name))
+                    walk(p);
+                continue;
+            }
+            const rel = relative(root, p).replace(/\\/g, '/');
+            if (isScannableSource(rel, config))
+                out.push(rel);
+        }
+    };
+    for (const d of dirs)
+        walk(join(root, d));
+    return out.sort();
+}
+/** Files changed vs the upstream base PLUS staged/unstaged/untracked work —
+ * a per-commit gate that only sees committed diffs would miss the commit's
+ * actual content. */
+export function changedFiles(root, config) {
+    const found = new Set();
+    const tryGit = (args) => {
+        try {
+            const out = execSync(`git ${args}`, { cwd: root, encoding: 'utf-8', timeout: 10_000 });
+            for (const l of out.split('\n')) {
+                const f = l.trim();
+                if (f)
+                    found.add(f);
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    let baseResolved = false;
+    for (const base of ['origin/master', 'origin/main', 'master', 'main']) {
+        if (tryGit(`diff --name-only ${base}...HEAD`)) {
+            baseResolved = true;
+            break;
+        }
+    }
+    // Uncommitted work: staged, unstaged, and untracked source files.
+    tryGit('diff --name-only --cached');
+    tryGit('diff --name-only');
+    tryGit('ls-files --others --exclude-standard');
+    if (!baseResolved && found.size === 0) {
+        console.error('quality: no upstream base resolvable and no working-tree changes — scanning nothing');
+    }
+    return [...found].filter((f) => isScannableSource(f, config)).sort();
+}
+/** Stage 1: the always-available built-in scan. */
+function builtinScan(root, files, config) {
+    const out = [];
+    for (const f of files) {
+        let content = '';
+        try {
+            content = readFileSync(join(root, f), 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        out.push(...scanContent(f, content, config));
+    }
+    return out;
+}
+function hasTool(tools, name) {
+    return tools.some((t) => t.name === name && t.available);
+}
+/** Stage 2a: lizard's authoritative cyclomatic/NLOC numbers replace the
+ * built-in ones when lizard is installed. */
+function applyLizard(violations, files, root, config, options, skipped) {
+    if (options.builtinOnly)
+        return violations;
+    if (!hasTool(probeCached(options), 'lizard')) {
+        skipped.push({ metric: 'cyclomatic(authoritative)', reason: 'lizard not installed — built-in heuristic used' });
+        return violations;
+    }
+    const lv = lizardViolations(files.map((f) => join(root, f)), root, config);
+    if (!lv)
+        return violations;
+    return [...violations.filter((v) => v.metric !== 'cyclomatic' && v.metric !== 'locPerFile'), ...lv];
+}
+/** Stage 2b: rust-code-analysis cognitive/Halstead replaces built-in
+ * cognitive when installed. */
+function applyRca(violations, files, root, config, options, skipped) {
+    if (options.builtinOnly)
+        return violations;
+    if (!hasTool(probeCached(options), 'rust-code-analysis')) {
+        skipped.push({ metric: 'halsteadDifficulty', reason: 'rust-code-analysis not installed' });
+        return violations;
+    }
+    const rv = rcaViolations(files.map((f) => join(root, f)), root, config);
+    if (!rv)
+        return violations;
+    return [...violations.filter((v) => v.metric !== 'cognitive'), ...rv];
+}
+/** Stage 3: coverage deficit + per-function CRAP, from vitest's
+ * coverage/coverage-summary.json. */
+function coverageStage(root, files, config, skipped) {
+    const coverage = loadCoverageSummary(root);
+    if (!coverage) {
+        skipped.push({ metric: 'coverage', reason: 'no coverage/coverage-summary.json (run npm run test:coverage)' });
+        skipped.push({ metric: 'crap', reason: 'needs coverage data' });
+        return [];
+    }
+    const t = config.thresholds;
+    const out = [];
+    for (const f of files) {
+        const cov = coverageFor(coverage, root, f);
+        if (cov === null)
+            continue;
+        if (cov * 100 < t.minCoveragePct) {
+            // The ratchet treats HIGHER value as worse, but coverage is better
+            // when higher — store the DEFICIT (threshold − pct) so a coverage
+            // regression ratchets up and an improvement ratchets down, like
+            // every other metric.
+            const deficit = Math.round((t.minCoveragePct - cov * 100) * 10) / 10;
+            out.push({
+                file: f,
+                metric: 'coverage',
+                value: deficit,
+                threshold: t.minCoveragePct,
+                signature: `${f}::coverage::<file>`,
+                message: `${f}: ${(cov * 100).toFixed(1)}% line coverage below min ${t.minCoveragePct}% (deficit ${deficit})`,
+            });
+        }
+        out.push(...crapViolations(root, f, cov, t.maxCrap));
+    }
+    return out;
+}
+/** CRAP per function: file coverage × function complexity. */
+function crapViolations(root, f, cov, maxCrap) {
+    const lang = languageForFile(f);
+    if (!lang)
+        return [];
+    let content = '';
+    try {
+        content = readFileSync(join(root, f), 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const fn of analyzeComplexity(content, lang).functions) {
+        const score = crapScore(fn.cyclomatic, cov);
+        if (score > maxCrap) {
+            out.push({
+                file: f,
+                metric: 'crap',
+                value: Math.round(score * 10) / 10,
+                threshold: maxCrap,
+                signature: `${f}::crap::${fn.name}@${fn.line}`,
+                message: `${f}:${fn.line} ${fn.name}() CRAP ${score.toFixed(1)} (cc=${fn.cyclomatic}, cov=${(cov * 100).toFixed(0)}%) exceeds max ${maxCrap}`,
+            });
+        }
+    }
+    return out;
+}
+/** Stage 4: jscpd duplication. */
+function duplicationStage(root, config, options, skipped) {
+    if (options.builtinOnly)
+        return [];
+    if (!hasTool(probeCached(options), 'jscpd')) {
+        skipped.push({ metric: 'duplicateBlocks', reason: 'jscpd not installed' });
+        return [];
+    }
+    return jscpdViolations(root, config) ?? [];
+}
+/** Stage 5: note metrics that are report-only or have no available tool. */
+function noteUnavailable(options, skipped) {
+    if (options.builtinOnly)
+        return;
+    if (!hasTool(probeCached(options), 'knip') && !hasTool(probeCached(options), 'vulture')) {
+        skipped.push({ metric: 'deadCode', reason: 'knip/vulture not installed' });
+    }
+    skipped.push({ metric: 'survivingMutants', reason: 'run `uap quality mutate` (changed-files incremental)' });
+}
+/** Probe tools once per report; stage helpers read the cached list. */
+const probeCache = new WeakMap();
+function probeCached(options) {
+    let t = probeCache.get(options);
+    if (!t) {
+        t = options.builtinOnly ? [] : probeTools();
+        probeCache.set(options, t);
+    }
+    return t;
+}
+/** Build the full quality report for a set of files. */
+export function buildReport(root, config, options = {}) {
+    const files = options.files ?? collectSourceFiles(root, config);
+    const skipped = [];
+    const tools = probeCached(options);
+    let violations = builtinScan(root, files, config);
+    violations = applyLizard(violations, files, root, config, options, skipped);
+    violations = applyRca(violations, files, root, config, options, skipped);
+    violations.push(...coverageStage(root, files, config, skipped));
+    violations.push(...duplicationStage(root, config, options, skipped));
+    noteUnavailable(options, skipped);
+    // Ratchet against the baseline.
+    const baseline = loadBaseline(root);
+    const r = ratchet(violations, baseline);
+    return {
+        root,
+        filesScanned: files.length,
+        violations,
+        blocking: r.blocking,
+        grandfathered: r.grandfathered,
+        improved: r.improved,
+        skipped,
+        tools,
+        pass: r.blocking.length === 0,
+        baselinePresent: baseline !== null,
+    };
+}
+//# sourceMappingURL=report.js.map

package/dist/quality/report.js.map

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

package/dist/quality/scanner.d.ts

@@ -0,0 +1,32 @@
+import { QualityConfig } from './config.js';
+export type MetricId = 'cyclomatic' | 'cognitive' | 'halsteadDifficulty' | 'locPerFile' | 'coverage' | 'crap' | 'survivingMutants' | 'duplicateBlocks' | 'deadCode' | 'anyTypes';
+export interface Violation {
+    file: string;
+    metric: MetricId;
+    /** Measured value (count, complexity, or percent depending on metric). */
+    value: number;
+    /** Configured threshold that was crossed. */
+    threshold: number;
+    /**
+     * Stable identity for baseline ratcheting: file + metric + the function or
+     * site the violation belongs to. Function renames intentionally re-identify
+     * a violation (a renamed complex function is reviewed as if new).
+     */
+    signature: string;
+    message: string;
+}
+/** Count explicit any/unknown usages in one file's content. */
+export declare function countAnyTypes(content: string, file: string): {
+    count: number;
+    lines: number[];
+};
+/**
+ * Scan one file's content for the always-available metrics:
+ * LOC/file, per-function cyclomatic + cognitive complexity, any-types.
+ * Halstead/CRAP/coverage/mutation/duplication/dead-code need external data
+ * and are merged later by report.ts.
+ */
+export declare function scanContent(file: string, content: string, config: QualityConfig): Violation[];
+/** True when `file` is a scannable source path under the config's rules. */
+export declare function isScannableSource(file: string, config: QualityConfig): boolean;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/quality/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/quality/scanner.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5C,MAAM,MAAM,QAAQ,GAChB,YAAY,GACZ,WAAW,GACX,oBAAoB,GACpB,YAAY,GACZ,UAAU,GACV,MAAM,GACN,kBAAkB,GAClB,iBAAiB,GACjB,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC;IACjB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAyBD,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAkB/F;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,SAAS,EAAE,CAuD7F;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAQ9E"}