docs: implement version-specific LLM manifest URLs

Generate version-specific LLM manifest files at root and add version-aware
footer links to surface the correct documentation bundle based on which
docs version the user is browsing.

Changes:
- Generate llms-2.0.txt and llms-full-2.0.txt at root for v2.0 docs
- Maintain canonical llms.txt and llms-full.txt for v1.x docs
- Add custom Footer component that detects doc version and updates
  LLM Docs link dynamically on the client side

Closes #276

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: durable-workflow-ops

scripts/generate-llms-full.js

@@ -222,6 +222,10 @@ function main() {
     ensureDir(v2Path);
     fs.writeFileSync(path.join(v2Path, 'llms-full.txt'), v2Content, 'utf8');
     console.log(`v2.0 manifest -> /${versions.current}/llms-full.txt`);
+
+    // Also write v2.0 version-specific manifest at root
+    fs.writeFileSync(path.join(buildDir, 'llms-full-2.0.txt'), v2Content, 'utf8');
+    console.log(`v2.0 version-specific manifest -> /llms-full-2.0.txt`);
   }
 
   // Write canonical manifest at root (based on lastVersion)

scripts/generate-llms.js

@@ -233,16 +233,6 @@ function collectSections(docsDir, repoRawBaseUrl) {
   return sections;
 }
 
-function resolveDocsSourceDir() {
-  const versionedDocsDir = path.join(__dirname, '..', 'versioned_docs', 'version-1.x');
-
-  if (fs.existsSync(versionedDocsDir)) {
-    return versionedDocsDir;
-  }
-
-  return path.join(__dirname, '..', 'docs');
-}
-
 function renderSection(section) {
   const lines = [`## ${section.title}`, ''];
 
@@ -254,10 +244,7 @@ function renderSection(section) {
   return lines.join('\n');
 }
 
-function main() {
-  const docsDir = resolveDocsSourceDir();
-  const buildDir = path.join(__dirname, '..', 'build');
-  const outputFile = path.join(buildDir, 'llms.txt');
+function generateManifest(docsDir, outputPath, fullManifestUrl) {
   const siteBaseUrl = getSiteBaseUrl();
   const repoRawBaseUrl = getRepoRawBaseUrl();
   const siteTitle = config.title || 'Documentation';
@@ -268,15 +255,13 @@ function main() {
     links: [
       {
         title: `${siteTitle} full documentation bundle`,
-        url: new URL('llms-full.txt', siteBaseUrl).toString(),
+        url: fullManifestUrl,
         note: 'Single-file bundle of the complete documentation set.',
       },
     ],
   };
   const renderedSections = [...sections, optionalSection].map(renderSection).join('\n\n');
 
-  ensureDir(buildDir);
-
   const content = [
     `# ${siteTitle}`,
     '',
@@ -288,9 +273,32 @@ function main() {
     '',
   ].join('\n');
 
-  fs.writeFileSync(outputFile, content, 'utf8');
+  fs.writeFileSync(outputPath, content, 'utf8');
+}
 
-  console.log('llms.txt generated successfully:', outputFile);
+function main() {
+  const buildDir = path.join(__dirname, '..', 'build');
+  const siteBaseUrl = getSiteBaseUrl();
+
+  ensureDir(buildDir);
+
+  // Generate v1.x manifest (canonical)
+  const v1DocsDir = path.join(__dirname, '..', 'versioned_docs', 'version-1.x');
+  if (fs.existsSync(v1DocsDir)) {
+    const v1OutputFile = path.join(buildDir, 'llms.txt');
+    const v1FullUrl = new URL('llms-full.txt', siteBaseUrl).toString();
+    generateManifest(v1DocsDir, v1OutputFile, v1FullUrl);
+    console.log('v1.x llms.txt generated successfully:', v1OutputFile);
+  }
+
+  // Generate v2.0 manifest (version-specific)
+  const v2DocsDir = path.join(__dirname, '..', 'docs');
+  if (fs.existsSync(v2DocsDir)) {
+    const v2OutputFile = path.join(buildDir, 'llms-2.0.txt');
+    const v2FullUrl = new URL('llms-full-2.0.txt', siteBaseUrl).toString();
+    generateManifest(v2DocsDir, v2OutputFile, v2FullUrl);
+    console.log('v2.0 llms-2.0.txt generated successfully:', v2OutputFile);
+  }
 }
 
 main();

src/theme/Footer/index.js

@@ -0,0 +1,31 @@
+import React, { useEffect, useRef } from 'react';
+import Footer from '@theme-original/Footer';
+import ExecutionEnvironment from '@docusaurus/ExecutionEnvironment';
+
+export default function FooterWrapper(props) {
+  const footerRef = useRef(null);
+
+  useEffect(() => {
+    if (!ExecutionEnvironment.canUseDOM || !footerRef.current) {
+      return;
+    }
+
+    // Detect if we're on v2.0 docs based on URL
+    const isV2Docs = window.location.pathname.startsWith('/docs/2.0/');
+
+    // Find and update the LLM Docs link in the footer
+    const llmDocsLink = footerRef.current.querySelector('a[href*="llms-full.txt"]');
+    if (llmDocsLink) {
+      const targetUrl = isV2Docs
+        ? 'https://durable-workflow.com/llms-full-2.0.txt'
+        : 'https://durable-workflow.com/llms-full.txt';
+      llmDocsLink.setAttribute('href', targetUrl);
+    }
+  }, []);
+
+  return (
+    <div ref={footerRef}>
+      <Footer {...props} />
+    </div>
+  );
+}