@kikedealba/recap 0.9.1 → 0.11.0

package/dist/bita/wrapup.js

@@ -3,11 +3,12 @@ import { dayString, parseDate } from "../core/dates.js";
 import { readText, writeAtomic } from "../core/fsutil.js";
 import { extractBetween, isRecord, swiftDefault } from "../core/json.js";
 import { durationSeconds, emptyWrapup, updateMeeting } from "../core/meeting.js";
-import { fold, formatDuration, prefix, replaceAll, suffix, trimmed } from "../core/text.js";
+import { fold, formatDuration, prefix, replaceAll, trimmed } from "../core/text.js";
 import { RecapError } from "../errors.js";
 import { resultText, runSummaryClaude } from "../pipeline/claude.js";
 import { loadResource } from "../pipeline/resources.js";
-import { callBita, docsClient, meetingTarget, requireBita } from "./client.js";
+import { INKWELL_CAPABILITIES, INKWELL_HINT, StageSkipped, callBita, callInkwell, lookupInkwell, meetingTarget, requireBita } from "./client.js";
+import { entryPages } from "../live/context.js";
 export const FORBIDDEN_SECTIONS = ['pendiente', 'proximos pasos', 'hallazgo', 'preguntas abiertas', 'lo que falta'];
 export function stripForbiddenSections(markdown) {
     const kept = [];
@@ -127,20 +128,30 @@ export function noteBody(summary, meeting, dir) {
     lines.push('', `Archivos de la reunión: \`${dir}\` (\`summary.md\`, \`transcript.md\`${meeting.mode === 'remote' ? ', `frames/`' : ''}).`);
     return `${lines.join('\n')}\n`;
 }
-export async function saveMinutes(meeting, dir, config, client) {
+export async function saveMinutes(meeting, dir, notes, log) {
     const entryId = meeting.bitaEntryId;
     if (entryId === undefined)
-        return;
-    const bita = client ?? (await requireBita(config, meetingTarget(meeting)));
+        return { saved: false, reason: 'the meeting has no bita entry' };
     const summary = readText(path.join(dir, 'summary.md'));
     if (summary === null)
-        throw new RecapError('NO_SUMMARY', `"${meeting.title}" has no summary to send to bita`);
-    const note = path.join(dir, 'bita-note.md');
+        throw new RecapError('NO_SUMMARY', `"${meeting.title}" has no summary to save in the entry note`);
+    const note = path.join(dir, 'entry-note.md');
     writeAtomic(note, noteBody(summary, meeting, dir));
-    const result = await bita.run(['note', 'save', String(entryId), '--note-md', note, '--section', NOTE_SECTION, '--json', ...bita.targetArgs()]);
-    if (result.status !== 0) {
-        throw new RecapError('BITA_FAILED', `bita note save ${entryId} failed: ${suffix(trimmed(result.stdout + result.stderr), 400)}`);
+    let client = notes;
+    let reason = 'no inkwell with docs.entry-notes was given';
+    if (client === undefined) {
+        const found = await lookupInkwell(INKWELL_CAPABILITIES.notes);
+        client = found.client;
+        if (found.reason !== undefined)
+            reason = found.reason;
+    }
+    if (!client) {
+        log?.(`minutes: not saved in the note of entry #${entryId}, ${reason}; they stay in ${dir} (${INKWELL_HINT})`);
+        return { saved: false, reason };
     }
+    await callInkwell(client, ['note', 'save', String(entryId), '--section', NOTE_SECTION, '--md', note]);
+    log?.(`minutes: saved in the note of entry #${entryId}`);
+    return { saved: true };
 }
 export function meetingDay(meeting) {
     return dayString(parseDate(meeting.startedAt) ?? parseDate(meeting.createdAt) ?? new Date());
@@ -155,7 +166,7 @@ export function encodeWrapupPlan(plan) {
     });
 }
 async function pageText(docs, pageId) {
-    const page = await callBita(docs, ['docs', 'page', 'show', String(pageId)]);
+    const page = await callInkwell(docs, ['page', 'show', String(pageId)]);
     const doc = isRecord(page) && isRecord(page['doc']) ? page['doc'] : undefined;
     const file = typeof doc?.['path'] === 'string' ? doc['path'] : undefined;
     return file ? readText(file) : null;
@@ -182,8 +193,16 @@ export async function runWrapup(meeting, dir, config, dependencies) {
     const entryId = meeting.bitaEntryId;
     if (entryId === undefined)
         return;
+    let docs = dependencies?.docs;
+    if (!docs) {
+        const found = await lookupInkwell(INKWELL_CAPABILITIES.wrapup);
+        if (!found.client) {
+            await saveMinutes(meeting, dir, undefined, dependencies?.log).catch((error) => dependencies?.log?.(`minutes: ${String(error)}`));
+            throw new StageSkipped(found.reason, INKWELL_HINT);
+        }
+        docs = found.client;
+    }
     const bita = dependencies?.bita ?? (await requireBita(config, meetingTarget(meeting)));
-    const docs = dependencies?.docs ?? (await docsClient(config, meetingTarget(meeting))) ?? bita;
     const claude = dependencies?.claude ?? (async (prompt) => resultText(await runSummaryClaude(prompt, dir, config)));
     const snapshot = meeting.bitaEntry ?? { title: meeting.title, pageIds: [] };
     const wrapup = { ...emptyWrapup(), ...(meeting.wrapup ?? {}) };
@@ -192,7 +211,7 @@ export async function runWrapup(meeting, dir, config, dependencies) {
         .filter(isRecord)
         .filter((project) => project['active'] !== false)
         .flatMap((project) => (typeof project['name'] === 'string' ? [project['name']] : []));
-    const existingPageId = wrapup.pageId ?? snapshot.pageIds[0];
+    const existingPageId = wrapup.pageId ?? (await entryPages(docs, entryId, true))[0]?.pageId;
     const existingPage = existingPageId === undefined ? null : await pageText(docs, existingPageId);
     const plan = await planWrapup(meeting, dir, snapshot, projects, existingPage, claude);
     writeAtomic(path.join(dir, 'wrapup.json'), encodeWrapupPlan(plan));
@@ -209,23 +228,23 @@ export async function runWrapup(meeting, dir, config, dependencies) {
         await callBita(bita, ['amend', String(entryId), '--project', choice.apply]);
     wrapup.project = choice.apply ?? snapshot.projectName;
     wrapup.projectResolved = choice.resolved;
-    const pageFile = path.join(dir, 'bita-page.md');
+    const pageFile = path.join(dir, 'wrapup-page.md');
     if (existingPageId !== undefined) {
         writeAtomic(pageFile, demoteHeadings(plan.pageMarkdown));
-        await callBita(docs, ['docs', 'page', 'write', String(existingPageId), '--md', pageFile, '--section', `Reunión ${meetingDay(meeting)}`]);
+        await callInkwell(docs, ['page', 'write', String(existingPageId), '--md', pageFile, '--section', `Reunión ${meetingDay(meeting)}`]);
         wrapup.pageId = existingPageId;
     }
     else {
         writeAtomic(pageFile, plan.pageMarkdown);
-        const args = ['docs', 'page', 'new', plan.pageTitle, '--from-entry', String(entryId)];
+        const args = ['page', 'new', plan.pageTitle, '--from-entry', String(entryId)];
         if (wrapup.project)
             args.push('--project', wrapup.project);
-        const created = await callBita(docs, args);
+        const created = await callInkwell(docs, args);
         const page = isRecord(created) && isRecord(created['page']) ? created['page'] : undefined;
         const pageId = typeof page?.['pageId'] === 'number' ? page['pageId'] : undefined;
         if (pageId === undefined)
-            throw new RecapError('BITA_FAILED', 'bita docs page new did not return the page id');
-        await callBita(docs, ['docs', 'page', 'write', String(pageId), '--md', pageFile]);
+            throw new RecapError('INKWELL_FAILED', 'inkwell page new did not return the page id');
+        await callInkwell(docs, ['page', 'write', String(pageId), '--md', pageFile]);
         wrapup.pageId = pageId;
         wrapup.pageCreated = true;
     }
@@ -237,17 +256,17 @@ export async function runWrapup(meeting, dir, config, dependencies) {
             continue;
         const args = ['backlog', 'add', '--kind', item.kind, '--title', item.title, '--page', String(wrapup.pageId ?? 0)];
         if (item.body) {
-            const bodyFile = path.join(dir, 'bita-backlog-item.md');
+            const bodyFile = path.join(dir, 'wrapup-backlog-item.md');
             writeAtomic(bodyFile, item.body);
             args.push('--md', bodyFile);
         }
-        const added = await callBita(docs, args);
+        const added = await callInkwell(docs, args);
         wrapup.backlogKeys[item.title] = isRecord(added) && typeof added['key'] === 'string' ? added['key'] : '?';
         updateMeeting(dir, (current) => {
             current.wrapup = { ...wrapup, backlogKeys: { ...wrapup.backlogKeys } };
         });
     }
-    await saveMinutes(meeting, dir, config, bita);
+    await saveMinutes(meeting, dir, dependencies?.notes, dependencies?.log);
     updateMeeting(dir, (current) => {
         current.wrapup = { ...wrapup, backlogKeys: { ...wrapup.backlogKeys } };
     });

package/dist/cli/commands/ask.js

@@ -5,10 +5,9 @@ import { MeetingStore, loadMeeting, resolveTarget } from "../../core/meeting.js"
 import { signalNumber, signalTree } from "../../core/proc.js";
 import { trimmed } from "../../core/text.js";
 import { RecapError, asRecapError, usageError } from "../../errors.js";
-import { BitaClient, docsClient, meetingTarget } from "../../bita/client.js";
 import { runAsk } from "../../live/ask.js";
 import { isValidAskId, makeAskId, performAsk, removeBoard } from "../../live/asking.js";
-import { loadProjectContext, meetingProject, meetingProjectName } from "../../live/context.js";
+import { contextSources, loadProjectContext, meetingContext, meetingProjectName } from "../../live/context.js";
 import { jsonLine } from "../../live/files.js";
 import { encodeAnswer, encodeAskEvent } from "../../live/stream.js";
 import { parseArgs } from "../args.js";
@@ -77,8 +76,7 @@ async function answer(args, emit) {
     let childPid = null;
     installCleanup(found.dir, id, () => childPid);
     return performAsk({ dir: found.dir, id, question, auto: args.has('auto'), now, questionMs, channel }, async () => {
-        const docs = await docsClient(config, meetingTarget(found.meeting));
-        const context = await loadProjectContext(await meetingProject(found.meeting, docs), found.meeting.bitaDocsRoot, docs);
+        const context = await meetingContext(found.meeting, config);
         return runAsk(config, { meeting: found.meeting, dir: found.dir, question, windowSeconds: args.int('window') ?? 180, now, auto: args.has('auto'), questionMs, channel, askId: id }, context, emit, (pid) => {
             childPid = pid;
         });
@@ -105,9 +103,9 @@ export async function askCommand(argv) {
         if (args.has('sources')) {
             const config = loadConfig();
             const found = args.has('active') || args.value('meeting') !== undefined || args.value('bita-entry') !== undefined ? target(args, config) : null;
-            const docs = found ? await docsClient(config, meetingTarget(found.meeting)) : await docsClient(config, {});
+            const sources = await contextSources(config, found?.meeting ?? null);
             const name = args.value('project') ?? (found ? meetingProjectName(found.meeting) : null);
-            const context = await loadProjectContext(name, found?.meeting.bitaDocsRoot, docs ?? (await BitaClient.create(config, {})));
+            const context = await loadProjectContext(name, sources);
             const lines = [`Project: ${context.project ?? '(none)'}`, `Docs: ${context.docsRoot ?? '(unknown)'}`, ...context.repos.map((repo) => `Repo: ${repo.slug} ${repo.path}${repo.exists ? '' : ' (missing)'}`)];
             return { data: { project: context.project ?? undefined, docsRoot: context.docsRoot ?? undefined, repos: context.repos }, text: lines.join('\n') };
         }

package/dist/cli/commands/hook.js

@@ -62,6 +62,21 @@ export async function handleHookEvent(event) {
                 log(`discarded ${record.dir}`);
                 break;
             }
+            case 'refresh': {
+                const found = new MeetingStore(loadConfig()).find(event.entry.id);
+                if (!found) {
+                    log(`nothing to do: no meeting for entry #${event.entry.id}`);
+                    break;
+                }
+                updateMeeting(found.dir, (meeting) => {
+                    meeting.bitaEntry = { ...eventSnapshot(event), pageIds: meeting.bitaEntry?.pageIds ?? [] };
+                    const renamed = event.previousTitle !== undefined && event.previousTitle !== event.entry.description;
+                    if (renamed && event.entry.description.trim().length > 0)
+                        meeting.title = event.entry.description;
+                });
+                log(`updated ${found.dir}`);
+                break;
+            }
             case 'ignore':
                 log(`nothing to do: ${action.reason}`);
                 break;

package/dist/cli/commands/proposals.js

@@ -3,7 +3,7 @@ import { expandTilde } from "../../core/paths.js";
 import { readText } from "../../core/fsutil.js";
 import { MeetingStore, resolveTarget } from "../../core/meeting.js";
 import { RecapError, usageError } from "../../errors.js";
-import { docsClient, meetingTarget } from "../../bita/client.js";
+import { INKWELL_CAPABILITIES, INKWELL_HINT, findInkwell, requireInkwell } from "../../bita/client.js";
 import { ProposalReview, loadProposals, proposalJson } from "../../bita/proposals.js";
 import { parseArgs } from "../args.js";
 import { output } from "../output.js";
@@ -21,13 +21,11 @@ function number(args) {
         throw new RecapError('PROPOSAL_REQUIRED', 'Pass the proposal number');
     return Number(raw);
 }
-const noBita = { invoke: async () => ({ ok: false, errorCode: 'DEPENDENCY_MISSING', errorMessage: 'bita not found' }) };
+const noInkwell = { invoke: async () => ({ ok: false, errorCode: 'DEPENDENCY_MISSING', errorMessage: `inkwell not found (${INKWELL_HINT})` }) };
 async function review(args, config, required) {
     const found = meeting(args, config);
-    const docs = await docsClient(config, meetingTarget(found.meeting));
-    if (!docs && required)
-        throw new RecapError('DEPENDENCY_MISSING', 'bita not found. Install it with `npm install -g @kikedealba/bita`');
-    return new ProposalReview(found.dir, docs ?? noBita);
+    const inkwell = required ? await requireInkwell(INKWELL_CAPABILITIES.proposals, 'Reviewing proposals') : await findInkwell(INKWELL_CAPABILITIES.proposals);
+    return new ProposalReview(found.dir, inkwell ?? noInkwell);
 }
 export async function proposalsCommand(argv) {
     const [sub, ...rest] = argv;

package/dist/cli/commands/query.js

@@ -10,6 +10,7 @@ import { processInBackground } from "../../core/self.js";
 import { formatDuration, padEnd } from "../../core/text.js";
 import { RecapError, usageError } from "../../errors.js";
 import { saveMinutes } from "../../bita/wrapup.js";
+import { INKWELL_HINT } from "../../bita/client.js";
 import { Pipeline } from "../../pipeline/pipeline.js";
 import { STAGES, allStagesSatisfied, isStage } from "../../pipeline/stages.js";
 import { saveSummary, summaryPromptFor } from "../../pipeline/summary.js";
@@ -106,14 +107,17 @@ export async function saveSummaryCommand(argv) {
             throw new RecapError('FILE_UNREADABLE', `Cannot read ${file}: ${error.message}`);
         }
         saveSummary(body, meeting, dir);
-        if (meeting.bitaEntryId !== undefined)
-            await saveMinutes(meeting, dir, config);
+        let minutes = null;
+        if (meeting.bitaEntryId !== undefined) {
+            const result = await saveMinutes(meeting, dir);
+            minutes = result.saved ? `Minutes saved in the note of entry #${meeting.bitaEntryId}` : `Minutes not saved in the entry note: ${result.reason ?? 'no reason given'} (${INKWELL_HINT})`;
+        }
         const updated = updateMeeting(dir, (current) => {
             current.stages['summarize'] = { status: 'done', updatedAt: isoNow() };
             if (allStagesSatisfied({ ...meeting, stages: current.stages }))
                 current.status = 'processed';
         });
-        return { data: meetingRecord(updated, dir), text: path.join(dir, 'summary.md') };
+        return { data: meetingRecord(updated, dir), text: minutes === null ? path.join(dir, 'summary.md') : `${path.join(dir, 'summary.md')}\n${minutes}` };
     });
 }
 export function failedStage(meeting) {
@@ -131,6 +135,10 @@ export function describeWait(meeting, dir) {
     const failed = failedStage(meeting);
     if (failed)
         lines.push(`Failed at ${failed[0]}: ${failed[1].error ?? 'no reason given'}`);
+    for (const [stage, state] of Object.entries(meeting.stages)) {
+        if (state.status === 'skipped' && state.reason !== undefined)
+            lines.push(`Skipped ${stage}: ${state.reason}${state.hint !== undefined ? ` (${state.hint})` : ''}`);
+    }
     const wrapup = meeting.wrapup;
     if (wrapup) {
         lines.push(`Title   : ${wrapup.title ?? meeting.title}`);

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/live/context.js

@@ -2,6 +2,8 @@ import path from 'node:path';
 import { isDirectory } from "../core/fsutil.js";
 import { isRecord } from "../core/json.js";
 import { trimmed } from "../core/text.js";
+import { BitaClient, INKWELL_CAPABILITIES, findInkwell, meetingTarget } from "../bita/client.js";
+import { RecapError } from "../errors.js";
 export function emptyContext(overrides = {}) {
     return { project: null, docsRoot: null, pages: [], repos: [], ...overrides };
 }
@@ -24,6 +26,7 @@ export function parsePages(data) {
                 title,
                 relPath: typeof item['relPath'] === 'string' ? item['relPath'] : '',
                 depth: typeof item['depth'] === 'number' && Number.isInteger(item['depth']) ? item['depth'] : depth,
+                ...(typeof item['projectName'] === 'string' ? { projectName: item['projectName'] } : {}),
             });
             if (Array.isArray(item['children']))
                 walk(item['children'], depth + 1);
@@ -52,39 +55,63 @@ export function parseRepos(data) {
 function metaRoot(meta) {
     return typeof meta?.['root'] === 'string' ? meta['root'] : null;
 }
-export async function loadProjectContext(project, docsRoot, bita) {
-    const context = emptyContext({ project: project && trimmed(project).length > 0 ? project : null, docsRoot: docsRoot ?? null });
-    if (!bita)
-        return context;
+export async function loadProjectContext(project, sources) {
+    const context = emptyContext({ project: project && trimmed(project).length > 0 ? project : null });
+    const { inkwell, bita } = sources;
     if (context.project) {
-        const pages = await bita.invoke(['docs', 'page', 'ls', '--project', context.project]).catch(() => null);
-        if (pages?.ok) {
-            context.pages = parsePages(pages.data);
-            context.docsRoot ??= metaRoot(pages.meta);
+        if (inkwell) {
+            const pages = await inkwell.invoke(['page', 'ls', '--project', context.project]).catch(() => null);
+            if (pages?.ok) {
+                context.pages = parsePages(pages.data);
+                context.docsRoot = metaRoot(pages.meta);
+            }
+        }
+        if (bita) {
+            const repos = await bita.invoke(['project', 'repo', 'ls', '--project', context.project]).catch(() => null);
+            if (repos?.ok)
+                context.repos = parseRepos(repos.data);
         }
-        const repos = await bita.invoke(['project', 'repo', 'ls', '--project', context.project]).catch(() => null);
-        if (repos?.ok)
-            context.repos = parseRepos(repos.data);
     }
-    if (context.docsRoot === null) {
-        const tree = await bita.invoke(['docs', 'tree']).catch(() => null);
+    if (context.docsRoot === null && inkwell) {
+        const tree = await inkwell.invoke(['tree']).catch(() => null);
         if (tree?.ok)
             context.docsRoot = metaRoot(tree.meta);
     }
     return context;
 }
+export async function entryPages(inkwell, entryId, strict = false) {
+    if (!inkwell || entryId === undefined)
+        return [];
+    const response = await inkwell.invoke(['page', 'ls', '--entry', String(entryId)]).catch(() => null);
+    if (response?.ok)
+        return parsePages(response.data);
+    if (strict)
+        throw new RecapError('INKWELL_FAILED', `inkwell page ls --entry ${entryId} failed: ${response?.errorMessage ?? 'no reason given'}`);
+    return [];
+}
 export function meetingProjectName(meeting) {
     return meeting.bitaEntry?.projectName ?? meeting.wrapup?.project ?? null;
 }
-export async function meetingProject(meeting, bita) {
+export async function meetingProject(meeting, inkwell, linked) {
     const name = meetingProjectName(meeting);
     if (name && trimmed(name).length > 0)
         return name;
-    const pageId = meeting.wrapup?.pageId ?? meeting.bitaEntry?.pageIds[0];
-    if (!bita || pageId === undefined)
-        return null;
-    const response = await bita.invoke(['docs', 'page', 'show', String(pageId), '--no-markdown']).catch(() => null);
-    if (!response?.ok || !isRecord(response.data))
+    if (!inkwell)
         return null;
-    return typeof response.data['projectName'] === 'string' ? response.data['projectName'] : null;
+    const pageId = meeting.wrapup?.pageId;
+    if (pageId !== undefined) {
+        const response = await inkwell.invoke(['page', 'show', String(pageId), '--no-markdown']).catch(() => null);
+        if (response?.ok && isRecord(response.data) && typeof response.data['projectName'] === 'string')
+            return response.data['projectName'];
+    }
+    const pages = linked ?? (await entryPages(inkwell, meeting.bitaEntryId));
+    return pages.find((page) => page.projectName !== undefined)?.projectName ?? null;
+}
+export async function contextSources(config, meeting) {
+    const [inkwell, bita] = await Promise.all([findInkwell(INKWELL_CAPABILITIES.pages), BitaClient.create(config, meeting ? meetingTarget(meeting) : {})]);
+    return { inkwell, bita };
+}
+export async function meetingContext(meeting, config) {
+    const sources = await contextSources(config, meeting);
+    return loadProjectContext(await meetingProject(meeting, sources.inkwell), sources);
 }

package/dist/live/worker.js

@@ -10,12 +10,11 @@ import { selfCommand } from "../core/self.js";
 import { suffix, trimmed } from "../core/text.js";
 import { requireTool } from "../core/tools.js";
 import { RecapError, errorMessage } from "../errors.js";
-import { docsClient, meetingTarget } from "../bita/client.js";
 import { resultText, runClaude } from "../pipeline/claude.js";
 import { whisperArguments } from "../pipeline/pipeline.js";
 import { parseWhisper } from "../pipeline/transcript.js";
 import { pruneBoard } from "./asking.js";
-import { loadProjectContext, meetingProject } from "./context.js";
+import { meetingContext } from "./context.js";
 import { AutoAskProcess, AutoAskQueue, QuestionDetector } from "./detector.js";
 import { appendLines, liveFiles, readLines } from "./files.js";
 import { LiveMerger } from "./merger.js";
@@ -177,10 +176,7 @@ export function makeLiveDetector(dir, meeting, config, log) {
     const runner = new AutoAskProcess(dir, selfCommand());
     const asks = new AutoAskQueue({ dir, concurrency: settings.autoAskConcurrency, run: (job) => runner.run(job), cancelRunning: () => runner.cancel(), log });
     return new QuestionDetector(dir, meeting, settings.autoAskMinSeconds, {
-        context: async () => {
-            const docs = await docsClient(config, meetingTarget(meeting));
-            return loadProjectContext(await meetingProject(meeting, docs), meeting.bitaDocsRoot, docs);
-        },
+        context: () => meetingContext(meeting, config),
         complete: async (prompt) => resultText(await runClaude({ prompt, cwd: dir, config, tools: [], addDirs: [], model: settings.autoAskModel, restrictTools: [] })),
         enqueue: (question, origin) => {
             asks.enqueue(question, origin);

package/dist/pipeline/pipeline.js

@@ -11,7 +11,7 @@ import { exec } from "../core/proc.js";
 import { suffix, trimmed } from "../core/text.js";
 import { requireTool } from "../core/tools.js";
 import { RecapError, errorMessage } from "../errors.js";
-import { docsClient, meetingTarget, requireBita } from "../bita/client.js";
+import { INKWELL_CAPABILITIES, StageSkipped, inkwellForStage } from "../bita/client.js";
 import { ProposalGenerator } from "../bita/proposals.js";
 import { runWrapup } from "../bita/wrapup.js";
 import { runSummaryClaude } from "./claude.js";
@@ -78,9 +78,9 @@ export class Pipeline {
     recording(meeting) {
         return recordingPath(this.dir, meeting.mode);
     }
-    setStage(stage, status, error, extra) {
+    setStage(stage, status, error, extra, details = {}) {
         return updateMeeting(this.dir, (current) => {
-            current.stages[stage] = { status, updatedAt: isoNow(), ...(error !== undefined ? { error } : {}) };
+            current.stages[stage] = { status, updatedAt: isoNow(), ...(error !== undefined ? { error } : {}), ...details };
             extra?.(current);
         });
     }
@@ -131,6 +131,11 @@ export class Pipeline {
                 }
                 catch (error) {
                     const message = error instanceof RecapError ? error.message : errorMessage(error);
+                    if (error instanceof StageSkipped) {
+                        meeting = this.setStage(stage, 'skipped', undefined, undefined, { reason: message, ...(error.hint !== undefined ? { hint: error.hint } : {}) });
+                        this.log(`${stage}: skipped, ${message}${error.hint !== undefined ? ` (${error.hint})` : ''}`);
+                        continue;
+                    }
                     if (stageIsOptional(stage)) {
                         meeting = this.setStage(stage, 'failed', message);
                         this.log(`${stage}: failed, continuing: ${message}`);
@@ -165,7 +170,7 @@ export class Pipeline {
             case 'proposals':
                 return this.proposals(meeting);
             case 'wrapup':
-                return runWrapup(meeting, this.dir, this.config);
+                return runWrapup(meeting, this.dir, this.config, { log: this.log });
         }
     }
     async extractAudio(meeting) {
@@ -268,8 +273,7 @@ export class Pipeline {
         saveSummary(extractSummary(output), meeting, this.dir);
     }
     async proposals(meeting) {
-        const target = meetingTarget(meeting);
-        const docs = (await docsClient(this.config, target)) ?? (await requireBita(this.config, target));
-        await new ProposalGenerator(this.config, docs, this.log).run(meeting, this.dir);
+        const inkwell = await inkwellForStage(INKWELL_CAPABILITIES.proposals);
+        await new ProposalGenerator(this.config, inkwell, this.log).run(meeting, this.dir);
     }
 }