refactor: migrate URL fixing script to ES modules and update package.json reference

Author: fassko

package.json

@@ -19,7 +19,7 @@
     "format:diff": "prettier --list-different .",
     "format:check": "prettier --check \"**/*.{js,jsx,ts,tsx,md,mdx}\"",
     "lint": "npx eslint .",
-    "fix-llms-urls": "node scripts/fix-llms-urls.js",
+    "fix-llms-urls": "node scripts/fix-llms-urls.mjs",
     "build:llms-fixed": "npm run build && npm run fix-llms-urls"
   },
   "dependencies": {

scripts/fix-llms-urls.js

@@ -7,8 +7,8 @@
  * generates routes (e.g., "0-overview" becomes "overview")
  */
 
-const fs = require("fs");
-const path = require("path");
+import fs from "fs";
+import path from "path";
 
 const config = {
   buildDir: "build",
@@ -58,8 +58,8 @@ function main() {
   console.log("✅ URL fixing completed!");
 }
 
-if (require.main === module) {
+if (import.meta.url === `file://${process.argv[1]}`) {
   main();
 }
 
-module.exports = { fixUrlsInFile, main };
+export { fixUrlsInFile, main };

scripts/fix-llms-urls.mjs

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+/**
+ * Script to fix URLs in generated LLMs files to match Docusaurus routing
+ *
+ * This script removes prepended numbers from URLs to match how Docusaurus
+ * generates routes (e.g., "0-overview" becomes "overview")
+ */
+
+import fs from "fs";
+import path from "path";
+
+const config = {
+  buildDir: "build",
+  filesToFix: ["llms.txt", "llms-full.txt"],
+  baseUrl: "https://dev.flare.network/docs/",
+};
+
+function fixUrlsInFile(filePath) {
+  try {
+    console.log(`Fixing URLs in: ${filePath}`);
+
+    const content = fs.readFileSync(filePath, "utf8");
+
+    // Fix URLs by removing prepended numbers
+    // Pattern: https://dev.flare.network/docs/network/0-overview -> https://dev.flare.network/docs/network/overview
+    const fixedContent = content.replace(
+      /(https:\/\/dev\.flare\.network\/docs\/[^)]+\/)\d+-([^)]+)/g,
+      "$1$2",
+    );
+
+    fs.writeFileSync(filePath, fixedContent);
+
+    console.log(`✅ Fixed URLs in: ${filePath}`);
+  } catch (error) {
+    console.error(`❌ Error fixing URLs in ${filePath}:`, error.message);
+  }
+}
+
+function main() {
+  console.log("🔧 Fixing URLs in LLMs files...");
+
+  if (!fs.existsSync(config.buildDir)) {
+    console.error(`❌ Build directory not found: ${config.buildDir}`);
+    return;
+  }
+
+  config.filesToFix.forEach((fileName) => {
+    const filePath = path.join(config.buildDir, fileName);
+
+    if (fs.existsSync(filePath)) {
+      fixUrlsInFile(filePath);
+    } else {
+      console.warn(`⚠️  File not found: ${filePath}`);
+    }
+  });
+
+  console.log("✅ URL fixing completed!");
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main();
+}
+
+export { fixUrlsInFile, main };