@snappedly-tools/shipyard 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { B as BindMountSandboxHandle, S as SandboxProvider, a as BranchStrategy, A as AnySandboxProvider, E as ExecResult, M as MergeToHeadBranchStrategy, b as NamedBranchStrategy } from './SandboxProvider-KeFp_nju.js';
-export { c as BindMountBranchStrategy, d as BindMountCreateOptions, e as BindMountSandboxProvider, f as BindMountSandboxProviderConfig, H as HeadBranchStrategy, g as InteractiveExecOptions, h as IsolatedBranchStrategy, i as IsolatedCreateOptions, j as IsolatedSandboxHandle, I as IsolatedSandboxProvider, k as IsolatedSandboxProviderConfig, l as NoSandboxBranchStrategy, m as NoSandboxHandle, N as NoSandboxProvider, n as createBindMountSandboxProvider, o as createIsolatedSandboxProvider } from './SandboxProvider-KeFp_nju.js';
+import { B as BindMountSandboxHandle, S as SandboxProvider, a as BranchStrategy, A as AnySandboxProvider, E as ExecResult, M as MergeToHeadBranchStrategy, b as NamedBranchStrategy } from './SandboxProvider-XJQqEdSf.js';
+export { c as BindMountBranchStrategy, d as BindMountCreateOptions, e as BindMountSandboxProvider, f as BindMountSandboxProviderConfig, H as HeadBranchStrategy, g as InteractiveExecOptions, h as IsolatedBranchStrategy, i as IsolatedCreateOptions, j as IsolatedSandboxHandle, I as IsolatedSandboxProvider, k as IsolatedSandboxProviderConfig, l as NoSandboxBranchStrategy, m as NoSandboxHandle, N as NoSandboxProvider, n as createBindMountSandboxProvider, o as createIsolatedSandboxProvider } from './SandboxProvider-XJQqEdSf.js';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 export { M as MountConfig } from './MountConfig-bZoCs4Dd.js';
 
@@ -1166,6 +1166,8 @@ interface PhaseResult {
     readonly phase: WorkflowPhase;
     readonly outcome: PhaseOutcome;
     readonly identity: WorkIdentity;
+    /** Brief revision executed by this phase. */
+    readonly briefHash: string;
     readonly base?: RevisionReference;
     readonly head?: RevisionReference;
     readonly summary: string;
@@ -1198,6 +1200,14 @@ interface TransitionContext {
     readonly kind: WorkItemKind;
     readonly authorization: Authorization["status"];
     readonly checks?: readonly CheckEvidence[];
+    /** Required check names from the repository policy. */
+    readonly requiredCheckNames?: readonly string[];
+    /** Exact candidate identity required for lifecycle-gating check evidence. */
+    readonly checkCandidate?: {
+        readonly baseSha: string;
+        readonly headSha: string;
+        readonly briefHash: string;
+    };
     readonly review?: ReviewEvidence;
     readonly currentHeadSha?: string;
     readonly assignedHeadSha?: string;
@@ -1341,6 +1351,8 @@ interface CoordinatorStorageTransaction {
         readonly inserted: boolean;
     }>;
     saveEvent(event: StoredEvent): Promise<void>;
+    /** Serialize intake for an identity even before its first job row exists. */
+    lockWorkIdentity(identity: WorkIdentity): Promise<void>;
     getJob(jobId: string): Promise<WorkflowJob | undefined>;
     findJobByKey(key: WorkKey, briefHash: string): Promise<WorkflowJob | undefined>;
     findCurrentJob(identity: WorkIdentity): Promise<WorkflowJob | undefined>;
@@ -1364,6 +1376,8 @@ interface CoordinatorStorageTransaction {
     }>;
     saveEffect(effect: EffectIntent): Promise<void>;
     getLease(repository: string, branch: string): Promise<BranchLease | undefined>;
+    /** Serialize lease acquisition even when no lease row exists yet. */
+    lockLeaseResource(repository: string, branch: string): Promise<void>;
     saveLease(lease: BranchLease): Promise<void>;
     findLeasesForJob(jobId: string): Promise<readonly BranchLease[]>;
     findLeasesForRepository(repository: string): Promise<readonly BranchLease[]>;
@@ -1653,6 +1667,10 @@ interface PhaseEngineResponse {
     readonly outcome?: "completed" | "needs-info";
 }
 interface PhaseEngineAdapter {
+    /**
+     * Execute one phase. After `request.signal` aborts, this promise MUST settle
+     * only after the provider has stopped all work that can mutate the candidate.
+     */
     execute(request: PhaseEngineRequest): Promise<PhaseEngineResponse>;
 }
 interface FakePhaseEngineAdapterOptions {
@@ -2033,6 +2051,8 @@ interface GitHubAuthorizationPolicy {
     readonly allowedRepositories: readonly string[];
     /** Exact GitHub logins allowed to submit workflow input. */
     readonly allowedSenders: readonly string[];
+    /** Exact GitHub logins allowed to approve or request changes on tracked pull requests. */
+    readonly allowedReviewers: readonly string[];
     /** Additional service logins treated as bot-originated. */
     readonly botLogins?: readonly string[];
 }
@@ -2388,7 +2408,6 @@ interface ReviewFindingInput {
     readonly id: string;
     readonly severity: FindingSeverity;
     readonly axis: ReviewAxis;
-    readonly disposition: FindingDisposition;
     readonly title: string;
     readonly evidence: string;
     readonly location?: string;
@@ -2653,6 +2672,7 @@ interface ReleaseCandidate {
     readonly reviewedHeadSha: string;
     readonly briefHash: string;
     readonly artifactDigest: string;
+    /** Provider-specific immutable locator; integrity is bound separately by artifactDigest. */
     readonly artifactRef: string;
     readonly version?: string;
 }
@@ -2737,6 +2757,8 @@ interface ReleaseIntegrationOptions {
     readonly store: ReleaseStore;
     readonly transport: ReleaseTransport;
     readonly actor: ReleaseActor;
+    /** Validate a provider-specific immutable locator not covered by built-in formats. */
+    readonly validateArtifactRef?: (candidate: ReleaseCandidate) => string | undefined;
     readonly now?: () => string;
 }
 interface ReleaseOperationResult {
@@ -2748,7 +2770,7 @@ interface RecoveryRecord {
     readonly candidate: ReleaseCandidate;
     readonly action: ReleasePolicy["recoveryMode"];
     readonly reason: string;
-    readonly authorizedBy?: ReleaseActor;
+    readonly authorizedBy: ReleaseActor;
     readonly recordedAt: string;
 }
 declare const releaseCandidateKey: (candidate: ReleaseCandidate) => string;
@@ -2757,6 +2779,7 @@ declare class ReleaseIntegration {
     private readonly store;
     private readonly transport;
     private readonly actor;
+    private readonly validateArtifactRef?;
     private readonly now;
     constructor(options: ReleaseIntegrationOptions);
     private stateKey;
@@ -2772,7 +2795,7 @@ declare class ReleaseIntegration {
     recordRecovery(input: {
         readonly candidate: ReleaseCandidate;
         readonly reason: string;
-        readonly authorizedBy?: ReleaseActor;
+        readonly authorizedBy: ReleaseActor;
     }): RecoveryRecord;
 }
 declare const candidateMatchesApproval: (candidate: ReleaseCandidate, approval: ProductionApproval) => boolean;