@tacuchi/agent-workflow-cli 9.3.0 → 10.0.0

package/skills/agent-workflow/exports/export-scripts/references/validations.md

@@ -1,41 +1,68 @@
-# Validations — V1-V6 para `/agent-workflow:export-scripts`
+# Validations — V1-V6 para `/agent-workflow:export-scripts` (v4.0.0)
 
-Checks post-render que se aplican antes de escribir el bundle al filesystem. Adaptados del canon de la familia export-* (export-arq + export-report) con foco en bundle SQL + informe.
+Checks post-render que se aplican antes de escribir el bundle al filesystem. Adaptados del canon de la familia export-* (export-arq + export-report) con foco en bundle SQL + informe único.
 
 Niveles de severidad:
 - **Hard-fail**: aborta la escritura, devuelve `ok: false` con error report. No se crea el directorio.
 - **Warning**: emite mensaje, pide confirmación del usuario para continuar.
 
-## V1 — Estructura del bundle
+## V1 — Estructura del bundle (layout plano cross-session)
 
-**Severidad**: hard-fail si falta archivo obligatorio o sub-dir esperado.
+**Severidad**: hard-fail si falta archivo obligatorio O aparece archivo/sub-dir vetado.
 
-**Archivos obligatorios siempre**:
-- `manifest.md`
-- `README.md`
-- `ORDER.md`
-- `rollback-global.sql`
-- `por-sesion/` con ≥1 sesión
+### Archivos obligatorios siempre
 
-**Archivos condicionales**:
-- `por-tema/` con ≥1 tema — sólo si la activación de Paso 6 dio positivo (themes declarados, `## Temas` en OBJECTIVE, o `--themes infer`).
+- `README.md` — único informe + índice + how-to-execute.
+- `00-ROLLBACK.sql` — sólo si al menos una categoría 01-04 tiene contenido (si todo el corpus está vacío, no se escribe el bundle).
 
-**Cómo validar**: listar el output dir antes de escribir el manifest final; verificar que todos los archivos obligatorios estarán presentes.
+### Archivos por categoría (skip silencioso si vacío)
+
+- `01-DDL-TABLES.sql` — sólo si hay sentencias `@category: 01` en el corpus.
+- `02-DDL-FUNCTIONS.sql` — sólo si hay sentencias `@category: 02`.
+- `03-DML.sql` — sólo si hay sentencias `@category: 03`.
+- `04-INSERTS.sql` — sólo si hay sentencias `@category: 04`.
+
+### Archivos condicionales
+
+- `_queries/<sessionXXX>/` — sólo si la sesión origen tenía `queries/`.
+- `por-tema/<slug>/` — sólo si `--themes` activado, `## Temas` declarado, o `--themes infer`.
+
+### Archivos VETADOS (presencia → hard-fail)
+
+Layout v3.x eliminado desde v4.0.0:
+- `manifest.md` (absorbido por `README.md`).
+- `ORDER.md` (absorbido por §4 del `README.md`).
+- `rollback-global.sql` separado (reemplazado por `00-ROLLBACK.sql`).
+- `por-sesion/` y todo su contenido (consolidación es cross-session al root).
+- `<file>.rollback.sql` companions por sentencia (eliminado en sql-rollback-generator v2.0.0).
+- `<session>/rollback/` sub-carpetas per-sesión (eliminado en sql-rollback-generator v2.0.0).
+
+**Cómo validar**: listar el output dir antes de escribir el bundle final; verificar que (a) archivos obligatorios están presentes y (b) no aparece nada del set vetado.
 
 **Error report (hard-fail)**:
 ```
-V1 FAILED: bundle incompleto
-  esperado: manifest.md, README.md, ORDER.md, rollback-global.sql, por-sesion/
-  encontrado: manifest.md, README.md, por-sesion/
-  faltantes: ORDER.md, rollback-global.sql
-  acción: regenerar pasos 7 y 9
+V1 FAILED: estructura del bundle incompatible con v4.0.0
+  esperado al root: README.md + 0X-*.sql (categorías con contenido)
+  encontrado vetado: por-sesion/ (4 sub-carpetas), manifest.md, rollback-global.sql
+  acción: el generador está produciendo layout v3.x — revisar export-scripts v4.0.0 + sql-rollback-generator v2.0.0
 ```
 
-## V2 — Noise vetado
+## V2 — Noise vetado + anti-redundancia v4.0.0
+
+**Severidad**: hard-fail si hay ≥1 ocurrencia.
+
+**Scope**: body-only del `README.md` — líneas después de `# Bundle export-scripts NNN` (h1 inicial) y antes de `## 10. Metadata`.
 
-**Severidad**: hard-fail si hay ≥1 ocurrencia en el cuerpo del `manifest.md` (header y sección Metadata exentos).
+**Patrones vetados** (catálogo en `references/lexico-tecnico.md` + reglas anti-redundancia v4.0.0):
 
-**Scope**: body-only — líneas después de `# Informe del bundle NNN` (h1 inicial) y antes de `## 10. Metadata`.
+1. Placeholders sin reemplazar: `NNN`, `YYYY-MM-DD`, `[entre corchetes]`, `<placeholder>`.
+2. Paths absolutos del developer: `/Users/`, `/home/`, `C:\\`.
+3. Referencias residuales al layout v3.x dentro de prosa generada (no en bloques deprecation explicit):
+   - `por-sesion/` en `## 4. Secuencia de ejecución` o `## 5. Rollback` (esos paths fueron eliminados).
+   - `manifest.md` como recurso vigente del bundle (sólo válido si se cita el template DEPRECATED).
+   - `ORDER.md` como archivo del bundle (eliminado).
+   - `rollback-global.sql` como path activo (renombrado a `00-ROLLBACK.sql`).
+   - `<file>.rollback.sql` companions.
 
 **Cómo validar**:
 ```bash
@@ -44,40 +71,43 @@ awk '
   /^## 10\. Metadata/ { body=0 }
   body { print }
   /^# / && !/Metadata/ { body=1 }
-' manifest.md > /tmp/body.md
+' README.md > /tmp/body.md
 grep -n -F -f references/lexico-tecnico.md /tmp/body.md
+# Plus anti-redundancia v4.0.0:
+grep -nE 'por-sesion/|rollback-global\.sql|\.rollback\.sql|ORDER\.md|manifest\.md' /tmp/body.md
 ```
 
 **Error report (hard-fail)**:
 ```
-V2 FAILED: noise vetado detectado en cuerpo del manifest
+V2 FAILED: noise vetado / redundancia v3.x detectados en README.md
   ocurrencias:
     línea 12: "NNN-export-scripts-YYYY-MM-DD"  → placeholder sin reemplazar
     línea 28: "/Users/tacuchi/"                → path absoluto del developer
-    línea 41: "DEC-NNN"                        → placeholder sin reemplazar
+    línea 65: "por-sesion/session001-*/"       → layout v3.x deprecated
   total: 3 ocurrencias
-  acción: completar render y stripear paths absolutos
+  acción: completar render con paths v4.0.0 y stripear referencias legacy
 ```
 
-## V3 — Secciones obligatorias del manifest
+## V3 — Secciones obligatorias del README único
 
 **Severidad**: hard-fail si falta una sección obligatoria.
 
-**Secciones obligatorias** (todas siempre presentes en `manifest.md`):
+**Secciones obligatorias** (todas siempre presentes en `README.md`):
+
 1. `## 1. Resumen ejecutivo`
 2. `## 2. Sesiones incluidas`
 3. `## 3. Acciones manuales previas a producción`
-4. `## 4. Base de datos`
-5. `## 5. Código fuente — hallazgos del escaneo`
-6. `## 6. Git y ramas`
-7. `## 7. Documentación graduada`
-8. `## 8. Checklist final de producción`
-9. `## 9. Advertencias`
+4. `## 4. Secuencia de ejecución (01 → 04)`
+5. `## 5. Rollback (\`00-ROLLBACK.sql\`)`
+6. `## 6. Código fuente — hallazgos del escaneo`
+7. `## 7. Git y ramas`
+8. `## 8. Documentación graduada`
+9. `## 9. Checklist final de producción`
 10. `## 10. Metadata`
 
 **Cómo validar**:
 ```bash
-grep -c '^## [0-9]\+\. ' manifest.md  # debe dar exactamente 10
+grep -c '^## [0-9]\+\. ' README.md  # debe dar exactamente 10
 ```
 
 **Error report (hard-fail)**:
@@ -85,34 +115,34 @@ grep -c '^## [0-9]\+\. ' manifest.md  # debe dar exactamente 10
 V3 FAILED: secciones obligatorias faltantes
   esperadas: 10
   encontradas: 8
-  faltantes: "## 5. Código fuente — hallazgos del escaneo", "## 9. Advertencias"
-  acción: regenerar manifest con secciones completas
+  faltantes: "## 5. Rollback (`00-ROLLBACK.sql`)", "## 9. Checklist final de producción"
+  acción: regenerar README con secciones completas
 ```
 
 ## V4 — Secciones condicionales honored
 
 **Severidad**: hard-fail si una sub-sección condicional aparece sin justificación o falta cuando debería estar.
 
-### V4.a — Vista por tema (`## 4.4 Vista por tema`)
+### V4.a — Mapping por tema (`## 4.1 Mapping sesión ↔ tema ↔ scripts`)
 
-- **Patrón A — activada**: temas declarados (CLI flag o `## Temas`) → sub-sección `## 4.4 Vista por tema` presente con conteo + paths a `por-tema/`.
-- **Patrón B — no activada**: sin temas → sub-sección `## 4.4 Vista por tema` **ausente** (no aparece header ni placeholder).
+- **Patrón A — `--themes` activado**: sub-sección `## 4.1 Mapping sesión ↔ tema ↔ scripts` presente con tabla de mapping.
+- **Patrón B — sin temas**: sub-sección `## 4.1` **ausente** (no aparece header ni placeholder).
 
 **Error report (Patrón B esperado pero sección presente sin contenido)**:
 ```
-V4.a FAILED: sin temas declarados pero sección "## 4.4 Vista por tema" presente
+V4.a FAILED: sin temas declarados pero sección "## 4.1 Mapping" presente
   themes: []
   acción: omitir sección cuando no hay temas (no dejar placeholder)
 ```
 
-### V4.b — Code scan skip (`## 5`)
+### V4.b — Code scan skip (`## 6`)
 
-- **Patrón A — escaneo ejecutado**: sección 5 contiene resumen con counts (`X críticos · Y medios · Z bajos`).
-- **Patrón B — `--skip-code-scan`**: sección 5 contiene **nota inline explícita** `_(Escaneo omitido por --skip-code-scan)_` y no hay tabla de hallazgos.
+- **Patrón A — escaneo ejecutado**: sección 6 contiene resumen con counts (`X críticos · Y medios · Z bajos`).
+- **Patrón B — `--skip-code-scan`**: sección 6 contiene **nota inline explícita** `_(Escaneo omitido por --skip-code-scan)_` y no hay tabla de hallazgos.
 
 **Error report (Patrón B esperado pero tabla presente)**:
 ```
-V4.b FAILED: --skip-code-scan declarado pero sección 5 tiene tabla de hallazgos
+V4.b FAILED: --skip-code-scan declarado pero sección 6 tiene tabla de hallazgos
   args: --skip-code-scan
   acción: reemplazar tabla por nota inline
 ```
@@ -129,17 +159,32 @@ V4.c FAILED: sesiones activas detectadas pero no marcadas con ⚠
   acción: marcar con ⚠ en tabla y documentar motivo en columna Resumen
 ```
 
-## V5 — Header bien formado
+### V4.d — Categorías SQL vacías
+
+- **Patrón A — categoría con contenido**: archivo `0X-*.sql` presente al root + referencia en §4 del README.
+- **Patrón B — categoría vacía**: archivo `0X-*.sql` **ausente** + comando psql correspondiente **omitido** del bloque de §4 (no aparece línea con archivo inexistente).
+
+**Error report (Patrón B con referencia)**:
+```
+V4.d FAILED: categoría 03-DML vacía pero referenciada en §4
+  corpus_dml_count: 0
+  archivo presente: false
+  referencia README: línea 88 → "psql ... -f 03-DML.sql"
+  acción: omitir comando psql cuando la categoría está vacía
+```
+
+## V5 — Header del README bien formado
 
 **Severidad**: warning.
 
-**Checks** (líneas 1-5 del `manifest.md`):
-- Línea 1: `# Informe del bundle NNN — <YYYY-MM-DD>` con NNN reemplazado.
+**Checks** (líneas 1-7 del `README.md`):
+
+- Línea 1: `# Bundle export-scripts NNN — <YYYY-MM-DD>` con NNN reemplazado.
 - Línea 3: `- **Rama actual:** \`<nombre-rama>\``
 - Línea 4: `- **Rama destino:** \`certificacion\``
 - Línea 5: `- **Sesiones incluidas:** <N>`
 - Línea 6: `- **Readiness:** 🟢 verde | 🟡 amarillo | 🔴 rojo` (una sola opción seleccionada).
-- Línea 7: `- **Generado por:** agent-workflow · skill \`export-scripts\``
+- Línea 7: `- **Generado por:** agent-workflow · skill \`export-scripts\` v4.0.0`
 
 **Error report (warning)**:
 ```
@@ -154,11 +199,11 @@ V5 WARNING: header incompleto o malformado
 
 **Severidad**: warning.
 
-**Checks**: cada link en cualquier sección del manifest apunta a un path existente en filesystem al momento de generar.
+**Checks**: cada link en cualquier sección del README apunta a un path existente en filesystem al momento de generar.
 
 **Cómo validar**:
 ```bash
-grep -Eo '`[^`]+\.(md|sql)`|\[.+?\]\([^)]+\)' manifest.md | \
+grep -Eo '`[^`]+\.(md|sql)`|\[.+?\]\([^)]+\)' README.md | \
   sed -E 's/^`(.+)`$/\1/; s/^\[.+?\]\((.+)\)$/\1/' | \
   while read p; do
     if [ ! -e "$p" ] && [ ! -e "<output_dir>/$p" ]; then echo "MISSING: $p"; fi
@@ -171,16 +216,16 @@ grep -Eo '`[^`]+\.(md|sql)`|\[.+?\]\([^)]+\)' manifest.md | \
 ```
 V6 WARNING: 2 referencias apuntan a paths inexistentes
   - docs/decisiones/005-tipos-cobranza.md → no existe en workspace
-  - por-sesion/session999/01-ddl-tablas/  → no existe en output dir
-  acción sugerida: corregir paths o omitir referencias placeholder
+  - 03-DML.sql                            → no existe en output dir (categoría vacía)
+  acción sugerida: corregir paths u omitir referencias a categorías vacías
   ¿continuar de todas formas? (s/n)
 ```
 
 ## Orden de aplicación
 
-1. V1 (estructura del bundle) — primero, barato.
-2. V3 (secciones del manifest) — segundo, barato.
-3. V2 (noise vetado) — tercero, requiere lectura del body.
+1. V1 (estructura del bundle, anti-redundancia layout) — primero, barato.
+2. V3 (secciones del README) — segundo, barato.
+3. V2 (noise vetado + redundancia v3.x en prosa) — tercero, requiere lectura del body.
 4. V4 (condicionales) — cuarto, requiere reconstruir contexto de flags + corpus.
 5. V5 (header) — quinto.
 6. V6 (referencias resolubles) — último.
@@ -198,23 +243,26 @@ Al final del flujo, el skill devuelve:
   "ok": true,
   "output_dir": "docs/scripts/NNN-export-scripts-YYYY-MM-DD/",
   "files_written": [
-    "manifest.md", "README.md", "ORDER.md", "rollback-global.sql",
-    "por-sesion/session057-export-func/...",
-    "por-sesion/session058-export-arq/...",
-    "por-tema/tema-rbac/01-ddl-tablas.sql",
+    "README.md",
+    "00-ROLLBACK.sql",
+    "01-DDL-TABLES.sql",
+    "02-DDL-FUNCTIONS.sql",
+    "04-INSERTS.sql",
+    "por-tema/tema-rbac/01-DDL-TABLES.sql",
     "..."
   ],
+  "categories_empty": ["03-DML"],
   "themes_resolved": ["rbac", "lista-negra-blanca"],
   "sessions_included": ["057", "058", "059", "060"],
   "validations": {
-    "V1": { "status": "pass" },
-    "V2": { "status": "pass", "noise_hits": 0 },
+    "V1": { "status": "pass", "forbidden_artifacts": 0 },
+    "V2": { "status": "pass", "noise_hits": 0, "v3_legacy_refs": 0 },
     "V3": { "status": "pass", "sections_found": 10 },
-    "V4": { "status": "pass", "conditionals": { "por_tema": "presente (2 temas)", "code_scan": "ejecutado", "sesiones_abiertas": "0" } },
+    "V4": { "status": "pass", "conditionals": { "mapping_tema": "presente (2 temas)", "code_scan": "ejecutado", "sesiones_abiertas": "0", "categorias_vacias": "1 (03-DML)" } },
     "V5": { "status": "pass" },
     "V6": { "status": "warning", "missing_refs": ["docs/decisiones/005-...md"] }
   },
-  "summary": "Bundle escrito. 1 warning (V6) aceptado."
+  "summary": "Bundle escrito (layout v4.0.0). 1 warning (V6) aceptado."
 }
 ```
 
@@ -224,8 +272,8 @@ Si hard-fail:
 {
   "ok": false,
   "stage": "validation",
-  "failed_at": "V3",
-  "details": "secciones obligatorias faltantes: ## 5. Código fuente — hallazgos del escaneo",
+  "failed_at": "V1",
+  "details": "estructura v3.x detectada: por-sesion/ presente. El generador no debería emitir ese sub-dir desde v4.0.0.",
   "no_files_written": true
 }
 ```
@@ -234,9 +282,9 @@ Si hard-fail:
 
 | Validación | export-arq | export-scripts |
 |---|---|---|
-| V1 | estructura de secciones por `--scope` | estructura del bundle (archivos + sub-dirs) |
-| V2 | noise interno (~25 términos) | noise + placeholders (~45 términos) |
-| V3 | secciones por scope | 10 secciones fijas del manifest |
-| V4 | Modelo de datos + Decisiones condicionales | Vista por tema + code-scan skip + sesiones abiertas |
-| V5 | header con snapshot + fuentes + diagrams engine | header con rama + readiness + counts |
-| V6 | referencias resolubles | referencias resolubles |
+| V1 | estructura de secciones por `--scope` | estructura del bundle (archivos al root + sub-dirs opt-in) + anti-redundancia v4.0.0 |
+| V2 | noise interno (~25 términos) | noise + placeholders + referencias residuales al layout v3.x |
+| V3 | secciones por scope | 10 secciones fijas del README único |
+| V4 | Modelo de datos + Decisiones condicionales | Mapping tema + code-scan skip + sesiones abiertas + categorías vacías |
+| V5 | header con snapshot + fuentes + diagrams engine | header con rama + readiness + counts + versión skill |
+| V6 | referencias resolubles | referencias resolubles (incl. archivos de categoría skipped) |

package/skills/agent-workflow/standards/sql-rollback-generator/SKILL.md

@@ -1,14 +1,14 @@
 ---
 name: sql-rollback-generator
-description: "Genera rollback **post-hoc** desde SCRIPTS.sql consolidado (v1.0.0 BREAKING — F-D session062): cuando /agent-workflow:export-scripts separa el bundle, este skill produce `.rollback.sql` por sentencia forward + `rollback-global.sql` encadenado en orden inverso (04→03→02→01). Cubre DDL (DROP IF EXISTS), migraciones con backup en esq_audit, e inserts. Marca operaciones irreversibles (DROP COLUMN, TRUNCATE, DROP CASCADE) con header WARNING. BREAKING desde v1.0.0: deja de generar rollbacks durante exec por archivo; la generación ocurre exclusivamente al exportar."
-version: 1.0.0
+description: "Genera rollback **post-hoc** desde SCRIPTS.sql consolidado (v2.0.0 BREAKING — session093): cuando /agent-workflow:export-scripts produce el bundle, este skill emite un único archivo `00-ROLLBACK.sql` al root del bundle, encadenado cross-session en orden inverso (última sesión → primera, 04→03→02→01 dentro de cada una). NO genera `.rollback.sql` companions por sentencia ni `<session>/rollback/` per-sesión (ambos eliminados desde v2.0.0). Cubre DDL (DROP IF EXISTS), migraciones con backup en esq_audit, e inserts. Marca operaciones irreversibles (DROP COLUMN, TRUNCATE, DROP CASCADE) con header WARNING en bloque separado al final del archivo, después del `COMMIT;`."
+version: 2.0.0
 ---
 
-# SQL Rollback Generator (v1.0.0 — on-export)
+# SQL Rollback Generator (v2.0.0 — `00-ROLLBACK.sql` único cross-session)
 
-Generación de rollbacks **post-hoc** desde el archivo único `SCRIPTS.sql` de cada sesión. Disparado por `/agent-workflow:export-scripts` v3.0.0+ al producir el bundle de release.
+Generación de rollback **post-hoc** desde los archivos `SCRIPTS.sql` de las sesiones incluidas en el bundle de export. Disparado por `/agent-workflow:export-scripts` v4.0.0+ al consolidar el bundle.
 
-> **BREAKING desde v1.0.0**: este skill ya NO genera `.rollback.sql` durante la sesión. La política previa "on-write per archivo" (v0.x) generaba un rollback acoplado por cada forward; la política nueva "on-export" agrupa la generación al consolidar el bundle. Razón: el flujo SQL durante exec ahora es un único `SCRIPTS.sql` (ver `sql-script-organizer` v1.0.0); no hay archivos individuales que parear con rollbacks. Layouts legacy se migran con `/agent-workflow:migrate --upgrade-topology`.
+> **BREAKING desde v2.0.0**: este skill ya NO produce companions `.rollback.sql` por sentencia ni sub-carpetas `<session>/rollback/` per-sesión (comportamiento v1.0.0 eliminado). El output canónico es un único `00-ROLLBACK.sql` al root del bundle. Razón: el bundle se ejecuta atomic (todo o nada) — múltiples archivos rollback agregaban ruido sin valor operacional. Layouts v1.0.0 quedan como histórico; bundles generados con export-scripts v3.x no se reescriben.
 
 ## When to use
 
@@ -20,45 +20,66 @@ Generación de rollbacks **post-hoc** desde el archivo único `SCRIPTS.sql` de c
 
 Reglas en `../session/references/sandbox-readonly-rules.md`. En plan mode describir estrategia por sentencia forward (sin crear `.rollback.sql`); irreversibles se anotan para revisión.
 
-## Principios (v1.0.0)
+## Principios (v2.0.0)
 
 - **Input**: `SCRIPTS.sql` de cada sesión incluida en el corpus de export, parseado vía markers `@category`/`@stmt` (ver `sql-script-organizer/references/scripts-sql-format.md`).
-- **Output**: archivos `.rollback.sql` ubicados junto al forward separado en el bundle export (`por-sesion/sessionXXX/<categoria>/NNN-*.rollback.sql`).
-- **Global**: `por-sesion/sessionXXX/rollback/00-rollback-global.sql` encadena los rollbacks en orden inverso (04 → 03 → 02 → 01), todo en `BEGIN; ... COMMIT;` único.
+- **Output único**: `<bundle-root>/00-ROLLBACK.sql` — un solo archivo cross-session al root del bundle.
+- **NO se generan** companions `.rollback.sql` por sentencia (eliminado en v2.0.0).
+- **NO se genera** sub-carpeta `<session>/rollback/` per-sesión (eliminado en v2.0.0).
+- **NO se genera** `rollback-global.sql` separado del root (eliminado en v2.0.0).
+- **Orden interno**: encadenado en orden inverso global — última sesión → primera; dentro de cada sesión 04 → 03 → 02 → 01.
+- **Estructura del archivo**:
+  - Header del archivo: corpus + fecha + sesiones cubiertas + versión del CLI.
+  - Bloque transaccional único `BEGIN; ... COMMIT;` con sub-bloques por sesión.
+  - Cada sub-bloque preserva header canónico del rollback de su sentencia (Script / Sesion / Objeto / Alcance) como comentario.
+  - Bloque final **fuera de la transacción**: "Fase 5 — Cleanup irreversible" con header `-- WARNING: IRREVERSIBLE` listando operaciones que no son revertibles automáticamente (decisión manual del operador).
 - **Idempotencia obligatoria**: `DROP ... IF EXISTS`, `CREATE OR REPLACE`, `ON CONFLICT DO NOTHING`.
-- **Transacción obligatoria** en cada rollback individual.
-- **Header del rollback** reusa el del forward (4 líneas Script/Sesion/Objeto/Alcance) con `Objeto:` describiendo la reversa.
-- **Irreversibles** (DROP COLUMN, TRUNCATE, DROP CASCADE, datos sin backup) marcados con `-- WARNING: IRREVERSIBLE` debajo del header.
-- **Datos**: si el forward es UPDATE/DELETE masivo sin backup, generar un `000-backup-*.sql` previo en el bundle (Categoría 03-migracion) + rollback que restaure desde `esq_audit.tb_bkp_<x>_sNNN`.
+- **Datos**: si el forward es UPDATE/DELETE masivo sin backup, generar un `000-backup-*.sql` previo en `03-DML.sql` del bundle + el rollback que restaura desde `esq_audit.tb_bkp_<x>_sNNN` vive dentro de `00-ROLLBACK.sql`.
 
-## Header del rollback
+## Estructura del `00-ROLLBACK.sql`
 
-El `.rollback.sql` reusa el mismo formato canónico definido en `sql-script-organizer/SKILL.md#header-canónico`:
+Header global del archivo:
 
 ```sql
 -- ============================================================================
--- Script:  NNN-tipo-objetivo.rollback.sql
--- Sesion:  sNNN
--- Objeto:  Revierte los cambios de NNN-tipo-objetivo.sql (<resumen de la reversa>).
--- Alcance: <mismo alcance que el forward>
+-- Script:  00-ROLLBACK.sql
+-- Bundle:  NNN-export-scripts-YYYY-MM-DD
+-- Sesiones: sNNN, sNNN, ...
+-- Objeto:  Revierte el bundle completo en orden inverso (última sesión → primera, 04→01).
+-- Alcance: <enumeración cross-session>
 -- ============================================================================
 ```
 
-- `Objeto:` describe la reversa, no el forward (ej. "Repone tb_x.cod_usuario al valor de esq_audit.tb_bkp_x_sNNN").
-- `Alcance:` repite literal el del forward para que quede explícito que la reversa cubre exactamente el mismo set.
-- Si el forward es irreversible, agregar **debajo del header** una línea suelta:
+Sub-bloque por sentencia (dentro del `BEGIN; ... COMMIT;` único):
+
+```sql
+-- ----------------------------------------------------------------------------
+-- Rollback de sesion sNNN — <categoria>: NNN-tipo-objetivo
+-- Objeto:  <resumen de la reversa>
+-- Alcance: <mismo alcance que el forward>
+-- ----------------------------------------------------------------------------
+DROP TABLE IF EXISTS esq_.tb_x;
+-- ...
+```
+
+- `Objeto:` del sub-bloque describe la reversa (ej. "Repone tb_x.cod_usuario al valor de esq_audit.tb_bkp_x_sNNN").
+- `Alcance:` repite literal el del forward.
+
+Bloque irreversibles al final del archivo (después del `COMMIT;`, **fuera de la transacción**):
+
+```sql
+COMMIT;
 
-  ```sql
-  -- ============================================================================
-  -- Script:  ...
-  -- Sesion:  ...
-  -- Objeto:  ...
-  -- Alcance: ...
-  -- ============================================================================
-  -- WARNING: IRREVERSIBLE — best-effort, ver DECISIONS.md DEC-NNN (legacy: DECISIONES.md).
-  ```
+-- ============================================================================
+-- Fase 5 — Cleanup irreversible (manual)
+-- WARNING: IRREVERSIBLE — best-effort. Ver DECISIONS.md de la sesión origen.
+-- ============================================================================
+-- sesion sNNN — DROP COLUMN esq_.tb_x.col_y (no hay backup automático)
+-- sesion sMMM — TRUNCATE esq_.tb_z
+-- ...
+```
 
-  El bloque WARNING explica qué no se puede recuperar y referencia la decisión.
+El bloque WARNING explica qué no se puede recuperar y referencia la decisión de la sesión donde se introdujo.
 
 ## Estrategias por tipo de operación
 
@@ -129,39 +150,33 @@ Protocolo:
 
 Lista completa en `references/irreversible-checklist.md`.
 
-## Layout (post-export-scripts v3.0.0)
-
-### Par acoplado
+## Layout (post-export-scripts v4.0.0)
 
-`export-scripts` produce los archivos separados desde SCRIPTS.sql y este skill genera el rollback junto a cada forward:
+Output canónico — un solo archivo al root del bundle:
 
 ```
-<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/por-sesion/sessionXXX/01-ddl-tablas/
-├── 001-crea-tb-x.sql              (forward, derivado de @stmt en SCRIPTS.sql)
-└── 001-crea-tb-x.rollback.sql     (rollback, generado por este skill)
+<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/
+└── 00-ROLLBACK.sql                # único rollback cross-session (este skill lo genera)
 ```
 
-### Bundle global
+Para context: el bundle plano del export incluye además `01-DDL-TABLES.sql`, `02-DDL-FUNCTIONS.sql`, `03-DML.sql`, `04-INSERTS.sql`, `README.md` — todos al root, generados por `export-scripts` (no por este skill).
 
-```
-<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/por-sesion/sessionXXX/rollback/
-├── 00-rollback-global.sql      (encadena todos 04→01 con BEGIN/COMMIT único)
-├── 04-inserts-rollback.sql
-├── 03-migracion-rollback.sql
-├── 02-ddl-funciones-rollback.sql
-└── 01-ddl-tablas-rollback.sql
-```
+**No se generan** (eliminados desde v2.0.0):
+- Companions `.rollback.sql` por sentencia.
+- Sub-carpeta `<session>/rollback/` per-sesión.
+- Archivo `rollback-global.sql` separado.
+- Archivos `04-inserts-rollback.sql`, `03-migracion-rollback.sql`, etc. (categorías por separado).
 
-Layout pre-v1.0.0 (`scripts/bundle/...` dentro de la sesión durante exec) ya no se genera. Layouts legacy se migran con `/agent-workflow:migrate --upgrade-topology`.
+Layouts v1.0.0 quedan como histórico en bundles ya generados (`docs/scripts/00X-export-scripts-*` previos). No se migran retroactivamente. Layouts legacy v0.x se migran con `/agent-workflow:migrate --upgrade-topology`.
 
-## Proceso
+## Proceso (v2.0.0)
 
-1. Leer el forward — identificar tipo.
-2. Clasificar — seleccionar estrategia.
-3. Generar rollback acoplado.
-4. Verificar irreversibilidades — warning + DECISIÓN + confirmación si aplica.
-5. Actualizar bundle global.
-6. Verificar cobertura antes de graduar.
+1. Parsear todos los `SCRIPTS.sql` del corpus de export (markers `@category`/`@stmt`).
+2. Para cada sentencia forward, clasificar el tipo y seleccionar estrategia (DDL / migración / inserts / irreversible).
+3. Generar el bloque rollback correspondiente — sin escribir todavía a disco.
+4. Identificar irreversibles → moverlos al bloque "Fase 5" final.
+5. Componer el `00-ROLLBACK.sql` único con orden inverso global (última sesión → primera, 04→01) + bloque "Fase 5" al final.
+6. Escribir el archivo único al root del bundle.
 
 ## Notas de portabilidad (PostgreSQL como motor primario)
 
@@ -176,19 +191,19 @@ Si el destino no es Postgres, indicarlo en `Objeto:` o como nota libre debajo de
 
 ## Graduación al cierre
 
-`rollback/` viaja junto al bundle forward bajo `docs/scripts/NNN-sessionXXX-nombre/rollback/`.
+Este skill **NO se invoca al cerrar una sesión**. La graduación de scripts de una sesión individual produce `docs/scripts/NNN-sessionXXX-nombre/` con el `SCRIPTS.sql` curado; el rollback consolidado vive **exclusivamente en el bundle de export** (`docs/scripts/NNN-export-scripts-YYYY-MM-DD/00-ROLLBACK.sql`).
 
-## Modo release (cross-session + por tema)
+## Modo release (LEGACY — deprecation Fase 1)
 
-`release` y `release-scripts` invocan este skill para producir rollback global del release y rollback por tema. Algoritmo detallado (3 niveles, principios, qué NO hacer, verificación) en **`references/release-rollback.md`**.
+`release` y `release-scripts` (legacy en deprecation Fase 1) consumían el algoritmo v1.0.0 (companions `.rollback.sql` + per-sesión rollback + global). Ese código y output **no se actualizan a v2.0.0**: se conserva como histórico en `references/release-rollback.md` mientras los workspaces dejan de invocarlos. El reemplazo canónico es `/agent-workflow:export-scripts` v4.0.0+ que invoca este skill en v2.0.0.
 
 ## Integración con otros skills
 
-- **`sql-script-organizer`** — companion: organiza el bundle forward y coordina rollbacks. En modo release, provee bundle consolidado.
-- **`release`** — consume rollback global de release.
-- **`release-scripts`** — consume rollback por tema.
+- **`sql-script-organizer`** — companion: organiza el `SCRIPTS.sql` por sesión que este skill consume al exportar.
+- **`export-scripts`** v4.0.0+ — único invocador activo de este skill (genera `00-ROLLBACK.sql` único).
+- **`release`** / **`release-scripts`** — legacy en deprecation Fase 1; consumen `references/release-rollback.md` (no se actualiza).
 - **`coding-standards`** — reglas de estilo SQL en `database-conventions.md#estilo-de-scripts-sql`.
-- **`session`** — Fase 3 invoca este skill junto a `sql-script-organizer` al escribir el primer `.sql`.
+- **`session`** — este skill NO se invoca al cerrar una sesión individual; sólo desde export-scripts.
 
 ## Recursos adicionales
 

package/skills/agent-workflow/standards/sql-rollback-generator/references/release-rollback.md

@@ -1,6 +1,8 @@
-# Rollback global de release y por tema
+# Rollback global de release y por tema (LEGACY — deprecation Fase 1)
 
-Algoritmos detallados para rollbacks consolidados en modo release. El SKILL.md tiene el resumen; este archivo tiene el procedimiento completo paso a paso.
+> **Estado**: legacy. Aplica solo a `release` / `release-scripts` legacy (deprecation Fase 1). El reemplazo canónico es `/agent-workflow:export-scripts` v4.0.0+, que produce un único `00-ROLLBACK.sql` cross-session al root del bundle (algoritmo en `SKILL.md` v2.0.0).
+
+Algoritmos detallados para rollbacks consolidados en modo release legacy. El SKILL.md tiene el resumen; este archivo tiene el procedimiento completo paso a paso.
 
 ## Rollback global de release (cross-session)
 

package/skills/agent-workflow/standards/sql-rollback-generator/references/rollback-patterns.md

@@ -210,11 +210,13 @@ COMMIT;
 
 ---
 
-## Bundle global (`00-rollback-global.sql`)
+## Bloque rollback de una sesión dentro de `00-ROLLBACK.sql`
 
 ```sql
--- ROLLBACK GLOBAL — sessionXXX-[nombre]
--- Revierte TODOS los cambios en orden inverso. Ejecutar sólo para deshacer la sesión completa.
+-- ----------------------------------------------------------------------------
+-- ROLLBACK de sessionXXX-[nombre] — revierte los cambios en orden inverso.
+-- Forma parte del 00-ROLLBACK.sql cross-session del bundle.
+-- ----------------------------------------------------------------------------
 BEGIN;
 
 -- Paso 4 invertido: deshacer inserts

package/skills/agent-workflow/standards/sql-script-organizer/SKILL.md

@@ -143,27 +143,27 @@ Cada sección del cuerpo se introduce con una línea de comentario corta envuelt
 
 El usuario revisa el SCRIPTS.sql periódicamente; la separación 01-04 final y la verificación de dependencias cruzadas la hace `/agent-workflow:export-scripts` post-hoc.
 
-## Layout del bundle (post-export-scripts v3.0.0)
+## Layout del bundle (post-export-scripts v4.0.0)
 
-`/agent-workflow:export-scripts` produce el bundle al ejecutarse, no este skill:
+`/agent-workflow:export-scripts` v4.0.0+ produce el bundle al ejecutarse, no este skill. Layout plano cross-session al root:
 
 ```
-<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/por-sesion/sessionXXX-nombre/
-├── README.md                                  (generado por export-scripts)
-├── 01-ddl-tablas/
-│   ├── 001-crea-tb-x.sql                      (derivado de @stmt: 001-crea-tb-x)
-│   └── ...
-├── 02-ddl-funciones/
-├── 03-migracion/
-│   ├── 000-backup-tb-x.sql                    (auto-generado por sql-rollback-generator si UPDATE/DELETE masivo)
-│   └── ...
-├── 04-inserts/
-└── rollback/
-    ├── 00-rollback-global.sql                 (encadenado 04→03→02→01)
-    └── NNN-*.rollback.sql                     (1 por @stmt forward)
+<docs>/scripts/NNN-export-scripts-YYYY-MM-DD/
+├── 00-ROLLBACK.sql                            (único rollback cross-session — sql-rollback-generator v2.0.0)
+├── 01-DDL-TABLES.sql                          (consolidado cross-session, skip si vacío)
+├── 02-DDL-FUNCTIONS.sql                       (idem)
+├── 03-DML.sql                                 (UPDATE/DELETE/migración + backup en esq_audit cuando aplica)
+├── 04-INSERTS.sql                             (idem)
+├── README.md                                  (único informe + índice + how-to-execute)
+└── por-tema/                                  (opt-in — capa adicional encima del root)
+    └── tema-<slug>/01-04-*.sql
 ```
 
-Layout **legacy** pre-v1.0.0 (`scripts/01-04/*.sql + .rollback.sql` directo en sesión) ya **no se genera**; sesiones nuevas usan SCRIPTS.sql. Layouts legacy en sesiones cerradas se migran con `/agent-workflow:migrate --upgrade-topology`.
+Sentencias individuales del `SCRIPTS.sql` per-sesión se consolidan **cross-session** al archivo de su categoría — no se crea sub-carpeta por sesión.
+
+Layout **v3.x** (`por-sesion/<sessionXXX>/01-04/*.sql + .rollback.sql` companions + per-sesión `rollback/`) ya **no se genera** desde v4.0.0. Bundles ya escritos con v3.x quedan como histórico.
+
+Layout **legacy** pre-SCRIPTS.sql (`scripts/01-04/*.sql + .rollback.sql` directo en sesión) tampoco se genera; sesiones nuevas usan SCRIPTS.sql. Layouts legacy en sesiones cerradas se migran con `/agent-workflow:migrate --upgrade-topology`.
 
 ## Graduación al cierre (vía `/agent-workflow:release`)