@resolveio/server-lib 22.3.160 → 22.3.162

package/package.json

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

package/util/ai-run-evidence-adapters.js

@@ -267,10 +267,48 @@ function hotfixEvidenceGate(evidence, now) {
             fullDeployBlocked: validation.fullDeployBlocked,
             hotfixSatisfied: validation.hotfixSatisfied,
             blockers: validation.blockers,
+            githubCommitGuard: validation.githubCommitGuard,
             target: (_b = validation.normalized) === null || _b === void 0 ? void 0 : _b.target
         }
     };
 }
+function hotfixCommitProofGate(evidence, now) {
+    var _a;
+    var validation = (0, ai_runner_manager_policy_1.validateResolveIOAIManagerHotfixEvidence)(evidence);
+    var guard = validation.githubCommitGuard;
+    if (!guard.required) {
+        return undefined;
+    }
+    var status = guard.passed
+        ? 'pass'
+        : guard.status === 'invalid'
+            ? 'fail'
+            : 'blocked';
+    return {
+        key: 'hotfix_commit_proof',
+        label: 'Hotfix GitHub commit proof',
+        status: status,
+        reason: guard.passed
+            ? 'Hotfix has matching sourceCommitSha, GitHub commit URL, and passed gitPushStatus/gitCommitStatus.'
+            : (guard.blockers.join('; ') || 'Manager hotfix is blocked until sourceCommitSha, githubCommitUrl, and passed gitPushStatus prove the hotfix is pushed to GitHub.'),
+        evidenceRefs: cleanStringList([guard.githubCommitUrl], 1, 500),
+        recordedAt: isoNow(now || ((_a = validation.normalized) === null || _a === void 0 ? void 0 : _a.recordedAt)),
+        metadata: {
+            channel: guard.channel || validation.channel,
+            status: guard.status,
+            passed: guard.passed,
+            managerMustCommitBeforeHotfix: guard.managerMustCommitBeforeHotfix,
+            sourceCommitSha: guard.sourceCommitSha,
+            githubCommitUrl: guard.githubCommitUrl,
+            githubCommitSha: guard.githubCommitSha,
+            gitCommitStatus: guard.gitCommitStatus,
+            gitPushStatus: guard.gitPushStatus,
+            blockers: guard.blockers,
+            nextCommands: guard.nextCommands,
+            requiredEvidence: guard.requiredEvidence
+        }
+    };
+}
 function collectHotfixEvidenceEvents(sources, events, gates, now) {
     var e_6, _a;
     var _b, _c;
@@ -297,6 +335,7 @@ function collectHotfixEvidenceEvents(sources, events, gates, now) {
                     fullDeployBlocked: validation.fullDeployBlocked,
                     hotfixSatisfied: validation.hotfixSatisfied,
                     blockers: validation.blockers,
+                    githubCommitGuard: validation.githubCommitGuard,
                     target: (_c = validation.normalized) === null || _c === void 0 ? void 0 : _c.target
                 }
             });
@@ -304,6 +343,18 @@ function collectHotfixEvidenceEvents(sources, events, gates, now) {
             if (gate) {
                 gates.push(gate);
             }
+            var commitProofGate = hotfixCommitProofGate(evidence, now);
+            if (commitProofGate) {
+                gates.push(commitProofGate);
+                pushEvent(events, {
+                    type: 'log',
+                    category: 'hotfix_commit_proof',
+                    message: commitProofGate.reason,
+                    artifactPaths: commitProofGate.evidenceRefs,
+                    recordedAt: commitProofGate.recordedAt,
+                    metadata: commitProofGate.metadata
+                });
+            }
         }
     }
     catch (e_6_1) { e_6 = { error: e_6_1 }; }
@@ -741,6 +792,94 @@ function supportDiagnosisProofGateResult(diagnosisGate, now) {
         }
     };
 }
+var SUPPORT_ROOT_CAUSE_ENTRY_REQUIRED_FIELDS = [
+    'issue_case',
+    'issue_class',
+    'accepted_hypothesis',
+    'rejected_alternatives',
+    'failing_path',
+    'owner_files',
+    'proof_plan',
+    'evidence'
+];
+var SUPPORT_ROOT_CAUSE_ENTRY_ISSUE_CLASSES = [
+    'no_op_submit',
+    'missing_wrong_data',
+    'filter_query_mismatch',
+    'invoice_pdf_export',
+    'upload_import',
+    'route_auth_hydration',
+    'slow_query_performance'
+];
+function supportRootCauseEntryContractGate(contract, now) {
+    if (!contract || !Object.keys(contract).length) {
+        return undefined;
+    }
+    var requiredOutput = plainObject(contract.required_output || contract.requiredOutput);
+    var ownerPolicy = plainObject(contract.owner_file_policy || contract.ownerFilePolicy);
+    var businessProofPolicy = plainObject(contract.business_proof_policy || contract.businessProofPolicy);
+    var failurePolicy = plainObject(contract.failure_policy || contract.failurePolicy);
+    var probes = asArray(contract.issue_class_probes || contract.issueClassProbes);
+    var requiredFields = cleanStringList(requiredOutput.required_fields || requiredOutput.requiredFields, 30, 160);
+    var issueClasses = probes.map(function (probe) { return cleanText(probe.issue_class || probe.issueClass, 120); }).filter(Boolean);
+    var missingRequiredFields = SUPPORT_ROOT_CAUSE_ENTRY_REQUIRED_FIELDS.filter(function (field) { return !requiredFields.includes(field); });
+    var missingIssueClasses = SUPPORT_ROOT_CAUSE_ENTRY_ISSUE_CLASSES.filter(function (issueClass) { return !issueClasses.includes(issueClass); });
+    var blockers = [];
+    if (!cleanText(contract.contract_id || contract.contractId, 160)) {
+        blockers.push('Root-cause entry contract is missing contract_id.');
+    }
+    if (cleanText(requiredOutput.object_key || requiredOutput.objectKey, 120) !== 'support_diagnosis_gate') {
+        blockers.push('Root-cause entry contract must require support_diagnosis_gate output.');
+    }
+    if (missingRequiredFields.length) {
+        blockers.push("Root-cause entry contract missing required output fields: ".concat(missingRequiredFields.join(', '), "."));
+    }
+    var ownerFileMax = Number(ownerPolicy.max_files || ownerPolicy.maxFiles || 0);
+    if (!Number.isFinite(ownerFileMax) || ownerFileMax <= 0 || ownerFileMax > 12) {
+        blockers.push('Root-cause entry contract must cap owner_files to a small exact file set.');
+    }
+    if (ownerPolicy.edits_outside_owner_files_require_revised_diagnosis !== true && ownerPolicy.editsOutsideOwnerFilesRequireRevisedDiagnosis !== true) {
+        blockers.push('Root-cause entry contract must require revised diagnosis before edits outside owner_files.');
+    }
+    if (businessProofPolicy.requires_aiqa_business_assertion !== true && businessProofPolicy.requiresAiqaBusinessAssertion !== true) {
+        blockers.push('Root-cause entry contract must require AIQaBusinessAssertion business proof.');
+    }
+    if (businessProofPolicy.route_load_screenshot_scorecard_model_claim_not_acceptance !== true && businessProofPolicy.routeLoadScreenshotScorecardModelClaimNotAcceptance !== true) {
+        blockers.push('Root-cause entry contract must reject route-load/screenshot/scorecard/model-claim acceptance.');
+    }
+    if (failurePolicy.repeated_failure_without_new_evidence_parks_run !== true && failurePolicy.repeatedFailureWithoutNewEvidenceParksRun !== true) {
+        blockers.push('Root-cause entry contract must park repeated failures without new evidence.');
+    }
+    if (missingIssueClasses.length) {
+        blockers.push("Root-cause entry contract missing issue-class probes: ".concat(missingIssueClasses.join(', '), "."));
+    }
+    var status = blockers.length ? 'fail' : 'pass';
+    return {
+        key: 'support_root_cause_entry_contract',
+        label: 'Root-cause entry contract',
+        status: status,
+        reason: blockers.length
+            ? blockers.join(' ')
+            : 'Support run has a structured root-cause-first entry contract with issue-class probes, owner-file policy, and business-proof policy.',
+        evidenceRefs: cleanStringList(businessProofPolicy.required_artifacts || businessProofPolicy.requiredArtifacts, 20, 500),
+        recordedAt: isoNow(now),
+        metadata: {
+            contractId: cleanText(contract.contract_id || contract.contractId, 160),
+            version: cleanText(contract.version, 120),
+            status: cleanText(contract.status, 120),
+            requiredOutputKey: cleanText(requiredOutput.object_key || requiredOutput.objectKey, 120),
+            requiredFields: requiredFields,
+            missingRequiredFields: missingRequiredFields,
+            ownerFileMax: ownerFileMax,
+            requiresRevisedDiagnosisForOutOfScopeEdits: ownerPolicy.edits_outside_owner_files_require_revised_diagnosis === true || ownerPolicy.editsOutsideOwnerFilesRequireRevisedDiagnosis === true,
+            requiresBusinessAssertion: businessProofPolicy.requires_aiqa_business_assertion === true || businessProofPolicy.requiresAiqaBusinessAssertion === true,
+            routeOnlyAcceptanceRejected: businessProofPolicy.route_load_screenshot_scorecard_model_claim_not_acceptance === true || businessProofPolicy.routeLoadScreenshotScorecardModelClaimNotAcceptance === true,
+            issueClassProbeCount: issueClasses.length,
+            issueClasses: issueClasses,
+            missingIssueClasses: missingIssueClasses
+        }
+    };
+}
 function applySupportDiagnosisProofGate(qa, diagnosisGate, now) {
     var proofPlan = diagnosisGate.proof_plan || diagnosisGate.proofPlan || {};
     var requiredBusinessAssertion = cleanText(proofPlan.business_assertion || proofPlan.businessAssertion, 1000);
@@ -1454,7 +1593,7 @@ function applyAssistantAnswerQualityGate(qa, decision, now) {
 }
 function buildSupportAIRunFromEvidence(input) {
     var e_22, _a, e_23, _b;
-    var _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    var _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
     var ticket = input.ticket || {};
     var job = input.job || {};
     var evidence = buildSupportQaEvidence(input);
@@ -1466,8 +1605,8 @@ function buildSupportAIRunFromEvidence(input) {
     addSourceId(sourceIds, 'jobId', job._id || job.id || job.jobId);
     addSourceId(sourceIds, 'buildPlanId', job.buildPlanId || ticket.buildPlanId);
     try {
-        for (var _o = __values(asArray(input.taskEvents)), _p = _o.next(); !_p.done; _p = _o.next()) {
-            var event_1 = _p.value;
+        for (var _s = __values(asArray(input.taskEvents)), _t = _s.next(); !_t.done; _t = _s.next()) {
+            var event_1 = _t.value;
             pushEvent(events, {
                 type: event_1.type === 'human_intervention' ? 'human_intervention' : 'log',
                 category: cleanText(event_1.category || event_1.phase || event_1.type, 160),
@@ -1484,13 +1623,13 @@ function buildSupportAIRunFromEvidence(input) {
     catch (e_22_1) { e_22 = { error: e_22_1 }; }
     finally {
         try {
-            if (_p && !_p.done && (_a = _o.return)) _a.call(_o);
+            if (_t && !_t.done && (_a = _s.return)) _a.call(_s);
         }
         finally { if (e_22) throw e_22.error; }
     }
     try {
-        for (var _q = __values(asArray(input.aiJobs)), _r = _q.next(); !_r.done; _r = _q.next()) {
-            var aiJob = _r.value;
+        for (var _u = __values(asArray(input.aiJobs)), _v = _u.next(); !_v.done; _v = _u.next()) {
+            var aiJob = _v.value;
             pushEvent(events, {
                 type: aiJob.model ? 'model_call' : 'log',
                 category: cleanText(aiJob.category || aiJob.phase || aiJob.runner, 160),
@@ -1508,7 +1647,7 @@ function buildSupportAIRunFromEvidence(input) {
     catch (e_23_1) { e_23 = { error: e_23_1 }; }
     finally {
         try {
-            if (_r && !_r.done && (_b = _q.return)) _b.call(_q);
+            if (_v && !_v.done && (_b = _u.return)) _b.call(_u);
         }
         finally { if (e_23) throw e_23.error; }
     }
@@ -1540,6 +1679,21 @@ function buildSupportAIRunFromEvidence(input) {
             metadata: customerReplyPolicyGate.metadata
         });
     }
+    var ticketAutomation = plainObject(ticket.automation);
+    var ticketManagerState = plainObject(ticketAutomation.manager || ticket.manager);
+    var rootCauseEntryContract = evidenceObject(job.supportRootCauseEntryContract, job.support_root_cause_entry_contract, job.rootCauseEntryContract, ticket.supportRootCauseEntryContract, ticket.rootCauseEntryContract, ticketManagerState.root_cause_entry_contract, ticketManagerState.rootCauseEntryContract, evidence.rootCauseEntryContract, evidence.root_cause_entry_contract);
+    var rootCauseEntryContractGate = supportRootCauseEntryContractGate(rootCauseEntryContract, input.now);
+    if (rootCauseEntryContractGate) {
+        gates.push(rootCauseEntryContractGate);
+        pushEvent(events, {
+            type: 'log',
+            category: 'support_root_cause_entry_contract',
+            message: rootCauseEntryContractGate.reason,
+            artifactPaths: rootCauseEntryContractGate.evidenceRefs,
+            recordedAt: rootCauseEntryContractGate.recordedAt,
+            metadata: rootCauseEntryContractGate.metadata
+        });
+    }
     var cost = collectUsageEvents(asArray(input.usageLedger), events);
     var diagnosisGate = evidenceObject(job.supportV5DiagnosisGate, job.support_v5_diagnosis_gate, job.diagnosisGate, ticket.supportV5DiagnosisGate, ticket.diagnosisGate, evidence.diagnosisGate, evidence.supportV5DiagnosisGate);
     var qa = applySupportDiagnosisProofGate(buildQaFromEvidence(evidence, input.now), diagnosisGate, input.now);
@@ -1582,11 +1736,20 @@ function buildSupportAIRunFromEvidence(input) {
         metadata: {
             versionCount: asArray(input.versions).length,
             buildPlanCount: asArray(input.buildPlans).length,
+            rootCauseEntryContract: Object.keys(rootCauseEntryContract).length ? {
+                contractId: cleanText(rootCauseEntryContract.contract_id || rootCauseEntryContract.contractId, 160),
+                version: cleanText(rootCauseEntryContract.version, 120),
+                status: cleanText(rootCauseEntryContract.status, 120),
+                issueClassProbeCount: asArray(rootCauseEntryContract.issue_class_probes || rootCauseEntryContract.issueClassProbes).length,
+                ownerFileMax: Number(((_e = rootCauseEntryContract.owner_file_policy) === null || _e === void 0 ? void 0 : _e.max_files) || ((_f = rootCauseEntryContract.ownerFilePolicy) === null || _f === void 0 ? void 0 : _f.maxFiles) || 0) || 0,
+                requiresBusinessAssertion: ((_g = rootCauseEntryContract.business_proof_policy) === null || _g === void 0 ? void 0 : _g.requires_aiqa_business_assertion) === true
+                    || ((_h = rootCauseEntryContract.businessProofPolicy) === null || _h === void 0 ? void 0 : _h.requiresAiqaBusinessAssertion) === true
+            } : undefined,
             diagnosis: Object.keys(diagnosisGate).length ? {
                 status: cleanText(diagnosisGate.status, 80),
                 issueClass: diagnosisIssueClass,
                 ownerFiles: diagnosisOwnerFiles,
-                acceptedHypothesis: cleanText(((_e = diagnosisGate.accepted_hypothesis) === null || _e === void 0 ? void 0 : _e.statement) || ((_f = diagnosisGate.acceptedHypothesis) === null || _f === void 0 ? void 0 : _f.statement), 1000),
+                acceptedHypothesis: cleanText(((_j = diagnosisGate.accepted_hypothesis) === null || _j === void 0 ? void 0 : _j.statement) || ((_k = diagnosisGate.acceptedHypothesis) === null || _k === void 0 ? void 0 : _k.statement), 1000),
                 proofPlan: diagnosisGate.proof_plan || diagnosisGate.proofPlan
             } : undefined,
             businessProofReadiness: Object.keys(businessProofReadiness).length ? {
@@ -1601,12 +1764,12 @@ function buildSupportAIRunFromEvidence(input) {
                 canDraftCustomerReply: customerReplyPolicy.canDraftCustomerReply === true || customerReplyPolicy.can_draft_customer_reply === true,
                 canSendCustomerReply: customerReplyPolicy.canSendCustomerReply === true || customerReplyPolicy.can_send_customer_reply === true,
                 reason: cleanText(customerReplyPolicy.reason, 1000),
-                reviewType: cleanText(((_g = customerReplyPolicy.humanReviewPacket) === null || _g === void 0 ? void 0 : _g.reviewType)
-                    || ((_h = customerReplyPolicy.human_review_packet) === null || _h === void 0 ? void 0 : _h.review_type)
-                    || ((_j = customerReplyPolicy.human_review_packet) === null || _j === void 0 ? void 0 : _j.reviewType), 160),
-                primaryAction: cleanText(((_k = customerReplyPolicy.humanReviewPacket) === null || _k === void 0 ? void 0 : _k.primaryAction)
-                    || ((_l = customerReplyPolicy.human_review_packet) === null || _l === void 0 ? void 0 : _l.primary_action)
-                    || ((_m = customerReplyPolicy.human_review_packet) === null || _m === void 0 ? void 0 : _m.primaryAction), 160)
+                reviewType: cleanText(((_l = customerReplyPolicy.humanReviewPacket) === null || _l === void 0 ? void 0 : _l.reviewType)
+                    || ((_m = customerReplyPolicy.human_review_packet) === null || _m === void 0 ? void 0 : _m.review_type)
+                    || ((_o = customerReplyPolicy.human_review_packet) === null || _o === void 0 ? void 0 : _o.reviewType), 160),
+                primaryAction: cleanText(((_p = customerReplyPolicy.humanReviewPacket) === null || _p === void 0 ? void 0 : _p.primaryAction)
+                    || ((_q = customerReplyPolicy.human_review_packet) === null || _q === void 0 ? void 0 : _q.primary_action)
+                    || ((_r = customerReplyPolicy.human_review_packet) === null || _r === void 0 ? void 0 : _r.primaryAction), 160)
             } : undefined
         }
     });