feat: add docusaurus plugin for llmstxt

docusaurus.config.ts

@@ -89,6 +89,46 @@ const config: Config = {
         }
       };
     },
+    [
+      require.resolve('./plugins/llms-symlinks'),
+      {
+        docsDir: 'docs',
+
+        // Use site metadata in generated headers
+        title: 'Oasis Documentation',
+        description: 'Official Oasis developer documentation.',
+
+        // Generate both files
+        generateLLMsTxt: true,
+        generateLLMsFullTxt: true,
+
+        // Clean MDX a bit but keep content readable
+        excludeImports: true,
+        removeDuplicateHeadings: true,
+
+        // Strip "docs" from URLs to match the deployed site paths
+        pathTransformation: {
+          ignorePaths: ['docs'],
+        },
+
+        // Prioritize Build docs in order: use-cases, ROFL, Sapphire, CLI, then rest of build.
+        // Keep unmatched docs at the end so we don't drop anything.
+        includeOrder: [
+          'docs/build/use-cases/**',
+          'docs/build/rofl/**',
+          'docs/build/sapphire/**',
+          'docs/build/tools/cli/**',
+          'docs/build/**',
+        ],
+        includeUnmatchedLast: true,
+        // Mirror ADR exclusions from the main docs plugin to avoid boilerplate entries.
+        ignoreFiles: [
+          'docs/adrs/README.md',
+          'docs/adrs/0000-architectural-decision-records.md',
+          'docs/adrs/template.md',
+        ],
+      },
+    ],
     [
       '@docusaurus/plugin-client-redirects',
       redirectsOptions,

package.json

@@ -58,6 +58,7 @@
     "@docusaurus/types": "3.9.2",
     "@types/plotly.js-basic-dist": "^1.54.4",
     "@types/react-plotly.js": "^2.6.3",
+    "docusaurus-plugin-llms": "0.2.2",
     "jest": "^29.7.0",
     "ts-jest": "^29.1.1",
     "ts-node": "^10.9.2",