opencode-swarm 7.134.1 → 7.134.3

package/dist/cli/{index-8t9xpn1a.js → index-6wya5cqh.js}

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

package/dist/cli/{index-k742ecbm.js → index-8fhg2nt2.js}

@@ -180,7 +180,7 @@ class BubblewrapSandboxExecutor {
       "--dev",
       "/dev",
       "--size",
-      "500M",
+      String(TMPFS_SIZE_BYTES),
       "--tmpfs",
       `'${shellEscape(temp)}'`,
       "--ro-bind",
@@ -210,7 +210,7 @@ class BubblewrapSandboxExecutor {
     return {};
   }
 }
-var BWRAP_VERSION_EXIT = 0, BWRAP_UNAVAILABLE_CODES, _internals2;
+var BWRAP_VERSION_EXIT = 0, BWRAP_UNAVAILABLE_CODES, TMPFS_SIZE_BYTES = 524288000, _internals2;
 var init_bubblewrap_executor = __esm(() => {
   init_logger();
   init_executor();

package/dist/cli/{index-9z1q181f.js → index-8wktghbc.js}

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

package/dist/cli/{index-c0e3vhv9.js → index-ddxt327j.js}

@@ -8,7 +8,7 @@ import {
   init_constants,
   init_schema,
   resolveExternalSkillsConfig
-} from "./index-y2esw64s.js";
+} from "./index-tsmjmhnk.js";
 import {
   advisoryWarn,
   init_warning_buffer

package/dist/cli/{index-kwm7hz18.js → index-mgr951p8.js}

@@ -6,13 +6,13 @@ import {
   resolveSwarmKnowledgePath,
   transactKnowledge,
   wordBigrams
-} from "./index-2j8f71c3.js";
+} from "./index-rjngxx7q.js";
 import {
   countEntryContradictionsInWindow,
   countEntryViolationsInWindow,
   readKnowledgeEvents,
   recordKnowledgeEvent
-} from "./index-8t9xpn1a.js";
+} from "./index-6wya5cqh.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-qg31ycbb.js");
+    const { quarantineEntry } = await import("./knowledge-validator-kc7fnt2r.js");
     let policyConfig;
     try {
-      const { KnowledgeConfigSchema } = await import("./schema-erk5bz43.js");
-      const { loadPluginConfigWithMeta } = await import("./index-463k8mfr.js");
+      const { KnowledgeConfigSchema } = await import("./schema-jb4p8ja9.js");
+      const { loadPluginConfigWithMeta } = await import("./index-reesz606.js");
       const { config: loadedConfig } = loadPluginConfigWithMeta(directory);
       policyConfig = KnowledgeConfigSchema.parse(loadedConfig.knowledge ?? {});
     } catch {

package/dist/cli/{index-6b69mp0r.js → index-q3m6bpx2.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   authorizeCuration
-} from "./index-zjw32rv9.js";
+} from "./index-y3rj2jgb.js";
 import {
   findNearDuplicate,
   inferTags,
@@ -9,7 +9,7 @@ import {
   resolveSwarmKnowledgePath,
   resolveSwarmRejectedPath,
   transactKnowledge
-} from "./index-2j8f71c3.js";
+} from "./index-rjngxx7q.js";
 import {
   resolveKnowledgeStoreDir
 } from "./index-cfkvc5q9.js";

package/dist/cli/{index-463k8mfr.js → index-reesz606.js}

@@ -7,7 +7,7 @@ import {
   loadPluginConfigWithMeta,
   loadPluginConfigWithMetaAsync,
   resolveWorktreeIsolationConfig
-} from "./index-c0e3vhv9.js";
+} from "./index-ddxt327j.js";
 import {
   ApprovalEvidenceSchema,
   BaseEvidenceSchema,
@@ -62,7 +62,7 @@ import {
   isQAAgent,
   isSubagent,
   resolveAutoReviewConfig
-} from "./index-y2esw64s.js";
+} from "./index-tsmjmhnk.js";
 import"./index-bk5tah7q.js";
 import {
   MigrationStatusSchema,

package/dist/cli/{index-2j8f71c3.js → index-rjngxx7q.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-qp19r2he.js");
+  const { readKnowledgeCounterRollups, effectiveRetrievalOutcomes } = await import("./knowledge-events-ykt8vrvj.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-qg31ycbb.js");
-    const { KnowledgeConfigSchema } = await import("./schema-erk5bz43.js");
+    const { quarantineEntry } = await import("./knowledge-validator-kc7fnt2r.js");
+    const { KnowledgeConfigSchema } = await import("./schema-jb4p8ja9.js");
     let config;
     try {
-      const { loadPluginConfigWithMeta } = await import("./index-463k8mfr.js");
+      const { loadPluginConfigWithMeta } = await import("./index-reesz606.js");
       const { config: loadedConfig } = loadPluginConfigWithMeta(directory);
       config = KnowledgeConfigSchema.parse(loadedConfig.knowledge ?? {});
     } catch {

package/dist/cli/{index-y2esw64s.js → index-tsmjmhnk.js}

@@ -19,7 +19,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "opencode-swarm",
-    version: "7.134.1",
+    version: "7.134.3",
     description: "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
     main: "dist/index.js",
     types: "dist/index.d.ts",

package/dist/cli/{index-mz6sqtm9.js → index-txwm0fv4.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-pz49rx4y.js";
+} from "./index-yaptf0hg.js";
 import {
   handleGuardrailLog
-} from "./index-9z1q181f.js";
+} from "./index-8wktghbc.js";
 import {
   COMMAND_REGISTRY,
   SWARM_COMMAND_TOOL_ALLOWLIST,
@@ -84,30 +84,30 @@ import {
   handleWriteRetroCommand,
   normalizeSwarmCommandInput,
   resolveCommand
-} from "./index-358f9h8p.js";
+} from "./index-6kfqz0jw.js";
 import"./index-13xxjfhn.js";
-import"./index-1v5mby7t.js";
-import"./index-bq2848a3.js";
-import"./index-k742ecbm.js";
+import"./index-yqvh2s4w.js";
+import"./index-2b7sv71f.js";
+import"./index-8fhg2nt2.js";
 import"./index-4905hd2m.js";
 import"./index-134d35c1.js";
-import"./index-m8ajf6wb.js";
-import"./index-kwm7hz18.js";
-import"./index-0541h76w.js";
+import"./index-1mq8kmp6.js";
+import"./index-mgr951p8.js";
+import"./index-5f403c30.js";
 import"./index-vxv732ex.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
 import"./index-wk1h5ec2.js";
 import"./index-1j3682j8.js";
-import"./index-6b69mp0r.js";
-import"./index-zjw32rv9.js";
+import"./index-q3m6bpx2.js";
+import"./index-y3rj2jgb.js";
 import"./index-rtry5xyf.js";
-import"./index-2j8f71c3.js";
-import"./index-8t9xpn1a.js";
+import"./index-rjngxx7q.js";
+import"./index-6wya5cqh.js";
 import"./index-ae75rja9.js";
 import"./index-cfkvc5q9.js";
 import"./index-dd7ttx8x.js";
-import"./index-c0e3vhv9.js";
+import"./index-ddxt327j.js";
 import"./index-k5jrywpr.js";
 import"./index-n832052r.js";
 import {
@@ -116,7 +116,7 @@ import {
   init_constants,
   init_schema,
   stripKnownSwarmPrefix
-} from "./index-y2esw64s.js";
+} from "./index-tsmjmhnk.js";
 import"./index-bk5tah7q.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
@@ -138,7 +138,7 @@ import"./index-z6xqpmqg.js";
 import"./index-zjygnfay.js";
 import"./index-qe3v54nb.js";
 import"./index-zgwm4ryv.js";
-import"./index-h3k62043.js";
+import"./index-3nasn371.js";
 import"./index-a76rekgs.js";
 
 // src/commands/index.ts

package/dist/cli/{index-zjw32rv9.js → index-y3rj2jgb.js}

@@ -4,7 +4,7 @@ import {
 } from "./index-rtry5xyf.js";
 import {
   readKnowledgeEvents
-} from "./index-8t9xpn1a.js";
+} from "./index-6wya5cqh.js";
 import {
   isLinked,
   readLinkPointer,

package/dist/cli/{index-pz49rx4y.js → index-yaptf0hg.js}

@@ -12,14 +12,14 @@ import {
   detectPosixWrites,
   detectWindowsWrites,
   resolveWriteTargets
-} from "./index-358f9h8p.js";
+} from "./index-6kfqz0jw.js";
 import {
   checkFileAuthority,
   classifyFile,
   isInDeclaredScope,
   redactPath,
   redactShellCommand
-} from "./index-1v5mby7t.js";
+} from "./index-yqvh2s4w.js";
 
 // src/services/guardrail-explain-service.ts
 import path from "path";

package/dist/cli/{index-1v5mby7t.js → index-yqvh2s4w.js}

@@ -3,7 +3,7 @@ import {
   init_constants,
   init_schema,
   stripKnownSwarmPrefix
-} from "./index-y2esw64s.js";
+} from "./index-tsmjmhnk.js";
 import {
   init_logger,
   warn

package/dist/cli/index.js

@@ -6,30 +6,30 @@ import {
   getPluginConfigDir,
   getPluginLockFilePaths,
   resolveCommand
-} from "./index-358f9h8p.js";
+} from "./index-6kfqz0jw.js";
 import"./index-13xxjfhn.js";
-import"./index-1v5mby7t.js";
-import"./index-bq2848a3.js";
-import"./index-k742ecbm.js";
+import"./index-yqvh2s4w.js";
+import"./index-2b7sv71f.js";
+import"./index-8fhg2nt2.js";
 import"./index-4905hd2m.js";
 import"./index-134d35c1.js";
-import"./index-m8ajf6wb.js";
-import"./index-kwm7hz18.js";
-import"./index-0541h76w.js";
+import"./index-1mq8kmp6.js";
+import"./index-mgr951p8.js";
+import"./index-5f403c30.js";
 import"./index-vxv732ex.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
 import"./index-wk1h5ec2.js";
 import"./index-1j3682j8.js";
-import"./index-6b69mp0r.js";
-import"./index-zjw32rv9.js";
+import"./index-q3m6bpx2.js";
+import"./index-y3rj2jgb.js";
 import"./index-rtry5xyf.js";
-import"./index-2j8f71c3.js";
-import"./index-8t9xpn1a.js";
+import"./index-rjngxx7q.js";
+import"./index-6wya5cqh.js";
 import"./index-ae75rja9.js";
 import"./index-cfkvc5q9.js";
 import"./index-dd7ttx8x.js";
-import"./index-c0e3vhv9.js";
+import"./index-ddxt327j.js";
 import"./index-k5jrywpr.js";
 import"./index-n832052r.js";
 import {
@@ -37,7 +37,7 @@ import {
   init_constants,
   init_package,
   package_default
-} from "./index-y2esw64s.js";
+} from "./index-tsmjmhnk.js";
 import"./index-bk5tah7q.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";
@@ -59,7 +59,7 @@ import"./index-z6xqpmqg.js";
 import"./index-zjygnfay.js";
 import"./index-qe3v54nb.js";
 import"./index-zgwm4ryv.js";
-import"./index-h3k62043.js";
+import"./index-3nasn371.js";
 import"./index-a76rekgs.js";
 
 // src/cli/index.ts

package/dist/cli/{knowledge-escalator-v09w0jmg.js → knowledge-escalator-fqsavryx.js}

@@ -8,9 +8,9 @@ import {
   maybeEscalateOnViolation,
   maybeQuarantineOnContradiction,
   readRecentEscalations
-} from "./index-kwm7hz18.js";
-import"./index-2j8f71c3.js";
-import"./index-8t9xpn1a.js";
+} from "./index-mgr951p8.js";
+import"./index-rjngxx7q.js";
+import"./index-6wya5cqh.js";
 import"./index-ae75rja9.js";
 import"./index-cfkvc5q9.js";
 import"./index-dd7ttx8x.js";

package/dist/cli/{knowledge-events-qp19r2he.js → knowledge-events-ykt8vrvj.js}

@@ -26,7 +26,7 @@ import {
   resolveKnowledgeCounterBaselinePath,
   resolveKnowledgeEventsPath,
   resolveLegacyApplicationLogPath
-} from "./index-8t9xpn1a.js";
+} from "./index-6wya5cqh.js";
 import"./index-ae75rja9.js";
 import"./index-cfkvc5q9.js";
 import"./index-dd7ttx8x.js";

package/dist/cli/{knowledge-store-n5pvv0s3.js → knowledge-store-tpd98m39.js}

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

package/dist/cli/{knowledge-validator-qg31ycbb.js → knowledge-validator-kc7fnt2r.js}

@@ -23,11 +23,11 @@ import {
   validateLesson,
   validateSkillCandidatePath,
   validateSkillPath
-} from "./index-6b69mp0r.js";
-import"./index-zjw32rv9.js";
+} from "./index-q3m6bpx2.js";
+import"./index-y3rj2jgb.js";
 import"./index-rtry5xyf.js";
-import"./index-2j8f71c3.js";
-import"./index-8t9xpn1a.js";
+import"./index-rjngxx7q.js";
+import"./index-6wya5cqh.js";
 import"./index-ae75rja9.js";
 import"./index-cfkvc5q9.js";
 import"./index-dd7ttx8x.js";

package/dist/cli/{scan-cursor-wtzfvkh2.js → scan-cursor-121b73j0.js}

@@ -4,8 +4,8 @@ import {
   alreadyCuratedThisGeneration,
   claimNextScanBatch,
   getScanStatus
-} from "./index-0541h76w.js";
-import"./index-2j8f71c3.js";
+} from "./index-5f403c30.js";
+import"./index-rjngxx7q.js";
 import"./index-ae75rja9.js";
 import"./index-cfkvc5q9.js";
 import"./index-dd7ttx8x.js";

package/dist/cli/{schema-erk5bz43.js → schema-jb4p8ja9.js}

@@ -93,7 +93,7 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-y2esw64s.js";
+} from "./index-tsmjmhnk.js";
 import"./index-bk5tah7q.js";
 import"./index-bpmtbmy9.js";
 import"./index-zjygnfay.js";

package/dist/cli/{skill-generator-nxs65tq3.js → skill-generator-m2g5mdva.js}

@@ -33,12 +33,12 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-m8ajf6wb.js";
-import"./index-6b69mp0r.js";
-import"./index-zjw32rv9.js";
+} from "./index-1mq8kmp6.js";
+import"./index-q3m6bpx2.js";
+import"./index-y3rj2jgb.js";
 import"./index-rtry5xyf.js";
-import"./index-2j8f71c3.js";
-import"./index-8t9xpn1a.js";
+import"./index-rjngxx7q.js";
+import"./index-6wya5cqh.js";
 import"./index-ae75rja9.js";
 import"./index-cfkvc5q9.js";
 import"./index-dd7ttx8x.js";

package/dist/cli/{workspace-snapshot-35qc0y8a.js → workspace-snapshot-9h5za0s6.js}

@@ -7,6 +7,7 @@ import {
   compareWorkspaceSnapshots,
   digest,
   parsePorcelainPaths,
+  parsePorcelainV2Snapshot,
   readGitTextAtRevision,
   resolveCommitCountSince,
   resolveCommitCountSinceAsync,
@@ -32,7 +33,7 @@ import {
   resolveRemoteRefsContainingHead,
   resolveRemoteRefsContainingHeadAsync,
   workspaceSnapshotMatches
-} from "./index-h3k62043.js";
+} from "./index-3nasn371.js";
 import"./index-a76rekgs.js";
 export {
   workspaceSnapshotMatches,
@@ -60,6 +61,7 @@ export {
   resolveCommitCountSinceAsync,
   resolveCommitCountSince,
   readGitTextAtRevision,
+  parsePorcelainV2Snapshot,
   parsePorcelainPaths,
   digest,
   compareWorkspaceSnapshots,

package/dist/commands/pr-feedback.d.ts

@@ -9,8 +9,8 @@
  * Input contract (PR reference is optional):
  *   /swarm pr-feedback 155                         → feedback pass on PR 155
  *   /swarm pr-feedback 155 also fix the lint errors → PR 155 + extra instructions
- *   /swarm pr-feedback 155 continue from .swarm/pr-review/<run_id>/feedback-handoff.md
- *                                                   -> PR 155 + handoff path instructions
+ *   /swarm pr-feedback 155 continue from .swarm/pr-review/<run_id>/feedback-handoff.json
+ *                                                   -> PR 155 + exact transition request
  *   /swarm pr-feedback owner/repo#155               → shorthand
  *   /swarm pr-feedback https://github.com/.../pull/155
  *   /swarm pr-feedback                              → bare signal; architect builds
@@ -22,4 +22,17 @@
  * PR-reference parsing and injection-hardening are shared with /swarm pr-review
  * via ./pr-ref.ts.
  */
+export interface PrFeedbackContinuationRequest {
+    runId: string;
+    handoffPath: string;
+    instructions: string;
+}
+export interface PrFeedbackCommandInput {
+    prUrl?: string;
+    instructions: string;
+    continuation?: PrFeedbackContinuationRequest;
+    error?: string;
+    errorKind?: 'pr-reference' | 'continuation';
+}
+export declare function parsePrFeedbackCommandInput(directory: string, args: string[]): PrFeedbackCommandInput;
 export declare function handlePrFeedbackCommand(directory: string, args: string[]): string;

package/dist/git/pr-workflow-state.d.ts

@@ -0,0 +1,37 @@
+import { parsePorcelainV2Snapshot } from '../background/workspace-snapshot.js';
+export type PrWorkflowGitStateKind = 'clean' | 'stashable' | 'recovery-required' | 'indeterminate';
+export interface PrWorkflowGitState {
+    kind: PrWorkflowGitStateKind;
+    code: 'CLEAN' | 'STASHABLE_CHANGES' | 'UNMERGED_INDEX' | 'GIT_OPERATION_IN_PROGRESS' | 'DIRTY_SUBMODULE' | 'SWARM_STATE_TRACKING_ERROR' | 'GIT_STATE_INDETERMINATE';
+    retryable: boolean;
+    requiredAction: string;
+    evidence: {
+        worktreeRoot: string | null;
+        gitDir: string | null;
+        operations: string[];
+        unmergedCodes: string[];
+        paths: string[];
+        trackedCount: number;
+        untrackedCount: number;
+        pathsTruncated: boolean;
+        detail?: string;
+    };
+}
+interface GitCaptureResult {
+    ok: boolean;
+    stdout: string;
+}
+declare function runGitCapture(directory: string, args: readonly string[]): Promise<GitCaptureResult>;
+declare function activeOperations(gitDir: string): Promise<string[]>;
+/**
+ * Classify the checkout before a PR workflow can take ownership of it.
+ * Unknown Git state fails closed; ordinary tracked/untracked dirt is explicitly
+ * distinguished from conflict and in-progress-operation recovery states.
+ */
+export declare function classifyPrWorkflowGitState(directory: string): Promise<PrWorkflowGitState>;
+export declare const _internals: {
+    runGitCapture: typeof runGitCapture;
+    activeOperations: typeof activeOperations;
+    parsePorcelainV2: typeof parsePorcelainV2Snapshot;
+};
+export {};

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

@@ -1,9 +1,27 @@
 import * as fsp from 'node:fs/promises';
 import { resolveCommitCountSince, resolveCommitCountSinceAsync, resolveCurrentGitHead, resolveCurrentGitHeadAsync, resolveCurrentUpstreamPushTarget, resolveCurrentUpstreamPushTargetAsync, resolveCurrentUpstreamRemoteRef, resolveExactRemoteBranchHead, resolveExactRemoteBranchHeadAsync, resolveIsExactSingleChildCommit, resolveIsExactSingleChildCommitAsync, resolveIsWorkingTreeClean, resolveIsWorkingTreeCleanAsync, resolvePrReviewDiffStats, resolvePrReviewDiffStatsAsync, resolvePrWorkflowRevisionDigest, resolveRemoteRefsContainingHead, resolveRemoteRefsContainingHeadAsync } from '../background/workspace-snapshot.js';
+import { type PrWorkflowGitState } from '../git/pr-workflow-state.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"];
 export type PrReviewBaseDimensionId = (typeof PR_REVIEW_BASE_DIMENSION_IDS)[number];
 export type PrWorkflowMode = 'PR_REVIEW' | 'PR_FEEDBACK';
+export interface PrWorkflowCheckoutRecoveryRecord {
+    code: 'UNMERGED_INDEX' | 'GIT_OPERATION_IN_PROGRESS' | 'DIRTY_SUBMODULE' | 'SWARM_STATE_TRACKING_ERROR' | 'GIT_STATE_INDETERMINATE';
+    retryable: false;
+    requiredAction: string;
+    evidence: PrWorkflowGitState['evidence'];
+    detectedAt: string;
+}
+export interface PrFeedbackReviewHandoffRecord {
+    path: string;
+    runId: string;
+    sourcePrHeadSha: string;
+    prUrl: string;
+    findingIds: string[];
+    digest: string;
+    sourceWorkflowInstanceId: string;
+    provenance: 'active-review-v1' | 'external-v1';
+}
 export type PrReviewDepthTier = 'S' | 'M' | 'L';
 /**
  * Objective size thresholds for the controller-computed PR-review depth tier.
@@ -156,6 +174,8 @@ export interface PrWorkflowGateState {
     schemaVersion: 1;
     /** Monotonic durable revision used to reject stale same-session transitions. */
     revision: number;
+    /** Stable identity that prevents revision-only ABA during mode replacement. */
+    workflowInstanceId?: string;
     sessionID: string;
     mode: PrWorkflowMode;
     activatedAt: string;
@@ -181,6 +201,10 @@ export interface PrWorkflowGateState {
     prReviewArtifactBoundaries?: PrReviewArtifactBoundary[];
     prReviewHandoffPath?: string;
     prReviewHandoffRequired?: boolean;
+    checkoutRecovery?: PrWorkflowCheckoutRecoveryRecord;
+    /** HTTPS PR URL selected after canonical GitHub PR identity validation. */
+    prFeedbackTargetUrl?: string;
+    prFeedbackReviewHandoff?: PrFeedbackReviewHandoffRecord;
     prFeedbackInventory?: string[];
     prFeedbackVerifications?: PrFeedbackVerificationRecord[];
     /** @deprecated Compatibility projection of the most recent verification dispatch. */
@@ -192,6 +216,8 @@ export interface PrWorkflowGateState {
 }
 export declare function activatePrWorkflow(directory: string, sessionID: string, mode: PrWorkflowMode, options?: {
     prHeadSha?: string;
+    requireCheckoutPreflight?: boolean;
+    prUrl?: string;
 }): Promise<PrWorkflowGateState>;
 export declare function readPrWorkflowGateState(directory: string, sessionID: string): Promise<PrWorkflowGateState | null>;
 /**
@@ -202,7 +228,9 @@ export declare function readPrWorkflowGateState(directory: string, sessionID: st
  * 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 withPrWorkflowCheckoutPreparationLock<T>(directory: string, sessionID: string, action: (state: PrWorkflowGateState, controls: {
+    markRecoveryRequired: (gitState: PrWorkflowGitState) => Promise<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.
@@ -316,6 +344,11 @@ export declare function assertPrReviewArtifactBoundary(directory: string, sessio
 export declare function assertPrReviewArtifactRecordsMatchAuthoritativeVerdicts(directory: string, sessionID: string, boundary: PrReviewArtifactBoundary, records: readonly PrReviewArtifactRecord[]): Promise<void>;
 export declare function markPrReviewArtifactBoundary(directory: string, sessionID: string, runId: string, boundary: PrReviewArtifactBoundary, artifactPath: string, findingIds: string[], handoffRequired: boolean): Promise<PrWorkflowGateState>;
 export declare function markPrReviewHandoffComplete(directory: string, sessionID: string, runId: string, artifactPath: string): Promise<PrWorkflowGateState>;
+export declare function transitionPrReviewToFeedback(directory: string, sessionID: string, request: {
+    runId: string;
+    handoffPath: string;
+    prUrl?: string;
+}): Promise<PrWorkflowGateState>;
 export declare function declarePrFeedbackScope(directory: string, sessionID: string, taskId: string, files: string[]): Promise<PrWorkflowGateState>;
 export declare function resolvePrFeedbackScopeDeclaration(directory: string, sessionID: string, taskId: string): Promise<PrFeedbackScopeDeclarationRecord | null>;
 export declare function consumePrFeedbackScopeDeclaration(directory: string, sessionID: string, taskId: string, callID: string): Promise<PrFeedbackScopeDeclarationRecord | null>;
@@ -334,6 +367,12 @@ export declare const _test_exports: {
     workflowGateStateLockRelativePath: typeof workflowGateStateLockRelativePath;
     resetTrackedStateCache: () => void;
     beforeTerminalClear: (() => Promise<void>) | undefined;
+    beforePrFeedbackTransitionLock: (() => Promise<void>) | undefined;
+    beforeBoundedSwarmFileOpen: (() => Promise<void>) | undefined;
+    beforeSessionStateLockWrite: (() => Promise<void>) | undefined;
+    beforeSafeDirectoryCreate: ((parentPath: string, nextPath: string) => Promise<void>) | undefined;
+    beforeAtomicTempWrite: (() => Promise<void>) | undefined;
+    beforeAtomicRename: (() => Promise<void>) | undefined;
     resolveCurrentGitHead: typeof resolveCurrentGitHead;
     resolveCurrentGitHeadAsync: typeof resolveCurrentGitHeadAsync;
     resolveCurrentUpstreamPushTarget: typeof resolveCurrentUpstreamPushTarget;
@@ -378,10 +417,11 @@ 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;
+export declare function ensurePrWorkflowSafeParentDirectory(directory: string, filePath: string): Promise<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 declare function writePrWorkflowAtomicJson(directory: string, filePath: string, value: unknown): Promise<void>;
 export {};

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

@@ -1,6 +1,9 @@
+import { claimPrFeedbackMonitorEvents, readPrFeedbackMonitorQueue } from '../background/pr-feedback-event-queue.js';
 import { readPrWorkflowGateState } from './pr-workflow-gate.js';
 export declare const _internals: {
     readPrWorkflowGateState: typeof readPrWorkflowGateState;
+    claimPrFeedbackMonitorEvents: typeof claimPrFeedbackMonitorEvents;
+    readPrFeedbackMonitorQueue: typeof readPrFeedbackMonitorQueue;
 };
 /**
  * Maximum number of consecutive unproductive auto-resumes per gated session

package/dist/hooks/shell-write-detect.d.ts

@@ -68,7 +68,7 @@ export declare function detectInteractiveSession(command: string, shell: 'posix'
  *
  * Detects:
  * - Redirection operators: >, >>, >|, <<, <<- (here-docs)
- * - Write-effect builtins: cp, mv, install, ln, truncate, dd (of=)
+ * - Write-effect builtins: cp, mv, install, ln, truncate, dd (of=), tee
  * - In-place editors: sed -i, perl -i, awk -i
  * - Interpreter eval: python -c, node -e, bun -e, ruby -e, perl -e, php -r
  * - Network downloaders: curl -o, wget -O, scp