@saulwade/swl-ses 1.3.3 → 1.3.5

package/scripts/lib/parsear-opciones.js

@@ -0,0 +1,136 @@
+'use strict';
+
+/**
+ * Parser de flags del CLI swl-ses.
+ *
+ * Soporta:
+ *   - Flags booleanos: --force, --global, --dry-run
+ *   - Flags con valor: --profile core, --target=claude
+ *   - Argumentos posicionales: install, doctor, mi-skill
+ *   - Alias bidireccional español ↔ inglés (--perfil ↔ --profile, etc.)
+ *
+ * Extraído de bin/swl-ses.js en v1.3.5 para permitir tests unitarios.
+ *
+ * @module scripts/lib/parsear-opciones
+ */
+
+/**
+ * Alias bidireccional español ↔ inglés para flags. El CLI documenta flags en
+ * inglés (--profile, --target, --force, --dry-run) por compatibilidad histórica
+ * y consistencia con otros CLIs, pero el resto del sistema SWL es 100% español
+ * (mensajes, comandos /swl:*, agentes, skills). Sin estos alias el usuario que
+ * intenta --perfil obtiene un fallo silencioso: el parser registra opciones.perfil
+ * pero el instalador solo lee opciones.profile, terminando en el default 'core'
+ * sin advertir nada (bug A v1.3.5).
+ *
+ * Estructura: cada entrada mapea exactamente DOS claves equivalentes. El campo
+ * `tipo` documenta si la flag espera valor (string) o es booleana (boolean).
+ */
+const ALIAS_FLAGS = [
+  { canonico: 'profile', alias: 'perfil',   tipo: 'string'  },
+  { canonico: 'target',  alias: 'objetivo', tipo: 'string'  },
+  { canonico: 'force',   alias: 'forzar',   tipo: 'boolean' },
+  { canonico: 'dry-run', alias: 'simular',  tipo: 'boolean' },
+];
+
+/**
+ * Whitelist de flags booleanos. Cuando aparecen sin valor son siempre `true`.
+ * Incluye tanto el nombre canónico como su alias en español si existe.
+ */
+const BOOLEANAS = [
+  'global', 'local',
+  'dry-run', 'simular',
+  'force', 'forzar',
+  'verbose', 'all', 'all-langs', 'no-claudemd',
+];
+
+/**
+ * Dado un nombre de flag (con o sin guiones), retorna el conjunto de todos los
+ * alias equivalentes incluyendo el original. Si la flag no tiene alias
+ * declarados, retorna solo [clave].
+ *
+ * @param {string} clave - Nombre de flag sin el prefijo `--`.
+ * @returns {string[]} Todos los nombres equivalentes (canónico + alias).
+ */
+function aliasDeFlag(clave) {
+  for (const par of ALIAS_FLAGS) {
+    if (clave === par.canonico || clave === par.alias) {
+      return [par.canonico, par.alias];
+    }
+  }
+  return [clave];
+}
+
+/**
+ * Parser de argumentos del CLI. Retorna un objeto con todas las opciones
+ * encontradas más `_args` para los posicionales.
+ *
+ * Reglas de mapeo:
+ *   - Cada flag se setea con su nombre original Y con la versión con
+ *     underscores (`dry-run` → también `dry_run`) para consumo desde JS.
+ *   - Si la flag tiene alias declarado, AMBAS variantes (canónica y alias)
+ *     se setean al mismo valor. Resuelve casos donde el consumidor solo
+ *     lee `opciones.profile` aunque el usuario haya pasado `--perfil`.
+ *
+ * @param {string[]} args - Argumentos crudos (típicamente process.argv.slice(2)).
+ * @returns {object} Opciones parseadas. Siempre incluye `_args` (array de posicionales).
+ */
+function parsearOpciones(args) {
+  const opciones = { _args: [] };
+  let i = 0;
+
+  const setear = (clave, valor) => {
+    const alias = aliasDeFlag(clave);
+    for (const k of alias) {
+      opciones[k] = valor;
+      const conUnderscores = k.replace(/-/g, '_');
+      if (conUnderscores !== k) {
+        opciones[conUnderscores] = valor;
+      }
+    }
+  };
+
+  while (i < args.length) {
+    const arg = args[i];
+
+    if (arg.startsWith('--')) {
+      let clave = arg.slice(2);
+      // Soporta flags con valor integrado: --key=value.
+      // Antes el parser dejaba 'session=claude' como nombre de flag completo,
+      // produciendo opciones['session=claude']=true en vez de opciones.session='claude'.
+      let valorIntegrado = null;
+      const idxIgual = clave.indexOf('=');
+      if (idxIgual !== -1) {
+        valorIntegrado = clave.slice(idxIgual + 1);
+        clave = clave.slice(0, idxIgual);
+      }
+
+      if (BOOLEANAS.includes(clave)) {
+        setear(clave, true);
+      } else if (valorIntegrado !== null) {
+        // --key=value
+        setear(clave, valorIntegrado);
+      } else if (i + 1 < args.length && !args[i + 1].startsWith('--')) {
+        // --key value
+        setear(clave, args[i + 1]);
+        i++;
+      } else {
+        // --key (sin valor)
+        setear(clave, true);
+      }
+    } else if (arg.startsWith('-')) {
+      const clave = arg.slice(1);
+      if (clave === 'v') opciones.version = true;
+      else if (clave === 'h') opciones.help = true;
+    } else {
+      // Argumentos posicionales (fuente en skills add, nombre en skills remove)
+      opciones._args.push(arg);
+    }
+
+    i++;
+  }
+
+  return opciones;
+}
+
+module.exports = { parsearOpciones, aliasDeFlag, ALIAS_FLAGS, BOOLEANAS };

package/scripts/lib/prompt-builder.js

@@ -1,264 +1,264 @@
-'use strict';
-
-/**
- * prompt-builder.js — Construcción dinámica de instrucciones para comandos
- * `/swl:*` y agentes desde un base + contexto + apéndices YAML por proyecto.
- *
- * Patrón adaptado de `temp/claudian-main/src/core/prompt/mainAgent.ts`
- * (plugin Obsidian Claudian, Yishen Tu, MIT). Diferencias respecto al
- * original:
- *   - SWL no controla el system prompt del subagente (lo gestiona Claude
- *     Code). Esta librería se enfoca en composición de mensajes/instrucciones
- *     que comandos `/swl:*` o agentes generan dinámicamente al delegar.
- *   - Zero-deps Node stdlib (sin js-yaml). Parser YAML mínimo y suficiente
- *     para apéndices simples (key: scalar, listas y bloques `>`).
- *
- * Uso programático:
- *   const pb = require('./scripts/lib/prompt-builder');
- *   const apendices = pb.cargarApendices(); // lee instintos/prompt-appendices.yaml
- *   const mensaje = pb.construirPrompt({
- *     base: 'Implementa la fase X siguiendo el PLAN.md.',
- *     contexto: { proyecto: 'sigaf', fase: '03-validacion' },
- *     appendices: ['estilo_respuesta', 'restricciones_dominio'],
- *     apendicesDisponibles: apendices,
- *   });
- *
- * Uso CLI (debug):
- *   node scripts/lib/prompt-builder.js --base "instr" --apendice estilo_respuesta
- *
- * @module scripts/lib/prompt-builder
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const RUTA_APENDICES_DEFAULT = path.join(process.cwd(), 'instintos', 'prompt-appendices.yaml');
-
-/**
- * Parser YAML mínimo zero-deps. Soporta:
- *   - claves de primer nivel con valor escalar: `key: value`
- *   - claves con bloque `>` o `|`: continúa hasta encontrar otra clave de
- *     primer nivel o EOF
- *   - secciones anidadas de un nivel: `parent:\n  hijo: valor`
- *   - listas inline `key: [a, b, c]` o multilínea con `- ` (no profundas)
- *
- * NO soporta: anidamiento profundo arbitrario, anclas `&`, alias `*`, tags.
- * Si se requiere YAML complejo, cargar js-yaml como dependencia opcional
- * (NO incluido aquí por principio zero-deps).
- *
- * @param {string} texto
- * @returns {object}
- */
-function parsearYamlMinimo(texto) {
-  if (!texto || typeof texto !== 'string') return {};
-  const lineas = texto.split(/\r?\n/);
-  const resultado = {};
-
-  let claveSeccion = null;
-  let bufferBloque = null;
-  let claveBloque = null;
-  let modoBloque = null;
-  let seccionActual = null;
-
-  const esLineaIndentadaSeccion = (l) => /^\s{2,}\S/.test(l);
-  const esComentario = (l) => /^\s*#/.test(l) || l.trim() === '';
-
-  function commitBloque() {
-    if (claveBloque !== null && bufferBloque !== null) {
-      const valor = modoBloque === '>'
-        ? bufferBloque.replace(/\n+/g, ' ').trim()
-        : bufferBloque.replace(/\n$/, '');
-      if (claveSeccion) {
-        if (!resultado[claveSeccion] || typeof resultado[claveSeccion] !== 'object') {
-          resultado[claveSeccion] = {};
-        }
-        resultado[claveSeccion][claveBloque] = valor;
-      } else {
-        resultado[claveBloque] = valor;
-      }
-    }
-    bufferBloque = null;
-    claveBloque = null;
-    modoBloque = null;
-  }
-
-  for (const linea of lineas) {
-    if (claveBloque !== null) {
-      if (esComentario(linea)) continue;
-      if (esLineaIndentadaSeccion(linea)) {
-        bufferBloque += linea.replace(/^\s+/, '') + '\n';
-        continue;
-      } else {
-        commitBloque();
-      }
-    }
-
-    if (esComentario(linea)) continue;
-
-    const matchSeccion = linea.match(/^([A-Za-z_][A-Za-z0-9_-]*)\s*:\s*$/);
-    if (matchSeccion) {
-      commitBloque();
-      claveSeccion = matchSeccion[1];
-      seccionActual = claveSeccion;
-      if (!resultado[claveSeccion]) resultado[claveSeccion] = {};
-      continue;
-    }
-
-    const matchBloque = linea.match(/^(\s*)([A-Za-z_][A-Za-z0-9_-]*)\s*:\s*([>|])\s*$/);
-    if (matchBloque) {
-      const [, indent, k, modo] = matchBloque;
-      if (indent.length > 0 && claveSeccion) {
-        claveBloque = k;
-      } else {
-        commitBloque();
-        claveSeccion = null;
-        claveBloque = k;
-      }
-      bufferBloque = '';
-      modoBloque = modo;
-      continue;
-    }
-
-    const matchKV = linea.match(/^(\s*)([A-Za-z_][A-Za-z0-9_-]*)\s*:\s*(.+?)\s*$/);
-    if (matchKV) {
-      const [, indent, k, rawV] = matchKV;
-      const v = rawV.replace(/^["'](.*)["']$/, '$1');
-      if (indent.length > 0 && seccionActual) {
-        if (!resultado[seccionActual] || typeof resultado[seccionActual] !== 'object') {
-          resultado[seccionActual] = {};
-        }
-        resultado[seccionActual][k] = v;
-      } else {
-        seccionActual = null;
-        claveSeccion = null;
-        resultado[k] = v;
-      }
-      continue;
-    }
-  }
-  commitBloque();
-  return resultado;
-}
-
-/**
- * Carga el archivo `instintos/prompt-appendices.yaml` si existe.
- * Retorna `{}` si no existe o si el parseo falla (zero-throw).
- *
- * @param {string} [ruta] - Ruta absoluta opcional para tests.
- * @returns {object} mapa de apéndices
- */
-function cargarApendices(ruta) {
-  const r = ruta || RUTA_APENDICES_DEFAULT;
-  try {
-    if (!fs.existsSync(r)) return {};
-    const contenido = fs.readFileSync(r, 'utf8');
-    return parsearYamlMinimo(contenido);
-  } catch {
-    return {};
-  }
-}
-
-/**
- * Sustituye placeholders `{clave}` en una cadena con valores del contexto.
- * Solo claves planas (no expresiones); valores undefined dejan el placeholder.
- *
- * @param {string} texto
- * @param {object} contexto
- * @returns {string}
- */
-function interpolar(texto, contexto) {
-  if (!texto || !contexto) return texto || '';
-  return String(texto).replace(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (_m, clave) => {
-    const v = contexto[clave];
-    return v === undefined ? `{${clave}}` : String(v);
-  });
-}
-
-/**
- * Construye un prompt/instrucción dinámico componiendo:
- *   1. base (obligatorio)
- *   2. apéndices seleccionados del catálogo (instintos/prompt-appendices.yaml)
- *   3. customAppend (instrucciones ad-hoc no en catálogo)
- *
- * Todos los componentes pasan por `interpolar()` con el contexto provisto.
- *
- * @param {object} opts
- * @param {string} opts.base                       - Texto base obligatorio.
- * @param {object} [opts.contexto]                 - Variables para interpolación.
- * @param {string[]} [opts.appendices]             - Nombres de apéndices a incluir.
- * @param {object} [opts.apendicesDisponibles]     - Catálogo (resultado de cargarApendices).
- * @param {string} [opts.customAppend]             - Texto adicional sin pasar por catálogo.
- * @returns {string}
- */
-function construirPrompt(opts = {}) {
-  const base = opts.base;
-  if (!base || typeof base !== 'string') {
-    throw new Error('construirPrompt: opts.base es obligatorio (string)');
-  }
-  const contexto = opts.contexto || {};
-  const apendicesDisp = opts.apendicesDisponibles || {};
-  const seleccion = Array.isArray(opts.appendices) ? opts.appendices : [];
-
-  const partes = [interpolar(base, contexto).trim()];
-
-  for (const nombre of seleccion) {
-    const valor = apendicesDisp[nombre];
-    if (valor && typeof valor === 'string' && valor.trim().length > 0) {
-      partes.push(interpolar(valor, contexto).trim());
-    }
-  }
-
-  if (opts.customAppend && typeof opts.customAppend === 'string' && opts.customAppend.trim()) {
-    partes.push(interpolar(opts.customAppend, contexto).trim());
-  }
-
-  return partes.filter(Boolean).join('\n\n');
-}
-
-/**
- * Calcula un identificador estable de un prompt construido. Útil para
- * caché o deduplicación (mismo input → misma key).
- *
- * Patrón adaptado de `computeSystemPromptKey` de claudian.
- *
- * @param {object} opts
- * @returns {string}
- */
-function calcularKey(opts = {}) {
-  const partes = [
-    opts.base || '',
-    JSON.stringify(opts.contexto || {}),
-    (opts.appendices || []).join('||'),
-    opts.customAppend || '',
-  ];
-  return partes.join('::');
-}
-
-module.exports = {
-  construirPrompt,
-  cargarApendices,
-  calcularKey,
-  _internals: {
-    parsearYamlMinimo,
-    interpolar,
-    RUTA_APENDICES_DEFAULT,
-  },
-};
-
-if (require.main === module) {
-  const args = process.argv.slice(2);
-  const opts = {};
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === '--base') opts.base = args[++i];
-    else if (args[i] === '--apendice') {
-      opts.appendices = opts.appendices || [];
-      opts.appendices.push(args[++i]);
-    } else if (args[i] === '--ruta-apendices') opts.rutaApendices = args[++i];
-  }
-  if (!opts.base) {
-    process.stderr.write('Uso: node prompt-builder.js --base "<texto>" [--apendice <nombre>]+ [--ruta-apendices <ruta>]\n');
-    process.exit(1);
-  }
-  opts.apendicesDisponibles = cargarApendices(opts.rutaApendices);
-  process.stdout.write(construirPrompt(opts) + '\n');
-}
+'use strict';
+
+/**
+ * prompt-builder.js — Construcción dinámica de instrucciones para comandos
+ * `/swl:*` y agentes desde un base + contexto + apéndices YAML por proyecto.
+ *
+ * Patrón adaptado de `temp/claudian-main/src/core/prompt/mainAgent.ts`
+ * (plugin Obsidian Claudian, Yishen Tu, MIT). Diferencias respecto al
+ * original:
+ *   - SWL no controla el system prompt del subagente (lo gestiona Claude
+ *     Code). Esta librería se enfoca en composición de mensajes/instrucciones
+ *     que comandos `/swl:*` o agentes generan dinámicamente al delegar.
+ *   - Zero-deps Node stdlib (sin js-yaml). Parser YAML mínimo y suficiente
+ *     para apéndices simples (key: scalar, listas y bloques `>`).
+ *
+ * Uso programático:
+ *   const pb = require('./scripts/lib/prompt-builder');
+ *   const apendices = pb.cargarApendices(); // lee instintos/prompt-appendices.yaml
+ *   const mensaje = pb.construirPrompt({
+ *     base: 'Implementa la fase X siguiendo el PLAN.md.',
+ *     contexto: { proyecto: 'sigaf', fase: '03-validacion' },
+ *     appendices: ['estilo_respuesta', 'restricciones_dominio'],
+ *     apendicesDisponibles: apendices,
+ *   });
+ *
+ * Uso CLI (debug):
+ *   node scripts/lib/prompt-builder.js --base "instr" --apendice estilo_respuesta
+ *
+ * @module scripts/lib/prompt-builder
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const RUTA_APENDICES_DEFAULT = path.join(process.cwd(), 'instintos', 'prompt-appendices.yaml');
+
+/**
+ * Parser YAML mínimo zero-deps. Soporta:
+ *   - claves de primer nivel con valor escalar: `key: value`
+ *   - claves con bloque `>` o `|`: continúa hasta encontrar otra clave de
+ *     primer nivel o EOF
+ *   - secciones anidadas de un nivel: `parent:\n  hijo: valor`
+ *   - listas inline `key: [a, b, c]` o multilínea con `- ` (no profundas)
+ *
+ * NO soporta: anidamiento profundo arbitrario, anclas `&`, alias `*`, tags.
+ * Si se requiere YAML complejo, cargar js-yaml como dependencia opcional
+ * (NO incluido aquí por principio zero-deps).
+ *
+ * @param {string} texto
+ * @returns {object}
+ */
+function parsearYamlMinimo(texto) {
+  if (!texto || typeof texto !== 'string') return {};
+  const lineas = texto.split(/\r?\n/);
+  const resultado = {};
+
+  let claveSeccion = null;
+  let bufferBloque = null;
+  let claveBloque = null;
+  let modoBloque = null;
+  let seccionActual = null;
+
+  const esLineaIndentadaSeccion = (l) => /^\s{2,}\S/.test(l);
+  const esComentario = (l) => /^\s*#/.test(l) || l.trim() === '';
+
+  function commitBloque() {
+    if (claveBloque !== null && bufferBloque !== null) {
+      const valor = modoBloque === '>'
+        ? bufferBloque.replace(/\n+/g, ' ').trim()
+        : bufferBloque.replace(/\n$/, '');
+      if (claveSeccion) {
+        if (!resultado[claveSeccion] || typeof resultado[claveSeccion] !== 'object') {
+          resultado[claveSeccion] = {};
+        }
+        resultado[claveSeccion][claveBloque] = valor;
+      } else {
+        resultado[claveBloque] = valor;
+      }
+    }
+    bufferBloque = null;
+    claveBloque = null;
+    modoBloque = null;
+  }
+
+  for (const linea of lineas) {
+    if (claveBloque !== null) {
+      if (esComentario(linea)) continue;
+      if (esLineaIndentadaSeccion(linea)) {
+        bufferBloque += linea.replace(/^\s+/, '') + '\n';
+        continue;
+      } else {
+        commitBloque();
+      }
+    }
+
+    if (esComentario(linea)) continue;
+
+    const matchSeccion = linea.match(/^([A-Za-z_][A-Za-z0-9_-]*)\s*:\s*$/);
+    if (matchSeccion) {
+      commitBloque();
+      claveSeccion = matchSeccion[1];
+      seccionActual = claveSeccion;
+      if (!resultado[claveSeccion]) resultado[claveSeccion] = {};
+      continue;
+    }
+
+    const matchBloque = linea.match(/^(\s*)([A-Za-z_][A-Za-z0-9_-]*)\s*:\s*([>|])\s*$/);
+    if (matchBloque) {
+      const [, indent, k, modo] = matchBloque;
+      if (indent.length > 0 && claveSeccion) {
+        claveBloque = k;
+      } else {
+        commitBloque();
+        claveSeccion = null;
+        claveBloque = k;
+      }
+      bufferBloque = '';
+      modoBloque = modo;
+      continue;
+    }
+
+    const matchKV = linea.match(/^(\s*)([A-Za-z_][A-Za-z0-9_-]*)\s*:\s*(.+?)\s*$/);
+    if (matchKV) {
+      const [, indent, k, rawV] = matchKV;
+      const v = rawV.replace(/^["'](.*)["']$/, '$1');
+      if (indent.length > 0 && seccionActual) {
+        if (!resultado[seccionActual] || typeof resultado[seccionActual] !== 'object') {
+          resultado[seccionActual] = {};
+        }
+        resultado[seccionActual][k] = v;
+      } else {
+        seccionActual = null;
+        claveSeccion = null;
+        resultado[k] = v;
+      }
+      continue;
+    }
+  }
+  commitBloque();
+  return resultado;
+}
+
+/**
+ * Carga el archivo `instintos/prompt-appendices.yaml` si existe.
+ * Retorna `{}` si no existe o si el parseo falla (zero-throw).
+ *
+ * @param {string} [ruta] - Ruta absoluta opcional para tests.
+ * @returns {object} mapa de apéndices
+ */
+function cargarApendices(ruta) {
+  const r = ruta || RUTA_APENDICES_DEFAULT;
+  try {
+    if (!fs.existsSync(r)) return {};
+    const contenido = fs.readFileSync(r, 'utf8');
+    return parsearYamlMinimo(contenido);
+  } catch {
+    return {};
+  }
+}
+
+/**
+ * Sustituye placeholders `{clave}` en una cadena con valores del contexto.
+ * Solo claves planas (no expresiones); valores undefined dejan el placeholder.
+ *
+ * @param {string} texto
+ * @param {object} contexto
+ * @returns {string}
+ */
+function interpolar(texto, contexto) {
+  if (!texto || !contexto) return texto || '';
+  return String(texto).replace(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g, (_m, clave) => {
+    const v = contexto[clave];
+    return v === undefined ? `{${clave}}` : String(v);
+  });
+}
+
+/**
+ * Construye un prompt/instrucción dinámico componiendo:
+ *   1. base (obligatorio)
+ *   2. apéndices seleccionados del catálogo (instintos/prompt-appendices.yaml)
+ *   3. customAppend (instrucciones ad-hoc no en catálogo)
+ *
+ * Todos los componentes pasan por `interpolar()` con el contexto provisto.
+ *
+ * @param {object} opts
+ * @param {string} opts.base                       - Texto base obligatorio.
+ * @param {object} [opts.contexto]                 - Variables para interpolación.
+ * @param {string[]} [opts.appendices]             - Nombres de apéndices a incluir.
+ * @param {object} [opts.apendicesDisponibles]     - Catálogo (resultado de cargarApendices).
+ * @param {string} [opts.customAppend]             - Texto adicional sin pasar por catálogo.
+ * @returns {string}
+ */
+function construirPrompt(opts = {}) {
+  const base = opts.base;
+  if (!base || typeof base !== 'string') {
+    throw new Error('construirPrompt: opts.base es obligatorio (string)');
+  }
+  const contexto = opts.contexto || {};
+  const apendicesDisp = opts.apendicesDisponibles || {};
+  const seleccion = Array.isArray(opts.appendices) ? opts.appendices : [];
+
+  const partes = [interpolar(base, contexto).trim()];
+
+  for (const nombre of seleccion) {
+    const valor = apendicesDisp[nombre];
+    if (valor && typeof valor === 'string' && valor.trim().length > 0) {
+      partes.push(interpolar(valor, contexto).trim());
+    }
+  }
+
+  if (opts.customAppend && typeof opts.customAppend === 'string' && opts.customAppend.trim()) {
+    partes.push(interpolar(opts.customAppend, contexto).trim());
+  }
+
+  return partes.filter(Boolean).join('\n\n');
+}
+
+/**
+ * Calcula un identificador estable de un prompt construido. Útil para
+ * caché o deduplicación (mismo input → misma key).
+ *
+ * Patrón adaptado de `computeSystemPromptKey` de claudian.
+ *
+ * @param {object} opts
+ * @returns {string}
+ */
+function calcularKey(opts = {}) {
+  const partes = [
+    opts.base || '',
+    JSON.stringify(opts.contexto || {}),
+    (opts.appendices || []).join('||'),
+    opts.customAppend || '',
+  ];
+  return partes.join('::');
+}
+
+module.exports = {
+  construirPrompt,
+  cargarApendices,
+  calcularKey,
+  _internals: {
+    parsearYamlMinimo,
+    interpolar,
+    RUTA_APENDICES_DEFAULT,
+  },
+};
+
+if (require.main === module) {
+  const args = process.argv.slice(2);
+  const opts = {};
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--base') opts.base = args[++i];
+    else if (args[i] === '--apendice') {
+      opts.appendices = opts.appendices || [];
+      opts.appendices.push(args[++i]);
+    } else if (args[i] === '--ruta-apendices') opts.rutaApendices = args[++i];
+  }
+  if (!opts.base) {
+    process.stderr.write('Uso: node prompt-builder.js --base "<texto>" [--apendice <nombre>]+ [--ruta-apendices <ruta>]\n');
+    process.exit(1);
+  }
+  opts.apendicesDisponibles = cargarApendices(opts.rutaApendices);
+  process.stdout.write(construirPrompt(opts) + '\n');
+}