fn_registry/functions/infra/audit_capability_groups.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_capability_groups	function	go	infra	1.0.0	impure	func AuditCapabilityGroups(root string) ([]CapabilityGroupAudit, error)	Audita drift entre grupos declarados en docs/capabilities/INDEX.md, tags presentes en registry.db y paginas existentes en docs/capabilities/. Detecta grupos sin doc, sin funciones, candidatos sin declarar y docs huerfanas.	doctor capability-groups audit infra				false	error_go_core	database/sql bufio fmt os path/filepath regexp sort strings github.com/mattn/go-sqlite3	false			functions/infra/audit_capability_groups.go	name desc root raiz del repo fn_registry (donde vive registry.db y docs/capabilities/)	lista de CapabilityGroupAudit ordenada por group asc, con drift detectado

Tipo: CapabilityGroupAudit

type CapabilityGroupAudit struct {
    Group           string   `json:"group"`             // slug del grupo (tag canonico)
    DeclaredInIndex bool     `json:"declared_in_index"` // aparece en INDEX.md
    DocExists       bool     `json:"doc_exists"`        // existe docs/capabilities/<group>.md
    FunctionCount   int      `json:"function_count"`    // funciones con ese tag
    Issues          []string `json:"issues"`            // lista de problemas detectados
    OK              bool     `json:"ok"`                // true si Issues esta vacio
}

Issues posibles

Issue	Condicion
doc_missing	Grupo declarado en INDEX pero no existe el .md
no_functions	Grupo declarado pero ningun tag en registry.db coincide
below_minimum	Grupo declarado con 1 o 2 funciones (minimo es 3)
ungrouped_candidate	Tag con >= 3 funciones, no declarado en INDEX ni tiene .md
doc_orphan	Existe docs/capabilities/.md pero no esta en INDEX.md

Ejemplo

audits, err := AuditCapabilityGroups("/home/lucas/fn_registry")
if err != nil {
    log.Fatal(err)
}
for _, a := range audits {
    if !a.OK {
        fmt.Printf("%s: %v\n", a.Group, a.Issues)
    }
}

Notas

• Abre registry.db en modo read-only (no modifica nada).
• Parsea INDEX.md con regex \[([a-z][a-z0-9_-]*)\]\(\1\.md\) — solo links donde el texto y el href tienen el mismo slug.
• Tags con count >= 3 que no estan en INDEX se emiten como ungrouped_candidate.
• Si INDEX.md no existe, se trata como conjunto vacio (no es error).
• Usada por fn doctor capabilities para diagnostico del registry.