docs(design): add user story knowledge bundle

2026-08-08 12:31:15 -04:00
parent baed3b4901
commit c76ea5b434
9 changed files with 198 additions and 0 deletions
@@ -0,0 +1,26 @@
+---
+type: User Story
+title: "US-003: Capture player and server activity"
+description: Record server lifecycle, player sessions, public chat, and recognized private messages.
+status: done
+---
+
+# US-003: Capture player and server activity
+
+As a **server analyst**, I want significant server and player activity captured so that I can reconstruct participation and communication activity downstream.
+
+## Acceptance criteria
+
+- [x] Plugin startup and shutdown produce server lifecycle events.
+- [x] Player joins and quits produce events with player identity.
+- [x] Non-cancelled public chat produces an event containing the complete message and whether the Bukkit event was asynchronous.
+- [x] Recognized explicit private-message commands capture the command, recipient token, and complete message.
+- [x] Recognized reply commands are marked as replies and omit a recipient.
+- [x] Private-message observations report whether the underlying command was cancelled.
+- [x] Standard aliases and namespaced variants documented by the project are recognized.
+
+## Related
+
+- [US-002: Produce standard CloudEvents](us-002-produce-standard-cloud-events.md)
+- [US-005: Deliver events durably](us-005-deliver-events-durably.md)
+- [Chat and private-message behavior](../../README.md#chat-and-private-messages)