> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trytrellis.app/llms.txt
> Use this file to discover all available pages before exploring further.

# v0.6.0-beta.18

> 2026-05-17

## Enhancements

### Channel worker OOM guard

`trellis channel spawn` 现在对 resident worker 进程有默认保护。

* Idle cleanup: `channel.worker_guard.idle_timeout`, default `5m`
* Live-worker budget: `channel.worker_guard.max_live_workers`, default `6`
* Spawn flags: `--idle-timeout <duration>`, `--max-live-workers <n>`
* Env overrides: `TRELLIS_CHANNEL_WORKER_IDLE_TIMEOUT`, `TRELLIS_CHANNEL_MAX_LIVE_WORKERS`
* Idle terminal event: `killed` with `reason: "idle-timeout"`
* Core projection: `WorkerState.idleSince`

Mid-turn worker 不会被 idle cleanup 杀掉。显式 `--timeout` 仍然是 opt-in。

### Channel message routing

Channel worker routing 不再在 send、wait、run 和 provider adapter internals 中使用 message tags。

* Removed send tag plumbing from `send.ts`
* Removed wait tag filtering from `wait.ts`
* Kept routing on channel events, worker inbox policy, and explicit `to`
* Added interrupt-specific adapter encoding in `interrupt.ts` and supervisor inbox flow

### Trellis spec bootstrap skill

Trellis beta bundle 现在包含 `trellis-spec-bootstarp`，用于让 AI 从真实代码库引导生成 `.trellis/spec/`。

* 替代旧的 `cc-codex-spec-bootstrap` marketplace 条目
* 适合在 `trellis init` 后，把默认 spec 模板填成项目专属内容
* 随 Trellis 自动安装，不需要再从 marketplace 单独下载
* beta 和 release 文档都会讲这条流程，方便 release bundle 补上对应 skill 后直接复用

## Bug Fixes

### Task archive auto-commit

`task.py archive` 现在会在 auto-commit 失败时失败，而不是报告 archive 成功但留下 dirty task files。

* Template file: `scripts/common/task_store.py`
* Covered path: archive move followed by failed `git commit`
* User-visible behavior: archive failure exits non-zero and leaves the problem visible

## Upgrade

```bash theme={null}
npm install -g @mindfoldhq/trellis@beta
trellis update
```

`trellis update` 会把 `channel.worker_guard` defaults 追加到已有 `.trellis/config.yaml`。不需要运行 migration command。