opencode-swarm 7.173.1 → 7.174.0

package/dist/events/core-events.d.ts

@@ -106,6 +106,8 @@ export declare const _internals: {
     readonly limits: CoreEventLimits;
     readonly emitHealth: typeof emitCoreEventsHealth;
 };
+/** Canonical project-root path for the bounded core-event store. */
+export declare function coreEventsFilePath(directory: string): string;
 export type CoreEventCoverage = 'complete' | 'truncated' | 'empty';
 /** The bounded view of the retained window. `text` is manifest-stripped event
  *  lines in append order (possibly starting mid-line when truncated). */

package/dist/evidence/task-gate-requirements.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import type { TaskEvidence, TaskWorkflowTransitionEvent } from '../gate-evidence.js';
+import type { ReviewRouteEvidence } from '../review/routing-enforcement.js';
 declare const TaskGateRequirementsReceiptSchema: z.ZodObject<{
     schemaVersion: z.ZodLiteral<1>;
     taskId: z.ZodString;
@@ -10,11 +11,34 @@ declare const TaskGateRequirementsReceiptSchema: z.ZodObject<{
     sourceEvent: z.ZodString;
     sourceTransitionId: z.ZodNullable<z.ZodString>;
     recordedAt: z.ZodString;
+    routeBinding: z.ZodOptional<z.ZodObject<{
+        role: z.ZodEnum<{
+            reviewer: "reviewer";
+            test_engineer: "test_engineer";
+        }>;
+        identity: z.ZodString;
+        sessionId: z.ZodString;
+        taskId: z.ZodString;
+        slotId: z.ZodString;
+        callId: z.ZodString;
+        childSessionId: z.ZodString;
+        generation: z.ZodNumber;
+    }, z.core.$strict>>;
     previousChainHash: z.ZodNullable<z.ZodString>;
     chainHash: z.ZodString;
 }, z.core.$strict>;
 export type TaskGateRequirementsReceipt = z.infer<typeof TaskGateRequirementsReceiptSchema>;
 export declare function taskGateRequirementsReceiptPath(directory: string, taskId: string): string;
 export declare function readTaskGateRequirementsReceipts(directory: string, taskId: string): Promise<TaskGateRequirementsReceipt[]>;
+/** Synchronous twin used by the synchronous Stage-B and status predicates. */
+export declare function readTaskGateRequirementsReceiptsSync(directory: string, taskId: string): TaskGateRequirementsReceipt[];
+/**
+ * Reconstructs exact route evidence from the append-only durable requirement
+ * chain. A retry for the same call/child/generation replaces that dispatch's
+ * row; distinct dispatch identities retain distinct route slots.
+ */
+export declare function routeEvidenceFromTaskGateRequirements(receipts: readonly TaskGateRequirementsReceipt[]): ReviewRouteEvidence[];
+/** Positive proof that an evidence chain predates v1 route-bound receipts. */
+export declare function isLegacyTaskGateRequirementsChain(receipts: readonly TaskGateRequirementsReceipt[]): boolean;
 export declare function appendTaskGateRequirementsReceiptIfNeeded(directory: string, taskId: string, current: TaskEvidence | null, next: TaskEvidence, event: TaskWorkflowTransitionEvent): Promise<void>;
 export {};

package/dist/gate-evidence.d.ts

@@ -17,6 +17,7 @@
  * that requires a protected trust root outside the project workspace.
  */
 import { appendTaskGateRequirementsReceiptIfNeeded } from './evidence/task-gate-requirements.js';
+import type { ReviewRouteEvidence } from './review/routing-enforcement.js';
 import type { TaskWorkflowState } from './state';
 export declare const _internals: {
     appendTaskGateRequirementsReceiptIfNeeded: typeof appendTaskGateRequirementsReceiptIfNeeded;
@@ -117,6 +118,15 @@ export type TaskWorkflowTransitionEvent = {
     type: 'stage_b_completed';
     gate: 'reviewer' | 'test_engineer';
     sessionId: string;
+    /** Exact v1 route tuple persisted with durable gate requirements evidence. */
+    routeBinding?: ReviewRouteEvidence;
+    /**
+     * The v1 route predicate evaluated over this completion's prospective
+     * tuple set. When false, retain the sequential intermediate state even
+     * though the role-level gate summary is now present; only true permits
+     * the durable Stage-B transition to tests_run.
+     */
+    routeComplete?: boolean;
     turbo?: boolean;
     ensureDefaultStageB?: boolean;
     expectedGeneration: number;
@@ -206,6 +216,8 @@ export declare function recordGateEvidence(directory: string, taskId: string, ga
     expectedGeneration?: number;
     transitionId?: string;
     ensureDefaultStageB?: boolean;
+    routeBinding?: ReviewRouteEvidence;
+    routeComplete?: boolean;
 }): Promise<void>;
 /**
  * Compatibility API for a settled non-gate dispatch. Coder callers represent

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

@@ -12,6 +12,7 @@ import { classifyPrWorkflowGitState, type PrWorkflowGitState } from '../git/pr-w
 import { type PrReviewReentryAuthorizationRecord, type PrReviewReentryBindingContext, type PrReviewReentryRole } from '../pr-review/authorization.js';
 import { classifyPrReviewCircuitSignal, type PrReviewCircuitLegacyRecord, type PrReviewCircuitRecordV2, type PrReviewResiliencePolicyRecord, resolvePrReviewResiliencePolicy } from '../pr-review/circuit.js';
 import { type PrReviewDimensionCancellationRecord, type PrReviewPartialBaseCoverageRecord, type PrReviewReportVerdict, type PrReviewTerminalCoverageSettlement } from '../pr-review/completion.js';
+import { type CriticOutcome } from '../pr-review/finding-policy.js';
 import { type PrReviewComposablePhase, type PrReviewPhaseComposition, parseCriticVerdict } from '../pr-review/legacy-transcript-adapter.js';
 import { withPrWorkflowCheckoutMutationLock, workflowCheckoutMutationLockRelativePath, workflowGateStateLockRelativePath, workflowGateStateRelativePath } from '../pr-review/persistence.js';
 import { classifyLaneLivenessCondition, type EffectivePrLaneHorizon, resolveEffectivePrLaneHorizonMs } from './lane-liveness-watchdog.js';
@@ -1322,6 +1323,12 @@ export declare function markPrReviewHandoffComplete(directory: string, sessionID
     state: PrWorkflowGateState;
     alreadyOffered: boolean;
 }>;
+/** Read-only final finding-policy projection for completion reports. */
+export declare function readPrReviewFinalFindingPolicyForReport(directory: string, sessionID: string): Promise<{
+    policyVersion: 1;
+    permittedVerdicts: readonly PrReviewReportVerdict[];
+    blockingFindingIds: string[];
+} | null>;
 export declare function transitionPrReviewToFeedback(directory: string, sessionID: string, request: {
     runId: string;
     handoffPath: string;
@@ -1682,6 +1689,12 @@ interface CandidateArtifactParseResult {
 declare function resolvePrReviewRowFamily(workflowLane: string | undefined, mode?: string): RowFormatFamily;
 declare function parseCanonicalCandidateRows(text: string, fallbackFamily: RowFormatFamily): CandidateArtifactParseResult;
 declare function extractCandidateIds(text: string, fallbackFamily: RowFormatFamily, scopeToLanes?: readonly string[]): string[];
+/** Read the durable critic settlement projection used by terminal readiness. */
+export declare function readAuthoritativePrReviewCriticSettlements(directory: string, sessionID: string): Promise<Array<{
+    findingId: string;
+    terminal: boolean;
+    status: CriticOutcome;
+}>>;
 /**
  * **B1 invariant — the accounting defect class's most dangerous recurrence.**
  *
@@ -1708,6 +1721,15 @@ declare function extractCandidateIds(text: string, fallbackFamily: RowFormatFami
  * 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;
+/**
+ * Read the authenticated critic verdict map for artifact adapters.  Keeping
+ * this behind the same B1-guarded accessor prevents a caller-supplied policy
+ * field from becoming a second authority for critic settlement.
+ */
+export declare function readAuthoritativePrReviewCriticVerdicts(directory: string, sessionID: string): Promise<Map<string, {
+    status: string;
+    severity: string;
+}>>;
 interface ExpectedWorkflowLane {
     laneId: string;
     workflowLane: string;

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import type { Plugin } from '@opencode-ai/plugin';
+import { type SoundingBoardResponse } from './agents/critic.js';
 import { loadPluginConfigWithMetaAsync } from './config';
 import { resolveAutoReviewConfig } from './config/schema';
 import { createRepoGraphBuilderHook } from './hooks';
@@ -18,6 +19,13 @@ export declare function capSessionMap<K, V>(map: Map<K, V>, max: number,
  * fresh entry can be the oldest and evict itself at the cap — mirroring
  * the stored-input-args guard). */
 justInserted?: K): void;
+/**
+ * Apply the sounding-board response contract at the host handoff boundary.
+ * Missing/malformed category metadata may never preserve UNNECESSARY: the
+ * response is surfaced as APPROVED with an observable warning. A caller-owned
+ * category is passed separately so a model cannot relabel a sticky decision.
+ */
+export declare function applySoundingBoardResponsePolicy(rawResponse: string, args?: unknown): SoundingBoardResponse | null;
 /** @internal — test-only: clears delegation-telemetry pairing state so one
  * test's unconsumed entries (e.g. a before with no matching after) cannot
  * leak into the next. Mirrors resetTelemetryForTesting / resetSwarmState. */