@saulwade/swl-ses 1.4.1 → 1.5.0

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