@telepat/ideon 0.1.19 → 0.1.20

package/dist/ideon.js

@@ -1362,7 +1362,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 // package.json
 var package_default = {
   name: "@telepat/ideon",
-  version: "0.1.19",
+  version: "0.1.20",
   description: "CLI for generating rich articles and images from ideas.",
   type: "module",
   repository: {
@@ -2284,9 +2284,10 @@ function buildArticlePlanJsonSchema(targetLengthWords) {
         items: {
           type: "object",
           additionalProperties: false,
-          required: ["description"],
+          required: ["description", "anchorAfterSection"],
           properties: {
-            description: { type: "string" }
+            description: { type: "string" },
+            anchorAfterSection: { type: "number", minimum: 1 }
           }
         }
       }
@@ -2323,8 +2324,9 @@ function buildArticlePlanMessages(idea, options) {
         "- Each section description should name the mechanism, evidence type, or practical action that makes the section useful.",
         "- Sections are article-only structure and must not be treated as requirements for non-article channels.",
         "- Include a cover image description and 2 to 3 inline image descriptions.",
+        "- Each inline image must specify which section it follows (anchorAfterSection, 1-based index). Choose sections where visual reinforcement adds the most value.",
+        "- 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.",
-        "- Do not include section placement for inline images \u2014 placement is determined automatically after writing.",
         "",
         "Shared content brief context:",
         `- description: ${options.contentBrief.description}`,
@@ -2343,7 +2345,7 @@ function buildArticlePlanMessages(idea, options) {
         "- outroBrief: string",
         `- sections: array of ${sectionCounts.label} objects, each with title and description strings`,
         "- coverImageDescription: string",
-        "- inlineImages: array of 2 to 3 objects, each with a description string only",
+        "- inlineImages: array of 2 to 3 objects, each with a description string and an anchorAfterSection number (1-based section index)",
         "",
         "Do not omit any required fields. Return strict JSON only."
       ].join("\n")
@@ -2358,7 +2360,8 @@ var articleSectionPlanSchema = z5.object({
   description: z5.string().min(1)
 });
 var inlineImagePlanSchema = z5.object({
-  description: z5.string().min(1)
+  description: z5.string().min(1),
+  anchorAfterSection: z5.number().int().min(1)
 });
 var articlePlanSchema = z5.object({
   title: z5.string().min(1),
@@ -2409,11 +2412,15 @@ async function planArticle({
   });
   const normalizedSlug = slugify(basePlan.slug || basePlan.title);
   const uniqueSlug = await resolveUniqueSlug(markdownOutputDir, normalizedSlug);
+  const sectionCount = basePlan.sections.length;
   return {
     ...basePlan,
     slug: uniqueSlug,
     keywords: basePlan.keywords.slice(0, 8),
-    inlineImages: basePlan.inlineImages.slice(0, 3)
+    inlineImages: basePlan.inlineImages.slice(0, 3).map((img) => ({
+      ...img,
+      anchorAfterSection: Math.max(1, Math.min(sectionCount, img.anchorAfterSection))
+    }))
   };
 }
 function buildDryRunPlan(idea, contentBrief) {
@@ -2451,10 +2458,12 @@ function buildDryRunPlan(idea, contentBrief) {
     coverImageDescription: "A refined editorial workspace with notebooks, sketches, and glowing structured outlines, cinematic but minimal.",
     inlineImages: [
       {
-        description: "A rough idea evolving into a structured article outline on a desk full of notes."
+        description: "A rough idea evolving into a structured article outline on a desk full of notes.",
+        anchorAfterSection: 2
       },
       {
-        description: "A collaborative editorial scene where human judgment and AI suggestions coexist."
+        description: "A collaborative editorial scene where human judgment and AI suggestions coexist.",
+        anchorAfterSection: 4
       }
     ]
   };
@@ -2956,24 +2965,8 @@ function sumKnownCosts(values) {
 
 // src/images/renderImages.ts
 var MIN_IMAGE_BYTES = 1024;
-function selectImageSlots(plan, sections, options) {
+function buildImageSlots(plan, sections, options) {
   const sectionCount = sections.length;
-  let defaultInlineCount;
-  if (sectionCount <= 3) {
-    defaultInlineCount = 0;
-  } else if (sectionCount <= 6) {
-    defaultInlineCount = 1;
-  } else {
-    defaultInlineCount = 2;
-  }
-  const availableInlineCount = Math.min(defaultInlineCount, plan.inlineImages.length, sectionCount);
-  let inlineCount;
-  const maxImages = options?.maxImages;
-  if (maxImages !== void 0 && maxImages >= 1) {
-    inlineCount = Math.min(availableInlineCount, Math.max(0, maxImages - 1));
-  } else {
-    inlineCount = availableInlineCount;
-  }
   const slots = [
     {
       id: "cover",
@@ -2983,17 +2976,22 @@ function selectImageSlots(plan, sections, options) {
       anchorAfterSection: null
     }
   ];
+  let inlineCount = plan.inlineImages.length;
+  const maxImages = options?.maxImages;
+  if (maxImages !== void 0 && maxImages >= 1) {
+    inlineCount = Math.min(inlineCount, Math.max(0, maxImages - 1));
+  }
   for (let i = 0; i < inlineCount; i++) {
-    const anchorAfterSection = Math.max(
-      1,
-      Math.min(sectionCount, Math.round((i + 1) / (inlineCount + 1) * sectionCount))
-    );
+    const img = plan.inlineImages[i];
+    if (!img) {
+      continue;
+    }
     slots.push({
       id: `inline-${i + 1}`,
       kind: "inline",
       prompt: "",
-      description: plan.inlineImages[i]?.description ?? "",
-      anchorAfterSection
+      description: img.description,
+      anchorAfterSection: Math.max(1, Math.min(sectionCount, img.anchorAfterSection))
     });
   }
   return slots;
@@ -3760,7 +3758,8 @@ var pipelineArtifactSummarySchema = z6.object({
   markdownPath: z6.string().min(1),
   assetDir: z6.string().min(1),
   analyticsPath: z6.string().min(1).default("unknown.analytics.json"),
-  interactionsPath: z6.string().min(1).default("unknown.interactions.json")
+  interactionsPath: z6.string().min(1).default("unknown.interactions.json"),
+  planPath: z6.string().min(1).nullable().default(null)
 });
 var resolvedPathsSchema = z6.object({
   markdownOutputDir: z6.string().min(1),
@@ -4282,7 +4281,7 @@ async function runPipelineShell(input, options = {}) {
         options.onUpdate?.(cloneStages(stages));
       } else {
         imagePrompts = await expandImagePrompts({
-          slots: selectImageSlots(plan, text.sections, { maxImages: options.maxImages }),
+          slots: buildImageSlots(plan, text.sections, { maxImages: options.maxImages }),
           planContext: plan,
           sections: text.sections,
           settings: input.config.settings,
@@ -4445,6 +4444,10 @@ async function runPipelineShell(input, options = {}) {
         sourceJob: input.job
       })
     );
+    const planPath = plan ? path8.join(generationDir, "plan.md") : null;
+    if (plan && planPath) {
+      await writeUtf8File(planPath, renderPlanMarkdown(plan));
+    }
     const primaryFilePrefix = toFilePrefix(primaryTarget.contentType);
     const primaryMarkdownPath = path8.join(generationDir, `${primaryFilePrefix}-1.md`);
     const sharedAssetDir = generationDir;
@@ -4962,7 +4965,8 @@ async function runPipelineShell(input, options = {}) {
       markdownPath: primaryMarkdownPathForArtifact,
       assetDir: sharedAssetDir,
       analyticsPath,
-      interactionsPath
+      interactionsPath,
+      planPath
     };
     writeSession = await patchWriteSession(
       {
@@ -5344,6 +5348,45 @@ function buildRunJobDefinition(input) {
     }
   };
 }
+function renderPlanMarkdown(plan) {
+  const yamlKeywords = plan.keywords.map((kw) => `  - "${kw}"`).join("\n");
+  const sectionsRows = plan.sections.map((section, index) => `| ${index + 1} | ${section.title} | ${section.description} |`).join("\n");
+  const inlineImageRows = plan.inlineImages.map((img, index) => `| Inline ${index + 1} | ${img.description} |`).join("\n");
+  const imageRows = `| Cover | ${plan.coverImageDescription} |
+${inlineImageRows}`;
+  return `---
+title: "${plan.title.replace(/"/g, '\\"')}"
+subtitle: "${plan.subtitle.replace(/"/g, '\\"')}"
+slug: "${plan.slug}"
+keywords:
+${yamlKeywords}
+---
+
+## Description
+
+${plan.description}
+
+## Introduction Brief
+
+${plan.introBrief}
+
+## Sections
+
+| # | Title | Description |
+|---|-------|-------------|
+${sectionsRows}
+
+## Outro Brief
+
+${plan.outroBrief}
+
+## Image Plan
+
+| Type | Description |
+|------|-------------|
+${imageRows}
+`;
+}
 function asWriteStageId(stageId) {
   if (stageId === "shared-brief" || stageId === "planning" || stageId === "sections" || stageId === "image-prompts" || stageId === "images" || stageId === "output" || stageId === "links") {
     return stageId;

package/package.json

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