kandev/docs/plans/attach-workspace-sources/task-07-files-panel-surface.md

id, title, status, wave, depends_on, plan, spec

id	title	status	wave	depends_on	plan	spec
07-files-panel-surface	Files panel surface	done	4	03-protocol-surfaces 06-shared-source-picker	plan.md	../../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

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.