fn_registry/functions/infra/artefact_doctor.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
artefact_doctor	function	go	infra	1.0.0	impure	func ArtefactDoctor(registryRoot string) ([]ArtefactCheck, error)	Audita la salud de cada artefacto (apps + analyses) registrado en registry.db. Para cada uno verifica: directorio en disco, presencia de .git, manifest parseable (app.md/analysis.md con campo name), venv de Python valido (solo analyses) y rama upstream configurada en git. Read-only, no toca red ni modifica nada.	doctor health artefact audit				false	error_go_core	bufio bytes context database/sql fmt os os/exec path/filepath strings time github.com/mattn/go-sqlite3	name desc registryRoot ruta absoluta al directorio raiz del fn_registry (donde vive registry.db)	slice de ArtefactCheck, uno por artefacto. Cada entrada incluye ID, Type, DirPath, lista de Issues y campo OK. Error solo si la BD no se puede abrir.	true	TestArtefactDoctor_DetectsMissingDir TestArtefactDoctor_OKArtefact	functions/infra/artefact_doctor_test.go	functions/infra/artefact_doctor.go

Ejemplo

checks, err := ArtefactDoctor("/home/lucas/fn_registry")
if err != nil {
    log.Fatal(err)
}
for _, c := range checks {
    if !c.OK {
        fmt.Printf("[%s] %s: %v\n", c.Type, c.ID, c.Issues)
    }
}

Issues posibles

Issue	Causa
directory_missing	dir_path del artefacto no existe en disco
git_not_initialized	Falta .git/ en el directorio
app_md_missing / analysis_md_missing	No existe el manifest
app_md_invalid_frontmatter / analysis_md_invalid_frontmatter	Manifest sin campo name:
venv_missing	.venv/bin/python3 no existe (solo analyses)
venv_broken_path	Symlink roto o binario no ejecutable (solo analyses)
no_upstream_branch	git rev-parse @{u} falla — sin push previo o sin remote

Notas

• Read-only: no modifica archivos ni BDs.
• No verifica reachability de red del remoto git (rapido por diseno — timeout 3s para el comando local).
• Usa exec.CommandContext con timeout de 3 segundos para el check de git upstream.
• dir_path en registry.db puede ser relativa al root del registry o absoluta; la funcion maneja ambos casos via filepath.Join.
• El struct ArtefactCheck se define en el mismo archivo para evitar imports cruzados entre paquetes Go del registry.