@tacuchi/agent-workflow-cli 11.0.1 → 12.0.0

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

@@ -1,47 +0,0 @@
-# Léxico técnico — placeholders vetados (V2)
-
-Lista mínima de placeholders y patrones de noise que NO deben aparecer en el bundle generado (`README.md` y `.sql`). Audiencia técnica: la terminología SQL/DBA es bienvenida, sólo se vetan restos de plantilla.
-
-## Lista vetada (V2 — para grep -F -f)
-
-```
-NNN
-YYYY-MM-DD
-[entre corchetes]
-[CATEGORIA]
-[nombre-rama]
-[primera categoría con contenido]
-[segunda categoría con contenido — si aplica]
-<placeholder>
-sessionXXX
-sessionYYY
-sessionNNN
-ACT-NNN
-ACT-001
-ACT-002
-/Users/
-/home/
-C:\Users\
-TODO:
-FIXME:
-WIP:
-```
-
-## Patrones v3.x deprecados (V2 — regex)
-
-```regex
-por-sesion/
-manifest\.md
-ORDER\.md
-rollback-global\.sql
-\.rollback\.sql
-```
-
-Válidos sólo dentro de bloques explícitos "DEPRECATED" / "histórico". V2 valida el contexto cercano.
-
-## Cómo extraer la lista
-
-```bash
-awk '/^```$/{flag=!flag; next} flag' lexico-tecnico.md > /tmp/lexico-vetado.txt
-grep -n -F -f /tmp/lexico-vetado.txt README.md
-```

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

@@ -1,265 +0,0 @@
-# Plantilla — Informe del bundle export-scripts
-
-## Status: DEPRECATED (desde v4.0.0 — session093)
-
-Este template ya **no se usa** para bundles nuevos. Desde `export-scripts` v4.0.0 el informe consolidado vive en `README.md` único al root del bundle (ver `readme-template.md`). El layout plano cross-session reemplazó `manifest.md` + `ORDER.md` + `rollback-global.sql` separados.
-
-**Si estás generando un bundle nuevo**: usar `references/readme-template.md` (plantilla canónica).
-
-**Si estás leyendo un bundle histórico** (`docs/scripts/001-002-003-export-scripts-*` generado por v3.x): este template describe el formato que tenía. No se reescriben los bundles ya generados.
-
----
-
-## Plantilla original (export-scripts v3.x — histórico)
-
-Plantilla exacta que usaba el skill `export-scripts` v3.x para generar `manifest.md` dentro del output dir. Reemplazar los placeholders `[entre corchetes]` con valores reales al momento de generar.
-
-> **Heredada de `release/references/report-template.md` v2.0.0**. Cambios respecto al original: (1) paths actualizados al nuevo output dir único; (2) sección 4.4 "Vista por tema" condicional (V4.a); (3) header con readiness color emoji; (4) sección 10 cita `export-scripts v1.0.0`.
-
----
-
-```markdown
-# Informe del bundle NNN — [YYYY-MM-DD]
-
-- **Rama actual:** `[nombre-rama]`
-- **Rama destino:** `certificacion`
-- **Sesiones incluidas:** [N]
-- **Readiness:** [🟢 verde | 🟡 amarillo | 🔴 rojo]
-- **Generado por:** agent-workflow · skill `export-scripts`
-
----
-
-## 1. Resumen ejecutivo
-
-[1-2 párrafos sintetizando qué entra en este bundle: módulos tocados, tipo de cambios predominantes (features, fixes, migración de datos), y el juicio general de readiness con 1-2 motivos principales.]
-
-**Motivos del color de readiness:**
-- [motivo 1]
-- [motivo 2]
-
----
-
-## 2. Sesiones incluidas
-
-| # | Sesión | Estado | Fase | Fechas | Resumen | Refs |
-|---|---|---|---|---|---|---|
-| 1 | session001-nombre | closed | 5 | YYYY-MM-DD → YYYY-MM-DD | [resumen 1 línea] | [DEC](../decisiones/001-*.md) · [SQL](por-sesion/sessionXXX-*/) |
-| 2 | session002-nombre | ⚠ active | 3 | YYYY-MM-DD → — | [resumen 1 línea] + motivo de apertura | — |
-
-**Sesiones abiertas:** destacadas con ⚠. Cada una baja la readiness del bundle. Motivo y próxima acción debe quedar explícito en el resumen.
-
----
-
-## 3. Acciones manuales previas a producción
-
-Checklist ordenado. Marcar cada ítem antes del despliegue.
-
-- [ ] **ACT-001** — [Título corto]
-  - **Motivo:** [por qué es necesaria]
-  - **Quién:** [rol/persona sugerida]
-  - **Detalle:** [qué hacer, con qué entrada/salida esperada]
-
-- [ ] **ACT-002** — Solicitar API keys de producción
-  - **Motivo:** REQUIREMENTS de session003 menciona integración con servicio externo pero no hay claves concretas.
-  - **Quién:** Administrador de infraestructura
-  - **Detalle:** enviar correo con plantilla abajo (sección 3.1).
-
-### 3.1 Plantillas de correo
-
-Copiar, personalizar y enviar manualmente. **Este plugin no envía correos.**
-
-```
-Para: [correo-destino]
-CC: [correo-cc]
-Asunto: [Bundle NNN] Solicitud de API keys de producción
-
-Buen día,
-
-Para el bundle NNN-[nombre] que se despliega el [fecha objetivo] requerimos las siguientes credenciales de producción:
-
-- [servicio 1] — URL y token de acceso
-- [servicio 2] — usuario/clave técnica
-
-Adjunto el manifest con detalle técnico: docs/scripts/NNN-export-scripts-[YYYY-MM-DD]/manifest.md
-
-Quedamos atentos.
-Saludos.
-```
-
----
-
-## 4. Base de datos
-
-### 4.1 Secuencia de ejecución
-
-Orden obligatorio (01 → 02 → 03 → 04) por sesión cronológica. Detalle completo en `ORDER.md`.
-
-Resumen alto nivel:
-
-1. **session001** → `por-sesion/session001-[slug]/01-ddl-tablas/...`
-2. **session001** → `por-sesion/session001-[slug]/02-ddl-funciones/...`
-3. **session001** → `por-sesion/session001-[slug]/03-migracion/...`
-4. **session001** → `por-sesion/session001-[slug]/04-inserts/...`
-5. **session002** → ...
-
-### 4.2 Rollback
-
-Bundle global: `rollback-global.sql` (en este mismo directorio).
-
-Orden inverso absoluto: última sesión → primera, y dentro de cada una 04 → 03 → 02 → 01. Ejecutable dentro de un único `BEGIN; … COMMIT;`.
-
-**Operaciones irreversibles detectadas:**
-
-| Script | Sesión origen | Operación | Mitigación disponible |
-|---|---|---|---|
-| `por-sesion/session003-*/03-migracion/001-*.sql` | session003 | `DROP COLUMN col_legacy` | Respaldo en `esq_audit.tb_bkp_...` (script `000-backup-*.sql`) |
-
-Si no hay irreversibles: incluir un placeholder con "Sin operaciones irreversibles en este bundle." (el AI debe reemplazar la tabla por esta frase única).
-
-### 4.3 Impacto
-
-- **Tablas creadas:** [lista]
-- **Tablas modificadas:** [lista, indicando tipo de ALTER]
-- **Funciones creadas/modificadas:** [lista]
-- **Filas afectadas por migración:** [estimación si hay count en sesiones]
-
-### 4.4 Vista por tema
-
-> **Condicional V4.a**: incluir esta sub-sección **sólo si** `por-tema/` se generó (temas declarados, `## Temas` en OBJECTIVE, o `--themes infer`). Si no se generó, omitir entera la sub-sección 4.4 (sin header).
-
-Bundle por tema: `por-tema/`
-
-- **Orden ejecutable cross-tema:** `por-tema/ORDER.md`
-- **Temas incluidos:** [slug1], [slug2], [slug3] — [N] scripts.
-
-Mapeo tema ↔ sesión ↔ scripts: `README.md` §"Mapping".
-
----
-
-## 5. Código fuente — hallazgos del escaneo
-
-> **Condicional V4.b**: si `--skip-code-scan` fue usado, esta sección contiene **sólo** una nota inline `_(Escaneo omitido por --skip-code-scan)_` y nada más.
-
-**Resumen:** [X] críticos · [Y] medios · [Z] bajos
-
-### 5.1 Severidad alta (bloqueantes para producción)
-
-| # | Patrón | Archivo:línea | Snippet | Recomendación |
-|---|---|---|---|---|
-| H1 | Credencial hardcodeada | `src/.../Config.java:42` | `password = "..."` | Mover a variable de entorno o gestor de secretos. Rotar la credencial si fue commiteada. |
-
-Si vacío: incluir un placeholder con "Sin hallazgos de severidad alta." (frase única que reemplaza la tabla).
-
-### 5.2 Severidad media
-
-| # | Patrón | Archivo:línea | Snippet | Recomendación |
-|---|---|---|---|---|
-| M1 | URL localhost | `src/.../api.service.ts:18` | `http://localhost:8080` | Reemplazar por `environment.apiUrl` u otro mecanismo de configuración. |
-
-### 5.3 Severidad baja
-
-Agrupados por patrón, con conteo. Lista expandida si hay menos de 20; si más, mostrar top 10 y conteo total.
-
-| Patrón | Conteo | Ejemplos |
-|---|---|---|
-| `TODO` | 7 | `UserService.java:88`, `OrderService.java:42`, ... |
-| `FIXME` | 2 | `validator.ts:15`, `payment.ts:103` |
-
-### 5.4 Alcance del escaneo
-
-- **Directorios incluidos:** [lista]
-- **Directorios excluidos:** `node_modules/`, `target/`, `dist/`, `build/`, `.workflow/`, `docs/`, `tests/`, `test/`, `.git/`
-- **Extensiones:** [lista]
-
----
-
-## 6. Git y ramas
-
-- **Rama actual:** `[nombre]`
-- **Rama destino:** `certificacion`
-- **Commits pendientes de merge (rama actual → certificacion):** [N]
-
-### 6.1 Commits pendientes
-
-```
-[sha corto] [mensaje]
-[sha corto] [mensaje]
-```
-
-### 6.2 Archivos modificados (git diff --stat)
-
-```
-[salida de git diff certificacion --stat]
-```
-
-### 6.3 Cambios sin commitear
-
-Si `git status` muestra archivos modificados/untracked:
-
-```
-[salida de git status --porcelain]
-```
-
-**Acción recomendada:** el usuario decide si esos cambios entran al bundle (commit) o no (stash/descartar).
-
-### 6.4 PR sugerido (texto — no se crea)
-
-```
-Título: [feat/fix/chore]: [resumen del bundle]
-Rama origen: [rama actual]
-Rama destino: certificacion
-Descripción:
-- Bundle NNN consolidando las siguientes sesiones:
-  - session001 — [título]
-  - session002 — [título]
-- Manifest completo: docs/scripts/NNN-export-scripts-[YYYY-MM-DD]/manifest.md
-- Bundle SQL: docs/scripts/NNN-export-scripts-[YYYY-MM-DD]/por-sesion/
-```
-
----
-
-## 7. Documentación graduada
-
-| Sesión | Decisiones | Manuales | Especificaciones | Conclusiones |
-|---|---|---|---|---|
-| session001 | `001-*.md`, `002-*.md` | — | — | — |
-| session002 | — | `003-*.md` | — | — |
-| session003 | `004-*.md` | — | `001-*/` | — |
-
-Nota: el modelo nuevo gradua 6 kinds (`decision`, `manual`, `script`, `especificacion`, `conclusion`, `release`). Este manifest enlaza los 4 primeros; `release` queda implícito en este mismo dossier; `script` queda implícito en `por-sesion/`.
-
----
-
-## 8. Checklist final de producción
-
-Lista única consolidada. Todos los ítems deben marcarse antes del "go":
-
-- [ ] **BD:** respaldo completo del esquema afectado tomado y verificado
-- [ ] **BD:** scripts ejecutados en orden (01 → 02 → 03 → 04)
-- [ ] **BD:** rollback probado en staging/certificación
-- [ ] **Infra:** variables de entorno actualizadas (ver sección 3)
-- [ ] **Infra:** API keys de producción solicitadas y configuradas
-- [ ] **Código:** hallazgos de severidad alta resueltos (sección 5.1)
-- [ ] **Git:** rama mergeada a `certificacion` (o PR aprobado)
-- [ ] **Git:** tag/release creado en el repositorio
-- [ ] **Stakeholders:** notificación enviada antes y después del despliegue
-- [ ] **Acciones manuales:** todos los ACT-XXX de la sección 3 completados
-
----
-
-## 9. Advertencias
-
-Cosas que el skill detectó pero no pudo validar automáticamente. Leer antes de marcar el checklist como completo.
-
-Si no hay advertencias: incluir un placeholder con "Sin advertencias pendientes." (frase única).
-
----
-
-## 10. Metadata
-
-- **Generado:** YYYY-MM-DD HH:MM
-- **Versión del skill:** export-scripts v1.0.0
-- **Argumentos usados:** `[sin argumentos | --since sessionNNN | --themes slug1,slug2 | --dry-run | --skip-code-scan]`
-- **Comando original:** `/agent-workflow:export-scripts [args]`
-- **Reemplaza:** `/agent-workflow:release` v2.0.0 + `/agent-workflow:release-scripts` v2.0.0 (ambos en deprecation Fase 1 desde plugin v2.8.0)
-```

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

@@ -1,49 +0,0 @@
-# Plantilla — README del bundle export-scripts
-
-README mínimo del bundle. Reemplaza `[entre corchetes]` con valores reales. Sin resumen ejecutivo, sin tabla de sesiones, sin plantillas de correo, sin acciones manuales narradas, sin checklist de producción.
-
----
-
-```markdown
-# Bundle export-scripts NNN — [YYYY-MM-DD]
-
-## Archivos
-
-| Archivo | Contiene |
-|---|---|
-| `00-ROLLBACK.sql` | Reversa de todo el bundle. |
-| `01-[CATEGORIA].sql` | [Primera categoría con contenido] |
-| `02-[CATEGORIA].sql` | [Segunda categoría con contenido — si aplica] |
-| ... | ... |
-
-> La numeración es continua tras `00-ROLLBACK.sql`. Las categorías sin contenido no ocupan número.
-
-## Aplicar
-
-```bash
-psql -h <host> -U <user> -d <db> -f 01-[CATEGORIA].sql
-psql -h <host> -U <user> -d <db> -f 02-[CATEGORIA].sql
-# ...
-```
-
-Orden estricto: ascendente por número (01 → 02 → …). El plugin no ejecuta nada — el operador aplica.
-
-## Revertir
-
-```bash
-psql -h <host> -U <user> -d <db> -f 00-ROLLBACK.sql
-```
-
-Si hay bloque `Fase 5 — Cleanup irreversible` al final del rollback, leerlo antes de ejecutar — son operaciones manuales (sin reversa automática).
-```
-
----
-
-## Notas para el AI generador
-
-- **No agregar** secciones más allá de `## Archivos`, `## Aplicar`, `## Revertir`.
-- **No incluir** resumen ejecutivo, sesiones origen, commits, ramas, code-scan, plantillas de correo, ACT-NNN, ni checklist de producción.
-- **Tabla de archivos**: una fila por archivo presente. Categorías vacías no aparecen.
-- **Cómo aplicar**: un `psql -f` por archivo presente, en orden ascendente.
-- **Cómo revertir**: una sola línea `psql -f 00-ROLLBACK.sql` + nota opcional si hay `Fase 5`.
-- Si el bundle es trivial (sólo 1 forward + rollback), basta con la tabla y los dos bloques `bash`. Cualquier prosa adicional es ruido.

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

@@ -1,141 +0,0 @@
-# Theme handling — detección + consolidación per-tema (v4.0.0)
-
-> **Port adaptado** de `release-scripts/references/theme-detection.md` + `release-scripts/references/order-generation.md` (ambos v2.0.0). DEC-004 de session061: contenido equivalente, paths actualizados al layout plano de export-scripts v4.0.0. **session093**: la capa `por-tema/` ya NO duplica el rollback y NO emite `ORDER.md` separado — el rollback canónico es `00-ROLLBACK.sql` único al root, y la secuencia de ejecución vive en §4 del `README.md`.
-
-## Activación de la capa `por-tema/`
-
-`por-tema/` es **capa adicional opt-in encima del root plano** — NO reemplaza los archivos `0X-*.sql` consolidados cross-session al root. Se genera **sólo** si se cumple **alguna** de estas condiciones:
-
-1. `--themes slug1,slug2` declarado explícitamente.
-2. Al menos una de las sesiones incluidas tiene sección `## Temas` en su `OBJECTIVE.md` (o `OBJETIVO.md` legacy).
-3. `--themes infer` declarado (inferencia LLM con confirmación).
-
-Si **ninguna** se cumple: el output dir contiene sólo `00-ROLLBACK.sql` + `0X-*.sql` (categorías con contenido) + `README.md` al root. No se crea sub-carpeta `por-tema/` vacía.
-
-## Formato de `## Temas` en OBJECTIVE
-
-```markdown
-## Temas
-
-- `rbac`: gestión de roles y permisos
-- `lista-negra-blanca`: filtros de acceso
-- `auditoria`: logging de cambios sensibles
-```
-
-Reglas:
-- Slug kebab-case (`a-z0-9-`).
-- Una descripción breve por tema (ayuda a la inferencia cross-session).
-- Sin overlapping en una misma sesión salvo necesidad expresa.
-
-## Resolución de temas por sesión
-
-### Paso A — Lectura declarativa
-
-Para cada sesión incluida, leer `OBJECTIVE.md` (fallback bilingual a `OBJETIVO.md`) buscando sección `## Temas`. Si presente: extraer slugs como autoritativos para esa sesión.
-
-### Paso B — Inferencia LLM (si `--themes infer` o falta declarativo en N sesiones)
-
-Para cada sesión sin `## Temas`:
-
-1. Leer OBJECTIVE + sentencias del `SCRIPTS.sql` (con sus markers `@objeto`).
-2. Inferir temas candidatos (3-5 max) con confidence score 0-1.
-3. Proponer al usuario:
-   ```
-   Sesión session057:
-   - Tema candidato: `export-report` (confidence 0.92, sentencias: ...)
-   - Tema candidato: `lifecycle-extension` (confidence 0.45)
-   - ¿Aceptar / editar / declarar uno propio?
-   ```
-4. Persistir respuesta:
-   - Si sesión **activa**: escribir `## Temas` en OBJECTIVE.
-   - Si sesión **cerrada**: guardar en `por-tema/themes.inferred.md` del bundle (no toca artefactos cerrados).
-
-### Paso C — Filtro `--themes`
-
-Si `--themes slug1,slug2` declarado: restringir el output `por-tema/` a esos slugs. Sentencias cuyo tema no entre en el filtro **siguen apareciendo en los archivos `0X-*.sql` del root** (la consolidación cross-session es independiente del filtro de temas) pero no se replican en `por-tema/`.
-
-## Asignación de cada sentencia a su tema
-
-Por cada sentencia forward parseada del `SCRIPTS.sql` (markers `@category` + `@stmt`):
-
-1. **Header declarativo**: leer marker `-- Temas: slug1, slug2` si está presente. Si sí: usar esos slugs.
-2. **Por nombre del stmt**: matchear contra patrones del tema (substring del slug en el nombre `@stmt`, ej. `rbac-rol-permiso` → `rbac`).
-3. **Por contenido**: leer el cuerpo de la sentencia y aplicar heurística (qué tabla/función toca, qué módulo de negocio).
-4. **Fallback**: si nada matchea, asignar a `tema-general/` con warning en el `README.md` §1.
-
-### Multi-tema
-
-Si una sentencia aplica a 2+ temas: copia al primer tema declarado y crea `.link.md` en los demás referenciando el canónico:
-
-```markdown
-# Link — sentencia multi-tema
-
-Esta sentencia aplica al tema `[secundario]` pero su versión canónica vive en:
-
-- `por-tema/tema-[primario]/03-DML.sql` (sección [N], sentencia `[stmt-original]`)
-
-Razón: el marker `-- Temas:` lista temas múltiples, y por convención el primero es el canónico.
-```
-
-## Consolidación por categoría dentro de cada tema
-
-Para cada tema y cada categoría (01..04):
-
-1. Ordenar sentencias fuente por orden cronológico (cross-session por sNNN → orden de aparición en SCRIPTS.sql).
-2. Para cada sentencia, extraer cuerpo eliminando `BEGIN;` inicial y `COMMIT;` final.
-3. Concatenar con separadores `[i/N]` + nombre `@stmt` + ruta canónica al `SCRIPTS.sql` original.
-4. Envolver todo en un único `BEGIN; … COMMIT;`.
-5. Escribir `por-tema/tema-<slug>/<categoria>.sql` con nombres UPPERCASE EN canon: `01-DDL-TABLES.sql`, `02-DDL-FUNCTIONS.sql`, `03-DML.sql`, `04-INSERTS.sql`.
-6. **NO se genera** `<tema>/rollback*` ni `<tema>/00-ROLLBACK.sql`. El rollback canónico es `<bundle-root>/00-ROLLBACK.sql` único — un solo punto de verdad para reversa.
-
-### Header del consolidado
-
-**Uno solo** al inicio del archivo, con el formato canónico de 4 líneas definido en `sql-script-organizer/SKILL.md#header-canónico`:
-
-```
--- ============================================================================
--- Script:  tema-rbac/03-DML.sql
--- Sesion:  s057, s058, s063
--- Objeto:  migración de roles y asignaciones RBAC
--- Alcance: tablas tb_rol, tb_permiso_rol, tb_rol_usuario
--- ============================================================================
-```
-
-**No copiar** los headers individuales de cada sentencia — su origen queda registrado en los separadores `[i/N]` del cuerpo y en `README.md` §4.1 (mapping cuando `por-tema/` activo).
-
-### `--keep-parts`
-
-Si el flag está activo: preservar `por-tema/<slug>/parts/<categoria>/*.sql` con sentencias individuales (no consolidadas). Permite ejecutar una por vez para debugging.
-
-## Rollback con temas activos
-
-Sigue siendo **único**: `<bundle-root>/00-ROLLBACK.sql` cubre todas las sentencias del corpus, indistinto del tema. Cuando `por-tema/` está activo, el `README.md` §5 incluye una nota explícita:
-
-> El `00-ROLLBACK.sql` revierte todos los temas. NO ejecutar rollbacks parciales por tema — dejaría el estado de BD inconsistente cuando los temas comparten objetos (tablas, funciones, foreign keys).
-
-Algoritmo de generación del `00-ROLLBACK.sql` en `sql-rollback-generator/SKILL.md` v2.0.0.
-
-## Secuencia de ejecución cuando `por-tema/` está activo
-
-§4 del `README.md` incluye una variante "Por tema (opcional)" además del orden canónico al root. Ejemplo:
-
-```markdown
-### 4.2 Ejecución per-tema (opcional, requiere --themes)
-
-Útil cuando un solo tema necesita validarse aisladamente en staging antes del despliegue completo. **Importante**: si se ejecuta un tema parcial, el rollback canónico (`00-ROLLBACK.sql`) sigue cubriendo todo el bundle — no hay rollback per-tema.
-
-```bash
-# Tema rbac:
-psql -f por-tema/tema-rbac/01-DDL-TABLES.sql
-psql -f por-tema/tema-rbac/02-DDL-FUNCTIONS.sql
-psql -f por-tema/tema-rbac/03-DML.sql
-psql -f por-tema/tema-rbac/04-INSERTS.sql
-```
-```
-
-## Idempotencia
-
-- Re-ejecutar export-scripts con los mismos args sobre las mismas sesiones produce el **mismo** output **modulo el NNN nuevo** del directorio. Cada invocación toma siguiente NNN; no sobrescribe.
-- Para regenerar: borrar el directorio manualmente y re-invocar.
-- Si los temas se declararon en OBJECTIVE: sin re-confirmación.
-- Si fueron inferidos: re-propone con `--themes infer`.

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

@@ -1,69 +0,0 @@
-# Validations — export-scripts
-
-Checks mínimos antes de escribir el bundle. Solo lo esencial: estructura básica y ausencia de placeholders.
-
-## V1 — Estructura del bundle
-
-**Severidad**: hard-fail.
-
-Requeridos al root del bundle:
-
-- `README.md`.
-- `00-ROLLBACK.sql` (si hay al menos un forward).
-- Al menos un `NN-*.sql` con `NN >= 01`.
-
-Numeración continua tras `00-ROLLBACK.sql`: el primer forward presente es `01-…`, el segundo `02-…`, etc. No hay gaps por categorías vacías.
-
-Vetados (presencia → hard-fail):
-
-- `manifest.md`, `ORDER.md`, `rollback-global.sql`, `por-sesion/`, `<file>.rollback.sql` (layout v3.x deprecado).
-- Archivos `NN-*.sql` con saltos en la numeración (`01-…`, `03-…` sin `02-…`).
-
-## V2 — Sin placeholders
-
-**Severidad**: hard-fail.
-
-El `README.md` y los `.sql` no deben contener:
-
-- `NNN`, `YYYY-MM-DD`, `[entre corchetes]`, `<placeholder>`, `[CATEGORIA]`.
-- Paths absolutos del developer (`/Users/`, `/home/`, `C:\\`).
-- Referencias al layout v3.x deprecado (`por-sesion/`, `manifest.md`, `ORDER.md`, `rollback-global.sql`, `.rollback.sql` companions) — excepto en bloques explícitos de "deprecated"/"histórico".
-
-**Cómo validar**:
-
-```bash
-grep -nE 'NNN|YYYY-MM-DD|\[entre corchetes\]|<placeholder>|\[CATEGORIA\]|/Users/|/home/|C:\\' README.md *.sql
-grep -nE 'por-sesion/|manifest\.md|ORDER\.md|rollback-global\.sql|\.rollback\.sql' README.md
-```
-
-Ambos deben devolver vacío.
-
-## Orden de aplicación
-
-1. V1 (estructura + numeración continua).
-2. V2 (placeholders + redundancia v3.x).
-
-Ambas hard-fail. Si fallan, abortar antes de escribir.
-
-## Reporte final
-
-```json
-{
-  "ok": true,
-  "output_dir": "docs/scripts/NNN-export-scripts-YYYY-MM-DD/",
-  "files_written": ["README.md", "00-ROLLBACK.sql", "01-DML.sql", "02-INSERTS.sql"],
-  "validations": { "V1": "pass", "V2": "pass" }
-}
-```
-
-Hard-fail:
-
-```json
-{
-  "ok": false,
-  "stage": "validation",
-  "failed_at": "V1",
-  "details": "numeración con gaps: 01-DML.sql + 03-INSERTS.sql sin 02",
-  "no_files_written": true
-}
-```