跳转到主要内容

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 现在对 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

npm install -g @mindfoldhq/trellis@beta
trellis update
trellis update 会把 channel.worker_guard defaults 追加到已有 .trellis/config.yaml。不需要运行 migration command。