pi-smart-router 0.2.0 → 0.4.0

package/dist/domain/routing/isotonic-calibrator.js

@@ -0,0 +1,187 @@
+/**
+ * Online isotonic P(success) calibrator for low_intensity gate (SP-133).
+ *
+ * Loads monotonic knot tables from routing-calibration bundle at serve time.
+ * O(log n) binary search lookup with <5ms budget; falls back to raw logistic
+ * when the artifact is missing or under-trained.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { z } from 'zod';
+import { MIN_TRAINING_SAMPLES } from './p-success-classifier.js';
+export const ISOTONIC_CALIBRATOR_ARTIFACT_VERSION = 1;
+export const ISOTONIC_LOOKUP_BUDGET_MS = 5;
+export const DEFAULT_ROUTING_CALIBRATION_PATH = resolve('config', 'routing-calibration.json');
+export class IsotonicCalibratorLoaderError extends Error {
+    name = 'IsotonicCalibratorLoaderError';
+    constructor(message, options) {
+        super(message, options);
+    }
+}
+const IsotonicCalibratorArtifactSchema = z.object({
+    version: z.literal(ISOTONIC_CALIBRATOR_ARTIFACT_VERSION),
+    min_training_samples: z.number().int().min(0),
+    x_knots: z.array(z.number().finite().min(0).max(1)).min(2),
+    y_knots: z.array(z.number().finite().min(0).max(1)).min(2),
+    trained_sample_count: z.number().int().min(0),
+    holdout_ece_raw: z.number().finite().min(0).max(1).nullable(),
+    holdout_ece_calibrated: z.number().finite().min(0).max(1).nullable(),
+});
+function clamp01(value) {
+    if (value <= 0)
+        return 0;
+    if (value >= 1)
+        return 1;
+    return value;
+}
+function formatZodIssues(error) {
+    return error.issues
+        .map((issue) => `  - ${issue.path.join('.')}: ${issue.message}`)
+        .join('\n');
+}
+/** True when artifact has enough labeled samples for serve-time calibration. */
+export function isIsotonicCalibratorTrained(artifact) {
+    return artifact.trained_sample_count >= artifact.min_training_samples;
+}
+export function createDefaultIsotonicCalibratorArtifact() {
+    return {
+        version: ISOTONIC_CALIBRATOR_ARTIFACT_VERSION,
+        min_training_samples: MIN_TRAINING_SAMPLES,
+        x_knots: [0, 1],
+        y_knots: [0, 1],
+        trained_sample_count: 0,
+        holdout_ece_raw: null,
+        holdout_ece_calibrated: null,
+    };
+}
+/** Piecewise-constant isotonic lookup with O(log n) binary search on knots. */
+export function applyIsotonicLookup(rawScore, xKnots, yKnots) {
+    if (xKnots.length === 0 || yKnots.length === 0 || xKnots.length !== yKnots.length) {
+        return clamp01(rawScore);
+    }
+    const score = clamp01(rawScore);
+    if (score <= xKnots[0]) {
+        return clamp01(yKnots[0]);
+    }
+    const lastIndex = xKnots.length - 1;
+    if (score >= xKnots[lastIndex]) {
+        return clamp01(yKnots[lastIndex]);
+    }
+    let low = 0;
+    let high = lastIndex;
+    while (low < high) {
+        const mid = Math.floor((low + high + 1) / 2);
+        if (xKnots[mid] <= score) {
+            low = mid;
+        }
+        else {
+            high = mid - 1;
+        }
+    }
+    return clamp01(yKnots[low]);
+}
+/**
+ * Apply isotonic calibration to a raw logistic P(success) score.
+ * Returns the raw score when the artifact is missing or under-trained.
+ */
+export function applyIsotonicCalibrator(rawScore, artifact) {
+    if (artifact === null || !isIsotonicCalibratorTrained(artifact)) {
+        return clamp01(rawScore);
+    }
+    return applyIsotonicLookup(rawScore, artifact.x_knots, artifact.y_knots);
+}
+/** Apply isotonic calibration with elapsed timing guard for the online routing budget. */
+export function applyIsotonicCalibratorTimed(rawScore, artifact, budgetMs = ISOTONIC_LOOKUP_BUDGET_MS) {
+    const start = performance.now();
+    const calibration_applied = artifact !== null && isIsotonicCalibratorTrained(artifact);
+    const calibrated = applyIsotonicCalibrator(rawScore, artifact);
+    const elapsed_ms = performance.now() - start;
+    if (elapsed_ms > budgetMs) {
+        console.warn('Isotonic P(success) lookup exceeded latency budget', {
+            elapsed_ms,
+            budget_ms: budgetMs,
+            knot_count: artifact?.x_knots.length ?? 0,
+        });
+    }
+    return {
+        calibrated,
+        elapsed_ms,
+        within_budget: elapsed_ms <= budgetMs,
+        calibration_applied,
+    };
+}
+/** Parse and validate an isotonic calibrator artifact from JSON text. */
+export function parseIsotonicCalibratorJson(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new IsotonicCalibratorLoaderError(`Failed to parse JSON: ${message}`, { cause: err });
+    }
+    const result = IsotonicCalibratorArtifactSchema.safeParse(parsed);
+    if (!result.success) {
+        throw new IsotonicCalibratorLoaderError(`Invalid isotonic calibrator artifact:\n${formatZodIssues(result.error)}`, { cause: result.error });
+    }
+    return result.data;
+}
+/** Extract isotonic_calibrator from a routing-calibration bundle object. */
+export function parseIsotonicCalibratorFromBundle(parsed) {
+    if (typeof parsed !== 'object' || parsed === null) {
+        throw new IsotonicCalibratorLoaderError('Routing calibration bundle must be a JSON object');
+    }
+    const isotonic = parsed.isotonic_calibrator;
+    if (isotonic === undefined) {
+        throw new IsotonicCalibratorLoaderError('Routing calibration bundle missing isotonic_calibrator');
+    }
+    const result = IsotonicCalibratorArtifactSchema.safeParse(isotonic);
+    if (!result.success) {
+        throw new IsotonicCalibratorLoaderError(`Invalid isotonic_calibrator in routing calibration bundle:\n${formatZodIssues(result.error)}`, { cause: result.error });
+    }
+    return result.data;
+}
+/**
+ * Load isotonic calibrator from routing-calibration bundle on disk.
+ * Returns null when the bundle file is missing.
+ */
+export function loadIsotonicCalibrator(options) {
+    const filePath = options?.filePath ?? DEFAULT_ROUTING_CALIBRATION_PATH;
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    let raw;
+    try {
+        raw = readFileSync(filePath, 'utf8');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new IsotonicCalibratorLoaderError(`Failed to read routing calibration file: ${message}`, {
+            cause: err,
+        });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new IsotonicCalibratorLoaderError(`Failed to parse routing calibration JSON: ${message}`, {
+            cause: err,
+        });
+    }
+    return parseIsotonicCalibratorFromBundle(parsed);
+}
+/** Resolve calibrator for online inference — missing or invalid artifacts fall back safely. */
+export function resolveIsotonicCalibrator(options) {
+    try {
+        return loadIsotonicCalibrator(options);
+    }
+    catch (err) {
+        console.warn('Isotonic calibrator artifact invalid; using raw logistic fallback', {
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return null;
+    }
+}
+//# sourceMappingURL=isotonic-calibrator.js.map

package/dist/domain/routing/isotonic-calibrator.js.map

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

package/dist/domain/routing/p-success-classifier.d.ts

@@ -11,10 +11,37 @@ import type { OutcomeSignalType, RoutingDatasetRecord, RoutingOutcomeRecord } fr
 export declare const MIN_TRAINING_SAMPLES = 30;
 /** Neutral probability when training data is insufficient or artifact missing. */
 export declare const NEUTRAL_P_SUCCESS = 0.5;
+/** Behavioral outcome signals that mark cheap-tier training failure (SP-062). */
+export declare const BEHAVIORAL_FAILURE_OUTCOME_SIGNALS: readonly OutcomeSignalType[];
+/** Verifier-grade failure proxies derived from privacy-safe telemetry scalars (SP-131). */
+export declare const VERIFIER_FAILURE_OUTCOME_SIGNALS: readonly ["tool_failure_chain", "stop_reason_invalid", "reprompt_detected", "high_edit_distance"];
+export type VerifierFailureOutcomeSignal = (typeof VERIFIER_FAILURE_OUTCOME_SIGNALS)[number];
+/** Execution telemetry failure signals (SP-104 review follow-up, SP-131). */
+export declare const EXECUTION_FAILURE_OUTCOME_SIGNALS: readonly ["provider_failover", "stop_reason_length", "infra_error"];
+export type ExecutionFailureOutcomeSignal = (typeof EXECUTION_FAILURE_OUTCOME_SIGNALS)[number];
+/** Union of all training label signals consumed by P(success) export and aggregate paths. */
+export type TrainingOutcomeSignal = OutcomeSignalType | VerifierFailureOutcomeSignal | ExecutionFailureOutcomeSignal;
 /** Outcome signals that mark a routing attempt as unsuccessful for cheap-tier training. */
-export declare const FAILURE_OUTCOME_SIGNALS: readonly OutcomeSignalType[];
-/** Outcome signals reserved for future execution telemetry (failover, length, infra). */
+export declare const FAILURE_OUTCOME_SIGNALS: readonly TrainingOutcomeSignal[];
+/** @deprecated Use EXECUTION_FAILURE_OUTCOME_SIGNALS */
 export declare const FUTURE_FAILURE_SIGNALS: readonly ["provider_failover", "stop_reason_length", "infra_error"];
+/** Privacy-safe scalar failure proxies exported in calibration contrib rows (SP-131). */
+export declare const P_SUCCESS_FAILURE_PROXY_FIELDS: readonly ["tool_failure_chain_count", "stop_reason_invalid", "reprompt_rate", "edit_distance_proxy"];
+export type PSuccessFailureProxyField = (typeof P_SUCCESS_FAILURE_PROXY_FIELDS)[number];
+export interface PSuccessFailureProxies {
+    readonly tool_failure_chain_count: number | null;
+    readonly stop_reason_invalid: boolean | null;
+    readonly reprompt_rate: number | null;
+    readonly edit_distance_proxy: number | null;
+}
+/** Minimum identical tool failures before labeling a tool-failure chain (loop escalation uses 3). */
+export declare const TOOL_FAILURE_CHAIN_LABEL_THRESHOLD = 2;
+/** Normalized re-prompt rate at or above this marks failure. */
+export declare const REPROMPT_RATE_FAILURE_THRESHOLD = 0.5;
+/** Normalized edit-distance proxy at or above this marks likely re-prompt / correction. */
+export declare const EDIT_DISTANCE_PROXY_FAILURE_THRESHOLD = 0.6;
+/** Provider stop reasons treated as invalid task completion for training labels. */
+export declare const INVALID_STOP_REASONS: Set<string>;
 export declare const P_SUCCESS_FEATURE_NAMES: readonly ["prompt_length_norm", "estimated_input_tokens_norm", "triage_cyclomatic_score", "requirement_reasoning", "requirement_code_gen", "requirement_tool_use", "has_tool_context", "compaction_flag", "routing_latency_norm", "economical_tier"];
 export type PSuccessFeatureName = (typeof P_SUCCESS_FEATURE_NAMES)[number];
 export interface PSuccessFeatures {
@@ -75,21 +102,40 @@ export interface LabeledTrainingSample {
     readonly request_id: string;
     readonly features: PSuccessFeatures;
     readonly success: boolean;
-    readonly outcome_signals: readonly OutcomeSignalType[];
+    readonly outcome_signals: readonly TrainingOutcomeSignal[];
+    readonly failure_proxies: PSuccessFailureProxies;
 }
 export interface DatasetExportJoinRow extends Record<string, unknown> {
     readonly request_id: string;
     readonly success_label: boolean | null;
-    readonly outcome_signals: readonly OutcomeSignalType[];
+    readonly outcome_signals: readonly TrainingOutcomeSignal[];
+    readonly tool_failure_chain_count: number | null;
+    readonly stop_reason_invalid: boolean | null;
+    readonly reprompt_rate: number | null;
+    readonly edit_distance_proxy: number | null;
 }
 /** Map a dataset row to a normalized feature vector for training or inference. */
 export declare function extractPSuccessFeatures(record: Pick<RoutingDatasetRecord, 'prompt_length_chars' | 'estimated_input_tokens' | 'triage_cyclomatic_score' | 'requirement_reasoning' | 'requirement_code_gen' | 'requirement_tool_use' | 'has_tool_context' | 'compaction_flag' | 'routing_latency_ms' | 'tier'>): PSuccessFeatures;
 export declare function featuresToVector(features: PSuccessFeatures): number[];
-/** Derive success label from outcome signals keyed to a request. */
-export declare function deriveSuccessLabel(outcomes: readonly RoutingOutcomeRecord[]): {
+/** Extract privacy-safe failure proxy scalars from a contrib or export row. */
+export declare function extractFailureProxies(record: Record<string, unknown>): PSuccessFailureProxies;
+/** Map failure proxy scalars to verifier-grade training outcome signals. */
+export declare function deriveVerifierFailureSignals(proxies: PSuccessFailureProxies): readonly VerifierFailureOutcomeSignal[];
+/** Derive success label from behavioral outcomes plus optional failure proxies. */
+export declare function deriveSuccessLabel(outcomes: readonly RoutingOutcomeRecord[], options?: {
+    readonly failureProxies?: PSuccessFailureProxies;
+}): {
+    success: boolean | null;
+    outcome_signals: readonly TrainingOutcomeSignal[];
+};
+/** Derive training labels from a privacy-safe export/contrib row (no prompt text). */
+export declare function deriveSuccessLabelFromExportRow(record: Record<string, unknown>): {
     success: boolean | null;
-    outcome_signals: readonly OutcomeSignalType[];
+    outcome_signals: readonly TrainingOutcomeSignal[];
+    failure_proxies: PSuccessFailureProxies;
 };
+/** Attach normalized failure proxy fields for calibration export rows. */
+export declare function attachFailureProxiesToExport(exportRecord: Record<string, unknown>): Record<string, unknown>;
 /** Group outcomes by request_id for export joins. */
 export declare function indexOutcomesByRequestId(outcomes: readonly RoutingOutcomeRecord[]): Map<string, RoutingOutcomeRecord[]>;
 /** Join dataset rows with outcome labels for training export. */

package/dist/domain/routing/p-success-classifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"p-success-classifier.d.ts","sourceRoot":"","sources":["../../../src/domain/routing/p-success-classifier.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"p-success-classifier.d.ts","sourceRoot":"","sources":["../../../src/domain/routing/p-success-classifier.ts"],"names":[],"mappings":"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"}

package/dist/domain/routing/p-success-classifier.js

@@ -11,17 +11,56 @@ import { z } from 'zod';
 export const MIN_TRAINING_SAMPLES = 30;
 /** Neutral probability when training data is insufficient or artifact missing. */
 export const NEUTRAL_P_SUCCESS = 0.5;
-/** Outcome signals that mark a routing attempt as unsuccessful for cheap-tier training. */
-export const FAILURE_OUTCOME_SIGNALS = [
+/** Behavioral outcome signals that mark cheap-tier training failure (SP-062). */
+export const BEHAVIORAL_FAILURE_OUTCOME_SIGNALS = [
     'model_override',
     'feedback_bad',
 ];
-/** Outcome signals reserved for future execution telemetry (failover, length, infra). */
-export const FUTURE_FAILURE_SIGNALS = [
+/** Verifier-grade failure proxies derived from privacy-safe telemetry scalars (SP-131). */
+export const VERIFIER_FAILURE_OUTCOME_SIGNALS = [
+    'tool_failure_chain',
+    'stop_reason_invalid',
+    'reprompt_detected',
+    'high_edit_distance',
+];
+/** Execution telemetry failure signals (SP-104 review follow-up, SP-131). */
+export const EXECUTION_FAILURE_OUTCOME_SIGNALS = [
     'provider_failover',
     'stop_reason_length',
     'infra_error',
 ];
+/** Outcome signals that mark a routing attempt as unsuccessful for cheap-tier training. */
+export const FAILURE_OUTCOME_SIGNALS = [
+    ...BEHAVIORAL_FAILURE_OUTCOME_SIGNALS,
+    ...VERIFIER_FAILURE_OUTCOME_SIGNALS,
+    ...EXECUTION_FAILURE_OUTCOME_SIGNALS,
+];
+/** @deprecated Use EXECUTION_FAILURE_OUTCOME_SIGNALS */
+export const FUTURE_FAILURE_SIGNALS = EXECUTION_FAILURE_OUTCOME_SIGNALS;
+/** Privacy-safe scalar failure proxies exported in calibration contrib rows (SP-131). */
+export const P_SUCCESS_FAILURE_PROXY_FIELDS = [
+    'tool_failure_chain_count',
+    'stop_reason_invalid',
+    'reprompt_rate',
+    'edit_distance_proxy',
+];
+/** Minimum identical tool failures before labeling a tool-failure chain (loop escalation uses 3). */
+export const TOOL_FAILURE_CHAIN_LABEL_THRESHOLD = 2;
+/** Normalized re-prompt rate at or above this marks failure. */
+export const REPROMPT_RATE_FAILURE_THRESHOLD = 0.5;
+/** Normalized edit-distance proxy at or above this marks likely re-prompt / correction. */
+export const EDIT_DISTANCE_PROXY_FAILURE_THRESHOLD = 0.6;
+const PROMPT_LENGTH_NORM_FOR_EDIT_PROXY = 8_000;
+/** Provider stop reasons treated as invalid task completion for training labels. */
+export const INVALID_STOP_REASONS = new Set([
+    'length',
+    'max_tokens',
+    'content_filter',
+    'tool_calls',
+    'function_call',
+    'unknown',
+    'error',
+]);
 export const P_SUCCESS_FEATURE_NAMES = [
     'prompt_length_norm',
     'estimated_input_tokens_norm',
@@ -94,9 +133,118 @@ export function extractPSuccessFeatures(record) {
 export function featuresToVector(features) {
     return P_SUCCESS_FEATURE_NAMES.map((name) => features[name]);
 }
-/** Derive success label from outcome signals keyed to a request. */
-export function deriveSuccessLabel(outcomes) {
-    const signals = [...new Set(outcomes.map((entry) => entry.signal_type))];
+function isTrainingOutcomeSignal(value) {
+    return (BEHAVIORAL_FAILURE_OUTCOME_SIGNALS.includes(value) ||
+        VERIFIER_FAILURE_OUTCOME_SIGNALS.includes(value) ||
+        EXECUTION_FAILURE_OUTCOME_SIGNALS.includes(value) ||
+        value === 'compaction_pin_break' ||
+        value === 'feedback_good');
+}
+function intOrNull(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? Math.max(0, Math.trunc(value)) : null;
+}
+function boolOrNull(value) {
+    return typeof value === 'boolean' ? value : null;
+}
+function rateOrNull(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        return null;
+    }
+    return clamp01(value);
+}
+function normalizeStopReasonInvalid(record) {
+    const explicit = boolOrNull(record.stop_reason_invalid);
+    if (explicit !== null) {
+        return explicit;
+    }
+    const stopReason = record.stop_reason;
+    if (typeof stopReason !== 'string' || stopReason.length === 0) {
+        return null;
+    }
+    return INVALID_STOP_REASONS.has(stopReason.toLowerCase());
+}
+function normalizeRepromptRate(record) {
+    const explicit = rateOrNull(record.reprompt_rate);
+    if (explicit !== null) {
+        return explicit;
+    }
+    const repromptCount = intOrNull(record.reprompt_count);
+    if (repromptCount === null) {
+        return null;
+    }
+    const turnIndex = intOrNull(record.turn_index_in_session);
+    const denominator = turnIndex !== null && turnIndex > 0 ? turnIndex : repromptCount + 1;
+    return clamp01(repromptCount / denominator);
+}
+function normalizeEditDistanceProxy(record) {
+    const explicit = rateOrNull(record.edit_distance_proxy);
+    if (explicit !== null) {
+        return explicit;
+    }
+    const delta = intOrNull(record.prompt_length_delta);
+    if (delta !== null) {
+        return clamp01(Math.abs(delta) / PROMPT_LENGTH_NORM_FOR_EDIT_PROXY);
+    }
+    const current = intOrNull(record.prompt_length_chars);
+    const prior = intOrNull(record.prior_prompt_length_chars);
+    if (current === null || prior === null) {
+        return null;
+    }
+    const maxLength = Math.max(current, prior, 1);
+    return clamp01(Math.abs(current - prior) / maxLength);
+}
+function normalizeToolFailureChainCount(record) {
+    const explicit = intOrNull(record.tool_failure_chain_count);
+    if (explicit !== null) {
+        return explicit;
+    }
+    return intOrNull(record.consecutive_tool_failures);
+}
+/** Extract privacy-safe failure proxy scalars from a contrib or export row. */
+export function extractFailureProxies(record) {
+    return {
+        tool_failure_chain_count: normalizeToolFailureChainCount(record),
+        stop_reason_invalid: normalizeStopReasonInvalid(record),
+        reprompt_rate: normalizeRepromptRate(record),
+        edit_distance_proxy: normalizeEditDistanceProxy(record),
+    };
+}
+/** Map failure proxy scalars to verifier-grade training outcome signals. */
+export function deriveVerifierFailureSignals(proxies) {
+    const signals = [];
+    if (proxies.tool_failure_chain_count !== null &&
+        proxies.tool_failure_chain_count >= TOOL_FAILURE_CHAIN_LABEL_THRESHOLD) {
+        signals.push('tool_failure_chain');
+    }
+    if (proxies.stop_reason_invalid === true) {
+        signals.push('stop_reason_invalid');
+    }
+    if (proxies.reprompt_rate !== null &&
+        proxies.reprompt_rate >= REPROMPT_RATE_FAILURE_THRESHOLD) {
+        signals.push('reprompt_detected');
+    }
+    if (proxies.edit_distance_proxy !== null &&
+        proxies.edit_distance_proxy >= EDIT_DISTANCE_PROXY_FAILURE_THRESHOLD) {
+        signals.push('high_edit_distance');
+    }
+    return signals;
+}
+function mergeTrainingOutcomeSignals(...groups) {
+    return [...new Set(groups.flat())];
+}
+function parseTrainingOutcomeSignals(raw) {
+    if (!Array.isArray(raw)) {
+        return [];
+    }
+    return raw.filter((value) => typeof value === 'string' && isTrainingOutcomeSignal(value));
+}
+/** Derive success label from behavioral outcomes plus optional failure proxies. */
+export function deriveSuccessLabel(outcomes, options) {
+    const behavioralSignals = [...new Set(outcomes.map((entry) => entry.signal_type))];
+    const verifierSignals = options?.failureProxies
+        ? deriveVerifierFailureSignals(options.failureProxies)
+        : [];
+    const signals = mergeTrainingOutcomeSignals(behavioralSignals, verifierSignals);
     if (signals.some((signal) => FAILURE_OUTCOME_SIGNALS.includes(signal))) {
         return { success: false, outcome_signals: signals };
     }
@@ -109,6 +257,41 @@ export function deriveSuccessLabel(outcomes) {
     // compaction_pin_break and other neutral signals — treat as unlabeled success.
     return { success: true, outcome_signals: signals };
 }
+/** Derive training labels from a privacy-safe export/contrib row (no prompt text). */
+export function deriveSuccessLabelFromExportRow(record) {
+    const failure_proxies = extractFailureProxies(record);
+    const existingSignals = parseTrainingOutcomeSignals(record.outcome_signals);
+    const verifierSignals = deriveVerifierFailureSignals(failure_proxies);
+    const mergedSignals = mergeTrainingOutcomeSignals(existingSignals, verifierSignals);
+    if (mergedSignals.some((signal) => FAILURE_OUTCOME_SIGNALS.includes(signal))) {
+        return { success: false, outcome_signals: mergedSignals, failure_proxies };
+    }
+    if (mergedSignals.includes('feedback_good')) {
+        return { success: true, outcome_signals: mergedSignals, failure_proxies };
+    }
+    if (typeof record.success_label === 'boolean') {
+        return {
+            success: record.success_label,
+            outcome_signals: mergedSignals,
+            failure_proxies,
+        };
+    }
+    if (mergedSignals.length === 0) {
+        return { success: null, outcome_signals: mergedSignals, failure_proxies };
+    }
+    return { success: true, outcome_signals: mergedSignals, failure_proxies };
+}
+/** Attach normalized failure proxy fields for calibration export rows. */
+export function attachFailureProxiesToExport(exportRecord) {
+    const proxies = extractFailureProxies(exportRecord);
+    return {
+        ...exportRecord,
+        tool_failure_chain_count: proxies.tool_failure_chain_count,
+        stop_reason_invalid: proxies.stop_reason_invalid,
+        reprompt_rate: proxies.reprompt_rate,
+        edit_distance_proxy: proxies.edit_distance_proxy,
+    };
+}
 /** Group outcomes by request_id for export joins. */
 export function indexOutcomesByRequestId(outcomes) {
     const byRequest = new Map();
@@ -124,23 +307,31 @@ export function joinDatasetWithOutcomes(datasetRecords, outcomeRecords) {
     const outcomesByRequest = indexOutcomesByRequestId(outcomeRecords);
     return datasetRecords.map((record) => {
         const linked = outcomesByRequest.get(record.request_id) ?? [];
-        const { success, outcome_signals } = deriveSuccessLabel(linked);
+        const failure_proxies = extractFailureProxies(record);
+        const { success, outcome_signals } = deriveSuccessLabel(linked, { failureProxies: failure_proxies });
         return {
             request_id: record.request_id,
             features: extractPSuccessFeatures(record),
             success: success ?? true,
             outcome_signals,
+            failure_proxies,
         };
     });
 }
 /** Attach join labels to a privacy-safe export object. */
 export function attachOutcomeLabelsToExport(exportRecord, outcomes) {
-    const { success, outcome_signals } = deriveSuccessLabel(outcomes);
+    const withProxies = attachFailureProxiesToExport(exportRecord);
+    const failure_proxies = extractFailureProxies(withProxies);
+    const { success, outcome_signals } = deriveSuccessLabel(outcomes, { failureProxies: failure_proxies });
     return {
-        ...exportRecord,
+        ...withProxies,
         request_id: String(exportRecord.request_id ?? ''),
         success_label: success,
         outcome_signals,
+        tool_failure_chain_count: failure_proxies.tool_failure_chain_count,
+        stop_reason_invalid: failure_proxies.stop_reason_invalid,
+        reprompt_rate: failure_proxies.reprompt_rate,
+        edit_distance_proxy: failure_proxies.edit_distance_proxy,
     };
 }
 function dot(a, b) {
@@ -202,21 +393,14 @@ export function parseTrainingExportLine(line) {
     if (typeof requestId !== 'string' || requestId.length === 0) {
         return null;
     }
-    const successLabel = parsed.success_label;
-    let success = true;
-    if (typeof successLabel === 'boolean') {
-        success = successLabel;
-    }
-    const rawSignals = parsed.outcome_signals;
-    const outcome_signals = Array.isArray(rawSignals)
-        ? rawSignals.filter((value) => typeof value === 'string')
-        : [];
+    const labeled = deriveSuccessLabelFromExportRow(parsed);
     const record = parsed;
     return {
         request_id: requestId,
         features: extractPSuccessFeatures(record),
-        success: success === false ? false : true,
-        outcome_signals,
+        success: labeled.success === false ? false : true,
+        outcome_signals: labeled.outcome_signals,
+        failure_proxies: labeled.failure_proxies,
     };
 }
 /** Train weights from privacy-safe labeled JSONL export content. */