settled-reach/docs/sprints/sprint-33/joint.md

Sprint 33: Pecunia — Joint Notes

Goal: Full economics simulation running — Leontief production, spatial price equilibrium, currency zones, corporate behavioral agents across all three corporation tiers, stability tests passing.

Sprint Completion Proof

When Sprint 33 is done, you can:

1. Run economy-sim --stability-check and see all four D-179 tests pass: cold-start convergence (±5% within 100 days), long-run stability (no drift > ±2% over 1,000 days), shock response (recovery within 200 ticks, no negative prices), cross-zone re-stabilization (within 50 ticks).
2. See Compact systems with MARK_PRIMARY currency zones in server/data/systems.db — SELECT system_id, currency_zone FROM star_systems WHERE currency_zone != 'TRACTUS_PRIMARY' returns a non-trivial list matching Compact membership.
3. See 150 Tier-2 corporations in wiki/economics/corporations/tier2/ with distinct names, corridors, backstories, and branded product lists.
4. See generated_corporations.toml with 5,000+ Tier-3 template instances covering all inhabited systems.
5. Read 36 commodity wiki pages at wiki/economics/commodities/ with full flavor text, lore context, and production chain descriptions.
6. See wiki/economics/shadow_economy.toml with per-system-type intensity ranges authored and annotated.
7. See the icon_tint.gdshader in the client with recoloring working on both stroke and fill icon types at all implant theme semantic colors.
8. Grep for qdrant in the repo and find no references (removal complete).

Phase 2 Context

Phase 2 deliverable (D-166): "Economics spreadsheets/graphs with runtime-tweakable simulation."

Sprint 33 is the first economics implementation sprint. The economics schema (#804, DONE), commodity catalog (wiki/economics/commodities.toml), and production chains (wiki/economics/production_chains.toml) were completed in Sprint 32. The Tier-1 corporation corpus (38 named corporations, #797, DONE) and archetype taxonomy (#798, DONE) are also in place.

This sprint builds the simulation binary and completes the corporation corpus (Tier 2 authored, Tier 3 generated). It does not close Phase 2 — the phase deliverable includes the full signal pipeline and runtime-tweakable parameters, which will be Sprint 34+ work. But passing all four stability tests in Sprint 33 validates the model architecture and unblocks everything downstream.

Pre-Sprint Checklist

Before any simulation code is written, verify:

Item	Owner	Status
server/data/systems-schema.sql has currency_zone on star_systems	server	Done (#804)
corp_presence table exists in schema	server	Done (#804)
wiki/economics/commodities.toml — 36 types present	copy	Done (#801)
wiki/economics/production_chains.toml — 21 chains present	copy	Done (#801)
wiki/economics/archetypes/lore.toml — 28 archetypes defined	copy	Done (#798)
wiki/economics/archetypes/behavioral.toml — 6 archetypes defined	copy	Done (#798)
38 Tier-1 corporations in DB + wiki	copy	Done (#797)

Cross-Team Dependencies

The server simulation chain (#806 → #807 → #808 → #809) has hard blockers on copy team output:

• #809 (corporate agents) cannot be started until #799 (Tier-2 corps) is in a queryable state. Server team must be able to read behavioral_archetype from Tier-2 TOML records.
• #808 (currency zones) consumes wiki/economics/shadow_economy.toml (#803) for per-node shadow_economy_intensity. Copy team should deliver #803 by mid-sprint.
• #805 (corp pipeline) will wire in Compact zone assignments from #820. Copy team must finalize the list of MARK_PRIMARY system IDs before #805 runs its full validation pass.
• #800 (Tier-3 pipeline) is a server Rust binary but reads archetype TOML format authored by copy. Schema for wiki/economics/archetypes/ must be stable before #800 starts. Server and copy teams: align on this format in the first two days of the sprint.

Iterative Development Cycle (D-183)

This sprint follows the iterative economics cycle: skeleton sim (#806) → data population (copy work running in parallel) → test (#807 stability) → currency layer (#808) → agents (#809). Copy and server work in parallel — they are not sequentially gated except at the #809 merge point.

If stability tests fail in #807, do not proceed to #808 until Tests 1 and 2 pass. The tâtonnement parameters (α=0.03, β=0.4) are starting values — Dudley/Tyre should tune them if the model oscillates or drifts. Report to team lead before making architectural changes.

Dependency Chain

Server chain:
  #813 (energy-over-gate schema) ─────────────────────────────────────────┐
  #805 (corp pipeline + validation) → #806 (skeleton sim)                  |
                                          → #807 (trade flows + stability) |
                                              → #808 (currency zones) ←───┘
                                                  → #809 (corporate agents)

Copy unblocks server:
  #820 (MARK_PRIMARY assignments) → feeds #805 validation
  #803 (shadow economy ranges) → feeds #808 shadow modifier
  #799 (Tier-2 corps) ─────────────────────────────────────────────────→ #809
  #800 (Tier-3 pipeline, server executes) ───────────────────────────→ #809

Independent:
  #812 (commodity copy) → standalone
  #818 (icon_tint shader, client) → standalone
  #816 (remove Qdrant, CI) → standalone

Not In Scope

• Phase 2 signal delivery to the Godot client — that is Phase 4 player interaction territory
• Event input port exercising — port is stubbed in #809, not exercised until Phase 3+
• Heightmap batch (#794) — deferred from Sprint 32, carries into a later sprint
• Character creation UI (#694, #618, #619) — Phase 4
• World generation — Phase 5