feat: enable AI-ready Blume docs

.gitattributes

@@ -0,0 +1 @@
+patches/*.patch -whitespace

blume.config.ts

@@ -3,9 +3,21 @@ import { defineConfig } from "blume";
 export default defineConfig({
   title: "Spacefast Docs",
   description: "Build and publish static sites with Spacefast.",
+  analytics: {
+    posthog: {
+      key: "phc_pnLfu3acyQJbpNz4YYdv4ULaXgafVtUrsZT8wHwijmQT",
+    },
+  },
   content: {
     root: "content",
   },
+  export: true,
+  github: {
+    owner: "spacefast",
+    repo: "docs",
+    branch: "main",
+  },
+  lastModified: true,
   navigation: {
     featured: [
       { label: "Spacefast", href: "https://spacefast.com", icon: "house" },
@@ -15,7 +27,7 @@ export default defineConfig({
         icon: "book-open",
       },
     ],
-    repo: false,
+    repo: true,
     sidebar: {
       display: "group",
       items: [
@@ -103,15 +115,30 @@ export default defineConfig({
         label: "Platform API",
         route: "/platforms/api/reference",
         spec: "./generated/openapi/platform.json",
+        includeInLlms: false,
+        includeInSearch: false,
+        noindex: true,
       },
     ],
   },
   search: {
     provider: "pagefind",
+    popular: [
+      { label: "Quickstart", href: "/quickstart", icon: "rocket" },
+      { label: "Agents", href: "/agents", icon: "bot" },
+      { label: "Publishing", href: "/publishing", icon: "upload" },
+      { label: "API reference", href: "/api/reference", icon: "braces" },
+    ],
   },
   ai: {
     ask: {
-      enabled: false,
+      enabled: true,
+      endpoint: "https://api.spacefast.com/v1/docs/ask",
+      suggestions: [
+        { label: "How do I publish a site?", icon: "upload" },
+        { label: "How should an agent use Spacefast?", icon: "bot" },
+        { label: "How do I roll back a version?", icon: "undo-2" },
+      ],
     },
     llmsTxt: {
       enabled: true,
@@ -124,7 +151,7 @@ export default defineConfig({
   seo: {
     agentReadability: true,
     og: {
-      enabled: false,
+      enabled: true,
     },
     robots: true,
     sitemap: true,

content/platforms/index.md

@@ -1,6 +1,12 @@
 ---
 title: Platforms
 description: The Spacefast platform surface for companies hosting sites for their own customers — the tenant model, key posture, on-behalf-of calls, and the Platform API reference.
+ai:
+  exclude: true
+search:
+  exclude: true
+seo:
+  noindex: true
 ---
 
 The platform surface is for companies that host many sites for **their own customers** — white-label static hosting behind your brand and your billing. You call one API; your customer sees you, full stop. This page is the guide — the [Platform API reference](/platforms/api/reference) lists every operation.

generated/cli/index.md

@@ -521,7 +521,7 @@ EXAMPLES
 
 ## `sf access grant GRANT`
 
-Grant access to an identity class.
+Gate this space for an identity class.
 
 ```text
 USAGE
@@ -537,16 +537,17 @@ GLOBAL FLAGS
       --profile=<value>  [env: SPACEFAST_PROFILE] Named provider profile from `sf profiles`.
 
 DESCRIPTION
-  Grant access to an identity class.
+  Gate this space for an identity class.
 
-  Append a cloud allow rule that admits any visitor whose verified grants intersect the glob (token.requiredGrants).
+  Create or update the identity admission and fallback gate. Approved identities join existing password/share audiences;
+  anonymous fallthrough must sign in.
 
 EXAMPLES
-  Allow any verified acme.com email.
+  Gate the space for any verified acme.com email.
 
     $ sf access grant email:*@acme.com
 
-  Allow members of the eng team.
+  Add members of the eng team to the admitted audience.
 
     $ sf access grant team:eng:member
 ```
@@ -3572,7 +3573,7 @@ Run the Spacefast MCP server.
 USAGE
   $ sf mcp [--transport stdio|http|streamable-http] [--host <value>] [--port <value>] [--path <value>]
     [--http-token <value>] [--cors-origin <value>...] [--workspace-root <value>]
-    [--repair]
+    [--preset all|agents|essential] [--repair]
 
 FLAGS
   --api-url=<value>         [env: SPACEFAST_API_URL] Spacefast API base URL for MCP tool calls.
@@ -3584,6 +3585,8 @@ FLAGS
   --json                    Print machine-readable status for `sf mcp status`.
   --path=<value>            [default: /mcp, env: SPACEFAST_MCP_PATH] HTTP path for streamable HTTP.
   --port=<value>            [default: 3945, env: SPACEFAST_MCP_PORT] Port for streamable HTTP.
+  --preset=<option>         [env: SPACEFAST_MCP_PRESET] MCP tool surface to expose.
+                            <options: all|agents|essential>
   --repair                  For `sf mcp status`, remove a stale local daemon manifest and print recovery steps.
   --token=<value>           [env: SPACEFAST_TOKEN] Spacefast API token for MCP tool calls.
   --transport=<option>      MCP transport to run. `http` is streamable HTTP.

generated/manifest.json

@@ -1,16 +1,16 @@
 {
-  "contentDigest": "c262898be8f96cd105c3e24ccbc352aa1f5fb1d24ab0b2580e0ade940c4d4bd3",
+  "contentDigest": "77ec66ee52ea9c21a5876fb98a524a25895b01f59207e7fdf98205d0e4d5de85",
   "counts": {
-    "apiOperations": 327,
+    "apiOperations": 328,
     "errorCodes": 462,
-    "platformOperations": 362,
-    "redirects": 2513
+    "platformOperations": 363,
+    "redirects": 2520
   },
   "files": [
     {
-      "bytes": 202781,
+      "bytes": 203043,
       "path": "cli/index.md",
-      "sha256": "08bf8d9bab90aac37d9d9dce2def5b8f74c12ffd3acfcc4808c688f96f3bca81"
+      "sha256": "aadf79c65118a878dd66caafc4c3bb0d221b734d2e9063210d2823844a10c6b0"
     },
     {
       "bytes": 960,
@@ -2328,19 +2328,19 @@
       "sha256": "16a6d9f8bcf7ffe954082924a6e44cad8a40bf539531681abeae15d650995aa9"
     },
     {
-      "bytes": 5526652,
+      "bytes": 5534159,
       "path": "openapi/api.json",
-      "sha256": "0bf694a9f49139ebba0ead607573388754f06805c4f56e1b60fc6325d129d80b"
+      "sha256": "dfbd031a49b2a5517c3683011759f404ae640542a46fab6744fbf0d4f0d91aad"
     },
     {
-      "bytes": 5996450,
+      "bytes": 6003957,
       "path": "openapi/platform.json",
-      "sha256": "364b666b8d664a98044bbf9f61b87d60c6937edf139399174bc2ce93863f1d11"
+      "sha256": "82c11911065064035f480e48153e0ae39128b04ca5aa10b7de0d504f60c9f4ee"
     },
     {
-      "bytes": 465094,
+      "bytes": 466090,
       "path": "redirects.json",
-      "sha256": "e027689ed673f57e1416d3eeccf4f7f40d126078265ffdc1ea24095c58138bb9"
+      "sha256": "0e28e82bfb105c9fc9348fe46eb07177d725a8c7cf9f867f23b5598360398fc6"
     }
   ],
   "generator": "spacefast-public-docs",