kandev/docs/plans/attach-workspace-sources/task-03-protocol-surfaces.md

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

id	title	status	wave	depends_on	plan	spec
03-protocol-surfaces	Protocol surfaces	done	3	02-attachment-service	plan.md	../../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

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.