Repository navigation
v2.1.0
Release Notes ( v2.1.0 )
Features
Custom Prompts
- Plan Generation and Subtask Generation prompts are now user-editable in Settings.
- New prompt loader with placeholder replacement (
{{task.title}},{{task.description}}, etc.). - Default templates and system suffixes are defined in
src/lib/prompts/defaults.ts. - API route
GET/POST /api/promptsfor persisting custom prompts. - Settings page includes a "Custom Prompts" tab with editors for both prompt types.
Themes
- Three new themes: Retro, Ocean, Forest, Sunset (in addition to Dark and Light).
- WCAG contrast validation for theme color pairs.
- Theme integration tests and visual audit in e2e.
- Theme switcher in the sidebar for quick switching.
Kanban Workflow Restrictions
- Drag-and-drop restrictions on task cards:
- Cannot move from AI Review → In Progress
- Cannot move from Done → AI Review or In Progress
- Cannot move from Human Review → AI Review or In Progress
- In Progress and AI Review are treated as one-way states; use Planning/Replanning to redo work.
- Restrictions enforced in both the UI and the API (
PATCH /api/tasks/update).
Packaged App (DMG) Support
- Environment enhancement for packaged apps: PATH and env vars (
CURSOR_API_KEY,AMP_API_KEY) are loaded from the user's login shell. - Port range: If port 3000 is busy, the app tries 3001–3009 (extended to 3000–3049 in dev script).
NEXT_PUBLIC_APP_URLset before starting the Next.js server so internal callbacks hit the correct port.- New
docs/PACKAGED_APP.mddocuments packaged app considerations and checklist.
Kanban UX Improvements
- Task card messaging: More specific status messages during planning:
- "🤖 Generating questions..." when generating questions
- "🤖 Generating plan..." when generating plan
- "🤖 Generating subtasks..." when plan is approved and subtasks are being generated
- Auto-start AI Review: Dragging a task to "AI Review" automatically triggers the review agent when QA subtasks exist.
- Human Review modal: Separate loading states for Create MR, Open in Cursor, and Move to Done buttons (no more shared "Creating..." / "Opening..." on multiple buttons).
QA Subtask Handling
- Manual QA subtasks: Agents now write a single concise
.mdfile tomanual-qa-required/<subtask-id>.mdfor QA subtasks that require manual verification. - New
qa-subtask-prompt.tswithisManualQASubtaskandbuildQASubtaskPrompt. - Guideline in subtask generation: include "manual" in label/content for QA subtasks that need human verification.
Planning Artifacts Cleanup
- Planning artifacts (
implementation-plan.json,planning-questions.json) are cleaned from worktrees at transition points. - Cleanup runs after plan generation, before development, before AI review, before human review, and in related routes.
Bug Fixes
- Tailwind ESM:
tailwind.config.tsupdated to use ESMimportinstead of CommonJSrequirefortailwindcss-animate. - Port handling:
scripts/dev.jsextends port range to 3000–3049 and shows a clearer error when ports are in use. - Custom Prompts UI: "Reset to Default" and "Save" buttons in Settings use correct theme styling.
- Retry AI Review button:
task.updatedAtis set when transitioning to AI Review so the 15-second grace period for "Auto-starting QA…" works correctly. - Edit Task modal: Improved handling for blocked tasks and planning restart.
Documentation
- KANBAN_WORKFLOW.md: Step-by-step Kanban workflow guide with screenshots (00–12).
- PACKAGED_APP.md: Packaged app considerations, env handling, and feature checklist.
- README.md: Logo links to demo video; Release Assets section; links to new docs.
Infrastructure & DevEx
- Vitest: Unit tests for theme config and theme store.
- E2E: Theme integration and visual tests.
- Loading screen:
public/loading.htmlfor app startup. - Coming Soon: Placeholder pages for Agents, Tasks, GitHub, Worktrees, Memory.
File Summary
| Category | Files Changed |
|---|---|
| New docs | KANBAN_WORKFLOW.md, PACKAGED_APP.md |
| New components | coming-soon.tsx |
| New lib | prompts/loader.ts, prompts/defaults.ts, agents/qa-subtask-prompt.ts, agents/plan-generation.ts, worktree/cleanup.ts, themes/wcag-contrast.ts |
| New API | /api/prompts |
| Modified | board.tsx, task-card.tsx, human-review-modal.tsx, edit-task-modal.tsx, tasks/update route, start-development, start-planning, start-review, electron/main.js, scripts/dev.js |
Full Changelog: v2.0.1...v2.1.0