---
name: migration_status
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func MigrationGetStatus(db *sql.DB, dir string) ([]MigrationStatus, error)"
description: "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."
tags: [migration, database, sql, schema, sqlite, status, list, pendiente-usar]
uses_functions: [migration_parse_go_infra]
uses_types: [MigrationStatus_go_infra]
returns: [MigrationStatus_go_infra]
returns_optional: false
error_type: "error_go_core"
imports: ["database/sql", "fmt", "sort", "strings", "time"]
params:
  - name: db
    desc: "conexion *sql.DB abierta a la base de datos SQLite (puede no tener _migrations aun)"
  - name: dir
    desc: "path al directorio con los archivos .sql de migracion (puede no existir)"
output: "slice de MigrationStatus ordenado por version ascendente con Applied y AppliedAt para cada migracion"
tested: true
tests:
  - "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"
test_file_path: "functions/infra/migration_status_test.go"
file_path: "functions/infra/migration_status.go"
---

## Ejemplo

```go
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.
