@lupinum/ginko-content 0.1.2 → 0.1.3

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { existsSync } from 'node:fs';
-import { readFile, readdir, stat } from 'node:fs/promises';
+import { stat, readFile, readdir } from 'node:fs/promises';
 import { join, extname, relative } from 'node:path';
 
 const ignoredDirs = /* @__PURE__ */ new Set([
@@ -27,68 +27,124 @@ const sourceExtensions = /* @__PURE__ */ new Set([
   ".yml",
   ".yaml"
 ]);
-const stalePackageNames = ["@nuxt/content", "better-sqlite3", "@standard-schema/spec"];
-const sourceChecks = [
-  {
-    pattern: /from\s+['"]@nuxt\/content(?:\/[^'"]*)?['"]|import\s*\([^)]*['"]@nuxt\/content(?:\/[^'"]*)?['"][^)]*\)/,
-    message: "Direct Nuxt Content import found.",
-    suggestion: "Import Ginko helpers from @lupinum/ginko-content/config, /client, or /server."
-  },
-  {
-    pattern: /['"]@nuxt\/content['"]/,
-    message: "Nuxt Content module or package reference found.",
-    suggestion: "Remove @nuxt/content from Nuxt modules and use @lupinum/ginko-content."
-  },
-  {
-    pattern: /\bqueryCollectionItemSurroundings\s*\(/,
-    message: "Nuxt Content v3 surround helper found.",
-    suggestion: "Use useContentPage('docs', { surround: true }) in route page components."
-  },
-  {
-    pattern: /\bqueryCollectionSearchSections\s*\(/,
-    message: "Nuxt Content v3 search sections helper found.",
-    suggestion: "Use useContentSearchData('docs') for UI search data."
-  },
-  {
-    pattern: /\bqueryCollectionNavigation\s*\(/,
-    message: "Nuxt Content v3 navigation helper found.",
-    suggestion: "Use useContentNavigation('docs') for layout navigation."
-  },
-  {
-    pattern: /\bqueryCollection\s*\(/,
-    message: "Removed collection query helper found.",
-    suggestion: "Use one('docs', options), many('docs', options), paginate('docs', options), or the matching useContent* composable."
-  },
-  {
-    pattern: /\buseContentList\s*\(/,
-    message: "Removed content list composable found.",
-    suggestion: "Use useContentMany('docs', options) or many('docs', options)."
-  },
-  {
-    pattern: /\bcontent\.(database|preview|build)\b/,
-    message: "Nuxt Content v3 runtime config key found.",
-    suggestion: "Remove content.database/content.preview/content.build and configure Ginko runtime options instead."
-  },
-  {
-    pattern: /\.editor\s*\(/,
-    message: "Nuxt Studio Zod .editor(...) helper found.",
-    suggestion: "Remove .editor(...) from runtime Zod schemas or move editor metadata outside the schema."
-  },
-  {
-    pattern: /<ContentRenderer\b[^>]*:value\s*=\s*["'][^"']*\.body["']/,
-    message: "ContentRenderer is receiving a document body.",
-    suggestion: "Pass the full content document to ContentRenderer, not document.body."
-  },
-  {
-    pattern: /<NuxtLink\b[^>]*:to\s*=\s*["'][^"']+\._path["']/,
-    message: "NuxtLink is using raw content _path.",
-    suggestion: "Use useContentMany('docs', options) for list pages and bind the route-safe item.path field."
-  }
-];
-const lockfileNames = ["pnpm-lock.yaml", "package-lock.json", "yarn.lock", "bun.lockb"];
-const localeCodePattern = /^[a-z]{2}(?:-[A-Z]{2})?$/;
 const toRelativePath = (rootDir, file) => relative(rootDir, file) || ".";
+async function collectFiles(dir, rootDir, files = []) {
+  const entries = await readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const absolutePath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (!ignoredDirs.has(entry.name)) {
+        await collectFiles(absolutePath, rootDir, files);
+      }
+      continue;
+    }
+    if (entry.isFile() && sourceExtensions.has(extname(entry.name))) {
+      files.push(absolutePath);
+    }
+  }
+  return files;
+}
+async function collectOutputFiles(dir, rootDir, files = []) {
+  const entries = await readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const absolutePath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name !== "_nuxt") {
+        await collectOutputFiles(absolutePath, rootDir, files);
+      }
+      continue;
+    }
+    if (entry.isFile() && [".html", ".json", ".xml"].includes(extname(entry.name))) {
+      files.push(absolutePath);
+    }
+  }
+  return files;
+}
+async function readTextIfPresent(path) {
+  if (!existsSync(path)) {
+    return "";
+  }
+  const fileStat = await stat(path);
+  if (!fileStat.isFile()) {
+    return "";
+  }
+  return readFile(path, "utf8");
+}
+async function readPackageJson(rootDir) {
+  const path = join(rootDir, "package.json");
+  if (!existsSync(path)) {
+    return void 0;
+  }
+  try {
+    return JSON.parse(await readFile(path, "utf8"));
+  } catch {
+    return void 0;
+  }
+}
+function hasDependency(packageJson, packageName) {
+  if (!packageJson) {
+    return false;
+  }
+  return ["dependencies", "devDependencies", "optionalDependencies", "peerDependencies"].some((blockName) => {
+    const block = packageJson[blockName];
+    return !!block && typeof block === "object" && packageName in block;
+  });
+}
+
 const countSitemapUrls = (text) => (text.match(/<url>/g) || []).length;
+async function readGeneratedSitemaps(rootDir) {
+  const outputPublicDir = join(rootDir, ".output/public");
+  if (!existsSync(outputPublicDir)) {
+    return [];
+  }
+  const sitemapPaths = [
+    join(outputPublicDir, "sitemap.xml"),
+    join(outputPublicDir, "sitemap_index.xml")
+  ];
+  const sitemapDir = join(outputPublicDir, "__sitemap__");
+  if (existsSync(sitemapDir)) {
+    const entries = await readdir(sitemapDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isFile() && entry.name.endsWith(".xml")) {
+        sitemapPaths.push(join(sitemapDir, entry.name));
+      }
+    }
+  }
+  const sitemapFiles = [];
+  for (const sitemapPath of sitemapPaths) {
+    if (!existsSync(sitemapPath)) {
+      continue;
+    }
+    const fileStat = await stat(sitemapPath);
+    if (fileStat.isFile()) {
+      sitemapFiles.push({
+        file: toRelativePath(rootDir, sitemapPath),
+        text: await readFile(sitemapPath, "utf8")
+      });
+    }
+  }
+  return sitemapFiles;
+}
+async function inspectSitemap(rootDir) {
+  const sitemapFiles = await readGeneratedSitemaps(rootDir);
+  const sitemapTexts = sitemapFiles.map((file) => file.text);
+  if (!sitemapTexts.length) {
+    return [];
+  }
+  const urlCount = sitemapTexts.reduce((total, text) => total + countSitemapUrls(text), 0);
+  const hasSitemapIndex = sitemapTexts.some((text) => /<sitemapindex\b/.test(text));
+  if (urlCount > 0 || hasSitemapIndex) {
+    return [];
+  }
+  return [{
+    severity: "error",
+    file: ".output/public/sitemap.xml",
+    message: "Generated sitemap contains no <url> entries.",
+    suggestion: "Enable content.sitemap, configure site.url, and verify public route collections are sitemap-backed."
+  }];
+}
+
+const localeCodePattern = /^[a-z]{2}(?:-[A-Z]{2})?$/;
 function findMatchingBrace(text, start) {
   let depth = 0;
   let quote;
@@ -231,188 +287,6 @@ function extractStringArrayProperty(block, property) {
   }
   return [...match[1].matchAll(/['"]([^'"]+)['"]/g)].map((item) => item[1]);
 }
-async function collectFiles(dir, rootDir, files = []) {
-  const entries = await readdir(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const absolutePath = join(dir, entry.name);
-    if (entry.isDirectory()) {
-      if (!ignoredDirs.has(entry.name)) {
-        await collectFiles(absolutePath, rootDir, files);
-      }
-      continue;
-    }
-    if (entry.isFile() && sourceExtensions.has(extname(entry.name))) {
-      files.push(absolutePath);
-    }
-  }
-  return files;
-}
-function packageDependencyFindings(rootDir, packageJson) {
-  const dependencyBlocks = ["dependencies", "devDependencies", "optionalDependencies", "peerDependencies"];
-  const findings = [];
-  for (const blockName of dependencyBlocks) {
-    const block = packageJson[blockName];
-    if (!block || typeof block !== "object") {
-      continue;
-    }
-    for (const packageName of stalePackageNames) {
-      if (packageName in block) {
-        findings.push({
-          severity: "error",
-          file: toRelativePath(rootDir, join(rootDir, "package.json")),
-          message: `Direct dependency "${packageName}" found in ${blockName}.`,
-          suggestion: packageName === "@nuxt/content" ? "Remove @nuxt/content and install @lupinum/ginko-content." : `Remove ${packageName} unless the app imports it directly. If it is only transitive, keep it out of package.json.`
-        });
-      }
-    }
-  }
-  return findings;
-}
-async function inspectPackageJson(rootDir) {
-  const path = join(rootDir, "package.json");
-  if (!existsSync(path)) {
-    return [];
-  }
-  try {
-    const packageJson = JSON.parse(await readFile(path, "utf8"));
-    return packageDependencyFindings(rootDir, packageJson);
-  } catch {
-    return [{
-      severity: "error",
-      file: "package.json",
-      message: "package.json could not be parsed.",
-      suggestion: "Fix package.json before running ginko-content doctor again."
-    }];
-  }
-}
-async function inspectSourceFiles(rootDir) {
-  const files = await collectFiles(rootDir, rootDir);
-  const findings = [];
-  for (const file of files) {
-    if (lockfileNames.includes(file.split("/").pop() || "")) {
-      continue;
-    }
-    const text = await readFile(file, "utf8");
-    for (const check of sourceChecks) {
-      if (check.pattern.test(text)) {
-        findings.push({
-          severity: "error",
-          file: toRelativePath(rootDir, file),
-          message: check.message,
-          suggestion: check.suggestion
-        });
-      }
-    }
-  }
-  return findings;
-}
-async function inspectSearchCollections(rootDir) {
-  const contentConfig = await readTextIfPresent(join(rootDir, "content.config.ts"));
-  const nuxtConfig = await readTextIfPresent(join(rootDir, "nuxt.config.ts"));
-  if (!contentConfig || !nuxtConfig) {
-    return [];
-  }
-  const dataCollections = new Set(
-    findCollectionDefinitions(contentConfig).filter((collection) => /\btype\s*:\s*['"]data['"]/.test(collection.block)).map((collection) => collection.name)
-  );
-  if (!dataCollections.size) {
-    return [];
-  }
-  const configuredCollections = new Set(
-    findObjectPropertyBlocks(nuxtConfig, "search").flatMap((block) => extractStringArrayProperty(block, "collections"))
-  );
-  const dataSearchCollections = [...configuredCollections].filter((collection) => dataCollections.has(collection));
-  if (!dataSearchCollections.length) {
-    return [];
-  }
-  return [{
-    severity: "info",
-    file: "nuxt.config.ts",
-    message: `Data-only collections listed in content.search.collections: ${dataSearchCollections.join(", ")}.`,
-    suggestion: "Remove data-only collections from the static public search index, make them route-backed pages, or use provider-backed search with route-safe results."
-  }];
-}
-async function inspectLockfiles(rootDir) {
-  const findings = [];
-  for (const lockfileName of lockfileNames) {
-    const path = join(rootDir, lockfileName);
-    if (!existsSync(path)) {
-      continue;
-    }
-    const text = await readFile(path, "utf8");
-    const presentPackages = stalePackageNames.filter((packageName) => text.includes(packageName));
-    if (presentPackages.length) {
-      findings.push({
-        severity: "info",
-        file: lockfileName,
-        message: `Lockfile still mentions ${presentPackages.join(", ")}.`,
-        suggestion: `Run "pnpm why ${presentPackages.join(" ")}" and only act if one is still a direct app dependency.`
-      });
-    }
-  }
-  return findings;
-}
-async function readGeneratedSitemaps(rootDir) {
-  const outputPublicDir = join(rootDir, ".output/public");
-  if (!existsSync(outputPublicDir)) {
-    return [];
-  }
-  const sitemapPaths = [
-    join(outputPublicDir, "sitemap.xml"),
-    join(outputPublicDir, "sitemap_index.xml")
-  ];
-  const sitemapDir = join(outputPublicDir, "__sitemap__");
-  if (existsSync(sitemapDir)) {
-    const entries = await readdir(sitemapDir, { withFileTypes: true });
-    for (const entry of entries) {
-      if (entry.isFile() && entry.name.endsWith(".xml")) {
-        sitemapPaths.push(join(sitemapDir, entry.name));
-      }
-    }
-  }
-  const sitemapFiles = [];
-  for (const sitemapPath of sitemapPaths) {
-    if (!existsSync(sitemapPath)) {
-      continue;
-    }
-    const fileStat = await stat(sitemapPath);
-    if (fileStat.isFile()) {
-      sitemapFiles.push({
-        file: toRelativePath(rootDir, sitemapPath),
-        text: await readFile(sitemapPath, "utf8")
-      });
-    }
-  }
-  return sitemapFiles;
-}
-async function inspectSitemap(rootDir) {
-  const sitemapFiles = await readGeneratedSitemaps(rootDir);
-  const sitemapTexts = sitemapFiles.map((file) => file.text);
-  if (!sitemapTexts.length) {
-    return [];
-  }
-  const urlCount = sitemapTexts.reduce((total, text) => total + countSitemapUrls(text), 0);
-  const hasSitemapIndex = sitemapTexts.some((text) => /<sitemapindex\b/.test(text));
-  if (urlCount > 0 || hasSitemapIndex) {
-    return [];
-  }
-  return [{
-    severity: "error",
-    file: ".output/public/sitemap.xml",
-    message: "Generated sitemap contains no <url> entries.",
-    suggestion: "Enable content.sitemap, configure site.url, and verify public route collections are sitemap-backed."
-  }];
-}
-async function readTextIfPresent(path) {
-  if (!existsSync(path)) {
-    return "";
-  }
-  const fileStat = await stat(path);
-  if (!fileStat.isFile()) {
-    return "";
-  }
-  return readFile(path, "utf8");
-}
 function extractLocaleCodesFromConfig(text) {
   const locales = /* @__PURE__ */ new Set();
   for (const match of text.matchAll(/\bcode\s*:\s*['"]([^'"]+)['"]/g)) {
@@ -437,26 +311,7 @@ function extractLocaleCodesFromConfig(text) {
   }
   return [...locales];
 }
-async function readPackageJson(rootDir) {
-  const path = join(rootDir, "package.json");
-  if (!existsSync(path)) {
-    return void 0;
-  }
-  try {
-    return JSON.parse(await readFile(path, "utf8"));
-  } catch {
-    return void 0;
-  }
-}
-function hasDependency(packageJson, packageName) {
-  if (!packageJson) {
-    return false;
-  }
-  return ["dependencies", "devDependencies", "optionalDependencies", "peerDependencies"].some((blockName) => {
-    const block = packageJson[blockName];
-    return !!block && typeof block === "object" && packageName in block;
-  });
-}
+
 async function detectI18n(rootDir) {
   const nuxtConfigPath = join(rootDir, "nuxt.config.ts");
   const contentConfigPath = join(rootDir, "content.config.ts");
@@ -633,22 +488,6 @@ async function inspectI18nDuplicateContentGroups(rootDir, locales) {
   }
   return findings;
 }
-async function collectOutputFiles(dir, rootDir, files = []) {
-  const entries = await readdir(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const absolutePath = join(dir, entry.name);
-    if (entry.isDirectory()) {
-      if (entry.name !== "_nuxt") {
-        await collectOutputFiles(absolutePath, rootDir, files);
-      }
-      continue;
-    }
-    if (entry.isFile() && [".html", ".json", ".xml"].includes(extname(entry.name))) {
-      files.push(absolutePath);
-    }
-  }
-  return files;
-}
 async function inspectRepeatedLocalePrefixes(rootDir, locales) {
   const outputPublicDir = join(rootDir, ".output/public");
   if (!existsSync(outputPublicDir)) {
@@ -769,23 +608,189 @@ async function inspectI18n(rootDir) {
     ...await inspectI18nSearchIndex(rootDir, detected.locales)
   ];
 }
-async function runDoctor(options = {}) {
-  const rootDir = options.rootDir || process.cwd();
-  const findings = [
+
+const stalePackageNames = ["@nuxt/content", "better-sqlite3", "@standard-schema/spec"];
+const lockfileNames = ["pnpm-lock.yaml", "package-lock.json", "yarn.lock", "bun.lockb"];
+
+function packageDependencyFindings(rootDir, packageJson) {
+  const dependencyBlocks = ["dependencies", "devDependencies", "optionalDependencies", "peerDependencies"];
+  const findings = [];
+  for (const blockName of dependencyBlocks) {
+    const block = packageJson[blockName];
+    if (!block || typeof block !== "object") {
+      continue;
+    }
+    for (const packageName of stalePackageNames) {
+      if (packageName in block) {
+        findings.push({
+          severity: "error",
+          file: toRelativePath(rootDir, join(rootDir, "package.json")),
+          message: `Direct dependency "${packageName}" found in ${blockName}.`,
+          suggestion: packageName === "@nuxt/content" ? "Remove @nuxt/content and install @lupinum/ginko-content." : `Remove ${packageName} unless the app imports it directly. If it is only transitive, keep it out of package.json.`
+        });
+      }
+    }
+  }
+  return findings;
+}
+async function inspectPackageJson(rootDir) {
+  const path = join(rootDir, "package.json");
+  if (!existsSync(path)) {
+    return [];
+  }
+  try {
+    const packageJson = JSON.parse(await readFile(path, "utf8"));
+    return packageDependencyFindings(rootDir, packageJson);
+  } catch {
+    return [{
+      severity: "error",
+      file: "package.json",
+      message: "package.json could not be parsed.",
+      suggestion: "Fix package.json before running ginko-content doctor again."
+    }];
+  }
+}
+async function inspectLockfiles(rootDir) {
+  const findings = [];
+  for (const lockfileName of lockfileNames) {
+    const path = join(rootDir, lockfileName);
+    if (!existsSync(path)) {
+      continue;
+    }
+    const text = await readFile(path, "utf8");
+    const presentPackages = stalePackageNames.filter((packageName) => text.includes(packageName));
+    if (presentPackages.length) {
+      findings.push({
+        severity: "info",
+        file: lockfileName,
+        message: `Lockfile still mentions ${presentPackages.join(", ")}.`,
+        suggestion: `Run "pnpm why ${presentPackages.join(" ")}" and only act if one is still a direct app dependency.`
+      });
+    }
+  }
+  return findings;
+}
+async function inspectDependencies(rootDir) {
+  return [
     ...await inspectPackageJson(rootDir),
-    ...await inspectSourceFiles(rootDir),
-    ...await inspectSearchCollections(rootDir),
-    ...await inspectLockfiles(rootDir),
-    ...await inspectSitemap(rootDir),
-    ...options.i18n ? await inspectI18n(rootDir) : []
-  ].sort((a, b) => `${a.severity}:${a.file}:${a.message}`.localeCompare(`${b.severity}:${b.file}:${b.message}`));
-  const exitCode = findings.some((finding) => finding.severity === "error") ? 1 : 0;
-  return {
-    rootDir,
-    findings,
-    exitCode
-  };
+    ...await inspectLockfiles(rootDir)
+  ];
 }
+
+async function inspectSourceChecks(rootDir, checks) {
+  const files = await collectFiles(rootDir, rootDir);
+  const findings = [];
+  for (const file of files) {
+    if (lockfileNames.includes(file.split("/").pop() || "")) {
+      continue;
+    }
+    const text = await readFile(file, "utf8");
+    for (const check of checks) {
+      if (check.pattern.test(text)) {
+        findings.push({
+          severity: "error",
+          file: toRelativePath(rootDir, file),
+          message: check.message,
+          suggestion: check.suggestion
+        });
+      }
+    }
+  }
+  return findings;
+}
+
+async function inspectPublicApiUsage(rootDir) {
+  return inspectSourceChecks(rootDir, [
+    {
+      pattern: /from\s+['"]@nuxt\/content(?:\/[^'"]*)?['"]|import\s*\([^)]*['"]@nuxt\/content(?:\/[^'"]*)?['"][^)]*\)/,
+      message: "Direct Nuxt Content import found.",
+      suggestion: "Import Ginko helpers from @lupinum/ginko-content/config, /client, or /server."
+    },
+    {
+      pattern: /['"]@nuxt\/content['"]/,
+      message: "Nuxt Content module or package reference found.",
+      suggestion: "Remove @nuxt/content from Nuxt modules and use @lupinum/ginko-content."
+    },
+    {
+      pattern: /\bqueryCollectionItemSurroundings\s*\(/,
+      message: "Nuxt Content v3 surround helper found.",
+      suggestion: "Use useContentPage('docs', { surround: true }) in route page components."
+    },
+    {
+      pattern: /\bqueryCollectionSearchSections\s*\(/,
+      message: "Nuxt Content v3 search sections helper found.",
+      suggestion: "Use useContentSearchData('docs') for UI search data."
+    },
+    {
+      pattern: /\bqueryCollectionNavigation\s*\(/,
+      message: "Nuxt Content v3 navigation helper found.",
+      suggestion: "Use useContentNavigation('docs') for layout navigation."
+    },
+    {
+      pattern: /\bqueryCollection\s*\(/,
+      message: "Removed collection query helper found.",
+      suggestion: "Use one('docs', options), many('docs', options), paginate('docs', options), or the matching useContent* composable."
+    },
+    {
+      pattern: /\buseContentList\s*\(/,
+      message: "Removed content list composable found.",
+      suggestion: "Use useContentMany('docs', options) or many('docs', options)."
+    },
+    {
+      pattern: /\bcontent\.(database|preview|build)\b/,
+      message: "Nuxt Content v3 runtime config key found.",
+      suggestion: "Remove content.database/content.preview/content.build and configure Ginko runtime options instead."
+    },
+    {
+      pattern: /\.editor\s*\(/,
+      message: "Nuxt Studio Zod .editor(...) helper found.",
+      suggestion: "Remove .editor(...) from runtime Zod schemas or move editor metadata outside the schema."
+    }
+  ]);
+}
+
+async function inspectRenderingUsage(rootDir) {
+  return inspectSourceChecks(rootDir, [
+    {
+      pattern: /<ContentRenderer\b[^>]*:value\s*=\s*["'][^"']*\.body["']/,
+      message: "ContentRenderer is receiving a document body.",
+      suggestion: "Pass the full content document to ContentRenderer, not document.body."
+    },
+    {
+      pattern: /<NuxtLink\b[^>]*:to\s*=\s*["'][^"']+\._path["']/,
+      message: "NuxtLink is using raw content _path.",
+      suggestion: "Use useContentMany('docs', options) for list pages and bind the route-safe item.path field."
+    }
+  ]);
+}
+
+async function inspectSearchCollections(rootDir) {
+  const contentConfig = await readTextIfPresent(join(rootDir, "content.config.ts"));
+  const nuxtConfig = await readTextIfPresent(join(rootDir, "nuxt.config.ts"));
+  if (!contentConfig || !nuxtConfig) {
+    return [];
+  }
+  const dataCollections = new Set(
+    findCollectionDefinitions(contentConfig).filter((collection) => /\btype\s*:\s*['"]data['"]/.test(collection.block)).map((collection) => collection.name)
+  );
+  if (!dataCollections.size) {
+    return [];
+  }
+  const configuredCollections = new Set(
+    findObjectPropertyBlocks(nuxtConfig, "search").flatMap((block) => extractStringArrayProperty(block, "collections"))
+  );
+  const dataSearchCollections = [...configuredCollections].filter((collection) => dataCollections.has(collection));
+  if (!dataSearchCollections.length) {
+    return [];
+  }
+  return [{
+    severity: "info",
+    file: "nuxt.config.ts",
+    message: `Data-only collections listed in content.search.collections: ${dataSearchCollections.join(", ")}.`,
+    suggestion: "Remove data-only collections from the static public search index, make them route-backed pages, or use provider-backed search with route-safe results."
+  }];
+}
+
 function formatDoctorResult(result) {
   const errors = result.findings.filter((finding) => finding.severity === "error");
   const infos = result.findings.filter((finding) => finding.severity === "info");
@@ -811,6 +816,24 @@ function formatDoctorResult(result) {
 `;
 }
 
+async function runDoctor(options = {}) {
+  const rootDir = options.rootDir || process.cwd();
+  const findings = [
+    ...await inspectDependencies(rootDir),
+    ...await inspectPublicApiUsage(rootDir),
+    ...await inspectRenderingUsage(rootDir),
+    ...await inspectSearchCollections(rootDir),
+    ...await inspectSitemap(rootDir),
+    ...options.i18n ? await inspectI18n(rootDir) : []
+  ].sort((a, b) => `${a.severity}:${a.file}:${a.message}`.localeCompare(`${b.severity}:${b.file}:${b.message}`));
+  const exitCode = findings.some((finding) => finding.severity === "error") ? 1 : 0;
+  return {
+    rootDir,
+    findings,
+    exitCode
+  };
+}
+
 const [, , command, ...args] = process.argv;
 if (!command || command === "--help" || command === "-h") {
   console.log([

package/dist/cms-import/index.js

@@ -31,7 +31,11 @@ async function extractEditableSource(id, source) {
   if (/\.(md|mdc|markdown)$/i.test(id)) {
     return parseMarkdownEditableSource(source);
   }
-  if (/\.json5?$/i.test(id)) {
+  if (/\.json5$/i.test(id)) {
+    const json5 = await import("json5").then((m) => m.default || m);
+    return { frontmatter: normalizeRecord(json5.parse(source)) };
+  }
+  if (/\.json$/i.test(id)) {
     return { frontmatter: normalizeRecord(destr(source)) };
   }
   if (/\.ya?ml$/i.test(id)) {

package/dist/config.d.mts

@@ -1,3 +1,3 @@
-export { CollectionSchema, ContentCmsCollectionConfig, ContentCmsFieldConfig, ContentCmsFieldType, ContentCmsRelationConfig, ContentCollectionConfig, ContentCollectionI18nConfig, ContentCollectionKind, ContentCollectionSource, ContentCollectionSourceObject, ContentConfig, ContentReferenceSchema, DefineCollectionObject, DefineCollectionOptions, defineCollection, defineContentConfig, reference } from '../dist/types/config';
+export { AgentMetadataField, AgentMetadataFieldList, CollectionSchema, ContentAgentCollectionConfig, ContentAgentMarkdownOptions, ContentCmsCollectionConfig, ContentCmsFieldConfig, ContentCmsFieldType, ContentCmsRelationConfig, ContentCollectionConfig, ContentCollectionI18nConfig, ContentCollectionKind, ContentCollectionSource, ContentCollectionSourceObject, ContentConfig, ContentReferenceSchema, DefineCollectionObject, DefineCollectionOptions, agentMetadataFields, defineAgentAppPage, defineAgentMarkdownPolicy, defineAgentMetadataFields, defineAgentSection, defineCollection, defineContentConfig, reference } from '../dist/types/config';
 export { ContentFieldMetadata, ContentFieldSchema, asset, fields, file, getContentFieldMetadata, image, isContentFieldSchema, relation, relations, richtext, text } from '../dist/types/fields';
 export { SlugifyUrlSegmentOptions, slugifyUrlSegment } from '../dist/core/content/slug';

package/dist/config.mjs

@@ -1,3 +1,3 @@
-export { defineCollection, defineContentConfig, reference } from '../dist/types/config';
+export { agentMetadataFields, defineAgentAppPage, defineAgentMarkdownPolicy, defineAgentMetadataFields, defineAgentSection, defineCollection, defineContentConfig, reference } from '../dist/types/config';
 export { asset, fields, file, getContentFieldMetadata, image, isContentFieldSchema, relation, relations, richtext, text } from '../dist/types/fields';
 export { slugifyUrlSegment } from '../dist/core/content/slug';