@telepat/ideon 0.1.24 → 0.1.27

package/dist/ideon.js

@@ -12,7 +12,8 @@ import { access, mkdir, writeFile } from "fs/promises";
 import os from "os";
 import path from "path";
 function resolveOutputPaths() {
-  const base = path.join(os.homedir(), ".ideon", "output");
+  const ideonHome = process.env.IDEON_HOME || os.homedir();
+  const base = path.join(ideonHome, ".ideon", "output");
   return {
     markdownOutputDir: base,
     assetOutputDir: path.join(base, "assets")
@@ -484,9 +485,9 @@ function resolveDefaultMaxLinks(targetLengthWords) {
 }
 function resolveDefaultInlineImageCount(targetLengthWords) {
   const alias = resolveTargetLengthAlias(targetLengthWords);
-  if (alias === "small") return { min: 1, max: 2 };
-  if (alias === "medium") return { min: 2, max: 3 };
-  return { min: 3, max: 4 };
+  if (alias === "small") return { min: 0, max: 1 };
+  if (alias === "medium") return { min: 1, max: 2 };
+  return { min: 2, max: 4 };
 }
 var contentTargetRoleValues = ["primary", "secondary"];
 var contentTargetSchema = z2.object({
@@ -1423,7 +1424,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 // package.json
 var package_default = {
   name: "@telepat/ideon",
-  version: "0.1.24",
+  version: "0.1.27",
   description: "CLI for generating rich articles and images from ideas.",
   type: "module",
   repository: {
@@ -1623,9 +1624,9 @@ function assertNoLegacyXMode(contentTargets, sourceLabel) {
 }
 
 // src/pipeline/runner.ts
-import { mkdir as mkdir6, stat as stat2 } from "fs/promises";
+import { mkdir as mkdir6, readFile as readFile6, stat as stat2 } from "fs/promises";
 import { randomUUID } from "crypto";
-import path8 from "path";
+import path9 from "path";
 
 // src/generation/enrichLinks.ts
 import { readFile as readFile4 } from "fs/promises";
@@ -2446,7 +2447,7 @@ function buildLongFormPlanMessages(idea, options) {
         "- Each section description should name the mechanism, evidence type, or practical action that makes the section useful.",
         "- Sections are primary-only structure and must not be treated as requirements for non-primary channels.",
         `- Include a cover image description and ${imageCounts.min} to ${imageCounts.max} inline image descriptions.`,
-        "- Each inline image must specify which section it follows (anchorAfterSection, 1-based index). Choose sections where visual reinforcement adds the most value.",
+        "- Each inline image must specify which section it follows (anchorAfterSection, starting at 1). Choose sections where visual reinforcement adds the most value.",
         "- Image descriptions should capture the general concept and mood \u2014 the exact text-to-image prompt will be refined later using the actual section content.",
         "- Image descriptions must be concrete and contextual, not generic stock-photo phrasing.",
         "",
@@ -2468,7 +2469,7 @@ function buildLongFormPlanMessages(idea, options) {
         "- outroBrief: string",
         `- sections: array of ${sectionCounts.label} objects, each with title and description strings`,
         "- coverImageDescription: string",
-        `- inlineImages: array of ${imageCounts.min} to ${imageCounts.max} objects, each with a description string and an anchorAfterSection number (1-based section index)`,
+        `- inlineImages: array of ${imageCounts.min} to ${imageCounts.max} objects, each with a description string and an anchorAfterSection number (starting at 1).`,
         "",
         "Do not omit any required fields. Return strict JSON only."
       ].join("\n")
@@ -2543,7 +2544,7 @@ var primaryPlanSchema = z5.object({
   introBrief: z5.string().min(1).optional(),
   outroBrief: z5.string().min(1).optional(),
   sections: z5.array(articleSectionPlanSchema).min(2).max(10).optional(),
-  inlineImages: z5.array(inlineImagePlanSchema).min(2).max(3).optional(),
+  inlineImages: z5.array(inlineImagePlanSchema).min(0).max(4).optional(),
   angle: z5.string().min(1).optional()
 });
 var longFormPlanSchema = z5.object({
@@ -2557,7 +2558,7 @@ var longFormPlanSchema = z5.object({
   outroBrief: z5.string().min(1),
   sections: z5.array(articleSectionPlanSchema).min(2).max(10),
   coverImageDescription: z5.string().min(1),
-  inlineImages: z5.array(inlineImagePlanSchema).min(2).max(3)
+  inlineImages: z5.array(inlineImagePlanSchema).min(0).max(4)
 });
 var shortFormPlanSchema = z5.object({
   contentType: z5.string().min(1),
@@ -4003,10 +4004,69 @@ ${body.join("\n").trim()}
 `;
 }
 
+// src/output/meta.ts
+import path7 from "path";
+function buildMetaJson(input) {
+  const plan = input.plan;
+  const contentPlan = input.contentPlan;
+  const generationDir = input.generationDir;
+  const title = plan?.title ?? contentPlan?.title ?? input.idea;
+  const slug = plan?.slug ?? "";
+  const description = plan?.description ?? contentPlan?.description ?? "";
+  const subtitle = (plan && "subtitle" in plan ? plan.subtitle : null) ?? null;
+  const keywords = (plan && "keywords" in plan ? plan.keywords : null) ?? [];
+  const contentType = plan?.contentType ?? contentPlan?.primaryContentType ?? "article";
+  const angle = plan?.angle ?? null;
+  const coverImage = input.renderedImages.find((image) => image.kind === "cover") ?? null;
+  const cover = coverImage ? {
+    path: coverImage.outputPath,
+    relativePath: coverImage.relativePath,
+    description: coverImage.description
+  } : null;
+  const sections = plan?.sections?.map((section) => ({
+    title: section.title,
+    description: section.description
+  })) ?? [];
+  const images = input.renderedImages.map((image) => ({
+    id: image.id,
+    kind: image.kind,
+    path: image.outputPath,
+    relativePath: image.relativePath,
+    description: image.description,
+    anchorAfterSection: image.anchorAfterSection
+  }));
+  const outputs = input.outputs.map((output) => ({
+    fileId: output.fileId,
+    contentType: output.contentType,
+    path: output.markdownPath,
+    relativePath: path7.relative(generationDir, output.markdownPath)
+  }));
+  return {
+    version: 1,
+    title,
+    slug,
+    idea: input.idea,
+    description,
+    subtitle,
+    keywords,
+    contentType,
+    style: input.style,
+    intent: input.intent,
+    targetLength: input.targetLength,
+    angle,
+    cover,
+    sections,
+    images,
+    outputs,
+    generatedAt: input.generatedAt,
+    generationDir
+  };
+}
+
 // src/pipeline/sessionStore.ts
 import { createHash as createHash2 } from "crypto";
 import { mkdir as mkdir5, readFile as readFile5, rm as rm2, writeFile as writeFile5 } from "fs/promises";
-import path7 from "path";
+import path8 from "path";
 import envPaths3 from "env-paths";
 import { z as z6 } from "zod";
 var STAGE_IDS = ["shared-plan", "planning", "sections", "image-prompts", "images", "output", "links"];
@@ -4049,7 +4109,8 @@ var pipelineArtifactSummarySchema = z6.object({
   assetDir: z6.string().min(1),
   analyticsPath: z6.string().min(1).default("unknown.analytics.json"),
   interactionsPath: z6.string().min(1).default("unknown.interactions.json"),
-  planPath: z6.string().min(1).nullable().default(null)
+  planPath: z6.string().min(1).nullable().default(null),
+  metaJsonPath: z6.string().min(1).default("meta.json")
 });
 var resolvedPathsSchema = z6.object({
   markdownOutputDir: z6.string().min(1),
@@ -4085,18 +4146,18 @@ var writeSessionStateSchema = z6.object({
   artifact: pipelineArtifactSummarySchema.nullable()
 });
 var ideonPaths3 = envPaths3("ideon", { suffix: "" });
-var sessionsDir = path7.join(ideonPaths3.config, "sessions");
+var sessionsDir = path8.join(ideonPaths3.config, "sessions");
 function hashProjectPath(workingDir) {
-  return createHash2("sha256").update(path7.resolve(workingDir)).digest("hex").slice(0, 16);
+  return createHash2("sha256").update(path8.resolve(workingDir)).digest("hex").slice(0, 16);
 }
 function resolveWriteRoot(workingDir) {
-  return path7.join(sessionsDir, hashProjectPath(workingDir));
+  return path8.join(sessionsDir, hashProjectPath(workingDir));
 }
 function resolveStateFilePath(workingDir) {
-  return path7.join(resolveWriteRoot(workingDir), "state.json");
+  return path8.join(resolveWriteRoot(workingDir), "state.json");
 }
 function resolveLegacyStatePath(workingDir) {
-  return path7.join(workingDir, ".ideon", "write", "state.json");
+  return path8.join(workingDir, ".ideon", "write", "state.json");
 }
 async function startFreshWriteSession(seed, workingDir = process.cwd()) {
   const writeRoot = resolveWriteRoot(workingDir);
@@ -4157,7 +4218,7 @@ async function saveWriteSession(state, workingDir = process.cwd()) {
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   });
   const statePath = resolveStateFilePath(workingDir);
-  await mkdir5(path7.dirname(statePath), { recursive: true });
+  await mkdir5(path8.dirname(statePath), { recursive: true });
   await writeFile5(statePath, `${JSON.stringify(next, null, 2)}
 `, "utf8");
   return next;
@@ -4716,12 +4777,12 @@ async function runPipelineShell(input, options = {}) {
       options.onUpdate?.(cloneStages(stages));
     }
     const baseSlug = plan?.slug ?? resolveGenerationSlug(input.idea, contentPlan?.title);
-    const generationDir = path8.join(
+    const generationDir = path9.join(
       writeSession.outputPaths.markdownOutputDir,
       buildGenerationDirectoryName(baseSlug)
     );
     await mkdir6(generationDir, { recursive: true });
-    const jobDefinitionPath = path8.join(generationDir, "job.json");
+    const jobDefinitionPath = path9.join(generationDir, "job.json");
     await writeJsonFile(
       jobDefinitionPath,
       buildRunJobDefinition({
@@ -4733,12 +4794,12 @@ async function runPipelineShell(input, options = {}) {
         sourceJob: input.job
       })
     );
-    const planPath = plan ? path8.join(generationDir, "plan.md") : null;
+    const planPath = plan ? path9.join(generationDir, "plan.md") : null;
     if (plan && planPath) {
       await writeUtf8File(planPath, renderPlanMarkdown(plan));
     }
     const primaryFilePrefix = toFilePrefix(primaryTarget.contentType);
-    const primaryMarkdownPath = path8.join(generationDir, `${primaryFilePrefix}-1.md`);
+    const primaryMarkdownPath = path9.join(generationDir, `${primaryFilePrefix}-1.md`);
     const sharedAssetDir = generationDir;
     if (isLongForm) {
       const longPlan = plan;
@@ -4962,7 +5023,7 @@ async function runPipelineShell(input, options = {}) {
         })
       };
       options.onUpdate?.(cloneStages(stages));
-      const markdownPath = path8.join(generationDir, `${output.filePrefix}-${output.index}.md`);
+      const markdownPath = path9.join(generationDir, `${output.filePrefix}-${output.index}.md`);
       try {
         const content = await writeSingleShotContent({
           idea: input.idea,
@@ -5025,7 +5086,7 @@ async function runPipelineShell(input, options = {}) {
               ...item,
               status: "succeeded",
               detail: "Saved markdown output.",
-              summary: path8.basename(markdownPath),
+              summary: path9.basename(markdownPath),
               analytics: {
                 durationMs: itemDurationMs,
                 costUsd: knownItemCost.usd,
@@ -5077,15 +5138,47 @@ async function runPipelineShell(input, options = {}) {
     markStageStarted(stageTracking, "links");
     options.onUpdate?.(cloneStages(stages));
     if (!shouldEnrichLinks) {
-      markStageCompleted(stageTracking, "links");
-      stages[6] = {
-        ...stages[6],
-        status: "succeeded",
-        detail: "Skipped link enrichment (enable with --enrich-links).",
-        summary: "Link enrichment disabled for this run",
-        stageAnalytics: snapshotStageAnalytics(stageTracking, "links")
-      };
-      options.onUpdate?.(cloneStages(stages));
+      const customLinkActions = pipelineCustomLinkRaws.length > 0 || pipelineUnlinks.length > 0;
+      if (customLinkActions && eligibleOutputsForLinks.length > 0) {
+        for (const output of eligibleOutputsForLinks) {
+          const existingLinks = await readExistingLinks(resolveLinksPath(output.markdownPath));
+          const mergedCustomLinks = resolvePipelineCustomLinks(
+            existingLinks?.customLinks ?? [],
+            pipelineCustomLinkRaws,
+            pipelineUnlinks
+          );
+          const generatedLinks = existingLinks?.links ?? [];
+          await writeLinksFile(output.markdownPath, {
+            version: 2,
+            customLinks: mergedCustomLinks,
+            links: generatedLinks
+          });
+        }
+        markStageCompleted(stageTracking, "links");
+        stages[6] = {
+          ...stages[6],
+          status: "succeeded",
+          detail: "Updated custom links without generating new links.",
+          summary: `${eligibleOutputsForLinks.length} files updated`,
+          items: (stages[6].items ?? []).map((stageItem) => ({
+            ...stageItem,
+            status: "succeeded",
+            detail: "Saved custom links sidecar."
+          })),
+          stageAnalytics: snapshotStageAnalytics(stageTracking, "links")
+        };
+        options.onUpdate?.(cloneStages(stages));
+      } else {
+        markStageCompleted(stageTracking, "links");
+        stages[6] = {
+          ...stages[6],
+          status: "succeeded",
+          detail: "Skipped link enrichment (enable with --enrich-links).",
+          summary: "Link enrichment disabled for this run",
+          stageAnalytics: snapshotStageAnalytics(stageTracking, "links")
+        };
+        options.onUpdate?.(cloneStages(stages));
+      }
     } else if (eligibleOutputsForLinks.length === 0) {
       markStageCompleted(stageTracking, "links");
       stages[6] = {
@@ -5240,10 +5333,24 @@ async function runPipelineShell(input, options = {}) {
       llmCalls: llmInteractions,
       t2iCalls: t2iInteractions
     };
-    const analyticsPath = path8.join(generationDir, "generation.analytics.json");
-    const interactionsPath = path8.join(generationDir, "model.interactions.json");
+    const analyticsPath = path9.join(generationDir, "generation.analytics.json");
+    const interactionsPath = path9.join(generationDir, "model.interactions.json");
     await writeJsonFile(analyticsPath, analytics);
     await writeJsonFile(interactionsPath, interactions);
+    const metaJson = buildMetaJson({
+      idea: input.idea,
+      generationDir,
+      contentPlan,
+      plan,
+      renderedImages: imageArtifacts?.renderedImages ?? [],
+      outputs: generatedOutputs,
+      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      style: input.config.settings.style,
+      intent: input.config.settings.intent,
+      targetLength: input.config.settings.targetLength ? resolveTargetLengthAlias(input.config.settings.targetLength) : null
+    });
+    const metaJsonPath = path9.join(generationDir, "meta.json");
+    await writeJsonFile(metaJsonPath, metaJson);
     const primaryMarkdownPathForArtifact = markdownPaths[0] ?? primaryMarkdownPath;
     const artifact = {
       title: plan?.title ?? contentPlan.title ?? deriveTitleFromIdea2(input.idea),
@@ -5257,7 +5364,8 @@ async function runPipelineShell(input, options = {}) {
       assetDir: sharedAssetDir,
       analyticsPath,
       interactionsPath,
-      planPath
+      planPath,
+      metaJsonPath
     };
     writeSession = await patchWriteSession(
       {
@@ -5728,10 +5836,62 @@ function parsePipelineCustomLinks(rawLinks, unlinks) {
   }
   return Array.from(result.values());
 }
+function resolvePipelineCustomLinks(existing, rawLinks, unlinks) {
+  const result = new Map(
+    existing.map((entry) => [entry.expression.trim().toLowerCase(), entry])
+  );
+  for (const raw of rawLinks) {
+    const separatorIndex = raw.indexOf("->");
+    if (separatorIndex < 0) {
+      continue;
+    }
+    const expression = raw.slice(0, separatorIndex).trim();
+    const url = raw.slice(separatorIndex + 2).trim();
+    if (expression && url) {
+      result.set(expression.toLowerCase(), { expression, url, title: null });
+    }
+  }
+  for (const expr of unlinks) {
+    result.delete(expr.trim().toLowerCase());
+  }
+  return Array.from(result.values());
+}
+async function readExistingLinks(linksPath) {
+  try {
+    const raw = await readFile6(linksPath, "utf8");
+    const parsed = JSON.parse(raw);
+    const links = Array.isArray(parsed.links) ? parsed.links.filter((entry) => isValidLinkEntry(entry)).map((entry) => ({
+      expression: entry.expression.trim(),
+      url: entry.url.trim(),
+      title: typeof entry.title === "string" ? entry.title : null
+    })) : null;
+    if (!links) {
+      throw new Error(`Invalid links sidecar format at ${linksPath}. Expected { version, links[] }.`);
+    }
+    const customLinks = Array.isArray(parsed.customLinks) ? parsed.customLinks.filter((entry) => isValidLinkEntry(entry)).map((entry) => ({
+      expression: entry.expression.trim(),
+      url: entry.url.trim(),
+      title: typeof entry.title === "string" ? entry.title : null
+    })) : [];
+    return {
+      version: typeof parsed.version === "number" ? parsed.version : 2,
+      customLinks,
+      links
+    };
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return null;
+    }
+    throw error;
+  }
+}
+function isValidLinkEntry(entry) {
+  return typeof entry === "object" && entry !== null && typeof entry.expression === "string" && typeof entry.url === "string";
+}
 
 // src/cli/commands/links.ts
-import { readFile as readFile6, stat as stat3 } from "fs/promises";
-import path9 from "path";
+import { readFile as readFile7, stat as stat3 } from "fs/promises";
+import path10 from "path";
 async function runLinksCommand(options, dependencies = {}) {
   const slug = normalizeSlug2(options.slug);
   const mode = normalizeMode(options.mode);
@@ -5742,7 +5902,7 @@ async function runLinksCommand(options, dependencies = {}) {
   });
   const markdownPath = await resolveMarkdownPathForSlug2(slug, cwd2);
   const frontmatter = await readFrontmatter(markdownPath);
-  const fileId = path9.parse(markdownPath).name;
+  const fileId = path10.parse(markdownPath).name;
   const articleTitle = frontmatter.title ?? toTitleFromSlug(slug);
   const articleDescription = frontmatter.description ?? "";
   const openRouterApiKey = resolved.config.secrets.openRouterApiKey;
@@ -5753,7 +5913,7 @@ async function runLinksCommand(options, dependencies = {}) {
   }
   const openRouter = new OpenRouterClient(openRouterApiKey);
   const linksPath = resolveLinksPath(markdownPath);
-  const existing = await readExistingLinks(linksPath);
+  const existing = await readExistingLinks2(linksPath);
   const updatedCustomLinks = resolveCustomLinks(existing?.customLinks ?? [], options.links ?? [], options.unlinks ?? []);
   const effectiveMaxLinks = options.maxLinks;
   const linksResult = await enrichLinks({
@@ -5812,14 +5972,14 @@ function normalizeSlug2(rawSlug) {
 }
 async function resolveMarkdownPathForSlug2(slug, cwd2) {
   const outputPaths = resolveOutputPaths();
-  const directPath = path9.join(outputPaths.markdownOutputDir, `${slug}.md`);
+  const directPath = path10.join(outputPaths.markdownOutputDir, `${slug}.md`);
   if (await isReadableFile(directPath)) {
     return directPath;
   }
   const markdownFiles = await listMarkdownFilesRecursively(outputPaths.markdownOutputDir);
   const matches = [];
   for (const candidate of markdownFiles) {
-    if (path9.basename(candidate) === `${slug}.md`) {
+    if (path10.basename(candidate) === `${slug}.md`) {
       matches.push(candidate);
       continue;
     }
@@ -5848,7 +6008,7 @@ async function newestPath(paths) {
   return latestPath;
 }
 async function readFrontmatter(markdownPath) {
-  const markdown = await readFile6(markdownPath, "utf8");
+  const markdown = await readFile7(markdownPath, "utf8");
   return parseFrontmatter(markdown);
 }
 function parseFrontmatter(markdown) {
@@ -5892,11 +6052,11 @@ async function isReadableFile(filePath) {
     return false;
   }
 }
-async function readExistingLinks(linksPath) {
+async function readExistingLinks2(linksPath) {
   try {
-    const raw = await readFile6(linksPath, "utf8");
+    const raw = await readFile7(linksPath, "utf8");
     const parsed = JSON.parse(raw);
-    const links = Array.isArray(parsed.links) ? parsed.links.filter((entry) => isValidLinkEntry(entry)).map((entry) => ({
+    const links = Array.isArray(parsed.links) ? parsed.links.filter((entry) => isValidLinkEntry2(entry)).map((entry) => ({
       expression: entry.expression.trim(),
       url: entry.url.trim(),
       title: typeof entry.title === "string" ? entry.title : null
@@ -5904,7 +6064,7 @@ async function readExistingLinks(linksPath) {
     if (!links) {
       throw new ReportedError(`Invalid links sidecar format at ${linksPath}. Expected { version, links[] }.`);
     }
-    const customLinks = Array.isArray(parsed.customLinks) ? parsed.customLinks.filter((entry) => isValidLinkEntry(entry)).map((entry) => ({
+    const customLinks = Array.isArray(parsed.customLinks) ? parsed.customLinks.filter((entry) => isValidLinkEntry2(entry)).map((entry) => ({
       expression: entry.expression.trim(),
       url: entry.url.trim(),
       title: typeof entry.title === "string" ? entry.title : null
@@ -5938,7 +6098,7 @@ function mergeLinks(existingLinks, generatedLinks) {
   }
   return merged;
 }
-function isValidLinkEntry(value2) {
+function isValidLinkEntry2(value2) {
   if (typeof value2 !== "object" || value2 === null) {
     return false;
   }
@@ -5953,7 +6113,7 @@ function readErrorCode2(error) {
   return typeof code === "string" ? code : null;
 }
 function formatRelativePath2(cwd2, targetPath) {
-  const relativePath = path9.relative(cwd2, targetPath);
+  const relativePath = path10.relative(cwd2, targetPath);
   return relativePath.length > 0 ? relativePath : targetPath;
 }
 function logProgress(event, log) {
@@ -5992,8 +6152,8 @@ function resolveCustomLinks(existing, addRaw, removeExpressions) {
 }
 
 // src/cli/commands/export.ts
-import { copyFile as copyFile2, mkdir as mkdir7, readFile as readFile8, stat as stat5, writeFile as writeFile6 } from "fs/promises";
-import path11 from "path";
+import { copyFile as copyFile2, mkdir as mkdir7, readFile as readFile9, stat as stat5, writeFile as writeFile6 } from "fs/promises";
+import path12 from "path";
 
 // src/output/enrichMarkdownWithLinks.ts
 function enrichMarkdownWithLinks(markdown, links) {
@@ -6049,8 +6209,8 @@ function escapeRegExp(value2) {
 }
 
 // src/server/previewHelpers.ts
-import { readdir, stat as stat4, readFile as readFile7 } from "fs/promises";
-import path10 from "path";
+import { readdir, stat as stat4, readFile as readFile8 } from "fs/promises";
+import path11 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 = {
@@ -6108,8 +6268,8 @@ function extractHeadingTitle(markdown) {
 }
 async function resolveMarkdownPath(markdownPathArg, markdownOutputDir, cwd2) {
   if (markdownPathArg) {
-    const resolved = path10.isAbsolute(markdownPathArg) ? markdownPathArg : path10.resolve(cwd2, markdownPathArg);
-    if (path10.extname(resolved).toLowerCase() !== ".md") {
+    const resolved = path11.isAbsolute(markdownPathArg) ? markdownPathArg : path11.resolve(cwd2, markdownPathArg);
+    if (path11.extname(resolved).toLowerCase() !== ".md") {
       throw new Error(`Expected a markdown file (.md), received: ${resolved}`);
     }
     await assertFileExists(resolved, "Could not find markdown file");
@@ -6151,9 +6311,9 @@ function extractCoverImageUrl(markdown) {
   return match?.[1] ?? null;
 }
 async function extractArticleMetadata(markdownPath) {
-  const markdown = await readFile7(markdownPath, "utf8");
+  const markdown = await readFile8(markdownPath, "utf8");
   const fileStat = await stat4(markdownPath);
-  const slug = extractFrontmatterSlug(markdown) ?? path10.basename(markdownPath, ".md");
+  const slug = extractFrontmatterSlug(markdown) ?? path11.basename(markdownPath, ".md");
   const title = extractHeadingTitle(stripFrontmatter2(markdown)) ?? slug;
   const body = stripFrontmatter2(markdown);
   const previewSnippet = body.replace(/[#\[\]()!\-*_`]/g, "").trim().substring(0, 150);
@@ -6168,7 +6328,7 @@ async function extractArticleMetadata(markdownPath) {
 }
 async function listAllGenerations(markdownOutputDir) {
   const markdownFiles = await findMarkdownFiles(markdownOutputDir);
-  const grouped = /* @__PURE__ */ new Map();
+  const outputMap = /* @__PURE__ */ new Map();
   for (const filePath of markdownFiles) {
     try {
       const metadata = await extractArticleMetadata(filePath);
@@ -6186,15 +6346,23 @@ async function listAllGenerations(markdownOutputDir) {
         contentTypeLabel: toContentTypeLabel(identity.contentType),
         index: identity.index
       };
-      const existing = grouped.get(identity.generationId);
-      if (existing) {
-        existing.push(output);
-      } else {
-        grouped.set(identity.generationId, [output]);
+      const outputKey = `${output.generationId}:${output.contentType}:${output.index}`;
+      const existing = outputMap.get(outputKey);
+      if (!existing || output.mtime > existing.mtime) {
+        outputMap.set(outputKey, output);
       }
     } catch {
     }
   }
+  const grouped = /* @__PURE__ */ new Map();
+  for (const output of outputMap.values()) {
+    const existing = grouped.get(output.generationId);
+    if (existing) {
+      existing.push(output);
+    } else {
+      grouped.set(output.generationId, [output]);
+    }
+  }
   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);
@@ -6218,16 +6386,16 @@ async function listAllGenerations(markdownOutputDir) {
   return generations;
 }
 function deriveGenerationId(markdownPath, markdownOutputDir) {
-  const relative = path10.relative(markdownOutputDir, markdownPath);
-  const normalized = relative.split(path10.sep).join("/");
+  const relative = path11.relative(markdownOutputDir, markdownPath);
+  const normalized = relative.split(path11.sep).join("/");
   if (!normalized || normalized.startsWith("../")) {
-    return path10.basename(markdownPath, ".md");
+    return path11.basename(markdownPath, ".md");
   }
   const segments = normalized.split("/").filter(Boolean);
   if (segments.length <= 1) {
-    return path10.basename(markdownPath, ".md");
+    return path11.basename(markdownPath, ".md");
   }
-  return segments[0] ?? path10.basename(markdownPath, ".md");
+  return segments[0] ?? path11.basename(markdownPath, ".md");
 }
 async function findMarkdownFiles(markdownOutputDir) {
   const files = [];
@@ -6244,7 +6412,7 @@ async function findMarkdownFiles(markdownOutputDir) {
       continue;
     }
     for (const entry of entries) {
-      const fullPath = path10.join(current, entry.name);
+      const fullPath = path11.join(current, entry.name);
       if (entry.isDirectory()) {
         stack.push(fullPath);
         continue;
@@ -6258,7 +6426,7 @@ async function findMarkdownFiles(markdownOutputDir) {
 }
 function deriveOutputIdentity(markdownPath, markdownOutputDir) {
   const generationId = deriveGenerationId(markdownPath, markdownOutputDir);
-  const fileBase = path10.basename(markdownPath, ".md");
+  const fileBase = path11.basename(markdownPath, ".md");
   const parsed = fileBase.match(/^([a-z0-9-]+)-(\d+)$/i);
   if (!parsed || !parsed[1] || !parsed[2]) {
     return {
@@ -6294,13 +6462,13 @@ function toContentTypeLabel(contentType) {
 }
 async function resolvePrimaryContentType(outputs) {
   const fallback = outputs.find((output) => output.contentType === "article")?.contentType ?? outputs[0]?.contentType ?? "article";
-  const generationDir = path10.dirname(outputs[0]?.sourcePath ?? "");
+  const generationDir = path11.dirname(outputs[0]?.sourcePath ?? "");
   if (!generationDir) {
     return fallback;
   }
-  const jobPath = path10.join(generationDir, "job.json");
+  const jobPath = path11.join(generationDir, "job.json");
   try {
-    const raw = await readFile7(jobPath, "utf8");
+    const raw = await readFile8(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");
@@ -6314,6 +6482,11 @@ async function resolvePrimaryContentType(outputs) {
 }
 
 // src/cli/commands/export.ts
+var INTERNAL_FILE_NAMES = /* @__PURE__ */ new Set([
+  "job.json",
+  "model.interactions.json",
+  "generation.analytics.json"
+]);
 async function runOutputCommand(options, dependencies = {}) {
   const cwd2 = dependencies.cwd ?? process.cwd();
   const log = dependencies.log ?? ((message) => console.log(message));
@@ -6336,11 +6509,11 @@ async function runOutputCommand(options, dependencies = {}) {
     );
   }
   const sourceMarkdownPath = articleOutput.sourcePath;
-  const sourceMarkdown = await readFile8(sourceMarkdownPath, "utf8");
-  const slug = extractFrontmatterSlug2(sourceMarkdown) ?? path11.basename(sourceMarkdownPath, ".md");
+  const sourceMarkdown = await readFile9(sourceMarkdownPath, "utf8");
+  const slug = extractFrontmatterSlug2(sourceMarkdown) ?? path12.basename(sourceMarkdownPath, ".md");
   const exportFilename = `${slug}.md`;
   const destinationDir = await resolveDestinationDir(options.destinationPath, cwd2);
-  const destinationFilePath = path11.join(destinationDir, exportFilename);
+  const destinationFilePath = path12.join(destinationDir, exportFilename);
   if (!options.overwrite && await fileExists2(destinationFilePath)) {
     throw new ReportedError(
       `Export file already exists: ${destinationFilePath}. Pass --overwrite to replace it.`
@@ -6349,32 +6522,24 @@ async function runOutputCommand(options, dependencies = {}) {
   await mkdir7(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 mkdir7(path11.dirname(destImagePath), { recursive: true });
-    await copyFile2(absoluteImageSrc, destImagePath);
-    copiedImages.push(relImagePath);
+  const sourceDir = path12.dirname(sourceMarkdownPath);
+  const allFiles = await listFilesRecursively(sourceDir, () => true);
+  const copiedFiles = [];
+  for (const absoluteSrc of allFiles) {
+    const basename = path12.basename(absoluteSrc);
+    if (INTERNAL_FILE_NAMES.has(basename)) continue;
+    if (path12.resolve(absoluteSrc) === path12.resolve(sourceMarkdownPath)) continue;
+    const relativePath = path12.relative(sourceDir, absoluteSrc);
+    const destPath = path12.join(destinationDir, relativePath);
+    await mkdir7(path12.dirname(destPath), { recursive: true });
+    await copyFile2(absoluteSrc, destPath);
+    copiedFiles.push(relativePath);
   }
   await writeFile6(destinationFilePath, enrichedMarkdown, "utf8");
-  const relDest = path11.relative(cwd2, destinationFilePath);
+  const relDest = path12.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 (copiedFiles.length > 0) {
+    log(`Copied ${copiedFiles.length} file${copiedFiles.length === 1 ? "" : "s"}: ${copiedFiles.join(", ")}`);
   }
   if (links.length > 0) {
     log(`Injected ${links.length} inline link${links.length === 1 ? "" : "s"}.`);
@@ -6396,7 +6561,7 @@ function resolveGeneration(generations, generationId) {
   );
 }
 async function resolveDestinationDir(destinationPath, cwd2) {
-  const resolved = path11.isAbsolute(destinationPath) ? destinationPath : path11.resolve(cwd2, destinationPath);
+  const resolved = path12.isAbsolute(destinationPath) ? destinationPath : path12.resolve(cwd2, destinationPath);
   return resolved;
 }
 async function fileExists2(filePath) {
@@ -6411,7 +6576,7 @@ async function loadLinks(markdownPath) {
   const linksPath = resolveLinksPath(markdownPath);
   let raw;
   try {
-    raw = await readFile8(linksPath, "utf8");
+    raw = await readFile9(linksPath, "utf8");
   } catch {
     return [];
   }
@@ -6466,22 +6631,6 @@ function extractFrontmatterSlug2(markdown) {
   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) {
@@ -7343,15 +7492,15 @@ async function openSettings() {
 }
 
 // src/cli/commands/serve.ts
-import path13 from "path";
+import path14 from "path";
 import { spawn } from "child_process";
 
 // src/server/previewServer.ts
 import { execFile } from "child_process";
 import { promisify } from "util";
-import { readFile as readFile9, stat as stat6 } from "fs/promises";
+import { readFile as readFile10, stat as stat6 } from "fs/promises";
 import { watch as fsWatch } from "fs";
-import path12 from "path";
+import path13 from "path";
 import { fileURLToPath } from "url";
 import express from "express";
 import { marked } from "marked";
@@ -7366,7 +7515,7 @@ async function startPreviewServer(options) {
   const app = express();
   const previewClientDir = await resolvePreviewClientBuildDir();
   app.disable("x-powered-by");
-  app.use("/assets", express.static(options.assetDir));
+  app.use("/assets", express.static(options.assetDir, { dotfiles: "allow" }));
   if (previewClientDir) {
     app.use(express.static(previewClientDir, { index: false }));
   }
@@ -7400,7 +7549,7 @@ async function startPreviewServer(options) {
       const assetPathParam = req.params.assetPath;
       const rawAssetPath = Array.isArray(assetPathParam) ? assetPathParam.join("/") : assetPathParam ?? "";
       const resolvedAssetPath = await resolveGenerationAssetPath(generationId, rawAssetPath, options.markdownOutputDir);
-      res.sendFile(resolvedAssetPath);
+      res.sendFile(resolvedAssetPath, { dotfiles: "allow" });
     } catch (error) {
       const message = error instanceof Error ? error.message : "Unknown error loading generation asset";
       const status = error instanceof MissingArticleError ? 404 : 400;
@@ -7449,7 +7598,7 @@ async function startPreviewServer(options) {
         if (options.watch) {
           let html2;
           try {
-            html2 = await readFile9(path12.join(previewClientDir, "index.html"), "utf8");
+            html2 = await readFile10(path13.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>`
@@ -7460,7 +7609,7 @@ async function startPreviewServer(options) {
           const injected = html2.replace("</body>", `${reloadScript}</body>`);
           res.status(200).type("html").send(injected);
         } else {
-          res.status(200).sendFile(path12.join(previewClientDir, "index.html"));
+          res.status(200).sendFile(path13.join(previewClientDir, "index.html"));
         }
         return;
       }
@@ -7513,7 +7662,7 @@ async function getArticleContent(generationId, markdownOutputDir) {
     generation.outputs.map(async (output) => {
       let markdown = "";
       try {
-        markdown = await readFile9(output.sourcePath, "utf8");
+        markdown = await readFile10(output.sourcePath, "utf8");
       } catch (error) {
         if (isMissingFileError(error)) {
           throw new MissingArticleError(`Generation "${generationId}" no longer exists.`);
@@ -7531,15 +7680,17 @@ async function getArticleContent(generationId, markdownOutputDir) {
       };
     })
   );
-  const generationDir = path12.dirname(generation.outputs[0]?.sourcePath ?? "");
+  const generationDir = path13.dirname(generation.outputs[0]?.sourcePath ?? "");
   const interactions = generationDir ? await loadSavedInteractions(generationDir) : { llmCalls: [], t2iCalls: [] };
   const analyticsSummary = generationDir ? await loadSavedAnalyticsSummary(generationDir) : null;
+  const metaJson = generationDir ? await loadSavedMetaJson(generationDir) : null;
   return {
     title: generation.title,
     generationId: generation.id,
     sourcePath,
     interactions,
     analyticsSummary,
+    metaJson,
     outputs
   };
 }
@@ -7560,7 +7711,7 @@ async function resolveActivePreviewArticle(preferredMarkdownPath, markdownOutput
   };
 }
 function resolveGenerationSourcePath(generation, markdownOutputDir) {
-  return generation.outputs.find((output) => output.contentType === generation.primaryContentType)?.sourcePath ?? generation.outputs[0]?.sourcePath ?? path12.join(markdownOutputDir, generation.id);
+  return generation.outputs.find((output) => output.contentType === generation.primaryContentType)?.sourcePath ?? generation.outputs[0]?.sourcePath ?? path13.join(markdownOutputDir, generation.id);
 }
 function isMissingFileError(error) {
   return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
@@ -7575,7 +7726,7 @@ async function renderArticleHtml(markdown, generationId, sourcePath) {
 async function loadSavedLinks(markdownPath) {
   const linksPath = resolveLinksPath(markdownPath);
   try {
-    const raw = await readFile9(linksPath, "utf8");
+    const raw = await readFile10(linksPath, "utf8");
     const parsed = JSON.parse(raw);
     if (!Array.isArray(parsed.links)) {
       return [];
@@ -7599,9 +7750,9 @@ async function loadSavedLinks(markdownPath) {
   }
 }
 async function loadSavedInteractions(generationDir) {
-  const interactionsPath = path12.join(generationDir, "model.interactions.json");
+  const interactionsPath = path13.join(generationDir, "model.interactions.json");
   try {
-    const raw = await readFile9(interactionsPath, "utf8");
+    const raw = await readFile10(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) : [];
@@ -7617,9 +7768,9 @@ async function loadSavedInteractions(generationDir) {
   }
 }
 async function loadSavedAnalyticsSummary(generationDir) {
-  const analyticsPath = path12.join(generationDir, "generation.analytics.json");
+  const analyticsPath = path13.join(generationDir, "generation.analytics.json");
   try {
-    const raw = await readFile9(analyticsPath, "utf8");
+    const raw = await readFile10(analyticsPath, "utf8");
     const parsed = JSON.parse(raw);
     const summary = parsed.summary;
     if (!summary || typeof summary !== "object") {
@@ -7640,6 +7791,15 @@ async function loadSavedAnalyticsSummary(generationDir) {
     return null;
   }
 }
+async function loadSavedMetaJson(generationDir) {
+  const metaJsonPath = path13.join(generationDir, "meta.json");
+  try {
+    const raw = await readFile10(metaJsonPath, "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
 async function getPreviewBootstrapData(preferredMarkdownPath, markdownOutputDir) {
   const activeArticle = await resolveActivePreviewArticle(preferredMarkdownPath, markdownOutputDir);
   const emptyStateMessage = activeArticle ? null : `No generated content found in ${markdownOutputDir}. Run ideon write "your idea" first.`;
@@ -7651,14 +7811,14 @@ async function getPreviewBootstrapData(preferredMarkdownPath, markdownOutputDir)
   };
 }
 async function resolvePreviewClientBuildDir() {
-  const currentDir = path12.dirname(fileURLToPath(import.meta.url));
+  const currentDir = path13.dirname(fileURLToPath(import.meta.url));
   const candidates = [
-    path12.resolve(currentDir, "preview"),
-    path12.resolve(currentDir, "../../dist/preview")
+    path13.resolve(currentDir, "preview"),
+    path13.resolve(currentDir, "../../dist/preview")
   ];
   for (const candidate of candidates) {
     try {
-      const indexStat = await stat6(path12.join(candidate, "index.html"));
+      const indexStat = await stat6(path13.join(candidate, "index.html"));
       if (indexStat.isFile()) {
         return candidate;
       }
@@ -7720,17 +7880,17 @@ async function resolveGenerationAssetPath(generationId, rawAssetPath, markdownOu
     throw new MissingArticleError(`Generation "${generationId}" no longer exists.`);
   }
   const decodedAssetPath = decodeURIComponent(rawAssetPath);
-  const normalizedRelative = path12.posix.normalize(decodedAssetPath.replace(/\\/g, "/"));
-  if (normalizedRelative.length === 0 || normalizedRelative === "." || normalizedRelative.startsWith("../") || normalizedRelative.includes("/../") || path12.posix.isAbsolute(normalizedRelative)) {
+  const normalizedRelative = path13.posix.normalize(decodedAssetPath.replace(/\\/g, "/"));
+  if (normalizedRelative.length === 0 || normalizedRelative === "." || normalizedRelative.startsWith("../") || normalizedRelative.includes("/../") || path13.posix.isAbsolute(normalizedRelative)) {
     throw new Error("Invalid generation asset path.");
   }
-  const generationDir = path12.dirname(generation.outputs[0]?.sourcePath ?? "");
+  const generationDir = path13.dirname(generation.outputs[0]?.sourcePath ?? "");
   if (!generationDir) {
     throw new MissingArticleError(`Generation "${generationId}" has no source directory.`);
   }
-  const resolvedPath = path12.resolve(generationDir, normalizedRelative);
-  const relativeToGeneration = path12.relative(generationDir, resolvedPath);
-  if (relativeToGeneration.startsWith("..") || path12.isAbsolute(relativeToGeneration)) {
+  const resolvedPath = path13.resolve(generationDir, normalizedRelative);
+  const relativeToGeneration = path13.relative(generationDir, resolvedPath);
+  if (relativeToGeneration.startsWith("..") || path13.isAbsolute(relativeToGeneration)) {
     throw new Error("Invalid generation asset path.");
   }
   try {
@@ -9208,7 +9368,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 = path13.resolve(process.cwd(), "node_modules", ".bin", "vite");
+    const viteBin = path14.resolve(process.cwd(), "node_modules", ".bin", "vite");
     const viteProcess = spawn(viteBin, ["build", "--watch"], {
       stdio: "inherit",
       shell: process.platform === "win32"
@@ -9234,8 +9394,8 @@ async function runServeCommand(options) {
     openBrowser: options.openBrowser,
     watch: options.watch
   });
-  const relativeArticle = path13.relative(process.cwd(), markdownPath);
-  const relativeAssets = path13.relative(process.cwd(), outputPaths.assetOutputDir);
+  const relativeArticle = path14.relative(process.cwd(), markdownPath);
+  const relativeAssets = path14.relative(process.cwd(), outputPaths.assetOutputDir);
   console.log(`Previewing ${relativeArticle || markdownPath}`);
   console.log(`Serving assets from ${relativeAssets || outputPaths.assetOutputDir}`);
   console.log(`Open ${server.url}`);
@@ -9785,6 +9945,7 @@ async function renderPlainPipeline(input, dryRun, enrichLinks2, runMode, links,
       title: result.artifact.title,
       slug: result.artifact.slug
     });
+    return result;
   } catch (error) {
     const message = error instanceof Error ? withWriteResumeHint(error.message) : withWriteResumeHint("Pipeline failed.");
     await notifyWriteFailed({
@@ -10101,6 +10262,7 @@ function WriteApp({
   unlinks,
   maxLinks,
   maxImages,
+  onSuccess,
   onError
 }) {
   const { exit } = useApp3();
@@ -10136,6 +10298,7 @@ function WriteApp({
           return;
         }
         setResult(runResult);
+        onSuccess?.(runResult);
         await notifyWriteSucceeded({
           enabled: input.config.settings.notifications.enabled,
           title: runResult.artifact.title,
@@ -10174,7 +10337,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, options.maxImages);
+  await runWritePipeline(input, options.dryRun, options.enrichLinks, "fresh", options.noInteractive, options.links, options.unlinks, options.maxLinks, options.maxImages, options.exportPath);
 }
 async function runWriteResumeCommand(options = {}) {
   const session = await loadWriteSession();
@@ -10196,9 +10359,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, options.maxImages);
+  await runWritePipeline(input, session.dryRun, options.enrichLinks ?? false, "resume", options.noInteractive ?? false, options.links, options.unlinks, options.maxLinks, options.maxImages, options.exportPath);
 }
-async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteractive, links, unlinks, maxLinks, maxImages) {
+async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteractive, links, unlinks, maxLinks, maxImages, exportPath) {
   let interruptHandled = false;
   const handleSignal = (signal) => {
     if (interruptHandled) {
@@ -10232,10 +10395,17 @@ 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, maxImages);
+      const result = await renderPlainPipeline(input, dryRun, enrichLinks2, runMode, links, unlinks, maxLinks, maxImages);
+      if (exportPath) {
+        await runOutputCommand({
+          generationId: result.artifact.slug,
+          destinationPath: exportPath
+        });
+      }
       return;
     }
     let commandError = null;
+    let pipelineResult = null;
     const app = render2(
       /* @__PURE__ */ jsx7(
         WriteApp,
@@ -10248,6 +10418,9 @@ async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteract
           unlinks,
           maxLinks,
           maxImages,
+          onSuccess: (result) => {
+            pipelineResult = result;
+          },
           onError: (error) => {
             commandError = error;
           }
@@ -10260,6 +10433,9 @@ async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteract
     if (finalError) {
       throw new ReportedError(withWriteResumeHint(finalError.message));
     }
+    if (exportPath && pipelineResult) {
+      await autoExport(exportPath, pipelineResult);
+    }
   } finally {
     cleanupSignalHandlers();
   }
@@ -10407,6 +10583,12 @@ async function promptForIdea() {
     readline.close();
   }
 }
+async function autoExport(exportPath, result) {
+  await runOutputCommand({
+    generationId: result.artifact.slug,
+    destinationPath: exportPath
+  });
+}
 
 // src/cli/app.ts
 var { version } = package_default;
@@ -10476,7 +10658,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-plan 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) => {
+  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-plan 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)).option("--export <path>", "Export the generated article to the given directory after writing").action(async (ideaArg, options) => {
     await runWriteCommand({
       idea: options.idea ?? ideaArg,
       audience: options.audience,
@@ -10492,17 +10674,19 @@ async function runCli(argv) {
       links: options.link,
       unlinks: options.unlink,
       maxLinks: options.maxLinks,
-      maxImages: options.maxImages
+      maxImages: options.maxImages,
+      exportPath: options.export
     });
   });
-  writeCommand.command("resume").description("Resume the last failed or interrupted write session.").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) => {
+  writeCommand.command("resume").description("Resume the last failed or interrupted write session.").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)).option("--export <path>", "Export the generated article to the given directory after writing").action(async (options) => {
     await runWriteResumeCommand({
       noInteractive: options.noInteractive,
       enrichLinks: options.enrichLinks,
       links: options.link,
       unlinks: options.unlink,
       maxLinks: options.maxLinks,
-      maxImages: options.maxImages
+      maxImages: options.maxImages,
+      exportPath: options.export
     });
   });
   await program.parseAsync(argv);