Files
kandev/docs/plans/attach-workspace-sources/task-04-host-materialization.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

1.9 KiB

id, title, status, wave, depends_on, plan, spec
id title status wave depends_on plan spec
04-host-materialization Host materialization done 3
02-attachment-service
plan.md ../../specs/tasks/attach-workspace-sources.md

Task 04: Host Materialization

Acceptance

  • Worktree repository additions and mixed Local/Worktree folder sources materialize under a safe Kandev-owned task root using live, canonical, platform-native directory links.
  • An idle Local execution can re-root/rebind without losing task conversation state; Worktree keeps synchronous sibling materialization. Active work is never interrupted.
  • Agentctl adopts the new workdir, refreshes file scope and Git trackers, and materialization rolls back safely when linking, restart, rescan, or event publication fails.

Verification

cd apps/backend
rtk go test ./internal/backendapp/... ./internal/agent/runtime/lifecycle/... ./internal/agentctl/server/api/... ./internal/agentctl/server/process/...

Files likely touched

  • apps/backend/internal/backendapp/branch_materializer.go
  • apps/backend/internal/backendapp/workspace_source_materializer.go (new)
  • apps/backend/internal/backendapp/*workspace_source_materializer*_test.go
  • apps/backend/internal/agent/runtime/lifecycle/manager_workspace_rescan.go
  • apps/backend/internal/agent/runtime/lifecycle/manager_execution.go
  • apps/backend/internal/agent/runtime/lifecycle/env_preparer_local.go
  • apps/backend/internal/agentctl/server/api/workspace_rescan.go
  • apps/backend/internal/agentctl/server/process/manager.go
  • platform-specific link helper/test files under apps/backend/internal/worktree/

Dependencies

Task 02.

Inputs

  • Spec: host live-reference semantics and idle gate.
  • ADR-2026-07-19-workspace-symlink-entries.
  • Existing branch_materializer.go root promotion and agentctl rescan path.

Output contract

Summary, files changed, tests run, blockers, risks, divergence, and task/plan status updates.