playable-lessons 0.2.2 → 0.6.2

package/out/cli/index.js

@@ -10,6 +10,15 @@ const promises_1 = require("fs/promises");
 const path_1 = require("path");
 const storyExport_js_1 = require("../shared/storyExport.js");
 const generate_js_1 = require("../shared/generate.js");
+const imageClient_js_1 = require("../shared/imageClient.js");
+const flashcardExport_js_1 = require("../shared/flashcardExport.js");
+const quizExport_js_1 = require("../shared/quizExport.js");
+const summaryExport_js_1 = require("../shared/summaryExport.js");
+const aiTaskExport_js_1 = require("../shared/aiTaskExport.js");
+const caseStudyExport_js_1 = require("../shared/caseStudyExport.js");
+const planExport_js_1 = require("../shared/planExport.js");
+const h5pExporter_js_1 = require("../shared/h5pExporter.js");
+const version_generated_js_1 = require("../shared/version.generated.js");
 /** Pick a provider from the environment when --provider isn't given. */
 function resolveProviderFromEnv() {
     if (process.env.ANTHROPIC_API_KEY)
@@ -62,6 +71,47 @@ function buildCliConfig(o) {
 function slug(s) {
     return s.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 40) || 'story';
 }
+/**
+ * Build an ImageProviderConfig from CLI flags + environment. Provider default:
+ * openai when OPENAI_API_KEY is set, gemini when GEMINI_API_KEY/GOOGLE_API_KEY
+ * is set, custom when --image-base-url is given.
+ */
+function buildCliImageConfig(o) {
+    const provider = o.imageProvider ||
+        (process.env.OPENAI_API_KEY ? 'openai' : process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY ? 'gemini' : o.imageBaseUrl ? 'custom' : undefined);
+    if (!provider) {
+        throw new Error('--images needs an image provider: set OPENAI_API_KEY or GEMINI_API_KEY, or pass --image-provider custom --image-base-url <url> --image-model <id>');
+    }
+    const config = { provider, model: o.imageModel || undefined };
+    switch (provider) {
+        case 'openai':
+            config.apiKey = process.env.OPENAI_API_KEY;
+            break;
+        case 'gemini':
+            config.apiKey = process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY;
+            break;
+        case 'custom':
+            config.baseUrl = o.imageBaseUrl;
+            config.apiKey = process.env.PLAYABLE_LESSONS_IMAGE_API_KEY || process.env.OPENAI_API_KEY || '';
+            break;
+        case 'swarmui':
+            config.baseUrl = o.imageBaseUrl;
+            config.apiKey = process.env.PLAYABLE_LESSONS_IMAGE_API_KEY || process.env.SWARMUI_TOKEN || '';
+            break;
+    }
+    if (!(0, imageClient_js_1.isImageProviderConfigured)(config)) {
+        throw new Error(`Image provider "${provider}" is not fully configured (missing ${provider === 'custom' || provider === 'swarmui' ? '--image-base-url' : 'API key'})`);
+    }
+    return config;
+}
+/** Decode a data URL into its binary payload. */
+function dataUrlToBuffer(dataUrl) {
+    const m = dataUrl.match(/^data:([^;]+);base64,(.+)$/s);
+    if (!m)
+        throw new Error('Not a base64 data URL');
+    const ext = m[1] === 'image/jpeg' ? 'jpg' : m[1] === 'image/webp' ? 'webp' : 'png';
+    return { buffer: Buffer.from(m[2], 'base64'), ext };
+}
 async function readStdin() {
     if (process.stdin.isTTY)
         return '';
@@ -90,7 +140,7 @@ async function readStdin() {
     return yargs
         .option('input', { alias: 'i', type: 'string', demandOption: true, describe: 'Path to .ink file' })
         .option('output', { alias: 'o', type: 'string', demandOption: true, describe: 'Output directory' })
-        .option('format', { alias: 'f', type: 'string', default: 'html', describe: 'Export format: html, ink, json' })
+        .option('format', { alias: 'f', type: 'string', default: 'html', describe: 'Export format: html, ink, json, h5p (h5p requires a story with no variables/conditionals)' })
         .option('title', { alias: 't', type: 'string', default: 'Story', describe: 'Story title' });
 }, async (argv) => {
     try {
@@ -122,6 +172,13 @@ async function readStdin() {
                     console.log(`Exported Ink: ${outPath}`);
                     break;
                 }
+                case 'h5p': {
+                    const bytes = (0, h5pExporter_js_1.exportH5P)(source, title);
+                    const outPath = (0, path_1.join)(outputDir, `${baseName}.h5p`);
+                    await (0, promises_1.writeFile)(outPath, Buffer.from(bytes));
+                    console.log(`Exported H5P: ${outPath}`);
+                    break;
+                }
                 default:
                     console.warn(`Unknown format: ${format}`);
             }
@@ -132,7 +189,7 @@ async function readStdin() {
         process.exit(1);
     }
 })
-    .command('generate', 'Generate an Ink story from source material using AI', (yargs) => {
+    .command('generate', 'Generate an Ink story or flashcards from source material using AI', (yargs) => {
     return yargs
         .option('input', { alias: 'i', type: 'string', describe: 'Path to source material (text/markdown). Omit to use --topic or stdin.' })
         .option('topic', { type: 'string', describe: 'A topic or brief to generate from (instead of --input)' })
@@ -142,13 +199,22 @@ async function readStdin() {
         .option('base-url', { type: 'string', describe: 'Base URL for a custom OpenAI-compatible endpoint' })
         .option('ollama-url', { type: 'string', default: 'http://localhost:11434', describe: 'Ollama base URL' })
         .option('mode', { type: 'string', default: 'topic', describe: 'Input mode: topic | lesson | methodology | case-study | lecture-notes | scenario' })
+        .option('target', { type: 'string', default: 'story', describe: 'What to generate: story (interactive fiction) | flashcards | quiz | summary | ai-task | case-study' })
+        .option('cards', { type: 'number', default: 12, describe: 'Number of items to generate — flashcards, quiz questions, summary key points, or AI-collaboration tasks (target=flashcards|quiz|summary|ai-task)' })
+        .option('depth', { type: 'string', default: 'complete', describe: 'Case-study depth: idea | outline | complete (target=case-study)' })
         .option('length', { alias: 'l', type: 'string', default: 'medium', describe: 'Story length: short | medium | long' })
+        .option('style', { type: 'string', default: 'stateful', describe: 'Story branching style: stateful (Ink variables + conditional text) | branching (pure tree, H5P/LMS-convertible)' })
+        .option('images', { type: 'boolean', default: false, describe: 'Generate an illustration for every scene (story target only). Images are embedded in the HTML export and written to an images/ folder.' })
+        .option('image-style', { type: 'string', default: 'cartoon', describe: 'Scene image style: cartoon | photorealistic' })
+        .option('image-provider', { type: 'string', describe: 'openai | gemini | custom | swarmui (default: inferred from OPENAI_API_KEY / GEMINI_API_KEY / --image-base-url)' })
+        .option('image-model', { type: 'string', describe: 'Image model id (defaults: gpt-image-1 | imagen-4.0-fast-generate-001; required by custom)' })
+        .option('image-base-url', { type: 'string', describe: 'Base URL for a custom OpenAI-compatible /images/generations endpoint or a SwarmUI server' })
         .option('tone', { type: 'string', default: 'professional', describe: 'Narrative tone' })
         .option('protagonist', { type: 'string', default: 'the reader', describe: 'Protagonist type' })
         .option('answers', { type: 'string', describe: 'Optional answers to clarifying questions' })
         .option('retries', { type: 'number', default: 3, describe: 'Max compile attempts, with AI-assisted fixes between them (raise for weaker local models)' })
-        .option('format', { alias: 'f', type: 'string', default: 'ink,html', describe: 'Output formats: ink, html, json' })
-        .option('title', { alias: 't', type: 'string', describe: 'Story title (defaults to the input/topic name)' });
+        .option('format', { alias: 'f', type: 'string', describe: 'Output formats. story: ink|html|json|h5p (default ink,html; h5p requires --style branching). flashcards: csv|html|anki|json (default csv,html). quiz: html|txt|json (default html,json). summary: html|txt|json (default html,txt). ai-task: html|txt|json (default html,txt). case-study: html|txt|json (default html,txt).' })
+        .option('title', { alias: 't', type: 'string', describe: 'Title for the story, flashcard deck, quiz, summary, AI-task set, or case study (defaults to the input/topic name)' });
 }, async (argv) => {
     try {
         // Resolve the source material: --input file, --topic string, or stdin.
@@ -174,44 +240,276 @@ async function readStdin() {
             baseUrl: argv['base-url'],
             ollamaUrl: argv['ollama-url'] || 'http://localhost:11434'
         });
-        console.error(`Generating with ${config.provider} (${config.model})…`);
-        const result = await (0, generate_js_1.generateInk)({
-            inputMode: argv.mode,
-            inputText,
-            storyLength: argv.length,
-            protagonistType: argv.protagonist,
-            tone: argv.tone,
-            answers: argv.answers
-        }, config, { log: (m) => console.error(m), maxCompileRetries: argv.retries });
         const outputDir = argv.output;
         await (0, promises_1.mkdir)(outputDir, { recursive: true });
         const title = argv.title || base;
-        const formats = argv.format.split(',').map((f) => f.trim()).filter(Boolean);
-        if (!formats.includes('ink'))
-            formats.unshift('ink'); // always keep the source
-        for (const format of formats) {
-            switch (format) {
-                case 'ink': {
-                    const outPath = (0, path_1.join)(outputDir, `${base}.ink`);
-                    await (0, promises_1.writeFile)(outPath, result.inkSource);
-                    console.log(`Wrote ${outPath}`);
-                    break;
+        const target = argv.target || 'story';
+        if (target !== 'story' && target !== 'flashcards' && target !== 'quiz' && target !== 'summary' && target !== 'ai-task' && target !== 'case-study') {
+            throw new Error(`Unknown --target "${target}". Use story, flashcards, quiz, summary, ai-task, or case-study.`);
+        }
+        const formatRaw = argv.format;
+        const formats = formatRaw
+            ? formatRaw.split(',').map((f) => f.trim()).filter(Boolean)
+            : target === 'flashcards'
+                ? ['csv', 'html']
+                : target === 'quiz'
+                    ? ['html', 'json']
+                    : target === 'summary'
+                        ? ['html', 'txt']
+                        : target === 'ai-task'
+                            ? ['html', 'txt']
+                            : target === 'case-study'
+                                ? ['html', 'txt']
+                                : ['ink', 'html'];
+        if (target === 'flashcards') {
+            console.error(`Generating flashcards with ${config.provider} (${config.model})…`);
+            const result = await (0, generate_js_1.generateFlashcards)({
+                inputMode: argv.mode,
+                inputText,
+                cardCount: argv.cards,
+                tone: argv.tone
+            }, config, { log: (m) => console.error(m) });
+            for (const format of formats) {
+                switch (format) {
+                    case 'csv': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.flashcards.csv`);
+                        await (0, promises_1.writeFile)(outPath, (0, flashcardExport_js_1.toCSV)(result));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    case 'html': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.flashcards.html`);
+                        await (0, promises_1.writeFile)(outPath, (0, flashcardExport_js_1.toStandaloneHTML)(result, title));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    case 'anki': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.flashcards.txt`);
+                        await (0, promises_1.writeFile)(outPath, (0, flashcardExport_js_1.toAnkiTSV)(result));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    case 'json': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.flashcards.json`);
+                        await (0, promises_1.writeFile)(outPath, JSON.stringify(result, null, 2));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    default:
+                        console.warn(`Unknown format: ${format}`);
                 }
-                case 'json': {
-                    const outPath = (0, path_1.join)(outputDir, `${base}.ink.json`);
-                    await (0, promises_1.writeFile)(outPath, result.compiledJson);
-                    console.log(`Wrote ${outPath}`);
-                    break;
+            }
+        }
+        else if (target === 'quiz') {
+            console.error(`Generating a quiz with ${config.provider} (${config.model})…`);
+            const result = await (0, generate_js_1.generateQuiz)({
+                inputMode: argv.mode,
+                inputText,
+                questionCount: argv.cards,
+                tone: argv.tone
+            }, config, { log: (m) => console.error(m) });
+            for (const format of formats) {
+                switch (format) {
+                    case 'html': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.quiz.html`);
+                        await (0, promises_1.writeFile)(outPath, (0, quizExport_js_1.toStandaloneHTML)(result, title));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    case 'json': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.quiz.json`);
+                        await (0, promises_1.writeFile)(outPath, JSON.stringify(result, null, 2));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    case 'txt': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.quiz.txt`);
+                        await (0, promises_1.writeFile)(outPath, (0, quizExport_js_1.toPlainText)(result, title));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    default:
+                        console.warn(`Unknown format: ${format}`);
                 }
-                case 'html': {
-                    const html = await (0, storyExport_js_1.exportStandaloneHTML)(result.inkSource, title);
-                    const outPath = (0, path_1.join)(outputDir, `${base}.html`);
-                    await (0, promises_1.writeFile)(outPath, html);
-                    console.log(`Wrote ${outPath}`);
-                    break;
+            }
+        }
+        else if (target === 'summary') {
+            console.error(`Generating a summary with ${config.provider} (${config.model})…`);
+            const result = await (0, generate_js_1.generateSummary)({
+                inputMode: argv.mode,
+                inputText,
+                keyPointCount: argv.cards,
+                tone: argv.tone
+            }, config, { log: (m) => console.error(m) });
+            for (const format of formats) {
+                switch (format) {
+                    case 'html': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.summary.html`);
+                        await (0, promises_1.writeFile)(outPath, (0, summaryExport_js_1.toStandaloneHTML)(result, title));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    case 'txt': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.summary.txt`);
+                        await (0, promises_1.writeFile)(outPath, (0, summaryExport_js_1.toPlainText)(result, title));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    case 'json': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.summary.json`);
+                        await (0, promises_1.writeFile)(outPath, JSON.stringify(result, null, 2));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    default:
+                        console.warn(`Unknown format: ${format}`);
+                }
+            }
+        }
+        else if (target === 'ai-task') {
+            console.error(`Generating AI-collaboration tasks with ${config.provider} (${config.model})…`);
+            const result = await (0, generate_js_1.generateAiTask)({
+                inputMode: argv.mode,
+                inputText,
+                taskCount: argv.cards,
+                tone: argv.tone
+            }, config, { log: (m) => console.error(m) });
+            for (const format of formats) {
+                switch (format) {
+                    case 'html': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.ai-task.html`);
+                        await (0, promises_1.writeFile)(outPath, (0, aiTaskExport_js_1.toStandaloneHTML)(result, title));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    case 'txt': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.ai-task.txt`);
+                        await (0, promises_1.writeFile)(outPath, (0, aiTaskExport_js_1.toPlainText)(result, title));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    case 'json': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.ai-task.json`);
+                        await (0, promises_1.writeFile)(outPath, JSON.stringify(result, null, 2));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    default:
+                        console.warn(`Unknown format: ${format}`);
+                }
+            }
+        }
+        else if (target === 'case-study') {
+            console.error(`Generating a case study with ${config.provider} (${config.model})…`);
+            const result = await (0, generate_js_1.generateCaseStudy)({
+                inputMode: argv.mode,
+                inputText,
+                depth: (argv.depth || 'complete'),
+                tone: argv.tone
+            }, config, { log: (m) => console.error(m) });
+            for (const format of formats) {
+                switch (format) {
+                    case 'html': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.case-study.html`);
+                        await (0, promises_1.writeFile)(outPath, (0, caseStudyExport_js_1.toStandaloneHTML)(result, title));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    case 'txt': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.case-study.txt`);
+                        await (0, promises_1.writeFile)(outPath, (0, caseStudyExport_js_1.toPlainText)(result, title));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    case 'json': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.case-study.json`);
+                        await (0, promises_1.writeFile)(outPath, JSON.stringify(result, null, 2));
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    default:
+                        console.warn(`Unknown format: ${format}`);
+                }
+            }
+        }
+        else {
+            console.error(`Generating with ${config.provider} (${config.model})…`);
+            const wantImages = argv.images;
+            // Fail fast on a misconfigured image provider, before story generation.
+            const imageConfig = wantImages
+                ? buildCliImageConfig({
+                    imageProvider: argv['image-provider'],
+                    imageModel: argv['image-model'],
+                    imageBaseUrl: argv['image-base-url']
+                })
+                : undefined;
+            const result = await (0, generate_js_1.generateInk)({
+                inputMode: argv.mode,
+                inputText,
+                storyLength: argv.length,
+                branchingStyle: argv.style === 'branching' ? 'branching' : 'stateful',
+                protagonistType: argv.protagonist,
+                tone: argv.tone,
+                answers: argv.answers,
+                sceneImages: wantImages
+            }, config, { log: (m) => console.error(m), maxCompileRetries: argv.retries });
+            // Resolve # IMAGE_PROMPT: tags to real images (embedded in the HTML
+            // export and written to an images/ folder, slide-stream style).
+            let sceneImages;
+            if (wantImages && imageConfig) {
+                const imageStyle = argv['image-style'] === 'photorealistic' ? 'photorealistic' : 'cartoon';
+                console.error(`Generating scene images with ${imageConfig.provider} (${imageConfig.model || 'default model'})…`);
+                sceneImages = await (0, generate_js_1.generateSceneImages)(result.inkSource, imageConfig, {
+                    style: imageStyle,
+                    log: (m) => console.error(m)
+                });
+                const imagesDir = (0, path_1.join)(outputDir, 'images');
+                await (0, promises_1.mkdir)(imagesDir, { recursive: true });
+                let n = 0;
+                for (const dataUrl of Object.values(sceneImages)) {
+                    n++;
+                    const { buffer, ext } = dataUrlToBuffer(dataUrl);
+                    await (0, promises_1.writeFile)((0, path_1.join)(imagesDir, `scene_${n}.${ext}`), buffer);
+                }
+                console.log(`Wrote ${n} scene image(s) to ${imagesDir}`);
+            }
+            const storyFormats = formats.includes('ink') ? formats : ['ink', ...formats];
+            for (const format of storyFormats) {
+                switch (format) {
+                    case 'ink': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.ink`);
+                        await (0, promises_1.writeFile)(outPath, result.inkSource);
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    case 'json': {
+                        const outPath = (0, path_1.join)(outputDir, `${base}.ink.json`);
+                        await (0, promises_1.writeFile)(outPath, result.compiledJson);
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    case 'html': {
+                        const html = await (0, storyExport_js_1.exportStandaloneHTML)(result.inkSource, title, sceneImages);
+                        const outPath = (0, path_1.join)(outputDir, `${base}.html`);
+                        await (0, promises_1.writeFile)(outPath, html);
+                        console.log(`Wrote ${outPath}`);
+                        break;
+                    }
+                    case 'h5p': {
+                        try {
+                            const bytes = (0, h5pExporter_js_1.exportH5P)(result.inkSource, title);
+                            const outPath = (0, path_1.join)(outputDir, `${base}.h5p`);
+                            await (0, promises_1.writeFile)(outPath, Buffer.from(bytes));
+                            console.log(`Wrote ${outPath}`);
+                        }
+                        catch (err) {
+                            console.warn(`Skipped h5p: ${err instanceof Error ? err.message : err}`);
+                        }
+                        break;
+                    }
+                    default:
+                        console.warn(`Unknown format: ${format}`);
                 }
-                default:
-                    console.warn(`Unknown format: ${format}`);
             }
         }
         console.log('Done.');
@@ -220,8 +518,88 @@ async function readStdin() {
         console.error('Generation failed:', err instanceof Error ? err.message : err);
         process.exit(1);
     }
+})
+    .command('plan', 'Recommend a set of outputs for source material (optionally generate them all)', (yargs) => {
+    return yargs
+        .option('input', { alias: 'i', type: 'string', describe: 'Path to source material. Omit to use --topic or stdin.' })
+        .option('topic', { type: 'string', describe: 'A topic or brief to plan from (instead of --input)' })
+        .option('output', { alias: 'o', type: 'string', demandOption: true, describe: 'Output directory' })
+        .option('provider', { alias: 'p', type: 'string', describe: 'claude | openai | ollama | custom (default: inferred from env)' })
+        .option('model', { alias: 'm', type: 'string', describe: 'Model id' })
+        .option('base-url', { type: 'string', describe: 'Base URL for a custom OpenAI-compatible endpoint' })
+        .option('ollama-url', { type: 'string', default: 'http://localhost:11434', describe: 'Ollama base URL' })
+        .option('mode', { type: 'string', default: 'topic', describe: 'Input mode: topic | lesson | methodology | case-study | lecture-notes | scenario' })
+        .option('tone', { type: 'string', default: 'professional', describe: 'Narrative tone' })
+        .option('style', { type: 'string', default: 'stateful', describe: 'Story branching style when applying: stateful | branching' })
+        .option('apply', { type: 'boolean', default: false, describe: 'Also generate every recommended output' })
+        .option('format', { alias: 'f', type: 'string', default: 'html,json', describe: 'When applying: artifact formats html|json' });
+}, async (argv) => {
+    try {
+        let inputText = '';
+        let base = 'plan';
+        if (argv.input) {
+            inputText = await (0, promises_1.readFile)(argv.input, 'utf-8');
+            base = (0, path_1.basename)(argv.input).replace(/\.[^.]+$/, '');
+        }
+        else if (argv.topic) {
+            inputText = argv.topic;
+            base = slug(argv.topic);
+        }
+        else {
+            inputText = await readStdin();
+        }
+        if (!inputText.trim()) {
+            throw new Error('No source material — provide --input <file>, --topic "<brief>", or pipe text via stdin');
+        }
+        const config = buildCliConfig({
+            provider: argv.provider,
+            model: argv.model,
+            baseUrl: argv['base-url'],
+            ollamaUrl: argv['ollama-url'] || 'http://localhost:11434'
+        });
+        const outputDir = argv.output;
+        await (0, promises_1.mkdir)(outputDir, { recursive: true });
+        const tone = argv.tone;
+        const log = (m) => console.error(m);
+        console.error(`Planning with ${config.provider} (${config.model})…`);
+        const plan = await (0, generate_js_1.generatePlan)({ inputMode: argv.mode, inputText, tone }, config, { log });
+        await (0, promises_1.writeFile)((0, path_1.join)(outputDir, `${base}.plan.json`), JSON.stringify(plan, null, 2));
+        await (0, promises_1.writeFile)((0, path_1.join)(outputDir, `${base}.plan.txt`), (0, planExport_js_1.toPlainText)(plan));
+        await (0, promises_1.writeFile)((0, path_1.join)(outputDir, `${base}.plan.html`), (0, planExport_js_1.toStandaloneHTML)(plan, plan.title || base));
+        console.log(`Wrote plan: ${plan.recommendations.length} recommendation(s).`);
+        if (argv.apply) {
+            const formats = argv.format.split(',').map((f) => f.trim()).filter(Boolean);
+            const artifacts = await (0, generate_js_1.applyPlan)(plan, { inputMode: argv.mode, inputText, tone, branchingStyle: argv.style === 'branching' ? 'branching' : 'stateful' }, config, { log });
+            const write = async (kind, html, json) => {
+                if (formats.includes('html') && html) {
+                    await (0, promises_1.writeFile)((0, path_1.join)(outputDir, `${base}.${kind}.html`), html);
+                }
+                if (formats.includes('json')) {
+                    await (0, promises_1.writeFile)((0, path_1.join)(outputDir, `${base}.${kind}.json`), JSON.stringify(json, null, 2));
+                }
+            };
+            if (artifacts.story)
+                await write('story', await (0, storyExport_js_1.exportStandaloneHTML)(artifacts.story.inkSource, base), artifacts.story);
+            if (artifacts.flashcards)
+                await write('flashcards', (0, flashcardExport_js_1.toStandaloneHTML)(artifacts.flashcards, base), artifacts.flashcards);
+            if (artifacts.quiz)
+                await write('quiz', (0, quizExport_js_1.toStandaloneHTML)(artifacts.quiz, base), artifacts.quiz);
+            if (artifacts.summary)
+                await write('summary', (0, summaryExport_js_1.toStandaloneHTML)(artifacts.summary, base), artifacts.summary);
+            if (artifacts.aiTask)
+                await write('ai-task', (0, aiTaskExport_js_1.toStandaloneHTML)(artifacts.aiTask, base), artifacts.aiTask);
+            if (artifacts.caseStudy)
+                await write('case-study', (0, caseStudyExport_js_1.toStandaloneHTML)(artifacts.caseStudy, base), artifacts.caseStudy);
+            console.log('Applied: generated every recommended output.');
+        }
+        console.log('Done.');
+    }
+    catch (err) {
+        console.error('Planning failed:', err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
 })
     .demandCommand(1, 'You must specify a command')
     .help()
-    .version('0.2.2')
+    .version(version_generated_js_1.APP_VERSION)
     .parse();