@saulwade/swl-ses 2.2.4 → 2.3.1

package/scripts/benchmark-memoria.js

@@ -1,167 +1,167 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * benchmark-memoria.js — CLI runner para benchmark de retrieval sobre memoria SWL.
- *
- * Ejecuta queries de un dataset JSONL contra `hooks/lib/memory-search`
- * (que usa RRF fusion sobre aprendizajes/sesiones/instintos) y reporta
- * métricas R@5, R@10, R@20, MRR, nDCG@10, P@5.
- *
- * Patrón adoptado de `temp/agentmemory-main/benchmark/longmemeval-bench.ts`.
- * Adaptado para swl-ses: file-based, sin embeddings ML, dataset SWL-específico.
- *
- * Uso:
- *   node scripts/benchmark-memoria.js [opciones]
- *
- * Opciones:
- *   --dataset <ruta>   Dataset JSONL (default: .planning/benchmark/dataset.jsonl)
- *   --limit <n>        Top-k a recuperar por query (default: 20)
- *   --json             Output en JSON (para scripts)
- *   --verbose          Detalle por query
- *
- * Exit codes:
- *   0 - OK
- *   1 - Error de I/O o dataset inválido
- *   2 - Argumentos inválidos
- *
- * Persistencia opcional: si se setea SWL_BENCHMARK_PERSIST=1, escribe
- * el resultado agregado a `.planning/evolution/benchmark-memoria.jsonl`
- * para tracking histórico.
- */
-
-const fs   = require('fs');
-const path = require('path');
-
-const { ejecutarDataset } = require('./lib/longmemeval-runner');
-
-const DATASET_DEFAULT = '.planning/benchmark/dataset.jsonl';
-const HISTORICO_PATH  = '.planning/evolution/benchmark-memoria.jsonl';
-
-function uso() {
-  console.error('Uso: node scripts/benchmark-memoria.js [--dataset <ruta>] [--limit <n>] [--json] [--verbose]');
-  process.exit(2);
-}
-
-function parseArgs(argv) {
-  const opts = {
-    dataset: DATASET_DEFAULT,
-    limit: 20,
-    json: false,
-    verbose: false,
-  };
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    if (arg === '--dataset') opts.dataset = argv[++i];
-    else if (arg === '--limit') opts.limit = parseInt(argv[++i], 10) || 20;
-    else if (arg === '--json') opts.json = true;
-    else if (arg === '--verbose') opts.verbose = true;
-    else if (arg === '--help' || arg === '-h') uso();
-  }
-  return opts;
-}
-
-function persistirHistorico(baseDir, resumen) {
-  if (process.env.SWL_BENCHMARK_PERSIST !== '1') return;
-  try {
-    const dirEvolucion = path.join(baseDir, '.planning', 'evolution');
-    if (!fs.existsSync(dirEvolucion)) fs.mkdirSync(dirEvolucion, { recursive: true });
-    const linea = JSON.stringify({
-      timestamp: new Date().toISOString(),
-      ...resumen,
-    });
-    fs.appendFileSync(path.join(baseDir, HISTORICO_PATH), linea + '\n', 'utf8');
-  } catch (_) {
-    // best-effort
-  }
-}
-
-function reportarTexto(resultado, opts) {
-  const { promedio, dataset, entries } = resultado;
-
-  console.log('================================================================');
-  console.log('   Benchmark de retrieval de memoria SWL');
-  console.log('================================================================');
-  console.log('');
-  console.log(`Dataset:      ${opts.dataset}`);
-  console.log(`Total queries: ${dataset.total}`);
-  console.log(`  Reales:      ${dataset.real}`);
-  console.log(`  Placeholder: ${dataset.placeholder}`);
-  console.log(`Significativo: ${dataset.significativo ? 'sí' : 'NO (requiere ≥30 reales)'}`);
-  console.log('');
-
-  if (!dataset.significativo) {
-    console.log('⚠ ADVERTENCIA: dataset con menos de 30 queries reales.');
-    console.log('  Las métricas son INDICATIVAS, no estadísticamente significativas.');
-    console.log('  Para usar como gate de release, expandir el dataset con preguntas');
-    console.log('  curadas extraídas de uso real (ver SKILL.md de benchmark-memoria).');
-    console.log('');
-  }
-
-  console.log('────────────── Métricas agregadas ──────────────');
-  console.log(`  Recall @ 5:     ${(promedio.recall_at_5 * 100).toFixed(1)}%`);
-  console.log(`  Recall @ 10:    ${(promedio.recall_at_10 * 100).toFixed(1)}%`);
-  console.log(`  Recall @ 20:    ${(promedio.recall_at_20 * 100).toFixed(1)}%`);
-  console.log(`  MRR:            ${promedio.mrr.toFixed(3)}`);
-  console.log(`  nDCG @ 10:      ${promedio.ndcg_at_10.toFixed(3)}`);
-  console.log(`  Precision @ 5:  ${(promedio.precision_at_5 * 100).toFixed(1)}%`);
-  console.log('');
-
-  if (opts.verbose) {
-    console.log('────────────── Detalle por query ──────────────');
-    for (const r of entries) {
-      const mark = r.metricas.recall_at_5 > 0 ? '✓' : '✗';
-      console.log(`  ${mark} ${r.question_id} [${r.category || 'n/a'}, ${r.status}] ` +
-        `R@5=${r.metricas.recall_at_5} R@10=${r.metricas.recall_at_10} ` +
-        `MRR=${r.metricas.mrr.toFixed(2)} (${r.latencyMs}ms)`);
-      if (r.metricas.recall_at_5 === 0 && opts.verbose) {
-        console.log(`      Q: ${r.question.slice(0, 80)}`);
-        console.log(`      Gold:      ${r.goldIds.slice(0, 3).join(', ')}${r.goldIds.length > 3 ? '...' : ''}`);
-        console.log(`      Retrieved: ${r.retrievedIds.slice(0, 5).join(', ')}`);
-      }
-    }
-    console.log('');
-  }
-}
-
-function main() {
-  const opts = parseArgs(process.argv.slice(2));
-  const baseDir = process.cwd();
-
-  if (!fs.existsSync(opts.dataset)) {
-    console.error(`Dataset no encontrado: ${opts.dataset}`);
-    console.error(`Crea uno o usa el placeholder en ${DATASET_DEFAULT}.`);
-    process.exit(1);
-  }
-
-  let resultado;
-  try {
-    resultado = ejecutarDataset(baseDir, opts.dataset, { limit: opts.limit });
-  } catch (err) {
-    console.error(`Error ejecutando benchmark: ${err.message}`);
-    process.exit(1);
-  }
-
-  if (opts.json) {
-    console.log(JSON.stringify(resultado, null, 2));
-  } else {
-    reportarTexto(resultado, opts);
-  }
-
-  persistirHistorico(baseDir, {
-    dataset: opts.dataset,
-    n: resultado.dataset.total,
-    significativo: resultado.dataset.significativo,
-    promedio: resultado.promedio,
-  });
-
-  process.exit(0);
-}
-
-if (require.main === module) {
-  main();
-}
-
-module.exports = {
-  parseArgs,
-};
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * benchmark-memoria.js — CLI runner para benchmark de retrieval sobre memoria SWL.
+ *
+ * Ejecuta queries de un dataset JSONL contra `hooks/lib/memory-search`
+ * (que usa RRF fusion sobre aprendizajes/sesiones/instintos) y reporta
+ * métricas R@5, R@10, R@20, MRR, nDCG@10, P@5.
+ *
+ * Patrón adoptado de `temp/agentmemory-main/benchmark/longmemeval-bench.ts`.
+ * Adaptado para swl-ses: file-based, sin embeddings ML, dataset SWL-específico.
+ *
+ * Uso:
+ *   node scripts/benchmark-memoria.js [opciones]
+ *
+ * Opciones:
+ *   --dataset <ruta>   Dataset JSONL (default: .planning/benchmark/dataset.jsonl)
+ *   --limit <n>        Top-k a recuperar por query (default: 20)
+ *   --json             Output en JSON (para scripts)
+ *   --verbose          Detalle por query
+ *
+ * Exit codes:
+ *   0 - OK
+ *   1 - Error de I/O o dataset inválido
+ *   2 - Argumentos inválidos
+ *
+ * Persistencia opcional: si se setea SWL_BENCHMARK_PERSIST=1, escribe
+ * el resultado agregado a `.planning/evolution/benchmark-memoria.jsonl`
+ * para tracking histórico.
+ */
+
+const fs   = require('fs');
+const path = require('path');
+
+const { ejecutarDataset } = require('./lib/longmemeval-runner');
+
+const DATASET_DEFAULT = '.planning/benchmark/dataset.jsonl';
+const HISTORICO_PATH  = '.planning/evolution/benchmark-memoria.jsonl';
+
+function uso() {
+  console.error('Uso: node scripts/benchmark-memoria.js [--dataset <ruta>] [--limit <n>] [--json] [--verbose]');
+  process.exit(2);
+}
+
+function parseArgs(argv) {
+  const opts = {
+    dataset: DATASET_DEFAULT,
+    limit: 20,
+    json: false,
+    verbose: false,
+  };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === '--dataset') opts.dataset = argv[++i];
+    else if (arg === '--limit') opts.limit = parseInt(argv[++i], 10) || 20;
+    else if (arg === '--json') opts.json = true;
+    else if (arg === '--verbose') opts.verbose = true;
+    else if (arg === '--help' || arg === '-h') uso();
+  }
+  return opts;
+}
+
+function persistirHistorico(baseDir, resumen) {
+  if (process.env.SWL_BENCHMARK_PERSIST !== '1') return;
+  try {
+    const dirEvolucion = path.join(baseDir, '.planning', 'evolution');
+    if (!fs.existsSync(dirEvolucion)) fs.mkdirSync(dirEvolucion, { recursive: true });
+    const linea = JSON.stringify({
+      timestamp: new Date().toISOString(),
+      ...resumen,
+    });
+    fs.appendFileSync(path.join(baseDir, HISTORICO_PATH), linea + '\n', 'utf8');
+  } catch (_) {
+    // best-effort
+  }
+}
+
+function reportarTexto(resultado, opts) {
+  const { promedio, dataset, entries } = resultado;
+
+  console.log('================================================================');
+  console.log('   Benchmark de retrieval de memoria SWL');
+  console.log('================================================================');
+  console.log('');
+  console.log(`Dataset:      ${opts.dataset}`);
+  console.log(`Total queries: ${dataset.total}`);
+  console.log(`  Reales:      ${dataset.real}`);
+  console.log(`  Placeholder: ${dataset.placeholder}`);
+  console.log(`Significativo: ${dataset.significativo ? 'sí' : 'NO (requiere ≥30 reales)'}`);
+  console.log('');
+
+  if (!dataset.significativo) {
+    console.log('⚠ ADVERTENCIA: dataset con menos de 30 queries reales.');
+    console.log('  Las métricas son INDICATIVAS, no estadísticamente significativas.');
+    console.log('  Para usar como gate de release, expandir el dataset con preguntas');
+    console.log('  curadas extraídas de uso real (ver SKILL.md de benchmark-memoria).');
+    console.log('');
+  }
+
+  console.log('────────────── Métricas agregadas ──────────────');
+  console.log(`  Recall @ 5:     ${(promedio.recall_at_5 * 100).toFixed(1)}%`);
+  console.log(`  Recall @ 10:    ${(promedio.recall_at_10 * 100).toFixed(1)}%`);
+  console.log(`  Recall @ 20:    ${(promedio.recall_at_20 * 100).toFixed(1)}%`);
+  console.log(`  MRR:            ${promedio.mrr.toFixed(3)}`);
+  console.log(`  nDCG @ 10:      ${promedio.ndcg_at_10.toFixed(3)}`);
+  console.log(`  Precision @ 5:  ${(promedio.precision_at_5 * 100).toFixed(1)}%`);
+  console.log('');
+
+  if (opts.verbose) {
+    console.log('────────────── Detalle por query ──────────────');
+    for (const r of entries) {
+      const mark = r.metricas.recall_at_5 > 0 ? '✓' : '✗';
+      console.log(`  ${mark} ${r.question_id} [${r.category || 'n/a'}, ${r.status}] ` +
+        `R@5=${r.metricas.recall_at_5} R@10=${r.metricas.recall_at_10} ` +
+        `MRR=${r.metricas.mrr.toFixed(2)} (${r.latencyMs}ms)`);
+      if (r.metricas.recall_at_5 === 0 && opts.verbose) {
+        console.log(`      Q: ${r.question.slice(0, 80)}`);
+        console.log(`      Gold:      ${r.goldIds.slice(0, 3).join(', ')}${r.goldIds.length > 3 ? '...' : ''}`);
+        console.log(`      Retrieved: ${r.retrievedIds.slice(0, 5).join(', ')}`);
+      }
+    }
+    console.log('');
+  }
+}
+
+function main() {
+  const opts = parseArgs(process.argv.slice(2));
+  const baseDir = process.cwd();
+
+  if (!fs.existsSync(opts.dataset)) {
+    console.error(`Dataset no encontrado: ${opts.dataset}`);
+    console.error(`Crea uno o usa el placeholder en ${DATASET_DEFAULT}.`);
+    process.exit(1);
+  }
+
+  let resultado;
+  try {
+    resultado = ejecutarDataset(baseDir, opts.dataset, { limit: opts.limit });
+  } catch (err) {
+    console.error(`Error ejecutando benchmark: ${err.message}`);
+    process.exit(1);
+  }
+
+  if (opts.json) {
+    console.log(JSON.stringify(resultado, null, 2));
+  } else {
+    reportarTexto(resultado, opts);
+  }
+
+  persistirHistorico(baseDir, {
+    dataset: opts.dataset,
+    n: resultado.dataset.total,
+    significativo: resultado.dataset.significativo,
+    promedio: resultado.promedio,
+  });
+
+  process.exit(0);
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  parseArgs,
+};

package/scripts/bootstrap-instintos.js

@@ -49,15 +49,31 @@ const flags = {
 // Config de secciones → confidence/tags
 // ---------------------------------------------------------------------------
 
+// tipo_memoria (eje cognitivo, Fase 19): patron/anti-patron = "cómo hacer / qué
+// evitar" → procedural; decisión/gotcha/regla = hechos → semantic. episodic NO se
+// infiere del bootstrap (nace de registros de sesión, no de APRENDIZAJES).
 const SECCIONES = [
-  { regex: /anti[-\s]?patrones?/i,                  confidence: 0.7, tags: ['anti-patron'] },
-  { regex: /patrones?\s+exitosos?/i,                confidence: 0.6, tags: ['patron'] },
-  { regex: /decisiones?\s+de\s+arquitectura/i,      confidence: 0.8, tags: ['decision', 'arquitectura'] },
-  { regex: /gotchas?/i,                             confidence: 0.6, tags: ['gotcha'] },
-  { regex: /patrones?/i,                            confidence: 0.6, tags: ['patron'] },
-  { regex: /reglas?\s+de\s+proyecto/i,              confidence: 0.8, tags: ['regla-proyecto'] },
+  { regex: /anti[-\s]?patrones?/i,                  confidence: 0.7, tags: ['anti-patron'], tipoMemoria: 'procedural' },
+  { regex: /patrones?\s+exitosos?/i,                confidence: 0.6, tags: ['patron'], tipoMemoria: 'procedural' },
+  { regex: /decisiones?\s+de\s+arquitectura/i,      confidence: 0.8, tags: ['decision', 'arquitectura'], tipoMemoria: 'semantic' },
+  { regex: /gotchas?/i,                             confidence: 0.6, tags: ['gotcha'], tipoMemoria: 'semantic' },
+  { regex: /patrones?/i,                            confidence: 0.6, tags: ['patron'], tipoMemoria: 'procedural' },
+  { regex: /reglas?\s+de\s+proyecto/i,              confidence: 0.8, tags: ['regla-proyecto'], tipoMemoria: 'semantic' },
 ];
 
+/**
+ * Infiere el eje cognitivo de memoria de un instinto por su sección de origen.
+ * Heurístico declarado (no autoritativo): default 'semantic' para hechos.
+ * @param {string} seccion
+ * @returns {'semantic'|'episodic'|'procedural'}
+ */
+function inferirTipoMemoria(seccion) {
+  for (const s of SECCIONES) {
+    if (s.regex.test(seccion || '')) return s.tipoMemoria;
+  }
+  return 'semantic';
+}
+
 function detectarConfidence(seccion) {
   for (const s of SECCIONES) {
     if (s.regex.test(seccion)) return { confidence: s.confidence, tags: [...s.tags] };
@@ -163,6 +179,7 @@ function generarInstintos(entradas) {
       tags,
       created_at: hoy,
       seccion_origen: e.seccion,
+      tipo_memoria: inferirTipoMemoria(e.seccion),
       decay_half_life_days: 90,
       helpful_count: 0,
       harmful_count: 0,
@@ -200,6 +217,7 @@ instintos:
       `    tags: [${i.tags.map(t => `"${t}"`).join(', ')}]`,
       `    created_at: "${i.created_at}"`,
       `    seccion_origen: ${escapeYaml(i.seccion_origen)}`,
+      `    tipo_memoria: ${i.tipo_memoria}`,
       `    decay_half_life_days: ${i.decay_half_life_days}`,
       `    helpful_count: ${i.helpful_count}`,
       `    harmful_count: ${i.harmful_count}`,
@@ -266,4 +284,4 @@ function main() {
 
 if (require.main === module) main();
 
-module.exports = { parsearAprendizajes, generarInstintos, detectarConfidence, main };
+module.exports = { parsearAprendizajes, generarInstintos, detectarConfidence, inferirTipoMemoria, 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/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;

package/scripts/cli/ciclo-evolucion.js

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