Files
kandev/docs/plans/attach-workspace-sources/task-07-files-panel-surface.md
T
Carlos Florêncio bc218dfbbe feat: add workspace sources from files panel (#1900)
* feat: add workspace sources from files panel

* fix: preserve worktree identity during recovery

* feat: unify workspace source actions

* fix: validate recovered workspace repositories

* fix: harden workspace source filesystem boundaries

* test: split workspace repository chip coverage

* fix: restrict repository rescan recovery paths

* fix: stabilize workspace source CI checks

* test: canonicalize workspace source paths

* test: align workspace source container paths

* fix: populate direct workspace repository names

* test: preserve git fixture rewrites across restarts

* test: isolate backend git fixture config

* fix: resume remote workspace executions before creation

* fix: preserve ssh agent identity during resume

* fix: preserve SSH workspace across backend restart

* fix: simplify workspace actions trigger

* fix: refine add workspace repositories UX

* docs: narrow workspace source UX updates

* fix: avoid phantom turn on session resume

* test(web): normalize workspace source request headers

* feat(web): streamline workspace source picker

* docs: remove trailing spaces from workspace source plan

* fix: prevent resume status from creating phantom turns

* fix(web): stabilize workspace source attachment

* refactor(web): extract workspace source store contract

* fix: avoid phantom turns on idle agent resume

* fix: address backend static analysis findings

* fix: preserve agentctl readiness status value

* fix: preserve resume messages without active turns

* fix: resume agents from promoted workspace root

* chore: merge origin/main into feature/add-new-repo-folder-d97

* feat(web): explain workspace source consequences

* test(websocket): count session activity subscription
2026-07-25 21:29:53 +01: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/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.