theus-cli 0.2.83 → 0.2.84

package/vendor/theus-arsenal/skills/materiales-inversores/SKILL.md

@@ -1,101 +0,0 @@
----
-name: materiales-inversores
-description: Crea y actualiza pitch decks, one-pagers, memos para inversores, postulaciones a aceleradoras, modelos financieros y materiales de levantamiento de capital. Úsala cuando se necesiten documentos para inversores, proyecciones, tablas de uso de fondos, planes de hitos o materiales que deban mantenerse internamente consistentes entre varios activos de fundraising.
----
-
-# Materiales para inversores
-
-Construye materiales dirigidos a inversores que sean consistentes, creíbles y fáciles de defender.
-
-## Cuándo usarla
-
-- Al crear o revisar un pitch deck.
-- Al escribir un memo para inversores o un one-pager.
-- Al construir un modelo financiero, un plan de hitos o una tabla de uso de fondos.
-- Al responder preguntas de postulación a aceleradoras o incubadoras.
-- Al alinear varios documentos de fundraising alrededor de una única fuente de verdad.
-
-## Regla de oro
-
-Todos los materiales para inversores deben ser coherentes entre sí.
-
-Crea o confirma una única fuente de verdad antes de escribir:
-- métricas de tracción
-- supuestos de precios e ingresos
-- tamaño de la ronda e instrumento
-- uso de fondos
-- biografías y cargos del equipo
-- hitos y cronogramas
-
-Si aparecen cifras contradictorias, detente y resuélvelas antes de redactar.
-
-## Flujo de trabajo central
-
-1. Inventaría los hechos canónicos.
-2. Identifica los supuestos faltantes.
-3. Elige el tipo de activo.
-4. Redacta el activo con lógica explícita.
-5. Contrasta cada cifra con la fuente de verdad.
-
-## Guía por tipo de activo
-
-### Pitch deck
-Flujo recomendado:
-1. empresa + cuña de entrada
-2. problema
-3. solución
-4. producto / demo
-5. mercado
-6. modelo de negocio
-7. tracción
-8. equipo
-9. competencia / diferenciación
-10. la petición (ask)
-11. uso de fondos / hitos
-12. anexo
-
-Si se quiere un deck nativo web, combina esta skill con `presentaciones-html`.
-
-### One-pager / memo
-- Explica qué hace la empresa en una sola frase limpia.
-- Muestra el "por qué ahora".
-- Incluye tracción y pruebas concretas al inicio.
-- Haz la petición precisa.
-- Mantén las afirmaciones fáciles de verificar.
-
-### Modelo financiero
-Incluye:
-- supuestos explícitos
-- escenarios pesimista / base / optimista cuando aporten
-- lógica de ingresos limpia, capa por capa
-- gasto vinculado a hitos
-- análisis de sensibilidad cuando la decisión dependa de los supuestos
-
-### Postulaciones a aceleradoras
-- Responde exactamente la pregunta formulada.
-- Prioriza tracción, insight y ventaja del equipo.
-- Evita la grandilocuencia.
-- Mantén las métricas internas consistentes con el deck y el modelo.
-
-## Señales de alerta a evitar
-
-- afirmaciones no verificables
-- dimensionamiento de mercado difuso sin supuestos
-- roles o cargos del equipo inconsistentes
-- matemática de ingresos que no suma con claridad
-- certeza inflada donde los supuestos son frágiles
-
-## Control de calidad
-
-Antes de entregar:
-- cada cifra coincide con la fuente de verdad vigente
-- el uso de fondos y las capas de ingresos suman correctamente
-- los supuestos son visibles, no están enterrados
-- la historia es clara sin lenguaje de hype
-- el activo final es defendible en una reunión con socios del fondo
-
-## Skills relacionadas
-
-- `presentaciones-html`
-- `contacto-inversores`
-- `voz-de-marca`

package/vendor/theus-arsenal/skills/memoria-por-proyecto/SKILL.md

@@ -1,170 +0,0 @@
----
-name: memoria-por-proyecto
-description: Memoria persistente por proyecto gestionada con scripts deterministas de Node.js.
-  Registra proyectos, guarda el estado de cada sesión (con actividad de git) y genera un
-  briefing al retomar el trabajo. Los comandos ejecutan scripts, no prosa — el comportamiento
-  es consistente entre versiones de modelo.
----
-
-# Memoria por proyecto
-
-Eres el asistente de **memoria por proyecto**. Cuando el usuario invoque cualquier comando
-`/memoria:*`, ejecuta el script de Node.js correspondiente y presenta su stdout al usuario
-de forma literal. Los scripts viven en:
-`${THEUS_PLUGIN_ROOT}/skills/memoria-por-proyecto/commands/`.
-
-> **Nota**: Theus ya incluye memoria y knowledge nativos por proyecto (persistidos bajo
-> `~/.theus/knowledge/`). Esta skill es un **método alternativo manual y portable** —
-> útil para llevar un registro estructurado de sesiones, decisiones y próximos pasos que
-> puedes inspeccionar y versionar a mano — no un reemplazo de la memoria nativa del CLI.
-
----
-
-## Distribución de datos
-
-```
-~/.theus/arsenal/ck/
-├── projects.json              ← ruta → {name, contextDir, lastUpdated}
-├── current-session.json       ← sesión en curso (la escribe el hook opcional)
-├── memoria/<ruta-codificada>/ ← una entrada .md por sesión guardada
-└── contexts/<nombre>/
-    ├── context.json           ← FUENTE DE VERDAD (JSON estructurado, v2)
-    └── CONTEXT.md             ← vista generada — no editar a mano
-```
-
-La raíz de datos se resuelve con `scripts/lib/agent-data-home.js` (`~/.theus/arsenal` por
-defecto; configurable con `THEUS_AGENT_DATA_HOME`).
-
----
-
-## Comandos
-
-### `/memoria:iniciar` — registrar un proyecto
-```bash
-node "${THEUS_PLUGIN_ROOT}/skills/memoria-por-proyecto/commands/init.mjs"
-```
-El script emite JSON con la información autodetectada. Preséntala como borrador de confirmación:
-```
-Esto es lo que encontré — confirma o edita lo que quieras:
-Proyecto:     <name>
-Descripción:  <description>
-Stack:        <stack>
-Objetivo:     <goal>
-No hacer:     <constraints o "Ninguno">
-Repo:         <repo o "ninguno">
-```
-Espera la aprobación del usuario. Aplica sus ediciones. Luego canaliza el JSON confirmado a `save.mjs --init`:
-```bash
-echo '<json-confirmado>' | node "${THEUS_PLUGIN_ROOT}/skills/memoria-por-proyecto/commands/save.mjs" --init
-```
-Esquema del JSON confirmado: `{"name":"...","path":"...","description":"...","stack":["..."],"goal":"...","constraints":["..."],"repo":"..."}`
-
----
-
-### `/memoria:guardar` — guardar el estado de la sesión
-**Es el único comando que requiere análisis del modelo.** Analiza la conversación actual:
-- `summary`: una frase, máximo 10 palabras, qué se logró
-- `leftOff`: en qué se estaba trabajando activamente (archivo/funcionalidad/bug concreto)
-- `nextSteps`: array ordenado de próximos pasos concretos
-- `decisions`: array de `{what, why}` con las decisiones tomadas en esta sesión
-- `blockers`: array de bloqueos actuales (array vacío si no hay)
-- `goal`: objetivo actualizado **solo si cambió en esta sesión**; si no, omítelo
-
-Muestra un borrador al usuario: `"Sesión: '<summary>' — ¿la guardo? (sí / editar)"`
-Espera confirmación. Luego canaliza el JSON a `save.mjs`:
-```bash
-echo '<json>' | node "${THEUS_PLUGIN_ROOT}/skills/memoria-por-proyecto/commands/save.mjs"
-```
-Esquema JSON (exacto): `{"summary":"...","leftOff":"...","nextSteps":["..."],"decisions":[{"what":"...","why":"..."}],"blockers":["..."]}`
-Muestra la confirmación de stdout del script de forma literal.
-
----
-
-### `/memoria:reanudar [nombre|número]` — briefing completo
-```bash
-node "${THEUS_PLUGIN_ROOT}/skills/memoria-por-proyecto/commands/resume.mjs" [arg]
-```
-Muestra la salida literal. Después pregunta: "¿Continuamos desde aquí? ¿O algo cambió?"
-Si el usuario reporta cambios → ejecuta `/memoria:guardar` de inmediato.
-
----
-
-### `/memoria:info [nombre|número]` — instantánea rápida
-```bash
-node "${THEUS_PLUGIN_ROOT}/skills/memoria-por-proyecto/commands/info.mjs" [arg]
-```
-Muestra la salida literal. Sin pregunta de seguimiento.
-
----
-
-### `/memoria:lista` — vista de portafolio
-```bash
-node "${THEUS_PLUGIN_ROOT}/skills/memoria-por-proyecto/commands/list.mjs"
-```
-Muestra la salida literal. Si el usuario responde con un número o nombre → ejecuta `/memoria:reanudar`.
-
----
-
-### `/memoria:olvidar [nombre|número]` — eliminar un proyecto
-Primero resuelve el nombre del proyecto (ejecuta `/memoria:lista` si hace falta).
-Pregunta: `"Esto eliminará permanentemente el contexto de '<nombre>'. ¿Estás seguro? (sí/no)"`
-Si la respuesta es sí:
-```bash
-node "${THEUS_PLUGIN_ROOT}/skills/memoria-por-proyecto/commands/forget.mjs" [nombre]
-```
-Muestra la confirmación literal.
-
----
-
-### `/memoria:migrar` — convertir datos v1 a v2
-```bash
-node "${THEUS_PLUGIN_ROOT}/skills/memoria-por-proyecto/commands/migrate.mjs"
-```
-Para una simulación previa:
-```bash
-node "${THEUS_PLUGIN_ROOT}/skills/memoria-por-proyecto/commands/migrate.mjs" --dry-run
-```
-Muestra la salida literal. Migra todos los CONTEXT.md + meta.json v1 (formato de la
-herramienta original, con encabezados en inglés) a context.json v2.
-Los originales se respaldan como `meta.json.v1-backup` — no se borra nada.
-
----
-
-## Hook SessionStart (opcional, no registrado por defecto)
-
-El hook `${THEUS_PLUGIN_ROOT}/skills/memoria-por-proyecto/hooks/session-start.mjs` puede
-registrarse en tu `hooks/hooks.json` para cargar automáticamente el contexto del proyecto
-al iniciar cada sesión. Es **opt-in**: esta skill no lo registra por ti.
-
-```json
-{
-  "hooks": {
-    "SessionStart": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${THEUS_PLUGIN_ROOT}/skills/memoria-por-proyecto/hooks/session-start.mjs\""
-          }
-        ],
-        "description": "memoria-por-proyecto: inyecta el contexto del proyecto al iniciar la sesión"
-      }
-    ]
-  }
-}
-```
-
-El hook recibe JSON por stdin (usa `session_id`), emite `additionalContext` por stdout e
-inyecta ~100 tokens por sesión (resumen compacto de 5 líneas). Además detecta sesiones sin
-guardar, actividad de git desde el último guardado y desajustes de objetivo frente a
-`AGENTS.md`. Sin el hook, la skill funciona igual: simplemente ejecuta `/memoria:reanudar`
-al empezar a trabajar.
-
----
-
-## Reglas
-
-- Los comandos no distinguen mayúsculas: `/MEMORIA:GUARDAR`, `/memoria:guardar` y `/Memoria:Guardar` funcionan igual.
-- Si un script termina con código 1, muestra su stdout como mensaje de error.
-- Nunca edites `context.json` ni `CONTEXT.md` directamente — usa siempre los scripts.
-- Si `projects.json` está malformado, avisa al usuario y ofrécele restablecerlo a `{}`.

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

@@ -1,44 +0,0 @@
-#!/usr/bin/env node
-/**
- * memoria-por-proyecto (ck) v2
- * forget.mjs — elimina el contexto de un proyecto y su entrada del registro
- *
- * Uso: node forget.mjs [nombre|número]
- * stdout: confirmación o error
- * exit 0: éxito  exit 1: no encontrado
- *
- * Nota: SKILL.md indica al agente preguntar "¿Estás seguro?" antes de llamar a este script.
- * Este script es el paso que ejecuta — aquí no hay confirmación.
- */
-
-import { rmSync } from 'fs';
-import { resolve } from 'path';
-import { resolveContext, readProjects, writeProjects, CONTEXTS_DIR } 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}`);
-  process.exit(1);
-}
-
-const { name, contextDir, projectPath } = resolved;
-
-// Elimina el directorio de contexto
-const contextDirPath = resolve(CONTEXTS_DIR, contextDir);
-try {
-  rmSync(contextDirPath, { recursive: true, force: true });
-} catch (e) {
-  console.log(`memoria: no se pudo eliminar el directorio de contexto — ${e.message}`);
-  process.exit(1);
-}
-
-// Elimina la entrada de projects.json
-const projects = readProjects();
-delete projects[projectPath];
-writeProjects(projects);
-
-console.log(`✓ Contexto de '${name}' eliminado.`);

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

@@ -1,24 +0,0 @@
-#!/usr/bin/env node
-/**
- * memoria-por-proyecto (ck) v2
- * info.mjs — instantánea rápida de solo lectura del contexto
- *
- * Uso: node info.mjs [nombre|número]
- * stdout: bloque compacto de información
- * exit 0: éxito  exit 1: no encontrado
- */
-
-import { resolveContext, renderInfoBlock } 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);
-}
-
-console.log('');
-console.log(renderInfoBlock(resolved.context));

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

@@ -1,152 +0,0 @@
-#!/usr/bin/env node
-/**
- * memoria-por-proyecto (ck) v2
- * init.mjs — autodetecta la información del proyecto y emite JSON para que el agente lo confirme
- *
- * Uso: node init.mjs
- * stdout: JSON con la información autodetectada del proyecto
- * exit 0: éxito  exit 1: error
- */
-
-import { readFileSync, existsSync } from 'fs';
-import { resolve, basename } from 'path';
-import { readProjects } from './shared.mjs';
-
-const cwd = process.env.PWD || process.cwd();
-const projects = readProjects();
-
-const output = {
-  path: cwd,
-  name: null,
-  description: null,
-  stack: [],
-  goal: null,
-  constraints: [],
-  repo: null,
-  alreadyRegistered: !!projects[cwd],
-};
-
-function readFile(filename) {
-  const p = resolve(cwd, filename);
-  if (!existsSync(p)) return null;
-  try { return readFileSync(p, 'utf8'); } catch { return null; }
-}
-
-function extractSection(md, heading) {
-  const re = new RegExp(`## ${heading}\\n([\\s\\S]*?)(?=\\n## |$)`);
-  const m = md.match(re);
-  return m ? m[1].trim() : null;
-}
-
-// Prueba varios encabezados (español primero, inglés como respaldo)
-function extractSectionAny(md, headings) {
-  for (const h of headings) {
-    const section = extractSection(md, h);
-    if (section) return section;
-  }
-  return null;
-}
-
-// ── package.json ──────────────────────────────────────────────────────────────
-const pkg = readFile('package.json');
-if (pkg) {
-  try {
-    const parsed = JSON.parse(pkg);
-    if (parsed.name && !output.name) output.name = parsed.name;
-    if (parsed.description && !output.description) output.description = parsed.description;
-
-    // Detecta el stack a partir de las dependencias
-    const deps = Object.keys({ ...(parsed.dependencies || {}), ...(parsed.devDependencies || {}) });
-    const stackMap = {
-      next: 'Next.js', react: 'React', vue: 'Vue', svelte: 'Svelte', astro: 'Astro',
-      express: 'Express', fastify: 'Fastify', hono: 'Hono', nestjs: 'NestJS',
-      typescript: 'TypeScript', prisma: 'Prisma', drizzle: 'Drizzle',
-      '@neondatabase/serverless': 'Neon', '@upstash/redis': 'Upstash Redis',
-      '@clerk/nextjs': 'Clerk', stripe: 'Stripe', tailwindcss: 'Tailwind CSS',
-    };
-    for (const [dep, label] of Object.entries(stackMap)) {
-      if (deps.includes(dep) && !output.stack.includes(label)) {
-        output.stack.push(label);
-      }
-    }
-    if (deps.includes('typescript') || existsSync(resolve(cwd, 'tsconfig.json'))) {
-      if (!output.stack.includes('TypeScript')) output.stack.push('TypeScript');
-    }
-  } catch { /* package.json malformado */ }
-}
-
-// ── go.mod ────────────────────────────────────────────────────────────────────
-const goMod = readFile('go.mod');
-if (goMod) {
-  if (!output.stack.includes('Go')) output.stack.push('Go');
-  const modName = goMod.match(/^module\s+(\S+)/m)?.[1];
-  if (modName && !output.name) output.name = modName.split('/').pop();
-}
-
-// ── Cargo.toml ────────────────────────────────────────────────────────────────
-const cargo = readFile('Cargo.toml');
-if (cargo) {
-  if (!output.stack.includes('Rust')) output.stack.push('Rust');
-  const crateName = cargo.match(/^name\s*=\s*"(.+?)"/m)?.[1];
-  if (crateName && !output.name) output.name = crateName;
-}
-
-// ── pyproject.toml ────────────────────────────────────────────────────────────
-const pyproject = readFile('pyproject.toml');
-if (pyproject) {
-  if (!output.stack.includes('Python')) output.stack.push('Python');
-  const pyName = pyproject.match(/^name\s*=\s*"(.+?)"/m)?.[1];
-  if (pyName && !output.name) output.name = pyName;
-}
-
-// ── .git/config (URL del repo) ────────────────────────────────────────────────
-const gitConfig = readFile('.git/config');
-if (gitConfig) {
-  const repoMatch = gitConfig.match(/url\s*=\s*(.+)/);
-  if (repoMatch) output.repo = repoMatch[1].trim();
-}
-
-// ── AGENTS.md ─────────────────────────────────────────────────────────────────
-const agentsMd = readFile('AGENTS.md');
-if (agentsMd) {
-  const goal = extractSectionAny(agentsMd, ['Objetivo actual', 'Current Goal']);
-  if (goal && !output.goal) output.goal = goal.split('\n')[0].trim();
-
-  const doNot = extractSectionAny(agentsMd, ['No hacer', 'Do Not Do']);
-  if (doNot) {
-    const bullets = doNot.split('\n')
-      .filter(l => /^[-*]\s+/.test(l))
-      .map(l => l.replace(/^[-*]\s+/, '').trim());
-    output.constraints = bullets;
-  }
-
-  const stack = extractSectionAny(agentsMd, ['Stack tecnológico', 'Tech Stack']);
-  if (stack && output.stack.length === 0) {
-    output.stack = stack.split(/[,\n]/).map(s => s.replace(/^[-*]\s+/, '').trim()).filter(Boolean);
-  }
-
-  // Descripción a partir de la primera sección o "Qué es"
-  const whatItIs = extractSectionAny(agentsMd, ['Qué es', 'What This Is', 'About', 'Acerca de']);
-  if (whatItIs && !output.description) output.description = whatItIs.split('\n')[0].trim();
-}
-
-// ── README.md (respaldo para la descripción) ─────────────────────────────────
-const readme = readFile('README.md');
-if (readme && !output.description) {
-  // Primer párrafo no vacío que no sea encabezado, badge ni cita
-  const lines = readme.split('\n');
-  for (const line of lines) {
-    const trimmed = line.trim();
-    if (trimmed && !trimmed.startsWith('#') && !trimmed.startsWith('!') && !trimmed.startsWith('>') && !trimmed.startsWith('[') && trimmed !== '---' && trimmed !== '___') {
-      output.description = trimmed.slice(0, 120);
-      break;
-    }
-  }
-}
-
-// ── Respaldo del nombre: nombre del directorio ────────────────────────────────
-if (!output.name) {
-  output.name = basename(cwd).toLowerCase().replace(/\s+/g, '-');
-}
-
-console.log(JSON.stringify(output, null, 2));

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

@@ -1,40 +0,0 @@
-#!/usr/bin/env node
-/**
- * memoria-por-proyecto (ck) v2
- * list.mjs — vista de portafolio de todos los proyectos registrados
- *
- * Uso: node list.mjs
- * stdout: tabla ASCII de todos los proyectos + invitación a reanudar
- * exit 0: éxito  exit 1: sin proyectos
- */
-
-import { readProjects, loadContext, today, renderListTable } from './shared.mjs';
-
-const cwd = process.env.PWD || process.cwd();
-const projects = readProjects();
-const entries = Object.entries(projects);
-
-if (entries.length === 0) {
-  console.log('No hay proyectos registrados. Ejecuta /memoria:iniciar para empezar.');
-  process.exit(1);
-}
-
-// Construye la lista enriquecida ordenada alfabéticamente por contextDir
-const enriched = entries
-  .map(([path, info]) => {
-    const context = loadContext(info.contextDir);
-    return {
-      name: info.name,
-      contextDir: info.contextDir,
-      path,
-      context,
-      lastUpdated: info.lastUpdated,
-    };
-  })
-  .sort((a, b) => a.contextDir.localeCompare(b.contextDir));
-
-const table = renderListTable(enriched, cwd, today());
-console.log('');
-console.log(table);
-console.log('');
-console.log('¿Cuál reanudamos? (número o nombre)');