@kikedealba/recap 0.10.0 → 0.11.1

package/README.md

@@ -37,9 +37,14 @@ Requisitos: Node 24 o superior, ffmpeg, whisper.cpp (`whisper-cli`) y
   `start`, `stop`, `cancel` y `amend` de las entradas `remote-meeting` e
   `in-person-meeting`. Reemplaza al viejo `bita hooks add` y quita ese hook si
   lo encuentra, para que no se dispare dos veces;
-- instala la skill y los comandos en los agentes que encuentre: Claude Code,
-  opencode, Codex y Gemini CLI (`--agents codex,gemini`, `--agents all` o
-  `--agents none`). Si el plugin de Claude Code ya está instalado, no lo duplica.
+- en Claude Code agrega o actualiza el marketplace `KikeDeAlba/recap` e instala
+  o actualiza el plugin `recap@recap` (`claude plugin marketplace add|update` y
+  `claude plugin install|update --scope user`), así el plugin queda en la misma
+  versión que la CLI; también quita los archivos sueltos que versiones viejas
+  dejaron en `~/.claude`;
+- en opencode, Codex y Gemini CLI instala la skill y las skills de usuario en el
+  formato de cada uno (`--agents codex,gemini`, `--agents all` o
+  `--agents none`).
 
 En Windows y Linux `recap start` falla con `CAPTURE_UNAVAILABLE`: graba con la
 app que quieras y procesa el archivo con
@@ -133,26 +138,47 @@ recap prompt <meeting>                 # print the summary prompt with transcrip
 recap save-summary <meeting> file.md   # store minutes written elsewhere
 ```
 
-## Claude Code plugin
+## Plugin de Claude Code
 
-The repository is also a Claude Code plugin marketplace:
+El repositorio también es un marketplace de plugins de Claude Code. `recap setup`
+lo instala y lo mantiene al día; a mano sería:
 
 ```
-/plugin marketplace add KikeDeAlba/recap
-/plugin install recap@recap
+claude plugin marketplace add KikeDeAlba/recap
+claude plugin install recap@recap --scope user
+claude plugin marketplace update recap && claude plugin update recap@recap   # al actualizar la CLI
 ```
 
-| Command | What it does |
-|---|---|
-| `/recap-start [remota\|presencial] [título]` | Starts a recording; infers the mode from the arguments or the conversation and asks when it cannot |
-| `/recap-stop [--wait]` | Stops the recording; with `--wait` it processes in the foreground and shows agreements and action items |
-| `/recap-status` | Shows whether a recording is running and how far processing got |
-| `/recap-list [meeting]` | Lists meetings or shows one meeting's minutes |
-| `/recap-summarize [meeting] [instructions]` | Rewrites the minutes inside the session, following extra instructions, and stores them with `recap save-summary` |
-| `/recap-ask [question]` | Answers the last question of the meeting being recorded, or the one given, from the inkwell pages and the project repositories |
-| `/recap-proposals [meeting]` | Reviews the documentation changes proposed by a meeting and accepts, edits or rejects them |
-
-The `recap` skill lets Claude answer questions such as "¿qué acordamos en la reunión de ayer?" from the stored minutes and transcripts. The commands call `recap`, so it must be on the `PATH` of the shell Claude Code runs.
+Trae tres cosas:
+
+- **La skill `recap`**, que Claude carga sola cuando la conversación trata de
+  reuniones ("¿qué acordamos en la reunión de ayer?"). Es la única fuente del
+  flujo de una reunión; bita y tally enlazan a ella. Lo largo (cierre con bita e
+  inkwell, en vivo, propuestas, espacio) vive en archivos aparte que se leen
+  solo cuando hacen falta.
+- **Skills de usuario** con `disable-model-invocation: true`: no ocupan contexto
+  y solo corren cuando las escribes.
+
+  | Skill | Qué hace |
+  |---|---|
+  | `/recap:recap-start [remota\|presencial] [título]` | Empieza a grabar; saca el modo de los argumentos o de la conversación y pregunta si no puede |
+  | `/recap:recap-stop [--no-wait]` | Para la grabación (por bita si la sigue un cronómetro), espera el procesamiento y muestra el resultado |
+  | `/recap:recap-status` | Dice si se está grabando y en qué va el procesamiento |
+  | `/recap:recap-list [reunión]` | Lista las reuniones o muestra la minuta de una |
+  | `/recap:recap-summarize [reunión] [indicaciones]` | Rehace la minuta dentro de la sesión y la guarda con `recap save-summary` |
+  | `/recap:recap-ask [pregunta]` | Responde la última pregunta de la reunión en curso, o la que le pases, con las páginas de inkwell y los repos del proyecto |
+  | `/recap:recap-proposals [reunión]` | Revisa los cambios a la documentación que propuso una reunión |
+
+- **Un monitor** (`monitors/monitors.json`) que corre `recap watch` en segundo
+  plano en cada sesión interactiva. Revisa las carpetas de reuniones cada 5 s,
+  sin llamar al modelo, y escribe una sola línea cuando una reunión termina de
+  procesarse o falla; esa línea le llega a Claude como notificación. No corre
+  con `claude -p`. Si `recap` no está en el `PATH`, no hace nada. Para apagarlo,
+  define `RECAP_MONITOR=off` en el entorno de Claude Code (por ejemplo en
+  `"env"` de `~/.claude/settings.json`).
+
+Las skills llaman a `recap`, así que tiene que estar en el `PATH` del shell que
+usa Claude Code.
 
 ## Live assistant
 

package/dist/cli/commands/watch.js

@@ -0,0 +1,109 @@
+import { readdirSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { loadConfig, rootDir } from "../../core/config.js";
+import { MEETING_FILE, loadMeeting } from "../../core/meeting.js";
+import { sleep } from "../../core/proc.js";
+import { suffix, trimmed } from "../../core/text.js";
+import { usageError } from "../../errors.js";
+import { parseArgs } from "../args.js";
+import { output } from "../output.js";
+import { failedStage, isSettled } from "./query.js";
+export const WATCH_OPT_OUT = 'RECAP_MONITOR';
+const NOTICE = ' (FYI: act on it only if this session is handling that meeting)';
+export function watchDisabled(env = process.env) {
+    const value = trimmed(env[WATCH_OPT_OUT] ?? '').toLowerCase();
+    return ['0', 'off', 'false', 'no'].includes(value);
+}
+export function describeSettled(meeting, dir) {
+    const failed = failedStage(meeting);
+    const base = { id: meeting.id, title: meeting.title, status: meeting.status, dir };
+    if (meeting.status !== 'processed') {
+        const where = failed ? ` at ${failed[0]}` : '';
+        const reason = suffix(trimmed((failed ? failed[1].error : meeting.error) ?? 'no reason given').replace(/\s+/g, ' '), 200);
+        return { ...base, failed: true, message: `recap: meeting "${meeting.title}" failed${where}: ${reason} (${meeting.id}); run \`recap process ${meeting.id}\` to resume${NOTICE}` };
+    }
+    const parts = [`recap: meeting "${meeting.title}" finished processing (${meeting.id})`, `minutes at ${path.join(dir, 'summary.md')}`];
+    const wrapup = meeting.wrapup;
+    if (wrapup?.pageId !== undefined)
+        parts.push(`inkwell page #${wrapup.pageId}`);
+    if (wrapup && !wrapup.projectResolved)
+        parts.push('project unresolved');
+    return { ...base, failed: false, message: `${parts.join('; ')}${NOTICE}` };
+}
+export class MeetingWatcher {
+    root;
+    seen = new Map();
+    primed = false;
+    constructor(root) {
+        this.root = root;
+    }
+    tick() {
+        let names;
+        try {
+            names = readdirSync(this.root);
+        }
+        catch {
+            names = [];
+        }
+        const events = [];
+        const present = new Set();
+        for (const name of names) {
+            const dir = path.join(this.root, name);
+            let mtimeMs;
+            try {
+                mtimeMs = statSync(path.join(dir, MEETING_FILE)).mtimeMs;
+            }
+            catch {
+                continue;
+            }
+            present.add(name);
+            const before = this.seen.get(name);
+            if (before && before.mtimeMs === mtimeMs)
+                continue;
+            let meeting;
+            try {
+                meeting = loadMeeting(dir);
+            }
+            catch {
+                continue;
+            }
+            const settled = isSettled(meeting);
+            this.seen.set(name, { mtimeMs, settled });
+            const wasSettled = before ? before.settled : !this.primed;
+            if (settled && !wasSettled)
+                events.push(describeSettled(meeting, dir));
+        }
+        for (const name of [...this.seen.keys()])
+            if (!present.has(name))
+                this.seen.delete(name);
+        this.primed = true;
+        return events;
+    }
+}
+export async function watchCommand(argv) {
+    const json = argv.includes('--json');
+    let interval;
+    let root;
+    try {
+        const args = parseArgs(argv, { values: ['interval'], maxPositionals: 0 });
+        interval = args.number('interval') ?? 5;
+        if (interval < 1 || interval > 300)
+            throw usageError('--interval takes seconds between 1 and 300');
+        root = rootDir(loadConfig());
+    }
+    catch (error) {
+        return output('watch', json, () => {
+            throw error;
+        });
+    }
+    if (watchDisabled())
+        return 0;
+    process.stdout.on('error', () => process.exit(0));
+    const watcher = new MeetingWatcher(root);
+    watcher.tick();
+    for (;;) {
+        await sleep(interval * 1000);
+        for (const event of watcher.tick())
+            process.stdout.write(`${json ? JSON.stringify(event) : event.message}\n`);
+    }
+}

package/dist/cli/router.js

@@ -12,6 +12,7 @@ import { proposalsCommand } from "./commands/proposals.js";
 import { listCommand, processCommand, promptCommand, saveSummaryCommand, showCommand, waitCommand } from "./commands/query.js";
 import { discardCommand, importCommand, startCommand, statusCommand, stopCommand } from "./commands/recording.js";
 import { setupCommand } from "./commands/setup.js";
+import { watchCommand } from "./commands/watch.js";
 import { output } from "./output.js";
 async function capabilitiesCommand(argv) {
     return output('capabilities', argv.includes('--json'), async () => {
@@ -42,6 +43,7 @@ const COMMANDS = {
     ask: askCommand,
     proposals: proposalsCommand,
     config: configCommand,
+    watch: watchCommand,
     'live-worker': liveWorkerCommand,
     capabilities: capabilitiesCommand,
 };
@@ -64,6 +66,7 @@ export function help() {
         '  recap proposals ls|show|accept|reject <meeting> [n] [--bita-entry id] [--md file]',
         '  recap compress-video <meeting> --preset light|medium|max | strip-video <meeting> | prune <meeting> --intermediates | delete <meeting>',
         '  recap config get [key] | config set <key> <value>',
+        '  recap watch [--interval s]: one line per meeting that finishes processing; RECAP_MONITOR=off turns it off',
         '  recap setup [--install-deps] [--skip-models] [--skip-permissions] [--skip-bita] [--skip-app] [--agents detected|all|none|claude,opencode,codex,gemini]',
         '  recap capabilities',
         '',

package/dist/setup/integration.js

@@ -3,9 +3,6 @@ import path from 'node:path';
 import { agents } from '@kikedealba/kit';
 import { defineManifest, isInstalled, readManifest, registerTool } from '@kikedealba/kit/registry';
 import { bitaCommand } from "../bita/client.js";
-import { readText } from "../core/fsutil.js";
-import { isRecord } from "../core/json.js";
-import { home } from "../core/paths.js";
 import { stableCommand } from "../core/self.js";
 import { HOOK_EVENTS, MEETING_KINDS } from "../bita/hook.js";
 import { PACKAGE_ROOT, VERSION } from "../version.js";
@@ -47,24 +44,29 @@ export async function bitaLinked(config) {
         return false;
     return (await bitaCommand(config)) !== null;
 }
-export function commandSources() {
-    const dir = path.join(PACKAGE_ROOT, 'commands');
+export const MAIN_SKILL = 'recap';
+export const CLAUDE_PLUGIN = { marketplace: 'KikeDeAlba/recap', marketplaceName: 'recap', plugin: 'recap' };
+export function userSkillSources() {
+    const dir = path.join(PACKAGE_ROOT, 'skills');
     let names = [];
     try {
-        names = readdirSync(dir).filter((name) => name.endsWith('.md')).sort();
+        names = readdirSync(dir, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory() && entry.name.startsWith(`${MAIN_SKILL}-`))
+            .map((entry) => entry.name)
+            .sort();
     }
     catch {
         return [];
     }
-    return names.map((name) => ({ name: name.slice(0, -3), file: path.join(dir, name) }));
+    return names.map((name) => ({ name, dir: path.join(dir, name) }));
 }
 export function integration() {
     return {
         tool: 'recap',
         version: VERSION,
         description: 'Record meetings and turn them into minutes with recap',
-        skills: [{ name: 'recap', dir: path.join(PACKAGE_ROOT, 'skills', 'recap') }],
-        commands: commandSources(),
+        skills: [{ name: MAIN_SKILL, dir: path.join(PACKAGE_ROOT, 'skills', MAIN_SKILL) }],
+        userSkills: userSkillSources(),
         claude: {
             permissions: {
                 allow: ['Bash(recap status:*)', 'Bash(recap list:*)', 'Bash(recap show:*)', 'Bash(recap wait:*)', 'Bash(recap prompt:*)', 'Bash(recap --version)'],
@@ -72,19 +74,9 @@ export function integration() {
         },
     };
 }
-export function claudePluginInstalled() {
-    const claudeHome = process.env['CLAUDE_CONFIG_DIR'] ?? path.join(home(), '.claude');
-    const text = readText(path.join(claudeHome, 'plugins', 'installed_plugins.json'));
-    if (text === null)
-        return false;
-    try {
-        const value = JSON.parse(text);
-        const plugins = isRecord(value) && isRecord(value['plugins']) ? value['plugins'] : isRecord(value) ? value : {};
-        return Object.keys(plugins).some((key) => key.startsWith('recap@'));
-    }
-    catch {
-        return text.includes('"recap@');
-    }
+export function legacyClaudeIntegration() {
+    const { claude: _permissions, ...base } = integration();
+    return { ...base, commands: (base.userSkills ?? []).map((skill) => ({ name: skill.name, file: path.join(skill.dir, 'SKILL.md') })) };
 }
 export function parseAgents(raw) {
     if (raw === undefined || raw === 'detected')
@@ -97,16 +89,19 @@ export function parseAgents(raw) {
         throw new Error(`Unknown agent ${invalid.join(', ')}; use ${agents.AGENTS.join(', ')}, detected, all or none`);
     return wanted;
 }
-export async function installAgents(choice, exec) {
+export async function installAgents(choice, options = {}) {
     if (choice === 'none')
         return [];
-    let list = choice === 'detected' ? await agents.detectAgents() : choice === 'all' ? [...agents.AGENTS] : choice;
+    const list = choice === 'detected' ? await agents.detectAgents(options.ctx, agents.agentHomes(options.ctx, options.homes), options.locate) : choice === 'all' ? [...agents.AGENTS] : choice;
     const steps = [];
-    if (list.includes('claude') && claudePluginInstalled()) {
-        list = list.filter((agent) => agent !== 'claude');
-        steps.push({ agent: 'claude', item: 'integration', state: 'present', detail: 'the recap plugin for Claude Code is installed; it already carries the skill and commands' });
+    if (list.includes('claude')) {
+        const plugin = await agents.installClaudePlugin(CLAUDE_PLUGIN, options);
+        steps.push(...plugin);
+        if (plugin.every((step) => step.state === 'installed' || step.state === 'present'))
+            steps.push(...(await agents.removeLegacyClaude(legacyClaudeIntegration(), options)));
     }
-    if (list.length === 0)
+    const others = list.filter((agent) => agent !== 'claude');
+    if (others.length === 0)
         return steps;
-    return [...steps, ...(await agents.installIntegration(integration(), { agents: list, ...(exec ? { exec } : {}) }))];
+    return [...steps, ...(await agents.installIntegration(integration(), { ...options, agents: others }))];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kikedealba/recap",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "Meeting recorder CLI: local transcription with whisper.cpp, minutes written by Claude Code, live answers, bita timers and inkwell docs.",
   "license": "MIT",
   "author": "Jesus Enrique De Alba Gaytan",
@@ -35,7 +35,6 @@
     "dist",
     "Resources/*.md",
     "skills",
-    "commands",
     "README.md",
     "LICENSE"
   ],
@@ -50,7 +49,7 @@
     "recap": "node src/bin/recap.ts"
   },
   "dependencies": {
-    "@kikedealba/kit": "^0.2.0"
+    "@kikedealba/kit": "^0.3.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/skills/recap/SKILL.md

@@ -1,26 +1,31 @@
 ---
 name: recap
-description: Graba reuniones con la CLI `recap` y las convierte en minuta (resumen, acuerdos, pendientes y preguntas abiertas). Úsala cuando el usuario quiera empezar o terminar de grabar una reunión, saber si se está grabando, regenerar la minuta, o consultar qué se habló, qué se acordó o qué quedó pendiente en reuniones pasadas. Frases que la disparan: "graba la reunión", "empieza a grabar la junta", "ya terminó la reunión", "para la grabación", "¿se está grabando?", "¿qué acordamos en la reunión de ayer?", "pendientes de la junta con X", "rehaz la minuta".
+description: Graba reuniones con la CLI recap y las vuelve minuta con acuerdos y pendientes. Frases como "graba la reunión", "ya terminó la reunión", "¿se está grabando?", "¿qué acordamos en la reunión de ayer?".
 ---
 
 # recap
 
 `recap` graba reuniones (en macOS, con Recap.app) y las procesa localmente en
-macOS, Windows y Linux. Todo vive en una carpeta por reunión bajo `~/Recap` (o
-la raíz configurada): `meeting.json`, la grabación, `transcript.md`, `frames/` y
+macOS, Windows y Linux. Cada reunión es una carpeta bajo `~/Recap` (o la raíz
+configurada) con `meeting.json`, la grabación, `transcript.md`, `frames/` y
 `summary.md`.
 
-Fuera de macOS no se puede grabar (`start` falla con `CAPTURE_UNAVAILABLE`):
-la reunión se graba con cualquier otra app y se procesa con
-`recap import <archivo> [--title "…"] [--in-person|--remote] --json`.
+Quién hace qué: bita mide el tiempo, recap graba y escribe la minuta, inkwell
+guarda la documentación, tally vuelca el tiempo a Jira y atl habla con Jira y
+Confluence. Este es el único lugar donde se describe el flujo de una reunión;
+las demás herramientas enlazan aquí.
 
 Todos los comandos aceptan `--json` y devuelven un sobre
 `{schemaVersion, ok, command, data, error}`. Usa `--json` siempre que vayas a
 leer el resultado; el texto plano es para mostrarlo tal cual.
 
-## Modos
+Fuera de macOS no se puede grabar (`start` falla con `CAPTURE_UNAVAILABLE`):
+la reunión se graba con otra app y se procesa con
+`recap import <archivo> [--title "…"] [--in-person|--remote] --json`.
 
-Hay que elegir el modo siempre; no tiene valor por defecto.
+## Modo
+
+Hay que elegirlo siempre; no tiene valor por defecto.
 
 | Modo | Flag | Cuándo |
 |---|---|---|
@@ -28,154 +33,49 @@ Hay que elegir el modo siempre; no tiene valor por defecto.
 | Presencial | `--in-person` | En sala, en oficina, en persona, junta física, comida, "aquí con" |
 
 En remota se graba pantalla, audio del sistema y micrófono; en presencial solo
-el micrófono, sin pantalla ni capturas. Si el contexto no deja claro cuál es,
-pregunta con una sola línea ("¿remota o presencial?") antes de arrancar.
-
-## Ciclo
-
-```sh
-recap start --remote "Planeación sprint 42"
-recap status
-recap stop
-```
-
-- `start` falla con `ALREADY_RECORDING` si ya hay una grabación activa: no
-  arranques otra, avísalo.
-- `stop` cierra el archivo y lanza el procesamiento en segundo plano
-  (transcripción, capturas y minuta). Tarda de segundos a unos minutos según la
-  duración. `recap status` y `recap show <id>` dicen en qué etapa va.
-- `recap discard` descarta la grabación activa y borra su carpeta. Solo si el
-  usuario lo pide explícitamente.
-
-## Liberar espacio
-
-Solo si el usuario lo pide; todos aceptan `<id>` o `--bita-entry <id>` y `--json`.
-
-```sh
-recap compress-video <id> --preset light|medium|max   # recomprime el video en HEVC (solo remotas)
-recap strip-video <id>                                 # quita el video y deja recording.m4a con ambas pistas de audio
-recap prune <id> --intermediates                       # borra mic.wav, system.wav, transcript-mic/system.json y live/chunks
-recap delete <id>                                      # borra la carpeta completa de la reunión
-```
-
-`compress-video` y `strip-video` aceptan `--prune-intermediates`. Fallan con
-`NOT_REMOTE` en reuniones presenciales, `NO_VIDEO` si ya no hay video,
-`MEETING_ACTIVE` mientras se graba y `NOT_SMALLER` si la compresión no ahorra
-espacio (el original se conserva). `recap list --json` trae `storage` y
-`hasVideo` de cada reunión.
-
-Errores típicos y qué hacer:
-
-| Código | Causa | Acción |
-|---|---|---|
-| `SCREEN_DENIED` | Recap.app sin permiso de grabación de pantalla | Pide activarlo en Configuración > Privacidad y seguridad > Grabación de pantalla y audio del sistema |
-| `MICROPHONE_DENIED` | Sin permiso de micrófono | Igual, en Micrófono |
-| `RECORDER_TIMEOUT` | Un diálogo de permisos quedó esperando | `recap setup` |
-| `DEPENDENCY_MISSING`, `MODEL_MISSING` | Falta ffmpeg, whisper-cli, claude o el modelo | `recap setup --install-deps` |
-| `CAPTURE_UNAVAILABLE` | No hay grabador en este equipo (Windows, Linux, o falta Recap.app) | Graba con otra app y usa `recap import <archivo>`; en mac, `recap setup` |
-
-## Con bita e inkwell
-
-Cada herramienta hace una sola cosa:
-
-- **bita** lleva el tiempo (cronómetros). recap solo le pide `projects`,
-  `project repo ls`, `entries get` y `amend` (título y proyecto).
-- **inkwell** guarda la documentación: páginas, backlog, propuestas, historial
-  y la nota de cada entrada de bita (`inkwell note …`).
-- **tally** vuelca a Jira el tiempo de bita (`tally summary --pending`); recap
-  no toca Jira.
-
-Si `recap status --json` trae `data.bitaLinked: true` (recap está suscrito a
-los eventos de bita desde `recap setup`), **arranca y para las reuniones desde
-bita**, no desde recap: así el tiempo queda medido y la grabación sigue al
-cronómetro.
-
-```sh
-bita start "<título>" --kind remote-meeting
-bita start "<título>" --kind in-person-meeting
-bita stop <id> --json                 # sin escribir la página: eso lo hace recap
-recap wait --bita-entry <id> --json   # espera a que todo quede listo
-```
-
-Cambiar el título o el proyecto del cronómetro mientras se graba (`bita amend`)
-no corta ni duplica la grabación: recap solo actualiza los datos de la reunión.
-Solo un cambio de tipo (`--kind`) que cruce la línea de reunión la arranca o la
-detiene.
-
-Al parar, recap hace todo lo demás sin que nadie lo pida:
-
-- transcribe y escribe la minuta;
-- le pone al cronómetro un título real, si el que tenía era genérico (`bita amend`);
-- le asigna el proyecto si no tenía y la conversación lo deja claro (`bita amend`);
-- crea la página en inkwell, ligada a la entrada (`inkwell page new --from-entry`),
-  o agrega una sección a la que ya tenía (`inkwell page ls --entry`), y la escribe;
-- pasa pendientes y hallazgos al backlog de inkwell (`inkwell backlog add`);
-- deja la minuta en la sección «Reunión» de la nota de la entrada
-  (`inkwell note save <entrada> --section Reunión --md …`).
-
-El resultado está en `data.wrapup` de `recap wait`. Si `wrapup.projectResolved`
-es false, pregunta el proyecto, aplícalo con `bita amend <id> --project …` y
-mueve la página y el backlog con `inkwell page move --project` e
-`inkwell backlog edit --project`.
-
-**Sin inkwell** la reunión igual queda procesada: las etapas `proposals` y
-`wrapup` quedan en `skipped` con el motivo en `stages.<etapa>.reason` y la pista
-`npm i -g @kikedealba/inkwell && inkwell setup`; la minuta se queda en
-`summary.md` de la carpeta de la reunión. Si inkwell es viejo y no tiene la
-capacidad `docs.entry-notes`, se escribe la página y el backlog pero la minuta
-no pasa a la nota (queda anotado en `process.log`). Después de instalar o
-actualizar inkwell, `recap process <id> --from proposals` lo completa.
-
-## En vivo
-
-Mientras se graba, recap transcribe por tramos de 5 a 20 s en
-`live/transcript.jsonl` (una línea `{startMs, endMs, channel, text}`; `mic` es
-Sala y `system` Remotos). Es aproximada: la transcripción de después del stop
-(`transcript.md`) sigue siendo la fuente de verdad.
-
-Para responder una pregunta que hicieron en la reunión, con las páginas de
-inkwell y los repos del proyecto (`bita project repo ls`); sin inkwell responde
-solo con los repos:
-
-```sh
-recap ask --active --json                              # la última pregunta de la transcripción
-recap ask --active --question "¿cómo se despliega X?" --json
-recap ask --meeting <id> --question "..." --json-stream   # eventos question/progress/delta/source/done
-recap ask --sources --project <p> --json               # qué consultaría, sin llamar a claude
-```
-
-La respuesta lleva `found` y `sources` (página, `archivo:línea` o commit) y se
-guarda en `live/answers.jsonl`. Con `found: false` no está documentado: no lo
-completes por tu cuenta. Se configura con `recap config get|set`
-(`live.enabled`, `live.openWindow`, `live.proposals`, `live.maxChunkSeconds`,
-`live.assistModel`, `live.autoAsk`, `live.autoAskModel`,
-`live.autoAskMinSeconds`).
-
-Con `live.autoAsk` (encendido por omisión), el live-worker detecta solo las
-preguntas técnicas de la reunión y las responde sin que nadie las pida: esas
-respuestas llevan `auto: true` en `live/answers.jsonl`. Mientras se responde
-algo, `live/asking.json` dice qué pregunta va (`{question, startedAt, auto}`);
-solo corre una respuesta a la vez y una manual detiene a la automática.
-
-## Cambios propuestos a la documentación
-
-Si la reunión está ligada a bita e inkwell está instalado, la etapa `proposals`
-(antes de `wrapup`) detecta los cambios explícitos y firmes a páginas de inkwell
-que ya existen y los deja en la rama `proposal/meeting-<entrada>` de sus docs
-(`inkwell git propose`), sin tocar `main`. Ideas,
-dudas y lo que se corrigió después no entran.
-
-```sh
-recap proposals ls <id> --json            # o --bita-entry <id>
-recap proposals show <id> <n> --json      # markdown, citas y diff
-recap proposals accept <id> <n> [--md <archivo editado>] --json
-recap proposals reject <id> <n> --json
-```
-
-Acepta o rechaza **solo cuando el usuario lo pida**. Si `accept` deja la
-propuesta en `stale`, la página cambió desde entonces: edítala sobre la versión
-actual y acéptala con `--md`. Cuando no queda ninguna pendiente, recap borra la
-rama. Usa `/recap-proposals` para revisarlas en la sesión.
+el micrófono. Si el contexto no deja claro cuál es, pregunta con una sola línea
+("¿remota o presencial?") antes de arrancar.
+
+## Flujo de una reunión
+
+1. **Ver el estado**: `recap status --json`. Si ya se está grabando
+   (`ALREADY_RECORDING` al arrancar), no arranques otra: avísalo.
+2. **Arrancar.** Si `data.bitaLinked` es true, recap sigue a los cronómetros
+   de bita: arranca por bita para que el tiempo también quede medido.
+
+   ```sh
+   bita start "<título>" --kind remote-meeting      # o --kind in-person-meeting
+   recap start --remote "<título>"                  # solo si bitaLinked es false
+   ```
+
+3. **Durante la reunión**: `recap ask --active --json` responde la última
+   pregunta con las páginas de inkwell y los repos del proyecto. Detalle en
+   [live.md](live.md).
+4. **Parar.** Con cronómetro, para el cronómetro y espera; sin él, para recap:
+
+   ```sh
+   bita stop <id> --json && recap wait --bita-entry <id> --json
+   recap stop --json && recap wait --json
+   ```
+
+   `stop` lanza el procesamiento en segundo plano (transcripción, capturas,
+   minuta y cierre). Tarda de uno a cinco minutos por hora de reunión: corre
+   `recap wait` con un timeout amplio. El monitor del plugin de Claude Code
+   avisa en la sesión cuando termina, así que no hace falta sondear.
+5. **Cierre automático** (con bita e inkwell): recap le pone título y proyecto
+   al cronómetro, crea o completa la página en inkwell, pasa pendientes y
+   hallazgos al backlog y deja la minuta en la nota de la entrada. El
+   resultado viene en `data.wrapup` de `recap wait`; si
+   `wrapup.projectResolved` es false, pregunta el proyecto. Detalle y
+   correcciones en [wrapup.md](wrapup.md).
+6. **Después**: los cambios que la reunión propuso a la documentación se
+   revisan con `/recap-proposals` ([proposals.md](proposals.md)), y el tiempo
+   de la reunión llega a Jira con tally, no desde recap.
+
+Cambiar el título o el proyecto del cronómetro mientras se graba
+(`bita amend`) no corta la grabación; solo un cambio de `--kind` que cruce la
+línea de reunión la arranca o la detiene. `recap discard` borra la grabación
+activa: solo si el usuario lo pide.
 
 ## Consultar reuniones
 
@@ -188,17 +88,35 @@ recap show <id> --path
 Para responder qué se habló o qué se acordó, lee `summary.md` de las reuniones
 que apliquen. Si hace falta precisión (una cifra, quién dijo qué), ve a
 `transcript.md`, que lleva el minuto de cada párrafo. Cita la reunión y el
-minuto en la respuesta. En reuniones remotas, **Sala** es el micrófono local y
-**Remotos** el audio de la llamada; no hay separación por persona.
+minuto. En remotas, **Sala** es el micrófono local y **Remotos** el audio de la
+llamada; no hay separación por persona.
 
 ## Regenerar la minuta
 
 - Sin intervención: `recap process <id> --from summarize`.
-- Dentro de la sesión, cuando el usuario quiere dirigir el enfoque o corregir
-  algo: usa `/recap-summarize`.
+- Dentro de la sesión, cuando el usuario quiere dirigir el enfoque: `/recap-summarize`.
+- Si una etapa falló, `recap process <id>` retoma desde ahí.
+
+## Errores típicos
+
+| Código | Causa | Acción |
+|---|---|---|
+| `SCREEN_DENIED` | Recap.app sin permiso de grabación de pantalla | Configuración > Privacidad y seguridad > Grabación de pantalla y audio del sistema |
+| `MICROPHONE_DENIED` | Sin permiso de micrófono | Igual, en Micrófono |
+| `RECORDER_TIMEOUT` | Un diálogo de permisos quedó esperando | `recap setup` |
+| `DEPENDENCY_MISSING`, `MODEL_MISSING` | Falta ffmpeg, whisper-cli, claude o el modelo | `recap setup --install-deps` |
+| `CAPTURE_UNAVAILABLE` | No hay grabador en este equipo | Graba con otra app y usa `recap import <archivo>`; en mac, `recap setup` |
+
+## Más detalle, bajo demanda
+
+- [wrapup.md](wrapup.md): qué hace el cierre con bita e inkwell, sin inkwell, y cómo corregir el proyecto.
+- [live.md](live.md): transcripción en vivo, `recap ask` y su configuración.
+- [proposals.md](proposals.md): cambios propuestos a la documentación.
+- [storage.md](storage.md): liberar espacio (comprimir, quitar video, borrar).
 
 ## Lo que no hace
 
 - No separa hablantes por persona: los nombres salen del contexto.
 - No sube nada a la nube salvo la transcripción que lee Claude al resumir, al
   responder con `recap ask` y al buscar cambios propuestos.
+- No toca Jira.

package/skills/recap/live.md

@@ -0,0 +1,31 @@
+# En vivo
+
+Mientras se graba, recap transcribe por tramos de 5 a 20 s en
+`live/transcript.jsonl` (una línea `{startMs, endMs, channel, text}`; `mic` es
+Sala y `system` Remotos). Es aproximada: la transcripción de después del stop
+(`transcript.md`) sigue siendo la fuente de verdad.
+
+Para responder una pregunta que hicieron en la reunión, con las páginas de
+inkwell y los repos del proyecto (`bita project repo ls`); sin inkwell responde
+solo con los repos:
+
+```sh
+recap ask --active --json                              # la última pregunta de la transcripción
+recap ask --active --question "¿cómo se despliega X?" --json
+recap ask --meeting <id> --question "..." --json-stream   # eventos question/progress/delta/source/done
+recap ask --sources --project <p> --json               # qué consultaría, sin llamar a claude
+```
+
+La respuesta lleva `found` y `sources` (página, `archivo:línea` o commit) y se
+guarda en `live/answers.jsonl`. Con `found: false` no está documentado: no lo
+completes por tu cuenta.
+
+Con `live.autoAsk` (encendido por omisión), el live-worker detecta solo las
+preguntas técnicas de la reunión y las responde sin que nadie las pida: esas
+respuestas llevan `auto: true` en `live/answers.jsonl`. Mientras se responde
+algo, `live/asking.json` dice qué pregunta va (`{question, startedAt, auto}`);
+una respuesta manual detiene a la automática.
+
+Se configura con `recap config get|set`: `live.enabled`, `live.openWindow`,
+`live.proposals`, `live.maxChunkSeconds`, `live.assistModel`, `live.autoAsk`,
+`live.autoAskModel`, `live.autoAskMinSeconds` y `live.autoAskConcurrency`.

package/skills/recap/proposals.md

@@ -0,0 +1,19 @@
+# Cambios propuestos a la documentación
+
+Si la reunión está ligada a bita e inkwell está instalado, la etapa `proposals`
+(antes de `wrapup`) detecta los cambios explícitos y firmes a páginas de
+inkwell que ya existen y los deja en la rama `proposal/meeting-<entrada>` de
+sus docs (`inkwell git propose`), sin tocar `main`. Ideas, dudas y lo que se
+corrigió después no entran.
+
+```sh
+recap proposals ls <id> --json            # o --bita-entry <id>
+recap proposals show <id> <n> --json      # markdown, citas y diff
+recap proposals accept <id> <n> [--md <archivo editado>] --json
+recap proposals reject <id> <n> --json
+```
+
+Acepta o rechaza **solo cuando el usuario lo pida**. Si `accept` deja la
+propuesta en `stale`, la página cambió desde entonces: edítala sobre la versión
+actual y acéptala con `--md`. Cuando no queda ninguna pendiente, recap borra la
+rama. `/recap-proposals` las revisa una por una en la sesión.

package/skills/recap/storage.md

@@ -0,0 +1,16 @@
+# Liberar espacio
+
+Solo si el usuario lo pide. Todos aceptan `<id>` o `--bita-entry <id>` y `--json`.
+
+```sh
+recap compress-video <id> --preset light|medium|max   # recomprime el video en HEVC (solo remotas)
+recap strip-video <id>                                 # quita el video y deja recording.m4a con ambas pistas de audio
+recap prune <id> --intermediates                       # borra mic.wav, system.wav, transcript-mic/system.json y live/chunks
+recap delete <id>                                      # borra la carpeta completa de la reunión
+```
+
+`compress-video` y `strip-video` aceptan `--prune-intermediates`. Fallan con
+`NOT_REMOTE` en reuniones presenciales, `NO_VIDEO` si ya no hay video,
+`MEETING_ACTIVE` mientras se graba y `NOT_SMALLER` si la compresión no ahorra
+espacio (el original se conserva). `recap list --json` trae `storage` y
+`hasVideo` de cada reunión.

package/skills/recap/wrapup.md

@@ -0,0 +1,49 @@
+# Cierre de una reunión con bita e inkwell
+
+Si `recap status --json` trae `data.bitaLinked: true` (recap está suscrito a
+los eventos de bita desde `recap setup`), las reuniones se arrancan y se paran
+desde bita. recap solo le pide a bita `projects`, `project repo ls`,
+`entries get` y `amend` (título y proyecto).
+
+Al parar el cronómetro, recap hace todo lo demás sin que nadie lo pida:
+
+- transcribe y escribe la minuta;
+- le pone al cronómetro un título real, si el que tenía era genérico (`bita amend`);
+- le asigna el proyecto si no tenía y la conversación lo deja claro (`bita amend`);
+- crea la página en inkwell, ligada a la entrada (`inkwell page new --from-entry`),
+  o agrega una sección a la que ya tenía (`inkwell page ls --entry`), y la escribe;
+- pasa pendientes y hallazgos al backlog de inkwell (`inkwell backlog add`);
+- deja la minuta en la sección «Reunión» de la nota de la entrada
+  (`inkwell note save <entrada> --section Reunión --md …`).
+
+El resultado está en `data.wrapup` de `recap wait`: `title`, `project`,
+`projectResolved`, `pageId`, `pageCreated` y `backlogKeys`.
+
+## Corregir el proyecto
+
+Si `wrapup.projectResolved` es false, pregunta solo «¿De qué proyecto fue?» y,
+con la respuesta:
+
+```sh
+bita amend <entryId> --project <X>
+inkwell page move <pageId> --project <X>
+inkwell backlog edit <CLAVE> --project <X>   # una por cada valor de wrapup.backlogKeys
+```
+
+## Sin inkwell, o con un inkwell viejo
+
+La reunión igual queda procesada: las etapas `proposals` y `wrapup` quedan en
+`skipped` con el motivo en `stages.<etapa>.reason` y la pista
+`npm i -g @kikedealba/inkwell && inkwell setup`; la minuta se queda en
+`summary.md` de la carpeta de la reunión. Si inkwell no tiene la capacidad
+`docs.entry-notes`, se escriben la página y el backlog, pero la minuta no pasa
+a la nota (queda anotado en `process.log`). Después de instalar o actualizar
+inkwell, `recap process <id> --from proposals` lo completa.
+
+## Qué responder al usuario
+
+- Título y duración.
+- Con bita e inkwell: el proyecto, la página (`wrapup.pageId`) y cuántos
+  pendientes y hallazgos quedaron en el backlog.
+- Sin bita o sin inkwell: los **Acuerdos** y **Pendientes** de la minuta, tal cual.
+- Si una etapa falló, su error y la sugerencia `recap process <id>`.

package/{commands/recap-ask.md → skills/recap-ask/SKILL.md}

@@ -1,7 +1,9 @@
 ---
-description: Responde la última pregunta de la reunión en curso con las páginas y repos del proyecto
+name: recap-ask
+description: Responde la última pregunta de la reunión en curso
 argument-hint: [pregunta, opcional]
 allowed-tools: Bash(recap ask:*)
+disable-model-invocation: true
 ---
 
 Responde en vivo una pregunta de la reunión que se está grabando.

package/{commands/recap-list.md → skills/recap-list/SKILL.md}

@@ -1,7 +1,9 @@
 ---
+name: recap-list
 description: Lista las reuniones grabadas, o muestra la minuta de una
 argument-hint: [id, parte del título o "last"]
 allowed-tools: Bash(recap list:*), Bash(recap show:*)
+disable-model-invocation: true
 ---
 
 **Sin `$ARGUMENTS`**, lista las reuniones recientes:

package/{commands/recap-proposals.md → skills/recap-proposals/SKILL.md}

@@ -1,7 +1,9 @@
 ---
-description: Revisa los cambios a la documentación que propuso una reunión
+name: recap-proposals
+description: Revisa los cambios de documentación que propuso una reunión
 argument-hint: [id de la reunión o "last"]
 allowed-tools: Bash(recap proposals:*), Bash(recap show:*), Read, Write
+disable-model-invocation: true
 ---
 
 Al cerrar una reunión ligada a bita, recap deja los cambios explícitos a

package/{commands/recap-start.md → skills/recap-start/SKILL.md}

@@ -1,7 +1,9 @@
 ---
+name: recap-start
 description: Empieza a grabar una reunión (remota o presencial)
 argument-hint: [remota|presencial] [título]
 allowed-tools: Bash(recap start:*), Bash(recap status:*), Bash(recap import:*), Bash(bita start:*)
+disable-model-invocation: true
 ---
 
 Estado actual:

package/{commands/recap-status.md → skills/recap-status/SKILL.md}

@@ -1,6 +1,8 @@
 ---
+name: recap-status
 description: Muestra si se está grabando y en qué va la última reunión
 allowed-tools: Bash(recap status:*)
+disable-model-invocation: true
 ---
 
 !`recap status --json`

package/{commands/recap-stop.md → skills/recap-stop/SKILL.md}

@@ -1,7 +1,9 @@
 ---
+name: recap-stop
 description: Termina la grabación y deja la reunión documentada
 argument-hint: [--no-wait para no esperar el resultado]
 allowed-tools: Bash(recap stop:*), Bash(recap status:*), Bash(recap wait:*), Bash(recap show:*), Bash(bita stop:*), Bash(bita ls:*), Bash(bita amend:*), Bash(inkwell page move:*), Bash(inkwell backlog edit:*)
+disable-model-invocation: true
 ---
 
 Detén la grabación activa y deja la reunión documentada.
@@ -22,13 +24,10 @@ bita stop <id> --json
 recap wait --bita-entry <id> --json
 ```
 
-El evento de bita detiene la grabación y recap hace lo demás:
-
-- transcribe y escribe la minuta;
-- le pone al cronómetro un título real y, si no tenía, su proyecto (`bita amend`);
-- crea o completa la página en inkwell;
-- pasa los pendientes y hallazgos al backlog de inkwell;
-- deja la minuta en la sección «Reunión» de la nota de la entrada (`inkwell note save`).
+El evento de bita detiene la grabación y recap hace lo demás: transcribe,
+escribe la minuta, le pone título y proyecto al cronómetro (`bita amend`),
+crea o completa la página en inkwell, pasa pendientes y hallazgos al backlog
+de inkwell y deja la minuta en la nota de la entrada.
 
 Sin inkwell, las etapas `proposals` y `wrapup` quedan en `skipped` con su
 motivo (`stages.wrapup.reason`) y la minuta se queda en la carpeta de la
@@ -70,4 +69,5 @@ inkwell backlog edit <CLAVE> --project <X>   # una por cada valor de wrapup.back
 El tiempo de la reunión se vuelca a Jira después con tally, no desde aquí.
 
 Con `--no-wait` en `$ARGUMENTS`, solo para y responde en una línea que el
-procesamiento sigue en segundo plano.
+procesamiento sigue en segundo plano. El monitor del plugin avisa en la sesión
+cuando la reunión termine de procesarse.

package/{commands/recap-summarize.md → skills/recap-summarize/SKILL.md}

@@ -1,7 +1,9 @@
 ---
-description: Rehace la minuta de una reunión dentro de la sesión, con indicaciones
+name: recap-summarize
+description: Rehace la minuta de una reunión con indicaciones
 argument-hint: [id o "last"] [indicaciones, p. ej. "enfócate en los riesgos"]
 allowed-tools: Bash(recap prompt:*), Bash(recap save-summary:*), Bash(recap show:*), Read, Write
+disable-model-invocation: true
 ---
 
 Rehaz la minuta de una reunión aquí mismo, en lugar del `claude -p` sin