Skip to content

HOURS EOH Framework

Module Map

Hours-Source/HOURS

Module Map¶

The hours_eoh package is organized into four layers with strict import rules.

EOH → TEH Pipeline

Layer Architecture¶

hours_eoh/
  data.py              All named constants — single source of truth
  params.py            EohParams — mutable parameter container

  core/                Pure physics + mechanics — stable API
    trajectory.py          Canonical arc + ε derivation
    eoh_generation.py      Four EOH domain functions + total_eoh()
    registration.py        Sigmoid admission curves per domain
    eoh_fulfillment.py     EOH → TEH pipeline
    multipliers.py         Condition II: multiplier band and tier logic
    fiscal.py              Levies, allocation, guarantee, trust
    prices.py              Price dynamics tied to human labor content
    capital.py             Asset and human capital lifecycle
    eoh_dynamics.py        Time-evolution: compounding, regenerative labor
    population.py          Population structure, age distribution
    workforce.py           Workforce lifecycle, competency reserve
    conditions.py          Structural conditions I–IV enforcement
    dashboard.py           Condition monitors + health indicators
    civilization.py        Endogenous ε from capital stock
    simulation.py          Period simulation engine

  land/                Ground Use Fee + stewardship lease mechanics
    guf.py                 GUF framework (NLSA TM-0042)

  scenarios/           Applied research: stress tests and scenario runners
    sweep.py               epsilon_sweep — arc coherence check
    shocks.py              automation_failure_shock, demographic_shock, ecological_eoh_spike
    maintenance.py         deferred_maintenance_crisis, care_registration_delay
    recovery.py            maintenance_recovery_schedule, minimum_fulfillment_for_recovery
    sensitivity.py         fiscal_parameter_sweep, eoh_arc_sensitivity

  research/            Experimental — NOT stable API
    investment.py          rank_investment_candidates, optimal_investment
    writedown.py           Redirect: eco-collapse resolved via land/guf.py §9

Import Rules¶

Layer	May import from	Never imports from
`core/`	`data.py`, `params.py`, other `core/`	`land/`, `scenarios/`, `research/`, `utils/`
`land/`	`core/`	`scenarios/`, `research/`, `utils/`
`scenarios/`	`core/`	`land/`, `research/`, `utils/`
`research/`	`core/` (re-exports only)	all others
`utils/`	All layers freely	Never imported by any layer

What you want	Where to look
Constants and calibration values	Parameters & Constants
EOH generation from physical state	EOH Generation
EOH → TEH pipeline	EOH Fulfillment & Registration
Price and basket functions	Price Dynamics
Levies, Trust, Guarantee	Fiscal Mechanics
Capital write-down, birth/death	Capital & Population
Structural conditions I–IV	Conditions & Dashboard
Ground Use Fee	Land — GUF Module
Scenario runners	Scenarios
Simulation engine	Simulation Engine