registry_dashboard/app.md

name, lang, domain, description, tags, uses_functions, uses_types, framework, entry_point, dir_path, repo_url

name	lang	domain	description	tags	uses_functions	uses_types	framework	entry_point	dir_path	repo_url
registry_dashboard	cpp	tui	Dashboard ImGui para visualizar el estado del fn_registry. Consume datos via sqlite_api HTTP (fallback a SQLite directo). KPIs, charts, tablas, desglose por lenguaje/dominio/pureza.	dashboard imgui visualization registry http	kpi_card_cpp_viz bar_chart_cpp_viz pie_chart_cpp_viz table_view_cpp_viz sparkline_cpp_viz dashboard_panel_cpp_core dashboard_grid_cpp_core fps_overlay_cpp_core fullscreen_window_cpp_core		imgui	main.cpp	projects/fn_monitoring/apps/registry_dashboard	https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/dataforge/registry_dashboard

Arquitectura

Dashboard C++ con dos modos de acceso a datos:

1. HTTP API (primario): Conecta a sqlite_api via HTTP para obtener datos de registry.db. No requiere acceso al filesystem.
2. SQLite directo (fallback): Lee registry.db directamente si la API no esta disponible.

Data layers:

• data_http.cpp: Carga datos via HTTP POST a sqlite_api (cpp-httplib + nlohmann/json)
• data.cpp: Carga directa desde SQLite C API

Views (views.cpp): Compone funciones del registry C++ para renderizar:

• 8 KPI cards: functions, types, apps, analysis, unit tests, proposals, tested%, pure%
• Bar charts: funciones por lenguaje, por dominio
• Pie charts: pureza (pure/impure), kind (function/pipeline/component)
• Tablas: ultimas 20 funciones, apps, analysis, tipos

Build

# Linux
cd cpp && cmake -B build/linux -S . && cmake --build build/linux --target registry_dashboard -j$(nproc)

# Windows (cross-compile)
cd cpp && cmake -B build/windows -S . -DCMAKE_TOOLCHAIN_FILE=toolchains/mingw-w64.cmake && cmake --build build/windows --target registry_dashboard -j$(nproc)

Ejecucion

# Via API (default, intenta conectar a localhost:8484)
./registry_dashboard

# API explicita
./registry_dashboard --api http://192.168.1.10:8484

# Con SQLite fallback
./registry_dashboard --api http://127.0.0.1:8484 /path/to/registry.db

# Solo SQLite (sin API)
./registry_dashboard /path/to/registry.db

# Windows (PowerShell)
.\registry_dashboard.ps1

Dependencias vendored

Libreria	Version	Archivo
cpp-httplib	v0.18.3	vendor/httplib.h
nlohmann/json	v3.11.3	vendor/nlohmann/json.hpp

Roadmap

• Filtros interactivos por lenguaje/dominio en sidebar
• Busqueda FTS5 integrada via API
• Detalles de funcion al hacer click en tabla

Notas

• Por defecto intenta conectar a sqlite_api en http://127.0.0.1:8484. Si falla, usa SQLite directo.
• SQLite compilado estaticamente en Windows via amalgamation vendoreada. En Linux usa libsqlite3 del sistema.
• cpp-httplib usa sockets nativos (no OpenSSL) — solo HTTP, no HTTPS.

Estado actual

Fase — actions bar + projects tab + Add modal [done 2026-04-25]

Cambios estructurales (requieren sqlite_api v0.2 con endpoints de mutacion):

• Actions bar en el page header (fn_ui::toolbar): Reindex (Primary) → http_post_reindex via process_runner; + Add (Secondary) → abre modal; Reload (Subtle) → re-fetch via UserData flag; toast_inbox_button con badge.
• Modal Add (modal_dialog): select para Kind (App/Analysis/Vault), select de proyecto (obligatorio para Vault), text_input Name + Description + campos especificos. process_runner para el POST. Toast de exito/error + reload al completar.
• Tab Projects (tree_view + tabs): columna izquierda con proyectos + entrada "(orphans)"; columna derecha con detalle nested (Apps/Analysis/Vaults). Click dispara load_project_detail_http.

RegistryData gana projects[], orphan_apps, orphan_analyses, orphan_vaults. Tipos nuevos ProjectRow, VaultRow, ProjectDetail. Layer data_http.cpp gana load_projects_http, load_project_detail_http, http_post_{reindex,add_app,add_analysis,add_vault}.

AnalysisRow gana campo lang para coherencia con la tabla analysis (la query SQL pasa de SELECT id,name,domain,description a SELECT id,name,lang,domain,description).

views_set_api_url(url) invocado desde main.cpp para que las vistas puedan disparar mutaciones.

Bug fixes operativos [done 2026-04-25]

• Vibracion al redimensionar: fullscreen_window v0.2 (NoScrollbar), altura de charts fija 260 px, kpi_card v1.2 (78 px + scale 1.4 + NoScrollbar). Ver project.md para detalle.
• HTTP POST timeout 5 ms en Windows: http_client.cpp::request() usaba struct timeval en setsockopt(SO_RCVTIMEO), que Windows interpreta como DWORD ms → 5 ms efectivos. Fix: rama _WIN32 con DWORD timeout_ms = timeout_sec * 1000. wsa_init envuelto en std::call_once.
• Mensajes de toast vacios: post_json ahora siempre escribe en out_body (extrae output del JSON en exito; sintetiza "connect() failed to host:port (err=N)" con codigo Winsock en error de conexion). Em dash sustituido por ASCII : para evitar render como ? en fuentes sin ese codepoint.
• Inbox popup en otra pantalla: toast_inbox_button antes usaba posicion calculada con btn_pos.x - 332 que podia caer fuera del WorkRect del viewport principal; con viewports = true ImGui lo movia a otra ventana del OS. Fix: clamp al WorkRect, anclar con ImGuiCond_Appearing (no Always), SetNextWindowViewport(vp->ID).

Toolchain MinGW para Windows [importante]

El cross-compile pasa de thread model win32 a posix (x86_64-w64-mingw32-g++-posix) para que std::mutex/std::thread funcionen — necesario para process_runner y toast. Linker: -static-libgcc -static-libstdc++ -static -lwinpthread. Configurado en cpp/toolchains/mingw-w64.cmake.

Lo siguiente que pega

• Filtros del Roadmap: el select de proyecto del modal Add ya prueba que filtrar por proyecto es trivial; aplicar mismo patron a las tablas Apps/Analysis/Types.
• Detalles al click: cuando un row de la tabla Apps (o Functions) se selecciona, abrir un panel lateral con metadata + boton "Open in editor" (segun OS, xdg-open/explorer).
• Integracion FTS5: el endpoint /api/databases/registry/fts ya existe; falta cablearlo desde la actions bar como text_input con resultados live.

Notas — Settings menubar (sesion 2026-04-25)

• render() ahora llama fn_ui::app_menubar(nullptr, 0, nullptr) al inicio para exponer el item Settings... en la MainMenuBar. La app no tiene paneles toggleables ni layouts propios, asi que solo aparece Settings.
• El usuario puede cambiar fuente (DroidSans/Karla/Roboto/Cousine) y tamaño (10..32 px) en runtime, y togglear el FPS overlay. Persistencia en app_settings.ini junto al registry_dashboard.exe.
• CMakeLists.txt limpiado: fps_overlay.cpp y tokens.cpp ya viven en fn_framework — no listarlos explicitamente o el linker da multiple-definition.
• 5 TTFs (Karla/Roboto/DroidSans/Cousine/Tabler) copiadas junto al exe via add_imgui_app post-build.

Notas — Settings submenu + Git column (sesion 2026-04-28)

• fn_ui::app_menubar reemplaza el item plano Settings... por un BeginMenu("Settings") con dos subitems: Settings... (existente) y About... (nuevo modulo app_about_cpp_core). El registry_dashboard cablea la info via fn_ui::about_window_set_info("fn_registry Dashboard", "0.2.0", "Dashboard ImGui...") antes de fn::run_app.
• Tabla Apps gana columna Git: remote si repo_url esta poblado en apps.repo_url, local si existe <dir_path>/.git/, - si nada. AppRow extendido con repo_url y dir_path; SELECT en data.cpp y data_http.cpp ampliado a 8 columnas.
• Build OK: cmake --build build --target registry_dashboard (Linux). La columna "Git" se ve sin reindexar.