(#8) EVENTS.md nest message contract #15

Merged
jacisjake merged 1 commits from task/8-events-nest-contract into main 2026-10-28 06:09:36 +00:00
jacisjake commented 2026-10-28 06:01:13 +00:00 (Migrated from github.com)
  • New "Nest messages" section in EVENTS.md: the 7 kinds (say/request/claim/deliver/refer/nudge/flag), the full payload record (msg_id, kind, author, text, to, refers_to, tagged_by), the nest.message SSE event, POST /api/nests/{nest_id}/messages and GET /api/events?nest_id=, the Jev-first tagging rule from #3, and guardrails (length, membership, postable kinds, rate limit reuse).
  • Replaces the B1 stub. Contracts-first: this lands before the server/UI code (B2+).
  • Docs only — no Go changes, existing suite untouched.

Closes #8 · Epic: #2

Red (before, on main):

git show main:EVENTS.md | grep -qE 'say|request|claim|deliver|refer' && ... || echo RED
→ RED on main: no nudge kind row / contract sections absent

Green (after):

grep -qE 'say|request|claim|deliver|refer' EVENTS.md && grep -qi 'nest_id' EVENTS.md && echo PASS → PASS
go test -race -count=1 . → ok  somanycrows
- New "Nest messages" section in EVENTS.md: the 7 kinds (say/request/claim/deliver/refer/nudge/flag), the full payload record (msg_id, kind, author, text, to, refers_to, tagged_by), the `nest.message` SSE event, `POST /api/nests/{nest_id}/messages` and `GET /api/events?nest_id=`, the Jev-first tagging rule from #3, and guardrails (length, membership, postable kinds, rate limit reuse). - Replaces the B1 stub. Contracts-first: this lands before the server/UI code (B2+). - Docs only — no Go changes, existing suite untouched. Closes #8 · Epic: #2 **Red (before, on main):** ``` git show main:EVENTS.md | grep -qE 'say|request|claim|deliver|refer' && ... || echo RED → RED on main: no nudge kind row / contract sections absent ``` **Green (after):** ``` grep -qE 'say|request|claim|deliver|refer' EVENTS.md && grep -qi 'nest_id' EVENTS.md && echo PASS → PASS go test -race -count=1 . → ok somanycrows ```
Sign in to join this conversation.