@saulwade/swl-ses 1.4.1 → 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 (114) hide show
  1. package/CLAUDE.md +1 -1
  2. package/README.md +1 -1
  3. package/agentes/nemesis-auditor-swl.md +161 -161
  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 -122
  8. package/gateway/lib/event-channel.js +191 -191
  9. package/habilidades/backend-production-resilience/SKILL.md +288 -288
  10. package/habilidades/benchmark-memoria/SKILL.md +186 -186
  11. package/habilidades/diagrama-arquitectura/assets/template.html +276 -276
  12. package/habilidades/doubt-driven-review/SKILL.md +171 -171
  13. package/habilidades/doubt-driven-review/recursos/EXAMPLES.md +130 -130
  14. package/habilidades/eval-framework/SKILL.md +212 -212
  15. package/habilidades/feynman-auditor-swl/SKILL.md +123 -123
  16. package/habilidades/feynman-auditor-swl/recursos/preguntas-language-agnostic.md +108 -108
  17. package/habilidades/harness-claude-code/SKILL.md +299 -299
  18. package/habilidades/infra-github-actions/SKILL.md +166 -166
  19. package/habilidades/legacy-code-rescue/SKILL.md +267 -267
  20. package/habilidades/manejo-errores/.evolved.json +8 -8
  21. package/habilidades/meta-skills-estandar/recursos/convencion-examples.md +93 -93
  22. package/habilidades/meta-skills-estandar/recursos/skills-as-agents.md +163 -163
  23. package/habilidades/patrones-python/SKILL.md +229 -229
  24. package/habilidades/patrones-python/recursos/patrones-avanzados.md +469 -469
  25. package/habilidades/planear-fase/SKILL.md +319 -319
  26. package/habilidades/release-semver/.evolved.json +8 -8
  27. package/habilidades/state-inconsistency-auditor-swl/SKILL.md +166 -166
  28. package/habilidades/state-inconsistency-auditor-swl/recursos/coupled-state-patterns.md +147 -147
  29. package/habilidades/testing-python/SKILL.md +340 -340
  30. package/habilidades/web-fetcher-routing/SKILL.md +75 -75
  31. package/hooks/claudemd-bloat-detector.js +161 -161
  32. package/hooks/lib/agent-routing.js +107 -107
  33. package/hooks/lib/auto-consolidator.js +335 -335
  34. package/hooks/lib/error-classifier.js +308 -308
  35. package/hooks/lib/merkle-audit.js +96 -96
  36. package/hooks/lib/provenance-tracker.js +191 -191
  37. package/hooks/lib/rate-limit-tracker.js +253 -253
  38. package/hooks/lib/resource-quota.js +122 -122
  39. package/hooks/lib/retry-jitter.js +165 -165
  40. package/hooks/lib/security-net.js +201 -201
  41. package/hooks/lib/skill-auditor.js +588 -588
  42. package/hooks/lib/sync-status.js +228 -228
  43. package/hooks/lib/taint-tracker.js +107 -107
  44. package/hooks/lib/text-similarity.js +241 -241
  45. package/hooks/lib/toon-compressor.js +245 -245
  46. package/hooks/registro-turnos.js +209 -209
  47. package/hooks/sugerir-regenerar-inventario.js +170 -170
  48. package/hooks/validar-formato-post-subagente.js +140 -140
  49. package/hooks/validar-memoria-hook.js +218 -218
  50. package/instintos/prompt-appendices.yaml +57 -57
  51. package/manifiestos/agent-output-schemas.json +57 -57
  52. package/manifiestos/modulos.json +11 -6
  53. package/manifiestos/perfiles.json +2 -1
  54. package/manifiestos/skills-lock.json +1114 -1114
  55. package/package.json +1 -1
  56. package/plantillas/auditor-veto-template.md +105 -105
  57. package/plantillas/github-workflows/README.md +47 -47
  58. package/plantillas/github-workflows/release-please.yml +44 -44
  59. package/plantillas/github-workflows/swl-ci.yml +107 -107
  60. package/plantillas/github-workflows/swl-security.yml +51 -51
  61. package/plugin.json +9 -1
  62. package/reglas/analisis-previo-tareas-grandes.md +172 -172
  63. package/reglas/arreglar-al-detectar.md +147 -147
  64. package/reglas/fragmentos-compartidos.md +152 -152
  65. package/reglas/harness-claude-code.md +213 -213
  66. package/reglas/usar-context7.md +226 -226
  67. package/schemas/diary-entry.schema.json +80 -80
  68. package/scripts/audit-tools/audit-history.js +330 -330
  69. package/scripts/audit-tools/bundle-tracker.js +290 -290
  70. package/scripts/audit-tools/canary-monitor.js +352 -352
  71. package/scripts/audit-tools/code-profiler.js +605 -605
  72. package/scripts/audit-tools/dep-doctor.js +320 -320
  73. package/scripts/audit-tools/env-validator.js +206 -206
  74. package/scripts/audit-tools/lib/fs-walk.js +48 -48
  75. package/scripts/audit-tools/lib/output.js +23 -23
  76. package/scripts/audit-tools/migration-checker.js +392 -392
  77. package/scripts/audit-tools/pentest-scanner.js +1436 -1436
  78. package/scripts/benchmark-memoria.js +167 -167
  79. package/scripts/configurar-branch-protection.js +418 -418
  80. package/scripts/detectar-aprendizajes-duplicados.js +151 -151
  81. package/scripts/field-report.js +199 -199
  82. package/scripts/generar-checklists-consolidados.js +273 -273
  83. package/scripts/generar-inventario.js +420 -420
  84. package/scripts/generar-matriz-lenguajes.js +271 -271
  85. package/scripts/lib/artefactos-python.js +43 -43
  86. package/scripts/lib/benchmark-metrics.js +160 -160
  87. package/scripts/lib/budget-enforcer.js +252 -252
  88. package/scripts/lib/configurar-ci.js +380 -380
  89. package/scripts/lib/contadores-inventario.js +217 -217
  90. package/scripts/lib/detectar-stack-detallado.js +307 -307
  91. package/scripts/lib/diary-entry.js +234 -234
  92. package/scripts/lib/eval-metrics-store.js +218 -218
  93. package/scripts/lib/eval-quality.js +171 -171
  94. package/scripts/lib/eval-schemas.js +144 -144
  95. package/scripts/lib/eval-self-correct.js +106 -106
  96. package/scripts/lib/eval-validator.js +185 -185
  97. package/scripts/lib/jaccard-similarity.js +98 -98
  98. package/scripts/lib/longmemeval-runner.js +125 -125
  99. package/scripts/lib/manifiestos.js +42 -1
  100. package/scripts/lib/npm-version.js +261 -261
  101. package/scripts/lib/paquetes-conocidos.js +50 -50
  102. package/scripts/lib/prompt-builder.js +264 -264
  103. package/scripts/lib/rrf-fusion.js +175 -175
  104. package/scripts/lib/scoring-instintos.js +277 -277
  105. package/scripts/lib/semantic-search.js +252 -252
  106. package/scripts/limpiar-artefactos-python.js +131 -131
  107. package/scripts/mcp-server/README.md +128 -128
  108. package/scripts/mcp-server/handlers.js +206 -206
  109. package/scripts/migrar-csv-a-array.js +168 -168
  110. package/scripts/migrar-fase-dominio.js +201 -201
  111. package/scripts/publicar.js +511 -511
  112. package/scripts/run-eval.js +141 -141
  113. package/scripts/validar-manifest.js +231 -195
  114. 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 };