@saulwade/swl-ses 2.2.4 → 2.3.1

package/scripts/cli/configurar-ci.js

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

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

@@ -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;

package/scripts/cli/execution-state.js

@@ -1,18 +1,18 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses execution-state` — imprime el resumen estructurado del
- * estado de ejecución (.planning/execution-state.json). Reemplaza el inline
- * `require('./hooks/lib/execution-state')` relativo al proyecto (roto downstream;
- * ver docs/invocacion-cli-cross-scope.md).
- *
- * Uso: swl-ses execution-state
- */
-
-const es = require('../../hooks/lib/execution-state');
-
-function executionState() {
-  console.log(es.formatearResumen(process.cwd()));
-}
-
-module.exports = executionState;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses execution-state` — imprime el resumen estructurado del
+ * estado de ejecución (.planning/execution-state.json). Reemplaza el inline
+ * `require('./hooks/lib/execution-state')` relativo al proyecto (roto downstream;
+ * ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses execution-state
+ */
+
+const es = require('../../hooks/lib/execution-state');
+
+function executionState() {
+  console.log(es.formatearResumen(process.cwd()));
+}
+
+module.exports = executionState;

package/scripts/cli/gateway-notify.js

@@ -1,41 +1,41 @@
-'use strict';
-
-/**
- * Wrapper CLI `swl-ses gateway-notify` — encola una notificación de vuelta al
- * canal origen del gateway (Telegram, Discord). Reemplaza el inline
- * `require('./hooks/lib/gateway-notify')` relativo al proyecto (roto downstream;
- * ver docs/invocacion-cli-cross-scope.md).
- *
- * Uso: swl-ses gateway-notify --texto="✅ ..." [--tipo=custom] [--to=telegram]
- *                             [--reply-to=<chatId>]
- */
-
-const { notificarGateway } = require('../../hooks/lib/gateway-notify');
-
-function gatewayNotify(opciones = {}) {
-  if (!opciones.texto) {
-    console.error('Error: falta --texto="mensaje"');
-    process.exitCode = 1;
-    return;
-  }
-  // --reply-to debe ser un chatId numérico: evita redirigir la notificación a
-  // un chat arbitrario cuando el flag se sintetiza desde input no confiable.
-  if (opciones['reply-to'] !== undefined && !/^-?\d+$/.test(String(opciones['reply-to']))) {
-    console.error('Error: --reply-to debe ser un chatId numérico');
-    process.exitCode = 1;
-    return;
-  }
-  const params = { tipo: opciones.tipo || 'custom', texto: opciones.texto };
-  if (opciones.to) params.to = opciones.to;
-  if (opciones['reply-to'] !== undefined) params.payload = { replyTo: opciones['reply-to'] };
-
-  const r = notificarGateway(params);
-  if (r === false) {
-    console.log(JSON.stringify({ ok: false, motivo: 'gateway deshabilitado o tipo no habilitado' }, null, 2));
-    process.exitCode = 1;
-    return;
-  }
-  console.log(JSON.stringify(r ?? { ok: true }, null, 2));
-}
-
-module.exports = gatewayNotify;
+'use strict';
+
+/**
+ * Wrapper CLI `swl-ses gateway-notify` — encola una notificación de vuelta al
+ * canal origen del gateway (Telegram, Discord). Reemplaza el inline
+ * `require('./hooks/lib/gateway-notify')` relativo al proyecto (roto downstream;
+ * ver docs/invocacion-cli-cross-scope.md).
+ *
+ * Uso: swl-ses gateway-notify --texto="✅ ..." [--tipo=custom] [--to=telegram]
+ *                             [--reply-to=<chatId>]
+ */
+
+const { notificarGateway } = require('../../hooks/lib/gateway-notify');
+
+function gatewayNotify(opciones = {}) {
+  if (!opciones.texto) {
+    console.error('Error: falta --texto="mensaje"');
+    process.exitCode = 1;
+    return;
+  }
+  // --reply-to debe ser un chatId numérico: evita redirigir la notificación a
+  // un chat arbitrario cuando el flag se sintetiza desde input no confiable.
+  if (opciones['reply-to'] !== undefined && !/^-?\d+$/.test(String(opciones['reply-to']))) {
+    console.error('Error: --reply-to debe ser un chatId numérico');
+    process.exitCode = 1;
+    return;
+  }
+  const params = { tipo: opciones.tipo || 'custom', texto: opciones.texto };
+  if (opciones.to) params.to = opciones.to;
+  if (opciones['reply-to'] !== undefined) params.payload = { replyTo: opciones['reply-to'] };
+
+  const r = notificarGateway(params);
+  if (r === false) {
+    console.log(JSON.stringify({ ok: false, motivo: 'gateway deshabilitado o tipo no habilitado' }, null, 2));
+    process.exitCode = 1;
+    return;
+  }
+  console.log(JSON.stringify(r ?? { ok: true }, null, 2));
+}
+
+module.exports = gatewayNotify;

package/scripts/cli/liberar-fase.js

@@ -1,42 +1,42 @@
-'use strict';
-
-/**
- * Subcomando `swl-ses liberar-fase` — cierra el gate G0 borrando
- * .planning/locks/fase-activa.json. Lo usa /swl:ejecutar-fase al terminar una
- * fase para que spec-gate.js vuelva a advertir si se reanuda trabajo.
- *
- * Reemplaza el `node -e "...unlinkSync('.planning/locks/fase-activa.json')"`
- * inline (relativo al proyecto). Busca el archivo ascendiendo desde el CWD para
- * funcionar aunque el comando se ejecute desde un subdirectorio.
- *
- * Uso: swl-ses liberar-fase
- */
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-function liberarFase(opciones = {}) {
-  let dir = (opciones && opciones.cwd) || process.cwd();
-  let target = null;
-  while (dir !== path.dirname(dir)) {
-    const cand = path.join(dir, '.planning', 'locks', 'fase-activa.json');
-    if (fs.existsSync(cand)) {
-      target = cand;
-      break;
-    }
-    dir = path.dirname(dir);
-  }
-
-  if (target) {
-    fs.unlinkSync(target);
-    console.log(JSON.stringify({ ok: true, liberado: target }));
-  } else {
-    console.log(
-      JSON.stringify({ ok: true, liberado: null, motivo: 'sin fase activa que liberar' })
-    );
-  }
-}
-
-module.exports = liberarFase;
-
-if (require.main === module) liberarFase();
+'use strict';
+
+/**
+ * Subcomando `swl-ses liberar-fase` — cierra el gate G0 borrando
+ * .planning/locks/fase-activa.json. Lo usa /swl:ejecutar-fase al terminar una
+ * fase para que spec-gate.js vuelva a advertir si se reanuda trabajo.
+ *
+ * Reemplaza el `node -e "...unlinkSync('.planning/locks/fase-activa.json')"`
+ * inline (relativo al proyecto). Busca el archivo ascendiendo desde el CWD para
+ * funcionar aunque el comando se ejecute desde un subdirectorio.
+ *
+ * Uso: swl-ses liberar-fase
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+function liberarFase(opciones = {}) {
+  let dir = (opciones && opciones.cwd) || process.cwd();
+  let target = null;
+  while (dir !== path.dirname(dir)) {
+    const cand = path.join(dir, '.planning', 'locks', 'fase-activa.json');
+    if (fs.existsSync(cand)) {
+      target = cand;
+      break;
+    }
+    dir = path.dirname(dir);
+  }
+
+  if (target) {
+    fs.unlinkSync(target);
+    console.log(JSON.stringify({ ok: true, liberado: target }));
+  } else {
+    console.log(
+      JSON.stringify({ ok: true, liberado: null, motivo: 'sin fase activa que liberar' })
+    );
+  }
+}
+
+module.exports = liberarFase;
+
+if (require.main === module) liberarFase();