From c1cd83784502da0de16a2a72f7d3b77c3cfe5491 Mon Sep 17 00:00:00 2001
From: Ricardo <rick@rmendes.net>
Date: Tue, 24 Feb 2026 20:46:23 +0100
Subject: [PATCH] fix: move markdown-agents generation from pagination template
 to eleventy.after hook

Eleventy 3.x's async internals crash when pagination templates access
collection item properties, triggering the frontMatter getter. Replace
the article-markdown.njk pagination template with post-build file
generation using gray-matter to read source files directly.
---
 article-markdown.njk | 37 -----------------------------
 eleventy.config.js   | 56 +++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 55 insertions(+), 38 deletions(-)
 delete mode 100644 article-markdown.njk

diff --git a/article-markdown.njk b/article-markdown.njk
deleted file mode 100644
index 43a1974..0000000
--- a/article-markdown.njk
+++ /dev/null
@@ -1,37 +0,0 @@
----js
-{
-  pagination: {
-    data: "collections.articles",
-    size: 1,
-    alias: "article"
-  },
-  permalink: function(data) {
-    if (!data.site.markdownAgents.enabled) return false;
-    return data.article.url + "index.md";
-  },
-  eleventyExcludeFromCollections: true
-}
----
-{%- set bodyContent = article.inputPath | rawMarkdownBody -%}
-{%- set tokens = (bodyContent.length / 4) | round(0, "ceil") -%}
----
-title: "{{ article.data.title | replace('"', '\\"') }}"
-date: {{ article.date.toISOString() }}
-author: {{ site.author.name }}
-url: {{ site.url }}{{ article.url }}
-{%- if article.data.category %}
-categories:
-{%- for cat in article.data.category %}
-  - {{ cat }}
-{%- endfor %}
-{%- endif %}
-{%- if article.data.description %}
-description: "{{ article.data.description | replace('"', '\\"') }}"
-{%- endif %}
-tokens: {{ tokens }}
-content_signal: ai-train={{ site.markdownAgents.aiTrain }}, search={{ site.markdownAgents.search }}, ai-input={{ site.markdownAgents.aiInput }}
----
-
-# {{ article.data.title }}
-
-{{ bodyContent }}
diff --git a/eleventy.config.js b/eleventy.config.js
index 504e300..7108c90 100644
--- a/eleventy.config.js
+++ b/eleventy.config.js
@@ -11,7 +11,7 @@ import registerUnfurlShortcode, { getCachedCard, prefetchUrl } from "./lib/unfur
 import matter from "gray-matter";
 import { createHash } from "crypto";
 import { execFileSync } from "child_process";
-import { readFileSync, readdirSync, existsSync } from "fs";
+import { readFileSync, readdirSync, existsSync, mkdirSync, writeFileSync } from "fs";
 import { resolve, dirname } from "path";
 import { fileURLToPath } from "url";
 
@@ -796,6 +796,60 @@ export default function (eleventyConfig) {
   // so we cannot use the incremental flag to guard pagefind. Use a one-shot flag instead.
   let pagefindDone = false;
   eleventyConfig.on("eleventy.after", async ({ dir, directories, runMode, incremental }) => {
+    // Markdown for Agents — generate index.md alongside index.html for articles
+    const mdEnabled = (process.env.MARKDOWN_AGENTS_ENABLED || "true").toLowerCase() === "true";
+    if (mdEnabled && !incremental) {
+      const outputDir = directories?.output || dir.output;
+      const contentDir = resolve(__dirname, "content/articles");
+      const aiTrain = process.env.MARKDOWN_AGENTS_AI_TRAIN || "yes";
+      const search = process.env.MARKDOWN_AGENTS_SEARCH || "yes";
+      const aiInput = process.env.MARKDOWN_AGENTS_AI_INPUT || "yes";
+      const authorName = process.env.AUTHOR_NAME || "Blog Author";
+      let mdCount = 0;
+      try {
+        const files = readdirSync(contentDir).filter(f => f.endsWith(".md"));
+        for (const file of files) {
+          const src = readFileSync(resolve(contentDir, file), "utf-8");
+          const { data: fm, content: body } = matter(src);
+          if (!fm || fm.draft) continue;
+          // Derive the output path from the article's permalink or url
+          const articleUrl = fm.permalink || fm.url;
+          if (!articleUrl || !articleUrl.startsWith("/articles/")) continue;
+          const mdDir = resolve(outputDir, articleUrl.replace(/^\//, "").replace(/\/$/, ""));
+          const mdPath = resolve(mdDir, "index.md");
+          const trimmedBody = body.trim();
+          const tokens = Math.ceil(trimmedBody.length / 4);
+          const title = (fm.title || "").replace(/"/g, '\\"');
+          const date = fm.date ? new Date(fm.date).toISOString() : fm.published || "";
+          let frontLines = [
+            "---",
+            `title: "${title}"`,
+            `date: ${date}`,
+            `author: ${authorName}`,
+            `url: ${siteUrl}${articleUrl}`,
+          ];
+          if (fm.category && Array.isArray(fm.category) && fm.category.length > 0) {
+            frontLines.push("categories:");
+            for (const cat of fm.category) {
+              frontLines.push(`  - ${cat}`);
+            }
+          }
+          if (fm.description) {
+            frontLines.push(`description: "${fm.description.replace(/"/g, '\\"')}"`);
+          }
+          frontLines.push(`tokens: ${tokens}`);
+          frontLines.push(`content_signal: ai-train=${aiTrain}, search=${search}, ai-input=${aiInput}`);
+          frontLines.push("---");
+          mkdirSync(mdDir, { recursive: true });
+          writeFileSync(mdPath, frontLines.join("\n") + "\n\n# " + (fm.title || "") + "\n\n" + trimmedBody + "\n");
+          mdCount++;
+        }
+        console.log(`[markdown-agents] Generated ${mdCount} article .md files`);
+      } catch (err) {
+        console.error("[markdown-agents] Error generating .md files:", err.message);
+      }
+    }
+
     // Pagefind indexing — run exactly once per process lifetime
     if (!pagefindDone) {
       pagefindDone = true;