Files
indiekit-server/scripts/patch-preset-eleventy-ai-frontmatter.mjs
svemagie 5f4d8ca5e8 fix: detect article/note post type via permalink for AI frontmatter
Indiekit's getPostTemplateProperties() explicitly removes the post-type
property before passing JF2 to postTemplate(). The v3 patch relied on
post-type to set supportsAiDisclosure, which was therefore always false —
causing the ai: frontmatter block to never be written regardless of what
was selected in the backend form.

v4 patch falls back to permalink URL pattern (/articles/, /notes/) to
correctly detect the post type when post-type is absent.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-12 08:11:28 +01:00

423 lines
15 KiB
JavaScript

import { access, readFile, writeFile } from "node:fs/promises";
const candidates = [
"node_modules/@rmdes/indiekit-preset-eleventy/lib/post-template.js",
"node_modules/@indiekit/preset-eleventy/lib/post-template.js",
"node_modules/@indiekit/indiekit/node_modules/@rmdes/indiekit-preset-eleventy/lib/post-template.js",
"node_modules/@indiekit/indiekit/node_modules/@indiekit/preset-eleventy/lib/post-template.js",
];
const patchMarker =
"Indiekit removes post-type before calling postTemplate; fall back to permalink-based detection.";
const upstreamBlock = [
" // Convert url to Eleventy permalink so generated URL matches Indiekit's stored URL",
" // Add trailing slash to generate /path/index.html instead of /path.html",
" if (properties.url) {",
" const url = properties.url;",
" properties.permalink = url.endsWith(\"/\") ? url : `${url}/`;",
" }",
" delete properties.url;",
"",
" const frontMatter = YAML.stringify(properties, { lineWidth: 0 });",
" return `---\\n${frontMatter}---\\n`;",
"};",
].join("\n");
const v1PatchedBlock = [
" // Convert url to Eleventy permalink so generated URL matches Indiekit's stored URL",
" // Add trailing slash to generate /path/index.html instead of /path.html",
" if (properties.url) {",
" const url = properties.url;",
" properties.permalink = url.endsWith(\"/\") ? url : `${url}/`;",
" }",
" delete properties.url;",
"",
" // Normalize AI disclosure metadata and default to no AI usage.",
" const aiSource =",
" properties.ai && typeof properties.ai === \"object\" && !Array.isArray(properties.ai)",
" ? properties.ai",
" : {};",
"",
" const aiTextLevel = String(",
" aiSource.textLevel ?? aiSource.aiTextLevel ?? properties.aiTextLevel ?? \"0\",",
" );",
"",
" const aiCodeLevel = String(",
" aiSource.codeLevel ?? aiSource.aiCodeLevel ?? properties.aiCodeLevel ?? \"0\",",
" );",
"",
" const aiTools = aiSource.aiTools ?? aiSource.tools ?? properties.aiTools;",
"",
" const aiDescription =",
" aiSource.aiDescription ?? aiSource.description ?? properties.aiDescription;",
"",
" delete properties.ai;",
" delete properties.aiTextLevel;",
" delete properties.aiCodeLevel;",
" delete properties.aiTools;",
" delete properties.aiDescription;",
"",
" const frontMatter = YAML.stringify(properties, { lineWidth: 0 });",
"",
" let aiFrontMatter = `ai:\\n textLevel: \\\"${aiTextLevel}\\\"\\n codeLevel: \\\"${aiCodeLevel}\\\"\\n # aiTools: \\\"Claude, ChatGPT, Copilot\\\"\\n # aiDescription: \\\"Optional disclosure about how AI was used\\\"\\n`;",
"",
" if (aiTools !== undefined && aiTools !== null && aiTools !== \"\") {",
" aiFrontMatter = aiFrontMatter.replace(",
" ' # aiTools: \\\"Claude, ChatGPT, Copilot\\\"\\n',",
" ` aiTools: ${JSON.stringify(String(aiTools))}\\n`,",
" );",
" }",
"",
" if (aiDescription !== undefined && aiDescription !== null && aiDescription !== \"\") {",
" aiFrontMatter = aiFrontMatter.replace(",
" ' # aiDescription: \\\"Optional disclosure about how AI was used\\\"\\n',",
" ` aiDescription: ${JSON.stringify(String(aiDescription))}\\n`,",
" );",
" }",
"",
" return `---\\n${frontMatter}${aiFrontMatter}---\\n`;",
"};",
].join("\n");
const v2PatchedBlock = [
" // Convert url to Eleventy permalink so generated URL matches Indiekit's stored URL",
" // Add trailing slash to generate /path/index.html instead of /path.html",
" if (properties.url) {",
" const url = properties.url;",
" properties.permalink = url.endsWith(\"/\") ? url : `${url}/`;",
" }",
" delete properties.url;",
"",
" // Normalize AI disclosure metadata for articles and notes only, defaulting to no AI usage.",
" const aiSource =",
" properties.ai && typeof properties.ai === \"object\" && !Array.isArray(properties.ai)",
" ? properties.ai",
" : {};",
"",
" const aiTextLevel = String(",
" aiSource.textLevel ?? aiSource.aiTextLevel ?? properties.aiTextLevel ?? \"0\",",
" );",
"",
" const aiCodeLevel = String(",
" aiSource.codeLevel ?? aiSource.aiCodeLevel ?? properties.aiCodeLevel ?? \"0\",",
" );",
"",
" const aiTools = aiSource.aiTools ?? aiSource.tools ?? properties.aiTools;",
"",
" const aiDescription =",
" aiSource.aiDescription ?? aiSource.description ?? properties.aiDescription;",
"",
" delete properties.ai;",
" delete properties.aiTextLevel;",
" delete properties.aiCodeLevel;",
" delete properties.aiTools;",
" delete properties.aiDescription;",
"",
" const postType = String(",
" properties.postType ?? properties[\"post-type\"] ?? \"\",",
" ).toLowerCase();",
" const supportsAiDisclosure = postType === \"article\" || postType === \"note\";",
"",
" const frontMatter = YAML.stringify(properties, { lineWidth: 0 });",
"",
" if (!supportsAiDisclosure) {",
" return `---\\n${frontMatter}---\\n`;",
" }",
"",
" let aiFrontMatter = `ai:\\n textLevel: \\\"${aiTextLevel}\\\"\\n codeLevel: \\\"${aiCodeLevel}\\\"\\n # aiTools: \\\"Claude, ChatGPT, Copilot\\\"\\n # aiDescription: \\\"Optional disclosure about how AI was used\\\"\\n`;",
"",
" if (aiTools !== undefined && aiTools !== null && aiTools !== \"\") {",
" aiFrontMatter = aiFrontMatter.replace(",
" ' # aiTools: \\\"Claude, ChatGPT, Copilot\\\"\\n',",
" ` aiTools: ${JSON.stringify(String(aiTools))}\\n`,",
" );",
" }",
"",
" if (aiDescription !== undefined && aiDescription !== null && aiDescription !== \"\") {",
" aiFrontMatter = aiFrontMatter.replace(",
" ' # aiDescription: \\\"Optional disclosure about how AI was used\\\"\\n',",
" ` aiDescription: ${JSON.stringify(String(aiDescription))}\\n`,",
" );",
" }",
"",
" return `---\\n${frontMatter}${aiFrontMatter}---\\n`;",
"};",
].join("\n");
const v3Block = [
" // Convert url to Eleventy permalink so generated URL matches Indiekit's stored URL",
" // Add trailing slash to generate /path/index.html instead of /path.html",
" if (properties.url) {",
" const url = properties.url;",
" properties.permalink = url.endsWith(\"/\") ? url : `${url}/`;",
" }",
" delete properties.url;",
"",
" // Normalize and sanitize AI disclosure metadata for articles and notes only.",
" const aiSource =",
" properties.ai && typeof properties.ai === \"object\" && !Array.isArray(properties.ai)",
" ? properties.ai",
" : {};",
"",
" const normaliseString = (value) => {",
" if (value === undefined || value === null) {",
" return undefined;",
" }",
"",
" const text = String(value).trim();",
" return text === \"\" ? undefined : text;",
" };",
"",
" const normaliseLevel = (value, allowedValues, fallback = \"0\") => {",
" const candidate = normaliseString(value);",
"",
" if (!candidate) {",
" return fallback;",
" }",
"",
" return allowedValues.includes(candidate) ? candidate : fallback;",
" };",
"",
" const aiTextLevelRaw =",
" aiSource.textLevel ??",
" aiSource.aiTextLevel ??",
" properties.aiTextLevel ??",
" properties[\"ai-text-level\"] ??",
" \"0\";",
"",
" const aiCodeLevelRaw =",
" aiSource.codeLevel ??",
" aiSource.aiCodeLevel ??",
" properties.aiCodeLevel ??",
" properties[\"ai-code-level\"] ??",
" \"0\";",
"",
" const aiTextLevel = normaliseLevel(aiTextLevelRaw, [\"0\", \"1\", \"2\", \"3\"]);",
" // Legacy value \"3\" is folded into \"2\" for code-level taxonomy compatibility.",
" const aiCodeLevel = normaliseLevel(",
" aiCodeLevelRaw === \"3\" ? \"2\" : aiCodeLevelRaw,",
" [\"0\", \"1\", \"2\"],",
" );",
"",
" const aiTools = normaliseString(",
" aiSource.aiTools ?? aiSource.tools ?? properties.aiTools ?? properties[\"ai-tools\"],",
" );",
"",
" const aiDescription = normaliseString(",
" aiSource.aiDescription ??",
" aiSource.description ??",
" properties.aiDescription ??",
" properties[\"ai-description\"],",
" );",
"",
" delete properties.ai;",
" delete properties.aiTextLevel;",
" delete properties.aiCodeLevel;",
" delete properties.aiTools;",
" delete properties.aiDescription;",
" delete properties[\"ai-text-level\"];",
" delete properties[\"ai-code-level\"];",
" delete properties[\"ai-tools\"];",
" delete properties[\"ai-description\"];",
"",
" const postType = String(",
" properties.postType ?? properties[\"post-type\"] ?? properties.type ?? \"\",",
" ).toLowerCase();",
" const supportsAiDisclosure = postType === \"article\" || postType === \"note\";",
"",
" const frontMatter = YAML.stringify(properties, { lineWidth: 0 });",
"",
" if (!supportsAiDisclosure) {",
" return `---\\n${frontMatter}---\\n`;",
" }",
"",
" let aiFrontMatter = `ai:\\n textLevel: \\\"${aiTextLevel}\\\"\\n codeLevel: \\\"${aiCodeLevel}\\\"\\n # aiTools: \\\"Claude, ChatGPT, Copilot\\\"\\n # aiDescription: \\\"Optional disclosure about how AI was used\\\"\\n`;",
"",
" if (aiTools) {",
" aiFrontMatter = aiFrontMatter.replace(",
" ' # aiTools: \\\"Claude, ChatGPT, Copilot\\\"\\n',",
" ` aiTools: ${JSON.stringify(aiTools)}\\n`,",
" );",
" }",
"",
" if (aiDescription) {",
" aiFrontMatter = aiFrontMatter.replace(",
" ' # aiDescription: \\\"Optional disclosure about how AI was used\\\"\\n',",
" ` aiDescription: ${JSON.stringify(aiDescription)}\\n`,",
" );",
" }",
"",
" return `---\\n${frontMatter}${aiFrontMatter}---\\n`;",
"};",
].join("\n");
// v4: fix post-type detection — Indiekit removes post-type before calling postTemplate,
// so fall back to permalink URL pattern to detect articles and notes.
const v4Block = [
" // Convert url to Eleventy permalink so generated URL matches Indiekit's stored URL",
" // Add trailing slash to generate /path/index.html instead of /path.html",
" if (properties.url) {",
" const url = properties.url;",
" properties.permalink = url.endsWith(\"/\") ? url : `${url}/`;",
" }",
" delete properties.url;",
"",
" // Normalize and sanitize AI disclosure metadata for articles and notes only.",
" const aiSource =",
" properties.ai && typeof properties.ai === \"object\" && !Array.isArray(properties.ai)",
" ? properties.ai",
" : {};",
"",
" const normaliseString = (value) => {",
" if (value === undefined || value === null) {",
" return undefined;",
" }",
"",
" const text = String(value).trim();",
" return text === \"\" ? undefined : text;",
" };",
"",
" const normaliseLevel = (value, allowedValues, fallback = \"0\") => {",
" const candidate = normaliseString(value);",
"",
" if (!candidate) {",
" return fallback;",
" }",
"",
" return allowedValues.includes(candidate) ? candidate : fallback;",
" };",
"",
" const aiTextLevelRaw =",
" aiSource.textLevel ??",
" aiSource.aiTextLevel ??",
" properties.aiTextLevel ??",
" properties[\"ai-text-level\"] ??",
" \"0\";",
"",
" const aiCodeLevelRaw =",
" aiSource.codeLevel ??",
" aiSource.aiCodeLevel ??",
" properties.aiCodeLevel ??",
" properties[\"ai-code-level\"] ??",
" \"0\";",
"",
" const aiTextLevel = normaliseLevel(aiTextLevelRaw, [\"0\", \"1\", \"2\", \"3\"]);",
" // Legacy value \"3\" is folded into \"2\" for code-level taxonomy compatibility.",
" const aiCodeLevel = normaliseLevel(",
" aiCodeLevelRaw === \"3\" ? \"2\" : aiCodeLevelRaw,",
" [\"0\", \"1\", \"2\"],",
" );",
"",
" const aiTools = normaliseString(",
" aiSource.aiTools ?? aiSource.tools ?? properties.aiTools ?? properties[\"ai-tools\"],",
" );",
"",
" const aiDescription = normaliseString(",
" aiSource.aiDescription ??",
" aiSource.description ??",
" properties.aiDescription ??",
" properties[\"ai-description\"],",
" );",
"",
" delete properties.ai;",
" delete properties.aiTextLevel;",
" delete properties.aiCodeLevel;",
" delete properties.aiTools;",
" delete properties.aiDescription;",
" delete properties[\"ai-text-level\"];",
" delete properties[\"ai-code-level\"];",
" delete properties[\"ai-tools\"];",
" delete properties[\"ai-description\"];",
"",
" // Indiekit removes post-type before calling postTemplate; fall back to permalink-based detection.",
" const postType = String(",
" properties.postType ?? properties[\"post-type\"] ?? properties.type ?? \"\",",
" ).toLowerCase();",
" const permalink = String(properties.permalink ?? \"\");",
" const supportsAiDisclosure =",
" postType === \"article\" || postType === \"note\" ||",
" /\\/articles(?:\\/|$)/.test(permalink) || /\\/notes(?:\\/|$)/.test(permalink);",
"",
" const frontMatter = YAML.stringify(properties, { lineWidth: 0 });",
"",
" if (!supportsAiDisclosure) {",
" return `---\\n${frontMatter}---\\n`;",
" }",
"",
" let aiFrontMatter = `ai:\\n textLevel: \\\"${aiTextLevel}\\\"\\n codeLevel: \\\"${aiCodeLevel}\\\"\\n # aiTools: \\\"Claude, ChatGPT, Copilot\\\"\\n # aiDescription: \\\"Optional disclosure about how AI was used\\\"\\n`;",
"",
" if (aiTools) {",
" aiFrontMatter = aiFrontMatter.replace(",
" ' # aiTools: \\\"Claude, ChatGPT, Copilot\\\"\\n',",
" ` aiTools: ${JSON.stringify(aiTools)}\\n`,",
" );",
" }",
"",
" if (aiDescription) {",
" aiFrontMatter = aiFrontMatter.replace(",
" ' # aiDescription: \\\"Optional disclosure about how AI was used\\\"\\n',",
" ` aiDescription: ${JSON.stringify(aiDescription)}\\n`,",
" );",
" }",
"",
" return `---\\n${frontMatter}${aiFrontMatter}---\\n`;",
"};",
].join("\n");
async function exists(filePath) {
try {
await access(filePath);
return true;
} catch {
return false;
}
}
let checked = 0;
let patched = 0;
for (const filePath of candidates) {
if (!(await exists(filePath))) {
continue;
}
checked += 1;
const source = await readFile(filePath, "utf8");
if (source.includes(patchMarker)) {
continue;
}
let updated = source;
if (source.includes(v3Block)) {
updated = source.replace(v3Block, v4Block);
} else if (source.includes(v2PatchedBlock)) {
updated = source.replace(v2PatchedBlock, v4Block);
} else if (source.includes(v1PatchedBlock)) {
updated = source.replace(v1PatchedBlock, v4Block);
} else if (source.includes(upstreamBlock)) {
updated = source.replace(upstreamBlock, v4Block);
} else {
console.warn(
`[postinstall] Skipping preset-eleventy AI frontmatter patch for ${filePath}: upstream format changed`,
);
continue;
}
await writeFile(filePath, updated, "utf8");
patched += 1;
}
if (checked === 0) {
console.log("[postinstall] No preset-eleventy post-template files found");
} else if (patched === 0) {
console.log("[postinstall] preset-eleventy AI frontmatter patch already applied");
} else {
console.log(
`[postinstall] Patched preset-eleventy AI frontmatter in ${patched} file(s)`,
);
}