theus-cli-darwin-x64 0.2.84

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

@@ -0,0 +1,402 @@
+/**
+ * memoria-por-proyecto (ck) v2
+ * shared.mjs — utilidades comunes para todos los scripts de comandos
+ *
+ * Sin dependencias externas. Solo stdlib de Node.js.
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+import { spawnSync } from 'child_process';
+import { randomBytes } from 'crypto';
+import { createRequire } from 'module';
+
+// ─── Rutas ────────────────────────────────────────────────────────────────────
+// El estado persistente vive SIEMPRE bajo la raíz de datos del agente
+// (~/.theus/arsenal por defecto; configurable con THEUS_AGENT_DATA_HOME).
+
+const require = createRequire(import.meta.url);
+let resolveAgentDataHome;
+try {
+  ({ resolveAgentDataHome } = require('../../../scripts/lib/agent-data-home.js'));
+} catch {
+  // Respaldo si el script se ejecuta fuera del árbol del plugin
+  resolveAgentDataHome = () => resolve(homedir(), '.theus', 'arsenal');
+}
+
+const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
+
+export const CK_HOME          = resolve(resolveAgentDataHome(), 'ck');
+export const CONTEXTS_DIR     = resolve(CK_HOME, 'contexts');
+export const PROJECTS_FILE    = resolve(CK_HOME, 'projects.json');
+export const CURRENT_SESSION  = resolve(CK_HOME, 'current-session.json');
+export const SKILL_FILE       = resolve(MODULE_DIR, '..', 'SKILL.md');
+
+// ─── E/S de JSON ──────────────────────────────────────────────────────────────
+
+export function readJson(filePath) {
+  try {
+    if (!existsSync(filePath)) return null;
+    return JSON.parse(readFileSync(filePath, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+export function writeJson(filePath, data) {
+  const dir = resolve(filePath, '..');
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf8');
+}
+
+export function readProjects() {
+  return readJson(PROJECTS_FILE) || {};
+}
+
+export function writeProjects(projects) {
+  writeJson(PROJECTS_FILE, projects);
+}
+
+// ─── E/S de contexto ──────────────────────────────────────────────────────────
+
+export function contextPath(contextDir) {
+  return resolve(CONTEXTS_DIR, contextDir, 'context.json');
+}
+
+export function contextMdPath(contextDir) {
+  return resolve(CONTEXTS_DIR, contextDir, 'CONTEXT.md');
+}
+
+export function loadContext(contextDir) {
+  return readJson(contextPath(contextDir));
+}
+
+export function saveContext(contextDir, data) {
+  const dir = resolve(CONTEXTS_DIR, contextDir);
+  mkdirSync(dir, { recursive: true });
+  writeJson(contextPath(contextDir), data);
+  writeFileSync(contextMdPath(contextDir), renderContextMd(data), 'utf8');
+}
+
+/**
+ * Resuelve sobre qué proyecto operar.
+ * @param {string|undefined} arg  — undefined = coincidencia por cwd, cadena numérica = índice alfabético, si no búsqueda por nombre
+ * @param {string} cwd
+ * @returns {{ name, contextDir, projectPath, context } | null}
+ */
+export function resolveContext(arg, cwd) {
+  const projects = readProjects();
+  const entries = Object.entries(projects); // [ruta, {name, contextDir, lastUpdated}]
+
+  if (!arg) {
+    // Coincidencia por cwd
+    const entry = projects[cwd];
+    if (!entry) return null;
+    const context = loadContext(entry.contextDir);
+    if (!context) return null;
+    return { name: entry.name, contextDir: entry.contextDir, projectPath: cwd, context };
+  }
+
+  // Recopila todos los contextos ordenados alfabéticamente por contextDir
+  const sorted = entries
+    .map(([path, info]) => ({ path, ...info }))
+    .sort((a, b) => a.contextDir.localeCompare(b.contextDir));
+
+  const asNumber = parseInt(arg, 10);
+  if (!isNaN(asNumber) && String(asNumber) === arg) {
+    // Búsqueda por número (índice desde 1)
+    const item = sorted[asNumber - 1];
+    if (!item) return null;
+    const context = loadContext(item.contextDir);
+    if (!context) return null;
+    return { name: item.name, contextDir: item.contextDir, projectPath: item.path, context };
+  }
+
+  // Búsqueda por nombre: exacta > prefijo > subcadena (sin distinguir mayúsculas)
+  const lower = arg.toLowerCase();
+  let match =
+    sorted.find(e => e.name.toLowerCase() === lower) ||
+    sorted.find(e => e.name.toLowerCase().startsWith(lower)) ||
+    sorted.find(e => e.name.toLowerCase().includes(lower));
+
+  if (!match) return null;
+  const context = loadContext(match.contextDir);
+  if (!context) return null;
+  return { name: match.name, contextDir: match.contextDir, projectPath: match.path, context };
+}
+
+// ─── Helpers de fechas ────────────────────────────────────────────────────────
+
+export function today() {
+  return new Date().toISOString().slice(0, 10);
+}
+
+export function daysAgoLabel(dateStr) {
+  if (!dateStr) return 'desconocido';
+  const diff = Math.floor((Date.now() - new Date(dateStr)) / 86_400_000);
+  if (diff === 0) return 'Hoy';
+  if (diff === 1) return 'hace 1 día';
+  return `hace ${diff} días`;
+}
+
+export function stalenessIcon(dateStr) {
+  if (!dateStr) return '○';
+  const diff = Math.floor((Date.now() - new Date(dateStr)) / 86_400_000);
+  if (diff < 1) return '●';
+  if (diff <= 5) return '◐';
+  return '○';
+}
+
+// ─── Generación de IDs ────────────────────────────────────────────────────────
+
+export function shortId() {
+  return randomBytes(4).toString('hex');
+}
+
+// ─── Helpers de git ───────────────────────────────────────────────────────────
+
+function runGit(args, cwd) {
+  try {
+    const result = spawnSync('git', ['-C', cwd, ...args], {
+      timeout: 3000,
+      stdio: 'pipe',
+      encoding: 'utf8',
+    });
+    if (result.status !== 0) return null;
+    return result.stdout.trim();
+  } catch {
+    return null;
+  }
+}
+
+export function gitLogSince(projectPath, sinceDate) {
+  if (!sinceDate) return null;
+  return runGit(['log', '--oneline', `--since=${sinceDate}`], projectPath);
+}
+
+export function gitSummary(projectPath, sinceDate) {
+  const log = gitLogSince(projectPath, sinceDate);
+  if (!log) return null;
+  const commits = log.split('\n').filter(Boolean).length;
+  if (commits === 0) return null;
+
+  // Cuenta de archivos únicos cambiados: llamada a runGit separada para evitar sustituciones anidadas de shell
+  const countStr = runGit(['rev-list', '--count', 'HEAD', `--since=${sinceDate}`], projectPath);
+  const revCount = countStr ? parseInt(countStr, 10) : commits;
+  const diff = runGit(['diff', '--shortstat', `HEAD~${Math.min(revCount, 50)}..HEAD`], projectPath);
+
+  if (diff) {
+    const filesMatch = diff.match(/(\d+) file/);
+    const files = filesMatch ? parseInt(filesMatch[1]) : '?';
+    return `${commits} commit${commits !== 1 ? 's' : ''}, ${files} archivo${files !== 1 ? 's' : ''} cambiados`;
+  }
+  return `${commits} commit${commits !== 1 ? 's' : ''}`;
+}
+
+// ─── Codificación de rutas para entradas de memoria ───────────────────────────
+
+export function encodeProjectPath(absolutePath) {
+  // "/Users/ana/dev/app" -> "-Users-ana-dev-app"
+  return absolutePath.replace(/\//g, '-');
+}
+
+export function sessionMemoryDir(absolutePath) {
+  const encoded = encodeProjectPath(absolutePath);
+  return resolve(CK_HOME, 'memoria', encoded);
+}
+
+// ─── Renderizado ──────────────────────────────────────────────────────────────
+
+/** Renderiza el CONTEXT.md legible por humanos a partir de context.json */
+export function renderContextMd(ctx) {
+  const latest = ctx.sessions?.[ctx.sessions.length - 1] || null;
+  const lines = [
+    `<!-- Generado por memoria-por-proyecto v2 — edita context.json, no este archivo -->`,
+    `# Proyecto: ${ctx.displayName ?? ctx.name}`,
+    `> Ruta: ${ctx.path}`,
+  ];
+  if (ctx.repo) lines.push(`> Repo: ${ctx.repo}`);
+  const sessionCount = ctx.sessions?.length || 0;
+  lines.push(`> Última sesión: ${ctx.sessions?.[sessionCount - 1]?.date || 'nunca'} | Sesiones: ${sessionCount}`);
+  lines.push(``);
+  lines.push(`## Qué es`);
+  lines.push(ctx.description || '_Sin definir._');
+  lines.push(``);
+  lines.push(`## Stack tecnológico`);
+  lines.push(Array.isArray(ctx.stack) ? ctx.stack.join(', ') : (ctx.stack || '_Sin definir._'));
+  lines.push(``);
+  lines.push(`## Objetivo actual`);
+  lines.push(ctx.goal || '_Sin definir._');
+  lines.push(``);
+  lines.push(`## Dónde quedé`);
+  lines.push(latest?.leftOff || '_Aún sin registrar. Ejecuta /memoria:guardar tras tu primera sesión._');
+  lines.push(``);
+  lines.push(`## Próximos pasos`);
+  if (latest?.nextSteps?.length) {
+    latest.nextSteps.forEach((s, i) => lines.push(`${i + 1}. ${s}`));
+  } else {
+    lines.push(`_Aún sin registrar._`);
+  }
+  lines.push(``);
+  lines.push(`## Bloqueos`);
+  if (latest?.blockers?.length) {
+    latest.blockers.forEach(b => lines.push(`- ${b}`));
+  } else {
+    lines.push(`- Ninguno`);
+  }
+  lines.push(``);
+  lines.push(`## No hacer`);
+  if (ctx.constraints?.length) {
+    ctx.constraints.forEach(c => lines.push(`- ${c}`));
+  } else {
+    lines.push(`- Nada especificado`);
+  }
+  lines.push(``);
+
+  // Todas las decisiones de todas las sesiones
+  const allDecisions = (ctx.sessions || []).flatMap(s =>
+    (s.decisions || []).map(d => ({ ...d, date: s.date }))
+  );
+  lines.push(`## Decisiones tomadas`);
+  lines.push(`| Decisión | Por qué | Fecha |`);
+  lines.push(`|----------|---------|-------|`);
+  if (allDecisions.length) {
+    allDecisions.forEach(d => lines.push(`| ${d.what} | ${d.why || ''} | ${d.date || ''} |`));
+  } else {
+    lines.push(`| _(ninguna aún)_ | | |`);
+  }
+  lines.push(``);
+
+  // Historial de sesiones (la más reciente primero)
+  if (ctx.sessions?.length > 1) {
+    lines.push(`## Historial de sesiones`);
+    const reversed = [...ctx.sessions].reverse();
+    reversed.forEach(s => {
+      lines.push(`### ${s.date} — ${s.summary || 'Sesión'}`);
+      if (s.gitActivity) lines.push(`_${s.gitActivity}_`);
+      if (s.leftOff) lines.push(`**Quedé en:** ${s.leftOff}`);
+    });
+    lines.push(``);
+  }
+
+  return lines.join('\n');
+}
+
+/** Renderiza la caja de briefing con bordes que usa /memoria:reanudar */
+export function renderBriefingBox(ctx, _meta = {}) {
+  const latest = ctx.sessions?.[ctx.sessions.length - 1] || {};
+  const W = 57;
+  const pad = (str, w) => {
+    const s = String(str || '');
+    return s.length > w ? s.slice(0, w - 1) + '…' : s.padEnd(w);
+  };
+  const row = (label, value) => `│  ${label} → ${pad(value, W - label.length - 7)}│`;
+
+  const when = daysAgoLabel(ctx.sessions?.[ctx.sessions.length - 1]?.date);
+  const sessions = ctx.sessions?.length || 0;
+  const shortSessId = latest.id?.slice(0, 8) || null;
+
+  const lines = [
+    `┌${'─'.repeat(W)}┐`,
+    `│  RETOMANDO: ${pad(ctx.displayName ?? ctx.name, W - 13)}│`,
+    `│  Última sesión: ${pad(`${when}  |  Sesiones: ${sessions}`, W - 17)}│`,
+  ];
+  if (shortSessId) lines.push(`│  ID de sesión: ${pad(shortSessId, W - 16)}│`);
+  lines.push(`├${'─'.repeat(W)}┤`);
+  lines.push(row('QUÉ ES    ', ctx.description || '—'));
+  lines.push(row('STACK     ', Array.isArray(ctx.stack) ? ctx.stack.join(', ') : (ctx.stack || '—')));
+  lines.push(row('RUTA      ', ctx.path));
+  if (ctx.repo) lines.push(row('REPO      ', ctx.repo));
+  lines.push(row('OBJETIVO  ', ctx.goal || '—'));
+  lines.push(`├${'─'.repeat(W)}┤`);
+  lines.push(`│  DÓNDE QUEDÉ${' '.repeat(W - 13)}│`);
+  const leftOffLines = (latest.leftOff || '—').split('\n').filter(Boolean);
+  leftOffLines.forEach(l => lines.push(`│    • ${pad(l, W - 7)}│`));
+  lines.push(`├${'─'.repeat(W)}┤`);
+  lines.push(`│  PRÓXIMOS PASOS${' '.repeat(W - 16)}│`);
+  const steps = latest.nextSteps || [];
+  if (steps.length) {
+    steps.forEach((s, i) => lines.push(`│    ${i + 1}. ${pad(s, W - 8)}│`));
+  } else {
+    lines.push(`│    —${' '.repeat(W - 5)}│`);
+  }
+  const blockers = latest.blockers?.length ? latest.blockers.join(', ') : 'Ninguno';
+  lines.push(`│  BLOQUEOS → ${pad(blockers, W - 13)}│`);
+  if (latest.gitActivity) {
+    lines.push(`│  GIT      → ${pad(latest.gitActivity, W - 13)}│`);
+  }
+  lines.push(`└${'─'.repeat(W)}┘`);
+  return lines.join('\n');
+}
+
+/** Renderiza el bloque compacto de info que usa /memoria:info */
+export function renderInfoBlock(ctx) {
+  const latest = ctx.sessions?.[ctx.sessions.length - 1] || {};
+  const sep = '─'.repeat(44);
+  const lines = [
+    `memoria: ${ctx.displayName ?? ctx.name}`,
+    sep,
+  ];
+  lines.push(`RUTA     ${ctx.path}`);
+  if (ctx.repo) lines.push(`REPO     ${ctx.repo}`);
+  if (latest.id) lines.push(`SESIÓN   ${latest.id.slice(0, 8)}`);
+  lines.push(`OBJETIVO ${ctx.goal || '—'}`);
+  lines.push(sep);
+  lines.push(`DÓNDE QUEDÉ`);
+  (latest.leftOff || '—').split('\n').filter(Boolean).forEach(l => lines.push(`  • ${l}`));
+  lines.push(`PRÓXIMOS PASOS`);
+  (latest.nextSteps || []).forEach((s, i) => lines.push(`  ${i + 1}. ${s}`));
+  if (!latest.nextSteps?.length) lines.push(`  —`);
+  lines.push(`BLOQUEOS`);
+  if (latest.blockers?.length) {
+    latest.blockers.forEach(b => lines.push(`  • ${b}`));
+  } else {
+    lines.push(`  • Ninguno`);
+  }
+  return lines.join('\n');
+}
+
+/** Renderiza la tabla ASCII que usa /memoria:lista */
+export function renderListTable(entries, cwd, _todayStr) {
+  // entries: [{name, contextDir, path, context, lastUpdated}]
+  // Ordenadas alfabéticamente por contextDir antes de llamar
+  const rows = entries.map((e, i) => {
+    const isHere = e.path === cwd;
+    const latest = e.context?.sessions?.[e.context.sessions.length - 1] || {};
+    const when = daysAgoLabel(latest.date);
+    const icon = stalenessIcon(latest.date);
+    const statusLabel = icon === '●' ? '● Activo' : icon === '◐' ? '◐ Tibio' : '○ Frío';
+    const sessId = latest.id ? latest.id.slice(0, 8) : '—';
+    const summary = (latest.summary || '—').slice(0, 34);
+    const displayName = ((e.context?.displayName ?? e.name) + (isHere ? ' <-' : '')).slice(0, 18);
+    return {
+      num: String(i + 1),
+      name: displayName,
+      status: statusLabel,
+      when: when.slice(0, 12),
+      sessId,
+      summary,
+    };
+  });
+
+  const cols = {
+    num:     Math.max(1, ...rows.map(r => r.num.length)),
+    name:    Math.max(8, ...rows.map(r => r.name.length)),
+    status:  Math.max(6, ...rows.map(r => r.status.length)),
+    when:    Math.max(10, ...rows.map(r => r.when.length)),
+    sessId:  Math.max(6, ...rows.map(r => r.sessId.length)),
+    summary: Math.max(14, ...rows.map(r => r.summary.length)),
+  };
+
+  const hr = `+${'-'.repeat(cols.num + 2)}+${'-'.repeat(cols.name + 2)}+${'-'.repeat(cols.status + 2)}+${'-'.repeat(cols.when + 2)}+${'-'.repeat(cols.sessId + 2)}+${'-'.repeat(cols.summary + 2)}+`;
+  const cell = (val, width) => ` ${val.padEnd(width)} `;
+  const headerRow = `|${cell('#', cols.num)}|${cell('Proyecto', cols.name)}|${cell('Estado', cols.status)}|${cell('Visto hace', cols.when)}|${cell('Sesión', cols.sessId)}|${cell('Último resumen', cols.summary)}|`;
+
+  const dataRows = rows.map(r =>
+    `|${cell(r.num, cols.num)}|${cell(r.name, cols.name)}|${cell(r.status, cols.status)}|${cell(r.when, cols.when)}|${cell(r.sessId, cols.sessId)}|${cell(r.summary, cols.summary)}|`
+  );
+
+  return [hr, headerRow, hr, ...dataRows, hr].join('\n');
+}

package/vendor/theus-arsenal/skills/memoria-por-proyecto/hooks/session-start.mjs

@@ -0,0 +1,238 @@
+#!/usr/bin/env node
+/**
+ * memoria-por-proyecto (ck) v2
+ * session-start.mjs — inyecta un contexto compacto del proyecto al iniciar la sesión.
+ *
+ * Inyecta ~100 tokens (no ~2.500 como la v1).
+ * El SKILL.md se inyecta por separado (sigue siendo pequeño, ~50 líneas).
+ *
+ * Funciones:
+ * - Resumen compacto de 5 líneas para proyectos registrados
+ * - Detección de sesión sin guardar → "La última sesión no se guardó. Ejecuta /memoria:guardar."
+ * - Actividad de git desde la última sesión
+ * - Detección de desajuste de objetivo frente a AGENTS.md
+ * - Mini portafolio para directorios no registrados
+ */
+
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+import { spawnSync } from 'child_process';
+import { createRequire } from 'module';
+
+// El estado persistente vive SIEMPRE bajo la raíz de datos del agente
+// (~/.theus/arsenal por defecto; configurable con THEUS_AGENT_DATA_HOME).
+const require = createRequire(import.meta.url);
+let resolveAgentDataHome;
+try {
+  ({ resolveAgentDataHome } = require('../../../scripts/lib/agent-data-home.js'));
+} catch {
+  // Respaldo si el script se ejecuta fuera del árbol del plugin
+  resolveAgentDataHome = () => resolve(homedir(), '.theus', 'arsenal');
+}
+
+const MODULE_DIR      = dirname(fileURLToPath(import.meta.url));
+const CK_HOME         = resolve(resolveAgentDataHome(), 'ck');
+const PROJECTS_FILE   = resolve(CK_HOME, 'projects.json');
+const CURRENT_SESSION = resolve(CK_HOME, 'current-session.json');
+const SKILL_FILE      = resolve(MODULE_DIR, '..', 'SKILL.md');
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+function readJson(p) {
+  try { return JSON.parse(readFileSync(p, 'utf8')); } catch { return null; }
+}
+
+function daysAgo(dateStr) {
+  if (!dateStr) return 'desconocido';
+  const diff = Math.floor((Date.now() - new Date(dateStr)) / 86_400_000);
+  if (diff === 0) return 'hoy';
+  if (diff === 1) return 'hace 1 día';
+  return `hace ${diff} días`;
+}
+
+function stalenessIcon(dateStr) {
+  if (!dateStr) return '○';
+  const diff = Math.floor((Date.now() - new Date(dateStr)) / 86_400_000);
+  return diff < 1 ? '●' : diff <= 5 ? '◐' : '○';
+}
+
+function gitLogSince(projectPath, sinceDate) {
+  if (!sinceDate || !existsSync(resolve(projectPath, '.git'))) return null;
+  try {
+    const result = spawnSync(
+      'git',
+      ['-C', projectPath, 'log', '--oneline', `--since=${sinceDate}`],
+      { timeout: 3000, stdio: 'pipe', encoding: 'utf8' },
+    );
+    if (result.status !== 0) return null;
+    const output = result.stdout.trim();
+    const commits = output.split('\n').filter(Boolean).length;
+    return commits > 0 ? `${commits} commit${commits !== 1 ? 's' : ''} desde la última sesión` : null;
+  } catch { return null; }
+}
+
+function extractAgentsMdGoal(projectPath) {
+  const p = resolve(projectPath, 'AGENTS.md');
+  if (!existsSync(p)) return null;
+  try {
+    const md = readFileSync(p, 'utf8');
+    const m = md.match(/## (?:Objetivo actual|Current Goal)\n([\s\S]*?)(?=\n## |$)/);
+    return m ? m[1].trim().split('\n')[0].trim() : null;
+  } catch { return null; }
+}
+
+// ─── ID de sesión desde stdin ─────────────────────────────────────────────────
+
+function readSessionId() {
+  try {
+    const raw = readFileSync(0, 'utf8');
+    return JSON.parse(raw).session_id || null;
+  } catch { return null; }
+}
+
+// ─── Principal ────────────────────────────────────────────────────────────────
+
+function main() {
+  const cwd = process.env.PWD || process.cwd();
+  const sessionId = readSessionId();
+
+  // Carga el skill (se inyecta siempre — ahora solo ~50 líneas)
+  const skill = existsSync(SKILL_FILE) ? readFileSync(SKILL_FILE, 'utf8') : '';
+
+  const projects = readJson(PROJECTS_FILE) || {};
+  const entry = projects[cwd];
+
+  // Lee la sesión anterior ANTES de sobrescribir current-session.json
+  const prevSession = readJson(CURRENT_SESSION);
+
+  // Escribe current-session.json
+  try {
+    writeFileSync(CURRENT_SESSION, JSON.stringify({
+      sessionId,
+      projectPath: cwd,
+      projectName: entry?.name || null,
+      startedAt: new Date().toISOString(),
+    }, null, 2), 'utf8');
+  } catch { /* no fatal */ }
+
+  const parts = [];
+  if (skill) parts.push(skill);
+
+  // ── PROYECTO REGISTRADO ─────────────────────────────────────────────────────
+  if (entry?.contextDir) {
+    const contextFile = resolve(CK_HOME, 'contexts', entry.contextDir, 'context.json');
+    const context = readJson(contextFile);
+
+    if (context) {
+      const latest = context.sessions?.[context.sessions.length - 1] || {};
+      const sessionDate = latest.date || context.createdAt;
+      const sessionCount = context.sessions?.length || 0;
+      const displayName = context.displayName ?? context.name;
+
+      // ── Bloque de resumen compacto (~100 tokens) ─────────────────────────
+      const summaryLines = [
+        `memoria: ${displayName} | ${daysAgo(sessionDate)} | ${sessionCount} sesión${sessionCount !== 1 ? 'es' : ''}`,
+        `Objetivo: ${context.goal || '—'}`,
+        latest.leftOff ? `Quedé en: ${latest.leftOff.split('\n')[0]}` : null,
+        latest.nextSteps?.length ? `Siguiente: ${latest.nextSteps.slice(0, 2).join(' · ')}` : null,
+      ].filter(Boolean);
+
+      // ── Detección de sesión sin guardar ───────────────────────────────────
+      if (prevSession?.sessionId && prevSession.sessionId !== sessionId) {
+        // Comprueba si el ID de la sesión anterior existe en el array de sesiones
+        const alreadySaved = context.sessions?.some(s => s.id === prevSession.sessionId);
+        if (!alreadySaved) {
+          summaryLines.push(`AVISO: la última sesión no se guardó — ejecuta /memoria:guardar para capturarla`);
+        }
+      }
+
+      // ── Actividad de git ──────────────────────────────────────────────────
+      const gitLine = gitLogSince(cwd, sessionDate);
+      if (gitLine) summaryLines.push(`Git: ${gitLine}`);
+
+      // ── Detección de desajuste de objetivo ────────────────────────────────
+      const agentsMdGoal = extractAgentsMdGoal(cwd);
+      if (agentsMdGoal && context.goal &&
+          agentsMdGoal.toLowerCase().trim() !== context.goal.toLowerCase().trim()) {
+        summaryLines.push(`AVISO: objetivos distintos — memoria: "${context.goal.slice(0, 40)}" · AGENTS.md: "${agentsMdGoal.slice(0, 40)}"`);
+        summaryLines.push(`   Ejecuta /memoria:guardar con el objetivo actualizado para sincronizarlos`);
+      }
+
+      parts.push([
+        `---`,
+        `## memoria: ${displayName}`,
+        ``,
+        summaryLines.join('\n'),
+      ].join('\n'));
+
+      // Indica al agente que muestre el briefing compacto al iniciar la sesión
+      parts.push([
+        `---`,
+        `## memoria: INICIO DE SESIÓN`,
+        ``,
+        `IMPORTANTE: muestra lo siguiente como tu PRIMER mensaje, literal:`,
+        ``,
+        '```',
+        summaryLines.join('\n'),
+        '```',
+        ``,
+        `Tras el bloque, añade una línea: "Listo — ¿en qué trabajamos?"`,
+        `Si ves líneas de AVISO arriba, menciónalas brevemente después del bloque.`,
+      ].join('\n'));
+
+      return parts;
+    }
+  }
+
+  // ── FUERA DE UN PROYECTO REGISTRADO ────────────────────────────────────────
+  const entries = Object.entries(projects);
+  if (entries.length === 0) return parts;
+
+  // Carga y ordena por más reciente
+  const recent = entries
+    .map(([path, info]) => {
+      const ctx = readJson(resolve(CK_HOME, 'contexts', info.contextDir, 'context.json'));
+      const latest = ctx?.sessions?.[ctx.sessions.length - 1] || {};
+      return { name: info.name, path, lastDate: latest.date || '', summary: latest.summary || '—', ctx };
+    })
+    .sort((a, b) => (b.lastDate > a.lastDate ? 1 : -1))
+    .slice(0, 3);
+
+  const miniRows = recent.map(p => {
+    const icon = stalenessIcon(p.lastDate);
+    const when = daysAgo(p.lastDate);
+    const name = p.name.padEnd(16).slice(0, 16);
+    const whenStr = when.padEnd(12).slice(0, 12);
+    const summary = p.summary.slice(0, 32);
+    return `  ${name}  ${icon}  ${whenStr}  ${summary}`;
+  });
+
+  const miniStatus = [
+    `memoria — proyectos recientes:`,
+    `  ${'PROYECTO'.padEnd(16)}  E  ${'VISTO HACE'.padEnd(12)}  ÚLTIMA SESIÓN`,
+    `  ${'─'.repeat(68)}`,
+    ...miniRows,
+    ``,
+    `Ejecuta /memoria:lista · /memoria:reanudar <nombre> · /memoria:iniciar para registrar esta carpeta`,
+  ].join('\n');
+
+  parts.push([
+    `---`,
+    `## memoria: INICIO DE SESIÓN`,
+    ``,
+    `IMPORTANTE: muestra lo siguiente como tu PRIMER mensaje, literal:`,
+    ``,
+    '```',
+    miniStatus,
+    '```',
+  ].join('\n'));
+
+  return parts;
+}
+
+const parts = main();
+if (parts.length > 0) {
+  console.log(JSON.stringify({ additionalContext: parts.join('\n\n---\n\n') }));
+}