@saulwade/swl-ses 2.3.0 → 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.
- package/CLAUDE.md +47 -6
- package/README.md +1 -1
- package/agentes/accesibilidad-wcag-swl.md +690 -690
- package/agentes/arquitecto-swl.md +267 -267
- package/agentes/auto-evolucion-swl.md +908 -908
- package/agentes/backend-api-swl.md +472 -472
- package/agentes/backend-csharp-swl.md +420 -420
- package/agentes/backend-go-swl.md +390 -390
- package/agentes/backend-java-swl.md +281 -281
- package/agentes/backend-node-swl.md +479 -479
- package/agentes/backend-python-swl.md +605 -605
- package/agentes/backend-rust-swl.md +364 -364
- package/agentes/backend-workers-swl.md +482 -482
- package/agentes/cloud-infra-swl.md +509 -509
- package/agentes/consolidador-swl.md +541 -541
- package/agentes/datos-swl.md +605 -605
- package/agentes/depurador-swl.md +352 -352
- package/agentes/devops-ci-swl.md +400 -400
- package/agentes/disenador-ui-swl.md +569 -569
- package/agentes/documentador-swl.md +345 -345
- package/agentes/frontend-angular-swl.md +621 -621
- package/agentes/frontend-css-swl.md +716 -716
- package/agentes/frontend-react-swl.md +692 -692
- package/agentes/frontend-swl.md +496 -496
- package/agentes/frontend-tailwind-swl.md +826 -826
- package/agentes/gh-fix-ci-swl.md +2 -2
- package/agentes/implementador-swl.md +328 -328
- package/agentes/investigador-swl.md +432 -432
- package/agentes/investigador-ux-swl.md +505 -505
- package/agentes/llm-apps-swl.md +278 -278
- package/agentes/migrador-swl.md +442 -442
- package/agentes/mobile-android-swl.md +511 -511
- package/agentes/mobile-cross-swl.md +541 -541
- package/agentes/mobile-ios-swl.md +502 -502
- package/agentes/mobile-testing-swl.md +302 -302
- package/agentes/nemesis-auditor-swl.md +285 -285
- package/agentes/notificador-swl.md +918 -918
- package/agentes/observabilidad-swl.md +438 -438
- package/agentes/orquestador-swl.md +1026 -1026
- package/agentes/pagos-swl.md +310 -310
- package/agentes/perfilador-usuario-swl.md +321 -321
- package/agentes/planificador-swl.md +399 -399
- package/agentes/producto-prd-swl.md +589 -589
- package/agentes/red-team-swl.md +1 -1
- package/agentes/release-manager-swl.md +590 -590
- package/agentes/rendimiento-swl.md +713 -713
- package/agentes/resolutor-build-swl.md +245 -245
- package/agentes/revisor-angular-swl.md +278 -278
- package/agentes/revisor-codigo-swl.md +505 -505
- package/agentes/revisor-csharp-swl.md +264 -264
- package/agentes/revisor-go-swl.md +259 -259
- package/agentes/revisor-java-swl.md +257 -257
- package/agentes/revisor-kotlin-swl.md +273 -273
- package/agentes/revisor-nextjs-swl.md +281 -281
- package/agentes/revisor-php-swl.md +271 -271
- package/agentes/revisor-react-swl.md +278 -278
- package/agentes/revisor-rust-swl.md +346 -346
- package/agentes/revisor-seguridad-swl.md +399 -399
- package/agentes/revisor-swift-swl.md +268 -268
- package/agentes/revisor-typescript-swl.md +346 -346
- package/agentes/sre-swl.md +291 -291
- package/agentes/tdd-qa-swl.md +393 -393
- package/comandos/swl/briefing.md +119 -119
- package/comandos/swl/contribuir.md +233 -233
- package/comandos/swl/predecir.md +139 -139
- package/comandos/swl/sesiones.md +1 -1
- package/gateway/agent-executor.js +1 -1
- package/gateway/lib/event-channel.js +191 -191
- package/habilidades/agent-deep-links/SKILL.md +148 -148
- package/habilidades/agentes-como-servicio/SKILL.md +2 -2
- package/habilidades/angular-moderno/SKILL.md +20 -1
- package/habilidades/auto-evolucion-protocolo/SKILL.md +276 -276
- package/habilidades/backend-async-postgres-testing/SKILL.md +215 -215
- package/habilidades/backend-error-design/SKILL.md +221 -221
- package/habilidades/backend-production-resilience/SKILL.md +288 -288
- package/habilidades/benchmark-memoria/SKILL.md +186 -186
- package/habilidades/calidad-anti-patrones-universales/SKILL.md +368 -368
- package/habilidades/calidad-contract-testing/SKILL.md +165 -165
- package/habilidades/calidad-mutation-testing/SKILL.md +170 -170
- package/habilidades/changelog-generator/scripts/parse-commits.js +367 -367
- package/habilidades/checklist-seguridad/recursos/stride-cobertura.md +60 -60
- package/habilidades/diagrama-arquitectura/assets/template.html +276 -276
- package/habilidades/doubt-driven-review/recursos/EXAMPLES.md +130 -130
- package/habilidades/drift-detection/SKILL.md +179 -179
- package/habilidades/ejecutar-task-iterativo/SKILL.md +278 -278
- package/habilidades/estructura-proyecto-claude/recursos/frontmatter-y-hooks-referencia.md +1 -1
- package/habilidades/estructura-proyecto-claude/recursos/mcp-json-template.json +57 -57
- package/habilidades/eval-framework/SKILL.md +212 -212
- package/habilidades/feynman-auditor-swl/recursos/preguntas-language-agnostic.md +108 -108
- package/habilidades/harness-claude-code/recursos/disciplina-harness-regla.md +252 -252
- package/habilidades/legacy-code-rescue/SKILL.md +267 -267
- package/habilidades/meta-skills-estandar/recursos/convencion-examples.md +93 -93
- package/habilidades/patrones-python/recursos/patrones-avanzados.md +469 -469
- package/habilidades/perfil-usuario/SKILL.md +200 -200
- package/habilidades/prevencion-sobreingenieria/recursos/EXAMPLES.md +580 -580
- package/habilidades/proceso-ddia-fundamentos/SKILL.md +255 -255
- package/habilidades/proceso-ddia-streaming/SKILL.md +231 -231
- package/habilidades/proceso-debate-adversarial/recursos/personas.md +105 -105
- package/habilidades/proceso-discovery-machote/SKILL.md +157 -157
- package/habilidades/proceso-dynamic-workflows/SKILL.md +138 -138
- package/habilidades/proceso-dynamic-workflows/recursos/template-adversarial-verify.js +65 -65
- package/habilidades/proceso-dynamic-workflows/recursos/template-triage.js +65 -65
- package/habilidades/proceso-intent-engineering/SKILL.md +269 -269
- package/habilidades/proceso-modular-split/SKILL.md +256 -256
- package/habilidades/prompt-engineering/recursos/patrones-avanzados.md +2 -2
- package/habilidades/state-inconsistency-auditor-swl/recursos/coupled-state-patterns.md +147 -147
- package/habilidades/structured-outputs/SKILL.md +2 -2
- package/habilidades/swl-claudemd/recursos/contrato-aprender.md +83 -83
- package/habilidades/swl-claudemd/recursos/duplicacion-reglas-globales.md +85 -85
- package/habilidades/swl-claudemd/recursos/plantillas-init.md +94 -94
- package/habilidades/swl-dashboard/SKILL.md +2 -2
- package/habilidades/tdd-workflow/recursos/gherkin-bdd.md +111 -111
- package/habilidades/validacion-ci-sistema/recursos/validadores-completos.md +1 -1
- package/habilidades/validacion-ci-sistema/scripts/validar-sistema.sh +1 -1
- package/hooks/ciclo-evolucion-subagente.js +26 -26
- package/hooks/ciclo-evolucion.js +26 -26
- package/hooks/claudemd-bloat-detector.js +161 -161
- package/hooks/claudemd-duplicacion-detector.js +170 -170
- package/hooks/contexto-iteracion.js +144 -144
- package/hooks/guardrail-modelo.js +1 -1
- package/hooks/lib/agent-routing.js +107 -107
- package/hooks/lib/auto-consolidator.js +335 -335
- package/hooks/lib/autonomia.js +208 -208
- package/hooks/lib/ciclo-evolucion.js +47 -47
- package/hooks/lib/deep-links.js +185 -185
- package/hooks/lib/error-classifier.js +308 -308
- package/hooks/lib/etapa-auto-evolucion.js +701 -701
- package/hooks/lib/etapa-metricas.js +388 -388
- package/hooks/lib/etapa-perfil-usuario.js +376 -376
- package/hooks/lib/loop-telemetry.js +321 -321
- package/hooks/lib/merkle-audit.js +96 -96
- package/hooks/lib/model-router.js +2 -2
- package/hooks/lib/propose-step.js +358 -358
- package/hooks/lib/provenance-tracker.js +191 -191
- package/hooks/lib/rate-limit-tracker.js +253 -253
- package/hooks/lib/resource-quota.js +122 -122
- package/hooks/lib/retry-jitter.js +165 -165
- package/hooks/lib/security-net.js +201 -201
- package/hooks/lib/skill-auditor.js +588 -588
- package/hooks/lib/sync-status.js +228 -228
- package/hooks/lib/taint-tracker.js +107 -107
- package/hooks/lib/text-similarity.js +241 -241
- package/hooks/lib/token-estimator.js +1 -0
- package/hooks/lib/toon-compressor.js +245 -245
- package/hooks/lib/usage-model.js +1 -1
- package/hooks/linea-estado.js +2 -0
- package/hooks/registro-turnos.js +209 -209
- package/hooks/session-briefing.js +98 -98
- package/hooks/spec-gate.js +211 -211
- package/hooks/sugerir-regenerar-inventario.js +170 -170
- package/hooks/tdd-gate.js +241 -241
- package/hooks/telemetria-skill-routing.js +100 -100
- package/hooks/validar-formato-post-subagente.js +140 -140
- package/hooks/validar-intent-spec.js +242 -242
- package/hooks/validar-memoria-hook.js +218 -218
- package/hooks/validar-planning-paths.js +134 -134
- package/instintos/autonomia.yaml +27 -27
- package/instintos/prompt-appendices.yaml +57 -57
- package/llms.txt +29 -29
- package/manifiestos/agent-output-schemas.json +57 -57
- package/manifiestos/canonical-hashes.json +2291 -1964
- package/manifiestos/planning-paths.json +44 -44
- package/manifiestos/skills-lock.json +1282 -1282
- package/package.json +1 -1
- package/plantillas/auditor-veto-template.md +105 -105
- package/plantillas/github-workflows/README.md +47 -47
- package/plantillas/github-workflows/release-please.yml +44 -44
- package/plantillas/github-workflows/swl-ci.yml +107 -107
- package/plantillas/github-workflows/swl-security.yml +51 -51
- package/plugin.json +1 -1
- package/reglas/accesibilidad.md +10 -10
- package/reglas/analisis-previo-tareas-grandes.md +172 -172
- package/reglas/api-diseno.md +9 -9
- package/reglas/arreglar-al-detectar.md +240 -240
- package/reglas/auditorias-documentales-estructurales.md +7 -7
- package/reglas/cloud-infra.md +8 -8
- package/reglas/consultar-vault-primero.md +195 -195
- package/reglas/debatir-antes-de-aceptar.md +158 -158
- package/reglas/fragmentos-compartidos.md +183 -183
- package/reglas/hooks.md +6 -6
- package/reglas/intent-engineering.md +218 -218
- package/reglas/markitdown.md +8 -8
- package/reglas/monitor-ci.md +309 -309
- package/reglas/patrones.md +6 -6
- package/reglas/sesiones-paralelas.md +180 -180
- package/reglas/sin-duplicacion-reglas-globales.md +182 -182
- package/reglas/skills-estandar.md +6 -6
- package/reglas/testing.md +7 -7
- package/reglas/tests-cleanup.md +224 -224
- package/reglas/usar-code-review-graph.md +155 -155
- package/reglas/usar-context7.md +226 -226
- package/reglas/verificar-citas-normativas.md +548 -548
- package/schemas/agent-frontmatter.schema.json +3 -3
- package/schemas/agent-message.schema.json +73 -73
- package/schemas/agent-output-implementacion.schema.json +114 -114
- package/schemas/agent-output-planificacion.schema.json +150 -150
- package/schemas/agent-output-review.schema.json +98 -98
- package/schemas/diary-entry.schema.json +112 -112
- package/schemas/hook-profiles.schema.json +54 -54
- package/schemas/hooks-config.schema.json +89 -89
- package/schemas/modulos.schema.json +38 -38
- package/schemas/perfiles.schema.json +36 -36
- package/schemas/plugin.schema.json +77 -77
- package/schemas/skill-evals.schema.json +119 -119
- package/schemas/skill-frontmatter.schema.json +245 -245
- package/scripts/audit-tools/audit-history.js +330 -330
- package/scripts/audit-tools/bundle-tracker.js +290 -290
- package/scripts/audit-tools/canary-monitor.js +352 -352
- package/scripts/audit-tools/code-profiler.js +605 -605
- package/scripts/audit-tools/dep-doctor.js +320 -320
- package/scripts/audit-tools/env-validator.js +206 -206
- package/scripts/audit-tools/lib/fs-walk.js +48 -48
- package/scripts/audit-tools/lib/output.js +23 -23
- package/scripts/audit-tools/migration-checker.js +392 -392
- package/scripts/audit-tools/pentest-scanner.js +1436 -1436
- package/scripts/benchmark-memoria.js +167 -167
- package/scripts/cli/aprobar-plan.js +73 -73
- package/scripts/cli/briefing.js +23 -23
- package/scripts/cli/ciclo-evolucion.js +26 -26
- package/scripts/cli/configurar-ci.js +40 -40
- package/scripts/cli/derivar-feature-list.js +25 -25
- package/scripts/cli/detectar-host.js +27 -27
- package/scripts/cli/diary-entry.js +69 -69
- package/scripts/cli/execution-state.js +18 -18
- package/scripts/cli/gateway-notify.js +41 -41
- package/scripts/cli/liberar-fase.js +42 -42
- package/scripts/cli/loop-telemetry.js +125 -125
- package/scripts/cli/mark-evolved.js +56 -56
- package/scripts/cli/metricas-dora.js +26 -26
- package/scripts/cli/near-duplicate.js +55 -55
- package/scripts/cli/notificaciones.js +123 -123
- package/scripts/cli/propose-step.js +29 -29
- package/scripts/cli/schedule-parse.js +19 -19
- package/scripts/cli/sugerir-modelo.js +20 -20
- package/scripts/cli/verificar-plan.js +36 -36
- package/scripts/cli/verificar-trazabilidad.js +35 -35
- package/scripts/configurar-branch-protection.js +418 -418
- package/scripts/detectar-aprendizajes-duplicados.js +151 -151
- package/scripts/field-report.js +199 -199
- package/scripts/generar-checklists-consolidados.js +273 -273
- package/scripts/generar-matriz-lenguajes.js +271 -271
- package/scripts/lib/artefactos-python.js +43 -43
- package/scripts/lib/auditar-invocaciones-comandos.js +104 -104
- package/scripts/lib/benchmark-metrics.js +160 -160
- package/scripts/lib/budget-enforcer.js +252 -252
- package/scripts/lib/ci-reader.js +193 -193
- package/scripts/lib/claude-sessions.js +1 -0
- package/scripts/lib/configurar-ci.js +380 -380
- package/scripts/lib/contadores-inventario.js +217 -217
- package/scripts/lib/detectar-host-swl.js +175 -175
- package/scripts/lib/detectar-stack-detallado.js +307 -307
- package/scripts/lib/detector-autoduplicacion-intra-archivo.js +234 -234
- package/scripts/lib/detector-reglas-duplicadas.js +220 -220
- package/scripts/lib/diary-entry.js +234 -234
- package/scripts/lib/eval-metrics-store.js +218 -218
- package/scripts/lib/eval-quality.js +171 -171
- package/scripts/lib/eval-schemas.js +144 -144
- package/scripts/lib/eval-self-correct.js +106 -106
- package/scripts/lib/eval-validator.js +185 -185
- package/scripts/lib/evidencia-release.js +322 -322
- package/scripts/lib/expandir-targets.js +71 -71
- package/scripts/lib/gate-hooks-requires.js +249 -249
- package/scripts/lib/gate-licencias.js +212 -212
- package/scripts/lib/git-metricas.js +257 -257
- package/scripts/lib/jaccard-similarity.js +98 -98
- package/scripts/lib/longmemeval-runner.js +125 -125
- package/scripts/lib/metricas-dora.js +204 -204
- package/scripts/lib/npm-version.js +261 -261
- package/scripts/lib/paquetes-conocidos.js +50 -50
- package/scripts/lib/plan-lock.js +275 -275
- package/scripts/lib/pr-analyzer.js +399 -399
- package/scripts/lib/prompt-builder.js +264 -264
- package/scripts/lib/reglas-globales-conocidas.json +180 -180
- package/scripts/lib/resolver-plan-fase.js +37 -37
- package/scripts/lib/rrf-fusion.js +175 -175
- package/scripts/lib/schema-version.js +164 -164
- package/scripts/lib/scoring-instintos.js +277 -277
- package/scripts/lib/semantic-search.js +252 -252
- package/scripts/lib/toml-merge.js +204 -204
- package/scripts/lib/tool-cost-analyzer.js +1 -0
- package/scripts/limpiar-artefactos-python.js +131 -131
- package/scripts/mcp-server/auth.js +105 -105
- package/scripts/mcp-server/cache.js +106 -106
- package/scripts/migrar-csv-a-array.js +168 -168
- package/scripts/migrar-fase-dominio.js +200 -200
- package/scripts/publicar.js +497 -497
- package/scripts/run-eval.js +141 -141
- package/scripts/tui/componentes/selector-multi.js +189 -189
- package/scripts/tui/componentes/selector-unico.js +158 -158
- package/scripts/tui/ejecutores.js +375 -375
- package/scripts/tui/index.js +162 -162
- package/scripts/tui/lib/colores.js +129 -129
- package/scripts/tui/lib/render.js +264 -264
- package/scripts/tui/lib/teclas.js +113 -113
- package/scripts/tui/pantallas/inspect.js +173 -173
- package/scripts/tui/pantallas/install-wizard.js +334 -334
- package/scripts/tui/pantallas/menu-principal.js +52 -52
- package/scripts/tui/pantallas/progreso.js +274 -274
- package/scripts/tui/pantallas/resumen.js +132 -132
- package/scripts/tui/pantallas/uninstall-wizard.js +208 -208
- package/scripts/tui/pantallas/update-wizard.js +232 -232
- package/scripts/tui/pantallas/welcome.js +187 -187
- package/scripts/validar-userland-vacio.js +110 -110
package/scripts/lib/ci-reader.js
CHANGED
|
@@ -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 },
|