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>
58 lines
2.1 KiB
Markdown
58 lines
2.1 KiB
Markdown
---
|
|
name: audit_modules_drift
|
|
kind: function
|
|
lang: go
|
|
domain: infra
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "AuditModulesDrift(root string) ([]ModuleDriftCheck, error)"
|
|
description: "Detecta drift entre app.md uses_modules y CMakeLists.txt fn_module_<name> link calls. Para cada app C++ con CMakeLists.txt: parsea uses_modules + regex sobre target_link_libraries. Devuelve por-app: declared/linked/missing/extra/OK."
|
|
tags: [audit, modules, cmake, drift, doctor, cpp]
|
|
uses_functions: []
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports:
|
|
- gopkg.in/yaml.v3
|
|
file_path: "functions/infra/audit_modules_drift.go"
|
|
params:
|
|
- name: root
|
|
desc: "Raiz del repositorio fn_registry. Se escanean apps/*, projects/*/apps/*."
|
|
output: "Slice de ModuleDriftCheck (uno por app C++ con CMakeLists.txt). Apps sin CMakeLists son saltadas."
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
import "fn-registry/functions/infra"
|
|
|
|
checks, err := infra.AuditModulesDrift("$HOME/fn_registry")
|
|
if err != nil { panic(err) }
|
|
for _, c := range checks {
|
|
if !c.OK {
|
|
fmt.Printf("DRIFT %s: missing=%v extra=%v\n", c.AppID, c.MissingLinks, c.ExtraLinks)
|
|
}
|
|
}
|
|
```
|
|
|
|
Tambien expuesto via CLI:
|
|
|
|
```bash
|
|
fn doctor modules # tabla legible
|
|
fn doctor modules --json # JSON para agentes
|
|
```
|
|
|
|
## Cuando usarla
|
|
|
|
Tras anadir/quitar un modulo a la app:
|
|
- Verifica que el `uses_modules` del `app.md` y `target_link_libraries(... PRIVATE fn_module_*)` del CMakeLists.txt coinciden.
|
|
- Tras renombrar un modulo, detecta apps que quedaron con la version antigua.
|
|
- Como gate en `/full-git-push` antes de mergear cambios de modulos.
|
|
|
|
## Gotchas
|
|
|
|
- Apps sin `CMakeLists.txt` (Python, bash, etc.) se saltan — el drift check no aplica.
|
|
- Modulos IDs en `uses_modules` llevan sufijo `_<lang>` (ej. `data_table_cpp`); los link targets son `fn_module_<name>` (sin sufijo). La funcion strippa el sufijo antes de comparar.
|
|
- Regex acepta `fn_module_<name>` en cualquier parte del CMakeLists — comentarios incluidos. Si un comentario referencia un modulo no usado, se reporta como `extra_links` (falso positivo aceptable).
|