# 09 — Критерии приёмки

Раздел 11 спека. Воспроизвести: `build/bin/squad_proto.exe --accept`.
Сценарии — [src/debug/harness.cpp](../src/debug/harness.cpp), `RunAccept()`.

## Автоматическая проверка

Критерии 1, 6, 7, 8 описывают **правила стрельбы** и меряются на отряде из пяти
стрелков — так, как их формулировал спек. Ближний бой проверяется отдельным
блоком M7 и, главное, трёхминутным прогоном 11.2, где состав отряда обычный,
боевой (2 клинка + 3 ствола).

| # | Критерий | Статус | Цифры последнего прогона |
|---|---|---|---|
| 1 | ≥4 из 5 агентов имеют линию за ≤1.5 с после остановки | **PASS** | settle = 0.32 с, линий 5/5 |
| 2 | `FRIENDLY_HITS` = 0 за 3 минуты боя во всех режимах | **PASS** | 0 попаданий, смешанный отряд |
| 4 | агент с чужой линии огня уходит за ~0.3 с | **PASS** | максимум 0.35 с на арене (0.98 с по всем сценариям) |
| 5 | нет дёрганья: `postPos` не чаще раза в 0.6 с | **PASS** | 36 коммитов, 0 нарушений, минимальный интервал 0.75 с |
| 6 | в проходе 2 тайла — колонна, огонь не идёт сквозь своих | **PASS** | до 5 агентов в створе, поперёк 3.09 / вдоль 6.08 тайла, вперёд передний/хвост 77/9, сквозь союзника 0 выстрелов из 247 |
| 7 | ручной режим никогда не стреляет сквозь своих | **PASS** | 0 попаданий по своим за 30 с, назначенная цель 96 % времени |
| 8 | `FIRE UPTIME` в стоячем бою на арене ≥ 80 % | **PASS** | 100 % |
| 9 | стабильные 60 fps | **PASS** | симуляция 2.5 мкс + рендер 4.1 мс при бюджете 16.6 мс, fps 60 |

Ближний бой ([11-melee.md](11-melee.md)), сценарий 30 с у кучки мишеней:

| # | Критерий | Статус | Цифры |
|---|---|---|---|
| M7.1 | клинок доходит до цели и наносит урон | **PASS** | 55 взмахов, 52 попадания, 16 убийств, 14 оборвано своими; связка `slash 21 / backhand 19 / spin 15` |
| M7.2 | ближний бой не задевает своих | **PASS** | `FRIENDLY_HITS = 0` при 55 взмахах |
| M7.3 | у каждого класса свой круг вокруг диска | **PASS** | стрелки не дальше 3.49 от диска, клинки — 5.61 (лимиты 3.70 / 6.80) |
| M7.4 | лезвие не достаёт за пределы своей дуги | **PASS** | превышение сектора 0.0° (лимит 12°) |

M7.4 появился после починки геометрии удара: угловой допуск `asin(r/dist)`
вырождался на контактной дистанции в 90°, и боец рубил за спину — те самые
«удары на 360 градусов». Теперь проверка идёт по отрезку лезвия, а критерий
замеряет превышение разрешённого сектора и не даёт багу вернуться
([11-melee.md](11-melee.md)).

M7.2 держится не тюнингом, а конструкцией: урон применяется только к мишеням, а
влезший под лезвие союзник обрывает взмах ([08-decisions.md](08-decisions.md), A16).

Прогон 300 с (`--headless 300`), смешанный отряд: `FRIENDLY_HITS = 0`,
1471 выстрел, 142 взмаха / 146 попаданий лезвием, **63 убийства**.
Тот же маршрут чистым отрядом стрелков (`--melee 0`): 2100 выстрелов,
45 убийств. Клинки заметно поднимают урон отряда, не ломая главного правила.

`FIRE UPTIME` на стоянках маршрута: 82.9 / 93.2 / 90.7 / 86.0 % там, где есть
мишени, и 23.3 % на стоянке, где стрелять не по чему.

Тест 11.6 переписан ещё раз, и на этот раз по существу — с подсчёта «кто стрелял»
на проверку инварианта.

Причина была в другом месте, чем казалось. Сценарий тащил курсор непрерывно,
курсор обгонял отряд, натяжение поводка упиралось в упор, включался спринт — а в
спринте отряд по замыслу не стреляет вовсе. Тест показывал «0 выстрелов вперёд» и
падал, проверяя пустой коридор. После поднятия `sprintAt` до 0.85 удержание
направления спринт больше не включает, и отряд идёт через проход **с боем** —
как и должен.

Область замера тоже была неверной: проход глубиной три тайла, а бойцов пятеро,
и колонна физически длиннее самого прохода — внутрь него целиком она не
помещается никогда. Меряется теперь створ прохода с подходами по обе стороны,
на всей проводке, а не только на стоянке.

Заодно выброшен критерий «передний стреляет чаще заднего». В проходе шириной два
тайла у заднего есть законные диагональные линии мимо переднего, и требовать их
отсутствия — значит требовать от отряда быть глупее, чем он есть. «Задние не
стреляют» — это следствие правила «не сквозь своего», а не отдельное правило.
Поэтому проверяется сам инвариант: берётся отрезок **реально сделанного**
выстрела и независимой геометрией проверяется, не задел ли он тело союзника.

Результат: 0 из 247 выстрелов прошли сквозь своего, колонна 6.08 тайла вдоль
против 3.09 поперёк, и передний всё равно ведёт огонь с перевесом 77 против 9 —
теперь это наблюдение, а не условие прохождения.

## Проверяется глазами / по коду

| # | Критерий | Как подтверждено |
|---|---|---|
| 3 | в движении стреляют только те, у кого чистая линия | по построению: спуск требует `hasLane`; в оверлее `F2` видно, что часть агентов идёт с жёлтой линией и молчит |
| 10 | вся сцена нарисована своим растеризатором | в `render/` нет ни одного raylib-примитива; raylib вызывается только в `ScreenBlitter` (`UpdateTexture` + `DrawTexturePro`) и в `debug/overlay.cpp`, который dev-only и снимается по `F1` |

Скриншот боевого кадра ([docs/combat.png](combat.png)): отряд в пятне света,
у каждого своя зелёная линия, ни одна не проходит через своего, трассеры в полёте,
дальние мишени видны только тлеющими глазами. `FRIENDLY_HITS 0`.

## Оговорки, которые стоит знать

- Критерий 1 и метрика `SETTLE TIME` осмысленны только когда в радиусе есть живые
  мишени. В общем маршруте попадаются значения до 5.7 с — это остановки там, где
  стрелять не по чему, а не медленное расхождение.
- Критерий 8 меряется в стоячем бою рядом с кучкой. При остановке на краю
  дальности честные значения ниже: часть агентов физически не достаёт цель.
  После сокращения дальности до 7.2 худшая стоянка маршрута даёт ~30 % — это
  остановка там, где кучка уже вне радиуса, а не деградация решателя.
- `FRIENDLY_HITS = 0` достигается связкой из четырёх вещей: резерв линий, включая
  перекрытые своим; резерв шире порога блокировки; учёт времени полёта на спуске;
  пуля не летит дальше проверенного отрезка. Отключение любой из них возвращает
  попадания по своим — цифры в [08-decisions.md](08-decisions.md).
- `FIRE UPTIME` усредняется только по стрелкам, `MELEE reach` — только по клинкам.
  Смешивать доли времени двух разных занятий в одно среднее бессмысленно.
- «Макс. время в чужой линии» на смешанном отряде доходит до 3.9 с против 1.3 с
  на чистых стрелках. Это боец с клинком, который стоит вплотную к мишени и тем
  самым перекрывает стрелку линию: расступиться он не может, не бросив свою
  работу. Правило при этом не нарушается — стрелок просто не стреляет и
  перерешивает позицию. Критерий 11.4 меряется на открытой арене чистым отрядом
  стрелков, где такой ситуации нет по построению.