@saulwade/swl-ses 2.6.0 → 2.8.0

package/scripts/canario-hooks.js

@@ -1,166 +1,166 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * canario-hooks.js — Canario de hooks: prueba que cada hook es viable y visible.
- *
- * Clase que cierra: "hook que funciona perfecto y nadie ve". Dos muertes
- * silenciosas documentadas: (a) check-update requería libs de scripts/lib/ no
- * distribuidas — MODULE_NOT_FOUND tragado por el wrapper en TODA instalación
- * destino desde su creación; (b) avisos emitidos por stderr con exit 0 (canal
- * invisible). La (b) la cubre auditar-clases-conocidas C3; este canario cubre
- * la (a) y la ejecución real.
- *
- * Modo default (rápido — test:all):
- *   Por cada hook ejecutable de hooks/*.js, extrae su grafo de requires
- *   relativos (transitivo) y verifica que todo archivo que EXISTE en el repo
- *   esté registrado en manifiestos/modulos.json — si no, el instalador no lo
- *   distribuye y el hook muere en silencio en el destino. Paths de fallback
- *   que no existen en el repo (patrón de require tolerante) se omiten.
- *
- * Modo --smoke (test:release):
- *   Además EJECUTA cada hook en un sandbox temporal (cwd aislado — las
- *   escrituras de telemetría van al sandbox) con un evento JSON mínimo por
- *   stdin. FALLA si el hook crashea (exit ≠ 0 y ≠ 2). Timeout (5s) es WARN
- *   informativo, no fallo: un hook lento no rompe la sesión (el harness lo
- *   corta), pero un hook que crashea al cargar es la clase (a) viva.
- *   Reporta tabla de visibilidad (bytes stdout/stderr) para auditoría humana.
- *
- * Exit: 0 limpio · 1 con fallas.
- */
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-const RAIZ = path.resolve(__dirname, '..');
-const SMOKE = process.argv.includes('--smoke');
-const RX_REQUIRE = /require\(\s*['"](\.[^'"]+)['"]\s*\)/g;
-
-function hooksEjecutables() {
-  // Forward slashes SIEMPRE: se comparan contra modulos.json (formato repo).
-  return fs.readdirSync(path.join(RAIZ, 'hooks'))
-    .filter(f => f.endsWith('.js'))
-    .map(f => `hooks/${f}`);
-}
-
-function archivosRegistrados() {
-  const m = JSON.parse(fs.readFileSync(path.join(RAIZ, 'manifiestos', 'modulos.json'), 'utf8'));
-  const set = new Set();
-  for (const mod of Object.values(m.modulos || {})) {
-    for (const a of mod.archivos || []) set.add(a.replace(/\\/g, '/'));
-  }
-  return set;
-}
-
-/** Resuelve un require relativo a .js real (agrega .js / index.js). */
-function resolverRequire(desdeArchivo, spec) {
-  const base = path.resolve(RAIZ, path.dirname(desdeArchivo), spec);
-  for (const cand of [base, `${base}.js`, path.join(base, 'index.js'), `${base}.json`]) {
-    if (fs.existsSync(cand) && fs.statSync(cand).isFile()) {
-      return path.relative(RAIZ, cand).replace(/\\/g, '/');
-    }
-  }
-  return null; // fallback de require tolerante que solo existe en el destino
-}
-
-/** Grafo transitivo de requires relativos que existen en el repo. */
-function grafoRequires(archivoInicial) {
-  const vistos = new Set();
-  const pila = [archivoInicial];
-  while (pila.length > 0) {
-    const actual = pila.pop();
-    if (vistos.has(actual)) continue;
-    vistos.add(actual);
-    let contenido;
-    try { contenido = fs.readFileSync(path.join(RAIZ, actual), 'utf8'); } catch { continue; }
-    for (const m of contenido.matchAll(RX_REQUIRE)) {
-      const resuelto = resolverRequire(actual, m[1]);
-      if (resuelto && !vistos.has(resuelto)) pila.push(resuelto);
-    }
-  }
-  vistos.delete(archivoInicial);
-  return [...vistos];
-}
-
-function verificarDistribucion(hooks, registrados, fallas) {
-  for (const hook of hooks) {
-    if (!registrados.has(hook)) {
-      fallas.push(`${hook} — el hook mismo no está registrado en modulos.json (no se distribuye)`);
-    }
-    for (const dep of grafoRequires(hook)) {
-      if (dep.endsWith('.json')) continue; // datos empaquetados aparte
-      if (!registrados.has(dep)) {
-        fallas.push(`${hook} — requiere ${dep}, que existe en el repo pero NO está en modulos.json: en el destino el require lanza MODULE_NOT_FOUND y el wrapper lo traga (clase check-update)`);
-      }
-    }
-  }
-}
-
-const EVENTO_MINIMO = JSON.stringify({
-  session_id: 'canario-smoke',
-  hook_event_name: 'PostToolUse',
-  tool_name: 'Write',
-  tool_input: { file_path: 'canario.md', content: 'canario' },
-  tool_response: { success: true },
-});
-
-function smokeEjecutar(hooks, fallas) {
-  const sandbox = fs.mkdtempSync(path.join(os.tmpdir(), 'swl-canario-'));
-  const tabla = [];
-  try {
-    for (const hook of hooks) {
-      const r = spawnSync(process.execPath, [path.join(RAIZ, hook)], {
-        cwd: sandbox,
-        input: EVENTO_MINIMO,
-        encoding: 'utf8',
-        timeout: 5000,
-        env: { ...process.env, SWL_CANARIO_SMOKE: '1' },
-      });
-      const nombre = path.basename(hook);
-      if (r.error && r.error.code === 'ETIMEDOUT') {
-        tabla.push(`  [WARN timeout] ${nombre} — >5s con evento mínimo (no rompe la sesión, pero revisar)`);
-        continue;
-      }
-      const exit = r.status;
-      if (exit !== 0 && exit !== 2) {
-        const stderr = (r.stderr || '').split(/\r?\n/).find(l => l.trim()) || 'sin stderr';
-        fallas.push(`${hook} — crasheó con exit ${exit} ante evento mínimo: ${stderr.slice(0, 140)}`);
-        continue;
-      }
-      const out = (r.stdout || '').length;
-      const err = (r.stderr || '').length;
-      tabla.push(`  [ok exit ${exit}] ${nombre} — stdout:${out}B stderr:${err}B${exit === 0 && out === 0 && err > 0 ? '  ← solo stderr con exit 0: si esto es un aviso al usuario, es invisible (C3-runtime)' : ''}`);
-    }
-  } finally {
-    try { fs.rmSync(sandbox, { recursive: true, force: true }); } catch { /* mejor esfuerzo */ }
-  }
-  return tabla;
-}
-
-function main() {
-  const hooks = hooksEjecutables();
-  const registrados = archivosRegistrados();
-  const fallas = [];
-
-  verificarDistribucion(hooks, registrados, fallas);
-
-  let tabla = [];
-  if (SMOKE) tabla = smokeEjecutar(hooks, fallas);
-
-  if (tabla.length > 0) {
-    console.log('[canario-hooks] Visibilidad por hook (smoke en sandbox):');
-    for (const l of tabla) console.log(l);
-  }
-  if (fallas.length === 0) {
-    console.log(`[canario-hooks] OK — ${hooks.length} hooks: grafo de requires distribuido completo${SMOKE ? ' + smoke sin crashes' : ''}`);
-    return;
-  }
-  console.error(`[canario-hooks] ${fallas.length} falla(s):`);
-  for (const f of fallas) console.error('  - ' + f);
-  process.exitCode = 1;
-}
-
-module.exports = { grafoRequires, resolverRequire };
-if (require.main === module) main();
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * canario-hooks.js — Canario de hooks: prueba que cada hook es viable y visible.
+ *
+ * Clase que cierra: "hook que funciona perfecto y nadie ve". Dos muertes
+ * silenciosas documentadas: (a) check-update requería libs de scripts/lib/ no
+ * distribuidas — MODULE_NOT_FOUND tragado por el wrapper en TODA instalación
+ * destino desde su creación; (b) avisos emitidos por stderr con exit 0 (canal
+ * invisible). La (b) la cubre auditar-clases-conocidas C3; este canario cubre
+ * la (a) y la ejecución real.
+ *
+ * Modo default (rápido — test:all):
+ *   Por cada hook ejecutable de hooks/*.js, extrae su grafo de requires
+ *   relativos (transitivo) y verifica que todo archivo que EXISTE en el repo
+ *   esté registrado en manifiestos/modulos.json — si no, el instalador no lo
+ *   distribuye y el hook muere en silencio en el destino. Paths de fallback
+ *   que no existen en el repo (patrón de require tolerante) se omiten.
+ *
+ * Modo --smoke (test:release):
+ *   Además EJECUTA cada hook en un sandbox temporal (cwd aislado — las
+ *   escrituras de telemetría van al sandbox) con un evento JSON mínimo por
+ *   stdin. FALLA si el hook crashea (exit ≠ 0 y ≠ 2). Timeout (5s) es WARN
+ *   informativo, no fallo: un hook lento no rompe la sesión (el harness lo
+ *   corta), pero un hook que crashea al cargar es la clase (a) viva.
+ *   Reporta tabla de visibilidad (bytes stdout/stderr) para auditoría humana.
+ *
+ * Exit: 0 limpio · 1 con fallas.
+ */
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const RAIZ = path.resolve(__dirname, '..');
+const SMOKE = process.argv.includes('--smoke');
+const RX_REQUIRE = /require\(\s*['"](\.[^'"]+)['"]\s*\)/g;
+
+function hooksEjecutables() {
+  // Forward slashes SIEMPRE: se comparan contra modulos.json (formato repo).
+  return fs.readdirSync(path.join(RAIZ, 'hooks'))
+    .filter(f => f.endsWith('.js'))
+    .map(f => `hooks/${f}`);
+}
+
+function archivosRegistrados() {
+  const m = JSON.parse(fs.readFileSync(path.join(RAIZ, 'manifiestos', 'modulos.json'), 'utf8'));
+  const set = new Set();
+  for (const mod of Object.values(m.modulos || {})) {
+    for (const a of mod.archivos || []) set.add(a.replace(/\\/g, '/'));
+  }
+  return set;
+}
+
+/** Resuelve un require relativo a .js real (agrega .js / index.js). */
+function resolverRequire(desdeArchivo, spec) {
+  const base = path.resolve(RAIZ, path.dirname(desdeArchivo), spec);
+  for (const cand of [base, `${base}.js`, path.join(base, 'index.js'), `${base}.json`]) {
+    if (fs.existsSync(cand) && fs.statSync(cand).isFile()) {
+      return path.relative(RAIZ, cand).replace(/\\/g, '/');
+    }
+  }
+  return null; // fallback de require tolerante que solo existe en el destino
+}
+
+/** Grafo transitivo de requires relativos que existen en el repo. */
+function grafoRequires(archivoInicial) {
+  const vistos = new Set();
+  const pila = [archivoInicial];
+  while (pila.length > 0) {
+    const actual = pila.pop();
+    if (vistos.has(actual)) continue;
+    vistos.add(actual);
+    let contenido;
+    try { contenido = fs.readFileSync(path.join(RAIZ, actual), 'utf8'); } catch { continue; }
+    for (const m of contenido.matchAll(RX_REQUIRE)) {
+      const resuelto = resolverRequire(actual, m[1]);
+      if (resuelto && !vistos.has(resuelto)) pila.push(resuelto);
+    }
+  }
+  vistos.delete(archivoInicial);
+  return [...vistos];
+}
+
+function verificarDistribucion(hooks, registrados, fallas) {
+  for (const hook of hooks) {
+    if (!registrados.has(hook)) {
+      fallas.push(`${hook} — el hook mismo no está registrado en modulos.json (no se distribuye)`);
+    }
+    for (const dep of grafoRequires(hook)) {
+      if (dep.endsWith('.json')) continue; // datos empaquetados aparte
+      if (!registrados.has(dep)) {
+        fallas.push(`${hook} — requiere ${dep}, que existe en el repo pero NO está en modulos.json: en el destino el require lanza MODULE_NOT_FOUND y el wrapper lo traga (clase check-update)`);
+      }
+    }
+  }
+}
+
+const EVENTO_MINIMO = JSON.stringify({
+  session_id: 'canario-smoke',
+  hook_event_name: 'PostToolUse',
+  tool_name: 'Write',
+  tool_input: { file_path: 'canario.md', content: 'canario' },
+  tool_response: { success: true },
+});
+
+function smokeEjecutar(hooks, fallas) {
+  const sandbox = fs.mkdtempSync(path.join(os.tmpdir(), 'swl-canario-'));
+  const tabla = [];
+  try {
+    for (const hook of hooks) {
+      const r = spawnSync(process.execPath, [path.join(RAIZ, hook)], {
+        cwd: sandbox,
+        input: EVENTO_MINIMO,
+        encoding: 'utf8',
+        timeout: 5000,
+        env: { ...process.env, SWL_CANARIO_SMOKE: '1' },
+      });
+      const nombre = path.basename(hook);
+      if (r.error && r.error.code === 'ETIMEDOUT') {
+        tabla.push(`  [WARN timeout] ${nombre} — >5s con evento mínimo (no rompe la sesión, pero revisar)`);
+        continue;
+      }
+      const exit = r.status;
+      if (exit !== 0 && exit !== 2) {
+        const stderr = (r.stderr || '').split(/\r?\n/).find(l => l.trim()) || 'sin stderr';
+        fallas.push(`${hook} — crasheó con exit ${exit} ante evento mínimo: ${stderr.slice(0, 140)}`);
+        continue;
+      }
+      const out = (r.stdout || '').length;
+      const err = (r.stderr || '').length;
+      tabla.push(`  [ok exit ${exit}] ${nombre} — stdout:${out}B stderr:${err}B${exit === 0 && out === 0 && err > 0 ? '  ← solo stderr con exit 0: si esto es un aviso al usuario, es invisible (C3-runtime)' : ''}`);
+    }
+  } finally {
+    try { fs.rmSync(sandbox, { recursive: true, force: true }); } catch { /* mejor esfuerzo */ }
+  }
+  return tabla;
+}
+
+function main() {
+  const hooks = hooksEjecutables();
+  const registrados = archivosRegistrados();
+  const fallas = [];
+
+  verificarDistribucion(hooks, registrados, fallas);
+
+  let tabla = [];
+  if (SMOKE) tabla = smokeEjecutar(hooks, fallas);
+
+  if (tabla.length > 0) {
+    console.log('[canario-hooks] Visibilidad por hook (smoke en sandbox):');
+    for (const l of tabla) console.log(l);
+  }
+  if (fallas.length === 0) {
+    console.log(`[canario-hooks] OK — ${hooks.length} hooks: grafo de requires distribuido completo${SMOKE ? ' + smoke sin crashes' : ''}`);
+    return;
+  }
+  console.error(`[canario-hooks] ${fallas.length} falla(s):`);
+  for (const f of fallas) console.error('  - ' + f);
+  process.exitCode = 1;
+}
+
+module.exports = { grafoRequires, resolverRequire };
+if (require.main === module) main();

package/scripts/cli/aprobar-plan.js

@@ -1,73 +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)));
-}
+'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/autonomia.js

@@ -1,23 +1,23 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses autonomia` — registro de auto-checkpoints según el
- * dial de autonomía (instintos/autonomia.yaml). Reemplaza el
- * `node hooks/lib/autonomia.js --accion "..."` relativo al proyecto que
- * ejecutar-fase instruía — roto downstream (ver
- * docs/invocacion-cli-cross-scope.md).
- *
- * Uso: swl-ses autonomia --accion="<descripción de la acción>"
- */
-
-const { main } = require('../../hooks/lib/autonomia');
-
-function autonomia(opciones = {}) {
-  const argv = ['node', 'autonomia.js'];
-  if (opciones.accion != null && opciones.accion !== true) {
-    argv.push('--accion', String(opciones.accion));
-  }
-  process.exitCode = main(argv);
-}
-
-module.exports = autonomia;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses autonomia` — registro de auto-checkpoints según el
+ * dial de autonomía (instintos/autonomia.yaml). Reemplaza el
+ * `node hooks/lib/autonomia.js --accion "..."` relativo al proyecto que
+ * ejecutar-fase instruía — roto downstream (ver
+ * docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses autonomia --accion="<descripción de la acción>"
+ */
+
+const { main } = require('../../hooks/lib/autonomia');
+
+function autonomia(opciones = {}) {
+  const argv = ['node', 'autonomia.js'];
+  if (opciones.accion != null && opciones.accion !== true) {
+    argv.push('--accion', String(opciones.accion));
+  }
+  process.exitCode = main(argv);
+}
+
+module.exports = autonomia;

package/scripts/cli/benchmark-memoria.js

@@ -1,37 +1,37 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses benchmark-memoria` — benchmark de retrieval de la
- * memoria del proyecto (scripts/benchmark-memoria.js). Reemplaza el
- * `node scripts/benchmark-memoria.js` relativo al proyecto que
- * benchmark-memoria (skill) instruía — roto downstream (ver
- * docs/invocacion-cli-cross-scope.md).
- *
- * Uso: swl-ses benchmark-memoria [--dataset=ruta] [--limit=N] [--json] [--verbose]
- * (SWL_BENCHMARK_PERSIST=1 en el entorno para tracking histórico.)
- *
- * ADVERTENCIA (nemesis iter-1 S3-6): el main() envuelto llama process.exit()
- * en todas sus ramas — este wrapper TERMINA el proceso host. Correcto vía
- * `bin/swl-ses.js` (proceso fresco por invocación); NO invocar in-process.
- */
-
-const { main } = require('../benchmark-memoria.js');
-
-function benchmarkMemoria(opciones = {}) {
-  // parseArgs del script espera flags de dos tokens (--dataset <ruta>).
-  const args = [];
-  if (opciones.dataset != null && opciones.dataset !== true) args.push('--dataset', String(opciones.dataset));
-  if (opciones.limit != null && opciones.limit !== true) args.push('--limit', String(opciones.limit));
-  if (opciones.json) args.push('--json');
-  if (opciones.verbose) args.push('--verbose');
-
-  const argvOriginal = process.argv;
-  process.argv = ['node', 'benchmark-memoria.js', ...args];
-  try {
-    main();
-  } finally {
-    process.argv = argvOriginal;
-  }
-}
-
-module.exports = benchmarkMemoria;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses benchmark-memoria` — benchmark de retrieval de la
+ * memoria del proyecto (scripts/benchmark-memoria.js). Reemplaza el
+ * `node scripts/benchmark-memoria.js` relativo al proyecto que
+ * benchmark-memoria (skill) instruía — roto downstream (ver
+ * docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses benchmark-memoria [--dataset=ruta] [--limit=N] [--json] [--verbose]
+ * (SWL_BENCHMARK_PERSIST=1 en el entorno para tracking histórico.)
+ *
+ * ADVERTENCIA (nemesis iter-1 S3-6): el main() envuelto llama process.exit()
+ * en todas sus ramas — este wrapper TERMINA el proceso host. Correcto vía
+ * `bin/swl-ses.js` (proceso fresco por invocación); NO invocar in-process.
+ */
+
+const { main } = require('../benchmark-memoria.js');
+
+function benchmarkMemoria(opciones = {}) {
+  // parseArgs del script espera flags de dos tokens (--dataset <ruta>).
+  const args = [];
+  if (opciones.dataset != null && opciones.dataset !== true) args.push('--dataset', String(opciones.dataset));
+  if (opciones.limit != null && opciones.limit !== true) args.push('--limit', String(opciones.limit));
+  if (opciones.json) args.push('--json');
+  if (opciones.verbose) args.push('--verbose');
+
+  const argvOriginal = process.argv;
+  process.argv = ['node', 'benchmark-memoria.js', ...args];
+  try {
+    main();
+  } finally {
+    process.argv = argvOriginal;
+  }
+}
+
+module.exports = benchmarkMemoria;

package/scripts/cli/briefing.js

@@ -1,23 +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;
+'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;