egutierrez
7913116a8e
- .claude/agents/fn-analizador/SKILL.md - .claude/agents/fn-constructor/SKILL.md - .claude/agents/fn-executor/SKILL.md - .claude/agents/fn-mejorador/SKILL.md - .claude/agents/fn-orquestador/SKILL.md - .claude/agents/fn-recopilador/SKILL.md - .claude/commands/app.md - .claude/commands/compile.md - .claude/commands/cpp-app.md - .claude/commands/create_functions.md - ... Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
67 lines
3.6 KiB
Markdown
67 lines
3.6 KiB
Markdown
---
|
|
name: audit_uses_functions
|
|
kind: function
|
|
lang: go
|
|
domain: infra
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "func AuditUsesFunctions(registryRoot string) ([]UsesFunctionsAudit, error)"
|
|
description: "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."
|
|
tags: [doctor, registry-first, audit, imports, uses_functions]
|
|
uses_functions: []
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: ["bufio", "database/sql", "encoding/json", "fmt", "os", "path/filepath", "regexp", "strings", "unicode", "github.com/mattn/go-sqlite3"]
|
|
params:
|
|
- name: registryRoot
|
|
desc: "ruta absoluta al directorio raiz del fn_registry (donde vive registry.db y apps/)"
|
|
output: "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."
|
|
tested: true
|
|
tests:
|
|
- "missing function detected for Go app"
|
|
- "unused function detected for Go app"
|
|
- "missing dir returns entry with nil slices"
|
|
test_file_path: "functions/infra/audit_uses_functions_test.go"
|
|
file_path: "functions/infra/audit_uses_functions.go"
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
results, err := AuditUsesFunctions("$HOME/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`).
|