docs(work): close walking-skeleton story 02 (protocol package)

This commit is contained in:
2026-07-12 21:47:47 +02:00
parent 52f3b19dfe
commit e9edad69b4
2 changed files with 18 additions and 26 deletions

View File

@@ -3,11 +3,12 @@ id: 02-core-runner-protocol
epic: walking-skeleton
title: core-runner-protocol package — versioned, zod-validated message schemas
type: technical-story
status: todo
status: done
feature: core-runner-protocol
depends-on: []
blocks: [04-runner-app-protocol-clone-install, 09-editor-package]
created: 2026-07-12T10:24:14Z
updated: 2026-07-12T19:47:48.507Z
---
## Goal
@@ -40,5 +41,7 @@ The runner protocol is plain WS/JSON, not tRPC (ADR-027) — which means nothing
## Tasks
- [ ] Run `pnpm turbo gen core-package runner-protocol` → green `@repo/core-runner-protocol` package shell.
- [ ] Add the versioned protocol surface: message envelope (`protocolVersion: "0"`, workspace-scoped auth token) + zod-validated `.strict()` schemas for hello/ready, clone, install, scan, adapter-start, render-frame, and status/error events (staged progress carries stage + elapsed; errors carry named causes), with unit tests covering accept/reject round-trips for every message type.
- [x] Run `pnpm turbo gen core-package runner-protocol` → green `@repo/core-runner-protocol` package shell.
- [x] Add the versioned protocol surface: message envelope (`protocolVersion: "0"`, workspace-scoped auth token) + zod-validated `.strict()` schemas for hello/ready, clone, install, scan, adapter-start, render-frame, and status/error events (staged progress carries stage + elapsed; errors carry named causes), with unit tests covering accept/reject round-trips for every message type.
_Landed: 48827b2 (scaffold) + a5670c5 (schemas, 74 round-trip tests, 100% L0), reviewer-approved. Generator legitimately refused 'runner-protocol' (choices pinned to 8 snapshots) — hand-scaffold mirrors core-events; flagged in the package AGENTS.md as a future generator snapshot candidate._