Governor bounce 4 + owner guidance 2026-08-28 (structured, provable, full lifecycle):
1. site model is data, not prose: new mine_sites table (ore, gates, rock_count,
respawn_seconds, rolls_per_ore, modeled_ores_per_hour, world_hop, selectable,
inventory_policy, access, safety, route). Adamantite @ Al Kharid south is now
respawn-BOUND (2 rocks, 240 s respawn): modeled 120 ores/hr ONLY with world
hopping (wiki F2P adamantite guide) = 70,080 gp/hr; no-hop ceiling ~30/hr =
17,520; the 839 ores/hr iron-cadence fantasy is gone and a cadence-ceiling
gate rejects it. Runite is selectable:false (Wilderness PK risk, ~12 min
respawn) — refused, not hand-waved. New hop state + hop_world action (a14)
implement the world-hop policy; long-respawn selectable sites REQUIRE
world_hop + a hop_world action (validator).
2. fast-xp success model: rolls_per_ore 1.33 (61+, derived from the wiki 52,500
benchmark: 1,500 ores/hr / 2,000 3-tick rolls/hr); rates recomputed with
success rolls + respawn math (3 rocks x 3.59 s = 10.8 s > 5.4 s respawn ->
zero idle, pinned) + drop/bank + breaks: xp_per_hour 28,000 (was 32,400 with
a flat 0.3 s and 1 ore/click); 52,500 stays a labeled external benchmark.
3. sub-29 fast-xp preserved: South-east Varrock DROP site (safe, same mode) —
the mode never silently switches to banking.
4. tool prep executable end to end: check-tool (has_item) -> withdraw-tool
(owned branch, bank_inventory) or buy-tool + wait-ge-fill (ge_offers_done) +
collect-tool (ge_collect, verify) -> equip-tool via menu_option Wield with
the Attack gate; recovery on purchase/equip failure (3 -> failed).
5. VALIDATOR PROVES THE CONTRACT (no phrase-search): pickaxe_tiers must match
the canonical F2P table exactly (Mining=use gate, Attack=equip gate,
roll_ticks); pickaxe_examples recomputed per row (1-Attack/41-Mining must
select + CARRY rune; 40-Attack/70-Mining equips; 5-Attack/30-Mining carries
mithril); both modes declared with fixed inventory policies; mode refs must
resolve to declared selectable policy-matching sites; Wilderness selectable
-> error; modeled ores/hr <= 3600/(rolls_per_ore x 2.7 s); xp_per_hour
within 2% of the modeled fast-xp rate. 13 committed --selftest fixtures
(negative cases included) wired into every gate run.
Evidence: validate 2 entries 0 errors 1 pre-existing WARN; --selftest 13 PASS;
synthetic 3-way merge main 79cab78 (incl. catalog) + head clean + gate green;
git diff --check clean. version 4 -> 5.
Owner decision 2026-08-28: expose separate fast-xp (powermine, drop) and
banked-income (deterministic target ore + mine, bank) modes; never select
highest-available rocks. Separate pickaxe gates per tier: Mining level
decides usability (rune 41), Attack only equipping (rune 40) — pinned
1-Attack/41-Mining carry-and-use example. Modeled policy rates recomputed
with cadence, respawn idle, drop/bank legs and breaks (fast-xp ~32,400
XP/hr; banked iron ~56,500 gp/hr); 52,500 kept as labeled external
benchmark only. Worked examples per mode covering preparation -> first
full inventory -> first break -> resume. Validator now proves the gate
distinction and both modes for mining entries.
- Dynamic inventory/drop model: no hardcoded 27-slot count; drop loop
driven by count_item ore + inventory full; equip only when Attack
requirement met (rune = 40 Attack), else carry pickaxe in inventory
- Outcome wait: new wait_rock state — re-click only on ore gained, rock
depleted, or roll timeout; never re-click the active rock
- Tier-aware cadence: roll_table per pickaxe tier (bronze 4.8s -> rune
1.8s), mandatory pause >= full roll + [0,1800]ms; anchor rune [1800,3600]
- Al Kharid hard-gated to combat 29+ (scorpion aggro ceiling 28 per wiki
Aggressiveness); sub-29 -> SE Varrock, no food in the model, eat action
removed; survive = retreat-only defensive fallback
- version 2 -> 3
- Powermine drop loop: model per-slot Dropping of non-stackable ores —
drop_run now self-loops (count_item ore > 0 -> drop_run) until the
inventory is empty, then back to mine; a6 drops one occupied slot per
execution and its params state the iteration contract.
- Click cadence: a2 delay was 600-1400ms, below the rune pickaxe 3-tick
(1.8s) mining roll — replaced with 2000-4200ms and comment distinguishing
the roll interval from translator re-click cadence (bronze 8 ticks = 4.8s
note).
- Al Kharid survivability: route gate modeled - scorpion is level 14 and
attacks players at combat <= 28 (wiki Aggressiveness, 2x rule), so Al
Kharid powermine requires combat 29+ or food; new survive state with eat/
retreat actions (a7/a8), hard-failure path (food exhausted + low HP ->
failed; death = hard failure, no respawn claim). Banked South-east Varrock
route preserved for sub-29 accounts. version 1 -> 2. Validator: 0 errors,
1 pre-existing F2P WARN.
