feat(quests): add quest creation and reward escrow
Release / release (push) Successful in 2m17s
CI / build (push) Successful in 1m4s

This commit is contained in:
dmg
2026-09-04 23:45:00 -04:00
parent 63779d1631
commit 638d2328ab
23 changed files with 1145 additions and 22 deletions
@@ -2,7 +2,7 @@
type: User Story
title: "US-003: Create a block-delivery quest"
description: Let a player request block items while safely escrowing an inventory-funded reward.
status: backlog
status: done
---
# US-003: Create a block-delivery quest
@@ -11,15 +11,15 @@ As a **player**, I want to request a block material and quantity in exchange for
## Acceptance criteria
- [ ] A player can create a quest through a registered quest board by selecting a valid block material, a positive quantity, and reward items from their inventory.
- [ ] Reward items must exist in the issuer's inventory and are removed only when quest creation succeeds.
- [ ] Removed rewards are held durably in escrow by the quest system.
- [ ] A created quest records a unique identifier, issuer UUID and current name, requested material and quantity, exact reward items, creation time, and expiration time.
- [ ] Each quest expires exactly seven days after successful creation.
- [ ] Invalid input, insufficient reward items, or persistence failure leaves the issuer's inventory unchanged and creates no quest.
- [ ] When player commands are enabled, `/quests create ...` provides equivalent validated creation behavior with contextual autocomplete.
- [ ] Quest state and item metadata survive server restarts without duplication or loss.
- [ ] Automated tests verify validation, escrow, rollback, timestamps, command routing, and persistence.
- [x] A player can create a quest through a registered quest board by selecting a valid block material, a positive quantity, and reward items from their inventory.
- [x] Reward items must exist in the issuer's inventory and are removed only when quest creation succeeds.
- [x] Removed rewards are held durably in escrow by the quest system.
- [x] A created quest records a unique identifier, issuer UUID and current name, requested material and quantity, exact reward items, creation time, and expiration time.
- [x] Each quest expires exactly seven days after successful creation.
- [x] Invalid input, insufficient reward items, or persistence failure leaves the issuer's inventory unchanged and creates no quest.
- [x] When player commands are enabled, `/quests create ...` provides equivalent validated creation behavior with contextual autocomplete.
- [x] Quest state and item metadata survive server restarts without duplication or loss.
- [x] Automated tests verify validation, escrow, rollback, timestamps, command routing, and persistence.
## Related