opencode-swarm 7.137.0 → 7.137.1

package/dist/cli/{index-mg26zd8x.js → index-a3gpeb4f.js}

@@ -4,7 +4,7 @@ import {
 } from "./index-rtry5xyf.js";
 import {
   readKnowledgeEvents
-} from "./index-72wzb81c.js";
+} from "./index-t5099rx9.js";
 import {
   isLinked,
   readLinkPointer,

package/dist/cli/{index-k3mezk96.js → index-b2s3t517.js}

@@ -737,7 +737,8 @@ async function runExecutorWithinBudget(args) {
         instruction: args.instruction,
         payload: args.payload,
         seed: args.seed,
-        abortSignal: controller.signal
+        abortSignal: controller.signal,
+        projectRoot: args.options.projectRoot
       }),
       aborted
     ]);
@@ -1072,7 +1073,7 @@ var _internals3 = {
 function createModelEvaluationExecutor(dispatcher, parentSessionId) {
   return async (args) => {
     const result = await dispatcher({
-      directory: args.isolatedRoot,
+      sessionDirectory: args.projectRoot,
       agentName: args.candidate.agent ?? "reviewer",
       modelId: args.candidate.model,
       system: args.payload,
@@ -1080,6 +1081,7 @@ function createModelEvaluationExecutor(dispatcher, parentSessionId) {
         "EVALUATION TASK:",
         args.instruction,
         "",
+        `Work ONLY in this directory: ${args.isolatedRoot}`,
         "Return the task-required scorer payload exactly."
       ].join(`
 `),

package/dist/cli/{index-wg98bsxz.js → index-bxk0a1r9.js}

@@ -2,7 +2,7 @@
 import {
   readKnowledge,
   transactKnowledge
-} from "./index-fgkhpdc6.js";
+} from "./index-t2mv25yf.js";
 import {
   resolveKnowledgeStoreDir
 } from "./index-vft1pg34.js";

package/dist/cli/{index-pcwjz5de.js → index-d67810xe.js}

@@ -6,7 +6,7 @@ import {
   PluginConfigSchema,
   init_schema,
   resolveExternalSkillsConfig
-} from "./index-mwdzkr6k.js";
+} from "./index-1qn2gchc.js";
 import {
   advisoryWarn,
   init_warning_buffer

package/dist/cli/{index-d0nhz96c.js → index-d8rc8c9y.js}

@@ -12,14 +12,14 @@ import {
   detectPosixWrites,
   detectWindowsWrites,
   resolveWriteTargets
-} from "./index-92v63zzr.js";
+} from "./index-9vqxf9pd.js";
 import {
   checkFileAuthority,
   classifyFile,
   isInDeclaredScope,
   redactPath,
   redactShellCommand
-} from "./index-j6ewv2pe.js";
+} from "./index-em10pmph.js";
 
 // src/services/guardrail-explain-service.ts
 import path from "path";

package/dist/cli/{index-aze9n64z.js → index-e0nvge1c.js}

@@ -7,7 +7,7 @@ import {
   loadPluginConfigWithMeta,
   loadPluginConfigWithMetaAsync,
   resolveWorktreeIsolationConfig
-} from "./index-pcwjz5de.js";
+} from "./index-d67810xe.js";
 import {
   ApprovalEvidenceSchema,
   BaseEvidenceSchema,
@@ -54,7 +54,7 @@ import {
   TurboConfigSchema,
   WorktreeIsolationConfigSchema,
   resolveAutoReviewConfig
-} from "./index-mwdzkr6k.js";
+} from "./index-1qn2gchc.js";
 import"./index-bk5tah7q.js";
 import {
   MigrationStatusSchema,

package/dist/cli/{index-j6ewv2pe.js → index-em10pmph.js}

@@ -2,7 +2,7 @@
 import {
   init_schema,
   stripKnownSwarmPrefix
-} from "./index-mwdzkr6k.js";
+} from "./index-1qn2gchc.js";
 import {
   init_constants
 } from "./index-3jcyn8g6.js";

package/dist/cli/{index-91kk2e9j.js → index-gd47gp2q.js}

@@ -6,7 +6,7 @@ import {
   PluginConfigSchema,
   init_schema,
   stripKnownSwarmPrefix
-} from "./index-mwdzkr6k.js";
+} from "./index-1qn2gchc.js";
 import {
   ALL_AGENT_NAMES,
   init_constants

package/dist/cli/{index-p124rnwb.js → index-k8y41t4y.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   authorizeCuration
-} from "./index-mg26zd8x.js";
+} from "./index-a3gpeb4f.js";
 import {
   findNearDuplicate,
   inferTags,
@@ -9,7 +9,7 @@ import {
   resolveSwarmKnowledgePath,
   resolveSwarmRejectedPath,
   transactKnowledge
-} from "./index-fgkhpdc6.js";
+} from "./index-t2mv25yf.js";
 import {
   resolveKnowledgeStoreDir
 } from "./index-vft1pg34.js";

package/dist/cli/{index-d00q9kpq.js → index-m4s91910.js}

@@ -6,13 +6,13 @@ import {
   resolveSwarmKnowledgePath,
   transactKnowledge,
   wordBigrams
-} from "./index-fgkhpdc6.js";
+} from "./index-t2mv25yf.js";
 import {
   countEntryContradictionsInWindow,
   countEntryViolationsInWindow,
   readKnowledgeEvents,
   recordKnowledgeEvent
-} from "./index-72wzb81c.js";
+} from "./index-t5099rx9.js";
 import {
   init_knowledge_types,
   isActiveStatus
@@ -190,11 +190,11 @@ async function maybeQuarantineOnContradiction(directory, entryId, threshold, win
         alreadyInactive: true
       };
     }
-    const { quarantineEntry } = await import("./knowledge-validator-bjxag1jp.js");
+    const { quarantineEntry } = await import("./knowledge-validator-gepda374.js");
     let policyConfig;
     try {
-      const { KnowledgeConfigSchema } = await import("./schema-11gyrec3.js");
-      const { loadPluginConfigWithMeta } = await import("./index-aze9n64z.js");
+      const { KnowledgeConfigSchema } = await import("./schema-mrbyt7dg.js");
+      const { loadPluginConfigWithMeta } = await import("./index-e0nvge1c.js");
       const { config: loadedConfig } = loadPluginConfigWithMeta(directory);
       policyConfig = KnowledgeConfigSchema.parse(loadedConfig.knowledge ?? {});
     } catch {

package/dist/cli/{index-y25nsyaq.js → index-pbe51g7h.js}

@@ -2,7 +2,7 @@
 import {
   redactPath,
   redactShellCommand
-} from "./index-j6ewv2pe.js";
+} from "./index-em10pmph.js";
 
 // src/services/guardrail-log-service.ts
 import * as fs from "fs/promises";

package/dist/cli/{index-fgkhpdc6.js → index-t2mv25yf.js}

@@ -702,7 +702,7 @@ async function applyConfidenceFloorAction(directory, touched, options) {
   const recovered = touched.filter((e) => e.confidence > CONFIDENCE_FLOOR + FLOOR_EPSILON && e.confidence_floor_demoted);
   if (atFloor.length === 0 && recovered.length === 0)
     return;
-  const { readKnowledgeCounterRollups, effectiveRetrievalOutcomes } = await import("./knowledge-events-8nz3sa2d.js");
+  const { readKnowledgeCounterRollups, effectiveRetrievalOutcomes } = await import("./knowledge-events-3c0g2xbm.js");
   const rollups = await readKnowledgeCounterRollups(directory);
   const flagIds = new Set;
   for (const e of atFloor) {
@@ -769,11 +769,11 @@ async function applyConfidenceFloorAction(directory, touched, options) {
     });
   }
   if (action === "quarantine" && toQuarantine.length > 0) {
-    const { quarantineEntry } = await import("./knowledge-validator-bjxag1jp.js");
-    const { KnowledgeConfigSchema } = await import("./schema-11gyrec3.js");
+    const { quarantineEntry } = await import("./knowledge-validator-gepda374.js");
+    const { KnowledgeConfigSchema } = await import("./schema-mrbyt7dg.js");
     let config;
     try {
-      const { loadPluginConfigWithMeta } = await import("./index-aze9n64z.js");
+      const { loadPluginConfigWithMeta } = await import("./index-e0nvge1c.js");
       const { config: loadedConfig } = loadPluginConfigWithMeta(directory);
       config = KnowledgeConfigSchema.parse(loadedConfig.knowledge ?? {});
     } catch {

package/dist/cli/{index-72wzb81c.js → index-t5099rx9.js}

@@ -625,7 +625,7 @@ async function applyKnowledgeVerdictFeedback(directory, options) {
       deltas.push({ id, delta });
     }
     if (deltas.length > 0) {
-      const { bumpKnowledgeConfidenceBatch } = await import("./knowledge-store-esghe3f9.js");
+      const { bumpKnowledgeConfidenceBatch } = await import("./knowledge-store-pq43990j.js");
       await bumpKnowledgeConfidenceBatch(directory, deltas, options?.floorOptions);
     }
     return {

package/dist/cli/{index-f24r6yqk.js → index-zxf5w0jj.js}

@@ -2,18 +2,18 @@
 import {
   ALLOWED_SKILL_PATH_PREFIXES,
   validateSkillPath
-} from "./index-p124rnwb.js";
+} from "./index-k8y41t4y.js";
 import {
   computeOutcomeSignal,
   readKnowledge,
   resolveHiveKnowledgePath,
   resolveSwarmKnowledgePath,
   transactKnowledge
-} from "./index-fgkhpdc6.js";
+} from "./index-t2mv25yf.js";
 import {
   effectiveRetrievalOutcomes,
   readKnowledgeCounterRollups
-} from "./index-72wzb81c.js";
+} from "./index-t5099rx9.js";
 import {
   init_knowledge_types,
   isActiveStatus

package/dist/cli/index.js

@@ -6,39 +6,39 @@ import {
   getPluginConfigDir,
   getPluginLockFilePaths,
   resolveCommand
-} from "./index-92v63zzr.js";
+} from "./index-9vqxf9pd.js";
 import"./index-vm4xw9z3.js";
-import"./index-k3mezk96.js";
-import"./index-j6ewv2pe.js";
-import"./index-91kk2e9j.js";
+import"./index-b2s3t517.js";
+import"./index-em10pmph.js";
+import"./index-gd47gp2q.js";
 import"./index-1zrb3vt2.js";
 import"./index-5wjw05dy.js";
 import"./index-y8552snf.js";
 import"./index-4905hd2m.js";
 import"./index-134d35c1.js";
-import"./index-f24r6yqk.js";
-import"./index-d00q9kpq.js";
-import"./index-wg98bsxz.js";
+import"./index-zxf5w0jj.js";
+import"./index-m4s91910.js";
+import"./index-bxk0a1r9.js";
 import"./index-6mjf4vr1.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
 import"./index-wsdnttf4.js";
 import"./index-5r6kkhd7.js";
-import"./index-p124rnwb.js";
-import"./index-mg26zd8x.js";
+import"./index-k8y41t4y.js";
+import"./index-a3gpeb4f.js";
 import"./index-rtry5xyf.js";
-import"./index-fgkhpdc6.js";
-import"./index-72wzb81c.js";
+import"./index-t2mv25yf.js";
+import"./index-t5099rx9.js";
 import"./index-ae75rja9.js";
 import"./index-vft1pg34.js";
 import"./index-n3h6rmbe.js";
-import"./index-pcwjz5de.js";
+import"./index-d67810xe.js";
 import"./index-k5jrywpr.js";
 import"./index-n832052r.js";
 import {
   init_package,
   package_default
-} from "./index-mwdzkr6k.js";
+} from "./index-1qn2gchc.js";
 import"./index-bk5tah7q.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";

package/dist/cli/{knowledge-escalator-9k0kbx6b.js → knowledge-escalator-3ds615yq.js}

@@ -8,9 +8,9 @@ import {
   maybeEscalateOnViolation,
   maybeQuarantineOnContradiction,
   readRecentEscalations
-} from "./index-d00q9kpq.js";
-import"./index-fgkhpdc6.js";
-import"./index-72wzb81c.js";
+} from "./index-m4s91910.js";
+import"./index-t2mv25yf.js";
+import"./index-t5099rx9.js";
 import"./index-ae75rja9.js";
 import"./index-vft1pg34.js";
 import"./index-n3h6rmbe.js";

package/dist/cli/{knowledge-events-8nz3sa2d.js → knowledge-events-3c0g2xbm.js}

@@ -28,7 +28,7 @@ import {
   resolveKnowledgeCounterBaselinePath,
   resolveKnowledgeEventsPath,
   resolveLegacyApplicationLogPath
-} from "./index-72wzb81c.js";
+} from "./index-t5099rx9.js";
 import"./index-ae75rja9.js";
 import"./index-vft1pg34.js";
 import"./index-n3h6rmbe.js";

package/dist/cli/{knowledge-store-esghe3f9.js → knowledge-store-pq43990j.js}

@@ -41,7 +41,7 @@ import {
   transactKnowledge,
   transactKnowledgeWithCas,
   wordBigrams
-} from "./index-fgkhpdc6.js";
+} from "./index-t2mv25yf.js";
 import {
   resolveHiveDataDir
 } from "./index-ae75rja9.js";

package/dist/cli/{knowledge-validator-bjxag1jp.js → knowledge-validator-gepda374.js}

@@ -23,11 +23,11 @@ import {
   validateLesson,
   validateSkillCandidatePath,
   validateSkillPath
-} from "./index-p124rnwb.js";
-import"./index-mg26zd8x.js";
+} from "./index-k8y41t4y.js";
+import"./index-a3gpeb4f.js";
 import"./index-rtry5xyf.js";
-import"./index-fgkhpdc6.js";
-import"./index-72wzb81c.js";
+import"./index-t2mv25yf.js";
+import"./index-t5099rx9.js";
 import"./index-ae75rja9.js";
 import"./index-vft1pg34.js";
 import"./index-n3h6rmbe.js";

package/dist/cli/{runner-d820ws7y.js → runner-9rqc8y3m.js}

@@ -3,7 +3,7 @@ import {
   _internals,
   createModelEvaluationExecutor,
   runEvaluation
-} from "./index-k3mezk96.js";
+} from "./index-b2s3t517.js";
 import"./index-5wjw05dy.js";
 import"./index-y8552snf.js";
 import"./index-n3h6rmbe.js";

package/dist/cli/{scan-cursor-t212v00f.js → scan-cursor-5hq37qdg.js}

@@ -4,8 +4,8 @@ import {
   alreadyCuratedThisGeneration,
   claimNextScanBatch,
   getScanStatus
-} from "./index-wg98bsxz.js";
-import"./index-fgkhpdc6.js";
+} from "./index-bxk0a1r9.js";
+import"./index-t2mv25yf.js";
 import"./index-ae75rja9.js";
 import"./index-vft1pg34.js";
 import"./index-n3h6rmbe.js";

package/dist/cli/{schema-11gyrec3.js → schema-mrbyt7dg.js}

@@ -95,7 +95,7 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-mwdzkr6k.js";
+} from "./index-1qn2gchc.js";
 import"./index-bk5tah7q.js";
 import"./index-3jcyn8g6.js";
 import"./index-bpmtbmy9.js";

package/dist/cli/{skill-generator-a07hpmw6.js → skill-generator-3gt8em6v.js}

@@ -33,12 +33,12 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-f24r6yqk.js";
-import"./index-p124rnwb.js";
-import"./index-mg26zd8x.js";
+} from "./index-zxf5w0jj.js";
+import"./index-k8y41t4y.js";
+import"./index-a3gpeb4f.js";
 import"./index-rtry5xyf.js";
-import"./index-fgkhpdc6.js";
-import"./index-72wzb81c.js";
+import"./index-t2mv25yf.js";
+import"./index-t5099rx9.js";
 import"./index-ae75rja9.js";
 import"./index-vft1pg34.js";
 import"./index-n3h6rmbe.js";

package/dist/evaluation/index.d.ts

@@ -9,6 +9,7 @@ export type { TaskInputHashLimits } from './hashing.js';
 export { canonicalHash, canonicalJson, computeCandidateInputContentHash, computeManifestContentHash, computeRunIntegrityHash, computeTaskContentHash, computeTaskInputContentHash, computeTaskLineageInputHash, computeTaskSetContentHash, contentHashWithout, resolveContainedExistingPath, sha256, } from './hashing.js';
 export type { EvaluationModelDispatcher, EvaluationModelDispatchRequest, EvaluationModelDispatchResult, } from './model-dispatcher.js';
 export { createEvaluationModelDispatcher, resolveEvaluationAgentName, } from './model-dispatcher.js';
+export * from './pr-review-recovery.js';
 export * from './public-api.js';
 export * from './retention.js';
 export type { EvaluationExecutor, EvaluationExecutorResult, RunEvaluationOptions, } from './runner.js';

package/dist/evaluation/model-dispatcher.d.ts

@@ -2,7 +2,25 @@ import type { Agent, OpencodeClient } from '@opencode-ai/sdk';
 import type { DelegationCostFields } from '../services/cost-accounting.js';
 import { _internals as ephemeralDispatcherInternals } from './ephemeral-agent-dispatcher.js';
 export type EvaluationModelDispatchRequest = {
-    directory: string;
+    /**
+     * The directory the ephemeral session is created against.
+     *
+     * This is the directory OpenCode uses to key permission state
+     * (`Permission.state`, `Agent.state`, `ToolRegistry.state` are all built
+     * through the directory-keyed `InstanceState` cache) AND to resolve
+     * registered agents. It MUST be the invoking instance's directory (the
+     * project root) so the session lands in the SAME permission partition as
+     * the user's session — a foreign directory gets a fresh, empty `approved`
+     * list and a private pending map that the user's TUI cannot reach, so an
+     * `external_directory` prompt raised there hangs forever.
+     *
+     * The SDK's `session.create` has no separate working-directory field, so
+     * this is also the agent's CWD. When the fixture the agent must inspect is
+     * NOT under this directory, the caller conveys the fixture path via the
+     * prompt (see gate-audit.ts `modelPrompt` and runner.ts
+     * `createModelEvaluationExecutor`).
+     */
+    sessionDirectory: string;
     agentName: string;
     modelId: string;
     prompt: string;

package/dist/evaluation/pr-review-recovery.d.ts

@@ -0,0 +1,41 @@
+import type { EvaluationRunV1 } from './contracts.js';
+import type { EvaluationModelDispatcher } from './model-dispatcher.js';
+export declare const PR_REVIEW_RECOVERY_BASE_SHA: "3811fe5981072c7fa541523e9f08430f18594590";
+type RecoveryBudgets = {
+    maxTasks: number;
+    maxRepetitions: number;
+    maxConcurrency: number;
+    maxTaskTimeMs: number;
+    maxRetries: number;
+    maxOutputBytes: number;
+    maxSpendUsd?: number;
+};
+export type EvaluatePrReviewRecoveryV1Options = {
+    projectRoot: string;
+    packageRoot?: string;
+    dispatcher: EvaluationModelDispatcher;
+    parentSessionId?: string;
+    model?: string;
+    seed?: string;
+    baselineSourceSha?: string;
+    budgets?: Partial<RecoveryBudgets>;
+    abortSignal?: AbortSignal;
+};
+type BaselineManifest = {
+    v: 1;
+    sourceSha: string;
+    payloadPath: string;
+    sha256: string;
+};
+declare function parseBaselineManifest(value: unknown): BaselineManifest;
+declare function verifyBaseline(packageRoot: string, requestedSourceSha: string): Promise<void>;
+/**
+ * Runs the packaged issue-2075 recovery scenario against the exact canonical
+ * PR-review skill and its content-addressed pre-hardening baseline.
+ */
+export declare function evaluatePrReviewRecoveryV1(options: EvaluatePrReviewRecoveryV1Options): Promise<EvaluationRunV1>;
+export declare const _internals: {
+    parseBaselineManifest: typeof parseBaselineManifest;
+    verifyBaseline: typeof verifyBaseline;
+};
+export {};

package/dist/evaluation/public-api.d.ts

@@ -1,6 +1,7 @@
 import type { EvaluationRunV1, PromotionDecisionV1, PromotionPolicyV1 } from './contracts.js';
 import { recordTestImpactGateGroundTruth } from './gate-ground-truth.js';
 import { computeCandidateInputContentHash, computeTaskInputContentHash } from './hashing.js';
+import { evaluatePrReviewRecoveryV1 } from './pr-review-recovery.js';
 import { type RunEvaluationOptions, runEvaluation } from './runner.js';
 import { type DecidePromotionInput } from './statistics.js';
 export type EvaluateCandidateV1Options = RunEvaluationOptions & {
@@ -25,6 +26,7 @@ export declare function evaluateCandidateV1(options: EvaluateCandidateV1Options)
  */
 export declare const evaluationV1: ((options: EvaluateCandidateV1Options) => Promise<EvaluateCandidateV1Result>) & {
     evaluateCandidate: typeof evaluateCandidateV1;
+    evaluatePrReviewRecovery: typeof evaluatePrReviewRecoveryV1;
     runEvaluation: typeof runEvaluation;
     decidePromotion: (input: DecidePromotionInput) => {
         v: 1;

package/dist/evaluation/runner.d.ts

@@ -19,6 +19,15 @@ export type EvaluationExecutor = (args: {
     payload: string;
     seed: string;
     abortSignal: AbortSignal;
+    /**
+     * The invoking instance's directory (the project root). An executor that
+     * creates an OpenCode session MUST bind it here — NOT to `isolatedRoot` —
+     * so the session lands in the same permission partition as the user's
+     * session (#2009). OpenCode keys permission state per directory; a foreign
+     * directory gets an empty approved list and a private pending map the TUI
+     * cannot reach, so a prompt raised there hangs forever.
+     */
+    projectRoot: string;
 }) => Promise<EvaluationExecutorResult>;
 export type RunEvaluationOptions = {
     projectRoot: string;

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';