feat(docs): sitemap for all rule pages + dashboard CTA on every rule page

Two SEO/growth changes on docs.the-doctor.report.

Sitemap: docs.the-doctor.report/sitemap.xml was 404, so Google had no efficient
way to discover the 105 generated rule pages — the entire programmatic-SEO
surface was invisible. Added @nuxtjs/sitemap + @nuxtjs/robots. The @nuxt/content
v3 integration is NOT automatic: the collection must opt in via
`sitemap: defineSitemapSchema()` from '@nuxtjs/sitemap/content', and
@nuxtjs/sitemap must load BEFORE @nuxt/content (verified against the installed
8.2.2 package, not assumed). Sitemap now enumerates 111 URLs incl. all 105 rule
pages (was 0), verified via a local worker.

CTA: each generated rule page now ends with a callout linking to
app.the-doctor.report (utm_source=docs&utm_medium=rule-page&utm_campaign=
rule-cta) — 103 long-tail rule pages become 103 conversion funnels to the
hosted dashboard. Wired into the codegen template so it stays in sync with the
registry.

Reverted 16 files of docs-local oxfmt-0.55 churn (the standalone oxfmt disagrees
with the root vp fmt that CI actually gates on) — diff is scoped to the 4
functional files. Gate: oxlint 0, eslint 0, build 0, sitemap + CTA both live-
verified.

Signed-off-by: Vinayak Kulkarni <19776877+vinayakkulkarni@users.noreply.github.com>

Author: vinayakkulkarni

apps/docs/content.config.ts

@@ -1,4 +1,5 @@
 import { defineCollection, defineContentConfig, z } from '@nuxt/content';
+import { defineSitemapSchema } from '@nuxtjs/sitemap/content';
 
 export default defineContentConfig({
   collections: {
@@ -7,6 +8,7 @@ export default defineContentConfig({
       source: '**/*.md',
       schema: z.object({
         description: z.string().optional(),
+        sitemap: defineSitemapSchema(),
       }),
     }),
   },

apps/docs/nuxt.config.ts

@@ -24,6 +24,11 @@ export default defineNuxtConfig({
   },
 
   modules: [
+    // Order is load-bearing: robots before sitemap (injects the sitemap URL
+    // into robots.txt), and sitemap before @nuxt/content (v8 sitemap only
+    // enumerates Content v3 collections registered before it).
+    '@nuxtjs/robots',
+    '@nuxtjs/sitemap',
     '@nuxt/content',
     '@nuxt/eslint',
     '@nuxt/icon',
@@ -103,6 +108,10 @@ export default defineNuxtConfig({
     },
   },
 
+  site: {
+    url: process.env.NUXT_PUBLIC_BASE_URL || 'https://docs.the-doctor.report',
+  },
+
   content: {
     build: {
       markdown: {

apps/docs/package.json

@@ -27,6 +27,8 @@
     "@nuxt/icon": "^2.2.5",
     "@nuxtjs/color-mode": "^4.0.1",
     "@nuxtjs/plausible": "^3.0.2",
+    "@nuxtjs/robots": "^6.1.2",
+    "@nuxtjs/sitemap": "^8.2.2",
     "@vueuse/core": "^14.3.0",
     "@vueuse/nuxt": "^14.3.0",
     "better-sqlite3": "^12.11.1",

apps/docs/scripts/generate-rule-pages.ts

@@ -135,6 +135,10 @@ for (const rule of RULE_REGISTRY) {
     '',
     `See the [category overview](${overviewHref}) for the full rule catalogue.`,
     '',
+    '::callout{type="tip"}',
+    `Want this rule enforced on every push? [the-doctor.report](https://app.the-doctor.report/?utm_source=docs&utm_medium=rule-page&utm_campaign=rule-cta) tracks your score over time, gates PRs on \`${rule.id}\`, and shows the trend across every branch — free while in early access.`,
+    '::',
+    '',
   ].join('\n');
 
   writeFileSync(rulePath, body, 'utf8');