@kikedealba/recap 0.9.1 → 0.11.0

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,7 +1,7 @@
 {
   "name": "@kikedealba/recap",
-  "version": "0.9.1",
-  "description": "Meeting recorder CLI: local transcription with whisper.cpp, minutes written by Claude Code, live answers and bita integration.",
+  "version": "0.11.0",
+  "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",
   "homepage": "https://github.com/KikeDeAlba/recap#readme",
@@ -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

@@ -6,21 +6,26 @@ description: Graba reuniones con la CLI `recap` y las convierte en minuta (resum
 # 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,132 +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
-
-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
-contador.
-
-```sh
-bita start "<título>" --kind remote-meeting
-bita start "<título>" --kind in-person-meeting
-bita stop <id> --json                 # sin --did y sin escribir la página
-recap wait --bita-entry <id> --json   # espera a que todo quede listo
-```
-
-Al parar, recap hace todo lo demás sin que nadie lo pida:
-
-- transcribe y escribe la minuta;
-- le pone al contador un título real, si el que tenía era genérico;
-- le asigna el proyecto si no tenía y la conversación lo deja claro;
-- crea la página en ese proyecto, o agrega una sección a la que ya tenía, y la escribe;
-- pasa pendientes y preguntas abiertas al backlog;
-- deja la minuta en la sección «Reunión» de la entrada.
-
-El resultado está en `data.wrapup` de `recap wait`. Si `wrapup.projectResolved`
-es false, pregunta el proyecto y aplícalo con `bita amend`, y mueve la página y
-el backlog con inkwell si está instalado (`inkwell page move --project`,
-`inkwell backlog edit --project`) o, si no, con `bita docs page move --project`
-y `bita backlog edit --project`.
-
-Las páginas, las propuestas y el backlog se escriben con inkwell cuando está
-instalado y ya migró los documentos de bita; si no, con `bita docs`/`bita backlog`.
-
-## 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 bita
-y los repos del proyecto (`bita project repo ls`):
-
-```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, la etapa `proposals` (antes de `wrapup`)
-detecta los cambios explícitos y firmes a páginas que ya existen y los deja en
-la rama `proposal/meeting-<entrada>` de los docs, 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
 
@@ -166,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 @@
 ---
+name: recap-ask
 description: Responde la última pregunta de la reunión en curso con las páginas y repos del proyecto
 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,12 +1,16 @@
 ---
+name: recap-proposals
 description: Revisa los cambios a la 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
-páginas existentes como propuestas en la rama `proposal/meeting-<entrada>` de
-los docs. Nada llega a `main` sin aceptarse.
+páginas existentes de inkwell como propuestas en la rama
+`proposal/meeting-<entrada>` de sus docs. Nada llega a `main` sin aceptarse.
+Aceptar o rechazar necesita inkwell instalado (`npm i -g @kikedealba/inkwell &&
+inkwell setup`).
 
 1. La reunión es `$ARGUMENTS`, o `last` si viene vacío. Lista sus propuestas:
 

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/skills/recap-stop/SKILL.md

@@ -0,0 +1,73 @@
+---
+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.
+
+Grabación actual:
+
+!`recap status --json`
+
+Si no hay grabación activa (`NOT_RECORDING`), dilo en una línea y termina.
+
+## Si la grabación sigue a un cronómetro de bita
+
+Cuando `data.active.bitaEntryId` trae un id, para **el cronómetro**, no recap,
+sin escribir la página:
+
+```
+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,
+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
+reunión; sugiere `npm i -g @kikedealba/inkwell && inkwell setup` y después
+`recap process <id> --from proposals`.
+
+`recap wait` tarda de uno a cinco minutos en una reunión de una hora: córrelo con
+un timeout amplio (15 min). Si después de un minuto `recap status` sigue
+grabando, el evento no llegó: párala con `recap stop`.
+
+## Si es una grabación suelta
+
+```
+recap stop --json
+recap wait --json
+```
+
+## Qué responder
+
+Con el resultado de `recap wait` responde:
+
+- 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ó, muestra su error y sugiere `recap process <id>`: retoma
+desde la etapa que falló.
+
+**Si `wrapup.projectResolved` es false**, pregunta solo «¿De qué proyecto fue?»
+y, con la respuesta:
+
+```
+bita amend <entryId> --project <X>
+inkwell page move <pageId> --project <X>
+inkwell backlog edit <CLAVE> --project <X>   # una por cada valor de wrapup.backlogKeys
+```
+
+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. 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 @@
 ---
+name: recap-summarize
 description: Rehace la minuta de una reunión dentro de la sesió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