@saulwade/swl-ses 2.6.0 → 2.8.0

package/scripts/runtime-doctor.js

@@ -0,0 +1,107 @@
+'use strict';
+
+/**
+ * Subcomando `swl-ses runtime-doctor [--target=<id>] [--json]` — diagnóstico
+ * read-only de disponibilidad Core-3 (Claude Code, Codex CLI, Gemini CLI).
+ *
+ * Delega en scripts/lib/runtime-doctor-core3.js: solo ejecuta probes
+ * `--version` de binarios code-owned, nunca instala, repara, autentica ni
+ * evalúa canarios conductuales. Disponibilidad != certificación — el
+ * resultado permanece `effectiveMode: proposal_only` / `certification:
+ * unverified` para los tres runtimes sin excepción (F31-T07, ADR-0047).
+ *
+ * Uso: swl-ses runtime-doctor [--target=claude-code|codex-cli|gemini-cli] [--json]
+ */
+
+const { CORE_RUNTIME_IDS } = require('./lib/runtime-adapter-contract');
+const { diagnosticarCore3 } = require('./lib/runtime-doctor-core3');
+const { pathEntriesFromEnv, emptyRuntimeMap } = require('./lib/runtime-doctor-input');
+
+function resolverTarget(opciones) {
+  if (opciones.target === undefined) return { ok: true, target: null };
+  if (typeof opciones.target !== 'string' || opciones.target.length === 0) {
+    return { ok: false, mensaje: '--target requiere un valor' };
+  }
+  if (!CORE_RUNTIME_IDS.includes(opciones.target)) {
+    return {
+      ok: false,
+      mensaje: `--target inválido: "${opciones.target}". Valores permitidos: ${CORE_RUNTIME_IDS.join(', ')}`,
+    };
+  }
+  return { ok: true, target: opciones.target };
+}
+
+/**
+ * `diagnosticarCore3()` congela profundamente su resultado y lo registra por
+ * referencia exacta en un WeakSet interno que respaldan `esDiagnosticoCore3`,
+ * `validarDiagnosticoCore3` y `serializarDiagnosticoCore3` (todas exigen
+ * exactamente los 3 runtimes Core-3). Filtrar por --target produce
+ * deliberadamente una vista parcial que esas tres funciones deben rechazar
+ * — no se registra en el WeakSet ni se intenta simular su identidad — pero
+ * la vista SÍ debe quedar tan inmutable como el diagnóstico completo, o un
+ * consumidor futuro podría mutarla sin que ningún assert lo detecte
+ * (Nemesis N-01, F31-T07 pass2).
+ */
+function filtrarPorTarget(diagnostico, target) {
+  if (!target) return diagnostico;
+  return Object.freeze({
+    ...diagnostico,
+    runtimes: Object.freeze(diagnostico.runtimes.filter((r) => r.runtimeId === target)),
+  });
+}
+
+function formatearAvailability(availability) {
+  if (availability.status === 'available') return `available v${availability.version}`;
+  return availability.status;
+}
+
+function formatearTexto(diagnostico) {
+  const lineas = [
+    `swl-ses runtime-doctor — Core-3 (${diagnostico.effectiveMode}, ${diagnostico.certification})`,
+    '',
+  ];
+  for (const runtime of diagnostico.runtimes) {
+    lineas.push(`  ${runtime.runtimeId}: ${formatearAvailability(runtime.availability)}`);
+  }
+  lineas.push(
+    '',
+    'Disponibilidad != certificación. Canarios conductuales: not_evaluated (pendientes de W4).'
+  );
+  return lineas.join('\n');
+}
+
+async function runtimeDoctorCli(opciones = {}) {
+  opciones = opciones || {};
+  const resuelto = resolverTarget(opciones);
+  if (!resuelto.ok) {
+    console.error(resuelto.mensaje);
+    process.exit(1);
+    return;
+  }
+
+  let diagnostico;
+  try {
+    diagnostico = await diagnosticarCore3({
+      now: new Date().toISOString(),
+      pathEntries: pathEntriesFromEnv(),
+      bundles: emptyRuntimeMap(),
+      buildEvents: emptyRuntimeMap(),
+    });
+  } catch (error) {
+    console.error(`runtime-doctor falló: ${error.message}`);
+    process.exit(1);
+    return;
+  }
+
+  const salida = filtrarPorTarget(diagnostico, resuelto.target);
+  console.log(opciones.json ? JSON.stringify(salida, null, 2) : formatearTexto(salida));
+  process.exit(0);
+}
+
+module.exports = runtimeDoctorCli;
+module.exports.filtrarPorTarget = filtrarPorTarget;
+
+if (require.main === module) {
+  const { parsearOpciones } = require('./lib/parsear-opciones');
+  runtimeDoctorCli(parsearOpciones(process.argv.slice(2)));
+}

package/scripts/tui/componentes/selector-multi.js

@@ -1,189 +1,189 @@
-'use strict';
-
-/**
- * Selector múltiple (multi-select / checkbox) para la TUI.
- * Extensión del selectorCheckbox de scripts/lib/selector-interactivo.js con:
- *   - Descripciones por item (panel inferior bajo el cursor)
- *   - Atajos: ↑↓ navegar, espacio toggle, 'a' todos, 'n' ninguno
- *   - Hint configurable
- *   - Items deshabilitados respetados
- *
- * Diseño:
- *   - Cada item: { valor, etiqueta, descripcion?, deshabilitado?, preseleccionado? }
- *   - Resuelve con array de valores seleccionados (en orden de items).
- *   - Esc resuelve con `null` (señal de cancelación).
- *
- * No-TTY: resuelve con los items preseleccionados o con todos si
- *   `opciones.todosSeleccionadosSiNoTty` está en true.
- */
-
-const render = require('../lib/render');
-const teclas = require('../lib/teclas');
-const { colores, semantico, iconos } = require('../lib/colores');
-
-/**
- * @param {object} opciones
- * @param {string} opciones.titulo
- * @param {Array<{valor:string,etiqueta:string,descripcion?:string,deshabilitado?:boolean,preseleccionado?:boolean}>} opciones.items
- * @param {boolean} [opciones.todosSeleccionadosSiNoTty=false]
- * @returns {Promise<string[]|null>}
- */
-function selectorMulti(opciones) {
-  const items = opciones.items || [];
-  const titulo = opciones.titulo || 'Selecciona las opciones:';
-
-  // Construir set inicial respetando preseleccionados y deshabilitados
-  const seleccionados = new Set();
-  for (const it of items) {
-    if (it.preseleccionado && !it.deshabilitado) seleccionados.add(it.valor);
-  }
-
-  let cursor = 0;
-  while (cursor < items.length && items[cursor]?.deshabilitado) cursor++;
-  if (cursor >= items.length) cursor = 0;
-
-  return new Promise((resolve) => {
-    if (!render.ES_TTY || !process.stdin.isTTY) {
-      if (opciones.todosSeleccionadosSiNoTty) {
-        resolve(items.filter(i => !i.deshabilitado).map(i => i.valor));
-      } else {
-        resolve(Array.from(seleccionados));
-      }
-      return;
-    }
-
-    function _renderizar() {
-      render.limpiarPantalla();
-      const { cols, rows } = render.obtenerDimensiones();
-
-      render.escribirEn(2, 3, semantico.titulo(titulo));
-      render.escribirEn(3, 3, colores.dim(
-        `${seleccionados.size}/${items.filter(i => !i.deshabilitado).length} seleccionados`
-      ));
-
-      const filaInicio = 5;
-      const maxVisible = Math.min(items.length, rows - 8);
-      let scrollOffset = 0;
-      if (cursor < scrollOffset) scrollOffset = cursor;
-      if (cursor >= scrollOffset + maxVisible) scrollOffset = cursor - maxVisible + 1;
-
-      for (let i = scrollOffset; i < Math.min(items.length, scrollOffset + maxVisible); i++) {
-        const item = items[i];
-        const esCursor = i === cursor;
-        const marcado = seleccionados.has(item.valor);
-        const filaItem = filaInicio + (i - scrollOffset);
-
-        let prefijo;
-        if (item.deshabilitado) {
-          prefijo = colores.dim('  ');
-        } else if (esCursor) {
-          prefijo = semantico.cursor(iconos.cursor + ' ');
-        } else {
-          prefijo = '  ';
-        }
-
-        const checkbox = item.deshabilitado
-          ? colores.dim(iconos.cajaVacia)
-          : (marcado ? semantico.exito(iconos.cajaLlena) : iconos.cajaVacia);
-
-        let etiqueta = item.etiqueta;
-        if (item.deshabilitado) etiqueta = colores.dim(etiqueta);
-        else if (esCursor) etiqueta = colores.negrita(etiqueta);
-
-        render.escribirEn(filaItem, 3, `${prefijo}${checkbox} ${etiqueta}`);
-
-        // Descripción del item bajo cursor
-        if (esCursor && item.descripcion && !item.deshabilitado) {
-          const filaDesc = filaInicio + maxVisible + 1;
-          const desc = render.recortar(colores.dim(item.descripcion), cols - 6);
-          render.escribirEn(filaDesc, 3, desc);
-        }
-      }
-
-      // Indicador de scroll
-      if (scrollOffset + maxVisible < items.length) {
-        render.escribirEn(filaInicio + maxVisible, 3,
-          colores.dim(`${iconos.flechaAbajo} ${items.length - scrollOffset - maxVisible} más`));
-      }
-
-      render.dibujarPiePagina([
-        ['↑↓', 'navegar'],
-        ['Space', 'toggle'],
-        ['a', 'todos'],
-        ['n', 'ninguno'],
-        ['Enter', 'confirmar'],
-        ['Esc', 'cancelar'],
-      ]);
-    }
-
-    render.iniciarModoTui();
-    _renderizar();
-
-    const onResize = () => _renderizar();
-    process.stdout.on('resize', onResize);
-
-    const teclado = teclas.crearTeclado();
-
-    function _moverArriba() {
-      let nuevo = cursor;
-      do {
-        nuevo = nuevo > 0 ? nuevo - 1 : items.length - 1;
-      } while (nuevo !== cursor && items[nuevo]?.deshabilitado);
-      cursor = nuevo;
-      _renderizar();
-    }
-
-    function _moverAbajo() {
-      let nuevo = cursor;
-      do {
-        nuevo = nuevo < items.length - 1 ? nuevo + 1 : 0;
-      } while (nuevo !== cursor && items[nuevo]?.deshabilitado);
-      cursor = nuevo;
-      _renderizar();
-    }
-
-    function _toggle() {
-      const item = items[cursor];
-      if (!item || item.deshabilitado) return;
-      if (seleccionados.has(item.valor)) seleccionados.delete(item.valor);
-      else seleccionados.add(item.valor);
-      _renderizar();
-    }
-
-    function _todos() {
-      for (const it of items) {
-        if (!it.deshabilitado) seleccionados.add(it.valor);
-      }
-      _renderizar();
-    }
-
-    function _ninguno() {
-      seleccionados.clear();
-      _renderizar();
-    }
-
-    function _finalizar(valor) {
-      teclado.desactivar();
-      process.stdout.removeListener('resize', onResize);
-      render.salirModoTui();
-      resolve(valor);
-    }
-
-    teclado.on('up', _moverArriba);
-    teclado.on('down', _moverAbajo);
-    teclado.on('space', _toggle);
-    teclado.on('a', _todos);
-    teclado.on('n', _ninguno);
-    teclado.on('return', () => {
-      // Preservar el orden de los items, no el de inserción al set
-      const resultado = items
-        .filter(it => seleccionados.has(it.valor))
-        .map(it => it.valor);
-      _finalizar(resultado);
-    });
-    teclado.on('escape', () => _finalizar(null));
-    teclado.activar();
-  });
-}
-
-module.exports = { selectorMulti };
+'use strict';
+
+/**
+ * Selector múltiple (multi-select / checkbox) para la TUI.
+ * Extensión del selectorCheckbox de scripts/lib/selector-interactivo.js con:
+ *   - Descripciones por item (panel inferior bajo el cursor)
+ *   - Atajos: ↑↓ navegar, espacio toggle, 'a' todos, 'n' ninguno
+ *   - Hint configurable
+ *   - Items deshabilitados respetados
+ *
+ * Diseño:
+ *   - Cada item: { valor, etiqueta, descripcion?, deshabilitado?, preseleccionado? }
+ *   - Resuelve con array de valores seleccionados (en orden de items).
+ *   - Esc resuelve con `null` (señal de cancelación).
+ *
+ * No-TTY: resuelve con los items preseleccionados o con todos si
+ *   `opciones.todosSeleccionadosSiNoTty` está en true.
+ */
+
+const render = require('../lib/render');
+const teclas = require('../lib/teclas');
+const { colores, semantico, iconos } = require('../lib/colores');
+
+/**
+ * @param {object} opciones
+ * @param {string} opciones.titulo
+ * @param {Array<{valor:string,etiqueta:string,descripcion?:string,deshabilitado?:boolean,preseleccionado?:boolean}>} opciones.items
+ * @param {boolean} [opciones.todosSeleccionadosSiNoTty=false]
+ * @returns {Promise<string[]|null>}
+ */
+function selectorMulti(opciones) {
+  const items = opciones.items || [];
+  const titulo = opciones.titulo || 'Selecciona las opciones:';
+
+  // Construir set inicial respetando preseleccionados y deshabilitados
+  const seleccionados = new Set();
+  for (const it of items) {
+    if (it.preseleccionado && !it.deshabilitado) seleccionados.add(it.valor);
+  }
+
+  let cursor = 0;
+  while (cursor < items.length && items[cursor]?.deshabilitado) cursor++;
+  if (cursor >= items.length) cursor = 0;
+
+  return new Promise((resolve) => {
+    if (!render.ES_TTY || !process.stdin.isTTY) {
+      if (opciones.todosSeleccionadosSiNoTty) {
+        resolve(items.filter(i => !i.deshabilitado).map(i => i.valor));
+      } else {
+        resolve(Array.from(seleccionados));
+      }
+      return;
+    }
+
+    function _renderizar() {
+      render.limpiarPantalla();
+      const { cols, rows } = render.obtenerDimensiones();
+
+      render.escribirEn(2, 3, semantico.titulo(titulo));
+      render.escribirEn(3, 3, colores.dim(
+        `${seleccionados.size}/${items.filter(i => !i.deshabilitado).length} seleccionados`
+      ));
+
+      const filaInicio = 5;
+      const maxVisible = Math.min(items.length, rows - 8);
+      let scrollOffset = 0;
+      if (cursor < scrollOffset) scrollOffset = cursor;
+      if (cursor >= scrollOffset + maxVisible) scrollOffset = cursor - maxVisible + 1;
+
+      for (let i = scrollOffset; i < Math.min(items.length, scrollOffset + maxVisible); i++) {
+        const item = items[i];
+        const esCursor = i === cursor;
+        const marcado = seleccionados.has(item.valor);
+        const filaItem = filaInicio + (i - scrollOffset);
+
+        let prefijo;
+        if (item.deshabilitado) {
+          prefijo = colores.dim('  ');
+        } else if (esCursor) {
+          prefijo = semantico.cursor(iconos.cursor + ' ');
+        } else {
+          prefijo = '  ';
+        }
+
+        const checkbox = item.deshabilitado
+          ? colores.dim(iconos.cajaVacia)
+          : (marcado ? semantico.exito(iconos.cajaLlena) : iconos.cajaVacia);
+
+        let etiqueta = item.etiqueta;
+        if (item.deshabilitado) etiqueta = colores.dim(etiqueta);
+        else if (esCursor) etiqueta = colores.negrita(etiqueta);
+
+        render.escribirEn(filaItem, 3, `${prefijo}${checkbox} ${etiqueta}`);
+
+        // Descripción del item bajo cursor
+        if (esCursor && item.descripcion && !item.deshabilitado) {
+          const filaDesc = filaInicio + maxVisible + 1;
+          const desc = render.recortar(colores.dim(item.descripcion), cols - 6);
+          render.escribirEn(filaDesc, 3, desc);
+        }
+      }
+
+      // Indicador de scroll
+      if (scrollOffset + maxVisible < items.length) {
+        render.escribirEn(filaInicio + maxVisible, 3,
+          colores.dim(`${iconos.flechaAbajo} ${items.length - scrollOffset - maxVisible} más`));
+      }
+
+      render.dibujarPiePagina([
+        ['↑↓', 'navegar'],
+        ['Space', 'toggle'],
+        ['a', 'todos'],
+        ['n', 'ninguno'],
+        ['Enter', 'confirmar'],
+        ['Esc', 'cancelar'],
+      ]);
+    }
+
+    render.iniciarModoTui();
+    _renderizar();
+
+    const onResize = () => _renderizar();
+    process.stdout.on('resize', onResize);
+
+    const teclado = teclas.crearTeclado();
+
+    function _moverArriba() {
+      let nuevo = cursor;
+      do {
+        nuevo = nuevo > 0 ? nuevo - 1 : items.length - 1;
+      } while (nuevo !== cursor && items[nuevo]?.deshabilitado);
+      cursor = nuevo;
+      _renderizar();
+    }
+
+    function _moverAbajo() {
+      let nuevo = cursor;
+      do {
+        nuevo = nuevo < items.length - 1 ? nuevo + 1 : 0;
+      } while (nuevo !== cursor && items[nuevo]?.deshabilitado);
+      cursor = nuevo;
+      _renderizar();
+    }
+
+    function _toggle() {
+      const item = items[cursor];
+      if (!item || item.deshabilitado) return;
+      if (seleccionados.has(item.valor)) seleccionados.delete(item.valor);
+      else seleccionados.add(item.valor);
+      _renderizar();
+    }
+
+    function _todos() {
+      for (const it of items) {
+        if (!it.deshabilitado) seleccionados.add(it.valor);
+      }
+      _renderizar();
+    }
+
+    function _ninguno() {
+      seleccionados.clear();
+      _renderizar();
+    }
+
+    function _finalizar(valor) {
+      teclado.desactivar();
+      process.stdout.removeListener('resize', onResize);
+      render.salirModoTui();
+      resolve(valor);
+    }
+
+    teclado.on('up', _moverArriba);
+    teclado.on('down', _moverAbajo);
+    teclado.on('space', _toggle);
+    teclado.on('a', _todos);
+    teclado.on('n', _ninguno);
+    teclado.on('return', () => {
+      // Preservar el orden de los items, no el de inserción al set
+      const resultado = items
+        .filter(it => seleccionados.has(it.valor))
+        .map(it => it.valor);
+      _finalizar(resultado);
+    });
+    teclado.on('escape', () => _finalizar(null));
+    teclado.activar();
+  });
+}
+
+module.exports = { selectorMulti };