@resolveio/server-lib 22.3.158 → 22.3.160

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

@@ -1,4 +1,4 @@
-import { ResolveIOAIManagerRecoveryCheckpoint, ResolveIOAIManagerRecoveryActionPacket, ResolveIOAIManagerRecoveryActionDispatchRecord, ResolveIOAIManagerRecoveryExecutionDirective, ResolveIOAIManagerRecoveryEvidenceProbe, ResolveIOAIManagerRecoveryPlan } from './ai-runner-manager-policy';
+import { ResolveIOAIManagerHotfixContinuationDecision, ResolveIOAIManagerHotfixFirstReleasePolicy, ResolveIOAIManagerEvidenceStrength, ResolveIOAIManagerRecoveryCheckpoint, ResolveIOAIManagerRecoveryActionPacket, ResolveIOAIManagerRecoveryActionDispatchRecord, ResolveIOAIManagerRecoveryExecutionDirective, ResolveIOAIManagerRecoveryEvidenceProbe, ResolveIOAIManagerRecoveryPlan } from './ai-runner-manager-policy';
 export type ResolveIOSupportV5StepType = 'diagnosis_gate' | 'reproduction_probe' | 'issue_class_probe' | 'business_proof' | 'compile_check' | 'startup_check' | 'live_seed' | 'auth_bootstrap' | 'route_probe' | 'qa_row' | 'build_repair' | 'qa_retest' | 'pr_review' | 'artifact_package' | 'cleanup';
 export type ResolveIOSupportV5Outcome = 'pass' | 'needs_repair' | 'retry_same_step' | 'park_manual' | 'budget_stop' | 'infra_retry' | 'ready_for_merge';
 export type ResolveIOSupportV5Lane = 'build' | 'qa' | 'review' | 'supervisor';
@@ -57,6 +57,35 @@ export interface ResolveIOSupportDiagnosisHint {
     commitMessage?: string;
     reason?: string;
 }
+export type ResolveIOSupportSimilarCaseSource = 'airun' | 'support_ticket' | 'git_commit' | 'manual';
+export interface ResolveIOSupportSimilarCaseCandidate extends ResolveIOSupportDiagnosisHint {
+    source: ResolveIOSupportSimilarCaseSource;
+    summary?: string;
+    keywords?: string[];
+    updatedAt?: string;
+    metadata?: Record<string, any>;
+}
+export interface ResolveIOSupportSimilarCaseRankedHint extends ResolveIOSupportDiagnosisHint {
+    source: ResolveIOSupportSimilarCaseSource;
+    score: number;
+    structuredSignals: string[];
+    advisoryOnly: true;
+}
+export interface ResolveIOSupportSimilarCaseSelectionInput {
+    issueClass?: ResolveIOSupportIssueClass | string;
+    ownerFiles?: any;
+    text?: any;
+    candidates?: any[];
+    limit?: number;
+    now?: Date | string;
+}
+export interface ResolveIOSupportSimilarCaseSelection {
+    ranked: ResolveIOSupportSimilarCaseRankedHint[];
+    similarTickets: ResolveIOSupportSimilarCaseRankedHint[];
+    similarCommits: ResolveIOSupportSimilarCaseRankedHint[];
+    ignoredCount: number;
+    generatedAt: string;
+}
 export interface ResolveIOSupportDiagnosisEvidence {
     type: 'ticket' | 'browser' | 'mongo' | 'log' | 'code' | 'commit' | 'qa' | 'other';
     summary: string;
@@ -95,12 +124,35 @@ export interface ResolveIOSupportDiagnosisEvidenceQuality {
     hasReproductionEvidence: boolean;
 }
 export type ResolveIOSupportCustomerReplyAction = 'draft_resolution_reply' | 'ask_clarification' | 'hold_internal';
+export type ResolveIOSupportHumanReviewType = 'diagnosis_gate' | 'owner_scoped_repair' | 'business_proof_qa' | 'release_hotfix' | 'customer_resolution_reply' | 'customer_clarification' | 'new_evidence' | 'internal_hold';
+export interface ResolveIOSupportHumanReviewPacket {
+    reviewType: ResolveIOSupportHumanReviewType;
+    title: string;
+    summary: string;
+    primaryAction: string;
+    question?: string;
+    customerFacingDraftAllowed: boolean;
+    customerSendAllowed: boolean;
+    requiresHumanApproval: boolean;
+    safety: 'safe_to_draft' | 'needs_clarification' | 'internal_hold';
+    reason: string;
+    blockers: string[];
+    requiredEvidence: string[];
+    evidenceRefs: string[];
+    nextCommands: string[];
+    forbiddenActions: string[];
+    costRisk: 'free_or_deterministic' | 'small_model_or_qa' | 'expensive_model' | 'release_or_customer_send';
+    createdAt: string;
+}
 export interface ResolveIOSupportCustomerReplyPolicyInput {
     diagnosisGate?: any;
     outcomeLabel?: string;
     confidence?: any;
     businessAssertionStatus?: string;
+    businessAssertions?: any[];
     businessProofArtifacts?: any[];
+    previousProofFingerprint?: string;
+    previousArtifactFingerprint?: string;
     unresolvedBlockers?: any[];
     releaseStatus?: string;
 }
@@ -113,6 +165,7 @@ export interface ResolveIOSupportCustomerReplyPolicy {
     reason: string;
     requiredEvidence: string[];
     clarificationQuestion?: string;
+    humanReviewPacket?: ResolveIOSupportHumanReviewPacket;
     draftBasis?: {
         issueClass: ResolveIOSupportIssueClass;
         businessProof: string;
@@ -122,18 +175,69 @@ export interface ResolveIOSupportCustomerReplyPolicy {
 export interface ResolveIOSupportIssueClassProbe {
     issue_class: ResolveIOSupportIssueClass;
     probe_type: ResolveIOSupportV5StepType;
+    failure_class: ResolveIOSupportV5FailureClass;
     objective: string;
     route?: string;
     action: string;
     expected_evidence: string;
+    expected_business_proof: string;
+    required_artifacts: string[];
+    state_transition: {
+        before: string;
+        action: string;
+        after: string;
+        assertion: string;
+    };
+    acceptance_gate: 'aiqa_business_assertion';
     blocks_acceptance_without_business_assertion: boolean;
 }
+export interface ResolveIOSupportBusinessProofAssertion {
+    assertion: string;
+    status: string;
+    workflow?: string;
+    route?: string;
+    before?: string;
+    action?: string;
+    expected?: string;
+    after?: string;
+    observed?: string;
+    dataProof?: string;
+    mongoDelta?: Record<string, any>;
+    artifactPaths: string[];
+    message?: string;
+    acceptanceBlocked?: boolean;
+    routeOnly?: boolean;
+    metadata?: Record<string, any>;
+}
+export interface ResolveIOSupportBusinessProofReadinessInput {
+    diagnosisGate?: any;
+    outcomeLabel?: string;
+    businessAssertionStatus?: string;
+    businessAssertions?: any[];
+    businessProofArtifacts?: any[];
+    previousProofFingerprint?: string;
+    previousArtifactFingerprint?: string;
+}
+export interface ResolveIOSupportBusinessProofReadiness {
+    ready: boolean;
+    status: 'missing' | 'route_only' | 'failed' | 'blocked' | 'weak' | 'stale' | 'passed';
+    reason: string;
+    blockers: string[];
+    requiredEvidence: string[];
+    artifactPaths: string[];
+    proofFingerprint: string;
+    artifactFingerprint: string;
+    proofFreshness: 'missing' | 'fresh' | 'same_as_previous' | 'stale_artifact' | 'unknown';
+    matchedAssertion?: ResolveIOSupportBusinessProofAssertion;
+}
 export interface ResolveIOSupportV5RepeatStopInput {
     history: ResolveIOSupportV5StepRecord[];
     failureClass?: ResolveIOSupportV5FailureClass | string;
     blocker?: string;
     evidence?: any;
     evidenceHash?: string;
+    changedFiles?: any;
+    artifactPaths?: any;
     limit?: number;
     ignoreInfra?: boolean;
 }
@@ -143,13 +247,39 @@ export interface ResolveIOSupportV5RepeatStopDecision {
     failureClass: string;
     blockerFingerprint: string;
     evidenceHash: string;
+    newEvidence?: boolean;
+    materialEvidence?: boolean;
+    evidenceStrength?: ResolveIOAIManagerEvidenceStrength;
+    evidenceSignals?: string[];
     reason: string;
 }
+export type ResolveIOSupportEvidenceFreshnessStatus = 'missing' | 'fresh' | 'retry_below_limit' | 'material_evidence' | 'weak_evidence' | 'stale_repeated' | 'ping_pong' | 'infra_ignored';
+export interface ResolveIOSupportEvidenceFreshness {
+    status: ResolveIOSupportEvidenceFreshnessStatus;
+    failureClass: string;
+    blockerFingerprint: string;
+    evidenceHash: string;
+    sameFailureCount: number;
+    pingPongCount: number;
+    newEvidence: boolean;
+    materialEvidence: boolean;
+    evidenceStrength: ResolveIOAIManagerEvidenceStrength;
+    evidenceSignals: string[];
+    loopBudgetShouldReset: boolean;
+    canRetry: boolean;
+    mustCollectNewEvidence: boolean;
+    productRepairFailure: boolean;
+    reason: string;
+    requiredResetEvidence: string[];
+    changedFiles: string[];
+    artifactPaths: string[];
+}
 export type ResolveIOSupportV5RepairGateAction = 'diagnose_only' | 'infra_repair_only' | 'allow_product_repair' | 'reject_out_of_scope' | 'park_repeated_failure';
 export interface ResolveIOSupportV5RepairGateInput {
     diagnosisGate?: any;
     activeStepType?: ResolveIOSupportV5StepType | string;
     changedFiles?: any;
+    artifactPaths?: any;
     failureClass?: ResolveIOSupportV5FailureClass | string;
     blocker?: string;
     evidence?: any;
@@ -374,7 +504,36 @@ export interface ResolveIOSupportV5ContinuationDecision {
     recoveryEvidenceProbe: ResolveIOAIManagerRecoveryEvidenceProbe;
     recoveryAction: ResolveIOAIManagerRecoveryActionPacket;
 }
-export type ResolveIOSupportV5AutonomousNextAction = 'run_diagnosis_gate' | 'repair_infra_only' | 'revise_diagnosis_scope' | 'run_owner_scoped_repair' | 'run_business_proof_qa' | 'repair_release_hotfix_first' | 'collect_new_evidence' | 'draft_customer_reply' | 'ready_for_release_gate' | 'park_manual';
+export type ResolveIOSupportV5AutonomousNextAction = 'run_diagnosis_gate' | 'ask_customer_clarification' | 'repair_infra_only' | 'revise_diagnosis_scope' | 'run_owner_scoped_repair' | 'run_business_proof_qa' | 'repair_release_hotfix_first' | 'collect_new_evidence' | 'draft_customer_reply' | 'ready_for_release_gate' | 'park_manual';
+export type ResolveIOSupportRootCauseReadinessStatus = 'diagnosis_required' | 'customer_clarification_required' | 'infra_repair_only' | 'scope_revision_required' | 'owner_scoped_repair_ready' | 'business_proof_required' | 'release_hotfix_required' | 'release_gate_ready' | 'customer_reply_draft_ready' | 'collect_new_evidence' | 'parked';
+export interface ResolveIOSupportRootCauseReadiness {
+    status: ResolveIOSupportRootCauseReadinessStatus;
+    nextGate: 'diagnosis' | 'infra' | 'scope' | 'repair' | 'business_proof' | 'release' | 'customer_reply' | 'evidence' | 'manual';
+    nextCommand: string;
+    rootCauseFirstSatisfied: boolean;
+    diagnosisValid: boolean;
+    ownerFilesReady: boolean;
+    proofPlanReady: boolean;
+    businessProofReady: boolean;
+    infraOnly: boolean;
+    sameFailureParked: boolean;
+    canEditProductCode: boolean;
+    canRunIssueClassProbe: boolean;
+    canRunBusinessProofQa: boolean;
+    canRelease: boolean;
+    canDraftCustomerReply: boolean;
+    requiresHumanDecision: boolean;
+    reason: string;
+    blockers: string[];
+    ownerFiles: string[];
+    issueClass?: ResolveIOSupportIssueClass;
+    expectedProof?: string;
+    issueClassProbes?: ResolveIOSupportIssueClassProbe[];
+    businessProofStatus?: ResolveIOSupportBusinessProofReadiness['status'];
+    proofFingerprint?: string;
+    artifactFingerprint?: string;
+    proofFreshness?: ResolveIOSupportBusinessProofReadiness['proofFreshness'];
+}
 export interface ResolveIOSupportV5AutonomousDecisionInput {
     bundle: ResolveIOSupportV5StateBundle;
     changedFiles?: any;
@@ -385,9 +544,16 @@ export interface ResolveIOSupportV5AutonomousDecisionInput {
     outcomeLabel?: string;
     confidence?: any;
     businessAssertionStatus?: string;
+    businessAssertions?: any[];
     businessProofArtifacts?: any[];
+    artifactPaths?: any;
+    previousProofFingerprint?: string;
+    previousArtifactFingerprint?: string;
     unresolvedBlockers?: any[];
     releaseStatus?: string;
+    hotfixEvidence?: any;
+    releasePolicy?: ResolveIOAIManagerHotfixFirstReleasePolicy;
+    releaseGatePassed?: boolean;
     maxOwnerFiles?: number;
     now?: Date | string;
 }
@@ -399,7 +565,9 @@ export interface ResolveIOSupportV5AutonomousDecision {
     canEditProductCode: boolean;
     canRunModel: boolean;
     canRunQa: boolean;
+    canPrepareHotfixPatch: boolean;
     canHotfixBackend: boolean;
+    liveHotfixBlockedUntilCommit: boolean;
     canDraftCustomerReply: boolean;
     canSendCustomerReply: boolean;
     lane: ResolveIOSupportV5Lane | 'release' | 'customer';
@@ -413,23 +581,44 @@ export interface ResolveIOSupportV5AutonomousDecision {
     ownerFiles: string[];
     issueClass?: ResolveIOSupportIssueClass;
     expectedProof?: string;
+    issueClassProbes: ResolveIOSupportIssueClassProbe[];
     activeMicrotask?: ResolveIOSupportV5Microtask;
     diagnosisValidation: ResolveIOSupportDiagnosisGateValidation;
     repairGate: ResolveIOSupportV5RepairGateDecision;
     continuation: ResolveIOSupportV5ContinuationDecision;
     customerReplyPolicy: ResolveIOSupportCustomerReplyPolicy;
+    businessProofReadiness: ResolveIOSupportBusinessProofReadiness;
+    evidenceFreshness: ResolveIOSupportEvidenceFreshness;
+    rootCauseReadiness: ResolveIOSupportRootCauseReadiness;
+    humanReviewPacket: ResolveIOSupportHumanReviewPacket;
+    hotfixContinuation?: ResolveIOAIManagerHotfixContinuationDecision;
     recordedAt: string;
 }
+export declare function selectResolveIOSupportSimilarCaseHints(input?: ResolveIOSupportSimilarCaseSelectionInput): ResolveIOSupportSimilarCaseSelection;
 export declare function evaluateResolveIOSupportDiagnosisEvidenceQuality(value: any): ResolveIOSupportDiagnosisEvidenceQuality;
 export declare function normalizeResolveIOSupportDiagnosisGate(value: any, now?: Date | string): ResolveIOSupportDiagnosisGate | undefined;
 export declare function extractResolveIOSupportDiagnosisGateFromText(value: string, now?: Date | string): ResolveIOSupportDiagnosisGate | undefined;
 export declare function validateResolveIOSupportDiagnosisGate(value: any, options?: {
     maxOwnerFiles?: number;
 }): ResolveIOSupportDiagnosisGateValidation;
+export declare function evaluateResolveIOSupportBusinessProofReadiness(input?: ResolveIOSupportBusinessProofReadinessInput): ResolveIOSupportBusinessProofReadiness;
 export declare function decideResolveIOSupportCustomerReplyPolicy(input?: ResolveIOSupportCustomerReplyPolicyInput): ResolveIOSupportCustomerReplyPolicy;
 export declare function buildResolveIOSupportIssueClassProbes(value: any): ResolveIOSupportIssueClassProbe[];
 export declare function hashResolveIOSupportV5Evidence(value: any): string;
 export declare function decideResolveIOSupportV5RepeatedFailureStop(input: ResolveIOSupportV5RepeatStopInput): ResolveIOSupportV5RepeatStopDecision;
+export declare function evaluateResolveIOSupportEvidenceFreshness(input: {
+    history?: ResolveIOSupportV5StepRecord[];
+    failureClass?: ResolveIOSupportV5FailureClass | string;
+    blocker?: any;
+    evidence?: any;
+    evidenceHash?: string;
+    changedFiles?: any;
+    artifactPaths?: any;
+    lane?: ResolveIOSupportV5Lane | string;
+    stepType?: ResolveIOSupportV5StepType | string;
+    limit?: number;
+    ignoreInfra?: boolean;
+}): ResolveIOSupportEvidenceFreshness;
 export declare function changedFilesOutsideResolveIOSupportDiagnosisOwnerFiles(diagnosisGate: any, changedFiles: any, options?: {
     allowTests?: boolean;
 }): string[];
@@ -479,6 +668,7 @@ export declare function buildResolveIOSupportV5MicrotaskPrompt(input: {
     artifactPaths?: string[];
     targetFiles?: string[];
     contextSnippets?: string[];
+    similarCaseHints?: any;
     activeQaRow?: ResolveIOSupportV5LaneMemory['activeQaRow'];
 }): {
     prompt: string;