feat: funciones impuras migration_create, migration_up, migration_down, migration_status

Fase 2 del issue 0015. MigrationCreate (crea archivo .sql template con version auto-calculada), MigrationUp (aplica migraciones pendientes en transacciones individuales), MigrationDown (revierte ultimas N via down_sql de _migrations), MigrationGetStatus (cruza disco con BD, detecta orphaned). Tests de integracion: ciclo completo create->up->status->down->status. 26 tests, todos pasan. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-13 02:01:40 +02:00
parent ca15655268
commit 9b0e1f836d
13 changed files with 1166 additions and 0 deletions
@@ -0,0 +1,52 @@
+---
+name: migration_down
+kind: function
+lang: go
+domain: infra
+version: "1.0.0"
+purity: impure
+signature: "func MigrationDown(db *sql.DB, n int) ([]Migration, error)"
+description: "Revierte las ultimas n migraciones aplicadas ejecutando su down_sql guardado en la tabla _migrations. Las reversiones ocurren en orden inverso de version (la mas alta primero). Cada reversion corre en su propia transaccion. Retorna las migraciones revertidas."
+tags: [migration, database, sql, schema, sqlite, rollback, down]
+uses_functions: []
+uses_types: [migration_go_infra]
+returns: [migration_go_infra]
+returns_optional: false
+error_type: "error_go_core"
+imports: ["database/sql", "fmt", "time"]
+params:
+  - name: db
+    desc: "conexion *sql.DB abierta a la base de datos SQLite con la tabla _migrations"
+  - name: "n"
+    desc: "numero de migraciones a revertir (las ultimas n en orden descendente de version). Si n <= 0 no hace nada."
+output: "slice de Migration con las migraciones que fueron revertidas (en orden descendente de version)"
+tested: true
+tests:
+  - "revertir ultima migracion elimina registro y ejecuta down_sql"
+  - "revertir n migraciones revierte en orden descendente"
+  - "n cero no revierte nada"
+  - "base de datos sin migraciones retorna slice vacio"
+test_file_path: "functions/infra/migration_down_test.go"
+file_path: "functions/infra/migration_down.go"
+---
+
+## Ejemplo
+
+```go
+db, _ := SQLiteOpen("", "apps/my_app/operations.db")
+defer db.Close()
+
+// Revertir la ultima migracion aplicada
+reverted, err := MigrationDown(db, 1)
+if err != nil {
+    log.Fatalf("rollback failed: %v", err)
+}
+for _, m := range reverted {
+    fmt.Printf("Reverted: %03d_%s\n", m.Version, m.Name)
+}
+// Reverted: 003_add_audit_log
+```
+
+## Notas
+
+Usa el `down_sql` almacenado en `_migrations`, no el archivo en disco. Esto garantiza que el rollback funciona aunque el archivo haya sido modificado o eliminado. Si `down_sql` esta vacio, solo se elimina el registro de `_migrations` sin ejecutar SQL. ATENCION: `MigrationDown` es destructiva — un `DROP TABLE` en el down elimina datos. Diseñada para desarrollo y no para revertir en produccion con datos vivos.