@saulwade/swl-ses 1.3.8 → 1.4.1

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