j154 (default-off): the DERIVED bounded hold TR_TFIL_HOLD_MAX_TICKS + panic release

Budget derived from the server source (tank-royale 0.35.5): calcGunHeat(p) = 1 + p/5, coolDown 0.1/tick, fire only at heat == 0, calcBulletDamage(3.0) = 16 -> two max-power shots are 16 ticks apart and 32 damage is the most the enemy can land in that window (brute force over the 0.1 power grid: 8/11/16/24/32 ticks -> 16/18/32/32/48). 16 = CommitTicks + 1, the first window that admits the enemy's second shot. Knob defaults to 0 = today's behaviour byte-for-byte (checked over 20026 ticks). Hold is taken only on a replan tick with an empty safe set, at most N ticks per streak, released the tick a safe tile exists, counter reset on the pick. PANIC RELEASE: a tracked bullet whose closest approach is within its core at t* in [0, min(N,16)] overrides the hold immediately. The gun is untouched. Also fixes a stray '&' that stopped test_tfil_commit_env.nim from compiling at all, and enforces the 'a hold never interrupts a live commitment' invariant j153 documented but did not implement. Registers TR_TFIL_HOLD_MAX_TICKS in env_report + knownEnvNames + .env.example. No battle, no A/B run.
2026-09-27 10:23:46 +02:00
parent 38fbc6ecd1
commit 2223ca667e
3 changed files with 143 additions and 1 deletions
@@ -114,6 +114,7 @@ TR_TFIL_TILE_REPLAN=self    # self | enemy | off: when a dodge commitment is can
 TR_TFIL_COMMIT_TICKS=15      # ticks to commit to a dodge point before replanning
 TR_TFIL_ARRIVE_TICKS=0.0     # hard bound: never pick a tile farther than this (ticks at 8px/tick); 0 = off = today's draw
 TR_TFIL_HOLD_WHEN_TRAPPED=off  # on = when NO safe tile exists, hold position one tick instead of taking the 2 least-hot blocked tiles; off = today's fallback
+TR_TFIL_HOLD_MAX_TICKS=0  # BOUNDED version of the above: hold at most N ticks per empty-safe-set streak (default 0 = off = today's fallback). The budget is DERIVED from the enemy's rate of fire (2 x 3.0-power shots = 16 ticks); the hold is released the tick a safe tile exists and overridden outright if a tracked bullet reaches us within min(N, 16) ticks
 TR_TFIL_DANGER_THRESHOLD=10.0  # hard heat filter on the path; lava is quantised to 5, so the effective steps are 10/15/20 and 10-14 admits exactly what 10 does
 TR_TFIL_DIAG=off     # on = fill the per-pick picker loss histogram (TfilLoss*); observability only
 TR_TFIL_GEO_MODE=off  # off | turn | dist | both, each with a `-soft` (default) / `-topk` / `-rej` suffix; shapes the DRAW over the heat-filtered pool