@fs/mycroft 0.3.0 → 0.4.0

package/dist/cli.js

@@ -1,10 +1,14 @@
 #!/usr/bin/env node
 import {
   submitBatchEmbeddings
-} from "./chunk-XXO66RCF.js";
+} from "./chunk-VBEGUDHG.js";
 import {
+  CHARS_PER_TOKEN,
+  SUMMARY_PROMPT,
+  parseStructuredSummary,
+  splitIntoSections,
   submitBatchSummaries
-} from "./chunk-7DUQNGEK.js";
+} from "./chunk-T6X7DRBN.js";
 import {
   CHUNK_OVERLAP,
   CHUNK_SIZE,
@@ -27,7 +31,7 @@ import {
   resolvePaths,
   setConfigOverrides,
   stdout
-} from "./chunk-KGG7WEYE.js";
+} from "./chunk-LV52FEMB.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -89,8 +93,9 @@ var createWarnFilter = () => {
 var parseEpub = async (epubPath, resourceSaveDir) => {
   logInfo(`[EPUB Parser] Starting parse for: ${basename(epubPath)}`);
   const suppressedWarnings = createWarnFilter();
+  let epubFile = null;
   try {
-    const epubFile = await initEpubFile(epubPath, resourceSaveDir);
+    epubFile = await initEpubFile(epubPath, resourceSaveDir);
     await epubFile.loadEpub();
     logInfo(`[EPUB Parser] EPUB loaded successfully`);
     await epubFile.parse();
@@ -132,7 +137,6 @@ var parseEpub = async (epubPath, resourceSaveDir) => {
       });
       chapterTitles.push(chapterTitle);
     }
-    epubFile.destroy();
     const author = safeMetadata.creator?.[0]?.contributor ?? null;
     logInfo(`[EPUB Parser] Extracted ${chapters.length} chapters with content`);
     logInfo(`[EPUB Parser] Title: "${safeMetadata.title || fileBaseName || "Untitled"}", Author: "${author || "Unknown"}"`);
@@ -147,6 +151,7 @@ var parseEpub = async (epubPath, resourceSaveDir) => {
       narrativeEndIndex
     };
   } finally {
+    epubFile?.destroy();
     console.warn = originalWarn;
   }
 };
@@ -226,14 +231,14 @@ var chunkChapters = (bookId, chapters) => {
 import { embedMany } from "ai";
 import { openai } from "@ai-sdk/openai";
 var MAX_TOKENS_PER_BATCH = 25e4;
-var CHARS_PER_TOKEN = 4;
+var CHARS_PER_TOKEN2 = 4;
 var embedChunks = async (chunks, options) => {
   if (chunks.length === 0) return [];
   const batches = [];
   let currentBatch = [];
   let currentTokens = 0;
   for (const chunk of chunks) {
-    const estimatedTokens = Math.ceil(chunk.content.length / CHARS_PER_TOKEN);
+    const estimatedTokens = Math.ceil(chunk.content.length / CHARS_PER_TOKEN2);
     if (currentTokens + estimatedTokens > MAX_TOKENS_PER_BATCH && currentBatch.length > 0) {
       batches.push(currentBatch);
       currentBatch = [];
@@ -250,7 +255,7 @@ var embedChunks = async (chunks, options) => {
   const models = await getModels();
   for (let i = 0; i < batches.length; i++) {
     const batch = batches[i];
-    const estimatedTokens = batch.reduce((sum, c) => sum + Math.ceil(c.content.length / CHARS_PER_TOKEN), 0);
+    const estimatedTokens = batch.reduce((sum, c) => sum + Math.ceil(c.content.length / CHARS_PER_TOKEN2), 0);
     logInfo(`[Embedder] Batch ${i + 1}/${batches.length}: ${batch.length} chunks (~${estimatedTokens.toLocaleString()} tokens)`);
     const { embeddings } = await embedMany({
       model: openai.embeddingModel(models.embedding),
@@ -258,9 +263,13 @@ var embedChunks = async (chunks, options) => {
     });
     const embeddedBatch = [];
     for (let j = 0; j < batch.length; j++) {
+      const vector = embeddings[j] ?? [];
+      if (vector.length === 0) {
+        logWarn(`[Embedder] Chunk ${allEmbedded.length + j} has empty embedding`);
+      }
       const embeddedChunk = {
         ...batch[j],
-        vector: embeddings[j] ?? []
+        vector
       };
       embeddedBatch.push(embeddedChunk);
       allEmbedded.push({
@@ -282,11 +291,14 @@ var embedChunks = async (chunks, options) => {
 
 // src/services/vector-store.ts
 import { LocalIndex } from "vectra";
+var indexCache = /* @__PURE__ */ new Map();
 var indexPathForBook = async (bookId) => {
   const paths = await ensureDataDirs();
   return `${paths.vectorsDir}/${bookId}`;
 };
 var createBookIndex = async (bookId) => {
+  const cached = indexCache.get(bookId);
+  if (cached) return cached;
   const index = new LocalIndex(await indexPathForBook(bookId));
   const exists = await index.isIndexCreated();
   if (!exists) {
@@ -297,6 +309,7 @@ var createBookIndex = async (bookId) => {
       }
     });
   }
+  indexCache.set(bookId, index);
   return index;
 };
 var addChunksToIndex = async (bookId, chunks) => {
@@ -336,6 +349,7 @@ var queryBookIndex = async (bookId, queryVector, queryText, topK, maxChapterInde
   return mapped.filter((item) => item.chapterIndex <= maxChapterIndex).slice(0, topK);
 };
 var deleteBookIndex = async (bookId) => {
+  indexCache.delete(bookId);
   const index = new LocalIndex(await indexPathForBook(bookId));
   const exists = await index.isIndexCreated();
   if (!exists) return;
@@ -345,42 +359,7 @@ var deleteBookIndex = async (bookId) => {
 // src/services/summarizer.ts
 import { generateText } from "ai";
 import { openai as openai2 } from "@ai-sdk/openai";
-var CHARS_PER_TOKEN2 = 4;
-var estimateTokens = (text) => Math.ceil(text.length / CHARS_PER_TOKEN2);
-var SUMMARY_PROMPT = (title, chapterNum, content) => `You are analyzing a chapter from a book (fiction or nonfiction). Extract key information to help readers understand the chapter's content.
-
-Chapter Title: ${title}
-Chapter Number: ${chapterNum}
-
----
-${content}
----
-
-Extract the following information and respond ONLY with valid JSON (no markdown, no code blocks):
-
-{
-  "characters": ["Name - brief description (role, traits, first appearance)", ...],
-  "events": "What happens in this chapter? (2-3 sentences)",
-  "setting": "Where does this chapter take place?",
-  "revelations": "Any important information revealed? (secrets, backstory, foreshadowing)"
-}
-
-Keep the total response around ${SUMMARY_TARGET_WORDS} words.`;
-var splitIntoSections = (text, maxTokens) => {
-  const estimatedTokens = estimateTokens(text);
-  if (estimatedTokens <= maxTokens) {
-    return [text];
-  }
-  const numSections = Math.ceil(estimatedTokens / maxTokens);
-  const charsPerSection = Math.floor(text.length / numSections);
-  const sections = [];
-  for (let i = 0; i < numSections; i++) {
-    const start = i * charsPerSection;
-    const end = i === numSections - 1 ? text.length : (i + 1) * charsPerSection;
-    sections.push(text.slice(start, end));
-  }
-  return sections;
-};
+var estimateTokens = (text) => Math.ceil(text.length / CHARS_PER_TOKEN);
 var summarizeSection = async (text, title, sectionNum) => {
   const models = await getModels();
   const { text: summary } = await generateText({
@@ -396,33 +375,9 @@ var generateStructuredSummary = async (content, title, chapterIndex) => {
     const models = await getModels();
     const { text } = await generateText({
       model: openai2(models.summary),
-      prompt: SUMMARY_PROMPT(title, chapterIndex + 1, content)
+      prompt: SUMMARY_PROMPT(title, chapterIndex + 1, content, SUMMARY_TARGET_WORDS)
     });
-    let jsonText = text.trim();
-    if (jsonText.startsWith("```json")) {
-      jsonText = jsonText.slice(7, -3).trim();
-    } else if (jsonText.startsWith("```")) {
-      jsonText = jsonText.slice(3, -3).trim();
-    }
-    const parsed = JSON.parse(jsonText);
-    const fullSummary = `Chapter ${chapterIndex + 1}: ${title}
-
-Characters: ${parsed.characters.join(", ")}
-
-Events: ${parsed.events}
-
-Setting: ${parsed.setting}
-
-Revelations: ${parsed.revelations}`;
-    return {
-      chapterIndex,
-      chapterTitle: title,
-      characters: parsed.characters,
-      events: parsed.events,
-      setting: parsed.setting,
-      revelations: parsed.revelations,
-      fullSummary
-    };
+    return parseStructuredSummary(text, chapterIndex, title);
   } catch (error) {
     logWarn(`[Summarizer] Failed to parse summary JSON for "${title}": ${error instanceof Error ? error.message : String(error)}`);
     return null;
@@ -479,6 +434,7 @@ var resolveDbPath = async () => {
 };
 var createDb = async () => {
   const db = new Database(await resolveDbPath());
+  db.pragma("foreign_keys = ON");
   db.exec(`
     CREATE TABLE IF NOT EXISTS books (
       id TEXT PRIMARY KEY,
@@ -496,7 +452,7 @@ var createDb = async () => {
   db.exec(`
     CREATE TABLE IF NOT EXISTS chat_sessions (
       id TEXT PRIMARY KEY,
-      book_id TEXT NOT NULL,
+      book_id TEXT NOT NULL REFERENCES books(id) ON DELETE CASCADE,
       title TEXT,
       summary TEXT,
       created_at INTEGER DEFAULT (strftime('%s','now')),
@@ -506,7 +462,7 @@ var createDb = async () => {
   db.exec(`
     CREATE TABLE IF NOT EXISTS chat_messages (
       id TEXT PRIMARY KEY,
-      session_id TEXT NOT NULL,
+      session_id TEXT NOT NULL REFERENCES chat_sessions(id) ON DELETE CASCADE,
       role TEXT NOT NULL,
       content TEXT NOT NULL,
       token_count INTEGER,
@@ -555,7 +511,10 @@ var mapRow = (row) => ({
   ingestState: row.ingest_state ?? null,
   ingestResumePath: row.ingest_resume_path ?? null,
   summaryBatchId: row.summary_batch_id ?? null,
-  summaryBatchFileId: row.summary_batch_file_id ?? null
+  summaryBatchFileId: row.summary_batch_file_id ?? null,
+  summaryBatchChapters: row.summary_batch_chapters ?? null,
+  summaries: row.summaries ?? null,
+  batchChunks: row.batch_chunks ?? null
 });
 var dbPromise = null;
 var getDb = async () => {
@@ -689,9 +648,12 @@ var getBookSummaryBatchChapters = async (id) => {
 };
 var deleteBook = async (id) => {
   const db = await getDb();
-  db.prepare("DELETE FROM chat_messages WHERE session_id IN (SELECT id FROM chat_sessions WHERE book_id = ?)").run(id);
-  db.prepare("DELETE FROM chat_sessions WHERE book_id = ?").run(id);
-  db.prepare("DELETE FROM books WHERE id = ?").run(id);
+  const deleteAll = db.transaction((bookId) => {
+    db.prepare("DELETE FROM chat_messages WHERE session_id IN (SELECT id FROM chat_sessions WHERE book_id = ?)").run(bookId);
+    db.prepare("DELETE FROM chat_sessions WHERE book_id = ?").run(bookId);
+    db.prepare("DELETE FROM books WHERE id = ?").run(bookId);
+  });
+  deleteAll(id);
 };
 var mapSession = (row) => ({
   id: row.id,
@@ -722,8 +684,8 @@ var insertChatSession = async (session) => {
     bookId: session.bookId,
     title: session.title ?? null,
     summary: session.summary ?? null,
-    createdAt: session.createdAt ?? Date.now(),
-    updatedAt: session.updatedAt ?? Date.now()
+    createdAt: session.createdAt ?? Math.floor(Date.now() / 1e3),
+    updatedAt: session.updatedAt ?? Math.floor(Date.now() / 1e3)
   });
   return session.id;
 };
@@ -768,7 +730,7 @@ var insertChatMessage = async (message) => {
     role: message.role,
     content: message.content,
     tokenCount: message.tokenCount ?? null,
-    createdAt: message.createdAt ?? Date.now()
+    createdAt: message.createdAt ?? Math.floor(Date.now() / 1e3)
   });
   return message.id;
 };
@@ -927,7 +889,7 @@ var ingestEpub = async (filePath, selectedChapterIndices, options) => {
   return { id: bookId, status: "completed" };
 };
 var resumeIngest = async (bookId, storedChunks, batchId, batchFileId) => {
-  const { checkBatchStatus, downloadBatchResults, cleanupBatchFiles } = await import("./batch-embedder-ZJZLNLOK.js");
+  const { checkBatchStatus, downloadBatchResults, cleanupBatchFiles } = await import("./batch-embedder-C2E6OHBQ.js");
   logInfo(`[Resume] Checking embedding batch ${batchId} for book ${bookId}`);
   const status = await checkBatchStatus(batchId);
   logInfo(`[Resume] Batch status: ${status.status} (completed: ${status.completed}/${status.total})`);
@@ -937,7 +899,7 @@ var resumeIngest = async (bookId, storedChunks, batchId, batchFileId) => {
   if (status.status === "failed" || status.status === "expired" || status.status === "cancelled") {
     logWarn(`[Resume] Batch ${batchId} ended with status "${status.status}". Re-submitting...`);
     await cleanupBatchFiles(batchFileId, status.outputFileId);
-    const { submitBatchEmbeddings: submitBatchEmbeddings2 } = await import("./batch-embedder-ZJZLNLOK.js");
+    const { submitBatchEmbeddings: submitBatchEmbeddings2 } = await import("./batch-embedder-C2E6OHBQ.js");
     const { batchId: newBatchId, inputFileId: newFileId } = await submitBatchEmbeddings2(storedChunks);
     await updateBook(bookId, { batchId: newBatchId, batchFileId: newFileId });
     logInfo(`[Resume] New batch submitted (${newBatchId}). Run resume again later.`);
@@ -949,7 +911,7 @@ var resumeIngest = async (bookId, storedChunks, batchId, batchFileId) => {
   if (!status.outputFileId) {
     logWarn(`[Resume] Batch ${batchId} completed but produced no output (${status.failed}/${status.total} failed). Re-submitting...`);
     await cleanupBatchFiles(batchFileId, null);
-    const { submitBatchEmbeddings: submitBatchEmbeddings2 } = await import("./batch-embedder-ZJZLNLOK.js");
+    const { submitBatchEmbeddings: submitBatchEmbeddings2 } = await import("./batch-embedder-C2E6OHBQ.js");
     const { batchId: newBatchId, inputFileId: newFileId } = await submitBatchEmbeddings2(storedChunks);
     await updateBook(bookId, { batchId: newBatchId, batchFileId: newFileId });
     logInfo(`[Resume] New batch submitted (${newBatchId}). Run resume again later.`);
@@ -970,8 +932,8 @@ var resumeIngest = async (bookId, storedChunks, batchId, batchFileId) => {
   return { status: "completed" };
 };
 var resumeSummaryBatch = async (bookId, summaryBatchId, summaryBatchFileId, storedData) => {
-  const { checkBatchStatus, cleanupBatchFiles } = await import("./batch-embedder-ZJZLNLOK.js");
-  const { downloadBatchSummaryResults, submitMergePass, downloadMergeResults } = await import("./batch-summarizer-BMIBVFAE.js");
+  const { checkBatchStatus, cleanupBatchFiles } = await import("./batch-embedder-C2E6OHBQ.js");
+  const { downloadBatchSummaryResults, submitMergePass, downloadMergeResults } = await import("./batch-summarizer-CM3NO7TK.js");
   logInfo(`[Resume] Checking summary batch ${summaryBatchId} for book ${bookId}`);
   const status = await checkBatchStatus(summaryBatchId);
   logInfo(`[Resume] Summary batch status: ${status.status} (completed: ${status.completed}/${status.total})`);
@@ -981,7 +943,7 @@ var resumeSummaryBatch = async (bookId, summaryBatchId, summaryBatchFileId, stor
   if (status.status === "failed" || status.status === "expired" || status.status === "cancelled") {
     logWarn(`[Resume] Summary batch ${summaryBatchId} ended with status "${status.status}". Re-submitting...`);
     await cleanupBatchFiles(summaryBatchFileId, status.outputFileId);
-    const { submitBatchSummaries: submitBatchSummaries2 } = await import("./batch-summarizer-BMIBVFAE.js");
+    const { submitBatchSummaries: submitBatchSummaries2 } = await import("./batch-summarizer-CM3NO7TK.js");
     const { batchId: newBatchId, inputFileId: newFileId, metadata: newMetadata } = await submitBatchSummaries2(storedData.chapters);
     await updateBook(bookId, {
       summaryBatchId: newBatchId,
@@ -997,7 +959,7 @@ var resumeSummaryBatch = async (bookId, summaryBatchId, summaryBatchFileId, stor
   if (!status.outputFileId) {
     logWarn(`[Resume] Summary batch ${summaryBatchId} completed but produced no output (${status.failed}/${status.total} failed). Re-submitting...`);
     await cleanupBatchFiles(summaryBatchFileId, null);
-    const { submitBatchSummaries: submitBatchSummaries2 } = await import("./batch-summarizer-BMIBVFAE.js");
+    const { submitBatchSummaries: submitBatchSummaries2 } = await import("./batch-summarizer-CM3NO7TK.js");
     const { batchId: newBatchId, inputFileId: newFileId, metadata: newMetadata } = await submitBatchSummaries2(storedData.chapters);
     await updateBook(bookId, {
       summaryBatchId: newBatchId,
@@ -1031,8 +993,8 @@ var resumeSummaryBatch = async (bookId, summaryBatchId, summaryBatchFileId, stor
   return await finalizeSummariesAndSubmitEmbeddings(bookId, summaries, storedData);
 };
 var resumeMergeBatch = async (bookId, summaryBatchId, summaryBatchFileId, storedData) => {
-  const { checkBatchStatus, cleanupBatchFiles } = await import("./batch-embedder-ZJZLNLOK.js");
-  const { downloadMergeResults } = await import("./batch-summarizer-BMIBVFAE.js");
+  const { checkBatchStatus, cleanupBatchFiles } = await import("./batch-embedder-C2E6OHBQ.js");
+  const { downloadMergeResults } = await import("./batch-summarizer-CM3NO7TK.js");
   logInfo(`[Resume] Checking merge batch ${summaryBatchId} for book ${bookId}`);
   const status = await checkBatchStatus(summaryBatchId);
   logInfo(`[Resume] Merge batch status: ${status.status} (completed: ${status.completed}/${status.total})`);
@@ -1054,7 +1016,7 @@ var resumeMergeBatch = async (bookId, summaryBatchId, summaryBatchFileId, stored
   return await finalizeSummariesAndSubmitEmbeddings(bookId, allSummaries, storedData);
 };
 var finalizeSummariesAndSubmitEmbeddings = async (bookId, summaries, storedData) => {
-  const { submitBatchEmbeddings: submitBatchEmbeddings2 } = await import("./batch-embedder-ZJZLNLOK.js");
+  const { submitBatchEmbeddings: submitBatchEmbeddings2 } = await import("./batch-embedder-C2E6OHBQ.js");
   const summaryRecords = summaries.map((s) => ({
     ...s,
     chapterIndex: storedData.selectedIndices[s.chapterIndex] ?? s.chapterIndex
@@ -1246,7 +1208,7 @@ NOTES
 // src/commands/list.ts
 var formatDate = (timestamp) => {
   if (!timestamp) return "-";
-  return new Date(timestamp).toISOString().slice(0, 10);
+  return new Date(timestamp * 1e3).toISOString().slice(0, 10);
 };
 var listCommand = async () => {
   await ensureDataDirs();
@@ -1255,8 +1217,8 @@ var listCommand = async () => {
     stdout("No books indexed yet.");
     return;
   }
-  stdout("ID       | Title | Author | Chunks | Indexed | Status");
-  stdout("---------|-------|--------|--------|--------|-------");
+  stdout("ID       | Title | Author | Chunks | Indexed    | Status");
+  stdout("---------|-------|--------|--------|------------|-------");
   for (const book of books) {
     const shortId = book.id.slice(0, 8);
     const title = book.title;
@@ -1324,10 +1286,38 @@ var registerBookShow = (program2) => {
 // src/commands/ask.ts
 import { embed, streamText } from "ai";
 import { openai as openai3 } from "@ai-sdk/openai";
+
+// src/shared/utils.ts
+var CHARS_PER_TOKEN3 = 4;
+var estimateTokens2 = (text) => Math.ceil(text.length / CHARS_PER_TOKEN3);
+var renderSources = (sources) => {
+  if (sources.length === 0) return "";
+  const lines = sources.map((match, index) => {
+    const title = match.chapterTitle || `Chapter ${match.chapterIndex + 1}`;
+    const excerpt = match.content.slice(0, 120).replace(/\s+/g, " ");
+    return `[${index + 1}] ${title}: ${excerpt}`;
+  });
+  return `
+Sources:
+${lines.join("\n")}`;
+};
+var resolveMaxChapter = (book, maxChapterOption) => {
+  const narrativeStart = book.narrativeStartIndex ?? 0;
+  const userProgress = book.progressChapter ?? null;
+  if (maxChapterOption !== void 0) {
+    return narrativeStart + maxChapterOption;
+  }
+  if (userProgress !== null) {
+    return narrativeStart + userProgress;
+  }
+  return void 0;
+};
 var formatContext = (chunks) => chunks.map(
   (chunk, index) => `Excerpt [${index + 1}] (${chunk.chapterTitle || `Chapter ${chunk.chapterIndex + 1}`}):
 ${chunk.content}`
 ).join("\n\n");
+
+// src/commands/ask.ts
 var askCommand = async (id, question, options) => {
   if (!await isAskEnabled()) {
     throw new Error("Ask is disabled in config (askEnabled: false). Enable it to use this command.");
@@ -1347,9 +1337,7 @@ var askCommand = async (id, question, options) => {
     model: openai3.embeddingModel(models.embedding),
     value: question
   });
-  const narrativeStart = book.narrativeStartIndex ?? 0;
-  const userProgress = book.progressChapter ?? null;
-  const maxChapterIndex = options.maxChapter !== void 0 ? narrativeStart + options.maxChapter : userProgress !== null ? narrativeStart + userProgress : void 0;
+  const maxChapterIndex = resolveMaxChapter(book, options.maxChapter);
   const retrievalLimit = options.topK * 3;
   const allMatches = await queryBookIndex(resolvedId, embedding, question, retrievalLimit, maxChapterIndex);
   const summaries = allMatches.filter((m) => m.type === "summary");
@@ -1383,28 +1371,20 @@ ${context}`
   } finally {
     releaseSigint();
   }
-  if (selectedMatches.length > 0) {
-    process.stdout.write("\n\nSources:\n");
-    selectedMatches.forEach((match, index) => {
-      const title = match.chapterTitle || `Chapter ${match.chapterIndex + 1}`;
-      const excerpt = match.content.slice(0, 120).replace(/\s+/g, " ");
-      process.stdout.write(`[${index + 1}] ${title}: ${excerpt}
-`);
-    });
-  }
+  stdout(renderSources(selectedMatches));
 };
 
 // src/commands/query-options.ts
 var parseQueryOptions = (options) => {
   const topK = Number(options.topK);
-  if (!Number.isFinite(topK) || topK <= 0) {
-    throw new Error("--top-k must be a positive number.");
+  if (!Number.isFinite(topK) || topK <= 0 || !Number.isInteger(topK)) {
+    throw new Error("--top-k must be a positive integer.");
   }
   let maxChapter;
   if (options.maxChapter !== void 0) {
     const parsed = Number(options.maxChapter);
-    if (!Number.isFinite(parsed) || parsed < 0) {
-      throw new Error("--max-chapter must be a non-negative number.");
+    if (!Number.isFinite(parsed) || parsed < 0 || !Number.isInteger(parsed)) {
+      throw new Error("--max-chapter must be a non-negative integer.");
     }
     maxChapter = parsed;
   }
@@ -1413,7 +1393,14 @@ var parseQueryOptions = (options) => {
 
 // src/commands/book/ask.ts
 var registerBookAsk = (program2) => {
-  program2.command("ask").description("Ask a question about a book").argument("<id>", "Book id or prefix").argument("<question>", "Question to ask").option("--top-k <n>", "Number of passages to retrieve", "5").option("--max-chapter <n>", "Spoiler-free limit (0-based within narrative)").action(async (id, question, options) => {
+  program2.command("ask").description("Ask a question about a book").argument("<id>", "Book id or prefix").argument("<question>", "Question to ask").option("--top-k <n>", "Number of passages to retrieve", "5").option("--max-chapter <n>", "Spoiler-free limit (0-based within narrative)").addHelpText(
+    "after",
+    `
+EXAMPLES
+  mycroft book ask 8f2c1a4b "Who is the main character?"
+  mycroft book ask 8f2c1a4b "What happened in chapter 3?" --max-chapter 3
+`
+  ).action(async (id, question, options) => {
     const { topK, maxChapter } = parseQueryOptions(options);
     await askCommand(id, question, { topK, maxChapter });
   });
@@ -1438,7 +1425,7 @@ var searchCommand = async (id, query, options) => {
     model: openai4.embeddingModel(models.embedding),
     value: query
   });
-  const maxChapterIndex = options.maxChapter !== void 0 ? (book.narrativeStartIndex ?? 0) + options.maxChapter : book.progressChapter !== null ? (book.narrativeStartIndex ?? 0) + (book.progressChapter ?? 0) : void 0;
+  const maxChapterIndex = resolveMaxChapter(book, options.maxChapter);
   const results = await queryBookIndex(resolvedId, embedding, query, options.topK, maxChapterIndex);
   if (results.length === 0) {
     stdout("No results.");
@@ -1456,7 +1443,14 @@ var searchCommand = async (id, query, options) => {
 
 // src/commands/book/search.ts
 var registerBookSearch = (program2) => {
-  program2.command("search").description("Vector search without LLM").argument("<id>", "Book id or prefix").argument("<query>", "Search query").option("--top-k <n>", "Number of passages to retrieve", "5").option("--max-chapter <n>", "Spoiler-free limit (0-based within narrative)").action(async (id, query, options) => {
+  program2.command("search").description("Vector search without LLM").argument("<id>", "Book id or prefix").argument("<query>", "Search query").option("--top-k <n>", "Number of passages to retrieve", "5").option("--max-chapter <n>", "Spoiler-free limit (0-based within narrative)").addHelpText(
+    "after",
+    `
+EXAMPLES
+  mycroft book search 8f2c1a4b "the storm scene"
+  mycroft book search 8f2c1a4b "betrayal" --top-k 10
+`
+  ).action(async (id, query, options) => {
     const { topK, maxChapter } = parseQueryOptions(options);
     await searchCommand(id, query, { topK, maxChapter });
   });
@@ -1487,14 +1481,23 @@ var deleteCommand = async (id, options) => {
   await deleteBook(resolvedId);
   await deleteBookIndex(resolvedId);
   if (book.epubPath) {
-    await unlink2(book.epubPath).catch(() => void 0);
+    await unlink2(book.epubPath).catch((err) => {
+      if (err.code !== "ENOENT") throw err;
+    });
   }
   stdout(`Deleted book ${book.id}`);
 };
 
 // src/commands/book/delete.ts
 var registerBookDelete = (program2) => {
-  program2.command("delete").description("Remove book, EPUB, and vectors").argument("<id>", "Book id or prefix").option("--force", "Skip confirmation").action(async (id, options) => {
+  program2.command("delete").description("Remove book, EPUB, and vectors").argument("<id>", "Book id or prefix").option("--force", "Skip confirmation").addHelpText(
+    "after",
+    `
+EXAMPLES
+  mycroft book delete 8f2c1a4b
+  mycroft book delete 8f2c1a4b --force
+`
+  ).action(async (id, options) => {
     await deleteCommand(id, { force: options.force });
   });
 };
@@ -1521,7 +1524,12 @@ var resumeCommand = async (id) => {
     if (!rawData) {
       throw new Error(`No stored summary batch data for book "${book.title}". Re-ingest with "mycroft book ingest --batch --summary".`);
     }
-    const storedData = JSON.parse(rawData);
+    let storedData;
+    try {
+      storedData = JSON.parse(rawData);
+    } catch {
+      throw new Error(`Corrupt summary batch data for book "${book.title}". Re-ingest with "mycroft book ingest --batch --summary".`);
+    }
     let result2;
     if (storedData.isMergePass) {
       result2 = await resumeMergeBatch(resolvedId, book.summaryBatchId, book.summaryBatchFileId ?? book.summaryBatchId, storedData);
@@ -1556,7 +1564,12 @@ Summary batch still in progress (${result2.status}: ${result2.completed}/${resul
     if (!rawChunks) {
       throw new Error(`No stored chunks found for book "${book.title}". Re-ingest with "mycroft book ingest --batch".`);
     }
-    const chunks = JSON.parse(rawChunks);
+    let chunks;
+    try {
+      chunks = JSON.parse(rawChunks);
+    } catch {
+      throw new Error(`Corrupt chunk data for book "${book.title}". Re-ingest with "mycroft book ingest --batch".`);
+    }
     const result2 = await resumeIngest(resolvedId, chunks, book.batchId, book.batchFileId ?? book.batchId);
     if (result2.status === "completed") {
       stdout(`
@@ -1624,7 +1637,7 @@ Status: completed`);
   }
   if (book.summaryBatchId) {
     requireOpenAIKey();
-    const { checkBatchStatus } = await import("./batch-embedder-ZJZLNLOK.js");
+    const { checkBatchStatus } = await import("./batch-embedder-C2E6OHBQ.js");
     const status = await checkBatchStatus(book.summaryBatchId);
     stdout(`
 Status: summary batch ${status.status}`);
@@ -1653,7 +1666,7 @@ Summary batch still processing.`);
   }
   if (book.batchId) {
     requireOpenAIKey();
-    const { checkBatchStatus } = await import("./batch-embedder-ZJZLNLOK.js");
+    const { checkBatchStatus } = await import("./batch-embedder-C2E6OHBQ.js");
     const status = await checkBatchStatus(book.batchId);
     stdout(`
 Status: embedding batch ${status.status}`);
@@ -1835,16 +1848,11 @@ var registerConfigOnboard = (program2) => {
 
 // src/services/chat.ts
 import { randomUUID as randomUUID2 } from "crypto";
-import { embed as embed3, generateText as generateText2 } from "ai";
+import { embed as embed3, generateText as generateText2, streamText as streamText2 } from "ai";
 import { openai as openai5 } from "@ai-sdk/openai";
 var MAX_RECENT_MESSAGES = 12;
 var SUMMARY_TRIGGER_MESSAGES = 24;
 var SUMMARY_TARGET_WORDS2 = 160;
-var formatContext2 = (chunks) => chunks.map(
-  (chunk, index) => `Excerpt [${index + 1}] (${chunk.chapterTitle || `Chapter ${chunk.chapterIndex + 1}`}):
-${chunk.content}`
-).join("\n\n");
-var estimateTokens2 = (text) => Math.ceil(text.length / 4);
 var summarizeMessages = async (messages) => {
   const transcript = messages.map((message) => `${message.role.toUpperCase()}: ${message.content}`).join("\n\n");
   const models = await getModels();
@@ -1908,9 +1916,7 @@ var chatAsk = async (sessionId, question, options) => {
     model: openai5.embeddingModel(models.embedding),
     value: question
   });
-  const narrativeStart = book.narrativeStartIndex ?? 0;
-  const userProgress = book.progressChapter ?? null;
-  const maxChapterIndex = options.maxChapter !== void 0 ? narrativeStart + options.maxChapter : userProgress !== null ? narrativeStart + userProgress : void 0;
+  const maxChapterIndex = resolveMaxChapter(book, options.maxChapter);
   const retrievalLimit = options.topK * 3;
   const allMatches = await queryBookIndex(session.bookId, embedding, question, retrievalLimit, maxChapterIndex);
   const summaries = allMatches.filter((m) => m.type === "summary");
@@ -1918,26 +1924,17 @@ var chatAsk = async (sessionId, question, options) => {
   const topSummaries = summaries.slice(0, 2);
   const topChunks = chunks.slice(0, Math.max(0, options.topK - topSummaries.length));
   const selectedMatches = [...topSummaries, ...topChunks];
-  const context = formatContext2(selectedMatches);
+  const context = formatContext(selectedMatches);
   const messages = await getChatMessages(sessionId);
   const conversation = buildConversationContext(session, messages);
-  const now = Date.now();
-  const userMessage = {
-    id: randomUUID2(),
-    sessionId,
-    role: "user",
-    content: question,
-    tokenCount: estimateTokens2(question),
-    createdAt: now
-  };
-  await insertChatMessage(userMessage);
+  const now = Math.floor(Date.now() / 1e3);
   const prompt2 = [
     conversation ? `Conversation:
 ${conversation}` : "",
     `Question: ${question}`,
     context
   ].filter(Boolean).join("\n\n");
-  const { text } = await generateText2({
+  const stream = streamText2({
     model: openai5(models.chat),
     system: `You are a reading companion helping readers understand this book.
 
@@ -1952,6 +1949,16 @@ Guidelines:
 - The context may be limited to earlier chapters only - don't infer beyond what's provided`,
     prompt: prompt2
   });
+  const text = await stream.text;
+  const userMessage = {
+    id: randomUUID2(),
+    sessionId,
+    role: "user",
+    content: question,
+    tokenCount: estimateTokens2(question),
+    createdAt: now
+  };
+  await insertChatMessage(userMessage);
   const assistantMessage = {
     id: randomUUID2(),
     sessionId,
@@ -1961,7 +1968,7 @@ Guidelines:
     createdAt: now
   };
   await insertChatMessage(assistantMessage);
-  const updatedAt = Date.now();
+  const updatedAt = Math.floor(Date.now() / 1e3);
   await updateChatSession(sessionId, { updatedAt });
   await maybeSummarizeSession(session, [...messages, userMessage, assistantMessage], updatedAt);
   return { answer: text, sources: selectedMatches };
@@ -1998,21 +2005,14 @@ var registerChatAsk = (program2) => {
     }
     const { answer, sources } = await chatAsk(resolvedId, question, { topK, maxChapter });
     stdout(answer);
-    if (sources.length > 0) {
-      stdout("\nSources:");
-      sources.forEach((match, index) => {
-        const title = match.chapterTitle || `Chapter ${match.chapterIndex + 1}`;
-        const excerpt = match.content.slice(0, 120).replace(/\s+/g, " ");
-        stdout(`[${index + 1}] ${title}: ${excerpt}`);
-      });
-    }
+    stdout(renderSources(sources));
   });
 };
 
 // src/commands/chat/list.ts
 var formatDate2 = (timestamp) => {
   if (!timestamp) return "-";
-  return new Date(timestamp).toISOString().slice(0, 10);
+  return new Date(timestamp * 1e3).toISOString().slice(0, 10);
 };
 var registerChatList = (program2) => {
   program2.command("list").description("List chat sessions").action(async () => {
@@ -2092,14 +2092,7 @@ var registerChatRepl = (program2) => {
       const { answer, sources } = await chatAsk(session.id, question, { topK, maxChapter });
       stdout(`
 ${answer}`);
-      if (sources.length > 0) {
-        stdout("\nSources:");
-        sources.forEach((match, index) => {
-          const title = match.chapterTitle || `Chapter ${match.chapterIndex + 1}`;
-          const excerpt = match.content.slice(0, 120).replace(/\s+/g, " ");
-          stdout(`[${index + 1}] ${title}: ${excerpt}`);
-        });
-      }
+      stdout(renderSources(sources));
       stdout("");
     }
   });