@resolveio/server-lib 22.3.192 → 22.3.194

package/util/support-runner-v5.js

@@ -57,6 +57,8 @@ exports.validateResolveIOSupportDiagnosisGate = validateResolveIOSupportDiagnosi
 exports.evaluateResolveIOSupportBusinessProofReadiness = evaluateResolveIOSupportBusinessProofReadiness;
 exports.buildResolveIOSupportClarificationContract = buildResolveIOSupportClarificationContract;
 exports.validateResolveIOSupportClarificationContract = validateResolveIOSupportClarificationContract;
+exports.buildResolveIOSupportCustomerReplyReadinessContract = buildResolveIOSupportCustomerReplyReadinessContract;
+exports.validateResolveIOSupportCustomerReplyReadinessContract = validateResolveIOSupportCustomerReplyReadinessContract;
 exports.decideResolveIOSupportCustomerReplyPolicy = decideResolveIOSupportCustomerReplyPolicy;
 exports.buildResolveIOSupportIssueClassProbes = buildResolveIOSupportIssueClassProbes;
 exports.validateResolveIOSupportIssueClassProbePlan = validateResolveIOSupportIssueClassProbePlan;
@@ -1752,6 +1754,185 @@ function buildResolveIOSupportHumanReviewPacket(input) {
         createdAt: isoNow(input.now)
     };
 }
+function supportCustomerReplyReadinessStatusFromReason(reason) {
+    var statusByReason = {
+        support_reply_clarification_contract_invalid: 'internal_blocked',
+        support_reply_waiting_on_customer_reproduction_detail: 'clarification_required',
+        support_reply_blocked_until_diagnosis_gate_validates: 'blocked_until_diagnosis',
+        support_reply_requires_valid_issue_class_probe_plan: 'blocked_until_probe_plan',
+        support_reply_blocked_by_confidence_gate: 'blocked_until_confidence',
+        support_reply_requires_high_confidence: 'blocked_until_confidence',
+        support_reply_blocked_by_unresolved_runner_blocker: 'blocked_until_runner_blocker',
+        support_reply_blocked_until_release_or_hotfix_gate_finishes: 'blocked_until_release_hotfix',
+        support_reply_rejects_route_only_business_proof: 'blocked_until_business_proof',
+        support_reply_requires_business_assertion_pass: 'blocked_until_business_proof',
+        support_reply_requires_business_proof_contract_artifact: 'blocked_until_business_proof_artifact',
+        support_reply_resolution_draft_allowed_after_business_proof: 'draft_ready'
+    };
+    return statusByReason[reason] || 'internal_blocked';
+}
+function supportCustomerReplyReadinessDefaultPrimaryCommand(status, policy) {
+    var reviewPacket = policy.humanReviewPacket;
+    var preferred = cleanText(reviewPacket === null || reviewPacket === void 0 ? void 0 : reviewPacket.primaryAction, 160);
+    if (preferred) {
+        return preferred;
+    }
+    switch (status) {
+        case 'draft_ready':
+            return 'review_customer_reply';
+        case 'clarification_required':
+            return 'review_customer_clarification';
+        case 'blocked_until_diagnosis':
+            return 'run_support_v5_read_only_diagnosis_gate';
+        case 'blocked_until_probe_plan':
+            return 'repair_support_issue_class_probe_plan';
+        case 'blocked_until_confidence':
+            return 'review_support_confidence_evidence';
+        case 'blocked_until_release_hotfix':
+            return 'repair_release_hotfix_first';
+        case 'blocked_until_business_proof':
+            return 'run_support_v5_business_proof_qa_row';
+        case 'blocked_until_business_proof_artifact':
+            return 'record_business_proof_artifact';
+        case 'blocked_until_runner_blocker':
+            return 'review_support_runner_blocker';
+        case 'blocked_until_human_approval':
+            return 'review_customer_reply';
+        case 'internal_blocked':
+        default:
+            return 'review_support_runner_blocker';
+    }
+}
+function buildResolveIOSupportCustomerReplyReadinessContract(input) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
+    var policy = input.policy;
+    var reviewPacket = policy.humanReviewPacket;
+    var reason = cleanText(policy.reason, 500);
+    var rawCanSend = policy.canSendCustomerReply === true || (reviewPacket === null || reviewPacket === void 0 ? void 0 : reviewPacket.customerSendAllowed) === true;
+    var businessProofReady = ((_a = input.businessProofReadiness) === null || _a === void 0 ? void 0 : _a.ready) === true
+        || (policy.action === 'draft_resolution_reply' && (((_b = policy.draftBasis) === null || _b === void 0 ? void 0 : _b.artifactCount) || 0) > 0);
+    var releaseReady = ((_c = input.releaseGate) === null || _c === void 0 ? void 0 : _c.blocked) !== true;
+    var diagnosisReady = ((_d = input.diagnosisValidation) === null || _d === void 0 ? void 0 : _d.valid) === true || policy.action === 'draft_resolution_reply';
+    var issueClassProbePlanReady = ((_e = input.issueClassProbePlanValidation) === null || _e === void 0 ? void 0 : _e.valid) === true
+        || ((_f = policy.draftBasis) === null || _f === void 0 ? void 0 : _f.issueClassProbePlanStatus) === 'ready';
+    var initialStatus = supportCustomerReplyReadinessStatusFromReason(reason);
+    var status = rawCanSend
+        ? 'blocked_until_human_approval'
+        : initialStatus;
+    var canDraft = policy.canDraftCustomerReply === true
+        && !rawCanSend
+        && (status === 'draft_ready' || status === 'clarification_required');
+    var requiresHumanApproval = true;
+    var primaryCommand = supportCustomerReplyReadinessDefaultPrimaryCommand(status, policy);
+    var blockers = Array.from(new Set(__spreadArray(__spreadArray(__spreadArray(__spreadArray(__spreadArray([], __read(cleanList(reviewPacket === null || reviewPacket === void 0 ? void 0 : reviewPacket.blockers, 20, 500)), false), __read(cleanList((_g = input.businessProofReadiness) === null || _g === void 0 ? void 0 : _g.blockers, 20, 500)), false), __read(cleanList((_h = input.releaseGate) === null || _h === void 0 ? void 0 : _h.blockers, 20, 500)), false), __read((rawCanSend ? ['automatic_customer_send_not_allowed'] : [])), false), __read((status === 'draft_ready' ? [] : [reason || status])), false).filter(Boolean)));
+    var requiredEvidence = Array.from(new Set(__spreadArray(__spreadArray(__spreadArray(__spreadArray([], __read(cleanList(policy.requiredEvidence, 30, 500)), false), __read(cleanList(reviewPacket === null || reviewPacket === void 0 ? void 0 : reviewPacket.requiredEvidence, 30, 500)), false), __read(cleanList((_j = input.businessProofReadiness) === null || _j === void 0 ? void 0 : _j.requiredEvidence, 30, 500)), false), __read(cleanList((_k = input.releaseGate) === null || _k === void 0 ? void 0 : _k.requiredEvidence, 30, 500)), false).filter(Boolean)));
+    var evidenceRefs = Array.from(new Set(__spreadArray(__spreadArray([], __read(cleanList(reviewPacket === null || reviewPacket === void 0 ? void 0 : reviewPacket.evidenceRefs, 40, 500)), false), __read(cleanList((_l = input.businessProofReadiness) === null || _l === void 0 ? void 0 : _l.artifactPaths, 40, 500)), false).filter(Boolean)));
+    var nextCommands = Array.from(new Set(__spreadArray(__spreadArray([
+        primaryCommand
+    ], __read(cleanList(reviewPacket === null || reviewPacket === void 0 ? void 0 : reviewPacket.nextCommands, 20, 200)), false), __read(cleanList((_m = input.releaseGate) === null || _m === void 0 ? void 0 : _m.nextCommands, 20, 200)), false).filter(Boolean)));
+    var forbiddenActions = Array.from(new Set(__spreadArray([
+        'Do not send customer email without explicit human approval.',
+        'Do not claim a fix is live until release or hotfix evidence is clear.',
+        'Do not draft a resolution reply from route-load, screenshot-only, scorecard-only, or model-claim proof.'
+    ], __read(cleanList(reviewPacket === null || reviewPacket === void 0 ? void 0 : reviewPacket.forbiddenActions, 20, 500)), false)));
+    var createdAt = isoNow(input.now || (reviewPacket === null || reviewPacket === void 0 ? void 0 : reviewPacket.createdAt));
+    return {
+        contractId: "support-customer-reply-".concat(hashResolveIOSupportV5Evidence({
+            status: status,
+            policyAction: policy.action,
+            reason: reason,
+            primaryCommand: primaryCommand,
+            blockers: blockers,
+            artifactFingerprint: (_o = input.businessProofReadiness) === null || _o === void 0 ? void 0 : _o.artifactFingerprint,
+            proofFingerprint: (_p = input.businessProofReadiness) === null || _p === void 0 ? void 0 : _p.proofFingerprint,
+            createdAt: createdAt.slice(0, 16)
+        }).slice(0, 16)),
+        status: status,
+        policyAction: policy.action,
+        reviewType: (reviewPacket === null || reviewPacket === void 0 ? void 0 : reviewPacket.reviewType) || (policy.action === 'draft_resolution_reply' ? 'customer_resolution_reply' : policy.action === 'ask_clarification' ? 'customer_clarification' : 'internal_hold'),
+        primaryCommand: primaryCommand,
+        canDraftCustomerReply: canDraft,
+        canSendCustomerReply: false,
+        requiresHumanApproval: requiresHumanApproval,
+        proofBacked: status === 'draft_ready' && businessProofReady && evidenceRefs.length > 0,
+        businessProofReady: businessProofReady,
+        releaseReady: releaseReady,
+        diagnosisReady: diagnosisReady,
+        issueClassProbePlanReady: issueClassProbePlanReady,
+        clarificationRequired: status === 'clarification_required',
+        reason: reason,
+        blockers: blockers,
+        requiredEvidence: requiredEvidence,
+        evidenceRefs: evidenceRefs,
+        nextCommands: nextCommands,
+        forbiddenActions: forbiddenActions,
+        createdAt: createdAt
+    };
+}
+function validateResolveIOSupportCustomerReplyReadinessContract(value) {
+    var source = cleanObject(value);
+    var validStatuses = [
+        'draft_ready',
+        'clarification_required',
+        'blocked_until_diagnosis',
+        'blocked_until_probe_plan',
+        'blocked_until_confidence',
+        'blocked_until_runner_blocker',
+        'blocked_until_release_hotfix',
+        'blocked_until_business_proof',
+        'blocked_until_business_proof_artifact',
+        'blocked_until_human_approval',
+        'internal_blocked'
+    ];
+    var status = cleanText(source.status, 120);
+    var normalized = {
+        contractId: cleanText(source.contractId || source.contract_id, 180),
+        status: validStatuses.includes(status) ? status : 'internal_blocked',
+        policyAction: cleanText(source.policyAction || source.policy_action, 120),
+        reviewType: cleanText(source.reviewType || source.review_type, 120),
+        primaryCommand: cleanText(source.primaryCommand || source.primary_command, 180),
+        canDraftCustomerReply: source.canDraftCustomerReply === true || source.can_draft_customer_reply === true,
+        canSendCustomerReply: source.canSendCustomerReply === true || source.can_send_customer_reply === true,
+        requiresHumanApproval: source.requiresHumanApproval !== false && source.requires_human_approval !== false,
+        proofBacked: source.proofBacked === true || source.proof_backed === true,
+        businessProofReady: source.businessProofReady === true || source.business_proof_ready === true,
+        releaseReady: source.releaseReady === true || source.release_ready === true,
+        diagnosisReady: source.diagnosisReady === true || source.diagnosis_ready === true,
+        issueClassProbePlanReady: source.issueClassProbePlanReady === true || source.issue_class_probe_plan_ready === true,
+        clarificationRequired: source.clarificationRequired === true || source.clarification_required === true,
+        reason: cleanText(source.reason, 500),
+        blockers: cleanList(source.blockers, 24, 500),
+        requiredEvidence: cleanList(source.requiredEvidence || source.required_evidence, 30, 500),
+        evidenceRefs: cleanList(source.evidenceRefs || source.evidence_refs, 40, 500),
+        nextCommands: cleanList(source.nextCommands || source.next_commands, 24, 200),
+        forbiddenActions: cleanList(source.forbiddenActions || source.forbidden_actions, 24, 500),
+        createdAt: cleanText(source.createdAt || source.created_at, 120)
+    };
+    var blockers = [
+        normalized.contractId ? '' : 'Customer reply readiness contract is missing contractId.',
+        validStatuses.includes(status) ? '' : 'Customer reply readiness contract has an invalid status.',
+        normalized.policyAction ? '' : 'Customer reply readiness contract is missing policyAction.',
+        normalized.primaryCommand ? '' : 'Customer reply readiness contract is missing primaryCommand.',
+        normalized.requiresHumanApproval ? '' : 'Customer reply readiness must require human approval.',
+        normalized.canSendCustomerReply === false ? '' : 'Customer reply readiness must never allow automatic customer send.',
+        normalized.requiredEvidence.length ? '' : 'Customer reply readiness contract is missing requiredEvidence.',
+        normalized.forbiddenActions.length ? '' : 'Customer reply readiness contract is missing forbiddenActions.',
+        normalized.status === 'draft_ready' && !normalized.canDraftCustomerReply ? 'Draft-ready customer reply must allow draft creation.' : '',
+        normalized.status === 'draft_ready' && !normalized.proofBacked ? 'Draft-ready customer reply must be proof-backed.' : '',
+        normalized.status === 'draft_ready' && !normalized.businessProofReady ? 'Draft-ready customer reply requires businessProofReady=true.' : '',
+        normalized.status === 'draft_ready' && !normalized.releaseReady ? 'Draft-ready customer reply requires releaseReady=true.' : '',
+        normalized.status === 'draft_ready' && normalized.reviewType !== 'customer_resolution_reply' ? 'Draft-ready customer reply requires reviewType=customer_resolution_reply.' : '',
+        normalized.status === 'clarification_required' && !normalized.clarificationRequired ? 'Clarification readiness must set clarificationRequired=true.' : '',
+        normalized.status === 'clarification_required' && normalized.reviewType !== 'customer_clarification' ? 'Clarification readiness requires reviewType=customer_clarification.' : '',
+        normalized.status !== 'draft_ready' && normalized.status !== 'clarification_required' && normalized.canDraftCustomerReply ? 'Blocked customer reply readiness cannot allow draft creation.' : ''
+    ].filter(Boolean);
+    return {
+        valid: blockers.length === 0,
+        status: blockers.length ? 'blocked' : normalized.status,
+        blockers: blockers,
+        normalized: normalized
+    };
+}
 function supportAutonomousReviewTypeForAction(action) {
     switch (action) {
         case 'run_diagnosis_gate':
@@ -1805,6 +1986,16 @@ function decideResolveIOSupportCustomerReplyPolicy(input) {
         'business proof contract and artifact evidence',
         'no unresolved blocker or release blocker'
     ];
+    var withReadiness = function (policy, issueClassProbePlanValidation) {
+        var normalizedPolicy = policy;
+        return __assign(__assign({}, normalizedPolicy), { readinessContract: buildResolveIOSupportCustomerReplyReadinessContract({
+                policy: normalizedPolicy,
+                diagnosisValidation: diagnosisValidation,
+                issueClassProbePlanValidation: issueClassProbePlanValidation,
+                businessProofReadiness: businessProofReadiness,
+                releaseGate: releaseGate
+            }) });
+    };
     if (!diagnosisValidation.valid) {
         var canAskCustomer = (gate === null || gate === void 0 ? void 0 : gate.issue_case.reproduction_status) === 'blocked'
             || diagnosisValidation.blockers.some(function (blocker) { return /expected_result|observed_result|account_customer_context/.test(blocker); });
@@ -1812,7 +2003,7 @@ function decideResolveIOSupportCustomerReplyPolicy(input) {
             var clarificationValidation = validateResolveIOSupportClarificationContract(buildResolveIOSupportClarificationContract(gate, diagnosisValidation.blockers));
             var clarificationContract = clarificationValidation.normalized;
             if (!clarificationValidation.valid) {
-                return {
+                return withReadiness({
                     action: 'hold_internal',
                     canDraftCustomerReply: false,
                     canSendCustomerReply: false,
@@ -1834,9 +2025,9 @@ function decideResolveIOSupportCustomerReplyPolicy(input) {
                         forbiddenActions: ['Do not send a malformed or multi-question clarification.'],
                         costRisk: 'free_or_deterministic'
                     })
-                };
+                });
             }
-            return {
+            return withReadiness({
                 action: 'ask_clarification',
                 canDraftCustomerReply: true,
                 canSendCustomerReply: false,
@@ -1861,9 +2052,9 @@ function decideResolveIOSupportCustomerReplyPolicy(input) {
                     forbiddenActions: clarificationContract.forbiddenActions,
                     costRisk: 'release_or_customer_send'
                 })
-            };
+            });
         }
-        return {
+        return withReadiness({
             action: 'hold_internal',
             canDraftCustomerReply: false,
             canSendCustomerReply: false,
@@ -1884,7 +2075,7 @@ function decideResolveIOSupportCustomerReplyPolicy(input) {
                 forbiddenActions: ['Do not draft a resolution reply before root-cause diagnosis validates.'],
                 costRisk: 'expensive_model'
             })
-        };
+        });
     }
     var explicitProbePlan = cleanObject(input.issueClassProbePlan);
     var generatedProbePlan = gate
@@ -1893,7 +2084,7 @@ function decideResolveIOSupportCustomerReplyPolicy(input) {
     var issueClassProbePlanValidation = validateResolveIOSupportIssueClassProbePlan(Object.keys(explicitProbePlan).length ? explicitProbePlan : generatedProbePlan, gate);
     var issueClassProbePlan = issueClassProbePlanValidation.normalized || generatedProbePlan;
     if (!issueClassProbePlanValidation.valid) {
-        return {
+        return withReadiness({
             action: 'hold_internal',
             canDraftCustomerReply: false,
             canSendCustomerReply: false,
@@ -1915,10 +2106,10 @@ function decideResolveIOSupportCustomerReplyPolicy(input) {
                 forbiddenActions: ['Do not draft a customer resolution from business proof that is not mapped to a validated IssueClassProbePlan.'],
                 costRisk: 'free_or_deterministic'
             })
-        };
+        }, issueClassProbePlanValidation);
     }
     if (shouldBlockConfidence || confidenceLevel !== 'high') {
-        return {
+        return withReadiness({
             action: 'hold_internal',
             canDraftCustomerReply: false,
             canSendCustomerReply: false,
@@ -1938,10 +2129,10 @@ function decideResolveIOSupportCustomerReplyPolicy(input) {
                 forbiddenActions: ['Do not draft a customer resolution from medium or low confidence.'],
                 costRisk: 'free_or_deterministic'
             })
-        };
+        }, issueClassProbePlanValidation);
     }
     if (unresolvedBlockers.length) {
-        return {
+        return withReadiness({
             action: 'hold_internal',
             canDraftCustomerReply: false,
             canSendCustomerReply: false,
@@ -1962,11 +2153,11 @@ function decideResolveIOSupportCustomerReplyPolicy(input) {
                 forbiddenActions: ['Do not send customer status as resolved while blockers remain.'],
                 costRisk: 'small_model_or_qa'
             })
-        };
+        }, issueClassProbePlanValidation);
     }
     if (releaseGate.blocked) {
         var releaseRequiredEvidence = Array.from(new Set(__spreadArray(__spreadArray([], __read(requiredEvidence), false), __read(releaseGate.requiredEvidence), false)));
-        return {
+        return withReadiness({
             action: 'hold_internal',
             canDraftCustomerReply: false,
             canSendCustomerReply: false,
@@ -1987,14 +2178,14 @@ function decideResolveIOSupportCustomerReplyPolicy(input) {
                 forbiddenActions: ['Do not tell the customer the fix is live before release evidence passes.'],
                 costRisk: 'release_or_customer_send'
             })
-        };
+        }, issueClassProbePlanValidation);
     }
     if (!businessProofReadiness.ready) {
         var replyReason = businessProofReadiness.reason === 'support_business_proof_route_only_or_acceptance_blocked'
             ? 'support_reply_rejects_route_only_business_proof'
             : 'support_reply_requires_business_assertion_pass';
         var proofRequiredEvidence = Array.from(new Set(__spreadArray(__spreadArray([], __read(requiredEvidence), false), __read(businessProofReadiness.requiredEvidence), false)));
-        return {
+        return withReadiness({
             action: 'hold_internal',
             canDraftCustomerReply: false,
             canSendCustomerReply: false,
@@ -2016,10 +2207,10 @@ function decideResolveIOSupportCustomerReplyPolicy(input) {
                 forbiddenActions: ['Route probe pass remains route evidence only.'],
                 costRisk: 'small_model_or_qa'
             })
-        };
+        }, issueClassProbePlanValidation);
     }
     if (!(gate === null || gate === void 0 ? void 0 : gate.proof_plan.business_proof_contract) || artifactCount < 1) {
-        return {
+        return withReadiness({
             action: 'hold_internal',
             canDraftCustomerReply: false,
             canSendCustomerReply: false,
@@ -2040,9 +2231,9 @@ function decideResolveIOSupportCustomerReplyPolicy(input) {
                 forbiddenActions: ['Do not draft a resolution reply without a proof artifact.'],
                 costRisk: 'free_or_deterministic'
             })
-        };
+        }, issueClassProbePlanValidation);
     }
-    return {
+    return withReadiness({
         action: 'draft_resolution_reply',
         canDraftCustomerReply: true,
         canSendCustomerReply: false,
@@ -2071,7 +2262,7 @@ function decideResolveIOSupportCustomerReplyPolicy(input) {
             businessProof: gate.proof_plan.business_proof_contract.expected_business_state_change,
             artifactCount: artifactCount
         }
-    };
+    }, issueClassProbePlanValidation);
 }
 function buildResolveIOSupportIssueClassProbes(value) {
     var validation = validateResolveIOSupportDiagnosisGate(value);
@@ -3760,6 +3951,12 @@ function decideResolveIOSupportV5AutonomousNextAction(input) {
                 now: input.now
             });
         var humanDecisionRequest = buildHumanDecisionRequest(action, label, reason, fields, rootCauseReadiness, continuationProofCheckpoint, nextActionContract, requiredEvidence, blockers);
+        var customerReplyReadiness = customerReplyPolicy.readinessContract || buildResolveIOSupportCustomerReplyReadinessContract({
+            policy: customerReplyPolicy,
+            diagnosisValidation: diagnosisValidation,
+            issueClassProbePlanValidation: issueClassProbePlanValidation,
+            businessProofReadiness: businessProofReadiness
+        });
         return {
             action: action,
             label: label,
@@ -3792,6 +3989,7 @@ function decideResolveIOSupportV5AutonomousNextAction(input) {
             repairGate: repairGate,
             continuation: continuation,
             customerReplyPolicy: customerReplyPolicy,
+            customerReplyReadiness: customerReplyReadiness,
             businessProofReadiness: businessProofReadiness,
             evidenceFreshness: evidenceFreshness,
             preflightGate: preflightGate,