@rushstack/rush-mcp-docs-plugin 0.2.14 → 0.3.1

package/CHANGELOG.json

@@ -1,6 +1,52 @@
 {
   "name": "@rushstack/rush-mcp-docs-plugin",
   "entries": [
+    {
+      "version": "0.3.1",
+      "tag": "@rushstack/rush-mcp-docs-plugin_v0.3.1",
+      "date": "Fri, 20 Feb 2026 00:15:04 GMT",
+      "comments": {
+        "patch": [
+          {
+            "comment": "Add `\"node\"` condition before `\"import\"` in the `\"exports\"` map so that Node.js uses the CJS output (which handles extensionless imports), while bundlers still use ESM via `\"import\"`. Fixes https://github.com/microsoft/rushstack/issues/5644."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `5.20.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/mcp-server\" to `0.4.1`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.2.1`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "0.3.0",
+      "tag": "@rushstack/rush-mcp-docs-plugin_v0.3.0",
+      "date": "Thu, 19 Feb 2026 00:04:53 GMT",
+      "comments": {
+        "minor": [
+          {
+            "comment": "Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `\"exports\"` field in `package.json`."
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `5.20.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/mcp-server\" to `0.4.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `1.2.0`"
+          }
+        ]
+      }
+    },
     {
       "version": "0.2.14",
       "tag": "@rushstack/rush-mcp-docs-plugin_v0.2.14",

package/CHANGELOG.md

@@ -1,6 +1,20 @@
 # Change Log - @rushstack/rush-mcp-docs-plugin
 
-This log was last generated on Sat, 07 Feb 2026 01:13:26 GMT and should not be manually modified.
+This log was last generated on Fri, 20 Feb 2026 00:15:04 GMT and should not be manually modified.
+
+## 0.3.1
+Fri, 20 Feb 2026 00:15:04 GMT
+
+### Patches
+
+- Add `"node"` condition before `"import"` in the `"exports"` map so that Node.js uses the CJS output (which handles extensionless imports), while bundlers still use ESM via `"import"`. Fixes https://github.com/microsoft/rushstack/issues/5644.
+
+## 0.3.0
+Thu, 19 Feb 2026 00:04:53 GMT
+
+### Minor changes
+
+- Normalize package layout. CommonJS is now under `lib-commonjs`, DTS is now under `lib-dts`, and ESM is now under `lib-esm`. Imports to `lib` still work as before, handled by the `"exports"` field in `package.json`.
 
 ## 0.2.14
 Sat, 07 Feb 2026 01:13:26 GMT

package/lib-esm/DocsPlugin.js

@@ -0,0 +1,17 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { DocsTool } from './DocsTool';
+export class DocsPlugin {
+    constructor(session, configFile) {
+        this.configFile = undefined;
+        this.session = session;
+        this.configFile = configFile;
+    }
+    async onInitializeAsync() {
+        this.session.registerTool({
+            toolName: 'rush_docs',
+            description: 'Search and retrieve relevant sections from the official Rush documentation based on user queries.'
+        }, new DocsTool(this));
+    }
+}
+//# sourceMappingURL=DocsPlugin.js.map

package/lib-esm/DocsPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsPlugin.js","sourceRoot":"","sources":["../src/DocsPlugin.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAI3D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC,MAAM,OAAO,UAAU;IAIrB,YAAmB,OAA6B,EAAE,UAA6C;QAFxF,eAAU,GAAsC,SAAS,CAAC;QAG/D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAEM,KAAK,CAAC,iBAAiB;QAC5B,IAAI,CAAC,OAAO,CAAC,YAAY,CACvB;YACE,QAAQ,EAAE,WAAW;YACrB,WAAW,EACT,mGAAmG;SACtG,EACD,IAAI,QAAQ,CAAC,IAAI,CAAC,CACnB,CAAC;IACJ,CAAC;CACF","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { IRushMcpPlugin, RushMcpPluginSession } from '@rushstack/mcp-server';\n\nimport { DocsTool } from './DocsTool';\n\nexport interface IDocsPluginConfigFile {}\n\nexport class DocsPlugin implements IRushMcpPlugin {\n  public session: RushMcpPluginSession;\n  public configFile: IDocsPluginConfigFile | undefined = undefined;\n\n  public constructor(session: RushMcpPluginSession, configFile: IDocsPluginConfigFile | undefined) {\n    this.session = session;\n    this.configFile = configFile;\n  }\n\n  public async onInitializeAsync(): Promise<void> {\n    this.session.registerTool(\n      {\n        toolName: 'rush_docs',\n        description:\n          'Search and retrieve relevant sections from the official Rush documentation based on user queries.'\n      },\n      new DocsTool(this)\n    );\n  }\n}\n"]}

package/lib-esm/DocsTool.js

@@ -0,0 +1,41 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import path from 'node:path';
+import { JsonFile } from '@rushstack/node-core-library';
+export class DocsTool {
+    constructor(plugin) {
+        this.plugin = plugin;
+        this.session = plugin.session;
+    }
+    // ZOD relies on type inference generate a messy expression in the .d.ts file
+    // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+    get schema() {
+        const zod = this.session.zod;
+        return zod.object({
+            userQuery: zod.string().describe('The user query to search for relevant documentation sections.')
+        });
+    }
+    // TODO: replace with Microsoft's service
+    _searchDocs(query) {
+        const startTime = Date.now();
+        const results = JsonFile.load(path.join(__dirname, './rush-doc-fragment.mock.json'));
+        return {
+            query,
+            results,
+            count: results.length,
+            searchTimeMs: Date.now() - startTime
+        };
+    }
+    async executeAsync({ userQuery }) {
+        const docSearchResult = this._searchDocs(userQuery);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: docSearchResult.results.map((item) => item.text).join('\n\n')
+                }
+            ]
+        };
+    }
+}
+//# sourceMappingURL=DocsTool.js.map

package/lib-esm/DocsTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocsTool.js","sourceRoot":"","sources":["../src/DocsTool.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAcxD,MAAM,OAAO,QAAQ;IAInB,YAAmB,MAAkB;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,6EAA6E;IAC7E,4EAA4E;IAC5E,IAAW,MAAM;QACf,MAAM,GAAG,GAAqB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;QAE/C,OAAO,GAAG,CAAC,MAAM,CAAC;YAChB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;SAClG,CAAC,CAAC;IACL,CAAC;IAED,yCAAyC;IACjC,WAAW,CAAC,KAAa;QAC/B,MAAM,SAAS,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QAErC,MAAM,OAAO,GAA2B,QAAQ,CAAC,IAAI,CACnD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,+BAA+B,CAAC,CACtD,CAAC;QAEF,OAAO;YACL,KAAK;YACL,OAAO;YACP,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACrC,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,EAAE,SAAS,EAAuC;QAC1E,MAAM,eAAe,GAAgB,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAEjE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;iBACpE;aACF;SACF,CAAC;IACJ,CAAC;CACF","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport path from 'node:path';\n\nimport type { IRushMcpTool, RushMcpPluginSession, CallToolResult, zodModule } from '@rushstack/mcp-server';\nimport { JsonFile } from '@rushstack/node-core-library';\n\nimport type { DocsPlugin } from './DocsPlugin';\n\ninterface IDocsResult {\n  query: string;\n  results: {\n    score: number;\n    text: string;\n  }[];\n  count: number;\n  searchTimeMs: number;\n}\n\nexport class DocsTool implements IRushMcpTool<DocsTool['schema']> {\n  public readonly plugin: DocsPlugin;\n  public readonly session: RushMcpPluginSession;\n\n  public constructor(plugin: DocsPlugin) {\n    this.plugin = plugin;\n    this.session = plugin.session;\n  }\n\n  // ZOD relies on type inference generate a messy expression in the .d.ts file\n  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type\n  public get schema() {\n    const zod: typeof zodModule = this.session.zod;\n\n    return zod.object({\n      userQuery: zod.string().describe('The user query to search for relevant documentation sections.')\n    });\n  }\n\n  // TODO: replace with Microsoft's service\n  private _searchDocs(query: string): IDocsResult {\n    const startTime: number = Date.now();\n\n    const results: IDocsResult['results'] = JsonFile.load(\n      path.join(__dirname, './rush-doc-fragment.mock.json')\n    );\n\n    return {\n      query,\n      results,\n      count: results.length,\n      searchTimeMs: Date.now() - startTime\n    };\n  }\n\n  public async executeAsync({ userQuery }: zodModule.infer<DocsTool['schema']>): Promise<CallToolResult> {\n    const docSearchResult: IDocsResult = this._searchDocs(userQuery);\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: docSearchResult.results.map((item) => item.text).join('\\n\\n')\n        }\n      ]\n    };\n  }\n}\n"]}

package/lib-esm/index.js

@@ -0,0 +1,8 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { DocsPlugin } from './DocsPlugin';
+function createPlugin(session, configFile) {
+    return new DocsPlugin(session, configFile);
+}
+export default createPlugin;
+//# sourceMappingURL=index.js.map

package/lib-esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAI3D,OAAO,EAAE,UAAU,EAA8B,MAAM,cAAc,CAAC;AAEtE,SAAS,YAAY,CACnB,OAA6B,EAC7B,UAA6C;IAE7C,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED,eAAe,YAAkE,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { RushMcpPluginSession, RushMcpPluginFactory } from '@rushstack/mcp-server';\n\nimport { DocsPlugin, type IDocsPluginConfigFile } from './DocsPlugin';\n\nfunction createPlugin(\n  session: RushMcpPluginSession,\n  configFile: IDocsPluginConfigFile | undefined\n): DocsPlugin {\n  return new DocsPlugin(session, configFile);\n}\n\nexport default createPlugin satisfies RushMcpPluginFactory<IDocsPluginConfigFile>;\n"]}

package/lib-esm/rush-doc-fragment.mock.json

@@ -0,0 +1,18 @@
+[
+  {
+    "text": "---\ntitle: rush install-autoinstaller\n---\n\n```\nusage: rush install-autoinstaller [-h] --name AUTOINSTALLER_NAME\n\nUse this command to install dependencies for an autoinstaller folder.\n\nOptional arguments:\n  -h, --help            Show this help message and exit.\n  --name AUTOINSTALLER_NAME\n                        The name of the autoinstaller, which must be one of\n                        the folders under common/autoinstallers.\n```\n\n## See also\n\n- [rush update-autoinstaller](../commands/rush_update-autoinstaller.md)\n- [rush init-autoinstaller](../commands/rush_init-autoinstaller.md)",
+    "score": 0.7231232
+  },
+  {
+    "text": "---\ntitle: rush install-autoinstaller\n---\n\n```\n用法：rush install-autoinstaller [-h] --name AUTOINSTALLER_NAME\n\n使用该指令给一个项目安装依赖。\n\n可选参数：\n  -h, --help            展示帮助信息并退出\n  --name AUTOINSTALLER_NAME\n                        指定自动安装的包名，它必须是 common/autoinstallers\n                        下的一个文件夹。\n```\n\n## See also\n\n- [rush update-autoinstaller](../commands/rush_update-autoinstaller.md)\n- [rush init-autoinstaller](../commands/rush_init-autoinstaller.md)",
+    "score": 0.7132133
+  },
+  {
+    "text": "---\ntitle: rush update-autoinstaller\n---\n\n```\nusage: rush update-autoinstaller [-h] --name AUTOINSTALLER_NAME\n\nUse this command to regenerate the shrinkwrap file for an autoinstaller\nfolder.\n\nOptional arguments:\n  -h, --help            Show this help message and exit.\n  --name AUTOINSTALLER_NAME\n                        The name of the autoinstaller, which must be one of\n                        the folders under common/autoinstallers.\n```\n\n## See also\n\n- [rush install-autoinstaller](../commands/rush_install-autoinstaller.md)\n- [rush init-autoinstaller](../commands/rush_init-autoinstaller.md)",
+    "score": 0.6632131
+  },
+  {
+    "text": "---\ntitle: rush update-autoinstaller\n---\n\n```\nusage: rush update-autoinstaller [-h] --name AUTOINSTALLER_NAME\n\nUse this command to regenerate the shrinkwrap file for an autoinstaller\nfolder.\n\nOptional arguments:\n  -h, --help            Show this help message and exit.\n  --name AUTOINSTALLER_NAME\n                        The name of the autoinstaller, which must be one of\n                        the folders under common/autoinstallers.\n```\n\n## See also\n\n- [rush install-autoinstaller](../commands/rush_install-autoinstaller.md)\n- [rush init-autoinstaller](../commands/rush_init-autoinstaller.md)",
+    "score": 0.6528328
+  }
+]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/rush-mcp-docs-plugin",
-  "version": "0.2.14",
+  "version": "0.3.1",
   "description": "Docs plugin for @rushstack/mcp-server",
   "repository": {
     "url": "https://github.com/microsoft/rushstack.git",
@@ -8,19 +8,43 @@
     "directory": "rush-plugins/rush-mcp-docs-plugin"
   },
   "homepage": "https://rushjs.io",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
+  "main": "./lib-commonjs/index.js",
+  "module": "./lib-esm/index.js",
+  "types": "./lib-dts/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib-dts/index.d.ts",
+      "node": "./lib-commonjs/index.js",
+      "import": "./lib-esm/index.js",
+      "require": "./lib-commonjs/index.js"
+    },
+    "./lib/*": {
+      "types": "./lib-dts/*.d.ts",
+      "node": "./lib-commonjs/*.js",
+      "import": "./lib-esm/*.js",
+      "require": "./lib-commonjs/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "lib/*": [
+        "lib-dts/*"
+      ]
+    }
+  },
   "license": "MIT",
   "dependencies": {
-    "@rushstack/node-core-library": "5.19.1",
-    "@rushstack/mcp-server": "0.3.14"
+    "@rushstack/node-core-library": "5.20.1",
+    "@rushstack/mcp-server": "0.4.1"
   },
   "devDependencies": {
     "eslint": "~9.37.0",
-    "@rushstack/heft": "1.1.14",
-    "local-node-rig": "1.0.0",
-    "local-eslint-config": "1.0.0"
+    "@rushstack/heft": "1.2.1",
+    "local-eslint-config": "1.0.0",
+    "local-node-rig": "1.0.0"
   },
+  "sideEffects": false,
   "scripts": {
     "build": "heft build --clean",
     "_phase:build": "heft run --only build -- --clean",

package/rush-mcp-plugin.json

@@ -15,10 +15,10 @@
    *
    * The config file path will be `<rush-repo>/common/config/rush-mcp/<plugin-name>.json`.
    */
-  // "configFileSchema": "./lib/rush-mcp-example-plugin.schema.json",
+  // "configFileSchema": "./lib-commonjs/rush-mcp-example-plugin.schema.json",
 
   /**
    * The entry point, whose default export should be a class that implements
    */
-  "entryPoint": "./lib/index.js"
+  "entryPoint": "./lib-commonjs/index.js"
 }