ai-foreman 1.7.13 → 1.7.15

package/dist/qaReview.d.ts

@@ -2,7 +2,9 @@ import { type ProviderSessionRefV1, type QaFailureReportV1, type SessionStrategy
 import type { BuilderAdapter, CompactResult } from "./adapters/types.js";
 import type { RunObserver } from "./observability.js";
 import type { TicketDef } from "./tickets/ticketSchema.js";
+import type { QaFailureDeliveryInput, QaFailureDeliveryResult } from "./qaFailureDelivery.js";
 import { type QaRecoveryPacket } from "./qaRecovery.js";
+import { type HandoffAcceptanceReceiptV2, type QaConfinementV2 } from "./qaProtocolV2.js";
 export interface QaStreamState {
     sessionId?: string;
     sessionRef?: ProviderSessionRefV1;
@@ -28,6 +30,8 @@ export interface QaReportHistoryEntry {
     reportDigest?: string;
     report?: QaFailureReportV1;
     findingIds?: string[];
+    remediationRequestDigest?: string;
+    remediationRequest?: string;
     fixSummaryDigest?: string;
     fixSummary?: string;
     remediationDigest?: string;
@@ -55,43 +59,56 @@ export type QaFixRequest = {
     remediation: string;
     history: QaReportHistoryEntry[];
     latestBuilderResult: string;
-} | {
-    kind: "plain-issues";
-    issues: string;
-    operatorApproved: true;
-    history: QaReportHistoryEntry[];
-    latestBuilderResult: string;
 };
 export type QaFixResult = {
     ok: true;
     response: string;
     summary: string;
     detail?: string;
+    providerTurnId?: string;
 } | {
     ok: false;
     detail?: string;
     response?: string;
     summary?: string;
+    providerTurnId?: string;
 };
 export interface QaSessionHandle {
     adapter: BuilderAdapter;
-    sessionIdentity?: ProviderSessionRefV1 | string;
+    sessionIdentity(): ProviderSessionRefV1;
     effectiveRoleInstructions: string;
     runtimeContext: unknown;
     skills: Array<{
         name: string;
-        digest: string | "unavailable";
-        reason?: string;
-        path?: string;
+        digest: string;
+        path: string;
+        content: string;
     }>;
-    handoffReceipt?: unknown;
+    confinement: QaConfinementV2 & {
+        digest: string;
+    };
+    handoffReceipt: {
+        kind: "initial";
+    } | {
+        kind: "accepted";
+        receipt: HandoffAcceptanceReceiptV2;
+    };
+}
+export interface QaSessionBoundaryResult {
+    handle: QaSessionHandle;
+    receipt: HandoffAcceptanceReceiptV2;
 }
 export interface QaSessionBoundaryRecovery {
+    runId: string;
+    ticketId: string;
+    packetId: string;
     packetDigest: string;
     reviewedStateDigest: string;
     packetPath: string;
     resources: Array<{
         label: string;
+        purpose: string;
+        bytes: number;
         digest: string;
         requiredForRecovery: boolean;
         mediaType: string;
@@ -118,12 +135,15 @@ export interface IsolatedQaOptions {
     builderSummary: string;
     qaStrategy: SessionStrategy;
     state: QaStreamState;
-    createQa: (cwd: string, sessionId?: string) => Promise<BuilderAdapter | QaSessionHandle>;
+    createQa: (cwd: string, sessionId?: string) => Promise<QaSessionHandle>;
     /** Host-owned ordinary QA boundary. Fresh strategies must return a validated successor. */
-    sessionBoundary?: (adapter: BuilderAdapter, frozenAction: string, strategy: SessionStrategy, cwd: string, recovery?: QaSessionBoundaryRecovery) => Promise<BuilderAdapter>;
+    sessionBoundary: (handle: QaSessionHandle, frozenAction: string, strategy: SessionStrategy, cwd: string, recovery?: QaSessionBoundaryRecovery) => Promise<QaSessionBoundaryResult>;
     /** Persist provider-native automatic compactions without imposing an ordinary QA boundary. */
     observeNativeCompactions?: (adapter: BuilderAdapter) => Promise<void>;
-    fix: (request: QaFixRequest) => Promise<QaFixResult>;
+    /** Legacy test seam. Production QA-failure remediation must use deliverFailure. */
+    fix?: (request: QaFixRequest) => Promise<QaFixResult>;
+    /** Canonical production delivery path for validated QA failure reports. */
+    deliverFailure?: (request: QaFailureDeliveryInput) => Promise<QaFailureDeliveryResult>;
     maxCycles: number;
     /** Durable QA execution scope; review/fix budgets survive worker restarts. */
     recovery: {
@@ -166,9 +186,14 @@ export interface IsolatedQaResult {
     outcome: "passed" | "blocked" | "needs-human" | "nonconverged" | "waived";
     detail?: string;
     summary?: string;
+    passCertificateId?: string;
+    sourceStateDigest?: string;
+    reviewBasisDigest?: string;
 }
 export declare function runIsolatedQa(opts: IsolatedQaOptions): Promise<IsolatedQaResult>;
-export declare function buildQaReviewHandoff(ticket: TicketDef, builderSummary: string, diffDigest: string, validationChecklist: string[], changeSummary?: unknown): string;
+export declare function buildQaReviewHandoff(ticket: TicketDef, builderSummary: string, diffDigest: string, validationChecklist: string[], changeSummary?: unknown, history?: QaReportHistoryEntry[]): string;
 export declare function compactWithRetry(adapter: BuilderAdapter): Promise<CompactResult>;
-export declare function buildDurableQaFixHandoff(ticket: TicketDef, request: QaFixRequest, worktree: string, priorResult: string, diffDigest: string, changeSummary?: string): string;
-export declare const QA_REPORT_RECOVERY_MENU: readonly ["Try another fresh QA.", "Use plain issues fallback.", "Manually fix saved JSON.", "Give QA specific instructions.", "Pause."];
+export declare const QA_REPORT_RECOVERY_MENU: readonly ["Try a complete fresh QA review.", "Manually fix saved JSON for human inspection.", "Give QA specific instructions for a fresh review.", "Pause."];
+export declare function beginQaFinalization(projectDir: string, sourceWorktree: string, runId: string, ticketId: string, certificateId: string, expectedSourceStateDigest: string, consumer: string, allowedProjectionPaths?: string[]): Promise<void>;
+export declare function verifyPendingQaFinalizationSource(projectDir: string, sourceWorktree: string, runId: string, ticketId: string, allowProjection?: boolean, projectionOperationId?: string): Promise<void>;
+export declare function completeQaFinalization(projectDir: string, runId: string, ticketId: string): void;