Skip to main content
v0.5.0-rc.0 是 0.5.0 发布前的候选版本。本版本聚焦发布稳定化:非交互 init 恢复、workflow breadcrumb 从 workflow.md 读取、workflow.md breadcrumb 自动更新,以及内置 trellis-meta 参考文档同步。

Enhancements

Workflow breadcrumbs

每轮提示 AI 当前该走哪一步的 workflow breadcrumb,现在从 .trellis/workflow.md[workflow-state:STATUS] block 读取。 解析器和移除逻辑都要求 tag 成对匹配:

workflow.md breadcrumb 自动更新

trellis update 现在会自动更新 .trellis/workflow.md 里的 [workflow-state:*] block。它们是 hook 用来提示 AI 下一步做什么的文本;普通说明文字仍然按用户自己的版本保留。 实现位于 buildWorkflowMdTemplatepackages/cli/src/commands/update.ts)。

task.py create 后设置 session active task

task.py create 现在会 best-effort 设置 session active-task pointer。创建任务后,planning breadcrumb 可以立刻出现,AI 会看到 Phase 1.1 到 Phase 1.4 的 guidance,而不是落回 no-task 路径。 trellis continue 也改为按 task.json.status 加必需 artifact 路由,包含 prd.md 和 jsonl context 就绪后的 Phase 1.4 activation 分支。

内置 trellis-meta 参考文档

内置 trellis-meta skill 的参考页面现在统一描述 workflow-state 如何读取 workflow.md

Bug Fixes

非交互 trellis init --yes

trellis init --yes 在文件已存在时也保持非交互。 --force 仍然覆盖已有文件。--yes 默认保留已有文件。

首次 init 中断后的恢复

如果之前的 init 已写入 .trellis/,但在创建任何 task 之前中断,重新运行 init 现在会创建 bootstrap task,而不是误走 joiner onboarding。 empty-tasks/ early check 会绕过 handleReinit,随后由 main dispatch 的 bootstrap fallback 接管。

Testing

Init recovery coverage

init 测试现在覆盖:

Workflow-state coverage

回归测试现在守住这些 invariant:

Upgrade

安装 RC:
已有 0.5 beta 项目:
从 0.4.x 升级的项目:
0.5.0-rc.0 不新增迁移条目,但 0.4.x 项目仍需执行从 0.5.0-beta.0 开始的 0.5 迁移链。