Files
kandev/docs/plans/attach-workspace-sources/task-07-files-panel-surface.md
T
2026-08-23 17:34:52 +00:00

57 lines
1.8 KiB
Markdown

---
id: "07-files-panel-surface"
title: "Files panel surface"
status: done
wave: 4
depends_on: ["03-protocol-surfaces", "06-shared-source-picker"]
plan: "plan.md"
spec: "../../specs/tasks/system-design/attach-workspace-sources.md"
---
# Task 07: Files Panel Surface
## Acceptance
- Eligible desktop and mobile Files panels expose an accessible Add sources action, with archived,
repository-less, loading, and active-turn states handled explicitly.
- Desktop Dialog and phone full-height Drawer share logic, support mixed rows, retain retryable input
on failure, and meet the documented scroll, safe-area, focus, touch-target, and overflow contract.
- Successful task/session events merge repository/folder state, adopt the new workspace path, reset
affected file-tree caches, and refresh Files/Changes/editor surfaces without a page reload.
## Verification
```bash
cd apps/web
rtk pnpm test -- components/task/add-workspace-sources components/task/file-browser lib/ws/handlers
rtk pnpm run typecheck
```
## Files likely touched
- `apps/web/components/task/add-workspace-sources/**` (new)
- `apps/web/components/task/file-browser-toolbar.tsx`
- `apps/web/components/task/file-browser.tsx`
- `apps/web/components/task/files-panel.tsx`
- `apps/web/components/task/task-files-panel.tsx`
- `apps/web/components/task/task-files-panel-hooks.ts`
- `apps/web/lib/ws/handlers/tasks.ts`
- `apps/web/lib/ws/handlers/agent-session.ts`
- `apps/web/lib/state/slices/kanban/**`
- `apps/web/lib/state/slices/session-runtime/**`
## Dependencies
Tasks 03 and 06.
## Inputs
- Plan: Frontend and Mobile design contract.
- Mobile exemplar: `components/task/mobile/mobile-picker-sheet.tsx`.
- Existing Files toolbar and mobile/tablet task layouts.
## Output contract
Summary, files changed, tests run, rendered desktop/mobile checks, blockers, risks, divergence, and
task/plan status updates.