fn_registry/functions/infra/audit_uses_functions.md

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

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
audit_uses_functions	function	go	infra	1.0.0	impure	func AuditUsesFunctions(registryRoot string) ([]UsesFunctionsAudit, error)	Audita el campo uses_functions de cada app Go y Python registrada en registry.db comparandolo contra los imports reales del codigo fuente. Reporta funciones del registry importadas pero no declaradas (missing_in_app_md) y funciones declaradas pero no detectadas en el codigo (unused_in_app_md). Read-only: no modifica archivos ni la BD.	doctor registry-first audit imports uses_functions				false	error_go_core	bufio database/sql encoding/json fmt os path/filepath regexp strings unicode github.com/mattn/go-sqlite3	name desc registryRoot ruta absoluta al directorio raiz del fn_registry (donde vive registry.db y apps/)	slice de UsesFunctionsAudit, uno por app Go o Python registrada. Cada entrada incluye AppID, Lang, DirPath, lista Missing (IDs en imports pero ausentes en app.md) y lista Unused (IDs en app.md pero no detectados en codigo). Error solo si registry.db no puede abrirse. Apps cuyo dir_path no existe en disco se incluyen con Missing/Unused nil.	true	missing function detected for Go app unused function detected for Go app missing dir returns entry with nil slices	functions/infra/audit_uses_functions_test.go	functions/infra/audit_uses_functions.go

Ejemplo

results, err := AuditUsesFunctions("/home/lucas/fn_registry")
if err != nil {
    log.Fatal(err)
}
for _, r := range results {
    if len(r.Missing) > 0 {
        fmt.Printf("[%s] MISSING en app.md: %v\n", r.AppID, r.Missing)
    }
    if len(r.Unused) > 0 {
        fmt.Printf("[%s] UNUSED en app.md: %v\n", r.AppID, r.Unused)
    }
}

Heuristica Go

1. Escanea todos los .go de la app buscando "fn-registry/functions/<domain>" en imports.
2. Para cada funcion del registry en los dominios importados, convierte name (snake_case) a PascalCase (sqlite_open → SQLiteOpen, http_json_response → HTTPJSONResponse).
3. Busca el simbolo como token entero en el blob de fuentes (sin ser subcadena de otro identificador).

Abreviaturas reconocidas: HTTP, SQL, URL, API, ID, DB, TLS, JSON, XML, SSH, IO, OK, UI. Si el nombre exportado real difiere de la convencion (ej. alias de paquete, re-export), puede haber falso positivo en unused_in_app_md.

Heuristica Python

Busca from <pkg> import X, Y en .py de la app. Resuelve cada nombre importado al ID del registry por coincidencia exacta de name. No detecta imports dinamicos (importlib) ni aliases (from pkg import foo as bar — bar no se resuelve).

Notas

• Read-only: no toca la BD ni archivos.
• Apps cuyo dir_path no existe en disco se incluyen con Missing = nil, Unused = nil (no se puede inspeccionar el codigo).
• Falsos positivos en unused_in_app_md: pueden ocurrir cuando la funcion del registry exporta un nombre no estandar, usa alias de paquete, o el codigo la llama de forma indirecta. Confirmar a mano antes de eliminar de uses_functions.
• Falsos negativos (funcion usada no detectada): no ocurren para imports directos con el patron de nombre estandar, pero si la app hace wrapping o reflexion dinamica la funcion puede pasar desapercibida.
• Python: solo detecta from pkg import X. Los import pkg seguidos de pkg.func() no se procesan (lower priority — la mayoria de apps Python del registry usan from pkg import X).