@telepat/ideon 0.1.15 → 0.1.18

package/dist/ideon.js

@@ -118,7 +118,7 @@ var notificationsSettingsSchema = z.object({
   enabled: z.boolean().default(false)
 });
 var appSettingsSchema = z.object({
-  model: z.string().default("moonshotai/kimi-k2.5"),
+  model: z.string().default("deepseek/deepseek-v4-pro"),
   modelSettings: modelSettingsSchema.default(modelSettingsSchema.parse({})),
   modelRequestTimeoutMs: z.number().int().positive().default(9e4),
   t2i: baseT2ISettingsSchema.default(baseT2ISettingsSchema.parse({})),
@@ -521,7 +521,7 @@ import { mkdir as mkdir3, readFile as readFile2, writeFile as writeFile3 } from
 import path4 from "path";
 import envPaths2 from "env-paths";
 import { z as z2 } from "zod";
-var supportedAgentRuntimeValues = ["claude", "chatgpt", "gemini", "generic-mcp"];
+var supportedAgentRuntimeValues = ["claude", "claude-desktop", "chatgpt", "gemini", "codex", "cursor", "vscode", "opencode", "generic-mcp"];
 var integrationEntrySchema = z2.object({
   runtime: z2.enum(supportedAgentRuntimeValues),
   installedAt: z2.string(),
@@ -975,7 +975,8 @@ var writeToolInputSchema = {
   enrichLinks: z3.boolean().optional(),
   link: z3.array(z3.string()).optional(),
   unlink: z3.array(z3.string()).optional(),
-  maxLinks: z3.coerce.number().int().positive().optional()
+  maxLinks: z3.coerce.number().int().positive().optional(),
+  maxImages: z3.coerce.number().int().min(1).optional()
 };
 var writeToolInputZodSchema = z3.object(writeToolInputSchema);
 var writeResumeToolInputSchema = {
@@ -983,7 +984,8 @@ var writeResumeToolInputSchema = {
   enrichLinks: z3.boolean().optional(),
   link: z3.array(z3.string()).optional(),
   unlink: z3.array(z3.string()).optional(),
-  maxLinks: z3.coerce.number().int().positive().optional()
+  maxLinks: z3.coerce.number().int().positive().optional(),
+  maxImages: z3.coerce.number().int().min(1).optional()
 };
 var writeResumeToolInputZodSchema = z3.object(writeResumeToolInputSchema);
 var deleteToolInputSchema = {
@@ -1007,6 +1009,13 @@ var linksToolInputSchema = {
   maxLinks: z3.coerce.number().int().positive().optional()
 };
 var linksToolInputZodSchema = z3.object(linksToolInputSchema);
+var exportToolInputSchema = {
+  generationId: z3.string().min(1),
+  destinationPath: z3.string().min(1),
+  index: z3.coerce.number().int().positive().optional(),
+  overwrite: z3.boolean().optional()
+};
+var exportToolInputZodSchema = z3.object(exportToolInputSchema);
 var configListToolInputSchema = {};
 var configListToolInputZodSchema = z3.object(configListToolInputSchema);
 var configUnsetToolInputSchema = {
@@ -1040,6 +1049,11 @@ var ideonToolContracts = [
       mode: ["fresh", "append"]
     }
   },
+  {
+    name: "ideon_export",
+    required: ["generationId", "destinationPath"],
+    enums: {}
+  },
   {
     name: "ideon_config_set",
     required: ["key", "value"],
@@ -1208,7 +1222,6 @@ function compareStringArrays(drifts, id, actual, expected) {
 }
 
 // src/cli/commands/agent.ts
-var unsupportedIdeRuntimeAliases = ["cursor", "vscode"];
 var defaultDependencies = {
   install: installAgentIntegration,
   uninstall: uninstallAgentIntegration,
@@ -1278,11 +1291,6 @@ async function collectAgentStatus(deps) {
 }
 function parseRuntime(rawRuntime) {
   const runtime = rawRuntime.trim().toLowerCase();
-  if (unsupportedIdeRuntimeAliases.includes(runtime)) {
-    throw new ReportedError(
-      `Unsupported runtime "${rawRuntime}". Ideon agent integration does not support Cursor or VS Code runtimes.`
-    );
-  }
   if (!supportedAgentRuntimeValues.includes(runtime)) {
     throw new ReportedError(
       `Unsupported runtime "${rawRuntime}". Supported runtimes: ${supportedAgentRuntimeValues.join(", ")}.`
@@ -1354,7 +1362,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 // package.json
 var package_default = {
   name: "@telepat/ideon",
-  version: "0.1.15",
+  version: "0.1.18",
   description: "CLI for generating rich articles and images from ideas.",
   type: "module",
   repository: {
@@ -2275,9 +2283,8 @@ function buildArticlePlanJsonSchema(targetLengthWords) {
         items: {
           type: "object",
           additionalProperties: false,
-          required: ["anchorAfterSection", "description"],
+          required: ["description"],
           properties: {
-            anchorAfterSection: { type: "integer", minimum: 1, maximum: 10 },
             description: { type: "string" }
           }
         }
@@ -2316,7 +2323,7 @@ function buildArticlePlanMessages(idea, options) {
         "- Sections are article-only structure and must not be treated as requirements for non-article channels.",
         "- Include a cover image description and 2 to 3 inline image descriptions.",
         "- Image descriptions must be concrete and contextual, not generic stock-photo phrasing.",
-        "- Inline images should be anchored after specific sections using 1-based indexes.",
+        "- Do not include section placement for inline images \u2014 placement is determined automatically after writing.",
         "",
         "Shared content brief context:",
         `- description: ${options.contentBrief.description}`,
@@ -2335,7 +2342,7 @@ function buildArticlePlanMessages(idea, options) {
         "- outroBrief: string",
         `- sections: array of ${sectionCounts.label} objects, each with title and description strings`,
         "- coverImageDescription: string",
-        "- inlineImages: array of 2 to 3 objects, each with anchorAfterSection (integer 1 to 10) and description string",
+        "- inlineImages: array of 2 to 3 objects, each with a description string only",
         "",
         "Do not omit any required fields. Return strict JSON only."
       ].join("\n")
@@ -2350,7 +2357,6 @@ var articleSectionPlanSchema = z5.object({
   description: z5.string().min(1)
 });
 var inlineImagePlanSchema = z5.object({
-  anchorAfterSection: z5.number().int().min(1).max(10),
   description: z5.string().min(1)
 });
 var articlePlanSchema = z5.object({
@@ -2406,7 +2412,7 @@ async function planArticle({
     ...basePlan,
     slug: uniqueSlug,
     keywords: basePlan.keywords.slice(0, 8),
-    inlineImages: basePlan.inlineImages.filter((image) => image.anchorAfterSection <= basePlan.sections.length).slice(0, 3)
+    inlineImages: basePlan.inlineImages.slice(0, 3)
   };
 }
 function buildDryRunPlan(idea, contentBrief) {
@@ -2444,11 +2450,9 @@ function buildDryRunPlan(idea, contentBrief) {
     coverImageDescription: "A refined editorial workspace with notebooks, sketches, and glowing structured outlines, cinematic but minimal.",
     inlineImages: [
       {
-        anchorAfterSection: 1,
         description: "A rough idea evolving into a structured article outline on a desk full of notes."
       },
       {
-        anchorAfterSection: 3,
         description: "A collaborative editorial scene where human judgment and AI suggestions coexist."
       }
     ]
@@ -2943,7 +2947,21 @@ var imagePromptSchema = {
     prompt: { type: "string" }
   }
 };
-function buildImagePromptMessages(plan, image) {
+function buildImagePromptMessages(plan, image, section) {
+  const userLines = [
+    `Article title: ${plan.title}`,
+    `Article subtitle: ${plan.subtitle}`,
+    `Article description: ${plan.description}`,
+    `Image kind: ${image.kind}`,
+    `Image description: ${image.description}`
+  ];
+  if (section) {
+    userLines.push(
+      `Section title: ${section.title}`,
+      `Section excerpt: ${section.body.slice(0, 500)}`
+    );
+  }
+  userLines.push("Write one strong prompt for a clean editorial illustration. Avoid text overlays or watermarks.");
   return [
     {
       role: "system",
@@ -2951,14 +2969,7 @@ function buildImagePromptMessages(plan, image) {
     },
     {
       role: "user",
-      content: [
-        `Article title: ${plan.title}`,
-        `Article subtitle: ${plan.subtitle}`,
-        `Article description: ${plan.description}`,
-        `Image kind: ${image.kind}`,
-        `Image description: ${image.description}`,
-        "Write one strong prompt for a clean editorial illustration. Avoid text overlays or watermarks."
-      ].join("\n")
+      content: userLines.join("\n")
     }
   ];
 }
@@ -3428,11 +3439,12 @@ function clampNumber(value2, minimum, maximum, integer, nullable) {
 // src/pipeline/analytics.ts
 var LLM_USD_PER_1K_TOKENS = {
   // AUTO-GENERATED:OPENROUTER_PRICING_START
-  // Last refreshed: 2026-03-27
+  // Last refreshed: 2026-05-05
   // Source: https://openrouter.ai/api/v1/models (per-token USD converted to per-1k-token USD)
   "anthropic/claude-3.5-sonnet": { input: 6e-3, output: 0.03 },
   "deepseek/deepseek-chat": { input: 32e-5, output: 89e-5 },
-  "moonshotai/kimi-k2.5": { input: 45e-5, output: 22e-4 },
+  "deepseek/deepseek-v4-pro": { input: 435e-6, output: 87e-5 },
+  "moonshotai/kimi-k2.5": { input: 44e-5, output: 2e-3 },
   "openai/gpt-4o-mini": { input: 15e-5, output: 6e-4 }
   // AUTO-GENERATED:OPENROUTER_PRICING_END
 };
@@ -3520,8 +3532,52 @@ function sumKnownCosts(values) {
 
 // src/images/renderImages.ts
 var MIN_IMAGE_BYTES = 1024;
+function selectImageSlots(plan, sections, options) {
+  const sectionCount = sections.length;
+  let defaultInlineCount;
+  if (sectionCount <= 3) {
+    defaultInlineCount = 0;
+  } else if (sectionCount <= 6) {
+    defaultInlineCount = 1;
+  } else {
+    defaultInlineCount = 2;
+  }
+  const availableInlineCount = Math.min(defaultInlineCount, plan.inlineImages.length, sectionCount);
+  let inlineCount;
+  const maxImages = options?.maxImages;
+  if (maxImages !== void 0 && maxImages >= 1) {
+    inlineCount = Math.min(availableInlineCount, Math.max(0, maxImages - 1));
+  } else {
+    inlineCount = availableInlineCount;
+  }
+  const slots = [
+    {
+      id: "cover",
+      kind: "cover",
+      prompt: "",
+      description: plan.coverImageDescription,
+      anchorAfterSection: null
+    }
+  ];
+  for (let i = 0; i < inlineCount; i++) {
+    const anchorAfterSection = Math.max(
+      1,
+      Math.min(sectionCount, Math.round((i + 1) / (inlineCount + 1) * sectionCount))
+    );
+    slots.push({
+      id: `inline-${i + 1}`,
+      kind: "inline",
+      prompt: "",
+      description: plan.inlineImages[i]?.description ?? "",
+      anchorAfterSection
+    });
+  }
+  return slots;
+}
 async function expandImagePrompts({
-  plan,
+  slots,
+  planContext,
+  sections,
   settings,
   openRouter,
   dryRun,
@@ -3529,11 +3585,11 @@ async function expandImagePrompts({
   onPromptComplete,
   onInteraction
 }) {
-  const imageSlots = buildImageSlots(plan);
   const prompts = [];
-  for (let index = 0; index < imageSlots.length; index += 1) {
-    const image = imageSlots[index];
-    onProgress?.(`Expanding prompt ${index + 1}/${imageSlots.length}: ${image.kind === "cover" ? "cover image" : image.description}`);
+  for (let index = 0; index < slots.length; index += 1) {
+    const image = slots[index];
+    onProgress?.(`Expanding prompt ${index + 1}/${slots.length}: ${image.kind === "cover" ? "cover image" : image.description}`);
+    const sectionForImage = image.kind === "inline" && image.anchorAfterSection != null && sections ? sections[image.anchorAfterSection - 1] : void 0;
     if (dryRun || !openRouter) {
       const dryRunStartMs = Date.now();
       prompts.push({
@@ -3560,7 +3616,7 @@ async function expandImagePrompts({
     const response = await openRouter.requestStructured({
       schemaName: "image_prompt",
       schema: imagePromptSchema,
-      messages: buildImagePromptMessages(plan, image),
+      messages: buildImagePromptMessages(planContext, image, sectionForImage),
       settings,
       interactionContext: {
         stageId: "image-prompts",
@@ -3776,24 +3832,6 @@ function mergeLlmMetrics(left, right) {
     }
   };
 }
-function buildImageSlots(plan) {
-  return [
-    {
-      id: "cover",
-      kind: "cover",
-      prompt: "",
-      description: plan.coverImageDescription,
-      anchorAfterSection: null
-    },
-    ...plan.inlineImages.map((image, index) => ({
-      id: `inline-${index + 1}`,
-      kind: "inline",
-      prompt: "",
-      description: image.description,
-      anchorAfterSection: image.anchorAfterSection
-    }))
-  ];
-}
 function createReplicateInput(settings, prompt, kind) {
   const model = getT2IModel(settings.t2i.modelId);
   const overrides = sanitizeT2IOverrides(settings.t2i.modelId, settings.t2i.inputOverrides);
@@ -4951,7 +4989,9 @@ async function runPipelineShell(input, options = {}) {
         options.onUpdate?.(cloneStages(stages));
       } else {
         imagePrompts = await expandImagePrompts({
-          plan,
+          slots: selectImageSlots(plan, text.sections, { maxImages: options.maxImages }),
+          planContext: plan,
+          sections: text.sections,
           settings: input.config.settings,
           openRouter,
           dryRun,
@@ -6316,98 +6356,590 @@ function resolveCustomLinks(existing, addRaw, removeExpressions) {
   return Array.from(result.values());
 }
 
-// src/cli/commands/writeTargetSpecs.ts
-function parseTargetSpec(spec) {
-  const trimmed = spec.trim();
-  if (!trimmed) {
-    throw new ReportedError("Target spec cannot be empty. Use <content-type=count>.");
+// src/cli/commands/export.ts
+import { copyFile, mkdir as mkdir6, readFile as readFile8, stat as stat5, writeFile as writeFile6 } from "fs/promises";
+import path11 from "path";
+
+// src/output/enrichMarkdownWithLinks.ts
+function enrichMarkdownWithLinks(markdown, links) {
+  if (links.length === 0) {
+    return markdown;
   }
-  const [rawType, rawCount] = trimmed.split("=");
-  if (!rawType || !rawCount) {
-    throw new ReportedError(`Invalid target "${spec}". Use format content-type=count, e.g. article=1 or x-thread=3.`);
+  const sorted = [...links].sort((left, right) => right.expression.length - left.expression.length);
+  let updated = markdown;
+  for (const link of sorted) {
+    const escapedExpression = escapeRegExp(link.expression);
+    const leadBoundary = /^\w/.test(link.expression) ? "\\b" : "";
+    const trailBoundary = /\w$/.test(link.expression) ? "\\b" : "";
+    const expressionRegex = new RegExp(`${leadBoundary}${escapedExpression}${trailBoundary}`, "g");
+    let match;
+    while ((match = expressionRegex.exec(updated)) !== null) {
+      const start = match.index;
+      const end = start + match[0].length;
+      if (isInProtectedSpan(updated, start, end)) {
+        continue;
+      }
+      updated = `${updated.slice(0, start)}[${match[0]}](${link.url})${updated.slice(end)}`;
+      break;
+    }
   }
-  const contentType = rawType.trim();
-  if (!contentTypeValues.includes(contentType)) {
-    throw new ReportedError(
-      `Unsupported content type "${contentType}". Supported values: ${contentTypeValues.join(", ")}.`
-    );
+  return updated;
+}
+function isInProtectedSpan(content, start, end) {
+  const lineStart = content.lastIndexOf("\n", start) + 1;
+  const lineEndIdx = content.indexOf("\n", end);
+  const lineEnd = lineEndIdx === -1 ? content.length : lineEndIdx;
+  const line = content.slice(lineStart, lineEnd);
+  const linkPattern = /\[[^\]]*\]\([^)]*\)/g;
+  let m;
+  while ((m = linkPattern.exec(line)) !== null) {
+    const absStart = lineStart + m.index;
+    const absEnd = absStart + m[0].length;
+    if (start >= absStart && end <= absEnd) {
+      return true;
+    }
   }
-  const count = Number.parseInt(rawCount.trim(), 10);
-  if (!Number.isFinite(count) || count <= 0) {
-    throw new ReportedError(`Invalid count in target "${spec}". Count must be a positive integer.`);
+  const codePattern = /`[^`]+`/g;
+  while ((m = codePattern.exec(line)) !== null) {
+    const absStart = lineStart + m.index;
+    const absEnd = absStart + m[0].length;
+    if (start >= absStart && end <= absEnd) {
+      return true;
+    }
   }
-  return {
-    contentType,
-    count
-  };
+  return false;
 }
-function parsePrimaryAndSecondarySpecs(options) {
-  const { primarySpec, secondarySpecs } = options;
-  if (!primarySpec && (!secondarySpecs || secondarySpecs.length === 0)) {
-    return void 0;
+function escapeRegExp(value2) {
+  return value2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// src/server/previewHelpers.ts
+import { readdir, stat as stat4, readFile as readFile7 } from "fs/promises";
+import path10 from "path";
+var DEFAULT_PORT = 4173;
+var CONTENT_TYPE_ORDER = ["article", "blog-post", "x-thread", "x-post", "linkedin-post", "reddit-post", "newsletter"];
+var FILE_PREFIX_TO_CONTENT_TYPE = {
+  article: "article",
+  blog: "blog-post",
+  "x-thread": "x-thread",
+  "x-post": "x-post",
+  x: "x-post",
+  reddit: "reddit-post",
+  linkedin: "linkedin-post",
+  newsletter: "newsletter"
+};
+var CONTENT_TYPE_LABELS = {
+  article: "Article",
+  "blog-post": "Blog Post",
+  "x-thread": "X Thread",
+  "x-post": "X Post",
+  "reddit-post": "Reddit Post",
+  "linkedin-post": "LinkedIn Post",
+  newsletter: "Newsletter"
+};
+function parsePort(portOption) {
+  if (!portOption) {
+    return DEFAULT_PORT;
   }
-  if (!primarySpec) {
-    throw new ReportedError("Missing required --primary <content-type=count>.");
+  const port = Number.parseInt(portOption, 10);
+  if (Number.isNaN(port) || port < 1 || port > 65535) {
+    throw new Error(`Invalid port "${portOption}". Choose a value between 1 and 65535.`);
   }
-  const primary = parseTargetSpec(primarySpec);
-  if (primary.count !== 1) {
-    throw new ReportedError("Primary target count must be exactly 1. Use --primary <content-type=1>.");
+  return port;
+}
+function stripFrontmatter2(markdown) {
+  return markdown.replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, "");
+}
+function extractFrontmatterSlug(markdown) {
+  const frontmatterMatch = markdown.match(/^---\s*\n([\s\S]*?)\n---\s*\n?/);
+  const frontmatter = frontmatterMatch?.[1];
+  if (!frontmatter) {
+    return null;
   }
-  const secondaryDedupedByType = /* @__PURE__ */ new Map();
-  for (const spec of secondarySpecs ?? []) {
-    const parsed = parseTargetSpec(spec);
-    if (parsed.contentType === primary.contentType) {
-      throw new ReportedError(
-        `Content type "${parsed.contentType}" cannot be both primary and secondary in the same run.`
-      );
+  const slugMatch = frontmatter.match(/^slug:\s*(.+)$/m);
+  const rawSlug = slugMatch?.[1]?.trim();
+  if (!rawSlug) {
+    return null;
+  }
+  const unquoted = rawSlug.replace(/^['\"]|['\"]$/g, "").trim();
+  return unquoted.length > 0 ? unquoted : null;
+}
+function extractHeadingTitle(markdown) {
+  const headingMatch = markdown.match(/^#\s+(.+)$/m);
+  if (!headingMatch || !headingMatch[1]) {
+    return null;
+  }
+  return headingMatch[1].trim();
+}
+async function resolveMarkdownPath(markdownPathArg, markdownOutputDir, cwd2) {
+  if (markdownPathArg) {
+    const resolved = path10.isAbsolute(markdownPathArg) ? markdownPathArg : path10.resolve(cwd2, markdownPathArg);
+    if (path10.extname(resolved).toLowerCase() !== ".md") {
+      throw new Error(`Expected a markdown file (.md), received: ${resolved}`);
     }
-    const previous = secondaryDedupedByType.get(parsed.contentType);
-    if (previous) {
-      previous.count += parsed.count;
-      continue;
+    await assertFileExists(resolved, "Could not find markdown file");
+    return resolved;
+  }
+  return await resolveLatestMarkdown(markdownOutputDir);
+}
+async function resolveLatestMarkdown(markdownOutputDir) {
+  const markdownCandidates = await findMarkdownFiles(markdownOutputDir);
+  if (markdownCandidates.length === 0) {
+    throw new Error(
+      `No generated articles found in ${markdownOutputDir}. Run ideon write "your idea" first or pass a markdown path.`
+    );
+  }
+  let latestPath = markdownCandidates[0];
+  let latestMtime = 0;
+  for (const candidate of markdownCandidates) {
+    const fileStat = await stat4(candidate);
+    if (fileStat.mtimeMs >= latestMtime) {
+      latestMtime = fileStat.mtimeMs;
+      latestPath = candidate;
     }
-    secondaryDedupedByType.set(parsed.contentType, {
-      ...parsed,
-      role: "secondary"
-    });
   }
-  return [
-    {
-      ...primary,
-      role: "primary"
-    },
-    ...secondaryDedupedByType.values()
-  ];
+  return latestPath;
 }
-
-// src/integrations/mcp/server.ts
-async function startIdeonMcpServer() {
-  const server = new McpServer({
-    name: "ideon",
-    version: package_default.version
-  });
-  server.registerTool(
-    "ideon_write",
-    {
-      title: "Ideon Write",
-      description: "Generate content from an idea using the Ideon pipeline.",
-      inputSchema: writeToolInputSchema
-    },
-    async (input) => {
-      try {
-        const parsedTargets = parsePrimaryAndSecondarySpecs({
-          primarySpec: input.primary,
-          secondarySpecs: input.secondary
-        });
-        const resolved = await resolveRunInput({
-          idea: input.idea,
-          audience: input.audience,
-          jobPath: input.jobPath,
-          style: input.style,
-          intent: input.intent,
-          targetLength: input.length,
-          contentTargets: parsedTargets
-        });
+async function assertFileExists(filePath, errorPrefix) {
+  try {
+    const fileStat = await stat4(filePath);
+    if (!fileStat.isFile()) {
+      throw new Error(`${errorPrefix}: ${filePath}`);
+    }
+  } catch {
+    throw new Error(`${errorPrefix}: ${filePath}`);
+  }
+}
+function extractCoverImageUrl(markdown) {
+  const body = stripFrontmatter2(markdown);
+  const match = body.match(/!\[[^\]]*\]\(([^)]+)\)/);
+  return match?.[1] ?? null;
+}
+async function extractArticleMetadata(markdownPath) {
+  const markdown = await readFile7(markdownPath, "utf8");
+  const fileStat = await stat4(markdownPath);
+  const slug = extractFrontmatterSlug(markdown) ?? path10.basename(markdownPath, ".md");
+  const title = extractHeadingTitle(stripFrontmatter2(markdown)) ?? slug;
+  const body = stripFrontmatter2(markdown);
+  const previewSnippet = body.replace(/[#\[\]()!\-*_`]/g, "").trim().substring(0, 150);
+  const coverImageUrl = extractCoverImageUrl(markdown);
+  return {
+    slug,
+    title,
+    mtime: fileStat.mtimeMs,
+    previewSnippet,
+    coverImageUrl
+  };
+}
+async function listAllGenerations(markdownOutputDir) {
+  const markdownFiles = await findMarkdownFiles(markdownOutputDir);
+  const grouped = /* @__PURE__ */ new Map();
+  for (const filePath of markdownFiles) {
+    try {
+      const metadata = await extractArticleMetadata(filePath);
+      const identity = deriveOutputIdentity(filePath, markdownOutputDir);
+      const output = {
+        id: `${identity.generationId}:${identity.contentType}:${identity.index}`,
+        generationId: identity.generationId,
+        sourcePath: filePath,
+        slug: metadata.slug,
+        title: metadata.title,
+        previewSnippet: metadata.previewSnippet,
+        coverImageUrl: metadata.coverImageUrl,
+        mtime: metadata.mtime,
+        contentType: identity.contentType,
+        contentTypeLabel: toContentTypeLabel(identity.contentType),
+        index: identity.index
+      };
+      const existing = grouped.get(identity.generationId);
+      if (existing) {
+        existing.push(output);
+      } else {
+        grouped.set(identity.generationId, [output]);
+      }
+    } catch {
+    }
+  }
+  const generations = [];
+  for (const [id, outputs] of grouped.entries()) {
+    outputs.sort((a, b) => compareContentTypes(a.contentType, b.contentType) || a.index - b.index || b.mtime - a.mtime);
+    const primaryContentType = await resolvePrimaryContentType(outputs);
+    const primary = outputs.find((output) => output.contentType === primaryContentType) ?? outputs[0];
+    if (!primary) {
+      continue;
+    }
+    const newestMtime = outputs.reduce((latest, output) => Math.max(latest, output.mtime), 0);
+    generations.push({
+      id,
+      title: primary.title,
+      mtime: newestMtime,
+      previewSnippet: primary.previewSnippet,
+      coverImageUrl: primary.coverImageUrl ?? outputs.find((output) => Boolean(output.coverImageUrl))?.coverImageUrl ?? null,
+      primaryContentType,
+      outputs
+    });
+  }
+  generations.sort((a, b) => b.mtime - a.mtime);
+  return generations;
+}
+function deriveGenerationId(markdownPath, markdownOutputDir) {
+  const relative = path10.relative(markdownOutputDir, markdownPath);
+  const normalized = relative.split(path10.sep).join("/");
+  if (!normalized || normalized.startsWith("../")) {
+    return path10.basename(markdownPath, ".md");
+  }
+  const segments = normalized.split("/").filter(Boolean);
+  if (segments.length <= 1) {
+    return path10.basename(markdownPath, ".md");
+  }
+  return segments[0] ?? path10.basename(markdownPath, ".md");
+}
+async function findMarkdownFiles(markdownOutputDir) {
+  const files = [];
+  const stack = [markdownOutputDir];
+  while (stack.length > 0) {
+    const current = stack.pop();
+    if (!current) {
+      continue;
+    }
+    let entries;
+    try {
+      entries = await readdir(current, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const fullPath = path10.join(current, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(fullPath);
+        continue;
+      }
+      if (entry.isFile() && entry.name.toLowerCase().endsWith(".md")) {
+        files.push(fullPath);
+      }
+    }
+  }
+  return files;
+}
+function deriveOutputIdentity(markdownPath, markdownOutputDir) {
+  const generationId = deriveGenerationId(markdownPath, markdownOutputDir);
+  const fileBase = path10.basename(markdownPath, ".md");
+  const parsed = fileBase.match(/^([a-z0-9-]+)-(\d+)$/i);
+  if (!parsed || !parsed[1] || !parsed[2]) {
+    return {
+      generationId,
+      contentType: "article",
+      index: 1
+    };
+  }
+  const prefix = parsed[1].toLowerCase();
+  const index = Number.parseInt(parsed[2], 10);
+  return {
+    generationId,
+    contentType: FILE_PREFIX_TO_CONTENT_TYPE[prefix] ?? prefix,
+    index: Number.isFinite(index) && index > 0 ? index : 1
+  };
+}
+function compareContentTypes(left, right) {
+  const leftIndex = CONTENT_TYPE_ORDER.indexOf(left);
+  const rightIndex = CONTENT_TYPE_ORDER.indexOf(right);
+  const normalizedLeft = leftIndex === -1 ? Number.MAX_SAFE_INTEGER : leftIndex;
+  const normalizedRight = rightIndex === -1 ? Number.MAX_SAFE_INTEGER : rightIndex;
+  if (normalizedLeft !== normalizedRight) {
+    return normalizedLeft - normalizedRight;
+  }
+  return left.localeCompare(right);
+}
+function toContentTypeLabel(contentType) {
+  const knownLabel = CONTENT_TYPE_LABELS[contentType];
+  if (knownLabel) {
+    return knownLabel;
+  }
+  return contentType.split("-").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
+}
+async function resolvePrimaryContentType(outputs) {
+  const fallback = outputs.find((output) => output.contentType === "article")?.contentType ?? outputs[0]?.contentType ?? "article";
+  const generationDir = path10.dirname(outputs[0]?.sourcePath ?? "");
+  if (!generationDir) {
+    return fallback;
+  }
+  const jobPath = path10.join(generationDir, "job.json");
+  try {
+    const raw = await readFile7(jobPath, "utf8");
+    const parsed = JSON.parse(raw);
+    const targets = Array.isArray(parsed.contentTargets) ? parsed.contentTargets : Array.isArray(parsed.settings?.contentTargets) ? parsed.settings.contentTargets : [];
+    const primary = targets.find((target) => target?.role === "primary" && typeof target.contentType === "string");
+    if (primary && typeof primary.contentType === "string") {
+      return primary.contentType;
+    }
+  } catch {
+    return fallback;
+  }
+  return fallback;
+}
+
+// src/cli/commands/export.ts
+async function runOutputCommand(options, dependencies = {}) {
+  const cwd2 = dependencies.cwd ?? process.cwd();
+  const log = dependencies.log ?? ((message) => console.log(message));
+  const targetIndex = options.index ?? 1;
+  const resolved = await resolveRunInput({ idea: `Export generation ${options.generationId}` });
+  const outputPaths = resolveOutputPaths(resolved.config.settings, cwd2);
+  const generations = await listAllGenerations(outputPaths.markdownOutputDir);
+  const generation = resolveGeneration(generations, options.generationId);
+  const articleOutputs = generation.outputs.filter((output) => output.contentType === generation.primaryContentType);
+  if (articleOutputs.length === 0) {
+    throw new ReportedError(
+      `Generation "${generation.id}" has no primary content outputs (type: ${generation.primaryContentType}).`
+    );
+  }
+  const articleOutput = articleOutputs.find((output) => output.index === targetIndex);
+  if (!articleOutput) {
+    const available = articleOutputs.map((output) => output.index).join(", ");
+    throw new ReportedError(
+      `Generation "${generation.id}" has no primary output at index ${targetIndex}. Available: ${available}.`
+    );
+  }
+  const sourceMarkdownPath = articleOutput.sourcePath;
+  const sourceMarkdown = await readFile8(sourceMarkdownPath, "utf8");
+  const slug = extractFrontmatterSlug2(sourceMarkdown) ?? path11.basename(sourceMarkdownPath, ".md");
+  const exportFilename = `${slug}.md`;
+  const destinationDir = await resolveDestinationDir(options.destinationPath, cwd2);
+  const destinationFilePath = path11.join(destinationDir, exportFilename);
+  if (!options.overwrite && await fileExists2(destinationFilePath)) {
+    throw new ReportedError(
+      `Export file already exists: ${destinationFilePath}. Pass --overwrite to replace it.`
+    );
+  }
+  await mkdir6(destinationDir, { recursive: true });
+  const links = await loadLinks(sourceMarkdownPath);
+  const enrichedMarkdown = enrichWithFrontmatterGuard(sourceMarkdown, links);
+  const sourceDir = path11.dirname(sourceMarkdownPath);
+  const imagePaths = extractLocalImagePaths(sourceMarkdown);
+  const copiedImages = [];
+  for (const relImagePath of imagePaths) {
+    const absoluteImageSrc = path11.resolve(sourceDir, relImagePath);
+    let imageStat = null;
+    try {
+      imageStat = await stat5(absoluteImageSrc);
+    } catch {
+      throw new ReportedError(
+        `Referenced image not found: ${relImagePath} (resolved to ${absoluteImageSrc}).`
+      );
+    }
+    if (!imageStat.isFile()) {
+      throw new ReportedError(`Referenced image path is not a file: ${absoluteImageSrc}.`);
+    }
+    const destImagePath = path11.join(destinationDir, relImagePath);
+    await mkdir6(path11.dirname(destImagePath), { recursive: true });
+    await copyFile(absoluteImageSrc, destImagePath);
+    copiedImages.push(relImagePath);
+  }
+  await writeFile6(destinationFilePath, enrichedMarkdown, "utf8");
+  const relDest = path11.relative(cwd2, destinationFilePath);
+  log(`Exported "${generation.id}" (${generation.primaryContentType} #${targetIndex}) \u2192 ${relDest}`);
+  if (copiedImages.length > 0) {
+    log(`Copied ${copiedImages.length} image${copiedImages.length === 1 ? "" : "s"}: ${copiedImages.join(", ")}`);
+  }
+  if (links.length > 0) {
+    log(`Injected ${links.length} inline link${links.length === 1 ? "" : "s"}.`);
+  }
+}
+function resolveGeneration(generations, generationId) {
+  const exact = generations.find((g) => g.id === generationId);
+  if (exact) {
+    return exact;
+  }
+  const bySlug = generations.find(
+    (g) => g.outputs.some((output) => output.slug === generationId)
+  );
+  if (bySlug) {
+    return bySlug;
+  }
+  throw new ReportedError(
+    `Generation "${generationId}" not found. Run \`ideon preview\` to list available generations.`
+  );
+}
+async function resolveDestinationDir(destinationPath, cwd2) {
+  const resolved = path11.isAbsolute(destinationPath) ? destinationPath : path11.resolve(cwd2, destinationPath);
+  return resolved;
+}
+async function fileExists2(filePath) {
+  try {
+    const fileStat = await stat5(filePath);
+    return fileStat.isFile();
+  } catch {
+    return false;
+  }
+}
+async function loadLinks(markdownPath) {
+  const linksPath = resolveLinksPath(markdownPath);
+  let raw;
+  try {
+    raw = await readFile8(linksPath, "utf8");
+  } catch {
+    return [];
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return [];
+  }
+  if (typeof parsed !== "object" || parsed === null) {
+    return [];
+  }
+  const record = parsed;
+  const links = Array.isArray(record.links) ? record.links : [];
+  const customLinks = Array.isArray(record.customLinks) ? record.customLinks : [];
+  const combined = [...customLinks, ...links];
+  return combined.filter((entry) => {
+    if (typeof entry !== "object" || entry === null) {
+      return false;
+    }
+    const e = entry;
+    return typeof e.expression === "string" && typeof e.url === "string" && (e.title === null || typeof e.title === "string");
+  }).map((entry) => ({
+    expression: entry.expression.trim(),
+    url: entry.url.trim(),
+    title: entry.title
+  })).filter((entry) => entry.expression.length > 0 && entry.url.length > 0);
+}
+function enrichWithFrontmatterGuard(markdown, links) {
+  if (links.length === 0) {
+    return markdown;
+  }
+  const frontmatterMatch = markdown.match(/^---\s*\n[\s\S]*?\n---\s*\n?/);
+  if (!frontmatterMatch) {
+    return enrichMarkdownWithLinks(markdown, links);
+  }
+  const frontmatter = frontmatterMatch[0];
+  const body = markdown.slice(frontmatter.length);
+  return `${frontmatter}${enrichMarkdownWithLinks(body, links)}`;
+}
+function extractFrontmatterSlug2(markdown) {
+  const frontmatterMatch = markdown.match(/^---\s*\n([\s\S]*?)\n---\s*\n?/);
+  const block = frontmatterMatch?.[1];
+  if (!block) {
+    return null;
+  }
+  const slugMatch = block.match(/^slug:\s*(.+)$/m);
+  const rawSlug = slugMatch?.[1]?.trim();
+  if (!rawSlug) {
+    return null;
+  }
+  const unquoted = rawSlug.replace(/^['""]|['""]$/g, "").trim();
+  return unquoted.length > 0 ? unquoted : null;
+}
+function extractLocalImagePaths(markdown) {
+  const imagePattern = /!\[[^\]]*\]\(([^)]+)\)/g;
+  const paths = [];
+  let match;
+  while ((match = imagePattern.exec(markdown)) !== null) {
+    const rawPath = match[1]?.trim();
+    if (!rawPath) {
+      continue;
+    }
+    if (rawPath.startsWith("http://") || rawPath.startsWith("https://") || rawPath.startsWith("data:") || rawPath.startsWith("/") || rawPath.startsWith("#")) {
+      continue;
+    }
+    paths.push(rawPath);
+  }
+  return paths;
+}
+
+// src/cli/commands/writeTargetSpecs.ts
+function parseTargetSpec(spec) {
+  const trimmed = spec.trim();
+  if (!trimmed) {
+    throw new ReportedError("Target spec cannot be empty. Use <content-type=count>.");
+  }
+  const [rawType, rawCount] = trimmed.split("=");
+  if (!rawType || !rawCount) {
+    throw new ReportedError(`Invalid target "${spec}". Use format content-type=count, e.g. article=1 or x-thread=3.`);
+  }
+  const contentType = rawType.trim();
+  if (!contentTypeValues.includes(contentType)) {
+    throw new ReportedError(
+      `Unsupported content type "${contentType}". Supported values: ${contentTypeValues.join(", ")}.`
+    );
+  }
+  const count = Number.parseInt(rawCount.trim(), 10);
+  if (!Number.isFinite(count) || count <= 0) {
+    throw new ReportedError(`Invalid count in target "${spec}". Count must be a positive integer.`);
+  }
+  return {
+    contentType,
+    count
+  };
+}
+function parsePrimaryAndSecondarySpecs(options) {
+  const { primarySpec, secondarySpecs } = options;
+  if (!primarySpec && (!secondarySpecs || secondarySpecs.length === 0)) {
+    return void 0;
+  }
+  if (!primarySpec) {
+    throw new ReportedError("Missing required --primary <content-type=count>.");
+  }
+  const primary = parseTargetSpec(primarySpec);
+  if (primary.count !== 1) {
+    throw new ReportedError("Primary target count must be exactly 1. Use --primary <content-type=1>.");
+  }
+  const secondaryDedupedByType = /* @__PURE__ */ new Map();
+  for (const spec of secondarySpecs ?? []) {
+    const parsed = parseTargetSpec(spec);
+    if (parsed.contentType === primary.contentType) {
+      throw new ReportedError(
+        `Content type "${parsed.contentType}" cannot be both primary and secondary in the same run.`
+      );
+    }
+    const previous = secondaryDedupedByType.get(parsed.contentType);
+    if (previous) {
+      previous.count += parsed.count;
+      continue;
+    }
+    secondaryDedupedByType.set(parsed.contentType, {
+      ...parsed,
+      role: "secondary"
+    });
+  }
+  return [
+    {
+      ...primary,
+      role: "primary"
+    },
+    ...secondaryDedupedByType.values()
+  ];
+}
+
+// src/integrations/mcp/server.ts
+async function startIdeonMcpServer() {
+  const server = new McpServer({
+    name: "ideon",
+    version: package_default.version
+  });
+  server.registerTool(
+    "ideon_write",
+    {
+      title: "Ideon Write",
+      description: "Generate content from an idea using the Ideon pipeline.",
+      inputSchema: writeToolInputSchema
+    },
+    async (input) => {
+      try {
+        const parsedTargets = parsePrimaryAndSecondarySpecs({
+          primarySpec: input.primary,
+          secondarySpecs: input.secondary
+        });
+        const resolved = await resolveRunInput({
+          idea: input.idea,
+          audience: input.audience,
+          jobPath: input.jobPath,
+          style: input.style,
+          intent: input.intent,
+          targetLength: input.length,
+          contentTargets: parsedTargets
+        });
         const run = await runPipelineShell(resolved, {
           workingDir: cwd(),
           runMode: "fresh",
@@ -6415,7 +6947,8 @@ async function startIdeonMcpServer() {
           enrichLinks: input.enrichLinks ?? false,
           customLinks: input.link,
           unlinks: input.unlink,
-          maxLinks: input.maxLinks
+          maxLinks: input.maxLinks,
+          maxImages: input.maxImages
         });
         return {
           content: [
@@ -6474,7 +7007,8 @@ async function startIdeonMcpServer() {
           enrichLinks: input.enrichLinks ?? false,
           customLinks: input.link,
           unlinks: input.unlink,
-          maxLinks: input.maxLinks
+          maxLinks: input.maxLinks,
+          maxImages: input.maxImages
         });
         return {
           content: [
@@ -6575,6 +7109,50 @@ async function startIdeonMcpServer() {
       }
     }
   );
+  server.registerTool(
+    "ideon_export",
+    {
+      title: "Ideon Export",
+      description: "Export a generated article as a standalone markdown file with inline links and copied images.",
+      inputSchema: exportToolInputZodSchema
+    },
+    async (input) => {
+      try {
+        const messages = [];
+        await runOutputCommand(
+          {
+            generationId: input.generationId,
+            destinationPath: input.destinationPath,
+            index: input.index,
+            overwrite: input.overwrite
+          },
+          {
+            cwd: cwd(),
+            log: (message) => {
+              messages.push(message);
+            }
+          }
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: messages.length > 0 ? messages.join("\n") : `Exported ${input.generationId}.`
+            }
+          ],
+          structuredContent: {
+            generationId: input.generationId,
+            destinationPath: input.destinationPath,
+            index: input.index ?? 1,
+            overwrite: input.overwrite ?? false,
+            messages
+          }
+        };
+      } catch (error) {
+        return formatToolError(error);
+      }
+    }
+  );
   server.registerTool(
     "ideon_config_get",
     {
@@ -6940,476 +7518,156 @@ function applyEdit(action, value2, settings, secrets, setSettings, setSecrets) {
     setSettings({
       ...settings,
       notifications: {
-        ...settings.notifications,
-        enabled: parsed
-      }
-    });
-    return;
-  }
-  if (action === "temperature") {
-    const nextTemperature = clampNumber2(parseNumberOrFallback(value2, settings.modelSettings.temperature), 0, 2);
-    setSettings({
-      ...settings,
-      modelSettings: {
-        ...settings.modelSettings,
-        temperature: nextTemperature
-      }
-    });
-    return;
-  }
-  if (action === "maxTokens") {
-    const nextMaxTokens = Math.max(1, Math.round(parseNumberOrFallback(value2, settings.modelSettings.maxTokens)));
-    setSettings({
-      ...settings,
-      modelSettings: {
-        ...settings.modelSettings,
-        maxTokens: nextMaxTokens
+        ...settings.notifications,
+        enabled: parsed
       }
     });
     return;
   }
-  if (action === "topP") {
-    const nextTopP = clampNumber2(parseNumberOrFallback(value2, settings.modelSettings.topP), 0, 1);
+  if (action === "temperature") {
+    const nextTemperature = clampNumber2(parseNumberOrFallback(value2, settings.modelSettings.temperature), 0, 2);
     setSettings({
       ...settings,
       modelSettings: {
         ...settings.modelSettings,
-        topP: nextTopP
+        temperature: nextTemperature
       }
     });
     return;
   }
-  if (action === "markdownOutputDir") {
-    setSettings({ ...settings, markdownOutputDir: value2.trim() || settings.markdownOutputDir });
-    return;
-  }
-  if (action === "assetOutputDir") {
-    setSettings({ ...settings, assetOutputDir: value2.trim() || settings.assetOutputDir });
-    return;
-  }
-  if (action.startsWith("t2i:")) {
-    const fieldName = action.slice(4);
-    const parsedValue = coerceT2IFieldValue(settings.t2i.modelId, fieldName, value2);
-    const nextOverrides = { ...settings.t2i.inputOverrides };
-    if (parsedValue === void 0) {
-      delete nextOverrides[fieldName];
-    } else {
-      nextOverrides[fieldName] = parsedValue;
-    }
+  if (action === "maxTokens") {
+    const nextMaxTokens = Math.max(1, Math.round(parseNumberOrFallback(value2, settings.modelSettings.maxTokens)));
     setSettings({
       ...settings,
-      t2i: {
-        ...settings.t2i,
-        inputOverrides: nextOverrides
-      }
-    });
-  }
-}
-function formatEditorValue(value2) {
-  if (value2 === null || value2 === void 0) {
-    return "";
-  }
-  return String(value2);
-}
-function formatValue(value2) {
-  if (value2 === null || value2 === void 0 || value2 === "") {
-    return "(default)";
-  }
-  return String(value2);
-}
-function parseNumberOrFallback(value2, fallback) {
-  const parsed = Number(value2.trim());
-  return Number.isFinite(parsed) ? parsed : fallback;
-}
-function clampNumber2(value2, minimum, maximum) {
-  return Math.min(maximum, Math.max(minimum, value2));
-}
-function parseBooleanOrFallback(value2, fallback) {
-  const normalized = value2.trim().toLowerCase();
-  if (normalized === "true") {
-    return true;
-  }
-  if (normalized === "false") {
-    return false;
-  }
-  return fallback;
-}
-
-// src/cli/commands/settings.tsx
-import { jsx as jsx2 } from "react/jsx-runtime";
-async function openSettings() {
-  const envSettings = readEnvSettings();
-  const [settings, secrets] = await Promise.all([
-    loadSavedSettings(),
-    loadSecrets({ disableKeytar: envSettings.disableKeytar })
-  ]);
-  let result = null;
-  const app = render(
-    /* @__PURE__ */ jsx2(
-      SettingsFlow,
-      {
-        initialSettings: settings,
-        initialSecrets: secrets,
-        onDone: (value2) => {
-          result = value2;
-        }
-      }
-    )
-  );
-  await app.waitUntilExit();
-  const finalResult = result;
-  if (!finalResult) {
-    console.log("Settings unchanged.");
-    return;
-  }
-  const savedResult = finalResult;
-  await saveSettings(savedResult.settings);
-  try {
-    await saveSecrets(savedResult.secrets, { disableKeytar: envSettings.disableKeytar });
-  } catch (error) {
-    if (error instanceof KeytarUnavailableError) {
-      console.log("Settings saved, but secrets were not stored in the system keychain.");
-      console.log("Use IDEON_OPENROUTER_API_KEY and IDEON_REPLICATE_API_TOKEN in this environment.");
-      return;
-    }
-    throw error;
-  }
-  console.log(`Settings saved to ${getSettingsFilePath()}.`);
-}
-
-// src/cli/commands/serve.ts
-import path12 from "path";
-import { spawn } from "child_process";
-
-// src/server/previewHelpers.ts
-import { readdir, stat as stat4, readFile as readFile7 } from "fs/promises";
-import path10 from "path";
-var DEFAULT_PORT = 4173;
-var CONTENT_TYPE_ORDER = ["article", "blog-post", "x-thread", "x-post", "linkedin-post", "reddit-post", "newsletter"];
-var FILE_PREFIX_TO_CONTENT_TYPE = {
-  article: "article",
-  blog: "blog-post",
-  "x-thread": "x-thread",
-  "x-post": "x-post",
-  x: "x-post",
-  reddit: "reddit-post",
-  linkedin: "linkedin-post",
-  newsletter: "newsletter"
-};
-var CONTENT_TYPE_LABELS = {
-  article: "Article",
-  "blog-post": "Blog Post",
-  "x-thread": "X Thread",
-  "x-post": "X Post",
-  "reddit-post": "Reddit Post",
-  "linkedin-post": "LinkedIn Post",
-  newsletter: "Newsletter"
-};
-function parsePort(portOption) {
-  if (!portOption) {
-    return DEFAULT_PORT;
-  }
-  const port = Number.parseInt(portOption, 10);
-  if (Number.isNaN(port) || port < 1 || port > 65535) {
-    throw new Error(`Invalid port "${portOption}". Choose a value between 1 and 65535.`);
-  }
-  return port;
-}
-function stripFrontmatter2(markdown) {
-  return markdown.replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, "");
-}
-function extractFrontmatterSlug(markdown) {
-  const frontmatterMatch = markdown.match(/^---\s*\n([\s\S]*?)\n---\s*\n?/);
-  const frontmatter = frontmatterMatch?.[1];
-  if (!frontmatter) {
-    return null;
-  }
-  const slugMatch = frontmatter.match(/^slug:\s*(.+)$/m);
-  const rawSlug = slugMatch?.[1]?.trim();
-  if (!rawSlug) {
-    return null;
-  }
-  const unquoted = rawSlug.replace(/^['\"]|['\"]$/g, "").trim();
-  return unquoted.length > 0 ? unquoted : null;
-}
-function extractHeadingTitle(markdown) {
-  const headingMatch = markdown.match(/^#\s+(.+)$/m);
-  if (!headingMatch || !headingMatch[1]) {
-    return null;
-  }
-  return headingMatch[1].trim();
-}
-async function resolveMarkdownPath(markdownPathArg, markdownOutputDir, cwd2) {
-  if (markdownPathArg) {
-    const resolved = path10.isAbsolute(markdownPathArg) ? markdownPathArg : path10.resolve(cwd2, markdownPathArg);
-    if (path10.extname(resolved).toLowerCase() !== ".md") {
-      throw new Error(`Expected a markdown file (.md), received: ${resolved}`);
-    }
-    await assertFileExists(resolved, "Could not find markdown file");
-    return resolved;
-  }
-  return await resolveLatestMarkdown(markdownOutputDir);
-}
-async function resolveLatestMarkdown(markdownOutputDir) {
-  const markdownCandidates = await findMarkdownFiles(markdownOutputDir);
-  if (markdownCandidates.length === 0) {
-    throw new Error(
-      `No generated articles found in ${markdownOutputDir}. Run ideon write "your idea" first or pass a markdown path.`
-    );
-  }
-  let latestPath = markdownCandidates[0];
-  let latestMtime = 0;
-  for (const candidate of markdownCandidates) {
-    const fileStat = await stat4(candidate);
-    if (fileStat.mtimeMs >= latestMtime) {
-      latestMtime = fileStat.mtimeMs;
-      latestPath = candidate;
-    }
-  }
-  return latestPath;
-}
-async function assertFileExists(filePath, errorPrefix) {
-  try {
-    const fileStat = await stat4(filePath);
-    if (!fileStat.isFile()) {
-      throw new Error(`${errorPrefix}: ${filePath}`);
-    }
-  } catch {
-    throw new Error(`${errorPrefix}: ${filePath}`);
-  }
-}
-function extractCoverImageUrl(markdown) {
-  const body = stripFrontmatter2(markdown);
-  const match = body.match(/!\[[^\]]*\]\(([^)]+)\)/);
-  return match?.[1] ?? null;
-}
-async function extractArticleMetadata(markdownPath) {
-  const markdown = await readFile7(markdownPath, "utf8");
-  const fileStat = await stat4(markdownPath);
-  const slug = extractFrontmatterSlug(markdown) ?? path10.basename(markdownPath, ".md");
-  const title = extractHeadingTitle(stripFrontmatter2(markdown)) ?? slug;
-  const body = stripFrontmatter2(markdown);
-  const previewSnippet = body.replace(/[#\[\]()!\-*_`]/g, "").trim().substring(0, 150);
-  const coverImageUrl = extractCoverImageUrl(markdown);
-  return {
-    slug,
-    title,
-    mtime: fileStat.mtimeMs,
-    previewSnippet,
-    coverImageUrl
-  };
-}
-async function listAllGenerations(markdownOutputDir) {
-  const markdownFiles = await findMarkdownFiles(markdownOutputDir);
-  const grouped = /* @__PURE__ */ new Map();
-  for (const filePath of markdownFiles) {
-    try {
-      const metadata = await extractArticleMetadata(filePath);
-      const identity = deriveOutputIdentity(filePath, markdownOutputDir);
-      const output = {
-        id: `${identity.generationId}:${identity.contentType}:${identity.index}`,
-        generationId: identity.generationId,
-        sourcePath: filePath,
-        slug: metadata.slug,
-        title: metadata.title,
-        previewSnippet: metadata.previewSnippet,
-        coverImageUrl: metadata.coverImageUrl,
-        mtime: metadata.mtime,
-        contentType: identity.contentType,
-        contentTypeLabel: toContentTypeLabel(identity.contentType),
-        index: identity.index
-      };
-      const existing = grouped.get(identity.generationId);
-      if (existing) {
-        existing.push(output);
-      } else {
-        grouped.set(identity.generationId, [output]);
+      modelSettings: {
+        ...settings.modelSettings,
+        maxTokens: nextMaxTokens
       }
-    } catch {
-    }
+    });
+    return;
   }
-  const generations = [];
-  for (const [id, outputs] of grouped.entries()) {
-    outputs.sort((a, b) => compareContentTypes(a.contentType, b.contentType) || a.index - b.index || b.mtime - a.mtime);
-    const primaryContentType = await resolvePrimaryContentType(outputs);
-    const primary = outputs.find((output) => output.contentType === primaryContentType) ?? outputs[0];
-    if (!primary) {
-      continue;
-    }
-    const newestMtime = outputs.reduce((latest, output) => Math.max(latest, output.mtime), 0);
-    generations.push({
-      id,
-      title: primary.title,
-      mtime: newestMtime,
-      previewSnippet: primary.previewSnippet,
-      coverImageUrl: primary.coverImageUrl ?? outputs.find((output) => Boolean(output.coverImageUrl))?.coverImageUrl ?? null,
-      primaryContentType,
-      outputs
+  if (action === "topP") {
+    const nextTopP = clampNumber2(parseNumberOrFallback(value2, settings.modelSettings.topP), 0, 1);
+    setSettings({
+      ...settings,
+      modelSettings: {
+        ...settings.modelSettings,
+        topP: nextTopP
+      }
     });
+    return;
   }
-  generations.sort((a, b) => b.mtime - a.mtime);
-  return generations;
-}
-function deriveGenerationId(markdownPath, markdownOutputDir) {
-  const relative = path10.relative(markdownOutputDir, markdownPath);
-  const normalized = relative.split(path10.sep).join("/");
-  if (!normalized || normalized.startsWith("../")) {
-    return path10.basename(markdownPath, ".md");
+  if (action === "markdownOutputDir") {
+    setSettings({ ...settings, markdownOutputDir: value2.trim() || settings.markdownOutputDir });
+    return;
   }
-  const segments = normalized.split("/").filter(Boolean);
-  if (segments.length <= 1) {
-    return path10.basename(markdownPath, ".md");
+  if (action === "assetOutputDir") {
+    setSettings({ ...settings, assetOutputDir: value2.trim() || settings.assetOutputDir });
+    return;
   }
-  return segments[0] ?? path10.basename(markdownPath, ".md");
-}
-async function findMarkdownFiles(markdownOutputDir) {
-  const files = [];
-  const stack = [markdownOutputDir];
-  while (stack.length > 0) {
-    const current = stack.pop();
-    if (!current) {
-      continue;
-    }
-    let entries;
-    try {
-      entries = await readdir(current, { withFileTypes: true });
-    } catch {
-      continue;
+  if (action.startsWith("t2i:")) {
+    const fieldName = action.slice(4);
+    const parsedValue = coerceT2IFieldValue(settings.t2i.modelId, fieldName, value2);
+    const nextOverrides = { ...settings.t2i.inputOverrides };
+    if (parsedValue === void 0) {
+      delete nextOverrides[fieldName];
+    } else {
+      nextOverrides[fieldName] = parsedValue;
     }
-    for (const entry of entries) {
-      const fullPath = path10.join(current, entry.name);
-      if (entry.isDirectory()) {
-        stack.push(fullPath);
-        continue;
-      }
-      if (entry.isFile() && entry.name.toLowerCase().endsWith(".md")) {
-        files.push(fullPath);
+    setSettings({
+      ...settings,
+      t2i: {
+        ...settings.t2i,
+        inputOverrides: nextOverrides
       }
-    }
+    });
   }
-  return files;
 }
-function deriveOutputIdentity(markdownPath, markdownOutputDir) {
-  const generationId = deriveGenerationId(markdownPath, markdownOutputDir);
-  const fileBase = path10.basename(markdownPath, ".md");
-  const parsed = fileBase.match(/^([a-z0-9-]+)-(\d+)$/i);
-  if (!parsed || !parsed[1] || !parsed[2]) {
-    return {
-      generationId,
-      contentType: "article",
-      index: 1
-    };
+function formatEditorValue(value2) {
+  if (value2 === null || value2 === void 0) {
+    return "";
   }
-  const prefix = parsed[1].toLowerCase();
-  const index = Number.parseInt(parsed[2], 10);
-  return {
-    generationId,
-    contentType: FILE_PREFIX_TO_CONTENT_TYPE[prefix] ?? prefix,
-    index: Number.isFinite(index) && index > 0 ? index : 1
-  };
+  return String(value2);
 }
-function compareContentTypes(left, right) {
-  const leftIndex = CONTENT_TYPE_ORDER.indexOf(left);
-  const rightIndex = CONTENT_TYPE_ORDER.indexOf(right);
-  const normalizedLeft = leftIndex === -1 ? Number.MAX_SAFE_INTEGER : leftIndex;
-  const normalizedRight = rightIndex === -1 ? Number.MAX_SAFE_INTEGER : rightIndex;
-  if (normalizedLeft !== normalizedRight) {
-    return normalizedLeft - normalizedRight;
+function formatValue(value2) {
+  if (value2 === null || value2 === void 0 || value2 === "") {
+    return "(default)";
   }
-  return left.localeCompare(right);
+  return String(value2);
 }
-function toContentTypeLabel(contentType) {
-  const knownLabel = CONTENT_TYPE_LABELS[contentType];
-  if (knownLabel) {
-    return knownLabel;
+function parseNumberOrFallback(value2, fallback) {
+  const parsed = Number(value2.trim());
+  return Number.isFinite(parsed) ? parsed : fallback;
+}
+function clampNumber2(value2, minimum, maximum) {
+  return Math.min(maximum, Math.max(minimum, value2));
+}
+function parseBooleanOrFallback(value2, fallback) {
+  const normalized = value2.trim().toLowerCase();
+  if (normalized === "true") {
+    return true;
   }
-  return contentType.split("-").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
+  if (normalized === "false") {
+    return false;
+  }
+  return fallback;
 }
-async function resolvePrimaryContentType(outputs) {
-  const fallback = outputs.find((output) => output.contentType === "article")?.contentType ?? outputs[0]?.contentType ?? "article";
-  const generationDir = path10.dirname(outputs[0]?.sourcePath ?? "");
-  if (!generationDir) {
-    return fallback;
+
+// src/cli/commands/settings.tsx
+import { jsx as jsx2 } from "react/jsx-runtime";
+async function openSettings() {
+  const envSettings = readEnvSettings();
+  const [settings, secrets] = await Promise.all([
+    loadSavedSettings(),
+    loadSecrets({ disableKeytar: envSettings.disableKeytar })
+  ]);
+  let result = null;
+  const app = render(
+    /* @__PURE__ */ jsx2(
+      SettingsFlow,
+      {
+        initialSettings: settings,
+        initialSecrets: secrets,
+        onDone: (value2) => {
+          result = value2;
+        }
+      }
+    )
+  );
+  await app.waitUntilExit();
+  const finalResult = result;
+  if (!finalResult) {
+    console.log("Settings unchanged.");
+    return;
   }
-  const jobPath = path10.join(generationDir, "job.json");
+  const savedResult = finalResult;
+  await saveSettings(savedResult.settings);
   try {
-    const raw = await readFile7(jobPath, "utf8");
-    const parsed = JSON.parse(raw);
-    const targets = Array.isArray(parsed.contentTargets) ? parsed.contentTargets : Array.isArray(parsed.settings?.contentTargets) ? parsed.settings.contentTargets : [];
-    const primary = targets.find((target) => target?.role === "primary" && typeof target.contentType === "string");
-    if (primary && typeof primary.contentType === "string") {
-      return primary.contentType;
+    await saveSecrets(savedResult.secrets, { disableKeytar: envSettings.disableKeytar });
+  } catch (error) {
+    if (error instanceof KeytarUnavailableError) {
+      console.log("Settings saved, but secrets were not stored in the system keychain.");
+      console.log("Use IDEON_OPENROUTER_API_KEY and IDEON_REPLICATE_API_TOKEN in this environment.");
+      return;
     }
-  } catch {
-    return fallback;
+    throw error;
   }
-  return fallback;
+  console.log(`Settings saved to ${getSettingsFilePath()}.`);
 }
 
+// src/cli/commands/serve.ts
+import path13 from "path";
+import { spawn } from "child_process";
+
 // src/server/previewServer.ts
 import { execFile } from "child_process";
 import { promisify } from "util";
-import { readFile as readFile8, stat as stat5 } from "fs/promises";
+import { readFile as readFile9, stat as stat6 } from "fs/promises";
 import { watch as fsWatch } from "fs";
-import path11 from "path";
+import path12 from "path";
 import { fileURLToPath } from "url";
 import express from "express";
 import { marked } from "marked";
-
-// src/output/enrichMarkdownWithLinks.ts
-function enrichMarkdownWithLinks(markdown, links) {
-  if (links.length === 0) {
-    return markdown;
-  }
-  const sorted = [...links].sort((left, right) => right.expression.length - left.expression.length);
-  let updated = markdown;
-  for (const link of sorted) {
-    const escapedExpression = escapeRegExp(link.expression);
-    const leadBoundary = /^\w/.test(link.expression) ? "\\b" : "";
-    const trailBoundary = /\w$/.test(link.expression) ? "\\b" : "";
-    const expressionRegex = new RegExp(`${leadBoundary}${escapedExpression}${trailBoundary}`, "g");
-    let match;
-    while ((match = expressionRegex.exec(updated)) !== null) {
-      const start = match.index;
-      const end = start + match[0].length;
-      if (isInProtectedSpan(updated, start, end)) {
-        continue;
-      }
-      updated = `${updated.slice(0, start)}[${match[0]}](${link.url})${updated.slice(end)}`;
-      break;
-    }
-  }
-  return updated;
-}
-function isInProtectedSpan(content, start, end) {
-  const lineStart = content.lastIndexOf("\n", start) + 1;
-  const lineEndIdx = content.indexOf("\n", end);
-  const lineEnd = lineEndIdx === -1 ? content.length : lineEndIdx;
-  const line = content.slice(lineStart, lineEnd);
-  const linkPattern = /\[[^\]]*\]\([^)]*\)/g;
-  let m;
-  while ((m = linkPattern.exec(line)) !== null) {
-    const absStart = lineStart + m.index;
-    const absEnd = absStart + m[0].length;
-    if (start >= absStart && end <= absEnd) {
-      return true;
-    }
-  }
-  const codePattern = /`[^`]+`/g;
-  while ((m = codePattern.exec(line)) !== null) {
-    const absStart = lineStart + m.index;
-    const absEnd = absStart + m[0].length;
-    if (start >= absStart && end <= absEnd) {
-      return true;
-    }
-  }
-  return false;
-}
-function escapeRegExp(value2) {
-  return value2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-
-// src/server/previewServer.ts
 var execFileAsync = promisify(execFile);
 var MissingArticleError = class extends Error {
   constructor(message) {
@@ -7504,7 +7762,7 @@ async function startPreviewServer(options) {
         if (options.watch) {
           let html2;
           try {
-            html2 = await readFile8(path11.join(previewClientDir, "index.html"), "utf8");
+            html2 = await readFile9(path12.join(previewClientDir, "index.html"), "utf8");
           } catch {
             res.status(200).type("html").send(
               `<!doctype html><html><head><meta charset="utf-8"><title>Rebuilding\u2026</title><style>body{margin:0;display:flex;align-items:center;justify-content:center;height:100vh;font-family:sans-serif;background:#101820;color:#e0eaf0}p{font-size:15px;opacity:.7}</style></head><body><p>Rebuilding\u2026</p><script>const s=new EventSource('/api/__reload');s.onmessage=function(){location.reload()};</script></body></html>`
@@ -7515,7 +7773,7 @@ async function startPreviewServer(options) {
           const injected = html2.replace("</body>", `${reloadScript}</body>`);
           res.status(200).type("html").send(injected);
         } else {
-          res.status(200).sendFile(path11.join(previewClientDir, "index.html"));
+          res.status(200).sendFile(path12.join(previewClientDir, "index.html"));
         }
         return;
       }
@@ -7568,7 +7826,7 @@ async function getArticleContent(generationId, markdownOutputDir) {
     generation.outputs.map(async (output) => {
       let markdown = "";
       try {
-        markdown = await readFile8(output.sourcePath, "utf8");
+        markdown = await readFile9(output.sourcePath, "utf8");
       } catch (error) {
         if (isMissingFileError(error)) {
           throw new MissingArticleError(`Generation "${generationId}" no longer exists.`);
@@ -7586,7 +7844,7 @@ async function getArticleContent(generationId, markdownOutputDir) {
       };
     })
   );
-  const generationDir = path11.dirname(generation.outputs[0]?.sourcePath ?? "");
+  const generationDir = path12.dirname(generation.outputs[0]?.sourcePath ?? "");
   const interactions = generationDir ? await loadSavedInteractions(generationDir) : { llmCalls: [], t2iCalls: [] };
   const analyticsSummary = generationDir ? await loadSavedAnalyticsSummary(generationDir) : null;
   return {
@@ -7615,7 +7873,7 @@ async function resolveActivePreviewArticle(preferredMarkdownPath, markdownOutput
   };
 }
 function resolveGenerationSourcePath(generation, markdownOutputDir) {
-  return generation.outputs.find((output) => output.contentType === generation.primaryContentType)?.sourcePath ?? generation.outputs[0]?.sourcePath ?? path11.join(markdownOutputDir, generation.id);
+  return generation.outputs.find((output) => output.contentType === generation.primaryContentType)?.sourcePath ?? generation.outputs[0]?.sourcePath ?? path12.join(markdownOutputDir, generation.id);
 }
 function isMissingFileError(error) {
   return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
@@ -7630,7 +7888,7 @@ async function renderArticleHtml(markdown, generationId, sourcePath) {
 async function loadSavedLinks(markdownPath) {
   const linksPath = resolveLinksPath(markdownPath);
   try {
-    const raw = await readFile8(linksPath, "utf8");
+    const raw = await readFile9(linksPath, "utf8");
     const parsed = JSON.parse(raw);
     if (!Array.isArray(parsed.links)) {
       return [];
@@ -7654,9 +7912,9 @@ async function loadSavedLinks(markdownPath) {
   }
 }
 async function loadSavedInteractions(generationDir) {
-  const interactionsPath = path11.join(generationDir, "model.interactions.json");
+  const interactionsPath = path12.join(generationDir, "model.interactions.json");
   try {
-    const raw = await readFile8(interactionsPath, "utf8");
+    const raw = await readFile9(interactionsPath, "utf8");
     const parsed = JSON.parse(raw);
     const llmCalls = Array.isArray(parsed.llmCalls) ? parsed.llmCalls.filter(isPreviewLlmInteraction) : [];
     const t2iCalls = Array.isArray(parsed.t2iCalls) ? parsed.t2iCalls.filter(isPreviewT2IInteraction) : [];
@@ -7672,9 +7930,9 @@ async function loadSavedInteractions(generationDir) {
   }
 }
 async function loadSavedAnalyticsSummary(generationDir) {
-  const analyticsPath = path11.join(generationDir, "generation.analytics.json");
+  const analyticsPath = path12.join(generationDir, "generation.analytics.json");
   try {
-    const raw = await readFile8(analyticsPath, "utf8");
+    const raw = await readFile9(analyticsPath, "utf8");
     const parsed = JSON.parse(raw);
     const summary = parsed.summary;
     if (!summary || typeof summary !== "object") {
@@ -7706,14 +7964,14 @@ async function getPreviewBootstrapData(preferredMarkdownPath, markdownOutputDir)
   };
 }
 async function resolvePreviewClientBuildDir() {
-  const currentDir = path11.dirname(fileURLToPath(import.meta.url));
+  const currentDir = path12.dirname(fileURLToPath(import.meta.url));
   const candidates = [
-    path11.resolve(currentDir, "preview"),
-    path11.resolve(currentDir, "../../dist/preview")
+    path12.resolve(currentDir, "preview"),
+    path12.resolve(currentDir, "../../dist/preview")
   ];
   for (const candidate of candidates) {
     try {
-      const indexStat = await stat5(path11.join(candidate, "index.html"));
+      const indexStat = await stat6(path12.join(candidate, "index.html"));
       if (indexStat.isFile()) {
         return candidate;
       }
@@ -7775,21 +8033,21 @@ async function resolveGenerationAssetPath(generationId, rawAssetPath, markdownOu
     throw new MissingArticleError(`Generation "${generationId}" no longer exists.`);
   }
   const decodedAssetPath = decodeURIComponent(rawAssetPath);
-  const normalizedRelative = path11.posix.normalize(decodedAssetPath.replace(/\\/g, "/"));
-  if (normalizedRelative.length === 0 || normalizedRelative === "." || normalizedRelative.startsWith("../") || normalizedRelative.includes("/../") || path11.posix.isAbsolute(normalizedRelative)) {
+  const normalizedRelative = path12.posix.normalize(decodedAssetPath.replace(/\\/g, "/"));
+  if (normalizedRelative.length === 0 || normalizedRelative === "." || normalizedRelative.startsWith("../") || normalizedRelative.includes("/../") || path12.posix.isAbsolute(normalizedRelative)) {
     throw new Error("Invalid generation asset path.");
   }
-  const generationDir = path11.dirname(generation.outputs[0]?.sourcePath ?? "");
+  const generationDir = path12.dirname(generation.outputs[0]?.sourcePath ?? "");
   if (!generationDir) {
     throw new MissingArticleError(`Generation "${generationId}" has no source directory.`);
   }
-  const resolvedPath = path11.resolve(generationDir, normalizedRelative);
-  const relativeToGeneration = path11.relative(generationDir, resolvedPath);
-  if (relativeToGeneration.startsWith("..") || path11.isAbsolute(relativeToGeneration)) {
+  const resolvedPath = path12.resolve(generationDir, normalizedRelative);
+  const relativeToGeneration = path12.relative(generationDir, resolvedPath);
+  if (relativeToGeneration.startsWith("..") || path12.isAbsolute(relativeToGeneration)) {
     throw new Error("Invalid generation asset path.");
   }
   try {
-    const fileStat = await stat5(resolvedPath);
+    const fileStat = await stat6(resolvedPath);
     if (!fileStat.isFile()) {
       throw new Error("Invalid generation asset path.");
     }
@@ -9269,7 +9527,7 @@ async function runServeCommand(options) {
   const markdownPath = await resolveMarkdownPath(options.markdownPath, outputPaths.markdownOutputDir, process.cwd());
   const port = parsePort(options.port);
   if (options.watch) {
-    const viteBin = path12.resolve(process.cwd(), "node_modules", ".bin", "vite");
+    const viteBin = path13.resolve(process.cwd(), "node_modules", ".bin", "vite");
     const viteProcess = spawn(viteBin, ["build", "--watch"], {
       stdio: "inherit",
       shell: process.platform === "win32"
@@ -9295,8 +9553,8 @@ async function runServeCommand(options) {
     openBrowser: options.openBrowser,
     watch: options.watch
   });
-  const relativeArticle = path12.relative(process.cwd(), markdownPath);
-  const relativeAssets = path12.relative(process.cwd(), outputPaths.assetOutputDir);
+  const relativeArticle = path13.relative(process.cwd(), markdownPath);
+  const relativeAssets = path13.relative(process.cwd(), outputPaths.assetOutputDir);
   console.log(`Previewing ${relativeArticle || markdownPath}`);
   console.log(`Serving assets from ${relativeAssets || outputPaths.assetOutputDir}`);
   console.log(`Open ${server.url}`);
@@ -9782,7 +10040,7 @@ function formatPipelineStageCost(stage) {
   }
   return stage.costSource === "estimated" ? `~${formatted}` : formatted;
 }
-async function renderPlainPipeline(input, dryRun, enrichLinks2, runMode, links, unlinks, maxLinks) {
+async function renderPlainPipeline(input, dryRun, enrichLinks2, runMode, links, unlinks, maxLinks, maxImages) {
   let previousStages = /* @__PURE__ */ new Map();
   let previousItemStatuses = /* @__PURE__ */ new Map();
   const notificationsEnabled = input.config.settings.notifications.enabled;
@@ -9799,6 +10057,7 @@ async function renderPlainPipeline(input, dryRun, enrichLinks2, runMode, links,
       customLinks: links,
       unlinks,
       maxLinks,
+      maxImages,
       onUpdate(stages) {
         for (const stage of stages) {
           const previous = previousStages.get(stage.id);
@@ -10160,6 +10419,7 @@ function WriteApp({
   links,
   unlinks,
   maxLinks,
+  maxImages,
   onError
 }) {
   const { exit } = useApp3();
@@ -10186,6 +10446,7 @@ function WriteApp({
           customLinks: links,
           unlinks,
           maxLinks,
+          maxImages,
           onUpdate(nextStages) {
             if (mounted) {
               setStages(nextStages);
@@ -10218,7 +10479,7 @@ function WriteApp({
     return () => {
       mounted = false;
     };
-  }, [dryRun, enrichLinks2, input, links, unlinks, maxLinks, onError, runMode]);
+  }, [dryRun, enrichLinks2, input, links, unlinks, maxLinks, maxImages, onError, runMode]);
   useEffect2(() => {
     if (!result && !errorMessage) {
       return;
@@ -10234,7 +10495,7 @@ function WriteApp({
 }
 async function runWriteCommand(options) {
   const input = await resolveInputWithInteractiveIdeaFallback(options);
-  await runWritePipeline(input, options.dryRun, options.enrichLinks, "fresh", options.noInteractive, options.links, options.unlinks, options.maxLinks);
+  await runWritePipeline(input, options.dryRun, options.enrichLinks, "fresh", options.noInteractive, options.links, options.unlinks, options.maxLinks, options.maxImages);
 }
 async function runWriteResumeCommand(options = {}) {
   const session = await loadWriteSession();
@@ -10256,9 +10517,9 @@ async function runWriteResumeCommand(options = {}) {
       secrets: resolved.config.secrets
     }
   };
-  await runWritePipeline(input, session.dryRun, options.enrichLinks ?? false, "resume", options.noInteractive ?? false, options.links, options.unlinks, options.maxLinks);
+  await runWritePipeline(input, session.dryRun, options.enrichLinks ?? false, "resume", options.noInteractive ?? false, options.links, options.unlinks, options.maxLinks, options.maxImages);
 }
-async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteractive, links, unlinks, maxLinks) {
+async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteractive, links, unlinks, maxLinks, maxImages) {
   let interruptHandled = false;
   const handleSignal = (signal) => {
     if (interruptHandled) {
@@ -10292,7 +10553,7 @@ async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteract
   process.on("SIGTERM", onSigterm);
   try {
     if (noInteractive || !process.stdout.isTTY) {
-      await renderPlainPipeline(input, dryRun, enrichLinks2, runMode, links, unlinks, maxLinks);
+      await renderPlainPipeline(input, dryRun, enrichLinks2, runMode, links, unlinks, maxLinks, maxImages);
       return;
     }
     let commandError = null;
@@ -10307,6 +10568,7 @@ async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteract
           links,
           unlinks,
           maxLinks,
+          maxImages,
           onError: (error) => {
             commandError = error;
           }
@@ -10474,7 +10736,7 @@ function collectOptionValue(value2, previous = []) {
 }
 async function runCli(argv) {
   const program = new Command();
-  program.name("ideon").description("Turn ideas into rich Markdown articles with generated images.").version(version);
+  program.name("ideon").description("Turn one idea into articles, threads, and social posts \u2014 quality content without the token tax.").version(version);
   program.command("settings").description("Show the current Ideon settings and storage state.").action(async () => {
     await openSettings();
   });
@@ -10519,6 +10781,14 @@ async function runCli(argv) {
       maxLinks: options.maxLinks
     });
   });
+  program.command("export").description("Export a generated article as a standalone markdown file with inline links and copied images.").argument("<generationId>", "Generation id or article slug to export").argument("<path>", "Destination directory for the exported file and images").option("--index <n>", "Which primary article variant to export when multiple exist (default: 1)", (v) => Number.parseInt(v, 10)).option("--overwrite", "Overwrite the destination file if it already exists", false).action(async (generationId, destinationPath, options) => {
+    await runOutputCommand({
+      generationId,
+      destinationPath,
+      index: options.index,
+      overwrite: options.overwrite
+    });
+  });
   program.command("preview").description("Preview a generated article in a local browser with linked assets.").argument("[markdownPath]", "Path to the markdown file to preview").option("-p, --port <port>", "Port for the local preview server (default: 4173)").option("--no-open", "Do not auto-open browser after server startup").option("--watch", "Rebuild the preview UI on source changes and auto-reload the browser", false).action(async (markdownPath, options) => {
     await runServeCommand({
       markdownPath,
@@ -10527,7 +10797,7 @@ async function runCli(argv) {
       watch: options.watch
     });
   });
-  const writeCommand = program.command("write").description("Generate one primary content output plus optional secondary outputs from a prompt or job file.").argument("[idea]", "Natural-language idea for the generation run").option("-i, --idea <idea>", "Natural-language idea for the generation run").option("--audience <description>", "Optional natural-language audience description for shared-brief targeting").option("-j, --job <path>", "Path to a JSON job definition").option("--primary <type=count>", "Required primary output target (for example: article=1 or x-post=1)").option("--secondary <type=count>", "Secondary output target, repeatable (for example: x-thread=3, linkedin-post=2)", collectOptionValue).option("--style <style>", "Writing style (academic, analytical, authoritative, conversational, empathetic, friendly, journalistic, minimalist, persuasive, playful, professional, storytelling, technical)").option("--intent <intent>", "Content intent (announcement, case-study, cornerstone, counterargument, critique-review, deep-dive-analysis, how-to-guide, interview-q-and-a, listicle, opinion-piece, personal-essay, roundup-curation, tutorial)").option("--length <size>", "Target length: small, medium, large, or a positive integer word count").option("--no-interactive", "Fail instead of prompting for missing input in TTY mode").option("--dry-run", "Run the pipeline shell without external API calls", false).option("--enrich-links", "Run link enrichment after markdown generation", false).option("--link <pair>", 'Custom link "expression->url", repeatable', collectOptionValue).option("--unlink <expression>", "Remove a custom link by expression, repeatable", collectOptionValue).option("--max-links <n>", "Max number of generated links", (v) => Number.parseInt(v, 10)).action(async (ideaArg, options) => {
+  const writeCommand = program.command("write").description("Generate one primary content output plus optional secondary outputs from a prompt or job file.").argument("[idea]", "Natural-language idea for the generation run").option("-i, --idea <idea>", "Natural-language idea for the generation run").option("--audience <description>", "Optional natural-language audience description for shared-brief targeting").option("-j, --job <path>", "Path to a JSON job definition").option("--primary <type=count>", "Required primary output target (for example: article=1 or x-post=1)").option("--secondary <type=count>", "Secondary output target, repeatable (for example: x-thread=3, linkedin-post=2)", collectOptionValue).option("--style <style>", "Writing style (academic, analytical, authoritative, conversational, empathetic, friendly, journalistic, minimalist, persuasive, playful, professional, storytelling, technical)").option("--intent <intent>", "Content intent (announcement, case-study, cornerstone, counterargument, critique-review, deep-dive-analysis, how-to-guide, interview-q-and-a, listicle, opinion-piece, personal-essay, roundup-curation, tutorial)").option("--length <size>", "Target length: small, medium, large, or a positive integer word count").option("--no-interactive", "Fail instead of prompting for missing input in TTY mode").option("--dry-run", "Run the pipeline shell without external API calls", false).option("--enrich-links", "Run link enrichment after markdown generation", false).option("--link <pair>", 'Custom link "expression->url", repeatable', collectOptionValue).option("--unlink <expression>", "Remove a custom link by expression, repeatable", collectOptionValue).option("--max-links <n>", "Max number of generated links", (v) => Number.parseInt(v, 10)).option("--max-images <n>", "Max total images including cover (1=cover only, 2=cover+1 inline, 3=cover+2 inline)", (v) => Number.parseInt(v, 10)).action(async (ideaArg, options) => {
     await runWriteCommand({
       idea: options.idea ?? ideaArg,
       audience: options.audience,
@@ -10542,16 +10812,18 @@ async function runCli(argv) {
       enrichLinks: options.enrichLinks,
       links: options.link,
       unlinks: options.unlink,
-      maxLinks: options.maxLinks
+      maxLinks: options.maxLinks,
+      maxImages: options.maxImages
     });
   });
-  writeCommand.command("resume").description("Resume the last failed or interrupted write session from .ideon/write.").option("--no-interactive", "Force plain non-interactive output even in TTY mode", false).option("--enrich-links", "Run link enrichment after markdown generation", false).option("--link <pair>", 'Custom link "expression->url", repeatable', collectOptionValue).option("--unlink <expression>", "Remove a custom link by expression, repeatable", collectOptionValue).option("--max-links <n>", "Max number of generated links", (v) => Number.parseInt(v, 10)).action(async (options) => {
+  writeCommand.command("resume").description("Resume the last failed or interrupted write session from .ideon/write.").option("--no-interactive", "Force plain non-interactive output even in TTY mode", false).option("--enrich-links", "Run link enrichment after markdown generation", false).option("--link <pair>", 'Custom link "expression->url", repeatable', collectOptionValue).option("--unlink <expression>", "Remove a custom link by expression, repeatable", collectOptionValue).option("--max-links <n>", "Max number of generated links", (v) => Number.parseInt(v, 10)).option("--max-images <n>", "Max total images including cover (1=cover only, 2=cover+1 inline, 3=cover+2 inline)", (v) => Number.parseInt(v, 10)).action(async (options) => {
     await runWriteResumeCommand({
       noInteractive: options.noInteractive,
       enrichLinks: options.enrichLinks,
       links: options.link,
       unlinks: options.unlink,
-      maxLinks: options.maxLinks
+      maxLinks: options.maxLinks,
+      maxImages: options.maxImages
     });
   });
   await program.parseAsync(argv);