Convert build scripts from CommonJS to ES Modules (#416)

* Convert build scripts from CommonJS to ES Modules

- Convert all eng/*.js files to ES Modules (.mjs)
- Update package.json scripts to reference .mjs files
- Fix ERR_REQUIRE_ESM error with vfile v6.0.3
- Add __dirname polyfills for ES Modules

* completing the migration of all files to es modules

---------

Co-authored-by: Lyubomir Filipov <lyubomir.filipov@jakala.com>
Co-authored-by: Aaron Powell <me@aaron-powell.com>

.vscode/tasks.json

@@ -12,19 +12,19 @@
     {
       "label": "generate-readme",
       "type": "shell",
-      "command": "node ${workspaceFolder}/eng/update-readme.js",
+      "command": "npm run build",
       "problemMatcher": [],
       "group": {
         "kind": "build",
         "isDefault": true
       },
-      "detail": "Generates the README.md file using update-readme.js script.",
+      "detail": "Generates the README.md file using npm build run-script.",
       "dependsOn": "npm install"
     },
     {
       "label": "validate-collections",
       "type": "shell",
-      "command": "node ${workspaceFolder}/eng/validate-collections.js",
+      "command": "npm run collection:validate",
       "problemMatcher": [],
       "group": "build",
       "detail": "Validates all collection manifest files.",
@@ -33,9 +33,8 @@
     {
       "label": "create-collection",
       "type": "shell",
-      "command": "node",
+      "command": "npm run collection:create",
       "args": [
-        "${workspaceFolder}/eng/create-collection.js",
         "--id",
         "${input:collectionId}",
         "--tags",

eng/constants.mjs

@@ -1,4 +1,9 @@
-const path = require("path");
+import path from "path";
+import { fileURLToPath } from "url";
+import { dirname } from "path";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
 
 // Template sections for the README
 const TEMPLATES = {
@@ -115,7 +120,7 @@ const MAX_COLLECTION_ITEMS = 50;
 
 const DOCS_DIR = path.join(ROOT_FOLDER, "docs");
 
-module.exports = {
+export {
   TEMPLATES,
   vscodeInstallImage,
   vscodeInsidersInstallImage,
@@ -130,3 +135,4 @@ module.exports = {
   MAX_COLLECTION_ITEMS,
   DOCS_DIR,
 };
+

eng/create-collection.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
-const fs = require("fs");
+import fs from "fs";
-const path = require("path");
+import path from "path";
-const readline = require("readline");
+import readline from "readline";
-const { COLLECTIONS_DIR } = require("./constants");
+import { COLLECTIONS_DIR } from "./constants.mjs";
 
 const rl = readline.createInterface({
   input: process.stdin,
@@ -166,7 +166,7 @@ display:
     console.log("\n📝 Next steps:");
     console.log("1. Edit the collection manifest to add your items");
     console.log("2. Update the name, description, and tags as needed");
-    console.log("3. Run 'npm run validate:collections' to validate");
+    console.log("3. Run 'npm run collection:validate' to validate");
     console.log("4. Run 'npm start' to generate documentation");
     console.log("\n📄 Collection template contents:");
     console.log(template);

eng/update-readme.mjs

@@ -1,14 +1,16 @@
 #!/usr/bin/env node
 
-const fs = require("fs");
+import fs from "fs";
-const path = require("path");
+import path from "path";
-const {
+import { fileURLToPath } from "url";
+import { dirname } from "path";
+import {
   parseCollectionYaml,
   extractMcpServers,
   extractMcpServerConfigs,
   parseFrontmatter,
-} = require("./yaml-parser");
+} from "./yaml-parser.mjs";
-const {
+import {
   TEMPLATES,
   AKA_INSTALL_URLS,
   repoBaseUrl,
@@ -21,7 +23,10 @@ const {
   COLLECTIONS_DIR,
   INSTRUCTIONS_DIR,
   DOCS_DIR,
-} = require("./constants");
+} from "./constants.mjs";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
 
 // Cache of MCP registry server names (lower-cased) loaded from github-mcp-registry.json
 let MCP_REGISTRY_SET = null;
@@ -968,3 +973,4 @@ try {
   console.error(`Error generating category README files: ${error.message}`);
   process.exit(1);
 }
+

eng/validate-collections.mjs

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 
-const fs = require("fs");
+import fs from "fs";
-const path = require("path");
+import path from "path";
-const { parseCollectionYaml, parseFrontmatter } = require("./yaml-parser");
+import { parseCollectionYaml, parseFrontmatter } from "./yaml-parser.mjs";
-const {
+import {
   ROOT_FOLDER,
   COLLECTIONS_DIR,
   MAX_COLLECTION_ITEMS,
-} = require("./constants");
+} from "./constants.mjs";
 
 // Validation functions
 function validateCollectionId(id) {
@@ -370,3 +370,4 @@ try {
   console.error(`Error during validation: ${error.message}`);
   process.exit(1);
 }
+

eng/yaml-parser.mjs

@@ -1,8 +1,8 @@
 // YAML parser for collection files and frontmatter parsing using vfile-matter
-const fs = require("fs");
+import fs from "fs";
-const yaml = require("js-yaml");
+import yaml from "js-yaml";
-const { VFile } = require("vfile");
+import { VFile } from "vfile";
-const { matter } = require("vfile-matter");
+import { matter } from "vfile-matter";
 
 function safeFileOperation(operation, filePath, defaultValue = null) {
   try {
@@ -137,7 +137,7 @@ function extractMcpServerConfigs(filePath) {
   });
 }
 
-module.exports = {
+export {
   parseCollectionYaml,
   parseFrontmatter,
   extractAgentMetadata,

package.json

@@ -6,11 +6,12 @@
   "private": true,
   "scripts": {
     "start": "npm run build",
-    "build": "node ./eng/update-readme.js",
+    "build": "node ./eng/update-readme.mjs",
     "contributors:add": "all-contributors add",
     "contributors:generate": "all-contributors generate",
     "contributors:check": "all-contributors check",
-    "validate:collections": "node ./eng/validate-collections.js"
+    "collection:validate": "node ./eng/validate-collections.mjs",
+    "collection:create": "node ./eng/create-collection.mjs"
   },
   "repository": {
     "type": "git",