@saulwade/swl-ses 2.2.4 → 2.3.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 (325) hide show
  1. package/CLAUDE.md +48 -7
  2. package/README.md +3 -3
  3. package/agentes/accesibilidad-wcag-swl.md +690 -690
  4. package/agentes/arquitecto-swl.md +267 -267
  5. package/agentes/auto-evolucion-swl.md +908 -908
  6. package/agentes/backend-api-swl.md +472 -472
  7. package/agentes/backend-csharp-swl.md +420 -420
  8. package/agentes/backend-go-swl.md +390 -390
  9. package/agentes/backend-java-swl.md +281 -281
  10. package/agentes/backend-node-swl.md +479 -479
  11. package/agentes/backend-python-swl.md +605 -605
  12. package/agentes/backend-rust-swl.md +364 -364
  13. package/agentes/backend-workers-swl.md +482 -482
  14. package/agentes/cloud-infra-swl.md +509 -509
  15. package/agentes/consolidador-swl.md +541 -541
  16. package/agentes/datos-swl.md +605 -605
  17. package/agentes/depurador-swl.md +352 -352
  18. package/agentes/devops-ci-swl.md +400 -400
  19. package/agentes/disenador-ui-swl.md +569 -569
  20. package/agentes/documentador-swl.md +345 -345
  21. package/agentes/frontend-angular-swl.md +621 -621
  22. package/agentes/frontend-css-swl.md +716 -716
  23. package/agentes/frontend-react-swl.md +692 -692
  24. package/agentes/frontend-swl.md +496 -496
  25. package/agentes/frontend-tailwind-swl.md +826 -826
  26. package/agentes/gh-fix-ci-swl.md +2 -2
  27. package/agentes/implementador-swl.md +328 -328
  28. package/agentes/investigador-swl.md +432 -432
  29. package/agentes/investigador-ux-swl.md +505 -505
  30. package/agentes/llm-apps-swl.md +278 -278
  31. package/agentes/migrador-swl.md +442 -442
  32. package/agentes/mobile-android-swl.md +511 -511
  33. package/agentes/mobile-cross-swl.md +541 -541
  34. package/agentes/mobile-ios-swl.md +502 -502
  35. package/agentes/mobile-testing-swl.md +302 -302
  36. package/agentes/nemesis-auditor-swl.md +285 -285
  37. package/agentes/notificador-swl.md +918 -918
  38. package/agentes/observabilidad-swl.md +438 -438
  39. package/agentes/orquestador-swl.md +1026 -1026
  40. package/agentes/pagos-swl.md +310 -310
  41. package/agentes/perfilador-usuario-swl.md +321 -321
  42. package/agentes/planificador-swl.md +399 -399
  43. package/agentes/producto-prd-swl.md +589 -589
  44. package/agentes/red-team-swl.md +1 -1
  45. package/agentes/release-manager-swl.md +590 -590
  46. package/agentes/rendimiento-swl.md +713 -713
  47. package/agentes/resolutor-build-swl.md +245 -245
  48. package/agentes/revisor-angular-swl.md +278 -278
  49. package/agentes/revisor-codigo-swl.md +505 -505
  50. package/agentes/revisor-csharp-swl.md +264 -264
  51. package/agentes/revisor-go-swl.md +259 -259
  52. package/agentes/revisor-java-swl.md +257 -257
  53. package/agentes/revisor-kotlin-swl.md +273 -273
  54. package/agentes/revisor-nextjs-swl.md +281 -281
  55. package/agentes/revisor-php-swl.md +271 -271
  56. package/agentes/revisor-react-swl.md +278 -278
  57. package/agentes/revisor-rust-swl.md +346 -346
  58. package/agentes/revisor-seguridad-swl.md +399 -399
  59. package/agentes/revisor-swift-swl.md +268 -268
  60. package/agentes/revisor-typescript-swl.md +346 -346
  61. package/agentes/sre-swl.md +291 -291
  62. package/agentes/tdd-qa-swl.md +393 -393
  63. package/comandos/swl/aprobar-plan.md +146 -141
  64. package/comandos/swl/briefing.md +119 -119
  65. package/comandos/swl/contribuir.md +233 -233
  66. package/comandos/swl/predecir.md +139 -139
  67. package/comandos/swl/release.md +30 -8
  68. package/comandos/swl/sesiones.md +1 -1
  69. package/comandos/swl/status.md +343 -333
  70. package/gateway/agent-executor.js +1 -1
  71. package/gateway/lib/event-channel.js +191 -191
  72. package/habilidades/agent-deep-links/SKILL.md +148 -148
  73. package/habilidades/agentes-como-servicio/SKILL.md +2 -2
  74. package/habilidades/angular-moderno/SKILL.md +20 -1
  75. package/habilidades/auto-evolucion-protocolo/SKILL.md +276 -276
  76. package/habilidades/backend-async-postgres-testing/SKILL.md +215 -215
  77. package/habilidades/backend-error-design/SKILL.md +221 -221
  78. package/habilidades/backend-production-resilience/SKILL.md +288 -288
  79. package/habilidades/benchmark-memoria/SKILL.md +186 -186
  80. package/habilidades/calidad-anti-patrones-universales/SKILL.md +368 -368
  81. package/habilidades/calidad-contract-testing/SKILL.md +165 -165
  82. package/habilidades/calidad-mutation-testing/SKILL.md +170 -170
  83. package/habilidades/changelog-generator/scripts/parse-commits.js +367 -367
  84. package/habilidades/checklist-seguridad/recursos/stride-cobertura.md +60 -60
  85. package/habilidades/contenedores-docker/SKILL.md +3 -1
  86. package/habilidades/diagrama-arquitectura/assets/template.html +276 -276
  87. package/habilidades/doubt-driven-review/recursos/EXAMPLES.md +130 -130
  88. package/habilidades/drift-detection/SKILL.md +179 -179
  89. package/habilidades/ejecutar-fase/SKILL.md +564 -541
  90. package/habilidades/ejecutar-task-iterativo/SKILL.md +278 -278
  91. package/habilidades/estructura-proyecto-claude/recursos/frontmatter-y-hooks-referencia.md +1 -1
  92. package/habilidades/estructura-proyecto-claude/recursos/mcp-json-template.json +57 -57
  93. package/habilidades/eval-framework/SKILL.md +212 -212
  94. package/habilidades/extractor-de-aprendizajes/SKILL.md +3 -3
  95. package/habilidades/feynman-auditor-swl/recursos/preguntas-language-agnostic.md +108 -108
  96. package/habilidades/harness-claude-code/recursos/disciplina-harness-regla.md +252 -252
  97. package/habilidades/legacy-code-rescue/SKILL.md +267 -267
  98. package/habilidades/meta-skills-estandar/recursos/convencion-examples.md +93 -93
  99. package/habilidades/patrones-python/recursos/patrones-avanzados.md +469 -469
  100. package/habilidades/perfil-usuario/SKILL.md +200 -200
  101. package/habilidades/planear-fase/SKILL.md +15 -1
  102. package/habilidades/prevencion-sobreingenieria/recursos/EXAMPLES.md +580 -580
  103. package/habilidades/proceso-ddia-fundamentos/SKILL.md +255 -255
  104. package/habilidades/proceso-ddia-streaming/SKILL.md +231 -231
  105. package/habilidades/proceso-debate-adversarial/SKILL.md +191 -164
  106. package/habilidades/proceso-debate-adversarial/recursos/personas.md +105 -105
  107. package/habilidades/proceso-discovery-machote/SKILL.md +157 -157
  108. package/habilidades/proceso-dynamic-workflows/SKILL.md +138 -138
  109. package/habilidades/proceso-dynamic-workflows/recursos/template-adversarial-verify.js +65 -65
  110. package/habilidades/proceso-dynamic-workflows/recursos/template-triage.js +65 -65
  111. package/habilidades/proceso-intent-engineering/SKILL.md +269 -269
  112. package/habilidades/proceso-modular-split/SKILL.md +256 -256
  113. package/habilidades/prompt-engineering/recursos/patrones-avanzados.md +2 -2
  114. package/habilidades/state-inconsistency-auditor-swl/recursos/coupled-state-patterns.md +147 -147
  115. package/habilidades/structured-outputs/SKILL.md +2 -2
  116. package/habilidades/swl-claudemd/recursos/contrato-aprender.md +83 -83
  117. package/habilidades/swl-claudemd/recursos/duplicacion-reglas-globales.md +85 -85
  118. package/habilidades/swl-claudemd/recursos/plantillas-init.md +94 -94
  119. package/habilidades/swl-dashboard/SKILL.md +2 -2
  120. package/habilidades/tdd-workflow/SKILL.md +33 -1
  121. package/habilidades/tdd-workflow/recursos/gherkin-bdd.md +111 -111
  122. package/habilidades/validacion-ci-sistema/recursos/validadores-completos.md +1 -1
  123. package/habilidades/validacion-ci-sistema/scripts/validar-sistema.sh +1 -1
  124. package/hooks/captura-acciones-post.js +151 -0
  125. package/hooks/captura-acciones-session.js +155 -0
  126. package/hooks/ciclo-evolucion-subagente.js +26 -26
  127. package/hooks/ciclo-evolucion.js +26 -26
  128. package/hooks/claudemd-bloat-detector.js +161 -161
  129. package/hooks/claudemd-duplicacion-detector.js +170 -170
  130. package/hooks/contexto-iteracion.js +144 -144
  131. package/hooks/guardrail-modelo.js +1 -1
  132. package/hooks/lib/agent-routing.js +107 -107
  133. package/hooks/lib/auto-consolidator.js +335 -335
  134. package/hooks/lib/autonomia.js +208 -208
  135. package/hooks/lib/briefing.js +512 -474
  136. package/hooks/lib/captura-acciones.js +392 -0
  137. package/hooks/lib/ciclo-evolucion.js +47 -47
  138. package/hooks/lib/deep-links.js +185 -185
  139. package/hooks/lib/error-classifier.js +308 -308
  140. package/hooks/lib/etapa-auto-evolucion.js +701 -701
  141. package/hooks/lib/etapa-metricas.js +388 -388
  142. package/hooks/lib/etapa-perfil-usuario.js +376 -376
  143. package/hooks/lib/loop-telemetry.js +321 -321
  144. package/hooks/lib/merkle-audit.js +96 -96
  145. package/hooks/lib/model-router.js +2 -2
  146. package/hooks/lib/propose-step.js +358 -358
  147. package/hooks/lib/provenance-tracker.js +191 -191
  148. package/hooks/lib/rate-limit-tracker.js +253 -253
  149. package/hooks/lib/resource-quota.js +122 -122
  150. package/hooks/lib/retry-jitter.js +165 -165
  151. package/hooks/lib/security-net.js +201 -201
  152. package/hooks/lib/skill-auditor.js +588 -588
  153. package/hooks/lib/sync-status.js +228 -228
  154. package/hooks/lib/taint-tracker.js +107 -107
  155. package/hooks/lib/text-similarity.js +241 -241
  156. package/hooks/lib/token-estimator.js +1 -0
  157. package/hooks/lib/toon-compressor.js +245 -245
  158. package/hooks/lib/usage-model.js +1 -1
  159. package/hooks/linea-estado.js +2 -0
  160. package/hooks/registro-turnos.js +209 -209
  161. package/hooks/session-briefing.js +98 -98
  162. package/hooks/spec-gate.js +211 -211
  163. package/hooks/sugerir-regenerar-inventario.js +170 -170
  164. package/hooks/tdd-gate.js +241 -241
  165. package/hooks/telemetria-skill-routing.js +100 -100
  166. package/hooks/validar-formato-post-subagente.js +140 -140
  167. package/hooks/validar-intent-spec.js +242 -242
  168. package/hooks/validar-memoria-hook.js +218 -218
  169. package/hooks/validar-planning-paths.js +134 -134
  170. package/instintos/autonomia.yaml +27 -27
  171. package/instintos/prompt-appendices.yaml +57 -57
  172. package/llms.txt +2 -2
  173. package/manifiestos/agent-output-schemas.json +57 -57
  174. package/manifiestos/canonical-hashes.json +2291 -1637
  175. package/manifiestos/hooks-config.json +18 -0
  176. package/manifiestos/modulos.json +4 -0
  177. package/manifiestos/planning-paths.json +44 -44
  178. package/manifiestos/skills-lock.json +1282 -1282
  179. package/package.json +2 -2
  180. package/plantillas/auditor-veto-template.md +105 -105
  181. package/plantillas/github-workflows/README.md +47 -47
  182. package/plantillas/github-workflows/release-please.yml +44 -44
  183. package/plantillas/github-workflows/swl-ci.yml +107 -107
  184. package/plantillas/github-workflows/swl-security.yml +51 -51
  185. package/plugin.json +2 -2
  186. package/reglas/accesibilidad.md +10 -10
  187. package/reglas/analisis-previo-tareas-grandes.md +172 -172
  188. package/reglas/api-diseno.md +9 -9
  189. package/reglas/arreglar-al-detectar.md +240 -240
  190. package/reglas/auditorias-documentales-estructurales.md +7 -7
  191. package/reglas/cloud-infra.md +8 -8
  192. package/reglas/consultar-vault-primero.md +195 -195
  193. package/reglas/debatir-antes-de-aceptar.md +158 -158
  194. package/reglas/fragmentos-compartidos.md +183 -183
  195. package/reglas/hooks.md +6 -6
  196. package/reglas/intent-engineering.md +218 -218
  197. package/reglas/markitdown.md +8 -8
  198. package/reglas/memoria-consolidada.md +41 -0
  199. package/reglas/monitor-ci.md +309 -309
  200. package/reglas/patrones.md +6 -6
  201. package/reglas/seguridad-agentes.md +66 -0
  202. package/reglas/sesiones-paralelas.md +180 -180
  203. package/reglas/sin-duplicacion-reglas-globales.md +182 -182
  204. package/reglas/skills-estandar.md +6 -6
  205. package/reglas/testing.md +7 -7
  206. package/reglas/tests-cleanup.md +224 -224
  207. package/reglas/usar-code-review-graph.md +155 -155
  208. package/reglas/usar-context7.md +226 -226
  209. package/reglas/verificar-citas-normativas.md +548 -548
  210. package/schemas/agent-frontmatter.schema.json +3 -3
  211. package/schemas/agent-message.schema.json +73 -73
  212. package/schemas/agent-output-implementacion.schema.json +114 -114
  213. package/schemas/agent-output-planificacion.schema.json +150 -150
  214. package/schemas/agent-output-review.schema.json +98 -98
  215. package/schemas/diary-entry.schema.json +112 -112
  216. package/schemas/hook-profiles.schema.json +54 -54
  217. package/schemas/hooks-config.schema.json +89 -89
  218. package/schemas/instinct.schema.json +161 -152
  219. package/schemas/modulos.schema.json +38 -38
  220. package/schemas/perfiles.schema.json +36 -36
  221. package/schemas/plugin.schema.json +77 -77
  222. package/schemas/skill-evals.schema.json +119 -119
  223. package/schemas/skill-frontmatter.schema.json +245 -245
  224. package/scripts/audit-tools/audit-history.js +330 -330
  225. package/scripts/audit-tools/bundle-tracker.js +290 -290
  226. package/scripts/audit-tools/canary-monitor.js +352 -352
  227. package/scripts/audit-tools/code-profiler.js +605 -605
  228. package/scripts/audit-tools/dep-doctor.js +320 -320
  229. package/scripts/audit-tools/env-validator.js +206 -206
  230. package/scripts/audit-tools/lib/fs-walk.js +48 -48
  231. package/scripts/audit-tools/lib/output.js +23 -23
  232. package/scripts/audit-tools/migration-checker.js +392 -392
  233. package/scripts/audit-tools/pentest-scanner.js +1436 -1436
  234. package/scripts/benchmark-memoria.js +167 -167
  235. package/scripts/bootstrap-instintos.js +25 -7
  236. package/scripts/cli/aprobar-plan.js +73 -73
  237. package/scripts/cli/briefing.js +23 -23
  238. package/scripts/cli/ciclo-evolucion.js +26 -26
  239. package/scripts/cli/configurar-ci.js +40 -40
  240. package/scripts/cli/derivar-feature-list.js +25 -25
  241. package/scripts/cli/detectar-host.js +27 -27
  242. package/scripts/cli/diary-entry.js +69 -69
  243. package/scripts/cli/execution-state.js +18 -18
  244. package/scripts/cli/gateway-notify.js +41 -41
  245. package/scripts/cli/liberar-fase.js +42 -42
  246. package/scripts/cli/loop-telemetry.js +125 -125
  247. package/scripts/cli/mark-evolved.js +56 -56
  248. package/scripts/cli/metricas-dora.js +26 -26
  249. package/scripts/cli/near-duplicate.js +55 -55
  250. package/scripts/cli/notificaciones.js +123 -123
  251. package/scripts/cli/propose-step.js +29 -29
  252. package/scripts/cli/schedule-parse.js +19 -19
  253. package/scripts/cli/sugerir-modelo.js +20 -20
  254. package/scripts/cli/verificar-plan.js +36 -36
  255. package/scripts/cli/verificar-trazabilidad.js +35 -35
  256. package/scripts/configurar-branch-protection.js +418 -418
  257. package/scripts/detectar-aprendizajes-duplicados.js +151 -151
  258. package/scripts/field-report.js +199 -199
  259. package/scripts/generar-checklists-consolidados.js +273 -273
  260. package/scripts/generar-matriz-lenguajes.js +271 -271
  261. package/scripts/lib/artefactos-python.js +43 -43
  262. package/scripts/lib/auditar-invocaciones-comandos.js +104 -104
  263. package/scripts/lib/benchmark-metrics.js +160 -160
  264. package/scripts/lib/budget-enforcer.js +252 -252
  265. package/scripts/lib/ci-reader.js +193 -193
  266. package/scripts/lib/claude-sessions.js +1 -0
  267. package/scripts/lib/configurar-ci.js +380 -380
  268. package/scripts/lib/contadores-inventario.js +217 -217
  269. package/scripts/lib/detectar-host-swl.js +175 -175
  270. package/scripts/lib/detectar-stack-detallado.js +307 -307
  271. package/scripts/lib/detector-autoduplicacion-intra-archivo.js +234 -234
  272. package/scripts/lib/detector-reglas-duplicadas.js +220 -220
  273. package/scripts/lib/diary-entry.js +234 -234
  274. package/scripts/lib/eval-metrics-store.js +218 -218
  275. package/scripts/lib/eval-quality.js +171 -171
  276. package/scripts/lib/eval-schemas.js +144 -144
  277. package/scripts/lib/eval-self-correct.js +106 -106
  278. package/scripts/lib/eval-validator.js +185 -185
  279. package/scripts/lib/evidencia-release.js +322 -322
  280. package/scripts/lib/expandir-targets.js +71 -71
  281. package/scripts/lib/gate-hooks-requires.js +249 -249
  282. package/scripts/lib/gate-licencias.js +212 -212
  283. package/scripts/lib/git-metricas.js +257 -257
  284. package/scripts/lib/gitignore-manifest.js +44 -11
  285. package/scripts/lib/jaccard-similarity.js +98 -98
  286. package/scripts/lib/longmemeval-runner.js +125 -125
  287. package/scripts/lib/metricas-dora.js +204 -204
  288. package/scripts/lib/npm-version.js +261 -261
  289. package/scripts/lib/paquetes-conocidos.js +50 -50
  290. package/scripts/lib/plan-lock.js +275 -275
  291. package/scripts/lib/pr-analyzer.js +399 -399
  292. package/scripts/lib/prompt-builder.js +264 -264
  293. package/scripts/lib/reglas-globales-conocidas.json +180 -180
  294. package/scripts/lib/resolver-plan-fase.js +37 -37
  295. package/scripts/lib/rrf-fusion.js +175 -175
  296. package/scripts/lib/schema-version.js +164 -164
  297. package/scripts/lib/scoring-instintos.js +277 -277
  298. package/scripts/lib/semantic-search.js +252 -252
  299. package/scripts/lib/skill-metrics.js +41 -1
  300. package/scripts/lib/toml-merge.js +204 -204
  301. package/scripts/lib/tool-cost-analyzer.js +1 -0
  302. package/scripts/limpiar-artefactos-python.js +131 -131
  303. package/scripts/mcp-server/auth.js +105 -105
  304. package/scripts/mcp-server/cache.js +106 -106
  305. package/scripts/migrar-csv-a-array.js +168 -168
  306. package/scripts/migrar-fase-dominio.js +200 -200
  307. package/scripts/publicar.js +497 -497
  308. package/scripts/run-eval.js +141 -141
  309. package/scripts/tui/componentes/selector-multi.js +189 -189
  310. package/scripts/tui/componentes/selector-unico.js +158 -158
  311. package/scripts/tui/ejecutores.js +375 -375
  312. package/scripts/tui/index.js +162 -162
  313. package/scripts/tui/lib/colores.js +129 -129
  314. package/scripts/tui/lib/render.js +264 -264
  315. package/scripts/tui/lib/teclas.js +113 -113
  316. package/scripts/tui/pantallas/inspect.js +173 -173
  317. package/scripts/tui/pantallas/install-wizard.js +334 -334
  318. package/scripts/tui/pantallas/menu-principal.js +52 -52
  319. package/scripts/tui/pantallas/progreso.js +274 -274
  320. package/scripts/tui/pantallas/resumen.js +132 -132
  321. package/scripts/tui/pantallas/uninstall-wizard.js +208 -208
  322. package/scripts/tui/pantallas/update-wizard.js +232 -232
  323. package/scripts/tui/pantallas/welcome.js +187 -187
  324. package/scripts/validar-userland-vacio.js +110 -110
  325. package/scripts/verificar-trazabilidad.js +329 -298
@@ -1,193 +1,193 @@
1
- 'use strict';
2
-
3
- /**
4
- * ci-reader.js
5
- *
6
- * Métricas DORA dependientes de CI (GitHub Actions vía `gh run list`):
7
- * - change failure rate: runs fallidos / runs completados en la ventana.
8
- * - MTTR (mean/median time to restore): mediana del tiempo de un run fallido
9
- * hasta el siguiente run exitoso.
10
- *
11
- * `gh` es OPCIONAL (D-15-01): si no está instalado, no autenticado, o el repo no
12
- * tiene remoto GitHub, las funciones devuelven `{disponible:false, razon}` SIN
13
- * lanzar. El executor `gh` es inyectable (`opts.ejecutorGh`) para tests sin gh
14
- * real. Funciones puras sobre el array de runs. Entrypoint CLI `--json`.
15
- * Parte de la Fase 15 (ADR-0039).
16
- */
17
-
18
- const { execFileSync } = require('node:child_process');
19
-
20
- const MS_DIA = 24 * 60 * 60 * 1000;
21
- const MS_HORA = 60 * 60 * 1000;
22
- const LIMITE_DEFAULT = 200;
23
-
24
- const CONCLUSIONES_FALLO = new Set(['failure', 'timed_out', 'startup_failure']);
25
- const CONCLUSIONES_EXITO = new Set(['success']);
26
-
27
- const GH_MAX_BUFFER = 8 * 1024 * 1024; // 8 MiB
28
- const GH_TIMEOUT_MS = 8000; // gh puede tardar por red; degrada si excede (H-04)
29
-
30
- /** Executor real de gh. Lanza si gh no está disponible/autenticado. */
31
- function ejecutorGhReal(args) {
32
- return execFileSync('gh', args, {
33
- encoding: 'utf8',
34
- stdio: ['ignore', 'pipe', 'pipe'],
35
- maxBuffer: GH_MAX_BUFFER,
36
- timeout: GH_TIMEOUT_MS,
37
- });
38
- }
39
-
40
- /** Categoriza el fallo de gh sin filtrar e.message crudo a logs/persistencia (H-03). */
41
- function _razonGh(e) {
42
- if (e && e.code === 'ENOENT') return 'gh no instalado';
43
- if (e && e.killed && e.signal) return 'gh excedió el timeout';
44
- return 'gh no disponible o sin acceso al repo';
45
- }
46
-
47
- /**
48
- * Obtiene los runs de CI. Degrada sin lanzar.
49
- * @returns {{disponible:boolean, runs?:Array, razon?:string}}
50
- */
51
- function obtenerRuns(opts = {}) {
52
- const { ejecutorGh = ejecutorGhReal, limite = LIMITE_DEFAULT, rama } = opts;
53
- let salida;
54
- try {
55
- salida = ejecutorGh([
56
- 'run', 'list',
57
- '--json', 'databaseId,conclusion,createdAt,updatedAt,headBranch,workflowName',
58
- '--limit', String(limite),
59
- ]);
60
- } catch (e) {
61
- return { disponible: false, razon: _razonGh(e) };
62
- }
63
- let runs;
64
- try {
65
- runs = JSON.parse(salida);
66
- } catch {
67
- return { disponible: false, razon: 'salida de gh no es JSON válido' };
68
- }
69
- if (!Array.isArray(runs)) return { disponible: false, razon: 'salida de gh inesperada' };
70
- if (rama) runs = runs.filter((r) => r && r.headBranch === rama);
71
- return { disponible: true, runs };
72
- }
73
-
74
- function _runsEnVentana(runs, ventanaDias, hoy) {
75
- const desde = new Date(hoy.getTime() - ventanaDias * MS_DIA).getTime();
76
- const hasta = hoy.getTime();
77
- return runs.filter((r) => {
78
- const t = Date.parse(r && r.createdAt);
79
- return Number.isFinite(t) && t >= desde && t <= hasta;
80
- });
81
- }
82
-
83
- function _mediana(valoresOrdenados) {
84
- const n = valoresOrdenados.length;
85
- if (n === 0) return null;
86
- const mid = Math.floor(n / 2);
87
- return n % 2 ? valoresOrdenados[mid] : (valoresOrdenados[mid - 1] + valoresOrdenados[mid]) / 2;
88
- }
89
-
90
- /**
91
- * Change failure rate en la ventana.
92
- * @returns {{disponible:boolean, cfr?:number, totalRuns?:number, fallidos?:number,
93
- * sinDatos?:boolean, razon?:string}}
94
- */
95
- function changeFailureRate(opts = {}) {
96
- const { ventanaDias = 30, hoy = new Date() } = opts;
97
- const base = opts.runs ? { disponible: true, runs: opts.runs } : obtenerRuns(opts);
98
- if (!base.disponible) return { disponible: false, razon: base.razon };
99
-
100
- const enVentana = _runsEnVentana(base.runs, ventanaDias, hoy);
101
- const completados = enVentana.filter(
102
- (r) => CONCLUSIONES_EXITO.has(r.conclusion) || CONCLUSIONES_FALLO.has(r.conclusion)
103
- );
104
- if (completados.length === 0) {
105
- return { disponible: true, sinDatos: true, totalRuns: 0, fallidos: 0, cfr: 0 };
106
- }
107
- const fallidos = completados.filter((r) => CONCLUSIONES_FALLO.has(r.conclusion)).length;
108
- return {
109
- disponible: true,
110
- sinDatos: false,
111
- totalRuns: completados.length,
112
- fallidos,
113
- cfr: fallidos / completados.length,
114
- };
115
- }
116
-
117
- /**
118
- * MTTR: mediana del tiempo de un run fallido hasta el siguiente run exitoso.
119
- * @returns {{disponible:boolean, mttrHoras?:number, recuperaciones?:number,
120
- * sinDatos?:boolean, razon?:string}}
121
- */
122
- function meanTimeToRestore(opts = {}) {
123
- const { ventanaDias = 30, hoy = new Date() } = opts;
124
- const base = opts.runs ? { disponible: true, runs: opts.runs } : obtenerRuns(opts);
125
- if (!base.disponible) return { disponible: false, razon: base.razon };
126
-
127
- const enVentana = _runsEnVentana(base.runs, ventanaDias, hoy)
128
- .filter((r) => CONCLUSIONES_EXITO.has(r.conclusion) || CONCLUSIONES_FALLO.has(r.conclusion))
129
- .map((r) => ({
130
- fallo: CONCLUSIONES_FALLO.has(r.conclusion),
131
- detectado: Date.parse(r.updatedAt || r.createdAt),
132
- }))
133
- .filter((r) => Number.isFinite(r.detectado))
134
- .sort((a, b) => a.detectado - b.detectado);
135
-
136
- const recuperaciones = [];
137
- for (let i = 0; i < enVentana.length; i++) {
138
- if (!enVentana[i].fallo) continue;
139
- const exito = enVentana.slice(i + 1).find((r) => !r.fallo);
140
- if (exito) {
141
- const h = (exito.detectado - enVentana[i].detectado) / MS_HORA;
142
- if (h >= 0) recuperaciones.push(h);
143
- }
144
- }
145
- recuperaciones.sort((a, b) => a - b);
146
- if (recuperaciones.length === 0) {
147
- return { disponible: true, sinDatos: true, recuperaciones: 0, mttrHoras: null };
148
- }
149
- return {
150
- disponible: true,
151
- sinDatos: false,
152
- recuperaciones: recuperaciones.length,
153
- mttrHoras: _mediana(recuperaciones),
154
- };
155
- }
156
-
157
- module.exports = {
158
- obtenerRuns,
159
- changeFailureRate,
160
- meanTimeToRestore,
161
- ejecutorGhReal,
162
- CONCLUSIONES_FALLO,
163
- CONCLUSIONES_EXITO,
164
- };
165
-
166
- // Entrypoint CLI: node scripts/lib/ci-reader.js [--json] [--dias=N]
167
- if (!require.main || require.main === module) {
168
- const args = process.argv.slice(2);
169
- const json = args.includes('--json');
170
- const diasArg = args.find((a) => a.startsWith('--dias='));
171
- const ventanaDias = Math.max(1, Math.min(365, (diasArg ? parseInt(diasArg.slice('--dias='.length), 10) : 30) || 30));
172
-
173
- // Una sola llamada a gh; si no está disponible, no se re-intenta.
174
- const base = obtenerRuns({ limite: LIMITE_DEFAULT });
175
- let out;
176
- if (!base.disponible) {
177
- out = { disponible: false, razon: base.razon };
178
- } else {
179
- const cfr = changeFailureRate({ ventanaDias, runs: base.runs });
180
- const mttr = meanTimeToRestore({ ventanaDias, runs: base.runs });
181
- out = { ventana_dias: ventanaDias, changeFailureRate: cfr, mttr };
182
- }
183
-
184
- if (json) {
185
- process.stdout.write(JSON.stringify(out, null, 2) + '\n');
186
- } else if (!base.disponible) {
187
- process.stdout.write(`CI no disponible: ${base.razon}\n`);
188
- } else {
189
- process.stdout.write(`Change failure rate: ${out.changeFailureRate.sinDatos ? 'sin datos' : (out.changeFailureRate.cfr * 100).toFixed(1) + '%'}\n`);
190
- process.stdout.write(`MTTR: ${out.mttr.sinDatos ? 'sin datos' : out.mttr.mttrHoras.toFixed(1) + 'h'}\n`);
191
- }
192
- process.exit(0);
193
- }
1
+ 'use strict';
2
+
3
+ /**
4
+ * ci-reader.js
5
+ *
6
+ * Métricas DORA dependientes de CI (GitHub Actions vía `gh run list`):
7
+ * - change failure rate: runs fallidos / runs completados en la ventana.
8
+ * - MTTR (mean/median time to restore): mediana del tiempo de un run fallido
9
+ * hasta el siguiente run exitoso.
10
+ *
11
+ * `gh` es OPCIONAL (D-15-01): si no está instalado, no autenticado, o el repo no
12
+ * tiene remoto GitHub, las funciones devuelven `{disponible:false, razon}` SIN
13
+ * lanzar. El executor `gh` es inyectable (`opts.ejecutorGh`) para tests sin gh
14
+ * real. Funciones puras sobre el array de runs. Entrypoint CLI `--json`.
15
+ * Parte de la Fase 15 (ADR-0039).
16
+ */
17
+
18
+ const { execFileSync } = require('node:child_process');
19
+
20
+ const MS_DIA = 24 * 60 * 60 * 1000;
21
+ const MS_HORA = 60 * 60 * 1000;
22
+ const LIMITE_DEFAULT = 200;
23
+
24
+ const CONCLUSIONES_FALLO = new Set(['failure', 'timed_out', 'startup_failure']);
25
+ const CONCLUSIONES_EXITO = new Set(['success']);
26
+
27
+ const GH_MAX_BUFFER = 8 * 1024 * 1024; // 8 MiB
28
+ const GH_TIMEOUT_MS = 8000; // gh puede tardar por red; degrada si excede (H-04)
29
+
30
+ /** Executor real de gh. Lanza si gh no está disponible/autenticado. */
31
+ function ejecutorGhReal(args) {
32
+ return execFileSync('gh', args, {
33
+ encoding: 'utf8',
34
+ stdio: ['ignore', 'pipe', 'pipe'],
35
+ maxBuffer: GH_MAX_BUFFER,
36
+ timeout: GH_TIMEOUT_MS,
37
+ });
38
+ }
39
+
40
+ /** Categoriza el fallo de gh sin filtrar e.message crudo a logs/persistencia (H-03). */
41
+ function _razonGh(e) {
42
+ if (e && e.code === 'ENOENT') return 'gh no instalado';
43
+ if (e && e.killed && e.signal) return 'gh excedió el timeout';
44
+ return 'gh no disponible o sin acceso al repo';
45
+ }
46
+
47
+ /**
48
+ * Obtiene los runs de CI. Degrada sin lanzar.
49
+ * @returns {{disponible:boolean, runs?:Array, razon?:string}}
50
+ */
51
+ function obtenerRuns(opts = {}) {
52
+ const { ejecutorGh = ejecutorGhReal, limite = LIMITE_DEFAULT, rama } = opts;
53
+ let salida;
54
+ try {
55
+ salida = ejecutorGh([
56
+ 'run', 'list',
57
+ '--json', 'databaseId,conclusion,createdAt,updatedAt,headBranch,workflowName',
58
+ '--limit', String(limite),
59
+ ]);
60
+ } catch (e) {
61
+ return { disponible: false, razon: _razonGh(e) };
62
+ }
63
+ let runs;
64
+ try {
65
+ runs = JSON.parse(salida);
66
+ } catch {
67
+ return { disponible: false, razon: 'salida de gh no es JSON válido' };
68
+ }
69
+ if (!Array.isArray(runs)) return { disponible: false, razon: 'salida de gh inesperada' };
70
+ if (rama) runs = runs.filter((r) => r && r.headBranch === rama);
71
+ return { disponible: true, runs };
72
+ }
73
+
74
+ function _runsEnVentana(runs, ventanaDias, hoy) {
75
+ const desde = new Date(hoy.getTime() - ventanaDias * MS_DIA).getTime();
76
+ const hasta = hoy.getTime();
77
+ return runs.filter((r) => {
78
+ const t = Date.parse(r && r.createdAt);
79
+ return Number.isFinite(t) && t >= desde && t <= hasta;
80
+ });
81
+ }
82
+
83
+ function _mediana(valoresOrdenados) {
84
+ const n = valoresOrdenados.length;
85
+ if (n === 0) return null;
86
+ const mid = Math.floor(n / 2);
87
+ return n % 2 ? valoresOrdenados[mid] : (valoresOrdenados[mid - 1] + valoresOrdenados[mid]) / 2;
88
+ }
89
+
90
+ /**
91
+ * Change failure rate en la ventana.
92
+ * @returns {{disponible:boolean, cfr?:number, totalRuns?:number, fallidos?:number,
93
+ * sinDatos?:boolean, razon?:string}}
94
+ */
95
+ function changeFailureRate(opts = {}) {
96
+ const { ventanaDias = 30, hoy = new Date() } = opts;
97
+ const base = opts.runs ? { disponible: true, runs: opts.runs } : obtenerRuns(opts);
98
+ if (!base.disponible) return { disponible: false, razon: base.razon };
99
+
100
+ const enVentana = _runsEnVentana(base.runs, ventanaDias, hoy);
101
+ const completados = enVentana.filter(
102
+ (r) => CONCLUSIONES_EXITO.has(r.conclusion) || CONCLUSIONES_FALLO.has(r.conclusion)
103
+ );
104
+ if (completados.length === 0) {
105
+ return { disponible: true, sinDatos: true, totalRuns: 0, fallidos: 0, cfr: 0 };
106
+ }
107
+ const fallidos = completados.filter((r) => CONCLUSIONES_FALLO.has(r.conclusion)).length;
108
+ return {
109
+ disponible: true,
110
+ sinDatos: false,
111
+ totalRuns: completados.length,
112
+ fallidos,
113
+ cfr: fallidos / completados.length,
114
+ };
115
+ }
116
+
117
+ /**
118
+ * MTTR: mediana del tiempo de un run fallido hasta el siguiente run exitoso.
119
+ * @returns {{disponible:boolean, mttrHoras?:number, recuperaciones?:number,
120
+ * sinDatos?:boolean, razon?:string}}
121
+ */
122
+ function meanTimeToRestore(opts = {}) {
123
+ const { ventanaDias = 30, hoy = new Date() } = opts;
124
+ const base = opts.runs ? { disponible: true, runs: opts.runs } : obtenerRuns(opts);
125
+ if (!base.disponible) return { disponible: false, razon: base.razon };
126
+
127
+ const enVentana = _runsEnVentana(base.runs, ventanaDias, hoy)
128
+ .filter((r) => CONCLUSIONES_EXITO.has(r.conclusion) || CONCLUSIONES_FALLO.has(r.conclusion))
129
+ .map((r) => ({
130
+ fallo: CONCLUSIONES_FALLO.has(r.conclusion),
131
+ detectado: Date.parse(r.updatedAt || r.createdAt),
132
+ }))
133
+ .filter((r) => Number.isFinite(r.detectado))
134
+ .sort((a, b) => a.detectado - b.detectado);
135
+
136
+ const recuperaciones = [];
137
+ for (let i = 0; i < enVentana.length; i++) {
138
+ if (!enVentana[i].fallo) continue;
139
+ const exito = enVentana.slice(i + 1).find((r) => !r.fallo);
140
+ if (exito) {
141
+ const h = (exito.detectado - enVentana[i].detectado) / MS_HORA;
142
+ if (h >= 0) recuperaciones.push(h);
143
+ }
144
+ }
145
+ recuperaciones.sort((a, b) => a - b);
146
+ if (recuperaciones.length === 0) {
147
+ return { disponible: true, sinDatos: true, recuperaciones: 0, mttrHoras: null };
148
+ }
149
+ return {
150
+ disponible: true,
151
+ sinDatos: false,
152
+ recuperaciones: recuperaciones.length,
153
+ mttrHoras: _mediana(recuperaciones),
154
+ };
155
+ }
156
+
157
+ module.exports = {
158
+ obtenerRuns,
159
+ changeFailureRate,
160
+ meanTimeToRestore,
161
+ ejecutorGhReal,
162
+ CONCLUSIONES_FALLO,
163
+ CONCLUSIONES_EXITO,
164
+ };
165
+
166
+ // Entrypoint CLI: node scripts/lib/ci-reader.js [--json] [--dias=N]
167
+ if (!require.main || require.main === module) {
168
+ const args = process.argv.slice(2);
169
+ const json = args.includes('--json');
170
+ const diasArg = args.find((a) => a.startsWith('--dias='));
171
+ const ventanaDias = Math.max(1, Math.min(365, (diasArg ? parseInt(diasArg.slice('--dias='.length), 10) : 30) || 30));
172
+
173
+ // Una sola llamada a gh; si no está disponible, no se re-intenta.
174
+ const base = obtenerRuns({ limite: LIMITE_DEFAULT });
175
+ let out;
176
+ if (!base.disponible) {
177
+ out = { disponible: false, razon: base.razon };
178
+ } else {
179
+ const cfr = changeFailureRate({ ventanaDias, runs: base.runs });
180
+ const mttr = meanTimeToRestore({ ventanaDias, runs: base.runs });
181
+ out = { ventana_dias: ventanaDias, changeFailureRate: cfr, mttr };
182
+ }
183
+
184
+ if (json) {
185
+ process.stdout.write(JSON.stringify(out, null, 2) + '\n');
186
+ } else if (!base.disponible) {
187
+ process.stdout.write(`CI no disponible: ${base.razon}\n`);
188
+ } else {
189
+ process.stdout.write(`Change failure rate: ${out.changeFailureRate.sinDatos ? 'sin datos' : (out.changeFailureRate.cfr * 100).toFixed(1) + '%'}\n`);
190
+ process.stdout.write(`MTTR: ${out.mttr.sinDatos ? 'sin datos' : out.mttr.mttrHoras.toFixed(1) + 'h'}\n`);
191
+ }
192
+ process.exit(0);
193
+ }
@@ -30,6 +30,7 @@ const PRECIOS_MODELO = {
30
30
  'claude-opus-4-8': { entrada: 15 / 1_000_000, salida: 75 / 1_000_000 },
31
31
  'claude-opus-4-7': { entrada: 15 / 1_000_000, salida: 75 / 1_000_000 },
32
32
  'claude-opus-4-6': { entrada: 15 / 1_000_000, salida: 75 / 1_000_000 },
33
+ 'claude-sonnet-5': { entrada: 3 / 1_000_000, salida: 15 / 1_000_000 },
33
34
  'claude-sonnet-4-6': { entrada: 3 / 1_000_000, salida: 15 / 1_000_000 },
34
35
  'claude-sonnet-4-5': { entrada: 3 / 1_000_000, salida: 15 / 1_000_000 },
35
36
  'claude-haiku-4-5': { entrada: 0.8 / 1_000_000, salida: 4 / 1_000_000 },