Build specification

Implementation Guide#

Recommended runtime#

Modular monolith plus workers: PostgreSQL, version-pinned Apache AGE, pgvector, object storage, Graph Command Service, Ally/Actor orchestration, ingestion, outbox/reconciliation, and privacy-safe observability. One graph per Ecosystem; Organization boundaries are policy and RLS, not isolated databases.

Build sequence#

1. Load schemas, registries, IDs, palette/material/isometric rules.
2. Implement identity/session and the four state layers.
3. Implement named reads, ActionRequest/authorization/confirmation/Command/Record spine.
4. Implement renderer from immutable SceneRenderState plus semantic-tree bridge.
5. Ship Arrival → Lantern → private Pitch → Compass receipt as vertical slice.
6. Add role quests, family Actor cycle, honest messages, and safe solo fallbacks.
7. Add Apiary Table, Project create/join, WorkItems, Contributions, acceptance.
8. Add Ally weaving and bounded Actor delegation.
9. Add sandbox ledger/resources/funding signals and governed decision.
10. Add Underways, movable Portal, Second Bell, and ARG opt-in.
11. Add Workshop/Compound expansion, sharding, crowd aggregation, return-session change.
12. Run full QA, privacy adversaries, accessibility, load, recovery, and art insertion tests.

Non-negotiable tests per slice#

Expected-version conflict; idempotent replay; reconnect; unauthorized read; secret preview; keyboard/screen reader; reduced motion; solo population; 1,000+ presence load; actor acts while Source absent; external operation never says complete before settlement.