opencode-swarm 7.194.0 → 7.196.0

package/dist/cli/{snapshot-coordination-init-z1aqsvn4.js → snapshot-coordination-init-2x56ds8a.js}

@@ -8,75 +8,75 @@ import {
   markSnapshotCoordinationClosing,
   retrySnapshotCoordinationInitialization,
   startSnapshotCoordinationInitialization
-} from "./index-vjytfp05.js";
-import"./index-51dxek4p.js";
-import"./index-ehab3z5y.js";
-import"./index-48h1yn6c.js";
+} from "./index-bjaef5zn.js";
+import"./index-t5med3ga.js";
+import"./index-hjma52c8.js";
+import"./index-2grr37ry.js";
 import"./index-j2vv0h13.js";
-import"./index-668npagp.js";
-import"./index-7njm9jk1.js";
+import"./index-c5xvm318.js";
+import"./index-necqa5bj.js";
 import"./index-txdagbh7.js";
-import"./index-vfdkvvkf.js";
+import"./index-knxq5byr.js";
 import"./index-rdec0y3z.js";
-import"./index-y3n9ry9q.js";
-import"./index-n5xwza76.js";
-import"./index-9bzgea2y.js";
-import"./index-rpnkp79f.js";
-import"./index-fd6b9f38.js";
-import"./index-hfnyykvm.js";
+import"./index-sgt1d7ez.js";
+import"./index-7zkgdefv.js";
+import"./index-41p9zzpe.js";
+import"./index-7gqmqhzj.js";
+import"./index-ghckhk16.js";
+import"./index-ypkfhqbc.js";
 import"./index-cjapb4hy.js";
-import"./index-6s3ab22d.js";
+import"./index-dfrcc46h.js";
 import"./index-pt7h91zc.js";
 import"./index-q7sjgr1y.js";
-import"./index-yfbk69b1.js";
-import"./index-9v43y7y6.js";
+import"./index-31b55cq9.js";
+import"./index-tjc68trf.js";
 import"./index-6b295cas.js";
 import"./index-9nyqt3kb.js";
-import"./index-6xppb1er.js";
+import"./index-ryjp0wmq.js";
 import"./index-v3bmwmqw.js";
-import"./index-f3ttgqak.js";
-import"./index-jrs2qh6j.js";
-import"./index-d7pznffh.js";
+import"./index-svbh91pz.js";
+import"./index-3drq02r1.js";
+import"./index-391ydd25.js";
 import"./index-g4fs6z4e.js";
-import"./index-dy7nztyp.js";
-import"./index-ajkdt5b8.js";
-import"./index-43v5axvm.js";
+import"./index-vsa05smc.js";
+import"./index-mt5t492g.js";
+import"./index-te61qv0q.js";
 import"./index-m9zzj4ee.js";
-import"./index-84k9zzv1.js";
+import"./index-kphy4we7.js";
 import"./index-2s7dvzff.js";
-import"./index-3dpb3kps.js";
-import"./index-w2vbaczx.js";
+import"./index-wscg5ryb.js";
+import"./index-hy2fqapm.js";
 import"./index-rtry5xyf.js";
-import"./index-7bfshvq1.js";
+import"./index-8bsnnnj2.js";
 import"./index-g22dps7x.js";
 import"./index-0725jpp7.js";
-import"./index-r8mavcg6.js";
-import"./index-at34nry4.js";
-import"./index-qh93qjc2.js";
-import"./index-st80sjg7.js";
-import"./index-vg8sxg12.js";
-import"./index-0e318vgt.js";
+import"./index-tzasccpd.js";
+import"./index-174j0g38.js";
+import"./index-6183at3v.js";
+import"./index-j8t1g5qd.js";
+import"./index-crz772sx.js";
+import"./index-app2rmxv.js";
 import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
-import"./index-ndec8akq.js";
-import"./index-cwr69qw7.js";
+import"./index-gc0aeth5.js";
+import"./index-jnjvghgp.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-3atkcqpb.js";
-import"./index-5rkh69f3.js";
-import"./index-e8k0v19e.js";
+import"./index-ry5g9s8d.js";
+import"./index-4gmxdkcd.js";
+import"./index-xmbtwtgw.js";
 import"./index-t7hmqgjy.js";
-import"./index-mtqwyjrg.js";
+import"./index-7rtq2t5n.js";
 import"./index-fzpt2djt.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
-import"./index-hfssjyxs.js";
+import"./index-yf2z4j7s.js";
 import"./index-gx2vp8gx.js";
-import"./index-0xe19j9g.js";
+import"./index-ppnpkww2.js";
 import"./index-zxdawwc7.js";
-import"./index-4ftg3p9n.js";
-import"./index-1jt12p3y.js";
+import"./index-nqxbqb50.js";
+import"./index-hqrkr9ag.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{speckit-checkoff-1g3vzywn.js → speckit-checkoff-c2e5wezr.js}

@@ -7,14 +7,14 @@ import {
   parseSpeckitTasksContent,
   propagateSpeckitCheckoff,
   writeSpeckitCheckoffLedger
-} from "./index-f3ttgqak.js";
+} from "./index-svbh91pz.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
-import"./index-hfssjyxs.js";
-import"./index-0xe19j9g.js";
+import"./index-yf2z4j7s.js";
+import"./index-ppnpkww2.js";
 import"./index-zxdawwc7.js";
-import"./index-4ftg3p9n.js";
-import"./index-1jt12p3y.js";
+import"./index-nqxbqb50.js";
+import"./index-hqrkr9ag.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{telemetry-qaymh4gg.js → telemetry-vapc5q4p.js}

@@ -14,7 +14,7 @@ import {
   startHeartbeatTracking,
   stopHeartbeatTracking,
   telemetry
-} from "./index-mtqwyjrg.js";
+} from "./index-7rtq2t5n.js";
 import"./index-fzpt2djt.js";
 import"./index-gknz3bv1.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{workspace-snapshot-p69t9zn7.js → workspace-snapshot-e3kw9kpg.js}

@@ -46,11 +46,11 @@ import {
   shouldSkipSnapshot,
   switchPrFeedbackTrackingCandidateAsync,
   workspaceSnapshotMatches
-} from "./index-fd6b9f38.js";
-import"./index-84k9zzv1.js";
+} from "./index-ghckhk16.js";
+import"./index-kphy4we7.js";
 import"./index-2s7dvzff.js";
 import"./index-fzpt2djt.js";
-import"./index-hfssjyxs.js";
+import"./index-yf2z4j7s.js";
 import"./index-zxdawwc7.js";
 import"./index-zpsr8rpc.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{worktree-collision-ownership-d0etv08a.js → worktree-collision-ownership-1bgcea0v.js}

@@ -6,37 +6,37 @@ import {
   WORKTREE_PROVISIONING_OWNER_LEASE_MS,
   removeWorktreeProvisioningOwner,
   scanWorktreeProvisioningOwnersForRecovery
-} from "./index-6s3ab22d.js";
+} from "./index-dfrcc46h.js";
 import {
   scanWorktreeMergeFailuresForRecovery
 } from "./index-v3bmwmqw.js";
 import {
   scanDelegationFallbacksForRecovery,
   scanDelegationsForRecovery
-} from "./index-dy7nztyp.js";
-import"./index-84k9zzv1.js";
+} from "./index-vsa05smc.js";
+import"./index-kphy4we7.js";
 import"./index-2s7dvzff.js";
-import"./index-st80sjg7.js";
-import"./index-vg8sxg12.js";
-import"./index-0e318vgt.js";
+import"./index-j8t1g5qd.js";
+import"./index-crz772sx.js";
+import"./index-app2rmxv.js";
 import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
-import"./index-ndec8akq.js";
-import"./index-cwr69qw7.js";
+import"./index-gc0aeth5.js";
+import"./index-jnjvghgp.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-3atkcqpb.js";
-import"./index-5rkh69f3.js";
-import"./index-e8k0v19e.js";
+import"./index-ry5g9s8d.js";
+import"./index-4gmxdkcd.js";
+import"./index-xmbtwtgw.js";
 import"./index-t7hmqgjy.js";
-import"./index-mtqwyjrg.js";
+import"./index-7rtq2t5n.js";
 import {
   canonicalRootKeyFresh
 } from "./index-fzpt2djt.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
-import"./index-hfssjyxs.js";
+import"./index-yf2z4j7s.js";
 import"./index-zxdawwc7.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";

package/dist/cli/{worktree-isolation-dj2qw13p.js → worktree-isolation-9xp4dz41.js}

@@ -25,77 +25,77 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-vjytfp05.js";
-import"./index-51dxek4p.js";
-import"./index-ehab3z5y.js";
-import"./index-48h1yn6c.js";
+} from "./index-bjaef5zn.js";
+import"./index-t5med3ga.js";
+import"./index-hjma52c8.js";
+import"./index-2grr37ry.js";
 import"./index-j2vv0h13.js";
-import"./index-668npagp.js";
-import"./index-7njm9jk1.js";
+import"./index-c5xvm318.js";
+import"./index-necqa5bj.js";
 import"./index-txdagbh7.js";
-import"./index-vfdkvvkf.js";
+import"./index-knxq5byr.js";
 import"./index-rdec0y3z.js";
-import"./index-y3n9ry9q.js";
-import"./index-n5xwza76.js";
-import"./index-9bzgea2y.js";
-import"./index-rpnkp79f.js";
-import"./index-fd6b9f38.js";
-import"./index-hfnyykvm.js";
+import"./index-sgt1d7ez.js";
+import"./index-7zkgdefv.js";
+import"./index-41p9zzpe.js";
+import"./index-7gqmqhzj.js";
+import"./index-ghckhk16.js";
+import"./index-ypkfhqbc.js";
 import"./index-cjapb4hy.js";
-import"./index-6s3ab22d.js";
+import"./index-dfrcc46h.js";
 import"./index-pt7h91zc.js";
 import"./index-q7sjgr1y.js";
-import"./index-yfbk69b1.js";
-import"./index-9v43y7y6.js";
+import"./index-31b55cq9.js";
+import"./index-tjc68trf.js";
 import"./index-6b295cas.js";
 import"./index-9nyqt3kb.js";
-import"./index-6xppb1er.js";
+import"./index-ryjp0wmq.js";
 import"./index-v3bmwmqw.js";
-import"./index-f3ttgqak.js";
-import"./index-jrs2qh6j.js";
-import"./index-d7pznffh.js";
+import"./index-svbh91pz.js";
+import"./index-3drq02r1.js";
+import"./index-391ydd25.js";
 import"./index-g4fs6z4e.js";
-import"./index-dy7nztyp.js";
-import"./index-ajkdt5b8.js";
-import"./index-43v5axvm.js";
+import"./index-vsa05smc.js";
+import"./index-mt5t492g.js";
+import"./index-te61qv0q.js";
 import"./index-m9zzj4ee.js";
-import"./index-84k9zzv1.js";
+import"./index-kphy4we7.js";
 import"./index-2s7dvzff.js";
-import"./index-3dpb3kps.js";
-import"./index-w2vbaczx.js";
+import"./index-wscg5ryb.js";
+import"./index-hy2fqapm.js";
 import"./index-rtry5xyf.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-7bfshvq1.js";
+} from "./index-8bsnnnj2.js";
 import"./index-g22dps7x.js";
 import"./index-0725jpp7.js";
-import"./index-r8mavcg6.js";
-import"./index-at34nry4.js";
-import"./index-qh93qjc2.js";
-import"./index-st80sjg7.js";
-import"./index-vg8sxg12.js";
-import"./index-0e318vgt.js";
+import"./index-tzasccpd.js";
+import"./index-174j0g38.js";
+import"./index-6183at3v.js";
+import"./index-j8t1g5qd.js";
+import"./index-crz772sx.js";
+import"./index-app2rmxv.js";
 import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
-import"./index-ndec8akq.js";
-import"./index-cwr69qw7.js";
+import"./index-gc0aeth5.js";
+import"./index-jnjvghgp.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
-import"./index-3atkcqpb.js";
-import"./index-5rkh69f3.js";
-import"./index-e8k0v19e.js";
+import"./index-ry5g9s8d.js";
+import"./index-4gmxdkcd.js";
+import"./index-xmbtwtgw.js";
 import"./index-t7hmqgjy.js";
-import"./index-mtqwyjrg.js";
+import"./index-7rtq2t5n.js";
 import"./index-fzpt2djt.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
-import"./index-hfssjyxs.js";
+import"./index-yf2z4j7s.js";
 import"./index-gx2vp8gx.js";
-import"./index-0xe19j9g.js";
+import"./index-ppnpkww2.js";
 import"./index-zxdawwc7.js";
-import"./index-4ftg3p9n.js";
-import"./index-1jt12p3y.js";
+import"./index-nqxbqb50.js";
+import"./index-hqrkr9ag.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";
 import"./index-zpsr8rpc.js";

package/dist/commands/registry.d.ts

@@ -715,7 +715,7 @@ export declare const COMMAND_REGISTRY: {
     readonly epic: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Open, inspect, and close a plan-scoped epic (coupling-aware parallel execution of the current plan)";
-        readonly details: "An epic is bound to ONE plan: `start` opens it for the current plan, `close` ends it. Requires `epic.mode.enabled: true` in config (top-level `epic` block; no `turbo` block needed — the legacy `turbo.epic` path is still accepted and migrated). `start [--force]` refuses, in order: epic-disabled-by-config, host-unsupported (the host gives the plugin no OpenCode SDK client; on OpenCode 2 the v2 adapter now ships one, so this refusal no longer fires there — v2 is held by the child-session placement work instead), no-plan / plan-ledger-unreadable, epic-already-open (idempotent for the same plan) / epic-open-for-other-plan, turbo-active (config turbo_mode, a session with Turbo on, or a running Lean run — Epic enables neither Lean nor Turbo and never waives per-task QA), dirty-baseline (git: uncommitted changes outside .swarm/), detached-head / epic-branch-exists (epic-branch policy), in-flight-coders (any coder dispatch, background delegation, unsettled settlement, or preserved/recovery lane), not-epic-sized (too few pending tasks, insufficient scope coverage, or insufficient effective speedup — run it in Balanced, or reshape it with the plan-shaping suggestions shown; `--force` overrides and is recorded). Non-git projects run an epic serially (one task per wave). Git epics default to `epic.commit_policy: \"epic-branch\"`: start checks out `swarm/epic/<epicKey>` and every Epic commit goes there (epic_next_wave blocks with epic-branch-mismatch, and no landing or residue is committed, while HEAD is elsewhere); `current-branch` keeps commits on the starting branch. In a git epic every coder runs in an isolated worktree (refused EPIC_ISOLATION_DEGRADED when isolation is unavailable) and lands as a `swarm(task <id>): …` merge commit; main-tree files a non-coder writer (test_engineer, docs) wrote for a task are committed as residue of that task; update_task_status writes nothing to git; wave close records the commit of each task as `refs/swarm/epics/<epicKey>/tasks/<id>` (deleted at close unless `epic.retain_refs`; never pushed by default). While open, the architect calls epic_next_wave and does what its status says: it issues one wave at a time (tasks with non-conflicting declared scopes — exclusive tasks alone, at most one task per densely coupled component; phases strictly in order), the architect dispatches one Task per taskId in ONE message and runs per-task QA (pre_check_batch → reviewer + test_engineer → update_task_status(completed)), and the next epic_next_wave closes the wave (recording outcomes and declared-vs-actual divergence) and issues the next; when a phase is done it returns phase-ready-for-review → epic_phase_review → phase_complete. `close [--abandon] [--land squash|merge|none]` refuses while tasks are pending (or the epic is orphaned / unreadable) unless `--abandon`, refuses a dirty tree before landing, writes a close report (epic-report-v2, embedding the epic scorecard) to .swarm/epic/reports/ and .swarm/epic-prior/reports/ (newest 50 kept), and lands the epic branch onto the original branch: squash (default — staged, uncommitted changes for you to review and commit), merge (a --no-ff merge commit), or none (switch back only). The epic branch is kept (remove it with `git branch -D` once committed). A landing conflict is rolled back (the attempted squash or merge is undone) and the epic stays closing — rerun close to resume. `--abandon` never lands; it switches back to the original branch when the tree is clean. `status [--repair-refs]` (also bare /swarm epic) shows the epic, its waves, phases, the task components recorded with the latest wave and recorded divergence, orphan detection (plan renamed or replaced), sentinel/row repair, recorded worktree merge failures, and retires legacy Epic v1 session state once; `--repair-refs` re-adopts task commits a rebase or amend made unreachable from HEAD. `report [<key>|last] [--format json]` shows the epic scorecard: live for the open epic (bare `report`), else from the close report of a past epic in .swarm/epic-prior/reports/ (`last` = newest; `<key>` = a report or epic key) — tasks completed in the epic, waves (count, width), time over closed waves (wave span, task issue→resolve time, and their ratio, a concurrency factor that is NOT a speedup: it includes queueing behind serialized QA), conflicts (merge-back failures, undeclared writes), rework (extra generations, reopens), first-pass gate rates (upper bounds: the failure history is bounded), forced/sizing at start and learned hot files. Epics learn from their outcomes: undeclared writes teach learned co-writes (a task declaring D that also wrote f makes later tasks declaring D conflict with tasks on f — planner analysis only, never write authorization) and incidents (undeclared writes, merge conflicts, Stage B failures, rework, reopens) in excess of clean exposures make a file hot (a task declaring it runs alone) — undeclared writes its strongest learned co-writer explains are discounted (expansion already separates them), so one declarer writing a file is not heat; an empty history learns nothing (neutral start). Each wave close updates the posterior of the epic; close merges it into the project prior .swarm/epic-prior/learning.json (decayed per epic and by age; kept across /swarm close; `epic.learning.*`). `learning` shows what the planner learned and uses now; `prior [show]` shows the project prior; `prior reset` previews and prints a single-use confirm token (15 minutes); `prior reset --confirm=<token>` clears it. Also: clear-merge-failure <taskId> [--confirm]. The former `on` / `off` toggles, the `decide` / `last` subcommands and `calibration` (renamed `learning`) were removed.";
+        readonly details: "An epic is bound to ONE plan: `start` opens it for the current plan, `close` ends it. Requires `epic.mode.enabled: true` in config (top-level `epic` block; no `turbo` block needed — the legacy `turbo.epic` path is still accepted and migrated). `start [--force]` refuses, in order: epic-disabled-by-config, host-unsupported (the host gives the plugin no OpenCode SDK client; on OpenCode 2 the v2 adapter ships one, so this refusal does not fire there — Epic is startable on OpenCode 2 via the native v2 /swarm command dispatch, #3169 Phase 4), no-plan / plan-ledger-unreadable, epic-already-open (idempotent for the same plan) / epic-open-for-other-plan, turbo-active (config turbo_mode, a session with Turbo on, or a running Lean run — Epic enables neither Lean nor Turbo and never waives per-task QA), dirty-baseline (git: uncommitted changes outside .swarm/), detached-head / epic-branch-exists (epic-branch policy), in-flight-coders (any coder dispatch, background delegation, unsettled settlement, or preserved/recovery lane), not-epic-sized (too few pending tasks, insufficient scope coverage, or insufficient effective speedup — run it in Balanced, or reshape it with the plan-shaping suggestions shown; `--force` overrides and is recorded). Non-git projects run an epic serially (one task per wave). Git epics default to `epic.commit_policy: \"epic-branch\"`: start checks out `swarm/epic/<epicKey>` and every Epic commit goes there (epic_next_wave blocks with epic-branch-mismatch, and no landing or residue is committed, while HEAD is elsewhere); `current-branch` keeps commits on the starting branch. In a git epic every coder runs in an isolated worktree (refused EPIC_ISOLATION_DEGRADED when isolation is unavailable) and lands as a `swarm(task <id>): …` merge commit; main-tree files a non-coder writer (test_engineer, docs) wrote for a task are committed as residue of that task; update_task_status writes nothing to git; wave close records the commit of each task as `refs/swarm/epics/<epicKey>/tasks/<id>` (deleted at close unless `epic.retain_refs`; never pushed by default). While open, the architect calls epic_next_wave and does what its status says: it issues one wave at a time (tasks with non-conflicting declared scopes — exclusive tasks alone, at most one task per densely coupled component; phases strictly in order), the architect dispatches one Task per taskId in ONE message and runs per-task QA (pre_check_batch → reviewer + test_engineer → update_task_status(completed)), and the next epic_next_wave closes the wave (recording outcomes and declared-vs-actual divergence) and issues the next; when a phase is done it returns phase-ready-for-review → epic_phase_review → phase_complete. `close [--abandon] [--land squash|merge|none]` refuses while tasks are pending (or the epic is orphaned / unreadable) unless `--abandon`, refuses a dirty tree before landing, writes a close report (epic-report-v2, embedding the epic scorecard) to .swarm/epic/reports/ and .swarm/epic-prior/reports/ (newest 50 kept), and lands the epic branch onto the original branch: squash (default — staged, uncommitted changes for you to review and commit), merge (a --no-ff merge commit), or none (switch back only). The epic branch is kept (remove it with `git branch -D` once committed). A landing conflict is rolled back (the attempted squash or merge is undone) and the epic stays closing — rerun close to resume. `--abandon` never lands; it switches back to the original branch when the tree is clean. `status [--repair-refs]` (also bare /swarm epic) shows the epic, its waves, phases, the task components recorded with the latest wave and recorded divergence, orphan detection (plan renamed or replaced), sentinel/row repair, recorded worktree merge failures, and retires legacy Epic v1 session state once; `--repair-refs` re-adopts task commits a rebase or amend made unreachable from HEAD. `report [<key>|last] [--format json]` shows the epic scorecard: live for the open epic (bare `report`), else from the close report of a past epic in .swarm/epic-prior/reports/ (`last` = newest; `<key>` = a report or epic key) — tasks completed in the epic, waves (count, width), time over closed waves (wave span, task issue→resolve time, and their ratio, a concurrency factor that is NOT a speedup: it includes queueing behind serialized QA), conflicts (merge-back failures, undeclared writes), rework (extra generations, reopens), first-pass gate rates (upper bounds: the failure history is bounded), forced/sizing at start and learned hot files. Epics learn from their outcomes: undeclared writes teach learned co-writes (a task declaring D that also wrote f makes later tasks declaring D conflict with tasks on f — planner analysis only, never write authorization) and incidents (undeclared writes, merge conflicts, Stage B failures, rework, reopens) in excess of clean exposures make a file hot (a task declaring it runs alone) — undeclared writes its strongest learned co-writer explains are discounted (expansion already separates them), so one declarer writing a file is not heat; an empty history learns nothing (neutral start). Each wave close updates the posterior of the epic; close merges it into the project prior .swarm/epic-prior/learning.json (decayed per epic and by age; kept across /swarm close; `epic.learning.*`). `learning` shows what the planner learned and uses now; `prior [show]` shows the project prior; `prior reset` previews and prints a single-use confirm token (15 minutes); `prior reset --confirm=<token>` clears it. Also: clear-merge-failure <taskId> [--confirm]. The former `on` / `off` toggles, the `decide` / `last` subcommands and `calibration` (renamed `learning`) were removed.";
         readonly args: "start [--force] | close [--abandon] [--land squash|merge|none] | status [--repair-refs] | report [<key>|last] [--format json] | learning | prior [show|reset [--confirm=<token>]] | clear-merge-failure <taskId> [--confirm]";
         readonly category: "diagnostics";
         readonly toolPolicy: "human-only";

package/dist/epic/start.d.ts

@@ -93,11 +93,12 @@ export interface EpicStartOptions {
  * Every git-epic coder needs worktree isolation and every phase needs the
  * `epic_phase_review` dispatch, and both create sessions through that client
  * (`worktree-isolation.ts` STANDARD_WORKTREE_ISOLATION_UNAVAILABLE,
- * `src/review/contracts.ts`). The OpenCode 2 adapter initializes the plugin
- * with `client: undefined` (`src/host/v2/setup.ts`), so an epic there could
- * neither dispatch a coder nor complete a phase.
+ * `src/review/contracts.ts`). Since #3169 Phase 2 the OpenCode 2 adapter
+ * installs a session-capable client shim (`src/host/v2/setup.ts`), and since
+ * Phase 4 a human-typed `/swarm` command dispatches natively there — this
+ * refusal now fires only on genuinely client-less hosts.
  */
-export declare const EPIC_HOST_UNSUPPORTED_MESSAGE = "This OpenCode host gives the plugin no SDK client. Epic needs it for worktree-isolated coders and for the epic_phase_review reviewer/critic, so an epic here could neither run its coders nor complete a phase. Run the plan in Balanced, or use an OpenCode 1.x host (1.18.29+). (On OpenCode 2 the v2 adapter now ships a session-capable client, so this refusal no longer fires there \u2014 Epic on v2 is held by the #3169 child-session placement work instead.)";
+export declare const EPIC_HOST_UNSUPPORTED_MESSAGE = "This OpenCode host gives the plugin no SDK client. Epic needs it for worktree-isolated coders and for the epic_phase_review reviewer/critic, so an epic here could neither run its coders nor complete a phase. Run the plan in Balanced, or use an OpenCode 1.x host (1.18.29+). (On OpenCode 2 the v2 adapter ships a session-capable client and native /swarm command dispatch, so this refusal does not fire there.)";
 /** Durable Lean run marked `running` — read without the migrating Lean reader. */
 declare function findRunningLeanRun(directory: string): string | null;
 /** Why Turbo blocks the start, or null (M-a). */

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

@@ -464,6 +464,20 @@ interface PrReviewBatchCoherenceRecord {
     reviewerItemBindings?: Record<string, string>;
     /** Key encoding for reviewerItemBindings; absent means legacy raw item IDs. */
     reviewerItemBindingKeyEncoding?: 'prefixed-v1';
+    /**
+     * Issue #2906: reviewer batches only. The presentation order this batch's
+     * candidates were counterbalanced into — 'A' renders the canonical sorted
+     * inventory, 'B' the exact reverse — alternating by reviewer-batch ordinal
+     * within the reviewer window so repeated passes observe order effects.
+     */
+    presentationOrder?: 'A' | 'B';
+    /**
+     * Issue #2906: critic batches only. AUDIT-ONLY snapshot of the
+     * order-unstable item ids the critic prompt for this batch was flagged
+     * with (the prompt re-derives them live via
+     * `derivePrReviewOrderUnstableItems`); no runtime reader consumes this.
+     */
+    orderUnstableItemIds?: string[];
 }
 /** One rejected `submit_pr_review_result` attempt (issue #2859 F3 journal). */
 export interface PrReviewSubmitRejectionRecord {
@@ -474,6 +488,22 @@ export interface PrReviewSubmitRejectionRecord {
 }
 /** FIFO cap for the gate-state submit-rejection journal (issue #2859 F3). */
 export declare const MAX_PR_REVIEW_SUBMIT_REJECTIONS = 24;
+/**
+ * One rejected `write_pr_review_artifact` attempt (issue #3098 verdict-lane
+ * journal, mirroring the #2859 discovery journal). `sessionId` is the gate
+ * owner (the orchestrator session that called the tool) — provenance only;
+ * the composition joins entries to lanes via `workflowLane`/`laneId`.
+ */
+export interface PrReviewVerdictRejectionRecord {
+    sessionId: string;
+    laneId?: string;
+    workflowLane?: string;
+    boundary?: 'post_explorer' | 'post_reviewer' | 'post_critic';
+    at: number;
+    message: string;
+}
+/** FIFO cap for the gate-state verdict-write-rejection journal (issue #3098). */
+export declare const MAX_PR_REVIEW_VERDICT_REJECTIONS = 24;
 export interface PrWorkflowGateState {
     schemaVersion: 1;
     /** Monotonic durable revision used to reject stale same-session transitions. */
@@ -588,6 +618,17 @@ export interface PrWorkflowGateState {
      * to 300 chars at write time.
      */
     prReviewSubmitRejections?: PrReviewSubmitRejectionRecord[];
+    /**
+     * Bounded FIFO journal of rejected `write_pr_review_artifact` attempts
+     * (issue #3098, the verdict-lane mirror of the #2859 journal above).
+     * Observability only — surfaced in the verdict composition diagnostic so
+     * the orchestrator can see WHY a declared reviewer/critic lane produced no
+     * successful exact artifact; never consulted for artifact validity. Capped
+     * by {@link MAX_PR_REVIEW_VERDICT_REJECTIONS}; each entry's message is
+     * bounded to 300 chars at write time. `sessionId` is the gate-owner caller
+     * (provenance); lane join happens via `workflowLane`/`laneId`.
+     */
+    prReviewVerdictRejections?: PrReviewVerdictRejectionRecord[];
     prReviewHandoffPath?: string;
     prReviewHandoffRequired?: boolean;
     checkoutRecovery?: PrWorkflowCheckoutRecoveryRecord;
@@ -714,6 +755,38 @@ export declare function recordPrReviewSubmitRejection(directory: string, childSe
  * ever see its most recent rejections.
  */
 export declare function latestPrReviewSubmitRejectionMessage(state: Pick<PrWorkflowGateState, 'prReviewSubmitRejections'>, childSessionId: string): string | undefined;
+/**
+ * Issue #3098: best-effort, fail-open journal of one rejected
+ * `write_pr_review_artifact` attempt onto the CALLER's own PR_REVIEW gate
+ * state (the tool is a controller tool invoked by the gate-owner session —
+ * no delegation parent-hop, unlike the #2859 discovery journal).
+ * Observability only — never changes the rejection outcome, never creates
+ * gate state for a session that has none (the pre-read outside the
+ * session-state lock means a non-gated caller gets no lock file either).
+ */
+export declare function recordPrReviewVerdictRejection(directory: string, sessionID: string, message: string, attribution?: {
+    laneId?: string;
+    workflowLane?: string;
+    boundary?: 'post_explorer' | 'post_reviewer' | 'post_critic';
+}): Promise<void>;
+/**
+ * Issue #3098: latest journal message for a failing obligation, or undefined.
+ * Newest wins. Join keys are `workflowLane` (the declared obligation) and
+ * `laneId`; the recorded `sessionId` is the gate-owner caller (provenance),
+ * never a lane child session, so it is deliberately not a join key.
+ *
+ * The production writer only ever stamps `boundary` (the write args name the
+ * boundary, never a lane), so in practice the phase-scoped fallback below is
+ * what resolves: it reports the newest rejection recorded for the failing
+ * lane's PHASE, which is honest about being phase-scoped rather than
+ * lane-scoped. The lane-exact arms stay because a future attribution producer
+ * (or a hand-seeded state) can populate them.
+ */
+export declare function latestPrReviewVerdictRejectionForLane(state: Pick<PrWorkflowGateState, 'prReviewVerdictRejections'>, matchers: {
+    workflowLane?: string;
+    laneIds?: readonly string[];
+    boundary?: 'post_explorer' | 'post_reviewer' | 'post_critic';
+}): string | undefined;
 /**
  * Issue #2859 (F3): single wrap point over every gate-layer rejection path in
  * `submitPrReviewResultCore` (all 15 `{ status: 'rejected' }` return sites —
@@ -1253,6 +1326,13 @@ export declare function recordPrReviewMicroFamilyDispatch(directory: string, ses
 export declare function recordPrReviewValidationBatch(directory: string, sessionID: string, phase: PrReviewValidationPhase, lanes: readonly PrWorkflowLaneSpec[], options: {
     batchId: string;
     prHeadSha: string;
+    /**
+     * Issue #2906: reviewer batches only. The presentation order the dispatch
+     * prompt was counterbalanced for (from `derivePrReviewPresentationOrder`).
+     * When supplied and the re-derived ordinal disagrees, recording fails
+     * closed so the prompt can never misrepresent the stamped receipt.
+     */
+    expectedPresentationOrder?: 'A' | 'B';
 }): Promise<PrWorkflowGateState>;
 /**
  * Validate that every declared council obligation has a successful retry, and
@@ -1491,6 +1571,27 @@ export declare function markPrReviewHandoffComplete(directory: string, sessionID
     state: PrWorkflowGateState;
     alreadyOffered: boolean;
 }>;
+interface PrReviewFindingPolicyAuthority {
+    policyFindings: Array<{
+        id: string;
+        status: string;
+        severity: string;
+        action: string;
+        [key: string]: unknown;
+    }>;
+    criticSettlements: Array<{
+        findingId: string;
+        terminal: boolean;
+        status: CriticOutcome;
+    }>;
+}
+/**
+ * Read the policy sidecar as an integrity-bound projection of the final
+ * findings artifact.  A write-only sidecar is not evidence: the route receipt
+ * pins the PR head and exact findings bytes, while the sidecar digest pins the
+ * synthesized projection itself.
+ */
+export declare function readAuthoritativeFindingPolicy(directory: string, state: PrWorkflowGateState): Promise<PrReviewFindingPolicyAuthority>;
 /** Read-only final finding-policy projection for completion reports. */
 export declare function readPrReviewFinalFindingPolicyForReport(directory: string, sessionID: string): Promise<{
     policyVersion: 1;
@@ -1677,6 +1778,8 @@ export declare const _test_exports: {
             validatedInventory: string[];
             reviewerItemBindings?: Record<string, string> | undefined;
             reviewerItemBindingKeyEncoding?: "prefixed-v1" | undefined;
+            presentationOrder?: "A" | "B" | undefined;
+            orderUnstableItemIds?: string[] | undefined;
         }> | undefined;
         prReviewRetiredReviewerSessionIds?: string[] | undefined;
         prReviewRetiredConsolidatedLanes?: string[] | undefined;
@@ -1721,6 +1824,15 @@ export declare const _test_exports: {
             message: string;
             laneId?: string | undefined;
         }[] | undefined;
+        prReviewVerdictRejections?: {
+            [x: string]: unknown;
+            sessionId: string;
+            at: number;
+            message: string;
+            laneId?: string | undefined;
+            workflowLane?: string | undefined;
+            boundary?: "post_explorer" | "post_reviewer" | "post_critic" | undefined;
+        }[] | undefined;
         prReviewArtifactBoundaries?: ("post_explorer" | "post_reviewer" | "post_critic")[] | undefined;
         prReviewHandoffPath?: string | undefined;
         prReviewHandoffRequired?: boolean | undefined;
@@ -2333,6 +2445,47 @@ export declare function readAuthoritativePrReviewCriticVerdicts(directory: strin
     status: string;
     severity: string;
 }>>;
+/**
+ * Issue #2906: the presentation order the NEXT reviewer batch will be
+ * counterbalanced into — 'A' when the reviewer window holds an even number of
+ * batches, 'B' when odd. Pure function of the persisted window state; the
+ * dispatch tool derives it before prompt assembly and passes the same value to
+ * `recordPrReviewValidationBatch` as `expectedPresentationOrder`, which
+ * re-derives and fails closed on divergence.
+ *
+ * Issue #2906 review finding F-03: at the `MAX_WORKFLOW_BATCHES` cap the
+ * record guard counts the window of the PRUNED state (its read-prune-append
+ * transaction applies `prunePrWorkflowBatchesForCapacity` before deriving the
+ * stamped ordinal), while this derivation used to count the unpruned persisted
+ * window. When the prune flipped the window parity the guard threw — before
+ * `persistState`, so the prune was never durable — and every retry re-derived
+ * the same divergent value: a permanent liveness wedge that failed closed.
+ * This derivation therefore applies the SAME pure prune under the SAME
+ * >= cap condition, so both sides count the identical window. The prune is
+ * pure with respect to durable state (it reads artifacts and returns a
+ * candidate state; only the record path persists it), so running it here
+ * cannot violate the BL-6 single-transaction rule. Every prune-abort path
+ * (inventory inequality, unreadable delegation store, ledger overflow) returns
+ * the state unchanged here AND inside the record guard, so the two sides agree
+ * on those paths as well; a divergence that still reaches the guard means the
+ * state genuinely changed between derivation and recording, which fails closed
+ * and is recoverable by re-deriving.
+ */
+export declare function derivePrReviewPresentationOrder(directory: string, sessionID: string): Promise<'A' | 'B'>;
+/**
+ * Issue #2906: every currently-composed reviewer item whose verdict flipped
+ * across counterbalanced presentation orders (`orderAgreement: 'disagree'`).
+ * The critic dispatch tool renders these as `order_unstable_item_ids` so the
+ * critic prioritizes them.
+ */
+export declare function derivePrReviewOrderUnstableItems(directory: string, sessionID: string): Promise<string[]>;
+/**
+ * Issue #2906: the authoritative per-item order-agreement map for the findings
+ * writer — the same reader shape as `readAuthoritativePrReviewCriticVerdicts`,
+ * so a model-supplied `order_agreement` on a findings row can be cross-checked
+ * against the composed reviewer claims instead of being taken on trust.
+ */
+export declare function readAuthoritativePrReviewOrderAgreement(directory: string, sessionID: string): Promise<Map<string, 'agree' | 'disagree' | 'single'>>;
 interface ExpectedWorkflowLane {
     laneId: string;
     workflowLane: string;

package/dist/host/v2/agents-commands.d.ts

@@ -19,11 +19,21 @@
  *   - Entries the v1 hook marks `disable: true` (auto-select disabling the
  *     `build`/`plan` built-ins) are REMOVED on the v2 agent editor.
  *   - v1 command entries `{template, description}` → v2 CommandDefinition
- *     whose `execute` submits the expanded template through
- *     `ctx.session.prompt` (TUI-side $ARGUMENTS expansion is replaced by
- *     direct substitution — inventory row).
+ *     whose `execute` natively dispatches through the shared v1 command
+ *     handler (`command.execute.before` on the hooks object) and submits the
+ *     handler-produced prompt via the v2 session prompt surface; the raw
+ *     expanded template survives as the explicit fallback (#3169 Phase 4 —
+ *     see deferredV2ExecuteSwarmCommand).
  */
 import type { V1HooksSubset, V2AgentInfo, V2PluginContext, V2Registration } from './types';
+/**
+ * Test seam (review PRR-002): the dispatch budget is read through this
+ * object so the timeout→notice arm is reachable in tests without patching
+ * global timers.
+ */
+export declare const _internals: {
+    dispatchTimeoutMs: number;
+};
 interface V1AgentConfigLike {
     mode?: unknown;
     prompt?: unknown;