Add architecture package and application skeleton

2026-07-03 21:09:47 +03:00
parent 7d6cc1c83e
commit ce2b263e52
47 changed files with 2377 additions and 53 deletions
@@ -0,0 +1,40 @@
+# ADR 003: User Event Stream Transport
+
+## Status
+
+Accepted
+
+## Context
+
+UI требует поток событий по task execution:
+
+- `task_started`
+- `node_started`
+- `node_completed`
+- `confirmation_required`
+- `task_completed`
+- `task_failed`
+
+В исходных документах упомянуты `SSE/WebSocket`, но как основной transport нужно выбрать один.
+
+## Decision
+
+Основной transport для пользовательского event stream: Server-Sent Events.
+
+WebSocket не исключается, но считается вторичным adapter для будущих realtime-потребностей.
+
+## Rationale
+
+SSE проще для:
+
+- однонаправленного server-to-client прогресса;
+- проксирования;
+- reconnect semantics;
+- дебага и совместимости с обычными HTTP-инструментами.
+
+WebSocket нужен не UI в первую очередь, а local worker transport.
+
+## Consequences
+
+`GET /tasks/{id}/events` фиксируется как SSE endpoint.
+