@conduction/docusaurus-preset 3.6.0 → 3.6.2

package/bin/validate-ai-baseline.mjs

@@ -87,19 +87,25 @@ check('sitemap.xml exists and has at least 1 URL', () => {
   return {ok: true, msg: `${n} URLs`};
 });
 
-/* sitemap.xml should ship <lastmod> on every URL. Google treats lastmod
-   as the only sitemap-level signal that actually informs recrawl
-   priority, and only when it's trustworthy. Sites that ship priority +
-   changefreq without lastmod (the Docusaurus default before preset
-   3.6.0) get treated as having no freshness signal. */
-check('sitemap.xml emits <lastmod> on URLs', () => {
+/* sitemap.xml lastmod check is informational only. Google treats
+   lastmod as the only sitemap-level signal that actually informs
+   recrawl priority, but applying it requires per-site docusaurus.config
+   changes (sites that override `presets:` don't pick up the preset's
+   DEFAULT_SITEMAP_OPTIONS automatically). Warning here surfaces the
+   gap without blocking deploy on fleet sites that haven't adopted
+   the new sitemap config yet. Promote back to hard-fail in a future
+   release once the preset wraps user presets to inject sitemap defaults
+   automatically. */
+check('sitemap.xml emits <lastmod> on URLs (advisory, not fatal)', () => {
   const body = readBuild('sitemap.xml');
   const locCount = (body.match(/<loc>/g) || []).length;
   const lastmodCount = (body.match(/<lastmod>/g) || []).length;
   if (locCount === 0) return {ok: false, msg: 'no <loc> entries to compare against'};
-  if (lastmodCount === 0) return {ok: false, msg: `0 / ${locCount} URLs have <lastmod> — enable sitemap.lastmod in docusaurus.config`};
+  if (lastmodCount === 0) {
+    /* Surface as a "passed with note" rather than fail. */
+    return {ok: true, msg: `WARN 0 / ${locCount} URLs have <lastmod> (enable sitemap.lastmod in docusaurus.config)`};
+  }
   const ratio = lastmodCount / locCount;
-  if (ratio < 0.5) return {ok: false, msg: `only ${lastmodCount} / ${locCount} URLs have <lastmod>`};
   return {ok: true, msg: `${lastmodCount} / ${locCount} URLs (${Math.round(ratio * 100)}%)`};
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@conduction/docusaurus-preset",
-  "version": "3.6.0",
+  "version": "3.6.2",
   "scripts": {
     "prepack": "node scripts/prepack-bundle-css.js"
   },

package/src/index.js

@@ -232,9 +232,11 @@ function buildAiHeadTags(opts) {
  *
  * Sites with locale-specific tag pages and pagination should keep the
  * exclude list in sync. Pagination (`/page/N/`) and tag pages
- * (`/tags/*/`) are documented Docusaurus duplicate-content traps;
+ * (`/tags/{slug}/`) are documented Docusaurus duplicate-content traps;
  * we exclude them by default so they neither dilute crawl budget nor
- * confuse AI summarisers.
+ * confuse AI summarisers. (Do not write `/tags/*` followed by a slash
+ * in this comment: the literal asterisk-slash sequence would close
+ * the JSDoc block and break preset parsing for every consuming site.)
  */
 const DEFAULT_SITEMAP_OPTIONS = {
   changefreq: null,