@saulwade/swl-ses 2.2.0 → 2.2.3

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-13T23:48:35.239Z",
+  "generatedAt": "2026-06-15T05:12:07.891Z",
   "skillsCount": 182,
-  "lockHash": "sha256:9a83648f9615e563db51b1ff72c083526892f9dd1e0a34513dbc104e1caf29ff",
+  "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,8 +1134,8 @@
     {
       "nombre": "swl-claudemd",
       "path": "habilidades/swl-claudemd/SKILL.md",
-      "hash": "sha256:6e8abe48bacd9059047df2b33bcd4df20e46c88e3df6d6692800896c003050e7",
-      "bytes": 16060,
+      "hash": "sha256:97f678f4471b6246c181c074fc64275cbef394109402b80aef8cc56bef3ba0b5",
+      "bytes": 15647,
       "version": "\"1.3.0\""
     },
     {
@@ -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.2.0",
+  "version": "2.2.3",
   "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.2.0",
+  "version": "2.2.3",
   "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/doctor.js

@@ -159,6 +159,15 @@ async function doctor(opciones = {}) {
     advertencias++;
   }
 
+  // C-2: doctor DIAGNOSTICA; no siembra dirs de proyecto (.planning/_userland)
+  // en un cwd que no es un proyecto swl. Correr `doctor` desde un directorio
+  // cualquiera no debe generar clutter. Marcadores de proyecto: .planning/ o
+  // _userland/ ya presentes, o un install-state de scope proyecto.
+  const esProyectoSwl =
+    fs.existsSync(path.join(cwd, '.planning')) ||
+    fs.existsSync(path.join(cwd, '_userland')) ||
+    fs.existsSync(path.join(cwd, '.swl-install-state.json'));
+
   // 3. Verificar .planning/
   const planningDir = path.join(cwd, '.planning');
   if (fs.existsSync(planningDir)) {
@@ -201,6 +210,8 @@ async function doctor(opciones = {}) {
         },
       });
     }
+  } else if (!esProyectoSwl) {
+    console.log(formatearPaso('.planning/', 'No aplica — el directorio actual no es un proyecto swl (usa `swl-ses init` para inicializar)'));
   } else {
     console.log(formatearAdvertencia('.planning/', 'No inicializado'));
     advertencias++;
@@ -230,6 +241,8 @@ async function doctor(opciones = {}) {
     if (agentesUser > 0 || habsUser > 0) {
       console.log(formatearPaso('Componentes usuario', `${agentesUser} agentes, ${habsUser} habilidades`));
     }
+  } else if (!esProyectoSwl) {
+    console.log(formatearPaso('_userland/', 'No aplica — el directorio actual no es un proyecto swl'));
   } else {
     console.log(formatearAdvertencia('_userland/', 'No encontrado'));
     advertencias++;

package/scripts/generar-canonical-hashes.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * generar-canonical-hashes — Genera/actualiza `manifiestos/canonical-hashes.json`.
+ *
+ * Recorre los componentes versionables del fuente (agentes, skills, comandos,
+ * reglas) y registra el hash del cuerpo canónico (sin campos `evolved-*`,
+ * CRLF→LF) bajo la versión actual del paquete:
+ *
+ *   { "<version>": { "<rutaRel>": "<sha256>", ... }, ... }
+ *
+ * El manifiesto es la baseline que el discriminador A/B (Fase 16) usa para
+ * decidir si una copia instalada `evolved:true` fue tocada por el usuario
+ * (población A → merge) o es shipped-evolved intacto (población B → actualizar).
+ *
+ * Modelo de amenaza (auditoría nemesis Fase 16, hallazgo BAJO): el manifiesto
+ * NO lleva firma criptográfica propia. No es un gap incremental: viaja DENTRO
+ * del paquete npm publicado, el mismo límite de confianza que `evolution-tracker.js`
+ * y todo el código. Quien pueda alterar este JSON ya puede alterar el código que
+ * lo consume — firmar el manifiesto sin firmar el paquete entero no añade defensa.
+ * La integridad la provee la cadena de publicación de npm (provenance/SBOM del
+ * release). NO se añade firma propia (sería seguridad teatral). Reabrir SOLO si
+ * el manifiesto se expone como archivo editable fuera del paquete (p. ej. P2P).
+ *
+ * Idempotente: dos corridas sin cambios producen el mismo archivo (keys
+ * ordenadas). Preserva entradas de versiones anteriores (histórico necesario
+ * para discriminar contra clientes que evolucionaron desde una versión vieja).
+ *
+ * Uso:  node scripts/generar-canonical-hashes.js [--check]
+ *   --check  No escribe; exit 2 si el manifiesto está desactualizado (uso CI).
+ *
+ * @module scripts/generar-canonical-hashes
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+const { canonicalHash } = require('./lib/canonical-hash');
+
+const RAIZ = path.resolve(__dirname, '..');
+const MANIFIESTO = path.join(RAIZ, 'manifiestos', 'canonical-hashes.json');
+
+let atomicWriteSync;
+try {
+  ({ atomicWriteSync } = require('../hooks/lib/atomic-write'));
+} catch {
+  atomicWriteSync = (p, c, e) => fs.writeFileSync(p, c, e);
+}
+
+/** Recolecta los componentes versionables como rutas relativas a la raíz. */
+function recolectarComponentes() {
+  const rutas = [];
+
+  const listarMd = (dirRel) => {
+    const dir = path.join(RAIZ, dirRel);
+    if (!fs.existsSync(dir)) return;
+    for (const entry of fs.readdirSync(dir)) {
+      if (entry.endsWith('.md')) rutas.push(path.posix.join(dirRel, entry));
+    }
+  };
+
+  // Agentes, comandos, reglas: archivos .md planos.
+  listarMd('agentes');
+  listarMd('comandos/swl');
+  listarMd('reglas');
+
+  // Habilidades: cada skill es un directorio con SKILL.md.
+  const habDir = path.join(RAIZ, 'habilidades');
+  if (fs.existsSync(habDir)) {
+    for (const entry of fs.readdirSync(habDir)) {
+      const skillMd = path.join(habDir, entry, 'SKILL.md');
+      if (fs.existsSync(skillMd)) rutas.push(path.posix.join('habilidades', entry, 'SKILL.md'));
+    }
+  }
+
+  return rutas.sort();
+}
+
+/** Construye el mapa { rutaRel: hash } de la versión actual del fuente. */
+function hashesActuales() {
+  const out = {};
+  for (const rel of recolectarComponentes()) {
+    const abs = path.join(RAIZ, rel);
+    out[rel] = canonicalHash(fs.readFileSync(abs, 'utf8'));
+  }
+  return out;
+}
+
+/** Ordena recursivamente las keys de un objeto plano de 2 niveles. */
+function ordenar(manifiesto) {
+  const out = {};
+  for (const version of Object.keys(manifiesto).sort()) {
+    const porVersion = manifiesto[version];
+    out[version] = {};
+    for (const k of Object.keys(porVersion).sort()) out[version][k] = porVersion[k];
+  }
+  return out;
+}
+
+function cargarManifiesto() {
+  if (!fs.existsSync(MANIFIESTO)) return {};
+  try {
+    return JSON.parse(fs.readFileSync(MANIFIESTO, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+function generar({ check = false } = {}) {
+  const version = require(path.join(RAIZ, 'package.json')).version;
+  const manifiesto = cargarManifiesto();
+  manifiesto[version] = hashesActuales();
+  const ordenado = ordenar(manifiesto);
+  const serializado = JSON.stringify(ordenado, null, 2) + '\n';
+
+  const previo = fs.existsSync(MANIFIESTO) ? fs.readFileSync(MANIFIESTO, 'utf8') : '';
+  // Comparación EOL-tolerante: git puede normalizar el .json a CRLF en checkout
+  // (Windows). El contenido semántico es idéntico; comparar normalizado evita
+  // un falso "desactualizado" en el gate `--check` cross-OS.
+  const norm = (s) => s.replace(/\r\n/g, '\n');
+  const cambio = norm(previo) !== norm(serializado);
+
+  if (check) {
+    if (cambio) {
+      console.error(`[canonical-hashes] DESACTUALIZADO para v${version} — ejecuta: node scripts/generar-canonical-hashes.js`);
+      process.exitCode = 2;
+    } else {
+      console.log(`[canonical-hashes] OK — v${version} al día (${Object.keys(ordenado[version]).length} componentes)`);
+    }
+    return ordenado;
+  }
+
+  if (cambio) {
+    atomicWriteSync(MANIFIESTO, serializado, 'utf8');
+    console.log(`[canonical-hashes] escrito v${version} (${Object.keys(ordenado[version]).length} componentes) → ${path.relative(RAIZ, MANIFIESTO)}`);
+  } else {
+    console.log(`[canonical-hashes] sin cambios para v${version}`);
+  }
+  return ordenado;
+}
+
+if (require.main === module) {
+  generar({ check: process.argv.includes('--check') });
+}
+
+module.exports = { generar, hashesActuales, recolectarComponentes, MANIFIESTO };