@saulwade/swl-ses 2.1.0 → 2.2.1

package/manifiestos/modulos.json

@@ -1043,6 +1043,9 @@
         "hooks/inbox-aviso.js",
         "hooks/session-briefing.js",
         "hooks/lib/briefing.js",
+        "hooks/lib/evolution-tracker.js",
+        "hooks/lib/atomic-write.js",
+        "scripts/lib/canonical-hash.js",
         "hooks/lib/propose-step.js",
         "hooks/lib/autonomia.js",
         "hooks/aiisms-detector.js",

package/manifiestos/skills-lock.json

@@ -1,8 +1,8 @@
 {
   "lockfileVersion": 1,
-  "generatedAt": "2026-06-12T19:50:44.271Z",
+  "generatedAt": "2026-06-15T01:34:05.511Z",
   "skillsCount": 182,
-  "lockHash": "sha256:db10fd842d21ff25e267d1b7bf2894876450ed4ca3d379f035079501a6d7e9d3",
+  "lockHash": "sha256:f6706fea37eb39050b10e8137d2cdcd9cba757cf8557f4f5291c6e05cb8ee60a",
   "skills": [
     {
       "nombre": "accesibilidad-a11y",
@@ -14,8 +14,8 @@
     {
       "nombre": "agent-browser",
       "path": "habilidades/agent-browser/SKILL.md",
-      "hash": "sha256:f86c928393b06a3dac05aabd09661776c65bfb027997d0c57ee1ca819ae88c31",
-      "bytes": 14502,
+      "hash": "sha256:74c4feb71c40c6df18444503c2d468603e1a454c218a1bdf379e7309b053104b",
+      "bytes": 14228,
       "version": "\"1.2.0\""
     },
     {
@@ -49,15 +49,15 @@
     {
       "nombre": "angular-moderno",
       "path": "habilidades/angular-moderno/SKILL.md",
-      "hash": "sha256:1e0ec49d49147fa6e8c67286efb4662edebb8c5150d34e73c85c0ce3d845f52a",
-      "bytes": 10743,
+      "hash": "sha256:2521b000c48a08228fb3510a7bf5d5471787ed8ce7e8296ae77e588f3823f5c2",
+      "bytes": 10472,
       "version": "\"1.0.1\""
     },
     {
       "nombre": "api-rest-diseno",
       "path": "habilidades/api-rest-diseno/SKILL.md",
-      "hash": "sha256:8f773d5a147f2b44f5b954a8b0a3357ba3486be961a6e10794817b04228e6fe6",
-      "bytes": 10100,
+      "hash": "sha256:2cba1d7fcc941055195b7171b04fbe76ecaf4b49bb7291520432dd743455fc43",
+      "bytes": 9890,
       "version": "\"1.0.1\""
     },
     {
@@ -70,8 +70,8 @@
     {
       "nombre": "aprendizaje-continuo",
       "path": "habilidades/aprendizaje-continuo/SKILL.md",
-      "hash": "sha256:dba271ea4c6e99e8f272f49c83fd634a5e55f3fb3ec319131ddaae0d926df69a",
-      "bytes": 8853,
+      "hash": "sha256:24e975a8e8aa64cd33fdf0389c018dec1e0f2cc2450fbca5682751021f3a4479",
+      "bytes": 8399,
       "version": "\"1.0.1\""
     },
     {
@@ -84,8 +84,8 @@
     {
       "nombre": "auth-patrones",
       "path": "habilidades/auth-patrones/SKILL.md",
-      "hash": "sha256:bbcdf9fd5a73d05c28abdd2493f3499b0a64aa9cac76de325aee013be7c55eba",
-      "bytes": 18387,
+      "hash": "sha256:a83322aec1665df10ed242d28d6c1812f388a4a7750f494cb18615e3318c1a7a",
+      "bytes": 18195,
       "version": "\"1.2.0\""
     },
     {
@@ -203,8 +203,8 @@
     {
       "nombre": "build-errors-nextjs",
       "path": "habilidades/build-errors-nextjs/SKILL.md",
-      "hash": "sha256:e7f41d7825608884bc64d993b9b1fd21c509a2478bb3606a4f038929fcb9b2a4",
-      "bytes": 14962,
+      "hash": "sha256:e5e83518a4af0ec2cfdb94cd7e310f486480789ac6c5cb980f47b394a09872cb",
+      "bytes": 14676,
       "version": "\"1.1.0\""
     },
     {
@@ -266,8 +266,8 @@
     {
       "nombre": "changelog-generator",
       "path": "habilidades/changelog-generator/SKILL.md",
-      "hash": "sha256:98ce8d74e9c5e94a2b897eb9ca289b02ce30b7624825822d9f0728d8e94d68ae",
-      "bytes": 7917,
+      "hash": "sha256:1d2cad1dac64cf5bdb9d169013cd481a8447a2e844792123f88de4c6008f6d65",
+      "bytes": 7811,
       "version": "1.1.0"
     },
     {
@@ -280,8 +280,8 @@
     {
       "nombre": "checklist-seguridad",
       "path": "habilidades/checklist-seguridad/SKILL.md",
-      "hash": "sha256:2677b17fb658cd596b7f28da51df76579cbe9288ac910ec8bf239e3b74accefe",
-      "bytes": 19379,
+      "hash": "sha256:700214ccffff4c5b9f14b0b0ad54df30d5929ee5e5993aa4e971ead268503b7d",
+      "bytes": 18988,
       "version": "\"1.2.0\""
     },
     {
@@ -315,8 +315,8 @@
     {
       "nombre": "contenedores-docker",
       "path": "habilidades/contenedores-docker/SKILL.md",
-      "hash": "sha256:a3a816bfb4bfceef7eeac90838392eddf474c86665e3c5cc600ecbedf29d448e",
-      "bytes": 9574,
+      "hash": "sha256:ee5b8d451f6e704d9cea50be5ff51b87ed2f6079f4378085e864f2e8298384b8",
+      "bytes": 9330,
       "version": "\"1.0.1\""
     },
     {
@@ -364,8 +364,8 @@
     {
       "nombre": "datos-etl",
       "path": "habilidades/datos-etl/SKILL.md",
-      "hash": "sha256:adae4c508c3895b77c68b5e84a65649d1c8043837eb69d721ff56a033731617b",
-      "bytes": 9595,
+      "hash": "sha256:ec871e2241c0c50beae88dbbb15903488e654b1c238553390a4309030bc9edb9",
+      "bytes": 9333,
       "version": "\"1.0.1\""
     },
     {
@@ -441,8 +441,8 @@
     {
       "nombre": "doc-sync",
       "path": "habilidades/doc-sync/SKILL.md",
-      "hash": "sha256:dd92947542bf032c97813366b1da405acb372ce62944cedb86059c7ff4fa432f",
-      "bytes": 35125,
+      "hash": "sha256:4da3e0b05d120fef21071d62cede54a69045cb01a66425545559acc6c0472dea",
+      "bytes": 34511,
       "version": "\"1.3.0\""
     },
     {
@@ -518,15 +518,15 @@
     {
       "nombre": "extractor-de-aprendizajes",
       "path": "habilidades/extractor-de-aprendizajes/SKILL.md",
-      "hash": "sha256:c34ceb3fbed0e283309c3049ad3df1d4adf88d0e3b889aaf79f9a01a77c5602b",
-      "bytes": 23819,
+      "hash": "sha256:a84b4e2278298602a8d8f1e0f4e359ae3ab14b419e708e396d71b92decd64c4a",
+      "bytes": 23431,
       "version": "\"1.0.6\""
     },
     {
       "nombre": "fastapi-experto",
       "path": "habilidades/fastapi-experto/SKILL.md",
-      "hash": "sha256:2e7e158b6ac54d9aec9b2e3932e9c4e5e17e43525530cad21fc30252ee2279bf",
-      "bytes": 25977,
+      "hash": "sha256:bebaf70751231833c004212787487b1ac4d9dec8cdca58c383790fb5f0261195",
+      "bytes": 25546,
       "version": "\"1.3.1\""
     },
     {
@@ -546,8 +546,8 @@
     {
       "nombre": "frontend-avanzado",
       "path": "habilidades/frontend-avanzado/SKILL.md",
-      "hash": "sha256:6302ef2f6c2aaec6b24f42e107cb5e8259e62db3a62b810b288534c02f22d164",
-      "bytes": 12502,
+      "hash": "sha256:04b0517806d09a748445c8ebb6d4f22cd91d41bf81c3c04bd07c6af42c318c79",
+      "bytes": 12303,
       "version": "\"1.1.0\""
     },
     {
@@ -616,8 +616,8 @@
     {
       "nombre": "iam-secretos",
       "path": "habilidades/iam-secretos/SKILL.md",
-      "hash": "sha256:dbaeac2d8b23e33a0255d79c849bbe7baa521d6d73dbb8050731878aef1ed908",
-      "bytes": 14568,
+      "hash": "sha256:ba18cd048f3c957dc51a85b88205e6849a25864cdd1af1eb5e91edfa856dd931",
+      "bytes": 14364,
       "version": "\"1.1.0\""
     },
     {
@@ -707,15 +707,15 @@
     {
       "nombre": "manejo-errores",
       "path": "habilidades/manejo-errores/SKILL.md",
-      "hash": "sha256:5559b25b817307e6d27e8524c91bf5a4b5b09f5b593771e1dfc908d96255d7cd",
-      "bytes": 23513,
+      "hash": "sha256:f51a3c1add4fa8121a477e1366f9c003f25acfa021cd36b68e9c89ac15133426",
+      "bytes": 23220,
       "version": "\"1.2.0\""
     },
     {
       "nombre": "mapear-codebase",
       "path": "habilidades/mapear-codebase/SKILL.md",
-      "hash": "sha256:2796130ccdacaff43e8920eaca9739edc3ad2a4bbae736edf6181e997ea4ab80",
-      "bytes": 13484,
+      "hash": "sha256:216b194a8929abe3340d344632a1d9a739ad5d4cfc76b64a7e0b227a2ba3cf9b",
+      "bytes": 13289,
       "version": "\"1.1.0\""
     },
     {
@@ -728,8 +728,8 @@
     {
       "nombre": "meta-skills-estandar",
       "path": "habilidades/meta-skills-estandar/SKILL.md",
-      "hash": "sha256:5e5a4597e200766aa6465f4ecc194739b2d9d82f6ac219d6774f2a0bb4ca10dc",
-      "bytes": 23632,
+      "hash": "sha256:02d1eb9c9395f22a766f4d4eb83ce3c4c4d687600fad0c721fb471ab9a1caa2d",
+      "bytes": 23161,
       "version": "\"1.1.1\""
     },
     {
@@ -763,8 +763,8 @@
     {
       "nombre": "monitoring-alertas",
       "path": "habilidades/monitoring-alertas/SKILL.md",
-      "hash": "sha256:8099a46491598e28abc47f8b8d0cc814998b8b80f05aed71f2d9f49767a21324",
-      "bytes": 11807,
+      "hash": "sha256:1e48ff5024454b2173a4b31d713394fce96be47df23fff09aaa2c973c858e0c1",
+      "bytes": 11618,
       "version": "\"1.0.1\""
     },
     {
@@ -791,8 +791,8 @@
     {
       "nombre": "nextjs-experto",
       "path": "habilidades/nextjs-experto/SKILL.md",
-      "hash": "sha256:689e4ce7f045a233efbb8fb9126e3345d9f9be9f2a7a56786b8149260455399a",
-      "bytes": 16165,
+      "hash": "sha256:18da55140e6f97d7a8497732c4136bda0d0a77307d5293feea0af41d415bf8c5",
+      "bytes": 15900,
       "version": "\"1.1.1\""
     },
     {
@@ -805,15 +805,15 @@
     {
       "nombre": "nextjs-testing",
       "path": "habilidades/nextjs-testing/SKILL.md",
-      "hash": "sha256:8df768e4971018902c8ed088901e8ffc860d45f1b28c8e78edaed5f93d9fffcd",
-      "bytes": 19451,
+      "hash": "sha256:e89ffdaf85f34845f9edd3a99768f39a0264513e9581c61286895837e4c2d0fa",
+      "bytes": 19157,
       "version": "\"1.1.0\""
     },
     {
       "nombre": "node-experto",
       "path": "habilidades/node-experto/SKILL.md",
-      "hash": "sha256:09658d3db6670c8f638fa7df02488414872bdccd343dee2aafd1f84c95878b53",
-      "bytes": 26597,
+      "hash": "sha256:a8ede8fcf5eeb72f37fd0d55b4228cab464d0aee08e3eff9bf0a00118e05bb90",
+      "bytes": 25949,
       "version": "\"1.1.0\""
     },
     {
@@ -833,8 +833,8 @@
     {
       "nombre": "orquestacion-async",
       "path": "habilidades/orquestacion-async/SKILL.md",
-      "hash": "sha256:df26a7b1759bf2b4f65c77c627ea39f617d091a4b5e7536e42b148828841f715",
-      "bytes": 14850,
+      "hash": "sha256:9f6b02dcf8a477e771d87fd81546d34f5929e9f602dbf6ff8a27a136a94cd10e",
+      "bytes": 14653,
       "version": "\"1.1.0\""
     },
     {
@@ -847,8 +847,8 @@
     {
       "nombre": "patrones-python",
       "path": "habilidades/patrones-python/SKILL.md",
-      "hash": "sha256:fb6f9a3727971a7eb9f93b3d6b79e588b55631b6353076c4144cc5b0dfe084e1",
-      "bytes": 14155,
+      "hash": "sha256:78d455c54a2a69dc425fc0646a4b5fa87b2951b2a4303283a04fe6dac743cc45",
+      "bytes": 14015,
       "version": "\"1.4.2\""
     },
     {
@@ -889,15 +889,15 @@
     {
       "nombre": "planear-fase",
       "path": "habilidades/planear-fase/SKILL.md",
-      "hash": "sha256:319c3bb674507a8ee31dc8623b441adf9341a24e02697e23dc3cf7b8f4ad9e1f",
-      "bytes": 15402,
+      "hash": "sha256:ce2633d320bb5302b7d49143971bae8b9b0d93c9bfee677c77bc5d0320e211a2",
+      "bytes": 15396,
       "version": "\"1.3.1\""
     },
     {
       "nombre": "postgresql-experto",
       "path": "habilidades/postgresql-experto/SKILL.md",
-      "hash": "sha256:cac1e35963e643432740909f00ff941520379b5bd72610ee761ecceb855d825e",
-      "bytes": 15670,
+      "hash": "sha256:3f0ccd767a4b4407aa8054d1987d2fe51eff84ebd92ae42cb1d672b1efbfce21",
+      "bytes": 15263,
       "version": "\"1.2.0\""
     },
     {
@@ -910,8 +910,8 @@
     {
       "nombre": "prevencion-sobreingenieria",
       "path": "habilidades/prevencion-sobreingenieria/SKILL.md",
-      "hash": "sha256:9f6d0d4f5c54e29aff3e5fa66d89c42a0dabfd0a59eefcfbf6715ca085984f3e",
-      "bytes": 16812,
+      "hash": "sha256:e264bcd56af27ca0f3f2ecc8c3430411c741bc15922d6e6984844f3a8d577e56",
+      "bytes": 16514,
       "version": "\"1.2.0\""
     },
     {
@@ -994,8 +994,8 @@
     {
       "nombre": "protocolo-revision-swl",
       "path": "habilidades/protocolo-revision-swl/SKILL.md",
-      "hash": "sha256:c84502a49b26fb005d237874e2b8c323407529bb1ac8d87362f622c9be46e730",
-      "bytes": 15874,
+      "hash": "sha256:3c46619e38bc2e2435245a71f367ecd63846b18d7902cfae762217e6bdb366c7",
+      "bytes": 15549,
       "version": "\"1.0.1\""
     },
     {
@@ -1015,8 +1015,8 @@
     {
       "nombre": "react-experto",
       "path": "habilidades/react-experto/SKILL.md",
-      "hash": "sha256:cce96f67db8370d78d92d94ce252a48182f664438c9c2f694473f74c2d590695",
-      "bytes": 13672,
+      "hash": "sha256:de2aa1a51c93411e3767f2a71de98366fa3ffa51218385b03ad837d6f4b3a034",
+      "bytes": 13430,
       "version": "\"1.2.0\""
     },
     {
@@ -1043,8 +1043,8 @@
     {
       "nombre": "release-semver",
       "path": "habilidades/release-semver/SKILL.md",
-      "hash": "sha256:2dfe5369f9fd29adb216be017fd7fbb396b874f6107ca9609fd52046a93b9b67",
-      "bytes": 15958,
+      "hash": "sha256:79a72f422b2df39b7a81c19035b3a0b147ab1e58369c73b28085114eafa575a0",
+      "bytes": 15708,
       "version": "\"1.0.2\""
     },
     {
@@ -1134,9 +1134,9 @@
     {
       "nombre": "swl-claudemd",
       "path": "habilidades/swl-claudemd/SKILL.md",
-      "hash": "sha256:b270cedba83127c2a45f4a639efce2f349a8645e42336bf44ca93a806dc1e53f",
-      "bytes": 15362,
-      "version": "\"1.2.1\""
+      "hash": "sha256:97f678f4471b6246c181c074fc64275cbef394109402b80aef8cc56bef3ba0b5",
+      "bytes": 15647,
+      "version": "\"1.3.0\""
     },
     {
       "nombre": "swl-dashboard",
@@ -1169,8 +1169,8 @@
     {
       "nombre": "tdd-workflow",
       "path": "habilidades/tdd-workflow/SKILL.md",
-      "hash": "sha256:c2cccec376924efd5b3fb283504b4953cbee8c625ec9ee7458be80816e9336b5",
-      "bytes": 33084,
+      "hash": "sha256:98e4b3e79336dde99f46c9958b177b7e926c2ec079b09fd38b00e5433532dddd",
+      "bytes": 33360,
       "version": "\"1.2.1\""
     },
     {
@@ -1183,8 +1183,8 @@
     {
       "nombre": "testing-python",
       "path": "habilidades/testing-python/SKILL.md",
-      "hash": "sha256:4bdeba28d408e888325fcf5723d1171748beb35b3d2ef0bc9044f377abe66255",
-      "bytes": 16984,
+      "hash": "sha256:d3b50bc36972691b7c50409ff0f756011b8c02db9aaa8919ed312581ab800a24",
+      "bytes": 17152,
       "version": "\"1.2.1\""
     },
     {
@@ -1246,8 +1246,8 @@
     {
       "nombre": "verificar-trabajo",
       "path": "habilidades/verificar-trabajo/SKILL.md",
-      "hash": "sha256:4aeab56aee56b7b481d8e2c59a4da505ad5bad6abff22e83e4e116c58fa1bbbf",
-      "bytes": 21346,
+      "hash": "sha256:2b8042f32e455217b5998d3f5856f062391cb6ee0ea88897a22767c76e69de38",
+      "bytes": 20811,
       "version": "\"1.2.1\""
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saulwade/swl-ses",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot con 60 agentes, 182 habilidades, 44 comandos, 77 reglas y 48 hooks. Soporta 11 lenguajes y 7 runtimes: Claude Code, OpenClaude, OpenCode, Gemini CLI, Cursor, Codex CLI (soporte completo); GitHub Copilot (soporte parcial). 100% en espanol (Mexico). Multi-target install (--target CSV / --all-runtimes), autoconfig MCP en Cursor/Codex con --with-mcp, agentes Codex en TOML, hooks Cursor (17 eventos) y Codex (6 eventos). Gateway bidireccional con relay Telegram y auditoria profunda Nemesis con loop evaluator-optimizer opt-in (ADR-0021) y 8 tools ejecutables. v1.8.0 unifica los directorios runtime de .planning/ al ingles (evolution/, auto-evolution/, user-profile/, archive/), manteniendo fases/ en espanol, con guard validar-planning-paths y allowlist canonica (ADR-0031). Hereda de v1.7.4: skill calidad-anti-patrones-universales + scripts/lib/pr-analyzer.js + 3 sub-secciones en estilo-sin-ai-isms.",
   "bin": {
     "swl-ses": "bin/swl-ses.js",

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "swl-ses",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot. 60 agentes, 182 habilidades, 44 comandos, 77 reglas y 48 hooks. 76 librerias. 11 lenguajes. Soporta Claude Code, Copilot, OpenCode, Codex y Gemini CLI. Loop evaluator-optimizer en /swl:nemesis (ADR-0021). v1.8.0 unifica los directorios runtime de .planning/ al ingles (evolution/, auto-evolution/, user-profile/, archive/), manteniendo fases/ en espanol, con guard validar-planning-paths y allowlist canonica (ADR-0031). Hereda de v1.7.4: skill calidad-anti-patrones-universales + scripts/lib/pr-analyzer.js + 3 sub-secciones en estilo-sin-ai-isms.",
   "author": "Saul Wade Leon",
   "license": "MIT",

package/scripts/auditar-claudemd.js

@@ -86,6 +86,28 @@ function ubicarClaudeMd(dir = process.cwd()) {
   return null;
 }
 
+// Detecta @-includes con path RELATIVO al CLAUDE.md cuyo destino no existe.
+// Solo evalúa rutas relativas al proyecto — omite `~/` y rutas absolutas
+// porque su existencia depende del entorno de instalación, no del repo.
+// Causa raíz del bug downstream: plantillas que emitían `@reglas/...` cuando
+// las reglas se instalan en `.claude/rules/` (no en `reglas/` del proyecto).
+function detectarReferenciasRotas(contenido, rutaClaudeMd) {
+  const baseDir = path.dirname(rutaClaudeMd);
+  // Primer char [A-Za-z0-9_.] excluye `~` y `/` → solo captura rutas relativas.
+  const re = /@([A-Za-z0-9_.][A-Za-z0-9_./\-]*\.md)\b/g;
+  const rotas = [];
+  const vistos = new Set();
+  let m;
+  while ((m = re.exec(contenido)) !== null) {
+    const ref = m[1];
+    if (vistos.has(ref)) continue;
+    vistos.add(ref);
+    if (ref.startsWith('~') || path.isAbsolute(ref)) continue;
+    if (!fs.existsSync(path.resolve(baseDir, ref))) rotas.push(ref);
+  }
+  return rotas;
+}
+
 function auditar(rutaClaudeMd) {
   if (!rutaClaudeMd || !fs.existsSync(rutaClaudeMd)) {
     return {
@@ -150,6 +172,17 @@ function auditar(rutaClaudeMd) {
     }
   }
 
+  // 4b. @references rotos: @-includes con path relativo cuyo destino no existe.
+  const referenciasRotas = detectarReferenciasRotas(contenido, rutaClaudeMd);
+  for (const ref of referenciasRotas) {
+    hallazgos.push({
+      severidad: 'WARN',
+      regla: 'at-reference-rota',
+      mensaje: `@-reference rota: \`@${ref}\` no existe (resuelto relativo al CLAUDE.md)`,
+      sugerencia: 'Corregir la ruta o, si es una regla global auto-cargada (p. ej. usar-sistema-swl), eliminar el @-include y dejar solo mención de texto',
+    });
+  }
+
   // 5. Placeholders sin reemplazar
   const matches = [...contenido.matchAll(PLACEHOLDERS)];
   if (matches.length > 0) {
@@ -237,6 +270,7 @@ function auditar(rutaClaudeMd) {
       secciones_presentes: SECCIONES_CANONICAS.filter(s => s.regex.test(contenido)).map(s => s.nombre),
       secciones_ausentes: seccionesAusentes.map(s => s.nombre),
       tiene_at_references: /@[a-zA-Z][a-zA-Z0-9_\-./]+\.md/.test(contenido),
+      at_references_rotas: referenciasRotas,
       tiene_referencia_karpathy: tieneReferenciaKarpathy,
       es_project_level: esProjectLevel,
       duplicaciones_reglas_globales: {
@@ -375,6 +409,9 @@ function imprimirReporte(resultado) {
       console.log(`  - Secciones ausentes: ${m.secciones_ausentes.join(', ')}`);
     }
     console.log(`  - @references: ${m.tiene_at_references ? 'sí' : 'no'}`);
+    if (m.at_references_rotas && m.at_references_rotas.length > 0) {
+      console.log(`  - @references rotas: ${m.at_references_rotas.length} (${m.at_references_rotas.join(', ')})`);
+    }
     if (m.es_project_level) {
       console.log(`  - Referencia Karpathy: ${m.tiene_referencia_karpathy ? 'sí' : 'no'}`);
     }
@@ -436,6 +473,7 @@ module.exports = {
   ubicarClaudeMd,
   detectarBulletsGigantes,
   detectarReferenciaKarpathy,
+  detectarReferenciasRotas,
   esRutaUserLevel,
   main,
   MAX_LINES,

package/scripts/cli/aprobar-plan.js

@@ -0,0 +1,73 @@
+'use strict';
+
+/**
+ * Subcomando `swl-ses aprobar-plan --fase=N` — parte determinista del gate G1.
+ *
+ * Reemplaza los `node -e "require('./scripts/lib/plan-lock')"` y
+ * `require('./hooks/lib/atomic-write')` que el slash command /swl:aprobar-plan
+ * tenía inline — rutas relativas al proyecto que se rompían en instalaciones
+ * downstream (ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Hace: firma el PLAN (SHA256 → .planning/locks/0N-PLAN.md.lock), lo verifica,
+ * y escribe .planning/locks/fase-activa.json (gate G0). El HITL (confirmación,
+ * transición de frontmatter, REQ×T) lo sigue manejando el prompt del comando.
+ *
+ * Uso: swl-ses aprobar-plan --fase=N [--plan=<ruta>] [--aprobado-por="texto"]
+ */
+
+const path = require('node:path');
+const { firmarPlan, verificarPlan } = require('../lib/plan-lock');
+const { atomicWriteJSON } = require('../../hooks/lib/atomic-write');
+const { resolverPlanPath } = require('../lib/resolver-plan-fase');
+
+function aprobarPlan(opciones = {}) {
+  opciones = opciones || {};
+  const planPath = resolverPlanPath(opciones);
+  if (!planPath) {
+    console.error('Uso: swl-ses aprobar-plan --fase=N [--plan=<ruta>] [--aprobado-por="texto"]');
+    process.exit(1);
+  }
+
+  const firmadoPor = opciones['aprobado-por'] || opciones.aprobado_por || 'swl:aprobar-plan';
+  const firma = firmarPlan(planPath, { firmadoPor });
+  if (!firma.ok) {
+    console.error(`[aprobar-plan] no se pudo firmar el PLAN: ${firma.motivo}`);
+    process.exit(1);
+  }
+
+  const ver = verificarPlan(planPath);
+  const numero =
+    opciones.fase != null && opciones.fase !== true ? Number(opciones.fase) : null;
+  const locksDir = path.dirname(firma.lockPath);
+  const faseActivaPath = path.join(locksDir, 'fase-activa.json');
+
+  atomicWriteJSON(faseActivaPath, {
+    numero,
+    planPath,
+    sha256: firma.sha256,
+    aprobadoEn: new Date().toISOString(),
+    aprobadoPor: opciones['aprobado-por'] || opciones.aprobado_por || 'usuario via /swl:aprobar-plan',
+  });
+
+  console.log(
+    JSON.stringify(
+      {
+        ok: true,
+        planPath,
+        sha256: firma.sha256,
+        lockPath: firma.lockPath,
+        modo: ver.modo,
+        faseActiva: faseActivaPath,
+      },
+      null,
+      2
+    )
+  );
+}
+
+module.exports = aprobarPlan;
+
+if (require.main === module) {
+  const { parsearOpciones } = require('../lib/parsear-opciones');
+  aprobarPlan(parsearOpciones(process.argv.slice(2)));
+}

package/scripts/cli/briefing.js

@@ -0,0 +1,23 @@
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses briefing` — recolecta las señales baratas del briefing
+ * (adr-vencido, deuda-trigger, nudges-pendientes, gate-calibracion,
+ * continue-here) y las imprime sin tope. Reemplaza el inline
+ * `require('./hooks/lib/briefing.js')` relativo al proyecto (roto downstream;
+ * ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses briefing
+ */
+
+const b = require('../../hooks/lib/briefing.js');
+
+function briefingCli() {
+  const items = b.recolectarTodo(process.cwd(), new Date());
+  for (const it of items) {
+    console.log('— [' + it.categoria + '] ' + it.titulo + ' → ' + it.accion);
+  }
+  if (items.length === 0) console.log('(sin señales baratas)');
+}
+
+module.exports = briefingCli;

package/scripts/cli/ciclo-evolucion.js

@@ -0,0 +1,26 @@
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses ciclo-evolucion` — regenera las métricas de evolución
+ * (.planning/evolution/metricas.json) ejecutando la sub-etapa Stop del ciclo.
+ * Reemplaza `echo '{}' | node hooks/ciclo-evolucion.js` relativo al proyecto
+ * (roto downstream; ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses ciclo-evolucion
+ */
+
+const cicloEvolucion = require('../../hooks/lib/ciclo-evolucion');
+
+function cicloEvolucionCli() {
+  try {
+    cicloEvolucion.ejecutarStop('{}');
+    console.log('[ciclo-evolucion] métricas de evolución regeneradas');
+  } catch (e) {
+    // A diferencia del hook (que nunca bloquea el harness), el CLI sí debe
+    // distinguir fallo de éxito para el caller: stderr + exit code != 0.
+    console.error('[ciclo-evolucion] no se pudo regenerar: ' + e.message);
+    process.exitCode = 1;
+  }
+}
+
+module.exports = cicloEvolucionCli;

package/scripts/cli/configurar-ci.js

@@ -0,0 +1,40 @@
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses configurar-ci <op>` — gestiona los workflows CI/CD de SWL
+ * en el proyecto actual. Reemplaza los inline `require('./scripts/lib/configurar-ci')`
+ * relativos al proyecto (rotos downstream; ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Ops (todas imprimen el resultado como JSON para que el comando lo inspeccione):
+ *   init      [--no-security] [--no-ci] [--with-release-please] [--dry-run] [--force]
+ *   status    (default)
+ *   uninstall [--confirmar]
+ */
+
+const ci = require('../lib/configurar-ci');
+
+function configurarCi(opciones = {}) {
+  const op = (opciones._args && opciones._args[0]) || opciones.op || 'status';
+
+  if (op === 'init') {
+    const r = ci.init({
+      withSecurity: !opciones['no-security'],
+      withCi: !opciones['no-ci'],
+      withReleasePlease: !!opciones['with-release-please'],
+      dryRun: !!opciones['dry-run'],
+      force: !!opciones.force,
+    });
+    console.log(JSON.stringify(r, null, 2));
+    return;
+  }
+
+  if (op === 'uninstall') {
+    const r = ci.uninstall({ confirmar: !!opciones.confirmar });
+    console.log(JSON.stringify(r, null, 2));
+    return;
+  }
+
+  console.log(JSON.stringify(ci.status(), null, 2));
+}
+
+module.exports = configurarCi;

package/scripts/cli/derivar-feature-list.js

@@ -0,0 +1,25 @@
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses derivar-feature-list` — genera .planning/feature-list.json
+ * desde HOJA-RUTA.md. Reemplaza `node scripts/derivar-feature-list.js` relativo
+ * al proyecto (roto downstream; ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses derivar-feature-list [--check]   (--check: exit 2 si hay drift)
+ */
+
+const { main } = require('../derivar-feature-list.js');
+
+function derivarFeatureList(opciones = {}) {
+  const args = ['node', 'derivar-feature-list'];
+  if (opciones && opciones.check) args.push('--check');
+  const argvOriginal = process.argv;
+  process.argv = args;
+  try {
+    return main();
+  } finally {
+    process.argv = argvOriginal;
+  }
+}
+
+module.exports = derivarFeatureList;