Build specification

QA and Acceptance#

Run npm run validate. Release fails on schema shape, broken ID, unreachable Scene, invalid Portal destination, impossible quest state, missing Role/family coverage, missing solo fallback, absent visual contract, or missing package file.

Product acceptance#

1. Player can arrive on Bellwether.
2. Player can understand place without a manual.
3. Player can meet the family.
4. Player can pitch an intention.
5. Player can receive dynamic questions.
6. Player can receive understandable provisional Orientation.
7. Player can leave the Pitch Room.
8. Player can explore.
9. Player can receive individualized quest.
10. Player can encounter another player/asynchronous presence.
11. Player can observe autonomous Actors/Allies.
12. Player can create an Ally.
13. Player can enter The Apiary.
14. Player can start or join a Project.
15. Player can make an accepted Contribution.
16. Player can participate in a resource decision.
17. Player can experience temporal mystery.
18. Player can receive a meaningful Actor communication.
19. Player can return to a changed world.
20. Player can complete Bellwether and see the wider bridge.

Test matrix#

• Unit: scoring, transitions, projection/depth, authorization, idempotency, value-flow dedupe.
• Contract: every schema fixture, Action receipt, event envelope, Portal preview.
• Integration: Pitch→Orientation; Project create/join→Contribution; funding; Actor decision; Ally delegation; time anomaly; reconnect.
• Load: 1, 8, 32, 256, 5,000 concurrent presences with shared state.
• Resilience: worker retry, outbox delay, graph conflict, object-store outage, external settlement timeout.
• Human review: visual constitution, family voice, non-creepy AI consent, economic honesty, accessibility, cultural/regional sensitivity.