@telepat/ideon 0.1.24 → 0.1.25

package/dist/ideon.js

@@ -484,9 +484,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 +1423,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 // package.json
 var package_default = {
   name: "@telepat/ideon",
-  version: "0.1.24",
+  version: "0.1.25",
   description: "CLI for generating rich articles and images from ideas.",
   type: "module",
   repository: {
@@ -1625,7 +1625,7 @@ function assertNoLegacyXMode(contentTargets, sourceLabel) {
 // src/pipeline/runner.ts
 import { mkdir as mkdir6, 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";
@@ -2380,7 +2380,7 @@ function buildLongFormPlanJsonSchema(targetLengthWords) {
           required: ["description", "anchorAfterSection"],
           properties: {
             description: { type: "string" },
-            anchorAfterSection: { type: "number", minimum: 1 }
+            anchorAfterSection: { type: "number", minimum: 2 }
           }
         }
       }
@@ -2446,7 +2446,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 2). Choose sections where visual reinforcement adds the most value. Do not anchor inline images after the first section because the cover image already appears near the title.",
         "- 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 +2468,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 2, since the cover image already appears near the title)`,
         "",
         "Do not omit any required fields. Return strict JSON only."
       ].join("\n")
@@ -2530,7 +2530,7 @@ var articleSectionPlanSchema = z5.object({
 });
 var inlineImagePlanSchema = z5.object({
   description: z5.string().min(1),
-  anchorAfterSection: z5.number().int().min(1)
+  anchorAfterSection: z5.number().int().min(2)
 });
 var primaryPlanSchema = z5.object({
   contentType: z5.string().min(1).default("article"),
@@ -2543,7 +2543,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 +2557,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),
@@ -2619,7 +2619,7 @@ async function planPrimaryContent({
       keywords: longPlan.keywords.slice(0, 8),
       inlineImages: longPlan.inlineImages.slice(0, 3).map((img) => ({
         ...img,
-        anchorAfterSection: Math.max(1, Math.min(sectionCount, img.anchorAfterSection))
+        anchorAfterSection: Math.max(2, Math.min(sectionCount, img.anchorAfterSection))
       }))
     };
   }
@@ -3276,7 +3276,7 @@ function buildImageSlots(plan, sections, options) {
       kind: "inline",
       prompt: "",
       description: img.description,
-      anchorAfterSection: Math.max(1, Math.min(sectionCount, img.anchorAfterSection))
+      anchorAfterSection: Math.max(2, Math.min(sectionCount, img.anchorAfterSection))
     });
   }
   return slots;
@@ -4003,10 +4003,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 +4108,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 +4145,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 +4217,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 +4776,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 +4793,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 +5022,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 +5085,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,
@@ -5240,10 +5300,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 +5331,8 @@ async function runPipelineShell(input, options = {}) {
       assetDir: sharedAssetDir,
       analyticsPath,
       interactionsPath,
-      planPath
+      planPath,
+      metaJsonPath
     };
     writeSession = await patchWriteSession(
       {
@@ -5731,7 +5806,7 @@ function parsePipelineCustomLinks(rawLinks, unlinks) {
 
 // src/cli/commands/links.ts
 import { readFile as readFile6, stat as stat3 } from "fs/promises";
-import path9 from "path";
+import path10 from "path";
 async function runLinksCommand(options, dependencies = {}) {
   const slug = normalizeSlug2(options.slug);
   const mode = normalizeMode(options.mode);
@@ -5742,7 +5817,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;
@@ -5812,14 +5887,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;
     }
@@ -5953,7 +6028,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) {
@@ -5993,7 +6068,7 @@ 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 path12 from "path";
 
 // src/output/enrichMarkdownWithLinks.ts
 function enrichMarkdownWithLinks(markdown, links) {
@@ -6050,7 +6125,7 @@ function escapeRegExp(value2) {
 
 // src/server/previewHelpers.ts
 import { readdir, stat as stat4, readFile as readFile7 } from "fs/promises";
-import path10 from "path";
+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 +6183,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");
@@ -6153,7 +6228,7 @@ function extractCoverImageUrl(markdown) {
 async function extractArticleMetadata(markdownPath) {
   const markdown = await readFile7(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);
@@ -6218,16 +6293,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 +6319,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 +6333,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,11 +6369,11 @@ 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 parsed = JSON.parse(raw);
@@ -6314,6 +6389,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));
@@ -6337,10 +6417,10 @@ async function runOutputCommand(options, dependencies = {}) {
   }
   const sourceMarkdownPath = articleOutput.sourcePath;
   const sourceMarkdown = await readFile8(sourceMarkdownPath, "utf8");
-  const slug = extractFrontmatterSlug2(sourceMarkdown) ?? path11.basename(sourceMarkdownPath, ".md");
+  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 +6429,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 +6468,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) {
@@ -6466,22 +6538,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,7 +7399,7 @@ 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
@@ -7351,7 +7407,7 @@ import { execFile } from "child_process";
 import { promisify } from "util";
 import { readFile as readFile9, 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";
@@ -7449,7 +7505,7 @@ async function startPreviewServer(options) {
         if (options.watch) {
           let html2;
           try {
-            html2 = await readFile9(path12.join(previewClientDir, "index.html"), "utf8");
+            html2 = await readFile9(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 +7516,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;
       }
@@ -7531,15 +7587,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 +7618,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";
@@ -7599,7 +7657,7 @@ 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 parsed = JSON.parse(raw);
@@ -7617,7 +7675,7 @@ 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 parsed = JSON.parse(raw);
@@ -7640,6 +7698,15 @@ async function loadSavedAnalyticsSummary(generationDir) {
     return null;
   }
 }
+async function loadSavedMetaJson(generationDir) {
+  const metaJsonPath = path13.join(generationDir, "meta.json");
+  try {
+    const raw = await readFile9(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 +7718,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 +7787,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 +9275,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 +9301,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 +9852,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 +10169,7 @@ function WriteApp({
   unlinks,
   maxLinks,
   maxImages,
+  onSuccess,
   onError
 }) {
   const { exit } = useApp3();
@@ -10136,6 +10205,7 @@ function WriteApp({
           return;
         }
         setResult(runResult);
+        onSuccess?.(runResult);
         await notifyWriteSucceeded({
           enabled: input.config.settings.notifications.enabled,
           title: runResult.artifact.title,
@@ -10174,7 +10244,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 +10266,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 +10302,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 +10325,9 @@ async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteract
           unlinks,
           maxLinks,
           maxImages,
+          onSuccess: (result) => {
+            pipelineResult = result;
+          },
           onError: (error) => {
             commandError = error;
           }
@@ -10260,6 +10340,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 +10490,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 +10565,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 +10581,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);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telepat/ideon",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "description": "CLI for generating rich articles and images from ideas.",
   "type": "module",
   "repository": {