v0.5.0-beta.4

​

Bug fixes

• .trellis/workflow.md is now actually updated by trellis update. Critical fix for 0.5 upgrades. workflow.md was explicitly excluded from collectTemplateFiles since early Trellis versions, under the assumption that it’s “user-customizable documentation, written once at init, never touched by update”. That assumption broke in 0.5.0 because workflow.md started carrying script-parsed structure:
  • ## Phase Index — read by get_context.py --mode phase
  • ## Phase 1/2/3 headings — inlined into the 9.5 KB SessionStart payload
  • [workflow-state:STATUS] tag blocks — consumed by the per-turn breadcrumb hook
  Users upgrading from 0.4.x → 0.5 ended up with get_context.py reporting Phase Index section not found in workflow.md and the new /continue command unable to resolve step routing. workflow.md is now included in the normal update flow. Unmodified copies auto-update, user-modified copies go through the existing “Modified by you” confirm prompt with diff. workspace/index.md stays excluded — it’s runtime-appended by add_session.py and has no script-parsed structure.

​

Upgrade path for users stuck on beta.0..beta.3

trellis update --migrate

• If you never edited workflow.md: it auto-updates (shows in “Template updated (will auto-update)” section)
• If you edited workflow.md: you’ll get a Modified by you confirm prompt with diff. Pick [1] Overwrite to get the new 0.5 structure, or pick [3] Skip and merge your edits into the new template manually (the template is at packages/cli/dist/templates/trellis/workflow.md inside the globally installed CLI)