theus-cli-linux-arm64 0.2.84

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

@@ -0,0 +1,101 @@
+---
+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

@@ -0,0 +1,170 @@
+---
+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

@@ -0,0 +1,44 @@
+#!/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

@@ -0,0 +1,24 @@
+#!/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

@@ -0,0 +1,152 @@
+#!/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

@@ -0,0 +1,40 @@
+#!/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)');