Skip to main content

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.

​
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

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.