Magic/Alchemy PR #10 landed on main; this integrates it into the woodcutting
branch and resolves the predicted tools/validate.py conflict:
- union of all validator gates: magic/alchemy (recipe/rate/tier/loadout,
supply_limit_conflicts, document_error + _end_to_end_bad_mapping),
mining (pickaxe suite), GE-flip lifecycle (floor-tax + scheduler +
conservation + slot-phase + buy-capacity + slot-reuse), and the
woodcutting gates (canonical axe table, per-mode ladders, per-selected-
row 27/28 dynamic rates, drop-GP-zero, prepare/failed/drop-gate wiring).
- governor 10637: removed the run_flip_selftest alias duplication — the
combined GE/Woodcutting suite no longer runs twice. Each suite now runs
exactly once per invocation: run_selftest (cross-field/alchemy),
run_flip_selftest (GE lifecycle), run_mining_selftest, and the new
run_woodcutting_selftest. Truthful unique selftest count: 144 PASS.
- tree scan: 6 entries, 0 errors, 0 warnings; git diff --check clean.
The merged alch_worked_example_regression gate requires the worked example to pin monotonic restock counters at 901/1,802 as well as breaks at 550/1,100/1,650; the 9-cast SII steel-path pins were already monotonic, this adds the alch-tier batch-cadence pins consistently with the entry's declared model.
Owner guidance 2026-08-29 for governor review 10476 (PR #11), finding by finding:
1. Explicit tier rank/tie-break for equal Mining gates. pickaxe_tiers
declared bronze and iron both at Mining 1 / Attack 1 while the
level-1 worked example called bronze canonical and carried it (27
slots) — internally contradictory under the entry's own
highest-unlocked acquisition policy. pickaxe_tiers now carries an
explicit rank (bronze 1 .. rune 6) and the selection rule resolves
equal Mining gates by rank: Mining 1 deterministically selects IRON
(7-tick roll, rank 2) over bronze (rank 1), and Attack 1 EQUIPS it
(iron attack gate = 1) -> 28 ore slots. Stated at every policy
layer (summary, accounts.requires_other, best_practice.equipment,
prepare state, economy.supplies, a14 equip-tool gate, pickaxe_tiers
head comment). An owned-only bronze run is documented as an operator
choice, never the entry's selection rule.
2. Level-1 lifecycle/rate inputs recomputed. The level-1 worked
example now uses the equipped iron pickaxe: 28 ore slots per drop
load, iron cadence [4200, 6000] ms (midpoint 5.1 s), and the
copper/tin rate re-derived from that cadence: 1.6 rolls x 5.1 + 0.5
drop + 0.39 break = 9.05 s/ore -> 398 ores/hr -> ~6,960 XP/hr (pin
6,900), replacing the bronze-midpoint 360 ores/hr / 6,300 XP/hr.
Updated in mine_sites (se-varrock-copper / se-varrock-tin),
economy comment block, profit_drivers, worktree example, and risk
notes; no other rate changes (fast-xp iron 28,000 and banked rates
untouched).
3. Recomputed 1-Attack/1-Mining fixture + capacity proof. Schema:
pickaxe_tiers gains required rank (1..6); pickaxe_examples gain
required expected_slots (28 equipped / 27 carried). Validator:
select_pickaxe() ties by rank; every pickaxe_examples row is
recomputed including expected_slots, the 1-Attack/41-Mining
rune-carry fixture is preserved, and the 1-Attack/1-Mining row is
now mandatory (selects iron, equipped, 28). Committed negative
fixtures f18-f22: bronze-at-Mining-1, carried-at-Attack-1, wrong
slots, missing 1/1 fixture, and a tier missing rank are all
rejected (22 selftests pass).
Preserved: complete GE tool acquisition loop, structured copper/tin
below-15 fallback, fast-xp/banked-income modes, dynamic 27/28
inventory handling, declared banked targets, respawn/world-hop model,
and all prior rate gates. version 6 -> 7, updated 2026-08-29.
Gate: python3 tools/validate.py -> 2 entries, 0 errors, 1 pre-existing
F2P WARN (low-alch-f2p researched, untouched); --selftest -> 22 PASS;
git diff --check clean.
Governor bounce 5 (2026-08-28) repaired finding by finding:
1. Tool purchase is now executable end to end: new a10 ge_open before any
ge_buy; a12 wait-ge-fill is BOUNDED (one 3-6 min fill window) and on
no-fill/partial-fill TIMEOUT cancels the resting offer -> a13
collects/refunds -> fail closed via recover (3 loops -> failed); a resting
offer is never re-placed indefinitely. Actions renumbered a11..a17.
2. min_level 1 copper/tin below-15 path now has STRUCTURED fallback rows
(mine_sites se-varrock-copper / se-varrock-tin, level 1, 17.5 xp, safe
East Varrock) added to mining_modes.fast-xp.sites; level-1 and level-14
selections are pinned in a new mining_selections block and recomputed by a
new select_fast_site() validator gate (+ 3 committed selftest fixtures).
3. a2 no longer advertises silver/coal/gold/mithril banked targets: it
restricts banked-income to the declared rows (iron @ se-varrock-bank,
adamantite @ al-kharid-south-adamantite); superheat-coal technique is
marked informational-only. New ge_open/ge_offers_done/ge_collect
validator gate (+ 1 fixture). Modeled below-15 rate 6,300 XP/hr (was
the unbacked '~8,800' prose) recomputed from the bronze cadence midpoint.
Validator: 2 entries, 0 errors, 1 pre-existing WARN; --selftest 17 PASS;
git diff --check clean.
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.
- Dragon Slayer I removed from accounts.requires_quest (empty for the
base entry); it now gates ONLY the optional Maple tier (a1 tier gate,
a2 maple route, idle transition)
- Dynamic inventory: no hardcoded 28-log assumption — equip the axe only
when the Attack requirement is met (rune/gilded = 41), otherwise chop
with the axe carried (27 log slots); inventory-full derived dynamically;
banking deposits logs ONLY, axe preserved
- version 2 -> 3
Governor-review (PR #10, attempt 2) findings, same issue-5 branch:
1. Pacing is additive. action-grammar.md defines anti_ban.delay as sleep
AFTER the action, so a cast takes 1.8s + 1.6-3.4s = 3.4-5.2s (mid
4.3s), ~837 casts/hr, not 1,400 or 1,800. Both entries now pin the
midpoint rate with the formula documented: LA 25,953 / SII 44,372 /
HLA 54,419 xp/hr. low-alch-f2p gp_per_hour bracketed by the delay
endpoints (-119,000 / -78,000).
2. run_control units agree: schema.md 'every' counts iterations and
iteration is one cast, so break.every [8, 14] is casts (comment no
longer claims bank cycles).
3. SII is now a concrete recipe. New top-level recipes: table models all
eight F2P smithable bars (bronze/iron/silver/steel/gold/mithril/
adamantite/runite) with every input and quantity (coal 2/4/6/8,
Smithing gates, bar ids) from the OSRS wiki smelting table. The
cast-superheat action pins params.recipe (steel-bar anchor) plus a
recipe_rule: smithing gate + complete input cost + one nature rune <
bar price; buy/withdraw the exact unnoted inputs; bank the bar.
entry.schema.json gains the optional 'recipes' section. Validator
gains recipe/SII checks and a deterministic steel-bar fixture
(1 iron + 2 coal = 3 inputs; margin 600 - (100 + 2*150 + 145) = 55).
4. Validator no longer crashes on malformed docs: scalar/empty YAML is
rejected with a normal ERROR (document shape check) and
supply_limit_conflicts guards non-mapping rows; regression fixtures
cover (bad.yaml, None), scalar docs, and undeclared recipe ids.
Tests: python3 tools/validate.py -> 2 entries, 0 errors, 0 warnings
(exit 0); --selftest -> 14 PASS; live negatives: scalar + empty docs
error cleanly (exit 1, no traceback), reintroduced 12500 divergence is
caught (supply-fact gate), git diff --check clean.
- 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
Governor-review bounce (PR #12) fixes on issue-3:
1. Maple IS F2P — restored as an optional level-45 tier. The only F2P
maples are the 4 trees in the Corsair Cove Resource Area (requires
Dragon Slayer I to enter), per the Free-to-play Woodcutting training
guide and Maple tree page (members1=No @ Corsair Cove). Entry no
longer labels Maple itself members-only; the quest gate is in
accounts.requires_quest and the tier route table.
2. XP-versus-income mode is now explicit: state machine and a1 gate-tier
take a mode parameter — XP mode stays on Willow (or Maple with Dragon
Slayer I) after 60; income mode selects Yew at Edgeville. The guide:
yew logs 'earn a profit' but 'it is recommended to cut willow or
maple trees for experience'. Default is XP mode; income must be an
explicit run parameter.
3. Bank loop is now executable and tier-specific: actions split into
walk-to-bank (a5) + deposit-logs (a6) + walk-back-to-trees (a7), and
the state machine pins chop -> walk_to_bank -> deposit_logs ->
walk_back -> chop with dedicated states. Per-tier tree+bank routes
(Lumbridge/Draynor/Edgeville/Corsair Cove) replace the hardcoded
Draynor-for-everything; Yew is routed to Edgeville (guide: 'best
place to chop yew trees is south of Edgeville bank').
4. Combat gate instead of a false no-combat claim: the Draynor willow
spot sits between two aggressive level-7 Dark Wizards that attack
players under combat 15 (Draynor Village wiki page). Accounts below
combat 15 are routed to the single Edgeville willow (bank adjacent);
relog/respawn N/A now scoped to the gated routes only, and the risk
notes call out Draynor as a combat zone for low-level accounts.
Tests: python3 tools/validate.py -> 2 entries, 0 errors, 1 pre-existing
warning (researched flag on low-alch-f2p, owned by issue #5's PR);
merged-tree check (main 79cab78 + head) keeps the issue-6 catalog,
gate clean; git diff --check clean.
- 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.
Governor-review bounce (PR #10) fixes on issue-5:
1. Timing units + rates: one OSRS tick = 0.6s so a 3-tick cast is 1.8s,
not 5.4s as both action comments claimed. The mandatory 1.6-3.4s
post-action delay (mid ~2.5s) allows ~1,440 casts/hr before overhead;
rates are now pinned at 1,400 casts/hr: LA 43,400 / SII 74,200 / HLA
91,000 xp/hr (was 55,800 / 95,400 / 117,000 @ 1,800). The old 1,800
figures were unreachable under the entries' own pacing.
2. Nature rune limit unified to 18000 (mapping 'limit' + Module:Exchange
agree, fetched live 2026-08-27): low-alch-f2p 12500 -> 18000, matching
magic-alch-handoff. tools/validate.py gains a cross-entry supply-fact
consistency check (same item+source must agree on ge_limit; run on
every gate invocation) plus --selftest regression fixtures: diverging
limits must fail, agreeing limits must pass, missing ge_limit is not
gated.
3. SII tier is now phase-aware and translatable: actions split into
cast-alch (LA/HLA -> cheapest alch candidate, noted stack) and
cast-superheat (SII 43-55 -> unnoted ore whose live bar margin is
positive; never a noted stack, never a price-only pick; on_fail skip
when no positive-margin ore). State machine pins each tier path
(LA <43, SII window chosen/skipped 43-55, HLA >=55), bank_supplies
banks smelted bars, buy-supplies restricts ores to positive-margin
recipes.
Tests: python3 tools/validate.py -> 2 entries, 0 errors, 0 warnings;
--selftest -> 3 PASS; negative test (reintroducing 12500) caught by the
new check; git diff --check clean.
Verified against OSRS wiki 2026-08-27 + live prices:
- F2P tree ladder: Tree 1/25xp, Oak 15/37.5xp, Willow 30/67.5xp,
Yew 60/175xp (wiki tree-page infoboxes + F2P location lists)
- Issue draft corrected: '45 Pine' disproven (OSRS pines are scenery
only, Pine tree page); level 45 is Maple (members) — noted in handoff
- F2P axes verified from wiki axe table + item pages: Bronze(1)..Rune(41)
+ Gilded(41) all F2P; Rune axe = best F2P; Dragon = members
- economy anchored on Draynor Village willows: live log sell prices
(willow 21, yew 112), xp/hr grounded in wiki per-log XP (hourly
rate explicitly flagged as estimate)
- bankside spot chosen per Oak/Willow/Yew page location lists; tree
fall timers cited (willow 30s, yew 114s)
- N/A relog/respawn noted (no combat/death vector)
validate.py exit 0 (0 errors). Closes#3
- low-alch-f2p.yaml: 'bank at a GE-adjacent bank' source now cites the wiki
Money making guide (noted-item bulk alching, West Varrock Bank F2P hub) and
High Level Alchemy page (GE buying below alch value; noted-item casting).
Researched-flag WARN eliminated.
- Verified handoff levels from the wiki: LA 21 (31xp), SII 43 (53xp), HLA 55
(65xp), all F2P; LA page explicitly recommends HLA at 55. Recorded as a
soft-efficiency-choice note on the golden entry and a new self-contained
entry codex/training/magic-alch-handoff.yaml (id magic-alch-handoff).
- Gate: RESULT 2 entries, 0 errors, 0 warnings; diff --check clean.
