Revert spike ports to 3001/5173, add stories 32 and 33
Reverts port changes made during the spike back to default (3001/5173). Adds two new stories for multi-worktree support: dynamic port management (story 32) and worktree diff inspection with editor integration (story 33). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,18 @@
|
||||
# Story 32: Worktree Agent Orchestration — Dynamic Port Management
|
||||
|
||||
## User Story
|
||||
**As a** developer running multiple agents in parallel worktrees,
|
||||
**I want** each server instance to bind to a unique port automatically,
|
||||
**So that** I can run multiple worktree-based agents concurrently without port conflicts.
|
||||
|
||||
## Acceptance Criteria
|
||||
- [ ] Server discovers an available port instead of hardcoding 3001 (e.g., try 3001, then 3002, etc., or use port 0 and report back).
|
||||
- [ ] Server prints the actual bound port on startup so callers can discover it.
|
||||
- [ ] Frontend dev server proxy target is configurable (env var or auto-detected from server).
|
||||
- [ ] WebSocket client in the frontend reads the port dynamically rather than hardcoding it.
|
||||
- [ ] Agent pool can target agents at different worktree server instances by URL.
|
||||
- [ ] A simple registry or file-based mechanism lets a supervisor discover which ports map to which worktrees.
|
||||
|
||||
## Out of Scope
|
||||
- Service mesh or container orchestration.
|
||||
- Multi-machine distributed agents (local only for now).
|
||||
@@ -0,0 +1,20 @@
|
||||
# Story 33: Worktree Diff Inspection and Editor Integration
|
||||
|
||||
## User Story
|
||||
**As a** supervisor coordinating agents across worktrees,
|
||||
**I want to** view diffs of in-progress agent work and open worktrees in my editor,
|
||||
**So that** I can review changes, catch problems early, and intervene when needed.
|
||||
|
||||
## Acceptance Criteria
|
||||
- [ ] API endpoint (or CLI command) returns `git diff` output for a given worktree path.
|
||||
- [ ] API endpoint returns `git diff --stat` summary for a quick overview.
|
||||
- [ ] API endpoint can return diff against the base branch (e.g., `git diff main...HEAD`).
|
||||
- [ ] A "open in editor" action launches the configured editor (e.g., `zed`) pointed at a worktree directory.
|
||||
- [ ] Editor preference is configurable (stored in app settings, defaults to `$EDITOR` or `zed`).
|
||||
- [ ] Frontend can trigger "open in editor" for any listed worktree/agent.
|
||||
- [ ] Frontend can display a diff view for any worktree with syntax-highlighted changes.
|
||||
|
||||
## Out of Scope
|
||||
- Full code review workflow (comments, approvals).
|
||||
- Automatic merge or conflict resolution.
|
||||
- Editor plugin integration (just launching the editor at the worktree path is sufficient).
|
||||
Reference in New Issue
Block a user