@resolveio/server-lib 22.3.211 → 22.3.212

package/package.json

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

package/util/support-runner-v5.js

@@ -1458,6 +1458,174 @@ function buildResolveIOSupportDiagnosisEvidencePack(input) {
         generatedAt: generatedAt
     };
 }
+function inferResolveIOSupportIssueClassFromText(value) {
+    var text = cleanText(value, 3000).toLowerCase();
+    if (/\b(upload|import|csv|spreadsheet|attachment|file)\b/.test(text)) {
+        return 'upload_import';
+    }
+    if (/\b(invoice|pdf|export|print|printed|report|download)\b/.test(text)) {
+        return 'invoice_pdf_export';
+    }
+    if (/\b(filter|query|search|wrong customer|wrong account|mismatch)\b/.test(text)) {
+        return 'filter_query_mismatch';
+    }
+    if (/\b(route|auth|permission|login|hydrate|hydration|blank page|shell)\b/.test(text)) {
+        return 'route_auth_hydration';
+    }
+    if (/\b(slow|timeout|performance|latency|takes too long|hang)\b/.test(text)) {
+        return 'slow_query_performance';
+    }
+    if (/\b(submit|save|click|button|no-op|does nothing|not saving)\b/.test(text)) {
+        return 'no_op_submit';
+    }
+    return 'missing_wrong_data';
+}
+function firstSupportDiagnosisText() {
+    var e_5, _a;
+    var values = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        values[_i] = arguments[_i];
+    }
+    try {
+        for (var values_2 = __values(values), values_2_1 = values_2.next(); !values_2_1.done; values_2_1 = values_2.next()) {
+            var value = values_2_1.value;
+            var text = cleanText(value, 1400);
+            if (text && !supportDiagnosisTextLooksGeneric(text, 12)) {
+                return text;
+            }
+        }
+    }
+    catch (e_5_1) { e_5 = { error: e_5_1 }; }
+    finally {
+        try {
+            if (values_2_1 && !values_2_1.done && (_a = values_2.return)) _a.call(values_2);
+        }
+        finally { if (e_5) throw e_5.error; }
+    }
+    return '';
+}
+function extractSupportDiagnosisLineValue(text, label, max) {
+    if (max === void 0) { max = 1000; }
+    var escaped = label.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    var match = String(text || '').match(new RegExp("(?:^|\\n)\\s*".concat(escaped, "\\s*:\\s*([^\\n]+)"), 'i'));
+    return cleanText(match === null || match === void 0 ? void 0 : match[1], max);
+}
+function inferSupportDiagnosisRouteModuleFromOwners(ownerFiles, text) {
+    var joinedOwners = ownerFiles.join('\n');
+    if (/part\/detail|part-detail|inventory/i.test("".concat(joinedOwners, "\n").concat(text))) {
+        return 'H2SKO part inventory detail / inventory print workflow';
+    }
+    if (/document\/pick-ticket|pick-ticket/i.test(joinedOwners)) {
+        return 'H2SKO pick-ticket print/report workflow';
+    }
+    if (/invoice/i.test("".concat(joinedOwners, "\n").concat(text))) {
+        return 'invoice/PDF/export workflow';
+    }
+    if (/upload|import/i.test("".concat(joinedOwners, "\n").concat(text))) {
+        return 'upload/import workflow';
+    }
+    return firstSupportDiagnosisText(extractSupportDiagnosisLineValue(text, 'Route'), extractSupportDiagnosisLineValue(text, 'Module'));
+}
+function buildSupportDiagnosisProofPlanScaffold(issueClass, complaint, routeModule) {
+    var target = cleanText(routeModule || complaint || 'the reported workflow', 300);
+    if (issueClass === 'upload_import') {
+        return {
+            before: 'Capture the target records/counts before re-running the customer import.',
+            before_state_unavailable_reason: '',
+            action: "Run the same upload/import path for ".concat(target, " with the staged customer attachment or an equivalent ticket fixture."),
+            after: 'Every expected imported row is attached/persisted with the correct relationships and no silently skipped rows.',
+            business_assertion: 'The import creates or updates all ticket-expected records, not just a successful upload shell.',
+            route: target,
+            data_assertion: 'Mongo/DOM row counts and representative imported records match the attachment contents.',
+            artifact_expectation: 'before count JSON, import action trace/screenshot, after count JSON, representative imported record proof',
+            business_proof_contract: {
+                issue_class: issueClass,
+                setup_state: 'Customer attachment or localhost fixture is available before import.',
+                action_under_test: 'Execute the import workflow end to end.',
+                expected_business_state_change: 'All expected rows/relationships exist after import.',
+                prohibited_false_pass: 'Upload completion, route load, screenshot, scorecard, or model claim alone is not acceptance.',
+                proof_artifacts: ['before Mongo/data snapshot', 'import action trace or screenshot', 'after Mongo/data snapshot', 'row-level mismatch report'],
+                data_or_dom_assertion: 'Imported record counts and key fields match the source attachment.'
+            }
+        };
+    }
+    var action = issueClass === 'invoice_pdf_export'
+        ? "Run the print/report/export path for ".concat(target, " using the named customer record.")
+        : issueClass === 'filter_query_mismatch'
+            ? "Run the filtered/search/query workflow for ".concat(target, " using the named customer/account context.")
+            : "Run the exact customer-reported workflow for ".concat(target, ".");
+    return {
+        before: 'Capture the customer-reported wrong/missing value before repair using the staged ticket context.',
+        before_state_unavailable_reason: '',
+        action: action,
+        after: 'The same workflow shows the expected customer/account data and no longer shows the wrong value.',
+        business_assertion: 'The reported business value is correct after the action, not merely that the route loaded.',
+        route: target,
+        data_assertion: 'DOM/print/report output and persisted source data agree for the named customer record.',
+        artifact_expectation: 'before screenshot/data snapshot, action trace, after screenshot/data snapshot, AIQaBusinessAssertion JSON',
+        business_proof_contract: {
+            issue_class: issueClass,
+            setup_state: 'The named customer record is present in the staged support data before action.',
+            action_under_test: action,
+            expected_business_state_change: 'The visible/output business data matches the expected persisted value.',
+            prohibited_false_pass: 'Route load, screenshot-only proof, scorecard pass, or model claim alone is not acceptance.',
+            proof_artifacts: ['before DOM/data snapshot', 'action trace/screenshot', 'after DOM/data snapshot', 'Mongo or persisted data comparison'],
+            data_or_dom_assertion: 'The displayed/output value matches the expected persisted customer value.'
+        }
+    };
+}
+function buildResolveIOSupportDiagnosisRetryScaffold(input) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    var existing = normalizeResolveIOSupportDiagnosisGate(input.diagnosisGate, input.now);
+    var scopeText = cleanText([
+        (_a = input.bundle) === null || _a === void 0 ? void 0 : _a.supportV5ScopeDigest,
+        (_c = (_b = input.bundle) === null || _b === void 0 ? void 0 : _b.supportV5SupervisorState) === null || _c === void 0 ? void 0 : _c.currentGoal,
+        (_e = (_d = input.bundle) === null || _d === void 0 ? void 0 : _d.supportV5SupervisorState) === null || _e === void 0 ? void 0 : _e.approvedScope
+    ].filter(Boolean).join('\n'), 3000);
+    var ownerFiles = Array.from(new Set(__spreadArray(__spreadArray([], __read(cleanList(existing === null || existing === void 0 ? void 0 : existing.owner_files, 8, 500)), false), __read(cleanList((_f = input.evidencePack) === null || _f === void 0 ? void 0 : _f.ownerFileHints, 8, 500)), false).map(normalizeOwnerFilePath).filter(Boolean))).slice(0, 8);
+    var complaint = firstSupportDiagnosisText(existing === null || existing === void 0 ? void 0 : existing.issue_case.customer_complaint, extractSupportDiagnosisLineValue(scopeText, 'Customer complaint'), extractSupportDiagnosisLineValue(scopeText, 'Issue'), extractSupportDiagnosisLineValue(scopeText, 'Approved scope'), scopeText);
+    var issueClass = normalizeIssueClass((existing === null || existing === void 0 ? void 0 : existing.issue_class) || ((_g = input.evidencePack) === null || _g === void 0 ? void 0 : _g.issueClassHint))
+        || inferResolveIOSupportIssueClassFromText("".concat(scopeText, "\n").concat(ownerFiles.join('\n')));
+    var routeModule = firstSupportDiagnosisText(existing === null || existing === void 0 ? void 0 : existing.issue_case.route_module, inferSupportDiagnosisRouteModuleFromOwners(ownerFiles, scopeText), extractSupportDiagnosisLineValue(scopeText, 'Route'), extractSupportDiagnosisLineValue(scopeText, 'Module'));
+    var expected = firstSupportDiagnosisText(existing === null || existing === void 0 ? void 0 : existing.issue_case.expected_result, extractSupportDiagnosisLineValue(scopeText, 'Expected'), complaint ? "The customer-reported workflow should use the correct business data for: ".concat(complaint) : '');
+    var observed = firstSupportDiagnosisText(existing === null || existing === void 0 ? void 0 : existing.issue_case.observed_result, extractSupportDiagnosisLineValue(scopeText, 'Observed'), complaint ? "The observed behavior is the customer report that needs reproduction: ".concat(complaint) : '');
+    var accountContext = firstSupportDiagnosisText(existing === null || existing === void 0 ? void 0 : existing.issue_case.account_customer_context, extractSupportDiagnosisLineValue(scopeText, 'Client'), extractSupportDiagnosisLineValue(scopeText, 'Customer'), extractSupportDiagnosisLineValue(scopeText, 'Reporter'), (_j = (_h = input.bundle) === null || _h === void 0 ? void 0 : _h.supportV5SupervisorState) === null || _j === void 0 ? void 0 : _j.currentGoal);
+    var proofPlan = (existing === null || existing === void 0 ? void 0 : existing.proof_plan) && (existing.proof_plan.action || existing.proof_plan.business_assertion)
+        ? existing.proof_plan
+        : buildSupportDiagnosisProofPlanScaffold(issueClass, complaint, routeModule);
+    return {
+        instruction: 'Starter only. Replace scaffolded guesses with verified ticket/code/browser/Mongo/log evidence before returning support_diagnosis_gate. Do not copy TODO/placeholder text and do not leave strings blank.',
+        support_diagnosis_gate: {
+            issue_case: {
+                customer_complaint: complaint || 'TODO: restate the customer complaint from the staged ticket/email.',
+                expected_result: expected || 'TODO: state the customer-visible expected business result.',
+                observed_result: observed || 'TODO: state the reproduced or classified wrong behavior.',
+                route_module: routeModule || 'TODO: identify the exact route/module/workflow.',
+                account_customer_context: accountContext || 'TODO: name the affected client/account/user context.',
+                reproduction_status: (existing === null || existing === void 0 ? void 0 : existing.issue_case.reproduction_status) || 'blocked',
+                reproduction_blocker: (existing === null || existing === void 0 ? void 0 : existing.issue_case.reproduction_blocker) || 'TODO: replace with blocker only if reproduction cannot be performed.'
+            },
+            issue_class: issueClass,
+            accepted_hypothesis: {
+                statement: firstSupportDiagnosisText(existing === null || existing === void 0 ? void 0 : existing.accepted_hypothesis.statement) || 'TODO: one falsifiable root-cause theory backed by current-ticket evidence.',
+                falsifiable_test: firstSupportDiagnosisText(existing === null || existing === void 0 ? void 0 : existing.accepted_hypothesis.falsifiable_test) || 'TODO: exact test that would prove this hypothesis wrong.',
+                evidence: cleanList(existing === null || existing === void 0 ? void 0 : existing.accepted_hypothesis.evidence, 6, 800)
+            },
+            rejected_alternatives: cleanList(existing === null || existing === void 0 ? void 0 : existing.rejected_alternatives, 4, 800),
+            failing_path: (existing === null || existing === void 0 ? void 0 : existing.failing_path) || {
+                frontend: '',
+                backend: '',
+                shared_library: '',
+                data_query: '',
+                description: routeModule || complaint || ''
+            },
+            owner_files: ownerFiles,
+            proof_plan: proofPlan,
+            evidence: (existing === null || existing === void 0 ? void 0 : existing.evidence) || [],
+            status: 'incomplete'
+        }
+    };
+}
 function normalizeSupportDiagnosisBusinessProofContract(value, issueClassHint) {
     var source = cleanObject(value);
     if (!Object.keys(source).length) {
@@ -1530,14 +1698,14 @@ function supportDiagnosisLooksLikeClassifiedFeatureRequest(source, issueCaseText
     return /\b(feature request|feature_request|new feature|requested behavior change|net-new|net new|not implemented|no existing|none_existing|does not exist|no .*route)\b/i.test(combined);
 }
 function normalizeSupportDiagnosisRejectedAlternatives(values) {
-    var e_5, _a;
+    var e_6, _a;
     if (!Array.isArray(values)) {
         return cleanList(values, 10, 700);
     }
     var result = [];
     try {
-        for (var values_2 = __values(values), values_2_1 = values_2.next(); !values_2_1.done; values_2_1 = values_2.next()) {
-            var value = values_2_1.value;
+        for (var values_3 = __values(values), values_3_1 = values_3.next(); !values_3_1.done; values_3_1 = values_3.next()) {
+            var value = values_3_1.value;
             var text = supportDiagnosisNarrativeText(value, 700);
             if (text && !result.includes(text)) {
                 result.push(text);
@@ -1547,25 +1715,25 @@ function normalizeSupportDiagnosisRejectedAlternatives(values) {
             }
         }
     }
-    catch (e_5_1) { e_5 = { error: e_5_1 }; }
+    catch (e_6_1) { e_6 = { error: e_6_1 }; }
     finally {
         try {
-            if (values_2_1 && !values_2_1.done && (_a = values_2.return)) _a.call(values_2);
+            if (values_3_1 && !values_3_1.done && (_a = values_3.return)) _a.call(values_3);
         }
-        finally { if (e_5) throw e_5.error; }
+        finally { if (e_6) throw e_6.error; }
     }
     return result;
 }
 function normalizeSupportDiagnosisProofPlanRows(values) {
-    var e_6, _a;
+    var e_7, _a;
     if (!Array.isArray(values)) {
         return {};
     }
     var actions = [];
     var proofRequired = [];
     try {
-        for (var values_3 = __values(values), values_3_1 = values_3.next(); !values_3_1.done; values_3_1 = values_3.next()) {
-            var row = values_3_1.value;
+        for (var values_4 = __values(values), values_4_1 = values_4.next(); !values_4_1.done; values_4_1 = values_4.next()) {
+            var row = values_4_1.value;
             var source = cleanObject(row);
             var action = pickText(source, ['action', 'step', 'browser_action', 'browserAction', 'task'], 500) || supportDiagnosisNarrativeText(row, 500);
             var proof = pickText(source, ['proof_required', 'proofRequired', 'expected', 'expected_result', 'expectedResult', 'assertion', 'business_assertion', 'businessAssertion'], 700);
@@ -1577,12 +1745,12 @@ function normalizeSupportDiagnosisProofPlanRows(values) {
             }
         }
     }
-    catch (e_6_1) { e_6 = { error: e_6_1 }; }
+    catch (e_7_1) { e_7 = { error: e_7_1 }; }
     finally {
         try {
-            if (values_3_1 && !values_3_1.done && (_a = values_3.return)) _a.call(values_3);
+            if (values_4_1 && !values_4_1.done && (_a = values_4.return)) _a.call(values_4);
         }
-        finally { if (e_6) throw e_6.error; }
+        finally { if (e_7) throw e_7.error; }
     }
     return {
         action: actions.join(' | ').slice(0, 1000),
@@ -1592,7 +1760,7 @@ function normalizeSupportDiagnosisProofPlanRows(values) {
     };
 }
 function normalizeOwnerFilePath(value) {
-    var e_7, _a;
+    var e_8, _a;
     var normalized = cleanListEntryText(value, 500)
         .replace(/\\/g, '/')
         .replace(/^\.\/+/, '')
@@ -1617,12 +1785,12 @@ function normalizeOwnerFilePath(value) {
             }
         }
     }
-    catch (e_7_1) { e_7 = { error: e_7_1 }; }
+    catch (e_8_1) { e_8 = { error: e_8_1 }; }
     finally {
         try {
             if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
         }
-        finally { if (e_7) throw e_7.error; }
+        finally { if (e_8) throw e_8.error; }
     }
     return normalized;
 }
@@ -1631,7 +1799,7 @@ function isResolveIOSupportGeneratedAngularWrapperPath(value) {
     return /(?:^|\/)angular\/app\/(?:methods|publications)\.ts$/i.test(normalized);
 }
 function ownerFileComparablePathKeys(value) {
-    var e_8, _a;
+    var e_9, _a;
     var normalized = normalizeOwnerFilePath(value);
     if (!normalized) {
         return [];
@@ -1653,12 +1821,12 @@ function ownerFileComparablePathKeys(value) {
             }
         }
     }
-    catch (e_8_1) { e_8 = { error: e_8_1 }; }
+    catch (e_9_1) { e_9 = { error: e_9_1 }; }
     finally {
         try {
             if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
         }
-        finally { if (e_8) throw e_8.error; }
+        finally { if (e_9) throw e_9.error; }
     }
     return Array.from(keys);
 }
@@ -1710,7 +1878,7 @@ function supportDiagnosisTextLooksGeneric(value, minimumLength) {
     return compact.length < minimumLength
         || meaningfulWords.length < 3
         || /^(n a|na|none|null|unknown|todo|tbd|pending|fix|bug|issue|problem|broken|not working|works|should work)$/i.test(compact)
-        || /\b(todo|tbd|placeholder|unknown|guess|maybe|probably|something|somewhere|stuff|things?)\b/i.test(compact)
+        || /\b(todo|tbd|placeholder|replace with|do not copy|do not leave blank|ticket specific|unknown|guess|maybe|probably|something|somewhere|stuff|things?)\b/i.test(compact)
         || /^(fix|debug|investigate|check|look into|test|verify)( the)? (issue|bug|problem|ticket|route|page)$/i.test(compact)
         || /^(the )?(issue|bug|problem|ticket|route|page)( is)? (fixed|broken|not working|wrong)$/i.test(compact);
 }
@@ -2130,7 +2298,7 @@ function normalizeResolveIOSupportDiagnosisGate(value, now) {
     return gate;
 }
 function extractResolveIOSupportDiagnosisGateFromText(value, now) {
-    var e_9, _a;
+    var e_10, _a;
     var text = String(value || '').trim();
     if (!text) {
         return undefined;
@@ -2158,12 +2326,12 @@ function extractResolveIOSupportDiagnosisGateFromText(value, now) {
             }
         }
     }
-    catch (e_9_1) { e_9 = { error: e_9_1 }; }
+    catch (e_10_1) { e_10 = { error: e_10_1 }; }
     finally {
         try {
             if (candidates_1_1 && !candidates_1_1.done && (_a = candidates_1.return)) _a.call(candidates_1);
         }
-        finally { if (e_9) throw e_9.error; }
+        finally { if (e_10) throw e_10.error; }
     }
     return undefined;
 }
@@ -2326,7 +2494,7 @@ function supportStatusLooksPassed(value) {
     return /\b(pass|passed|success|succeeded|complete|completed|ready|not_required|not required)\b/i.test(cleanText(value, 200));
 }
 function nestedObject(source) {
-    var e_10, _a;
+    var e_11, _a;
     var keys = [];
     for (var _i = 1; _i < arguments.length; _i++) {
         keys[_i - 1] = arguments[_i];
@@ -2340,17 +2508,17 @@ function nestedObject(source) {
             }
         }
     }
-    catch (e_10_1) { e_10 = { error: e_10_1 }; }
+    catch (e_11_1) { e_11 = { error: e_11_1 }; }
     finally {
         try {
             if (keys_1_1 && !keys_1_1.done && (_a = keys_1.return)) _a.call(keys_1);
         }
-        finally { if (e_10) throw e_10.error; }
+        finally { if (e_11) throw e_11.error; }
     }
     return {};
 }
 function resolveSupportReplyReleaseGate(input) {
-    var e_11, _a;
+    var e_12, _a;
     var _b;
     var releaseEvidence = cleanObject(input.releaseEvidence);
     var releaseStatus = cleanText(input.releaseStatus
@@ -2421,12 +2589,12 @@ function resolveSupportReplyReleaseGate(input) {
             blockers.push("missing_".concat(field));
         }
     }
-    catch (e_11_1) { e_11 = { error: e_11_1 }; }
+    catch (e_12_1) { e_12 = { error: e_12_1 }; }
     finally {
         try {
             if (missingCommitProofFields_1_1 && !missingCommitProofFields_1_1.done && (_a = missingCommitProofFields_1.return)) _a.call(missingCommitProofFields_1);
         }
-        finally { if (e_11) throw e_11.error; }
+        finally { if (e_12) throw e_12.error; }
     }
     var shouldEvaluateHotfix = statusBlocked || commitProofRequired || Object.keys(hotfixEvidence).length > 0;
     var hotfixContinuation = shouldEvaluateHotfix
@@ -2472,7 +2640,7 @@ function supportBusinessAssertionRouteOnly(value) {
     return /^(route_probe_pass|route_only_pass|route_pass|route_probe|route_loaded)$/i.test(cleanText(value, 80));
 }
 function normalizeSupportBusinessProofAssertions(input) {
-    var e_12, _a;
+    var e_13, _a;
     var gate = normalizeResolveIOSupportDiagnosisGate(input.diagnosisGate);
     var proofPlan = gate === null || gate === void 0 ? void 0 : gate.proof_plan;
     var proofContract = proofPlan === null || proofPlan === void 0 ? void 0 : proofPlan.business_proof_contract;
@@ -2506,12 +2674,12 @@ function normalizeSupportBusinessProofAssertions(input) {
             });
         }
     }
-    catch (e_12_1) { e_12 = { error: e_12_1 }; }
+    catch (e_13_1) { e_13 = { error: e_13_1 }; }
     finally {
         try {
             if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
         }
-        finally { if (e_12) throw e_12.error; }
+        finally { if (e_13) throw e_13.error; }
     }
     var status = cleanText(input.businessAssertionStatus || input.outcomeLabel, 80);
     if (!assertions.length && (supportBusinessAssertionPassed(status) || supportBusinessAssertionRouteOnly(status) || supportBusinessAssertionFailed(status))) {
@@ -2601,7 +2769,7 @@ function supportBusinessProofAssertionHasStructuredContractMapping(assertion, ga
     return routeMatches && actionMatches && expectedStateMatches && hasBusinessDataProof;
 }
 function supportBusinessProofAssertionMatchesContract(assertion, gate) {
-    var e_13, _a;
+    var e_14, _a;
     if (!gate) {
         return false;
     }
@@ -2641,12 +2809,12 @@ function supportBusinessProofAssertionMatchesContract(assertion, gate) {
             }
         }
     }
-    catch (e_13_1) { e_13 = { error: e_13_1 }; }
+    catch (e_14_1) { e_14 = { error: e_14_1 }; }
     finally {
         try {
             if (proofWords_1_1 && !proofWords_1_1.done && (_a = proofWords_1.return)) _a.call(proofWords_1);
         }
-        finally { if (e_13) throw e_13.error; }
+        finally { if (e_14) throw e_14.error; }
     }
     return overlap >= Math.min(5, Math.max(3, Math.ceil(proofWords.size * 0.45)));
 }
@@ -4171,7 +4339,7 @@ function supportManagerRequiredResetEvidenceForContract(contract) {
     ], false))).slice(0, 16);
 }
 function validateResolveIOSupportNextActionContract(value) {
-    var e_14, _a;
+    var e_15, _a;
     var _b, _c, _d, _e, _f;
     var contract = cleanObject(value);
     var blockers = [];
@@ -4193,12 +4361,12 @@ function validateResolveIOSupportNextActionContract(value) {
             }
         }
     }
-    catch (e_14_1) { e_14 = { error: e_14_1 }; }
+    catch (e_15_1) { e_15 = { error: e_15_1 }; }
     finally {
         try {
             if (requiredStringFields_1_1 && !requiredStringFields_1_1.done && (_a = requiredStringFields_1.return)) _a.call(requiredStringFields_1);
         }
-        finally { if (e_14) throw e_14.error; }
+        finally { if (e_15) throw e_15.error; }
     }
     if (!Array.isArray(contract.nextCommands) || !contract.nextCommands.length) {
         blockers.push('NextActionContract.nextCommands must include at least the primary command.');
@@ -5217,7 +5385,7 @@ function buildResolveIOSupportV5ScopeDigest(input) {
     return raw.slice(0, maxChars);
 }
 function buildResolveIOSupportV5MicrotaskLedger(input) {
-    var e_15, _a;
+    var e_16, _a;
     var existing = Array.isArray(input.existing) ? input.existing : [];
     var completedByObjective = new Map();
     try {
@@ -5228,12 +5396,12 @@ function buildResolveIOSupportV5MicrotaskLedger(input) {
             }
         }
     }
-    catch (e_15_1) { e_15 = { error: e_15_1 }; }
+    catch (e_16_1) { e_16 = { error: e_16_1 }; }
     finally {
         try {
             if (existing_1_1 && !existing_1_1.done && (_a = existing_1.return)) _a.call(existing_1);
         }
-        finally { if (e_15) throw e_15.error; }
+        finally { if (e_16) throw e_16.error; }
     }
     var now = isoNow(input.now);
     var requirements = cleanList(input.requirements, 30, 240);
@@ -6802,6 +6970,14 @@ function buildResolveIOSupportV5MicrotaskPrompt(input) {
         ownerFiles: (diagnosisGate === null || diagnosisGate === void 0 ? void 0 : diagnosisGate.owner_files) || targetFiles,
         text: input.bundle.supportV5ScopeDigest || input.bundle.supportV5SupervisorState.currentGoal
     });
+    var diagnosisRetryScaffold = diagnosisActive
+        ? buildResolveIOSupportDiagnosisRetryScaffold({
+            bundle: input.bundle,
+            diagnosisGate: diagnosisGate,
+            evidencePack: diagnosisEvidencePack,
+            now: input.now
+        })
+        : undefined;
     var promptProbePlanValidation = validateResolveIOSupportIssueClassProbePlan(input.bundle.supportV5IssueClassProbePlan, diagnosisValidation.normalized || diagnosisGate, input.now);
     var promptProbePlan = promptProbePlanValidation.valid
         ? promptProbePlanValidation.normalized
@@ -6848,7 +7024,8 @@ function buildResolveIOSupportV5MicrotaskPrompt(input) {
             name: 'root_cause_first_diagnosis_contract',
             text: [
                 'Before any product-code repair, produce strict JSON only:',
-                '{"support_diagnosis_gate":{"issue_case":{"customer_complaint":"","expected_result":"","observed_result":"","route_module":"","account_customer_context":"","reproduction_status":"reproduced|blocked|classified","reproduction_blocker":""},"issue_class":"no_op_submit|missing_wrong_data|filter_query_mismatch|invoice_pdf_export|upload_import|route_auth_hydration|slow_query_performance","accepted_hypothesis":{"statement":"","falsifiable_test":"","evidence":[""]},"rejected_alternatives":[""],"failing_path":{"frontend":"","backend":"","shared_library":"","data_query":"","description":""},"owner_files":["small/exact/file.ts"],"proof_plan":{"before":"","before_state_unavailable_reason":"","action":"","after":"","business_assertion":"","route":"","data_assertion":"","artifact_expectation":"","business_proof_contract":{"issue_class":"same as diagnosis issue_class","setup_state":"","action_under_test":"","expected_business_state_change":"","prohibited_false_pass":"Route load, screenshot, scorecard, or model claim alone is not acceptance.","proof_artifacts":["browser trace/screenshot/json/mongo delta"],"data_or_dom_assertion":""}},"similar_tickets":[],"similar_commits":[],"evidence":[{"type":"ticket|browser|mongo|log|code|commit|qa|other","summary":"","artifactPath":""}],"status":"passed"}}',
+                'Required JSON shape: {"support_diagnosis_gate":{"issue_case":{"customer_complaint":"concrete customer complaint","expected_result":"concrete expected business result","observed_result":"concrete observed/reproduced behavior","route_module":"exact route/module/workflow","account_customer_context":"affected client/account/user","reproduction_status":"reproduced|blocked|classified","reproduction_blocker":"required only when blocked"},"issue_class":"no_op_submit|missing_wrong_data|filter_query_mismatch|invoice_pdf_export|upload_import|route_auth_hydration|slow_query_performance","accepted_hypothesis":{"statement":"one falsifiable root-cause theory","falsifiable_test":"exact test that could disprove it","evidence":["typed evidence with artifact path or concrete code/data citation"]},"rejected_alternatives":["rejected theory plus why"],"failing_path":{"frontend":"frontend event/path if applicable","backend":"method/publication/query if applicable","shared_library":"shared library path if applicable","data_query":"data/query path if applicable","description":"end-to-end failing path"},"owner_files":["small/exact/product-file.ts"],"proof_plan":{"before":"before-state business proof","before_state_unavailable_reason":"only if before proof cannot exist","action":"exact user/system action","after":"expected after-state business proof","business_assertion":"pass/fail assertion tied to customer issue","route":"route/workflow under test","data_assertion":"DOM/data/Mongo assertion","artifact_expectation":"specific artifacts to capture","business_proof_contract":{"issue_class":"same as diagnosis issue_class","setup_state":"setup state","action_under_test":"action under test","expected_business_state_change":"expected state change","prohibited_false_pass":"Route load, screenshot, scorecard, or model claim alone is not acceptance.","proof_artifacts":["specific DOM/data/Mongo/network/screenshot artifacts"],"data_or_dom_assertion":"assertion checked in DOM/data/Mongo"}},"similar_tickets":[],"similar_commits":[],"evidence":[{"type":"ticket|browser|mongo|log|code|commit|qa|other","summary":"concrete evidence summary","artifactPath":"path or code reference"}],"status":"passed"}}',
+                'Do not copy schema/example wording into the output. Empty strings, TODOs, placeholders, route-only proof, and ticket-only proof will fail validation.',
                 'Owner files must be a small exact editable set, not directories, globs, generated wrappers, or broad repo areas.',
                 'The accepted hypothesis must be falsifiable and backed by evidence; prior similar tickets or commits are hints only and cannot bypass fresh diagnosis.',
                 'For reproduction_status="reproduced", evidence must include at least one browser, Mongo, log, or QA evidence object with artifactPath so the runner can replay the proof.',
@@ -6918,6 +7095,10 @@ function buildResolveIOSupportV5MicrotaskPrompt(input) {
                 instruction: 'This JSON block is the diagnosis evidence pack. Do not request or invent a support-diagnosis-pack JSON file unless a concrete named ticket attachment/log is still absent from the staged support evidence context.'
             }, null, 2)
         } : undefined,
+        diagnosisActive && diagnosisRetryScaffold ? {
+            name: 'diagnosis_retry_scaffold',
+            text: JSON.stringify(diagnosisRetryScaffold, null, 2)
+        } : undefined,
         diagnosisActive && similarCaseHintsText ? {
             name: 'similar_accepted_fix_hints',
             text: similarCaseHintsText
@@ -7024,7 +7205,7 @@ function buildResolveIOSupportV5MicrotaskPrompt(input) {
     };
 }
 function summarizeResolveIOSupportV5MicrotaskUsage(bundle) {
-    var e_16, _a, e_17, _b;
+    var e_17, _a, e_18, _b;
     var byMicrotask = new Map();
     var bySection = new Map();
     var totalPromptTokenEstimate = 0;
@@ -7039,17 +7220,17 @@ function summarizeResolveIOSupportV5MicrotaskUsage(bundle) {
             existing.calls += 1;
             byMicrotask.set(usage.microtaskId, existing);
             try {
-                for (var _e = (e_17 = void 0, __values(usage.promptSections || [])), _f = _e.next(); !_f.done; _f = _e.next()) {
+                for (var _e = (e_18 = void 0, __values(usage.promptSections || [])), _f = _e.next(); !_f.done; _f = _e.next()) {
                     var section = _f.value;
                     bySection.set(section.name, (bySection.get(section.name) || 0) + section.tokenEstimate);
                 }
             }
-            catch (e_17_1) { e_17 = { error: e_17_1 }; }
+            catch (e_18_1) { e_18 = { error: e_18_1 }; }
             finally {
                 try {
                     if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
                 }
-                finally { if (e_17) throw e_17.error; }
+                finally { if (e_18) throw e_18.error; }
             }
             var hardCap = usage.lane === 'qa' ? promptBudget.qaMicrotaskHardCap : promptBudget.buildMicrotaskHardCap;
             if ((usage.promptTokenEstimate || 0) > hardCap) {
@@ -7057,12 +7238,12 @@ function summarizeResolveIOSupportV5MicrotaskUsage(bundle) {
             }
         }
     }
-    catch (e_16_1) { e_16 = { error: e_16_1 }; }
+    catch (e_17_1) { e_17 = { error: e_17_1 }; }
     finally {
         try {
             if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
         }
-        finally { if (e_16) throw e_16.error; }
+        finally { if (e_17) throw e_17.error; }
     }
     return {
         totalPromptTokenEstimate: totalPromptTokenEstimate,