fn_registry/functions/infra/migration_status.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
migration_status	function	go	infra	1.0.0	impure	func MigrationGetStatus(db *sql.DB, dir string) ([]MigrationStatus, error)	Cruza los archivos .sql del directorio con los registros en _migrations y retorna una lista ordenada por version con el estado de cada migracion (applied/pending). Migraciones en BD pero sin archivo en disco se marcan como orphaned. Si _migrations no existe aun, todas las migraciones del directorio aparecen como pending.	migration database sql schema sqlite status list	migration_parse_go_infra	MigrationStatus_go_infra	MigrationStatus_go_infra	false	error_go_core	database/sql fmt sort strings time	name desc db conexion *sql.DB abierta a la base de datos SQLite (puede no tener _migrations aun) name desc dir path al directorio con los archivos .sql de migracion (puede no existir)	slice de MigrationStatus ordenado por version ascendente con Applied y AppliedAt para cada migracion	true	migraciones en disco pero no en BD aparecen como pending migraciones aplicadas aparecen con Applied=true y AppliedAt migraciones aplicadas sin archivo en disco aparecen como orphaned base de datos sin tabla _migrations retorna todas como pending	functions/infra/migration_status_test.go	functions/infra/migration_status.go

Ejemplo

db, _ := SQLiteOpen("", "apps/my_app/operations.db")
defer db.Close()

statuses, err := MigrationGetStatus(db, "apps/my_app/migrations")
if err != nil {
    log.Fatal(err)
}
for _, s := range statuses {
    if s.Applied {
        fmt.Printf("%03d %-30s applied at %s\n", s.Version, s.Name, s.AppliedAt.Format(time.RFC3339))
    } else {
        fmt.Printf("%03d %-30s pending\n", s.Version, s.Name)
    }
}
// 001 create_users                  applied at 2026-04-13T10:30:00Z
// 002 add_roles                     applied at 2026-04-13T10:30:00Z
// 003 add_audit_log                 pending

Notas

Combina informacion de disco (archivos .sql) y BD (tabla _migrations) para dar una vision completa del estado. Las migraciones "orphaned" son aquellas que aparecen en _migrations pero ya no tienen archivo en disco — esto puede indicar que el archivo fue eliminado despues de aplicarse. La tabla _migrations se crea con MigrationUp; si no existe aun, MigrationStatus las trata todas como pending.