fn_registry/functions/infra/audit_data_table_usage.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, tested, tests, test_file_path, file_path, params, output

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	tested	tests	test_file_path	file_path	params	output
audit_data_table_usage	function	go	infra	1.0.0	impure	AuditDataTableUsage(registryRoot string) ([]DataTableUsageEntry, error)	Escanea apps C++ del registry que declaran uses_modules: [data_table_cpp] y detecta anti-patrones en su uso de data_table::render: ImGui::BeginTable inline, State stack-local (no persistente), render sin BeginChild host, event sink ignorado, y enlace cmake faltante.	audit data_table cpp lint doctor modules				false	error_go_core		false			functions/infra/audit_data_table_usage.go	name desc registryRoot Raiz absoluta del repositorio fn_registry. Se escanean apps/*, projects/*/apps/*. Solo procesa apps con lang: cpp y uses_modules incluye data_table_cpp.	Slice de DataTableUsageEntry, uno por app C++ con uses_modules: [data_table_cpp]. Status: ok (sin findings warn/error), warn (hay findings), n/a (no declara data_table_cpp).

Ejemplo

import "fn-registry/functions/infra"

entries, err := infra.AuditDataTableUsage("/home/lucas/fn_registry")
if err != nil {
    panic(err)
}
for _, e := range entries {
    if e.Status == "warn" {
        fmt.Printf("[%s] %s\n", e.AppID, e.DirPath)
        for _, f := range e.Findings {
            fmt.Printf("  %s (%s) %s:%d  %s\n", f.Kind, f.Severity, f.File, f.Line, f.Snippet)
        }
    }
}

Expuesto via CLI (una vez integrado en fn doctor):

fn doctor data-table           # tabla legible
fn doctor data-table --json    # JSON para agentes

Cuando usarla

• Tras anadir data_table_cpp a un nuevo app, verifica que el patron canonico se sigue.
• Como gate pre-merge cuando se toca código de integración de data_table.
• Periodicamente para detectar apps que usan ImGui::BeginTable directamente en lugar de data_table::render.
• Para auditar que el event sink (TableEvent/events_out) se consume donde se necesita interactividad.

Gotchas

• isInsideFunctionBody es heuristica de balance de llaves: falsos positivos posibles con lambdas o structs anonimos. Ruido bajo en codigo real.
• no_child_host mira 30 lineas hacia atras del data_table::render(. Si el BeginChild esta mas lejos (extraido en helper), se reportara falso positivo. Severidad warn, no error.
• inline_begintable suprime findings cuando el archivo contiene data_table y modules en su path relativo (evita ruido del modulo mismo).
• Apps cuyo directorio no existe en el PC local (sub-repos no clonados) se marcan warn: directory_missing en vez de analizarse. Esperado en entorno multi-PC.
• cmake_missing_link usa if(TARGET fn_module_data_table) pattern (conditional link). La funcion detecta la presencia de la string fn_module_data_table en CMakeLists.txt, sea en target_link_libraries o en el guard.