chore: auto-commit (5 archivos)

- CMakeLists.txt
- agent.cpp
- agent.h
- gx-cli
- main.cpp

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

agent.h

@@ -0,0 +1,65 @@
+#pragma once
+
+#include <string>
+#include <vector>
+
+// Panel Chat — agente Claude (claude -p) con tool-use sobre operations.db
+// via gx-cli. Subprocess persistente bidireccional (stdin/stdout JSON-lines).
+// El usuario escribe, el hilo lector parsea stream-json y va emitiendo
+// fragmentos al historial. gx-cli muta operations.db; el contador
+// agent_mutations en graph_explorer.db dispara reload del viewport.
+
+namespace app_agent {
+
+// Inicia el subprocess claude -p (lazy: hasta el primer mensaje no se
+// arranca). Setea env vars GX_OPS_DB / GX_APP_DB / GX_APP_DIR. Devuelve
+// false si claude no esta disponible (o, en Windows, wsl no esta).
+bool chat_init(const char* ops_db_path,
+               const char* app_db_path,
+               const char* app_dir);
+
+// Si la ops_db cambia (proyecto switch), refresca env del subprocess
+// matandolo y dejando que el siguiente send lo reabra.
+void chat_set_ops_db(const char* ops_db_path);
+
+// Envia un mensaje del usuario al agente. Si el subprocess no esta vivo,
+// lo arranca primero. No bloquea — el resultado llega via chat_render
+// al ir vaciando la cola del hilo lector.
+void chat_send(const char* user_text);
+
+// Renderiza el panel ImGui (titulo "Chat"). Drena cola de mensajes del
+// hilo lector. `panel_open` es bound al close button.
+void chat_render(bool* panel_open);
+
+// Cierra el subprocess y libera recursos. Llamar en shutdown.
+void chat_shutdown();
+
+// Counter de mutaciones (lee tabla agent_mutations en app_db). Se llama
+// desde main.cpp cada frame para detectar si gx-cli muto algo y disparar
+// reload del grafo. Devuelve 0 si la tabla no existe todavia.
+int chat_mutations_counter();
+
+// ----------------------------------------------------------------------------
+// Logging con tags
+//
+// Todas las trazas del subsistema chat van a `<app_dir>/chat.log` ademas de
+// stderr. Cada linea tiene formato:
+//
+//     2026-05-01T18:35:50.853Z [chat:detect] mensaje
+//
+// Tags usados (grep amigable):
+//   detect    deteccion de claude/wsl al arrancar
+//   env       env vars seteadas para el subprocess
+//   spawn     argv completo + cwd al lanzar el subprocess
+//   io        operaciones sobre los pipes (lectura/escritura/EOF)
+//   parse     eventos JSON parseados desde stream-json
+//   tools     tool_use detectados, comandos Bash invocados
+//   mut       cambios detectados via agent_mutations.counter
+//   error     fallos y exit codes
+// ----------------------------------------------------------------------------
+void chat_log(const char* tag, const char* fmt, ...);
+
+// Devuelve el path absoluto del fichero de log (vacio si no inicializado).
+const char* chat_log_path();
+
+} // namespace app_agent