@miller-tech/uap 1.221.0 → 2.0.0

package/dist/quality/complexity.js

@@ -0,0 +1,239 @@
+/**
+ * Built-in complexity fallback scanner.
+ *
+ * When lizard / rust-code-analysis are installed their numbers are used
+ * instead (see tools.ts). This heuristic exists so the gate is not toothless
+ * on machines without external tooling. It is deliberately conservative:
+ * function-region detection is generic (brace-balance for C-family, indent
+ * for Python), and decision counting follows McCabe (cc = 1 + decisions) and
+ * the SonarSource cognitive rules (decisions weighted by nesting depth).
+ *
+ * Accuracy note: it can disagree with lizard on exotic syntax. That is fine
+ * for a ratcheted gate — the baseline freezes whatever the scanner reports,
+ * and a project needing exact numbers installs lizard.
+ *
+ * PARITY: quality_metrics_gate.py mirrors this file decision-for-decision.
+ * Change one, change both, and extend the parity corpus in
+ * test/quality/quality-gate-enforcer.test.ts.
+ */
+import { stripNoise } from './languages.js';
+/** Count non-empty lines of comment-stripped content. */
+export function countLoc(stripped) {
+    let n = 0;
+    for (const line of stripped.split('\n'))
+        if (line.trim())
+            n++;
+    return n;
+}
+/** Boolean/ternary ops get a flat +1 cognitive (no nesting bump). */
+const BOOL_OPS = new Set(['&&', '||', '?', 'and', 'or']);
+function countDecisions(segment, facts, initialDepth = 0) {
+    let cyclomatic = 1;
+    let cognitive = 0;
+    // Region segments include the function's own opening brace; callers pass
+    // initialDepth = -1 there so nesting depth counts from INSIDE the function
+    // (SonarSource convention), not from the header line.
+    let depth = initialDepth;
+    // Normalize modern TS before tokenizing: `??` counts as ONE decision (a
+    // coalescing branch), `?.` counts as none (optional chaining is a guard,
+    // not a branch SonarSource-style). Without this `a?.b ?? c` reads as three
+    // phantom decisions. Keep in lockstep with quality_metrics_gate.py.
+    const normalized = segment.replace(/\?\?/g, ' ? ').replace(/\?\./g, '.');
+    // Word + operator scan in source order so cognitive nesting weighting works.
+    const tokenRe = /[A-Za-z_][A-Za-z0-9_]*|&&|\|\||[?{}]/g;
+    let m;
+    while ((m = tokenRe.exec(normalized)) !== null) {
+        const tok = m[0];
+        if (tok === '{') {
+            depth++;
+            continue;
+        }
+        if (tok === '}') {
+            depth = Math.max(0, depth - 1);
+            continue;
+        }
+        const isDecision = facts.decisionWords.includes(tok) || facts.decisionOps.includes(tok);
+        if (isDecision) {
+            cyclomatic++;
+            // SonarSource cognitive: +1 for the decision, +1 per nesting level.
+            // Binary boolean ops add 1 flat (no nesting bump). Keep BOOL_OPS in
+            // lockstep with quality_metrics_gate.py (_BOOL_OPS).
+            cognitive += BOOL_OPS.has(tok) ? 1 : 1 + Math.max(0, depth);
+        }
+    }
+    return { cyclomatic, cognitive };
+}
+/**
+ * Function-header detection, tried in order per line. Deliberately simple:
+ * keyword forms first (including generators `function*`), then arrow
+ * functions assigned to consts (pervasive in modern TS — missing them dumps
+ * their bodies into the <module> score), then a method-style fallback that
+ * rejects control-flow keywords. Built from strings (not regex literals) so
+ * this module's own <module> score does not count the patterns' `?`s —
+ * string contents are stripped before scanning.
+ */
+const RE_FUNC_KW = new RegExp('\\b(?:export\\s+)?(?:default\\s+)?(?:async\\s+)?function\\s*\\*?\\s*([A-Za-z_$][\\w$]*)\\s*\\(');
+const RE_NAMED_KW = new RegExp('\\b(?:def|fn|func|fun)\\s+([A-Za-z_]\\w*)\\s*\\(');
+const RE_ARROW = new RegExp('^\\s*(?:export\\s+)?(?:const|let|var)\\s+([A-Za-z_$][\\w$]*)\\s*(?::\\s*[^=]+?)?=' +
+    '\\s*(?:async\\s+)?(?:\\([^)]*\\)|[A-Za-z_$][\\w$]*)\\s*=>\\s*\\{');
+const RE_METHOD = new RegExp('^\\s*(?:(?:public|private|protected|static|final|abstract|override|readonly|async|inline|virtual' +
+    '|constexpr|pub|unsafe|extern|internal|sealed|partial|suspend|open|export|default|get|set)\\s+)*' +
+    '([A-Za-z_$][\\w$]*)\\s*\\([^;{}]*\\)\\s*(?::\\s*[^{;]+?)?\\s*\\{');
+const CONTROL_WORDS = new Set([
+    'if', 'for', 'while', 'switch', 'catch', 'return', 'do', 'else', 'case',
+    'with', 'synchronized', 'lock', 'using', 'foreach', 'when', 'unless', 'until',
+]);
+/** Name of the function declared on this line, or null. */
+export function functionHeader(line) {
+    let m = RE_FUNC_KW.exec(line) ?? RE_NAMED_KW.exec(line) ?? RE_ARROW.exec(line);
+    if (m)
+        return m[1];
+    m = RE_METHOD.exec(line);
+    if (m && !CONTROL_WORDS.has(m[1]))
+        return m[1];
+    return null;
+}
+function braceDelta(line) {
+    let n = 0;
+    for (let i = 0; i < line.length; i++) {
+        if (line[i] === '{')
+            n++;
+        else if (line[i] === '}')
+            n--;
+    }
+    return n;
+}
+function scoreRegion(seg, facts, name, line, initialDepth) {
+    const d = countDecisions(seg, facts, initialDepth);
+    return { name, line, cyclomatic: d.cyclomatic, cognitive: d.cognitive, nloc: countLoc(seg) };
+}
+/** Module-level decisions score as a pseudo-function, so module-level
+ * tangles are still gated (and stay in TS/Python signature parity). */
+function moduleMetric(modLines, facts) {
+    const seg = modLines.join('\n');
+    const d = countDecisions(seg, facts);
+    if (d.cyclomatic <= 1)
+        return null;
+    return { name: '<module>', line: 1, cyclomatic: d.cyclomatic, cognitive: d.cognitive, nloc: countLoc(seg) };
+}
+/** Python-style: a region starts at `def name(` and ends at the first
+ * subsequent line whose indent <= the def's indent. */
+function analyzeIndentRegions(lines, loc, facts) {
+    const functions = [];
+    const modBuf = [];
+    let open = null;
+    let buf = [];
+    const flush = () => {
+        if (!open)
+            return;
+        functions.push(scoreRegion(buf.join('\n'), facts, open.name, open.startLine, 0));
+        open = null;
+        buf = [];
+    };
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const dm = /^(\s*)(?:async\s+)?def\s+([A-Za-z_][\w]*)\s*\(/.exec(line);
+        if (dm) {
+            flush();
+            open = { name: dm[2], startLine: i + 1, indent: dm[1].length };
+            buf.push(line);
+            continue;
+        }
+        if (!open) {
+            modBuf.push(line);
+            continue;
+        }
+        const indent = /^(\s*)/.exec(line)?.[1].length ?? 0;
+        if (line.trim() && indent <= open.indent) {
+            flush();
+            modBuf.push(line); // the dedent line itself is module-level
+            continue;
+        }
+        buf.push(line);
+    }
+    flush();
+    const mod = moduleMetric(modBuf, facts);
+    if (mod)
+        functions.push(mod);
+    return { functions, loc };
+}
+/** Classify a detected header line: open a region for it, or score it
+ * in place (one-line functions) and stay at module level. */
+function startBraceRegion(name, line, lineNo, depth, delta, facts, functions) {
+    if (delta > 0) {
+        return { region: { name, startLine: lineNo, startDepth: depth + delta, entered: true }, depth: depth + delta };
+    }
+    if (!line.includes('{')) {
+        // Multi-line signature — the opening brace is on a later line. Open the
+        // region now, anticipating the body one level above current depth (TS
+        // overload signatures collapse into their implementation; fine for a
+        // heuristic).
+        return { region: { name, startLine: lineNo, startDepth: depth + 1, entered: false }, depth };
+    }
+    // One-line function (`function f() { ... }` on one line): the brace
+    // balance never dips below startDepth, so without this branch the region
+    // stays open and swallows the REST OF THE FILE into this function's
+    // metrics. Score the header line alone.
+    functions.push(scoreRegion(line, facts, name, lineNo, 0));
+    return { region: null, depth: Math.max(0, depth + delta) };
+}
+/** Brace languages: find candidate headers, then brace-balance the region. */
+function analyzeBraceRegions(lines, loc, facts) {
+    const functions = [];
+    const fileBuf = [];
+    let depth = 0;
+    let open = null;
+    let buf = [];
+    const closeRegion = () => {
+        if (!open)
+            return;
+        functions.push(scoreRegion(buf.join('\n'), facts, open.name, open.startLine, -1));
+        open = null;
+        buf = [];
+    };
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (open) {
+            buf.push(line);
+            const d = braceDelta(line);
+            depth += d;
+            if (!open.entered) {
+                if (d > 0)
+                    open.entered = true;
+                continue; // never close-check before the body opens
+            }
+            if (depth < open.startDepth)
+                closeRegion();
+            continue;
+        }
+        const name = functionHeader(line);
+        const delta = braceDelta(line);
+        if (!name) {
+            fileBuf.push(line);
+            depth = Math.max(0, depth + delta);
+            continue;
+        }
+        const started = startBraceRegion(name, line, i + 1, depth, delta, facts, functions);
+        if (started.region) {
+            open = started.region;
+            buf = [line];
+        }
+        depth = started.depth;
+    }
+    // Unbalanced braces — score what we saw rather than dropping it.
+    closeRegion();
+    const mod = moduleMetric(fileBuf, facts);
+    if (mod)
+        functions.push(mod);
+    return { functions, loc };
+}
+/** Split source into function-ish regions and score each. */
+export function analyzeComplexity(content, facts) {
+    const stripped = stripNoise(content, facts.commentStyle);
+    const lines = stripped.split('\n');
+    const loc = countLoc(stripped);
+    return facts.indentBased
+        ? analyzeIndentRegions(lines, loc, facts)
+        : analyzeBraceRegions(lines, loc, facts);
+}
+//# sourceMappingURL=complexity.js.map

package/dist/quality/complexity.js.map

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

package/dist/quality/config.d.ts

@@ -0,0 +1,40 @@
+export interface QualityThresholds {
+    /** Max cyclomatic complexity per function. */
+    maxCyclomatic: number;
+    /** Max cognitive complexity per function. */
+    maxCognitive: number;
+    /** Max Halstead difficulty per function (requires rust-code-analysis). */
+    maxHalsteadDifficulty: number;
+    /** Max non-blank, non-comment lines per file. */
+    maxLocPerFile: number;
+    /** Min line-coverage percent per file (0-100). */
+    minCoveragePct: number;
+    /** Max CRAP score per function: cc^2 * (1-cov)^3 + cc. */
+    maxCrap: number;
+    /** Max surviving mutants (changed-files incremental run). */
+    maxSurvivingMutants: number;
+    /** Max duplicated-block findings (jscpd clones over the token floor). */
+    maxDuplicateBlocks: number;
+    /** Max dead-code findings (knip / vulture / compiler dead_code). */
+    maxDeadCode: number;
+    /** Max explicit any/unknown type usages (TS: any/unknown, Py: typing.Any). */
+    maxAnyTypes: number;
+}
+export interface QualityConfig {
+    version: 1;
+    thresholds: QualityThresholds;
+    /** Glob-ish directory prefixes to exclude from scanning. */
+    excludeDirs: string[];
+    /** File extensions considered source (others are ignored). */
+    sourceExts: string[];
+}
+export declare const DEFAULT_THRESHOLDS: QualityThresholds;
+export declare const DEFAULT_SOURCE_EXTS: string[];
+export declare const DEFAULT_EXCLUDE_DIRS: string[];
+export declare function configPath(root: string): string;
+export declare function defaultConfig(): QualityConfig;
+/** Load the config, or null when the gate is inactive (no config file). */
+export declare function loadQualityConfig(root: string): QualityConfig | null;
+/** Write the default config (uap quality init). */
+export declare function writeDefaultConfig(root: string): string;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/quality/config.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iDAAiD;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,UAAU,EAAE,iBAAiB,CAAC;IAC9B,4DAA4D;IAC5D,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,eAAO,MAAM,kBAAkB,EAAE,iBAWhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,UAI/B,CAAC;AAEF,eAAO,MAAM,oBAAoB,UAIhC,CAAC;AAEF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,aAAa,IAAI,aAAa,CAO7C;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAiBpE;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD"}

package/dist/quality/config.js

@@ -0,0 +1,77 @@
+/**
+ * Quality-metrics gate configuration.
+ *
+ * Lives at `.uap/quality-metrics.json` (committed, per project). The gate is
+ * INACTIVE (fails open) when the file is absent — quality policing is opt-in
+ * per project via `uap quality init`, exactly like the design-token gate is
+ * inactive without a DESIGN.md.
+ *
+ * Every threshold mirrors the policing targets:
+ *   cyclomatic < 22 · cognitive < 22 · halstead difficulty < 80
+ *   LOC/file < 500 · coverage 100% · CRAP < 25 · surviving mutants 0
+ *   dead code 0 · redundant (duplicate) code 0 · explicit any/unknown 0
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+export const DEFAULT_THRESHOLDS = {
+    maxCyclomatic: 22,
+    maxCognitive: 22,
+    maxHalsteadDifficulty: 80,
+    maxLocPerFile: 500,
+    minCoveragePct: 100,
+    maxCrap: 25,
+    maxSurvivingMutants: 0,
+    maxDuplicateBlocks: 0,
+    maxDeadCode: 0,
+    maxAnyTypes: 0,
+};
+export const DEFAULT_SOURCE_EXTS = [
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.py', '.java', '.cs', '.cpp', '.cc', '.cxx', '.c', '.h', '.hpp',
+    '.rs', '.go', '.rb', '.php', '.swift', '.kt', '.scala',
+];
+export const DEFAULT_EXCLUDE_DIRS = [
+    'node_modules', 'dist', 'build', 'out', 'target', 'coverage',
+    '.git', '.worktrees', 'vendor', '__pycache__', '.venv', 'venv',
+    'benchmarks', 'benchmark-results', 'third_party', 'generated',
+];
+export function configPath(root) {
+    return join(root, '.uap', 'quality-metrics.json');
+}
+export function defaultConfig() {
+    return {
+        version: 1,
+        thresholds: { ...DEFAULT_THRESHOLDS },
+        excludeDirs: [...DEFAULT_EXCLUDE_DIRS],
+        sourceExts: [...DEFAULT_SOURCE_EXTS],
+    };
+}
+/** Load the config, or null when the gate is inactive (no config file). */
+export function loadQualityConfig(root) {
+    const p = configPath(root);
+    if (!existsSync(p))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(p, 'utf-8'));
+        const d = defaultConfig();
+        return {
+            version: 1,
+            thresholds: { ...d.thresholds, ...(raw.thresholds ?? {}) },
+            excludeDirs: raw.excludeDirs ?? d.excludeDirs,
+            sourceExts: raw.sourceExts ?? d.sourceExts,
+        };
+    }
+    catch {
+        // A corrupt config must not silently disable policing, but crashing the
+        // gate is worse — fail open and let `uap quality check` surface the error.
+        return null;
+    }
+}
+/** Write the default config (uap quality init). */
+export function writeDefaultConfig(root) {
+    const p = configPath(root);
+    mkdirSync(join(root, '.uap'), { recursive: true });
+    writeFileSync(p, JSON.stringify(defaultConfig(), null, 2) + '\n');
+    return p;
+}
+//# sourceMappingURL=config.js.map

package/dist/quality/config.js.map

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

package/dist/quality/crap.d.ts

@@ -0,0 +1,11 @@
+export declare function crapScore(cyclomatic: number, coverageFraction: number): number;
+/**
+ * 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 declare function loadCoverageSummary(root: string): Map<string, number> | null;
+/** Resolve the coverage fraction for a scanned file, tolerating path shape. */
+export declare function coverageFor(coverage: Map<string, number>, root: string, file: string): number | null;
+//# sourceMappingURL=crap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"crap.d.ts","sourceRoot":"","sources":["../../src/quality/crap.ts"],"names":[],"mappings":"AAaA,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAG9E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAkB5E;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASpG"}

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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"}