opencode-swarm 7.145.2 → 7.146.1

package/dist/hooks/pr-workflow-gate.d.ts

@@ -5,6 +5,7 @@ import { type LaneOutputArtifact } from '../background/lane-output-store.js';
 import { type BackgroundDelegationRecord, type BackgroundDelegationResult, type BackgroundDelegationWorkflowLaneRecovery, findByBatchId, sweepStaleDelegations } from '../background/pending-delegations.js';
 import { type PrReviewInlineTriggerRow } from '../background/pr-review-trigger-contract.js';
 import { type RevisionDigestResult, resolveCommitCountSince, resolveCommitCountSinceAsync, resolveCurrentGitHead, resolveCurrentGitHeadAsync, resolveCurrentUpstreamPushTarget, resolveCurrentUpstreamPushTargetAsync, resolveCurrentUpstreamRemoteRef, resolveExactRemoteBranchHead, resolveExactRemoteBranchHeadAsync, resolveIsExactSingleChildCommit, resolveIsExactSingleChildCommitAsync, resolveIsWorkingTreeClean, resolveIsWorkingTreeCleanAsync, resolvePrReviewDiffStats, resolvePrReviewDiffStatsAsync, resolvePrWorkflowRevisionDigest, resolvePrWorkflowRevisionDigestDetailed, resolveRemoteRefsContainingHead, resolveRemoteRefsContainingHeadAsync } from '../background/workspace-snapshot.js';
+import { type PrReviewResilienceConfig } from '../config/schema.js';
 import { classifyPrWorkflowGitState, type PrWorkflowGitState } from '../git/pr-workflow-state.js';
 export declare const PR_REVIEW_BASE_DIMENSION_IDS: readonly ["intent-architecture", "correctness-state", "tests-falsifiability", "security-trust", "reliability-performance", "compatibility-delivery"];
 export declare const PR_REVIEW_REQUIRED_MICRO_LANE_IDS: ("auth-identity-secrets" | "untrusted-input-boundaries" | "subprocess-platform" | "concurrency-state" | "dependencies-build-release" | "api-schema-migrations" | "test-infrastructure" | "ui-accessibility-i18n" | "privacy-observability" | "generated-provenance" | "unclassified-risk")[];
@@ -161,6 +162,36 @@ interface PrReviewBaseDispatchRecord {
     }>;
     validatedAt: string;
 }
+interface PrReviewResiliencePolicyRecord {
+    enabled: boolean;
+    canaryProbeMs: number;
+    statusProbeTimeoutMs: number;
+    correlatedFailureThreshold: number;
+    maxRetryAttemptsAfterInitial: number;
+}
+interface PrReviewResilienceAttemptRecord {
+    attempt: 0 | 1 | 2;
+    targetDimensions: PrReviewBaseDimensionId[];
+    canaryBatchId: string;
+    canaryLaneId: string;
+    canaryWorkflowLane: PrReviewBaseDimensionId;
+    admittedAt: string;
+    fanoutBatchId?: string;
+}
+interface PrReviewResilienceCircuitRecord {
+    signature: string;
+    count: number;
+    contributors: Array<{
+        batchId: string;
+        laneId: string;
+    }>;
+    openedAt: string;
+}
+interface PrReviewResilienceStateRecord {
+    policy: PrReviewResiliencePolicyRecord;
+    attempts: PrReviewResilienceAttemptRecord[];
+    circuit?: PrReviewResilienceCircuitRecord;
+}
 interface PrFeedbackVerificationRecord {
     batchId: string;
     ownership: PrFeedbackLaneOwnership[];
@@ -299,6 +330,7 @@ export interface PrWorkflowGateState {
     prReviewBaseDispatches?: PrReviewBaseDispatchRecord[];
     /** @deprecated Compatibility projection of the most recent base dispatch. */
     prReviewBaseDispatch?: PrReviewBaseDispatchRecord;
+    prReviewResilience?: PrReviewResilienceStateRecord;
     /** Canonical ordered semantic ledger frozen by the first micro dispatch. */
     prReviewTriggerLedger?: PrReviewInlineTriggerRow[];
     prReviewTriggerEvalPath?: string;
@@ -650,11 +682,24 @@ export declare function assertCurrentCheckoutHead(directory: string, expectedHea
 /** Prove that every PR-review lane reads the immutable checked-out PR tree. */
 export declare function assertPrReviewCleanCheckout(directory: string, mode?: PrWorkflowMode): Promise<void>;
 export declare function enforcePrWorkflowDispatchLanesAsync(directory: string, sessionID: string, toolName: string): Promise<PrWorkflowGateState | null>;
-export declare function enforcePrReviewBaseDimensions(directory: string, sessionID: string, lanes: readonly PrWorkflowLaneSpec[], options: {
+export declare class PrReviewResilienceCircuitOpenError extends Error {
+    readonly code: "PR_REVIEW_RESILIENCE_CIRCUIT_OPEN";
+    constructor(message: string);
+}
+export declare class PrReviewResilienceRetryExhaustedError extends Error {
+    readonly code: "PR_REVIEW_RESILIENCE_RETRY_EXHAUSTED";
+    constructor(message: string);
+}
+interface EnforcePrReviewBaseDimensionsOptions {
     batchId: string;
     prHeadSha: string;
     revisionDigest?: string;
-}): Promise<PrWorkflowGateState>;
+    prReviewWaveStage?: 'canary' | 'fanout';
+    prReviewWaveAttempt?: 0 | 1 | 2;
+    prReviewResiliencePolicy?: PrReviewResilienceConfig;
+}
+export declare function enforcePrReviewBaseDimensions(directory: string, sessionID: string, lanes: readonly PrWorkflowLaneSpec[], options: EnforcePrReviewBaseDimensionsOptions): Promise<PrWorkflowGateState>;
+export declare function rollbackPrReviewBaseAdmissionIfUnlaunched(directory: string, sessionID: string, batchId: string): Promise<boolean>;
 declare function minimumConsolidatedLaneCover(sets: ReadonlyArray<readonly string[]>): number;
 /** Validate durable exact-six PR review evidence across all base and retry batches. */
 export declare function assertPrReviewBaseCoverageSettled(directory: string, sessionID: string, gateContext?: PrReviewGateContext): Promise<PrWorkflowGateState>;
@@ -822,6 +867,7 @@ export declare const _test_exports: {
      * that would silently drift if the cap ever moved.
      */
     MAX_WORKFLOW_BATCHES: number;
+    MAX_PR_REVIEW_RESILIENCE_CIRCUIT_CONTRIBUTORS: number;
     /**
      * The three ledger ceilings whose overflow makes the capacity GC abandon a
      * prune and keep every batch. Exposed on the same reasoning as

package/dist/hooks/pr-workflow-response-gate.d.ts

@@ -1,9 +1,15 @@
 import { claimPrFeedbackMonitorEvents, readPrFeedbackMonitorQueue } from '../background/pr-feedback-event-queue.js';
+import { observePrWorkflowAutoWakeEvent } from './pr-workflow-auto-wake.js';
 import { type PrReviewDepthTier, readPrWorkflowGateState } from './pr-workflow-gate.js';
+export declare const DEFAULT_BOUNDARY_QUIET_MS = 120000;
+export declare const DEFAULT_BOUNDARY_WATCHDOG_MS = 5000;
+export declare const DEFAULT_STATUS_PROBE_TIMEOUT_MS = 250;
+export declare const MAX_TRACKED_BOUNDARY_TOOL_PARTS = 200;
 export declare const _internals: {
     readPrWorkflowGateState: typeof readPrWorkflowGateState;
     claimPrFeedbackMonitorEvents: typeof claimPrFeedbackMonitorEvents;
     readPrFeedbackMonitorQueue: typeof readPrFeedbackMonitorQueue;
+    observePrWorkflowAutoWakeEvent: typeof observePrWorkflowAutoWakeEvent;
 };
 /**
  * Maximum number of consecutive unproductive auto-resumes per gated session
@@ -85,9 +91,13 @@ export declare const DEFAULT_TOTAL_WAKE_CEILINGS: Record<PrReviewDepthTier, numb
  * messageID-less path).
  */
 export declare const MAX_TRACKED_WAKE_SESSIONS = 200;
+type SessionReadiness = 'idle' | 'busy' | 'retry' | 'unknown';
 interface PrWorkflowResponseGateClient {
     session?: unknown;
 }
+type TimerHandle = ReturnType<typeof setTimeout>;
+type ScheduleTimer = (callback: () => void, delayMs: number) => TimerHandle;
+type ClearScheduledTimer = (timer: TimerHandle) => void;
 interface WakeBudget {
     consecutiveUnproductive: number;
     lastWakeAt: number;
@@ -142,6 +152,12 @@ export declare function createPrWorkflowResponseGate(options: {
     maxConsecutiveUnproductiveWakes?: number;
     wakeCooldownMs?: number;
     bannerCooldownMs?: number;
+    boundaryQuietMs?: number;
+    boundaryWatchdogMs?: number;
+    statusProbeTimeoutMs?: number;
+    now?: () => number;
+    scheduleTimer?: ScheduleTimer;
+    clearScheduledTimer?: ClearScheduledTimer;
     /** Override the per-tier default total-wake ceilings. A single number
      * applies uniformly to all tiers; a partial Record allows per-tier
      * overrides with unspecified tiers falling back to the defaults.
@@ -166,5 +182,13 @@ export declare function createPrWorkflowResponseGate(options: {
      * without relying on `promptAsync` call counts alone.
      */
     _inspectWakeBudget: (sessionID: string) => WakeBudget | undefined;
+    _inspectBoundaryActivity: (sessionID: string) => {
+        lastParentActivityAt: number;
+        lastHostStatus: SessionReadiness;
+        activeToolPartCount: number;
+        quietDeadlineAt?: number;
+        watchdogDeadlineAt?: number;
+        hasTimer: boolean;
+    } | undefined;
 };
 export {};