@saulwade/swl-ses 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CLAUDE.md +238 -0
- package/README.md +560 -0
- package/_userland/agentes/.gitkeep +0 -0
- package/_userland/habilidades/.gitkeep +0 -0
- package/agentes/.evolved.json +9 -0
- package/agentes/accesibilidad-wcag-swl.md +692 -0
- package/agentes/arquitecto-swl.md +238 -0
- package/agentes/auto-evolucion-swl.md +854 -0
- package/agentes/backend-api-swl.md +470 -0
- package/agentes/backend-csharp-swl.md +418 -0
- package/agentes/backend-go-swl.md +388 -0
- package/agentes/backend-java-swl.md +279 -0
- package/agentes/backend-node-swl.md +477 -0
- package/agentes/backend-python-swl.md +608 -0
- package/agentes/backend-rust-swl.md +362 -0
- package/agentes/backend-workers-swl.md +480 -0
- package/agentes/cloud-infra-swl.md +485 -0
- package/agentes/consolidador-swl.md +539 -0
- package/agentes/datos-swl.md +584 -0
- package/agentes/depurador-swl.md +349 -0
- package/agentes/devops-ci-swl.md +374 -0
- package/agentes/disenador-ui-swl.md +558 -0
- package/agentes/documentador-swl.md +343 -0
- package/agentes/evals/arquitecto-swl.evals.json +56 -0
- package/agentes/evals/auto-evolucion-swl.evals.json +68 -0
- package/agentes/evals/implementador-swl.evals.json +56 -0
- package/agentes/evals/orquestador-swl.evals.json +60 -0
- package/agentes/evals/perfilador-usuario-swl.evals.json +60 -0
- package/agentes/evals/red-team-swl.evals.json +59 -0
- package/agentes/evals/revisor-codigo-swl.evals.json +59 -0
- package/agentes/frontend-angular-swl.md +627 -0
- package/agentes/frontend-css-swl.md +720 -0
- package/agentes/frontend-react-swl.md +696 -0
- package/agentes/frontend-swl.md +500 -0
- package/agentes/frontend-tailwind-swl.md +830 -0
- package/agentes/implementador-swl.md +328 -0
- package/agentes/investigador-swl.md +430 -0
- package/agentes/investigador-ux-swl.md +500 -0
- package/agentes/llm-apps-swl.md +276 -0
- package/agentes/migrador-swl.md +417 -0
- package/agentes/mobile-android-swl.md +509 -0
- package/agentes/mobile-cross-swl.md +539 -0
- package/agentes/mobile-ios-swl.md +500 -0
- package/agentes/mobile-testing-swl.md +300 -0
- package/agentes/notificador-swl.md +916 -0
- package/agentes/observabilidad-swl.md +436 -0
- package/agentes/orquestador-swl.md +884 -0
- package/agentes/pagos-swl.md +283 -0
- package/agentes/perfilador-usuario-swl.md +306 -0
- package/agentes/planificador-swl.md +402 -0
- package/agentes/producto-prd-swl.md +587 -0
- package/agentes/red-team-swl.md +216 -0
- package/agentes/release-manager-swl.md +568 -0
- package/agentes/rendimiento-swl.md +714 -0
- package/agentes/resolutor-build-swl.md +243 -0
- package/agentes/revisor-angular-swl.md +276 -0
- package/agentes/revisor-codigo-swl.md +348 -0
- package/agentes/revisor-csharp-swl.md +262 -0
- package/agentes/revisor-go-swl.md +257 -0
- package/agentes/revisor-java-swl.md +255 -0
- package/agentes/revisor-kotlin-swl.md +271 -0
- package/agentes/revisor-nextjs-swl.md +279 -0
- package/agentes/revisor-php-swl.md +269 -0
- package/agentes/revisor-react-swl.md +276 -0
- package/agentes/revisor-rust-swl.md +344 -0
- package/agentes/revisor-seguridad-swl.md +390 -0
- package/agentes/revisor-swift-swl.md +266 -0
- package/agentes/revisor-typescript-swl.md +344 -0
- package/agentes/sre-swl.md +265 -0
- package/agentes/tdd-qa-swl.md +354 -0
- package/agentes/ux-disenador-swl.md +501 -0
- package/bin/lib/bot-comandos.js +1030 -0
- package/bin/lib/bot-discovery.js +182 -0
- package/bin/lib/bot-git.js +142 -0
- package/bin/swl-ses.js +325 -0
- package/bin/swl-telegram-bot.js +442 -0
- package/bin/swl-telegram-bot.plist +21 -0
- package/bin/swl-telegram-bot.service +14 -0
- package/comandos/swl/.evolved.json +23 -0
- package/comandos/swl/actualizar.md +174 -0
- package/comandos/swl/adoptar-proyecto.md +207 -0
- package/comandos/swl/aprender.md +701 -0
- package/comandos/swl/auditar-deps.md +134 -0
- package/comandos/swl/autoresearch.md +170 -0
- package/comandos/swl/ayuda.md +224 -0
- package/comandos/swl/brainstorm.md +50 -0
- package/comandos/swl/checkpoint.md +330 -0
- package/comandos/swl/compactar.md +283 -0
- package/comandos/swl/configurar-ci.md +227 -0
- package/comandos/swl/contexto.md +112 -0
- package/comandos/swl/contribuir.md +233 -0
- package/comandos/swl/crear-skill.md +292 -0
- package/comandos/swl/cron.md +196 -0
- package/comandos/swl/dashboard.md +146 -0
- package/comandos/swl/discutir-fase.md +230 -0
- package/comandos/swl/ejecutar-fase.md +135 -0
- package/comandos/swl/evaluar-skill.md +487 -0
- package/comandos/swl/evolucion-estado.md +142 -0
- package/comandos/swl/evolucionar.md +259 -0
- package/comandos/swl/exportar-vault.md +189 -0
- package/comandos/swl/gateway.md +158 -0
- package/comandos/swl/inbox.md +116 -0
- package/comandos/swl/instalar.md +220 -0
- package/comandos/swl/instintos.md +86 -0
- package/comandos/swl/mapear-codebase.md +312 -0
- package/comandos/swl/mcp-status.md +175 -0
- package/comandos/swl/metricas.md +270 -0
- package/comandos/swl/modelo.md +102 -0
- package/comandos/swl/notificaciones.md +396 -0
- package/comandos/swl/nuevo-proyecto.md +154 -0
- package/comandos/swl/planear-fase.md +221 -0
- package/comandos/swl/plugins.md +256 -0
- package/comandos/swl/reflect-skills.md +125 -0
- package/comandos/swl/release.md +217 -0
- package/comandos/swl/revisar-impacto.md +206 -0
- package/comandos/swl/revisar.md +330 -0
- package/comandos/swl/salud.md +363 -0
- package/comandos/swl/sesiones.md +200 -0
- package/comandos/swl/skill-search.md +113 -0
- package/comandos/swl/verificar.md +585 -0
- package/comandos/swl/wiki.md +620 -0
- package/contextos/dev.md +32 -0
- package/contextos/research.md +30 -0
- package/contextos/review.md +31 -0
- package/habilidades/accesibilidad-a11y/SKILL.md +201 -0
- package/habilidades/accesibilidad-a11y/evals/evals.json +56 -0
- package/habilidades/accesibilidad-a11y/recursos/ejemplos-y-checklist-completo.md +441 -0
- package/habilidades/agent-browser/SKILL.md +218 -0
- package/habilidades/agentes-como-servicio/SKILL.md +218 -0
- package/habilidades/ai-runtime-security/SKILL.md +273 -0
- package/habilidades/angular-avanzado/SKILL.md +164 -0
- package/habilidades/angular-avanzado/recursos/ejemplos-avanzados.md +219 -0
- package/habilidades/angular-moderno/SKILL.md +186 -0
- package/habilidades/angular-moderno/evals/evals.json +45 -0
- package/habilidades/angular-moderno/recursos/ejemplos-avanzados.md +106 -0
- package/habilidades/api-rest-diseno/SKILL.md +191 -0
- package/habilidades/api-rest-diseno/recursos/openapi-template.yaml +506 -0
- package/habilidades/api-rest-diseno/recursos/referencia-api.md +140 -0
- package/habilidades/aprendizaje-continuo/SKILL.md +151 -0
- package/habilidades/aprendizaje-continuo/evals/evals.json +53 -0
- package/habilidades/aprendizaje-continuo/recursos/referencia-instintos.md +290 -0
- package/habilidades/async-python/SKILL.md +149 -0
- package/habilidades/async-python/evals/evals.json +47 -0
- package/habilidades/async-python/recursos/patrones-y-ejemplos-completos.md +292 -0
- package/habilidades/auth-patrones/.evolved.json +9 -0
- package/habilidades/auth-patrones/SKILL.md +413 -0
- package/habilidades/auth-patrones/recursos/implementaciones-completas.md +229 -0
- package/habilidades/auto-evolucion-protocolo/SKILL.md +276 -0
- package/habilidades/auto-evolucion-protocolo/evals/evals.json +55 -0
- package/habilidades/auto-evolucion-protocolo/recursos/referencia-completa.md +145 -0
- package/habilidades/autoresearch/SKILL.md +268 -0
- package/habilidades/autoresearch/evals/evals.json +41 -0
- package/habilidades/autoresearch/recursos/checklist-template.md +191 -0
- package/habilidades/autoresearch/scripts/calcular-score.js +88 -0
- package/habilidades/azure-cloud/SKILL.md +308 -0
- package/habilidades/azure-cloud/recursos/aks.md +327 -0
- package/habilidades/backend-mcp-servidor/SKILL.md +270 -0
- package/habilidades/backend-production-resilience/SKILL.md +288 -0
- package/habilidades/brainstorming/SKILL.md +295 -0
- package/habilidades/brainstorming/recursos/componentes-html.md +247 -0
- package/habilidades/build-errors-cpp/SKILL.md +270 -0
- package/habilidades/build-errors-csharp/SKILL.md +265 -0
- package/habilidades/build-errors-go/SKILL.md +306 -0
- package/habilidades/build-errors-java/SKILL.md +278 -0
- package/habilidades/build-errors-kotlin/SKILL.md +303 -0
- package/habilidades/build-errors-nextjs/SKILL.md +312 -0
- package/habilidades/build-errors-php/SKILL.md +270 -0
- package/habilidades/build-errors-python/SKILL.md +292 -0
- package/habilidades/build-errors-rust/SKILL.md +284 -0
- package/habilidades/build-errors-swift/SKILL.md +272 -0
- package/habilidades/build-errors-typescript/SKILL.md +369 -0
- package/habilidades/checklist-calidad/SKILL.md +271 -0
- package/habilidades/checklist-calidad/recursos/quality-report-template.md +148 -0
- package/habilidades/checklist-seguridad/SKILL.md +285 -0
- package/habilidades/checkpoints-verificacion/SKILL.md +298 -0
- package/habilidades/checkpoints-verificacion/recursos/checkpoint-templates.md +360 -0
- package/habilidades/ci-cd-pipelines/SKILL.md +157 -0
- package/habilidades/ci-cd-pipelines/recursos/github-actions-template.yaml +403 -0
- package/habilidades/ci-cd-pipelines/recursos/pipelines-completos.md +487 -0
- package/habilidades/cloud-aws/SKILL.md +142 -0
- package/habilidades/cloud-aws/recursos/servicios-aws-referencia.md +321 -0
- package/habilidades/compactacion-contexto/SKILL.md +247 -0
- package/habilidades/contenedores-docker/SKILL.md +137 -0
- package/habilidades/contenedores-docker/recursos/dockerfile-template.dockerfile +160 -0
- package/habilidades/contenedores-docker/recursos/ejemplos-y-configuraciones.md +327 -0
- package/habilidades/context-builder/SKILL.md +170 -0
- package/habilidades/control-profundidad/SKILL.md +128 -0
- package/habilidades/csharp-experto/SKILL.md +322 -0
- package/habilidades/csharp-patrones/SKILL.md +316 -0
- package/habilidades/csharp-testing/SKILL.md +286 -0
- package/habilidades/css-moderno/SKILL.md +166 -0
- package/habilidades/css-moderno/evals/evals.json +43 -0
- package/habilidades/css-moderno/recursos/ejemplos-y-patrones-completos.md +337 -0
- package/habilidades/datos-etl/SKILL.md +129 -0
- package/habilidades/datos-etl/recursos/implementaciones-completas.md +322 -0
- package/habilidades/dbml-experto/SKILL.md +339 -0
- package/habilidades/dbml-experto/evals/evals.json +56 -0
- package/habilidades/dependencias-auditoria/SKILL.md +320 -0
- package/habilidades/deprecacion-migracion/SKILL.md +169 -0
- package/habilidades/deprecacion-migracion/recursos/implementaciones-completas.md +220 -0
- package/habilidades/design-tokens/SKILL.md +158 -0
- package/habilidades/design-tokens/recursos/tokens-y-configuracion.md +363 -0
- package/habilidades/devsecops-pipeline-security/SKILL.md +309 -0
- package/habilidades/diagrama-arquitectura/SKILL.md +165 -0
- package/habilidades/diagrama-arquitectura/assets/template.html +276 -0
- package/habilidades/discutir-fase/SKILL.md +188 -0
- package/habilidades/diseno-herramientas-agente/SKILL.md +199 -0
- package/habilidades/diseno-responsivo/SKILL.md +186 -0
- package/habilidades/diseno-responsivo/recursos/ejemplos-layouts.md +156 -0
- package/habilidades/django-experto/SKILL.md +205 -0
- package/habilidades/django-experto/recursos/async-django.md +390 -0
- package/habilidades/django-experto/recursos/drf-patrones.md +438 -0
- package/habilidades/django-experto/recursos/orm-avanzado.md +382 -0
- package/habilidades/django-experto/recursos/referencia-completa.md +188 -0
- package/habilidades/django-experto/recursos/testing-django.md +415 -0
- package/habilidades/doc-sync/SKILL.md +280 -0
- package/habilidades/drift-detection/SKILL.md +179 -0
- package/habilidades/ejecutar-fase/SKILL.md +468 -0
- package/habilidades/estilo-sin-ai-isms/SKILL.md +775 -0
- package/habilidades/estilo-sin-ai-isms/evals/evals.json +63 -0
- package/habilidades/estilo-sin-ai-isms/scripts/detectar_aiisms.py +500 -0
- package/habilidades/estructura-proyecto-claude/SKILL.md +215 -0
- package/habilidades/estructura-proyecto-claude/recursos/claude-md-template.md +261 -0
- package/habilidades/estructura-proyecto-claude/recursos/configuracion-y-extensiones.md +176 -0
- package/habilidades/estructura-proyecto-claude/recursos/frontmatter-y-hooks-referencia.md +289 -0
- package/habilidades/estructura-proyecto-claude/recursos/mcp-json-template.json +77 -0
- package/habilidades/estructura-proyecto-claude/recursos/variantes-por-stack.md +177 -0
- package/habilidades/evaluacion-agentes/SKILL.md +314 -0
- package/habilidades/event-driven/SKILL.md +153 -0
- package/habilidades/event-driven/recursos/implementaciones-completas.md +423 -0
- package/habilidades/extraccion-documentos/SKILL.md +221 -0
- package/habilidades/extractor-de-aprendizajes/.evolved.json +9 -0
- package/habilidades/extractor-de-aprendizajes/SKILL.md +311 -0
- package/habilidades/extractor-de-aprendizajes/evals/evals.json +55 -0
- package/habilidades/fastapi-experto/SKILL.md +221 -0
- package/habilidades/fastapi-experto/recursos/async-patterns.md +438 -0
- package/habilidades/fastapi-experto/recursos/dependency-injection.md +330 -0
- package/habilidades/fastapi-experto/recursos/referencia-completa.md +79 -0
- package/habilidades/fastapi-experto/recursos/testing-httpx.md +420 -0
- package/habilidades/filament-admin/SKILL.md +290 -0
- package/habilidades/frontend-avanzado/SKILL.md +257 -0
- package/habilidades/frontend-avanzado/recursos/apis-nativas-ejemplos.md +341 -0
- package/habilidades/gcp-cloud/SKILL.md +260 -0
- package/habilidades/gcp-cloud/recursos/gke.md +234 -0
- package/habilidades/gcp-cloud/recursos/terraform-gcp.md +307 -0
- package/habilidades/generacion-mermaid/SKILL.md +229 -0
- package/habilidades/git-worktrees-paralelo/SKILL.md +270 -0
- package/habilidades/go-experto/SKILL.md +305 -0
- package/habilidades/go-patrones/SKILL.md +299 -0
- package/habilidades/go-testing/SKILL.md +291 -0
- package/habilidades/graphql-experto/SKILL.md +323 -0
- package/habilidades/guardrail-semantico/SKILL.md +282 -0
- package/habilidades/harness-claude-code/SKILL.md +299 -0
- package/habilidades/iam-secretos/SKILL.md +265 -0
- package/habilidades/iam-secretos/recursos/implementaciones-completas.md +356 -0
- package/habilidades/infra-github-actions/SKILL.md +166 -0
- package/habilidades/instalar-sistema/.evolved.json +9 -0
- package/habilidades/instalar-sistema/SKILL.md +221 -0
- package/habilidades/java-experto/SKILL.md +290 -0
- package/habilidades/java-patrones/SKILL.md +275 -0
- package/habilidades/java-testing/SKILL.md +288 -0
- package/habilidades/kotlin-compose/SKILL.md +278 -0
- package/habilidades/kotlin-compose/recursos/animaciones-performance.md +93 -0
- package/habilidades/kotlin-experto/SKILL.md +318 -0
- package/habilidades/kotlin-testing/SKILL.md +267 -0
- package/habilidades/kotlin-testing/recursos/testing-avanzado.md +74 -0
- package/habilidades/kubernetes-orquestacion/SKILL.md +152 -0
- package/habilidades/kubernetes-orquestacion/recursos/manifiestos-completos.md +452 -0
- package/habilidades/langchain-langraph/SKILL.md +386 -0
- package/habilidades/langchain-langraph/recursos/evaluacion-rag.md +321 -0
- package/habilidades/langchain-langraph/recursos/rag-maturity-model.md +225 -0
- package/habilidades/langchain-langraph/recursos/vectorstores.md +306 -0
- package/habilidades/legacy-code-rescue/SKILL.md +267 -0
- package/habilidades/likec4-experto/SKILL.md +412 -0
- package/habilidades/likec4-experto/evals/evals.json +69 -0
- package/habilidades/manejo-errores/.evolved.json +9 -0
- package/habilidades/manejo-errores/SKILL.md +407 -0
- package/habilidades/manejo-errores/recursos/implementaciones-completas.md +248 -0
- package/habilidades/mapear-codebase/SKILL.md +275 -0
- package/habilidades/memoria-busqueda/SKILL.md +194 -0
- package/habilidades/memoria-busqueda/evals/evals.json +44 -0
- package/habilidades/meta-skills-estandar/SKILL.md +298 -0
- package/habilidades/meta-skills-estandar/recursos/anti-patrones-y-leyes.md +205 -0
- package/habilidades/meta-skills-estandar/recursos/frameworks-seguridad.md +107 -0
- package/habilidades/meta-skills-estandar/recursos/idiomas-framework.md +60 -0
- package/habilidades/meta-skills-estandar/recursos/skills-as-agents.md +163 -0
- package/habilidades/microservicios/SKILL.md +155 -0
- package/habilidades/microservicios/recursos/patrones-y-ejemplos-completos.md +325 -0
- package/habilidades/mobile-flutter/SKILL.md +199 -0
- package/habilidades/mobile-flutter/recursos/ejemplos-completos.md +319 -0
- package/habilidades/mobile-react-native/SKILL.md +176 -0
- package/habilidades/mobile-react-native/recursos/ejemplos-completos.md +216 -0
- package/habilidades/mongodb-experto/SKILL.md +302 -0
- package/habilidades/monitoring-alertas/SKILL.md +201 -0
- package/habilidades/monitoring-alertas/recursos/instrumentacion-y-alertas.md +301 -0
- package/habilidades/nestjs-experto/SKILL.md +307 -0
- package/habilidades/nestjs-experto/recursos/guards-interceptors.md +339 -0
- package/habilidades/nestjs-experto/recursos/modulos-di.md +287 -0
- package/habilidades/nestjs-experto/recursos/testing-nestjs.md +354 -0
- package/habilidades/nextjs-experto/SKILL.md +335 -0
- package/habilidades/nextjs-patrones/SKILL.md +303 -0
- package/habilidades/nextjs-testing/SKILL.md +331 -0
- package/habilidades/node-experto/.evolved.json +9 -0
- package/habilidades/node-experto/SKILL.md +266 -0
- package/habilidades/node-experto/recursos/patrones-completos.md +283 -0
- package/habilidades/notificaciones-multicanal/SKILL.md +159 -0
- package/habilidades/notificaciones-multicanal/recursos/config-template.json +115 -0
- package/habilidades/notificaciones-multicanal/recursos/configuracion-y-templates.md +303 -0
- package/habilidades/nuevo-proyecto/SKILL.md +204 -0
- package/habilidades/orquestacion-async/SKILL.md +303 -0
- package/habilidades/paid-media-tracking/SKILL.md +269 -0
- package/habilidades/paid-media-tracking/recursos/auditoria-tracking.md +220 -0
- package/habilidades/paid-media-tracking/recursos/google-ads-api.md +215 -0
- package/habilidades/patrones-python/SKILL.md +228 -0
- package/habilidades/patrones-python/evals/evals.json +56 -0
- package/habilidades/patrones-python/recursos/patrones-avanzados.md +469 -0
- package/habilidades/patrones-python/recursos/referencia-completa.md +202 -0
- package/habilidades/perfil-usuario/SKILL.md +200 -0
- package/habilidades/perfil-usuario/evals/evals.json +55 -0
- package/habilidades/performance-baseline/SKILL.md +297 -0
- package/habilidades/php-experto/SKILL.md +291 -0
- package/habilidades/php-patrones/SKILL.md +306 -0
- package/habilidades/php-testing/SKILL.md +280 -0
- package/habilidades/planear-fase/SKILL.md +269 -0
- package/habilidades/postgresql-experto/SKILL.md +151 -0
- package/habilidades/postgresql-experto/evals/evals.json +53 -0
- package/habilidades/postgresql-experto/recursos/referencia-completa.md +215 -0
- package/habilidades/prevencion-racionalizacion/SKILL.md +175 -0
- package/habilidades/prevencion-sobreingenieria/SKILL.md +323 -0
- package/habilidades/privacy-memoria/SKILL.md +141 -0
- package/habilidades/privacy-memoria/evals/evals.json +43 -0
- package/habilidades/prompt-engineering/SKILL.md +518 -0
- package/habilidades/prompt-engineering/recursos/patrones-avanzados.md +467 -0
- package/habilidades/rag-arquitectura/SKILL.md +338 -0
- package/habilidades/rails-experto/SKILL.md +237 -0
- package/habilidades/rails-experto/recursos/active-record.md +260 -0
- package/habilidades/rails-experto/recursos/hotwire-turbo.md +293 -0
- package/habilidades/rails-experto/recursos/testing-rspec.md +362 -0
- package/habilidades/react-experto/SKILL.md +209 -0
- package/habilidades/react-experto/evals/evals.json +55 -0
- package/habilidades/react-experto/recursos/patrones-y-ejemplos-completos.md +240 -0
- package/habilidades/react-optimizacion/SKILL.md +174 -0
- package/habilidades/react-optimizacion/recursos/patrones-avanzados.md +138 -0
- package/habilidades/redis-experto/SKILL.md +305 -0
- package/habilidades/release-semver/.evolved.json +9 -0
- package/habilidades/release-semver/SKILL.md +248 -0
- package/habilidades/release-semver/scripts/generar-changelog.sh +238 -0
- package/habilidades/rust-experto/SKILL.md +400 -0
- package/habilidades/rust-patrones/SKILL.md +296 -0
- package/habilidades/rust-testing/SKILL.md +311 -0
- package/habilidades/seguridad-skills-ia/SKILL.md +262 -0
- package/habilidades/sql-optimizacion/SKILL.md +200 -0
- package/habilidades/sql-optimizacion/evals/evals.json +54 -0
- package/habilidades/sql-optimizacion/recursos/patrones-sql-avanzados.md +131 -0
- package/habilidades/sre-patrones/SKILL.md +333 -0
- package/habilidades/sre-patrones/recursos/chaos-engineering.md +241 -0
- package/habilidades/sre-patrones/recursos/oncall-design.md +236 -0
- package/habilidades/stripe-pagos/SKILL.md +550 -0
- package/habilidades/stripe-pagos/recursos/errores-reintentos.md +390 -0
- package/habilidades/stripe-pagos/recursos/stripe-connect.md +290 -0
- package/habilidades/structured-outputs/SKILL.md +343 -0
- package/habilidades/swift-experto/SKILL.md +320 -0
- package/habilidades/swift-experto/recursos/keychain-y-wrappers.md +110 -0
- package/habilidades/swift-patrones/SKILL.md +313 -0
- package/habilidades/swift-patrones/recursos/tca-ejemplo-completo.md +113 -0
- package/habilidades/swift-testing/SKILL.md +254 -0
- package/habilidades/swift-testing/recursos/xcuitest-planes.md +143 -0
- package/habilidades/swl-dashboard/SKILL.md +370 -0
- package/habilidades/swl-markitdown/SKILL.md +285 -0
- package/habilidades/swl-markitdown/evals/evals.json +52 -0
- package/habilidades/swl-revisar-impacto/SKILL.md +233 -0
- package/habilidades/tailwind-experto/SKILL.md +240 -0
- package/habilidades/tailwind-experto/recursos/referencia-completa.md +184 -0
- package/habilidades/tdd-workflow/SKILL.md +293 -0
- package/habilidades/terraform-experto/SKILL.md +321 -0
- package/habilidades/testing-python/SKILL.md +340 -0
- package/habilidades/testing-python/recursos/ejemplos-completos.md +167 -0
- package/habilidades/threat-model-lite/SKILL.md +246 -0
- package/habilidades/tracing-processor/SKILL.md +212 -0
- package/habilidades/tracking-measurement/SKILL.md +239 -0
- package/habilidades/tracking-measurement/recursos/consent-mode.md +231 -0
- package/habilidades/tracking-measurement/recursos/gtm-datalayer.md +216 -0
- package/habilidades/tracking-measurement/recursos/meta-capi.md +262 -0
- package/habilidades/typescript-avanzado/SKILL.md +144 -0
- package/habilidades/typescript-avanzado/evals/evals.json +55 -0
- package/habilidades/typescript-avanzado/recursos/patrones-y-ejemplos-completos.md +298 -0
- package/habilidades/typescript-diagnosticos/SKILL.md +513 -0
- package/habilidades/ux-diseno/SKILL.md +116 -0
- package/habilidades/ux-diseno/evals/evals.json +43 -0
- package/habilidades/ux-diseno/recursos/patrones-ux-referencia.md +214 -0
- package/habilidades/validacion-ci-sistema/SKILL.md +136 -0
- package/habilidades/validacion-ci-sistema/recursos/validadores-completos.md +369 -0
- package/habilidades/validacion-ci-sistema/scripts/validar-sistema.sh +286 -0
- package/habilidades/verificacion-evidencia/SKILL.md +160 -0
- package/habilidades/verificar-trabajo/SKILL.md +303 -0
- package/habilidades/verificar-trabajo/recursos/plantilla-verificacion.md +60 -0
- package/habilidades/wiki-conocimiento/SKILL.md +276 -0
- package/habilidades/wireframes-flujos/SKILL.md +212 -0
- package/habilidades/wireframes-flujos/recursos/referencia-completa.md +192 -0
- package/habilidades/workflow-claude-code/SKILL.md +260 -0
- package/habilidades/workflow-claude-code/recursos/referencia-completa.md +109 -0
- package/hooks/_run-hook.sh +57 -0
- package/hooks/actualizar-perfil-usuario.js +364 -0
- package/hooks/agente-lifecycle.js +71 -0
- package/hooks/aiisms-detector.js +173 -0
- package/hooks/audit-trail.js +204 -0
- package/hooks/auto-background.js +97 -0
- package/hooks/auto-consolidacion.js +178 -0
- package/hooks/auto-evolucion.js +666 -0
- package/hooks/auto-restaurar-settings.js +360 -0
- package/hooks/calidad-pre-commit.js +929 -0
- package/hooks/calidad-typescript.js +511 -0
- package/hooks/captura-feedback-usuario.js +148 -0
- package/hooks/check-update.js +211 -0
- package/hooks/clasificador-mensajes.js +271 -0
- package/hooks/degradacion-instintos.js +272 -0
- package/hooks/escaneo-secretos.js +389 -0
- package/hooks/extraccion-aprendizajes.js +763 -0
- package/hooks/grafo-contexto.js +129 -0
- package/hooks/graph-update.js +67 -0
- package/hooks/guardrail-modelo.js +247 -0
- package/hooks/inbox-aviso.js +75 -0
- package/hooks/inyeccion-contexto.js +246 -0
- package/hooks/lib/abort-registry.js +214 -0
- package/hooks/lib/agent-backend.js +210 -0
- package/hooks/lib/agent-comms.js +263 -0
- package/hooks/lib/agent-issue-codes.js +284 -0
- package/hooks/lib/agent-matcher.js +189 -0
- package/hooks/lib/async-hook-registry.js +252 -0
- package/hooks/lib/atomic-write.js +130 -0
- package/hooks/lib/auto-consolidator.js +335 -0
- package/hooks/lib/canary-skills.js +187 -0
- package/hooks/lib/consolidation-lock.js +291 -0
- package/hooks/lib/context-builder.js +430 -0
- package/hooks/lib/context-compressor.js +657 -0
- package/hooks/lib/convergence-detector.js +105 -0
- package/hooks/lib/delegation-tracker.js +198 -0
- package/hooks/lib/detectar-package-manager.js +423 -0
- package/hooks/lib/edit-accumulator.js +171 -0
- package/hooks/lib/error-classifier.js +308 -0
- package/hooks/lib/event-bus.js +112 -0
- package/hooks/lib/evolution-tracker.js +442 -0
- package/hooks/lib/execution-state.js +316 -0
- package/hooks/lib/fingerprint-id.js +135 -0
- package/hooks/lib/gateway-notify.js +116 -0
- package/hooks/lib/graph-security.js +75 -0
- package/hooks/lib/guardrail-metrics.js +202 -0
- package/hooks/lib/hook-circuit-breaker.js +206 -0
- package/hooks/lib/loop-detector.js +267 -0
- package/hooks/lib/mcp-health.js +184 -0
- package/hooks/lib/mcp-pool.js +436 -0
- package/hooks/lib/memory-search.js +506 -0
- package/hooks/lib/merkle-audit.js +96 -0
- package/hooks/lib/model-router.js +222 -0
- package/hooks/lib/normalize-error.js +324 -0
- package/hooks/lib/normalize-input.js +65 -0
- package/hooks/lib/nudge-tracker.js +306 -0
- package/hooks/lib/otlp-exporter.js +365 -0
- package/hooks/lib/performance-marks.js +239 -0
- package/hooks/lib/privacy-filter.js +128 -0
- package/hooks/lib/prompt-injection-scanner.js +209 -0
- package/hooks/lib/provenance-tracker.js +183 -0
- package/hooks/lib/rate-limit-tracker.js +253 -0
- package/hooks/lib/reflect-classifier.js +164 -0
- package/hooks/lib/resource-quota.js +122 -0
- package/hooks/lib/retry-jitter.js +165 -0
- package/hooks/lib/risk-engine.js +368 -0
- package/hooks/lib/run-log.js +408 -0
- package/hooks/lib/session-fts.js +379 -0
- package/hooks/lib/session-store.js +293 -0
- package/hooks/lib/singleton-guard.js +159 -0
- package/hooks/lib/skill-auditor.js +588 -0
- package/hooks/lib/sync-status.js +228 -0
- package/hooks/lib/taint-tracker.js +107 -0
- package/hooks/lib/task-service.js +295 -0
- package/hooks/lib/tech-skills-map.js +146 -0
- package/hooks/lib/telegram-cliente.js +159 -0
- package/hooks/lib/telegram-config.js +170 -0
- package/hooks/lib/token-budget.js +156 -0
- package/hooks/lib/token-estimator.js +420 -0
- package/hooks/lib/toon-compressor.js +245 -0
- package/hooks/lib/usage-model.js +183 -0
- package/hooks/lib/variable-resolver.js +230 -0
- package/hooks/linea-estado.js +324 -0
- package/hooks/metricas-evolucion.js +209 -0
- package/hooks/monitor-contexto.js +325 -0
- package/hooks/notificacion-sesion-stop.js +198 -0
- package/hooks/notificacion-telegram-notification.js +4 -0
- package/hooks/notificacion-telegram-subagent.js +4 -0
- package/hooks/notificacion-telegram.js +267 -0
- package/hooks/preservar-estado-pre-compact.js +150 -0
- package/hooks/proteccion-rutas.js +366 -0
- package/hooks/registro-turnos.js +209 -0
- package/hooks/resumen-sesion.js +249 -0
- package/hooks/risk-scoring.js +323 -0
- package/hooks/rotar-audit-auto.js +122 -0
- package/hooks/sugerir-regenerar-inventario.js +170 -0
- package/hooks/telemetria-agentes.js +167 -0
- package/hooks/tracking-costos.js +688 -0
- package/instintos/global.yaml +8 -0
- package/instintos/perfil-usuario.yaml +53 -0
- package/instintos/prompt-appendices.yaml +57 -0
- package/instintos/proyecto.yaml +372 -0
- package/manifiestos/gateway-config.json +77 -0
- package/manifiestos/handoff-context.json +223 -0
- package/manifiestos/hook-profiles.json +44 -0
- package/manifiestos/hooks-config.json +360 -0
- package/manifiestos/modulos.json +1173 -0
- package/manifiestos/perfiles.json +404 -0
- package/package.json +86 -0
- package/plantillas/ESTADO.md +109 -0
- package/plantillas/HOJA-RUTA.md +143 -0
- package/plantillas/PROYECTO.md +122 -0
- package/plantillas/REQUISITOS.md +132 -0
- package/plantillas/auditor-veto-template.md +105 -0
- package/plantillas/github-workflows/README.md +47 -0
- package/plantillas/github-workflows/release-please.yml +44 -0
- package/plantillas/github-workflows/swl-ci.yml +107 -0
- package/plantillas/github-workflows/swl-security.yml +51 -0
- package/plantillas/mcp-mineru.json +13 -0
- package/plantillas/research/ARQUITECTURA.md +220 -0
- package/plantillas/research/FUNCIONALIDADES.md +175 -0
- package/plantillas/research/RESUMEN.md +165 -0
- package/plantillas/research/STACK.md +233 -0
- package/plantillas/research/TRAMPAS.md +299 -0
- package/plantillas/skill-evals-template.json +44 -0
- package/plugin.json +343 -0
- package/reglas/accesibilidad.md +269 -0
- package/reglas/api-diseno.md +400 -0
- package/reglas/arquitectura.md +352 -0
- package/reglas/brevedad-output.md +124 -0
- package/reglas/cloud-infra.md +247 -0
- package/reglas/docs.md +245 -0
- package/reglas/estilo-codigo.md +201 -0
- package/reglas/git-workflow.md +245 -0
- package/reglas/gobernanza.md +271 -0
- package/reglas/harness-claude-code.md +213 -0
- package/reglas/hooks.md +186 -0
- package/reglas/lenguajes/csharp/estilo-codigo.md +231 -0
- package/reglas/lenguajes/csharp/hooks.md +281 -0
- package/reglas/lenguajes/csharp/patrones.md +226 -0
- package/reglas/lenguajes/csharp/seguridad.md +258 -0
- package/reglas/lenguajes/csharp/testing.md +176 -0
- package/reglas/lenguajes/go/estilo-codigo.md +195 -0
- package/reglas/lenguajes/go/hooks.md +249 -0
- package/reglas/lenguajes/go/patrones.md +249 -0
- package/reglas/lenguajes/go/seguridad.md +225 -0
- package/reglas/lenguajes/go/testing.md +272 -0
- package/reglas/lenguajes/java/estilo-codigo.md +217 -0
- package/reglas/lenguajes/java/hooks.md +251 -0
- package/reglas/lenguajes/java/patrones.md +226 -0
- package/reglas/lenguajes/java/seguridad.md +233 -0
- package/reglas/lenguajes/java/testing.md +238 -0
- package/reglas/lenguajes/kotlin/estilo-codigo.md +208 -0
- package/reglas/lenguajes/kotlin/hooks.md +245 -0
- package/reglas/lenguajes/kotlin/patrones.md +201 -0
- package/reglas/lenguajes/kotlin/seguridad.md +202 -0
- package/reglas/lenguajes/kotlin/testing.md +236 -0
- package/reglas/lenguajes/nextjs/estilo-codigo.md +175 -0
- package/reglas/lenguajes/nextjs/hooks.md +186 -0
- package/reglas/lenguajes/nextjs/patrones.md +225 -0
- package/reglas/lenguajes/nextjs/seguridad.md +216 -0
- package/reglas/lenguajes/nextjs/testing.md +193 -0
- package/reglas/lenguajes/php/estilo-codigo.md +228 -0
- package/reglas/lenguajes/php/hooks.md +165 -0
- package/reglas/lenguajes/php/patrones.md +233 -0
- package/reglas/lenguajes/php/seguridad.md +186 -0
- package/reglas/lenguajes/php/testing.md +205 -0
- package/reglas/lenguajes/rust/estilo-codigo.md +207 -0
- package/reglas/lenguajes/rust/hooks.md +240 -0
- package/reglas/lenguajes/rust/patrones.md +250 -0
- package/reglas/lenguajes/rust/seguridad.md +221 -0
- package/reglas/lenguajes/rust/testing.md +194 -0
- package/reglas/lenguajes/swift/estilo-codigo.md +238 -0
- package/reglas/lenguajes/swift/hooks.md +257 -0
- package/reglas/lenguajes/swift/patrones.md +235 -0
- package/reglas/lenguajes/swift/seguridad.md +248 -0
- package/reglas/lenguajes/swift/testing.md +242 -0
- package/reglas/markitdown.md +60 -0
- package/reglas/memoria-consolidada.md +209 -0
- package/reglas/patrones.md +225 -0
- package/reglas/performance.md +195 -0
- package/reglas/pruebas.md +159 -0
- package/reglas/seguridad-agentes.md +351 -0
- package/reglas/seguridad.md +151 -0
- package/reglas/skills-estandar.md +373 -0
- package/reglas/testing.md +193 -0
- package/schemas/agent-contract.json +176 -0
- package/schemas/agent-frontmatter.schema.json +149 -0
- package/schemas/agent-message.schema.json +53 -0
- package/schemas/agent-output-implementacion.schema.json +85 -0
- package/schemas/agent-output-planificacion.schema.json +113 -0
- package/schemas/agent-output-review.schema.json +78 -0
- package/schemas/diary-entry.schema.json +80 -0
- package/schemas/hook-profiles.schema.json +39 -0
- package/schemas/hooks-config.schema.json +74 -0
- package/schemas/instinct.schema.json +115 -0
- package/schemas/modulos.schema.json +29 -0
- package/schemas/perfiles.schema.json +28 -0
- package/schemas/plugin.schema.json +64 -0
- package/schemas/skill-evals.schema.json +95 -0
- package/schemas/skill-frontmatter.schema.json +170 -0
- package/scripts/actualizar.js +145 -0
- package/scripts/audit-skills.sh +78 -0
- package/scripts/auditar-agentes-gaps.js +149 -0
- package/scripts/auditar-cobertura-frameworks.js +241 -0
- package/scripts/auditar-skills-gaps.js +206 -0
- package/scripts/bootstrap-instintos.js +259 -0
- package/scripts/check-update.js +109 -0
- package/scripts/comandos/agents.js +105 -0
- package/scripts/comandos/info.js +108 -0
- package/scripts/comandos/install-asistido.js +186 -0
- package/scripts/comandos/skills.js +211 -0
- package/scripts/configurar-branch-protection.js +418 -0
- package/scripts/daemon-swl.py +388 -0
- package/scripts/desinstalar.js +130 -0
- package/scripts/doctor.js +559 -0
- package/scripts/field-report.js +199 -0
- package/scripts/generar-inventario.js +317 -0
- package/scripts/inbox-tmux-inject.js +161 -0
- package/scripts/inferir-herramientas-permitidas.js +586 -0
- package/scripts/inicializar.js +133 -0
- package/scripts/instalador.js +1031 -0
- package/scripts/instalar-git-hook.js +122 -0
- package/scripts/lib/agp-frontmatter.js +222 -0
- package/scripts/lib/append-con-marcadores.js +199 -0
- package/scripts/lib/artefactos-python.js +43 -0
- package/scripts/lib/audit-query.js +221 -0
- package/scripts/lib/autostart-linux.js +347 -0
- package/scripts/lib/autostart-macos.js +360 -0
- package/scripts/lib/autostart-windows.js +307 -0
- package/scripts/lib/budget-enforcer.js +252 -0
- package/scripts/lib/claude-sessions.js +285 -0
- package/scripts/lib/configurar-ci.js +380 -0
- package/scripts/lib/console-span-exporter.js +92 -0
- package/scripts/lib/contadores-inventario.js +217 -0
- package/scripts/lib/dashboard-widgets.js +290 -0
- package/scripts/lib/detectar-runtime.js +279 -0
- package/scripts/lib/detectar-stack.js +187 -0
- package/scripts/lib/diary-entry.js +234 -0
- package/scripts/lib/drift-detector.js +545 -0
- package/scripts/lib/estado.js +124 -0
- package/scripts/lib/gestor-componentes.js +243 -0
- package/scripts/lib/gitignore-manifest.js +305 -0
- package/scripts/lib/graph-analyze.py +556 -0
- package/scripts/lib/graph-builder.py +485 -0
- package/scripts/lib/graph-cluster.py +259 -0
- package/scripts/lib/health-row.js +168 -0
- package/scripts/lib/hooks-settings.js +789 -0
- package/scripts/lib/manifiestos.js +138 -0
- package/scripts/lib/mc-client.js +137 -0
- package/scripts/lib/notificaciones-telegram.js +1107 -0
- package/scripts/lib/npm-version.js +261 -0
- package/scripts/lib/paquetes-conocidos.js +50 -0
- package/scripts/lib/preservar-usuario.js +586 -0
- package/scripts/lib/prompt-builder.js +264 -0
- package/scripts/lib/resolver-externo.js +332 -0
- package/scripts/lib/schedule-parser.js +305 -0
- package/scripts/lib/scoring-instintos.js +240 -0
- package/scripts/lib/seguridad.js +160 -0
- package/scripts/lib/selector-interactivo.js +152 -0
- package/scripts/lib/semantic-search.js +242 -0
- package/scripts/lib/skill-discovery.js +234 -0
- package/scripts/lib/skill-metrics.js +246 -0
- package/scripts/lib/skill-normalizer.js +112 -0
- package/scripts/lib/skills-hub.js +340 -0
- package/scripts/lib/span-schema.js +134 -0
- package/scripts/lib/tool-cost-analyzer.js +255 -0
- package/scripts/lib/tracing-processor-interface.js +286 -0
- package/scripts/lib/transformadores/base.js +80 -0
- package/scripts/lib/transformadores/claude.js +124 -0
- package/scripts/lib/transformadores/codex.js +115 -0
- package/scripts/lib/transformadores/copilot.js +106 -0
- package/scripts/lib/transformadores/gemini.js +74 -0
- package/scripts/lib/transformadores/index.js +35 -0
- package/scripts/lib/transformadores/opencode.js +75 -0
- package/scripts/lib/ui.js +259 -0
- package/scripts/limpiar-artefactos-python.js +131 -0
- package/scripts/mcp-orchestrator.py +386 -0
- package/scripts/mcp-pool-manager.py +352 -0
- package/scripts/mcp-telemetry.py +378 -0
- package/scripts/poblar-evolvable.js +226 -0
- package/scripts/publicar.js +287 -0
- package/scripts/reflect-skills.js +403 -0
- package/scripts/rotar-audit-logs.js +185 -0
- package/scripts/run-skill-evals.js +242 -0
- package/scripts/smoke-test.js +374 -0
- package/scripts/token-analysis.py +471 -0
- package/scripts/validar-manifest.js +195 -0
- package/scripts/validar-memoria.js +321 -0
- package/scripts/validar-tests-aislamiento.js +184 -0
- package/scripts/validar-tokens-test.js +208 -0
- package/scripts/validar.js +147 -0
- package/scripts/validate-markdown.py +339 -0
- package/scripts/validate-skills.py +385 -0
- package/scripts/vendor/claude-usage/README.md +116 -0
- package/scripts/vendor/claude-usage/cli.py +334 -0
- package/scripts/vendor/claude-usage/dashboard.py +795 -0
- package/scripts/vendor/claude-usage/scanner.py +467 -0
- package/scripts/vendor/markitdown/cli.py +194 -0
- package/scripts/verificar-evolucion.js +289 -0
- package/scripts/verificar-release.js +494 -0
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Resource Quota — Control de consumo por ventana temporal.
|
|
5
|
+
*
|
|
6
|
+
* Adoptado de OpenFang (crates/openfang-kernel/src/metering.rs).
|
|
7
|
+
* Implementa quotas rolling por hora, dia y mes para tokens y costo USD.
|
|
8
|
+
*
|
|
9
|
+
* Zero dependencias externas.
|
|
10
|
+
*
|
|
11
|
+
* Uso:
|
|
12
|
+
* const { quota } = require('./lib/resource-quota');
|
|
13
|
+
* quota.registrar({ tokens: 1500, costoUsd: 0.005, agente: 'implementador-swl' });
|
|
14
|
+
* const check = quota.verificar();
|
|
15
|
+
* if (check.excedido) console.log(check.mensaje);
|
|
16
|
+
*
|
|
17
|
+
* @module hooks/lib/resource-quota
|
|
18
|
+
*/
|
|
19
|
+
|
|
20
|
+
const DEFAULTS = {
|
|
21
|
+
maxTokensPorHora: 200000,
|
|
22
|
+
maxCostoPorHoraUsd: 2.00,
|
|
23
|
+
maxCostoPorDiaUsd: 10.00,
|
|
24
|
+
maxCostoPorMesUsd: 100.00,
|
|
25
|
+
alertAt: 0.80,
|
|
26
|
+
};
|
|
27
|
+
|
|
28
|
+
const _registros = [];
|
|
29
|
+
const MAX_REGISTROS = 10000;
|
|
30
|
+
|
|
31
|
+
function _ahora() { return Date.now(); }
|
|
32
|
+
function _haceUnaHora() { return _ahora() - 3600000; }
|
|
33
|
+
function _haceUnDia() { return _ahora() - 86400000; }
|
|
34
|
+
function _haceUnMes() { return _ahora() - 2592000000; }
|
|
35
|
+
|
|
36
|
+
const quota = {
|
|
37
|
+
configurar(opciones) {
|
|
38
|
+
Object.assign(DEFAULTS, opciones);
|
|
39
|
+
},
|
|
40
|
+
|
|
41
|
+
registrar(datos) {
|
|
42
|
+
_registros.push({
|
|
43
|
+
tokens: datos.tokens || 0,
|
|
44
|
+
costoUsd: datos.costoUsd || 0,
|
|
45
|
+
agente: datos.agente || 'desconocido',
|
|
46
|
+
timestamp: _ahora(),
|
|
47
|
+
});
|
|
48
|
+
if (_registros.length > MAX_REGISTROS) {
|
|
49
|
+
_registros.splice(0, _registros.length - MAX_REGISTROS);
|
|
50
|
+
}
|
|
51
|
+
},
|
|
52
|
+
|
|
53
|
+
_sumarVentana(desdeMs) {
|
|
54
|
+
let tokens = 0, costo = 0;
|
|
55
|
+
for (let i = _registros.length - 1; i >= 0; i--) {
|
|
56
|
+
const r = _registros[i];
|
|
57
|
+
if (r.timestamp < desdeMs) break;
|
|
58
|
+
tokens += r.tokens;
|
|
59
|
+
costo += r.costoUsd;
|
|
60
|
+
}
|
|
61
|
+
return { tokens, costo };
|
|
62
|
+
},
|
|
63
|
+
|
|
64
|
+
verificar() {
|
|
65
|
+
const hora = this._sumarVentana(_haceUnaHora());
|
|
66
|
+
const dia = this._sumarVentana(_haceUnDia());
|
|
67
|
+
const mes = this._sumarVentana(_haceUnMes());
|
|
68
|
+
|
|
69
|
+
const violations = [];
|
|
70
|
+
|
|
71
|
+
if (hora.tokens >= DEFAULTS.maxTokensPorHora) {
|
|
72
|
+
violations.push({ tipo: 'tokens_hora', valor: hora.tokens, limite: DEFAULTS.maxTokensPorHora });
|
|
73
|
+
}
|
|
74
|
+
if (hora.costo >= DEFAULTS.maxCostoPorHoraUsd) {
|
|
75
|
+
violations.push({ tipo: 'costo_hora', valor: hora.costo, limite: DEFAULTS.maxCostoPorHoraUsd });
|
|
76
|
+
}
|
|
77
|
+
if (dia.costo >= DEFAULTS.maxCostoPorDiaUsd) {
|
|
78
|
+
violations.push({ tipo: 'costo_dia', valor: dia.costo, limite: DEFAULTS.maxCostoPorDiaUsd });
|
|
79
|
+
}
|
|
80
|
+
if (mes.costo >= DEFAULTS.maxCostoPorMesUsd) {
|
|
81
|
+
violations.push({ tipo: 'costo_mes', valor: mes.costo, limite: DEFAULTS.maxCostoPorMesUsd });
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
const warnings = [];
|
|
85
|
+
const alertThreshold = DEFAULTS.alertAt;
|
|
86
|
+
|
|
87
|
+
if (hora.costo >= DEFAULTS.maxCostoPorHoraUsd * alertThreshold && !violations.find(v => v.tipo === 'costo_hora')) {
|
|
88
|
+
warnings.push({ tipo: 'costo_hora', valor: hora.costo, limite: DEFAULTS.maxCostoPorHoraUsd, pct: Math.round(hora.costo / DEFAULTS.maxCostoPorHoraUsd * 100) });
|
|
89
|
+
}
|
|
90
|
+
if (dia.costo >= DEFAULTS.maxCostoPorDiaUsd * alertThreshold && !violations.find(v => v.tipo === 'costo_dia')) {
|
|
91
|
+
warnings.push({ tipo: 'costo_dia', valor: dia.costo, limite: DEFAULTS.maxCostoPorDiaUsd, pct: Math.round(dia.costo / DEFAULTS.maxCostoPorDiaUsd * 100) });
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
return {
|
|
95
|
+
excedido: violations.length > 0,
|
|
96
|
+
violations,
|
|
97
|
+
warnings,
|
|
98
|
+
consumo: { hora, dia, mes },
|
|
99
|
+
mensaje: violations.length > 0
|
|
100
|
+
? 'Quota excedida: ' + violations.map(v => v.tipo + ' (' + v.valor.toFixed(2) + '/' + v.limite + ')').join(', ')
|
|
101
|
+
: warnings.length > 0
|
|
102
|
+
? 'Alerta: ' + warnings.map(w => w.tipo + ' al ' + w.pct + '%').join(', ')
|
|
103
|
+
: 'Dentro de quota',
|
|
104
|
+
};
|
|
105
|
+
},
|
|
106
|
+
|
|
107
|
+
resumen() {
|
|
108
|
+
const hora = this._sumarVentana(_haceUnaHora());
|
|
109
|
+
const dia = this._sumarVentana(_haceUnDia());
|
|
110
|
+
const mes = this._sumarVentana(_haceUnMes());
|
|
111
|
+
return {
|
|
112
|
+
hora: { tokens: hora.tokens, costoUsd: Math.round(hora.costo * 10000) / 10000 },
|
|
113
|
+
dia: { tokens: dia.tokens, costoUsd: Math.round(dia.costo * 10000) / 10000 },
|
|
114
|
+
mes: { tokens: mes.tokens, costoUsd: Math.round(mes.costo * 10000) / 10000 },
|
|
115
|
+
registros: _registros.length,
|
|
116
|
+
};
|
|
117
|
+
},
|
|
118
|
+
|
|
119
|
+
reset() { _registros.length = 0; },
|
|
120
|
+
};
|
|
121
|
+
|
|
122
|
+
module.exports = { quota, DEFAULTS };
|
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Retry con Jitter Decorrelado — Backoff exponencial con decorrelación.
|
|
5
|
+
*
|
|
6
|
+
* Patrón adoptado de Hermes Agent (agent/retry_utils.py).
|
|
7
|
+
* Usa seed basado en time + counter con golden ratio para decorrelación
|
|
8
|
+
* entre sesiones concurrentes — evita thundering herd.
|
|
9
|
+
*
|
|
10
|
+
* Zero dependencias externas — usa crypto nativo de Node.js.
|
|
11
|
+
*
|
|
12
|
+
* Uso:
|
|
13
|
+
* const { jitteredBackoff, crearRetrier } = require('./lib/retry-jitter');
|
|
14
|
+
*
|
|
15
|
+
* // Calcular delay para un intento específico
|
|
16
|
+
* const delay = jitteredBackoff(2, { baseDelay: 5, maxDelay: 120 });
|
|
17
|
+
*
|
|
18
|
+
* // Usar retrier completo
|
|
19
|
+
* const retrier = crearRetrier({ maxIntentos: 3, baseDelay: 5 });
|
|
20
|
+
* const resultado = await retrier.ejecutar(async () => {
|
|
21
|
+
* return await llamadaAPI();
|
|
22
|
+
* });
|
|
23
|
+
*
|
|
24
|
+
* @module hooks/lib/retry-jitter
|
|
25
|
+
*/
|
|
26
|
+
|
|
27
|
+
const crypto = require('crypto');
|
|
28
|
+
|
|
29
|
+
// ---------------------------------------------------------------------------
|
|
30
|
+
// Constantes
|
|
31
|
+
// ---------------------------------------------------------------------------
|
|
32
|
+
|
|
33
|
+
/** Golden ratio × 2^32 — constante de dispersión de Fibonacci hashing. */
|
|
34
|
+
const GOLDEN_RATIO_32 = 0x9E3779B9;
|
|
35
|
+
|
|
36
|
+
/** Contador global para decorrelación entre llamadas concurrentes. */
|
|
37
|
+
let _jitterCounter = 0;
|
|
38
|
+
|
|
39
|
+
// ---------------------------------------------------------------------------
|
|
40
|
+
// Funciones core
|
|
41
|
+
// ---------------------------------------------------------------------------
|
|
42
|
+
|
|
43
|
+
/**
|
|
44
|
+
* Calcula delay con backoff exponencial + jitter decorrelado.
|
|
45
|
+
*
|
|
46
|
+
* Delay = min(base × 2^(intento-1), maxDelay) + jitter
|
|
47
|
+
* Jitter = random(0, jitterRatio × delay)
|
|
48
|
+
*
|
|
49
|
+
* El seed para el random combina timestamp con un contador global
|
|
50
|
+
* multiplicado por la constante golden ratio, lo que garantiza
|
|
51
|
+
* que llamadas concurrentes desde diferentes hilos/procesos
|
|
52
|
+
* NO coincidan en el mismo delay.
|
|
53
|
+
*
|
|
54
|
+
* @param {number} intento - Número de intento (1-indexed)
|
|
55
|
+
* @param {object} [opciones]
|
|
56
|
+
* @param {number} [opciones.baseDelay=5] - Delay base en segundos
|
|
57
|
+
* @param {number} [opciones.maxDelay=120] - Delay máximo en segundos
|
|
58
|
+
* @param {number} [opciones.jitterRatio=0.5] - Proporción de jitter (0-1)
|
|
59
|
+
* @returns {number} Delay en segundos (con decimales)
|
|
60
|
+
*/
|
|
61
|
+
function jitteredBackoff(intento, opciones = {}) {
|
|
62
|
+
const {
|
|
63
|
+
baseDelay = 5,
|
|
64
|
+
maxDelay = 120,
|
|
65
|
+
jitterRatio = 0.5,
|
|
66
|
+
} = opciones;
|
|
67
|
+
|
|
68
|
+
_jitterCounter += 1;
|
|
69
|
+
const tick = _jitterCounter;
|
|
70
|
+
|
|
71
|
+
// Backoff exponencial acotado
|
|
72
|
+
const exponente = Math.max(0, intento - 1);
|
|
73
|
+
const delay = Math.min(baseDelay * Math.pow(2, exponente), maxDelay);
|
|
74
|
+
|
|
75
|
+
// Seed decorrelado: timestamp XOR (counter × golden_ratio)
|
|
76
|
+
const nowNs = BigInt(Date.now()) * 1_000_000n; // ms → pseudo-ns
|
|
77
|
+
const seed = Number((nowNs ^ BigInt(tick * GOLDEN_RATIO_32)) & 0xFFFFFFFFn);
|
|
78
|
+
|
|
79
|
+
// PRNG determinista basado en seed (sin crypto para velocidad)
|
|
80
|
+
const hash = crypto.createHash('md5').update(String(seed)).digest();
|
|
81
|
+
const pseudoRandom = hash.readUInt32LE(0) / 0xFFFFFFFF;
|
|
82
|
+
|
|
83
|
+
const jitter = pseudoRandom * jitterRatio * delay;
|
|
84
|
+
|
|
85
|
+
return delay + jitter;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* Espera un número de segundos (para uso con async/await).
|
|
90
|
+
*
|
|
91
|
+
* @param {number} segundos
|
|
92
|
+
* @returns {Promise<void>}
|
|
93
|
+
*/
|
|
94
|
+
function esperar(segundos) {
|
|
95
|
+
return new Promise(resolve => setTimeout(resolve, Math.round(segundos * 1000)));
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* Crea un retrier configurable con jitter decorrelado.
|
|
100
|
+
*
|
|
101
|
+
* @param {object} [opciones]
|
|
102
|
+
* @param {number} [opciones.maxIntentos=3] - Máximo de intentos
|
|
103
|
+
* @param {number} [opciones.baseDelay=5] - Delay base en segundos
|
|
104
|
+
* @param {number} [opciones.maxDelay=120] - Delay máximo en segundos
|
|
105
|
+
* @param {number} [opciones.jitterRatio=0.5] - Proporción de jitter
|
|
106
|
+
* @param {Function} [opciones.esRetryable] - Función que determina si un error es retryable
|
|
107
|
+
* @param {Function} [opciones.onReintento] - Callback antes de cada reintento
|
|
108
|
+
* @returns {object} Retrier con método ejecutar()
|
|
109
|
+
*/
|
|
110
|
+
function crearRetrier(opciones = {}) {
|
|
111
|
+
const {
|
|
112
|
+
maxIntentos = 3,
|
|
113
|
+
baseDelay = 5,
|
|
114
|
+
maxDelay = 120,
|
|
115
|
+
jitterRatio = 0.5,
|
|
116
|
+
esRetryable = () => true,
|
|
117
|
+
onReintento = null,
|
|
118
|
+
} = opciones;
|
|
119
|
+
|
|
120
|
+
return {
|
|
121
|
+
/**
|
|
122
|
+
* Ejecuta una función con reintentos automáticos.
|
|
123
|
+
*
|
|
124
|
+
* @template T
|
|
125
|
+
* @param {() => Promise<T>} fn - Función async a ejecutar
|
|
126
|
+
* @returns {Promise<T>} Resultado de la función
|
|
127
|
+
* @throws {Error} Error del último intento si todos fallan
|
|
128
|
+
*/
|
|
129
|
+
async ejecutar(fn) {
|
|
130
|
+
let ultimoError;
|
|
131
|
+
|
|
132
|
+
for (let intento = 1; intento <= maxIntentos; intento++) {
|
|
133
|
+
try {
|
|
134
|
+
return await fn();
|
|
135
|
+
} catch (error) {
|
|
136
|
+
ultimoError = error;
|
|
137
|
+
|
|
138
|
+
if (intento >= maxIntentos || !esRetryable(error)) {
|
|
139
|
+
throw error;
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
const delay = jitteredBackoff(intento, { baseDelay, maxDelay, jitterRatio });
|
|
143
|
+
|
|
144
|
+
if (onReintento) {
|
|
145
|
+
onReintento({ intento, maxIntentos, delay, error });
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
await esperar(delay);
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
throw ultimoError;
|
|
153
|
+
},
|
|
154
|
+
};
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
// ---------------------------------------------------------------------------
|
|
158
|
+
// Exports
|
|
159
|
+
// ---------------------------------------------------------------------------
|
|
160
|
+
|
|
161
|
+
module.exports = {
|
|
162
|
+
jitteredBackoff,
|
|
163
|
+
esperar,
|
|
164
|
+
crearRetrier,
|
|
165
|
+
};
|
|
@@ -0,0 +1,368 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* lib/risk-engine.js
|
|
5
|
+
* Motor de scoring de riesgo compuesto para operaciones de Claude Code.
|
|
6
|
+
*
|
|
7
|
+
* Calcula un score normalizado [0.0 - 1.0] evaluando cada tool call en 4 ejes:
|
|
8
|
+
*
|
|
9
|
+
* Score = min(1.0, baseRisk + fileSensitivity + blastRadius + irreversibility)
|
|
10
|
+
*
|
|
11
|
+
* Ejes de evaluación:
|
|
12
|
+
*
|
|
13
|
+
* 1. Base Tool Risk — riesgo intrínseco por tipo de herramienta
|
|
14
|
+
* 2. File Sensitivity — sensibilidad del archivo objetivo (Write/Edit/Read)
|
|
15
|
+
* 3. Blast Radius — alcance del impacto del comando (Bash)
|
|
16
|
+
* 4. Irreversibility — dificultad de deshacer la operación (Bash)
|
|
17
|
+
*
|
|
18
|
+
* API pública:
|
|
19
|
+
* calcularRiskScore(toolName, toolInput) → { score, level, factors }
|
|
20
|
+
* UMBRALES_DEFAULT → { allow, review, confirm }
|
|
21
|
+
*
|
|
22
|
+
* Niveles de decisión:
|
|
23
|
+
* 'allow' — score < umbral allow → operación segura, no intervenir
|
|
24
|
+
* 'review' — score < umbral review → advertencia en stderr, continuar
|
|
25
|
+
* 'confirm' — score < umbral confirm → solicitar confirmación explícita
|
|
26
|
+
* 'block' — score >= umbral confirm → bloquear operación
|
|
27
|
+
*/
|
|
28
|
+
|
|
29
|
+
// ---------------------------------------------------------------------------
|
|
30
|
+
// Umbrales de decisión
|
|
31
|
+
// ---------------------------------------------------------------------------
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Umbrales por defecto para clasificar el nivel de riesgo.
|
|
35
|
+
* Un score igual o superior al umbral activa ese nivel.
|
|
36
|
+
*
|
|
37
|
+
* allow [0.00 – 0.35) → operación normal
|
|
38
|
+
* review [0.35 – 0.60) → advertencia
|
|
39
|
+
* confirm [0.60 – 0.85) → requiere confirmación
|
|
40
|
+
* block [0.85 – 1.00] → bloqueo automático
|
|
41
|
+
*/
|
|
42
|
+
const UMBRALES_DEFAULT = {
|
|
43
|
+
allow: 0.35,
|
|
44
|
+
review: 0.60,
|
|
45
|
+
confirm: 0.85,
|
|
46
|
+
};
|
|
47
|
+
|
|
48
|
+
// ---------------------------------------------------------------------------
|
|
49
|
+
// Eje 1 — Base Tool Risk
|
|
50
|
+
// ---------------------------------------------------------------------------
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* Riesgo base asignado a cada herramienta por su naturaleza.
|
|
54
|
+
* El mapa cubre las herramientas conocidas de Claude Code; las no listadas
|
|
55
|
+
* reciben el valor 'otros'.
|
|
56
|
+
*/
|
|
57
|
+
const BASE_TOOL_RISK = {
|
|
58
|
+
Bash: 0.20,
|
|
59
|
+
Write: 0.15,
|
|
60
|
+
Edit: 0.10,
|
|
61
|
+
NotebookEdit: 0.10,
|
|
62
|
+
Read: 0.02,
|
|
63
|
+
Grep: 0.02,
|
|
64
|
+
Glob: 0.02,
|
|
65
|
+
Agent: 0.05,
|
|
66
|
+
// valor para herramientas no reconocidas
|
|
67
|
+
_otros: 0.03,
|
|
68
|
+
};
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* Retorna el riesgo base para un nombre de herramienta dado.
|
|
72
|
+
*
|
|
73
|
+
* @param {string} toolName
|
|
74
|
+
* @returns {number}
|
|
75
|
+
*/
|
|
76
|
+
function obtenerRiesgoBase(toolName) {
|
|
77
|
+
return BASE_TOOL_RISK[toolName] ?? BASE_TOOL_RISK._otros;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
// ---------------------------------------------------------------------------
|
|
81
|
+
// Eje 2 — File Sensitivity
|
|
82
|
+
// ---------------------------------------------------------------------------
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* Patrones de alta sensibilidad: contienen secretos, claves o configuración
|
|
86
|
+
* crítica de seguridad. Contribución: +0.25
|
|
87
|
+
*/
|
|
88
|
+
const PATRONES_ALTA_SENSIBILIDAD = [
|
|
89
|
+
/\.env\b/i,
|
|
90
|
+
/secret/i,
|
|
91
|
+
/credential/i,
|
|
92
|
+
/\btoken\b/i,
|
|
93
|
+
/\.pem$/i,
|
|
94
|
+
/id_rsa/i,
|
|
95
|
+
/\.key$/i,
|
|
96
|
+
/password/i,
|
|
97
|
+
/\.pfx$/i,
|
|
98
|
+
/\.p12$/i,
|
|
99
|
+
];
|
|
100
|
+
|
|
101
|
+
/**
|
|
102
|
+
* Patrones de sensibilidad media: manifiestos de dependencias, configuración
|
|
103
|
+
* de infraestructura, esquemas de BD o pipelines de CI/CD. Contribución: +0.15
|
|
104
|
+
*/
|
|
105
|
+
const PATRONES_MEDIA_SENSIBILIDAD = [
|
|
106
|
+
/package\.json$/i,
|
|
107
|
+
/Cargo\.toml$/i,
|
|
108
|
+
/go\.mod$/i,
|
|
109
|
+
/pom\.xml$/i,
|
|
110
|
+
/\.csproj$/i,
|
|
111
|
+
/Dockerfile/i,
|
|
112
|
+
/docker-compose/i,
|
|
113
|
+
/\.github[/\\]workflows/i,
|
|
114
|
+
/schema/i,
|
|
115
|
+
/migration/i,
|
|
116
|
+
/production/i,
|
|
117
|
+
/Makefile$/i,
|
|
118
|
+
/\.tf$/i,
|
|
119
|
+
/\.tfvars$/i,
|
|
120
|
+
];
|
|
121
|
+
|
|
122
|
+
/**
|
|
123
|
+
* Calcula el delta de sensibilidad del archivo para operaciones que reciben
|
|
124
|
+
* un file_path en su toolInput (Write, Edit, Read).
|
|
125
|
+
*
|
|
126
|
+
* @param {string} toolName
|
|
127
|
+
* @param {object} toolInput
|
|
128
|
+
* @returns {{ delta: number, factor: string|null }}
|
|
129
|
+
*/
|
|
130
|
+
function calcularFileSensitivity(toolName, toolInput) {
|
|
131
|
+
// Solo aplica a herramientas que operan sobre archivos
|
|
132
|
+
if (!['Write', 'Edit', 'Read'].includes(toolName)) {
|
|
133
|
+
return { delta: 0, factor: null };
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
const filePath = String(toolInput.file_path || toolInput.path || '');
|
|
137
|
+
if (!filePath) return { delta: 0, factor: null };
|
|
138
|
+
|
|
139
|
+
// Prioridad alta sobre media: verificar en orden descendente de severidad
|
|
140
|
+
for (const patron of PATRONES_ALTA_SENSIBILIDAD) {
|
|
141
|
+
if (patron.test(filePath)) {
|
|
142
|
+
return {
|
|
143
|
+
delta: 0.25,
|
|
144
|
+
factor: `Archivo de alta sensibilidad (${patron.toString()}) — ruta: ${filePath}`,
|
|
145
|
+
};
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
for (const patron of PATRONES_MEDIA_SENSIBILIDAD) {
|
|
150
|
+
if (patron.test(filePath)) {
|
|
151
|
+
return {
|
|
152
|
+
delta: 0.15,
|
|
153
|
+
factor: `Archivo de sensibilidad media (${patron.toString()}) — ruta: ${filePath}`,
|
|
154
|
+
};
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
return { delta: 0, factor: null };
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
// ---------------------------------------------------------------------------
|
|
162
|
+
// Eje 3 — Blast Radius
|
|
163
|
+
// ---------------------------------------------------------------------------
|
|
164
|
+
|
|
165
|
+
/**
|
|
166
|
+
* Patrones de alcance amplio: operaciones que afectan múltiples archivos o
|
|
167
|
+
* recursos de forma masiva / recursiva. Contribución: +0.35
|
|
168
|
+
*/
|
|
169
|
+
const PATRONES_BLAST_ALTO = [
|
|
170
|
+
/\brm\s+.*\*\*/, // rm con glob recursivo (no globs en grep/ls/echo)
|
|
171
|
+
/\brm\s+.*\/\*/, // rm con wildcard de directorio
|
|
172
|
+
/--all\b/,
|
|
173
|
+
/--recursive\b/,
|
|
174
|
+
/\bfind\s+\.\s+-.*\bdelete\b/, // find con -delete (destructivo)
|
|
175
|
+
/\bxargs\s+rm\b/, // xargs rm (destructivo)
|
|
176
|
+
/chmod\s+-R\b/,
|
|
177
|
+
/chown\s+-R\b/,
|
|
178
|
+
];
|
|
179
|
+
|
|
180
|
+
/**
|
|
181
|
+
* Patrones de alcance de publicación/despliegue: operaciones que propagan
|
|
182
|
+
* cambios a sistemas externos. Contribución: +0.25
|
|
183
|
+
*/
|
|
184
|
+
const PATRONES_BLAST_MEDIO = [
|
|
185
|
+
/\bgit\s+push\b/,
|
|
186
|
+
/\bnpm\s+publish\b/,
|
|
187
|
+
/\bdocker\s+push\b/,
|
|
188
|
+
/\bkubectl\s+apply\b/,
|
|
189
|
+
/\bterraform\s+apply\b/,
|
|
190
|
+
];
|
|
191
|
+
|
|
192
|
+
/**
|
|
193
|
+
* Calcula el delta de blast radius para comandos Bash.
|
|
194
|
+
*
|
|
195
|
+
* @param {string} toolName
|
|
196
|
+
* @param {object} toolInput
|
|
197
|
+
* @returns {{ delta: number, factor: string|null }}
|
|
198
|
+
*/
|
|
199
|
+
function calcularBlastRadius(toolName, toolInput) {
|
|
200
|
+
if (toolName !== 'Bash') return { delta: 0, factor: null };
|
|
201
|
+
|
|
202
|
+
const comando = String(toolInput.command || '');
|
|
203
|
+
if (!comando) return { delta: 0, factor: null };
|
|
204
|
+
|
|
205
|
+
// Prioridad alto sobre medio
|
|
206
|
+
for (const patron of PATRONES_BLAST_ALTO) {
|
|
207
|
+
if (patron.test(comando)) {
|
|
208
|
+
return {
|
|
209
|
+
delta: 0.35,
|
|
210
|
+
factor: `Blast radius alto — patrón de alcance masivo detectado: ${patron.toString()}`,
|
|
211
|
+
};
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
for (const patron of PATRONES_BLAST_MEDIO) {
|
|
216
|
+
if (patron.test(comando)) {
|
|
217
|
+
return {
|
|
218
|
+
delta: 0.25,
|
|
219
|
+
factor: `Blast radius medio — operación de publicación/despliegue: ${patron.toString()}`,
|
|
220
|
+
};
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
return { delta: 0, factor: null };
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
// ---------------------------------------------------------------------------
|
|
228
|
+
// Eje 4 — Irreversibility
|
|
229
|
+
// ---------------------------------------------------------------------------
|
|
230
|
+
|
|
231
|
+
/**
|
|
232
|
+
* Patrones de alta irreversibilidad: operaciones que destruyen datos de forma
|
|
233
|
+
* permanente o difícilmente recuperable. Contribución: +0.45
|
|
234
|
+
*/
|
|
235
|
+
const PATRONES_IRREVERSIBLE_ALTO = [
|
|
236
|
+
/\brm\s+-rf\b/,
|
|
237
|
+
/\bgit\s+reset\s+--hard\b/,
|
|
238
|
+
/\bdrop\s+database\b/i,
|
|
239
|
+
/\btruncate\s+table\b/i,
|
|
240
|
+
/\bDROP\s+TABLE\b/i,
|
|
241
|
+
/\bformat\s+[A-Z]:/i, // format C: / format D: (disk formatting, not dotnet format)
|
|
242
|
+
/\bfdisk\b/,
|
|
243
|
+
/\bmkfs\b/,
|
|
244
|
+
];
|
|
245
|
+
|
|
246
|
+
/**
|
|
247
|
+
* Patrones de irreversibilidad media: operaciones que sobrescriben o eliminan
|
|
248
|
+
* con cierta dificultad de recuperación. Contribución: +0.35
|
|
249
|
+
*/
|
|
250
|
+
const PATRONES_IRREVERSIBLE_MEDIO = [
|
|
251
|
+
/\brm\s+-f\b/,
|
|
252
|
+
/\bgit\s+push\s+--force\b/,
|
|
253
|
+
/\bgit\s+push\s+-f\b/,
|
|
254
|
+
/\bDELETE\s+FROM\b/i,
|
|
255
|
+
/\bgit\s+clean\s+-fd\b/,
|
|
256
|
+
/\bdocker\s+system\s+prune\b/,
|
|
257
|
+
];
|
|
258
|
+
|
|
259
|
+
/**
|
|
260
|
+
* Calcula el delta de irreversibilidad para comandos Bash.
|
|
261
|
+
*
|
|
262
|
+
* @param {string} toolName
|
|
263
|
+
* @param {object} toolInput
|
|
264
|
+
* @returns {{ delta: number, factor: string|null }}
|
|
265
|
+
*/
|
|
266
|
+
function calcularIrreversibilidad(toolName, toolInput) {
|
|
267
|
+
if (toolName !== 'Bash') return { delta: 0, factor: null };
|
|
268
|
+
|
|
269
|
+
const comando = String(toolInput.command || '');
|
|
270
|
+
if (!comando) return { delta: 0, factor: null };
|
|
271
|
+
|
|
272
|
+
// Prioridad alto sobre medio
|
|
273
|
+
for (const patron of PATRONES_IRREVERSIBLE_ALTO) {
|
|
274
|
+
if (patron.test(comando)) {
|
|
275
|
+
return {
|
|
276
|
+
delta: 0.45,
|
|
277
|
+
factor: `Irreversibilidad alta — operación destructiva permanente: ${patron.toString()}`,
|
|
278
|
+
};
|
|
279
|
+
}
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
for (const patron of PATRONES_IRREVERSIBLE_MEDIO) {
|
|
283
|
+
if (patron.test(comando)) {
|
|
284
|
+
return {
|
|
285
|
+
delta: 0.35,
|
|
286
|
+
factor: `Irreversibilidad media — operación difícilmente reversible: ${patron.toString()}`,
|
|
287
|
+
};
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
return { delta: 0, factor: null };
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
// ---------------------------------------------------------------------------
|
|
295
|
+
// Clasificación de nivel
|
|
296
|
+
// ---------------------------------------------------------------------------
|
|
297
|
+
|
|
298
|
+
/**
|
|
299
|
+
* Clasifica un score numérico en un nivel de decisión usando los umbrales dados.
|
|
300
|
+
*
|
|
301
|
+
* @param {number} score - Score en [0.0, 1.0].
|
|
302
|
+
* @param {object} umbrales - Objeto { allow, review, confirm }.
|
|
303
|
+
* @returns {'allow'|'review'|'confirm'|'block'}
|
|
304
|
+
*/
|
|
305
|
+
function clasificarNivel(score, umbrales) {
|
|
306
|
+
if (score >= umbrales.confirm) return 'block';
|
|
307
|
+
if (score >= umbrales.review) return 'confirm';
|
|
308
|
+
if (score >= umbrales.allow) return 'review';
|
|
309
|
+
return 'allow';
|
|
310
|
+
}
|
|
311
|
+
|
|
312
|
+
// ---------------------------------------------------------------------------
|
|
313
|
+
// API pública
|
|
314
|
+
// ---------------------------------------------------------------------------
|
|
315
|
+
|
|
316
|
+
/**
|
|
317
|
+
* Calcula el score de riesgo compuesto para una operación de Claude Code.
|
|
318
|
+
*
|
|
319
|
+
* La fórmula aplicada es:
|
|
320
|
+
* score = min(1.0, baseRisk + fileSensitivity + blastRadius + irreversibility)
|
|
321
|
+
*
|
|
322
|
+
* @param {string} toolName - Nombre de la herramienta (Bash, Write, Edit, etc.).
|
|
323
|
+
* @param {object} toolInput - Parámetros de la herramienta tal como los recibe el hook.
|
|
324
|
+
* @param {object} [umbrales=UMBRALES_DEFAULT] - Umbrales de clasificación a usar.
|
|
325
|
+
* @returns {{ score: number, level: string, factors: string[] }}
|
|
326
|
+
* - score: Valor entre 0.0 y 1.0 (2 decimales).
|
|
327
|
+
* - level: 'allow' | 'review' | 'confirm' | 'block'.
|
|
328
|
+
* - factors: Descripciones de los factores que contribuyeron al score.
|
|
329
|
+
*/
|
|
330
|
+
function calcularRiskScore(toolName, toolInput, umbrales = UMBRALES_DEFAULT) {
|
|
331
|
+
const factors = [];
|
|
332
|
+
|
|
333
|
+
// Eje 1 — Base risk
|
|
334
|
+
const baseRisk = obtenerRiesgoBase(toolName);
|
|
335
|
+
// Solo registrar el factor base si hay contribución no trivial (> 0)
|
|
336
|
+
if (baseRisk > 0) {
|
|
337
|
+
factors.push(`Riesgo base de herramienta "${toolName}": +${baseRisk.toFixed(2)}`);
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
// Eje 2 — File sensitivity
|
|
341
|
+
const { delta: deltaFile, factor: factorFile } = calcularFileSensitivity(toolName, toolInput);
|
|
342
|
+
if (deltaFile > 0 && factorFile) factors.push(factorFile);
|
|
343
|
+
|
|
344
|
+
// Eje 3 — Blast radius
|
|
345
|
+
const { delta: deltaBlast, factor: factorBlast } = calcularBlastRadius(toolName, toolInput);
|
|
346
|
+
if (deltaBlast > 0 && factorBlast) factors.push(factorBlast);
|
|
347
|
+
|
|
348
|
+
// Eje 4 — Irreversibility
|
|
349
|
+
const { delta: deltaIrrev, factor: factorIrrev } = calcularIrreversibilidad(toolName, toolInput);
|
|
350
|
+
if (deltaIrrev > 0 && factorIrrev) factors.push(factorIrrev);
|
|
351
|
+
|
|
352
|
+
// Score compuesto, acotado a [0.0, 1.0]
|
|
353
|
+
const scoreRaw = baseRisk + deltaFile + deltaBlast + deltaIrrev;
|
|
354
|
+
const score = Math.min(1.0, parseFloat(scoreRaw.toFixed(2)));
|
|
355
|
+
|
|
356
|
+
const level = clasificarNivel(score, umbrales);
|
|
357
|
+
|
|
358
|
+
return { score, level, factors };
|
|
359
|
+
}
|
|
360
|
+
|
|
361
|
+
// ---------------------------------------------------------------------------
|
|
362
|
+
// Exportaciones
|
|
363
|
+
// ---------------------------------------------------------------------------
|
|
364
|
+
|
|
365
|
+
module.exports = {
|
|
366
|
+
calcularRiskScore,
|
|
367
|
+
UMBRALES_DEFAULT,
|
|
368
|
+
};
|