AGENTS.md — api/tracium/v1/

Назначение этого уровня

Protobuf-пакет tracium.v1 публичного API. Сейчас: контракт стриминга событий асинхронных задач (JobEvents.Watch) — target-state, gRPC-сервер не реализован (отдельный цикл: ingress/TLS/auth). Схема событий едина с REST-курсором и WebSocket /v1/jobs/{kind}/{id}/events.

Содержимое

v1/
├── AGENTS.md        # ← вы здесь
├── README.md        # mapping REST ↔ WS ↔ gRPC, семантика lagged/seq
└── job_events.proto # service JobEvents, WatchRequest, JobEvent

Правила

• payload_json в JobEvent = байт-в-байт JSON REST-ответа; типизированные message’ы вводить только при реализации сервера, сохраняя payload_json.
• Изменение семантики seq/lagged согласовывать с platform/jobstream и WS-handler’ом (backend/internal/platform/jobstream/ws/).