@saulwade/swl-ses 2.6.0 → 2.8.0

package/scripts/cli/ciclo-autonomo.js

@@ -1,73 +1,73 @@
-'use strict';
-
-/**
- * Subcomando `swl-ses ciclo-autonomo [on|off|status]` — motor determinista de
- * aprendizaje (Fase A del ciclo autónomo, ADR-0041).
- *
- * Sin positional: ejecuta la Fase A (writer de instintos → puente de
- * degradación → drenador de feedback). Opt-out estricto (nace encendido):
- * con `habilitado:false` en el config o `SWL_CICLO_AUTONOMO=0` retorna sin
- * efecto ni escritura — el off es sagrado.
- *
- *   on     → habilita el motor (escribe evolution/ciclo-config.json)
- *   off    → lo deshabilita
- *   status → reporta last_run y conteos de la última corrida
- *
- * Uso: swl-ses ciclo-autonomo [on|off|status] [--forzar]
- */
-
-const { correrFaseA } = require('../lib/ciclo-autonomo');
-const { leerConfig, escribirConfig, estaHabilitado } = require('../lib/ciclo-autonomo/config');
-
-function cicloAutonomo(opciones = {}) {
-  const accion = (opciones._args || [])[0];
-  const baseDir = opciones.dir || process.cwd();
-
-  if (accion === 'on' || accion === 'off') {
-    const habilitado = accion === 'on';
-    escribirConfig(baseDir, { habilitado });
-    console.log(`[ciclo-autonomo] motor ${habilitado ? 'HABILITADO' : 'deshabilitado'} (${baseDir})`);
-    if (habilitado) {
-      console.log('[ciclo-autonomo] la Fase A correrá vía cron/briefing; corrida manual: swl-ses ciclo-autonomo');
-    }
-    return leerConfig(baseDir);
-  }
-
-  if (accion === 'status') {
-    const config = leerConfig(baseDir);
-    const estado = {
-      habilitado: estaHabilitado(baseDir),
-      credencial: config.credencial,
-      last_run: config.last_run,
-      ultima_corrida: config.ultima_corrida,
-    };
-    console.log(`[ciclo-autonomo] habilitado: ${estado.habilitado} · credencial: ${estado.credencial}`);
-    console.log(`[ciclo-autonomo] last_run: ${estado.last_run || 'nunca'}`);
-    if (estado.ultima_corrida) {
-      const u = estado.ultima_corrida;
-      console.log(`[ciclo-autonomo] última corrida — promovidos: ${u.promovidos}, degradados: ${u.degradados}, drenados: ${u.drenados}, archivados: ${u.archivados}, bajados: ${u.bajados}`);
-    }
-    return estado;
-  }
-
-  if (accion !== undefined) {
-    console.error(`[ciclo-autonomo] acción desconocida: "${accion}". Uso: swl-ses ciclo-autonomo [on|off|status] [--forzar]`);
-    process.exitCode = 1;
-    return null;
-  }
-
-  const resultado = correrFaseA(baseDir, { forzar: opciones.forzar === true });
-  if (!resultado.ejecutado) {
-    console.log(`[ciclo-autonomo] sin corrida: ${resultado.razon}`);
-  } else if (resultado.acciones === 0) {
-    console.log('[ciclo-autonomo] corrida no-op: sin señales que crucen umbral');
-  } else {
-    console.log(`[ciclo-autonomo] corrida completada — acciones: ${resultado.acciones}`);
-    if (resultado.errores && resultado.errores.length > 0) {
-      console.error(`[ciclo-autonomo] sub-fases con error: ${resultado.errores.join(', ')}`);
-    }
-  }
-  return resultado;
-}
-
-module.exports = cicloAutonomo;
+'use strict';
+
+/**
+ * Subcomando `swl-ses ciclo-autonomo [on|off|status]` — motor determinista de
+ * aprendizaje (Fase A del ciclo autónomo, ADR-0041).
+ *
+ * Sin positional: ejecuta la Fase A (writer de instintos → puente de
+ * degradación → drenador de feedback). Opt-out estricto (nace encendido):
+ * con `habilitado:false` en el config o `SWL_CICLO_AUTONOMO=0` retorna sin
+ * efecto ni escritura — el off es sagrado.
+ *
+ *   on     → habilita el motor (escribe evolution/ciclo-config.json)
+ *   off    → lo deshabilita
+ *   status → reporta last_run y conteos de la última corrida
+ *
+ * Uso: swl-ses ciclo-autonomo [on|off|status] [--forzar]
+ */
+
+const { correrFaseA } = require('../lib/ciclo-autonomo');
+const { leerConfig, escribirConfig, estaHabilitado } = require('../lib/ciclo-autonomo/config');
+
+function cicloAutonomo(opciones = {}) {
+  const accion = (opciones._args || [])[0];
+  const baseDir = opciones.dir || process.cwd();
+
+  if (accion === 'on' || accion === 'off') {
+    const habilitado = accion === 'on';
+    escribirConfig(baseDir, { habilitado });
+    console.log(`[ciclo-autonomo] motor ${habilitado ? 'HABILITADO' : 'deshabilitado'} (${baseDir})`);
+    if (habilitado) {
+      console.log('[ciclo-autonomo] la Fase A correrá vía cron/briefing; corrida manual: swl-ses ciclo-autonomo');
+    }
+    return leerConfig(baseDir);
+  }
+
+  if (accion === 'status') {
+    const config = leerConfig(baseDir);
+    const estado = {
+      habilitado: estaHabilitado(baseDir),
+      credencial: config.credencial,
+      last_run: config.last_run,
+      ultima_corrida: config.ultima_corrida,
+    };
+    console.log(`[ciclo-autonomo] habilitado: ${estado.habilitado} · credencial: ${estado.credencial}`);
+    console.log(`[ciclo-autonomo] last_run: ${estado.last_run || 'nunca'}`);
+    if (estado.ultima_corrida) {
+      const u = estado.ultima_corrida;
+      console.log(`[ciclo-autonomo] última corrida — promovidos: ${u.promovidos}, degradados: ${u.degradados}, drenados: ${u.drenados}, archivados: ${u.archivados}, bajados: ${u.bajados}`);
+    }
+    return estado;
+  }
+
+  if (accion !== undefined) {
+    console.error(`[ciclo-autonomo] acción desconocida: "${accion}". Uso: swl-ses ciclo-autonomo [on|off|status] [--forzar]`);
+    process.exitCode = 1;
+    return null;
+  }
+
+  const resultado = correrFaseA(baseDir, { forzar: opciones.forzar === true });
+  if (!resultado.ejecutado) {
+    console.log(`[ciclo-autonomo] sin corrida: ${resultado.razon}`);
+  } else if (resultado.acciones === 0) {
+    console.log('[ciclo-autonomo] corrida no-op: sin señales que crucen umbral');
+  } else {
+    console.log(`[ciclo-autonomo] corrida completada — acciones: ${resultado.acciones}`);
+    if (resultado.errores && resultado.errores.length > 0) {
+      console.error(`[ciclo-autonomo] sub-fases con error: ${resultado.errores.join(', ')}`);
+    }
+  }
+  return resultado;
+}
+
+module.exports = cicloAutonomo;

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;

package/scripts/cli/ciclo-fase-b.js

@@ -1,102 +1,102 @@
-'use strict';
-
-/**
- * Subcomando `swl-ses ciclo-fase-b [status] [--dry-run]` — CLI headless de la
- * Fase B del ciclo autónomo (Fase 22, T-07, ADR-0042 gate G-B, REQ-22-07).
- *
- * Espeja el patrón de `scripts/cli/ciclo-autonomo.js` (contrato del bin: cada
- * subcomando exporta UNA función(opciones) sin efectos al require).
- *
- *   (nada) | --dry-run → corre `runner-fase-b.correrFaseB` con `dryRun:true`
- *     SIEMPRE, se pase o no el flag. En Fase 22 el runner NUNCA invoca LLM ni
- *     gasta bajo ninguna combinación de argumentos — el modo real
- *     (`dryRun:false` + `invocador` cableado) llega en Fase 24; hasta
- *     entonces `--dry-run` es un no-op explícito frente al default.
- *   status → reporta `fase_b_habilitada`, `last_run_fase_b`, candidatos
- *     pendientes (conteo tolerante de `evolution/candidatos-fase-b.jsonl` —
- *     NUNCA `candidatos.detectar`, que tiene efecto de escritura; `status`
- *     jamás muta disco) y el estado de presupuesto (`gasto_mes`,
- *     `presupuesto_usd_mes`, `pausado_por_presupuesto`) vía
- *     `presupuesto.estado`.
- *
- * Uso: swl-ses ciclo-fase-b [status] [--dry-run]
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const { correrFaseB } = require('../lib/ciclo-autonomo/runner-fase-b');
-const config = require('../lib/ciclo-autonomo/config');
-const presupuesto = require('../lib/ciclo-autonomo/presupuesto');
-
-const RUTA_CANDIDATOS_RELATIVA = path.join('.planning', 'evolution', 'candidatos-fase-b.jsonl');
-
-/**
- * Conteo tolerante de líneas JSON válidas en `candidatos-fase-b.jsonl`.
- * `status` es de solo lectura: nunca invoca `candidatos.detectar` (que
- * persiste candidatos nuevos) — solo cuenta lo que YA quedó registrado por
- * una corrida previa de la Fase A o del runner.
- *
- * @param {string} baseDir - Directorio raíz del proyecto.
- * @returns {number}
- */
-function contarCandidatosPendientes(baseDir) {
-  let crudo;
-  try {
-    crudo = fs.readFileSync(path.join(baseDir, RUTA_CANDIDATOS_RELATIVA), 'utf8');
-  } catch (_) {
-    return 0;
-  }
-  return crudo.split(/\r\n|\n/)
-    .filter((linea) => linea.trim() !== '')
-    .filter((linea) => {
-      try {
-        JSON.parse(linea);
-        return true;
-      } catch (_) {
-        return false;
-      }
-    }).length;
-}
-
-function cicloFaseB(opciones = {}) {
-  const accion = (opciones._args || [])[0];
-  const baseDir = opciones.dir || process.cwd();
-
-  if (accion === 'status') {
-    const cfg = config.leerConfig(baseDir);
-    const presu = presupuesto.estado(baseDir);
-    const estado = {
-      fase_b_habilitada: config.estaFaseBHabilitada(baseDir),
-      last_run_fase_b: cfg.last_run_fase_b,
-      candidatos_pendientes: contarCandidatosPendientes(baseDir),
-      gasto_mes: presu.gasto_mes,
-      presupuesto_usd_mes: presu.tope,
-      pausado_por_presupuesto: presu.pausado_por_presupuesto,
-    };
-    console.log(`[ciclo-fase-b] fase_b_habilitada: ${estado.fase_b_habilitada}`);
-    console.log(`[ciclo-fase-b] last_run_fase_b: ${estado.last_run_fase_b || 'nunca'}`);
-    console.log(`[ciclo-fase-b] candidatos_pendientes: ${estado.candidatos_pendientes}`);
-    console.log(`[ciclo-fase-b] gasto_mes: $${estado.gasto_mes} / $${estado.presupuesto_usd_mes} · pausado_por_presupuesto: ${estado.pausado_por_presupuesto}`);
-    return estado;
-  }
-
-  if (accion !== undefined && accion !== '--dry-run') {
-    console.error(`[ciclo-fase-b] acción desconocida: "${accion}". Uso: swl-ses ciclo-fase-b [status] [--dry-run]`);
-    process.exitCode = 1;
-    return null;
-  }
-
-  // Fase 22: dryRun forzado a true sin importar el flag — el runner valida
-  // toda la tubería (lock, catch-up, guard, credencial, presupuesto) y
-  // registra la corrida SIN invocar LLM. El modo real llega en Fase 24.
-  const resultado = correrFaseB(baseDir, { dryRun: true });
-  if (!resultado.ejecutado) {
-    console.log(`[ciclo-fase-b] sin corrida: ${resultado.razon}`);
-  } else {
-    console.log(`[ciclo-fase-b] corrida dry-run completada — candidatos: ${resultado.candidatos}`);
-  }
-  return resultado;
-}
-
-module.exports = cicloFaseB;
+'use strict';
+
+/**
+ * Subcomando `swl-ses ciclo-fase-b [status] [--dry-run]` — CLI headless de la
+ * Fase B del ciclo autónomo (Fase 22, T-07, ADR-0042 gate G-B, REQ-22-07).
+ *
+ * Espeja el patrón de `scripts/cli/ciclo-autonomo.js` (contrato del bin: cada
+ * subcomando exporta UNA función(opciones) sin efectos al require).
+ *
+ *   (nada) | --dry-run → corre `runner-fase-b.correrFaseB` con `dryRun:true`
+ *     SIEMPRE, se pase o no el flag. En Fase 22 el runner NUNCA invoca LLM ni
+ *     gasta bajo ninguna combinación de argumentos — el modo real
+ *     (`dryRun:false` + `invocador` cableado) llega en Fase 24; hasta
+ *     entonces `--dry-run` es un no-op explícito frente al default.
+ *   status → reporta `fase_b_habilitada`, `last_run_fase_b`, candidatos
+ *     pendientes (conteo tolerante de `evolution/candidatos-fase-b.jsonl` —
+ *     NUNCA `candidatos.detectar`, que tiene efecto de escritura; `status`
+ *     jamás muta disco) y el estado de presupuesto (`gasto_mes`,
+ *     `presupuesto_usd_mes`, `pausado_por_presupuesto`) vía
+ *     `presupuesto.estado`.
+ *
+ * Uso: swl-ses ciclo-fase-b [status] [--dry-run]
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const { correrFaseB } = require('../lib/ciclo-autonomo/runner-fase-b');
+const config = require('../lib/ciclo-autonomo/config');
+const presupuesto = require('../lib/ciclo-autonomo/presupuesto');
+
+const RUTA_CANDIDATOS_RELATIVA = path.join('.planning', 'evolution', 'candidatos-fase-b.jsonl');
+
+/**
+ * Conteo tolerante de líneas JSON válidas en `candidatos-fase-b.jsonl`.
+ * `status` es de solo lectura: nunca invoca `candidatos.detectar` (que
+ * persiste candidatos nuevos) — solo cuenta lo que YA quedó registrado por
+ * una corrida previa de la Fase A o del runner.
+ *
+ * @param {string} baseDir - Directorio raíz del proyecto.
+ * @returns {number}
+ */
+function contarCandidatosPendientes(baseDir) {
+  let crudo;
+  try {
+    crudo = fs.readFileSync(path.join(baseDir, RUTA_CANDIDATOS_RELATIVA), 'utf8');
+  } catch (_) {
+    return 0;
+  }
+  return crudo.split(/\r\n|\n/)
+    .filter((linea) => linea.trim() !== '')
+    .filter((linea) => {
+      try {
+        JSON.parse(linea);
+        return true;
+      } catch (_) {
+        return false;
+      }
+    }).length;
+}
+
+function cicloFaseB(opciones = {}) {
+  const accion = (opciones._args || [])[0];
+  const baseDir = opciones.dir || process.cwd();
+
+  if (accion === 'status') {
+    const cfg = config.leerConfig(baseDir);
+    const presu = presupuesto.estado(baseDir);
+    const estado = {
+      fase_b_habilitada: config.estaFaseBHabilitada(baseDir),
+      last_run_fase_b: cfg.last_run_fase_b,
+      candidatos_pendientes: contarCandidatosPendientes(baseDir),
+      gasto_mes: presu.gasto_mes,
+      presupuesto_usd_mes: presu.tope,
+      pausado_por_presupuesto: presu.pausado_por_presupuesto,
+    };
+    console.log(`[ciclo-fase-b] fase_b_habilitada: ${estado.fase_b_habilitada}`);
+    console.log(`[ciclo-fase-b] last_run_fase_b: ${estado.last_run_fase_b || 'nunca'}`);
+    console.log(`[ciclo-fase-b] candidatos_pendientes: ${estado.candidatos_pendientes}`);
+    console.log(`[ciclo-fase-b] gasto_mes: $${estado.gasto_mes} / $${estado.presupuesto_usd_mes} · pausado_por_presupuesto: ${estado.pausado_por_presupuesto}`);
+    return estado;
+  }
+
+  if (accion !== undefined && accion !== '--dry-run') {
+    console.error(`[ciclo-fase-b] acción desconocida: "${accion}". Uso: swl-ses ciclo-fase-b [status] [--dry-run]`);
+    process.exitCode = 1;
+    return null;
+  }
+
+  // Fase 22: dryRun forzado a true sin importar el flag — el runner valida
+  // toda la tubería (lock, catch-up, guard, credencial, presupuesto) y
+  // registra la corrida SIN invocar LLM. El modo real llega en Fase 24.
+  const resultado = correrFaseB(baseDir, { dryRun: true });
+  if (!resultado.ejecutado) {
+    console.log(`[ciclo-fase-b] sin corrida: ${resultado.razon}`);
+  } else {
+    console.log(`[ciclo-fase-b] corrida dry-run completada — candidatos: ${resultado.candidatos}`);
+  }
+  return resultado;
+}
+
+module.exports = cicloFaseB;

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

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

package/scripts/cli/detectar-host.js

@@ -1,27 +1,27 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses detectar-host` — determina si el CWD es el repo host de
- * SWL o un proyecto consumidor. Reemplaza `node scripts/lib/detectar-host-swl.js`
- * relativo al proyecto (roto downstream; ver docs/invocacion-cli-cross-scope.md).
- *
- * Uso: swl-ses detectar-host [--json]
- */
-
-const { detectarHostSwl } = require('../lib/detectar-host-swl');
-
-function detectarHost(opciones = {}) {
-  const r = detectarHostSwl(process.cwd());
-  if (opciones && opciones.json) {
-    console.log(JSON.stringify(r, null, 2));
-    return;
-  }
-  if (r.esHost) {
-    console.log(`[host] ${r.razon}`);
-  } else {
-    console.log(`[consumidor] ${r.razon}`);
-    for (const s of r.sugerencias) console.log(`  - ${s}`);
-  }
-}
-
-module.exports = detectarHost;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses detectar-host` — determina si el CWD es el repo host de
+ * SWL o un proyecto consumidor. Reemplaza `node scripts/lib/detectar-host-swl.js`
+ * relativo al proyecto (roto downstream; ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses detectar-host [--json]
+ */
+
+const { detectarHostSwl } = require('../lib/detectar-host-swl');
+
+function detectarHost(opciones = {}) {
+  const r = detectarHostSwl(process.cwd());
+  if (opciones && opciones.json) {
+    console.log(JSON.stringify(r, null, 2));
+    return;
+  }
+  if (r.esHost) {
+    console.log(`[host] ${r.razon}`);
+  } else {
+    console.log(`[consumidor] ${r.razon}`);
+    for (const s of r.sugerencias) console.log(`  - ${s}`);
+  }
+}
+
+module.exports = detectarHost;

package/scripts/cli/diary-entry.js

@@ -1,69 +1,69 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses diary-entry` — construye y persiste una entrada de diario
- * de sesión en .planning/sessions/diary/<id>.json. Reemplaza el inline
- * `require('./scripts/lib/diary-entry')` relativo al proyecto (roto downstream;
- * ver docs/invocacion-cli-cross-scope.md).
- *
- * Entrada: objeto JSON por stdin (o --json='{...}') con la forma:
- *   {
- *     "sessionId": "...", "agent": "orquestador-swl",
- *     "accomplishments": ["..."], "decisions": ["..."],
- *     "learnings": ["..."], "challenges": ["..."],
- *     "sourceAgents": ["implementador-swl"], "tags": ["..."]
- *   }
- *
- * Imprime la ruta del archivo escrito. Uso:
- *   echo '{"sessionId":"s1","agent":"orquestador-swl"}' | swl-ses diary-entry
- */
-
-const fs = require('node:fs');
-const path = require('node:path');
-const diary = require('../lib/diary-entry');
-const { atomicWriteSync } = require('../../hooks/lib/atomic-write');
-
-function diaryEntry(opciones = {}) {
-  let raw = opciones.json;
-  if (!raw && !process.stdin.isTTY) {
-    try {
-      raw = fs.readFileSync(0, 'utf8');
-    } catch (e) {
-      // No degradar en silencio: avisar que stdin fue ilegible antes del fallback.
-      console.error('[diary-entry] aviso: stdin ilegible (' + e.code + ')');
-      raw = '';
-    }
-  }
-  let input;
-  try {
-    input = JSON.parse(raw || '{}');
-  } catch (e) {
-    console.error('Error: JSON inválido: ' + e.message);
-    process.exitCode = 1;
-    return;
-  }
-
-  let entry = diary.createDiary({ sessionId: input.sessionId, agent: input.agent });
-  for (const a of input.accomplishments || []) entry = diary.addAccomplishment(entry, a);
-  for (const d of input.decisions || []) entry = diary.addDecision(entry, d);
-  for (const c of input.challenges || []) entry = diary.addChallenge(entry, c);
-  for (const l of input.learnings || []) entry = diary.addLearning(entry, l);
-  for (const tg of input.tags || []) entry = diary.addTag(entry, tg);
-  for (const sa of input.sourceAgents || []) entry = diary.addSourceAgent(entry, sa);
-  entry = diary.closeDiary(entry);
-
-  const val = diary.validateDiary(entry);
-  if (!val.valid) {
-    console.error('Error de validación: ' + val.errors.join('; '));
-    process.exitCode = 1;
-    return;
-  }
-
-  const dir = path.join(process.cwd(), '.planning', 'sessions', 'diary');
-  fs.mkdirSync(dir, { recursive: true });
-  const dest = path.join(dir, entry.id + '.json');
-  atomicWriteSync(dest, diary.serializeDiary(entry));
-  console.log(dest);
-}
-
-module.exports = diaryEntry;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses diary-entry` — construye y persiste una entrada de diario
+ * de sesión en .planning/sessions/diary/<id>.json. Reemplaza el inline
+ * `require('./scripts/lib/diary-entry')` relativo al proyecto (roto downstream;
+ * ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Entrada: objeto JSON por stdin (o --json='{...}') con la forma:
+ *   {
+ *     "sessionId": "...", "agent": "orquestador-swl",
+ *     "accomplishments": ["..."], "decisions": ["..."],
+ *     "learnings": ["..."], "challenges": ["..."],
+ *     "sourceAgents": ["implementador-swl"], "tags": ["..."]
+ *   }
+ *
+ * Imprime la ruta del archivo escrito. Uso:
+ *   echo '{"sessionId":"s1","agent":"orquestador-swl"}' | swl-ses diary-entry
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+const diary = require('../lib/diary-entry');
+const { atomicWriteSync } = require('../../hooks/lib/atomic-write');
+
+function diaryEntry(opciones = {}) {
+  let raw = opciones.json;
+  if (!raw && !process.stdin.isTTY) {
+    try {
+      raw = fs.readFileSync(0, 'utf8');
+    } catch (e) {
+      // No degradar en silencio: avisar que stdin fue ilegible antes del fallback.
+      console.error('[diary-entry] aviso: stdin ilegible (' + e.code + ')');
+      raw = '';
+    }
+  }
+  let input;
+  try {
+    input = JSON.parse(raw || '{}');
+  } catch (e) {
+    console.error('Error: JSON inválido: ' + e.message);
+    process.exitCode = 1;
+    return;
+  }
+
+  let entry = diary.createDiary({ sessionId: input.sessionId, agent: input.agent });
+  for (const a of input.accomplishments || []) entry = diary.addAccomplishment(entry, a);
+  for (const d of input.decisions || []) entry = diary.addDecision(entry, d);
+  for (const c of input.challenges || []) entry = diary.addChallenge(entry, c);
+  for (const l of input.learnings || []) entry = diary.addLearning(entry, l);
+  for (const tg of input.tags || []) entry = diary.addTag(entry, tg);
+  for (const sa of input.sourceAgents || []) entry = diary.addSourceAgent(entry, sa);
+  entry = diary.closeDiary(entry);
+
+  const val = diary.validateDiary(entry);
+  if (!val.valid) {
+    console.error('Error de validación: ' + val.errors.join('; '));
+    process.exitCode = 1;
+    return;
+  }
+
+  const dir = path.join(process.cwd(), '.planning', 'sessions', 'diary');
+  fs.mkdirSync(dir, { recursive: true });
+  const dest = path.join(dir, entry.id + '.json');
+  atomicWriteSync(dest, diary.serializeDiary(entry));
+  console.log(dest);
+}
+
+module.exports = diaryEntry;