@telepat/ideon 0.1.25 → 0.1.27

package/dist/ideon.js

@@ -12,7 +12,8 @@ import { access, mkdir, writeFile } from "fs/promises";
 import os from "os";
 import path from "path";
 function resolveOutputPaths() {
-  const base = path.join(os.homedir(), ".ideon", "output");
+  const ideonHome = process.env.IDEON_HOME || os.homedir();
+  const base = path.join(ideonHome, ".ideon", "output");
   return {
     markdownOutputDir: base,
     assetOutputDir: path.join(base, "assets")
@@ -1423,7 +1424,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 // package.json
 var package_default = {
   name: "@telepat/ideon",
-  version: "0.1.25",
+  version: "0.1.27",
   description: "CLI for generating rich articles and images from ideas.",
   type: "module",
   repository: {
@@ -1623,7 +1624,7 @@ function assertNoLegacyXMode(contentTargets, sourceLabel) {
 }
 
 // src/pipeline/runner.ts
-import { mkdir as mkdir6, stat as stat2 } from "fs/promises";
+import { mkdir as mkdir6, readFile as readFile6, stat as stat2 } from "fs/promises";
 import { randomUUID } from "crypto";
 import path9 from "path";
 
@@ -2380,7 +2381,7 @@ function buildLongFormPlanJsonSchema(targetLengthWords) {
           required: ["description", "anchorAfterSection"],
           properties: {
             description: { type: "string" },
-            anchorAfterSection: { type: "number", minimum: 2 }
+            anchorAfterSection: { type: "number", minimum: 1 }
           }
         }
       }
@@ -2446,7 +2447,7 @@ function buildLongFormPlanMessages(idea, options) {
         "- Each section description should name the mechanism, evidence type, or practical action that makes the section useful.",
         "- Sections are primary-only structure and must not be treated as requirements for non-primary channels.",
         `- Include a cover image description and ${imageCounts.min} to ${imageCounts.max} inline image descriptions.`,
-        "- Each inline image must specify which section it follows (anchorAfterSection, 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.",
+        "- Each inline image must specify which section it follows (anchorAfterSection, starting at 1). Choose sections where visual reinforcement adds the most value.",
         "- Image descriptions should capture the general concept and mood \u2014 the exact text-to-image prompt will be refined later using the actual section content.",
         "- Image descriptions must be concrete and contextual, not generic stock-photo phrasing.",
         "",
@@ -2468,7 +2469,7 @@ function buildLongFormPlanMessages(idea, options) {
         "- outroBrief: string",
         `- sections: array of ${sectionCounts.label} objects, each with title and description strings`,
         "- coverImageDescription: string",
-        `- inlineImages: array of ${imageCounts.min} to ${imageCounts.max} objects, each with a description string and an anchorAfterSection number (starting at 2, since the cover image already appears near the title)`,
+        `- inlineImages: array of ${imageCounts.min} to ${imageCounts.max} objects, each with a description string and an anchorAfterSection number (starting at 1).`,
         "",
         "Do not omit any required fields. Return strict JSON only."
       ].join("\n")
@@ -2530,7 +2531,7 @@ var articleSectionPlanSchema = z5.object({
 });
 var inlineImagePlanSchema = z5.object({
   description: z5.string().min(1),
-  anchorAfterSection: z5.number().int().min(2)
+  anchorAfterSection: z5.number().int().min(1)
 });
 var primaryPlanSchema = z5.object({
   contentType: z5.string().min(1).default("article"),
@@ -2619,7 +2620,7 @@ async function planPrimaryContent({
       keywords: longPlan.keywords.slice(0, 8),
       inlineImages: longPlan.inlineImages.slice(0, 3).map((img) => ({
         ...img,
-        anchorAfterSection: Math.max(2, Math.min(sectionCount, img.anchorAfterSection))
+        anchorAfterSection: Math.max(1, Math.min(sectionCount, img.anchorAfterSection))
       }))
     };
   }
@@ -3276,7 +3277,7 @@ function buildImageSlots(plan, sections, options) {
       kind: "inline",
       prompt: "",
       description: img.description,
-      anchorAfterSection: Math.max(2, Math.min(sectionCount, img.anchorAfterSection))
+      anchorAfterSection: Math.max(1, Math.min(sectionCount, img.anchorAfterSection))
     });
   }
   return slots;
@@ -5137,15 +5138,47 @@ async function runPipelineShell(input, options = {}) {
     markStageStarted(stageTracking, "links");
     options.onUpdate?.(cloneStages(stages));
     if (!shouldEnrichLinks) {
-      markStageCompleted(stageTracking, "links");
-      stages[6] = {
-        ...stages[6],
-        status: "succeeded",
-        detail: "Skipped link enrichment (enable with --enrich-links).",
-        summary: "Link enrichment disabled for this run",
-        stageAnalytics: snapshotStageAnalytics(stageTracking, "links")
-      };
-      options.onUpdate?.(cloneStages(stages));
+      const customLinkActions = pipelineCustomLinkRaws.length > 0 || pipelineUnlinks.length > 0;
+      if (customLinkActions && eligibleOutputsForLinks.length > 0) {
+        for (const output of eligibleOutputsForLinks) {
+          const existingLinks = await readExistingLinks(resolveLinksPath(output.markdownPath));
+          const mergedCustomLinks = resolvePipelineCustomLinks(
+            existingLinks?.customLinks ?? [],
+            pipelineCustomLinkRaws,
+            pipelineUnlinks
+          );
+          const generatedLinks = existingLinks?.links ?? [];
+          await writeLinksFile(output.markdownPath, {
+            version: 2,
+            customLinks: mergedCustomLinks,
+            links: generatedLinks
+          });
+        }
+        markStageCompleted(stageTracking, "links");
+        stages[6] = {
+          ...stages[6],
+          status: "succeeded",
+          detail: "Updated custom links without generating new links.",
+          summary: `${eligibleOutputsForLinks.length} files updated`,
+          items: (stages[6].items ?? []).map((stageItem) => ({
+            ...stageItem,
+            status: "succeeded",
+            detail: "Saved custom links sidecar."
+          })),
+          stageAnalytics: snapshotStageAnalytics(stageTracking, "links")
+        };
+        options.onUpdate?.(cloneStages(stages));
+      } else {
+        markStageCompleted(stageTracking, "links");
+        stages[6] = {
+          ...stages[6],
+          status: "succeeded",
+          detail: "Skipped link enrichment (enable with --enrich-links).",
+          summary: "Link enrichment disabled for this run",
+          stageAnalytics: snapshotStageAnalytics(stageTracking, "links")
+        };
+        options.onUpdate?.(cloneStages(stages));
+      }
     } else if (eligibleOutputsForLinks.length === 0) {
       markStageCompleted(stageTracking, "links");
       stages[6] = {
@@ -5803,9 +5836,61 @@ function parsePipelineCustomLinks(rawLinks, unlinks) {
   }
   return Array.from(result.values());
 }
+function resolvePipelineCustomLinks(existing, rawLinks, unlinks) {
+  const result = new Map(
+    existing.map((entry) => [entry.expression.trim().toLowerCase(), entry])
+  );
+  for (const raw of rawLinks) {
+    const separatorIndex = raw.indexOf("->");
+    if (separatorIndex < 0) {
+      continue;
+    }
+    const expression = raw.slice(0, separatorIndex).trim();
+    const url = raw.slice(separatorIndex + 2).trim();
+    if (expression && url) {
+      result.set(expression.toLowerCase(), { expression, url, title: null });
+    }
+  }
+  for (const expr of unlinks) {
+    result.delete(expr.trim().toLowerCase());
+  }
+  return Array.from(result.values());
+}
+async function readExistingLinks(linksPath) {
+  try {
+    const raw = await readFile6(linksPath, "utf8");
+    const parsed = JSON.parse(raw);
+    const links = Array.isArray(parsed.links) ? parsed.links.filter((entry) => isValidLinkEntry(entry)).map((entry) => ({
+      expression: entry.expression.trim(),
+      url: entry.url.trim(),
+      title: typeof entry.title === "string" ? entry.title : null
+    })) : null;
+    if (!links) {
+      throw new Error(`Invalid links sidecar format at ${linksPath}. Expected { version, links[] }.`);
+    }
+    const customLinks = Array.isArray(parsed.customLinks) ? parsed.customLinks.filter((entry) => isValidLinkEntry(entry)).map((entry) => ({
+      expression: entry.expression.trim(),
+      url: entry.url.trim(),
+      title: typeof entry.title === "string" ? entry.title : null
+    })) : [];
+    return {
+      version: typeof parsed.version === "number" ? parsed.version : 2,
+      customLinks,
+      links
+    };
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return null;
+    }
+    throw error;
+  }
+}
+function isValidLinkEntry(entry) {
+  return typeof entry === "object" && entry !== null && typeof entry.expression === "string" && typeof entry.url === "string";
+}
 
 // src/cli/commands/links.ts
-import { readFile as readFile6, stat as stat3 } from "fs/promises";
+import { readFile as readFile7, stat as stat3 } from "fs/promises";
 import path10 from "path";
 async function runLinksCommand(options, dependencies = {}) {
   const slug = normalizeSlug2(options.slug);
@@ -5828,7 +5913,7 @@ async function runLinksCommand(options, dependencies = {}) {
   }
   const openRouter = new OpenRouterClient(openRouterApiKey);
   const linksPath = resolveLinksPath(markdownPath);
-  const existing = await readExistingLinks(linksPath);
+  const existing = await readExistingLinks2(linksPath);
   const updatedCustomLinks = resolveCustomLinks(existing?.customLinks ?? [], options.links ?? [], options.unlinks ?? []);
   const effectiveMaxLinks = options.maxLinks;
   const linksResult = await enrichLinks({
@@ -5923,7 +6008,7 @@ async function newestPath(paths) {
   return latestPath;
 }
 async function readFrontmatter(markdownPath) {
-  const markdown = await readFile6(markdownPath, "utf8");
+  const markdown = await readFile7(markdownPath, "utf8");
   return parseFrontmatter(markdown);
 }
 function parseFrontmatter(markdown) {
@@ -5967,11 +6052,11 @@ async function isReadableFile(filePath) {
     return false;
   }
 }
-async function readExistingLinks(linksPath) {
+async function readExistingLinks2(linksPath) {
   try {
-    const raw = await readFile6(linksPath, "utf8");
+    const raw = await readFile7(linksPath, "utf8");
     const parsed = JSON.parse(raw);
-    const links = Array.isArray(parsed.links) ? parsed.links.filter((entry) => isValidLinkEntry(entry)).map((entry) => ({
+    const links = Array.isArray(parsed.links) ? parsed.links.filter((entry) => isValidLinkEntry2(entry)).map((entry) => ({
       expression: entry.expression.trim(),
       url: entry.url.trim(),
       title: typeof entry.title === "string" ? entry.title : null
@@ -5979,7 +6064,7 @@ async function readExistingLinks(linksPath) {
     if (!links) {
       throw new ReportedError(`Invalid links sidecar format at ${linksPath}. Expected { version, links[] }.`);
     }
-    const customLinks = Array.isArray(parsed.customLinks) ? parsed.customLinks.filter((entry) => isValidLinkEntry(entry)).map((entry) => ({
+    const customLinks = Array.isArray(parsed.customLinks) ? parsed.customLinks.filter((entry) => isValidLinkEntry2(entry)).map((entry) => ({
       expression: entry.expression.trim(),
       url: entry.url.trim(),
       title: typeof entry.title === "string" ? entry.title : null
@@ -6013,7 +6098,7 @@ function mergeLinks(existingLinks, generatedLinks) {
   }
   return merged;
 }
-function isValidLinkEntry(value2) {
+function isValidLinkEntry2(value2) {
   if (typeof value2 !== "object" || value2 === null) {
     return false;
   }
@@ -6067,7 +6152,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 { copyFile as copyFile2, mkdir as mkdir7, readFile as readFile9, stat as stat5, writeFile as writeFile6 } from "fs/promises";
 import path12 from "path";
 
 // src/output/enrichMarkdownWithLinks.ts
@@ -6124,7 +6209,7 @@ function escapeRegExp(value2) {
 }
 
 // src/server/previewHelpers.ts
-import { readdir, stat as stat4, readFile as readFile7 } from "fs/promises";
+import { readdir, stat as stat4, readFile as readFile8 } from "fs/promises";
 import path11 from "path";
 var DEFAULT_PORT = 4173;
 var CONTENT_TYPE_ORDER = ["article", "blog-post", "x-thread", "x-post", "linkedin-post", "reddit-post", "newsletter"];
@@ -6226,7 +6311,7 @@ function extractCoverImageUrl(markdown) {
   return match?.[1] ?? null;
 }
 async function extractArticleMetadata(markdownPath) {
-  const markdown = await readFile7(markdownPath, "utf8");
+  const markdown = await readFile8(markdownPath, "utf8");
   const fileStat = await stat4(markdownPath);
   const slug = extractFrontmatterSlug(markdown) ?? path11.basename(markdownPath, ".md");
   const title = extractHeadingTitle(stripFrontmatter2(markdown)) ?? slug;
@@ -6243,7 +6328,7 @@ async function extractArticleMetadata(markdownPath) {
 }
 async function listAllGenerations(markdownOutputDir) {
   const markdownFiles = await findMarkdownFiles(markdownOutputDir);
-  const grouped = /* @__PURE__ */ new Map();
+  const outputMap = /* @__PURE__ */ new Map();
   for (const filePath of markdownFiles) {
     try {
       const metadata = await extractArticleMetadata(filePath);
@@ -6261,15 +6346,23 @@ async function listAllGenerations(markdownOutputDir) {
         contentTypeLabel: toContentTypeLabel(identity.contentType),
         index: identity.index
       };
-      const existing = grouped.get(identity.generationId);
-      if (existing) {
-        existing.push(output);
-      } else {
-        grouped.set(identity.generationId, [output]);
+      const outputKey = `${output.generationId}:${output.contentType}:${output.index}`;
+      const existing = outputMap.get(outputKey);
+      if (!existing || output.mtime > existing.mtime) {
+        outputMap.set(outputKey, output);
       }
     } catch {
     }
   }
+  const grouped = /* @__PURE__ */ new Map();
+  for (const output of outputMap.values()) {
+    const existing = grouped.get(output.generationId);
+    if (existing) {
+      existing.push(output);
+    } else {
+      grouped.set(output.generationId, [output]);
+    }
+  }
   const generations = [];
   for (const [id, outputs] of grouped.entries()) {
     outputs.sort((a, b) => compareContentTypes(a.contentType, b.contentType) || a.index - b.index || b.mtime - a.mtime);
@@ -6375,7 +6468,7 @@ async function resolvePrimaryContentType(outputs) {
   }
   const jobPath = path11.join(generationDir, "job.json");
   try {
-    const raw = await readFile7(jobPath, "utf8");
+    const raw = await readFile8(jobPath, "utf8");
     const parsed = JSON.parse(raw);
     const targets = Array.isArray(parsed.contentTargets) ? parsed.contentTargets : Array.isArray(parsed.settings?.contentTargets) ? parsed.settings.contentTargets : [];
     const primary = targets.find((target) => target?.role === "primary" && typeof target.contentType === "string");
@@ -6416,7 +6509,7 @@ async function runOutputCommand(options, dependencies = {}) {
     );
   }
   const sourceMarkdownPath = articleOutput.sourcePath;
-  const sourceMarkdown = await readFile8(sourceMarkdownPath, "utf8");
+  const sourceMarkdown = await readFile9(sourceMarkdownPath, "utf8");
   const slug = extractFrontmatterSlug2(sourceMarkdown) ?? path12.basename(sourceMarkdownPath, ".md");
   const exportFilename = `${slug}.md`;
   const destinationDir = await resolveDestinationDir(options.destinationPath, cwd2);
@@ -6483,7 +6576,7 @@ async function loadLinks(markdownPath) {
   const linksPath = resolveLinksPath(markdownPath);
   let raw;
   try {
-    raw = await readFile8(linksPath, "utf8");
+    raw = await readFile9(linksPath, "utf8");
   } catch {
     return [];
   }
@@ -7405,7 +7498,7 @@ import { spawn } from "child_process";
 // src/server/previewServer.ts
 import { execFile } from "child_process";
 import { promisify } from "util";
-import { readFile as readFile9, stat as stat6 } from "fs/promises";
+import { readFile as readFile10, stat as stat6 } from "fs/promises";
 import { watch as fsWatch } from "fs";
 import path13 from "path";
 import { fileURLToPath } from "url";
@@ -7422,7 +7515,7 @@ async function startPreviewServer(options) {
   const app = express();
   const previewClientDir = await resolvePreviewClientBuildDir();
   app.disable("x-powered-by");
-  app.use("/assets", express.static(options.assetDir));
+  app.use("/assets", express.static(options.assetDir, { dotfiles: "allow" }));
   if (previewClientDir) {
     app.use(express.static(previewClientDir, { index: false }));
   }
@@ -7456,7 +7549,7 @@ async function startPreviewServer(options) {
       const assetPathParam = req.params.assetPath;
       const rawAssetPath = Array.isArray(assetPathParam) ? assetPathParam.join("/") : assetPathParam ?? "";
       const resolvedAssetPath = await resolveGenerationAssetPath(generationId, rawAssetPath, options.markdownOutputDir);
-      res.sendFile(resolvedAssetPath);
+      res.sendFile(resolvedAssetPath, { dotfiles: "allow" });
     } catch (error) {
       const message = error instanceof Error ? error.message : "Unknown error loading generation asset";
       const status = error instanceof MissingArticleError ? 404 : 400;
@@ -7505,7 +7598,7 @@ async function startPreviewServer(options) {
         if (options.watch) {
           let html2;
           try {
-            html2 = await readFile9(path13.join(previewClientDir, "index.html"), "utf8");
+            html2 = await readFile10(path13.join(previewClientDir, "index.html"), "utf8");
           } catch {
             res.status(200).type("html").send(
               `<!doctype html><html><head><meta charset="utf-8"><title>Rebuilding\u2026</title><style>body{margin:0;display:flex;align-items:center;justify-content:center;height:100vh;font-family:sans-serif;background:#101820;color:#e0eaf0}p{font-size:15px;opacity:.7}</style></head><body><p>Rebuilding\u2026</p><script>const s=new EventSource('/api/__reload');s.onmessage=function(){location.reload()};</script></body></html>`
@@ -7569,7 +7662,7 @@ async function getArticleContent(generationId, markdownOutputDir) {
     generation.outputs.map(async (output) => {
       let markdown = "";
       try {
-        markdown = await readFile9(output.sourcePath, "utf8");
+        markdown = await readFile10(output.sourcePath, "utf8");
       } catch (error) {
         if (isMissingFileError(error)) {
           throw new MissingArticleError(`Generation "${generationId}" no longer exists.`);
@@ -7633,7 +7726,7 @@ async function renderArticleHtml(markdown, generationId, sourcePath) {
 async function loadSavedLinks(markdownPath) {
   const linksPath = resolveLinksPath(markdownPath);
   try {
-    const raw = await readFile9(linksPath, "utf8");
+    const raw = await readFile10(linksPath, "utf8");
     const parsed = JSON.parse(raw);
     if (!Array.isArray(parsed.links)) {
       return [];
@@ -7659,7 +7752,7 @@ async function loadSavedLinks(markdownPath) {
 async function loadSavedInteractions(generationDir) {
   const interactionsPath = path13.join(generationDir, "model.interactions.json");
   try {
-    const raw = await readFile9(interactionsPath, "utf8");
+    const raw = await readFile10(interactionsPath, "utf8");
     const parsed = JSON.parse(raw);
     const llmCalls = Array.isArray(parsed.llmCalls) ? parsed.llmCalls.filter(isPreviewLlmInteraction) : [];
     const t2iCalls = Array.isArray(parsed.t2iCalls) ? parsed.t2iCalls.filter(isPreviewT2IInteraction) : [];
@@ -7677,7 +7770,7 @@ async function loadSavedInteractions(generationDir) {
 async function loadSavedAnalyticsSummary(generationDir) {
   const analyticsPath = path13.join(generationDir, "generation.analytics.json");
   try {
-    const raw = await readFile9(analyticsPath, "utf8");
+    const raw = await readFile10(analyticsPath, "utf8");
     const parsed = JSON.parse(raw);
     const summary = parsed.summary;
     if (!summary || typeof summary !== "object") {
@@ -7701,7 +7794,7 @@ async function loadSavedAnalyticsSummary(generationDir) {
 async function loadSavedMetaJson(generationDir) {
   const metaJsonPath = path13.join(generationDir, "meta.json");
   try {
-    const raw = await readFile9(metaJsonPath, "utf8");
+    const raw = await readFile10(metaJsonPath, "utf8");
     return JSON.parse(raw);
   } catch {
     return null;