gutterpress 0.10.10 → 0.10.11

package/dist/{index-xs2g04p2.js → index-03cqyyyk.js}

@@ -24,6 +24,7 @@ import {
   gitScopeFor,
   hasPendingChanges,
   hasUncommittedChanges,
+  listWorkdirChanges,
   resolveGitAuthor,
   resolveLogger,
   snapshotStagingMarkerPath,
@@ -32,6 +33,7 @@ import {
 } from "./index-y01v2fe0.js";
 import {
   detectProjectSource,
+  repoSubPath,
   syncRemoteFor
 } from "./index-v5mp7a6q.js";
 import {
@@ -1469,7 +1471,7 @@ function attachDataAttrs(token, kind, name, attrs) {
       continue;
     if (k === "class" || k === "id" || k === "template" || k === "region")
       continue;
-    token.attrSet(`data-${k}`, v);
+    token.attrSet(k.startsWith("data-") ? k : `data-${k}`, v);
   }
 }
 var DECLARED_NAME_RE = /^[a-z][a-z0-9-]*$/;
@@ -4839,7 +4841,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.10.10",
+  version: "0.10.11",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -5112,64 +5114,32 @@ async function writeBuildFingerprint(input) {
 import { existsSync as existsSync10 } from "node:fs";
 import { dirname as dirname4, join as join4, resolve as resolve8 } from "node:path";
 
-// src/checks/formatter.ts
-function formatReport(report, format = "text") {
-  if (format === "json") {
-    formatJson(report);
-  } else {
-    formatText(report);
-  }
-}
-function formatText(report) {
-  for (const r of report.infos) {
-    const loc = targetPrefix(r.target) + formatLocation(r.file, r.line, r.column);
-    log.info(`${loc}${r.message}`);
-    if (r.detail)
-      log.info(`  ${r.detail}`);
-  }
-  for (const r of report.warnings) {
-    const loc = targetPrefix(r.target) + formatLocation(r.file, r.line, r.column);
-    log.warn(`${loc}${r.message}`);
-    if (r.detail)
-      log.warn(`  ${r.detail}`);
-  }
-  for (const r of report.errors) {
-    const loc = targetPrefix(r.target) + formatLocation(r.file, r.line, r.column);
-    log.error(`${loc}${r.message}`);
-    if (r.detail)
-      log.error(`  ${r.detail}`);
-  }
-  const { summary } = report;
-  if (summary.errors > 0) {
-    log.error(`VALIDATION FAILED (${summary.errors} error${summary.errors > 1 ? "s" : ""})`);
-  } else if (summary.warnings > 0) {
-    log.warn("VALIDATION PASSED (with warnings)");
-  } else {
-    log.success("VALIDATION PASSED");
+// src/lib/markdownlint-fix.ts
+import { readFile as readFile10, writeFile as writeFile5 } from "node:fs/promises";
+import { applyFixes } from "markdownlint";
+import { lint as lint2 } from "markdownlint/sync";
+
+// src/checks/source/config-file.ts
+import { existsSync as existsSync6 } from "node:fs";
+import { resolve as resolve5 } from "node:path";
+function findConfigFile(inputDir, names, explicit) {
+  if (explicit) {
+    const p = resolve5(inputDir, explicit);
+    return existsSync6(p) ? p : null;
   }
-}
-function targetPrefix(target) {
-  return target ? `[${target}] ` : "";
-}
-function formatJson(report) {
-  console.log(JSON.stringify({
-    results: report.results,
-    summary: report.summary,
-    passed: report.passed
-  }, null, 2));
-}
-function formatLocation(file, line, column) {
-  if (!file)
-    return "";
-  let loc = `${file}`;
-  if (line != null) {
-    loc += `:${line}`;
-    if (column != null)
-      loc += `:${column}`;
+  for (const name of names) {
+    const p = resolve5(inputDir, name);
+    if (existsSync6(p))
+      return p;
   }
-  return `${loc}: `;
+  return null;
 }
 
+// src/checks/source/markdownlint.ts
+import { readFile as readFile9 } from "node:fs/promises";
+import { lint } from "markdownlint/sync";
+import { parse as parseYaml2 } from "yaml";
+
 // src/checks/registry.ts
 var checks = new Map;
 function registerCheck(check) {
@@ -5235,15 +5205,205 @@ function selectorToRegex(selector) {
   return new RegExp(`^${escaped}$`);
 }
 
+// src/checks/source/markdownlint.ts
+var CONFIG_NAMES = [
+  ".markdownlint.yaml",
+  ".markdownlint.yml",
+  ".markdownlint.json",
+  ".markdownlint.jsonc",
+  ".markdownlint-cli2.yaml",
+  ".markdownlint-cli2.jsonc"
+];
+function stripJsonComments(s) {
+  return s.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/.*$/gm, "$1");
+}
+async function loadConfig(configPath) {
+  const raw = await readFile9(configPath, "utf8");
+  let parsed;
+  if (configPath.endsWith(".json")) {
+    parsed = JSON.parse(raw);
+  } else if (configPath.endsWith(".jsonc")) {
+    parsed = JSON.parse(stripJsonComments(raw));
+  } else {
+    parsed = parseYaml2(raw);
+  }
+  if (parsed && typeof parsed === "object") {
+    const obj = parsed;
+    if (obj.config && typeof obj.config === "object") {
+      return obj.config;
+    }
+    return obj;
+  }
+  return {};
+}
+var MARKDOWNLINT_CHECK_ID = "source.markdownlint";
+var check = {
+  id: MARKDOWNLINT_CHECK_ID,
+  name: "Markdownlint",
+  description: "Runs markdownlint with project config to validate Markdown files",
+  category: "source",
+  phase: "pre-build",
+  async run(ctx) {
+    const sourceConfig = ctx.config.validate.source;
+    if (sourceConfig.markdownlint === false)
+      return [];
+    const files = ctx.markdownFiles;
+    if (!files || files.length === 0)
+      return [];
+    const configPath = typeof sourceConfig.markdownlint === "string" ? sourceConfig.markdownlint : null;
+    const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES, configPath);
+    if (!resolvedConfig && !configPath)
+      return [];
+    const config = resolvedConfig ? await loadConfig(resolvedConfig) : { default: true };
+    const results = lint({ files, config });
+    const out = [];
+    for (const [file, violations] of Object.entries(results)) {
+      if (!Array.isArray(violations))
+        continue;
+      for (const v of violations) {
+        out.push({
+          checkId: check.id,
+          severity: "warning",
+          message: `${v.ruleDescription} (${v.ruleNames.join("/")})`,
+          file,
+          line: v.lineNumber,
+          column: v.errorRange?.[0],
+          code: v.ruleNames[0]
+        });
+      }
+    }
+    return out;
+  }
+};
+registerCheck(check);
+
+// src/lib/markdownlint-fix.ts
+async function uncommittedAmong(inputDir, files) {
+  const source = await detectProjectSource(inputDir);
+  if (source.type !== "local-git-folder")
+    return [];
+  const repoRoot = source.repoRoot;
+  let changed;
+  try {
+    const { adds } = await listWorkdirChanges(repoRoot);
+    changed = new Set(adds);
+  } catch {
+    return [];
+  }
+  return files.filter((file) => changed.has(repoSubPath(repoRoot, file)));
+}
+async function applyMarkdownlintFixes(ctx) {
+  const sourceConfig = ctx.config.validate.source;
+  if (sourceConfig.markdownlint === false) {
+    log.warn("--fix: source.markdownlint is disabled for this project — no files were fixed.");
+    return [];
+  }
+  const files = ctx.markdownFiles;
+  if (!files || files.length === 0) {
+    log.warn("--fix: no markdown files to fix.");
+    return [];
+  }
+  const configPath = typeof sourceConfig.markdownlint === "string" ? sourceConfig.markdownlint : null;
+  const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES, configPath);
+  if (!resolvedConfig && !configPath) {
+    log.warn(`--fix: no markdownlint config found in ${ctx.inputDir} (looked for ${CONFIG_NAMES.join(", ")}) — no files were fixed.`);
+    return [];
+  }
+  const config = resolvedConfig ? await loadConfig(resolvedConfig) : { default: true };
+  const results = lint2({ files, config });
+  const pending = [];
+  for (const [file, violations] of Object.entries(results)) {
+    if (!Array.isArray(violations) || violations.length === 0)
+      continue;
+    const before = await readFile10(file, "utf8");
+    const after = applyFixes(before, violations);
+    if (after !== before)
+      pending.push({ file, content: after });
+  }
+  if (pending.length === 0) {
+    log.warn("--fix: no mechanically fixable markdownlint violations found.");
+    return [];
+  }
+  const dirty = await uncommittedAmong(ctx.inputDir, pending.map((p) => p.file));
+  for (const { file, content } of pending) {
+    await writeFile5(file, content, "utf8");
+  }
+  log.warn(`--fix: rewrote ${pending.length} file(s):`);
+  for (const { file } of pending)
+    log.warn(`  ${file}`);
+  if (dirty.length > 0) {
+    log.warn(`--fix: ${dirty.length} of those already had uncommitted changes and were rewritten anyway: ${dirty.join(", ")}`);
+  }
+  return pending.map((p) => p.file);
+}
+
+// src/checks/formatter.ts
+function formatReport(report, format = "text") {
+  if (format === "json") {
+    formatJson(report);
+  } else {
+    formatText(report);
+  }
+}
+function formatText(report) {
+  for (const r of report.infos) {
+    const loc = targetPrefix(r.target) + formatLocation(r.file, r.line, r.column);
+    log.info(`${loc}${r.message}`);
+    if (r.detail)
+      log.info(`  ${r.detail}`);
+  }
+  for (const r of report.warnings) {
+    const loc = targetPrefix(r.target) + formatLocation(r.file, r.line, r.column);
+    log.warn(`${loc}${r.message}`);
+    if (r.detail)
+      log.warn(`  ${r.detail}`);
+  }
+  for (const r of report.errors) {
+    const loc = targetPrefix(r.target) + formatLocation(r.file, r.line, r.column);
+    log.error(`${loc}${r.message}`);
+    if (r.detail)
+      log.error(`  ${r.detail}`);
+  }
+  const { summary } = report;
+  if (summary.errors > 0) {
+    log.error(`VALIDATION FAILED (${summary.errors} error${summary.errors > 1 ? "s" : ""})`);
+  } else if (summary.warnings > 0) {
+    log.warn("VALIDATION PASSED (with warnings)");
+  } else {
+    log.success("VALIDATION PASSED");
+  }
+}
+function targetPrefix(target) {
+  return target ? `[${target}] ` : "";
+}
+function formatJson(report) {
+  console.log(JSON.stringify({
+    results: report.results,
+    summary: report.summary,
+    passed: report.passed
+  }, null, 2));
+}
+function formatLocation(file, line, column) {
+  if (!file)
+    return "";
+  let loc = `${file}`;
+  if (line != null) {
+    loc += `:${line}`;
+    if (column != null)
+      loc += `:${column}`;
+  }
+  return `${loc}: `;
+}
+
 // src/checks/policy.ts
 var INSPECT_FAILED_CODE = "inspect-failed";
-function isCheckEnabled(check, config) {
-  const entry = config.validate.checks[check.id];
+function isCheckEnabled(check2, config) {
+  const entry = config.validate.checks[check2.id];
   if (entry === false)
     return false;
   if (typeof entry === "object" && entry.enabled === false)
     return false;
-  if (check.enabledWhen && !check.enabledWhen(config))
+  if (check2.enabledWhen && !check2.enabledWhen(config))
     return false;
   return true;
 }
@@ -5280,7 +5440,7 @@ function inspectionFailed(checkId, message, extra = {}) {
 }
 
 // src/lib/pdf-inspect.ts
-import { stat, readFile as readFile9 } from "node:fs/promises";
+import { stat, readFile as readFile11 } from "node:fs/promises";
 import { getDocumentProxy } from "unpdf";
 import * as pdfjs from "unpdf/pdfjs";
 function getOps(mod) {
@@ -5335,7 +5495,7 @@ async function loadPdf(path7) {
   }
   if (hit)
     destroyEntry(hit);
-  const docPromise = readFile9(path7).then((buf) => getDocumentProxy(new Uint8Array(buf)));
+  const docPromise = readFile11(path7).then((buf) => getDocumentProxy(new Uint8Array(buf)));
   docCache.delete(path7);
   docCache.set(path7, { mtimeMs: st.mtimeMs, size: st.size, doc: docPromise });
   evictLru();
@@ -5533,12 +5693,12 @@ function getOpPass(doc) {
   return p;
 }
 function getImagePixelSize(page, name, timeoutMs = 2000) {
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     let done = false;
     const finish = (v) => {
       if (!done) {
         done = true;
-        resolve5(v);
+        resolve6(v);
       }
     };
     const t = setTimeout(() => finish(null), timeoutMs);
@@ -5594,7 +5754,7 @@ async function isLoadable(doc) {
 }
 
 // src/checks/pdf/qpdf-structure.ts
-var check = {
+var check2 = {
   id: "pdf.structure.qpdf",
   name: "PDF Structure",
   description: "Validates the PDF parses and every page is traversable",
@@ -5606,16 +5766,16 @@ var check = {
     const doc = await loadPdf(ctx.pdfPath);
     if (!doc || !await isLoadable(doc)) {
       return [
-        inspectionFailed(check.id, "PDF could not be fully parsed — possible structural issues.", { file: ctx.pdfPath })
+        inspectionFailed(check2.id, "PDF could not be fully parsed — possible structural issues.", { file: ctx.pdfPath })
       ];
     }
     return [];
   }
 };
-registerCheck(check);
+registerCheck(check2);
 
 // src/checks/pdf/page-size.ts
-var check2 = {
+var check3 = {
   id: "pdf.print.page-size",
   name: "Page Size",
   description: "Validates PDF page dimensions match expected size from config",
@@ -5627,7 +5787,7 @@ var check2 = {
     const doc = await loadPdf(ctx.pdfPath);
     if (!doc) {
       return [
-        inspectionFailed(check2.id, "Could not parse PDF page size.", {
+        inspectionFailed(check3.id, "Could not parse PDF page size.", {
           file: ctx.pdfPath
         })
       ];
@@ -5637,7 +5797,7 @@ var check2 = {
     const { width, height, tolerance } = ctx.config.page;
     if (Math.abs(size.w - width) >= tolerance || Math.abs(size.h - height) >= tolerance) {
       return [
-        finding(check2.id, {
+        finding(check3.id, {
           severity: "error",
           message: `Page size mismatch: expected ~${width}x${height} pts, got ${Math.round(size.w)}x${Math.round(size.h)} pts.`,
           file: ctx.pdfPath
@@ -5647,7 +5807,7 @@ var check2 = {
     return [];
   }
 };
-registerCheck(check2);
+registerCheck(check3);
 
 // src/checks/pdf/pdfx-structure.ts
 function isObject(value) {
@@ -5757,7 +5917,7 @@ function getPdfxMetadataIssues(objects, flavor) {
 }
 
 // src/checks/pdf/pdfx-markers.ts
-var check3 = {
+var check4 = {
   id: "pdf.print.pdfx-markers",
   name: "PDF/X Markers",
   description: "Checks PDF/X OutputIntent structure via qpdf JSON",
@@ -5776,27 +5936,27 @@ var check3 = {
       const objects = parseQpdfObjectsJson(stdout);
       if (!objects) {
         return [
-          inspectionFailed(check3.id, "Unable to parse qpdf JSON output for PDF/X checks.", { file: ctx.pdfPath })
+          inspectionFailed(check4.id, "Unable to parse qpdf JSON output for PDF/X checks.", { file: ctx.pdfPath })
         ];
       }
-      return getPdfxOutputIntentIssues(objects).map((message) => finding(check3.id, {
+      return getPdfxOutputIntentIssues(objects).map((message) => finding(check4.id, {
         severity: "error",
         message,
         file: ctx.pdfPath
       }));
     } catch {
       return [
-        inspectionFailed(check3.id, "Failed to inspect PDF objects with qpdf for PDF/X markers.", { file: ctx.pdfPath })
+        inspectionFailed(check4.id, "Failed to inspect PDF objects with qpdf for PDF/X markers.", { file: ctx.pdfPath })
       ];
     }
   }
 };
-registerCheck(check3);
+registerCheck(check4);
 
 // src/lib/pdf-parse.ts
-import { readFile as readFile10 } from "node:fs/promises";
+import { readFile as readFile12 } from "node:fs/promises";
 async function readPdfBytes(pdfPath) {
-  return readFile10(pdfPath, "latin1");
+  return readFile12(pdfPath, "latin1");
 }
 function parseInkCov(out) {
   const lines = out.split(/\r?\n/).filter((l) => l.includes("CMYK"));
@@ -5844,7 +6004,7 @@ async function getPerPageInkCoverage(pdfPath) {
 }
 
 // src/checks/pdf/color-spaces.ts
-var check4 = {
+var check5 = {
   id: "pdf.print.color-spaces",
   name: "Color Spaces",
   description: "Checks for forbidden color spaces (DeviceRGB, Lab, Separation, DeviceN)",
@@ -5857,7 +6017,7 @@ var check4 = {
     const results = [];
     if (/\/DeviceRGB/.test(bytes)) {
       results.push({
-        checkId: check4.id,
+        checkId: check5.id,
         severity: "error",
         message: "DeviceRGB found (interior must be CMYK or grayscale only).",
         file: ctx.pdfPath
@@ -5865,7 +6025,7 @@ var check4 = {
     }
     if (/\/Lab\b/.test(bytes)) {
       results.push({
-        checkId: check4.id,
+        checkId: check5.id,
         severity: "error",
         message: "Lab color space found (not allowed).",
         file: ctx.pdfPath
@@ -5873,7 +6033,7 @@ var check4 = {
     }
     if (/\/Separation/.test(bytes)) {
       results.push({
-        checkId: check4.id,
+        checkId: check5.id,
         severity: "error",
         message: "Spot color (Separation) found (not allowed).",
         file: ctx.pdfPath
@@ -5881,7 +6041,7 @@ var check4 = {
     }
     if (/\/DeviceN/.test(bytes)) {
       results.push({
-        checkId: check4.id,
+        checkId: check5.id,
         severity: "error",
         message: "Spot color (DeviceN) found (not allowed).",
         file: ctx.pdfPath
@@ -5890,10 +6050,10 @@ var check4 = {
     return results;
   }
 };
-registerCheck(check4);
+registerCheck(check5);
 
 // src/checks/pdf/embedded-fonts.ts
-var check5 = {
+var check6 = {
   id: "pdf.print.embedded-fonts",
   name: "Embedded Fonts",
   description: "Verifies all fonts in the PDF are embedded",
@@ -5909,7 +6069,7 @@ var check5 = {
     if (fonts.length === 0) {
       return [
         {
-          checkId: check5.id,
+          checkId: check6.id,
           severity: "warning",
           message: "No fonts detected (unexpected).",
           file: ctx.pdfPath,
@@ -5922,7 +6082,7 @@ var check5 = {
       const names = notEmbedded.map((f) => f.name);
       return [
         {
-          checkId: check5.id,
+          checkId: check6.id,
           severity: "error",
           message: `Not all fonts are embedded (${names.join(", ")}). Check @font-face and Chromium output.`,
           file: ctx.pdfPath,
@@ -5934,10 +6094,10 @@ var check5 = {
     return [];
   }
 };
-registerCheck(check5);
+registerCheck(check6);
 
 // src/checks/pdf/ink-coverage.ts
-var check6 = {
+var check7 = {
   id: "pdf.print.ink-coverage",
   name: "Ink Coverage (TAC)",
   description: "Checks total area coverage (TAC) against maximum ink limits",
@@ -5951,7 +6111,7 @@ var check6 = {
     if (!inkResult.ok) {
       return [
         {
-          checkId: check6.id,
+          checkId: check7.id,
           severity: "warning",
           message: "Ink coverage could not be measured",
           file: ctx.pdfPath,
@@ -5976,7 +6136,7 @@ var check6 = {
     }
     return [
       {
-        checkId: check6.id,
+        checkId: check7.id,
         severity: "warning",
         message: `Total ink coverage too high on ${offending.length} page(s) (max ${maxTac.toFixed(1)}%, recommended <=${ctx.config.ink.maxTac}%)`,
         file: ctx.pdfPath,
@@ -6000,10 +6160,10 @@ var check6 = {
     ];
   }
 };
-registerCheck(check6);
+registerCheck(check7);
 
 // src/checks/pdf/rasterized-pages.ts
-var check7 = {
+var check8 = {
   id: "pdf.print.rasterized-pages",
   name: "Rasterized Pages",
   description: "Detects pages that appear to be fully rasterized (CSS filters, blend modes, transparency)",
@@ -6043,7 +6203,7 @@ var check7 = {
     rasterizedPages.sort((a, b) => a - b);
     return [
       {
-        checkId: check7.id,
+        checkId: check8.id,
         severity: "warning",
         message: `Possible rasterized pages detected: ${rasterizedPages.join(", ")}`,
         file: ctx.pdfPath,
@@ -6054,10 +6214,10 @@ var check7 = {
     ];
   }
 };
-registerCheck(check7);
+registerCheck(check8);
 
 // src/checks/pdf/bookmarks.ts
-var check8 = {
+var check9 = {
   id: "pdf.nav.bookmarks",
   name: "Bookmarks",
   description: "Checks for PDF outline (bookmarks) tree",
@@ -6071,14 +6231,14 @@ var check8 = {
     const doc = await loadPdf(ctx.pdfPath);
     if (!doc) {
       return [
-        inspectionFailed(check8.id, "Could not inspect PDF for bookmarks.", {
+        inspectionFailed(check9.id, "Could not inspect PDF for bookmarks.", {
           file: ctx.pdfPath
         })
       ];
     }
     if (await getOutlineCount(doc) === 0) {
       return [
-        finding(check8.id, {
+        finding(check9.id, {
           severity: "warning",
           message: "PDF does not contain bookmarks (outline tree).",
           file: ctx.pdfPath
@@ -6088,10 +6248,10 @@ var check8 = {
     return [];
   }
 };
-registerCheck(check8);
+registerCheck(check9);
 
 // src/checks/pdf/toc-links.ts
-var check9 = {
+var check10 = {
   id: "pdf.nav.toc-links",
   name: "TOC Links",
   description: "Detects link annotations on TOC pages",
@@ -6106,7 +6266,7 @@ var check9 = {
     if (!doc) {
       return [
         {
-          checkId: check9.id,
+          checkId: check10.id,
           severity: "warning",
           message: "Could not inspect PDF for TOC links.",
           file: ctx.pdfPath
@@ -6117,7 +6277,7 @@ var check9 = {
     if (!hasLinks) {
       return [
         {
-          checkId: check9.id,
+          checkId: check10.id,
           severity: "warning",
           message: "No link annotations found in PDF (expected for TOC).",
           file: ctx.pdfPath
@@ -6127,10 +6287,10 @@ var check9 = {
     return [];
   }
 };
-registerCheck(check9);
+registerCheck(check10);
 
 // src/checks/pdf/cross-refs.ts
-var check10 = {
+var check11 = {
   id: "pdf.nav.cross-refs",
   name: "Cross References",
   description: "Counts and verifies internal link annotations",
@@ -6143,7 +6303,7 @@ var check10 = {
     if (!doc) {
       return [
         {
-          checkId: check10.id,
+          checkId: check11.id,
           severity: "info",
           message: "Could not inspect PDF for cross-references.",
           file: ctx.pdfPath
@@ -6153,7 +6313,7 @@ var check10 = {
     const linkCount = await countLinkAnnotations(doc);
     return [
       {
-        checkId: check10.id,
+        checkId: check11.id,
         severity: "info",
         message: `PDF contains ${linkCount} internal link annotation${linkCount !== 1 ? "s" : ""}.`,
         file: ctx.pdfPath
@@ -6161,10 +6321,10 @@ var check10 = {
     ];
   }
 };
-registerCheck(check10);
+registerCheck(check11);
 
 // src/checks/pdf/page-labels.ts
-var check11 = {
+var check12 = {
   id: "pdf.nav.page-labels",
   name: "Page Labels",
   description: "Verifies PDF page labels / folio numbering",
@@ -6179,7 +6339,7 @@ var check11 = {
     const labels = await getPageLabels(doc);
     return [
       {
-        checkId: check11.id,
+        checkId: check12.id,
         severity: "info",
         message: labels && labels.length > 0 ? "PDF contains page labels." : "PDF does not contain explicit page labels.",
         file: ctx.pdfPath
@@ -6187,10 +6347,10 @@ var check11 = {
     ];
   }
 };
-registerCheck(check11);
+registerCheck(check12);
 
 // src/checks/pdf/image-resolution.ts
-var check12 = {
+var check13 = {
   id: "pdf.print.image-resolution",
   name: "Image Resolution",
   description: "Checks DPI of images embedded in the PDF",
@@ -6217,7 +6377,7 @@ var check12 = {
       lowResPages.sort((a, b) => a - b);
       return [
         {
-          checkId: check12.id,
+          checkId: check13.id,
           severity: "warning",
           message: `Low-resolution images (below ${minDpi} DPI) found on pages: ${lowResPages.join(", ")}`,
           file: ctx.pdfPath
@@ -6227,10 +6387,10 @@ var check12 = {
     return [];
   }
 };
-registerCheck(check12);
+registerCheck(check13);
 
 // src/checks/pdf/transparency.ts
-var check13 = {
+var check14 = {
   id: "pdf.print.transparency",
   name: "Transparency",
   description: "Checks for transparency markers (/Transparency, /SMask, /BM) in the PDF",
@@ -6252,7 +6412,7 @@ var check13 = {
     if (found.length > 0) {
       return [
         {
-          checkId: check13.id,
+          checkId: check14.id,
           severity: "warning",
           message: `Transparency detected in PDF: ${found.join(", ")}. This may cause issues with some printers.`,
           file: ctx.pdfPath
@@ -6262,7 +6422,7 @@ var check13 = {
     return [];
   }
 };
-registerCheck(check13);
+registerCheck(check14);
 
 // src/checks/pdf/bleed.ts
 function findBox(bytes, box) {
@@ -6272,7 +6432,7 @@ function findBox(bytes, box) {
     return null;
   return [Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4])];
 }
-var check14 = {
+var check15 = {
   id: "pdf.print.bleed",
   name: "Bleed Box",
   description: "Compares MediaBox vs TrimBox/BleedBox to verify bleed area",
@@ -6286,7 +6446,7 @@ var check14 = {
     const bytes = await readPdfBytes(ctx.pdfPath).catch(() => "");
     if (!bytes) {
       return [
-        inspectionFailed(check14.id, "Could not inspect PDF for bleed boxes.", {
+        inspectionFailed(check15.id, "Could not inspect PDF for bleed boxes.", {
           file: ctx.pdfPath
         })
       ];
@@ -6296,14 +6456,14 @@ var check14 = {
     const bleed = findBox(bytes, "BleedBox");
     if (!media) {
       return [
-        inspectionFailed(check14.id, "Could not parse MediaBox from PDF.", {
+        inspectionFailed(check15.id, "Could not parse MediaBox from PDF.", {
           file: ctx.pdfPath
         })
       ];
     }
     if (!trim && !bleed) {
       return [
-        finding(check14.id, {
+        finding(check15.id, {
           severity: "warning",
           message: "No TrimBox or BleedBox found. Bleed area cannot be verified.",
           file: ctx.pdfPath
@@ -6316,7 +6476,7 @@ var check14 = {
       const bleedSize = ctx.config.validate.pdf.bleedSize;
       if (mediaW - trimW < bleedSize * 2 * 0.9) {
         return [
-          finding(check14.id, {
+          finding(check15.id, {
             severity: "warning",
             message: `Bleed area appears insufficient. Expected at least ${bleedSize}pt on each side.`,
             file: ctx.pdfPath
@@ -6327,10 +6487,10 @@ var check14 = {
     return [];
   }
 };
-registerCheck(check14);
+registerCheck(check15);
 
 // src/checks/pdf/pdfx-metadata.ts
-var check15 = {
+var check16 = {
   id: "pdf.print.pdfx-metadata",
   name: "PDF/X Metadata",
   description: "Verifies PDF/X DOCINFO metadata via qpdf JSON",
@@ -6349,118 +6509,26 @@ var check15 = {
       const objects = parseQpdfObjectsJson(stdout);
       if (!objects) {
         return [
-          inspectionFailed(check15.id, "Unable to parse qpdf JSON output for PDF/X metadata checks.", { file: ctx.pdfPath })
+          inspectionFailed(check16.id, "Unable to parse qpdf JSON output for PDF/X metadata checks.", { file: ctx.pdfPath })
         ];
       }
-      return getPdfxMetadataIssues(objects, ctx.config.pdfx.flavor).map((message) => finding(check15.id, {
+      return getPdfxMetadataIssues(objects, ctx.config.pdfx.flavor).map((message) => finding(check16.id, {
         severity: "error",
         message,
         file: ctx.pdfPath
       }));
     } catch {
       return [
-        inspectionFailed(check15.id, "Failed to inspect PDF objects with qpdf for PDF/X metadata.", { file: ctx.pdfPath })
+        inspectionFailed(check16.id, "Failed to inspect PDF objects with qpdf for PDF/X metadata.", { file: ctx.pdfPath })
       ];
     }
   }
 };
-registerCheck(check15);
-
-// src/checks/source/markdownlint.ts
-import { readFile as readFile11 } from "node:fs/promises";
-import { lint } from "markdownlint/sync";
-import { parse as parseYaml2 } from "yaml";
-
-// src/checks/source/config-file.ts
-import { existsSync as existsSync6 } from "node:fs";
-import { resolve as resolve5 } from "node:path";
-function findConfigFile(inputDir, names, explicit) {
-  if (explicit) {
-    const p = resolve5(inputDir, explicit);
-    return existsSync6(p) ? p : null;
-  }
-  for (const name of names) {
-    const p = resolve5(inputDir, name);
-    if (existsSync6(p))
-      return p;
-  }
-  return null;
-}
-
-// src/checks/source/markdownlint.ts
-var CONFIG_NAMES = [
-  ".markdownlint.yaml",
-  ".markdownlint.yml",
-  ".markdownlint.json",
-  ".markdownlint.jsonc",
-  ".markdownlint-cli2.yaml",
-  ".markdownlint-cli2.jsonc"
-];
-function stripJsonComments(s) {
-  return s.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/.*$/gm, "$1");
-}
-async function loadConfig(configPath) {
-  const raw = await readFile11(configPath, "utf8");
-  let parsed;
-  if (configPath.endsWith(".json")) {
-    parsed = JSON.parse(raw);
-  } else if (configPath.endsWith(".jsonc")) {
-    parsed = JSON.parse(stripJsonComments(raw));
-  } else {
-    parsed = parseYaml2(raw);
-  }
-  if (parsed && typeof parsed === "object") {
-    const obj = parsed;
-    if (obj.config && typeof obj.config === "object") {
-      return obj.config;
-    }
-    return obj;
-  }
-  return {};
-}
-var check16 = {
-  id: "source.markdownlint",
-  name: "Markdownlint",
-  description: "Runs markdownlint with project config to validate Markdown files",
-  category: "source",
-  phase: "pre-build",
-  async run(ctx) {
-    const sourceConfig = ctx.config.validate.source;
-    if (sourceConfig.markdownlint === false)
-      return [];
-    const files = ctx.markdownFiles;
-    if (!files || files.length === 0)
-      return [];
-    const configPath = typeof sourceConfig.markdownlint === "string" ? sourceConfig.markdownlint : null;
-    const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES, configPath);
-    if (!resolvedConfig && !configPath)
-      return [];
-    const config = resolvedConfig ? await loadConfig(resolvedConfig) : { default: true };
-    const results = lint({ files, config });
-    const out = [];
-    for (const [file, violations] of Object.entries(results)) {
-      if (!Array.isArray(violations))
-        continue;
-      for (const v of violations) {
-        out.push({
-          checkId: check16.id,
-          severity: "warning",
-          message: `${v.ruleDescription} (${v.ruleNames.join("/")})`,
-          file,
-          line: v.lineNumber,
-          column: v.errorRange?.[0],
-          code: v.ruleNames[0]
-        });
-      }
-    }
-    return out;
-  }
-};
 registerCheck(check16);
 
 // src/checks/source/htmlhint.ts
 import { existsSync as existsSync7 } from "node:fs";
-import { readFile as readFile12 } from "node:fs/promises";
+import { readFile as readFile13 } from "node:fs/promises";
 import htmlhint from "htmlhint";
 var { HTMLHint } = htmlhint;
 var CONFIG_NAMES2 = [".htmlhintrc"];
@@ -6480,8 +6548,8 @@ var check17 = {
     const resolvedConfig = findConfigFile(ctx.inputDir, CONFIG_NAMES2, configPath);
     if (!resolvedConfig && !configPath)
       return [];
-    const ruleset = resolvedConfig ? JSON.parse(await readFile12(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
-    const html = await readFile12(ctx.htmlPath, "utf8");
+    const ruleset = resolvedConfig ? JSON.parse(await readFile13(resolvedConfig, "utf8")) : HTMLHint.defaultRuleset;
+    const html = await readFile13(ctx.htmlPath, "utf8");
     const messages = HTMLHint.verify(html, ruleset);
     return messages.map((m) => ({
       checkId: check17.id,
@@ -6496,7 +6564,7 @@ var check17 = {
 registerCheck(check17);
 
 // src/checks/source/stylelint.ts
-import { readFile as readFile13 } from "node:fs/promises";
+import { readFile as readFile14 } from "node:fs/promises";
 
 // src/lib/printsafe.ts
 import postcss2 from "postcss";
@@ -6772,7 +6840,7 @@ var check18 = {
     for (const file of files) {
       let css;
       try {
-        css = await readFile13(file, "utf8");
+        css = await readFile14(file, "utf8");
       } catch (err) {
         results.push({
           checkId: check18.id,
@@ -6799,12 +6867,12 @@ var check18 = {
 registerCheck(check18);
 
 // src/checks/source/css-ownership.ts
-import { readFile as readFile14 } from "node:fs/promises";
+import { readFile as readFile15 } from "node:fs/promises";
 import postcss3 from "postcss";
 import { parse as parseYaml3 } from "yaml";
 var CONFIG_NAMES3 = [".gutterpress/css-contract.yaml", ".gutterpress/css-contract.yml"];
 async function loadContract(configPath) {
-  const raw = await readFile14(configPath, "utf8");
+  const raw = await readFile15(configPath, "utf8");
   const parsed = parseYaml3(raw);
   if (parsed && typeof parsed === "object")
     return parsed;
@@ -6955,7 +7023,7 @@ var check19 = {
         continue;
       let css;
       try {
-        css = await readFile14(absFile, "utf8");
+        css = await readFile15(absFile, "utf8");
       } catch {
         continue;
       }
@@ -7001,7 +7069,7 @@ import { existsSync as existsSync8 } from "node:fs";
 import { dirname as dirname3, resolve as resolve6 } from "node:path";
 
 // src/checks/source/local-ref-parser.ts
-import { readFile as readFile15 } from "node:fs/promises";
+import { readFile as readFile16 } from "node:fs/promises";
 function newlineOffsets(content) {
   const offsets = [];
   for (let i = 0;i < content.length; i++)
@@ -7070,7 +7138,7 @@ async function* renderedLocalRefs(ctx, checkId, results) {
   for (const file of files) {
     let refs;
     try {
-      refs = collectRenderedLocalRefs(await readFile15(file, "utf8"));
+      refs = collectRenderedLocalRefs(await readFile16(file, "utf8"));
     } catch {
       results.push(inspectionFailed(checkId, `Could not read source file: ${file}`, { file }));
       continue;
@@ -7421,7 +7489,7 @@ var check21 = {
 registerCheck(check21);
 
 // src/checks/source/accessibility-alt-text.ts
-import { readFile as readFile16 } from "node:fs/promises";
+import { readFile as readFile17 } from "node:fs/promises";
 var check22 = {
   id: "source.accessibility.alt-text",
   name: "Image Alt Text",
@@ -7435,7 +7503,7 @@ var check22 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile16(file, "utf8");
+        const content = await readFile17(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -7479,7 +7547,7 @@ function extractImageAlts(line) {
 registerCheck(check22);
 
 // src/checks/source/accessibility-heading-order.ts
-import { readFile as readFile17 } from "node:fs/promises";
+import { readFile as readFile18 } from "node:fs/promises";
 var check23 = {
   id: "source.accessibility.heading-order",
   name: "Heading Order",
@@ -7493,7 +7561,7 @@ var check23 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile17(file, "utf8");
+        const content = await readFile18(file, "utf8");
         const lines = content.split(`
 `);
         let inFence = false;
@@ -7529,7 +7597,7 @@ var check23 = {
 registerCheck(check23);
 
 // src/checks/source/layout-markers.ts
-import { readFile as readFile18 } from "node:fs/promises";
+import { readFile as readFile19 } from "node:fs/promises";
 var check24 = {
   id: "source.markdown.layout-markers",
   name: "Layout Markers",
@@ -7547,7 +7615,7 @@ var check24 = {
     const md = createMarkdownRenderer(plugins);
     for (const file of files) {
       try {
-        const content = await readFile18(file, "utf8");
+        const content = await readFile19(file, "utf8");
         const env = {};
         md.render(content, env);
         for (const w of env.layoutWarnings ?? []) {
@@ -7569,7 +7637,7 @@ var check24 = {
 registerCheck(check24);
 
 // src/checks/source/merge-markers.ts
-import { readFile as readFile19 } from "node:fs/promises";
+import { readFile as readFile20 } from "node:fs/promises";
 import path8 from "node:path";
 
 // src/checks/asset/extensions.ts
@@ -7611,7 +7679,7 @@ var check25 = {
     for (const file of textFiles) {
       let content;
       try {
-        content = await readFile19(file, "utf8");
+        content = await readFile20(file, "utf8");
       } catch {
         results.push(inspectionFailed(check25.id, `Could not read source file: ${file}`, { file }));
         continue;
@@ -7674,7 +7742,7 @@ registerCheck(check25);
 import { stat as stat3 } from "node:fs/promises";
 
 // src/lib/image-inspect.ts
-import { stat as stat2, readFile as readFile20 } from "node:fs/promises";
+import { stat as stat2, readFile as readFile21 } from "node:fs/promises";
 var DEFAULT_DPI = 72;
 var cache = new Map;
 async function inspectImage(path9) {
@@ -7689,7 +7757,7 @@ async function inspectImage(path9) {
     return hit.info;
   let info2 = null;
   try {
-    const buf = await readFile20(path9);
+    const buf = await readFile21(path9);
     info2 = parseImage(buf);
   } catch {
     info2 = null;
@@ -8249,7 +8317,7 @@ var check33 = {
 registerCheck(check33);
 
 // src/checks/heuristic/section-density.ts
-import { readFile as readFile21 } from "node:fs/promises";
+import { readFile as readFile22 } from "node:fs/promises";
 var check34 = {
   id: "heuristic.chunking.section-density",
   name: "Section Density",
@@ -8266,7 +8334,7 @@ var check34 = {
     const results = [];
     for (const file of files) {
       try {
-        const content = await readFile21(file, "utf8");
+        const content = await readFile22(file, "utf8");
         const lines = content.split(`
 `);
         let currentSectionStart = 0;
@@ -8765,6 +8833,14 @@ async function executeValidation(args) {
     only,
     skip
   };
+  if (args.fix) {
+    const selected = selectChecks(runnerOptions, config).checks;
+    if (selected.some((check37) => check37.id === MARKDOWNLINT_CHECK_ID)) {
+      await applyMarkdownlintFixes(context);
+    } else {
+      log.warn(`--fix: ${MARKDOWNLINT_CHECK_ID} is not part of this run — no files were fixed.`);
+    }
+  }
   const runs = planRuns({ manifest, baseConfig: config, targetIds, pdfPath, categories, only });
   const reports = [];
   const toolResults = [];
@@ -9243,7 +9319,7 @@ async function runBuild(opts) {
 import path11 from "path";
 import { tmpdir as tmpdir2 } from "os";
 import { randomBytes as randomBytes2 } from "crypto";
-import { readdir as readdir5, readFile as readFile22, writeFile as writeFile5 } from "node:fs/promises";
+import { readdir as readdir5, readFile as readFile23, writeFile as writeFile6 } from "node:fs/promises";
 
 // src/utils/file-utils.ts
 import { promises as fs3 } from "fs";
@@ -9753,7 +9829,7 @@ async function cleanupOrphanTempDirs() {
     const dir = path11.join(TEMP_DIR_BASE, entry);
     const pidFile = path11.join(dir, PID_FILE_NAME);
     try {
-      const raw = await readFile22(pidFile, "utf8");
+      const raw = await readFile23(pidFile, "utf8");
       const pid = parseInt(raw.trim(), 10);
       if (!isProcessAlive(pid)) {
         debug(`Removing orphan temp dir ${dir} (pid ${pid} not alive)`);
@@ -9768,7 +9844,7 @@ async function initializePreviewDirectories() {
   const tempDir = path11.join(TEMP_DIR_BASE, tempDirSuffix);
   await mkdir4(tempDir);
   debug(`Created temporary directory: ${tempDir}`);
-  await writeFile5(path11.join(tempDir, PID_FILE_NAME), `${process.pid}
+  await writeFile6(path11.join(tempDir, PID_FILE_NAME), `${process.pid}
 `, "utf8");
   return tempDir;
 }
@@ -9859,7 +9935,7 @@ function createServerState(inputPath, tempDir, config, options) {
 import http from "node:http";
 import net from "node:net";
 import { createHash as createHash6, randomUUID } from "node:crypto";
-import { readFile as readFile23, stat as stat4 } from "node:fs/promises";
+import { readFile as readFile24, stat as stat4 } from "node:fs/promises";
 import path13 from "path";
 import { WebSocket, WebSocketServer } from "ws";
 
@@ -10177,7 +10253,7 @@ async function serveStatic(absPath, res, cacheControl = "no-store", extraHeaders
   }
   let data;
   try {
-    data = await readFile23(filePath);
+    data = await readFile24(filePath);
   } catch {
     res.writeHead(404);
     res.end("Not Found");
@@ -10227,7 +10303,7 @@ async function serveRevalidatedStatic(req, absPath, res, validators) {
   let data;
   if (!validator || validator.stamp !== stamp) {
     try {
-      data = await readFile23(absPath);
+      data = await readFile24(absPath);
     } catch {
       await serveStatic(absPath, res);
       return;
@@ -10568,7 +10644,7 @@ async function startPreviewServer(options) {
 import { platform, arch, release } from "node:os";
 
 // src/lib/remote-auth/token-store.ts
-import { chmod, mkdir as mkdir5, readFile as readFile24, rename as rename2, writeFile as writeFile6 } from "node:fs/promises";
+import { chmod, mkdir as mkdir5, readFile as readFile25, rename as rename2, writeFile as writeFile7 } from "node:fs/promises";
 import os3 from "node:os";
 import path14 from "node:path";
 function credentialHostKey(hostOrUrl) {
@@ -10612,7 +10688,7 @@ class FileTokenStore {
   async read() {
     let raw;
     try {
-      raw = await readFile24(this.filePath, "utf8");
+      raw = await readFile25(this.filePath, "utf8");
     } catch (e) {
       if (e?.code === "ENOENT") {
         return { version: 1, credentials: {} };
@@ -10624,7 +10700,7 @@ class FileTokenStore {
       if (parsed && typeof parsed === "object" && parsed.credentials)
         return parsed;
     } catch {
-      await writeFile6(`${this.filePath}.corrupt`, raw, {
+      await writeFile7(`${this.filePath}.corrupt`, raw, {
         encoding: "utf8",
         mode: 384
       }).catch(() => {});
@@ -10634,7 +10710,7 @@ class FileTokenStore {
   async write(data) {
     await mkdir5(path14.dirname(this.filePath), { recursive: true });
     const tmpPath = `${this.filePath}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
-    await writeFile6(tmpPath, JSON.stringify(data, null, 2), {
+    await writeFile7(tmpPath, JSON.stringify(data, null, 2), {
       encoding: "utf8",
       mode: 384
     });
@@ -10812,14 +10888,14 @@ async function getSystemDiagnostics() {
   };
 }
 // src/lib/project-scaffold.ts
-import { access, copyFile, cp as cp3, mkdir as mkdir9, readdir as readdir6, readFile as readFile28, stat as stat6, writeFile as writeFile7 } from "node:fs/promises";
+import { access, copyFile, cp as cp3, mkdir as mkdir9, readdir as readdir6, readFile as readFile29, stat as stat6, writeFile as writeFile8 } from "node:fs/promises";
 import { constants as FS, existsSync as existsSync13 } from "node:fs";
 import path18 from "node:path";
 
 // src/lib/manifest-doc.ts
 import { existsSync as existsSync11 } from "node:fs";
 import { randomUUID as randomUUID2 } from "node:crypto";
-import { mkdir as mkdir6, open, readFile as readFile25, rename as rename3, rm as rm2 } from "node:fs/promises";
+import { mkdir as mkdir6, open, readFile as readFile26, rename as rename3, rm as rm2 } from "node:fs/promises";
 import path15 from "node:path";
 import { parseDocument, isSeq, YAMLSeq } from "yaml";
 function resolveManifestPath(projectDir) {
@@ -10830,7 +10906,7 @@ async function loadManifestDoc(projectDir) {
   const file = resolveManifestPath(projectDir);
   let text = "";
   try {
-    text = await readFile25(file, "utf8");
+    text = await readFile26(file, "utf8");
   } catch (error2) {
     if (error2.code !== "ENOENT")
       throw error2;
@@ -10877,7 +10953,7 @@ function scalarString(item) {
 }
 
 // src/lib/extension-manager.ts
-import { cp as cp2, mkdir as mkdir8, readFile as readFile27, rm as rm4, stat as stat5 } from "node:fs/promises";
+import { cp as cp2, mkdir as mkdir8, readFile as readFile28, rm as rm4, stat as stat5 } from "node:fs/promises";
 import { existsSync as existsSync12 } from "node:fs";
 import path17 from "node:path";
 import { isSeq as isSeq2, isMap, isScalar, YAMLMap, Scalar } from "yaml";
@@ -10890,7 +10966,7 @@ import {
   mkdir as mkdir7,
   mkdtemp as mkdtemp2,
   open as open2,
-  readFile as readFile26,
+  readFile as readFile27,
   realpath as realpath2,
   rename as rename4,
   rm as rm3
@@ -11288,7 +11364,7 @@ async function readInstalledManifest(packageDir, selected) {
     const info2 = await lstat2(packageJsonPath);
     if (!info2.isFile() || info2.isSymbolicLink())
       throw new Error("not a regular file");
-    manifest = object3(JSON.parse(await readFile26(packageJsonPath, "utf8")));
+    manifest = object3(JSON.parse(await readFile27(packageJsonPath, "utf8")));
   } catch (error2) {
     throw new SecurityInstallError(`Downloaded ${selected.name}@${selected.version} has no valid package.json (${error2 instanceof Error ? error2.message : String(error2)}).`);
   }
@@ -12060,7 +12136,7 @@ async function readExtensionCss(projectDir, use) {
     throw new Error(`Extension "${use}" declares no stylesheets.`);
   const parts = [];
   for (const sheet of sheets)
-    parts.push(await readFile27(sheet, "utf8"));
+    parts.push(await readFile28(sheet, "utf8"));
   return parts.join(`
 
 `);
@@ -12187,7 +12263,7 @@ async function scaffoldProject(options) {
       await copyFile(tplManifest, path18.join(projectDir, MANIFEST_FILENAMES[0]));
       await copyFile(tplChapter, path18.join(projectDir, "chapter-01.md"));
       await mkdir9(path18.join(projectDir, "styles"), { recursive: true });
-      await writeFile7(path18.join(projectDir, "styles", "book.css"), starterOverridesCss(starterThemeId), "utf8");
+      await writeFile8(path18.join(projectDir, "styles", "book.css"), starterOverridesCss(starterThemeId), "utf8");
     }
   } catch (e) {
     throw new CreateProjectErrorImpl("scaffold-io", `Could not create the project files: ${e instanceof Error ? e.message : String(e)}`);
@@ -12302,7 +12378,7 @@ async function adoptFolder(options) {
     const bookCssPath = path18.join(dir, "styles", "book.css");
     const hadOwnStylesheet = existsSync13(bookCssPath);
     if (!hadOwnStylesheet) {
-      await writeFile7(bookCssPath, starterOverridesCss(themeId), "utf8");
+      await writeFile8(bookCssPath, starterOverridesCss(themeId), "utf8");
     }
     const filesYaml = mdFiles.map((f) => `    - "${escapeYamlScalar(f)}"`).join(`
 `);
@@ -12318,7 +12394,7 @@ ${filesYaml}
 styles:
   - styles/book.css
 `;
-    await writeFile7(path18.join(dir, MANIFEST_FILENAMES[0]), manifest, "utf8");
+    await writeFile8(path18.join(dir, MANIFEST_FILENAMES[0]), manifest, "utf8");
     await mkdir9(path18.join(dir, "assets"), { recursive: true });
     if (!hadOwnStylesheet) {
       await addBuiltInStyleSet(dir, themeId);
@@ -12361,10 +12437,10 @@ async function ensureGitignoreHasDist(projectDir) {
   const gitignorePath = path18.join(projectDir, ".gitignore");
   let existing = null;
   try {
-    existing = await readFile28(gitignorePath, "utf8");
+    existing = await readFile29(gitignorePath, "utf8");
   } catch {}
   if (existing === null) {
-    await writeFile7(gitignorePath, `dist/
+    await writeFile8(gitignorePath, `dist/
 `, "utf8");
     return;
   }
@@ -12374,14 +12450,14 @@ async function ensureGitignoreHasDist(projectDir) {
     return;
   const needsLeadingNewline = existing.length > 0 && !existing.endsWith(`
 `);
-  await writeFile7(gitignorePath, existing + (needsLeadingNewline ? `
+  await writeFile8(gitignorePath, existing + (needsLeadingNewline ? `
 ` : "") + `dist/
 `, "utf8");
 }
 async function firstSourceFile(manifestPath) {
   let text;
   try {
-    text = await readFile28(manifestPath, "utf8");
+    text = await readFile29(manifestPath, "utf8");
   } catch {
     return;
   }
@@ -12393,14 +12469,14 @@ async function firstSourceFile(manifestPath) {
   return m ? m[1].trim() : undefined;
 }
 async function fillTemplateFile(filePath, substitutions) {
-  let text = await readFile28(filePath, "utf8");
+  let text = await readFile29(filePath, "utf8");
   for (const [token, value] of Object.entries(substitutions)) {
     text = text.split(token).join(value);
   }
-  await writeFile7(filePath, text, "utf8");
+  await writeFile8(filePath, text, "utf8");
 }
 // src/lib/extension-scaffold.ts
-import { access as access2, mkdir as mkdir10, readFile as readFile29, writeFile as writeFile8 } from "node:fs/promises";
+import { access as access2, mkdir as mkdir10, readFile as readFile30, writeFile as writeFile9 } from "node:fs/promises";
 import { constants as FS2 } from "node:fs";
 import path19 from "node:path";
 var EXTENSION_KINDS = ["plugin", "theme"];
@@ -12517,9 +12593,9 @@ async function scaffoldExtension(options) {
       const src = await getAssetPath(`extension-templates/${kind}/${assetName}`);
       const dest = path19.join(extensionDir, relDest);
       await mkdir10(path19.dirname(dest), { recursive: true });
-      const text = await readFile29(src, "utf8");
+      const text = await readFile30(src, "utf8");
       const table = relDest.endsWith(".json") ? jsonSafe : plain;
-      await writeFile8(dest, substitute(text, table), "utf8");
+      await writeFile9(dest, substitute(text, table), "utf8");
       written.push(relDest);
     }
   } catch (e) {
@@ -12543,7 +12619,7 @@ function substitute(text, table) {
   return out;
 }
 // src/lib/project-templates.ts
-import { cp as cp4, mkdir as mkdir11, readFile as readFile30, readdir as readdir7, stat as stat7, writeFile as writeFile9 } from "node:fs/promises";
+import { cp as cp4, mkdir as mkdir11, readFile as readFile31, readdir as readdir7, stat as stat7, writeFile as writeFile10 } from "node:fs/promises";
 import { constants as FS3, existsSync as existsSync14 } from "node:fs";
 import { access as access3 } from "node:fs/promises";
 import path20 from "node:path";
@@ -12555,7 +12631,7 @@ var BUILT_IN_TEMPLATE_IDS = [
 ];
 async function readTemplateChoices(manifestPath) {
   try {
-    const text = await readFile30(manifestPath, "utf8");
+    const text = await readFile31(manifestPath, "utf8");
     const doc = parseDocument2(text);
     const out = {};
     const preset = doc.get("preset");
@@ -12724,7 +12800,7 @@ async function saveProjectAsTemplate(options) {
   const shared = manifestName ? await reconcileSharedRefs(dir, projectDir, options.sharedRefs ?? "vendor") : { vendoredRefs: [], excludedRefs: [] };
   if (manifestName)
     await retokeniseManifest(path20.join(dir, manifestName));
-  await writeFile9(path20.join(dir, TEMPLATE_META_FILE), JSON.stringify({ label: name }, null, 2), "utf8");
+  await writeFile10(path20.join(dir, TEMPLATE_META_FILE), JSON.stringify({ label: name }, null, 2), "utf8");
   return {
     id,
     label: name,
@@ -12737,12 +12813,12 @@ async function saveProjectAsTemplate(options) {
 async function retokeniseManifest(manifestPath) {
   let text;
   try {
-    text = await readFile30(manifestPath, "utf8");
+    text = await readFile31(manifestPath, "utf8");
   } catch {
     return;
   }
   text = text.replace(/^title:\s*.*$/m, 'title: "{{TITLE}}"').replace(/^(authors:[^\n]*\n[ \t]*-[ \t]*).*$/m, '$1"{{AUTHOR}}"');
-  await writeFile9(manifestPath, text, "utf8");
+  await writeFile10(manifestPath, text, "utf8");
 }
 async function listCustomTemplates(templatesRoot) {
   let entries;
@@ -12758,7 +12834,7 @@ async function listCustomTemplates(templatesRoot) {
     const dir = path20.join(templatesRoot, entry.name);
     let label = prettify(entry.name);
     try {
-      const meta = JSON.parse(await readFile30(path20.join(dir, TEMPLATE_META_FILE), "utf8"));
+      const meta = JSON.parse(await readFile31(path20.join(dir, TEMPLATE_META_FILE), "utf8"));
       if (typeof meta.label === "string" && meta.label)
         label = meta.label;
     } catch {}
@@ -12784,7 +12860,7 @@ async function importTemplateFromFolder(options) {
   return saveProjectAsTemplate({ projectDir: sourceDir, name, templatesRoot });
 }
 // src/lib/snippets.ts
-import { readdir as readdir8, readFile as readFile31, writeFile as writeFile10, mkdir as mkdir12, rm as rm5 } from "node:fs/promises";
+import { readdir as readdir8, readFile as readFile32, writeFile as writeFile11, mkdir as mkdir12, rm as rm5 } from "node:fs/promises";
 import path21 from "node:path";
 var SNIPPETS_DIR = "snippets";
 var PLACEHOLDER_RE = /\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g;
@@ -12826,7 +12902,7 @@ async function scanSnippetFiles(dir) {
       continue;
     let body = "";
     try {
-      body = await readFile31(path21.join(dir, fileName), "utf8");
+      body = await readFile32(path21.join(dir, fileName), "utf8");
     } catch {
       continue;
     }
@@ -12844,7 +12920,7 @@ async function listSnippets(projectDir) {
   return files.map((file) => ({ ...file, source: { kind: "project" } }));
 }
 async function readSnippet(projectDir, fileName) {
-  return readFile31(resolveSnippetPath(projectDir, fileName), "utf8");
+  return readFile32(resolveSnippetPath(projectDir, fileName), "utf8");
 }
 async function saveSnippet(projectDir, name, body) {
   const stem = slugify(name);
@@ -12853,7 +12929,7 @@ async function saveSnippet(projectDir, name, body) {
   const fileName = `${stem}.md`;
   const dir = path21.join(projectDir, SNIPPETS_DIR);
   await mkdir12(dir, { recursive: true });
-  await writeFile10(resolveSnippetPath(projectDir, fileName), body, "utf8");
+  await writeFile11(resolveSnippetPath(projectDir, fileName), body, "utf8");
   return { name, fileName, variables: extractVariables(body), source: { kind: "project" } };
 }
 async function deleteSnippet(projectDir, fileName) {
@@ -12903,11 +12979,11 @@ async function readExtensionSnippet(projectDir, source, fileName) {
   if (!dir) {
     throw new Error(`Extension "${source.ref}" does not declare a usable snippets folder.`);
   }
-  return readFile31(resolveSafeChildFile(dir, fileName), "utf8");
+  return readFile32(resolveSafeChildFile(dir, fileName), "utf8");
 }
 // src/lib/extension-import.ts
 import { existsSync as existsSync15 } from "node:fs";
-import { cp as cp5, mkdir as mkdir13, mkdtemp as mkdtemp3, readFile as readFile32, rm as rm6, writeFile as writeFile11 } from "node:fs/promises";
+import { cp as cp5, mkdir as mkdir13, mkdtemp as mkdtemp3, readFile as readFile33, rm as rm6, writeFile as writeFile12 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
 import path22 from "node:path";
 import { unzipSync } from "fflate";
@@ -12980,7 +13056,7 @@ async function finalizeExtensionImport(projectDir, sourceDir, relPaths, fallback
   if (!existsSync15(cssPath)) {
     throw new Error("A theme must contain a theme.css file.");
   }
-  const css = await readFile32(cssPath, "utf8");
+  const css = await readFile33(cssPath, "utf8");
   const { reject, warnings: printFindings } = classifyThemeCssFindings(checkCss(css, "theme.css"));
   if (reject) {
     throw new Error(`theme.css could not be parsed — ${reject.message}`);
@@ -13008,7 +13084,7 @@ async function finalizeExtensionImport(projectDir, sourceDir, relPaths, fallback
   for (let i = 0;i < extraSheets.length; i++) {
     const rel = extraSheets[i];
     const sheetPath = extraSheetPaths[i];
-    const sheetCss = await readFile32(sheetPath, "utf8");
+    const sheetCss = await readFile33(sheetPath, "utf8");
     const { reject: sheetReject, warnings: sheetFindings } = classifyThemeCssFindings(checkCss(sheetCss, rel));
     if (sheetReject) {
       throw new Error(`${rel} could not be parsed — ${sheetReject.message}`);
@@ -13041,14 +13117,14 @@ async function completeLandedManifest(dest, id, meta, metaExists) {
   let pkg = {};
   if (metaExists) {
     try {
-      const parsed = JSON.parse(await readFile32(file, "utf8"));
+      const parsed = JSON.parse(await readFile33(file, "utf8"));
       if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
         pkg = parsed;
       }
     } catch {}
   }
   const gutterpress = pkg.gutterpress && typeof pkg.gutterpress === "object" && !Array.isArray(pkg.gutterpress) ? pkg.gutterpress : {};
-  await writeFile11(file, JSON.stringify({
+  await writeFile12(file, JSON.stringify({
     ...pkg,
     name: typeof pkg.name === "string" && pkg.name.trim() ? pkg.name : id,
     gutterpress: { ...gutterpress, styles: ["theme.css"] }
@@ -13113,7 +13189,7 @@ async function importExtensionFromZip(projectDir, archive) {
       }
       relPaths.push(rel);
       await mkdir13(path22.dirname(dest), { recursive: true });
-      await writeFile11(dest, data);
+      await writeFile12(dest, data);
     }
     return await finalizeExtensionImport(projectDir, tmp, relPaths, root || "imported-look");
   } finally {
@@ -13128,8 +13204,8 @@ async function importExtensionFromCssText(projectDir, css, name) {
   const displayName = name.trim() || "Imported theme";
   const tmp = await mkdtemp3(path22.join(tmpdir3(), "gutterpress-theme-"));
   try {
-    await writeFile11(path22.join(tmp, "theme.css"), css, "utf8");
-    await writeFile11(path22.join(tmp, EXTENSION_MANIFEST_FILENAME), JSON.stringify({ name: slugify(displayName, "look"), gutterpress: { styles: ["theme.css"] } }, null, 2), "utf8");
+    await writeFile12(path22.join(tmp, "theme.css"), css, "utf8");
+    await writeFile12(path22.join(tmp, EXTENSION_MANIFEST_FILENAME), JSON.stringify({ name: slugify(displayName, "look"), gutterpress: { styles: ["theme.css"] } }, null, 2), "utf8");
     const result = await finalizeExtensionImport(projectDir, tmp, ["theme.css", EXTENSION_MANIFEST_FILENAME], displayName);
     result.warnings.unshift({
       code: "no-theme-json",
@@ -13143,11 +13219,11 @@ async function importExtensionFromCssText(projectDir, css, name) {
 async function importExtensionFromFile(projectDir, filePath) {
   const ext = path22.extname(filePath).toLowerCase();
   if (ext === ".zip") {
-    const buf = await readFile32(filePath);
+    const buf = await readFile33(filePath);
     return importExtensionFromZip(projectDir, new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength));
   }
   if (ext === ".css") {
-    const css = await readFile32(filePath, "utf8");
+    const css = await readFile33(filePath, "utf8");
     return importExtensionFromCssText(projectDir, css, prettify(path22.basename(filePath, ".css")));
   }
   throw new Error("Choose a .zip extension package or a .css stylesheet.");
@@ -13212,7 +13288,7 @@ async function importExtensionFromUrl(projectDir, url) {
   assertLooksLikeCss(css, trimmed);
   const tmp = await mkdtemp3(path22.join(tmpdir3(), "gutterpress-ext-"));
   try {
-    await writeFile11(path22.join(tmp, "theme.css"), css, "utf8");
+    await writeFile12(path22.join(tmp, "theme.css"), css, "utf8");
     const gp = meta.gutterpress && typeof meta.gutterpress === "object" && !Array.isArray(meta.gutterpress) ? meta.gutterpress : {};
     const finalMeta = {
       name: typeof meta.name === "string" && meta.name || slugify(baseName, "look"),
@@ -13224,7 +13300,7 @@ async function importExtensionFromUrl(projectDir, url) {
         preview: typeof gp.preview === "string" ? gp.preview : null
       }
     };
-    await writeFile11(path22.join(tmp, EXTENSION_MANIFEST_FILENAME), JSON.stringify(finalMeta, null, 2), "utf8");
+    await writeFile12(path22.join(tmp, EXTENSION_MANIFEST_FILENAME), JSON.stringify(finalMeta, null, 2), "utf8");
     return await finalizeExtensionImport(projectDir, tmp, ["theme.css", EXTENSION_MANIFEST_FILENAME], baseName);
   } finally {
     await rm6(tmp, { recursive: true, force: true });
@@ -14680,7 +14756,7 @@ async function diagnoseProjectRemote(projectDir, options = {}) {
 import git6 from "isomorphic-git";
 
 // src/lib/remote-auth/converge-merge.ts
-import { mkdir as mkdir15, unlink as unlink3, writeFile as writeFile12 } from "node:fs/promises";
+import { mkdir as mkdir15, unlink as unlink3, writeFile as writeFile13 } from "node:fs/promises";
 import path24 from "node:path";
 import git5 from "isomorphic-git";
 import diff3Merge from "diff3";
@@ -14730,7 +14806,7 @@ async function readBlobOrNull(dir, cache2, oid, filepath) {
 async function writeTreeFile(dir, filepath, content) {
   const abs = path24.join(dir, filepath);
   await mkdir15(path24.dirname(abs), { recursive: true });
-  await writeFile12(abs, content);
+  await writeFile13(abs, content);
 }
 async function bothAddedPaths(dir, cache2, ourTip, theirTip, allowUnrelated) {
   const bases = await git5.findMergeBase({ fs: gitFs, dir, cache: cache2, oids: [ourTip, theirTip] });
@@ -15248,7 +15324,7 @@ ${tail}` : ""}`);
 };
 
 // src/lib/publish/providers/guided.ts
-import { copyFile as copyFile2, mkdir as mkdir16, writeFile as writeFile13 } from "node:fs/promises";
+import { copyFile as copyFile2, mkdir as mkdir16, writeFile as writeFile14 } from "node:fs/promises";
 import path25 from "node:path";
 async function stageGuidedPackage(req, providerId, listingLines) {
   const packageDir = path25.join(path25.dirname(req.artifact.path), "publish", providerId);
@@ -15266,7 +15342,7 @@ async function stageGuidedPackage(req, providerId, listingLines) {
     ""
   ].join(`
 `);
-  await writeFile13(path25.join(packageDir, "LISTING.md"), sheet, "utf8");
+  await writeFile14(path25.join(packageDir, "LISTING.md"), sheet, "utf8");
   return packageDir;
 }
 
@@ -15329,7 +15405,7 @@ var drivethrurpgProvider = {
 };
 
 // src/lib/publish/providers/gdrive.ts
-import { mkdtemp as mkdtemp4, readFile as readFile33, readdir as readdir10, rm as rm8, stat as stat9, writeFile as writeFile14 } from "node:fs/promises";
+import { mkdtemp as mkdtemp4, readFile as readFile34, readdir as readdir10, rm as rm8, stat as stat9, writeFile as writeFile15 } from "node:fs/promises";
 import { tmpdir as tmpdir4 } from "node:os";
 import path26 from "node:path";
 import { Zip, ZipDeflate } from "fflate";
@@ -15721,12 +15797,12 @@ async function collectZipEntries(root, dir, out, onWarn) {
       await collectZipEntries(root, full, out, onWarn);
     } else if (entry.isFile()) {
       const rel = path26.relative(root, full).split(path26.sep).join("/");
-      out[rel] = await readFile33(full);
+      out[rel] = await readFile34(full);
     } else if (entry.isSymbolicLink()) {
       const resolved = await stat9(full).catch(() => null);
       if (resolved?.isFile()) {
         const rel = path26.relative(root, full).split(path26.sep).join("/");
-        out[rel] = await readFile33(full);
+        out[rel] = await readFile34(full);
       } else if (resolved?.isDirectory()) {
         await collectZipEntries(root, full, out, onWarn);
       } else {
@@ -15737,7 +15813,7 @@ async function collectZipEntries(root, dir, out, onWarn) {
     }
   }
 }
-async function zipHtmlExport(exportDir, title, onWarn, writeArchiveImpl = writeFile14) {
+async function zipHtmlExport(exportDir, title, onWarn, writeArchiveImpl = writeFile15) {
   const entries = {};
   await collectZipEntries(exportDir, exportDir, entries, onWarn);
   const fileName = `${bookSlug(title)}-website.zip`;
@@ -15841,7 +15917,7 @@ var gdriveProvider = {
 };
 
 // src/lib/publish/butler.ts
-import { chmod as chmod2, mkdir as mkdir17, stat as stat10, writeFile as writeFile15 } from "node:fs/promises";
+import { chmod as chmod2, mkdir as mkdir17, stat as stat10, writeFile as writeFile16 } from "node:fs/promises";
 import path27 from "node:path";
 import { unzipSync as unzipSync2 } from "fflate";
 var BUTLER_DOWNLOAD_TIMEOUT_MS = 300000;
@@ -15908,7 +15984,7 @@ async function ensureButler(deps) {
     if (name.endsWith("/"))
       continue;
     const target = path27.join(cacheDir, path27.basename(name));
-    await writeFile15(target, data);
+    await writeFile16(target, data);
     if (path27.basename(name) === butlerBinaryName()) {
       await chmod2(target, 493).catch(() => {});
       foundBinary = true;
@@ -16543,7 +16619,7 @@ async function disconnectPublishCredential(key, deps, options = {}) {
   }
 }
 // src/lib/publish/selections.ts
-import { chmod as chmod3, mkdir as mkdir18, readFile as readFile34, writeFile as writeFile16 } from "node:fs/promises";
+import { chmod as chmod3, mkdir as mkdir18, readFile as readFile35, writeFile as writeFile17 } from "node:fs/promises";
 import path29 from "node:path";
 class PublishSelectionsStore {
   filePath;
@@ -16553,7 +16629,7 @@ class PublishSelectionsStore {
   }
   async read() {
     try {
-      const raw = await readFile34(this.filePath, "utf8");
+      const raw = await readFile35(this.filePath, "utf8");
       const parsed = JSON.parse(raw);
       if (parsed && typeof parsed === "object") {
         return {
@@ -16567,7 +16643,7 @@ class PublishSelectionsStore {
   }
   async write(data) {
     await mkdir18(path29.dirname(this.filePath), { recursive: true });
-    await writeFile16(this.filePath, JSON.stringify(data, null, 2), {
+    await writeFile17(this.filePath, JSON.stringify(data, null, 2), {
       encoding: "utf8",
       mode: 384
     });
@@ -16669,4 +16745,4 @@ async function setPublishProviderConfig(projectDir, providerId, values) {
   await writeManifestDoc(file, doc);
   return settingsFromDoc(doc);
 }
-export { DEFAULT_NPM_REGISTRY, npmRegistryUrl, PLUGINS_DIR, BUNDLED_EXTENSIONS, isBundledExtension, isPathSpecifier, parseExtensionSpecifier, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, SYNC_SNAPSHOT_MESSAGE, log, resolveActiveStyles, listProjectStyles, EXTENSION_MANIFEST_FILENAME, readExtensionMeta, extensionStyleList, extensionEntry, extensionCarries, pathEscapesFolder, assertExtensionContained, resolveExtension, loadPluginsWithCss, formatReport, getChecks, getCheckById, resolveCheckSelectors, ruleRemoteUrls, ruleRiskyProps, ruleSyntax, rulePageContainment, checkCss, inspectImage, runChecks, checkToolAvailability, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, defaultConfigDir, FileTokenStore, extractUrlCredential, getSystemDiagnostics, EXTENSIONS_DIR, RECOMMENDED_EXTENSIONS, BUILT_IN_STYLE_SET_IDS, sameExtension, listProjectExtensions, describeExtension, setExtensionEnabled, reorderExtensions, removeExtension, addExtension, listBuiltInStyleSets, addBuiltInStyleSet, validateProjectExtensions, readExtensionCss, slugifyProjectName, escapeYamlScalar, scaffoldProject, adoptFolder, EXTENSION_KINDS, RESERVED_PREFIX, resolveExtensionPrefix, scaffoldExtension, BUILT_IN_TEMPLATE_IDS, listBuiltInTemplates, saveProjectAsTemplate, listCustomTemplates, importTemplateFromFolder, SNIPPETS_DIR, extractVariables, substituteVariables, listSnippets, readSnippet, saveSnippet, deleteSnippet, listMergedSnippets, readExtensionSnippet, importExtensionFromFile, importExtensionFromUrl, MAX_SEARCH_BYTES, SEARCH_KEYWORDS, searchNpmExtensions, setManifestFields, readManifestFields, setActiveStyles, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, AUTO_SYNC_PUSH_INTERVAL_MINUTES, autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, resolveGitHubClientId, GITHUB_HOST, GitHubAuthProvider, GDRIVE_HOST, resolveGoogleClientId, resolveGoogleClientSecret, GOOGLE_NOT_CONFIGURED_MESSAGE, requireGoogleClientCredentials, pkceChallengeFromVerifier, GoogleAuthProvider, revokeGoogleCredential, publishCredentialKey, publishConnectionStatus, listPublishAccounts, connectGoogleDrive, listGitHubRepositories, listRepoBooks, listGitHubBranches, sanitizeCloneFolderName, cloneRepository, isSshRemoteUrl, testRemoteAccess, knownForgeTokenUrl, connectGenericHost, parseRemoteOrigin, forgeKindForHost, diagnoseProjectRemote, syncProject, refreshRemoteCopies, listPublishProviders, publishProviderFor, resolvePublishFormat, resolvePublishRequest, runPublish, connectPublishProvider, disconnectPublishCredential, PublishSelectionsStore, readPublishSettings, setPublishProviderConfig };
+export { DEFAULT_NPM_REGISTRY, npmRegistryUrl, PLUGINS_DIR, BUNDLED_EXTENSIONS, isBundledExtension, isPathSpecifier, parseExtensionSpecifier, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, SYNC_SNAPSHOT_MESSAGE, log, resolveActiveStyles, listProjectStyles, EXTENSION_MANIFEST_FILENAME, readExtensionMeta, extensionStyleList, extensionEntry, extensionCarries, pathEscapesFolder, assertExtensionContained, resolveExtension, loadPluginsWithCss, getChecks, getCheckById, resolveCheckSelectors, formatReport, ruleRemoteUrls, ruleRiskyProps, ruleSyntax, rulePageContainment, checkCss, inspectImage, runChecks, checkToolAvailability, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, defaultConfigDir, FileTokenStore, extractUrlCredential, getSystemDiagnostics, EXTENSIONS_DIR, RECOMMENDED_EXTENSIONS, BUILT_IN_STYLE_SET_IDS, sameExtension, listProjectExtensions, describeExtension, setExtensionEnabled, reorderExtensions, removeExtension, addExtension, listBuiltInStyleSets, addBuiltInStyleSet, validateProjectExtensions, readExtensionCss, slugifyProjectName, escapeYamlScalar, scaffoldProject, adoptFolder, EXTENSION_KINDS, RESERVED_PREFIX, resolveExtensionPrefix, scaffoldExtension, BUILT_IN_TEMPLATE_IDS, listBuiltInTemplates, saveProjectAsTemplate, listCustomTemplates, importTemplateFromFolder, SNIPPETS_DIR, extractVariables, substituteVariables, listSnippets, readSnippet, saveSnippet, deleteSnippet, listMergedSnippets, readExtensionSnippet, importExtensionFromFile, importExtensionFromUrl, MAX_SEARCH_BYTES, SEARCH_KEYWORDS, searchNpmExtensions, setManifestFields, readManifestFields, setActiveStyles, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, AUTO_SYNC_PUSH_INTERVAL_MINUTES, autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, resolveGitHubClientId, GITHUB_HOST, GitHubAuthProvider, GDRIVE_HOST, resolveGoogleClientId, resolveGoogleClientSecret, GOOGLE_NOT_CONFIGURED_MESSAGE, requireGoogleClientCredentials, pkceChallengeFromVerifier, GoogleAuthProvider, revokeGoogleCredential, publishCredentialKey, publishConnectionStatus, listPublishAccounts, connectGoogleDrive, listGitHubRepositories, listRepoBooks, listGitHubBranches, sanitizeCloneFolderName, cloneRepository, isSshRemoteUrl, testRemoteAccess, knownForgeTokenUrl, connectGenericHost, parseRemoteOrigin, forgeKindForHost, diagnoseProjectRemote, syncProject, refreshRemoteCopies, listPublishProviders, publishProviderFor, resolvePublishFormat, resolvePublishRequest, runPublish, connectPublishProvider, disconnectPublishCredential, PublishSelectionsStore, readPublishSettings, setPublishProviderConfig };