browser/openspec/changes/implement-run-control-registration/tasks.md

1. Control Contracts

• 1.1 Add typed run control protocol payloads in run/protocol for hello, heartbeat, capability report, and capacity report.
• 1.2 Add matching platform DTO/domain contracts and conversion helpers for run control hello and heartbeat.

2. Platform Control Registration

• 2.1 Extend platform service behavior to register run endpoints, issue session tokens, validate heartbeat tokens, and request capability refresh on fingerprint drift.
• 2.2 Implement platform control HTTP routes for hello and heartbeat using named DTOs and service methods.
• 2.3 Add platform service/API tests for new registration, re-registration, heartbeat success, invalid tokens, validation failures, and capability refresh.

3. Run Control Client

• 3.1 Extend run/api.PlatformClient with typed hello and heartbeat methods.
• 3.2 Add run client tests for request paths, JSON payloads, response decoding, and platform error handling.
• 3.3 Add an integration-style test that performs platform hello then heartbeat through the run client.

4. Documentation

• 4.1 Update run and platform protocol/route documentation to mark hello/heartbeat implemented and heavier channels deferred.

5. Verification

• 5.1 Run go test ./... from platform/ and record evidence.
• 5.2 Run go test ./... from run/ and record evidence.
• 5.3 Run scripts/check-structure.sh and record evidence.
• 5.4 Run openspec validate implement-run-control-registration --strict and record evidence.

Evidence

• 2026-07-03: go test ./... from platform/ passed.
• 2026-07-03: go test ./... from run/ passed.
• 2026-07-03: scripts/check-structure.sh passed with structure check passed.
• 2026-07-03: openspec validate implement-run-control-registration --strict passed with Change 'implement-run-control-registration' is valid.