claude-novel-writer 0.1.0

package/dist/ai/beat-generator.js

@@ -0,0 +1,281 @@
+/**
+ * Scene Beat Generator
+ *
+ * Assembles scene context from the database and calls Claude to generate
+ * free-form narrative beats for a scene — the micro-structure of what happens
+ * beat by beat within a single scene.
+ *
+ * Philosophy: beats are planning scaffolding, not prose. They help the author
+ * see the shape of the scene before writing it. "Suggest, don't dictate."
+ */
+import { ClaudeClient, PassthroughClaudeClient } from './claude-client.js';
+export class BeatGenerator {
+    mcpClient;
+    projectId;
+    claude;
+    constructor(mcpClient, projectId) {
+        this.mcpClient = mcpClient;
+        this.projectId = projectId;
+        this.claude = ClaudeClient.isConfigured()
+            ? new ClaudeClient()
+            : new PassthroughClaudeClient();
+    }
+    /**
+     * Build the beat-generation prompt without calling the API.
+     * Useful for surfacing context to the active Claude Code session.
+     */
+    async buildBeatPrompt(sceneMetadata, chapterNumber, count = 5) {
+        const ctx = await this.assembleContext(sceneMetadata, chapterNumber);
+        return this.buildPrompt(ctx, count);
+    }
+    /**
+     * Generate beats for a scene from its metadata and DB context.
+     * Does not require the scene to have prose — works from planning data alone.
+     *
+     * Returns an empty array when running in passthrough mode (no standalone API
+     * key). The caller should display the assembled prompt so the active Claude
+     * Code session can generate beats and write them back.
+     */
+    async generateBeats(sceneMetadata, chapterNumber, options = {}) {
+        const count = options.count ?? 5;
+        const ctx = await this.assembleContext(sceneMetadata, chapterNumber);
+        const prompt = this.buildPrompt(ctx, count);
+        const response = await this.claude.generateStructured(prompt, {
+            temperature: 0.8,
+            maxTokens: 1024,
+            systemPrompt: 'You are a story structure assistant helping a novelist plan scene beats. ' +
+                'Write concise, concrete, specific beats — not vague summaries. ' +
+                'Each beat is one focused narrative unit: an action, a revelation, a decision, or a shift in understanding. ' +
+                'Return ONLY the numbered list, nothing else.',
+        });
+        // Passthrough mode: no standalone API key configured — the prompt has been
+        // emitted to stdout for the active Claude Code session to handle. Return a
+        // sentinel so the CLI handler can print the context and wait for the agent
+        // to supply beats rather than trying to parse the raw prompt text as beats.
+        if (response.passthrough) {
+            return [];
+        }
+        return this.parseBeats(response.content);
+    }
+    // ============================================================
+    // CONTEXT ASSEMBLY
+    // ============================================================
+    async assembleContext(scene, chapterNumber) {
+        const [project, chapterRow, threads, rules, previousSceneBeat] = await Promise.all([
+            this.loadProject(),
+            this.loadChapter(chapterNumber),
+            this.loadActivePlotThreads(),
+            this.loadHardWorldRules(),
+            this.loadPreviousSceneLastBeat(chapterNumber, scene.sceneNumber),
+        ]);
+        const povCharacter = scene.pov
+            ? await this.loadCharacter(scene.pov)
+            : undefined;
+        return {
+            projectTitle: project?.title ?? 'Untitled',
+            projectGenre: project?.genre,
+            chapterNumber,
+            chapterTitle: chapterRow?.title,
+            chapterSummary: chapterRow?.summary,
+            scene,
+            povCharacter,
+            activePlotThreads: threads,
+            hardWorldRules: rules,
+            previousSceneLastBeat: previousSceneBeat,
+        };
+    }
+    async loadProject() {
+        try {
+            const rows = await this.mcpClient.readQuery('SELECT title, genre FROM projects WHERE id = ? LIMIT 1', [this.projectId]);
+            return rows[0];
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async loadChapter(chapterNumber) {
+        try {
+            const rows = await this.mcpClient.readQuery('SELECT title, summary FROM chapters WHERE project_id = ? AND chapter_number = ? LIMIT 1', [this.projectId, chapterNumber]);
+            return rows[0];
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async loadCharacter(name) {
+        try {
+            const rows = await this.mcpClient.readQuery(`SELECT name, role, summary,
+                GROUP_CONCAT(CASE WHEN ca.attribute_name = 'personality' THEN ca.attribute_value END) AS personality,
+                GROUP_CONCAT(CASE WHEN ca.attribute_name = 'arc' THEN ca.attribute_value END) AS arc
+         FROM characters c
+         LEFT JOIN character_attributes ca ON ca.character_id = c.id
+         WHERE c.project_id = ? AND c.name = ?
+         GROUP BY c.id
+         LIMIT 1`, [this.projectId, name]);
+            if (!rows[0])
+                return undefined;
+            const r = rows[0];
+            return {
+                name: r.name,
+                role: r.role,
+                summary: r.summary,
+                personality: r.personality,
+                arc: r.arc,
+            };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async loadActivePlotThreads() {
+        try {
+            const rows = await this.mcpClient.readQuery(`SELECT thread_name AS name, description, priority
+         FROM plot_threads
+         WHERE project_id = ? AND status = 'active'
+         ORDER BY priority DESC
+         LIMIT 5`, [this.projectId]);
+            return rows.map((r) => ({
+                name: r.name,
+                description: r.description ?? '',
+                priority: r.priority ?? 5,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    async loadHardWorldRules() {
+        try {
+            const rows = await this.mcpClient.readQuery(`SELECT rule_name AS name, description
+         FROM world_rules
+         WHERE project_id = ? AND is_hard_rule = 1
+         LIMIT 6`, [this.projectId]);
+            return rows.map((r) => ({
+                name: r.name,
+                description: r.description ?? '',
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Load the last beat from the previous scene in the same chapter (for continuity).
+     * Returns undefined if this is scene 1 or no beats exist.
+     */
+    async loadPreviousSceneLastBeat(chapterNumber, sceneNumber) {
+        if (sceneNumber <= 1)
+            return undefined;
+        try {
+            const rows = await this.mcpClient.readQuery(`SELECT sb.description
+         FROM scene_beats sb
+         JOIN scenes s ON sb.scene_id = s.id
+         JOIN chapters c ON s.chapter_id = c.id
+         WHERE c.project_id = ?
+           AND c.chapter_number = ?
+           AND s.scene_number = ?
+         ORDER BY sb.beat_number DESC
+         LIMIT 1`, [this.projectId, chapterNumber, sceneNumber - 1]);
+            return rows[0]
+                ? rows[0].description
+                : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    // ============================================================
+    // PROMPT BUILDING
+    // ============================================================
+    buildPrompt(ctx, count) {
+        const lines = [];
+        lines.push(`PROJECT: ${ctx.projectTitle}${ctx.projectGenre ? ` (${ctx.projectGenre})` : ''}`, `CHAPTER ${ctx.chapterNumber}${ctx.chapterTitle ? `: ${ctx.chapterTitle}` : ''}`);
+        if (ctx.chapterSummary) {
+            lines.push(`Chapter summary: ${ctx.chapterSummary.trim()}`);
+        }
+        lines.push('');
+        lines.push(`SCENE ${ctx.scene.sceneNumber}${ctx.scene.title ? `: ${ctx.scene.title}` : ''}`);
+        if (ctx.scene.purpose)
+            lines.push(`Purpose: ${ctx.scene.purpose}`);
+        if (ctx.scene.emotionalTone)
+            lines.push(`Tone: ${ctx.scene.emotionalTone}`);
+        if (ctx.scene.tensionLevel != null)
+            lines.push(`Tension level: ${ctx.scene.tensionLevel}/10`);
+        if (ctx.scene.timeOfDay)
+            lines.push(`Time: ${ctx.scene.timeOfDay}`);
+        if (ctx.scene.location)
+            lines.push(`Location: ${ctx.scene.location}`);
+        if (ctx.scene.pov)
+            lines.push(`POV: ${ctx.scene.pov}`);
+        if (ctx.povCharacter) {
+            lines.push('');
+            lines.push(`POV CHARACTER — ${ctx.povCharacter.name}:`);
+            if (ctx.povCharacter.role)
+                lines.push(`  Role: ${ctx.povCharacter.role}`);
+            if (ctx.povCharacter.summary)
+                lines.push(`  ${ctx.povCharacter.summary.trim().slice(0, 400)}`);
+            if (ctx.povCharacter.personality)
+                lines.push(`  Personality: ${ctx.povCharacter.personality}`);
+            if (ctx.povCharacter.arc)
+                lines.push(`  Arc: ${ctx.povCharacter.arc}`);
+        }
+        if (ctx.activePlotThreads.length > 0) {
+            lines.push('');
+            lines.push('ACTIVE PLOT THREADS:');
+            for (const t of ctx.activePlotThreads) {
+                lines.push(`  • ${t.name} (priority ${t.priority}): ${t.description.slice(0, 200)}`);
+            }
+        }
+        if (ctx.hardWorldRules.length > 0) {
+            lines.push('');
+            lines.push('HARD WORLD RULES (must not be violated):');
+            for (const r of ctx.hardWorldRules) {
+                lines.push(`  • ${r.name}: ${r.description.slice(0, 150)}`);
+            }
+        }
+        if (ctx.previousSceneLastBeat) {
+            lines.push('');
+            lines.push(`PREVIOUS SCENE ENDS WITH:`);
+            lines.push(`  ${ctx.previousSceneLastBeat}`);
+        }
+        lines.push('');
+        lines.push(`Generate exactly ${count} beats for this scene. A beat is one focused narrative unit — ` +
+            `an action, a reaction, a moment of realisation, a decision, a shift. ` +
+            `Each beat should be one or two sentences, specific and concrete. ` +
+            `Do not use labels or categories. Write only what happens.`);
+        lines.push('');
+        lines.push('Format — return only this, nothing else:');
+        lines.push('1. [description]');
+        lines.push('2. [description]');
+        lines.push('...');
+        return lines.join('\n');
+    }
+    // ============================================================
+    // RESPONSE PARSING
+    // ============================================================
+    /**
+     * Parse Claude's numbered list response into SceneBeat[].
+     * Tolerates minor formatting variation (periods, parentheses, extra whitespace).
+     */
+    parseBeats(raw) {
+        const beats = [];
+        const lines = raw.split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            // Match "1. description", "1) description", "1: description"
+            const match = trimmed.match(/^(\d+)[.):\s]\s*(.+)$/);
+            if (match) {
+                const beatNumber = parseInt(match[1], 10);
+                const description = match[2].trim();
+                if (description) {
+                    beats.push({ beatNumber, description });
+                }
+            }
+        }
+        // Re-number sequentially in case Claude skipped numbers
+        return beats.map((b, i) => ({ ...b, beatNumber: i + 1 }));
+    }
+}
+//# sourceMappingURL=beat-generator.js.map

package/dist/ai/beat-generator.js.map

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

package/dist/ai/claude-client.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Claude API Client
+ * Wrapper for Anthropic SDK
+ */
+export interface ClaudeOptions {
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+    systemPrompt?: string;
+}
+export interface ClaudeResponse {
+    content: string;
+    stopReason?: string;
+    /** True when this is a context-prompt passthrough, not an API-generated response. */
+    passthrough?: boolean;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+/**
+ * Shared interface implemented by both ClaudeClient and PassthroughClaudeClient.
+ * GenerationManager depends on this interface, not on the concrete class.
+ */
+export interface IClaudeClient {
+    generate(prompt: string, options?: ClaudeOptions): Promise<ClaudeResponse>;
+    generateStructured(prompt: string, options?: ClaudeOptions): Promise<ClaudeResponse>;
+    generateCreative(prompt: string, options?: ClaudeOptions): Promise<ClaudeResponse>;
+}
+/**
+ * Live API client — calls the Anthropic API.
+ * Requires ANTHROPIC_API_KEY in the environment.
+ */
+export declare class ClaudeClient implements IClaudeClient {
+    private anthropic;
+    private defaultModel;
+    constructor(apiKey?: string);
+    generate(prompt: string, options?: ClaudeOptions): Promise<ClaudeResponse>;
+    generateStructured(prompt: string, options?: ClaudeOptions): Promise<ClaudeResponse>;
+    generateCreative(prompt: string, options?: ClaudeOptions): Promise<ClaudeResponse>;
+    static isConfigured(): boolean;
+}
+/**
+ * Passthrough client used when ANTHROPIC_API_KEY is absent.
+ *
+ * Returns the assembled prompt verbatim instead of calling the API.
+ * Claude Code's active session sees the command output and generates the content
+ * directly — no separate API key required for the plugin to function.
+ */
+export declare class PassthroughClaudeClient implements IClaudeClient {
+    generate(prompt: string): Promise<ClaudeResponse>;
+    generateStructured(prompt: string): Promise<ClaudeResponse>;
+    generateCreative(prompt: string): Promise<ClaudeResponse>;
+}
+//# sourceMappingURL=claude-client.d.ts.map

package/dist/ai/claude-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-client.d.ts","sourceRoot":"","sources":["../../src/ai/claude-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3E,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACrF,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACpF;AAED;;;GAGG;AACH,qBAAa,YAAa,YAAW,aAAa;IAChD,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,YAAY,CAA+B;gBAEvC,MAAM,CAAC,EAAE,MAAM;IAUrB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAsC9E,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxF,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;IAI5F,MAAM,CAAC,YAAY,IAAI,OAAO;CAG/B;AAED;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,aAAa;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAGjD,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAG3D,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAGhE"}

package/dist/ai/claude-client.js

@@ -0,0 +1,78 @@
+/**
+ * Claude API Client
+ * Wrapper for Anthropic SDK
+ */
+import Anthropic from '@anthropic-ai/sdk';
+/**
+ * Live API client — calls the Anthropic API.
+ * Requires ANTHROPIC_API_KEY in the environment.
+ */
+export class ClaudeClient {
+    anthropic;
+    defaultModel = 'claude-sonnet-4-6';
+    constructor(apiKey) {
+        const key = apiKey || process.env.ANTHROPIC_API_KEY;
+        if (!key) {
+            throw new Error('Anthropic API key not found. Set ANTHROPIC_API_KEY environment variable or pass to constructor.');
+        }
+        this.anthropic = new Anthropic({ apiKey: key });
+    }
+    async generate(prompt, options = {}) {
+        const { model = this.defaultModel, maxTokens = 2048, temperature = 0.7, systemPrompt, } = options;
+        try {
+            const message = await this.anthropic.messages.create({
+                model,
+                max_tokens: maxTokens,
+                temperature,
+                system: systemPrompt,
+                messages: [{ role: 'user', content: prompt }],
+            });
+            const content = message.content
+                .filter((block) => block.type === 'text')
+                .map((block) => block.text)
+                .join('\n');
+            return {
+                content,
+                stopReason: message.stop_reason || undefined,
+                usage: {
+                    inputTokens: message.usage.input_tokens,
+                    outputTokens: message.usage.output_tokens,
+                },
+            };
+        }
+        catch (error) {
+            if (error instanceof Anthropic.APIError) {
+                throw new Error(`Claude API Error: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    async generateStructured(prompt, options = {}) {
+        return this.generate(prompt, { ...options, temperature: options.temperature ?? 0.5 });
+    }
+    async generateCreative(prompt, options = {}) {
+        return this.generate(prompt, { ...options, temperature: options.temperature ?? 0.9 });
+    }
+    static isConfigured() {
+        return !!process.env.ANTHROPIC_API_KEY;
+    }
+}
+/**
+ * Passthrough client used when ANTHROPIC_API_KEY is absent.
+ *
+ * Returns the assembled prompt verbatim instead of calling the API.
+ * Claude Code's active session sees the command output and generates the content
+ * directly — no separate API key required for the plugin to function.
+ */
+export class PassthroughClaudeClient {
+    async generate(prompt) {
+        return { content: prompt, stopReason: 'passthrough', passthrough: true };
+    }
+    async generateStructured(prompt) {
+        return { content: prompt, stopReason: 'passthrough', passthrough: true };
+    }
+    async generateCreative(prompt) {
+        return { content: prompt, stopReason: 'passthrough', passthrough: true };
+    }
+}
+//# sourceMappingURL=claude-client.js.map

package/dist/ai/claude-client.js.map

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

package/dist/ai/generation-manager.d.ts

@@ -0,0 +1,216 @@
+/**
+ * AI Generation Manager
+ * Coordinates AI-assisted content generation with proper context
+ *
+ * Philosophy: Suggest, don't dictate. Support the author's voice.
+ */
+import type { MCPClient } from '../core/database.js';
+import type { SynopsisContext, SynopsisLength } from '../types/novel.js';
+export interface CharacterProfileRow {
+    name: string;
+    role?: string;
+    summary?: string;
+    [key: string]: unknown;
+}
+export interface WorldRuleRow {
+    rule_name: string;
+    description?: string;
+    [key: string]: unknown;
+}
+export interface GenerationContext {
+    projectId: number;
+    genre?: string;
+    tone?: string;
+    currentChapter?: number;
+    currentScene?: number;
+    recentText?: string;
+    characterProfiles?: CharacterProfileRow[];
+    locationDetails?: Record<string, unknown>[];
+    worldRules?: WorldRuleRow[];
+    plotThreads?: Record<string, unknown>[];
+}
+export interface GenerationOptions {
+    temperature?: number;
+    maxLength?: number;
+    style?: 'descriptive' | 'action' | 'dialogue' | 'introspective';
+    pov?: string;
+    includeContext?: boolean;
+    count?: number;
+}
+export interface GenerationResult {
+    content: string;
+    alternatives: string[];
+    reasoning?: string;
+    warnings?: string[];
+}
+/**
+ * Manages AI-assisted generation
+ */
+export declare class GenerationManager {
+    private mcpClient;
+    private projectId;
+    private claude;
+    private contextAssembler;
+    constructor(mcpClient: MCPClient, projectId: number);
+    /**
+     * Generate character profile from description.
+     * When options.count > 1, instructs Claude to return that many distinct profile options,
+     * numbered, and parses them into alternatives[].
+     *
+     * Based on NOVEL_CRAFT_PRINCIPLES: believable characters with flaws.
+     */
+    generateCharacter(description: string, options?: GenerationOptions): Promise<GenerationResult>;
+    /**
+     * Generate location/world-building details
+     */
+    generateLocation(description: string, options?: GenerationOptions): Promise<GenerationResult>;
+    /**
+     * Suggest scene continuation.
+     * Defaults to 3 alternatives. Respects options.count (max 3).
+     * Based on principle: "Follow the headlights" - discovery writing.
+     */
+    suggestSceneContinuation(currentText: string, sceneId: number, options?: GenerationOptions): Promise<GenerationResult>;
+    /**
+     * Enhance dialogue for character voice.
+     * When options.count > 1, requests that many dialogue variations.
+     * Based on principle: Give each character a voice.
+     */
+    enhanceDialogue(dialogue: string, characterName: string, options?: GenerationOptions): Promise<GenerationResult>;
+    /**
+     * Expand description with sensory details.
+     * When options.count > 1, requests distinct sensory approaches
+     * (e.g. visual-first, sound-first, emotional-first).
+     */
+    expandDescription(text: string, pov?: string, options?: GenerationOptions): Promise<GenerationResult>;
+    /**
+     * Suggest plot development.
+     * Defaults to 3 alternatives. Respects options.count (max 3).
+     */
+    suggestPlotDevelopment(threadName: string, currentStatus: string, options?: GenerationOptions): Promise<GenerationResult>;
+    private buildCharacterPrompt;
+    private buildLocationPrompt;
+    private buildContinuationPrompt;
+    private buildDialoguePrompt;
+    private buildDescriptionPrompt;
+    private buildPlotPrompt;
+    private assembleProjectContext;
+    private assembleSceneContext;
+    private getCharacterProfile;
+    private getPlotThread;
+    /**
+     * Load a character's voice, personality, and mannerisms from the database.
+     * Returns null if the character is not found or an error occurs.
+     *
+     * @param projectId - The project to search within
+     * @param name      - The character's name
+     */
+    private loadCharacterVoice;
+    /**
+     * Build the POV anchor block to prepend to a prompt when options.pov is set.
+     * Returns an empty string if the character voice cannot be loaded.
+     *
+     * @param options - Generation options that may include a pov character name
+     */
+    private buildPovBlock;
+    /**
+     * Generate one true sentence to break through writer's block.
+     * Loads the last 500 words of the scene's content from the database and asks
+     * Claude to write a single, precise sentence that continues the story naturally.
+     *
+     * @param projectId - (unused; class already scoped to projectId)
+     * @param sceneId   - The scene to continue
+     * @param options   - Optional generation configuration
+     */
+    generateNextSentence(projectId: string, sceneId: number, options?: GenerationOptions): Promise<GenerationResult>;
+    /**
+     * Assemble all project data needed to generate synopsis, pitch,
+     * query-letter, or comp-title content.
+     *
+     * Queries: projects, characters (protagonist + antagonist),
+     * chapters (summaries), world_rules, narrative_promises.
+     *
+     * @param projectId - Project identifier (string form accepted by callers)
+     */
+    assembleSynopsisContext(projectId: string): Promise<SynopsisContext>;
+    /**
+     * Generate a synopsis of the specified length.
+     *
+     * @param projectId - Project identifier
+     * @param length    - 'short' (~150w), 'medium' (~400w), or 'long' (~800w)
+     */
+    generateSynopsis(projectId: string, length: SynopsisLength): Promise<GenerationResult>;
+    /**
+     * Generate a 25-word elevator pitch using the "When…must…before" template.
+     *
+     * @param projectId - Project identifier
+     */
+    generatePitch(projectId: string): Promise<GenerationResult>;
+    /**
+     * Generate a professional query letter ready for literary agent submission.
+     *
+     * @param projectId  - Project identifier
+     * @param compTitles - Optional list of comp titles provided by the author
+     */
+    generateQueryLetter(projectId: string, compTitles?: string[]): Promise<GenerationResult>;
+    /**
+     * Suggest 5 comparative titles published 2020–2025 for the novel.
+     *
+     * @param projectId - Project identifier
+     */
+    generateComps(projectId: string): Promise<GenerationResult>;
+    /**
+     * Workshop opening lines for the novel.
+     * Loads project context (title, genre, protagonist, core conflict) via
+     * `assembleSynopsisContext` when available, then asks Claude to generate
+     * `count` distinct opening-line options.
+     *
+     * Each option:
+     * - hooks the reader immediately
+     * - establishes voice and tone
+     * - hints at the central tension
+     * - stands alone as a complete sentence
+     *
+     * @param projectId - Project identifier
+     * @param count     - Number of options to generate (default 5, max 10)
+     */
+    workshopOpeningLines(projectId: string, count?: number): Promise<GenerationResult>;
+    /**
+     * Generate creative brainstorm ideas from an author prompt.
+     * Returns 5 distinct, numbered ideas grounded in the project genre.
+     *
+     * @param prompt  - The brainstorm prompt from the author
+     * @param options - Optional generation configuration
+     */
+    generateBrainstorm(prompt: string, options?: GenerationOptions): Promise<GenerationResult>;
+    /**
+     * Generate character name options with cultural context and meaning.
+     *
+     * @param opts - Options controlling culture, gender, count, and name type
+     */
+    generateName(opts: {
+        culture?: string;
+        gender?: 'male' | 'female' | 'neutral';
+        count?: number;
+        type?: 'first' | 'last' | 'full';
+    }): Promise<GenerationResult>;
+    /**
+     * Workshop a partial premise through structured development questions.
+     * Guides the author through conflict, protagonist, stakes, story question, and uniqueness.
+     *
+     * @param projectId      - Project identifier (unused in prompt but kept for API consistency)
+     * @param partialPremise - The author's initial premise idea
+     */
+    workshopPremise(projectId: string, partialPremise: string): Promise<GenerationResult>;
+    /**
+     * Generate a quick character sketch to capture an early idea.
+     * Lightweight — name options, core trait, flaw, hidden depth, voice note, and story role.
+     *
+     * @param opts - Optional role, genre, and freeform notes
+     */
+    generateCharacterSketch(opts?: {
+        role?: string;
+        genre?: string;
+        notes?: string;
+    }): Promise<GenerationResult>;
+}
+//# sourceMappingURL=generation-manager.d.ts.map

package/dist/ai/generation-manager.d.ts.map

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