@saulwade/swl-ses 1.4.0 → 1.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/CLAUDE.md +4 -3
  2. package/README.md +15 -14
  3. package/agentes/nemesis-auditor-swl.md +161 -0
  4. package/bin/swl-mcp-server.js +187 -187
  5. package/comandos/swl/.evolved.json +22 -22
  6. package/comandos/swl/contribuir.md +233 -233
  7. package/comandos/swl/nemesis.md +122 -0
  8. package/comandos/swl/salud.md +34 -0
  9. package/comandos/swl/verificar.md +45 -0
  10. package/gateway/lib/event-channel.js +191 -191
  11. package/habilidades/backend-production-resilience/SKILL.md +288 -288
  12. package/habilidades/benchmark-memoria/SKILL.md +186 -186
  13. package/habilidades/diagrama-arquitectura/assets/template.html +276 -276
  14. package/habilidades/doubt-driven-review/SKILL.md +171 -171
  15. package/habilidades/doubt-driven-review/recursos/EXAMPLES.md +130 -130
  16. package/habilidades/eval-framework/SKILL.md +212 -212
  17. package/habilidades/feynman-auditor-swl/SKILL.md +123 -0
  18. package/habilidades/feynman-auditor-swl/recursos/preguntas-language-agnostic.md +108 -0
  19. package/habilidades/harness-claude-code/SKILL.md +299 -299
  20. package/habilidades/infra-github-actions/SKILL.md +166 -166
  21. package/habilidades/legacy-code-rescue/SKILL.md +267 -267
  22. package/habilidades/manejo-errores/.evolved.json +8 -8
  23. package/habilidades/meta-skills-estandar/recursos/convencion-examples.md +93 -93
  24. package/habilidades/meta-skills-estandar/recursos/skills-as-agents.md +163 -163
  25. package/habilidades/patrones-python/SKILL.md +229 -229
  26. package/habilidades/patrones-python/recursos/patrones-avanzados.md +469 -469
  27. package/habilidades/planear-fase/SKILL.md +319 -319
  28. package/habilidades/release-semver/.evolved.json +8 -8
  29. package/habilidades/state-inconsistency-auditor-swl/SKILL.md +166 -0
  30. package/habilidades/state-inconsistency-auditor-swl/recursos/coupled-state-patterns.md +147 -0
  31. package/habilidades/testing-python/SKILL.md +340 -340
  32. package/habilidades/web-fetcher-routing/SKILL.md +75 -0
  33. package/hooks/claudemd-bloat-detector.js +161 -161
  34. package/hooks/lib/agent-routing.js +107 -107
  35. package/hooks/lib/auto-consolidator.js +335 -335
  36. package/hooks/lib/error-classifier.js +308 -308
  37. package/hooks/lib/merkle-audit.js +96 -96
  38. package/hooks/lib/provenance-tracker.js +191 -191
  39. package/hooks/lib/rate-limit-tracker.js +253 -253
  40. package/hooks/lib/resource-quota.js +122 -122
  41. package/hooks/lib/retry-jitter.js +165 -165
  42. package/hooks/lib/security-net.js +201 -0
  43. package/hooks/lib/skill-auditor.js +588 -588
  44. package/hooks/lib/sync-status.js +228 -228
  45. package/hooks/lib/taint-tracker.js +107 -107
  46. package/hooks/lib/text-similarity.js +241 -241
  47. package/hooks/lib/toon-compressor.js +245 -245
  48. package/hooks/registro-turnos.js +209 -209
  49. package/hooks/sugerir-regenerar-inventario.js +170 -170
  50. package/hooks/validar-formato-post-subagente.js +140 -140
  51. package/hooks/validar-memoria-hook.js +218 -218
  52. package/instintos/prompt-appendices.yaml +57 -57
  53. package/manifiestos/agent-output-schemas.json +57 -57
  54. package/manifiestos/modulos.json +41 -6
  55. package/manifiestos/perfiles.json +2 -1
  56. package/manifiestos/skills-lock.json +30 -9
  57. package/package.json +2 -2
  58. package/plantillas/auditor-veto-template.md +105 -105
  59. package/plantillas/github-workflows/README.md +47 -47
  60. package/plantillas/github-workflows/release-please.yml +44 -44
  61. package/plantillas/github-workflows/swl-ci.yml +107 -107
  62. package/plantillas/github-workflows/swl-security.yml +51 -51
  63. package/plugin.json +10 -2
  64. package/reglas/analisis-previo-tareas-grandes.md +172 -172
  65. package/reglas/arreglar-al-detectar.md +147 -147
  66. package/reglas/fragmentos-compartidos.md +152 -152
  67. package/reglas/harness-claude-code.md +213 -213
  68. package/reglas/usar-context7.md +226 -226
  69. package/schemas/diary-entry.schema.json +80 -80
  70. package/scripts/audit-tools/audit-history.js +330 -0
  71. package/scripts/audit-tools/bundle-tracker.js +290 -0
  72. package/scripts/audit-tools/canary-monitor.js +352 -0
  73. package/scripts/audit-tools/code-profiler.js +605 -0
  74. package/scripts/audit-tools/dep-doctor.js +320 -0
  75. package/scripts/audit-tools/env-validator.js +206 -0
  76. package/scripts/audit-tools/lib/fs-walk.js +48 -0
  77. package/scripts/audit-tools/lib/output.js +23 -0
  78. package/scripts/audit-tools/migration-checker.js +392 -0
  79. package/scripts/audit-tools/pentest-scanner.js +1436 -0
  80. package/scripts/benchmark-memoria.js +167 -167
  81. package/scripts/configurar-branch-protection.js +418 -418
  82. package/scripts/detectar-aprendizajes-duplicados.js +151 -151
  83. package/scripts/field-report.js +199 -199
  84. package/scripts/generar-checklists-consolidados.js +273 -273
  85. package/scripts/generar-inventario.js +420 -420
  86. package/scripts/generar-matriz-lenguajes.js +271 -271
  87. package/scripts/lib/artefactos-python.js +43 -43
  88. package/scripts/lib/benchmark-metrics.js +160 -160
  89. package/scripts/lib/budget-enforcer.js +252 -252
  90. package/scripts/lib/configurar-ci.js +380 -380
  91. package/scripts/lib/contadores-inventario.js +217 -217
  92. package/scripts/lib/detectar-stack-detallado.js +307 -307
  93. package/scripts/lib/diary-entry.js +234 -234
  94. package/scripts/lib/eval-metrics-store.js +218 -218
  95. package/scripts/lib/eval-quality.js +171 -171
  96. package/scripts/lib/eval-schemas.js +144 -144
  97. package/scripts/lib/eval-self-correct.js +106 -106
  98. package/scripts/lib/eval-validator.js +185 -185
  99. package/scripts/lib/jaccard-similarity.js +98 -98
  100. package/scripts/lib/longmemeval-runner.js +125 -125
  101. package/scripts/lib/manifiestos.js +42 -1
  102. package/scripts/lib/npm-version.js +261 -261
  103. package/scripts/lib/paquetes-conocidos.js +50 -50
  104. package/scripts/lib/prompt-builder.js +264 -264
  105. package/scripts/lib/rrf-fusion.js +175 -175
  106. package/scripts/lib/scoring-instintos.js +277 -277
  107. package/scripts/lib/semantic-search.js +252 -252
  108. package/scripts/limpiar-artefactos-python.js +131 -131
  109. package/scripts/mcp-server/README.md +128 -128
  110. package/scripts/mcp-server/handlers.js +206 -206
  111. package/scripts/migrar-csv-a-array.js +168 -168
  112. package/scripts/migrar-fase-dominio.js +201 -201
  113. package/scripts/publicar.js +511 -511
  114. package/scripts/run-eval.js +141 -141
  115. package/scripts/validar-manifest.js +231 -195
  116. package/scripts/validar-userland-vacio.js +110 -110
@@ -1,201 +1,201 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Migración Sprint 2B — añade campos `fase` y `dominio` al frontmatter de los
4
- * 59 agentes de SWL. Skip si ya los tiene. Inserta antes de `exclusiones:` o
5
- * al final del frontmatter.
6
- *
7
- * Idempotente: corre dos veces sin efectos.
8
- *
9
- * Uso:
10
- * node scripts/migrar-fase-dominio.js [--dry-run]
11
- *
12
- * Origen: análisis de temp/ + propuesta consolidada (mayo 2026).
13
- */
14
-
15
- 'use strict';
16
-
17
- const fs = require('fs');
18
- const path = require('path');
19
-
20
- const AGENTES_DIR = path.join(__dirname, '..', 'agentes');
21
- const DRY_RUN = process.argv.includes('--dry-run');
22
-
23
- // Mapeo agente → (fase, dominio). Vocabulario controlado del schema.
24
- const MAPEO = {
25
- 'accesibilidad-wcag-swl': ['verify', 'ux'],
26
- 'arquitecto-swl': ['plan', 'general'],
27
- 'auto-evolucion-swl': ['learn', 'meta'],
28
- 'backend-api-swl': ['implement', 'backend'],
29
- 'backend-csharp-swl': ['implement', 'backend'],
30
- 'backend-go-swl': ['implement', 'backend'],
31
- 'backend-java-swl': ['implement', 'backend'],
32
- 'backend-node-swl': ['implement', 'backend'],
33
- 'backend-python-swl': ['implement', 'backend'],
34
- 'backend-rust-swl': ['implement', 'backend'],
35
- 'backend-workers-swl': ['implement', 'backend'],
36
- 'cloud-infra-swl': ['release', 'infra'],
37
- 'consolidador-swl': ['learn', 'meta'],
38
- 'datos-swl': ['implement', 'data'],
39
- 'depurador-swl': ['implement', 'general'],
40
- 'devops-ci-swl': ['release', 'infra'],
41
- 'disenador-ui-swl': ['plan', 'ux'],
42
- 'documentador-swl': ['meta', 'docs'],
43
- 'frontend-angular-swl': ['implement', 'frontend'],
44
- 'frontend-css-swl': ['implement', 'frontend'],
45
- 'frontend-react-swl': ['implement', 'frontend'],
46
- 'frontend-swl': ['implement', 'frontend'],
47
- 'frontend-tailwind-swl': ['implement', 'frontend'],
48
- 'implementador-swl': ['implement', 'general'],
49
- 'investigador-swl': ['discover', 'general'],
50
- 'investigador-ux-swl': ['discover', 'ux'],
51
- 'llm-apps-swl': ['implement', 'backend'],
52
- 'migrador-swl': ['implement', 'data'],
53
- 'mobile-android-swl': ['implement', 'mobile'],
54
- 'mobile-cross-swl': ['implement', 'mobile'],
55
- 'mobile-ios-swl': ['implement', 'mobile'],
56
- 'mobile-testing-swl': ['verify', 'quality'],
57
- 'notificador-swl': ['meta', 'meta'],
58
- 'observabilidad-swl': ['release', 'infra'],
59
- 'orquestador-swl': ['meta', 'process'],
60
- 'pagos-swl': ['implement', 'backend'],
61
- 'perfilador-usuario-swl': ['meta', 'meta'],
62
- 'planificador-swl': ['plan', 'process'],
63
- 'producto-prd-swl': ['discover', 'process'],
64
- 'red-team-swl': ['verify', 'security'],
65
- 'release-manager-swl': ['release', 'process'],
66
- 'rendimiento-swl': ['verify', 'quality'],
67
- 'resolutor-build-swl': ['implement', 'general'],
68
- 'revisor-angular-swl': ['verify', 'quality'],
69
- 'revisor-codigo-swl': ['verify', 'quality'],
70
- 'revisor-csharp-swl': ['verify', 'quality'],
71
- 'revisor-go-swl': ['verify', 'quality'],
72
- 'revisor-java-swl': ['verify', 'quality'],
73
- 'revisor-kotlin-swl': ['verify', 'quality'],
74
- 'revisor-nextjs-swl': ['verify', 'quality'],
75
- 'revisor-php-swl': ['verify', 'quality'],
76
- 'revisor-react-swl': ['verify', 'quality'],
77
- 'revisor-rust-swl': ['verify', 'quality'],
78
- 'revisor-seguridad-swl': ['verify', 'security'],
79
- 'revisor-swift-swl': ['verify', 'quality'],
80
- 'revisor-typescript-swl': ['verify', 'quality'],
81
- 'sre-swl': ['release', 'infra'],
82
- 'tdd-qa-swl': ['verify', 'quality'],
83
- 'ux-disenador-swl': ['plan', 'ux'],
84
- };
85
-
86
- function migrarAgente(nombre) {
87
- const archivo = path.join(AGENTES_DIR, `${nombre}.md`);
88
- if (!fs.existsSync(archivo)) {
89
- return { nombre, status: 'no-existe' };
90
- }
91
-
92
- const par = MAPEO[nombre];
93
- if (!par) {
94
- return { nombre, status: 'sin-mapeo' };
95
- }
96
- const [fase, dominio] = par;
97
-
98
- const contenido = fs.readFileSync(archivo, 'utf-8');
99
-
100
- // Detectar el frontmatter delimitado por `---` (acepta CRLF y LF)
101
- const match = contenido.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n/);
102
- if (!match) {
103
- return { nombre, status: 'sin-frontmatter' };
104
- }
105
-
106
- const frontmatter = match[1];
107
-
108
- // Idempotencia: skip si ya tiene fase y dominio
109
- const tieneFase = /^fase:\s*\S+/m.test(frontmatter);
110
- const tieneDominio = /^dominio:\s*\S+/m.test(frontmatter);
111
- if (tieneFase && tieneDominio) {
112
- return { nombre, status: 'ya-migrado', fase, dominio };
113
- }
114
-
115
- // Insertar antes de `exclusiones:` o al final del frontmatter
116
- let nuevoFrontmatter;
117
- if (/^exclusiones:/m.test(frontmatter)) {
118
- nuevoFrontmatter = frontmatter.replace(
119
- /^(exclusiones:)/m,
120
- `fase: ${fase}\ndominio: ${dominio}\n$1`
121
- );
122
- } else {
123
- // Sin exclusiones: agregar al final del frontmatter
124
- nuevoFrontmatter = frontmatter.trimEnd() + `\nfase: ${fase}\ndominio: ${dominio}\n`;
125
- }
126
-
127
- // Preservar el line ending detectado
128
- const eol = match[0].includes('\r\n') ? '\r\n' : '\n';
129
- const fm = nuevoFrontmatter.replace(/\r\n/g, '\n').replace(/\n/g, eol);
130
- const nuevoContenido = contenido.replace(match[0], `---${eol}${fm}${eol}---${eol}`);
131
-
132
- if (DRY_RUN) {
133
- return { nombre, status: 'dry-run-ok', fase, dominio };
134
- }
135
-
136
- fs.writeFileSync(archivo, nuevoContenido, 'utf-8');
137
- return { nombre, status: 'migrado', fase, dominio };
138
- }
139
-
140
- function main() {
141
- console.log(`Migrando fase/dominio en agentes${DRY_RUN ? ' (dry-run)' : ''}...\n`);
142
-
143
- const archivosEnDisco = fs
144
- .readdirSync(AGENTES_DIR)
145
- .filter((f) => f.endsWith('.md') && !f.startsWith('_'))
146
- .map((f) => f.replace(/\.md$/, ''));
147
-
148
- const resultados = archivosEnDisco.map(migrarAgente);
149
-
150
- const stats = {
151
- migrado: 0,
152
- 'ya-migrado': 0,
153
- 'dry-run-ok': 0,
154
- 'sin-mapeo': [],
155
- 'sin-frontmatter': [],
156
- 'no-existe': [],
157
- };
158
-
159
- for (const r of resultados) {
160
- if (typeof stats[r.status] === 'number') {
161
- stats[r.status]++;
162
- } else if (Array.isArray(stats[r.status])) {
163
- stats[r.status].push(r.nombre);
164
- }
165
- }
166
-
167
- console.log(`Migrados: ${stats.migrado}`);
168
- console.log(`Ya migrados (skip): ${stats['ya-migrado']}`);
169
- console.log(`Dry-run OK: ${stats['dry-run-ok']}`);
170
- if (stats['sin-mapeo'].length) {
171
- console.log(`\n⚠️ Sin mapeo en MAPEO (${stats['sin-mapeo'].length}):`);
172
- stats['sin-mapeo'].forEach((n) => console.log(` - ${n}`));
173
- }
174
- if (stats['sin-frontmatter'].length) {
175
- console.log(`\n❌ Sin frontmatter detectable:`);
176
- stats['sin-frontmatter'].forEach((n) => console.log(` - ${n}`));
177
- }
178
-
179
- // Validación: el mapeo debe cubrir todos los agentes en disco
180
- const enMapeo = new Set(Object.keys(MAPEO));
181
- const enDisco = new Set(archivosEnDisco);
182
- const faltanEnMapeo = [...enDisco].filter((n) => !enMapeo.has(n));
183
- const sobranEnMapeo = [...enMapeo].filter((n) => !enDisco.has(n));
184
-
185
- if (faltanEnMapeo.length) {
186
- console.log(`\n⚠️ Agentes en disco sin entrada en MAPEO:`);
187
- faltanEnMapeo.forEach((n) => console.log(` - ${n}`));
188
- }
189
- if (sobranEnMapeo.length) {
190
- console.log(`\nℹ️ Entradas en MAPEO sin archivo en disco (probablemente renombrados):`);
191
- sobranEnMapeo.forEach((n) => console.log(` - ${n}`));
192
- }
193
-
194
- process.exit(stats['sin-frontmatter'].length || faltanEnMapeo.length ? 1 : 0);
195
- }
196
-
197
- if (require.main === module) {
198
- main();
199
- }
200
-
201
- module.exports = { MAPEO, migrarAgente };
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Migración Sprint 2B — añade campos `fase` y `dominio` al frontmatter de los
4
+ * 59 agentes de SWL. Skip si ya los tiene. Inserta antes de `exclusiones:` o
5
+ * al final del frontmatter.
6
+ *
7
+ * Idempotente: corre dos veces sin efectos.
8
+ *
9
+ * Uso:
10
+ * node scripts/migrar-fase-dominio.js [--dry-run]
11
+ *
12
+ * Origen: análisis de temp/ + propuesta consolidada (mayo 2026).
13
+ */
14
+
15
+ 'use strict';
16
+
17
+ const fs = require('fs');
18
+ const path = require('path');
19
+
20
+ const AGENTES_DIR = path.join(__dirname, '..', 'agentes');
21
+ const DRY_RUN = process.argv.includes('--dry-run');
22
+
23
+ // Mapeo agente → (fase, dominio). Vocabulario controlado del schema.
24
+ const MAPEO = {
25
+ 'accesibilidad-wcag-swl': ['verify', 'ux'],
26
+ 'arquitecto-swl': ['plan', 'general'],
27
+ 'auto-evolucion-swl': ['learn', 'meta'],
28
+ 'backend-api-swl': ['implement', 'backend'],
29
+ 'backend-csharp-swl': ['implement', 'backend'],
30
+ 'backend-go-swl': ['implement', 'backend'],
31
+ 'backend-java-swl': ['implement', 'backend'],
32
+ 'backend-node-swl': ['implement', 'backend'],
33
+ 'backend-python-swl': ['implement', 'backend'],
34
+ 'backend-rust-swl': ['implement', 'backend'],
35
+ 'backend-workers-swl': ['implement', 'backend'],
36
+ 'cloud-infra-swl': ['release', 'infra'],
37
+ 'consolidador-swl': ['learn', 'meta'],
38
+ 'datos-swl': ['implement', 'data'],
39
+ 'depurador-swl': ['implement', 'general'],
40
+ 'devops-ci-swl': ['release', 'infra'],
41
+ 'disenador-ui-swl': ['plan', 'ux'],
42
+ 'documentador-swl': ['meta', 'docs'],
43
+ 'frontend-angular-swl': ['implement', 'frontend'],
44
+ 'frontend-css-swl': ['implement', 'frontend'],
45
+ 'frontend-react-swl': ['implement', 'frontend'],
46
+ 'frontend-swl': ['implement', 'frontend'],
47
+ 'frontend-tailwind-swl': ['implement', 'frontend'],
48
+ 'implementador-swl': ['implement', 'general'],
49
+ 'investigador-swl': ['discover', 'general'],
50
+ 'investigador-ux-swl': ['discover', 'ux'],
51
+ 'llm-apps-swl': ['implement', 'backend'],
52
+ 'migrador-swl': ['implement', 'data'],
53
+ 'mobile-android-swl': ['implement', 'mobile'],
54
+ 'mobile-cross-swl': ['implement', 'mobile'],
55
+ 'mobile-ios-swl': ['implement', 'mobile'],
56
+ 'mobile-testing-swl': ['verify', 'quality'],
57
+ 'notificador-swl': ['meta', 'meta'],
58
+ 'observabilidad-swl': ['release', 'infra'],
59
+ 'orquestador-swl': ['meta', 'process'],
60
+ 'pagos-swl': ['implement', 'backend'],
61
+ 'perfilador-usuario-swl': ['meta', 'meta'],
62
+ 'planificador-swl': ['plan', 'process'],
63
+ 'producto-prd-swl': ['discover', 'process'],
64
+ 'red-team-swl': ['verify', 'security'],
65
+ 'release-manager-swl': ['release', 'process'],
66
+ 'rendimiento-swl': ['verify', 'quality'],
67
+ 'resolutor-build-swl': ['implement', 'general'],
68
+ 'revisor-angular-swl': ['verify', 'quality'],
69
+ 'revisor-codigo-swl': ['verify', 'quality'],
70
+ 'revisor-csharp-swl': ['verify', 'quality'],
71
+ 'revisor-go-swl': ['verify', 'quality'],
72
+ 'revisor-java-swl': ['verify', 'quality'],
73
+ 'revisor-kotlin-swl': ['verify', 'quality'],
74
+ 'revisor-nextjs-swl': ['verify', 'quality'],
75
+ 'revisor-php-swl': ['verify', 'quality'],
76
+ 'revisor-react-swl': ['verify', 'quality'],
77
+ 'revisor-rust-swl': ['verify', 'quality'],
78
+ 'revisor-seguridad-swl': ['verify', 'security'],
79
+ 'revisor-swift-swl': ['verify', 'quality'],
80
+ 'revisor-typescript-swl': ['verify', 'quality'],
81
+ 'sre-swl': ['release', 'infra'],
82
+ 'tdd-qa-swl': ['verify', 'quality'],
83
+ 'ux-disenador-swl': ['plan', 'ux'],
84
+ };
85
+
86
+ function migrarAgente(nombre) {
87
+ const archivo = path.join(AGENTES_DIR, `${nombre}.md`);
88
+ if (!fs.existsSync(archivo)) {
89
+ return { nombre, status: 'no-existe' };
90
+ }
91
+
92
+ const par = MAPEO[nombre];
93
+ if (!par) {
94
+ return { nombre, status: 'sin-mapeo' };
95
+ }
96
+ const [fase, dominio] = par;
97
+
98
+ const contenido = fs.readFileSync(archivo, 'utf-8');
99
+
100
+ // Detectar el frontmatter delimitado por `---` (acepta CRLF y LF)
101
+ const match = contenido.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n/);
102
+ if (!match) {
103
+ return { nombre, status: 'sin-frontmatter' };
104
+ }
105
+
106
+ const frontmatter = match[1];
107
+
108
+ // Idempotencia: skip si ya tiene fase y dominio
109
+ const tieneFase = /^fase:\s*\S+/m.test(frontmatter);
110
+ const tieneDominio = /^dominio:\s*\S+/m.test(frontmatter);
111
+ if (tieneFase && tieneDominio) {
112
+ return { nombre, status: 'ya-migrado', fase, dominio };
113
+ }
114
+
115
+ // Insertar antes de `exclusiones:` o al final del frontmatter
116
+ let nuevoFrontmatter;
117
+ if (/^exclusiones:/m.test(frontmatter)) {
118
+ nuevoFrontmatter = frontmatter.replace(
119
+ /^(exclusiones:)/m,
120
+ `fase: ${fase}\ndominio: ${dominio}\n$1`
121
+ );
122
+ } else {
123
+ // Sin exclusiones: agregar al final del frontmatter
124
+ nuevoFrontmatter = frontmatter.trimEnd() + `\nfase: ${fase}\ndominio: ${dominio}\n`;
125
+ }
126
+
127
+ // Preservar el line ending detectado
128
+ const eol = match[0].includes('\r\n') ? '\r\n' : '\n';
129
+ const fm = nuevoFrontmatter.replace(/\r\n/g, '\n').replace(/\n/g, eol);
130
+ const nuevoContenido = contenido.replace(match[0], `---${eol}${fm}${eol}---${eol}`);
131
+
132
+ if (DRY_RUN) {
133
+ return { nombre, status: 'dry-run-ok', fase, dominio };
134
+ }
135
+
136
+ fs.writeFileSync(archivo, nuevoContenido, 'utf-8');
137
+ return { nombre, status: 'migrado', fase, dominio };
138
+ }
139
+
140
+ function main() {
141
+ console.log(`Migrando fase/dominio en agentes${DRY_RUN ? ' (dry-run)' : ''}...\n`);
142
+
143
+ const archivosEnDisco = fs
144
+ .readdirSync(AGENTES_DIR)
145
+ .filter((f) => f.endsWith('.md') && !f.startsWith('_'))
146
+ .map((f) => f.replace(/\.md$/, ''));
147
+
148
+ const resultados = archivosEnDisco.map(migrarAgente);
149
+
150
+ const stats = {
151
+ migrado: 0,
152
+ 'ya-migrado': 0,
153
+ 'dry-run-ok': 0,
154
+ 'sin-mapeo': [],
155
+ 'sin-frontmatter': [],
156
+ 'no-existe': [],
157
+ };
158
+
159
+ for (const r of resultados) {
160
+ if (typeof stats[r.status] === 'number') {
161
+ stats[r.status]++;
162
+ } else if (Array.isArray(stats[r.status])) {
163
+ stats[r.status].push(r.nombre);
164
+ }
165
+ }
166
+
167
+ console.log(`Migrados: ${stats.migrado}`);
168
+ console.log(`Ya migrados (skip): ${stats['ya-migrado']}`);
169
+ console.log(`Dry-run OK: ${stats['dry-run-ok']}`);
170
+ if (stats['sin-mapeo'].length) {
171
+ console.log(`\n⚠️ Sin mapeo en MAPEO (${stats['sin-mapeo'].length}):`);
172
+ stats['sin-mapeo'].forEach((n) => console.log(` - ${n}`));
173
+ }
174
+ if (stats['sin-frontmatter'].length) {
175
+ console.log(`\n❌ Sin frontmatter detectable:`);
176
+ stats['sin-frontmatter'].forEach((n) => console.log(` - ${n}`));
177
+ }
178
+
179
+ // Validación: el mapeo debe cubrir todos los agentes en disco
180
+ const enMapeo = new Set(Object.keys(MAPEO));
181
+ const enDisco = new Set(archivosEnDisco);
182
+ const faltanEnMapeo = [...enDisco].filter((n) => !enMapeo.has(n));
183
+ const sobranEnMapeo = [...enMapeo].filter((n) => !enDisco.has(n));
184
+
185
+ if (faltanEnMapeo.length) {
186
+ console.log(`\n⚠️ Agentes en disco sin entrada en MAPEO:`);
187
+ faltanEnMapeo.forEach((n) => console.log(` - ${n}`));
188
+ }
189
+ if (sobranEnMapeo.length) {
190
+ console.log(`\nℹ️ Entradas en MAPEO sin archivo en disco (probablemente renombrados):`);
191
+ sobranEnMapeo.forEach((n) => console.log(` - ${n}`));
192
+ }
193
+
194
+ process.exit(stats['sin-frontmatter'].length || faltanEnMapeo.length ? 1 : 0);
195
+ }
196
+
197
+ if (require.main === module) {
198
+ main();
199
+ }
200
+
201
+ module.exports = { MAPEO, migrarAgente };