kandev/docs/plans/workspace-git-status-scalability/task-03-api-regression-verification.md

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

id	title	status	wave	depends_on	plan	spec
03-api-regression-verification	API regression verification	done	3	02-coalesce-fresh-status	plan.md	../../specs/platform/workspace-git-status.md

Task 03: API regression verification

Acceptance

• Overlapping fresh multi-repository HTTP requests perform one underlying observation per repository and return consistent repository-scoped snapshots.
• One cancelled HTTP waiter does not prevent peers from receiving the shared completed result.
• An invalid repository remains a local failure while healthy repository entries succeed.
• Focused race tests and the backend format, test, and lint suites pass.
• No frontend, payload-shape, ignore-policy, or public-documentation changes are introduced.

Verification

cd apps/backend
rtk go test ./internal/agentctl/server/api -run 'Test.*GitStatus.*Fresh'
rtk go test -race ./internal/agentctl/server/process ./internal/agentctl/server/api
cd ../../
rtk make -C apps/backend fmt
rtk make -C apps/backend test
rtk make -C apps/backend lint

Files likely touched

• apps/backend/internal/agentctl/server/api/git_status_fresh_concurrency_test.go
• Process-package files only if handler coverage exposes a correctness defect from Task 02.

Dependencies

• 02-coalesce-fresh-status

Inputs

• Existing Git-status single and multi handlers and response types.
• Existing multi-repository partial-success tests.
• Task 02's deterministic observation-count seam or blocking Git shim.

Output contract

Report handler scenarios, underlying observation counts, cancellation behavior, multi-repository results, race and full-suite verification, changed files, and remaining risks. Keep assertions synchronization-based rather than elapsed-time-based.