opencode-swarm 7.137.0 → 7.137.2

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

@@ -1,4 +1,6 @@
 import * as fsp from 'node:fs/promises';
+import { type LaneOutputArtifact } from '../background/lane-output-store.js';
+import { type BackgroundDelegationRecord, type BackgroundDelegationResult, findByBatchId } 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 PrWorkflowGitState } from '../git/pr-workflow-state.js';
@@ -6,6 +8,33 @@ export declare const PR_REVIEW_BASE_DIMENSION_IDS: readonly ["intent-architectur
 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")[];
 export type PrReviewBaseDimensionId = (typeof PR_REVIEW_BASE_DIMENSION_IDS)[number];
 export type PrWorkflowMode = 'PR_REVIEW' | 'PR_FEEDBACK';
+export type PrReviewLaneValidationPredicate = 'batch.validated_at' | 'batch.expected_lane_unique' | 'record.missing' | 'record.duplicate_lane' | 'record.subagent_session_id' | 'record.duplicate_subagent_session_id' | 'record.forbidden_subagent_session_id' | 'record.created_at' | 'record.workflow_lane' | 'record.owned_workflow_lanes' | 'record.mode' | 'record.pr_head_sha' | 'record.git_head' | 'record.status' | 'result.output_degraded' | 'result.transcript_incomplete' | 'result.truncated' | 'result.chars' | 'result.digest' | 'result.output_ref' | 'artifact.readable' | 'artifact.ref' | 'artifact.batch_id' | 'artifact.lane_id' | 'artifact.mode' | 'artifact.session_id' | 'artifact.parent_session_id' | 'artifact.agent' | 'artifact.role' | 'artifact.source' | 'artifact.workflow_lane_record' | 'artifact.workflow_lane_expected' | 'artifact.pr_head_sha' | 'artifact.git_head' | 'artifact.revision_digest' | 'record.scope' | 'artifact.scope' | 'artifact.digest' | 'artifact.chars' | 'discovery.header' | 'discovery.row' | 'discovery.coverage' | 'discovery.duplicate_evidence';
+export interface PrReviewLaneValidationFailure {
+    predicate: PrReviewLaneValidationPredicate;
+    expected: string;
+    actual: string;
+}
+export type PrReviewLaneValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    failure: PrReviewLaneValidationFailure;
+};
+export interface PrReviewDiscoveryLaneValidationInput {
+    record: BackgroundDelegationRecord;
+    result: BackgroundDelegationResult;
+    artifact: LaneOutputArtifact | null;
+    expected: {
+        mode: 'swarm-pr-review:base' | 'swarm-pr-review:micro';
+        workflowLane: string;
+        ownedWorkflowLanes?: readonly string[];
+        prHeadSha: string;
+        gitHead: string;
+        revisionDigest: string;
+        reviewScope?: string;
+        checkWorkflowLane?: boolean;
+    };
+}
 export interface PrWorkflowCheckoutRecoveryRecord {
     code: 'UNMERGED_INDEX' | 'GIT_OPERATION_IN_PROGRESS' | 'DIRTY_SUBMODULE' | 'SWARM_STATE_TRACKING_ERROR' | 'GIT_STATE_INDETERMINATE';
     retryable: false;
@@ -460,6 +489,7 @@ export declare function enforcePrWorkflowToolBefore(directory: string, sessionID
 export declare function completePrWorkflow(directory: string, sessionID: string, expectedMode: PrWorkflowMode, prHeadSha: string): Promise<PrWorkflowCompletionStatus>;
 export declare const _test_exports: {
     minimumConsolidatedLaneCover: typeof minimumConsolidatedLaneCover;
+    analyzePrReviewBatchRecordIntegrity: typeof analyzePrReviewBatchRecordIntegrity;
     MAX_COVER_UNIVERSE_BITS: number;
     workflowGateStateRelativePath: typeof workflowGateStateRelativePath;
     workflowGateStateLockRelativePath: typeof workflowGateStateLockRelativePath;
@@ -678,6 +708,45 @@ interface PrReviewPhaseComposition {
  * already computed: no digest resolution, no artifact reads, no subprocess work.
  */
 declare function assertSettledPhaseHasAuthoritativeVerdicts(phase: PrReviewComposablePhase, composed: Pick<PrReviewPhaseComposition, 'requiredInventory' | 'unclaimed'>, authoritative: ReadonlyMap<string, unknown>, origin: string): void;
+interface ExpectedWorkflowLane {
+    laneId: string;
+    workflowLane: string;
+    reviewItemIds?: string[];
+    ownedWorkflowLanes?: string[];
+}
+interface QualifiedBatchRecord {
+    record: ReturnType<typeof findByBatchId>[number];
+    expectedLane: ExpectedWorkflowLane;
+    expectedWorkflowLane: string;
+    expectedOwnedLanes: string[];
+}
+type BatchRecordIntegrityAnalysis = ({
+    ok: true;
+} & QualifiedBatchRecord) | {
+    ok: false;
+    expectedLane: ExpectedWorkflowLane;
+    expectedWorkflowLane: string;
+    expectedOwnedLanes: string[];
+    failure: PrReviewLaneValidationFailure;
+};
+export declare function formatPrReviewLaneValidationFailure(failure: PrReviewLaneValidationFailure): string;
+declare function analyzePrReviewBatchRecordIntegrity(args: {
+    batchId: string;
+    expectedLanes: ReadonlyArray<ExpectedWorkflowLane>;
+    expectedMode: string;
+    validatedAt: string;
+    checkWorkflowLane: boolean;
+    forbiddenSubagentSessionIds: ReadonlySet<string>;
+    records: readonly BackgroundDelegationRecord[];
+    expectedPrHeadSha?: string;
+}): BatchRecordIntegrityAnalysis[];
+/**
+ * Validate a just-collected base/micro discovery result before the delegation
+ * ledger publishes it as completed. The caller supplies the prospective result
+ * and the exact stored artifact, so this pure validator cannot accidentally
+ * accept stale terminal state or a different output reference.
+ */
+export declare function validatePrReviewDiscoveryLaneCompletion(input: PrReviewDiscoveryLaneValidationInput): PrReviewLaneValidationResult;
 /** Require at least one semantically valid discovery row or CLEAN attestation. */
 export declare function prReviewDiscoveryArtifactCoversLane(text: string, expectedWorkflowLane: string, ownedWorkflowLanes?: readonly string[]): boolean;
 declare function parseCriticVerdict(text: string, itemId: string, reviewerSeverity?: string): {

package/dist/index.d.ts

@@ -50,5 +50,7 @@ export type { AgentDefinition } from './agents';
 export type { AgentName, AutomationCapabilities, AutomationConfig, AutomationMode, PipelineAgentName, PluginConfig, QAAgentName, } from './config';
 export { loadTier1EvaluationTasks } from './evaluation/fixtures.js';
 export { recordTestImpactGateGroundTruth } from './evaluation/gate-ground-truth.js';
+export type { EvaluatePrReviewRecoveryV1Options } from './evaluation/pr-review-recovery.js';
+export { evaluatePrReviewRecoveryV1 } from './evaluation/pr-review-recovery.js';
 export type { EvaluateCandidateV1Options, EvaluateCandidateV1Result, } from './evaluation/public-api.js';
 export { evaluateCandidateV1, evaluationV1, } from './evaluation/public-api.js';