# Trace пишет ядро, показывает плагин

Владелец хочет видеть ход целиком: как сообщение идёт через Bridge, Inbound pipeline,
Gate, контекст, шаги модели, тулы, память, субагентов, Outbox и обратно в Telegram —
живьём и повтором. Это первый плагин Ивы и первый потребитель рельсов ADR-0009.

## Что решено

**Журнал хода (Trace) — в ядре.** `data/trace/YYYY-MM-DD.jsonl`, append-only, одна
строка = событие `{ts, turn, session, kind, name, data}`. Пишут два места: хук
`agent/hooks/trace.ts` (все события eve: `turn.*`, `step.*`, `actions.requested`,
`action.result`, `subagent.*`, `message.*`, `reasoning.*`) и швы Ивы — Bridge принял
апдейт, Inbound pipeline (allowlist, вердикт Gate, сборка контекста), Outbox (доставка,
outbound-Gate). Ночные ходы пишутся так же. Почему ядро: швы Ивы видит только Ива, а
плагин видит только eve; и это доставка/безопасность — территория кода (philosophy §2).
Второй потребитель журнала — `iva trace tail|show|open`, поэтому это механизм, а не
функция (philosophy §5).

**Содержимое пишем, с потолком.** Аргументы и результаты тулов, текст модели — да,
каждое поле обрезано по лимиту, как `CONTENT_ATTRIBUTE_LIMIT` у eve. Тумблер
`captureContent`, по умолчанию включён: вьюер локальный, владелец один. Хранение
14 дней, чистка по дате в имени файла, не по mtime.

**Вьюер — плагин `trace`, отдельный сервис.** `plugin.json` + `skills/trace/` (как
читать журнал, как открыть вьюер) + `sh.iva/services/viewer` — node http + SSE,
читает `data/trace/`, слушает `127.0.0.1`. Юнит генерит Ива по рельсам ADR-0009.
Отдельный процесс переживает рестарт агента, показывает «агент перезапускается» и не
грузит процесс модели. eve Extension плагину не нужен.

**Доступ — только SSH-туннель.** Наружу ничего; `iva trace open` печатает готовую
`ssh -N -L`. Трейс — личные данные, auth = SSH-ключ.

**Ввода на странице нет.** Пишешь в Telegram, смотришь на странице. Вход внутрь
остаётся один — Inbound pipeline; веб-чат через eve-канал обошёл бы allowlist и Gate.

**Страница — один HTML-файл без сборки.** Схема Ивы с подсветкой узлов и рёбер по
событиям, справа лента хода чипами, сверху равные плитки за период (без «hero»-цифры,
решение владельца). У каждого хода кнопка «Повторить»: события проигрываются заново с
реальными интервалами и ускоренно — владелец переключается с Telegram на браузер и
успевает не всегда. Планка для критиков — референсный скриншот дашборда Waku.

## Что отвергнуто

- Хук трейса внутри плагина: не видит швов Ивы; ядро всё равно писало бы свою часть —
  два писателя одного журнала.
- OTel-экспортёр через `defineInstrumentation.setup()`: даёт спаны eve, но не швы Ивы,
  и тянет OTel-стек ради локального файла.
- Вьюер внутри процесса агента: умирает с ним, сайд-эффект на import, и механизм
  сервисов всё равно нужен для MCP proxy.
- Публичный адрес с токеном: личные данные за одним секретом в интернете.

**Пересмотрено 06.10.2026.** Поле содержимого — до 4096 знаков: входящее сообщение Telegram ложится целиком.
Строка, не влезшая в 16 КБ, сначала пересобирается с полями по 2000 знаков и только потом теряет
содержимое, поэтому ни одно событие не теряет больше, чем раньше; атомарность одной записи не меняется.
Результат инструмента пишется одной строкой JSON: вложенность не съедает выдачу, а размер строки держит
одно поле. Хук ставит `failure` — класс сбоя без текста — и `exitCode`; у `bash` хранится конец вывода, там
стоит ошибка. Чатовый ход склеивается по паре «сессия + turn», имя хода — `<session>/<turn>`. Хранение
30 дней: сравнить можно с прошлым месяцем. Откат на версию до этой правки дочищает журнал до 14 дней — это
диагностика, а не данные владельца из ADR-0002. Отвергнуто: строка больше 16 КБ (атомарность больших
записей не проверена) и результаты в отдельных файлах (ломают «один файл на день» и всех читателей).

Статус: решение принято 17.08.2026, реализация — вместе с волной «плагины».