doc: финальные доработки polygon (Fable + v0.3.1 + тесты + AI-гайд)

HISTORY/2026-07-31-session.md

@@ -762,3 +762,44 @@ python app.py  # NUBES_API_ENDPOINT = lk-api-gateway-test... → автоопр
 ```
 
 **Версия:** app-autotest v1.2.23 → v1.2.24 (`a398892`).
+
+---
+
+## Финальные доработки polygon (2026-07-31, Fable 5 + DeepSeek)
+
+### Аудиты
+
+- **Опус:** архитектурный аудит → 5 находок. Главное: публичный деплой vs single-user дизайн.
+- **Fable 5:** bug hunt → 7 находок. Нашёл то что 3 других ревью пропустили: setdefault не работает, sleep блокирует /health, int(param_id) без try.
+- **Моё мнение:** Fable vs Opus — `polygon-docs/my-opinion-fable-vs-opus.md`
+- **Гайд по AI-моделям:** `polygon-docs/ai-models-guide.md`
+
+### Исправлено (v0.2.5 → v0.3.1)
+
+| Фикс | От кого |
+|------|---------|
+| `Authorization: Bearer` на ВСЕХ эндпоинтах (если MOCK_AUTH_TOKEN задан) | Fable |
+| Cap DELAY ≤ 5с, min ≥ 0, float() с try/except | Fable |
+| Runtime warning если WEB_CONCURRENCY != 1 (setdefault удалён) | Fable |
+| `int(param_id)` с try/except — нет 500 | Fable |
+| `/_mock/fail-next` — симуляция падения (isSuccessful=False) | Fable |
+| `.format()` → `%s` в докстринге (KeyError fix) | Я |
+
+### Интеграционные тесты (app-autotest v1.2.25)
+
+`test_polygon_integration.py` — 15 тестов (все PASS):
+- services CRUD, create flow, postgres state.out
+- 409 при повторном run, modify-мерж, suspend/resume, delete
+- пагинация, _mock/state, _mock/services, _mock/delay
+
+### Оптимизация токенов
+
+- `copilot-instructions.md`: 106 → 25 строк (выброшены повторы, прецеденты)
+- Гайд по моделям: короткие промпты для Fable (40 строк), полные для Опуса (150 строк)
+
+### Итог
+
+- **Polygon:** v0.3.1, задеплоен, 23/23 curl PASS
+- **App-autotest:** v1.2.25, STANDS-check интеграция
+- **Готов к последовательному CI.**
+- **Блокеры для параллельного CI:** per-session модель (Опус), симуляция ошибок (Fable)