trellis-herbivore 0.1.0

package/dist/migrations/manifests/0.1.9.json

@@ -0,0 +1,30 @@
+{
+  "version": "0.1.9",
+  "description": "Rename deprecated command files",
+  "migrations": [
+    {
+      "type": "rename",
+      "from": ".claude/commands/onboard-developer.md",
+      "to": ".claude/commands/onboard.md",
+      "description": "Shortened onboard-developer to onboard"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/onboard-developer.md",
+      "to": ".cursor/commands/onboard.md",
+      "description": "Shortened onboard-developer to onboard"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/record-agent-flow.md",
+      "to": ".claude/commands/record-session.md",
+      "description": "Renamed record-agent-flow to record-session"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/record-agent-flow.md",
+      "to": ".cursor/commands/record-session.md",
+      "description": "Renamed record-agent-flow to record-session"
+    }
+  ]
+}

package/dist/migrations/manifests/0.2.0.json

@@ -0,0 +1,49 @@
+{
+  "version": "0.2.0",
+  "description": "Comprehensive naming redesign for clarity",
+  "migrations": [
+    {
+      "type": "rename-dir",
+      "from": ".trellis/agent-traces",
+      "to": ".trellis/workspace",
+      "description": "Rename agent-traces to workspace (developer work records)"
+    },
+    {
+      "type": "rename-dir",
+      "from": ".trellis/structure",
+      "to": ".trellis/spec",
+      "description": "Rename structure to spec (development guidelines)"
+    },
+    {
+      "type": "rename-dir",
+      "from": ".trellis/backlog",
+      "to": ".trellis/tasks",
+      "description": "Rename backlog to tasks (unified task tracking)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/feature.sh",
+      "to": ".trellis/scripts/task.sh",
+      "description": "Rename feature.sh to task.sh"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/common/backlog.sh",
+      "to": ".trellis/scripts/common/task-queue.sh",
+      "description": "Rename backlog.sh to task-queue.sh"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/common/feature-utils.sh",
+      "to": ".trellis/scripts/common/task-utils.sh",
+      "description": "Rename feature-utils.sh to task-utils.sh"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/.current-feature",
+      "to": ".trellis/.current-task",
+      "description": "Rename .current-feature to .current-task"
+    }
+  ],
+  "notes": "Complex migrations (features→tasks, traces→journal) require running scripts/migrate-features-to-tasks.sh"
+}

package/dist/migrations/manifests/0.2.12.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.2.12",
+  "description": "Init file conflict handling improvement",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- fix(init): use writeFile for all file copies to allow user choice on conflicts",
+  "migrations": [],
+  "notes": "No migration required."
+}

package/dist/migrations/manifests/0.2.13.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.2.13",
+  "description": "Hotfix release",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "Hotfix release with minor improvements.",
+  "migrations": [],
+  "notes": "No migration required."
+}

package/dist/migrations/manifests/0.2.14.json

@@ -0,0 +1,175 @@
+{
+  "version": "0.2.14",
+  "description": "Command namespace migration + fix incorrect task directory paths in agent docs",
+  "migrations": [
+    {
+      "type": "rename",
+      "from": ".claude/commands/start.md",
+      "to": ".claude/commands/trellis/start.md",
+      "description": "Move Claude start command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/finish-work.md",
+      "to": ".claude/commands/trellis/finish-work.md",
+      "description": "Move Claude finish-work command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/before-frontend-dev.md",
+      "to": ".claude/commands/trellis/before-frontend-dev.md",
+      "description": "Move Claude before-frontend-dev command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/before-backend-dev.md",
+      "to": ".claude/commands/trellis/before-backend-dev.md",
+      "description": "Move Claude before-backend-dev command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/check-frontend.md",
+      "to": ".claude/commands/trellis/check-frontend.md",
+      "description": "Move Claude check-frontend command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/check-backend.md",
+      "to": ".claude/commands/trellis/check-backend.md",
+      "description": "Move Claude check-backend command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/check-cross-layer.md",
+      "to": ".claude/commands/trellis/check-cross-layer.md",
+      "description": "Move Claude check-cross-layer command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/record-session.md",
+      "to": ".claude/commands/trellis/record-session.md",
+      "description": "Move Claude record-session command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/update-spec.md",
+      "to": ".claude/commands/trellis/update-spec.md",
+      "description": "Move Claude update-spec command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/onboard.md",
+      "to": ".claude/commands/trellis/onboard.md",
+      "description": "Move Claude onboard command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/break-loop.md",
+      "to": ".claude/commands/trellis/break-loop.md",
+      "description": "Move Claude break-loop command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/integrate-skill.md",
+      "to": ".claude/commands/trellis/integrate-skill.md",
+      "description": "Move Claude integrate-skill command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/create-command.md",
+      "to": ".claude/commands/trellis/create-command.md",
+      "description": "Move Claude create-command command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/parallel.md",
+      "to": ".claude/commands/trellis/parallel.md",
+      "description": "Move Claude parallel command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/start.md",
+      "to": ".cursor/commands/trellis-start.md",
+      "description": "Rename Cursor start command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/finish-work.md",
+      "to": ".cursor/commands/trellis-finish-work.md",
+      "description": "Rename Cursor finish-work command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/before-frontend-dev.md",
+      "to": ".cursor/commands/trellis-before-frontend-dev.md",
+      "description": "Rename Cursor before-frontend-dev command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/before-backend-dev.md",
+      "to": ".cursor/commands/trellis-before-backend-dev.md",
+      "description": "Rename Cursor before-backend-dev command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/check-frontend.md",
+      "to": ".cursor/commands/trellis-check-frontend.md",
+      "description": "Rename Cursor check-frontend command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/check-backend.md",
+      "to": ".cursor/commands/trellis-check-backend.md",
+      "description": "Rename Cursor check-backend command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/check-cross-layer.md",
+      "to": ".cursor/commands/trellis-check-cross-layer.md",
+      "description": "Rename Cursor check-cross-layer command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/record-session.md",
+      "to": ".cursor/commands/trellis-record-session.md",
+      "description": "Rename Cursor record-session command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/update-spec.md",
+      "to": ".cursor/commands/trellis-update-spec.md",
+      "description": "Rename Cursor update-spec command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/onboard.md",
+      "to": ".cursor/commands/trellis-onboard.md",
+      "description": "Rename Cursor onboard command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/break-loop.md",
+      "to": ".cursor/commands/trellis-break-loop.md",
+      "description": "Rename Cursor break-loop command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/integrate-skill.md",
+      "to": ".cursor/commands/trellis-integrate-skill.md",
+      "description": "Rename Cursor integrate-skill command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/create-command.md",
+      "to": ".cursor/commands/trellis-create-command.md",
+      "description": "Rename Cursor create-command command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/parallel.md",
+      "to": ".cursor/commands/trellis-parallel.md",
+      "description": "Rename Cursor parallel command with trellis- prefix"
+    }
+  ],
+  "notes": "This release includes: (1) Command namespace migration - Claude Code uses subdirectory (.claude/commands/trellis/), Cursor uses filename prefix (.cursor/commands/trellis-*); (2) Bug fix for incorrect task directory paths in agent docs - these files will be updated via normal template sync"
+}

package/dist/migrations/manifests/0.2.15.json

@@ -0,0 +1,33 @@
+{
+  "version": "0.2.15",
+  "description": "Fix task directory paths, base_branch auto-detection, and migration bug",
+  "migrations": [],
+  "changelog": [
+    {
+      "type": "fix",
+      "scope": "agents",
+      "description": "Correct task directory path in dispatch.md and plan.md (was .trellis/workspace/{dev}/tasks/, now .trellis/tasks/)"
+    },
+    {
+      "type": "fix",
+      "scope": "scripts",
+      "description": "Remove hardcoded 'taosu' in status.sh help example"
+    },
+    {
+      "type": "fix",
+      "scope": "task",
+      "description": "Auto-record current branch as base_branch when creating task, so PR targets correct branch"
+    },
+    {
+      "type": "fix",
+      "scope": "update",
+      "description": "Remove unsupported 'update' migration type that caused 'path argument undefined' error"
+    },
+    {
+      "type": "feat",
+      "scope": "task",
+      "description": "Add set-base-branch command to manually override PR target branch"
+    }
+  ],
+  "notes": "Key fix: When user creates a task on branch A, base_branch is now automatically set to A. Worktree creates feature branch based on A, and PR will target A."
+}

package/dist/migrations/manifests/0.3.0-beta.0.json

@@ -0,0 +1,297 @@
+{
+  "version": "0.3.0-beta.0",
+  "description": "Command path namespace migration + Shell to Python script migration",
+  "breaking": true,
+  "recommendMigrate": true,
+  "changelog": "BREAKING: All shell scripts (.sh) have been replaced by Python scripts (.py). Requires Python 3.10+. The multi-agent/ directory is now multi_agent/ (underscore). Run with --migrate to archive legacy shell scripts to scripts-shell-archive/.",
+  "migrationGuide": "# Migration Guide: v0.3.0 Shell to Python\n\n## Overview\n\nAll shell scripts (.sh) have been replaced by Python scripts (.py). This affects any custom workflows, slash commands, or documentation that references the old scripts.\n\n## Requirements\n\n- Python 3.10 or higher\n\n## What Changed\n\n### Script Extensions\n\n| Old Path | New Path |\n|----------|----------|\n| `.trellis/scripts/*.sh` | `.trellis/scripts/*.py` |\n| `.trellis/scripts/common/*.sh` | `.trellis/scripts/common/*.py` |\n| `.trellis/scripts/multi-agent/*.sh` | `.trellis/scripts/multi_agent/*.py` |\n\n### Directory Rename\n\n| Old | New |\n|-----|-----|\n| `multi-agent/` (hyphen) | `multi_agent/` (underscore) |\n\n### Invocation Change\n\n| Old | New |\n|-----|-----|\n| `./script.sh` | `python3 ./script.py` |\n| `./.trellis/scripts/task.sh` | `python3 ./.trellis/scripts/task.py` |\n\n## Files to Check\n\nSearch your project for these patterns and update them:\n\n```bash\n# Find files with old .sh references\ngrep -r '\\.trellis/scripts.*\\.sh' .claude/ .cursor/ .trellis/\n\n# Find files with old multi-agent directory\ngrep -r 'multi-agent/' .claude/ .cursor/ .trellis/\n```\n\n## Common Replacements\n\n```\n# Task management\n./.trellis/scripts/task.sh → python3 ./.trellis/scripts/task.py\n\n# Context\n./.trellis/scripts/get-context.sh → python3 ./.trellis/scripts/get_context.py\n\n# Developer\n./.trellis/scripts/get-developer.sh → python3 ./.trellis/scripts/get_developer.py\n./.trellis/scripts/init-developer.sh → python3 ./.trellis/scripts/init_developer.py\n\n# Session\n./.trellis/scripts/add-session.sh → python3 ./.trellis/scripts/add_session.py\n\n# Multi-agent\n./.trellis/scripts/multi-agent/start.sh → python3 ./.trellis/scripts/multi_agent/start.py\n./.trellis/scripts/multi-agent/status.sh → python3 ./.trellis/scripts/multi_agent/status.py\n./.trellis/scripts/multi-agent/plan.sh → python3 ./.trellis/scripts/multi_agent/plan.py\n./.trellis/scripts/multi-agent/cleanup.sh → python3 ./.trellis/scripts/multi_agent/cleanup.py\n./.trellis/scripts/multi-agent/create-pr.sh → python3 ./.trellis/scripts/multi_agent/create_pr.py\n```\n\n## After Migration\n\nRun `trellis update --migrate` to archive the old shell scripts to `.trellis/scripts-shell-archive/`.",
+  "aiInstructions": "1. Search for files containing old patterns:\n   - `.trellis/scripts/*.sh` references\n   - `multi-agent/` directory references (should be `multi_agent/`)\n   - `python script.py` without `python3` (Windows compatibility)\n2. For each file found, apply the replacements from the migration guide\n3. IMPORTANT: Always use `python3` explicitly, not just `python` or relying on shebang (Windows doesn't support shebang)\n4. Check ALL locations: docstrings, help text, error messages, markdown docs\n5. Verify the changes compile/work correctly\n6. After all files are updated, remind user to run `trellis update --migrate`",
+  "migrations": [
+    {
+      "type": "rename",
+      "from": ".claude/commands/start.md",
+      "to": ".claude/commands/trellis/start.md",
+      "description": "Move Claude start command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/finish-work.md",
+      "to": ".claude/commands/trellis/finish-work.md",
+      "description": "Move Claude finish-work command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/before-frontend-dev.md",
+      "to": ".claude/commands/trellis/before-frontend-dev.md",
+      "description": "Move Claude before-frontend-dev command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/before-backend-dev.md",
+      "to": ".claude/commands/trellis/before-backend-dev.md",
+      "description": "Move Claude before-backend-dev command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/check-frontend.md",
+      "to": ".claude/commands/trellis/check-frontend.md",
+      "description": "Move Claude check-frontend command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/check-backend.md",
+      "to": ".claude/commands/trellis/check-backend.md",
+      "description": "Move Claude check-backend command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/check-cross-layer.md",
+      "to": ".claude/commands/trellis/check-cross-layer.md",
+      "description": "Move Claude check-cross-layer command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/record-session.md",
+      "to": ".claude/commands/trellis/record-session.md",
+      "description": "Move Claude record-session command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/update-spec.md",
+      "to": ".claude/commands/trellis/update-spec.md",
+      "description": "Move Claude update-spec command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/onboard.md",
+      "to": ".claude/commands/trellis/onboard.md",
+      "description": "Move Claude onboard command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/break-loop.md",
+      "to": ".claude/commands/trellis/break-loop.md",
+      "description": "Move Claude break-loop command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/integrate-skill.md",
+      "to": ".claude/commands/trellis/integrate-skill.md",
+      "description": "Move Claude integrate-skill command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/create-command.md",
+      "to": ".claude/commands/trellis/create-command.md",
+      "description": "Move Claude create-command command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".claude/commands/parallel.md",
+      "to": ".claude/commands/trellis/parallel.md",
+      "description": "Move Claude parallel command to trellis/ subdirectory"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/start.md",
+      "to": ".cursor/commands/trellis-start.md",
+      "description": "Rename Cursor start command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/finish-work.md",
+      "to": ".cursor/commands/trellis-finish-work.md",
+      "description": "Rename Cursor finish-work command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/before-frontend-dev.md",
+      "to": ".cursor/commands/trellis-before-frontend-dev.md",
+      "description": "Rename Cursor before-frontend-dev command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/before-backend-dev.md",
+      "to": ".cursor/commands/trellis-before-backend-dev.md",
+      "description": "Rename Cursor before-backend-dev command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/check-frontend.md",
+      "to": ".cursor/commands/trellis-check-frontend.md",
+      "description": "Rename Cursor check-frontend command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/check-backend.md",
+      "to": ".cursor/commands/trellis-check-backend.md",
+      "description": "Rename Cursor check-backend command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/check-cross-layer.md",
+      "to": ".cursor/commands/trellis-check-cross-layer.md",
+      "description": "Rename Cursor check-cross-layer command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/record-session.md",
+      "to": ".cursor/commands/trellis-record-session.md",
+      "description": "Rename Cursor record-session command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/update-spec.md",
+      "to": ".cursor/commands/trellis-update-spec.md",
+      "description": "Rename Cursor update-spec command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/onboard.md",
+      "to": ".cursor/commands/trellis-onboard.md",
+      "description": "Rename Cursor onboard command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/break-loop.md",
+      "to": ".cursor/commands/trellis-break-loop.md",
+      "description": "Rename Cursor break-loop command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/integrate-skill.md",
+      "to": ".cursor/commands/trellis-integrate-skill.md",
+      "description": "Rename Cursor integrate-skill command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/create-command.md",
+      "to": ".cursor/commands/trellis-create-command.md",
+      "description": "Rename Cursor create-command command with trellis- prefix"
+    },
+    {
+      "type": "rename",
+      "from": ".cursor/commands/parallel.md",
+      "to": ".cursor/commands/trellis-parallel.md",
+      "description": "Rename Cursor parallel command with trellis- prefix"
+    },
+
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/get-developer.sh",
+      "to": ".trellis/scripts-shell-archive/get-developer.sh",
+      "description": "Archive legacy shell script (replaced by Python)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/init-developer.sh",
+      "to": ".trellis/scripts-shell-archive/init-developer.sh",
+      "description": "Archive legacy shell script (replaced by Python)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/get-context.sh",
+      "to": ".trellis/scripts-shell-archive/get-context.sh",
+      "description": "Archive legacy shell script (replaced by Python)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/task.sh",
+      "to": ".trellis/scripts-shell-archive/task.sh",
+      "description": "Archive legacy shell script (replaced by Python)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/add-session.sh",
+      "to": ".trellis/scripts-shell-archive/add-session.sh",
+      "description": "Archive legacy shell script (replaced by Python)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/create-bootstrap.sh",
+      "to": ".trellis/scripts-shell-archive/create-bootstrap.sh",
+      "description": "Archive legacy shell script (replaced by Python)"
+    },
+
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/common/paths.sh",
+      "to": ".trellis/scripts-shell-archive/common/paths.sh",
+      "description": "Archive legacy shell script (replaced by Python)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/common/developer.sh",
+      "to": ".trellis/scripts-shell-archive/common/developer.sh",
+      "description": "Archive legacy shell script (replaced by Python)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/common/git-context.sh",
+      "to": ".trellis/scripts-shell-archive/common/git-context.sh",
+      "description": "Archive legacy shell script (replaced by Python)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/common/worktree.sh",
+      "to": ".trellis/scripts-shell-archive/common/worktree.sh",
+      "description": "Archive legacy shell script (replaced by Python)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/common/task-queue.sh",
+      "to": ".trellis/scripts-shell-archive/common/task-queue.sh",
+      "description": "Archive legacy shell script (replaced by Python)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/common/task-utils.sh",
+      "to": ".trellis/scripts-shell-archive/common/task-utils.sh",
+      "description": "Archive legacy shell script (replaced by Python)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/common/phase.sh",
+      "to": ".trellis/scripts-shell-archive/common/phase.sh",
+      "description": "Archive legacy shell script (replaced by Python)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/common/registry.sh",
+      "to": ".trellis/scripts-shell-archive/common/registry.sh",
+      "description": "Archive legacy shell script (replaced by Python)"
+    },
+
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/multi-agent/start.sh",
+      "to": ".trellis/scripts-shell-archive/multi-agent/start.sh",
+      "description": "Archive legacy shell script (replaced by Python in multi_agent/)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/multi-agent/plan.sh",
+      "to": ".trellis/scripts-shell-archive/multi-agent/plan.sh",
+      "description": "Archive legacy shell script (replaced by Python in multi_agent/)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/multi-agent/status.sh",
+      "to": ".trellis/scripts-shell-archive/multi-agent/status.sh",
+      "description": "Archive legacy shell script (replaced by Python in multi_agent/)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/multi-agent/create-pr.sh",
+      "to": ".trellis/scripts-shell-archive/multi-agent/create-pr.sh",
+      "description": "Archive legacy shell script (replaced by Python in multi_agent/)"
+    },
+    {
+      "type": "rename",
+      "from": ".trellis/scripts/multi-agent/cleanup.sh",
+      "to": ".trellis/scripts-shell-archive/multi-agent/cleanup.sh",
+      "description": "Archive legacy shell script (replaced by Python in multi_agent/)"
+    }
+  ],
+  "notes": "Part 1: Command namespace migration - Claude Code uses subdirectory namespacing (.claude/commands/trellis/), Cursor uses filename prefix (.cursor/commands/trellis-*). Part 2: Shell to Python migration - All .trellis/scripts/*.sh files are archived to .trellis/scripts-shell-archive/ (not deleted). The multi-agent/ directory (with hyphen) is replaced by multi_agent/ (with underscore). Empty source directories are automatically cleaned up after rename."
+}

package/dist/migrations/manifests/0.3.0-beta.1.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-beta.1",
+  "description": "Breaking change warning UX improvement",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- fix(update): re-show breaking change warning before confirm prompt",
+  "migrations": [],
+  "notes": "No migration required."
+}

package/dist/migrations/manifests/0.3.0-beta.10.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-beta.10",
+  "description": "Windows UTF-8 encoding fix",
+  "breaking": false,
+  "recommendMigrate": true,
+  "changelog": "Fixed Windows encoding issues:\n\n**Bug Fix:**\n- Fixed `UnicodeEncodeError: 'gbk' codec can't encode character` on Windows\n- Fixed `SyntaxWarning` corrupting hook JSON output on Python 3.12+\n\n**Root Cause:**\n- Windows console defaults to GBK encoding, fails on Chinese characters in git commits/task names\n- Python 3.12+ warns on invalid escape sequences, stderr corrupts hook output\n\n**Files Fixed:**\n- All hooks: session-start.py, inject-subagent-context.py, ralph-loop.py\n- All scripts: git_context.py, task.py, add_session.py\n\n**Technical Details:**\n- Added `# -*- coding: utf-8 -*-` encoding declaration\n- Force stdout to UTF-8 on Windows using `io.TextIOWrapper`\n- Suppress Python warnings with `warnings.filterwarnings(\"ignore\")`",
+  "migrations": [],
+  "notes": "Bug fix for Windows users. Strongly recommended to upgrade."
+}

package/dist/migrations/manifests/0.3.0-beta.11.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-beta.11",
+  "description": "Windows UTF-8 encoding support",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Bug Fixes:**\n- fix(hooks): add Windows UTF-8 encoding support",
+  "migrations": [],
+  "notes": "No migration required."
+}

package/dist/migrations/manifests/0.3.0-beta.12.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.3.0-beta.12",
+  "description": "Windows compatibility & multi-model support improvements",
+  "breaking": false,
+  "recommendMigrate": true,
+  "changelog": "**Bug Fixes:**\n\n1. **Windows Hook JSON Parse Error** (b282b14)\n   - Fixed `Unexpected end of string` error when parsing hook output\n   - Replaced backslash characters (`\\--`, `\\->`) in markdown templates\n   - These caused JSON serialization issues on Windows\n\n2. **Cross-Platform Script Paths** (19f8a68)\n   - Fixed `python3` command not found on Windows\n   - Scripts now use platform-specific command paths via cli_adapter\n\n3. **Multi-Agent GPT/Codex Compatibility** (14bfbe9)\n   - Fixed dispatch agent getting stuck with \"Start the pipeline\" prompt\n   - GPT/Codex models were misinterpreting \"pipeline\" as CI/CD\n   - New prompt explicitly guides models to follow agent instructions\n\n**Known Issue:**\n- Windows users may still experience hook failures due to Claude Code bug (#18469)\n- Workaround: Use `cmd.exe /c python ...` in hook command",
+  "migrations": [],
+  "notes": "Recommended for Windows users and those using GPT/Codex models with multi-agent pipeline."
+}