Files
kandev/docs/plans/attach-workspace-sources/task-03-protocol-surfaces.md
T
2026-08-23 17:34:52 +00:00

54 lines
1.7 KiB
Markdown

---
id: "03-protocol-surfaces"
title: "Protocol surfaces"
status: done
wave: 3
depends_on: ["02-attachment-service"]
plan: "plan.md"
spec: "../../specs/tasks/system-design/attach-workspace-sources.md"
---
# Task 03: Protocol Surfaces
## Acceptance
- HTTP accepts the documented mixed batch, maps typed failures to the documented status codes, and
returns the durable source/session projection.
- `add_workspace_sources_kandev` defaults to the current task and reaches the same service;
`add_branch_to_task_kandev` remains wire-compatible.
- Task and session source-update events are routed through the gateway only after successful
materialization, with handler/MCP/event tests covering payloads and failure truthfulness.
## Verification
```bash
cd apps/backend
rtk go test ./internal/task/handlers/... ./internal/mcp/... ./internal/gateway/websocket/... ./pkg/websocket/...
```
## Files likely touched
- `apps/backend/internal/task/handlers/task_handlers.go`
- `apps/backend/internal/task/handlers/task_http_handlers.go`
- `apps/backend/internal/task/handlers/*workspace_sources*_test.go`
- `apps/backend/internal/mcp/server/server.go`
- `apps/backend/internal/mcp/server/handlers_test.go`
- `apps/backend/internal/mcp/handlers/handlers.go`
- `apps/backend/internal/mcp/handlers/handlers_test.go`
- `apps/backend/internal/events/types.go`
- `apps/backend/pkg/websocket/actions.go`
- `apps/backend/internal/gateway/websocket/task_notifications.go`
## Dependencies
Task 02.
## Inputs
- Spec: API surface and error codes.
- Existing create-task repository union and add-branch MCP forwarding tests.
## Output contract
Summary, files changed, tests run, blockers, risks, divergence, and task/plan status updates.