@saulwade/swl-ses 2.3.0 → 2.3.1

package/CLAUDE.md

@@ -1,4 +1,4 @@
-# CLAUDE.md — @saulwade/swl-ses v2.3.0
+# CLAUDE.md — @saulwade/swl-ses v2.3.1
 
 ## Reglas de máxima prioridad (aplican SIEMPRE, sin excepción)
 
@@ -158,17 +158,19 @@ Catálogo completo y matchers en `@INVENTARIO.md` sección Reglas.
 
 Asignar el modelo correcto a cada agente según la criticidad e irreversibilidad de la tarea.
 
-| Nivel | Modelo | Campo en frontmatter | Agentes SWL | Criterio |
+| Nivel | Alias (resuelve a) | Campo en frontmatter | Agentes SWL | Criterio |
 |-------|--------|---------------------|-------------|----------|
-| **Crítico** | `claude-opus-4-8` | `model: claude-opus-4-8` | orquestador, arquitecto, revisor-seguridad, producto-prd | Decisiones irreversibles (arquitectura, seguridad, PRD) |
-| **Estándar** | `claude-sonnet-4-6` | `model: claude-sonnet-4-6` | backend-*, frontend-*, mobile-*, tdd-qa, revisores de lenguaje | Implementación y revisión |
-| **Ligero** | `claude-haiku-4-5-20251001` | `model: claude-haiku-4-5-20251001` | notificador, resolutor-build (búsquedas) | Operaciones deterministas rápidas |
+| **Crítico** | `opus` (hoy Opus 4.8) | `model: opus` | orquestador, arquitecto, revisor-seguridad, producto-prd | Decisiones irreversibles (arquitectura, seguridad, PRD) |
+| **Estándar** | `sonnet` (hoy Sonnet 5) | `model: sonnet` | backend-*, frontend-*, mobile-*, tdd-qa, revisores de lenguaje | Implementación y revisión |
+| **Ligero** | `haiku` (hoy Haiku 4.5) | `model: haiku` | notificador, resolutor-build (búsquedas) | Operaciones deterministas rápidas |
 | **Heredado** | (del padre) | `model: inherit` | Sub-agentes invocados por el orquestador | El padre decide |
 
+**Por qué alias y no ID pineado**: el frontmatter usa alias (`opus`/`sonnet`/`haiku`), no IDs completos. El alias *resuelve al modelo vigente de su familia y se actualiza solo* ([doc oficial](https://code.claude.com/docs/en/model-config): "aliases point to the recommended version and update over time"). Esto elimina la migración manual en cada release de modelo (antes: opus 4.7→4.8, sonnet 4.6→5). En Bedrock/Vertex el alias resuelve al modelo que ese proveedor sí ofrece, evitando IDs inexistentes; y degrada limpio en versiones antiguas de Claude Code. **Caveat**: los alias son un constructo de Claude Code, no de la API cruda — el código que llama a la API/SDK directamente (`gateway/agent-executor.js`, tablas de precios/telemetría) sí usa el ID completo (`claude-sonnet-5`).
+
 **Reglas de asignación**: decisiones no reversibles → Opus; código → Sonnet; búsqueda/notificación → Haiku.
 NUNCA usar Opus para tareas que Sonnet resuelve igual de bien.
 
-**Workflow Opus 4.8**: tratar como ingeniero al que se delega (spec completa: intent + constraints + acceptance criteria + file locations). Sigue instrucciones literalmente — eliminar ambigüedad. Effort levels nativos: `high | xhigh | max`.
+**Workflow Opus 4.8 / Sonnet 5**: tratar como ingeniero al que se delega (spec completa: intent + constraints + acceptance criteria + file locations). Sigue instrucciones literalmente — eliminar ambigüedad. Effort levels nativos: `low | medium | high | xhigh | max` (Sonnet 5 y Opus 4.8; Sonnet 4.6 no soportaba `xhigh`).
 
 ---
 
@@ -197,3 +199,42 @@ Resumen mínimo para uso inmediato:
 - **Skill responsable**: `Skill("doc-sync") § Protocolo proactivo` (sub-secciones Tipo 1 a Tipo 8) tiene el detalle prescriptivo.
 - **Antes de commit estructural**: regenerar inventario, validar manifiestos, verificar evolución (si tocó skill/agente), correr verificador docs-vs-código, suite completa, gate de release. Checklist exacto en `@docs/mapa-propagacion.md § Checklist único`.
 - Si cualquier gate falla, **NO commitear** hasta corregir. Regla `arreglar-al-detectar.md` exige resolver en mismo turno.
+
+<!-- code-review-graph MCP tools -->
+## MCP Tools: code-review-graph
+
+**IMPORTANT: This project has a knowledge graph. ALWAYS use the
+code-review-graph MCP tools BEFORE using Grep/Glob/Read to explore
+the codebase.** The graph is faster, cheaper (fewer tokens), and gives
+you structural context (callers, dependents, test coverage) that file
+scanning cannot.
+
+### When to use graph tools FIRST
+
+- **Exploring code**: `semantic_search_nodes` or `query_graph` instead of Grep
+- **Understanding impact**: `get_impact_radius` instead of manually tracing imports
+- **Code review**: `detect_changes` + `get_review_context` instead of reading entire files
+- **Finding relationships**: `query_graph` with callers_of/callees_of/imports_of/tests_for
+- **Architecture questions**: `get_architecture_overview` + `list_communities`
+
+Fall back to Grep/Glob/Read **only** when the graph doesn't cover what you need.
+
+### Key Tools
+
+| Tool | Use when |
+|------|----------|
+| `detect_changes` | Reviewing code changes — gives risk-scored analysis |
+| `get_review_context` | Need source snippets for review — token-efficient |
+| `get_impact_radius` | Understanding blast radius of a change |
+| `get_affected_flows` | Finding which execution paths are impacted |
+| `query_graph` | Tracing callers, callees, imports, tests, dependencies |
+| `semantic_search_nodes` | Finding functions/classes by name or keyword |
+| `get_architecture_overview` | Understanding high-level codebase structure |
+| `refactor_tool` | Planning renames, finding dead code |
+
+### Workflow
+
+1. The graph auto-updates on file changes (via hooks).
+2. Use `detect_changes` for code review.
+3. Use `get_affected_flows` to understand impact.
+4. Use `query_graph` pattern="tests_for" to check coverage.

package/README.md

@@ -1,4 +1,4 @@
-# swl-ses v2.3.0
+# swl-ses v2.3.1
 
 > El paquete anterior `@saulwadeleon/swl-software-engineering-system` está deprecado. Migrar a `@saulwade/swl-ses` (npmjs.org canónico) o `@saul-wade/swl-ses` (mirror en GitHub Packages) — el CLI `swl-ses` no cambia.