Carlos Florêncio
bc218dfbbe
* 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
54 lines
1.9 KiB
Markdown
54 lines
1.9 KiB
Markdown
---
|
|
id: "04-host-materialization"
|
|
title: "Host materialization"
|
|
status: done
|
|
wave: 3
|
|
depends_on: ["02-attachment-service"]
|
|
plan: "plan.md"
|
|
spec: "../../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
|
|
|
|
```bash
|
|
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.
|