opencode-swarm 7.193.0 → 7.194.0

package/dist/cli/{scope-persistence-mrnz8j43.js → scope-persistence-y0ebqyjm.js}

@@ -25,8 +25,8 @@ import {
   tombstoneScopeBinding,
   writeScopeBindingToDisk,
   writeScopeToDisk
-} from "./index-1p24bfn2.js";
-import"./index-5ev6f1gj.js";
+} from "./index-r8mavcg6.js";
+import"./index-at34nry4.js";
 import"./index-qh93qjc2.js";
 import"./index-st80sjg7.js";
 import"./index-vg8sxg12.js";
@@ -35,7 +35,7 @@ import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
 import"./index-ndec8akq.js";
-import"./index-bg19b84s.js";
+import"./index-cwr69qw7.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
 import"./index-3atkcqpb.js";
@@ -48,10 +48,10 @@ import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-hfssjyxs.js";
 import"./index-gx2vp8gx.js";
-import"./index-ngk8hpc3.js";
+import"./index-0xe19j9g.js";
 import"./index-zxdawwc7.js";
-import"./index-1dx5zyss.js";
-import"./index-py8wpe81.js";
+import"./index-4ftg3p9n.js";
+import"./index-1jt12p3y.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";
 import"./index-zpsr8rpc.js";

package/dist/cli/{server-mwk6zn83.js → server-m10e78ey.js}

@@ -22,16 +22,16 @@ import {
   resolveWriteTargets,
   searchKnowledge,
   symbols
-} from "./index-jx80ed6g.js";
+} from "./index-vjytfp05.js";
 import {
   checkFileAuthority,
   checkWriteTargetForSymlink
-} from "./index-bkpyff61.js";
-import"./index-4mq8r4be.js";
+} from "./index-51dxek4p.js";
+import"./index-ehab3z5y.js";
 import {
   _internals,
   saveEvidence
-} from "./index-ma71x1aa.js";
+} from "./index-48h1yn6c.js";
 import {
   getProfileForFile
 } from "./index-j2vv0h13.js";
@@ -42,12 +42,12 @@ import"./index-7njm9jk1.js";
 import"./index-txdagbh7.js";
 import {
   resolveCohortId
-} from "./index-prvancd0.js";
+} from "./index-vfdkvvkf.js";
 import"./index-rdec0y3z.js";
-import"./index-d2emv8ap.js";
-import"./index-ymnathfr.js";
-import"./index-r3mffz78.js";
-import"./index-5n760fzn.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-cjapb4hy.js";
@@ -59,11 +59,11 @@ import {
 import"./index-q7sjgr1y.js";
 import {
   createSwarmTool
-} from "./index-nktwf2xm.js";
+} from "./index-yfbk69b1.js";
 import {
   loadPlan,
   loadPlanJsonOnly
-} from "./index-he2nyr7x.js";
+} from "./index-9v43y7y6.js";
 import {
   containsControlChars,
   createTargetWithinRootValidator,
@@ -73,15 +73,15 @@ import {
   validateWorkspaceRoot
 } from "./index-6b295cas.js";
 import"./index-9nyqt3kb.js";
-import"./index-bgtfvst1.js";
+import"./index-6xppb1er.js";
 import"./index-v3bmwmqw.js";
-import"./index-4gacy6y6.js";
-import"./index-nz6ehpjn.js";
-import"./index-x2phyvcv.js";
+import"./index-f3ttgqak.js";
+import"./index-jrs2qh6j.js";
+import"./index-d7pznffh.js";
 import"./index-g4fs6z4e.js";
-import"./index-6dn16dre.js";
-import"./index-tr47q89d.js";
-import"./index-cs0p582p.js";
+import"./index-dy7nztyp.js";
+import"./index-ajkdt5b8.js";
+import"./index-43v5axvm.js";
 import"./index-m9zzj4ee.js";
 import"./index-84k9zzv1.js";
 import"./index-2s7dvzff.js";
@@ -90,18 +90,18 @@ import {
   validateActionability,
   validateActionableFields,
   validateLesson
-} from "./index-jxs9qnad.js";
+} from "./index-3dpb3kps.js";
 import {
   resolveWorktreeId
 } from "./index-w2vbaczx.js";
 import"./index-rtry5xyf.js";
-import"./index-vbp35frb.js";
+import"./index-7bfshvq1.js";
 import"./index-g22dps7x.js";
 import"./index-0725jpp7.js";
 import {
   normalizeScopeFiles
-} from "./index-1p24bfn2.js";
-import"./index-5ev6f1gj.js";
+} from "./index-r8mavcg6.js";
+import"./index-at34nry4.js";
 import"./index-qh93qjc2.js";
 import"./index-st80sjg7.js";
 import"./index-vg8sxg12.js";
@@ -119,7 +119,7 @@ import {
   reinforceSwarmKnowledgeEntry,
   resolveSwarmKnowledgePath,
   transactKnowledge
-} from "./index-bg19b84s.js";
+} from "./index-cwr69qw7.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
 import"./index-3atkcqpb.js";
@@ -143,7 +143,7 @@ import"./index-gx2vp8gx.js";
 import {
   loadGateOverrides,
   loadPluginConfigWithMeta
-} from "./index-ngk8hpc3.js";
+} from "./index-0xe19j9g.js";
 import {
   init_git_executable,
   resolveGitExecutableAsync
@@ -151,11 +151,11 @@ import {
 import {
   KnowledgeConfigSchema,
   init_schema
-} from "./index-1dx5zyss.js";
+} from "./index-4ftg3p9n.js";
 import {
   TOOL_METADATA,
   init_tool_metadata
-} from "./index-py8wpe81.js";
+} from "./index-1jt12p3y.js";
 import {
   KNOWLEDGE_SCHEMA_VERSION,
   init_knowledge_types

package/dist/cli/{skill-generator-svs4k0g8.js → skill-generator-kzw1dcba.js}

@@ -33,21 +33,21 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-r3mffz78.js";
+} from "./index-9bzgea2y.js";
 import"./index-q7sjgr1y.js";
-import"./index-tr47q89d.js";
-import"./index-cs0p582p.js";
+import"./index-ajkdt5b8.js";
+import"./index-43v5axvm.js";
 import"./index-m9zzj4ee.js";
 import"./index-84k9zzv1.js";
 import"./index-2s7dvzff.js";
-import"./index-jxs9qnad.js";
+import"./index-3dpb3kps.js";
 import"./index-w2vbaczx.js";
 import"./index-rtry5xyf.js";
-import"./index-vbp35frb.js";
+import"./index-7bfshvq1.js";
 import"./index-g22dps7x.js";
 import"./index-0725jpp7.js";
 import"./index-ndec8akq.js";
-import"./index-bg19b84s.js";
+import"./index-cwr69qw7.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
 import"./index-3atkcqpb.js";
@@ -60,10 +60,10 @@ import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-hfssjyxs.js";
 import"./index-gx2vp8gx.js";
-import"./index-ngk8hpc3.js";
+import"./index-0xe19j9g.js";
 import"./index-zxdawwc7.js";
-import"./index-1dx5zyss.js";
-import"./index-py8wpe81.js";
+import"./index-4ftg3p9n.js";
+import"./index-1jt12p3y.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";
 import"./index-zpsr8rpc.js";

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

@@ -8,50 +8,50 @@ import {
   markSnapshotCoordinationClosing,
   retrySnapshotCoordinationInitialization,
   startSnapshotCoordinationInitialization
-} from "./index-jx80ed6g.js";
-import"./index-bkpyff61.js";
-import"./index-4mq8r4be.js";
-import"./index-ma71x1aa.js";
+} from "./index-vjytfp05.js";
+import"./index-51dxek4p.js";
+import"./index-ehab3z5y.js";
+import"./index-48h1yn6c.js";
 import"./index-j2vv0h13.js";
 import"./index-668npagp.js";
 import"./index-7njm9jk1.js";
 import"./index-txdagbh7.js";
-import"./index-prvancd0.js";
+import"./index-vfdkvvkf.js";
 import"./index-rdec0y3z.js";
-import"./index-d2emv8ap.js";
-import"./index-ymnathfr.js";
-import"./index-r3mffz78.js";
-import"./index-5n760fzn.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-cjapb4hy.js";
 import"./index-6s3ab22d.js";
 import"./index-pt7h91zc.js";
 import"./index-q7sjgr1y.js";
-import"./index-nktwf2xm.js";
-import"./index-he2nyr7x.js";
+import"./index-yfbk69b1.js";
+import"./index-9v43y7y6.js";
 import"./index-6b295cas.js";
 import"./index-9nyqt3kb.js";
-import"./index-bgtfvst1.js";
+import"./index-6xppb1er.js";
 import"./index-v3bmwmqw.js";
-import"./index-4gacy6y6.js";
-import"./index-nz6ehpjn.js";
-import"./index-x2phyvcv.js";
+import"./index-f3ttgqak.js";
+import"./index-jrs2qh6j.js";
+import"./index-d7pznffh.js";
 import"./index-g4fs6z4e.js";
-import"./index-6dn16dre.js";
-import"./index-tr47q89d.js";
-import"./index-cs0p582p.js";
+import"./index-dy7nztyp.js";
+import"./index-ajkdt5b8.js";
+import"./index-43v5axvm.js";
 import"./index-m9zzj4ee.js";
 import"./index-84k9zzv1.js";
 import"./index-2s7dvzff.js";
-import"./index-jxs9qnad.js";
+import"./index-3dpb3kps.js";
 import"./index-w2vbaczx.js";
 import"./index-rtry5xyf.js";
-import"./index-vbp35frb.js";
+import"./index-7bfshvq1.js";
 import"./index-g22dps7x.js";
 import"./index-0725jpp7.js";
-import"./index-1p24bfn2.js";
-import"./index-5ev6f1gj.js";
+import"./index-r8mavcg6.js";
+import"./index-at34nry4.js";
 import"./index-qh93qjc2.js";
 import"./index-st80sjg7.js";
 import"./index-vg8sxg12.js";
@@ -60,7 +60,7 @@ import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
 import"./index-ndec8akq.js";
-import"./index-bg19b84s.js";
+import"./index-cwr69qw7.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
 import"./index-3atkcqpb.js";
@@ -73,10 +73,10 @@ import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-hfssjyxs.js";
 import"./index-gx2vp8gx.js";
-import"./index-ngk8hpc3.js";
+import"./index-0xe19j9g.js";
 import"./index-zxdawwc7.js";
-import"./index-1dx5zyss.js";
-import"./index-py8wpe81.js";
+import"./index-4ftg3p9n.js";
+import"./index-1jt12p3y.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";
 import"./index-zpsr8rpc.js";

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

@@ -7,14 +7,14 @@ import {
   parseSpeckitTasksContent,
   propagateSpeckitCheckoff,
   writeSpeckitCheckoffLedger
-} from "./index-4gacy6y6.js";
+} from "./index-f3ttgqak.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-hfssjyxs.js";
-import"./index-ngk8hpc3.js";
+import"./index-0xe19j9g.js";
 import"./index-zxdawwc7.js";
-import"./index-1dx5zyss.js";
-import"./index-py8wpe81.js";
+import"./index-4ftg3p9n.js";
+import"./index-1jt12p3y.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";
 import"./index-zpsr8rpc.js";

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

@@ -13,7 +13,7 @@ import {
 import {
   scanDelegationFallbacksForRecovery,
   scanDelegationsForRecovery
-} from "./index-6dn16dre.js";
+} from "./index-dy7nztyp.js";
 import"./index-84k9zzv1.js";
 import"./index-2s7dvzff.js";
 import"./index-st80sjg7.js";
@@ -23,7 +23,7 @@ import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
 import"./index-ndec8akq.js";
-import"./index-bg19b84s.js";
+import"./index-cwr69qw7.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
 import"./index-3atkcqpb.js";

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

@@ -25,52 +25,52 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-jx80ed6g.js";
-import"./index-bkpyff61.js";
-import"./index-4mq8r4be.js";
-import"./index-ma71x1aa.js";
+} from "./index-vjytfp05.js";
+import"./index-51dxek4p.js";
+import"./index-ehab3z5y.js";
+import"./index-48h1yn6c.js";
 import"./index-j2vv0h13.js";
 import"./index-668npagp.js";
 import"./index-7njm9jk1.js";
 import"./index-txdagbh7.js";
-import"./index-prvancd0.js";
+import"./index-vfdkvvkf.js";
 import"./index-rdec0y3z.js";
-import"./index-d2emv8ap.js";
-import"./index-ymnathfr.js";
-import"./index-r3mffz78.js";
-import"./index-5n760fzn.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-cjapb4hy.js";
 import"./index-6s3ab22d.js";
 import"./index-pt7h91zc.js";
 import"./index-q7sjgr1y.js";
-import"./index-nktwf2xm.js";
-import"./index-he2nyr7x.js";
+import"./index-yfbk69b1.js";
+import"./index-9v43y7y6.js";
 import"./index-6b295cas.js";
 import"./index-9nyqt3kb.js";
-import"./index-bgtfvst1.js";
+import"./index-6xppb1er.js";
 import"./index-v3bmwmqw.js";
-import"./index-4gacy6y6.js";
-import"./index-nz6ehpjn.js";
-import"./index-x2phyvcv.js";
+import"./index-f3ttgqak.js";
+import"./index-jrs2qh6j.js";
+import"./index-d7pznffh.js";
 import"./index-g4fs6z4e.js";
-import"./index-6dn16dre.js";
-import"./index-tr47q89d.js";
-import"./index-cs0p582p.js";
+import"./index-dy7nztyp.js";
+import"./index-ajkdt5b8.js";
+import"./index-43v5axvm.js";
 import"./index-m9zzj4ee.js";
 import"./index-84k9zzv1.js";
 import"./index-2s7dvzff.js";
-import"./index-jxs9qnad.js";
+import"./index-3dpb3kps.js";
 import"./index-w2vbaczx.js";
 import"./index-rtry5xyf.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-vbp35frb.js";
+} from "./index-7bfshvq1.js";
 import"./index-g22dps7x.js";
 import"./index-0725jpp7.js";
-import"./index-1p24bfn2.js";
-import"./index-5ev6f1gj.js";
+import"./index-r8mavcg6.js";
+import"./index-at34nry4.js";
 import"./index-qh93qjc2.js";
 import"./index-st80sjg7.js";
 import"./index-vg8sxg12.js";
@@ -79,7 +79,7 @@ import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
 import"./index-ndec8akq.js";
-import"./index-bg19b84s.js";
+import"./index-cwr69qw7.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
 import"./index-3atkcqpb.js";
@@ -92,10 +92,10 @@ import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-hfssjyxs.js";
 import"./index-gx2vp8gx.js";
-import"./index-ngk8hpc3.js";
+import"./index-0xe19j9g.js";
 import"./index-zxdawwc7.js";
-import"./index-1dx5zyss.js";
-import"./index-py8wpe81.js";
+import"./index-4ftg3p9n.js";
+import"./index-1jt12p3y.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 — OpenCode 2 does not yet — so worktree-isolated coders and the phase review cannot run), 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 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 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

@@ -97,7 +97,7 @@ export interface EpicStartOptions {
  * with `client: undefined` (`src/host/v2/setup.ts`), so an epic there could
  * neither dispatch a coder nor complete a phase.
  */
-export declare const EPIC_HOST_UNSUPPORTED_MESSAGE = "This OpenCode host gives the plugin no SDK client (OpenCode 2 does not yet, see docs/host/v2-hook-inventory.md). 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+).";
+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.)";
 /** 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). */
@@ -163,10 +163,13 @@ export declare const _internals: {
     hasActiveTurboMode: () => boolean;
     /**
      * False only when the plugin was initialized on a host that supplies no
-     * SDK client: the v1 init stores the host client, the OpenCode 2 adapter
-     * stores `undefined`, and an uninitialized process (tests, scripts) keeps
-     * the initial `null` — which is not a host verdict, so it is allowed.
-     * Capability-based: once a v2 client is wired, Epic starts there too.
+     * SDK client: the v1 init stores the host client, an uninitialized process
+     * (tests, scripts) keeps the initial `null`, and only a genuinely
+     * client-less host stores `undefined` — which is not a host verdict, so
+     * it is allowed. Capability-based: the v2 adapter now ships a
+     * session-capable client (the #3169 session shim), so this passes on v2;
+     * Epic's v2 execution is held by the entry-point double-gate and the
+     * child-session placement work, not by this check.
      */
     hostProvidesClient: () => boolean;
     findRunningLeanRun: typeof findRunningLeanRun;

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

@@ -2208,6 +2208,32 @@ interface PrReviewGateContext {
      */
     candidateSeverities?: Map<string, CandidateSeverity>;
 }
+/**
+ * Issue #3095: read-surface reuse of the derivation above for
+ * `pr_workflow_status`. The derivation itself stays single-sourced: every
+ * production caller is a validation/enforcement path that must keep throwing,
+ * so this wrapper exists only to thread the SAME result to a read-only status
+ * tool and to degrade fail-soft instead of blocking an observation. A status
+ * read must never fail the whole tool for an unbound head or an unreadable
+ * revision digest — the caller renders the `unavailable` arm (with the
+ * bounded reason) and still projects boundaries and lane coverage.
+ *
+ * Read-only by construction: it performs no writes and mutates no state.
+ * COST DISCLOSURE (not free): resolving the derivation context runs the
+ * revision-digest computation on every bound PR_REVIEW call — three bounded
+ * git processes plus a re-read/hash of every changed file
+ * (`createPrReviewGateContext` → `resolvePrWorkflowRevisionDigestForGate` →
+ * the workspace-snapshot digest path). An observation surface pays the same
+ * digest price an enforcement call would.
+ */
+export type PrReviewCandidateInventoryForStatus = {
+    state: 'available';
+    inventory: string[];
+} | {
+    state: 'unavailable';
+    reason: string;
+};
+export declare function derivePrReviewCandidateInventoryForStatus(directory: string, state: PrWorkflowGateState): Promise<PrReviewCandidateInventoryForStatus>;
 /**
  * Extract candidate ids from a discovery artifact's [CANDIDATE] rows. When
  * `scopeToLanes` is given (base-dimension sources credited for only a subset
@@ -2406,6 +2432,17 @@ export interface PrWorkflowGateRecoveryRead {
      * availability one.
      */
     armedShapeUnreadable: boolean;
+    /**
+     * true when the salvage reconstructed ONLY the abort-relevant fields and
+     * every `prReview*` projection field (base dispatches, artifact
+     * boundaries, run id, findings path, settlement digests) was dropped
+     * because the shadow bytes failed schema validation. The status tool uses
+     * this to mark its derived PR_REVIEW sections `unavailable` instead of
+     * reporting healthy-but-empty coverage — an absent field on a salvaged
+     * state proves nothing about the workflow. Present only when true; a
+     * schema-valid shadow (or an ordinary healthy read) keeps full fidelity.
+     */
+    prReviewProjectionDropped?: boolean;
 }
 /**
  * Recovery-only gate-state reader (issue #2242 R4, wedge W-5).

package/dist/host/v2/session-client.d.ts

@@ -0,0 +1,77 @@
+/**
+ * v2 session client shim — issue #3169 Phase 2.
+ *
+ * A narrow `OpencodeClient` subset implementing exactly the v1 session surface
+ * Epic's dispatch paths use (`session.create/prompt/abort/delete` plus `get`,
+ * which verified teardown requires), backed by the v2 host's `ctx.session`
+ * domain. Installed as the synthetic v1 PluginInput's `client` field by
+ * `setup.ts`, it flows through the shared init core's single client write site
+ * into `swarmState.opencodeClient` and every init-path `ctx.client` consumer —
+ * the tracking issue's Decision 2 (a client subset instead of v2 branches
+ * spread through consumers).
+ *
+ * Translation contract (per the issue §4 gap table and the Phase 0 live
+ * findings on @opencode/cli 2.0.26):
+ *
+ *   - `create({body:{parentID,title}, query:{directory}})` validates placement
+ *     BEFORE creating anything: v2 child sessions inherit the parent's
+ *     directory and ignore the requested one (Phase 0 C1 catch), so a divergent
+ *     or unverifiable placement fails closed with a typed `{data: null,
+ *     error}` result — routing worktree isolation to its existing degradation
+ *     path instead of silently running a "lane" session in the project root.
+ *     A passing precheck mints a placeholder id; the real v2 session is
+ *     created at PROMPT time, when the v1 prompt body supplies the create-time
+ *     options (agent/model/permissions) the published `SessionCreateInput`
+ *     expects (issue R2: one session per dispatch contains the per-session
+ *     shift).
+ *   - `prompt({path:{id}, body:{agent,model?,system?,tools,parts}, signal?})`
+ *     emulates the v1 BLOCKING call: real create (carrying agent/model and the
+ *     read-only denial map as `effect:'deny'` permissions) → one sessionID-
+ *     scoped `context` hook that replaces `event.system` (fence-aware: parts
+ *     carrying the `<swarm_system_directive` provenance fence survive, per
+ *     #2526) and deletes denied keys from `event.tools` → `prompt` → bounded
+ *     `wait` → `context()` translated into the v1 `{data:{info,parts}}`
+ *     envelope so `dispatchEphemeralAgent` and `readProviderMessageError`
+ *     work unchanged. A prompt addressed to a non-placeholder (real) session
+ *     id takes a direct path without re-creating — the pr-event-delivery wake
+ *     prompt shape.
+ *   - Provider failures are EVENT-SOURCED on v2 (Phase 0 C4: no error text in
+ *     `context()`), so the event pump records `session.error` /
+ *     `session.execution.failed` payloads here (`recordV2SessionErrorFromEnvelope`,
+ *     called pump-side beside `seedSessionIdentityFromEnvelope`) and the
+ *     translation surfaces them as the v1 `info.error` shape. A failed outcome
+ *     without recorded detail yields a bounded `provider.unknown` error
+ *     instead of a silent empty success.
+ *   - `abort` maps to `interrupt`, `delete` to `remove`, `get` to the v2 get
+ *     (unresolved placeholders read as `{data: null}` — never prompted means
+ *     gone, satisfying `teardownEphemeralSessionVerified`).
+ *
+ * Deferred-work marker: NONE. The unverified live-host behaviors this design
+ * rests on are recorded as deferrals in the trace (context-hook firing for
+ * plugin-created sessions, permission vocabulary honor, `context()` entry
+ * shapes, `wait` on failed prompts, `get(parent).location` availability) with
+ * the owning follow-up on #3169.
+ *
+ * C6 await convention: every `await` lives inside a `deferredV2Session*`
+ * function declaration or `const deferredV2SessionX = async (` binding — the
+ * dual-shape-parity scan's function tracker does not recognize object-literal
+ * method properties, so the client object's methods never await directly.
+ */
+import type { OpencodeClient } from '@opencode-ai/sdk';
+import type { V2EventEnvelope, V2PluginContext, V2SessionPermission } from './types';
+/**
+ * Record a `session.error` / `session.execution.failed` envelope's error
+ * payload for the shim's result translation. SYNC by contract — the event pump
+ * calls it inline in its iteration loop. Accepts the same dual payload dialect
+ * `mapV2EventToV1` accepts (live `data`, SDK `properties`).
+ */
+export declare function recordV2SessionErrorFromEnvelope(envelope: V2EventEnvelope): void;
+/** Drop all shim-held state (v2 cleanup path; bounded residue documented in the trace). */
+export declare function clearV2SessionClientState(): void;
+/**
+ * Map a v1 read-only denial map onto v2 create-time permission entries.
+ * Fail-closed shape: only `effect: 'deny'` entries are ever produced.
+ */
+export declare function readOnlyToolsToV2Permissions(tools: Readonly<Record<string, false>> | undefined): V2SessionPermission[];
+/** Feature-detect the full surface the shim requires (types.ts host-tolerance contract). */
+export declare function createV2SessionClient(ctx: V2PluginContext): OpencodeClient | undefined;