@pennixrv/trellis 0.7.0-beta.5 → 0.7.0-beta.50

package/dist/migrations/manifests/0.7.0-beta.40.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.7.0-beta.40",
+  "description": "Durable owned Codex session relationships and binding readiness",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "Record new owned Codex bindings outside removable Channels and expose exact historical descendants through channel sessions; wait for persisted binding before turn delivery.",
+  "migrations": [],
+  "notes": "Tracking starts at activation. No pre-upgrade history import or recovery; use native Trellis update for generated assets."
+}

package/dist/migrations/manifests/0.7.0-beta.41.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.7.0-beta.41",
+  "description": "Read-only research completion and explicit subnode dispatch approval",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "Allow complex and cross-owner analysis-only work to complete in planning without implementation approval. Require a frozen, explicitly approved evidence plan before requested subnode dispatch; preserve change-bearing Planning Seal and approval.",
+  "migrations": [],
+  "notes": "No migrations. Research remains bounded by the protected-target no-change contract."
+}

package/dist/migrations/manifests/0.7.0-beta.42.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.7.0-beta.42",
+  "description": "Bounded in-progress amendments and retired Herdr cleanup",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "Allow explicit low-risk same-task amendments to remain in progress while preserving replan gates for material changes. Remove the retired Herdr workflow hook and integration residue.",
+  "migrations": [],
+  "notes": "No migrations. Existing task state and user-owned Herdr history remain untouched."
+}

package/dist/migrations/manifests/0.7.0-beta.43.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.7.0-beta.43",
+  "description": "Effective AGENTS source diagnostics and progressive decisions",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "Report non-empty same-directory AGENTS overrides without modifying user rules. Screen genuine user decisions progressively and escalate material execution ambiguity through native replan. Keep project graph checks capability-aware.",
+  "migrations": [],
+  "notes": "No migrations. Existing task state, user-owned AGENTS text and overrides are preserved."
+}

package/dist/migrations/manifests/0.7.0-beta.44.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.7.0-beta.44",
+  "description": "Bounded Codex memory queries and workflow asset boundaries",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "Read Codex JSONL memory queries in bounded passes, preserve compaction and repeated-turn semantics, enforce context character budgets, and clarify managed asset, dispatch, archive acceptance, and bulk research boundaries.",
+  "migrations": [],
+  "notes": "No migrations. Existing session data, task state, and user-owned workflow files are preserved."
+}

package/dist/migrations/manifests/0.7.0-beta.45.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.7.0-beta.45",
+  "description": "Bounded Codex memory queries and workflow asset boundaries",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "Read Codex JSONL memory queries in bounded passes, preserve compaction and repeated-turn semantics, enforce context character budgets, and clarify managed asset, dispatch, archive acceptance, and bulk research boundaries.",
+  "migrations": [],
+  "notes": "No migrations. Existing session data, task state, and user-owned workflow files are preserved."
+}

package/dist/migrations/manifests/0.7.0-beta.46.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.7.0-beta.46",
+  "description": "Idea-to-plan routing and closed-loop review guidance",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "Add workflow guidance for separating facts from decisions, recording evidence at the natural task artifact, grilling consequential choices, closing review loops, and assigning boundaries to neighboring defects.",
+  "migrations": [],
+  "notes": "No migrations. Existing session data, task state, and user-owned workflow files are preserved."
+}

package/dist/migrations/manifests/0.7.0-beta.47.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.7.0-beta.47",
+  "description": "简体中文默认用户文档模板与双格式解析",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "原生 workflow、任务 PRD、workspace 和 spec 源模板使用中文优先正文；阶段标题和日志续写支持旧英文及新双语格式。",
+  "migrations": [],
+  "notes": "不迁移既有用户文档或历史日志。原生 workflow 继续按模板哈希更新，用户冲突和第三方 workflow 保持原生保护。"
+}

package/dist/migrations/manifests/0.7.0-beta.48.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.7.0-beta.48",
+  "description": "工作流资源留存与安全清理边界",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "Channel、Grok 输出、FastCtx 后台任务和 Trellis 备份增加有界留存与原生清理入口；清理默认只读预览，并在无法证明归属或状态异常时安全停止。",
+  "migrations": [],
+  "notes": "不迁移既有项目资产或运行态数据。新清理入口由各组件原生所有者执行，未知、活动或无归属资源继续保留。"
+}

package/dist/migrations/manifests/0.7.0-beta.49.json

@@ -0,0 +1,13 @@
+{
+  "version": "0.7.0-beta.49",
+  "description": "Protect update backups and report actual pruning results",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": [
+    "Share an exclusive lock between update writes and backup pruning",
+    "Separate preview candidates and estimated bytes from actual successful removals",
+    "Report partial deletion failures without counting them as reclaimed bytes"
+  ],
+  "migrations": [],
+  "notes": "No project migration or automatic backup deletion."
+}

package/dist/migrations/manifests/0.7.0-beta.50.json

@@ -0,0 +1,12 @@
+{
+  "version": "0.7.0-beta.50",
+  "description": "Preserve project instruction bytes when appending the Trellis block",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": [
+    "Preserve trailing spaces and blank lines in existing project instructions during init",
+    "Verify that manual content and an existing CodeGraph block remain byte-for-byte intact"
+  ],
+  "migrations": [],
+  "notes": "No project workflow change or automatic migration."
+}

package/dist/migrations/manifests/0.7.0-beta.6.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.7.0-beta.6",
+  "description": "Pennix v0.7 beta release tag isolation",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- Beta release pushes only its newly-created tag, preventing unrelated local tags from triggering npm publish workflows.",
+  "migrations": [],
+  "notes": "Run `npm install -g @pennixrv/trellis@beta` then `trellis update`. No `--migrate` required."
+}

package/dist/migrations/manifests/0.7.0-beta.7.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.7.0-beta.7",
+  "description": "Pennix v0.7 beta release verification normalization",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- Normalize npm's single-item JSON array response during local and CI visibility verification.",
+  "migrations": [],
+  "notes": "Run `npm install -g @pennixrv/trellis@beta` then `trellis update`. No `--migrate` required."
+}

package/dist/migrations/manifests/0.7.0-beta.8.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.7.0-beta.8",
+  "description": "Pennix v0.7 beta decision-chain replanning",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Features:**\n- Add an auditable same-task replan transition for material implementation-time decisions.\n- Preserve every planning interval in `trellis mem --phase brainstorm`.",
+  "migrations": [],
+  "notes": "Run `npm install -g @pennixrv/trellis@beta` then `trellis update`. No `--migrate` required."
+}

package/dist/migrations/manifests/0.7.0-beta.9.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.7.0-beta.9",
+  "description": "Pennix v0.7 beta planning and evidence governance",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Features:**\n- Require complex analysis to use normal planning and a sealed decision chain.\n- Add evidence units and schema-v2 subnode reports with coordinator-only acceptance.",
+  "migrations": [],
+  "notes": "Run npm install -g @pennixrv/trellis@beta then trellis update. No --migrate required."
+}

package/dist/templates/codex/hooks/session-start.py

@@ -240,8 +240,8 @@ def _get_task_status(trellis_dir: Path, hook_input: dict) -> str:
     if not active.task_path:
         return (
             "Status: NO ACTIVE TASK\n"
-            "Next: Classify the current turn and ask for task-creation consent "
-            "before creating any Trellis task."
+            "Next: Classify the current turn; simple conversation needs no task, "
+            "bounded direct work uses the direct path, and complex work creates a task only when planning is authorized."
         )
 
     task_ref = active.task_path
@@ -253,12 +253,10 @@ def _get_task_status(trellis_dir: Path, hook_input: dict) -> str:
         )
 
     task_json_path = task_dir / "task.json"
-    task_data: dict = {}
-    if task_json_path.is_file():
-        try:
-            task_data = json.loads(task_json_path.read_text(encoding="utf-8"))
-        except (json.JSONDecodeError, PermissionError):
-            pass  # Optional task metadata; fall back to generic status.
+    from common.io import read_json_checked
+    task_data, _reason = read_json_checked(task_json_path)
+    if task_data is None or not isinstance(task_data.get("status"), str) or not task_data["status"].strip():
+        return f"Status: TASK_ERROR\nTask: {task_ref}\nNext: Repair the existing task record through its owner before continuing; do not create a replacement task."
 
     task_title = task_data.get("title", task_ref)
     task_status = task_data.get("status", "unknown")
@@ -396,13 +394,15 @@ def _build_compact_current_state(
         lines.append(f"Current task: ambiguous; candidates={candidates}; bind explicitly.")
     elif active.task_path:
         task_dir = _resolve_task_dir(trellis_dir, active.task_path)
-        status = "unknown"
+        status = "task_error"
         task_json = task_dir / "task.json"
         if task_json.is_file():
             try:
                 data = json.loads(task_json.read_text(encoding="utf-8"))
                 if isinstance(data, dict):
-                    status = str(data.get("status") or "unknown")
+                    value = data.get("status")
+                    if isinstance(value, str) and value.strip():
+                        status = value
             except (json.JSONDecodeError, OSError):
                 pass  # Optional task metadata; fall back to generic status.
         lines.append(f"Current task: {_repo_relative(repo_root, task_dir)}; status={status}.")
@@ -431,19 +431,19 @@ def _build_compact_current_state(
     return "\n".join(lines)
 
 
-def _extract_range(content: str, start_header: str, end_header: str) -> str:
+def _extract_range(content: str, start_header: tuple[str, ...], end_header: tuple[str, ...]) -> str:
     """Extract lines starting at `## start_header` up to (but excluding) `## end_header`."""
     lines = content.splitlines()
     start: "int | None" = None
     end: int = len(lines)
-    start_match = f"## {start_header}"
-    end_match = f"## {end_header}"
+    start_matches = {f"## {header}" for header in start_header}
+    end_matches = {f"## {header}" for header in end_header}
     for i, line in enumerate(lines):
         stripped = line.strip()
-        if start is None and stripped == start_match:
+        if start is None and stripped in start_matches:
             start = i
             continue
-        if start is not None and stripped == end_match:
+        if start is not None and stripped in end_matches:
             end = i
             break
     if start is None:
@@ -495,7 +495,7 @@ def _build_workflow_toc(workflow_path: Path) -> str:
         "",
     ]
 
-    phases = _extract_range(content, "Phase Index", "Phase 1: Plan")
+    phases = _extract_range(content, ("阶段索引（Phase Index）", "Phase Index"), ("阶段一：规划（Phase 1: Plan）", "Phase 1: Plan"))
     if phases:
         out_lines.append(_strip_breadcrumb_tag_blocks(phases).rstrip())
 
@@ -511,11 +511,15 @@ def main() -> None:
         hook_input = json.loads(sys.stdin.read())
         if not isinstance(hook_input, dict):
             hook_input = {}
-        project_dir = Path(_normalize_windows_shell_path(hook_input.get("cwd", "."))).resolve()
+        raw_cwd = hook_input.get("cwd")
+        project_dir = Path(_normalize_windows_shell_path(raw_cwd if isinstance(raw_cwd, str) and raw_cwd else ".")).resolve()
     except (json.JSONDecodeError, KeyError):
         hook_input = {}
         project_dir = Path(".").resolve()
 
+    project_dir = next((candidate for candidate in (project_dir, *project_dir.parents) if (candidate / ".trellis").is_dir()), None)
+    if project_dir is None or not (project_dir / ".trellis" / "scripts" / "common" / "active_task.py").is_file():
+        return
     configure_project_encoding(project_dir)
 
     trellis_dir = project_dir / ".trellis"

package/dist/templates/common/bundled-skills/trellis-channel/SKILL.md

@@ -35,6 +35,7 @@ trellis channel context list <board> --scope global --thread <thread>
 | "和 codex/claude 讨论一下", "brainstorm with another agent" | `references/workflows.md` |
 | "派一个 implement/check agent", "让 agent review", "spawn a worker" | `references/workflows.md`, then `references/workers.md` |
 | "独立取证", "subnode", "反证/独立审查", "持久化工作节点报告" | `references/subnode-work.md`, then `references/workers.md` |
+| Multiple evidence units, FIFO refill, or task switching with live nodes | `references/subnode-work.md`, then `references/multi-target-dispatch.md` |
 | "开 issue 区 / topic 群 / changelog / board", "make a forum" | `references/forum.md` |
 | "看看这个 thread / linked context", "inspect a thread" | `references/forum.md` |
 | "channel 卡住了 / 没输出 / progress 被截断", "worker stalled" | `references/progress-debugging.md` |
@@ -46,7 +47,7 @@ trellis channel context list <board> --scope global --thread <thread>
 - Use `--context-file` / `--context-raw` and `trellis channel context add/delete/list`. `--linked-context-*` is deprecated terminology.
 - Use `--stdin` or `--text-file` for long messages. Do not put long mixed Chinese/English text in the positional shell argument.
 - Pretty `messages` output is an operator dashboard and may truncate progress. Use `--raw` for audit.
-- `--as` is the speaker or worker handle, depending on the command. Use explicit, stable names when multiple agents or sessions are involved.
+- `--as` is the speaker or worker handle, depending on the command. Author commands default to `TRELLIS_CHANNEL_AS` or `main`; `kill` still requires the target worker, and multi-worker dispatch needs distinct worker names.
 - `--scope project` (default) operates on the current cwd's project bucket; `--scope global` operates on the shared `__global__` bucket. Pick scope deliberately — a global board is invisible from project listings unless `--scope global` is passed.
 - For brainstorm, do multiple pressure-test rounds. One answer plus one confirmation is review, not brainstorm.
 - **Dispatcher wait pattern**: use `--kind done` / `--kind turn_finished` (trellis-emitted system events), NOT a user `--tag` as the completion signal. CLI help lists `phase_done` / `question` as `--tag` examples but only `interrupt` is a reserved tag with hardcoded trellis behavior; the others are opaque user labels. Relying on a worker to run `send --tag <my_signal>` is unreliable — LLM workers commonly write the tag string into prose instead of running the actual CLI command. See `references/command-reference.md` "tag vs kind".
@@ -59,6 +60,7 @@ trellis channel context list <board> --scope global --thread <thread>
 - `references/forum.md` — forum channels, context, title, rename, changelog forums, thread filtering.
 - `references/workers.md` — spawn, agent cards, context injection (`--file` / `--jsonl`), interrupts, kill semantics.
 - `references/subnode-work.md` — bounded independent-evidence subnodes, their task artifacts, coordinator verification, and counterwork.
+- `references/multi-target-dispatch.md` — one-host multi-target procedure, rolling FIFO acceptance, and drain before task selection.
 - `references/progress-debugging.md` — progress/raw inspection, stalled worker diagnosis, OOM guard, exit codes.
 - `references/command-reference.md` — current CLI command reference (every subcommand, every flag, output conventions, scope/type model).
 

package/dist/templates/common/bundled-skills/trellis-channel/references/command-reference.md

@@ -35,7 +35,7 @@ trellis channel create <name>
   [--linked-context-file <abs-path>]      # [deprecated alias]
   [--linked-context-raw  <text>]          # [deprecated alias]
   [--cwd <path>]                          # recorded in create event
-  [--by <agent>]                          # default: main
+  [--by <agent>]                          # default: TRELLIS_CHANNEL_AS or main
   [--owner-session <id>]                  # opaque main Codex session owner
   [--force]                               # overwrite existing channel
   [--ephemeral]                           # hide from default list, prunable
@@ -76,7 +76,7 @@ Behavior:
 
 ```bash
 trellis channel send <name> [text]
-  --as <agent>                            # REQUIRED — author
+  [--as <agent>]                          # default: TRELLIS_CHANNEL_AS or main
   [--scope project|global]
   [--to <agents,csv>]                     # default: broadcast
   [--stdin | --text-file <path>]          # body from stdin or file
@@ -137,17 +137,18 @@ emit the event you intend to wait for, then pass it to `wait --after-seq`.
 
 ```bash
 trellis channel wait <name>
-  --as <agent>                            # REQUIRED — self for filter ctx
+  [--as <agent>]                          # default: TRELLIS_CHANNEL_AS or main
   [--scope project|global]
   [--timeout <Ns|Nm|Nh|Nms>]              # parsed by parseDuration
   [--after-seq <integer>]                 # replay only events after barrier
   [--from <a,b>]                          # author CSV
+  [--workers <a,b>]                       # worker lifecycle CSV, separate mode
   [--kind <k1,k2>]                        # CSV, OR semantics
   [--thread <key>]                        # forum filter
   [--action <thread-action>]              # forum filter
   [--to <target>]                         # default: own agent (broadcast + me)
   [--include-progress]                    # also wake on progress events
-  [--all]                                 # require every --from to match
+  [--all]                                 # require every author or worker to match
 ```
 
 Behavior:
@@ -155,13 +156,20 @@ Behavior:
 - Streams matching events as JSON, one per line.
 - Default `--to` filter is the caller's own agent (broadcast events still
   match — broadcast + explicit-to-me).
-- `--all` requires `--from` and blocks until every listed agent has produced
-  a matching event.
+- `--all` requires `--from` or `--workers` and blocks until every listed target
+  has matched.
+- `--workers` waits for nonterminal-to-terminal worker lifecycle transitions
+  (`done`, `error`, `killed`, `crashed`) after the durable barrier and emits
+  terminal worker JSON with `workerId` and `lastSeq`. Supervisor author aliases
+  are handled by the core projection. Ordinary adapter errors and peer turn
+  completion are not terminal; previously terminal workers are not counted.
+  This mode rejects `--from`, `--kind`, `--to`, `--thread`, `--action` and
+  `--include-progress`. It does not accept a subnode report or disposition.
 - Without `--after-seq`, the command captures its current event sequence before
   constructing its watcher and ignores prior events. With `--after-seq`, it
   replays matching events whose sequence is greater than that supplied barrier.
 - **Timeout exits 124** and prints `timeout: still waiting on ...` to stderr
-  when `--all` was in play.
+  when `--all` or `--workers` was in play.
 
 ### `workers <name>`
 
@@ -246,7 +254,7 @@ trellis channel send T --as A --text-file /tmp/message.md
 
 ```bash
 trellis channel interrupt <name> [text]
-  --as <agent>                            # REQUIRED — caller
+  [--as <agent>]                          # default: TRELLIS_CHANNEL_AS or main
   --to <agent>                            # REQUIRED — target worker
   [--scope project|global]
   [--stdin | --text-file <path>]
@@ -270,6 +278,7 @@ trellis channel spawn <name>
   [--scope project|global]
   [--agent <agent-name>]                  # loads .trellis/agents/<name>.md
   [--provider claude|codex]               # overrides agent file
+  [--profile <id>]                        # subnode Codex profile; implies --agent subnode
   [--as <worker-name>]                    # default: agent name
   [--cwd <path>]
   [--model <id>]
@@ -367,8 +376,7 @@ Behavior:
 trellis channel prune
   [--scope project|global]                # omitted: scan every project
   [--all | --empty | --idle <Ns|Nm|Nh|Nd> | --ephemeral]   # mutually exclusive
-  [--yes]                                 # actually delete (default: dry-run)
-  [--dry-run]                             # default true; redundant with default
+  [--yes]                                 # actually delete; omitted means preview
   [--keep <names,csv>]                    # exclusion list
 ```
 
@@ -389,7 +397,7 @@ Behavior:
 
 ```bash
 trellis channel post <name> <action>
-  --as <agent>                            # REQUIRED
+  [--as <agent>]                          # default: TRELLIS_CHANNEL_AS or main
   [--scope project|global]
   [--thread <key>]                        # required except action=opened
   [--title <text>]
@@ -436,7 +444,7 @@ trellis channel thread <name> <thread-key>
   [--raw]
 
 trellis channel thread rename <name> <old-thread> <new-thread>
-  --as <agent>                            # REQUIRED
+  [--as <agent>]                          # default: TRELLIS_CHANNEL_AS or main
   [--scope project|global]
 ```
 
@@ -455,7 +463,7 @@ Behavior:
 
 ```bash
 trellis channel context add <name>
-  [--as <agent>]                          # default: main
+  [--as <agent>]                          # default: TRELLIS_CHANNEL_AS or main
   [--scope project|global]
   [--thread <key>]                        # thread-level instead of channel-level
   [--file <abs-path>] ...                 # repeatable
@@ -463,7 +471,7 @@ trellis channel context add <name>
                                           # at least one of --file or --raw
 
 trellis channel context delete <name>
-  [--as <agent>]                          # default: main
+  [--as <agent>]                          # default: TRELLIS_CHANNEL_AS or main
   [--scope project|global]
   [--thread <key>]
   [--file <abs-path>] ...
@@ -486,11 +494,11 @@ Behavior:
 ```bash
 trellis channel title set <name>
   --title <text>                          # REQUIRED
-  [--as <agent>]                          # default: main
+  [--as <agent>]                          # default: TRELLIS_CHANNEL_AS or main
   [--scope project|global]
 
 trellis channel title clear <name>
-  [--as <agent>]                          # default: main
+  [--as <agent>]                          # default: TRELLIS_CHANNEL_AS or main
   [--scope project|global]
 ```
 

package/dist/templates/common/bundled-skills/trellis-channel/references/forum.md

@@ -26,8 +26,7 @@ trellis channel create design-feedback \
   --type forum \
   --scope global \
   --description "Cross-project design feedback board." \
-  --context-raw "One thread per design topic; close when resolved." \
-  --by main
+  --context-raw "One thread per design topic; close when resolved."
 ```
 
 Use `--scope project` for a board scoped to one repo, `--scope global` for a
@@ -42,7 +41,6 @@ a thread is `opened`; everything afterwards uses the same `--thread` key.
 ```bash
 trellis channel post design-feedback opened \
   --scope global \
-  --as main \
   --thread login-empty-state \
   --title "Empty state on the login screen" \
   --description "Track design feedback for the new login empty state." \
@@ -58,13 +56,11 @@ trellis channel post design-feedback comment \
 
 trellis channel post design-feedback status \
   --scope global \
-  --as main \
   --thread login-empty-state \
   --status closed
 
 trellis channel post design-feedback summary \
   --scope global \
-  --as main \
   --thread login-empty-state \
   --summary "Adopted the option-B layout; ticket TRELLIS-123 owns the fix."
 ```
@@ -187,12 +183,10 @@ wrong key (typo, wrong slug convention, etc.). Threads do not support hard
 deletion — rename is the supported corrective action.
 
 ```bash
-trellis channel thread rename design-feedback old-key new-key \
-  --scope global \
-  --as main
+trellis channel thread rename design-feedback old-key new-key --scope global
 ```
 
-- `--as <agent>` is **required**.
+- Omit `--as` to use `TRELLIS_CHANNEL_AS` or `main`; pass it only to attribute the rename to another actor.
 - `post <name> rename` is rejected — you must use `thread rename`.
 
 ## Deletion Discipline
@@ -216,12 +210,10 @@ trellis channel create release-notes \
   --type forum \
   --scope global \
   --description "Internal release and runtime changelog." \
-  --context-raw "One thread per notable change; close when shipped." \
-  --by main
+  --context-raw "One thread per notable change; close when shipped."
 
 trellis channel post release-notes opened \
   --scope global \
-  --as main \
   --thread release-2026-q1 \
   --title "Channel threads and forum UX in 0.6" \
   --description "Forum channel UX shipped in the 0.6 line." \

package/dist/templates/common/bundled-skills/trellis-channel/references/multi-target-dispatch.md

@@ -0,0 +1,139 @@
+# Multiple Evidence Units
+
+Use after the user has authorized independent evidence and the task owns a
+reviewed unit mapping. Read `subnode-work.md` for artifact and acceptance rules.
+Codex inline workflows skip native implement/check dispatch and keep ordinary
+implementation/checking in the main session; inline mode does not disable
+explicit Channel evidence. Channel implement/check workers belong to a
+separately selected Channel-driven workflow, not `codex-subnode-channel`.
+Codex Channel workers disable their own native multi-agent features to prevent
+recursive dispatch. Missing independent reports cannot be replaced by
+main-session pass claims.
+
+## Prepare And Dispatch In One Host Call
+
+Choose units by work, complexity, evidence range, and relationship. Combine only
+individually quick/simple and obviously related points with shared context and
+a bounded total workload. Each scope item keeps its own evidence, conclusion,
+unknowns, and stop condition. Neither eight slots nor eight owner domains imply
+eight work packages. Store this mapping in the task's existing plan or matrix.
+
+Read the actual native guard and current workers/reservations. Initially fill
+all available capacity in FIFO order; a justified dependency or resource limit
+belongs in the task record, not an arbitrary coordinator throttle. Initialize
+all reviewed briefs before queue creation or spawning. A failed initialization
+stops admission; preserve/reconcile partial artifacts without dispatching them.
+
+For a configured subnode profile, `spawn --profile <id> --as <worker>` implies
+the subnode role and inherits its Codex provider; do not repeat
+`--agent subnode --provider codex`. Keep each worker ID and `send --to` explicit.
+Read each unit's selected profile/model/effort from its brief and compare the
+durable spawned receipt with that selection; never substitute one fixed profile
+for a mixed-unit batch. Record a mismatch rather than inferring quality from a
+profile name when the effective values are identical.
+Author identity on `send` defaults to `TRELLIS_CHANNEL_AS` or `main`, so routine
+dispatch need not repeat `--as main`.
+
+Coalesce operations that can share one noninteractive host invocation. Use ONE
+native `exec_command` containing a standard-library loop over existing CLI
+commands. Multiple `exec_command` calls inside `functions.exec` still count as
+multiple host calls. This is a procedure, not a new Channel batch API, scheduler,
+or worker-state store. Keep init and dispatch as separate admission stages.
+
+The following runnable pattern consumes a temporary, reviewed JSON array of
+`{"target": "unit-id", "argv": ["trellis", "channel", ...]}` entries. Use
+`[sys.executable, ".trellis/scripts/subnode_artifact.py", ...]` for artifact
+commands. Put claim, spawn, and send in queue order; do not include waits. Review
+each argument vector and the native capacity before executing. The input and
+raw receipts are temporary command data, not task authority; retain only needed
+non-sensitive evidence and clean the temporary input after use.
+
+```bash
+# python on Windows; python3 elsewhere. Execute this whole block in ONE host call.
+python3 - /absolute/path/to/reviewed-actions.json <<'PY'
+import json
+import subprocess
+import sys
+
+actions = json.load(open(sys.argv[1], encoding="utf-8"))
+failed = False
+for action in actions:
+    if failed:
+        print(json.dumps({"target": action["target"], "status": "not_attempted"}))
+        continue
+    argv = [sys.executable if part == "{python}" else part for part in action["argv"]]
+    try:
+        result = subprocess.run(argv, capture_output=True, text=True, check=False)
+        failed = result.returncode != 0
+        receipt = {"target": action["target"], "argv": argv,
+                   "status": "error" if failed else "completed",
+                   "exit_code": result.returncode,
+                   "stdout": result.stdout, "stderr": result.stderr}
+    except OSError as error:
+        failed = True
+        receipt = {"target": action["target"], "argv": argv,
+                   "status": "error", "error": str(error)}
+    print(json.dumps(receipt), flush=True)
+sys.exit(1 if failed else 0)
+PY
+```
+
+The aggregate exit code is not per-target evidence. Inspect every receipt,
+including missing or conflicting receipts; the first error stops later actions
+and stops the remainder of this invocation. Reconcile completed, failed and
+not-attempted targets before further admission; apply the local/global boundary
+below rather than assuming every failure blocks unrelated units. Never replay a
+claim or retry in its old worker conversation. A permitted fresh attempt needs a
+new brief and ID with `retry_of`; old evidence is navigation only and must be
+independently rechecked.
+
+## Rolling FIFO
+
+1. Capture a durable barrier before dispatch. Claim the earliest unclaimed unit,
+   spawn/send through native Channel, and preserve its receipt. The helper
+   enforces claim order; earlier claims need not be accepted to fill initial slots.
+2. Reconcile the complete worker projection with claims and reports first.
+   Process every already-terminal unit, including terminal siblings absent from
+   an old active list. When no live work remains, enter review/closeout directly;
+   zero live workers with an exhausted queue is valid and does not prove a stall.
+   Establish exactly one native waiter for actual live workers without
+   `--all`. Resume only its live host continuation until it returns, times out,
+   or errors; run no other host action meanwhile.
+3. Recheck dispatched items for failures, conflicts, and unresolved terminal
+   states. Still-running healthy workers do not need to finish. Validate the
+   completed worker's per-scope report, recheck sources and protected targets,
+   then write its create-once `accepted` disposition.
+4. That acceptance plus verified native capacity authorizes the next unclaimed
+   FIFO unit immediately, while other healthy workers continue. Preserve the
+   barrier/event cursor so already emitted terminal events cannot be lost.
+5. Local report delivery/validation failures isolate that unit and provide no
+   accepted-slot credit. Other independently accepted units refill FIFO normally;
+   a retry does not reserve an exclusive time interval. Identity, source or
+   protected-target, permission/security and capacity conflicts, missing terminal
+   evidence, conflicting receipts and unresolvable reservations stop global
+   admission. A terminal event alone never authorizes replacement. On recovery,
+   reconstruct claims, events, workers/reservations, reports, and dispositions;
+   never redispatch an old claim or require all healthy live predecessors to
+   complete merely to refill an accepted slot.
+
+A host continuation belongs to the single outstanding wait, not to a new worker
+notification. Resume that continuation only; do not add a waiter, status poll,
+background shell job or progress reaction while it remains live. After a real
+return, process its event cursor and complete projection before choosing refill,
+another authorized wait or closeout. Use diagnostics only for an actual error,
+timeout, conflicting fact or explicit user request.
+
+## Temporary Task Switch
+
+Save the old task's checkpoint. Pause refills and drain ALL already dispatched
+units: wait, validate, and disposition each result, including failures; confirm
+the live continuation, worker, and reservation boundaries are closed. A drain
+does not dispatch pending queue items or turn a failure into acceptance. Do not
+automatically kill, retry, or abandon the old queue. Preserve unclaimed work and
+the old phase. Only after drain, run native `task.py select <new-task>`; it
+changes context without status, branch, after_start hooks, or implementation
+authority. With no in-flight work, select directly after saving the checkpoint.
+
+When returning, reconstruct only the missing old-task facts and resume only
+still-authorized work. Selecting a user-stopped audit never restarts it. Ordinary
+continue and sufficient compaction recovery retain their direct checkpoint path.