> ## 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.5.0-beta.6

> 2026-04-20

## Bug 修复

* **Codex `trellis-check` 之前是 read-only，跟它自己的契约对不上。**

  `packages/cli/src/templates/codex/agents/trellis-check.toml` 写的是 `sandbox_mode = "read-only"` + "Read-only Trellis reviewer focused on correctness"。其他平台的 check agent 全都配了 `Read, Write, Edit` 工具，description 明确写 "Reviews code changes against specs **and self-fixes issues**"。`workflow.md` § Phase 2.2 写的也清清楚楚：

  > check agent 的职责：
  >
  > * 按 spec review 代码变更
  > * **自动修复发现的问题**
  > * 跑 lint 和 typecheck 验证

  结果对 Codex 用户来说：`trellis-check` 能报问题但碰不了文件，每个 fix 都得退回主 agent 手动处理。这不是权限小问题——是工作流契约被静默破坏了，workflow 假设 check 是闭环的。

  修复：

  * `sandbox_mode = "workspace-write"`（和 codex 的 `trellis-implement` / `trellis-research` 对齐）
  * 重写 `developer_instructions`，要求直接自修、re-run lint/type-check 到绿、输出 `Findings (fixed)` / `Findings (not fixed)` / `Verification` 报告——行为上和 Claude Code / Cursor 的 check agent 一致。

## 升级

```bash theme={null}
trellis update
```

非 breaking 版本，`update.skip` 正常生效。未修改过 `.codex/agents/trellis-check.toml` 的自动更新；改过的弹标准 `Modified by you` confirm prompt + diff 预览。

安装：`npm install -g @mindfoldhq/trellis@beta`