Give the enemy a structured intent and a durable route queue (#127)
build / mod (push) Failing after 22s
release / windows (push) Failing after 2s

Stage 2 of #127. A smart drone now carries why it is aimed where it is
(Intent: plan, sead, react, replace) apart from the aim bookkeeping
(unit, since, switches, confidence). Assignments are throttled per
adaptive tick and per contact, a fresh disclosure replaces an aim only
after a hold, within a switch cap and when the change is worth a new
route, and a killed aim is replaced as a separate, lower-priority
decision. The queue is bounded and taken by priority (plan > sead >
react > replace); unknown land is no longer free in a replanned route.

The autosave now carries the air state: the drones in flight, the launch
queue, every pending job with its id, aim, unit, version, priority,
intent and relief version, the contacts the jobs were chosen from and
the relief snapshots they plan over. The format is a versioned `air 1`
section; older saves read as before, scenarios do not carry the sky,
stale, ghost and duplicate jobs are cancelled on load, and the section is
bounded (512 drones, 512 route points, 4096 contacts, 8 reliefs, 900 KB).
A periodic save waits while a raid is only being planned.

enemy_picture() now explains targets and pending jobs (aims, aimed_by,
pending_jobs, reason, work_per_tick) in English, and intel_bench records
the queue and intent evidence next to completion, losses and failures.
This commit is contained in:
2026-11-06 18:35:09 +03:00
parent 8fc10c07a1
commit e7934a1ebb
14 changed files with 2411 additions and 89 deletions
+123 -7
View File
@@ -449,9 +449,9 @@ Lancet, баллистика и decoy, как и раньше, летят пря
рельефом: два job с одинаковым рельефом, но разными known units, не делят price/route grid. За
пределами известной сетки — Unknown, новая карта не раскрывается.
Очередь — рантайм-состояние планировщика. Дроны и очередь запуска в текущий `state_text` не входят,
поэтому формат save не менялся и старые saves читаются как прежде; запись replay по-прежнему хранит
траектории, а не задания. Регрессии: `mass_retarget_finishes_its_route_jobs_over_the_budget`
Очередь этапа 1 была рантайм-состоянием планировщика: дроны и очередь запуска в `state_text` не
входили, поэтому durable-очередью она не была. Этап 2 (ниже) сохраняет её вместе с дронами, очередью
запуска, картиной и версиями рельефа. Регрессии этапа 1 остаются: `mass_retarget_finishes_its_route_jobs_over_the_budget`
(40+ ретаргетов, прогресс каждый бюджетный тик, старый маршрут до нового, нет пустых маршрутов)
и `mass_retarget_is_deterministic_and_never_duplicates_a_drone` (тот же seed — те же цели и
маршруты; повторный `adapt` не создаёт дублей).
@@ -492,8 +492,8 @@ launcher-only: без донорского контакта такая ПУ в
статистикой секторов (`best_bearing` по kills/hits): новых всеведущих данных и усиления
характеристик нет.
Форматы не изменились: intel — рантайм (save хранит Layout, replay — траектории), durable-очередь
по-прежнему не делается. Измерения до/после на одних seed: `docs/measurements/issue-127-enemy-picture-baseline.json`
Форматы этапа 1 не менялись: intel оставался рантаймом (save хранил Layout, replay — траектории);
durable-очередь появилась на этапе 2, ниже. Измерения до/после на одних seed: `docs/measurements/issue-127-enemy-picture-baseline.json`
(0b645d77e) и `issue-127-enemy-picture-result.json` (эта ветка), bench — `cargo run --release --example intel_bench`.
big-smart и logistics побайтово совпали с базой; ew-adaptive изменился (kills 62→59/61→59/61→56,
hits 3→7/5→7/7→8, потери ЗРК 1→3/4→3/4→4) — фиксируется как факт перехода на честную картину,
@@ -502,8 +502,124 @@ hits 3→7/5→7/7→8, потери ЗРК 1→3/4→3/4→4) — фиксир
(донор любой роли; разрыв связи наблюдённый/нет), `destruction_moves_the_picture_only_when_watched`,
`confidence_is_a_function_of_age_alone`, `enemy_picture_report_describes_observation_and_belief`,
`an_impact_watches_the_kill_and_updates_only_the_picture` (BSA end-to-end), обновлённые SEAD/#4/#21/#122
и обе регрессии очереди. Остаток #127: durable save queue (новый формат save), полный structured intent,
GUI поверх `enemy_picture()`, оценка баланса ew-adaptive.
и обе регрессии очереди. Остаток #127 после этапа 1: durable save queue, structured intent, GUI.
### #127, этап 2: structured intent, durable queue и объяснимость
**Намерение отделено от цели.** У дрона теперь два поля: `ew::Intent` — почему он летит туда — и
`ew::Aim` — юнит, когда цель выбрана, сколько раз менялась и уверенность контакта. `Intent`:
`Plan` (собственная цель плана: объект или юнит, выбранный при заказе), `Sead` (плановый удар по РЛС
из `radar_strikes`), `React` (реакция на раскрытие: станция показала себя уже в воздухе) и `Replace`
(картинка увидела гибель/забвение прежней цели). Случайный выбор цели (`choose_target`) больше не
смешивается с реакцией: при заказе налёта intent фиксируется, а `adapt` помечает свои решения явно.
Приоритет очереди — из намерения: Plan 3, Sead 2, React 1, Replace 0.
**Throttle.** `SWITCH_HOLD = 160` тиков (8 с): свежее раскрытие может сменить цель только после
выдержки; `SWITCH_CAP = 3` смены на дрон за жизнь; `ASSIGN_PER_TICK = 16` новых целей за адаптивный
тик и `ASSIGN_PER_CONTACT = 6` на один контакт за тик — массовый ретаргет растягивается на следующие
адаптивные тики, а не переписывает все маршруты сразу. Смена возможна, только если контакт показался
позже текущей цели (`tick > aim.since`), он не Doubtful, и он либо достовернее текущего, либо ближе
на `SWITCH_GAIN = 120` блоков: смена выбрасывает готовый маршрут и стоит планировщику нового, поэтому
маргинальная не делается. Замена убитой цели выдержку не ждёт (цели уже нет), но упирается в тот же
cap. В полёте, как и раньше, цель меняется только когда картинка её убила или забыла.
**Явные игровые реакции без скрытых данных.** Реакции читают только поля контакта, записанные каналом
наблюдения: выключенный радар остаётся в картине таким, каким его видели (эмиссия не фиксировалась —
собственный сенсор не верится), разделённая батарея читается как пуск без эмиссии (launcher-only,
без донора «слепа»), конечный БК наблюдается только как пуски (`Contact.launches`: счётчик увиденных
пусков; остаток магазина в картину не входит никогда), энергия/нагрев РЭБ — своё состояние станции,
а не раскрытие. Метаморфный тест `hidden_changes_do_not_move_the_picture_or_its_decisions` расширен:
скрытые перемещение, off, роли, режим, БК, урон, гибель и нагрев/замок/выключение РЭБ не двигают ни
картинку, ни цены, ни намерения/aims/очередь заданий. Повторное наблюдение двигает всё — как и должно.
**Неизвестная земля не бесплатна.** `raid::Relief` получил поле `unknown`; у плана умной волны оно
0 (поведение этапа 1 сохранено), у повторного планирования задания — `UNKNOWN_LAND = 6` сверх базовой
цены клетки 1. Задание, чья версия рельефа ничего не знает, планируется по полностью неизвестной
земле с той же ценой, а не «как по свободной»: маршрут держится размеченной части, если она есть.
Тест `unknown_land_is_not_free_in_a_replanned_route` сравнивает маршрут с ценой 0 и с ценой 6 на одной
сетке: бесплатный срезает через неразмеченное, платный идёт по размеченному.
**Durable queue: формат save.** `state_text` (автосейв) дописывает версионированную секцию
(`sim::durable`, формат `air 1`):
```
air 1 <такт> <номер следующего задания> <дронов> <в очереди> <заданий> <контактов> <версий рельефа>
airintel <12 kills> <12 hits>
airglobal <версия рельефа|->
airrelief <номер> <minX> <minZ> <клетка> <сторона> <RLE: u<n> | <высота>x<n> ...>
aircontact <id> <тип> <x> <y> <z> <такт наблюдения> <канал> <эмиссия|-> <гибель|-> <пусков>
airdrone <id> <тип> ... <полёт> <намерение> <юнит> <since> <смены> <уверенность> ... <маршрут: n x y z ...|->
airqueue <такт запуска> <то же тело дрона>
airjob <id> <дрон> <x> <y> <z> <юнит> <версия> <приоритет> <намерение> <рельеф|->
```
Секция пишется только автосейвом: сценарий — это стартовое состояние, его тело её не несёт
(`scenario_text` → `state_text_with(..., air = false)`). Старые saves без секции читаются как прежде
(пустое небо); старые сборки новые saves читают как Layout, игнорируя `air*` (Layout пропускает
неизвестные строки). Всё проверяется до применения: битая строка отказывает save целиком с номером
строки и полем, счётчики в заголовке сверяются с числом строк (обрезанный файл отвергается), чужая
строка внутри секции — тоже. Границы: 512 дронов, 512 точек маршрута, 4096 контактов, 8 версий
рельефа, 40 000 клеток; координаты пишутся до 0.01 блока (полёт этого не замечает), рельеф — RLE
целых высот. Секция дополнительно ограничена 900 КБ (хост разрешает 1 МиБ на одну запись): дрон,
который не влез, не пишется, и его задание тоже (восстановить его было бы нельзя). Измеренный размер секции в bench: 4.0–8.8 КБ для logistics/ew-adaptive и 61–62 КБ для
big-smart (38 дронов в воздухе).
**Что именно восстанавливается.** Дроны в воздухе (живые; падающие обломки — эффект, их нет),
очередь запуска с тактами, задания (`id`, дрон, цель, юнит, версия, приоритет, намерение, версия
рельефа), контакты картины (счётчики секторов, пуски), глобальный снимок рельефа и `job_next`.
Картина задания восстанавливается «на свою версию»: контакты, наблюдённые не позже версии, плюс
собственная цель задания (её последнее сохранённое наблюдение заменяет более позднее — иначе цель
исчезла бы из своей же картины). Устаревшие задания отменяются при загрузке (`prune_air`): дрон
исчез/погиб, цель уже другая, юнит наблюдённо уничтожен или забыт, дубль по дрону, версия старше
`JOB_TTL = 1200` тиков (60 с). Маршрут отменённого «по устареванию/дублю» задания сохраняется (он
ведёт к той же цели), отменённого из-за смены цели — очищается.
`apply_state` сначала проверяет Layout и секцию, затем применяет обе; секция заменяет воздушное
состояние, а не сливается с ним. `durable_mark` включает `air_mark` (число дронов/очереди/заданий/
контактов и `job_next`): автосейв берётся на запуске, потере, новом/завершённом задании и новом/забытом
контакте, а не каждый тик полёта. Пока налёт *планируется*, периодический save откладывается (план не
имеет durable-формы; поиск площадок ограничен `sites::SEARCH_TICKS = 400`); при смене мира пишется
только Layout. Replay по-прежнему хранит траектории: секция пишется и читается только для живого
`Sim`, записи не смешиваются с ней.
Остаток и ограничения: ракеты-перехватчики в воздухе, пусковые площадки (`sites`), промежуточный
план, статистика волны и состояние RNG не сохраняются — после загрузки перехваты начнутся заново,
очередь стартует без площадки (свободный слот), отчёт волны не придёт, а случайные броски идут от
нового генератора мира; сама воздушная обстановка (дроны, цели, задания, картина) восстанавливается
точно. GUI поверх отчёта не делался.
**Объяснимость.** `EnemyPictureReport` расширен без русского текста в core: у контакта — `launches`,
`aimed_by` (сколько дронов на него нацелено) и `pending_jobs`; добавлены `aims` (дрон, юнит, intent,
since, switches, confidence) и `pending` (id задания, дрон, юнит, точка, версия, приоритет, intent,
`relief_known`, `reason` словами: ждёт бюджета / ждёт бюджета, земля неизвестна и стоит дороже /
устарело), плюс `work_per_tick`. Тест `the_report_explains_aims_and_pending_jobs_in_english`
проверяет и ASCII-only диагностику.
**Измерения (baseline 8fc10c07a → эта ветка, `cargo run --release --example intel_bench`, seeds 1/7/42):**
`docs/measurements/issue-127-intent-queue-baseline.json` и `issue-127-intent-queue-result.json`.
big-smart: завершение у всех, launched 38, kills 38, hits 0, потери 0 — как в базе; ticks 1716→1676
(seed 1) и 1542/1433 без изменений, fired 49→60, 48→68, 49→71 (больше пусков ПВО). logistics: все
поля совпали (27 запусков, 11/12/12 сбито, 8/7/8 прорвалось, 18 ракет, 0 потерь). ew-adaptive:
kills 59→58, 59→58, 56→63; hits 7→7, 7→9, 8→3; потери ЗРК 3→3, 3→4, 4→2; ticks 8084→7146, 8193→7650,
7916→7243; fired 69→76, 81→98, 69→82. Это следствие throttle назначений и приоритетной очереди, а не
подкрутки баланса: параметры ПВО/дронов не менялись, числа фиксируются как факт. В result-файле есть
новые поля (`retargets_max`, `air_bytes`, `switches_max`, `intents`), у baseline их нет.
**Регрессии этапа 2.** Core: `the_plan_records_sead_separately_from_its_objective`,
`assignments_are_throttled_per_tick_and_per_contact`, `a_fresh_disclosure_switches_an_aim_only_after_the_hold`,
`a_watched_kill_replaces_the_aim_and_queues_a_lower_priority_route`,
`launched_rounds_are_observed_but_the_magazine_is_not`, `unknown_land_is_not_free_in_a_replanned_route`,
`the_route_queue_is_bounded_and_refuses_a_worthless_job`, `the_same_seed_chose_the_same_intents_and_jobs`,
`the_report_explains_aims_and_pending_jobs_in_english`, `the_air_state_round_trips_every_job_field`,
`a_pending_route_continues_after_a_save_and_a_load` (save/load посреди незавершённой очереди: та же
очередь, те же маршруты, обе кампании доводят задания, пустых маршрутов нет),
`stale_ghost_and_duplicate_jobs_are_cancelled`, `a_job_for_a_unit_the_picture_lost_is_cancelled_on_load`,
`a_damaged_air_section_is_refused_with_its_line_and_field`, `the_section_stays_inside_its_byte_bound`
(600 дронов с длинными маршрутами: секция ≤ 900 КБ, записанные задания принадлежат записанным дронам),
обновлённые массовые ретаргеты (40+ дронов:
прогресс на бюджетном тике, throttle назначений, у дрона, стартовавшего без маршрута, маршрут
появляется). Adapter: `the_air_section_of_a_save_is_written_and_read_by_the_adapter` (запись/чтение
секции, замена не слияние, старый save без секции, сценарий без воздуха).
## Что следующему агенту проверить в первую очередь