docs: serve site under /stability-matrix/ for multi-product future

Per team discussion: prefix all URLs from day one so the planned move to
a multi-product docs repo (SM + Chat + Bench) never breaks hotlinks or
SEO — the future migration becomes a pure code move.

- rewrites map every page under stability-matrix/, README.md as the
  section index
- bare site root 302s to /stability-matrix/ via staticwebapp.config.json
  (replaced by a product landing page at migration)
- markdown hook normalizes content links targeting README to
  directory-index form; VitePress emits relative hrefs verbatim, so
  ./../README rendered as a README.html that does not exist in the built
  output (latent 404 even at root config — dev middleware masked it, and
  the dead-link checker resolves in source space so it never flagged it)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: mohnjiles

docs/.vitepress/config.mts

@@ -4,16 +4,43 @@ export default defineConfig({
   title: 'Stability Matrix Docs',
   description: 'Documentation for Stability Matrix, a multi-platform package manager for Stable Diffusion and related AI tools.',
 
-  // Keep README.md as the single source of truth for the home page content,
-  // while serving it at the site root (index.html) instead of /README.html.
+  // Serve everything under /stability-matrix/ from day one so URLs survive the
+  // planned move to a multi-product docs repo (SM + Chat + Bench sections) with
+  // zero redirects. README.md doubles as the section index. The bare site root
+  // 302s here via public/staticwebapp.config.json until a landing page exists.
   rewrites: {
-    'README.md': 'index.md'
+    'README.md': 'stability-matrix/index.md',
+    ':path(.*)': 'stability-matrix/:path'
   },
 
   // Dead-link checking stays ON (default) so a future PR that breaks a
   // relative link fails the build instead of shipping silently.
   ignoreDeadLinks: false,
 
+  markdown: {
+    config(md) {
+      // README.md is rewritten to the section index, but VitePress emits
+      // relative hrefs verbatim — a content link like `./../README` would
+      // point at a README.html that doesn't exist in the built site (it
+      // renders fine on GitHub and in the in-app viewer, so the content is
+      // correct; the mismatch is this site's rewrite). Normalize such links
+      // to directory-index form, which resolves everywhere.
+      md.core.ruler.push('sm-readme-links', (state) => {
+        for (const token of state.tokens) {
+          if (token.type !== 'inline' || !token.children) continue
+          for (const child of token.children) {
+            if (child.type !== 'link_open') continue
+            const href = child.attrGet('href')
+            const match = href?.match(/^(?:\.\/)?((?:\.\.\/)*)README(?:\.md)?(#.*)?$/)
+            if (match) {
+              child.attrSet('href', (match[1] || './') + (match[2] ?? ''))
+            }
+          }
+        }
+      })
+    }
+  },
+
   appearance: 'dark',
 
   // Requires full git history at build time (fetch-depth: 0 in the deploy job).
@@ -36,70 +63,70 @@ export default defineConfig({
     },
 
     nav: [
-      { text: 'Home', link: '/' },
-      { text: 'Getting Started', link: '/getting-started/overview' },
-      { text: 'Package Manager', link: '/package-manager/overview' },
-      { text: 'Inference', link: '/inference/overview' },
-      { text: 'Advanced', link: '/advanced/overview' },
-      { text: 'Tips and Tricks', link: '/tips/overview' },
-      { text: 'Troubleshooting', link: '/troubleshooting/common-issues' }
+      { text: 'Home', link: '/stability-matrix/' },
+      { text: 'Getting Started', link: '/stability-matrix/getting-started/overview' },
+      { text: 'Package Manager', link: '/stability-matrix/package-manager/overview' },
+      { text: 'Inference', link: '/stability-matrix/inference/overview' },
+      { text: 'Advanced', link: '/stability-matrix/advanced/overview' },
+      { text: 'Tips and Tricks', link: '/stability-matrix/tips/overview' },
+      { text: 'Troubleshooting', link: '/stability-matrix/troubleshooting/common-issues' }
     ],
 
     sidebar: {
-      '/getting-started/': [
+      '/stability-matrix/getting-started/': [
         {
           text: 'Getting Started',
           items: [
-            { text: 'Overview', link: '/getting-started/overview' },
-            { text: 'Installation', link: '/getting-started/installation' },
-            { text: 'First Launch', link: '/getting-started/first-launch' },
-            { text: 'Data Directory', link: '/getting-started/data-directory' }
+            { text: 'Overview', link: '/stability-matrix/getting-started/overview' },
+            { text: 'Installation', link: '/stability-matrix/getting-started/installation' },
+            { text: 'First Launch', link: '/stability-matrix/getting-started/first-launch' },
+            { text: 'Data Directory', link: '/stability-matrix/getting-started/data-directory' }
           ]
         }
       ],
-      '/package-manager/': [
+      '/stability-matrix/package-manager/': [
         {
           text: 'Package Manager',
           items: [
-            { text: 'Overview', link: '/package-manager/overview' },
-            { text: 'Supported Packages', link: '/package-manager/supported-packages' },
-            { text: 'Installing Packages', link: '/package-manager/installing-packages' }
+            { text: 'Overview', link: '/stability-matrix/package-manager/overview' },
+            { text: 'Supported Packages', link: '/stability-matrix/package-manager/supported-packages' },
+            { text: 'Installing Packages', link: '/stability-matrix/package-manager/installing-packages' }
           ]
         }
       ],
-      '/inference/': [
+      '/stability-matrix/inference/': [
         {
           text: 'Inference',
           items: [
-            { text: 'Overview', link: '/inference/overview' }
+            { text: 'Overview', link: '/stability-matrix/inference/overview' }
           ]
         }
       ],
-      '/advanced/': [
+      '/stability-matrix/advanced/': [
         {
           text: 'Advanced',
           items: [
-            { text: 'Overview', link: '/advanced/overview' },
-            { text: 'Hardware Support', link: '/advanced/hardware-support' },
-            { text: 'ComfyUI Integration', link: '/advanced/comfyui-integration' },
-            { text: 'Environment Variables', link: '/advanced/environment-variables' }
+            { text: 'Overview', link: '/stability-matrix/advanced/overview' },
+            { text: 'Hardware Support', link: '/stability-matrix/advanced/hardware-support' },
+            { text: 'ComfyUI Integration', link: '/stability-matrix/advanced/comfyui-integration' },
+            { text: 'Environment Variables', link: '/stability-matrix/advanced/environment-variables' }
           ]
         }
       ],
-      '/tips/': [
+      '/stability-matrix/tips/': [
         {
           text: 'Tips and Tricks',
           items: [
-            { text: 'Overview', link: '/tips/overview' },
-            { text: 'Terminology', link: '/tips/terminology' }
+            { text: 'Overview', link: '/stability-matrix/tips/overview' },
+            { text: 'Terminology', link: '/stability-matrix/tips/terminology' }
           ]
         }
       ],
-      '/troubleshooting/': [
+      '/stability-matrix/troubleshooting/': [
         {
           text: 'Troubleshooting',
           items: [
-            { text: 'Common Issues', link: '/troubleshooting/common-issues' }
+            { text: 'Common Issues', link: '/stability-matrix/troubleshooting/common-issues' }
           ]
         }
       ]

docs/public/staticwebapp.config.json

@@ -1,4 +1,11 @@
 {
+  "routes": [
+    {
+      "route": "/",
+      "redirect": "/stability-matrix/",
+      "statusCode": 302
+    }
+  ],
   "responseOverrides": {
     "404": {
       "rewrite": "/404.html"