@resolveio/server-lib 22.3.184 → 22.3.185

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@resolveio/server-lib",
-  "version": "22.3.184",
+  "version": "22.3.185",
   "description": "",
   "scripts": {
     "package": "./build_package.sh",

package/util/support-runner-v5.d.ts

@@ -381,9 +381,55 @@ export interface ResolveIOSupportEvidenceFreshness {
     changedFiles: string[];
     artifactPaths: string[];
 }
+export type ResolveIOSupportPreflightCheckName = 'puppeteer_module' | 'chrome_executable' | 'chrome_launch' | 'node_version' | 'npm_install' | 'settings_file' | 'mongo_connection' | 'server_startup' | 'client_startup' | 'port_availability' | 'compile' | 'cache_state' | 'seed_data' | 'unknown';
+export type ResolveIOSupportPreflightCheckStatus = 'pass' | 'fail' | 'blocked' | 'warn' | 'unknown';
+export interface ResolveIOSupportPreflightCheck {
+    name: ResolveIOSupportPreflightCheckName;
+    status: ResolveIOSupportPreflightCheckStatus;
+    summary: string;
+    failureClass: 'infra' | 'compile' | 'unknown';
+    command?: string;
+    durationMs?: number;
+    artifactPaths: string[];
+    evidence: string[];
+    recordedAt: string;
+}
+export type ResolveIOSupportPreflightGateStatus = 'passed' | 'missing' | 'infra_failed' | 'compile_failed' | 'blocked' | 'unknown';
+export type ResolveIOSupportPreflightNextCommand = 'continue_to_diagnosis' | 'run_support_v5_preflight' | 'run_support_v5_infra_repair' | 'run_support_v5_compile_repair';
+export interface ResolveIOSupportPreflightGateInput {
+    required?: boolean;
+    status?: ResolveIOSupportPreflightGateStatus | string;
+    ready?: boolean;
+    checks?: any[];
+    infraChecks?: any[];
+    compileResult?: any;
+    startupChecks?: any[];
+    blockers?: any;
+    requiredEvidence?: any;
+    artifactPaths?: any;
+    evidenceHash?: string;
+    recordedAt?: Date | string;
+}
+export interface ResolveIOSupportPreflightGate {
+    ready: boolean;
+    required: boolean;
+    status: ResolveIOSupportPreflightGateStatus;
+    failureClass: 'infra' | 'compile' | 'unknown';
+    checks: ResolveIOSupportPreflightCheck[];
+    failedChecks: ResolveIOSupportPreflightCheck[];
+    blockers: string[];
+    requiredEvidence: string[];
+    artifactPaths: string[];
+    nextCommand: ResolveIOSupportPreflightNextCommand;
+    blocksProductRepair: boolean;
+    blocksModelRepair: boolean;
+    evidenceHash: string;
+    recordedAt: string;
+}
 export type ResolveIOSupportV5RepairGateAction = 'diagnose_only' | 'infra_repair_only' | 'allow_product_repair' | 'reject_out_of_scope' | 'park_repeated_failure';
 export interface ResolveIOSupportV5RepairGateInput {
     diagnosisGate?: any;
+    preflightGate?: ResolveIOSupportPreflightGateInput | ResolveIOSupportPreflightGate;
     activeStepType?: ResolveIOSupportV5StepType | string;
     changedFiles?: any;
     artifactPaths?: any;
@@ -404,6 +450,7 @@ export interface ResolveIOSupportV5RepairGateDecision {
     issueClass?: ResolveIOSupportIssueClass;
     proofPlan?: ResolveIOSupportDiagnosisProofPlan;
     outsideOwnerFiles: string[];
+    preflightGate: ResolveIOSupportPreflightGate;
     repeatedFailure?: ResolveIOSupportV5RepeatStopDecision;
     diagnosisValidation: ResolveIOSupportDiagnosisGateValidation;
     recoveryPlan: ResolveIOAIManagerRecoveryPlan;
@@ -530,6 +577,7 @@ export interface ResolveIOSupportV5StepRecord {
     changedFiles?: string[];
     artifactPaths?: string[];
     diagnosisGate?: ResolveIOSupportDiagnosisGate;
+    preflightGate?: ResolveIOSupportPreflightGate;
     failureClass?: ResolveIOSupportV5FailureClass | string;
     blockerFingerprint?: string;
     evidenceHash?: string;
@@ -549,6 +597,7 @@ export interface ResolveIOSupportV5StateBundle {
     supportV5DiagnosisGate?: ResolveIOSupportDiagnosisGate;
     supportV5DiagnosisEvidencePack?: ResolveIOSupportDiagnosisEvidencePack;
     supportV5IssueClassProbePlan?: ResolveIOSupportIssueClassProbePlan;
+    supportV5PreflightGate?: ResolveIOSupportPreflightGate;
     supportV5LaneMemory: {
         build: ResolveIOSupportV5LaneMemory;
         qa: ResolveIOSupportV5LaneMemory;
@@ -597,6 +646,7 @@ export interface ResolveIOSupportV5StepInput {
     changedFiles?: string[];
     artifactPaths?: string[];
     diagnosisGate?: ResolveIOSupportDiagnosisGate;
+    preflightGate?: ResolveIOSupportPreflightGateInput | ResolveIOSupportPreflightGate;
     failureClass?: ResolveIOSupportV5FailureClass | string;
     evidenceHash?: string;
     activeQaRow?: ResolveIOSupportV5LaneMemory['activeQaRow'];
@@ -648,6 +698,9 @@ export interface ResolveIOSupportRootCauseReadiness {
     canDraftCustomerReply: boolean;
     requiresHumanDecision: boolean;
     issueClassProbePlanReady: boolean;
+    preflightReady: boolean;
+    preflightStatus: ResolveIOSupportPreflightGateStatus;
+    preflightFailureClass: 'infra' | 'compile' | 'unknown';
     reason: string;
     blockers: string[];
     ownerFiles: string[];
@@ -659,6 +712,7 @@ export interface ResolveIOSupportRootCauseReadiness {
     proofFingerprint?: string;
     artifactFingerprint?: string;
     proofFreshness?: ResolveIOSupportBusinessProofReadiness['proofFreshness'];
+    preflightGate?: ResolveIOSupportPreflightGate;
 }
 export type ResolveIOSupportNextActionCostRisk = 'free_or_deterministic' | 'small_model_or_qa' | 'expensive_model' | 'release_or_customer_send' | 'manual_blocked';
 export interface ResolveIOSupportNextActionContract {
@@ -687,6 +741,10 @@ export interface ResolveIOSupportNextActionContract {
         evidenceHash: string;
         sameFailureCount: number;
         issueClassProbePlanReady: boolean;
+        preflightReady: boolean;
+        preflightStatus: ResolveIOSupportPreflightGateStatus;
+        preflightFailureClass: 'infra' | 'compile' | 'unknown';
+        preflightEvidenceHash: string;
         hotfixCommitRequired: boolean;
         liveHotfixBlockedUntilCommit: boolean;
     };
@@ -720,6 +778,7 @@ export interface ResolveIOSupportV5AutonomousDecisionInput {
     hotfixEvidence?: any;
     releasePolicy?: ResolveIOAIManagerHotfixFirstReleasePolicy;
     releaseGatePassed?: boolean;
+    preflightGate?: ResolveIOSupportPreflightGateInput | ResolveIOSupportPreflightGate;
     maxOwnerFiles?: number;
     now?: Date | string;
 }
@@ -757,6 +816,7 @@ export interface ResolveIOSupportV5AutonomousDecision {
     customerReplyPolicy: ResolveIOSupportCustomerReplyPolicy;
     businessProofReadiness: ResolveIOSupportBusinessProofReadiness;
     evidenceFreshness: ResolveIOSupportEvidenceFreshness;
+    preflightGate: ResolveIOSupportPreflightGate;
     rootCauseReadiness: ResolveIOSupportRootCauseReadiness;
     continuationProofCheckpoint: ResolveIOSupportContinuationProofCheckpoint;
     nextActionContract: ResolveIOSupportNextActionContract;
@@ -765,6 +825,7 @@ export interface ResolveIOSupportV5AutonomousDecision {
     hotfixContinuation?: ResolveIOAIManagerHotfixContinuationDecision;
     recordedAt: string;
 }
+export declare function evaluateResolveIOSupportPreflightGate(input?: ResolveIOSupportPreflightGateInput | ResolveIOSupportPreflightGate | any, nowValue?: Date | string): ResolveIOSupportPreflightGate;
 export declare function selectResolveIOSupportSimilarCaseHints(input?: ResolveIOSupportSimilarCaseSelectionInput): ResolveIOSupportSimilarCaseSelection;
 export declare function buildResolveIOSupportDiagnosisEvidencePack(input?: ResolveIOSupportDiagnosisEvidencePackInput): ResolveIOSupportDiagnosisEvidencePack;
 export declare function evaluateResolveIOSupportDiagnosisEvidenceQuality(value: any): ResolveIOSupportDiagnosisEvidenceQuality;

package/util/support-runner-v5.js

@@ -47,6 +47,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     return to.concat(ar || Array.prototype.slice.call(from));
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateResolveIOSupportPreflightGate = evaluateResolveIOSupportPreflightGate;
 exports.selectResolveIOSupportSimilarCaseHints = selectResolveIOSupportSimilarCaseHints;
 exports.buildResolveIOSupportDiagnosisEvidencePack = buildResolveIOSupportDiagnosisEvidencePack;
 exports.evaluateResolveIOSupportDiagnosisEvidenceQuality = evaluateResolveIOSupportDiagnosisEvidenceQuality;
@@ -127,6 +128,196 @@ function cleanList(values, limit, max) {
 function cleanObject(value) {
     return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
 }
+function normalizeResolveIOSupportPreflightCheckName(value) {
+    var normalized = cleanText(value, 120)
+        .toLowerCase()
+        .replace(/[\s-]+/g, '_');
+    var aliases = {
+        puppeteer: 'puppeteer_module',
+        puppeteer_module: 'puppeteer_module',
+        chrome: 'chrome_executable',
+        chrome_path: 'chrome_executable',
+        chrome_executable: 'chrome_executable',
+        chrome_launch: 'chrome_launch',
+        browser_launch: 'chrome_launch',
+        node: 'node_version',
+        node_version: 'node_version',
+        npm: 'npm_install',
+        npm_install: 'npm_install',
+        settings: 'settings_file',
+        settings_file: 'settings_file',
+        mongo: 'mongo_connection',
+        mongodb: 'mongo_connection',
+        mongo_connection: 'mongo_connection',
+        server: 'server_startup',
+        server_startup: 'server_startup',
+        client: 'client_startup',
+        client_startup: 'client_startup',
+        port: 'port_availability',
+        ports: 'port_availability',
+        port_availability: 'port_availability',
+        build: 'compile',
+        compile: 'compile',
+        cache: 'cache_state',
+        cache_state: 'cache_state',
+        seed: 'seed_data',
+        seed_data: 'seed_data'
+    };
+    return aliases[normalized] || 'unknown';
+}
+function normalizeResolveIOSupportPreflightCheckStatus(value, source) {
+    var normalized = cleanText(value, 80).toLowerCase();
+    if (['pass', 'passed', 'ok', 'success', 'ready'].includes(normalized) || source.passed === true || source.ok === true || source.ready === true) {
+        return 'pass';
+    }
+    if (['fail', 'failed', 'failure', 'error'].includes(normalized) || source.passed === false || source.ok === false) {
+        return 'fail';
+    }
+    if (['blocked', 'block', 'missing'].includes(normalized) || source.blocked === true) {
+        return 'blocked';
+    }
+    if (['warn', 'warning'].includes(normalized)) {
+        return 'warn';
+    }
+    return 'unknown';
+}
+function normalizeResolveIOSupportPreflightFailureClass(name, source, status) {
+    var normalized = cleanText(source.failureClass || source.failure_class || source.class, 80).toLowerCase();
+    if (normalized === 'compile' || normalized === 'build') {
+        return 'compile';
+    }
+    if (normalized === 'infra' || normalized === 'infrastructure') {
+        return 'infra';
+    }
+    if (status === 'pass' || status === 'warn') {
+        return 'unknown';
+    }
+    return name === 'compile' ? 'compile' : 'infra';
+}
+function normalizeResolveIOSupportPreflightCheck(input, now) {
+    var source = typeof input === 'string'
+        ? { summary: input, name: 'unknown', status: 'unknown' }
+        : cleanObject(input);
+    var name = normalizeResolveIOSupportPreflightCheckName(source.name || source.check || source.checkName || source.id || source.type);
+    var status = normalizeResolveIOSupportPreflightCheckStatus(source.status || source.state || source.outcome, source);
+    var artifactPaths = Array.from(new Set(__spreadArray(__spreadArray([], __read(cleanList(source.artifactPaths || source.artifacts, 20, 500)), false), __read(cleanList(source.artifactPath ? [source.artifactPath] : [], 1, 500)), false)));
+    var evidence = cleanList(source.evidence || source.logs || source.messages, 20, 500);
+    return {
+        name: name,
+        status: status,
+        summary: cleanText(source.summary || source.reason || source.error || source.message || source.status || name, 1000),
+        failureClass: normalizeResolveIOSupportPreflightFailureClass(name, source, status),
+        command: cleanText(source.command, 500) || undefined,
+        durationMs: Number.isFinite(Number(source.durationMs || source.duration_ms))
+            ? Math.max(0, Number(source.durationMs || source.duration_ms))
+            : undefined,
+        artifactPaths: artifactPaths,
+        evidence: evidence,
+        recordedAt: cleanText(source.recordedAt || source.recorded_at, 80) || now
+    };
+}
+function normalizeResolveIOSupportPreflightGateStatus(value) {
+    var normalized = cleanText(value, 80).toLowerCase();
+    var aliases = {
+        passed: 'passed',
+        pass: 'passed',
+        ready: 'passed',
+        missing: 'missing',
+        infra_failed: 'infra_failed',
+        infra: 'infra_failed',
+        infrastructure_failed: 'infra_failed',
+        compile_failed: 'compile_failed',
+        build_failed: 'compile_failed',
+        blocked: 'blocked',
+        unknown: 'unknown'
+    };
+    return aliases[normalized] || '';
+}
+function evaluateResolveIOSupportPreflightGate(input, nowValue) {
+    var now = isoNow(nowValue);
+    var source = cleanObject(input);
+    var compileResult = cleanObject(source.compileResult || source.compile_result);
+    var checksInput = __spreadArray(__spreadArray(__spreadArray(__spreadArray([], __read((Array.isArray(source.checks) ? source.checks : [])), false), __read((Array.isArray(source.infraChecks || source.infra_checks) ? (source.infraChecks || source.infra_checks) : [])), false), __read((Array.isArray(source.startupChecks || source.startup_checks) ? (source.startupChecks || source.startup_checks) : [])), false), __read((Object.keys(compileResult).length ? [__assign(__assign({}, compileResult), { name: compileResult.name || 'compile', failureClass: compileResult.failureClass || compileResult.failure_class || 'compile' })] : [])), false);
+    var checks = checksInput.map(function (check) { return normalizeResolveIOSupportPreflightCheck(check, now); });
+    var required = source.required === true
+        || source.requiredBeforeRepair === true
+        || source.required_before_repair === true
+        || source.blocksProductRepair === true
+        || source.blocks_product_repair === true;
+    var failedChecks = checks.filter(function (check) { return check.status === 'fail' || check.status === 'blocked'; });
+    var unknownChecks = checks.filter(function (check) { return check.status === 'unknown'; });
+    var directStatus = normalizeResolveIOSupportPreflightGateStatus(source.status);
+    var compileFailed = failedChecks.some(function (check) { return check.failureClass === 'compile' || check.name === 'compile'; })
+        || directStatus === 'compile_failed';
+    var infraFailed = failedChecks.length > 0 || directStatus === 'infra_failed';
+    var status;
+    if (compileFailed) {
+        status = 'compile_failed';
+    }
+    else if (infraFailed) {
+        status = 'infra_failed';
+    }
+    else if (directStatus === 'blocked') {
+        status = 'blocked';
+    }
+    else if (directStatus === 'missing' || (required && checks.length === 0)) {
+        status = 'missing';
+    }
+    else if (directStatus === 'passed' || source.ready === true || (checks.length > 0 && failedChecks.length === 0 && unknownChecks.length === 0)) {
+        status = 'passed';
+    }
+    else {
+        status = 'unknown';
+    }
+    var failureClass = status === 'compile_failed'
+        ? 'compile'
+        : (status === 'infra_failed' || status === 'blocked' || status === 'missing')
+            ? 'infra'
+            : 'unknown';
+    var artifactPaths = Array.from(new Set(__spreadArray(__spreadArray([], __read(cleanList(source.artifactPaths || source.artifacts, 40, 500)), false), __read(checks.flatMap(function (check) { return check.artifactPaths; })), false))).slice(0, 80);
+    var blockers = Array.from(new Set(__spreadArray(__spreadArray(__spreadArray(__spreadArray([], __read(cleanList(source.blockers, 20, 500)), false), __read(failedChecks.map(function (check) { return "".concat(check.name, ": ").concat(check.summary); })), false), __read((status === 'missing' ? ['Deterministic support preflight is required before product-code repair.'] : [])), false), __read((status === 'blocked' ? ['Support preflight is blocked and must be cleared before product-code repair.'] : [])), false).filter(Boolean))).slice(0, 30);
+    var requiredEvidence = Array.from(new Set(__spreadArray(__spreadArray(__spreadArray(__spreadArray([], __read(cleanList(source.requiredEvidence || source.required_evidence, 20, 500)), false), __read((status === 'compile_failed' ? ['compile command output', 'artifact path or build log', 'new compile evidence hash or pass'] : [])), false), __read((status === 'infra_failed' ? ['Puppeteer/Chrome/server/client/Mongo preflight log', 'new infra evidence hash or pass'] : [])), false), __read((status === 'missing' || status === 'blocked' || (required && status === 'unknown') ? ['support preflight result with Puppeteer, Chrome, compile, startup, Mongo, port, and settings status'] : [])), false))).slice(0, 30);
+    var blocksProductRepair = status === 'compile_failed'
+        || status === 'infra_failed'
+        || status === 'blocked'
+        || status === 'missing'
+        || (required && status === 'unknown');
+    var nextCommand = status === 'compile_failed'
+        ? 'run_support_v5_compile_repair'
+        : status === 'infra_failed' || status === 'blocked'
+            ? 'run_support_v5_infra_repair'
+            : status === 'missing' || (required && status === 'unknown')
+                ? 'run_support_v5_preflight'
+                : 'continue_to_diagnosis';
+    var evidenceHash = cleanText(source.evidenceHash || source.evidence_hash, 80)
+        || hashResolveIOSupportV5Evidence({
+            status: status,
+            required: required,
+            failedChecks: failedChecks.map(function (check) { return ({
+                name: check.name,
+                status: check.status,
+                summary: check.summary,
+                failureClass: check.failureClass
+            }); }),
+            artifactPaths: artifactPaths
+        });
+    return {
+        ready: blocksProductRepair ? false : status === 'passed',
+        required: required,
+        status: status,
+        failureClass: failureClass,
+        checks: checks,
+        failedChecks: failedChecks,
+        blockers: blockers,
+        requiredEvidence: requiredEvidence,
+        artifactPaths: artifactPaths,
+        nextCommand: nextCommand,
+        blocksProductRepair: blocksProductRepair,
+        blocksModelRepair: blocksProductRepair,
+        evidenceHash: evidenceHash,
+        recordedAt: cleanText(source.recordedAt || source.recorded_at, 80) || now
+    };
+}
 function pickText(source, fields, max) {
     var e_2, _a;
     if (max === void 0) { max = 1000; }
@@ -2354,9 +2545,10 @@ function changedFilesOutsideResolveIOSupportDiagnosisOwnerFiles(diagnosisGate, c
     });
 }
 function decideResolveIOSupportV5RepairGate(input) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
     var activeStepType = cleanText(input.activeStepType, 80);
     var failureClass = cleanText(input.failureClass, 80).toLowerCase();
+    var preflightGate = evaluateResolveIOSupportPreflightGate(input.preflightGate);
     var diagnosisValidation = validateResolveIOSupportDiagnosisGate(input.diagnosisGate, {
         maxOwnerFiles: input.maxOwnerFiles
     });
@@ -2437,24 +2629,31 @@ function decideResolveIOSupportV5RepairGate(input) {
     };
     if (repeatedFailure === null || repeatedFailure === void 0 ? void 0 : repeatedFailure.shouldStop) {
         var recoveryPlan_1 = recoveryPlanFor('park_repeated_failure', repeatedFailure.reason, repeatedFailure.failureClass, true);
-        return __assign({ action: 'park_repeated_failure', canEditProductCode: false, blockers: [repeatedFailure.reason], ownerFiles: ownerFiles, issueClass: (_c = diagnosisValidation.normalized) === null || _c === void 0 ? void 0 : _c.issue_class, proofPlan: (_d = diagnosisValidation.normalized) === null || _d === void 0 ? void 0 : _d.proof_plan, outsideOwnerFiles: outsideOwnerFiles, repeatedFailure: repeatedFailure, diagnosisValidation: diagnosisValidation }, recoveryFieldsFor(recoveryPlan_1));
+        return __assign({ action: 'park_repeated_failure', canEditProductCode: false, blockers: [repeatedFailure.reason], ownerFiles: ownerFiles, issueClass: (_c = diagnosisValidation.normalized) === null || _c === void 0 ? void 0 : _c.issue_class, proofPlan: (_d = diagnosisValidation.normalized) === null || _d === void 0 ? void 0 : _d.proof_plan, outsideOwnerFiles: outsideOwnerFiles, preflightGate: preflightGate, repeatedFailure: repeatedFailure, diagnosisValidation: diagnosisValidation }, recoveryFieldsFor(recoveryPlan_1));
+    }
+    if (preflightGate.blocksProductRepair) {
+        var recoveryFailureClass = preflightGate.failureClass === 'compile' ? 'compile' : 'infra';
+        var recoveryPlan_2 = recoveryPlanFor('retry_infra', 'support_v5_preflight_gate_blocks_product_repair', recoveryFailureClass, false);
+        return __assign({ action: 'infra_repair_only', canEditProductCode: false, blockers: preflightGate.blockers.length
+                ? preflightGate.blockers
+                : ['Deterministic support preflight must pass before product-code repair.'], ownerFiles: ownerFiles, issueClass: (_e = diagnosisValidation.normalized) === null || _e === void 0 ? void 0 : _e.issue_class, proofPlan: (_f = diagnosisValidation.normalized) === null || _f === void 0 ? void 0 : _f.proof_plan, outsideOwnerFiles: outsideOwnerFiles, preflightGate: preflightGate, repeatedFailure: repeatedFailure, diagnosisValidation: diagnosisValidation }, recoveryFieldsFor(recoveryPlan_2));
     }
     if (failureClass === 'infra' || failureClass === 'compile') {
-        var recoveryPlan_2 = recoveryPlanFor('retry_infra', 'support_v5_infra_or_compile_repair_required', failureClass, false);
-        return __assign({ action: 'infra_repair_only', canEditProductCode: false, blockers: ['Infra/compile/Puppeteer/startup failures must be repaired in the harness lane before product-code repair.'], ownerFiles: ownerFiles, issueClass: (_e = diagnosisValidation.normalized) === null || _e === void 0 ? void 0 : _e.issue_class, proofPlan: (_f = diagnosisValidation.normalized) === null || _f === void 0 ? void 0 : _f.proof_plan, outsideOwnerFiles: outsideOwnerFiles, repeatedFailure: repeatedFailure, diagnosisValidation: diagnosisValidation }, recoveryFieldsFor(recoveryPlan_2));
+        var recoveryPlan_3 = recoveryPlanFor('retry_infra', 'support_v5_infra_or_compile_repair_required', failureClass, false);
+        return __assign({ action: 'infra_repair_only', canEditProductCode: false, blockers: ['Infra/compile/Puppeteer/startup failures must be repaired in the harness lane before product-code repair.'], ownerFiles: ownerFiles, issueClass: (_g = diagnosisValidation.normalized) === null || _g === void 0 ? void 0 : _g.issue_class, proofPlan: (_h = diagnosisValidation.normalized) === null || _h === void 0 ? void 0 : _h.proof_plan, outsideOwnerFiles: outsideOwnerFiles, preflightGate: preflightGate, repeatedFailure: repeatedFailure, diagnosisValidation: diagnosisValidation }, recoveryFieldsFor(recoveryPlan_3));
     }
     if (activeStepType === 'diagnosis_gate' || !diagnosisValidation.valid) {
-        var recoveryPlan_3 = recoveryPlanFor('continue', 'support_v5_diagnosis_gate_required', 'diagnosis', false);
+        var recoveryPlan_4 = recoveryPlanFor('continue', 'support_v5_diagnosis_gate_required', 'diagnosis', false);
         return __assign({ action: 'diagnose_only', canEditProductCode: false, blockers: diagnosisValidation.blockers.length
                 ? diagnosisValidation.blockers
-                : ['SupportDiagnosisGate is required before product-code repair.'], ownerFiles: ownerFiles, issueClass: (_g = diagnosisValidation.normalized) === null || _g === void 0 ? void 0 : _g.issue_class, proofPlan: (_h = diagnosisValidation.normalized) === null || _h === void 0 ? void 0 : _h.proof_plan, outsideOwnerFiles: outsideOwnerFiles, repeatedFailure: repeatedFailure, diagnosisValidation: diagnosisValidation }, recoveryFieldsFor(recoveryPlan_3));
+                : ['SupportDiagnosisGate is required before product-code repair.'], ownerFiles: ownerFiles, issueClass: (_j = diagnosisValidation.normalized) === null || _j === void 0 ? void 0 : _j.issue_class, proofPlan: (_k = diagnosisValidation.normalized) === null || _k === void 0 ? void 0 : _k.proof_plan, outsideOwnerFiles: outsideOwnerFiles, preflightGate: preflightGate, repeatedFailure: repeatedFailure, diagnosisValidation: diagnosisValidation }, recoveryFieldsFor(recoveryPlan_4));
     }
     if (outsideOwnerFiles.length) {
-        var recoveryPlan_4 = recoveryPlanFor('continue', 'support_v5_out_of_scope_requires_diagnosis_revision', 'owner_scope', false);
-        return __assign({ action: 'reject_out_of_scope', canEditProductCode: false, blockers: ["Changed files outside diagnosis owner_files; revise diagnosis with new evidence before broadening edits: ".concat(outsideOwnerFiles.join(', '))], ownerFiles: ownerFiles, issueClass: (_j = diagnosisValidation.normalized) === null || _j === void 0 ? void 0 : _j.issue_class, proofPlan: (_k = diagnosisValidation.normalized) === null || _k === void 0 ? void 0 : _k.proof_plan, outsideOwnerFiles: outsideOwnerFiles, repeatedFailure: repeatedFailure, diagnosisValidation: diagnosisValidation }, recoveryFieldsFor(recoveryPlan_4));
+        var recoveryPlan_5 = recoveryPlanFor('continue', 'support_v5_out_of_scope_requires_diagnosis_revision', 'owner_scope', false);
+        return __assign({ action: 'reject_out_of_scope', canEditProductCode: false, blockers: ["Changed files outside diagnosis owner_files; revise diagnosis with new evidence before broadening edits: ".concat(outsideOwnerFiles.join(', '))], ownerFiles: ownerFiles, issueClass: (_l = diagnosisValidation.normalized) === null || _l === void 0 ? void 0 : _l.issue_class, proofPlan: (_m = diagnosisValidation.normalized) === null || _m === void 0 ? void 0 : _m.proof_plan, outsideOwnerFiles: outsideOwnerFiles, preflightGate: preflightGate, repeatedFailure: repeatedFailure, diagnosisValidation: diagnosisValidation }, recoveryFieldsFor(recoveryPlan_5));
     }
     var recoveryPlan = recoveryPlanFor('continue', 'support_v5_product_repair_allowed_after_diagnosis', failureClass || 'product_code', true);
-    return __assign({ action: 'allow_product_repair', canEditProductCode: true, blockers: [], ownerFiles: ownerFiles, issueClass: (_l = diagnosisValidation.normalized) === null || _l === void 0 ? void 0 : _l.issue_class, proofPlan: (_m = diagnosisValidation.normalized) === null || _m === void 0 ? void 0 : _m.proof_plan, outsideOwnerFiles: outsideOwnerFiles, repeatedFailure: repeatedFailure, diagnosisValidation: diagnosisValidation }, recoveryFieldsFor(recoveryPlan));
+    return __assign({ action: 'allow_product_repair', canEditProductCode: true, blockers: [], ownerFiles: ownerFiles, issueClass: (_o = diagnosisValidation.normalized) === null || _o === void 0 ? void 0 : _o.issue_class, proofPlan: (_p = diagnosisValidation.normalized) === null || _p === void 0 ? void 0 : _p.proof_plan, outsideOwnerFiles: outsideOwnerFiles, preflightGate: preflightGate, repeatedFailure: repeatedFailure, diagnosisValidation: diagnosisValidation }, recoveryFieldsFor(recoveryPlan));
 }
 function applyResolveIOSupportDiagnosisGateToMicrotasks(bundle, diagnosisGate) {
     var _a;
@@ -2683,6 +2882,7 @@ function initializeResolveIOSupportV5State(input) {
     var qaThreadKey = cleanText(input.qaThreadKey || ((_b = existingLaneMemory.qa) === null || _b === void 0 ? void 0 : _b.threadKey) || "support:".concat(input.ticketId || input.jobId, ":job:").concat(input.jobId, ":qa"), 240);
     var budget = buildResolveIOSupportV5Budget(existing.supportV5Budget);
     var existingDiagnosisGate = normalizeResolveIOSupportDiagnosisGate(existing.supportV5DiagnosisGate);
+    var existingPreflightGate = evaluateResolveIOSupportPreflightGate(existing.supportV5PreflightGate || existing.support_v5_preflight_gate, now);
     var diagnosisValidation = validateResolveIOSupportDiagnosisGate(existingDiagnosisGate);
     var existingProbePlanValidation = validateResolveIOSupportIssueClassProbePlan(existing.supportV5IssueClassProbePlan || existing.support_v5_issue_class_probe_plan, diagnosisValidation.normalized || existingDiagnosisGate, now);
     var scopeDigest = cleanText(existing.supportV5ScopeDigest, 4000) || buildResolveIOSupportV5ScopeDigest({
@@ -2719,6 +2919,9 @@ function initializeResolveIOSupportV5State(input) {
         supportV5DiagnosisGate: diagnosisValidation.valid ? diagnosisValidation.normalized : existingDiagnosisGate,
         supportV5DiagnosisEvidencePack: existing.supportV5DiagnosisEvidencePack || existing.support_v5_diagnosis_evidence_pack,
         supportV5IssueClassProbePlan: existingProbePlanValidation.normalized,
+        supportV5PreflightGate: existingPreflightGate.status === 'unknown' && existingPreflightGate.checks.length === 0
+            ? undefined
+            : existingPreflightGate,
         supportV5LaneMemory: {
             build: {
                 lane: 'build',
@@ -2785,6 +2988,9 @@ function recordResolveIOSupportV5Step(bundle, step) {
     var normalizedDiagnosisGate = step.diagnosisGate
         ? normalizeResolveIOSupportDiagnosisGate(step.diagnosisGate, now)
         : undefined;
+    var normalizedPreflightGate = step.preflightGate
+        ? evaluateResolveIOSupportPreflightGate(step.preflightGate, now)
+        : undefined;
     var blockerFingerprint = step.blocker || step.summary
         ? fingerprintResolveIOSupportV5Blocker(step.blocker || step.summary || '')
         : undefined;
@@ -2798,8 +3004,9 @@ function recordResolveIOSupportV5Step(bundle, step) {
                 changedFiles: step.changedFiles,
                 artifactPaths: step.artifactPaths
             }));
-    var record = __assign(__assign({}, (microtaskId ? { microtaskId: microtaskId } : {})), { stepType: step.stepType, outcome: step.outcome, lane: step.lane, model: cleanText(step.model, 80), threadKey: cleanText(step.threadKey, 240), promptTokenEstimate: promptTokens || undefined, runtimeMs: runtimeMs || undefined, summary: cleanText(step.summary || step.blocker || step.outcome, 1200), blocker: cleanText(step.blocker, 1200), changedFiles: cleanList(step.changedFiles, 80, 500), artifactPaths: cleanList(step.artifactPaths, 80, 500), diagnosisGate: normalizedDiagnosisGate, failureClass: cleanText(step.failureClass, 80) || undefined, blockerFingerprint: blockerFingerprint, evidenceHash: evidenceHash, recordedAt: now });
+    var record = __assign(__assign({}, (microtaskId ? { microtaskId: microtaskId } : {})), { stepType: step.stepType, outcome: step.outcome, lane: step.lane, model: cleanText(step.model, 80), threadKey: cleanText(step.threadKey, 240), promptTokenEstimate: promptTokens || undefined, runtimeMs: runtimeMs || undefined, summary: cleanText(step.summary || step.blocker || step.outcome, 1200), blocker: cleanText(step.blocker, 1200), changedFiles: cleanList(step.changedFiles, 80, 500), artifactPaths: cleanList(step.artifactPaths, 80, 500), diagnosisGate: normalizedDiagnosisGate, preflightGate: normalizedPreflightGate, failureClass: cleanText(step.failureClass, 80) || undefined, blockerFingerprint: blockerFingerprint, evidenceHash: evidenceHash, recordedAt: now });
     var diagnosisGate = normalizedDiagnosisGate || bundle.supportV5DiagnosisGate;
+    var preflightGate = normalizedPreflightGate || bundle.supportV5PreflightGate;
     var laneMemory = __assign({}, bundle.supportV5LaneMemory);
     if (step.lane === 'build' || step.lane === 'qa') {
         var previous = laneMemory[step.lane];
@@ -2845,7 +3052,7 @@ function recordResolveIOSupportV5Step(bundle, step) {
         ? 1
         : bundle.supportV5Budget.loopCount + 1;
     var nextMicrotask = selectResolveIOSupportV5ActiveMicrotask(ledger, bundle.supportV5ActiveMicrotaskId);
-    var nextBundle = __assign(__assign({}, bundle), { supportV5SupervisorState: supervisor, supportV5DiagnosisGate: diagnosisGate, supportV5LaneMemory: laneMemory, supportV5StepHistory: __spreadArray(__spreadArray([], __read(bundle.supportV5StepHistory), false), [record], false).slice(-100), supportV5Budget: __assign(__assign({}, bundle.supportV5Budget), { totalPromptTokenEstimate: bundle.supportV5Budget.totalPromptTokenEstimate + promptTokens, totalRuntimeMs: bundle.supportV5Budget.totalRuntimeMs + runtimeMs, loopCount: nextLoopCount }), supportV5MicrotaskLedger: ledger, supportV5ActiveMicrotaskId: nextMicrotask === null || nextMicrotask === void 0 ? void 0 : nextMicrotask.microtaskId, supportV5MicrotaskUsageHistory: bundle.supportV5MicrotaskUsageHistory || [], supportV5FailureFingerprints: failureFingerprint
+    var nextBundle = __assign(__assign({}, bundle), { supportV5SupervisorState: supervisor, supportV5DiagnosisGate: diagnosisGate, supportV5PreflightGate: preflightGate, supportV5LaneMemory: laneMemory, supportV5StepHistory: __spreadArray(__spreadArray([], __read(bundle.supportV5StepHistory), false), [record], false).slice(-100), supportV5Budget: __assign(__assign({}, bundle.supportV5Budget), { totalPromptTokenEstimate: bundle.supportV5Budget.totalPromptTokenEstimate + promptTokens, totalRuntimeMs: bundle.supportV5Budget.totalRuntimeMs + runtimeMs, loopCount: nextLoopCount }), supportV5MicrotaskLedger: ledger, supportV5ActiveMicrotaskId: nextMicrotask === null || nextMicrotask === void 0 ? void 0 : nextMicrotask.microtaskId, supportV5MicrotaskUsageHistory: bundle.supportV5MicrotaskUsageHistory || [], supportV5FailureFingerprints: failureFingerprint
             ? __spreadArray(__spreadArray([], __read((bundle.supportV5FailureFingerprints || [])), false), [failureFingerprint], false).slice(-200)
             : (bundle.supportV5FailureFingerprints || []), supportV5RecoveryPlan: managerDecision.recoveryPlan, supportV5RecoveryCheckpoint: managerDecision.recoveryCheckpoint, supportV5RecoveryEvidenceProbe: managerDecision.recoveryEvidenceProbe, supportV5RecoveryAction: managerDecision.recoveryAction });
     if (normalizedDiagnosisGate && validateResolveIOSupportDiagnosisGate(normalizedDiagnosisGate).valid) {
@@ -2927,34 +3134,34 @@ function decideResolveIOSupportV5Continuation(bundle) {
         };
     };
     if (budgetExceeded) {
-        var recoveryPlan_5 = recoveryPlanFor('manual_handoff', 'support_v5_budget_guard', {
+        var recoveryPlan_6 = recoveryPlanFor('manual_handoff', 'support_v5_budget_guard', {
             productRepairFailure: false
         });
-        return __assign({ action: 'park', reason: 'support_v5_budget_guard', nextStep: (last === null || last === void 0 ? void 0 : last.stepType) || 'cleanup', repeatedNoProgressCount: repeatedNoProgressCount, budgetExceeded: budgetExceeded }, recoveryFieldsFor(recoveryPlan_5));
+        return __assign({ action: 'park', reason: 'support_v5_budget_guard', nextStep: (last === null || last === void 0 ? void 0 : last.stepType) || 'cleanup', repeatedNoProgressCount: repeatedNoProgressCount, budgetExceeded: budgetExceeded }, recoveryFieldsFor(recoveryPlan_6));
     }
     var lastFailureClass = cleanText(last === null || last === void 0 ? void 0 : last.failureClass, 80).toLowerCase();
     var materialEvidenceRetryAllowed = (repeatedFailure === null || repeatedFailure === void 0 ? void 0 : repeatedFailure.shouldStop) === false
         && repeatedFailure.newEvidence === true
         && repeatedFailure.materialEvidence === true;
     if (repeatedNoProgressCount > budget.maxRepeatedNoProgress && /^(infra|compile)$/.test(lastFailureClass)) {
-        var recoveryPlan_6 = recoveryPlanFor('retry_infra', 'support_v5_infra_or_compile_repair_required', {
+        var recoveryPlan_7 = recoveryPlanFor('retry_infra', 'support_v5_infra_or_compile_repair_required', {
             failureClass: lastFailureClass,
             productRepairFailure: false
         });
-        return __assign({ action: 'continue', reason: 'support_v5_infra_or_compile_repair_required', nextStep: (last === null || last === void 0 ? void 0 : last.stepType) || 'compile_check', repeatedNoProgressCount: repeatedNoProgressCount, budgetExceeded: budgetExceeded }, recoveryFieldsFor(recoveryPlan_6));
+        return __assign({ action: 'continue', reason: 'support_v5_infra_or_compile_repair_required', nextStep: (last === null || last === void 0 ? void 0 : last.stepType) || 'compile_check', repeatedNoProgressCount: repeatedNoProgressCount, budgetExceeded: budgetExceeded }, recoveryFieldsFor(recoveryPlan_7));
     }
     if (repeatedFailure === null || repeatedFailure === void 0 ? void 0 : repeatedFailure.shouldStop) {
-        var recoveryPlan_7 = recoveryPlanFor(repeatedFailure.reason === 'support_v5_ping_pong_failure_loop' ? 'park_ping_pong' : 'park_repeated_failure', repeatedFailure.reason, {
+        var recoveryPlan_8 = recoveryPlanFor(repeatedFailure.reason === 'support_v5_ping_pong_failure_loop' ? 'park_ping_pong' : 'park_repeated_failure', repeatedFailure.reason, {
             failureClass: repeatedFailure.failureClass,
             productRepairFailure: true
         });
-        return __assign({ action: 'park', reason: repeatedFailure.reason, nextStep: (last === null || last === void 0 ? void 0 : last.stepType) || 'cleanup', repeatedNoProgressCount: repeatedFailure.repeatedCount, budgetExceeded: budgetExceeded }, recoveryFieldsFor(recoveryPlan_7));
+        return __assign({ action: 'park', reason: repeatedFailure.reason, nextStep: (last === null || last === void 0 ? void 0 : last.stepType) || 'cleanup', repeatedNoProgressCount: repeatedFailure.repeatedCount, budgetExceeded: budgetExceeded }, recoveryFieldsFor(recoveryPlan_8));
     }
     if (repeatedNoProgressCount > budget.maxRepeatedNoProgress && !materialEvidenceRetryAllowed) {
-        var recoveryPlan_8 = recoveryPlanFor('park_repeated_failure', 'support_v5_repeated_no_progress', {
+        var recoveryPlan_9 = recoveryPlanFor('park_repeated_failure', 'support_v5_repeated_no_progress', {
             productRepairFailure: true
         });
-        return __assign({ action: 'park', reason: 'support_v5_repeated_no_progress', nextStep: (last === null || last === void 0 ? void 0 : last.stepType) || 'cleanup', repeatedNoProgressCount: repeatedNoProgressCount, budgetExceeded: budgetExceeded }, recoveryFieldsFor(recoveryPlan_8));
+        return __assign({ action: 'park', reason: 'support_v5_repeated_no_progress', nextStep: (last === null || last === void 0 ? void 0 : last.stepType) || 'cleanup', repeatedNoProgressCount: repeatedNoProgressCount, budgetExceeded: budgetExceeded }, recoveryFieldsFor(recoveryPlan_9));
     }
     var recoveryPlan = recoveryPlanFor('continue', 'support_v5_continue');
     return __assign({ action: 'continue', reason: 'support_v5_continue', nextStep: (last === null || last === void 0 ? void 0 : last.stepType) || bundle.supportV5SupervisorState.activeStep, repeatedNoProgressCount: repeatedNoProgressCount, budgetExceeded: false }, recoveryFieldsFor(recoveryPlan));
@@ -2962,6 +3169,7 @@ function decideResolveIOSupportV5Continuation(bundle) {
 function decideResolveIOSupportV5AutonomousNextAction(input) {
     var _a, _b, _c, _d, _e, _f, _g, _h;
     var bundle = input.bundle;
+    var preflightGate = evaluateResolveIOSupportPreflightGate(input.preflightGate || bundle.supportV5PreflightGate, input.now);
     var activeMicrotask = selectResolveIOSupportV5ActiveMicrotask(bundle.supportV5MicrotaskLedger || [], bundle.supportV5ActiveMicrotaskId);
     var diagnosisValidation = validateResolveIOSupportDiagnosisGate(bundle.supportV5DiagnosisGate, {
         maxOwnerFiles: input.maxOwnerFiles
@@ -2969,6 +3177,7 @@ function decideResolveIOSupportV5AutonomousNextAction(input) {
     var activeStepType = cleanText((activeMicrotask === null || activeMicrotask === void 0 ? void 0 : activeMicrotask.type) || (!diagnosisValidation.valid ? bundle.supportV5SupervisorState.activeStep : 'cleanup') || 'diagnosis_gate', 80);
     var repairGate = decideResolveIOSupportV5RepairGate({
         diagnosisGate: bundle.supportV5DiagnosisGate,
+        preflightGate: preflightGate,
         activeStepType: activeStepType,
         changedFiles: input.changedFiles,
         failureClass: input.failureClass,
@@ -3077,7 +3286,8 @@ function decideResolveIOSupportV5AutonomousNextAction(input) {
         var ownerFilesReady = diagnosisValid && ownerFiles.length > 0;
         var proofPlanReady = diagnosisValid && !!proofContract;
         var issueClassProbePlanReady = issueClassProbePlanValidation.valid === true;
-        var rootCauseFirstSatisfied = diagnosisValid && ownerFilesReady && proofPlanReady && issueClassProbePlanReady;
+        var preflightReady = preflightGate.blocksProductRepair !== true;
+        var rootCauseFirstSatisfied = diagnosisValid && ownerFilesReady && proofPlanReady && issueClassProbePlanReady && preflightReady;
         var sameFailureParked = evidenceFreshness.mustCollectNewEvidence === true
             || (action === 'collect_new_evidence' && /repeated|no_progress|ping_pong|same failure|same evidence/i.test(reason));
         return {
@@ -3099,8 +3309,11 @@ function decideResolveIOSupportV5AutonomousNextAction(input) {
                 || action === 'ask_customer_clarification',
             requiresHumanDecision: action === 'park_manual' || fields.canRunAutonomously !== true,
             issueClassProbePlanReady: issueClassProbePlanReady,
+            preflightReady: preflightReady,
+            preflightStatus: preflightGate.status,
+            preflightFailureClass: preflightGate.failureClass,
             reason: reason,
-            blockers: Array.from(new Set(__spreadArray(__spreadArray([], __read(blockers), false), __read(issueClassProbePlanValidation.blockers), false))),
+            blockers: Array.from(new Set(__spreadArray(__spreadArray(__spreadArray([], __read(blockers), false), __read(issueClassProbePlanValidation.blockers), false), __read(preflightGate.blockers), false))),
             ownerFiles: ownerFiles,
             issueClass: ((_a = diagnosisValidation.normalized) === null || _a === void 0 ? void 0 : _a.issue_class) || repairGate.issueClass,
             expectedProof: expectedProof,
@@ -3109,7 +3322,8 @@ function decideResolveIOSupportV5AutonomousNextAction(input) {
             businessProofStatus: businessProofReadiness.status,
             proofFingerprint: businessProofReadiness.proofFingerprint,
             artifactFingerprint: businessProofReadiness.artifactFingerprint,
-            proofFreshness: businessProofReadiness.proofFreshness
+            proofFreshness: businessProofReadiness.proofFreshness,
+            preflightGate: preflightGate
         };
     };
     var nextActionExpectedTransition = function (action, primaryCommand) {
@@ -3232,6 +3446,10 @@ function decideResolveIOSupportV5AutonomousNextAction(input) {
                 evidenceHash: evidenceFreshness.evidenceHash,
                 sameFailureCount: evidenceFreshness.sameFailureCount,
                 issueClassProbePlanReady: rootCauseReadiness.issueClassProbePlanReady === true,
+                preflightReady: rootCauseReadiness.preflightReady === true,
+                preflightStatus: preflightGate.status,
+                preflightFailureClass: preflightGate.failureClass,
+                preflightEvidenceHash: preflightGate.evidenceHash,
                 hotfixCommitRequired: hotfixCommitRequired,
                 liveHotfixBlockedUntilCommit: liveHotfixBlockedUntilCommit
             },
@@ -3448,6 +3666,7 @@ function decideResolveIOSupportV5AutonomousNextAction(input) {
             customerReplyPolicy: customerReplyPolicy,
             businessProofReadiness: businessProofReadiness,
             evidenceFreshness: evidenceFreshness,
+            preflightGate: preflightGate,
             rootCauseReadiness: rootCauseReadiness,
             continuationProofCheckpoint: continuationProofCheckpoint,
             nextActionContract: nextActionContract,
@@ -3522,16 +3741,27 @@ function decideResolveIOSupportV5AutonomousNextAction(input) {
         });
     }
     if (repairGate.action === 'infra_repair_only') {
-        return makeDecision('repair_infra_only', 'Repair Infra Only', 'support_v5_infra_failure_before_product_repair', {
+        var compileOnly = repairGate.preflightGate.failureClass === 'compile' || input.failureClass === 'compile';
+        var preflightNextCommand = repairGate.preflightGate.nextCommand === 'continue_to_diagnosis'
+            ? undefined
+            : repairGate.preflightGate.nextCommand;
+        return makeDecision('repair_infra_only', compileOnly ? 'Repair Compile Only' : 'Repair Infra Only', 'support_v5_infra_failure_before_product_repair', {
             canRunAutonomously: true,
             canRunModel: false,
             canEditProductCode: false,
             canRunQa: true,
             lane: 'qa',
             stepType: activeStepType,
-            primaryCommand: 'run_support_v5_infra_repair',
-            nextCommands: ['rerun_puppeteer_compile_startup_preflight', 'repair_harness_or_cache_only', 'record_infra_artifact'],
-            requiredEvidence: ['preflight log', 'compile/startup/browser status', 'new infra blocker hash or pass'],
+            primaryCommand: preflightNextCommand || (compileOnly ? 'run_support_v5_compile_repair' : 'run_support_v5_infra_repair'),
+            nextCommands: Array.from(new Set([
+                preflightNextCommand || (compileOnly ? 'run_support_v5_compile_repair' : 'run_support_v5_infra_repair'),
+                'rerun_puppeteer_compile_startup_preflight',
+                compileOnly ? 'repair_compile_or_cache_only' : 'repair_harness_or_cache_only',
+                'record_infra_artifact'
+            ])),
+            requiredEvidence: repairGate.preflightGate.requiredEvidence.length
+                ? repairGate.preflightGate.requiredEvidence
+                : ['preflight log', 'compile/startup/browser status', 'new infra blocker hash or pass'],
             blockers: repairGate.blockers,
             forbiddenActions: ['Do not charge infra failures as product-code repair failures.']
         });