opencode-swarm 7.195.0 → 7.197.0

package/dist/cli/{server-am2y11yn.js → server-rpx7pkg1.js}

@@ -22,16 +22,16 @@ import {
   resolveWriteTargets,
   searchKnowledge,
   symbols
-} from "./index-7kbpzg05.js";
+} from "./index-jvpvghyh.js";
 import {
   checkFileAuthority,
   checkWriteTargetForSymlink
-} from "./index-akb436kn.js";
-import"./index-gns3gc87.js";
+} from "./index-8zwmfh9d.js";
+import"./index-67w61x1b.js";
 import {
   _internals,
   saveEvidence
-} from "./index-780g1hht.js";
+} from "./index-jvzfw0n5.js";
 import {
   getProfileForFile
 } from "./index-j2vv0h13.js";
@@ -42,12 +42,12 @@ import"./index-necqa5bj.js";
 import"./index-txdagbh7.js";
 import {
   resolveCohortId
-} from "./index-8448vj9w.js";
+} from "./index-dgvf1jey.js";
 import"./index-rdec0y3z.js";
-import"./index-863hst4e.js";
-import"./index-fk4j26km.js";
-import"./index-yryy781f.js";
-import"./index-gz16dke1.js";
+import"./index-ysbmrmzk.js";
+import"./index-njfkqr77.js";
+import"./index-29xr45xr.js";
+import"./index-1cks27mv.js";
 import"./index-ghckhk16.js";
 import"./index-ypkfhqbc.js";
 import"./index-cjapb4hy.js";
@@ -59,11 +59,11 @@ import {
 import"./index-q7sjgr1y.js";
 import {
   createSwarmTool
-} from "./index-xs9cn3c0.js";
+} from "./index-xf6tdsyr.js";
 import {
   loadPlan,
   loadPlanJsonOnly
-} from "./index-epdzvp4w.js";
+} from "./index-1gnrtz76.js";
 import {
   containsControlChars,
   createTargetWithinRootValidator,
@@ -73,15 +73,15 @@ import {
   validateWorkspaceRoot
 } from "./index-6b295cas.js";
 import"./index-9nyqt3kb.js";
-import"./index-peyz4k9k.js";
+import"./index-t3tzk566.js";
 import"./index-v3bmwmqw.js";
-import"./index-z59414gv.js";
-import"./index-kmvy5fr8.js";
-import"./index-479kf368.js";
+import"./index-v8jhmn8x.js";
+import"./index-401a12w5.js";
+import"./index-mbdkr2sh.js";
 import"./index-g4fs6z4e.js";
-import"./index-3k65kdfp.js";
-import"./index-bftpd2m5.js";
-import"./index-c4hx57tz.js";
+import"./index-9px1knpj.js";
+import"./index-eabxecjf.js";
+import"./index-ng6me2hh.js";
 import"./index-m9zzj4ee.js";
 import"./index-kphy4we7.js";
 import"./index-2s7dvzff.js";
@@ -90,18 +90,18 @@ import {
   validateActionability,
   validateActionableFields,
   validateLesson
-} from "./index-tc8x0zc5.js";
+} from "./index-avbvxmw2.js";
 import {
   resolveWorktreeId
 } from "./index-hy2fqapm.js";
 import"./index-rtry5xyf.js";
-import"./index-82aj6gaj.js";
+import"./index-g749xs7c.js";
 import"./index-g22dps7x.js";
 import"./index-0725jpp7.js";
 import {
   normalizeScopeFiles
-} from "./index-6vpqe4ws.js";
-import"./index-1hcjxz6w.js";
+} from "./index-fzx1wfxn.js";
+import"./index-9sqcmzc2.js";
 import"./index-6183at3v.js";
 import"./index-j8t1g5qd.js";
 import"./index-crz772sx.js";
@@ -119,7 +119,7 @@ import {
   reinforceSwarmKnowledgeEntry,
   resolveSwarmKnowledgePath,
   transactKnowledge
-} from "./index-5gf2wx2c.js";
+} from "./index-xb3h5tvj.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
 import"./index-ry5g9s8d.js";
@@ -143,7 +143,7 @@ import"./index-gx2vp8gx.js";
 import {
   loadGateOverrides,
   loadPluginConfigWithMeta
-} from "./index-c6hyd8hg.js";
+} from "./index-bpnpvhja.js";
 import {
   init_git_executable,
   resolveGitExecutableAsync
@@ -151,7 +151,7 @@ import {
 import {
   KnowledgeConfigSchema,
   init_schema
-} from "./index-jn4mmhqc.js";
+} from "./index-20m9q2z9.js";
 import {
   TOOL_METADATA,
   init_tool_metadata

package/dist/cli/{skill-generator-p71b6h5k.js → skill-generator-h1w7s5dh.js}

@@ -33,21 +33,21 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-yryy781f.js";
+} from "./index-29xr45xr.js";
 import"./index-q7sjgr1y.js";
-import"./index-bftpd2m5.js";
-import"./index-c4hx57tz.js";
+import"./index-eabxecjf.js";
+import"./index-ng6me2hh.js";
 import"./index-m9zzj4ee.js";
 import"./index-kphy4we7.js";
 import"./index-2s7dvzff.js";
-import"./index-tc8x0zc5.js";
+import"./index-avbvxmw2.js";
 import"./index-hy2fqapm.js";
 import"./index-rtry5xyf.js";
-import"./index-82aj6gaj.js";
+import"./index-g749xs7c.js";
 import"./index-g22dps7x.js";
 import"./index-0725jpp7.js";
 import"./index-gc0aeth5.js";
-import"./index-5gf2wx2c.js";
+import"./index-xb3h5tvj.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
 import"./index-ry5g9s8d.js";
@@ -60,9 +60,9 @@ import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-yf2z4j7s.js";
 import"./index-gx2vp8gx.js";
-import"./index-c6hyd8hg.js";
+import"./index-bpnpvhja.js";
 import"./index-zxdawwc7.js";
-import"./index-jn4mmhqc.js";
+import"./index-20m9q2z9.js";
 import"./index-hqrkr9ag.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";

package/dist/cli/{snapshot-coordination-init-x9b4t9sk.js → snapshot-coordination-init-f6ecsn9c.js}

@@ -8,50 +8,50 @@ import {
   markSnapshotCoordinationClosing,
   retrySnapshotCoordinationInitialization,
   startSnapshotCoordinationInitialization
-} from "./index-7kbpzg05.js";
-import"./index-akb436kn.js";
-import"./index-gns3gc87.js";
-import"./index-780g1hht.js";
+} from "./index-jvpvghyh.js";
+import"./index-8zwmfh9d.js";
+import"./index-67w61x1b.js";
+import"./index-jvzfw0n5.js";
 import"./index-j2vv0h13.js";
 import"./index-c5xvm318.js";
 import"./index-necqa5bj.js";
 import"./index-txdagbh7.js";
-import"./index-8448vj9w.js";
+import"./index-dgvf1jey.js";
 import"./index-rdec0y3z.js";
-import"./index-863hst4e.js";
-import"./index-fk4j26km.js";
-import"./index-yryy781f.js";
-import"./index-gz16dke1.js";
+import"./index-ysbmrmzk.js";
+import"./index-njfkqr77.js";
+import"./index-29xr45xr.js";
+import"./index-1cks27mv.js";
 import"./index-ghckhk16.js";
 import"./index-ypkfhqbc.js";
 import"./index-cjapb4hy.js";
 import"./index-dfrcc46h.js";
 import"./index-pt7h91zc.js";
 import"./index-q7sjgr1y.js";
-import"./index-xs9cn3c0.js";
-import"./index-epdzvp4w.js";
+import"./index-xf6tdsyr.js";
+import"./index-1gnrtz76.js";
 import"./index-6b295cas.js";
 import"./index-9nyqt3kb.js";
-import"./index-peyz4k9k.js";
+import"./index-t3tzk566.js";
 import"./index-v3bmwmqw.js";
-import"./index-z59414gv.js";
-import"./index-kmvy5fr8.js";
-import"./index-479kf368.js";
+import"./index-v8jhmn8x.js";
+import"./index-401a12w5.js";
+import"./index-mbdkr2sh.js";
 import"./index-g4fs6z4e.js";
-import"./index-3k65kdfp.js";
-import"./index-bftpd2m5.js";
-import"./index-c4hx57tz.js";
+import"./index-9px1knpj.js";
+import"./index-eabxecjf.js";
+import"./index-ng6me2hh.js";
 import"./index-m9zzj4ee.js";
 import"./index-kphy4we7.js";
 import"./index-2s7dvzff.js";
-import"./index-tc8x0zc5.js";
+import"./index-avbvxmw2.js";
 import"./index-hy2fqapm.js";
 import"./index-rtry5xyf.js";
-import"./index-82aj6gaj.js";
+import"./index-g749xs7c.js";
 import"./index-g22dps7x.js";
 import"./index-0725jpp7.js";
-import"./index-6vpqe4ws.js";
-import"./index-1hcjxz6w.js";
+import"./index-fzx1wfxn.js";
+import"./index-9sqcmzc2.js";
 import"./index-6183at3v.js";
 import"./index-j8t1g5qd.js";
 import"./index-crz772sx.js";
@@ -60,7 +60,7 @@ import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
 import"./index-gc0aeth5.js";
-import"./index-5gf2wx2c.js";
+import"./index-xb3h5tvj.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
 import"./index-ry5g9s8d.js";
@@ -73,9 +73,9 @@ import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-yf2z4j7s.js";
 import"./index-gx2vp8gx.js";
-import"./index-c6hyd8hg.js";
+import"./index-bpnpvhja.js";
 import"./index-zxdawwc7.js";
-import"./index-jn4mmhqc.js";
+import"./index-20m9q2z9.js";
 import"./index-hqrkr9ag.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";

package/dist/cli/{speckit-checkoff-xp9vsp9k.js → speckit-checkoff-kf0zkpdw.js}

@@ -7,13 +7,13 @@ import {
   parseSpeckitTasksContent,
   propagateSpeckitCheckoff,
   writeSpeckitCheckoffLedger
-} from "./index-z59414gv.js";
+} from "./index-v8jhmn8x.js";
 import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-yf2z4j7s.js";
-import"./index-c6hyd8hg.js";
+import"./index-bpnpvhja.js";
 import"./index-zxdawwc7.js";
-import"./index-jn4mmhqc.js";
+import"./index-20m9q2z9.js";
 import"./index-hqrkr9ag.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.js";

package/dist/cli/{worktree-collision-ownership-2pmyww6g.js → worktree-collision-ownership-p7zmj4ag.js}

@@ -13,7 +13,7 @@ import {
 import {
   scanDelegationFallbacksForRecovery,
   scanDelegationsForRecovery
-} from "./index-3k65kdfp.js";
+} from "./index-9px1knpj.js";
 import"./index-kphy4we7.js";
 import"./index-2s7dvzff.js";
 import"./index-j8t1g5qd.js";
@@ -23,7 +23,7 @@ import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
 import"./index-gc0aeth5.js";
-import"./index-5gf2wx2c.js";
+import"./index-xb3h5tvj.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
 import"./index-ry5g9s8d.js";

package/dist/cli/{worktree-isolation-379tmkta.js → worktree-isolation-nz90xvw5.js}

@@ -25,52 +25,52 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-7kbpzg05.js";
-import"./index-akb436kn.js";
-import"./index-gns3gc87.js";
-import"./index-780g1hht.js";
+} from "./index-jvpvghyh.js";
+import"./index-8zwmfh9d.js";
+import"./index-67w61x1b.js";
+import"./index-jvzfw0n5.js";
 import"./index-j2vv0h13.js";
 import"./index-c5xvm318.js";
 import"./index-necqa5bj.js";
 import"./index-txdagbh7.js";
-import"./index-8448vj9w.js";
+import"./index-dgvf1jey.js";
 import"./index-rdec0y3z.js";
-import"./index-863hst4e.js";
-import"./index-fk4j26km.js";
-import"./index-yryy781f.js";
-import"./index-gz16dke1.js";
+import"./index-ysbmrmzk.js";
+import"./index-njfkqr77.js";
+import"./index-29xr45xr.js";
+import"./index-1cks27mv.js";
 import"./index-ghckhk16.js";
 import"./index-ypkfhqbc.js";
 import"./index-cjapb4hy.js";
 import"./index-dfrcc46h.js";
 import"./index-pt7h91zc.js";
 import"./index-q7sjgr1y.js";
-import"./index-xs9cn3c0.js";
-import"./index-epdzvp4w.js";
+import"./index-xf6tdsyr.js";
+import"./index-1gnrtz76.js";
 import"./index-6b295cas.js";
 import"./index-9nyqt3kb.js";
-import"./index-peyz4k9k.js";
+import"./index-t3tzk566.js";
 import"./index-v3bmwmqw.js";
-import"./index-z59414gv.js";
-import"./index-kmvy5fr8.js";
-import"./index-479kf368.js";
+import"./index-v8jhmn8x.js";
+import"./index-401a12w5.js";
+import"./index-mbdkr2sh.js";
 import"./index-g4fs6z4e.js";
-import"./index-3k65kdfp.js";
-import"./index-bftpd2m5.js";
-import"./index-c4hx57tz.js";
+import"./index-9px1knpj.js";
+import"./index-eabxecjf.js";
+import"./index-ng6me2hh.js";
 import"./index-m9zzj4ee.js";
 import"./index-kphy4we7.js";
 import"./index-2s7dvzff.js";
-import"./index-tc8x0zc5.js";
+import"./index-avbvxmw2.js";
 import"./index-hy2fqapm.js";
 import"./index-rtry5xyf.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-82aj6gaj.js";
+} from "./index-g749xs7c.js";
 import"./index-g22dps7x.js";
 import"./index-0725jpp7.js";
-import"./index-6vpqe4ws.js";
-import"./index-1hcjxz6w.js";
+import"./index-fzx1wfxn.js";
+import"./index-9sqcmzc2.js";
 import"./index-6183at3v.js";
 import"./index-j8t1g5qd.js";
 import"./index-crz772sx.js";
@@ -79,7 +79,7 @@ import"./index-ry16d01s.js";
 import"./index-rdm3px0g.js";
 import"./index-7pmbnjvj.js";
 import"./index-gc0aeth5.js";
-import"./index-5gf2wx2c.js";
+import"./index-xb3h5tvj.js";
 import"./index-vzm6zre7.js";
 import"./index-ae75rja9.js";
 import"./index-ry5g9s8d.js";
@@ -92,9 +92,9 @@ import"./index-ejhxgyvm.js";
 import"./index-7g4c7s5r.js";
 import"./index-yf2z4j7s.js";
 import"./index-gx2vp8gx.js";
-import"./index-c6hyd8hg.js";
+import"./index-bpnpvhja.js";
 import"./index-zxdawwc7.js";
-import"./index-jn4mmhqc.js";
+import"./index-20m9q2z9.js";
 import"./index-hqrkr9ag.js";
 import"./index-bk5tah7q.js";
 import"./index-gknz3bv1.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/config/skill-contract-digest.d.ts

@@ -14,6 +14,12 @@ export declare function splitSkillFrontmatter(content: string): {
 export declare function skillContractDigest(body: string): string;
 /**
  * Read the stamped contract digest from a frontmatter block, if present.
+ * Accepts the spec shape (a two-space-indented child of the `metadata:` map,
+ * issue #2907) and the legacy column-0 form so consumer installs generated
+ * before the migration keep verifying. Deeper-indented lines (e.g. stamp-
+ * shaped text inside a `description: |` block scalar) do NOT match — the
+ * indent is anchored to exactly the two forms the stamp writer emits
+ * (PRR-020, PR #3207 review).
  * String.match rather than RegExp.exec: the SAST callee-binding classifier
  * (issue #2300) flags an unresolved .exec member call as exec-like.
  */

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/skill-scoring.d.ts

@@ -67,7 +67,7 @@ export interface SkillMetadata {
     skillType?: 'directive' | 'workflow';
     /** Literal trigger phrases from frontmatter. */
     triggers?: string[];
-    /** Bounded, top-level audience declaration and its parse status. */
+    /** Audience declaration (spec `metadata.audience` or legacy top-level) and its parse status. */
     audience?: SkillAudienceMetadata;
 }
 export declare const _internals: {

package/dist/hooks/skill-usage-log.d.ts

@@ -280,6 +280,8 @@ export declare function resolveSourceKnowledgeIds(directory: string, skillPath:
  * Pure helper: parse `generated_from_knowledge:` YAML list from frontmatter.
  * Uses a minimal regex-based parser — the SKILL.md format is well-known and narrow.
  * Does NOT use a full YAML parser to avoid adding a dependency.
+ * Accepts the spec shape (indented `metadata:` child; lists serialize as
+ * JSON-string arrays, issue #2907) and the legacy top-level block list.
  */
 declare function parseGeneratedFromKnowledge(content: string): 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;