---
name: find_unused_functions
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func FindUnusedFunctions(registryRoot string) ([]UnusedFunction, error)"
description: "Abre registry.db y retorna todas las funciones que no son referenciadas por ninguna otra funcion, app ni analisis. Util para detectar candidatas a deprecar o eliminar (fn doctor unused)."
tags: [doctor, registry, unused, cleanup]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports:
  - "database/sql"
  - "encoding/json"
  - "fmt"
  - "strings"
  - "time"
  - "github.com/mattn/go-sqlite3"
params:
  - name: registryRoot
    desc: "Ruta absoluta a la raiz del registry (directorio que contiene registry.db)."
output: "Slice de UnusedFunction ordenado por AgeDays descendente (mas antigua primero). Cada entrada incluye ID, Name, Lang, Domain, Tags (JSON array como string) y AgeDays (dias desde updated_at)."
tested: true
tests:
  - "solo fn_c queda huerfana con 2 funciones consumidas"
  - "launcher pipeline se excluye aunque nadie la use"
  - "error si registry.db no existe"
test_file_path: "functions/infra/find_unused_functions_test.go"
file_path: "functions/infra/find_unused_functions.go"
---

## Ejemplo

```go
unused, err := FindUnusedFunctions("$HOME/fn_registry")
if err != nil {
    log.Fatal(err)
}
for _, u := range unused {
    fmt.Printf("%s (%s/%s) — %d dias sin uso\n", u.ID, u.Lang, u.Domain, u.AgeDays)
}
```

## Notas

- Recorre `uses_functions` en tres tablas: `functions`, `apps` y `analysis`.
- Pipelines con tag `launcher` se excluyen: son endpoints intencionales aunque nadie los llame.
- Pipelines sin tag `launcher` y sin consumidor SÍ aparecen — son candidatos igual.
- Los tipos no se incluyen (eso es responsabilidad de otra funcion).
- El campo `Tags` retornado es el JSON array crudo (ej. `["deprecated","core"]`) para que el caller pueda filtrar por tag sin deserializar en esta funcion.
- `AgeDays` se calcula con `time.Parse(time.RFC3339, updated_at)`.
