@saulwade/swl-ses 2.6.1 → 2.8.0

package/CLAUDE.md

@@ -1,4 +1,4 @@
-# CLAUDE.md — @saulwade/swl-ses v2.6.1
+# CLAUDE.md — @saulwade/swl-ses v2.8.0
 
 ## Reglas de máxima prioridad (aplican SIEMPRE, sin excepción)
 
@@ -42,7 +42,8 @@ NUNCA asumir, sugerir como hecho consumado, ni escribir en ADRs/manifiestos/CHAN
 | `npm run test:release` | test:all + test:userland + smoke (gate pre-publish) |
 | `npm run test:validate` | `node scripts/validar.js` — validación estructural completa |
 | `npm run test:manifest` | `node scripts/validar-manifest.js` — coherencia modulos/hooks |
-| `npm run test:smoke` | Smoke test del instalador |
+| `npm run test:smoke` | Smoke test del instalador (install → doctor → uninstall, desde el árbol fuente) |
+| `node scripts/verificar-empaquetado-downstream.js` | Ciclo `pack → install → doctor → update → uninstall` sobre el tarball REAL de `npm pack` (no el árbol fuente); verifica contenido del tarball (requeridos/prohibidos) e invariantes de claims/versión. Invocación directa — NO en `package.json#scripts` (esa superficie está congelada por `tests/scripts/generar-harness-ir.test.js` desde `aa9b08a`/F29; ver F31-T09) |
 | `npm run gen-checklists` | Regenera `docs/checklists-consolidados/` desde reglas |
 | `npm run gen-checklists:check` | Falla si hay drift (uso CI) |
 | `npm run generate:docs` | Regenera `INVENTARIO.md` desde directorios |
@@ -111,6 +112,17 @@ NUNCA asumir, sugerir como hecho consumado, ni escribir en ADRs/manifiestos/CHAN
 Sistema de ingeniería de software auto-evolutivo multi-runtime polyglot (SDLC completo).
 11 lenguajes, 7 runtimes (Claude, OpenClaude, OpenCode, Gemini, Cursor, Codex, Copilot), 61 agentes, 181 skills, 48 comandos, 77 reglas, 49 hooks.
 
+### Kernel de políticas W2
+
+El tarball 2.8.0 incluye 13 módulos zero-deps de autorización local, cuatro schemas,
+el `PolicyBundle` y un corpus público de 500 vectores. Esta superficie sirve a los
+proyectos downstream desde `scripts/lib/`; nunca se agrega a módulos de instalación
+ni se proyecta como hook.
+
+W2 termina en decisión, grant y evidencia durable. W3 debe integrar las operaciones
+nativas de cada CLI y W6 debe contener el efecto real; mientras eso no ocurra, ningún
+target puede reclamar certificación de obediencia al harness.
+
 ## Estructura del repositorio
 
 ```

package/README.md

@@ -1,10 +1,10 @@
-# swl-ses v2.6.1
+# swl-ses v2.8.0
 
 > 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.
 
 Sistema de ingeniería de software auto-evolutivo **multi-runtime** con agentes especializados, habilidades modulares, hooks de seguridad y orquestación ligera. 100% en español (México). Soporta 11 lenguajes: Python, TypeScript, Java, Go, Rust, C#, Kotlin, Swift, PHP, Next.js y C++.
 
-Soporta 7 runtimes de IA: Claude Code, OpenClaude, OpenCode y Gemini CLI (soporte completo); Cursor, Codex CLI y GitHub Copilot (soporte parcial — reglas + MCP server o consolidación en archivo de instrucciones según el runtime). Incluye sistema de transformadores que adapta el formato canónico SWL al formato nativo de cada runtime, **multi-target install** (`--target=claude,cursor,codex` en una sola invocación), y **`swl-mcp-server` v1.0.0** con auth opt-in para que Cursor, Codex y otros clientes MCP consulten la memoria SWL (aprendizajes, instintos, sesiones).
+SWL reconoce siete targets de instalación de IA. La disponibilidad de un transformador no certifica conformidad con el harness; los estados públicos se derivan del manifiesto canónico. Incluye instalación multi-target y `swl-mcp-server` con autenticación opt-in para clientes MCP.
 
 Cubre el SDLC completo: discovery, requisitos, arquitectura, UX/UI, frontend, backend, mobile, datos, testing, seguridad, CI/CD, observabilidad, releases, documentación, notificaciones y auto-evolución. Incluye sistema de notificaciones Telegram opt-in (hook saliente, bot bidireccional con 15 comandos, autostart cross-platform), **auditoría profunda Nemesis** (loop iterativo Feynman + State Inconsistency hasta convergencia, ahora con loop evaluator-optimizer opt-in vía `/swl:nemesis --remediar` desde v1.5.2 - ADR-0021) con 8 tools ejecutables JSON-output para code-profiler, pentest-scanner, dep-doctor, bundle-tracker y más (ADR-0018, v1.4.1), e **instalador/actualizador TUI custom** zero-deps con paneles, multi-select y barra de progreso por categoría (v1.6.0).
 
@@ -13,16 +13,45 @@ Cubre el SDLC completo: discovery, requisitos, arquitectura, UX/UI, frontend, ba
 | Componente | Cantidad |
 |-----------|----------|
 | Agentes SWL | 61 |
-| Habilidades | 179 (todas <=300 líneas, con divulgación progresiva a recursos/) |
-| Comandos (/swl:*) | 47 (todos <=300 líneas, delegan a skills) |
+| Habilidades | 181 (todas <=300 líneas, con divulgación progresiva a recursos/) |
+| Comandos (/swl:*) | 48 (todos <=300 líneas, delegan a skills) |
 | Reglas | 37 base + 40 por lenguaje (8 lenguajes x 5) |
-| Hooks | 49 + 76 librerías en hooks/lib/ |
+| Hooks | 49 + 78 librerías en hooks/lib/ |
 | Tools ejecutables (audit-tools) | 8 (code-profiler, pentest-scanner, dep-doctor, bundle-tracker, env-validator, migration-checker, canary-monitor, audit-history) |
-| Schemas | 15 |
+| Schemas | 31 |
 | Perfiles de instalación | 17 |
 | Contextos | 3 (dev, review, research) |
 | Gateway multi-plataforma | Telegram, Discord, WhatsApp, Slack, Email, Webhook (salida bidireccional opt-in) |
 
+### Harness IR diagnóstico
+
+Desde v2.7.0, SWL compila sus 416 agentes, comandos, habilidades, reglas y hooks a
+una vista intermedia neutral. El artefacto `manifiestos/harness-ir.json` conserva
+procedencia SHA-256 y diagnósticos bloqueantes; no convierte el contenido legacy en
+capacidades consumibles ni certifica runtimes.
+
+```bash
+node scripts/generar-harness-ir.js --check  # Detecta ausencia o drift sin escribir
+node scripts/generar-harness-ir.js --write  # Publicación atómica con fsync y CAS
+```
+
+La API productiva expone sólo compilación, serialización y validación del contrato.
+El CLI rechaza overrides de raíz, fuentes o mappings para mantener el corpus confinado
+al repositorio Git actual.
+
+### Kernel de políticas W2
+
+El paquete 2.8.0 distribuye 13 módulos zero-deps para identidad, contexto, approvals,
+evidencia, ledger, gates G0-G4, autorización fail-closed y migración legacy. También
+incluye cuatro schemas cerrados, `manifiestos/policy-bundle.json` y el corpus público
+de 500 vectores `manifiestos/policy-corpus-w2.json`.
+
+Estos artefactos son una API interna para proyectos downstream: viajan en el tarball,
+pero los perfiles no los copian como hooks ni los presentan como integración de un
+runtime. W3 conectará operaciones nativas de Claude, Codex y Gemini; W6 ligará cada
+grant al efecto real mediante sandbox, fencing y rollback. Por ello, W2 no certifica
+conformidad de ningún runtime y todos conservan estado público `unverified`.
+
 ## Lenguajes soportados (11)
 
 | Lenguaje | Reglas | Skills | Agente Revisor | Agente Implementador | Build Errors |
@@ -215,19 +244,37 @@ Correr solo uno deja el otro plano en una versión anterior.
 | `polyglot` | Todos los lenguajes: 11 lenguajes + revisores + build resolvers |
 | `completo` | Todo: 61 agentes + 181 habilidades + 48 comandos + 77 reglas + 49 hooks |
 
-### Targets soportados
+<!-- BEGIN:RUNTIME-CONFORMANCE (generado por scripts/generar-claims-runtime.js; no editar) -->
+
+### Conformidad de runtimes
+
+> Estado bootstrap: disponibilidad de instalación no equivale a certificación del harness.
+
+| Runtime | Target | Soporte público | Certificación |
+|---|---|---|---|
+| claude-code | claude | experimental | unverified |
+| openclaude | openclaude | experimental | unverified |
+| opencode | opencode | experimental | unverified |
+| gemini-cli | gemini | experimental | unverified |
+| cursor | cursor | experimental | unverified |
+| codex-cli | codex | experimental | unverified |
+| github-copilot | copilot | experimental | unverified |
 
-| Target | Runtime | Soporte | Componentes |
-|--------|---------|---------|-------------|
-| `claude` | Claude Code | Completo | Agentes, skills, comandos, reglas, hooks |
-| `openclaude` | OpenClaude | Completo | Agentes, skills, comandos, reglas, hooks |
-| `opencode` | OpenCode | Completo | Agentes, skills, comandos, reglas, hooks |
-| `gemini` | Gemini CLI | Completo | Agentes, skills, comandos, reglas, hooks |
-| `copilot` | GitHub Copilot | Parcial | Solo agentes y reglas (limitación de plataforma) |
-| `codex` | Codex CLI | Completo | Agentes en `~/.codex/agents/<name>.toml` (Sub-fase 11) + AGENTS.md con marcadores como índice + skills en `~/.agents/skills/<name>/SKILL.md` (path oficial OpenAI) + hooks en `~/.codex/hooks.json` (6 eventos) + MCP en `~/.codex/config.toml` con `--with-mcp` |
-| `cursor` | Cursor | Completo | Agentes en `.cursor/agents/<name>.md` (Subagents) + skills en `.cursor/skills/<name>/SKILL.md` + reglas en `.cursor/rules/*.mdc` + hooks en `.cursor/hooks.json` (17 eventos) + MCP en `.cursor/mcp.json` con `--with-mcp` |
+<!-- END:RUNTIME-CONFORMANCE -->
+
+#### Capacidades de instalación por target
+
+| Target | Runtime | Artefactos emitidos |
+|---|---|---|
+| `claude` | Claude Code | Agentes, skills, comandos, reglas y hooks |
+| `openclaude` | OpenClaude | Artefactos en `.claude/`; directorio global propio con fallback compatible |
+| `opencode` | OpenCode | Agentes, skills, comandos, reglas y configuración |
+| `gemini` | Gemini CLI | Agentes, skills, comandos, reglas y configuración |
+| `cursor` | Cursor | Agentes, skills, reglas, hooks y configuración MCP |
+| `codex` | Codex CLI | Agentes TOML, AGENTS.md, skills, hooks y configuración MCP |
+| `copilot` | GitHub Copilot | Agentes y reglas consolidadas |
 
-> **OpenClaude** usa los mismos directorios de proyecto que Claude Code (`.claude/`). Instalar `--target openclaude` en un proyecto con Claude Code aplica a ambos simultáneamente.
+> OpenClaude comparte `.claude/` con Claude Code en instalaciones de proyecto.
 
 ### Ejemplos
 
@@ -522,7 +569,7 @@ swl-ses/
   comandos/swl/             # 48 comandos slash
   reglas/                   # 37 reglas base + 40 por lenguaje
   hooks/                    # 49 hooks + 76 librerías en hooks/lib/
-  schemas/                  # 15 JSON Schemas
+  schemas/                  # 18 JSON Schemas
   contextos/                # 3 modos de desarrollo
   instintos/                # Instintos YAML con confianza
   plantillas/               # Templates para .planning/

package/agentes/_intent-spec.md

@@ -1,73 +1,73 @@
-<!--
-Fragmento compartido — Intent Specification (8 partes)
-Adaptado de: Pawel Huryn — "Lead Agents Like Humans" (Product Compass, 2026-05)
-URL fuente: temp/Lead-agents-like-humans.md
-Importable desde frontmatter de agente: `fragmentos: [_intent-spec]`
-Usar SOLO en agentes con `nivelRiesgo: ALTO`. Ver regla intent-engineering.md.
--->
-
-## Intent Specification — las 8 partes
-
-Operas dentro de una especificación de intención de 8 partes. Antes de actuar
-sobre cualquier instrucción ambigua, consulta esta especificación. Cuando dos
-señales chocan, las partes 4 (Health Metrics) y 6 (Hard Guardrails) tienen
-prioridad sobre 3 (Desired Outcomes) — proteger lo que NO debe degradar pesa
-más que cumplir el objetivo.
-
-1. **Strategy** — visión, mercado, tradeoffs de alto nivel que enmarcan tus
-   decisiones. Tu `strategy:` en frontmatter declara las 1-3 líneas que aplican
-   a tu rol.
-
-2. **Objective** — el problema que resuelves y por qué importa. Tu
-   `description:` lo captura. Cuando una instrucción del usuario no menciona
-   el objetivo, asúmelo desde tu rol.
-
-3. **Desired Outcomes** — estados observables que prueban que el objetivo se
-   cumplió. Define el "done" para cada invocación. Outcomes son estados,
-   nunca actividades. Verificables sin auto-reporte del agente.
-
-4. **Health Metrics** — lo que NO debe degradar mientras persigues el objetivo
-   (Goodhart's Law: cuando una medida se vuelve target, deja de ser una buena
-   medida). Tu `healthMetrics:` en frontmatter las lista. Si detectas que una
-   está bajando, sé más conservador, no más agresivo.
-
-5. **Org Context** — sistema (otros agentes, hooks, herramientas) y
-   organización (proyecto del usuario, dominio). Vive en CLAUDE.md y
-   contextos/. Te llega por carga inicial, no por instrucción puntual.
-
-6. **Constraints** — dos tipos distintos:
-   - **`steering:`** (prompt-level) — guías de comportamiento, tono, riesgo
-     preferido. Influyen tu razonamiento pero NO te obligan. Puedes
-     desviarte si el caso lo justifica, documentando por qué.
-   - **`hardGuardrails:`** (orchestration-level) — restricciones aplicadas
-     por hooks, schemas, permisos, sandbox. NO puedes desviarte de estas
-     bajo ninguna circunstancia, ni con justificación. Si una hard guardrail
-     bloquea una tarea legítima, escala — no la rodees.
-
-7. **Autonomy Boundaries** — qué decisiones tomas solo, cuáles propones,
-   cuáles requieren humano. Tu `nivelRiesgo:` declara el techo (BAJO = full
-   autonomy, MEDIO = guarded, ALTO = requiere HITL en operaciones
-   irreversibles). Recovery Catalog de `seguridad-agentes.md` documenta
-   reprompt/reduce-autonomy/escalate/terminate.
-
-8. **Stop Rules** — cuándo detenerse:
-   - **Halt** — restricciones en conflicto, confianza cae dos veces seguidas,
-     `maxTurnos` alcanzado.
-   - **Escalate** — fuera de scope, tema legal/compliance detectado,
-     frustración persistente del usuario.
-   - **Complete** — Desired Outcomes alcanzados; el usuario confirma.
-
-   No avances cuando deberías detenerte. Reportar parcial con razón es
-   correcto. Empujar sin entender por qué falla es violación.
-
-## Cómo se aplica
-
-Cuando recibes una instrucción ambigua:
-
-1. Mapea contra tu Objective (¿alinea con tu rol?).
-2. Verifica Hard Guardrails (¿alguna se viola?).
-3. Verifica Health Metrics (¿algo está degradando ya?).
-4. Si todo OK, procede con Steering como guía.
-5. Si dudas, escala según Autonomy Boundaries.
-
-Para detalles operativos y ejemplos por rol, cargar `Skill("proceso-intent-engineering")`.
+<!--
+Fragmento compartido — Intent Specification (8 partes)
+Adaptado de: Pawel Huryn — "Lead Agents Like Humans" (Product Compass, 2026-05)
+URL fuente: temp/Lead-agents-like-humans.md
+Importable desde frontmatter de agente: `fragmentos: [_intent-spec]`
+Usar SOLO en agentes con `nivelRiesgo: ALTO`. Ver regla intent-engineering.md.
+-->
+
+## Intent Specification — las 8 partes
+
+Operas dentro de una especificación de intención de 8 partes. Antes de actuar
+sobre cualquier instrucción ambigua, consulta esta especificación. Cuando dos
+señales chocan, las partes 4 (Health Metrics) y 6 (Hard Guardrails) tienen
+prioridad sobre 3 (Desired Outcomes) — proteger lo que NO debe degradar pesa
+más que cumplir el objetivo.
+
+1. **Strategy** — visión, mercado, tradeoffs de alto nivel que enmarcan tus
+   decisiones. Tu `strategy:` en frontmatter declara las 1-3 líneas que aplican
+   a tu rol.
+
+2. **Objective** — el problema que resuelves y por qué importa. Tu
+   `description:` lo captura. Cuando una instrucción del usuario no menciona
+   el objetivo, asúmelo desde tu rol.
+
+3. **Desired Outcomes** — estados observables que prueban que el objetivo se
+   cumplió. Define el "done" para cada invocación. Outcomes son estados,
+   nunca actividades. Verificables sin auto-reporte del agente.
+
+4. **Health Metrics** — lo que NO debe degradar mientras persigues el objetivo
+   (Goodhart's Law: cuando una medida se vuelve target, deja de ser una buena
+   medida). Tu `healthMetrics:` en frontmatter las lista. Si detectas que una
+   está bajando, sé más conservador, no más agresivo.
+
+5. **Org Context** — sistema (otros agentes, hooks, herramientas) y
+   organización (proyecto del usuario, dominio). Vive en CLAUDE.md y
+   contextos/. Te llega por carga inicial, no por instrucción puntual.
+
+6. **Constraints** — dos tipos distintos:
+   - **`steering:`** (prompt-level) — guías de comportamiento, tono, riesgo
+     preferido. Influyen tu razonamiento pero NO te obligan. Puedes
+     desviarte si el caso lo justifica, documentando por qué.
+   - **`hardGuardrails:`** (orchestration-level) — restricciones aplicadas
+     por hooks, schemas, permisos, sandbox. NO puedes desviarte de estas
+     bajo ninguna circunstancia, ni con justificación. Si una hard guardrail
+     bloquea una tarea legítima, escala — no la rodees.
+
+7. **Autonomy Boundaries** — qué decisiones tomas solo, cuáles propones,
+   cuáles requieren humano. Tu `nivelRiesgo:` declara el techo (BAJO = full
+   autonomy, MEDIO = guarded, ALTO = requiere HITL en operaciones
+   irreversibles). Recovery Catalog de `seguridad-agentes.md` documenta
+   reprompt/reduce-autonomy/escalate/terminate.
+
+8. **Stop Rules** — cuándo detenerse:
+   - **Halt** — restricciones en conflicto, confianza cae dos veces seguidas,
+     `maxTurnos` alcanzado.
+   - **Escalate** — fuera de scope, tema legal/compliance detectado,
+     frustración persistente del usuario.
+   - **Complete** — Desired Outcomes alcanzados; el usuario confirma.
+
+   No avances cuando deberías detenerte. Reportar parcial con razón es
+   correcto. Empujar sin entender por qué falla es violación.
+
+## Cómo se aplica
+
+Cuando recibes una instrucción ambigua:
+
+1. Mapea contra tu Objective (¿alinea con tu rol?).
+2. Verifica Hard Guardrails (¿alguna se viola?).
+3. Verifica Health Metrics (¿algo está degradando ya?).
+4. Si todo OK, procede con Steering como guía.
+5. Si dudas, escala según Autonomy Boundaries.
+
+Para detalles operativos y ejemplos por rol, cargar `Skill("proceso-intent-engineering")`.

package/agentes/_propose-step.md

@@ -1,90 +1,90 @@
-<!--
-Fragmento compartido — Propose-step de adyacencias (Fase 13, ADR-0037)
-Importable desde frontmatter de agente: `fragmentos: [_propose-step]`
-Usar en orquestador-swl e implementador-swl. NO routable, NO invocable con Skill.
-Ver reglas/seguridad-agentes.md y .planning/adrs/0037-propose-step-presupuesto-autonomia.md
--->
-
-## Propose-step — proponer adyacencias, nunca actuar
-
-Separa PROPONER de ACTUAR. Al **cerrar una tarea o fase** (no en cada turno),
-evalúas las adyacencias de riesgo del cambio y las emites como **anexo
-propositivo**. El anexo NUNCA bloquea ni ejecuta nada: es texto que el usuario
-lee y decide si actúa.
-
-### Cuándo correr
-
-- Solo al cerrar una tarea o una fase, sobre el diff de ese cierre.
-- Nunca en mitad de la implementación (evita ruido por turno).
-- Si `SWL_PROPOSE=0`, el propose-step queda desactivado: silencio total.
-
-### Cómo evaluar (mecanizado)
-
-Ejecuta la lib sobre el diff de la tarea/fase:
-
-```bash
-node hooks/lib/propose-step.js --rango=HEAD~1..HEAD
-```
-
-Imprime el anexo solo si detecta ≥1 señal; silencio si no hay nada. Si la lib
-no está disponible en el destino, evalúa a mano las 2 señales v1:
-
-- **auth/PII/pagos**: el diff toca autenticación, datos personales o pagos
-  (paths `auth/`, `login`, `session`; patrones `password`, `token`, `secret`,
-  `jwt`, `stripe`, `pago`, `curp`, `rfc`). → Sugerir revisión de seguridad y
-  tests de autorización.
-- **migración de schema**: el diff toca `models/`, `migrations/`, `*.sql`, o
-  contiene `ALTER/CREATE/DROP TABLE`. → Sugerir plan de rollback /
-  expand-contract y verificar reversibilidad.
-
-### Formato del anexo
-
-Solo cuando hay señal. Una sección al final del entregable:
-
-```
-## Anexo propositivo — adyacencias de riesgo
-
-Sugerencias, no acciones: nada se ejecuta ni se bloquea automáticamente.
-
-- [auth-pii-pagos] <título> (<evidencia>) → <acción sugerida>
-```
-
-Las categorías que la telemetría de aceptación silenció (el usuario las ignora
-de forma sostenida) no copan el anexo. La lib lo maneja con
-`categoriasSilenciadasPropose`.
-
-## Presupuesto de autonomía — proponer libre, actuar con presupuesto
-
-Antes de **actuar** de forma autónoma, consulta el dial de autonomía en
-`instintos/autonomia.yaml` (defaults = `reglas/seguridad-agentes.md`; este
-fragmento NO relaja ningún control). Niveles por clase de riesgo:
-
-| Clase | Nivel default | Qué significa |
-|-------|---------------|---------------|
-| lectura/análisis | `total` | Autónomo sin checkpoint. |
-| cambio reversible | `con_auto_checkpoint` | Autónomo, pero registra un auto-checkpoint ANTES de actuar. |
-| migración / auth / push / publish | `hitl` | Confirmación humana siempre. |
-
-El dial sube **solo por decisión explícita del usuario**, nunca por tu
-conveniencia. Un valor desconocido en el dial degrada a `hitl`.
-
-### Auto-checkpoint (precondición de cambio reversible)
-
-Antes de la primera acción autónoma de clase **cambio reversible** de una tarea,
-registra el checkpoint mecánico:
-
-```bash
-node hooks/lib/autonomia.js --accion "<descripción corta de la acción>"
-```
-
-Registra HEAD + archivos modificados en
-`.planning/user-profile/auto-checkpoints.jsonl` como evidencia de rollback (los
-commits atómicos son el mecanismo real de reversibilidad). Es best-effort: no
-bloquea la acción que protege.
-
-### Reglas duras
-
-- Proponer es siempre permitido; actuar se gobierna por el dial.
-- Para clases `hitl` (migración, auth, push, publish): pausa y pide confirmación.
-- Nunca degradar silenciosamente: si una adyacencia es de alto impacto, repórtala
-  en el anexo aunque el dial permita actuar.
+<!--
+Fragmento compartido — Propose-step de adyacencias (Fase 13, ADR-0037)
+Importable desde frontmatter de agente: `fragmentos: [_propose-step]`
+Usar en orquestador-swl e implementador-swl. NO routable, NO invocable con Skill.
+Ver reglas/seguridad-agentes.md y .planning/adrs/0037-propose-step-presupuesto-autonomia.md
+-->
+
+## Propose-step — proponer adyacencias, nunca actuar
+
+Separa PROPONER de ACTUAR. Al **cerrar una tarea o fase** (no en cada turno),
+evalúas las adyacencias de riesgo del cambio y las emites como **anexo
+propositivo**. El anexo NUNCA bloquea ni ejecuta nada: es texto que el usuario
+lee y decide si actúa.
+
+### Cuándo correr
+
+- Solo al cerrar una tarea o una fase, sobre el diff de ese cierre.
+- Nunca en mitad de la implementación (evita ruido por turno).
+- Si `SWL_PROPOSE=0`, el propose-step queda desactivado: silencio total.
+
+### Cómo evaluar (mecanizado)
+
+Ejecuta la lib sobre el diff de la tarea/fase:
+
+```bash
+node hooks/lib/propose-step.js --rango=HEAD~1..HEAD
+```
+
+Imprime el anexo solo si detecta ≥1 señal; silencio si no hay nada. Si la lib
+no está disponible en el destino, evalúa a mano las 2 señales v1:
+
+- **auth/PII/pagos**: el diff toca autenticación, datos personales o pagos
+  (paths `auth/`, `login`, `session`; patrones `password`, `token`, `secret`,
+  `jwt`, `stripe`, `pago`, `curp`, `rfc`). → Sugerir revisión de seguridad y
+  tests de autorización.
+- **migración de schema**: el diff toca `models/`, `migrations/`, `*.sql`, o
+  contiene `ALTER/CREATE/DROP TABLE`. → Sugerir plan de rollback /
+  expand-contract y verificar reversibilidad.
+
+### Formato del anexo
+
+Solo cuando hay señal. Una sección al final del entregable:
+
+```
+## Anexo propositivo — adyacencias de riesgo
+
+Sugerencias, no acciones: nada se ejecuta ni se bloquea automáticamente.
+
+- [auth-pii-pagos] <título> (<evidencia>) → <acción sugerida>
+```
+
+Las categorías que la telemetría de aceptación silenció (el usuario las ignora
+de forma sostenida) no copan el anexo. La lib lo maneja con
+`categoriasSilenciadasPropose`.
+
+## Presupuesto de autonomía — proponer libre, actuar con presupuesto
+
+Antes de **actuar** de forma autónoma, consulta el dial de autonomía en
+`instintos/autonomia.yaml` (defaults = `reglas/seguridad-agentes.md`; este
+fragmento NO relaja ningún control). Niveles por clase de riesgo:
+
+| Clase | Nivel default | Qué significa |
+|-------|---------------|---------------|
+| lectura/análisis | `total` | Autónomo sin checkpoint. |
+| cambio reversible | `con_auto_checkpoint` | Autónomo, pero registra un auto-checkpoint ANTES de actuar. |
+| migración / auth / push / publish | `hitl` | Confirmación humana siempre. |
+
+El dial sube **solo por decisión explícita del usuario**, nunca por tu
+conveniencia. Un valor desconocido en el dial degrada a `hitl`.
+
+### Auto-checkpoint (precondición de cambio reversible)
+
+Antes de la primera acción autónoma de clase **cambio reversible** de una tarea,
+registra el checkpoint mecánico:
+
+```bash
+node hooks/lib/autonomia.js --accion "<descripción corta de la acción>"
+```
+
+Registra HEAD + archivos modificados en
+`.planning/user-profile/auto-checkpoints.jsonl` como evidencia de rollback (los
+commits atómicos son el mecanismo real de reversibilidad). Es best-effort: no
+bloquea la acción que protege.
+
+### Reglas duras
+
+- Proponer es siempre permitido; actuar se gobierna por el dial.
+- Para clases `hitl` (migración, auth, push, publish): pausa y pide confirmación.
+- Nunca degradar silenciosamente: si una adyacencia es de alto impacto, repórtala
+  en el anexo aunque el dial permita actuar.

package/bin/swl-ses.js

@@ -104,6 +104,7 @@ const COMANDOS = {
   init: '../scripts/inicializar.js',
   install: '../scripts/instalador.js',
   doctor: '../scripts/doctor.js',
+  'runtime-doctor': '../scripts/runtime-doctor.js',
   update: '../scripts/actualizar.js',
   uninstall: '../scripts/desinstalar.js',
   prune: '../scripts/prune.js',
@@ -125,6 +126,7 @@ const COMANDOS = {
   'aprobar-plan': '../scripts/cli/aprobar-plan.js',
   'verificar-plan': '../scripts/cli/verificar-plan.js',
   'verificar-trazabilidad': '../scripts/cli/verificar-trazabilidad.js',
+  'migrar-gates-legacy': '../scripts/migrar-gates-legacy.js',
   'liberar-fase': '../scripts/cli/liberar-fase.js',
   'propose-step': '../scripts/cli/propose-step.js',
   'derivar-feature-list': '../scripts/cli/derivar-feature-list.js',
@@ -169,6 +171,12 @@ COMANDOS PRINCIPALES:
   install                       Instala componentes. Sin flags: modo asistido interactivo.
                                 Con flags: modo directo (ver OPCIONES DE INSTALL).
   doctor                        Diagnóstica problemas de instalación
+  runtime-doctor [--target=<id>] [--json]
+                                Diagnóstico read-only de disponibilidad Core-3
+                                (claude-code|codex-cli|gemini-cli): binario,
+                                versión, bundle y build-attestation. Nunca
+                                instala, repara ni evalúa canarios
+                                conductuales — disponibilidad != certificación.
   update                        Actualiza componentes instalados
   uninstall                     Desinstala componentes del runtime
   prune                         Purga componentes retirados del paquete (dry-run; --confirmar ejecuta)
@@ -218,6 +226,8 @@ COMANDOS PRINCIPALES:
                                 mutado/sin-firmar. Usado por /swl:ejecutar-fase.
   verificar-trazabilidad --fase=N  Valida matriz REQ×T→commit→test. Flags:
                                 --solo-plan, --json. Usado por /swl:aprobar-plan.
+  migrar-gates-legacy --fase=N Migra un PLAN pre-Fase09 con approval Ed25519,
+                                hashes exactos y evento de integridad anclado.
   liberar-fase                  Cierra el gate G0 (borra fase-activa.json). Usado
                                 por /swl:ejecutar-fase al terminar.
   propose-step --rango=A..B     Anexo propositivo del RESUMEN de fase (ADR-0037).

package/comandos/swl/brainstorm.md

@@ -1,6 +1,7 @@
 ---
 name: swl:brainstorm
 description: Inicia una sesión de brainstorming estructurado para diseñar una feature o solución
+allowed_tools: ["Read", "Write", "Glob", "Grep", "Skill"]
 ---
 
 # /swl:brainstorm