---
name: resolve_registry_root
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func ResolveRegistryRoot() (string, error)"
description: "Devuelve la ruta absoluta de la raíz del fn_registry (el directorio que contiene registry.db). Resuelve en orden: env var FN_REGISTRY_ROOT, walk-up desde el ejecutable (hasta 6 niveles), y $HOME/fn_registry. Retorna error si ningún método localiza registry.db. Centraliza la resolución dinámica para que ningún binario del ecosistema necesite un path hardcodeado."
tags: [registry, infra, root, path, env]
uses_functions: []
uses_types: []
params:
  - name: (ninguno)
    desc: "La función no recibe argumentos."
output: "Ruta absoluta del directorio raíz del fn_registry (contiene registry.db), o error descriptivo si no se encontró."
returns: []
returns_optional: false
error_type: "error_go_core"
imports: ["fmt", "os", "path/filepath"]
tested: true
tests:
  - "env var apunta a tmpdir con registry.db"
  - "HOME apunta a tmpdir con fn_registry/registry.db"
  - "nada existe devuelve error"
test_file_path: "functions/infra/resolve_registry_root_test.go"
file_path: "functions/infra/resolve_registry_root.go"
---

## Ejemplo

```go
root, err := infra.ResolveRegistryRoot()
if err != nil {
    log.Fatalf("no se pudo localizar fn_registry: %v", err)
}
// Construir ruta al binario fn
fnBin := filepath.Join(root, "fn")
cmd := exec.Command(fnBin, "run", "mi_funcion")
```

## Cuando usarla

Cuando un binario Go del ecosistema (dag_engine, deploy_server, registry_mcp, etc.) necesita localizar la raíz del registry para construir rutas a `fn run`, abrir `registry.db`, o encontrar `python/.venv` — y `FN_REGISTRY_ROOT` puede no estar seteado en el entorno del usuario.

## Gotchas

- **Depende del entorno en tiempo de ejecución** (env vars + filesystem): no es determinista. Dos llamadas sucesivas desde entornos distintos pueden devolver rutas distintas.
- **El paso 2 (walk-up desde ejecutable) asume que el binario vive dentro del árbol del registry.** Si el binario se copia a `/usr/local/bin` o a un directorio externo, este paso no encontrará nada — los pasos 1 y 3 sirven como fallback.
- **En `go test` el exe es un binario temporal** generado por el framework de tests, que vive en `/tmp/`. Por eso el paso 2 no encontrará `registry.db` durante los tests unitarios. Los tests de esta función usan `t.Setenv` para cubrir los pasos 1 y 3 sin depender del entorno real.
- **El paso 3 deriva `$HOME` dinámicamente** con `os.UserHomeDir()` — nunca hay paths de usuario hardcodeados.
