feat(website): replace the Rspress site with the agent-device.dev product site

.fallowrc.json

@@ -42,9 +42,7 @@
     "examples/sdk/batch-orchestration.ts",
     "examples/sdk/ai-sdk-tools.ts",
     "examples/sdk/host-runtime.ts",
-    "test/integration/**/*.test.ts",
-    "website/docs/404.mdx",
-    "website/rspress.config.ts"
+    "test/integration/**/*.test.ts"
   ],
   "framework": [
     {
@@ -59,6 +57,8 @@
   ],
   "ignorePatterns": [
     "examples/test-app/**",
+    // The social card template: scripts/og.mjs serves it with generated /og/* files.
+    "website/og/og.html",
     "scripts/perf/**",
     "scripts/layering/**",
     "scripts/di-seams/**",
@@ -71,7 +71,17 @@
     // by an import edge. Same shape as the help-conformance declaration files above.
     "scripts/size-report-package.d.mts"
   ],
-  "dynamicallyLoaded": ["packages/daemon/src/execution/interaction/index.ts"],
+  "dynamicallyLoaded": [
+    "packages/daemon/src/execution/interaction/index.ts",
+    // The site's modules that Astro loads without an import Fallow can read: from an .astro
+    // <script> block (hero.ts, dither-host.ts), as a worker URL (dither.worker.ts), by a path
+    // in astro.config.mjs (routeData.ts) or by convention (ec.config.mjs, Expressive Code).
+    "website/src/components/home/hero.ts",
+    "website/src/components/site/dither-host.ts",
+    "website/src/components/site/dither.worker.ts",
+    "website/src/routeData.ts",
+    "website/ec.config.mjs"
+  ],
   "ignoreDependencies": [
     "@theme",
     // @agent-device/maestro owns the source import, while the published root
@@ -94,6 +104,30 @@
     "@arethetypeswrong/cli"
   ],
   "ignoreExports": [
+    {
+      // og.html draws the social card's scene with it; scripts/og.mjs serves the module to the page.
+      "file": "website/src/components/site/dither.ts",
+      "exports": ["drawDither"]
+    },
+    {
+      // Starlight runs the route middleware by name (routeMiddleware in astro.config.mjs).
+      "file": "website/src/routeData.ts",
+      "exports": ["onRequest"]
+    },
+    {
+      // Astro and Expressive Code read the default export of each site config by convention.
+      "file": "website/{astro,ec}.config.mjs",
+      "exports": ["default"]
+    },
+    {
+      // .astro <script> blocks import these with import(), which Fallow cannot read.
+      "file": "website/src/components/home/hero.ts",
+      "exports": ["default"]
+    },
+    {
+      "file": "website/src/components/site/dither-host.ts",
+      "exports": ["host"]
+    },
     {
       // The standalone packed-install harness loads this fixture from the selected package path and reads its request scenarios dynamically.
       "file": "packages/provider-*/test/package-smoke.mjs",
@@ -236,7 +270,7 @@
     },
     {
       // Tool config default exports, loaded by the tool rather than imported.
-      "file": "{oxlint.config.ts,tsdown.config.ts,packages/provider-*/tsdown.config.ts,packages/proxy/tsdown.config.ts,vitest.mutation.config.ts,website/rspress.config.ts}",
+      "file": "{oxlint.config.ts,tsdown.config.ts,packages/provider-*/tsdown.config.ts,packages/proxy/tsdown.config.ts,vitest.mutation.config.ts}",
       "exports": ["default"]
     },
     {

.github/workflows/android.yml

@@ -12,10 +12,6 @@ on:
       - 'CONTRIBUTING.md'
       - 'LICENSE'
       - 'SECURITY.md'
-      - '.github/actions/build-docs/action.yml'
-      - '.github/workflows/deploy.yml'
-      - '.github/workflows/pr-preview.yml'
-      - '.github/workflows/pr-preview-cleanup.yml'
   push:
     branches:
       - main

.github/workflows/apple.yml

@@ -16,10 +16,6 @@ on:
       - CONTRIBUTING.md
       - LICENSE
       - SECURITY.md
-      - .github/actions/build-docs/action.yml
-      - .github/workflows/deploy.yml
-      - .github/workflows/pr-preview.yml
-      - .github/workflows/pr-preview-cleanup.yml
   push:
     branches:
       - main

.github/workflows/ci.yml

@@ -11,10 +11,6 @@ on:
       - 'CONTRIBUTING.md'
       - 'LICENSE'
       - 'SECURITY.md'
-      - '.github/actions/build-docs/action.yml'
-      - '.github/workflows/deploy.yml'
-      - '.github/workflows/pr-preview.yml'
-      - '.github/workflows/pr-preview-cleanup.yml'
   push:
     branches:
       - main

.github/workflows/deploy.yml

@@ -1,12 +1,30 @@
-name: Deploy Docs
+name: Deploy docs redirects
 
+# The docs moved from oss.callstack.com/agent-device (GitHub Pages) to agent-device.dev (Vercel).
+# This publishes stubs that send every old page to its new URL (website/scripts/oss-redirects.mjs).
+# The script copies the Markdown and llms files from agent-device.dev and fails until that site
+# serves them, so the old docs stay published until the domain points at the new site.
+
+# Only changes to what it publishes run it, so an outage at agent-device.dev cannot fail unrelated
+# commits on main. A push run first waits until agent-device.dev serves that commit or a later one
+# (/version.txt), so it never copies docs from before the merge. Every path below is under website/,
+# which Vercel rebuilds; after a change to this workflow, or right after the cutover, run it by hand
+# on main to republish.
 on:
   push:
     branches:
       - main
+    paths:
+      - 'website/docs/**'
+      - 'website/scripts/oss-redirects.mjs'
+      - 'website/src/site/content.ts'
+      - 'website/src/site/llms.ts'
+  workflow_dispatch:
 
 jobs:
   deploy:
+    # Only main publishes to gh-pages, whichever way the run starts.
+    if: github.ref == 'refs/heads/main'
     runs-on: ubuntu-latest
     permissions:
       contents: write
@@ -17,15 +35,39 @@ jobs:
         with:
           persist-credentials: true
 
-      - name: Build docs
-        uses: ./.github/actions/build-docs
+      - name: Setup Node
+        uses: ./.github/actions/setup-node-pnpm
         with:
-          rspress-base: /${{ github.event.repository.name }}/
+          install-deps: 'false'
+
+      - name: Wait for agent-device.dev to serve this commit
+        if: github.event_name == 'push'
+        env:
+          GH_TOKEN: ${{ github.token }}
+          REPO: ${{ github.repository }}
+          SHA: ${{ github.sha }}
+        run: |
+          for attempt in $(seq 1 40); do
+            live=$(curl -fsS https://agent-device.dev/version.txt | tr -d '[:space:]' || true)
+            if [ -n "$live" ] && [ "$live" != local ]; then
+              status=$(gh api "repos/$REPO/compare/$SHA...$live" --jq .status 2>/dev/null || true)
+              if [ "$status" = identical ] || [ "$status" = ahead ]; then
+                echo "agent-device.dev serves $live, which includes $SHA."
+                exit 0
+              fi
+            fi
+            sleep 30
+          done
+          echo "agent-device.dev does not serve $SHA after 20 minutes; run this workflow by hand once it does."
+          exit 1
+
+      - name: Write the redirect pages
+        run: node website/scripts/oss-redirects.mjs website/oss-redirects
 
+      # Replaces the whole branch, including the old pr-preview/ deploys.
       - name: Deploy
         uses: JamesIves/github-pages-deploy-action@d92aa235d04922e8f08b40ce78cc5442fcfbfa2f # v4.8.0
         with:
-          folder: website/doc_build
+          folder: website/oss-redirects
           branch: gh-pages
-          clean-exclude: pr-preview
           force: false

.github/workflows/docs.yml

@@ -1,14 +1,13 @@
 name: Docs
 
 # ci.yml ignores docs paths, so docs-only PRs need their own lane. The links
-# gate builds the site and checks the rendered pages, so the rspress version
-# (website/package.json, the lockfile) and config re-run it as well.
+# gate builds the site and checks the rendered pages, so anything in website/,
+# the lockfile and server.json (the MCP manifest's source) re-run it as well.
 on:
   pull_request:
     paths:
-      - 'website/docs/**'
-      - 'website/package.json'
-      - 'website/rspress.config.ts'
+      - 'website/**'
+      - 'server.json'
       - 'README.md'
       - 'scripts/check-doc-links.ts'
       - 'scripts/__tests__/check-doc-links.test.ts'
@@ -26,9 +25,8 @@ on:
     branches:
       - main
     paths:
-      - 'website/docs/**'
-      - 'website/package.json'
-      - 'website/rspress.config.ts'
+      - 'website/**'
+      - 'server.json'
       - 'README.md'
       - 'scripts/check-doc-links.ts'
       - 'scripts/__tests__/check-doc-links.test.ts'
@@ -78,3 +76,21 @@ jobs:
       - name: Check docs links
         uses: ./.github/actions/run-gate
         with: { gate: docs-links }
+
+  # ci.yml ignores docs paths, so a docs-only PR never reaches the unit lane that carries the
+  # command-reference coverage gate. Documenting a retired command, or dropping a public
+  # command's docs, fails here instead.
+  command-docs:
+    name: Command reference doc coverage
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Checkout
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+
+      - name: Setup Node and pnpm
+        uses: ./.github/actions/setup-node-pnpm
+
+      - name: Check command reference doc coverage
+        uses: ./.github/actions/run-gate
+        with: { gate: command-docs }

.github/workflows/linux.yml

@@ -12,10 +12,6 @@ on:
       - 'CONTRIBUTING.md'
       - 'LICENSE'
       - 'SECURITY.md'
-      - '.github/actions/build-docs/action.yml'
-      - '.github/workflows/deploy.yml'
-      - '.github/workflows/pr-preview.yml'
-      - '.github/workflows/pr-preview-cleanup.yml'
   push:
     branches:
       - main

.github/workflows/pr-cancel-on-close.yml

@@ -16,7 +16,6 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 5
     steps:
-      # pr-preview-cleanup.yml runs on the same close event and must finish.
       - name: Cancel the PR's unfinished runs
         env:
           GH_TOKEN: ${{ github.token }}
@@ -31,7 +30,6 @@ jobs:
               | select(.head_repository.full_name == \"$GITHUB_REPOSITORY\")
               | select(any(.pull_requests[]; .number == $PR_NUMBER))
               | select(.id != $RUN_ID)
-              | select(.path != \".github/workflows/pr-preview-cleanup.yml\")
               | .id")
           refused=()
           for id in $ids; do