rrt/docs/atlas/company-and-ledger.md

# Company and Ledger

Primary atlas sources:

- [control-loop-atlas.md#input-saveload-and-simulation](/home/jan/projects/rrt/docs/control-loop-atlas.md#input-saveload-and-simulation)

This view isolates the company-side shell panes, linked-transit company maintenance, city-connection
news, and annual finance-policy thresholds.

Current grounded owners:

- `shell_company_list_window_construct`
- `shell_company_detail_window_construct`
- `shell_company_detail_window_handle_message`
- `shell_load_screen_window_construct`
- `company_service_periodic_city_connection_finance_and_linked_transit_lanes`
- `company_evaluate_annual_finance_policy_and_publish_news`
- `company_balance_linked_transit_train_roster`
- `company_try_buy_unowned_industry_near_city_and_publish_news`
- `company_evaluate_and_publish_city_connection_bonus_news`
- `simulation_try_select_and_publish_company_start_or_city_connection_news`

Current bounded finance verbs:

- bankruptcy
- bond repayment
- bond issuance
- public-share repurchase
- public-share issuance
- dividend adjustment

Current bounded shell families:

- `CompanyDetail.win`
- `CompanyList`
- `LoadScreen.win`

What this note is for:

- CompanyDetail section ownership and finance dialogs
- Ledger and report-page ownership
- Linked-transit autoroute and train-roster maintenance
- City-connection announcement and bonus lanes
- Annual finance-policy thresholds and same-cycle reaction latches

Current bounded linked-transit cache outputs:

- peer row `+0x05`: route-step count from the tracker metric chooser
- peer row `+0x09`: normalized continuity share `(steps - mismatches) / max(steps, 1)`
- site cache `+0x12`: raw surviving linked-transit site-score total
- site cache `+0x0e`: continuity-and-step-weighted companion total
- site cache `+0x16`: promoted final autoroute site-ranking lane
- `company_compute_owned_linked_transit_site_score_total`: converts summed site `+0x12` totals
  into the train-roster target through year and site-count ladders, plus the special build-`1.03+`
  two-site distance branch

Current bounded compatibility impact:

- the pre-`1.03` versus `1.03+` tracker metric split mainly perturbs peer continuity and weighted
  site ranking
- that means it can change which site `0x00408280` prefers and which peer `0x00408380` seeds into
  a train route
- current evidence says it does not directly move the company train-pressure target in
  `0x00408f70`, because that target sums raw site cache `+0x12` rather than the weighted `+0x0e`
  or promoted `+0x16` lanes

Highest-value open edge:

- The remaining semantic meaning of the annual finance policy branches is now narrower:
  stat-family `0x2329/0x1d` is now bounded as current `Book Value Per Share` in the stock-issue
  denominator path, `0x2329/0x0d` is now bounded there as the current cash gate before the
  bond-rate-versus-support ladder, the broader support-adjusted share-price or public-support lane
  is now bounded through `company_compute_public_support_adjusted_share_price_scalar` `0x00424fd0`,
  and its immediate feeder is now bounded as
  `company_compute_cached_recent_per_share_performance_subscore` `0x004248d0`, which weighs recent
  `Revenue Per Share`, `Earnings Per Share`, and `Dividend Per Share` lanes `0x1e/0x1f/0x20`
  against current `Book Value Per Share`, while `0x21` now routes through
  `company_compute_five_year_weighted_shareholder_return` `0x004246b0` and its paired hidden
  shareholder-payout lane `0x23`,
  raw slot `0x09` aligns with the Income Statement fuel-cost lane surfaced by tooltip `1309`, and
  derived slot `0x2b` now reads as the rolling net-profits lane. The main remaining gap is the
  exact weight schedule and gate ordering used inside the already-bounded annual bankruptcy,
  debt, repurchase, stock-issue, and dividend branches. The current strongest read is now:
  bankruptcy = first the year, toggle, and cooldown gates, then the three-year scan, then the
  revenue-band-selected cash-and-debt ladder, then the support-adjusted share-price threshold,
  then the fuel-cost lane and net-profit accumulator; the later deep-distress fallback then
  re-checks cash below `-300000` plus the first three recent profit years at or below `-20000`.
  Stock issuance = first the bond/stock toggle gates, then the outstanding-share tranche sizing,
  then the `55000` proceeds cap, then the support-adjusted price-to-book screen against the
  highest live coupon band. Dividend adjustment = first the toggle and age gates, then the
  weighted recent-profit-per-share target, then the small-unassigned-share cash supplement, then
  the board ceiling clamp. The remaining gap is now mostly the near-cutoff ordering inside the
  stock-issue lane, and the current strongest read places the liquidity gate at `0x2329/0x0d`
  before the valuation gate at `0x2329/0x1d`. The dividend-ceiling clamp is already separately
  bounded on the dividend branch. That is now a final precedence question, not a missing
  ownership gap in the annual finance verbs themselves. The debt-news tail is also now explicit:
  it compares total retired versus newly issued principal to pick `2882..2886`, and the
  stock-buyback tail separately publishes `2887` from the accumulated repurchased-share count.