Skip to content

Conditions & Dashboard

Modules: hours_eoh/core/conditions.py, hours_eoh/core/dashboard.py

These modules form the structural integrity layer. conditions.py enforces the four Structural Conditions; dashboard.py provides health indicators and the system-level integrity check.

Structural Conditions (conditions.py)

condition_i_check(teh_created, teh_destroyed, teh_observed, …) → dict

Verifies the Ledger Identity: TEH in circulation equals cumulative creation minus cumulative destruction. A gap means TEH was created outside the fulfillment pipeline or destroyed by a mechanism other than terminal consumption or capital write-down.

condition_ii_check(mean_multiplier, …) → dict

Verifies the Multiplier Band: the population-weighted mean is within [band_low, band_high]. Delegates to multipliers.multiplier_band_check().

balance_check(balance_start, earnings, expenditures, balance_end, …) → dict

Verifies Condition III for one balance: B(t+Δt) = B(t) + E − X, with no third term.

condition_iii_balance_growth_check(prev_balance, new_balance, labor_income, expenditure, …) → dict

The same zero-interest invariant for a single period, stated as a balance delta: the only valid source of growth is labor income minus expenditure.

condition_iv_check(workforce, competent_workers, …) → dict

Verifies Distributed Competency: the share of the workforce with certified competency across essential domains meets the recommended threshold (15.5%).

from hours_eoh.core.conditions import condition_iv_check

result = condition_iv_check(
    workforce=600_000,
    competent_workers=96_000,
    domain_coverage={"agriculture": 0.03, "healthcare": 0.04},
)
print(result["passes"], result["reserve_fraction"], result["status"])

dashboard_snapshot(teh_created, teh_destroyed, teh_observed, mean_multiplier, balance_start, earnings, expenditures, balance_end, workforce, competent_workers, epsilon, …) → dict

Single-call all-conditions check at ε.

domain_eoh_coverage(reserve_result, domain_eoh_demands, …) → dict

Whether the certified workforce can actually cover each domain's EOH. Condition IV checks certified fractions, not capacity: a domain whose EOH has outgrown its certified workers passes Condition IV and is still in shortfall, and this is the check that sees it.

Dashboard (dashboard.py)

eoh_health_indicators(total_eoh, fulfilled_eoh, epsilon, …) → dict

EOH-side health: the deferred-maintenance ratio, the compounding rate of the deferred backlog, registration coverage, and the personal registration share.

fiscal_health_check(trust_balance, labor_income, capital_stock_teh, capital_age_ratio, population, floor_teh, epsilon, …) → dict

Fiscal health: Trust solvency (can it fund stewardship and the guarantee together), the floor purchasing-power index, and levy sufficiency against the guarantee.

system_dashboard(epsilon, teh_created, teh_destroyed, teh_observed, balance_start, earnings, expenditures, balance_end, certified_by_domain, workforce_size, total_eoh, fulfilled_eoh, trust_balance, labor_income, capital_stock_teh, capital_age_ratio, population, floor_teh, …) → dict

Comprehensive system health snapshot: all four Structural Conditions, EOH health and fiscal health in one report. The overall status is the worst of the individual statuses.

system_dashboard() takes the period's accounts as keyword arguments — TEH created, destroyed and observed, the Trust's opening and closing balance, the certified workforce by domain, total and fulfilled EOH — because a structural check is only as good as the ledger figures it is given. The quickest way to see it assembled is the CLI:

python3 utils/eoh_cli.py dashboard --epsilon 0.40

Read the CLI's assembly as a demonstration on the reference frame, not a measurement of a collective. Its EOH accounts come from the pipeline, and its ledger and Trust accounts from one simulated period on the same frame. One input is declared rather than tracked — the certified share of the workforce, which nothing in the package measures (--certified-fraction) — and the command prints it as declared. For a real collective, pass your own ledger figures.

The dashboard is the constitution's test bench

Green means every check it runs passes on the accounts it was given — not that the system works. A yellow or red reading is reported, never tuned away. See Design Principle 8.