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:
@@ -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)
|
||||
@@ -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)
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user