@telepat/ideon 0.1.13 → 0.1.14

package/dist/ideon.js

@@ -93,6 +93,12 @@ function resolveTargetLengthAlias(targetLengthWords) {
   }
   return "large";
 }
+function resolveDefaultMaxLinks(targetLengthWords) {
+  const alias = resolveTargetLengthAlias(targetLengthWords);
+  if (alias === "small") return 5;
+  if (alias === "medium") return 8;
+  return 12;
+}
 var contentTargetRoleValues = ["primary", "secondary"];
 var contentTargetSchema = z.object({
   contentType: z.enum(contentTypeValues),
@@ -1299,7 +1305,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 // package.json
 var package_default = {
   name: "@telepat/ideon",
-  version: "0.1.13",
+  version: "0.1.14",
   description: "CLI for generating rich articles and images from ideas.",
   type: "module",
   repository: {
@@ -1508,7 +1514,7 @@ import path8 from "path";
 import { readFile as readFile4 } from "fs/promises";
 
 // src/llm/prompts/linkEnrichment.ts
-function buildLinkCandidatesJsonSchema() {
+function buildLinkCandidatesJsonSchema(maxLinks = 10) {
   return {
     type: "object",
     additionalProperties: false,
@@ -1517,13 +1523,13 @@ function buildLinkCandidatesJsonSchema() {
       expressions: {
         type: "array",
         minItems: 0,
-        maxItems: 10,
+        maxItems: maxLinks,
         items: { type: "string", minLength: 2 }
       }
     }
   };
 }
-function buildLinkCandidatesMessages(content, contentType) {
+function buildLinkCandidatesMessages(content, contentType, maxLinks = 10) {
   return [
     {
       role: "system",
@@ -1539,7 +1545,7 @@ function buildLinkCandidatesMessages(content, contentType) {
       role: "user",
       content: [
         `Content type: ${contentType}`,
-        "Select up to 10 expressions that should become links in this content.",
+        `Select up to ${maxLinks} expressions that should become links in this content.`,
         "Each expression must be copied exactly from the text and be useful to link.",
         "",
         "Content:",
@@ -1594,6 +1600,8 @@ async function enrichLinks({
   openRouter,
   settings,
   dryRun,
+  customLinks = [],
+  maxLinks = 10,
   onLlmMetrics,
   onItemProgress,
   onInteraction
@@ -1615,7 +1623,8 @@ async function enrichLinks({
         fileId: item.fileId,
         contentType: item.contentType,
         markdownPath: item.markdownPath,
-        links: []
+        links: [],
+        customLinks
       });
       continue;
     }
@@ -1634,7 +1643,8 @@ async function enrichLinks({
         fileId: item.fileId,
         contentType: item.contentType,
         markdownPath: item.markdownPath,
-        links: []
+        links: [],
+        customLinks
       });
       continue;
     }
@@ -1645,8 +1655,8 @@ async function enrichLinks({
     });
     const candidateResult = await openRouter.requestStructured({
       schemaName: "link_candidates",
-      schema: buildLinkCandidatesJsonSchema(),
-      messages: buildLinkCandidatesMessages(content, item.contentType),
+      schema: buildLinkCandidatesJsonSchema(maxLinks),
+      messages: buildLinkCandidatesMessages(content, item.contentType, maxLinks),
       settings,
       reasoning: LINKS_REASONING_SETTINGS,
       interactionContext: {
@@ -1657,7 +1667,10 @@ async function enrichLinks({
       parse(data) {
         const record = data;
         const expressions = Array.isArray(record.expressions) ? record.expressions.filter((value2) => typeof value2 === "string") : [];
-        return { expressions: dedupeExpressions(expressions).slice(0, 10) };
+        const customExpressions = new Set(customLinks.map((e) => e.expression.trim().toLowerCase()));
+        return {
+          expressions: dedupeExpressions(expressions).filter((expr) => !customExpressions.has(expr.trim().toLowerCase())).slice(0, maxLinks)
+        };
       },
       onMetrics(metrics) {
         onLlmMetrics?.(item.fileId, metrics);
@@ -1734,7 +1747,8 @@ async function enrichLinks({
       fileId: item.fileId,
       contentType: item.contentType,
       markdownPath: item.markdownPath,
-      links
+      links,
+      customLinks
     });
   }
   return results;
@@ -4355,7 +4369,8 @@ var linksResultSchema = z6.object({
   fileId: z6.string().min(1),
   contentType: z6.string().min(1),
   markdownPath: z6.string().min(1),
-  links: z6.array(linkEntrySchema)
+  links: z6.array(linkEntrySchema),
+  customLinks: z6.array(linkEntrySchema).default([])
 });
 var pipelineArtifactSummarySchema = z6.object({
   title: z6.string().min(1),
@@ -4553,6 +4568,9 @@ async function runPipelineShell(input, options = {}) {
   const shouldEnrichLinks = options.enrichLinks ?? false;
   const runMode = options.runMode ?? "fresh";
   const workingDir = options.workingDir ?? process.cwd();
+  const pipelineCustomLinkRaws = options.customLinks ?? [];
+  const pipelineUnlinks = options.unlinks ?? [];
+  const pipelineMaxLinks = options.maxLinks;
   const outputPaths = resolveOutputPaths(input.config.settings, workingDir);
   const hasArticlePrimary = isArticlePrimary;
   const stageTracking = /* @__PURE__ */ new Map();
@@ -5422,15 +5440,19 @@ async function runPipelineShell(input, options = {}) {
       options.onUpdate?.(cloneStages(stages));
     } else if (linksResult) {
       const linksByFileId = new Map(linksResult.map((item) => [item.fileId, item.links]));
-      linksResult = eligibleOutputsForLinks.map((output) => ({
+      const customLinksByFileId = new Map(linksResult.map((item) => [item.fileId, item.customLinks]));
+      const resumedLinks = eligibleOutputsForLinks.map((output) => ({
         fileId: output.fileId,
         contentType: output.contentType,
         markdownPath: output.markdownPath,
-        links: linksByFileId.get(output.fileId) ?? []
+        links: linksByFileId.get(output.fileId) ?? [],
+        customLinks: customLinksByFileId.get(output.fileId) ?? []
       }));
-      for (const item of linksResult) {
+      linksResult = resumedLinks;
+      for (const item of resumedLinks) {
         await writeLinksFile(item.markdownPath, {
-          version: 1,
+          version: 2,
+          customLinks: item.customLinks,
           links: item.links
         });
       }
@@ -5439,7 +5461,7 @@ async function runPipelineShell(input, options = {}) {
         ...stages[6],
         status: "succeeded",
         detail: "Reused saved link metadata from .ideon/write.",
-        summary: `${linksResult.reduce((sum, item) => sum + item.links.length, 0)} links`,
+        summary: `${resumedLinks.reduce((sum, item) => sum + item.links.length, 0)} links`,
         items: (stages[6].items ?? []).map((item) => ({
           ...item,
           status: "succeeded",
@@ -5457,6 +5479,8 @@ async function runPipelineShell(input, options = {}) {
         openRouter,
         settings: input.config.settings,
         dryRun,
+        customLinks: parsePipelineCustomLinks(pipelineCustomLinkRaws, pipelineUnlinks),
+        maxLinks: pipelineMaxLinks ?? resolveDefaultMaxLinks(input.config.settings.targetLength),
         onInteraction(interaction) {
           onLlmInteraction(interaction);
         },
@@ -5501,7 +5525,8 @@ async function runPipelineShell(input, options = {}) {
           costSource
         });
         await writeLinksFile(item.markdownPath, {
-          version: 1,
+          version: 2,
+          customLinks: item.customLinks,
           links: item.links
         });
       }
@@ -5866,7 +5891,6 @@ function toFilePrefix(contentType) {
   if (contentType === "reddit-post") return "reddit";
   if (contentType === "linkedin-post") return "linkedin";
   if (contentType === "newsletter") return "newsletter";
-  if (contentType === "landing-page-copy") return "landing";
   return contentType.replace(/[^a-z0-9]+/gi, "-").replace(/^-+|-+$/g, "").toLowerCase() || "content";
 }
 function getPrimaryTarget(contentTargets) {
@@ -5962,6 +5986,24 @@ function asWriteStageId(stageId) {
   }
   return null;
 }
+function parsePipelineCustomLinks(rawLinks, unlinks) {
+  const result = /* @__PURE__ */ new Map();
+  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());
+}
 
 // src/cli/commands/writeTargetSpecs.ts
 function parseTargetSpec(spec) {
@@ -6273,6 +6315,10 @@ async function runLinksCommand(options, dependencies = {}) {
     );
   }
   const openRouter = new OpenRouterClient(openRouterApiKey);
+  const linksPath = resolveLinksPath(markdownPath);
+  const existing = await readExistingLinks(linksPath);
+  const updatedCustomLinks = resolveCustomLinks(existing?.customLinks ?? [], options.links ?? [], options.unlinks ?? []);
+  const effectiveMaxLinks = options.maxLinks;
   const linksResult = await enrichLinks({
     markdownFiles: [{ markdownPath, fileId, contentType: "article" }],
     articleTitle,
@@ -6280,31 +6326,32 @@ async function runLinksCommand(options, dependencies = {}) {
     openRouter,
     settings: resolved.config.settings,
     dryRun: false,
+    customLinks: updatedCustomLinks,
+    maxLinks: effectiveMaxLinks,
     onItemProgress(event) {
       logProgress(event, log);
     }
   });
   const generatedLinks = linksResult[0]?.links ?? [];
-  const linksPath = resolveLinksPath(markdownPath);
-  const existing = await readExistingLinks(linksPath);
-  const mergedLinks = mode === "append" ? mergeLinks(existing?.links ?? [], generatedLinks) : generatedLinks;
-  const appendedCount = Math.max(0, mergedLinks.length - (existing?.links.length ?? 0));
+  const mergedGeneratedLinks = mode === "append" ? mergeLinks(existing?.links ?? [], generatedLinks) : generatedLinks;
+  const appendedCount = Math.max(0, mergedGeneratedLinks.length - (existing?.links.length ?? 0));
   await writeLinksFile(markdownPath, {
-    version: 1,
-    links: mergedLinks
+    version: 2,
+    customLinks: updatedCustomLinks,
+    links: mergedGeneratedLinks
   });
   const relativeMarkdownPath = formatRelativePath2(cwd2, markdownPath);
   const relativeLinksPath = formatRelativePath2(cwd2, linksPath);
   if (mode === "fresh") {
     const replaced = existing ? "Replaced existing links." : "Created links sidecar.";
     log(`Enriched links for "${slug}".`);
-    log(`${replaced} Saved ${generatedLinks.length} links to ${relativeLinksPath} (${relativeMarkdownPath}).`);
+    log(`${replaced} Saved ${generatedLinks.length} generated + ${updatedCustomLinks.length} custom links to ${relativeLinksPath} (${relativeMarkdownPath}).`);
     return;
   }
   const baseCount = existing?.links.length ?? 0;
   const verb = existing ? "Appended and deduplicated links." : "Created links sidecar.";
   log(`Enriched links for "${slug}".`);
-  log(`${verb} Base ${baseCount}, added ${appendedCount}, total ${mergedLinks.length} in ${relativeLinksPath} (${relativeMarkdownPath}).`);
+  log(`${verb} Base ${baseCount}, added ${appendedCount}, total ${mergedGeneratedLinks.length} generated + ${updatedCustomLinks.length} custom in ${relativeLinksPath} (${relativeMarkdownPath}).`);
 }
 function normalizeMode(rawMode) {
   const normalized = rawMode.trim().toLowerCase();
@@ -6420,8 +6467,14 @@ 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) => ({
+      expression: entry.expression.trim(),
+      url: entry.url.trim(),
+      title: typeof entry.title === "string" ? entry.title : null
+    })) : [];
     return {
       version: typeof parsed.version === "number" ? parsed.version : 1,
+      customLinks,
       links
     };
   } catch (error) {
@@ -6472,6 +6525,34 @@ function logProgress(event, log) {
   }
   log(event.detail);
 }
+function parseCustomLinkFlag(raw) {
+  const separatorIndex = raw.indexOf("->");
+  if (separatorIndex < 0) {
+    throw new ReportedError(`Invalid --link value "${raw}". Expected format: "expression->url".`);
+  }
+  const expression = raw.slice(0, separatorIndex).trim();
+  const url = raw.slice(separatorIndex + 2).trim();
+  if (!expression) {
+    throw new ReportedError(`Invalid --link value "${raw}": expression (left side of ->) cannot be empty.`);
+  }
+  if (!url) {
+    throw new ReportedError(`Invalid --link value "${raw}": url (right side of ->) cannot be empty.`);
+  }
+  return { expression, url };
+}
+function resolveCustomLinks(existing, addRaw, removeExpressions) {
+  const result = new Map(
+    existing.map((entry) => [entry.expression.trim().toLowerCase(), entry])
+  );
+  for (const raw of addRaw) {
+    const { expression, url } = parseCustomLinkFlag(raw);
+    result.set(expression.toLowerCase(), { expression, url, title: null });
+  }
+  for (const expr of removeExpressions) {
+    result.delete(expr.trim().toLowerCase());
+  }
+  return Array.from(result.values());
+}
 
 // src/cli/commands/settings.tsx
 import { render } from "ink";
@@ -6852,7 +6933,7 @@ import { spawn } from "child_process";
 import { readdir, stat as stat4, readFile as readFile7 } from "fs/promises";
 import path10 from "path";
 var DEFAULT_PORT = 4173;
-var CONTENT_TYPE_ORDER = ["article", "blog-post", "x-thread", "x-post", "linkedin-post", "reddit-post", "newsletter", "landing-page-copy"];
+var CONTENT_TYPE_ORDER = ["article", "blog-post", "x-thread", "x-post", "linkedin-post", "reddit-post", "newsletter"];
 var FILE_PREFIX_TO_CONTENT_TYPE = {
   article: "article",
   blog: "blog-post",
@@ -6861,8 +6942,7 @@ var FILE_PREFIX_TO_CONTENT_TYPE = {
   x: "x-post",
   reddit: "reddit-post",
   linkedin: "linkedin-post",
-  newsletter: "newsletter",
-  landing: "landing-page-copy"
+  newsletter: "newsletter"
 };
 var CONTENT_TYPE_LABELS = {
   article: "Article",
@@ -6871,8 +6951,7 @@ var CONTENT_TYPE_LABELS = {
   "x-post": "X Post",
   "reddit-post": "Reddit Post",
   "linkedin-post": "LinkedIn Post",
-  newsletter: "Newsletter",
-  "landing-page-copy": "Landing Page Copy"
+  newsletter: "Newsletter"
 };
 function parsePort(portOption) {
   if (!portOption) {
@@ -7630,10 +7709,6 @@ function renderShell({
         --newsletter-bg: #fffdf4;
         --newsletter-header-bg: #fff5cc;
         --newsletter-border: #cfb95a;
-        --landing-bg: linear-gradient(155deg, #10395c 0%, #3d7fa0 100%);
-        --landing-text: #f8fdff;
-        --landing-link: #d7f0ff;
-        --landing-border: rgba(255, 255, 255, 0.3);
         color-scheme: light;
       }
 
@@ -7673,10 +7748,6 @@ function renderShell({
           --newsletter-bg: #2e291b;
           --newsletter-header-bg: #3b331e;
           --newsletter-border: #d6b25f;
-          --landing-bg: linear-gradient(155deg, #0f2236 0%, #245d7e 100%);
-          --landing-text: #e7f4ff;
-          --landing-link: #b8e4ff;
-          --landing-border: rgba(220, 239, 255, 0.35);
           color-scheme: dark;
         }
       }
@@ -7716,10 +7787,6 @@ function renderShell({
         --newsletter-bg: #fffdf4;
         --newsletter-header-bg: #fff5cc;
         --newsletter-border: #cfb95a;
-        --landing-bg: linear-gradient(155deg, #10395c 0%, #3d7fa0 100%);
-        --landing-text: #f8fdff;
-        --landing-link: #d7f0ff;
-        --landing-border: rgba(255, 255, 255, 0.3);
         color-scheme: light;
       }
 
@@ -7758,10 +7825,6 @@ function renderShell({
         --newsletter-bg: #2e291b;
         --newsletter-header-bg: #3b331e;
         --newsletter-border: #d6b25f;
-        --landing-bg: linear-gradient(155deg, #0f2236 0%, #245d7e 100%);
-        --landing-text: #e7f4ff;
-        --landing-link: #b8e4ff;
-        --landing-border: rgba(220, 239, 255, 0.35);
         color-scheme: dark;
       }
 
@@ -8281,21 +8344,6 @@ function renderShell({
         background: var(--newsletter-header-bg);
       }
 
-      .channel-landing-page-copy {
-        background: var(--landing-bg);
-        color: var(--landing-text);
-        border: none;
-      }
-
-      .channel-landing-page-copy .channel-header {
-        border-bottom: 1px solid var(--landing-border);
-      }
-
-      .channel-landing-page-copy .channel-meta,
-      .channel-landing-page-copy a {
-        color: var(--landing-link);
-      }
-
       .channel-article,
       .channel-blog-post {
         background: var(--paper);
@@ -8481,7 +8529,7 @@ function renderShell({
       const articleElement = document.getElementById('article');
       const articleListElement = document.getElementById('articleList');
       const themeToggleButton = document.getElementById('themeToggle');
-      const typeOrder = ['article', 'blog-post', 'x-thread', 'x-post', 'linkedin-post', 'reddit-post', 'newsletter', 'landing-page-copy'];
+      const typeOrder = ['article', 'blog-post', 'x-thread', 'x-post', 'linkedin-post', 'reddit-post', 'newsletter'];
       const stageOrder = ['shared-brief', 'planning', 'sections', 'image-prompts', 'images', 'output', 'links'];
 
       let currentGeneration = null;
@@ -9582,7 +9630,7 @@ function formatPipelineStageCost(stage) {
   }
   return stage.costSource === "estimated" ? `~${formatted}` : formatted;
 }
-async function renderPlainPipeline(input, dryRun, enrichLinks2, runMode) {
+async function renderPlainPipeline(input, dryRun, enrichLinks2, runMode, links, unlinks, maxLinks) {
   let previousStages = /* @__PURE__ */ new Map();
   let previousItemStatuses = /* @__PURE__ */ new Map();
   const notificationsEnabled = input.config.settings.notifications.enabled;
@@ -9596,6 +9644,9 @@ async function renderPlainPipeline(input, dryRun, enrichLinks2, runMode) {
       dryRun,
       enrichLinks: enrichLinks2,
       runMode,
+      customLinks: links,
+      unlinks,
+      maxLinks,
       onUpdate(stages) {
         for (const stage of stages) {
           const previous = previousStages.get(stage.id);
@@ -9954,6 +10005,9 @@ function WriteApp({
   dryRun,
   enrichLinks: enrichLinks2,
   runMode,
+  links,
+  unlinks,
+  maxLinks,
   onError
 }) {
   const { exit } = useApp3();
@@ -9977,6 +10031,9 @@ function WriteApp({
           dryRun,
           enrichLinks: enrichLinks2,
           runMode,
+          customLinks: links,
+          unlinks,
+          maxLinks,
           onUpdate(nextStages) {
             if (mounted) {
               setStages(nextStages);
@@ -10009,7 +10066,7 @@ function WriteApp({
     return () => {
       mounted = false;
     };
-  }, [dryRun, enrichLinks2, input, onError, runMode]);
+  }, [dryRun, enrichLinks2, input, links, unlinks, maxLinks, onError, runMode]);
   useEffect2(() => {
     if (!result && !errorMessage) {
       return;
@@ -10025,7 +10082,7 @@ function WriteApp({
 }
 async function runWriteCommand(options) {
   const input = await resolveInputWithInteractiveIdeaFallback(options);
-  await runWritePipeline(input, options.dryRun, options.enrichLinks, "fresh", options.noInteractive);
+  await runWritePipeline(input, options.dryRun, options.enrichLinks, "fresh", options.noInteractive, options.links, options.unlinks, options.maxLinks);
 }
 async function runWriteResumeCommand(options = {}) {
   const session = await loadWriteSession();
@@ -10047,9 +10104,9 @@ async function runWriteResumeCommand(options = {}) {
       secrets: resolved.config.secrets
     }
   };
-  await runWritePipeline(input, session.dryRun, options.enrichLinks ?? false, "resume", options.noInteractive ?? false);
+  await runWritePipeline(input, session.dryRun, options.enrichLinks ?? false, "resume", options.noInteractive ?? false, options.links, options.unlinks, options.maxLinks);
 }
-async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteractive) {
+async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteractive, links, unlinks, maxLinks) {
   let interruptHandled = false;
   const handleSignal = (signal) => {
     if (interruptHandled) {
@@ -10083,7 +10140,7 @@ async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteract
   process.on("SIGTERM", onSigterm);
   try {
     if (noInteractive || !process.stdout.isTTY) {
-      await renderPlainPipeline(input, dryRun, enrichLinks2, runMode);
+      await renderPlainPipeline(input, dryRun, enrichLinks2, runMode, links, unlinks, maxLinks);
       return;
     }
     let commandError = null;
@@ -10095,6 +10152,9 @@ async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteract
           dryRun,
           enrichLinks: enrichLinks2,
           runMode,
+          links,
+          unlinks,
+          maxLinks,
           onError: (error) => {
             commandError = error;
           }
@@ -10298,10 +10358,13 @@ async function runCli(argv) {
       force: options.force
     });
   });
-  program.command("links").description("Run link enrichment for a previously generated article by slug.").argument("<slug>", "Slug of the generated article to enrich").option("--mode <mode>", "Link merge mode: fresh or append", "fresh").action(async (slug, options) => {
+  program.command("links").description("Run link enrichment for a previously generated article by slug.").argument("<slug>", "Slug of the generated article to enrich").option("--mode <mode>", "Link merge mode: fresh or append", "fresh").option("--link <pair>", 'Custom link "expression->url", repeatable', collectOptionValue).option("--unlink <expression>", "Remove a custom link by expression, repeatable", collectOptionValue).option("--max-links <n>", "Max number of generated links", (v) => Number.parseInt(v, 10)).action(async (slug, options) => {
     await runLinksCommand({
       slug,
-      mode: options.mode
+      mode: options.mode,
+      links: options.link,
+      unlinks: options.unlink,
+      maxLinks: options.maxLinks
     });
   });
   program.command("preview").description("Preview a generated article in a local browser with linked assets.").argument("[markdownPath]", "Path to the markdown file to preview").option("-p, --port <port>", "Port for the local preview server (default: 4173)").option("--no-open", "Do not auto-open browser after server startup").option("--watch", "Rebuild the preview UI on source changes and auto-reload the browser", false).action(async (markdownPath, options) => {
@@ -10312,7 +10375,7 @@ async function runCli(argv) {
       watch: options.watch
     });
   });
-  const writeCommand = program.command("write").description("Generate one primary content output plus optional secondary outputs from a prompt or job file.").argument("[idea]", "Natural-language idea for the generation run").option("-i, --idea <idea>", "Natural-language idea for the generation run").option("--audience <description>", "Optional natural-language audience description for shared-brief targeting").option("-j, --job <path>", "Path to a JSON job definition").option("--primary <type=count>", "Required primary output target (for example: article=1 or x-post=1)").option("--secondary <type=count>", "Secondary output target, repeatable (for example: x-thread=3, linkedin-post=2)", collectOptionValue).option("--style <style>", "Writing style (academic, analytical, authoritative, conversational, empathetic, friendly, journalistic, minimalist, persuasive, playful, professional, storytelling, technical)").option("--intent <intent>", "Content intent (announcement, case-study, cornerstone, counterargument, critique-review, deep-dive-analysis, how-to-guide, interview-q-and-a, listicle, opinion-piece, personal-essay, roundup-curation, tutorial)").option("--length <size>", "Target length: small, medium, large, or a positive integer word count").option("--no-interactive", "Fail instead of prompting for missing input in TTY mode").option("--dry-run", "Run the pipeline shell without external API calls", false).option("--enrich-links", "Run link enrichment after markdown generation", false).action(async (ideaArg, options) => {
+  const writeCommand = program.command("write").description("Generate one primary content output plus optional secondary outputs from a prompt or job file.").argument("[idea]", "Natural-language idea for the generation run").option("-i, --idea <idea>", "Natural-language idea for the generation run").option("--audience <description>", "Optional natural-language audience description for shared-brief targeting").option("-j, --job <path>", "Path to a JSON job definition").option("--primary <type=count>", "Required primary output target (for example: article=1 or x-post=1)").option("--secondary <type=count>", "Secondary output target, repeatable (for example: x-thread=3, linkedin-post=2)", collectOptionValue).option("--style <style>", "Writing style (academic, analytical, authoritative, conversational, empathetic, friendly, journalistic, minimalist, persuasive, playful, professional, storytelling, technical)").option("--intent <intent>", "Content intent (announcement, case-study, cornerstone, counterargument, critique-review, deep-dive-analysis, how-to-guide, interview-q-and-a, listicle, opinion-piece, personal-essay, roundup-curation, tutorial)").option("--length <size>", "Target length: small, medium, large, or a positive integer word count").option("--no-interactive", "Fail instead of prompting for missing input in TTY mode").option("--dry-run", "Run the pipeline shell without external API calls", false).option("--enrich-links", "Run link enrichment after markdown generation", false).option("--link <pair>", 'Custom link "expression->url", repeatable', collectOptionValue).option("--unlink <expression>", "Remove a custom link by expression, repeatable", collectOptionValue).option("--max-links <n>", "Max number of generated links", (v) => Number.parseInt(v, 10)).action(async (ideaArg, options) => {
     await runWriteCommand({
       idea: options.idea ?? ideaArg,
       audience: options.audience,
@@ -10324,13 +10387,19 @@ async function runCli(argv) {
       length: options.length,
       noInteractive: !options.interactive,
       dryRun: options.dryRun,
-      enrichLinks: options.enrichLinks
+      enrichLinks: options.enrichLinks,
+      links: options.link,
+      unlinks: options.unlink,
+      maxLinks: options.maxLinks
     });
   });
-  writeCommand.command("resume").description("Resume the last failed or interrupted write session from .ideon/write.").option("--no-interactive", "Force plain non-interactive output even in TTY mode", false).option("--enrich-links", "Run link enrichment after markdown generation", false).action(async (options) => {
+  writeCommand.command("resume").description("Resume the last failed or interrupted write session from .ideon/write.").option("--no-interactive", "Force plain non-interactive output even in TTY mode", false).option("--enrich-links", "Run link enrichment after markdown generation", false).option("--link <pair>", 'Custom link "expression->url", repeatable', collectOptionValue).option("--unlink <expression>", "Remove a custom link by expression, repeatable", collectOptionValue).option("--max-links <n>", "Max number of generated links", (v) => Number.parseInt(v, 10)).action(async (options) => {
     await runWriteResumeCommand({
       noInteractive: options.noInteractive,
-      enrichLinks: options.enrichLinks
+      enrichLinks: options.enrichLinks,
+      links: options.link,
+      unlinks: options.unlink,
+      maxLinks: options.maxLinks
     });
   });
   await program.parseAsync(argv);