opencode-swarm 7.126.1 → 7.126.2

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

@@ -1,3 +1,4 @@
+import * as fsp from 'node:fs/promises';
 import { resolveCommitCountSince, resolveCurrentGitHead, resolveCurrentUpstreamPushTarget, resolveCurrentUpstreamRemoteRef, resolveExactRemoteBranchHead, resolveIsExactSingleChildCommit, resolveIsWorkingTreeClean, resolvePrWorkflowRevisionDigest, resolveRemoteRefsContainingHead } from '../background/workspace-snapshot.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: readonly ["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"];
@@ -137,6 +138,15 @@ export declare function activatePrWorkflow(directory: string, sessionID: string,
     prHeadSha?: string;
 }): Promise<PrWorkflowGateState>;
 export declare function readPrWorkflowGateState(directory: string, sessionID: string): Promise<PrWorkflowGateState | null>;
+/**
+ * Serialize a pre-bind checkout-preservation controller with every terminal
+ * PR-workflow transition for the raw parent session. The caller's action may
+ * perform the fixed Git preservation command while holding this lock; abort,
+ * bind, and a same-session reactivation cannot clear or replace the gate until
+ * it settles. The state passed to the action is schema-validated durable state,
+ * never a caller-supplied projection.
+ */
+export declare function withPrWorkflowCheckoutPreparationLock<T>(directory: string, sessionID: string, action: (state: PrWorkflowGateState) => Promise<T>): Promise<T>;
 export declare function clearPrWorkflowGateState(directory: string, sessionID: string, expectedRevision?: number): Promise<void>;
 /**
  * Abort an active PR workflow gate without reaching terminal completion.
@@ -268,6 +278,7 @@ export declare const _test_exports: {
     resolveRemoteRefsContainingHead: typeof resolveRemoteRefsContainingHead;
     parseCriticVerdict: typeof parseCriticVerdict;
     isProcessAlive: typeof isProcessAlive;
+    rename: typeof fsp.rename;
     nowMs: () => number;
 };
 /** Require at least one real discovery row or a lane-bound CLEAN attestation. */
@@ -279,4 +290,11 @@ declare function parseCriticVerdict(text: string, itemId: string, reviewerSeveri
 declare function isProcessAlive(pid: number): boolean;
 declare function workflowGateStateLockRelativePath(sessionID: string): string;
 declare function workflowGateStateRelativePath(sessionID: string): string;
+export declare function prWorkflowSessionFileStem(sessionID: string): string;
+/**
+ * Write a PR-workflow artifact with the gate's Windows-safe atomic persistence
+ * contract. Checkout-preparation receipts must survive the same transient
+ * rename contention as canonical gate state.
+ */
+export declare function writePrWorkflowAtomicJson(filePath: string, value: unknown): Promise<void>;
 export {};