@saulwade/swl-ses 2.2.1 → 2.2.4

package/habilidades/prompt-engineering/SKILL.md

@@ -3,7 +3,7 @@ name: prompt-engineering
 description: >
   Diseño y optimización de prompts para LLMs: chain-of-thought, few-shot,
   system prompts, structured outputs y técnicas de evaluación. Incluye guía
-  para Claude Opus 4.7 y su patrón de instrucciones literales vs inferidas.
+  para Claude Opus 4.8 y su patrón de instrucciones literales vs inferidas.
   Cargar cuando se diseñen system prompts, se optimice la calidad de
   respuestas LLM, se implemente prompt chaining, o se evalúe la efectividad
   de prompts.
@@ -26,15 +26,15 @@ exclusiones:
 - La tarea es fine-tuning o ajuste de pesos de un modelo: usar documentación del proveedor directamente.
 
 
-## Prompts literales vs inferidos (Opus 4.7)
+## Prompts literales vs inferidos (Opus 4.8)
 
-Desde Claude Opus 4.7 (abril 2026), Anthropic cambió cómo el modelo interpreta
+Desde Claude Opus 4.8 (abril 2026), Anthropic cambió cómo el modelo interpreta
 instrucciones ambiguas:
 
 - **Opus 4.6 y anteriores**: rellenaban ambigüedades con inferencia razonable.
   Un prompt como "agrega validación al formulario" generaba validación completa
   con reglas de dominio típicas.
-- **Opus 4.7**: sigue instrucciones de forma más literal. El mismo prompt ahora
+- **Opus 4.8**: sigue instrucciones de forma más literal. El mismo prompt ahora
   genera validación mínima (o pregunta qué validar) porque la instrucción
   literal no especifica qué campos ni qué reglas.
 
@@ -73,7 +73,7 @@ validación fallando."""
 
 ### Effort levels vs verbosidad
 
-Opus 4.7 no mezcla "cuánto pensar" con "cuán verboso ser". Son ejes distintos:
+Opus 4.8 no mezcla "cuánto pensar" con "cuán verboso ser". Son ejes distintos:
 
 | Eje | Control |
 |-----|---------|

package/habilidades/release-semver/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: release-semver
 description: Versionado semántico (SemVer). Cuándo bumpar major/minor/patch, changelogs convencionales, estrategia de tags y proceso de release completo.
-version: "1.0.2"
+version: "1.0.3"
 herramientasPermitidas: [Read, Bash]
 exclusiones:
   - "No cargar para versionar el sistema SWL — el bump de versión de swl-ses sigue el checklist de 15 ubicaciones documentado en `/swl:release`; este skill cubre SemVer general para proyectos de usuario, no el proceso interno de release del sistema."
@@ -325,3 +325,6 @@ de token inválido.
 - **Changelog generado con `git cliff` sin configuración personalizada incluye commits de chore y docs**: el CHANGELOG.md resultante tiene 80% de entradas de limpieza que no interesan a los consumidores. Causa: `git cliff` sin `.cliff.toml` incluye todos los tipos de commit. Solución: crear `.cliff.toml` en el repo con la sección `[git]` filtrando solo `feat`, `fix`, `perf` y `BREAKING CHANGE` para el changelog de release público.
 - **Rama `release/2.1.0` mergeada a `main` pero no a `develop`**: el próximo desarrollo parte de `develop` sin incluir los commits del release, generando conflictos en la siguiente rama de feature. Causa: el Paso 4 requiere merge a ambas ramas pero se omite el merge a `develop` por considerar que el release ya está en `main`. Solución: el proceso de release de 4 pasos del skill requiere merge a `main` Y a `develop` antes de eliminar la rama de release — ambos merges son parte del mismo paso atómico.
 - **`npx <paquete> <comando>` sin `@latest` usa caché stale indefinidamente**: tras publicar una nueva versión, `npx swl-ses doctor` sigue ejecutando la primera versión que el usuario cacheó (por ejemplo v5.7.0 cuando ya hay v5.10.3 instalada). Causa: npx resuelve a la primera versión disponible y la cachea; sin `@latest` nunca vuelve a consultar el registry. Solución: SIEMPRE usar `npx paquete@latest <comando>` en mensajes post-install, hooks de alerta de nueva versión, docs del README, ejemplos en CHANGELOG y scripts de inicialización. Nunca `npx paquete <comando>` desnudo — incluso si el paquete acaba de publicarse; el caché de un desarrollador vecino puede tener una versión anterior desde hace meses. Un bump sin `@latest` en los mensajes post-install perpetúa el problema para todos los usuarios nuevos.
+- **`npm pack --ignore-scripts` mete `__pycache__/*.pyc` (o cualquier artefacto del `prepack`) en el tarball publicado**: al saltar `--ignore-scripts` el lifecycle `prepack`, se omite la limpieza de artefactos que suele ser el ÚNICO filtro efectivo — un `.npmignore` con `**/*.pyc` NO los excluye de forma fiable cuando `package.json#files` es un allowlist (los paths del allowlist se incluyen y `.npmignore` no los poda). Causa: usar `--ignore-scripts` para "acelerar" un `npm pack`/publish manual. Solución: usar `npm pack` a secas — el `prepack` (rápido) limpia el árbol; `prepublishOnly` (lento, tests) solo corre en `npm publish`, NO en `pack`, así que no hay nada que "ahorrar". Señal de alerta: un salto inesperado en `total files` del tarball (p.ej. +1) suele ser un artefacto colado.
+- **Log de release con `createWriteStream` queda VACÍO al `process.exit()`**: un script de publicación que abre el log con `fs.createWriteStream` (async) y termina con `process.exit(code)` no alcanza a vaciar el buffer del stream a disco antes de que el proceso muera — justo cuando más se necesita el log para diagnosticar el fallo. Causa: asumir que `stream.end()` antes de `process.exit()` fuerza el flush (es asíncrono, no lo garantiza). Solución: para logs que DEBEN sobrevivir un `exit` inmediato, usar escritura SÍNCRONA: `fs.writeFileSync` (header) + `fs.appendFileSync` (cada chunk), que vacían en cada llamada.
+- **Forzar prompt de OTP TOTP rompe a usuarios con passkey/WebAuthn**: un wrapper de publish que intercepta el `EOTP` de npm y pide un código de 6 dígitos asume 2FA tipo TOTP; si la cuenta usa passkey (flujo web "abrir URL y seleccionar la llave") el prompt es un callejón sin salida. Causa: tratar `EOTP` como sinónimo de "pedir TOTP". Solución: ante `EOTP` con TTY, reintentar el `npm publish` con **stdio heredado** (`stdio: 'inherit'`) y dejar que npm conduzca su 2FA NATIVO — soporta TOTP Y passkey según la cuenta. Alternativa permanente sin 2FA: token **Automation** (no "Publish", que sí exige 2FA).

package/habilidades/workflow-claude-code/SKILL.md

@@ -3,7 +3,7 @@ name: workflow-claude-code
 description: >
   Patrones de flujo de trabajo diario con Claude Code: gestión de sesiones,
   atajos de teclado, Plan Mode, feature-per-session, gestión de contexto,
-  jerarquía de memoria, handoff multi-sesión, niveles de esfuerzo de Opus 4.7
+  jerarquía de memoria, handoff multi-sesión, niveles de esfuerzo de Opus 4.8
   (high/xhigh/max) y el patrón de delegación. Cargar cuando el usuario pregunte
   cómo usar Claude Code eficientemente, cuando necesite optimizar su flujo de
   trabajo, o cuando inicie un proyecto nuevo. NO cargar para estructura de
@@ -189,9 +189,9 @@ Para ESTRUCTURA de proyecto, usar `estructura-proyecto-claude`.
 
 ---
 
-## Patrón de delegación con Opus 4.7 (desde abril 2026)
+## Patrón de delegación con Opus 4.8 (desde abril 2026)
 
-Opus 4.7 introduce un shift operativo importante: **rinde mejor tratado como un
+Opus 4.8 introduce un shift operativo importante: **rinde mejor tratado como un
 ingeniero al que delegas, no como un pair programmer al que guías línea por línea**.
 Fuente: https://claude.com/blog/best-practices-for-using-claude-opus-4-7-with-claude-code
 
@@ -228,7 +228,7 @@ el modelo decide dinámicamente cuánto razonar según la tarea.
 
 ### Sub-agentes: paralelismo explícito
 
-Opus 4.7 usa menos sub-agentes por defecto que 4.6. Si una tarea se beneficia
+Opus 4.8 usa menos sub-agentes por defecto que 4.6. Si una tarea se beneficia
 de ejecución paralela, declararlo en el prompt:
 
 - "Ejecuta estos 3 análisis en paralelo" > confiar en que lo decidirá solo.
@@ -236,7 +236,7 @@ de ejecución paralela, declararlo en el prompt:
 
 ### Instrucciones literales
 
-Opus 4.7 interpreta instrucciones de forma más literal. Los prompts ambiguos
+Opus 4.8 interpreta instrucciones de forma más literal. Los prompts ambiguos
 que 4.6 resolvía por inferencia ahora se ejecutan al pie de la letra. Invertir
 tiempo en eliminar ambigüedad al inicio ahorra iteraciones.
 
@@ -257,4 +257,4 @@ y quick reference completa, ver [recursos/referencia-completa.md](recursos/refer
 - **Sesión de >40 turnos sin compactar**: el agente no monitorea el conteo de turnos y continúa trabajando hasta que Claude empieza a "olvidar" decisiones tomadas temprano en la sesión. Causa: no se aplica la señal de context rot (40 turnos). Solución: al llegar a 40 turnos, ejecutar `/swl:compactar` antes de la siguiente tarea grande — no esperar a que la degradación sea visible en la calidad del output.
 - **CLAUDE.md superando 200 líneas sin subdirectorios**: el proyecto crece y todo el contexto se acumula en el CLAUDE.md raíz, incrementando la carga base de contexto de cada conversación. Causa: no se crean CLAUDE.md de subdirectorio para módulos como `backend/` o `frontend/`. Solución: extraer convenciones específicas de módulo a su propio `<directorio>/CLAUDE.md`; el CLAUDE.md raíz mantiene solo lo global.
 - **Auto Accept Mode activado en operaciones destructivas**: el usuario activa `Shift+Tab` para acelerar trabajo y olvida cambiarlo antes de un deploy o borrado de archivos. Causa: el modo no tiene contexto de operación. Solución: volver a Default Mode explícitamente antes de operaciones irreversibles (`Shift+Tab` de vuelta) — Auto Accept es para generación de código, no para operaciones con blast radius alto.
-- **Tokenizer 4.7 subestimado en presupuesto de contexto**: el mismo CLAUDE.md que ocupaba el 30% del contexto en Opus 4.6 ocupa hasta 40% en 4.7 debido al tokenizer más granular. Causa: el umbral de compactación no se recalibró al migrar de modelo. Solución: con Opus 4.7, bajar el umbral de compactación de 70% a 50% tal como indica el skill `compactacion-contexto`.
+- **Tokenizer 4.7 subestimado en presupuesto de contexto**: el mismo CLAUDE.md que ocupaba el 30% del contexto en Opus 4.6 ocupa hasta 40% en 4.7 debido al tokenizer más granular. Causa: el umbral de compactación no se recalibró al migrar de modelo. Solución: con Opus 4.8, bajar el umbral de compactación de 70% a 50% tal como indica el skill `compactacion-contexto`.

package/hooks/lib/context-builder.js

@@ -19,7 +19,7 @@
 const fs   = require('fs');
 const path = require('path');
 
-const DEFAULT_TOKEN_BUDGET = 2500; // Recalibrado para Opus 4.7 (tokenizer 1.0-1.35x vs 4.6)
+const DEFAULT_TOKEN_BUDGET = 2500; // Recalibrado para Opus 4.8 (tokenizer 1.0-1.35x vs 4.6)
 const CHARS_POR_TOKEN      = 4; // Heuristica para espanol
 
 // ---------------------------------------------------------------------------
@@ -211,7 +211,7 @@ function buildAprendizajes(baseDir, max, budgetRestante) {
  *
  * @param {string} baseDir - Directorio raiz del proyecto.
  * @param {object} [opciones]
- * @param {number} [opciones.tokenBudget=2500]    - Presupuesto de tokens (default 2500 — recalibrado para Opus 4.7).
+ * @param {number} [opciones.tokenBudget=2500]    - Presupuesto de tokens (default 2500 — recalibrado para Opus 4.8).
  * @param {number} [opciones.maxAprendizajes=5]   - Max aprendizajes a incluir.
  * @param {number} [opciones.maxInstintos=5]       - Max instintos a incluir.
  * @returns {{ contexto: string, tokensUsados: number, seccionesTruncadas: string[] }}

package/hooks/lib/etapa-perfil-usuario.js

@@ -251,7 +251,7 @@ function ejecutar(inputRaw) {
     //    cada sesión.
     const señalesKw = detectarKeywords(textoUsuario)
       .map(s => {
-        const r = scanInjection(s.snippet, 'perfil-usuario/dirty.json');
+        const r = scanInjection(s.snippet, 'user-profile/dirty.json');
         return { ...s, _scan: r };
       })
       .filter(s => {

package/hooks/lib/model-router.js

@@ -182,7 +182,7 @@ const PROVEEDORES = {
   anthropic: {
     nombre: 'Anthropic',
     modelos: {
-      opus:   'claude-opus-4-7',
+      opus:   'claude-opus-4-8',
       sonnet: 'claude-sonnet-4-6',
       haiku:  'claude-haiku-4-5-20251001',
     },

package/hooks/lib/token-estimator.js

@@ -87,6 +87,7 @@ const COSTO_DEFAULT_POR_MILLON = 3.0;
  */
 const PRICING_CANONICO = {
   // Anthropic — precios por 1M tokens (nombres canónicos)
+  'claude-opus-4-8':                        { input: 15.00, output: 75.00, cacheRead: 1.50,  cacheWrite: 18.75 },
   'claude-opus-4-7':                        { input: 15.00, output: 75.00, cacheRead: 1.50,  cacheWrite: 18.75 },
   'claude-opus-4-6':                        { input: 15.00, output: 75.00, cacheRead: 1.50,  cacheWrite: 18.75 },
   'claude-opus-4-5':                        { input: 15.00, output: 75.00, cacheRead: 1.50,  cacheWrite: 18.75 },
@@ -97,6 +98,7 @@ const PRICING_CANONICO = {
   'claude-haiku-4-5':                       { input:  0.80, output:  4.00, cacheRead: 0.08,  cacheWrite:  1.00 },
   'claude-3-5-haiku':                       { input:  0.80, output:  4.00, cacheRead: 0.08,  cacheWrite:  1.00 },
   // Aliases con prefijo anthropic/ (compatibilidad con mission-control y gateways)
+  'anthropic/claude-opus-4-8':              { input: 15.00, output: 75.00, cacheRead: 1.50,  cacheWrite: 18.75 },
   'anthropic/claude-opus-4-7':              { input: 15.00, output: 75.00, cacheRead: 1.50,  cacheWrite: 18.75 },
   'anthropic/claude-opus-4-6':              { input: 15.00, output: 75.00, cacheRead: 1.50,  cacheWrite: 18.75 },
   'anthropic/claude-opus-4-5':              { input: 15.00, output: 75.00, cacheRead: 1.50,  cacheWrite: 18.75 },

package/hooks/linea-estado.js

@@ -43,15 +43,17 @@ const TOKENS_MAXIMOS_DEFAULT = 200_000;
  *
  * IMPORTANTE: las claves son prefijos del `model_id` reportado por Claude Code
  * en el evento del hook. La detección hace `modelId.includes(prefijo)` en orden;
- * los prefijos más específicos van primero para que `claude-opus-4-7` no
+ * los prefijos más específicos van primero para que `claude-opus-4-8` no
  * matchee accidentalmente con la entrada genérica `claude-opus`.
  *
- * Si el `model_id` contiene el sufijo `[1m]` (ej: `claude-opus-4-7[1m]`), el
+ * Si el `model_id` contiene el sufijo `[1m]` (ej: `claude-opus-4-8[1m]`), el
  * techo se fuerza a 1M independientemente del modelo base — Anthropic usa
  * ese sufijo para indicar la variante de 1M context.
  */
 const TECHOS_POR_MODELO = {
-  // Opus 4.7 — variante de 1M context (la actual por defecto)
+  // Opus 4.8 — variante de 1M context (la actual por defecto)
+  'claude-opus-4-8':  1_000_000,
+  // Opus 4.7 — variante de 1M context (histórica)
   'claude-opus-4-7':  1_000_000,
   // Resto de modelos modernos: 200k context
   'claude-opus-4-6':    200_000,
@@ -84,7 +86,7 @@ const ETIQUETAS_MODELO = {
  *   3. Default → TOKENS_MAXIMOS_DEFAULT (200k).
  *
  * @param {string} modelId - Identificador completo del modelo, posiblemente
- *                           con sufijo de variante (ej: `claude-opus-4-7[1m]`).
+ *                           con sufijo de variante (ej: `claude-opus-4-8[1m]`).
  * @returns {number} Techo de tokens del contexto.
  */
 function techoTokens(modelId) {
@@ -261,7 +263,7 @@ process.stdin.on('end', () => {
     // Ruta del archivo bridge compartido entre hooks
     const bridgePath = path.join(os.tmpdir(), `swl-ctx-${sessionId}.json`);
 
-    // Resolver techo según modelo (Opus 4.7 con sufijo [1m] = 1M; resto 200k)
+    // Resolver techo según modelo (Opus 4.8 con sufijo [1m] = 1M; resto 200k)
     const techo = techoTokens(modelId);
 
     // Calcular métricas

package/hooks/resumen-sesion.js

@@ -85,10 +85,10 @@ function hooksDisparados(sessionId) {
   try {
     const planningDir = path.join(process.cwd(), '.planning');
     const jsonlCandidatos = [
-      ['evolucion/nudges.jsonl', 'nudge-tracker'],
-      ['auto-evolucion/agentes.jsonl', 'auto-evolucion'],
-      ['perfil-usuario/dirty.json', 'actualizar-perfil-usuario'],
-      ['evolucion/metricas.json', 'metricas-evolucion'],
+      ['evolution/nudges.jsonl', 'nudge-tracker'],
+      ['auto-evolution/agentes.jsonl', 'auto-evolucion'],
+      ['user-profile/dirty.json', 'actualizar-perfil-usuario'],
+      ['evolution/metricas.json', 'metricas-evolucion'],
     ];
     for (const [rel, nombre] of jsonlCandidatos) {
       const p = path.join(planningDir, rel);

package/llms.txt

@@ -1,6 +1,6 @@
 # swl-ses (@saulwade/swl-ses)
 
-> Sistema de ingeniería de software auto-evolutivo multi-runtime polyglot (SDLC completo), distribuido como paquete npm y plugin de Claude Code. 60 agentes, 182 habilidades, 44 comandos, 37 reglas base y 48 hooks. Soporta 11 lenguajes y 7 runtimes (Claude Code, OpenClaude, OpenCode, Gemini, Cursor, Codex, Copilot). Versión 2.2.1.
+> Sistema de ingeniería de software auto-evolutivo multi-runtime polyglot (SDLC completo), distribuido como paquete npm y plugin de Claude Code. 60 agentes, 182 habilidades, 44 comandos, 37 reglas base y 48 hooks. Soporta 11 lenguajes y 7 runtimes (Claude Code, OpenClaude, OpenCode, Gemini, Cursor, Codex, Copilot). Versión 2.2.4.
 
 Archivo generado por `node scripts/generar-inventario.js` — no editar a mano. Las cifras se sincronizan con INVENTARIO.md en cada regeneración.