v0.5.0-rc.5 - Trellis Doc

Codex 模板默认开启 multi_agent_v2，wait 超时下限 8 分钟。AGENTS.md 加上 wait 工具规则。无新增 migration。

Enhancements

Codex `multi_agent_v2` 默认开启

.codex/config.toml 从注释指引改为直接写入生效配置：

[features.multi_agent_v2]
enabled = true
max_concurrent_threads_per_session = 6
min_wait_timeout_ms = 480000

字段	值	说明
`enabled`	`true`	表内必填——只写表不带这一行不会启用 feature
`max_concurrent_threads_per_session`	`6`	原值 `4`
`min_wait_timeout_ms`	`480000`（8 分钟）	`wait()` 超时下限。原值 `10000`（10 秒）。强制父 agent 等子 agent 跑完

项目级 [features] 只在项目被 trusted 时激活。在 ~/.codex/config.toml 加：

[projects."/abs/path/to/your/repo"]
trust_level = "trusted"

删掉 legacy `codex_hooks = true`

CodexHooks 在 Codex feature registry 里现在是 Stage::Stable 且 default_enabled: true——只要项目 trusted，hooks.json 自动加载。模板里之前的 [features].codex_hooks = true 是冗余的，已删除。

`AGENTS.md` subagent wait 规则

Subagents 段点名 Codex 的 wait 工具，禁止在子 agent 跑完前 cancel：

等子 agent 进入终态再让出 / 处理结果 / 派发下一个。Codex 上调 wait 传 thread id。
子 agent 未完成时不要 cancel 或 re-spawn。觉得卡住先抬 timeout（默认 30 秒，上限 1 小时）再判断。

Upgrade

npm install -g @mindfoldhq/trellis@rc
trellis update