Skip to content

v2.1.0

Choose a tag to compare

@danted4 danted4 released this 01 Feb 08:07
· 21 commits to main since this release
d258f40

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/prompts for 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_URL set before starting the Next.js server so internal callbacks hit the correct port.
  • New docs/PACKAGED_APP.md documents 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 .md file to manual-qa-required/<subtask-id>.md for QA subtasks that require manual verification.
  • New qa-subtask-prompt.ts with isManualQASubtask and buildQASubtaskPrompt.
  • 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.ts updated to use ESM import instead of CommonJS require for tailwindcss-animate.
  • Port handling: scripts/dev.js extends 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.updatedAt is 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.html for 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