# 07.4.4.1.10.1 Semantic Diagnostic Snapshot Builder

## Цель этапа

Этап **07.4.4.1.10.1 Semantic Diagnostic Snapshot Builder** направлен на создание отдельного диагностического слоя, который собирает текущее состояние автоторговли в единый semantic snapshot.

После внедрения предыдущих semantic-слоёв runtime начал анализировать не только торговый сигнал, но и качество рынка, тренда, фазы, momentum, breakout, execution confidence, execution quality и adaptive sizing. Однако эти данные были распределены по разным полям `AutoTradeState`, payload стратегии, execution runtime и UI.

Цель этапа — собрать все ключевые runtime-факторы в одну структурированную диагностическую модель, чтобы дальше на её основе построить:
- human-readable diagnostic formatter
- отдельный Telegram diagnostic screen
- diagnostic journal layer
- auto-refresh diagnostic UI
- расширенную проверку причин HOLD / BLOCKED / READY
- прозрачную диагностику market / signal / execution / sizing context

---

# Что реализовано

## Реализован Semantic Diagnostic Snapshot Builder

Добавлен отдельный слой диагностики, который формирует единый snapshot текущего состояния автоторговли.

Snapshot Builder агрегирует данные из:
- AutoTrade runtime state
- signal runtime
- decision runtime
- market semantic layer
- momentum / breakout semantic layer
- execution quality layer
- execution confidence layer
- adaptive sizing layer
- runtime expiration layer
- position / PnL context

Вместо ручного просмотра отдельных полей теперь появляется единая точка сборки диагностики.

---

## Реализована диагностическая модель runtime-состояния

Diagnostic Snapshot Builder структурирует данные по смысловым блокам:

- **status block** — режим автоторговли и базовый runtime context
- **signal block** — текущий сигнал, уверенность, повторы, длительность и причина
- **decision block** — статус решения, готовность сигнала и причина блокировки / ожидания
- **market block** — состояние рынка, тренд, волатильность, сила и качество тренда
- **market phase block** — фаза рынка, направление фазы и причина классификации
- **momentum block** — momentum state, direction, strength, breakout level и breakout distance
- **execution block** — execution quality, semantic status, confidence score и confidence level
- **sizing block** — adaptive size multiplier, effective risk и причина изменения размера
- **position block** — текущая позиция, entry price, position size и unrealized PnL
- **runtime block** — snapshot age, spread, stale/runtime expiration diagnostics

---

## Реализована подготовка к отдельному диагностическому экрану

Этап создаёт foundation для будущего Telegram Diagnostic Screen.

Диагностический экран сможет показывать не только короткие строки вида:
- `📉 Рынок · снижение`
- `🧩 Фильтр · слабый импульс`
- `⚡️ Импульс · вниз`

но и полную расшифровку:
- почему рынок классифицирован именно так
- почему вход заблокирован
- почему сигнал не READY
- какой фактор снижает confidence
- какой слой ограничивает adaptive sizing
- есть ли momentum / breakout
- является ли движение продолжением, откатом или слабым импульсом
- насколько свежий snapshot
- есть ли spread / execution degradation

---

# Что изменилось в аналитике

## Аналитика стала собираться в единый semantic snapshot

До этапа 07.4.4.1.10.1 аналитические данные существовали в runtime, но были распределены по нескольким слоям:

- market analysis payload
- strategy payload
- AutoTradeState fields
- execution confidence factors
- adaptive sizing factors
- execution quality fields
- Telegram UI semantic lines

Теперь появляется единая структура, которая объединяет эти данные в один диагностический объект.

Это важно, потому что последующие этапы диагностики смогут работать не с разрозненными runtime-полями, а с одним snapshot, который уже содержит полную картину торгового контекста.

---

## Реализована explainable diagnostic aggregation

Snapshot Builder не принимает торговые решения сам. Его задача — объяснить уже существующее состояние runtime.

Он собирает:
- что сейчас видит стратегия
- какой сигнал сформирован
- почему сигнал удерживается или блокируется
- что говорит market semantic layer
- что говорит momentum / breakout layer
- что говорит execution quality layer
- что говорит execution confidence layer
- что говорит adaptive sizing layer
- какой итоговый runtime context сложился

Таким образом, runtime становится не только исполняющим, но и объяснимым.

---

## Диагностика стала пригодной для UI и журнала

Данные snapshot builder подготовлены так, чтобы их можно было использовать сразу в нескольких слоях:

- Telegram diagnostic screen
- compact human-readable formatter
- expanded diagnostic formatter
- journal payload
- debug output
- future AI interpretation layer

Это отделяет диагностическую модель от конкретного способа отображения.

---

## Подготовлена аналитика причин HOLD

Одна из главных задач этапа — подготовить основу для объяснения, почему бот не входит в сделку.

Snapshot Builder собирает факторы, которые могут удерживать систему в HOLD:
- market filter blocked
- weak market trend
- noisy market trend
- pullback phase
- weak live impulse
- not enough live data
- low execution confidence
- stale snapshot
- high spread
- adaptive size zero
- signal confirmation pending

В дальнейшем formatter сможет превращать эти данные в понятное объяснение для пользователя.

---

## Подготовлена аналитика причин READY / BLOCKED

Диагностический snapshot также фиксирует, почему сигнал стал READY или почему был заблокирован.

В snapshot попадают:
- decision status
- decision reason
- signal confirmation progress
- repeat count
- confirmation seconds
- execution confidence score
- execution confidence level
- execution confidence reason
- execution semantic status
- execution semantic message

Это позволит на следующих этапах сделать отдельный экран, где будет видно не только итоговое состояние, но и путь к нему.

---

## Подготовлена аналитика market semantics

Snapshot Builder собирает все данные, появившиеся в semantic market layer:

- market state
- market trend
- market volatility
- market trend strength
- market trend quality
- market phase
- market phase direction
- market analysis reason

Это позволит диагностическому экрану объяснять, почему рынок считается:
- трендовым
- слабым
- шумным
- импульсным
- откатным
- флетовым
- сжатым
- слишком волатильным

---

## Подготовлена аналитика momentum / breakout semantics

Snapshot Builder также собирает данные из momentum / breakout layer:

- momentum state
- momentum direction
- momentum change percent
- momentum strength
- breakout level
- breakout distance percent
- breakout reason

Это особенно важно для ситуаций, когда основной market state ещё выглядит слабым или неподходящим, но рынок уже показывает быстрый directional acceleration или breakout.

Диагностика сможет показать, является ли движение:
- обычным шумом
- краткосрочным momentum
- подтверждённым breakout
- быстрым продолжением
- потенциальным ложным пробоем

---

## Подготовлена аналитика execution confidence

Snapshot Builder собирает execution confidence diagnostics:

- execution confidence score
- execution confidence level
- execution confidence required score
- execution confidence reason
- execution confidence factors

Это даёт возможность объяснять, почему вход разрешён или заблокирован не только через сигнал стратегии, но и через совокупную оценку качества execution context.

---

## Подготовлена аналитика adaptive sizing

В snapshot попадают данные adaptive sizing:

- adaptive size base
- adaptive size final
- adaptive size multiplier
- adaptive size reason
- adaptive size factors
- effective risk percent
- effective target risk USD

Это позволит видеть, почему размер позиции:
- не изменён
- уменьшен
- сильно уменьшен
- увеличен
- заблокирован

---

## Подготовлена аналитика execution quality

Snapshot Builder собирает execution quality diagnostics:

- execution quality
- execution quality reason
- execution quality message
- snapshot age seconds
- spread percent
- market runtime degraded

Это позволит диагностировать проблемы с исполнением:
- stale snapshot
- aging snapshot
- high spread
- unavailable depth snapshot
- snapshot error
- degraded market runtime

---

# Интеграция с текущей архитектурой

Этап 07.4.4.1.10.1 не меняет торговую логику входа напрямую.

Он добавляет аналитический диагностический слой поверх текущей runtime architecture.

Интеграция выполнена так, чтобы не ломать:
- AutoTradeService
- TrendStrategy
- ExecutionEngine
- текущий Telegram UI
- adaptive sizing
- execution confidence
- market semantic layer
- momentum / breakout semantic layer

Diagnostic Snapshot Builder является read-only слоем: он читает текущее состояние и формирует структурированную диагностическую картину.

---

# Результат этапа

После этапа 07.4.4.1.10.1 система получила foundation для полноценной semantic diagnostics architecture.

Runtime теперь подготовлен к тому, чтобы объяснять:
- что сейчас происходит на рынке
- почему бот держит HOLD
- почему вход заблокирован
- почему сигнал подтверждается
- почему сигнал READY
- какой слой ограничивает execution
- какой слой уменьшает размер позиции
- есть ли momentum или breakout
- является ли рынок пригодным для входа
- является ли execution context качественным

---

# Что подготовлено для следующих этапов

Этап 07.4.4.1.10.1 подготовил основу для:

## 07.4.4.1.10.2 Human-readable formatter
- преобразование diagnostic snapshot в понятный текст
- короткий и расширенный формат диагностики
- объяснение причин HOLD / BLOCKED / READY
- человекочитаемые market / signal / execution / sizing diagnostics

## 07.4.4.1.10.3 Telegram Diagnostic Screen
- отдельный экран диагностики в Telegram
- кнопка перехода из AutoTrade UI
- отображение полного semantic snapshot
- разделение краткого UI и расширенной диагностики

## 07.4.4.1.10.4 Diagnostic Journal Layer
- запись диагностических событий в журнал
- explainable diagnostic payload
- история изменений market / signal / execution context
- анализ причин блокировок и слабых входов

## 07.4.4.1.10.5 Auto-refresh Diagnostic UI
- автообновление диагностического экрана
- semantic refresh filtering
- обновление при изменении diagnostic snapshot
- защита от volatile timer refresh spam

---

# Итог

Этап 07.4.4.1.10.1 сделал runtime более explainable и подготовил систему к полноценной диагностике.

Система стала:
- diagnostic-aware
- semantic-state-aware
- explainability-ready
- UI-diagnostics-ready
- journal-diagnostics-ready
- лучше подготовленной к анализу причин HOLD / BLOCKED / READY
- ближе к professional runtime observability layer
- ближе к institutional execution diagnostics architecture
