fraqtal/agentic-dev
Template
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
Danijel Martinek
2026-07-12 21:47:47 +02:00
parent 52f3b19dfe
commit e9edad69b4
2 changed files with 18 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files

35
docs/work/_system/_state.json
View File

@@ -1,5 +1,5 @@
{ {
"updated_at": "2026-07-12T19:44:14.864Z", "updated_at": "2026-07-12T19:47:48.805Z",
"epics": { "epics": {
"platform-retrofit": { "platform-retrofit": {
"status": "done", "status": "done",
@@ -120,10 +120,10 @@
] ]
}, },
"02-core-runner-protocol": { "02-core-runner-protocol": {
"status": "todo", "status": "done",
"title": "core-runner-protocol package — versioned, zod-validated message schemas", "title": "core-runner-protocol package — versioned, zod-validated message schemas",
"ac_total": 2, "ac_total": 2,
"ac_completed": 0, "ac_completed": 2,
"depends_on": [], "depends_on": [],
"blocks": [ "blocks": [
"04-runner-app-protocol-clone-install", "04-runner-app-protocol-clone-install",
@@ -238,19 +238,24 @@
"ready": [ "ready": [
{ {
"epic": "walking-skeleton", "epic": "walking-skeleton",
"story": "02-core-runner-protocol", "story": "03-workspaces-feature-core",
"title": "core-runner-protocol package — versioned, zod-validated message schemas" "title": "workspaces feature core — connect, status, list + encrypted credential storage"
}, },
{ {
"epic": "walking-skeleton", "epic": "walking-skeleton",
"story": "03-workspaces-feature-core", "story": "04-runner-app-protocol-clone-install",
"title": "workspaces feature core — connect, status, list + encrypted credential storage" "title": "runner app — protocol server, clone stage, install stage"
}, },
{ {
"epic": "walking-skeleton", "epic": "walking-skeleton",
"story": "07-runner-lifecycle-events-and-realtime", "story": "07-runner-lifecycle-events-and-realtime",
"title": "runner lifecycle — status events, scan event, realtime channel" "title": "runner lifecycle — status events, scan event, realtime channel"
}, },
{
"epic": "walking-skeleton",
"story": "09-editor-package",
"title": "editor package — React Flow board, iframe frame node, canvas-protocol client"
},
{ {
"epic": "walking-skeleton", "epic": "walking-skeleton",
"story": "10-web-next-wiring", "story": "10-web-next-wiring",
@@ -258,14 +263,6 @@
} }
], ],
"blocked": [ "blocked": [
{
"epic": "walking-skeleton",
"story": "04-runner-app-protocol-clone-install",
"title": "runner app — protocol server, clone stage, install stage",
"waiting_on": [
"walking-skeleton/02-core-runner-protocol"
]
},
{ {
"epic": "walking-skeleton", "epic": "walking-skeleton",
"story": "05-runner-scan-and-preview-adapter", "story": "05-runner-scan-and-preview-adapter",
@@ -291,14 +288,6 @@
"walking-skeleton/07-runner-lifecycle-events-and-realtime" "walking-skeleton/07-runner-lifecycle-events-and-realtime"
] ]
}, },
{
"epic": "walking-skeleton",
"story": "09-editor-package",
"title": "editor package — React Flow board, iframe frame node, canvas-protocol client",
"waiting_on": [
"walking-skeleton/02-core-runner-protocol"
]
},
{ {
"epic": "walking-skeleton", "epic": "walking-skeleton",
"story": "11-flagship-e2e", "story": "11-flagship-e2e",

9
docs/work/epics/walking-skeleton/02-core-runner-protocol/_story.md
View File

@@ -3,11 +3,12 @@ id: 02-core-runner-protocol
epic: walking-skeleton epic: walking-skeleton
title: core-runner-protocol package — versioned, zod-validated message schemas title: core-runner-protocol package — versioned, zod-validated message schemas
type: technical-story type: technical-story
status: todo status: done
feature: core-runner-protocol feature: core-runner-protocol
depends-on: [] depends-on: []
blocks: [04-runner-app-protocol-clone-install, 09-editor-package] blocks: [04-runner-app-protocol-clone-install, 09-editor-package]
created: 2026-07-12T10:24:14Z created: 2026-07-12T10:24:14Z
updated: 2026-07-12T19:47:48.507Z
--- ---
## Goal ## Goal
@@ -40,5 +41,7 @@ The runner protocol is plain WS/JSON, not tRPC (ADR-027) — which means nothing
## Tasks ## Tasks
- [ ] Run `pnpm turbo gen core-package runner-protocol` → green `@repo/core-runner-protocol` package shell. - [x] 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] 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._