@telepat/ideon 0.1.13 → 0.1.15

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),
@@ -966,12 +972,18 @@ var writeToolInputSchema = {
   intent: z3.enum(contentIntentValues).optional(),
   length: z3.union([z3.enum(targetLengthValues), z3.coerce.number().int().positive()]).optional(),
   dryRun: z3.boolean().optional(),
-  enrichLinks: z3.boolean().optional()
+  enrichLinks: z3.boolean().optional(),
+  link: z3.array(z3.string()).optional(),
+  unlink: z3.array(z3.string()).optional(),
+  maxLinks: z3.coerce.number().int().positive().optional()
 };
 var writeToolInputZodSchema = z3.object(writeToolInputSchema);
 var writeResumeToolInputSchema = {
   dryRun: z3.boolean().optional(),
-  enrichLinks: z3.boolean().optional()
+  enrichLinks: z3.boolean().optional(),
+  link: z3.array(z3.string()).optional(),
+  unlink: z3.array(z3.string()).optional(),
+  maxLinks: z3.coerce.number().int().positive().optional()
 };
 var writeResumeToolInputZodSchema = z3.object(writeResumeToolInputSchema);
 var deleteToolInputSchema = {
@@ -987,6 +999,20 @@ var configSetToolInputSchema = {
   value: z3.string()
 };
 var configSetToolInputZodSchema = z3.object(configSetToolInputSchema);
+var linksToolInputSchema = {
+  slug: z3.string().min(1),
+  mode: z3.enum(["fresh", "append"]).optional(),
+  link: z3.array(z3.string()).optional(),
+  unlink: z3.array(z3.string()).optional(),
+  maxLinks: z3.coerce.number().int().positive().optional()
+};
+var linksToolInputZodSchema = z3.object(linksToolInputSchema);
+var configListToolInputSchema = {};
+var configListToolInputZodSchema = z3.object(configListToolInputSchema);
+var configUnsetToolInputSchema = {
+  key: z3.enum(configKeys)
+};
+var configUnsetToolInputZodSchema = z3.object(configUnsetToolInputSchema);
 var ideonToolContracts = [
   {
     name: "ideon_write",
@@ -997,6 +1023,23 @@ var ideonToolContracts = [
       length: [...targetLengthValues]
     }
   },
+  {
+    name: "ideon_write_resume",
+    required: [],
+    enums: {}
+  },
+  {
+    name: "ideon_delete",
+    required: ["slug"],
+    enums: {}
+  },
+  {
+    name: "ideon_links",
+    required: ["slug"],
+    enums: {
+      mode: ["fresh", "append"]
+    }
+  },
   {
     name: "ideon_config_set",
     required: ["key", "value"],
@@ -1010,6 +1053,18 @@ var ideonToolContracts = [
     enums: {
       key: [...configKeys]
     }
+  },
+  {
+    name: "ideon_config_list",
+    required: [],
+    enums: {}
+  },
+  {
+    name: "ideon_config_unset",
+    required: ["key"],
+    enums: {
+      key: [...configKeys]
+    }
   }
 ];
 
@@ -1299,7 +1354,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 // package.json
 var package_default = {
   name: "@telepat/ideon",
-  version: "0.1.13",
+  version: "0.1.15",
   description: "CLI for generating rich articles and images from ideas.",
   type: "module",
   repository: {
@@ -1508,7 +1563,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 +1572,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 +1594,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 +1649,8 @@ async function enrichLinks({
   openRouter,
   settings,
   dryRun,
+  customLinks = [],
+  maxLinks = 10,
   onLlmMetrics,
   onItemProgress,
   onInteraction
@@ -1615,7 +1672,8 @@ async function enrichLinks({
         fileId: item.fileId,
         contentType: item.contentType,
         markdownPath: item.markdownPath,
-        links: []
+        links: [],
+        customLinks
       });
       continue;
     }
@@ -1634,7 +1692,8 @@ async function enrichLinks({
         fileId: item.fileId,
         contentType: item.contentType,
         markdownPath: item.markdownPath,
-        links: []
+        links: [],
+        customLinks
       });
       continue;
     }
@@ -1645,8 +1704,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 +1716,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 +1796,8 @@ async function enrichLinks({
       fileId: item.fileId,
       contentType: item.contentType,
       markdownPath: item.markdownPath,
-      links
+      links,
+      customLinks
     });
   }
   return results;
@@ -4355,7 +4418,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 +4617,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 +5489,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 +5510,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 +5528,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 +5574,8 @@ async function runPipelineShell(input, options = {}) {
           costSource
         });
         await writeLinksFile(item.markdownPath, {
-          version: 1,
+          version: 2,
+          customLinks: item.customLinks,
           links: item.links
         });
       }
@@ -5866,7 +5940,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,71 +6035,351 @@ 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) {
-  const trimmed = spec.trim();
-  if (!trimmed) {
-    throw new ReportedError("Target spec cannot be empty. Use <content-type=count>.");
+// src/cli/commands/links.ts
+import { readFile as readFile6, stat as stat3 } from "fs/promises";
+import path9 from "path";
+async function runLinksCommand(options, dependencies = {}) {
+  const slug = normalizeSlug2(options.slug);
+  const mode = normalizeMode(options.mode);
+  const cwd2 = dependencies.cwd ?? process.cwd();
+  const log = dependencies.log ?? ((message) => console.log(message));
+  const resolved = await resolveRunInput({
+    idea: `Enrich links for ${slug}`
+  });
+  const markdownPath = await resolveMarkdownPathForSlug2(resolved.config.settings, slug, cwd2);
+  const frontmatter = await readFrontmatter(markdownPath);
+  const fileId = path9.parse(markdownPath).name;
+  const articleTitle = frontmatter.title ?? toTitleFromSlug(slug);
+  const articleDescription = frontmatter.description ?? "";
+  const openRouterApiKey = resolved.config.secrets.openRouterApiKey;
+  if (!openRouterApiKey) {
+    throw new ReportedError(
+      "Missing OpenRouter API key. Run `ideon settings` to configure credentials or set IDEON_OPENROUTER_API_KEY."
+    );
   }
-  const [rawType, rawCount] = trimmed.split("=");
-  if (!rawType || !rawCount) {
-    throw new ReportedError(`Invalid target "${spec}". Use format content-type=count, e.g. article=1 or x-thread=3.`);
+  const 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,
+    articleDescription,
+    openRouter,
+    settings: resolved.config.settings,
+    dryRun: false,
+    customLinks: updatedCustomLinks,
+    maxLinks: effectiveMaxLinks,
+    onItemProgress(event) {
+      logProgress(event, log);
+    }
+  });
+  const generatedLinks = linksResult[0]?.links ?? [];
+  const mergedGeneratedLinks = mode === "append" ? mergeLinks(existing?.links ?? [], generatedLinks) : generatedLinks;
+  const appendedCount = Math.max(0, mergedGeneratedLinks.length - (existing?.links.length ?? 0));
+  await writeLinksFile(markdownPath, {
+    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} generated + ${updatedCustomLinks.length} custom links to ${relativeLinksPath} (${relativeMarkdownPath}).`);
+    return;
   }
-  const contentType = rawType.trim();
-  if (!contentTypeValues.includes(contentType)) {
+  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 ${mergedGeneratedLinks.length} generated + ${updatedCustomLinks.length} custom in ${relativeLinksPath} (${relativeMarkdownPath}).`);
+}
+function normalizeMode(rawMode) {
+  const normalized = rawMode.trim().toLowerCase();
+  if (normalized === "fresh" || normalized === "append") {
+    return normalized;
+  }
+  throw new ReportedError(`Unsupported --mode value "${rawMode}". Use "fresh" or "append".`);
+}
+function normalizeSlug2(rawSlug) {
+  const slug = rawSlug.trim();
+  if (!slug) {
+    throw new ReportedError("Slug cannot be empty. Pass the generated article slug, for example `ideon links my-article-slug`.");
+  }
+  if (slug.toLowerCase().endsWith(".md")) {
+    throw new ReportedError(`Expected a slug, not a markdown filename: ${slug}. Pass the slug without .md.`);
+  }
+  if (slug === "." || slug === ".." || /[/\\]/.test(slug)) {
+    throw new ReportedError(`Invalid slug "${slug}". Pass the article slug only, without any path separators.`);
+  }
+  return slug;
+}
+async function resolveMarkdownPathForSlug2(settings, slug, cwd2) {
+  const outputPaths = resolveOutputPaths(settings, cwd2);
+  const directPath = path9.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`) {
+      matches.push(candidate);
+      continue;
+    }
+    const frontmatter = await readFrontmatter(candidate);
+    if (frontmatter.slug === slug) {
+      matches.push(candidate);
+    }
+  }
+  if (matches.length === 0) {
     throw new ReportedError(
-      `Unsupported content type "${contentType}". Supported values: ${contentTypeValues.join(", ")}.`
+      `Could not find article "${slug}". Expected a markdown file in ${outputPaths.markdownOutputDir} with frontmatter slug "${slug}".`
     );
   }
-  const count = Number.parseInt(rawCount.trim(), 10);
-  if (!Number.isFinite(count) || count <= 0) {
-    throw new ReportedError(`Invalid count in target "${spec}". Count must be a positive integer.`);
+  return newestPath(matches);
+}
+async function newestPath(paths) {
+  let latestPath = paths[0];
+  let latestMtime = 0;
+  for (const candidate of paths) {
+    const candidateStat = await stat3(candidate);
+    if (candidateStat.mtimeMs >= latestMtime) {
+      latestMtime = candidateStat.mtimeMs;
+      latestPath = candidate;
+    }
   }
+  return latestPath;
+}
+async function readFrontmatter(markdownPath) {
+  const markdown = await readFile6(markdownPath, "utf8");
+  return parseFrontmatter(markdown);
+}
+function parseFrontmatter(markdown) {
+  if (!markdown.startsWith("---\n")) {
+    return { slug: null, title: null, description: null };
+  }
+  const frontmatterEnd = markdown.indexOf("\n---\n", 4);
+  if (frontmatterEnd < 0) {
+    return { slug: null, title: null, description: null };
+  }
+  const block = markdown.slice(4, frontmatterEnd);
   return {
-    contentType,
-    count
+    slug: parseFrontmatterValue(block, "slug"),
+    title: parseFrontmatterValue(block, "title"),
+    description: parseFrontmatterValue(block, "description")
   };
 }
-function parsePrimaryAndSecondarySpecs(options) {
-  const { primarySpec, secondarySpecs } = options;
-  if (!primarySpec && (!secondarySpecs || secondarySpecs.length === 0)) {
-    return void 0;
+function parseFrontmatterValue(block, key) {
+  const pattern = new RegExp(`^${key}:\\s*(.+)$`, "m");
+  const match = block.match(pattern);
+  if (!match || !match[1]) {
+    return null;
   }
-  if (!primarySpec) {
-    throw new ReportedError("Missing required --primary <content-type=count>.");
+  const rawValue = match[1].trim();
+  if (!rawValue) {
+    return null;
   }
-  const primary = parseTargetSpec(primarySpec);
-  if (primary.count !== 1) {
-    throw new ReportedError("Primary target count must be exactly 1. Use --primary <content-type=1>.");
+  if (rawValue.startsWith('"') && rawValue.endsWith('"') || rawValue.startsWith("'") && rawValue.endsWith("'")) {
+    return rawValue.slice(1, -1);
   }
-  const secondaryDedupedByType = /* @__PURE__ */ new Map();
-  for (const spec of secondarySpecs ?? []) {
-    const parsed = parseTargetSpec(spec);
-    if (parsed.contentType === primary.contentType) {
-      throw new ReportedError(
-        `Content type "${parsed.contentType}" cannot be both primary and secondary in the same run.`
-      );
+  return rawValue;
+}
+function toTitleFromSlug(slug) {
+  return slug.split("-").filter((part) => part.length > 0).map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
+}
+async function isReadableFile(filePath) {
+  try {
+    const fileStat = await stat3(filePath);
+    return fileStat.isFile();
+  } catch {
+    return false;
+  }
+}
+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 ReportedError(`Invalid links sidecar format at ${linksPath}. Expected { version, links[] }.`);
     }
-    const previous = secondaryDedupedByType.get(parsed.contentType);
-    if (previous) {
-      previous.count += parsed.count;
+    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) {
+    if (readErrorCode2(error) === "ENOENT") {
+      return null;
+    }
+    if (error instanceof ReportedError) {
+      throw error;
+    }
+    const message = error instanceof Error ? error.message : "Unknown links sidecar read error.";
+    throw new ReportedError(`Failed to read existing links from ${linksPath}: ${message}`);
+  }
+}
+function mergeLinks(existingLinks, generatedLinks) {
+  const merged = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const entry of [...existingLinks, ...generatedLinks]) {
+    const key = `${entry.expression.trim().toLowerCase()}::${entry.url.trim().toLowerCase()}`;
+    if (seen.has(key)) {
       continue;
     }
-    secondaryDedupedByType.set(parsed.contentType, {
-      ...parsed,
-      role: "secondary"
-    });
+    seen.add(key);
+    merged.push(entry);
   }
-  return [
-    {
-      ...primary,
-      role: "primary"
-    },
-    ...secondaryDedupedByType.values()
-  ];
+  return merged;
 }
-
+function isValidLinkEntry(value2) {
+  if (typeof value2 !== "object" || value2 === null) {
+    return false;
+  }
+  const record = value2;
+  return typeof record.expression === "string" && typeof record.url === "string" && (typeof record.title === "string" || record.title === null || record.title === void 0);
+}
+function readErrorCode2(error) {
+  if (typeof error !== "object" || error === null || !("code" in error)) {
+    return null;
+  }
+  const code = error.code;
+  return typeof code === "string" ? code : null;
+}
+function formatRelativePath2(cwd2, targetPath) {
+  const relativePath = path9.relative(cwd2, targetPath);
+  return relativePath.length > 0 ? relativePath : targetPath;
+}
+function logProgress(event, log) {
+  if (event.phase === "resolving-expression" || event.phase === "selecting-expressions") {
+    return;
+  }
+  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/writeTargetSpecs.ts
+function parseTargetSpec(spec) {
+  const trimmed = spec.trim();
+  if (!trimmed) {
+    throw new ReportedError("Target spec cannot be empty. Use <content-type=count>.");
+  }
+  const [rawType, rawCount] = trimmed.split("=");
+  if (!rawType || !rawCount) {
+    throw new ReportedError(`Invalid target "${spec}". Use format content-type=count, e.g. article=1 or x-thread=3.`);
+  }
+  const contentType = rawType.trim();
+  if (!contentTypeValues.includes(contentType)) {
+    throw new ReportedError(
+      `Unsupported content type "${contentType}". Supported values: ${contentTypeValues.join(", ")}.`
+    );
+  }
+  const count = Number.parseInt(rawCount.trim(), 10);
+  if (!Number.isFinite(count) || count <= 0) {
+    throw new ReportedError(`Invalid count in target "${spec}". Count must be a positive integer.`);
+  }
+  return {
+    contentType,
+    count
+  };
+}
+function parsePrimaryAndSecondarySpecs(options) {
+  const { primarySpec, secondarySpecs } = options;
+  if (!primarySpec && (!secondarySpecs || secondarySpecs.length === 0)) {
+    return void 0;
+  }
+  if (!primarySpec) {
+    throw new ReportedError("Missing required --primary <content-type=count>.");
+  }
+  const primary = parseTargetSpec(primarySpec);
+  if (primary.count !== 1) {
+    throw new ReportedError("Primary target count must be exactly 1. Use --primary <content-type=1>.");
+  }
+  const secondaryDedupedByType = /* @__PURE__ */ new Map();
+  for (const spec of secondarySpecs ?? []) {
+    const parsed = parseTargetSpec(spec);
+    if (parsed.contentType === primary.contentType) {
+      throw new ReportedError(
+        `Content type "${parsed.contentType}" cannot be both primary and secondary in the same run.`
+      );
+    }
+    const previous = secondaryDedupedByType.get(parsed.contentType);
+    if (previous) {
+      previous.count += parsed.count;
+      continue;
+    }
+    secondaryDedupedByType.set(parsed.contentType, {
+      ...parsed,
+      role: "secondary"
+    });
+  }
+  return [
+    {
+      ...primary,
+      role: "primary"
+    },
+    ...secondaryDedupedByType.values()
+  ];
+}
+
 // src/integrations/mcp/server.ts
 async function startIdeonMcpServer() {
   const server = new McpServer({
@@ -6051,6 +6404,7 @@ async function startIdeonMcpServer() {
           audience: input.audience,
           jobPath: input.jobPath,
           style: input.style,
+          intent: input.intent,
           targetLength: input.length,
           contentTargets: parsedTargets
         });
@@ -6058,7 +6412,10 @@ async function startIdeonMcpServer() {
           workingDir: cwd(),
           runMode: "fresh",
           dryRun: input.dryRun ?? false,
-          enrichLinks: input.enrichLinks ?? true
+          enrichLinks: input.enrichLinks ?? false,
+          customLinks: input.link,
+          unlinks: input.unlink,
+          maxLinks: input.maxLinks
         });
         return {
           content: [
@@ -6114,7 +6471,10 @@ async function startIdeonMcpServer() {
           workingDir: cwd(),
           runMode: "resume",
           dryRun: input.dryRun ?? false,
-          enrichLinks: input.enrichLinks ?? true
+          enrichLinks: input.enrichLinks ?? false,
+          customLinks: input.link,
+          unlinks: input.unlink,
+          maxLinks: input.maxLinks
         });
         return {
           content: [
@@ -6173,6 +6533,48 @@ async function startIdeonMcpServer() {
       }
     }
   );
+  server.registerTool(
+    "ideon_links",
+    {
+      title: "Ideon Links",
+      description: "Run link enrichment for a previously generated article by slug.",
+      inputSchema: linksToolInputSchema
+    },
+    async (input) => {
+      try {
+        const messages = [];
+        await runLinksCommand(
+          {
+            slug: input.slug,
+            mode: input.mode ?? "fresh",
+            links: input.link,
+            unlinks: input.unlink,
+            maxLinks: input.maxLinks
+          },
+          {
+            cwd: cwd(),
+            log: (message) => {
+              messages.push(message);
+            }
+          }
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: messages.length > 0 ? messages.join("\n") : `Enriched links for ${input.slug}.`
+            }
+          ],
+          structuredContent: {
+            slug: input.slug,
+            mode: input.mode ?? "fresh"
+          }
+        };
+      } catch (error) {
+        return formatToolError(error);
+      }
+    }
+  );
   server.registerTool(
     "ideon_config_get",
     {
@@ -6234,6 +6636,60 @@ async function startIdeonMcpServer() {
       }
     }
   );
+  server.registerTool(
+    "ideon_config_list",
+    {
+      title: "Ideon Config List",
+      description: "List current settings and secret availability flags.",
+      inputSchema: configListToolInputSchema
+    },
+    async (_input) => {
+      try {
+        const result = await configList();
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(result, null, 2)
+            }
+          ],
+          structuredContent: result
+        };
+      } catch (error) {
+        return formatToolError(error);
+      }
+    }
+  );
+  server.registerTool(
+    "ideon_config_unset",
+    {
+      title: "Ideon Config Unset",
+      description: "Reset a setting to its default or delete a stored secret.",
+      inputSchema: configUnsetToolInputSchema
+    },
+    async (input) => {
+      try {
+        if (!isConfigKey(input.key)) {
+          throw new ReportedError(`Unsupported config key: ${input.key}`);
+        }
+        await configUnset(input.key);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Unset ${input.key}.`
+            }
+          ],
+          structuredContent: {
+            key: input.key,
+            updated: true
+          }
+        };
+      } catch (error) {
+        return formatToolError(error);
+      }
+    }
+  );
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
@@ -6250,229 +6706,6 @@ async function runMcpServeCommand() {
   await startIdeonMcpServer();
 }
 
-// src/cli/commands/links.ts
-import { readFile as readFile6, stat as stat3 } from "fs/promises";
-import path9 from "path";
-async function runLinksCommand(options, dependencies = {}) {
-  const slug = normalizeSlug2(options.slug);
-  const mode = normalizeMode(options.mode);
-  const cwd2 = dependencies.cwd ?? process.cwd();
-  const log = dependencies.log ?? ((message) => console.log(message));
-  const resolved = await resolveRunInput({
-    idea: `Enrich links for ${slug}`
-  });
-  const markdownPath = await resolveMarkdownPathForSlug2(resolved.config.settings, slug, cwd2);
-  const frontmatter = await readFrontmatter(markdownPath);
-  const fileId = path9.parse(markdownPath).name;
-  const articleTitle = frontmatter.title ?? toTitleFromSlug(slug);
-  const articleDescription = frontmatter.description ?? "";
-  const openRouterApiKey = resolved.config.secrets.openRouterApiKey;
-  if (!openRouterApiKey) {
-    throw new ReportedError(
-      "Missing OpenRouter API key. Run `ideon settings` to configure credentials or set IDEON_OPENROUTER_API_KEY."
-    );
-  }
-  const openRouter = new OpenRouterClient(openRouterApiKey);
-  const linksResult = await enrichLinks({
-    markdownFiles: [{ markdownPath, fileId, contentType: "article" }],
-    articleTitle,
-    articleDescription,
-    openRouter,
-    settings: resolved.config.settings,
-    dryRun: false,
-    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));
-  await writeLinksFile(markdownPath, {
-    version: 1,
-    links: mergedLinks
-  });
-  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}).`);
-    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}).`);
-}
-function normalizeMode(rawMode) {
-  const normalized = rawMode.trim().toLowerCase();
-  if (normalized === "fresh" || normalized === "append") {
-    return normalized;
-  }
-  throw new ReportedError(`Unsupported --mode value "${rawMode}". Use "fresh" or "append".`);
-}
-function normalizeSlug2(rawSlug) {
-  const slug = rawSlug.trim();
-  if (!slug) {
-    throw new ReportedError("Slug cannot be empty. Pass the generated article slug, for example `ideon links my-article-slug`.");
-  }
-  if (slug.toLowerCase().endsWith(".md")) {
-    throw new ReportedError(`Expected a slug, not a markdown filename: ${slug}. Pass the slug without .md.`);
-  }
-  if (slug === "." || slug === ".." || /[/\\]/.test(slug)) {
-    throw new ReportedError(`Invalid slug "${slug}". Pass the article slug only, without any path separators.`);
-  }
-  return slug;
-}
-async function resolveMarkdownPathForSlug2(settings, slug, cwd2) {
-  const outputPaths = resolveOutputPaths(settings, cwd2);
-  const directPath = path9.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`) {
-      matches.push(candidate);
-      continue;
-    }
-    const frontmatter = await readFrontmatter(candidate);
-    if (frontmatter.slug === slug) {
-      matches.push(candidate);
-    }
-  }
-  if (matches.length === 0) {
-    throw new ReportedError(
-      `Could not find article "${slug}". Expected a markdown file in ${outputPaths.markdownOutputDir} with frontmatter slug "${slug}".`
-    );
-  }
-  return newestPath(matches);
-}
-async function newestPath(paths) {
-  let latestPath = paths[0];
-  let latestMtime = 0;
-  for (const candidate of paths) {
-    const candidateStat = await stat3(candidate);
-    if (candidateStat.mtimeMs >= latestMtime) {
-      latestMtime = candidateStat.mtimeMs;
-      latestPath = candidate;
-    }
-  }
-  return latestPath;
-}
-async function readFrontmatter(markdownPath) {
-  const markdown = await readFile6(markdownPath, "utf8");
-  return parseFrontmatter(markdown);
-}
-function parseFrontmatter(markdown) {
-  if (!markdown.startsWith("---\n")) {
-    return { slug: null, title: null, description: null };
-  }
-  const frontmatterEnd = markdown.indexOf("\n---\n", 4);
-  if (frontmatterEnd < 0) {
-    return { slug: null, title: null, description: null };
-  }
-  const block = markdown.slice(4, frontmatterEnd);
-  return {
-    slug: parseFrontmatterValue(block, "slug"),
-    title: parseFrontmatterValue(block, "title"),
-    description: parseFrontmatterValue(block, "description")
-  };
-}
-function parseFrontmatterValue(block, key) {
-  const pattern = new RegExp(`^${key}:\\s*(.+)$`, "m");
-  const match = block.match(pattern);
-  if (!match || !match[1]) {
-    return null;
-  }
-  const rawValue = match[1].trim();
-  if (!rawValue) {
-    return null;
-  }
-  if (rawValue.startsWith('"') && rawValue.endsWith('"') || rawValue.startsWith("'") && rawValue.endsWith("'")) {
-    return rawValue.slice(1, -1);
-  }
-  return rawValue;
-}
-function toTitleFromSlug(slug) {
-  return slug.split("-").filter((part) => part.length > 0).map((part) => `${part[0]?.toUpperCase() ?? ""}${part.slice(1)}`).join(" ");
-}
-async function isReadableFile(filePath) {
-  try {
-    const fileStat = await stat3(filePath);
-    return fileStat.isFile();
-  } catch {
-    return false;
-  }
-}
-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 ReportedError(`Invalid links sidecar format at ${linksPath}. Expected { version, links[] }.`);
-    }
-    return {
-      version: typeof parsed.version === "number" ? parsed.version : 1,
-      links
-    };
-  } catch (error) {
-    if (readErrorCode2(error) === "ENOENT") {
-      return null;
-    }
-    if (error instanceof ReportedError) {
-      throw error;
-    }
-    const message = error instanceof Error ? error.message : "Unknown links sidecar read error.";
-    throw new ReportedError(`Failed to read existing links from ${linksPath}: ${message}`);
-  }
-}
-function mergeLinks(existingLinks, generatedLinks) {
-  const merged = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const entry of [...existingLinks, ...generatedLinks]) {
-    const key = `${entry.expression.trim().toLowerCase()}::${entry.url.trim().toLowerCase()}`;
-    if (seen.has(key)) {
-      continue;
-    }
-    seen.add(key);
-    merged.push(entry);
-  }
-  return merged;
-}
-function isValidLinkEntry(value2) {
-  if (typeof value2 !== "object" || value2 === null) {
-    return false;
-  }
-  const record = value2;
-  return typeof record.expression === "string" && typeof record.url === "string" && (typeof record.title === "string" || record.title === null || record.title === void 0);
-}
-function readErrorCode2(error) {
-  if (typeof error !== "object" || error === null || !("code" in error)) {
-    return null;
-  }
-  const code = error.code;
-  return typeof code === "string" ? code : null;
-}
-function formatRelativePath2(cwd2, targetPath) {
-  const relativePath = path9.relative(cwd2, targetPath);
-  return relativePath.length > 0 ? relativePath : targetPath;
-}
-function logProgress(event, log) {
-  if (event.phase === "resolving-expression" || event.phase === "selecting-expressions") {
-    return;
-  }
-  log(event.detail);
-}
-
 // src/cli/commands/settings.tsx
 import { render } from "ink";
 
@@ -6852,7 +7085,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 +7094,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 +7103,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 +7861,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 +7900,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 +7939,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 +7977,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 +8496,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 +8681,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 +9782,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 +9796,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 +10157,9 @@ function WriteApp({
   dryRun,
   enrichLinks: enrichLinks2,
   runMode,
+  links,
+  unlinks,
+  maxLinks,
   onError
 }) {
   const { exit } = useApp3();
@@ -9977,6 +10183,9 @@ function WriteApp({
           dryRun,
           enrichLinks: enrichLinks2,
           runMode,
+          customLinks: links,
+          unlinks,
+          maxLinks,
           onUpdate(nextStages) {
             if (mounted) {
               setStages(nextStages);
@@ -10009,7 +10218,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 +10234,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 +10256,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 +10292,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 +10304,9 @@ async function runWritePipeline(input, dryRun, enrichLinks2, runMode, noInteract
           dryRun,
           enrichLinks: enrichLinks2,
           runMode,
+          links,
+          unlinks,
+          maxLinks,
           onError: (error) => {
             commandError = error;
           }
@@ -10298,10 +10510,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 +10527,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 +10539,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);