# ==========================================================================
# Settled Reach — Commodity Catalog
# Source of truth. Compiled to systems.db via `make economy-db`.
#
# Fields:
#   name                    Display name (Title Case)
#   tier                    raw | intermediate | final | service_professional | service_luxury
#   elasticity              perfectly_inelastic | inelastic | unit_elastic | elastic
#   base_price              Equilibrium price in Tractus (float > 0)
#   bulk_class              bulk | liquid | perishable | standard | compact | precision | oversized | non_physical
#   unit                    tonnes | units | contracts
#   production_ubiquity     ubiquitous | common | regional | concentrated | monopolistic
#   demand_model            market | utility | compliance
#   commission_certifiable    Requires Commission certification for formal sale
#   compact_contested       Compact contests Commission authority over this
#   shadow_viable           Shadow market routinely exists
#   panic_threshold_weeks   Stockpile level (in weeks) triggering panic hoarding; 0 = no panic
#   description             Flavor text (optional, not consumed by sim)
#
# Decisions: D-173 (taxonomy), D-177 (constraints), D-178 (model), D-182 (TOML pipeline)
# ==========================================================================


# ==========================================================================
# RAW MATERIALS (9)
# Extracted or harvested. Location-bound production.
# ==========================================================================

[metallic_ore]
name = "Metallic Ore"
tier = "raw"
elasticity = "unit_elastic"
base_price = 10.0
bulk_class = "bulk"
unit = "tonnes"
production_ubiquity = "common"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Ferrous and non-ferrous ore from planetary mines and asteroid operations."

[rare_minerals]
name = "Rare Minerals"
tier = "raw"
elasticity = "unit_elastic"
base_price = 80.0
bulk_class = "precision"
unit = "tonnes"
production_ubiquity = "concentrated"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Exotic crystals, rare earths. Scarce, location-specific. Critical bottleneck for high-tech manufacturing."

[lattice_grade_material]
name = "Lattice-Grade Material"
tier = "raw"
elasticity = "unit_elastic"
base_price = 120.0
bulk_class = "precision"
unit = "tonnes"
production_ubiquity = "monopolistic"
demand_model = "market"
commission_certifiable = true
compact_contested = false
shadow_viable = true
panic_threshold_weeks = 0
description = "Crystalline substrates for neural lattice fabrication and gate optics. East reach anchor. Strategic material."

[timber]
name = "Timber"
tier = "raw"
elasticity = "unit_elastic"
base_price = 15.0
bulk_class = "bulk"
unit = "tonnes"
production_ubiquity = "regional"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Structural and decorative wood from managed forests. 40-60 year replanting cycles."

[agricultural_produce]
name = "Agricultural Produce"
tier = "raw"
elasticity = "inelastic"
base_price = 5.0
bulk_class = "perishable"
unit = "tonnes"
production_ubiquity = "ubiquitous"
demand_model = "utility"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Food crops, livestock, grain, grapes. Every terraformed world produces some."

[water]
name = "Water/Volatiles"
tier = "raw"
elasticity = "perfectly_inelastic"
base_price = 2.0
bulk_class = "liquid"
unit = "tonnes"
production_ubiquity = "ubiquitous"
demand_model = "utility"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 1
description = "Water ice, atmospheric gases. Life support critical. Fusion fuel feedstock."

[organic_compounds]
name = "Organic Compounds"
tier = "raw"
elasticity = "unit_elastic"
base_price = 35.0
bulk_class = "standard"
unit = "tonnes"
production_ubiquity = "regional"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Biochemicals, pharmaceutical precursors, biological feedstock. Requires complex biosphere."

[stone]
name = "Stone/Aggregate"
tier = "raw"
elasticity = "unit_elastic"
base_price = 8.0
bulk_class = "bulk"
unit = "tonnes"
production_ubiquity = "common"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Construction stone, ceramics feedstock. Substitution route for structural panels."

[chemical_feedstock]
name = "Chemical Feedstock"
tier = "raw"
elasticity = "unit_elastic"
base_price = 12.0
bulk_class = "liquid"
unit = "tonnes"
production_ubiquity = "common"
demand_model = "market"
commission_certifiable = true
compact_contested = true
shadow_viable = true
panic_threshold_weeks = 0
description = "Industrial gases, reaction mass, solvents. Hazmat certification required."


# ==========================================================================
# INTERMEDIATE GOODS (10)
# Processed from raws. Transportable through gates.
# ==========================================================================

[refined_metals]
name = "Refined Metals"
tier = "intermediate"
elasticity = "inelastic"
base_price = 30.0
bulk_class = "standard"
unit = "tonnes"
production_ubiquity = "common"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Structural steel, copper wire, aluminum. Backbone of construction and manufacturing."

[advanced_alloys]
name = "Advanced Alloys"
tier = "intermediate"
elasticity = "unit_elastic"
base_price = 100.0
bulk_class = "standard"
unit = "tonnes"
production_ubiquity = "regional"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "High-performance materials for hulls, gate infrastructure, precision machinery."

[fusion_fuel]
name = "Fusion Fuel"
tier = "intermediate"
elasticity = "perfectly_inelastic"
base_price = 20.0
bulk_class = "liquid"
unit = "tonnes"
production_ubiquity = "common"
demand_model = "utility"
commission_certifiable = true
compact_contested = true
shadow_viable = true
panic_threshold_weeks = 2
description = "Deuterium/tritium refined from water at 8:1 ratio. Continuous consumption. Every system needs it."

[processed_food]
name = "Processed Food"
tier = "intermediate"
elasticity = "inelastic"
base_price = 15.0
bulk_class = "standard"
unit = "tonnes"
production_ubiquity = "ubiquitous"
demand_model = "utility"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 2
description = "Shelf-stable, transportable food products."

[electronics]
name = "Electronics/Components"
tier = "intermediate"
elasticity = "unit_elastic"
base_price = 120.0
bulk_class = "compact"
unit = "units"
production_ubiquity = "regional"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Circuits, processors, control systems. Rare mineral-dependent. Input to nearly every final good."

[chemicals]
name = "Chemicals/Pharmaceuticals"
tier = "intermediate"
elasticity = "inelastic"
base_price = 60.0
bulk_class = "standard"
unit = "tonnes"
production_ubiquity = "regional"
demand_model = "market"
commission_certifiable = true
compact_contested = true
shadow_viable = true
panic_threshold_weeks = 3
description = "Medicines, industrial chemicals, life support consumables. Two production paths."

[textiles]
name = "Textiles/Composites"
tier = "intermediate"
elasticity = "unit_elastic"
base_price = 50.0
bulk_class = "standard"
unit = "tonnes"
production_ubiquity = "regional"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Clothing, technical fabrics, composite materials."

[structural_panels]
name = "Structural Panels"
tier = "intermediate"
elasticity = "unit_elastic"
base_price = 45.0
bulk_class = "standard"
unit = "units"
production_ubiquity = "regional"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Pre-fabricated building components. Two production paths: timber or stone."

[drive_cores]
name = "Drive Cores"
tier = "intermediate"
elasticity = "elastic"
base_price = 200.0
bulk_class = "compact"
unit = "units"
production_ubiquity = "concentrated"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Propulsion components. High-value, specialized. Double rare-minerals dependency."

[lattice_substrate]
name = "Lattice Substrate"
tier = "intermediate"
elasticity = "unit_elastic"
base_price = 180.0
bulk_class = "compact"
unit = "units"
production_ubiquity = "concentrated"
demand_model = "market"
commission_certifiable = true
compact_contested = false
shadow_viable = true
panic_threshold_weeks = 0
description = "Processed neural lattice wafers and gate optics. From lattice-grade material."


# ==========================================================================
# FINAL GOODS (9)
# Assembled from intermediates. End of production chain.
# ==========================================================================

[heavy_equipment]
name = "Heavy Equipment"
tier = "final"
elasticity = "elastic"
base_price = 250.0
bulk_class = "oversized"
unit = "units"
production_ubiquity = "regional"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Mining rigs, construction machinery. 1-3 year lead times."

[transport_vehicles]
name = "Transport Vehicles"
tier = "final"
elasticity = "elastic"
base_price = 350.0
bulk_class = "oversized"
unit = "units"
production_ubiquity = "regional"
demand_model = "market"
commission_certifiable = true
compact_contested = true
shadow_viable = false
panic_threshold_weeks = 0
description = "Ships, ground vehicles. Commission safety registration."

[freight_haulers]
name = "Freight Haulers"
tier = "final"
elasticity = "elastic"
base_price = 300.0
bulk_class = "oversized"
unit = "units"
production_ubiquity = "concentrated"
demand_model = "market"
commission_certifiable = true
compact_contested = true
shadow_viable = false
panic_threshold_weeks = 0
description = "Commercial cargo vessels. Demand driven by trade volume, not population."

[consumer_goods]
name = "Consumer Goods"
tier = "final"
elasticity = "unit_elastic"
base_price = 80.0
bulk_class = "compact"
unit = "units"
production_ubiquity = "ubiquitous"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Daily necessities, household items, personal tech."

[implant_hardware]
name = "Implant Hardware"
tier = "final"
elasticity = "elastic"
base_price = 400.0
bulk_class = "precision"
unit = "units"
production_ubiquity = "concentrated"
demand_model = "market"
commission_certifiable = true
compact_contested = true
shadow_viable = true
panic_threshold_weeks = 0
description = "Neural interfaces, lattice components. THE Compact political flashpoint. D-037 adjacent."

[medical_goods]
name = "Medical Goods"
tier = "final"
elasticity = "inelastic"
base_price = 200.0
bulk_class = "compact"
unit = "units"
production_ubiquity = "regional"
demand_model = "market"
commission_certifiable = true
compact_contested = true
shadow_viable = true
panic_threshold_weeks = 0
description = "Pharmaceuticals, surgical equipment, diagnostics, re-embodiment supporting hardware."

[gate_components]
name = "Gate Components"
tier = "final"
elasticity = "elastic"
base_price = 800.0
bulk_class = "oversized"
unit = "units"
production_ubiquity = "monopolistic"
demand_model = "market"
commission_certifiable = true
compact_contested = true
shadow_viable = true
panic_threshold_weeks = 0
description = "Gate maintenance and construction parts. Gate Corporation monopoly. Triple rare-minerals dependency."

[habitat_modules]
name = "Habitat Modules"
tier = "final"
elasticity = "unit_elastic"
base_price = 150.0
bulk_class = "oversized"
unit = "units"
production_ubiquity = "regional"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Complete living/working units for stations and settlements. 2-5 year lead times."

[rail_infrastructure]
name = "Rail Infrastructure"
tier = "final"
elasticity = "unit_elastic"
base_price = 180.0
bulk_class = "oversized"
unit = "units"
production_ubiquity = "regional"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Planetary transit systems, trains, intra-system transport networks."


# ==========================================================================
# PROFESSIONAL SERVICES (7)
# Location-bound. Non-transportable through gates.
# ==========================================================================

[legal_services]
name = "Legal Services"
tier = "service_professional"
elasticity = "inelastic"
base_price = 100.0
bulk_class = "non_physical"
unit = "contracts"
production_ubiquity = "common"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Contract enforcement, dispute resolution, commercial law."

[financial_services]
name = "Financial Services"
tier = "service_professional"
elasticity = "inelastic"
base_price = 120.0
bulk_class = "non_physical"
unit = "contracts"
production_ubiquity = "common"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Banking, credit, clearing, currency exchange. Cross-zone settlement infrastructure."

[medical_services]
name = "Medical/Re-embodiment Services"
tier = "service_professional"
elasticity = "inelastic"
base_price = 200.0
bulk_class = "non_physical"
unit = "contracts"
production_ubiquity = "regional"
demand_model = "market"
commission_certifiable = true
compact_contested = true
shadow_viable = true
panic_threshold_weeks = 0
description = "Healthcare, neural backup, licensed re-embodiment. Unlicensed variant is canonical contraband."

[insurance]
name = "Insurance/Risk"
tier = "service_professional"
elasticity = "unit_elastic"
base_price = 75.0
bulk_class = "non_physical"
unit = "contracts"
production_ubiquity = "regional"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Cargo, liability, corporate risk management. Affects trade volume through risk pricing."

[commission_certification]
name = "Commission Certification"
tier = "service_professional"
elasticity = "inelastic"
base_price = 100.0
bulk_class = "non_physical"
unit = "contracts"
production_ubiquity = "concentrated"
demand_model = "compliance"
commission_certifiable = true
compact_contested = true
shadow_viable = false
panic_threshold_weeks = 0
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."


# ==========================================================================
# LUXURY/EXPERIENTIAL SERVICES (3)
# Location-bound. Discretionary consumption.
# ==========================================================================

[tourism]
name = "Tourism"
tier = "service_luxury"
elasticity = "elastic"
base_price = 100.0
bulk_class = "non_physical"
unit = "contracts"
production_ubiquity = "concentrated"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Cultural tourism, prestige destinations. Cannot freight the experience."

[entertainment]
name = "Entertainment/Holo-content"
tier = "service_luxury"
elasticity = "elastic"
base_price = 30.0
bulk_class = "non_physical"
unit = "contracts"
production_ubiquity = "common"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Performances, holo-content, cultural production."

[hospitality]
name = "Fine Dining/Hospitality"
tier = "service_luxury"
elasticity = "elastic"
base_price = 60.0
bulk_class = "non_physical"
unit = "contracts"
production_ubiquity = "regional"
demand_model = "market"
commission_certifiable = false
compact_contested = false
shadow_viable = false
panic_threshold_weeks = 0
description = "Corridor taverns, station cantinas, Talbreu taphouses. Cultural dining reflecting local heritage and transit-corridor traditions."