@avi770/testteam 3.0.0 → 3.2.0

package/dist/core/quality-score/calculator.d.ts

@@ -0,0 +1,125 @@
+/**
+ * QualityScoreCalculator (#14 — "The Judge").
+ *
+ * One honest, transparent health number for every component, feature, and the
+ * whole system. Composite, weighted, incremental, explainable. No black box;
+ * every number shows its math. No rounding-up. Deterministic given the same inputs.
+ *
+ * Genuine engine reuse (spec-locked):
+ *  - `validateCodeQuality` (helpers/quality-gate.ts) backs `deriveCodeQualitySignal`,
+ *    turning real source-quality violations into a code-quality dimension signal.
+ *  - `evaluateGate` (core/phase-gate.ts) is folded into `evaluateReleaseGate` when
+ *    phase-gate inputs are supplied — a failed engine phase gate blocks the release.
+ *
+ * The release gate is FAIL-CLOSED: unscored, low-confidence, or gamed components
+ * block a release rather than slipping through.
+ *
+ * Spec: blueprint/agents/14-quality-score-calculator.md
+ * All 10 improvements are implemented — see inline improvement markers.
+ */
+import { type ComponentScore, type DimensionSignals, type QualityScoreConfig, type RegressionAlert, type ReleaseGateResult, type RiskTier, type ScoreHistoryEntry, type SignalUpdateEvent, type SystemBenchmark, type SystemScorecard, type ReleaseGateOptions } from './types.js';
+/**
+ * Truncate to 2 decimal places WITHOUT rounding up.
+ * Avi's QA standard: "never round up". Exported so tests can assert the
+ * breakdown reconstructs the score EXACTLY under the same truncation.
+ */
+export declare function truncate2(n: number): number;
+/**
+ * Derive a 0..1 code-quality dimension signal by REUSING the engine's
+ * `validateCodeQuality` (helpers/quality-gate.ts). 1.0 = clean; every error-severity
+ * violation subtracts `penaltyPerError`, warnings subtract less. Clamped to [0,1].
+ * This is genuine reuse of the engine gate helper — not a reimplementation — and is
+ * the recommended way to populate the code-quality lane of DimensionSignals.
+ */
+export declare function deriveCodeQualitySignal(sources: readonly {
+    readonly path: string;
+    readonly content: string;
+}[], options?: {
+    readonly penaltyPerError?: number;
+    readonly penaltyPerWarning?: number;
+}): number;
+/**
+ * Score one component from its dimension signals. Pure and deterministic.
+ *
+ * The composite score is a weighted average of available dimension signals,
+ * converted to 0..100. The risk-adjusted score applies the blast-radius
+ * multiplier (improvement #5). The breakdown lists every dimension's weighted
+ * contribution so the numbers can be independently verified (improvement #2).
+ */
+export declare function scoreComponent(componentId: string, riskTier: RiskTier, signals: DimensionSignals, config: QualityScoreConfig | undefined, scoredAt: string): ComponentScore;
+/**
+ * QualityScoreCalculator maintains a per-component score cache and a score
+ * history ring. It is driven by `SignalUpdateEvent`s — only the affected
+ * component is re-scored (improvement #1 — incremental recomputation).
+ */
+export declare class QualityScoreCalculator {
+    private readonly config;
+    private readonly now;
+    /**
+     * Primary cache: componentId → latest ComponentScore.
+     * Improvement #1 — sub-scores cached; unchanged components never re-scored.
+     */
+    private readonly cache;
+    /**
+     * Score history per component for trend / regression analysis.
+     * Improvement #6, #7.
+     */
+    private readonly history;
+    constructor(config?: QualityScoreConfig);
+    /**
+     * Process a signal-update event. Re-scores only the named component, leaving
+     * all other cached scores untouched. Returns any regression alert if one fired.
+     * Improvement #1 — incremental recomputation / event-driven.
+     */
+    update(event: SignalUpdateEvent): {
+        score: ComponentScore;
+        alert: RegressionAlert | null;
+    };
+    /**
+     * Process multiple signal-update events in one call. Returns all scores and
+     * any regression alerts that fired. Components not in the event list are
+     * untouched in the cache (incremental, improvement #1).
+     */
+    updateBatch(events: readonly SignalUpdateEvent[]): {
+        scores: ComponentScore[];
+        alerts: RegressionAlert[];
+    };
+    /** Return the cached score for a component, or undefined if not yet scored. */
+    getScore(componentId: string): ComponentScore | undefined;
+    /** All currently-cached component scores. */
+    getAllScores(): readonly ComponentScore[];
+    /** Score history for a component (oldest first). */
+    getHistory(componentId: string): readonly ScoreHistoryEntry[];
+    /**
+     * Evaluate whether the system can release — FAIL-CLOSED. A component blocks the
+     * gate when it is unscored, low-confidence (thin data can't certify), gamed
+     * (untrustworthy score), or its risk-adjusted score is below the threshold.
+     *
+     * When `options.phaseGate` is supplied this REUSES the engine's `evaluateGate`
+     * (core/phase-gate.ts): a failed engine phase gate blocks the release too.
+     */
+    evaluateReleaseGate(options?: ReleaseGateOptions): ReleaseGateResult;
+    /**
+     * Compute the system-level benchmark: median risk-adjusted score and which
+     * components fall below it. Improvement #7.
+     */
+    computeBenchmark(): SystemBenchmark;
+    /**
+     * Returns progress toward each configured target as a 0..1 ratio (clamped).
+     * Improvement #8 — per-component target score + progress.
+     */
+    getTargetProgress(): ReadonlyMap<string, number>;
+    /**
+     * Generate a complete system quality scorecard. Bundles all cached scores,
+     * the benchmark, any open regression alerts from the last update cycle, and
+     * the release gate result.
+     */
+    generateScorecard(pendingAlerts?: readonly RegressionAlert[], componentIds?: readonly string[]): SystemScorecard;
+    private appendHistory;
+    /**
+     * Regression detection: fires if riskAdjustedScore dropped more than the
+     * configured threshold vs the previous snapshot. Improvement #6.
+     */
+    private detectRegression;
+}
+//# sourceMappingURL=calculator.d.ts.map

package/dist/core/quality-score/calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculator.d.ts","sourceRoot":"","sources":["../../../core/quality-score/calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAGL,KAAK,cAAc,EAInB,KAAK,gBAAgB,EAGrB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,eAAe,EAEpB,KAAK,kBAAkB,EACxB,MAAM,SAAS,CAAC;AA+CjB;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3C;AAOD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,EACvE,OAAO,GAAE;IAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GACvF,MAAM,CAUR;AAqFD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,kBAAkB,YAAK,EAC/B,QAAQ,EAAE,MAAM,GACf,cAAc,CA+EhB;AAMD;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAQ4E;IAEnG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IAEnC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAE3D;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;gBAEtD,MAAM,GAAE,kBAAuB;IAkB3C;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;KAAE;IAkC1F;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,GAAG;QACjD,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,MAAM,EAAE,eAAe,EAAE,CAAC;KAC3B;IAeD,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIzD,6CAA6C;IAC7C,YAAY,IAAI,SAAS,cAAc,EAAE;IAIzC,oDAAoD;IACpD,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,iBAAiB,EAAE;IAQ7D;;;;;;;OAOG;IACH,mBAAmB,CAAC,OAAO,GAAE,kBAAuB,GAAG,iBAAiB;IAmExE;;;OAGG;IACH,gBAAgB,IAAI,eAAe;IA4BnC;;;OAGG;IACH,iBAAiB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IAkBhD;;;;OAIG;IACH,iBAAiB,CACf,aAAa,GAAE,SAAS,eAAe,EAAO,EAC9C,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAC/B,eAAe;IAqBlB,OAAO,CAAC,aAAa;IAWrB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CAiBzB"}

package/dist/core/quality-score/calculator.js

@@ -0,0 +1,489 @@
+/**
+ * QualityScoreCalculator (#14 — "The Judge").
+ *
+ * One honest, transparent health number for every component, feature, and the
+ * whole system. Composite, weighted, incremental, explainable. No black box;
+ * every number shows its math. No rounding-up. Deterministic given the same inputs.
+ *
+ * Genuine engine reuse (spec-locked):
+ *  - `validateCodeQuality` (helpers/quality-gate.ts) backs `deriveCodeQualitySignal`,
+ *    turning real source-quality violations into a code-quality dimension signal.
+ *  - `evaluateGate` (core/phase-gate.ts) is folded into `evaluateReleaseGate` when
+ *    phase-gate inputs are supplied — a failed engine phase gate blocks the release.
+ *
+ * The release gate is FAIL-CLOSED: unscored, low-confidence, or gamed components
+ * block a release rather than slipping through.
+ *
+ * Spec: blueprint/agents/14-quality-score-calculator.md
+ * All 10 improvements are implemented — see inline improvement markers.
+ */
+import { DEFAULT_WEIGHTS, RISK_MULTIPLIERS, } from './types.js';
+import { evaluateGate } from '../phase-gate.js';
+import { validateCodeQuality } from '../../helpers/quality-gate.js';
+// ---------------------------------------------------------------------------
+// Internal constants
+// ---------------------------------------------------------------------------
+const ALL_DIMENSIONS = [
+    'passRate',
+    'coverage',
+    'security',
+    'performance',
+    'accessibility',
+    'dataIntegrity',
+    'ux',
+    'docCoverage',
+    'reliability',
+];
+/** Dimensions that count as "leading" (predictive) signals — improvement #9. */
+const LEADING_DIMENSIONS = new Set([
+    'coverage',
+    'dataIntegrity',
+    'docCoverage',
+]);
+/**
+ * Minimum assertions-per-test ratio. Below this threshold with high coverage
+ * the gameability guard fires — improvement #10.
+ */
+const DEFAULT_GAMEABILITY_THRESHOLD = 0.5;
+/** Default sample count needed for `high` confidence — improvement #4. */
+const DEFAULT_MIN_SAMPLES = 30;
+/** Default regression alert threshold (score points) — improvement #6. */
+const DEFAULT_REGRESSION_THRESHOLD = 5;
+/** Default release-gate threshold — improvement (escalation policy). */
+const DEFAULT_RELEASE_GATE_THRESHOLD = 60;
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Truncate to 2 decimal places WITHOUT rounding up.
+ * Avi's QA standard: "never round up". Exported so tests can assert the
+ * breakdown reconstructs the score EXACTLY under the same truncation.
+ */
+export function truncate2(n) {
+    return Math.trunc(n * 100) / 100;
+}
+/** Clamp to [0, 1]. */
+function clamp01(n) {
+    return Math.max(0, Math.min(1, n));
+}
+/**
+ * Derive a 0..1 code-quality dimension signal by REUSING the engine's
+ * `validateCodeQuality` (helpers/quality-gate.ts). 1.0 = clean; every error-severity
+ * violation subtracts `penaltyPerError`, warnings subtract less. Clamped to [0,1].
+ * This is genuine reuse of the engine gate helper — not a reimplementation — and is
+ * the recommended way to populate the code-quality lane of DimensionSignals.
+ */
+export function deriveCodeQualitySignal(sources, options = {}) {
+    const penaltyPerError = options.penaltyPerError ?? 0.1;
+    const penaltyPerWarning = options.penaltyPerWarning ?? 0.02;
+    let penalty = 0;
+    for (const src of sources) {
+        for (const v of validateCodeQuality(src.content, src.path)) {
+            penalty += v.severity === 'error' ? penaltyPerError : penaltyPerWarning;
+        }
+    }
+    return clamp01(1 - penalty);
+}
+/**
+ * Build the full dimension-weight record by merging caller-supplied overrides
+ * into the defaults, then return only the dimensions that have available signals.
+ */
+function resolveWeights(overrides, presentDimensions) {
+    const weights = new Map();
+    for (const dim of ALL_DIMENSIONS) {
+        if (!presentDimensions.has(dim))
+            continue;
+        const w = overrides?.[dim] ?? DEFAULT_WEIGHTS[dim];
+        weights.set(dim, w);
+    }
+    return weights;
+}
+/**
+ * Derive a confidence level from sample count and signal completeness.
+ * Improvement #4 — confidence interval / thin-data flag.
+ */
+function deriveConfidence(sampleCount, missingCount, minSamples) {
+    const available = sampleCount ?? 0;
+    const half = minSamples / 2;
+    if (available < half || missingCount >= ALL_DIMENSIONS.length / 2)
+        return 'low';
+    if (available < minSamples || missingCount > 0)
+        return 'medium';
+    return 'high';
+}
+/**
+ * Compute the leading and lagging sub-scores from a breakdown.
+ * Improvement #9 — leading-vs-lagging split.
+ * Both scores are 0..100, normalised within their own dimension sets.
+ */
+function splitLeadingLagging(breakdown, weights) {
+    let leadingW = 0;
+    let leadingWS = 0;
+    let laggingW = 0;
+    let laggingWS = 0;
+    for (const c of breakdown) {
+        const w = weights.get(c.dimension) ?? 0;
+        if (LEADING_DIMENSIONS.has(c.dimension)) {
+            leadingW += w;
+            leadingWS += c.rawSignal * w;
+        }
+        else {
+            laggingW += w;
+            laggingWS += c.rawSignal * w;
+        }
+    }
+    const leadingScore = leadingW > 0 ? truncate2((leadingWS / leadingW) * 100) : 0;
+    const laggingScore = laggingW > 0 ? truncate2((laggingWS / laggingW) * 100) : 0;
+    return { leadingScore, laggingScore };
+}
+/**
+ * Compute the gameability warning flag.
+ * Fires when coverage is above 50 % but assertionDensity is suspiciously low.
+ * Improvement #10 — gameability guard.
+ */
+function detectGameability(signals, densityThreshold) {
+    const coverage = signals.coverage ?? 0;
+    const density = signals.assertionDensity;
+    if (coverage < 0.5)
+        return false; // low coverage — guard irrelevant
+    if (density === undefined)
+        return false; // no density data — cannot judge
+    return density < densityThreshold;
+}
+// ---------------------------------------------------------------------------
+// Core pure-function: score a single component
+// ---------------------------------------------------------------------------
+/**
+ * Score one component from its dimension signals. Pure and deterministic.
+ *
+ * The composite score is a weighted average of available dimension signals,
+ * converted to 0..100. The risk-adjusted score applies the blast-radius
+ * multiplier (improvement #5). The breakdown lists every dimension's weighted
+ * contribution so the numbers can be independently verified (improvement #2).
+ */
+export function scoreComponent(componentId, riskTier, signals, config = {}, scoredAt) {
+    const minSamples = config.minSamplesForHighConfidence ?? DEFAULT_MIN_SAMPLES;
+    const densityThreshold = config.gameabilityDensityThreshold ?? DEFAULT_GAMEABILITY_THRESHOLD;
+    // --- Identify present dimensions in a SINGLE pass (no unsafe cast). ---
+    // DimensionSignals keys are all `number | undefined`, so signals[dim] is safely
+    // typed without a cast; keep only finite numeric signals, clamped to 0..1.
+    const presentSignals = new Map();
+    const missingDimensions = [];
+    for (const dim of ALL_DIMENSIONS) {
+        const v = signals[dim];
+        if (typeof v === 'number' && isFinite(v)) {
+            presentSignals.set(dim, clamp01(v));
+        }
+        else {
+            missingDimensions.push(dim);
+        }
+    }
+    // --- Resolve and normalise weights ---
+    const presentDimensions = new Set(presentSignals.keys());
+    const rawWeights = resolveWeights(config.weights, presentDimensions);
+    let totalWeight = 0;
+    for (const w of rawWeights.values())
+        totalWeight += w;
+    // Degenerate all-zero weights over present signals → the score is meaningless;
+    // surface it as low-confidence (#6 guard) rather than silently scoring 0.
+    const degenerateWeights = presentSignals.size > 0 && totalWeight === 0;
+    const useWeight = totalWeight > 0 ? totalWeight : 1;
+    // --- Build per-dimension contributions (breakdown SUMS exactly to the score). ---
+    const breakdown = [];
+    let weightedSum = 0;
+    for (const [dim, rawSignal] of presentSignals) {
+        const w = rawWeights.get(dim) ?? 0;
+        const normalisedWeight = w / useWeight;
+        const weightedContribution = rawSignal * normalisedWeight;
+        weightedSum += weightedContribution;
+        breakdown.push({
+            dimension: dim,
+            rawSignal,
+            weight: normalisedWeight,
+            weightedContribution,
+        });
+    }
+    // --- Composite score 0..100 (never rounded up) ---
+    const score = truncate2(weightedSum * 100);
+    // --- Risk-adjusted score (improvement #5) ---
+    const multiplier = RISK_MULTIPLIERS[riskTier];
+    const riskAdjustedScore = truncate2(score * multiplier);
+    // --- Confidence (improvement #4); degenerate weights force low-confidence. ---
+    const confidence = degenerateWeights
+        ? 'low'
+        : deriveConfidence(signals.sampleCount, missingDimensions.length, minSamples);
+    // --- Leading / lagging split (improvement #9) ---
+    const { leadingScore, laggingScore } = splitLeadingLagging(breakdown, rawWeights);
+    // --- Gameability guard (improvement #10) ---
+    const gameabilityWarning = detectGameability(signals, densityThreshold);
+    return {
+        componentId,
+        score,
+        riskAdjustedScore,
+        riskTier,
+        confidence,
+        breakdown,
+        missingDimensions,
+        scoredAt,
+        leadingScore,
+        laggingScore,
+        gameabilityWarning,
+    };
+}
+// ---------------------------------------------------------------------------
+// Calculator class — incremental, cached, event-driven
+// ---------------------------------------------------------------------------
+/**
+ * QualityScoreCalculator maintains a per-component score cache and a score
+ * history ring. It is driven by `SignalUpdateEvent`s — only the affected
+ * component is re-scored (improvement #1 — incremental recomputation).
+ */
+export class QualityScoreCalculator {
+    config;
+    now;
+    /**
+     * Primary cache: componentId → latest ComponentScore.
+     * Improvement #1 — sub-scores cached; unchanged components never re-scored.
+     */
+    cache = new Map();
+    /**
+     * Score history per component for trend / regression analysis.
+     * Improvement #6, #7.
+     */
+    history = new Map();
+    constructor(config = {}) {
+        this.config = {
+            weights: config.weights,
+            regressionThreshold: config.regressionThreshold ?? DEFAULT_REGRESSION_THRESHOLD,
+            minSamplesForHighConfidence: config.minSamplesForHighConfidence ?? DEFAULT_MIN_SAMPLES,
+            gameabilityDensityThreshold: config.gameabilityDensityThreshold ?? DEFAULT_GAMEABILITY_THRESHOLD,
+            releaseGateThreshold: config.releaseGateThreshold ?? DEFAULT_RELEASE_GATE_THRESHOLD,
+            targets: config.targets ?? [],
+        };
+        this.now = config.clock ?? (() => Date.now());
+    }
+    // -------------------------------------------------------------------------
+    // Incremental update (improvement #1)
+    // -------------------------------------------------------------------------
+    /**
+     * Process a signal-update event. Re-scores only the named component, leaving
+     * all other cached scores untouched. Returns any regression alert if one fired.
+     * Improvement #1 — incremental recomputation / event-driven.
+     */
+    update(event) {
+        const scoredAt = new Date(this.now()).toISOString();
+        const previous = this.cache.get(event.componentId);
+        const score = scoreComponent(event.componentId, event.riskTier, event.signals, {
+            weights: this.config.weights,
+            regressionThreshold: this.config.regressionThreshold,
+            minSamplesForHighConfidence: this.config.minSamplesForHighConfidence,
+            gameabilityDensityThreshold: this.config.gameabilityDensityThreshold,
+            releaseGateThreshold: this.config.releaseGateThreshold,
+            targets: this.config.targets,
+            clock: this.now,
+        }, scoredAt);
+        // Store in cache and history
+        this.cache.set(event.componentId, score);
+        this.appendHistory(score);
+        // Regression detection (improvement #6)
+        const alert = this.detectRegression(previous, score, scoredAt);
+        return { score, alert };
+    }
+    // -------------------------------------------------------------------------
+    // Batch update — convenience wrapper
+    // -------------------------------------------------------------------------
+    /**
+     * Process multiple signal-update events in one call. Returns all scores and
+     * any regression alerts that fired. Components not in the event list are
+     * untouched in the cache (incremental, improvement #1).
+     */
+    updateBatch(events) {
+        const scores = [];
+        const alerts = [];
+        for (const event of events) {
+            const { score, alert } = this.update(event);
+            scores.push(score);
+            if (alert !== null)
+                alerts.push(alert);
+        }
+        return { scores, alerts };
+    }
+    // -------------------------------------------------------------------------
+    // Read access to cached scores
+    // -------------------------------------------------------------------------
+    /** Return the cached score for a component, or undefined if not yet scored. */
+    getScore(componentId) {
+        return this.cache.get(componentId);
+    }
+    /** All currently-cached component scores. */
+    getAllScores() {
+        return [...this.cache.values()];
+    }
+    /** Score history for a component (oldest first). */
+    getHistory(componentId) {
+        return this.history.get(componentId) ?? [];
+    }
+    // -------------------------------------------------------------------------
+    // Release gate (escalation policy)
+    // -------------------------------------------------------------------------
+    /**
+     * Evaluate whether the system can release — FAIL-CLOSED. A component blocks the
+     * gate when it is unscored, low-confidence (thin data can't certify), gamed
+     * (untrustworthy score), or its risk-adjusted score is below the threshold.
+     *
+     * When `options.phaseGate` is supplied this REUSES the engine's `evaluateGate`
+     * (core/phase-gate.ts): a failed engine phase gate blocks the release too.
+     */
+    evaluateReleaseGate(options = {}) {
+        const threshold = this.config.releaseGateThreshold;
+        const evaluatedAt = new Date(this.now()).toISOString();
+        const ids = options.componentIds ?? [...this.cache.keys()];
+        const blocking = [];
+        // --- Reuse the engine phase gate: a failed phase gate blocks the release. ---
+        if (options.phaseGate !== undefined) {
+            const pg = options.phaseGate;
+            const gateResult = evaluateGate(pg.phase, pg.classification, pg.results, pg.disabledAgents ?? new Set(), pg.scheduledAgents ?? new Set());
+            // evaluateGate defines passed === (failedBlockingAgents.length === 0): every failed
+            // blocking agent blocks the release. When the phase gate passes this loop is a no-op.
+            for (const agentId of gateResult.failedBlockingAgents) {
+                blocking.push({ componentId: `phase-gate:agent-${agentId}`, reason: 'phase-gate-failed' });
+            }
+        }
+        // --- Score-based, fail-closed component checks. ---
+        for (const id of ids) {
+            const score = this.cache.get(id);
+            if (score === undefined) {
+                blocking.push({ componentId: id, reason: 'unscored' }); // unknown = unsafe
+                continue;
+            }
+            if (score.confidence === 'low') {
+                blocking.push({
+                    componentId: id,
+                    reason: 'low-confidence',
+                    riskAdjustedScore: score.riskAdjustedScore,
+                });
+                continue;
+            }
+            if (score.gameabilityWarning) {
+                blocking.push({
+                    componentId: id,
+                    reason: 'gameability',
+                    riskAdjustedScore: score.riskAdjustedScore,
+                });
+                continue;
+            }
+            if (score.riskAdjustedScore < threshold) {
+                blocking.push({
+                    componentId: id,
+                    reason: 'below-threshold',
+                    riskAdjustedScore: score.riskAdjustedScore,
+                });
+            }
+        }
+        return {
+            canRelease: blocking.length === 0,
+            blockingComponents: blocking,
+            threshold,
+            evaluatedAt,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // System benchmark (improvement #7 — relative benchmarking)
+    // -------------------------------------------------------------------------
+    /**
+     * Compute the system-level benchmark: median risk-adjusted score and which
+     * components fall below it. Improvement #7.
+     */
+    computeBenchmark() {
+        const scores = [...this.cache.values()];
+        const computedAt = new Date(this.now()).toISOString();
+        if (scores.length === 0) {
+            return { medianScore: 0, belowMedian: [], computedAt };
+        }
+        const sorted = [...scores].sort((a, b) => a.riskAdjustedScore - b.riskAdjustedScore);
+        const mid = Math.floor(sorted.length / 2);
+        const medianScore = sorted.length % 2 === 0
+            ? truncate2((sorted[mid - 1].riskAdjustedScore + sorted[mid].riskAdjustedScore) / 2)
+            : (sorted[mid].riskAdjustedScore);
+        const belowMedian = sorted
+            .filter((s) => s.riskAdjustedScore < medianScore)
+            .map((s) => s.componentId);
+        return { medianScore, belowMedian, computedAt };
+    }
+    // -------------------------------------------------------------------------
+    // Target progress (improvement #8)
+    // -------------------------------------------------------------------------
+    /**
+     * Returns progress toward each configured target as a 0..1 ratio (clamped).
+     * Improvement #8 — per-component target score + progress.
+     */
+    getTargetProgress() {
+        const result = new Map();
+        for (const target of this.config.targets) {
+            const score = this.cache.get(target.componentId);
+            if (score === undefined) {
+                result.set(target.componentId, 0);
+                continue;
+            }
+            const progress = clamp01(score.riskAdjustedScore / target.targetScore);
+            result.set(target.componentId, truncate2(progress));
+        }
+        return result;
+    }
+    // -------------------------------------------------------------------------
+    // Full system scorecard
+    // -------------------------------------------------------------------------
+    /**
+     * Generate a complete system quality scorecard. Bundles all cached scores,
+     * the benchmark, any open regression alerts from the last update cycle, and
+     * the release gate result.
+     */
+    generateScorecard(pendingAlerts = [], componentIds) {
+        const componentScores = componentIds
+            ? componentIds.flatMap((id) => {
+                const s = this.cache.get(id);
+                return s !== undefined ? [s] : [];
+            })
+            : [...this.cache.values()];
+        return {
+            componentScores,
+            benchmark: this.computeBenchmark(),
+            regressionAlerts: pendingAlerts,
+            releaseGate: this.evaluateReleaseGate({ componentIds }),
+            generatedAt: new Date(this.now()).toISOString(),
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    appendHistory(score) {
+        const entries = this.history.get(score.componentId) ?? [];
+        entries.push({
+            componentId: score.componentId,
+            score: score.score,
+            riskAdjustedScore: score.riskAdjustedScore,
+            scoredAt: score.scoredAt,
+        });
+        this.history.set(score.componentId, entries);
+    }
+    /**
+     * Regression detection: fires if riskAdjustedScore dropped more than the
+     * configured threshold vs the previous snapshot. Improvement #6.
+     */
+    detectRegression(previous, current, detectedAt) {
+        if (previous === undefined)
+            return null;
+        const drop = previous.riskAdjustedScore - current.riskAdjustedScore;
+        if (drop <= this.config.regressionThreshold)
+            return null;
+        return {
+            componentId: current.componentId,
+            previousScore: previous.riskAdjustedScore,
+            currentScore: current.riskAdjustedScore,
+            drop: truncate2(drop),
+            threshold: this.config.regressionThreshold,
+            detectedAt,
+        };
+    }
+}
+//# sourceMappingURL=calculator.js.map

package/dist/core/quality-score/calculator.js.map

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

package/dist/core/quality-score/from-run.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Derive a QualityScore for a completed run from its agent results.
+ *
+ * The calculator (`QualityScoreCalculator`, "The Judge") is signal-driven: it
+ * aggregates per-dimension 0..1 signals. This adapter maps a run's agent
+ * outcomes onto the documented dimension→source-agent mapping in `types.ts`
+ * (passRate, security←#7, accessibility←#8, performance←#13, dataIntegrity←#14,
+ * ux←#12, docCoverage←#17). Dimensions whose source agent did not run are left
+ * `undefined` — which HONESTLY lowers the confidence level rather than inventing
+ * a number. Consumers must surface that confidence; a `low` confidence blocks the
+ * release gate (fail-closed) by design.
+ *
+ * This is a faithful, transparent projection of THIS run's outcomes — not an
+ * absolute code-quality measure.
+ */
+import type { AgentResult } from '../types.js';
+import type { ComponentScore, ReleaseGateResult } from './types.js';
+export interface RunQuality {
+    score: ComponentScore;
+    gate: ReleaseGateResult;
+}
+/**
+ * Project a run's agent results into a QualityScore + release-gate verdict.
+ * Returns null for an empty run (nothing to score).
+ */
+export declare function deriveRunQuality(agents: readonly AgentResult[]): RunQuality | null;
+//# sourceMappingURL=from-run.d.ts.map