> ## 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` now has default safeguards for resident worker processes.

* 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 workers are not killed by idle cleanup. Explicit `--timeout` remains opt-in.

### Channel message routing

Channel worker routing no longer uses message tags in send, wait, run, and provider adapter internals.

* 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

The Trellis beta bundle now includes `trellis-spec-bootstarp`, a platform-neutral skill for bootstrapping `.trellis/spec/` from the real codebase.

* Replaces the older `cc-codex-spec-bootstrap` marketplace entry
* Works after `trellis init` when the default spec templates still need project-specific content
* Installed automatically with Trellis; no extra marketplace download is needed
* Documented in both beta and release docs so the workflow stays visible when the release bundle is updated

## Bug Fixes

### Task archive auto-commit

`task.py archive` now fails when its auto-commit fails instead of reporting a successful archive with 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` appends `channel.worker_guard` defaults to existing `.trellis/config.yaml` files. No migration command is required.