Introduce a canonical config API with backward-compatible normalization

.changeset/canonical-config-api.md

@@ -0,0 +1,11 @@
+---
+"leadtype": minor
+---
+
+Add a canonical config vocabulary and one resolved-config normalizer.
+
+`defineLeadtypeConfig` names the project/site config in `leadtype.config.ts`, alongside `defineDocsConfig` for a source repo's content-owned `docs.config.ts`. Three collection fields are renamed: `prefix` → `routePrefix`, `sourceConfig` → `inheritConfig`, `schema` → `frontmatterSchema`.
+
+Every existing config keeps working. Both spellings normalize to one internal `ResolvedDocsConfig` that generate, sync, lint, score, and the runtime source all read, so no subsystem re-derives the project from raw config. The resolved shape adds a deduped source graph — collections sharing a `(repository, ref)` resolve to one acquisition — and per-field provenance recording whether each value was authored, inherited from a source repo, inferred, or defaulted.
+
+Deprecated fields carry `@deprecated` guidance in the IDE and warn once per config file at load. Setting an old name and its replacement together is an error naming both rather than a silent precedence rule. Nothing is removed before 1.0.

apps/next-example/leadtype.config.ts

@@ -1,7 +1,7 @@
 import { execSync } from "node:child_process";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { defineCollection, defineDocsConfig } from "leadtype";
+import { defineCollection, defineLeadtypeConfig } from "leadtype";
 
 const appDir = path.dirname(fileURLToPath(import.meta.url));
 const repoRoot = path.resolve(appDir, "../..");
@@ -33,7 +33,7 @@ function resolveExampleSourceRef(): string {
   }
 }
 
-export default defineDocsConfig({
+export default defineLeadtypeConfig({
   product: {
     name: "Leadtype",
     tagline:
@@ -53,8 +53,8 @@ export default defineDocsConfig({
       cacheDir: ".leadtype",
       dir: "docs",
       mounts: [{ pathPrefix: "changelog", urlPrefix: "/changelog" }],
-      prefix: "/docs",
-      sourceConfig: true,
+      routePrefix: "/docs",
+      inheritConfig: true,
     }),
   },
   feeds: [

apps/sveltekit-example/static/mcp.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json",
+  "version": "1.0",
+  "protocolVersion": "2025-06-18",
+  "name": "leadtype-docs",
+  "description": "A docs pipeline that turns one MDX source into a website, agent-readable artifacts, and a search index.",
+  "serverUrl": "http://localhost:5173/mcp",
+  "tools": [
+    {
+      "name": "search-docs",
+      "title": "Search documentation",
+      "description": "Search the documentation and return ranked results ({ title, urlPath, snippet }). Use get-page to read a full result.",
+      "annotations": {
+        "idempotentHint": true,
+        "readOnlyHint": true
+      }
+    },
+    {
+      "name": "get-page",
+      "title": "Get a documentation page",
+      "description": "Return the full Markdown of one documentation page by its urlPath (e.g. the urlPath from a search-docs result).",
+      "annotations": {
+        "idempotentHint": true,
+        "readOnlyHint": true
+      }
+    }
+  ],
+  "serverInfo": {
+    "name": "leadtype-docs",
+    "version": "1.0.0",
+    "description": "A docs pipeline that turns one MDX source into a website, agent-readable artifacts, and a search index.",
+    "instructions": "Search and read the documentation for A docs pipeline that turns one MDX source into a website, agent-readable artifacts, and a search index."
+  },
+  "transport": {
+    "type": "streamable-http",
+    "endpoint": "http://localhost:5173/mcp"
+  },
+  "capabilities": {
+    "tools": {}
+  },
+  "authentication": {
+    "required": false
+  }
+}

apps/sveltekit-example/static/robots.txt

@@ -0,0 +1,211 @@
+User-agent: *
+Content-Signal: ai-train=no, search=yes, ai-input=yes
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: OAI-SearchBot
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: ChatGPT-User
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: PerplexityBot
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: Perplexity-User
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: ClaudeBot
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: Claude-SearchBot
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: Claude-User
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: Claude-Web
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: Gemini-Deep-Research
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: DeepSeekBot
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: Meta-ExternalFetcher
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: AmazonBot
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: Amazonbot
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: Bingbot
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: MistralBot
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: AppleBot
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: YouBot
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: GPTBot
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: Google-Extended
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: CCBot
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: ByteSpider
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: Bytespider
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: anthropic-ai
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: MetaExternalAgent
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+User-agent: Applebot-Extended
+Allow: /
+Allow: /docs/
+Allow: /llms.txt
+Allow: /docs/llms.txt
+Allow: /sitemap.xml
+Allow: /sitemap.md
+
+Sitemap: http://localhost:5173/sitemap.xml
+Schemamap: http://localhost:5173/schema-map.xml

apps/sveltekit-example/static/schema-map.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<schemamap>
+  <feed>
+    <loc>http://localhost:5173/feeds/schema.jsonl</loc>
+    <format>application/jsonl</format>
+    <itemType>https://schema.org/TechArticle</itemType>
+  </feed>
+</schemamap>