theus-cli 0.2.82 → 0.2.84

package/vendor/theus-arsenal/skills/memoria-por-proyecto/commands/migrate.mjs

@@ -1,214 +0,0 @@
-#!/usr/bin/env node
-/**
- * memoria-por-proyecto (ck) v2
- * migrate.mjs — convierte datos v1 (CONTEXT.md + meta.json) al formato v2 (context.json)
- *
- * Uso:
- *   node migrate.mjs           — migra todos los proyectos v1
- *   node migrate.mjs --dry-run — vista previa sin escribir nada
- *
- * Seguro: respalda meta.json como meta.json.v1-backup, nunca borra datos.
- * exit 0: éxito  exit 1: error
- *
- * Nota: los archivos v1 provienen de la herramienta original y usan encabezados
- * en inglés; el parser acepta tanto los encabezados en inglés como sus
- * equivalentes en español.
- */
-
-import { readFileSync, existsSync, renameSync } from 'fs';
-import { resolve } from 'path';
-import { readProjects, writeProjects, saveContext, today, shortId, CONTEXTS_DIR } from './shared.mjs';
-
-const isDryRun = process.argv.includes('--dry-run');
-
-if (isDryRun) {
-  console.log('memoria migrar — SIMULACIÓN (no se escribirá ningún archivo)\n');
-}
-
-// ── Parsers del markdown v1 ───────────────────────────────────────────────────
-
-function extractSection(md, heading) {
-  const re = new RegExp(`## ${heading}\\n([\\s\\S]*?)(?=\\n## |$)`);
-  const m = md.match(re);
-  return m ? m[1].trim() : null;
-}
-
-function extractSectionAny(md, headings) {
-  for (const h of headings) {
-    const section = extractSection(md, h);
-    if (section) return section;
-  }
-  return null;
-}
-
-function parseBullets(text) {
-  if (!text) return [];
-  return text.split('\n')
-    .filter(l => /^[-*\d]\s/.test(l.trim()))
-    .map(l => l.replace(/^[-*\d]+\.?\s+/, '').trim())
-    .filter(Boolean);
-}
-
-function parseDecisionsTable(text) {
-  if (!text) return [];
-  const rows = [];
-  for (const line of text.split('\n')) {
-    if (!line.startsWith('|') || line.match(/^[|\s-]+$/)) continue;
-    const cols = line.split('|').map(c => c.trim()).filter((c, i) => i > 0 && i < 4);
-    if (cols.length >= 1 && !cols[0].startsWith('Decision') && !cols[0].startsWith('Decisión') && !cols[0].startsWith('_')) {
-      rows.push({ what: cols[0] || '', why: cols[1] || '', date: cols[2] || '' });
-    }
-  }
-  return rows;
-}
-
-/**
- * Parsea "Where I Left Off" / "Dónde quedé", que en v1 puede ser:
- * - Lista simple de viñetas
- * - Bloques multi-sesión: "Session N (fecha):\n- viñeta\n"
- * Devuelve un array de objetos tipo sesión {date?, leftOff}
- */
-function parseLeftOff(text) {
-  if (!text) return [{ leftOff: null }];
-
-  // Detecta el formato multi-sesión: "Session N ..."
-  const sessionBlocks = text.split(/(?=Session \d+)/);
-  if (sessionBlocks.length > 1) {
-    return sessionBlocks
-      .filter(b => b.trim())
-      .map(block => {
-        const dateMatch = block.match(/\((\d{4}-\d{2}-\d{2})\)/);
-        const bullets = parseBullets(block);
-        return {
-          date: dateMatch?.[1] || null,
-          leftOff: bullets.length ? bullets.join('\n') : block.replace(/^Session \d+.*\n/, '').trim(),
-        };
-      });
-  }
-
-  // Formato simple
-  const bullets = parseBullets(text);
-  return [{ leftOff: bullets.length ? bullets.join('\n') : text.trim() }];
-}
-
-// ── Migración principal ───────────────────────────────────────────────────────
-
-const projects = readProjects();
-let migrated = 0;
-let skipped = 0;
-let errors = 0;
-
-for (const [projectPath, info] of Object.entries(projects)) {
-  const contextDir = info.contextDir;
-  const contextDirPath = resolve(CONTEXTS_DIR, contextDir);
-  const contextJsonPath = resolve(contextDirPath, 'context.json');
-  const contextMdPath   = resolve(contextDirPath, 'CONTEXT.md');
-  const metaPath        = resolve(contextDirPath, 'meta.json');
-
-  // Ya está en v2
-  if (existsSync(contextJsonPath)) {
-    try {
-      const existing = JSON.parse(readFileSync(contextJsonPath, 'utf8'));
-      if (existing.version === 2) {
-        console.log(`  ✓ ${contextDir} — ya es v2, se omite`);
-        skipped++;
-        continue;
-      }
-    } catch { /* continúa con la migración */ }
-  }
-
-  console.log(`\n  → Migrando: ${contextDir}`);
-
-  try {
-    // Lee los archivos v1
-    const contextMd = existsSync(contextMdPath) ? readFileSync(contextMdPath, 'utf8') : '';
-    let meta = {};
-    if (existsSync(metaPath)) {
-      try {
-        meta = JSON.parse(readFileSync(metaPath, 'utf8'));
-      } catch (e) {
-        console.warn(`  ! ${contextDir}: meta.json inválido, se continúa con valores por defecto (${e.message})`);
-      }
-    }
-
-    // Extrae campos de CONTEXT.md
-    const description   = extractSectionAny(contextMd, ['What This Is', 'Qué es', 'About', 'Acerca de']) || null;
-    const stackRaw      = extractSectionAny(contextMd, ['Tech Stack', 'Stack tecnológico']) || '';
-    const stack         = stackRaw.split(/[,\n]/).map(s => s.replace(/^[-*]\s+/, '').trim()).filter(Boolean);
-    const goal          = (extractSectionAny(contextMd, ['Current Goal', 'Objetivo actual']) || '').split('\n')[0].trim() || null;
-    const constraintRaw = extractSectionAny(contextMd, ['Do Not Do', 'No hacer']) || '';
-    const constraints   = parseBullets(constraintRaw);
-    const decisionsRaw  = extractSectionAny(contextMd, ['Decisions Made', 'Decisiones tomadas']) || '';
-    const decisions     = parseDecisionsTable(decisionsRaw);
-    const nextStepsRaw  = extractSectionAny(contextMd, ['Next Steps', 'Próximos pasos']) || '';
-    const nextSteps     = parseBullets(nextStepsRaw);
-    const blockersRaw   = extractSectionAny(contextMd, ['Blockers', 'Bloqueos']) || '';
-    const blockers      = parseBullets(blockersRaw).filter(b => !['none', 'ninguno'].includes(b.toLowerCase()));
-    const leftOffRaw    = extractSectionAny(contextMd, ['Where I Left Off', 'Dónde quedé']) || '';
-    const leftOffParsed = parseLeftOff(leftOffRaw);
-
-    // Construye las sesiones a partir de los bloques parseados (pueden ser varios)
-    const sessions = leftOffParsed.map((lo, idx) => ({
-      id: idx === leftOffParsed.length - 1 && meta.lastSessionId
-        ? meta.lastSessionId.slice(0, 8)
-        : shortId(),
-      date: lo.date || meta.lastUpdated || today(),
-      summary: idx === leftOffParsed.length - 1
-        ? (meta.lastSessionSummary || 'Migrado desde v1')
-        : `Sesión ${idx + 1} (migrada)`,
-      leftOff: lo.leftOff,
-      nextSteps: idx === leftOffParsed.length - 1 ? nextSteps : [],
-      decisions: idx === leftOffParsed.length - 1 ? decisions : [],
-      blockers: idx === leftOffParsed.length - 1 ? blockers : [],
-    }));
-
-    const context = {
-      version: 2,
-      name: contextDir,
-      path: meta.path || projectPath,
-      description,
-      stack,
-      goal,
-      constraints,
-      repo: meta.repo || null,
-      createdAt: meta.lastUpdated || today(),
-      sessions,
-    };
-
-    if (isDryRun) {
-      console.log(`    descripción: ${description?.slice(0, 60) || '(ninguna)'}`);
-      console.log(`    stack:       ${stack.join(', ') || '(ninguno)'}`);
-      console.log(`    objetivo:    ${goal?.slice(0, 60) || '(ninguno)'}`);
-      console.log(`    sesiones:    ${sessions.length}`);
-      console.log(`    decisiones:  ${decisions.length}`);
-      console.log(`    próximos:    ${nextSteps.length}`);
-      migrated++;
-      continue;
-    }
-
-    // Respalda meta.json
-    if (existsSync(metaPath)) {
-      renameSync(metaPath, resolve(contextDirPath, 'meta.json.v1-backup'));
-    }
-
-    // Escribe context.json + CONTEXT.md regenerado
-    saveContext(contextDir, context);
-
-    // Actualiza la entrada de projects.json
-    projects[projectPath].lastUpdated = today();
-
-    console.log(`    ✓ Migrado — ${sessions.length} sesión(es), ${decisions.length} decisión(es)`);
-    migrated++;
-  } catch (e) {
-    console.log(`    ✗ Error: ${e.message}`);
-    errors++;
-  }
-}
-
-if (!isDryRun && migrated > 0) {
-  writeProjects(projects);
-}
-
-console.log(`\nmemoria migrar: ${migrated} migrados, ${skipped} ya en v2, ${errors} errores`);
-if (isDryRun) console.log('Ejecuta sin --dry-run para aplicar los cambios.');
-if (errors > 0) process.exit(1);

package/vendor/theus-arsenal/skills/memoria-por-proyecto/commands/resume.mjs

@@ -1,36 +0,0 @@
-#!/usr/bin/env node
-/**
- * memoria-por-proyecto (ck) v2
- * resume.mjs — briefing completo del proyecto
- *
- * Uso: node resume.mjs [nombre|número]
- * stdout: caja de briefing con bordes
- * exit 0: éxito  exit 1: no encontrado
- */
-
-import { existsSync } from 'fs';
-import { resolveContext, renderBriefingBox } from './shared.mjs';
-
-const arg = process.argv[2];
-const cwd = process.env.PWD || process.cwd();
-
-const resolved = resolveContext(arg, cwd);
-if (!resolved) {
-  const hint = arg ? `Ningún proyecto coincide con "${arg}".` : 'Este directorio no está registrado.';
-  console.log(`${hint} Ejecuta /memoria:iniciar para registrarlo.`);
-  process.exit(1);
-}
-
-const { context, projectPath } = resolved;
-
-// Intenta hacer cd a la ruta del proyecto
-if (projectPath && projectPath !== cwd) {
-  if (existsSync(projectPath)) {
-    console.log(`→ cd ${projectPath}`);
-  } else {
-    console.log(`AVISO: ruta no encontrada: ${projectPath}`);
-  }
-}
-
-console.log('');
-console.log(renderBriefingBox(context));

package/vendor/theus-arsenal/skills/memoria-por-proyecto/commands/save.mjs

@@ -1,210 +0,0 @@
-#!/usr/bin/env node
-/**
- * memoria-por-proyecto (ck) v2
- * save.mjs — escribe los datos de la sesión en context.json, regenera CONTEXT.md
- *            y guarda una entrada de memoria por sesión.
- *
- * Uso (guardado normal):
- *   echo '<json>' | node save.mjs
- *   Esquema JSON: { summary, leftOff, nextSteps[], decisions[{what,why}], blockers[], goal? }
- *
- * Uso (init — primer registro):
- *   echo '<json>' | node save.mjs --init
- *   Esquema JSON: { name, path, description, stack[], goal, constraints[], repo? }
- *
- * stdout: mensaje de confirmación
- * exit 0: éxito  exit 1: error
- */
-
-import { readFileSync, mkdirSync, writeFileSync } from 'fs';
-import { resolve } from 'path';
-import {
-  readProjects, writeProjects, loadContext, saveContext,
-  today, shortId, gitSummary, sessionMemoryDir,
-  CURRENT_SESSION,
-} from './shared.mjs';
-
-const isInit = process.argv.includes('--init');
-const cwd    = process.env.PWD || process.cwd();
-
-// ── Lee el JSON desde stdin ───────────────────────────────────────────────────
-let input;
-try {
-  const raw = readFileSync(0, 'utf8').trim();
-  if (!raw) throw new Error('stdin vacío');
-  input = JSON.parse(raw);
-} catch (e) {
-  console.error(`memoria guardar: JSON inválido en stdin — ${e.message}`);
-  console.log('Esquema esperado (guardar):  {"summary":"...","leftOff":"...","nextSteps":["..."],"decisions":[{"what":"...","why":"..."}],"blockers":["..."]}');
-  console.log('Esquema esperado (--init): {"name":"...","path":"...","description":"...","stack":["..."],"goal":"...","constraints":["..."]}');
-  process.exit(1);
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// MODO INIT: primer registro del proyecto
-// ─────────────────────────────────────────────────────────────────────────────
-if (isInit) {
-  const { name, path: projectPath, description, stack, goal, constraints, repo } = input;
-
-  if (!name || !projectPath) {
-    console.log('memoria iniciar: name y path son obligatorios.');
-    process.exit(1);
-  }
-
-  const projects = readProjects();
-
-  // Deriva contextDir (minúsculas, espacios→guiones, sin duplicados)
-  let contextDir = name.toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9-]/g, '');
-  let suffix = 2;
-  const existingDirs = Object.values(projects).map(p => p.contextDir);
-  while (existingDirs.includes(contextDir) && projects[projectPath]?.contextDir !== contextDir) {
-    contextDir = `${contextDir.replace(/-\d+$/, '')}-${suffix++}`;
-  }
-
-  const context = {
-    version: 2,
-    name: contextDir,
-    displayName: name,
-    path: projectPath,
-    description: description || null,
-    stack: Array.isArray(stack) ? stack : (stack ? [stack] : []),
-    goal: goal || null,
-    constraints: Array.isArray(constraints) ? constraints : [],
-    repo: repo || null,
-    createdAt: today(),
-    sessions: [],
-  };
-
-  saveContext(contextDir, context);
-
-  // Actualiza projects.json
-  projects[projectPath] = {
-    name,
-    contextDir,
-    lastUpdated: today(),
-  };
-  writeProjects(projects);
-
-  console.log(`✓ Proyecto '${name}' registrado.`);
-  console.log(`  Usa /memoria:guardar para guardar el estado de la sesión y /memoria:reanudar para recuperarlo la próxima vez.`);
-  process.exit(0);
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// MODO GUARDAR: registra una sesión
-// ─────────────────────────────────────────────────────────────────────────────
-const projects = readProjects();
-const projectEntry = projects[cwd];
-
-if (!projectEntry) {
-  console.log('Este proyecto aún no está registrado. Ejecuta /memoria:iniciar primero.');
-  process.exit(1);
-}
-
-const { contextDir } = projectEntry;
-let context = loadContext(contextDir);
-
-if (!context) {
-  console.log(`memoria: no se encontró context.json para '${contextDir}'. La instalación puede estar corrupta.`);
-  process.exit(1);
-}
-
-// Obtiene el ID de sesión desde current-session.json
-let sessionId;
-try {
-  const sess = JSON.parse(readFileSync(CURRENT_SESSION, 'utf8'));
-  sessionId = sess.sessionId || shortId();
-} catch {
-  sessionId = shortId();
-}
-
-// Comprueba duplicados (re-guardado de la misma sesión)
-const existingIdx = context.sessions.findIndex(s => s.id === sessionId);
-
-const { summary, leftOff, nextSteps, decisions, blockers, goal } = input;
-
-// Captura la actividad de git desde la última sesión
-const lastSessionDate = context.sessions?.[context.sessions.length - 1]?.date;
-const gitActivity = gitSummary(cwd, lastSessionDate);
-
-const session = {
-  id: sessionId,
-  date: today(),
-  summary: summary || 'Sesión guardada',
-  leftOff: leftOff || null,
-  nextSteps: Array.isArray(nextSteps) ? nextSteps : (nextSteps ? [nextSteps] : []),
-  decisions: Array.isArray(decisions) ? decisions : [],
-  blockers: Array.isArray(blockers) ? blockers.filter(Boolean) : [],
-  ...(gitActivity ? { gitActivity } : {}),
-};
-
-if (existingIdx >= 0) {
-  // Actualiza la sesión existente (re-guardado)
-  context.sessions[existingIdx] = session;
-} else {
-  context.sessions.push(session);
-}
-
-// Actualiza el objetivo si se proporcionó
-if (goal && goal !== context.goal) {
-  context.goal = goal;
-}
-
-// Guarda context.json + regenera CONTEXT.md
-saveContext(contextDir, context);
-
-// Actualiza la marca de tiempo de projects.json
-projects[cwd].lastUpdated = today();
-writeProjects(projects);
-
-// ── Escribe la entrada de memoria de la sesión ────────────────────────────────
-try {
-  const memDir = sessionMemoryDir(cwd);
-  mkdirSync(memDir, { recursive: true });
-
-  const memFile = resolve(memDir, `ck_${today()}_${sessionId.slice(0, 8)}.md`);
-  const decisionsBlock = session.decisions.length
-    ? session.decisions.map(d => `- **${d.what}**: ${d.why || ''}`).join('\n')
-    : '- Ninguna en esta sesión';
-  const nextBlock = session.nextSteps.length
-    ? session.nextSteps.map((s, i) => `${i + 1}. ${s}`).join('\n')
-    : '- Sin registrar';
-  const blockersBlock = session.blockers.length
-    ? session.blockers.map(b => `- ${b}`).join('\n')
-    : '- Ninguno';
-
-  const memContent = [
-    `---`,
-    `name: Sesión ${today()} — ${session.summary}`,
-    `description: Decisiones y resultados clave de la sesión ${sessionId.slice(0, 8)}`,
-    `type: project`,
-    `source: memoria-por-proyecto`,
-    `sessionId: ${sessionId}`,
-    `---`,
-    ``,
-    `# Sesión: ${session.summary}`,
-    ``,
-    `## Decisiones`,
-    decisionsBlock,
-    ``,
-    `## Dónde quedé`,
-    session.leftOff || '—',
-    ``,
-    `## Próximos pasos`,
-    nextBlock,
-    ``,
-    `## Bloqueos`,
-    blockersBlock,
-    ``,
-    ...(gitActivity ? [`## Actividad de git`, gitActivity, ``] : []),
-  ].join('\n');
-
-  writeFileSync(memFile, memContent, 'utf8');
-} catch (e) {
-  // No fatal — un fallo al escribir la entrada de memoria no debe bloquear el guardado
-  process.stderr.write(`memoria: aviso — no se pudo escribir la entrada de memoria: ${e.message}\n`);
-}
-
-console.log(`✓ Guardado. Sesión: ${sessionId.slice(0, 8)}`);
-if (gitActivity) console.log(`  Git: ${gitActivity}`);
-console.log(`  Hasta la próxima.`);