{
  "version": "0.5.0",
  "description": "v0.5.0 stable — skill-first architecture, 7 platforms agent-capable, workflow.md as single source of truth. Stable promotion of rc.6 with no new src/ changes.",
  "breaking": false,
  "recommendMigrate": true,
  "changelog": "**v0.5.0 stable.** Stable promotion of rc.6 — no new src/ changes since rc.6.\n\n**Heads-up:** `/start` is no longer a required entry point. Just describe what you want in natural language and you're in the Trellis workflow. `/continue <what you want to do>` works as an explicit kickoff. If you'd rather manually start a session before chatting, `/trellis:continue` now serves as the kickoff command in place of `/start`.\n\nCycle headlines since 0.4.0:\n\n**Codex notes**\n- _Addressed (rc.5):_ `multi_agent_v2` default-on. `.codex/config.toml` template writes the feature block; `min_wait_timeout_ms = 480000` (8 min) `wait()` floor stops parent busy-polling subagent status. Requires Codex CLI ≥ v0.128.0; older Codex fails with `untagged enum FeatureToml in features.multi_agent_v2`.\n- _Upstream (#191):_ Codex prints SessionStart hook context to the terminal on every turn. No toggle to suppress it for now (the Codex desktop app avoids this).\n- _Upstream:_ sub-agent startup can hang on a slow / failing MCP server. Present since Codex `multi_agent_v1`, still in `v2`.\n\n**Architecture**\n- Skill-first templates: 5 commands → auto-triggered skills (`before-dev` / `brainstorm` / `break-loop` / `check` / `update-spec`). Commands + skills consolidated to `packages/cli/src/templates/common/` (single source — drift across N platform copies eliminated).\n- `workflow.md` is the single source of truth: Phase definitions, skill routing, per-turn breadcrumb content, task.py 16-subcommand reference. Fork the workflow = edit one markdown file.\n- New `/continue` command: intra-task continue. Eliminates the user's need to learn the workflow — natural language enters Trellis, then a single `continue` at each handoff drives brainstorm → curate jsonl → implement+check → update-spec → commit+finish-work. Mechanism: routes by `task.json.status` + artifacts (prd.md, implement.jsonl curation) to the matching Phase step.\n\n**Multi-task & onboarding**\n- Session-scoped active-task pointer: moved from global `.trellis/.current-task` to per-session `.trellis/.runtime/sessions/<context-key>.json`. Parallel windows no longer stomp each other's active task. Bootstrap / joiner tasks skip the pointer. Per-platform session-key sources: Claude `CLAUDE_ENV_FILE`, Codex `CODEX_SESSION_ID` / `CODEX_THREAD_ID`, Cursor `beforeShellExecution` tickets, OpenCode Bash prefix, Pi nested injection.\n- Joiner onboarding: `trellis init` three-way dispatch on `.trellis/` × `.trellis/.developer` (gitignored). New `00-join-<slug>` task fires when a developer clones an existing Trellis project. Bootstrap + joiner PRDs rewritten as AI-facing instructions (runtime mechanics + suggested opening line) instead of user-facing welcome docs.\n\n**Platform coverage**\n- 7 platforms upgraded to agent-capable: Qoder, CodeBuddy, Factory Droid, Cursor, Gemini CLI, Kiro, GitHub Copilot.\n- Sub-agent context injection split: class-1 hook (Claude / Cursor / OpenCode / Kiro / CodeBuddy / Droid) vs class-2 pull-based prelude (Codex / Copilot / Gemini / Qoder).\n- `inject-workflow-state.py` per-turn breadcrumb hook injects `<workflow-state>` block keyed on `task.json.status`. iFlow platform dropped.\n\n**SessionStart payload**\n- 2.7 KB → 9.5 KB: Phase 1/2/3 step bodies inlined. `<guidelines>` shrunk 10.9 KB → 4.6 KB (paths-only for spec layer indexes). Total payload 16.7 KB, under Claude Code's ~20 KB truncate threshold.\n\n**Migration & update flow**\n- Breaking-change gate: `trellis update` exits 1 when traversing a breaking manifest, requires `--migrate` (was: silent partial migration).\n- `config.yaml` `update.skip` auto-bypass on breaking releases for `safe-file-delete` / new-file writes / template updates (was: half-migrated state).\n- Confirm prompt redesigned: shows `What` (migration action) + `Why prompted` (per-entry `reason`) + per-option recommendation.\n- Backup excludes `.claude/worktrees/` / `.cursor/worktrees/` / `.gemini/worktrees/` (avoids hundreds-of-MB bloat).\n\n**Cleanup (138-entry safe-file-delete, hash-verified)**\n- Removed: iFlow platform, multi-agent pipeline (`scripts/multi_agent/`, `worktree.yaml`), Ralph Loop hook (`ralph-loop.py`).\n- Retired: 6 commands (`parallel` / `onboard` / `create-command` / `integrate-skill` / `check-cross-layer` / `record-session`), 3 sub-agents (`dispatch` / `debug` / `plan`).\n- `record-session` merged into `finish-work` Step 3.\n\n**RC stabilization (rc.0 → rc.6)**\n- `trellis uninstall` command (rc.2)\n- `TRELLIS_HOOKS` env var for runtime disable (rc.4)\n- Codex `multi_agent_v2` default-on, 8-min wait floor (rc.5)\n- Windows session-start.py normalizes MSYS/Cygwin/WSL paths (rc.6, fixes #226)\n- `finish-work` Step 2 classifies dirty paths instead of aborting (rc.6)\n- Gemini CLI 0.40.x template compat (rc.3); OpenCode 1.2.x loader fix (rc.1); Copilot custom-agent frontmatter normalization (rc.2); Windows `python3` → `python` write replacement (rc.2).",
  "migrations": [],
  "notes": "**Stable release.** Promoted from rc.6 with no new src/ changes. \n\nUsers on 0.4.x: run `trellis update --migrate` (the `--migrate` flag is REQUIRED — the breaking-change gate from `0.5.0-beta.0` fires when traversing the migration chain). 138-entry safe-file-delete is hash-verified; local customizations are preserved with a warning. \n\nCodex users: Codex CLI ≥ v0.128.0 required for the `multi_agent_v2` config block. Two upstream Codex issues remain: hook context renders in terminal every turn (#191; Codex desktop app avoids this), and sub-agent startup can hang on a slow/failing MCP server. \n\nUsers on any 0.5.0 prerelease (beta.X / rc.X): plain `trellis update` works as a clean version bump. \n\nInstall: `npm install -g @mindfoldhq/trellis`"
}