@kienmatu/inkos 0.1.0

package/dist/book-backup.d.ts

@@ -0,0 +1,33 @@
+export interface BookBackupInfo {
+    readonly id: string;
+    readonly createdAt: string;
+}
+export interface CreateBookBackupOptions {
+    /** Injectable clock so tests do not depend on real time. */
+    readonly now?: () => Date;
+    /** Appended to the backup id, e.g. "pre-restore". */
+    readonly suffix?: string;
+}
+export interface CreateBookBackupResult {
+    readonly bookId: string;
+    readonly backupId: string;
+    readonly path: string;
+}
+export interface RestoreBookBackupOptions {
+    readonly now?: () => Date;
+}
+export interface RestoreBookBackupResult {
+    readonly bookId: string;
+    readonly restoredFrom: string;
+    /** Auto-backup of the pre-restore state; null when the book directory did not exist. */
+    readonly preRestoreBackupId: string | null;
+}
+/**
+ * Whole-book backups live OUTSIDE books/ (at .inkos/backups/<bookId>/<backupId>/),
+ * so a backup never recursively contains other backups.
+ */
+export declare function bookBackupsDir(root: string, bookId: string): string;
+export declare function createBookBackup(root: string, bookId: string, options?: CreateBookBackupOptions): Promise<CreateBookBackupResult>;
+export declare function listBookBackups(root: string, bookId: string): Promise<ReadonlyArray<BookBackupInfo>>;
+export declare function restoreBookBackup(root: string, bookId: string, backupId: string, options?: RestoreBookBackupOptions): Promise<RestoreBookBackupResult>;
+//# sourceMappingURL=book-backup.d.ts.map

package/dist/book-backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"book-backup.d.ts","sourceRoot":"","sources":["../src/book-backup.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,wFAAwF;IACxF,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAoBjC;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAmBxC;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,uBAAuB,CAAC,CA4BlC"}

package/dist/book-backup.js

@@ -0,0 +1,74 @@
+import { access, cp, mkdir, readdir, rm, stat } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * Whole-book backups live OUTSIDE books/ (at .inkos/backups/<bookId>/<backupId>/),
+ * so a backup never recursively contains other backups.
+ */
+export function bookBackupsDir(root, bookId) {
+    return join(root, ".inkos", "backups", bookId);
+}
+export async function createBookBackup(root, bookId, options = {}) {
+    const bookDir = join(root, "books", bookId);
+    const bookInfo = await stat(bookDir).catch(() => null);
+    if (!bookInfo?.isDirectory()) {
+        throw new Error(`Book "${bookId}" not found at books/${bookId}/.`);
+    }
+    const backupsDir = bookBackupsDir(root, bookId);
+    await mkdir(backupsDir, { recursive: true });
+    const clock = options.now ?? (() => new Date());
+    const base = options.suffix ? `${formatStamp(clock())}-${options.suffix}` : formatStamp(clock());
+    let backupId = base;
+    for (let attempt = 2; await pathExists(join(backupsDir, backupId)); attempt += 1) {
+        backupId = `${base}-${attempt}`;
+    }
+    const backupPath = join(backupsDir, backupId);
+    await cp(bookDir, backupPath, { recursive: true });
+    return { bookId, backupId, path: backupPath };
+}
+export async function listBookBackups(root, bookId) {
+    const backupsDir = bookBackupsDir(root, bookId);
+    const entries = await readdir(backupsDir, { withFileTypes: true }).catch((error) => {
+        if (error.code === "ENOENT") {
+            return [];
+        }
+        throw error;
+    });
+    const backups = await Promise.all(entries
+        .filter((entry) => entry.isDirectory())
+        .map(async (entry) => {
+        const info = await stat(join(backupsDir, entry.name));
+        return { id: entry.name, createdAt: info.mtime.toISOString() };
+    }));
+    // Backup ids start with a UTC timestamp, so a descending id sort is newest-first.
+    return backups.sort((a, b) => b.id.localeCompare(a.id));
+}
+export async function restoreBookBackup(root, bookId, backupId, options = {}) {
+    // backupId comes from CLI input and is joined into a path — keep it a single
+    // safe path component.
+    if (!/^[A-Za-z0-9._-]+$/.test(backupId) || backupId === "." || backupId === "..") {
+        throw new Error(`Invalid backup id "${backupId}": a backup id must be a single directory name.`);
+    }
+    const backupPath = join(bookBackupsDir(root, bookId), backupId);
+    const backupInfo = await stat(backupPath).catch(() => null);
+    if (!backupInfo?.isDirectory()) {
+        throw new Error(`Backup "${backupId}" not found for book "${bookId}". `
+            + `List available backups with: inkos book backup ${bookId} --list`);
+    }
+    const bookDir = join(root, "books", bookId);
+    const bookExists = await stat(bookDir).then((info) => info.isDirectory()).catch(() => false);
+    let preRestoreBackupId = null;
+    if (bookExists) {
+        const preRestore = await createBookBackup(root, bookId, { now: options.now, suffix: "pre-restore" });
+        preRestoreBackupId = preRestore.backupId;
+    }
+    await rm(bookDir, { recursive: true, force: true });
+    await cp(backupPath, bookDir, { recursive: true });
+    return { bookId, restoredFrom: backupId, preRestoreBackupId };
+}
+function formatStamp(date) {
+    return date.toISOString().slice(0, 19).replace(/[-:]/g, "").replace("T", "-");
+}
+async function pathExists(path) {
+    return access(path).then(() => true).catch(() => false);
+}
+//# sourceMappingURL=book-backup.js.map

package/dist/book-backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"book-backup.js","sourceRoot":"","sources":["../src/book-backup.ts"],"names":[],"mappings":"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"}

package/dist/commands/agent.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const agentCommand: Command;
+//# sourceMappingURL=agent.d.ts.map

package/dist/commands/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,YAAY,SAsErB,CAAC"}

package/dist/commands/agent.js

@@ -0,0 +1,71 @@
+import { Command } from "commander";
+import { PipelineRunner, runAgentSession, toWritingLanguage } from "@kienmatu/inkos-core";
+import { buildPipelineConfig, loadConfig, createClient, findProjectRoot, resolveBookId, resolveContext, log, logError } from "../utils.js";
+export const agentCommand = new Command("agent")
+    .description("Natural language agent mode (LLM orchestrates via tool-use)")
+    .argument("<instruction>", "Natural language instruction")
+    .option("--book <bookId>", "Bind this request to an existing book")
+    .option("--session <sessionId>", "Reuse an agent session id")
+    .option("--context <text>", "Additional context (natural language)")
+    .option("--context-file <path>", "Read additional context from file")
+    .option("--json", "Output JSON (suppress progress messages)")
+    .option("--quiet", "Suppress non-JSON console output")
+    .action(async (instruction, opts) => {
+    try {
+        const config = await loadConfig();
+        const client = createClient(config);
+        const root = findProjectRoot();
+        const context = await resolveContext(opts);
+        const fullInstruction = context
+            ? `${instruction}\n\n补充信息：${context}`
+            : instruction;
+        const bookId = opts.book ? await resolveBookId(opts.book, root) : null;
+        const trimmed = fullInstruction.trim();
+        const actionSource = trimmed.startsWith("/") ? "slash" : "free-text";
+        const requestedIntent = bookId && trimmed === "/write"
+            ? "write_next"
+            : !bookId && trimmed === "/create"
+                ? "create_book"
+                : undefined;
+        const sessionKind = bookId
+            ? "book"
+            : requestedIntent === "create_book"
+                ? "book-create"
+                : "chat";
+        const sessionId = opts.session?.trim() || `cli-agent-${Date.now().toString(36)}`;
+        const pipeline = new PipelineRunner(buildPipelineConfig(config, root, {
+            externalContext: context,
+            quiet: opts.quiet || opts.json,
+        }));
+        const result = await runAgentSession({
+            sessionId,
+            bookId,
+            sessionKind,
+            actionSource,
+            requestedIntent,
+            language: toWritingLanguage(config.language),
+            pipeline,
+            projectRoot: root,
+            model: client._piModel
+                ? client._piModel
+                : { provider: config.llm.provider ?? "openai", modelId: config.llm.model },
+            apiKey: client._apiKey,
+        }, fullInstruction);
+        if (opts.json) {
+            log(JSON.stringify({ result }));
+        }
+        else if (!opts.quiet && result.responseText.trim()) {
+            log(result.responseText);
+        }
+    }
+    catch (e) {
+        if (opts.json) {
+            log(JSON.stringify({ error: String(e) }));
+        }
+        else {
+            logError(`Agent failed: ${e}`);
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=agent.js.map

package/dist/commands/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"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"}

package/dist/commands/analytics.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const analyticsCommand: Command;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/commands/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/commands/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,gBAAgB,SAwEzB,CAAC"}

package/dist/commands/analytics.js

@@ -0,0 +1,74 @@
+import { Command } from "commander";
+import { StateManager, computeAnalytics } from "@kienmatu/inkos-core";
+import { loadConfig, findProjectRoot, resolveBookId, log, logError } from "../utils.js";
+export const analyticsCommand = new Command("analytics")
+    .alias("stats")
+    .description("Show analytics and token stats for a book")
+    .argument("[book-id]", "Book ID (auto-detected if only one book)")
+    .option("--json", "Output JSON")
+    .action(async (bookIdArg, opts) => {
+    try {
+        await loadConfig();
+        const root = findProjectRoot();
+        const bookId = await resolveBookId(bookIdArg, root);
+        const state = new StateManager(root);
+        const chapters = await state.loadChapterIndex(bookId);
+        const analytics = computeAnalytics(bookId, chapters);
+        if (opts.json) {
+            log(JSON.stringify(analytics, null, 2));
+        }
+        else {
+            log(`Analytics for "${bookId}":`);
+            log("");
+            log(`  Total chapters: ${analytics.totalChapters}`);
+            log(`  Total words: ${analytics.totalWords.toLocaleString()}`);
+            log(`  Avg words/chapter: ${analytics.avgWordsPerChapter.toLocaleString()}`);
+            log(`  Audit pass rate: ${analytics.auditPassRate}%`);
+            log("");
+            if (Object.keys(analytics.statusDistribution).length > 0) {
+                log("  Status distribution:");
+                for (const [status, count] of Object.entries(analytics.statusDistribution)) {
+                    log(`    ${status}: ${count}`);
+                }
+                log("");
+            }
+            if (analytics.tokenStats) {
+                log("  Token usage:");
+                log(`    Total tokens: ${analytics.tokenStats.totalTokens.toLocaleString()}`);
+                log(`    Prompt tokens: ${analytics.tokenStats.totalPromptTokens.toLocaleString()}`);
+                log(`    Completion tokens: ${analytics.tokenStats.totalCompletionTokens.toLocaleString()}`);
+                log(`    Avg tokens/chapter: ${analytics.tokenStats.avgTokensPerChapter.toLocaleString()}`);
+                if (analytics.tokenStats.recentTrend.length > 0) {
+                    log("    Recent trend:");
+                    for (const { chapter, totalTokens } of analytics.tokenStats.recentTrend) {
+                        log(`      Ch.${chapter}: ${totalTokens.toLocaleString()} tokens`);
+                    }
+                }
+                log("");
+            }
+            if (analytics.topIssueCategories.length > 0) {
+                log("  Most common issue categories:");
+                for (const { category, count } of analytics.topIssueCategories) {
+                    log(`    ${category}: ${count}`);
+                }
+                log("");
+            }
+            if (analytics.chaptersWithMostIssues.length > 0) {
+                log("  Chapters with most issues:");
+                for (const { chapter, issueCount } of analytics.chaptersWithMostIssues) {
+                    log(`    Ch.${chapter}: ${issueCount} issues`);
+                }
+            }
+        }
+    }
+    catch (e) {
+        if (opts.json) {
+            log(JSON.stringify({ error: String(e) }));
+        }
+        else {
+            logError(`Analytics failed: ${e}`);
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=analytics.js.map

package/dist/commands/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/commands/analytics.ts"],"names":[],"mappings":"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"}

package/dist/commands/audit.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const auditCommand: Command;
+//# sourceMappingURL=audit.d.ts.map

package/dist/commands/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,eAAO,MAAM,YAAY,SA4ErB,CAAC"}

package/dist/commands/audit.js

@@ -0,0 +1,81 @@
+import { Command } from "commander";
+import { PipelineRunner, StateManager } from "@kienmatu/inkos-core";
+import { loadConfig, buildPipelineConfig, findProjectRoot, resolveBookId, log, logError } from "../utils.js";
+import { formatNotifyAuditBody, formatNotifyCommandTitle, formatNotifyFailureBody, resolveCliLanguage, } from "../localization.js";
+import { sendCommandNotification } from "../notify-helper.js";
+export const auditCommand = new Command("audit")
+    .description("Audit a chapter for continuity issues")
+    .argument("[book-id]", "Book ID (auto-detected if only one book)")
+    .argument("[chapter]", "Chapter number (defaults to latest)")
+    .option("--json", "Output JSON")
+    .option("--notify", "Send a notification to configured notify channels when the command finishes")
+    .action(async (bookIdArg, chapterStr, opts) => {
+    let notifyLanguage = "zh";
+    let notifyBookName;
+    try {
+        const config = await loadConfig();
+        const root = findProjectRoot();
+        // If first arg looks like a number, treat it as chapter (auto-detect book)
+        let bookId;
+        let chapterNumber;
+        if (bookIdArg && /^\d+$/.test(bookIdArg)) {
+            bookId = await resolveBookId(undefined, root);
+            chapterNumber = parseInt(bookIdArg, 10);
+        }
+        else {
+            bookId = await resolveBookId(bookIdArg, root);
+            chapterNumber = chapterStr ? parseInt(chapterStr, 10) : undefined;
+        }
+        const state = new StateManager(root);
+        const book = await state.loadBookConfig(bookId);
+        const language = resolveCliLanguage(book.language);
+        notifyLanguage = language;
+        notifyBookName = book.title ?? bookId;
+        const pipeline = new PipelineRunner(buildPipelineConfig(config, root));
+        if (!opts.json)
+            log(`Auditing "${bookId}"${chapterNumber ? ` chapter ${chapterNumber}` : " (latest)"}...`);
+        const result = await pipeline.auditDraft(bookId, chapterNumber);
+        if (opts.json) {
+            log(JSON.stringify(result, null, 2));
+        }
+        else {
+            log(`  Chapter ${result.chapterNumber}: ${result.passed ? "PASSED" : "FAILED"}`);
+            log(`  Summary: ${result.summary}`);
+            if (result.issues.length > 0) {
+                log("  Issues:");
+                for (const issue of result.issues) {
+                    log(`    [${issue.severity}] ${issue.category}: ${issue.description}`);
+                }
+            }
+        }
+        // Unlike write commands, the pipeline sends no notification for
+        // auditDraft, so --notify always sends the completion notification here.
+        if (opts.notify) {
+            await sendCommandNotification({
+                title: formatNotifyCommandTitle(language, "audit", notifyBookName, true),
+                body: formatNotifyAuditBody(language, {
+                    chapterNumber: result.chapterNumber,
+                    passed: result.passed,
+                    issueCount: result.issues.length,
+                    summary: result.summary,
+                }),
+            }, config);
+        }
+    }
+    catch (e) {
+        if (opts.notify) {
+            await sendCommandNotification({
+                title: formatNotifyCommandTitle(notifyLanguage, "audit", notifyBookName, false),
+                body: formatNotifyFailureBody(notifyLanguage, e),
+            });
+        }
+        if (opts.json) {
+            log(JSON.stringify({ error: String(e) }));
+        }
+        else {
+            logError(`Audit failed: ${e}`);
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=audit.js.map

package/dist/commands/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"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"}

package/dist/commands/auto.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const autoCommand: Command;
+//# sourceMappingURL=auto.d.ts.map

package/dist/commands/auto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto.d.ts","sourceRoot":"","sources":["../../src/commands/auto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,eAAO,MAAM,WAAW,SAuIpB,CAAC"}

package/dist/commands/auto.js

@@ -0,0 +1,136 @@
+import { Command } from "commander";
+import { PipelineRunner, StateManager } from "@kienmatu/inkos-core";
+import { loadConfig, buildPipelineConfig, findProjectRoot, getLegacyMigrationHint, resolveBookId, log, logError } from "../utils.js";
+import { formatAutoWriteAlreadyComplete, formatAutoWriteStart, formatNotifyBatchWriteBody, formatNotifyCommandTitle, formatNotifyFailureBody, formatWriteNextComplete, formatWriteNextProgress, formatWriteNextResultLines, resolveCliLanguage, } from "../localization.js";
+import { sendCommandNotification } from "../notify-helper.js";
+export const autoCommand = new Command("auto")
+    .description("Auto-write chapters until the book reaches a target chapter number: auto [book-id] <target-chapter>")
+    .argument("<args...>", "Book ID (optional, auto-detected if only one book) and target chapter number")
+    .option("--words <n>", "Words per chapter (overrides book config)")
+    .option("--json", "Output JSON")
+    .option("-q, --quiet", "Suppress console output")
+    .option("--notify", "Send a notification to configured notify channels when the command finishes")
+    .action(async (args, opts) => {
+    let notifyLanguage = "zh";
+    let notifyBookName;
+    try {
+        const root = findProjectRoot();
+        let bookId;
+        let targetChapter;
+        if (args.length === 1) {
+            targetChapter = parseInt(args[0], 10);
+            if (isNaN(targetChapter))
+                throw new Error(`Expected target chapter number, got "${args[0]}"`);
+            bookId = await resolveBookId(undefined, root);
+        }
+        else if (args.length === 2) {
+            targetChapter = parseInt(args[1], 10);
+            if (isNaN(targetChapter))
+                throw new Error(`Expected target chapter number, got "${args[1]}"`);
+            bookId = await resolveBookId(args[0], root);
+        }
+        else {
+            throw new Error("Usage: inkos auto [book-id] <target-chapter>");
+        }
+        if (targetChapter < 1) {
+            throw new Error(`Target chapter must be >= 1, got ${targetChapter}`);
+        }
+        const state = new StateManager(root);
+        const book = await state.loadBookConfig(bookId);
+        const language = resolveCliLanguage(book.language);
+        notifyLanguage = language;
+        notifyBookName = book.title ?? bookId;
+        const migrationHint = await getLegacyMigrationHint(root, bookId);
+        if (migrationHint && !opts.json) {
+            log(`[migration] ${migrationHint}`);
+        }
+        const startChapter = await state.getNextChapterNumber(bookId);
+        if (startChapter > targetChapter) {
+            if (opts.json) {
+                log(JSON.stringify([], null, 2));
+            }
+            else {
+                log(formatAutoWriteAlreadyComplete(language, bookId, startChapter - 1, targetChapter));
+            }
+            return;
+        }
+        const config = await loadConfig();
+        // `inkos auto` is unattended batch writing, so the audit→revise loop must
+        // run inline: force "auto" regardless of book/project reviewMode settings.
+        const pipeline = new PipelineRunner(buildPipelineConfig(config, root, {
+            quiet: opts.quiet,
+            chapterReviewMode: "auto",
+        }));
+        if (!opts.json)
+            log(formatAutoWriteStart(language, bookId, startChapter, targetChapter));
+        const wordCount = opts.words ? parseInt(opts.words, 10) : undefined;
+        const results = [];
+        for (let chapter = startChapter; chapter <= targetChapter; chapter++) {
+            if (!opts.json)
+                log(formatWriteNextProgress(language, chapter, targetChapter, bookId));
+            let result;
+            try {
+                result = await pipeline.writeNextChapter(bookId, wordCount);
+            }
+            catch (e) {
+                throw new Error(`Chapter ${chapter} failed, stopping auto-write (${results.length} chapter(s) completed this run): ${e instanceof Error ? e.message : String(e)}`, { cause: e });
+            }
+            results.push(result);
+            if (!opts.json) {
+                for (const line of formatWriteNextResultLines(language, {
+                    chapterNumber: result.chapterNumber,
+                    title: result.title,
+                    wordCount: result.wordCount,
+                    auditPassed: result.auditResult.passed,
+                    revised: result.revised,
+                    status: result.status,
+                    issues: result.auditResult.issues,
+                })) {
+                    log(line);
+                }
+                log("");
+            }
+            if (result.status === "state-degraded") {
+                throw new Error(`Chapter ${result.chapterNumber} finished in state-degraded status, stopping auto-write. Run "inkos write repair-state ${bookId} ${result.chapterNumber}" first, then re-run inkos auto.`);
+            }
+        }
+        if (opts.json) {
+            log(JSON.stringify(results, null, 2));
+        }
+        else {
+            log(formatWriteNextComplete(language));
+        }
+        // The pipeline itself already sends one notification per completed
+        // chapter whenever notify channels are configured (runner.ts, end of
+        // writeNextChapter). A single-chapter run would therefore duplicate that
+        // exact notification — only send a command-level batch summary when this
+        // run wrote more than one chapter.
+        if (opts.notify && results.length > 1) {
+            await sendCommandNotification({
+                title: formatNotifyCommandTitle(language, "auto", notifyBookName, true),
+                body: formatNotifyBatchWriteBody(language, results.map((r) => ({
+                    chapterNumber: r.chapterNumber,
+                    title: r.title,
+                    wordCount: r.wordCount,
+                    auditPassed: r.auditResult.passed,
+                }))),
+            }, config);
+        }
+    }
+    catch (e) {
+        if (opts.notify) {
+            await sendCommandNotification({
+                title: formatNotifyCommandTitle(notifyLanguage, "auto", notifyBookName, false),
+                body: formatNotifyFailureBody(notifyLanguage, e),
+            });
+        }
+        if (opts.json) {
+            log(JSON.stringify({ error: String(e) }));
+        }
+        else {
+            logError(`Auto-write failed: ${e}`);
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=auto.js.map

package/dist/commands/auto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto.js","sourceRoot":"","sources":["../../src/commands/auto.ts"],"names":[],"mappings":"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"}

package/dist/commands/book.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const bookCommand: Command;
+//# sourceMappingURL=book.d.ts.map

package/dist/commands/book.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"book.d.ts","sourceRoot":"","sources":["../../src/commands/book.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC,eAAO,MAAM,WAAW,SACM,CAAC"}