docs: define initial quest board stories

2026-09-04 23:21:53 -04:00
commit 97ad506ba7
12 changed files with 314 additions and 0 deletions
@@ -0,0 +1,27 @@
+---
+type: User Story
+title: "US-006: Cancel an owned quest"
+description: Let an issuer cancel an active quest and reclaim its escrowed reward safely.
+status: backlog
+---
+
+# US-006: Cancel an owned quest
+
+As a **quest issuer**, I want to cancel my active quest so that I can reclaim the reward when I no longer need the requested blocks.
+
+## Acceptance criteria
+
+- [ ] An issuer can cancel their own active quest through any registered board.
+- [ ] A player cannot cancel a quest issued by another player.
+- [ ] Completed, cancelled, and expired quests cannot be cancelled.
+- [ ] Cancellation removes the quest from active listings and converts its exact escrowed reward into a claim for the issuer.
+- [ ] The reward is not inserted directly into the issuer's inventory during cancellation.
+- [ ] When player commands are enabled, `/quests cancel <quest>` provides equivalent behavior and only autocompletes the player's cancellable quest identifiers.
+- [ ] Cancellation and simultaneous completion are serialized so items cannot be duplicated or lost.
+- [ ] Persistence failure leaves the quest active and its reward escrowed.
+- [ ] Automated tests verify ownership, state validation, claim creation, autocomplete, rollback, and completion races.
+
+## Related
+
+- [US-003: Create a block-delivery quest](us-003-create-a-block-delivery-quest.md)
+- [US-007: Expire quests and claim held items](us-007-expire-quests-and-claim-held-items.md)