docs(observability): document phase-0 telemetry and baseline workflow
This commit is contained in:
@@ -27,6 +27,7 @@ flowchart LR
|
||||
subgraph HOST[Host (Flynn Daemon)]
|
||||
CA[ChannelAdapters]
|
||||
GW[Gateway\nHTTP + WS JSON-RPC + Web UI]
|
||||
MC[MetricsCollector\nrun state + cancel latency + reactions]
|
||||
RT[Routing\ncreateMessageRouter()]
|
||||
PF[Preferences\n~/.local/share/flynn/preferences.json\nmodelTier + backendMode]
|
||||
SM[SessionManager\nSQLite]
|
||||
@@ -60,6 +61,7 @@ flowchart LR
|
||||
|
||||
CH --> CA
|
||||
GW --> RT
|
||||
GW --> MC
|
||||
CA --> RT
|
||||
RT --> SM
|
||||
RT --> OR
|
||||
@@ -147,6 +149,7 @@ Key files:
|
||||
- Model routing: `src/models/router.ts`
|
||||
- Tool policy + execution: `src/tools/policy.ts`, `src/tools/executor.ts`
|
||||
- Canary backend telemetry summarization (offline evaluation): `src/audit/backendCanarySummary.ts`, `scripts/summarize-backend-canary.ts`
|
||||
- Phase 0 baseline telemetry summarization: `src/audit/phase0BaselineSummary.ts`, `scripts/summarize-phase0-baseline.ts`
|
||||
|
||||
## Component Graph (Agent-Safety Boundary)
|
||||
|
||||
|
||||
@@ -14,6 +14,7 @@ If you only want the protocol surface, see `docs/api/PROTOCOL.md`.
|
||||
- Runtime backend mode can be overridden manually via `/runtime` command fast-path (`status`, `activate pi`, `deactivate pi`, `use config`) and is persisted in preferences (`/backend` remains a compatibility alias).
|
||||
- `flynn tui` now attaches to this same gateway command path for `/runtime ...` and auto-starts/attaches daemon+gateway when needed.
|
||||
- Backend routing outcomes are auditable via `backend.route` / `backend.success` / `backend.fallback`, which enables offline canary evaluation without changing gateway protocol methods.
|
||||
- Run lifecycle/cancel intent and reaction decisions are emitted to audit logs, and aggregated into `system.metrics` counters (runStates, cancelLatencyMs, reactions) for dashboards.
|
||||
|
||||
## Component Map
|
||||
|
||||
@@ -31,6 +32,8 @@ flowchart LR
|
||||
LQ[LaneQueue\nper-session FIFO]
|
||||
SB[SessionBridge\nconnectionId -> sessionId -> AgentOrchestrator]
|
||||
AQ[AuditLogger\nqueue.preempt events]
|
||||
MC[MetricsCollector\nrun states + cancel latency + reactions]
|
||||
UI[Web UI Dashboard]
|
||||
end
|
||||
|
||||
subgraph CORE[Flynn Core]
|
||||
@@ -46,6 +49,8 @@ flowchart LR
|
||||
GS --> LQ
|
||||
GS --> SB
|
||||
LQ --> AQ
|
||||
GS --> MC
|
||||
MC --> UI
|
||||
|
||||
SB --> AO
|
||||
SB --> SM
|
||||
|
||||
Reference in New Issue
Block a user