@saulwade/swl-ses 1.3.4 → 1.3.7

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