chore: archive final 4 completed OpenSpec changes

Move the following completed changes from openspec/changes/ to openspec/changes/archive/2026-06-12-completed-changes-archive/: - multi-session-terminal-ux - reorganize-long-files - working-copies - workspace-first-ui Update parent and archive .pi-map*.md indexes to reflect the move and remove the transient active-changes-archive grouping. openspec/changes/ now contains only the archive/ directory.
2026-06-12 21:11:11 +00:00
parent 43f3865f69
commit 8c1948d226
41 changed files with 176 additions and 145 deletions
@@ -0,0 +1,130 @@
+# Tasks: Workspace-First UI Refresh
+
+## Status
+
+| Field | Value |
+|---|---|
+| Phase | **Tasks** |
+| Based on | [Design](design.md) |
+| Next | Apply |
+
+## PR Breakdown
+
+### PR-1: Backend — Workspace File, Git & Instance Endpoints
+**Scope**: All new backend endpoints for workspace-scoped operations
+**Est. lines**: ~900 backend, ~400 tests
+**Files touched**: 10 new, 3 modified
+
+**Tasks**:
+1. [x] Create `FileService` (`apps/api/src/services/file_service.py`)
+2. [x] Create `GitOperations` service (`apps/api/src/services/git_operations.py`)
+3. [x] Create `workspace_files` API router (`apps/api/src/api/workspace_files.py`)
+4. [x] Create `workspace_git` API router (`apps/api/src/api/workspace_git.py`)
+5. [x] Create `workspace_instances` API router (`apps/api/src/api/workspace_instances.py`)
+6. [x] Register new routers in `main.py`
+7. [x] Update `workspaces.py` POST to accept `repo_id` directly
+8. [x] Enrich `projects.py` list response with repos + workspaces
+9. [x] Write unit tests for FileService
+10. [x] Write unit tests for GitOperations
+11. [x] Write integration tests for workspace file endpoints
+12. [x] Write integration tests for workspace git endpoints
+13. [x] Write integration tests for workspace instance endpoints
+
+### PR-2: Frontend — Workspace Detail Page
+**Scope**: Workspace detail page with 4 tabs, replaces old repo-workspace
+**Est. lines**: ~1,400 frontend, ~300 tests
+**Files touched**: 14 new, 3 modified
+
+**Tasks**:
+1. [x] Create `useWorkspaceFiles` hook
+2. [x] Create `useWorkspaceGit` hook
+3. [x] Create `useWorkspaceInstances` hook
+4. [x] Create workspace API clients (`workspace-files.ts`, `workspace-git.ts`, `workspace-instances.ts`)
+5. [x] Create `WorkspaceHeader` component (inline in WorkspaceDetailPage)
+6. [x] Create `WorkspaceTabs` component (inline in WorkspaceDetailPage)
+7. [x] Create `WorkspaceFilePanel` component (inline in WorkspaceDetailPage)
+8. [x] Create `GitToolbar` component (inline in Files tab)
+9. [x] Create `WorkspaceGitPanel` component (inline in WorkspaceDetailPage)
+10. [x] Create `WorkspaceToolsPanel` component (inline in WorkspaceDetailPage)
+11. [x] Create `WorkspaceSettingsPanel` component (inline in WorkspaceDetailPage)
+12. [x] Create `WorkspaceDetailPage` page
+13. [x] Add `/workspaces/:id` route
+14. [x] Delete `repo-workspace.tsx` and related components
+15. [x] Write component tests for WorkspaceDetailPage
+
+### PR-3: Frontend — Projects Page Refresh & Routing
+**Scope**: Projects page with inline repos + workspaces, mobile layout
+**Est. lines**: ~800 frontend, ~200 tests
+**Files touched**: 5 new, 5 modified
+
+**Tasks**:
+1. [x] Update `projects.ts` API client for enriched response
+2. [x] Create `useProjects` hook with enriched response
+3. [x] Create `ProjectCard` component
+4. [x] Inline repo section in ProjectCard
+5. [x] Inline workspace chips in ProjectCard
+6. [x] Inline new workspace form in ProjectCard
+7. [x] Rewrite `ProjectsPage`
+8. [x] Inline project detail on ProjectsPage (mobile + desktop)
+9. [x] Update `AppShell` nav order (Workspaces → Projects)
+10. [x] Update `WorkspacesPage` / WorkspaceCard to link to detail
+11. [x] Add mobile tab bar to workspace detail
+12. [x] Remove old repo-workspace route and components
+13. [x] Write component tests for ProjectCard
+14. [ ] Write component tests for RepoSection
+15. [ ] Write tests for NewWorkspaceInline
+
+## Acceptance Criteria (All PRs)
+
+- [x] Old `repo-workspace.tsx` is deleted
+- [x] `/projects/:id` shows project detail with repos + workspaces (inline on ProjectsPage)
+- [x] `/workspaces/:id` shows workspace detail with 4 tabs
+- [x] File browser reads from workspace clone path
+- [x] File viewer/editor works on workspace files
+- [x] Git toolbar on Files tab supports commit/push/pull/fetch
+- [x] Git tab shows commit history
+- [x] Tools tab lists instances + spawn modal (or empty prompt)
+- [x] Settings tab shows workspace info + rename/sync/delete
+- [x] Projects page shows inline repos + workspace cards
+- [x] Inline "New Workspace" form on project page
+- [x] Mobile: 4-tab bottom navigation
+- [x] All existing tests pass or updated
+- [ ] ruff clean (ruff not available in current environment; py_compile passed)
+- [x] TypeScript compilation clean
+- [x] eslint clean
+
+## Implementation Order
+
+```
+PR-1 (Backend endpoints)
+  → PR-2 (Workspace detail page)
+    → PR-3 (Projects refresh + routing)
+```
+
+Each PR depends on the previous. No parallel work.
+
+## Verification Steps per PR
+
+### PR-1
+```bash
+cd apps/api
+pytest tests/unit/test_file_service.py tests/unit/test_git_operations.py -v
+pytest tests/integration/test_workspace_files.py tests/integration/test_workspace_git.py tests/integration/test_workspace_instances.py -v
+python -m ruff check src/services/file_service.py src/services/git_operations.py src/api/workspace_*.py
+```
+
+### PR-2
+```bash
+cd apps/web
+npx tsc --noEmit
+npx eslint src/pages/workspace-detail.tsx src/components/workspace/
+npm run test -- --run workspace-detail
+```
+
+### PR-3
+```bash
+cd apps/web
+npx tsc --noEmit
+npx eslint src/pages/projects.tsx src/components/project/
+npm run test -- --run projects
+```