fix(economics): address 17 PR review comments on #114

Blocking fixes:
- V-13: legal_services demand_model compliance→market (build-breaker)
- D-184: political flag names match TOML (commission_certified etc.)
- D-184: professional services list matches TOML
- D-173: elasticity count 5→4, cross-ref to D-184
- Workshop outcomes: fix self-contradicting fusion fuel statement
- R-011: move to end of file (was between D-183 and D-184)

Should-fix:
- D-166 domain link scope.md→architecture.md
- Sprint briefing counts updated (13→17 D-records, #801 marked done)
- Burnelli-Sheldon added to agent roster + briefing created
- questions-architecture.md footer tally updated
- medical_services demand_model utility→market
- timber display name drop "/Biomass"

Polish:
- D-171 Groombridge clarified (clearing house, not co-issuer)
- hospitality description has Reach texture
- commission_certification shadow_viable=false rationale in description
- Ticket #801 description updated
- Wiki pages regenerated

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-04-05 22:18:41 +02:00
co-authored by Claude Opus 4.6
parent 69d0659066
commit f1b97d4a88
15 changed files with 83 additions and 53 deletions
+40
View File
@@ -0,0 +1,40 @@
---
title: "Burnelli-Sheldon - Project Briefing"
description: "Economist owning commodity pricing, production chain coefficients, tâtonnement parameters, stability criteria, and economic model architecture"
type: briefing
status: active
agent: Burnelli-Sheldon
updated: 2026-04-05
---
# Burnelli-Sheldon - Project Briefing
Last updated: 2026-04-05
## Current Project State
See [PROJECT_STATE.md](../../PROJECT_STATE.md) for shared project state (cascade phase, sprint, decision count).
## Your Domain
Economics simulation: commodity pricing, Leontief production chains, spatial price equilibrium (damped tâtonnement), corporate behavioral agents, stability criteria.
## Key Decisions You Own or Contributed To
- **D-173** Commodity taxonomy (co-author with Gestalt)
- **D-178** Economic model architecture (primary author — 3-layer model)
- **D-179** Stability acceptance criteria (primary author — 4 tests)
- **D-184** Commodity catalog, 36 types (co-author — pricing, margins, cascades)
- **D-185** Brands are not commodities (validated economic separation)
- **D-187** Fusion fuel as intermediate, 8:1 yield (validated economics)
## Key References
- `decisions/economics.md` — all economics D-records (D-171–D-187)
- `wiki/economics/commodities.toml` — commodity catalog (source of truth)
- `wiki/economics/production_chains.toml` — Leontief recipes
- `wiki/economics/schema.md` — SQL schema + validation rules
## Open Work
- Brand-layer demand interface design (#811)
- Tâtonnement parameter tuning (α=0.03, β=0.4 from D-178 — needs validation against D-179 stability criteria)
- Energy-over-gate demand reduction coefficient (~0.3× utility — needs calibration)
+2
View File
@@ -28,6 +28,8 @@ Phase 1 deliverable: "Implant-ready Godot map of the Reach with click-throughs +
**#796 complete** — Economics design workshop produced D-171 through D-183 in `decisions/economics.md` and 14 tickets (#797–#810) under #747.
**#801 complete** — Commodity catalog workshop produced D-184 through D-187 and 5 follow-up tickets (#811–#815). 36 commodities, 21 production chains in `wiki/economics/`.
**Pulled into Sprint 32:**
- #797 Author 25 new Tier-1 corps (copy team)
- #798 Define archetype taxonomy (copy team)
+3 -12
View File
@@ -18,20 +18,11 @@ Use `tooling/db/ticket show <id>` for full details.
### #796 Phase 2 economics design kickoff — DONE
Workshop complete. Produced 13 D-records (D-171–D-183) in `decisions/economics.md` and 14 tickets (#797–#810) under #747. See `docs/sprints/sprint-32/workshop-796-round*.md` for full records.
Workshop complete. Produced 17 D-records (D-171–D-187) in `decisions/economics.md` and 19 tickets (#797–#815) under #747. See `docs/sprints/sprint-32/workshop-796-round*.md` and `docs/workshops/commodity-catalog/` for full records.
### #801 Define commodity catalog (TOML)
### #801 Define commodity catalog (TOML) — DONE
Author `wiki/economics/commodities.toml` with ~30 commodity types:
- 7 raw materials (ore, rare minerals, timber, agricultural produce, water, energy, organics)
- 8 intermediate goods (refined metals, structural panels, processed food, components, chemicals, hull plates, drive assemblies, habitat modules)
- 7 final goods (heavy equipment, vehicles, consumer goods, luxury goods, implant hardware, gate components, freight haulers)
- ~5 professional services (legal, banking, medical/re-embodiment, information brokerage, technical certification)
- ~3 luxury/experiential services (tourism, entertainment media, fine dining/hospitality)
Each entry needs: tier, elasticity class, base price (in Tractus), bulk class, political sensitivity flag. Include production chain recipes in `wiki/economics/production_chains.toml`.
**Reference:** D-173 (commodity taxonomy), D-177 (productivity constraints), Burnelli-Sheldon's Round 2 commodity list, Miri's productivity constraint table.
Delivered `wiki/economics/commodities.toml` (36 commodities) and `wiki/economics/production_chains.toml` (21 chains). Workshop produced D-184–D-187. Follow-up tickets #811–#815 created.
### #804 Extend systems.db schema for economics
@@ -72,7 +72,7 @@ panic_threshold_weeks = 0
description = "Crystalline substrates for neural lattice fabrication and gate optics. East reach anchor. Strategic material."
[timber]
name = "Timber/Biomass"
name = "Timber"
tier = "raw"
elasticity = "unit_elastic"
base_price = 15.0
@@ -472,7 +472,7 @@ base_price = 100.0
bulk_class = "non_physical"
unit = "contracts"
production_ubiquity = "common"
demand_model = "compliance"
demand_model = "market"
commission_certified = false
compact_contested = false
shadow_viable = false
@@ -502,7 +502,7 @@ base_price = 200.0
bulk_class = "non_physical"
unit = "contracts"
production_ubiquity = "regional"
demand_model = "utility"
demand_model = "market"
commission_certified = true
compact_contested = true
shadow_viable = true
@@ -537,7 +537,7 @@ commission_certified = true
compact_contested = true
shadow_viable = false
panic_threshold_weeks = 0
description = "Lattice Commission regulatory certification. Tractus-denominated. Availability inverse to shadow economy."
description = "Lattice Commission regulatory certification. Tractus-denominated. Availability inverse to shadow economy. Shadow-viable is false: you cannot shadow-market the Commission's own stamp — you shadow-market the goods that skip certification."
# ==========================================================================
@@ -588,4 +588,4 @@ commission_certified = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Restaurants, hotels, gastronomy."
description = "Corridor taverns, station cantinas, Talbreu taphouses. Cultural dining reflecting local heritage and transit-corridor traditions."
@@ -47,11 +47,7 @@ Gestalt's initial recommendation was Level 2 (no energy transmission). Resolved
### Fusion fuel as intermediate with 8:1 water yield (D-187)
Positioned as an intermediate (water → fusion_fuel at 8:1), not a raw material. Creates a structural frontier energy cost premium via compounding water transport costs without requiring event generation. Demand is entirely `demand_model = utility` (exogenous per-node consumption) — it does not appear as an input in any Leontief production chain. **Server team must implement a utility consumption mechanism** separate from the Leontief matrix (all commodities with `demand_model = utility` require a population × per-capita consumption rate multiplier per active node).
Burnelli-Sheldon flagged the 25% refining margin as negative at non-local-water nodes. Accepted: this is the intended behavior — fuel refining clusters at water-rich nodes, creating the geographic pattern without simulation scripting.
Burnelli-Sheldon recommended adding fusion_fuel as an input to smelting, alloys, and electronics to create an industrial cascade. This was adopted in the final TOML: `smelt_ore` (0.3), `alloy_fabrication` (0.2), `electronics_fabrication` (0.2). Fusion fuel has BOTH Leontief chain demand AND utility demand (`demand_model = utility` for per-node operational consumption).
Positioned as an intermediate (water → fusion_fuel at 8:1), not a raw material. Creates a structural frontier energy cost premium via compounding water transport costs without requiring event generation. Fusion fuel has two demand sources: (1) Leontief chain inputs to `smelt_ore` (0.3), `alloy_fabrication` (0.2), and `electronics_fabrication` (0.2), and (2) `demand_model = utility` for per-node operational consumption (population × per-capita rate). The chain demand was added after B-S and Gestalt independently flagged that fuel with zero chain presence would have no industrial cascade. **Server team must implement the utility consumption mechanism** separate from the Leontief matrix for all commodities with `demand_model = utility`.
### Final catalog: 36 commodities, 21 chains