docs(okf): entidades e relacionamentos OKF do DashDescomplicar

2026-10-28 16:01:20 +00:00
parent f063a2ec8c
commit 61ae4697f9
48 changed files with 2610 additions and 0 deletions
@@ -0,0 +1,61 @@
+---
+type: Entity
+layer: wiki
+tags: [stack, dashdescomplicar, infra, monitorizacao, gemini, telemetria]
+title: "Monitorizacao-Gemini"
+---
+
+# Monitorizacao-Gemini
+
+Sistema de telemetria para hooks do Gemini CLI. Recolhe métricas de tool calls do Gemini e escreve no mesmo ficheiro JSONL usado pelo Claude Code para métricas unificadas.
+
+## Responsabilidades
+
+- **Hook AfterTool**: Captura tool_name, session_id, success/error, duration
+- **Formato Unificado**: Escreve em `~/.claude-work/tool-invocations.jsonl` com campo `engine: gemini`
+- **Pré-Telemetria**: Script `gemini-pre-telemetry.py` regista timestamp de início para cálculo de duração
+- **Health Check**: `gemini-health.sh` verifica conectividade do Gemini CLI
+
+## Stack
+
+- **Python 3**: Scripts de hook (piped via stdin/stdout do Gemini CLI)
+- **Formato**: JSONL (compatível com Claude Code)
+- **Ficheiro**: `~/.claude-work/tool-invocations.jsonl`
+
+## Scripts
+
+| Script | Função | Trigger |
+|---|---|---|
+| `gemini-telemetry.py` (2.3KB) | Hook AfterTool — captura e regista métricas | Gemini CLI after tool call |
+| `gemini-pre-telemetry.py` (1.0KB) | Hook BeforeTool — regista timestamp início | Gemini CLI before tool call |
+| `gemini-health.sh` (1.0KB) | Health check conectividade Gemini | Manual/agendado |
+
+## Formato de Log
+
+```json
+{
+  "ts": "2026-06-30T12:00:00Z",
+  "session": "<session_id>",
+  "tool_name": "read_file",
+  "success": true,
+  "error": "",
+  "duration": 1.23,
+  "engine": "gemini"
+}
+```
+
+## Localizações
+
+- **Scripts**: `Dev/DashDescomplicar/monitorizacao/` (3 ficheiros)
+- **Output**: `~/.claude-work/tool-invocations.jsonl`
+- **Temp**: `~/.gemini/tmp/telemetry/<session_id>.start`
+
+## Dependências
+
+- **Gemini CLI**: Pipe stdin/stdout para hooks Python
+- **Sistema de Ficheiros**: `~/.claude-work/`, `~/.gemini/tmp/`
+
+## Fornece a
+
+- **Observabilidade-Sessions**: Dados de telemetria Gemini unificados com Claude
+- **Sistema IA**: Métricas cross-engine (Claude + Gemini + Hermes + OpenCode)