@rushstack/mcp-server 0.1.4 → 0.1.5

package/CHANGELOG.json

@@ -1,6 +1,18 @@
 {
   "name": "@rushstack/mcp-server",
   "entries": [
+    {
+      "version": "0.1.5",
+      "tag": "@rushstack/mcp-server_v0.1.5",
+      "date": "Fri, 02 May 2025 15:11:29 GMT",
+      "comments": {
+        "patch": [
+          {
+            "comment": "Add more tools to mcp server"
+          }
+        ]
+      }
+    },
     {
       "version": "0.1.4",
       "tag": "@rushstack/mcp-server_v0.1.4",

package/CHANGELOG.md

@@ -1,6 +1,13 @@
 # Change Log - @rushstack/mcp-server
 
-This log was last generated on Thu, 01 May 2025 15:11:33 GMT and should not be manually modified.
+This log was last generated on Fri, 02 May 2025 15:11:29 GMT and should not be manually modified.
+
+## 0.1.5
+Fri, 02 May 2025 15:11:29 GMT
+
+### Patches
+
+- Add more tools to mcp server
 
 ## 0.1.4
 Thu, 01 May 2025 15:11:33 GMT

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export { log } from './utilities/log';
+export * from './tools';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,cAAc,SAAS,CAAC"}

package/lib/index.js

@@ -0,0 +1,23 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = void 0;
+var log_1 = require("./utilities/log");
+Object.defineProperty(exports, "log", { enumerable: true, get: function () { return log_1.log; } });
+__exportStar(require("./tools"), exports);
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;AAE3D,uCAAsC;AAA7B,0FAAA,GAAG,OAAA;AACZ,0CAAwB","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nexport { log } from './utilities/log';\nexport * from './tools';\n"]}

package/lib/server.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare class RushMCPServer extends McpServer {
+    private _rushWorkspacePath;
+    private _tools;
+    constructor(rushWorkspacePath: string);
+    private _initializeTools;
+    private _registerTools;
+}
+//# sourceMappingURL=server.d.ts.map

package/lib/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWpE,qBAAa,aAAc,SAAQ,SAAS;IAC1C,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,MAAM,CAAkB;gBAEb,iBAAiB,EAAE,MAAM;IAY5C,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,cAAc;CAOvB"}

package/lib/server.js

@@ -0,0 +1,35 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RushMCPServer = void 0;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const tools_1 = require("./tools");
+class RushMCPServer extends mcp_js_1.McpServer {
+    constructor(rushWorkspacePath) {
+        super({
+            name: 'rush',
+            version: '1.0.0'
+        });
+        this._tools = [];
+        this._rushWorkspacePath = rushWorkspacePath;
+        this._initializeTools();
+        this._registerTools();
+    }
+    _initializeTools() {
+        this._tools.push(new tools_1.RushConflictResolverTool());
+        this._tools.push(new tools_1.RushMigrateProjectTool(this._rushWorkspacePath));
+        this._tools.push(new tools_1.RushCommandValidatorTool());
+        this._tools.push(new tools_1.RushWorkspaceDetailsTool());
+        this._tools.push(new tools_1.RushProjectDetailsTool());
+        this._tools.push(new tools_1.RushDocsTool());
+    }
+    _registerTools() {
+        process.chdir(this._rushWorkspacePath);
+        for (const tool of this._tools) {
+            tool.register(this);
+        }
+    }
+}
+exports.RushMCPServer = RushMCPServer;
+//# sourceMappingURL=server.js.map

package/lib/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,oEAAoE;AACpE,mCAQiB;AAEjB,MAAa,aAAc,SAAQ,kBAAS;IAI1C,YAAmB,iBAAyB;QAC1C,KAAK,CAAC;YACJ,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QANG,WAAM,GAAe,EAAE,CAAC;QAQ9B,IAAI,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;QAE5C,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAEO,gBAAgB;QACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,gCAAwB,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,8BAAsB,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,gCAAwB,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,gCAAwB,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,8BAAsB,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,oBAAY,EAAE,CAAC,CAAC;IACvC,CAAC;IAEO,cAAc;QACpB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAEvC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;CACF;AAhCD,sCAgCC","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 { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport {\n  type BaseTool,\n  RushConflictResolverTool,\n  RushMigrateProjectTool,\n  RushCommandValidatorTool,\n  RushWorkspaceDetailsTool,\n  RushProjectDetailsTool,\n  RushDocsTool\n} from './tools';\n\nexport class RushMCPServer extends McpServer {\n  private _rushWorkspacePath: string;\n  private _tools: BaseTool[] = [];\n\n  public constructor(rushWorkspacePath: string) {\n    super({\n      name: 'rush',\n      version: '1.0.0'\n    });\n\n    this._rushWorkspacePath = rushWorkspacePath;\n\n    this._initializeTools();\n    this._registerTools();\n  }\n\n  private _initializeTools(): void {\n    this._tools.push(new RushConflictResolverTool());\n    this._tools.push(new RushMigrateProjectTool(this._rushWorkspacePath));\n    this._tools.push(new RushCommandValidatorTool());\n    this._tools.push(new RushWorkspaceDetailsTool());\n    this._tools.push(new RushProjectDetailsTool());\n    this._tools.push(new RushDocsTool());\n  }\n\n  private _registerTools(): void {\n    process.chdir(this._rushWorkspacePath);\n\n    for (const tool of this._tools) {\n      tool.register(this);\n    }\n  }\n}\n"]}

package/lib/start.d.ts

@@ -1 +1,2 @@
+export {};
 //# sourceMappingURL=start.d.ts.map

package/lib/start.js

@@ -1,4 +1,22 @@
 "use strict";
 // Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
 // See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const log_1 = require("./utilities/log");
+const server_1 = require("./server");
+const main = async () => {
+    const rushWorkspacePath = process.argv[2];
+    if (!rushWorkspacePath) {
+        throw new Error('Please provide workspace root path as the first argument');
+    }
+    const server = new server_1.RushMCPServer(rushWorkspacePath);
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    (0, log_1.log)('Rush MCP Server running on stdio');
+};
+main().catch((error) => {
+    (0, log_1.log)('Fatal error running server:', error);
+    process.exit(1);
+});
 //# sourceMappingURL=start.js.map

package/lib/start.js.map

@@ -1 +1 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n"]}
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;AAE3D,wEAAiF;AAEjF,yCAAsC;AACtC,qCAAyC;AAEzC,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;IACrC,MAAM,iBAAiB,GAAuB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9D,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,MAAM,GAAkB,IAAI,sBAAa,CAAC,iBAAiB,CAAC,CAAC;IACnE,MAAM,SAAS,GAAyB,IAAI,+BAAoB,EAAE,CAAC;IACnE,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,IAAA,SAAG,EAAC,kCAAkC,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,IAAA,SAAG,EAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,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 { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\n\nimport { log } from './utilities/log';\nimport { RushMCPServer } from './server';\n\nconst main = async (): Promise<void> => {\n  const rushWorkspacePath: string | undefined = process.argv[2];\n  if (!rushWorkspacePath) {\n    throw new Error('Please provide workspace root path as the first argument');\n  }\n\n  const server: RushMCPServer = new RushMCPServer(rushWorkspacePath);\n  const transport: StdioServerTransport = new StdioServerTransport();\n  await server.connect(transport);\n\n  log('Rush MCP Server running on stdio');\n};\n\nmain().catch((error) => {\n  log('Fatal error running server:', error);\n  process.exit(1);\n});\n"]}

package/lib/tools/base.tool.d.ts

@@ -0,0 +1,19 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp';
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol';
+import type { CallToolResultSchema, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types';
+import type { z, ZodRawShape, ZodTypeAny } from 'zod';
+export type CallToolResult = z.infer<typeof CallToolResultSchema>;
+type ToolCallback<Args extends undefined | ZodRawShape = undefined> = Args extends ZodRawShape ? (args: z.objectOutputType<Args, ZodTypeAny>, extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => CallToolResult | Promise<CallToolResult> : (extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => CallToolResult | Promise<CallToolResult>;
+export interface IBaseToolOptions<Args extends ZodRawShape = ZodRawShape> {
+    name: string;
+    description: string;
+    schema: Args;
+}
+export declare abstract class BaseTool<Args extends ZodRawShape = ZodRawShape> {
+    private _options;
+    protected constructor(options: IBaseToolOptions<Args>);
+    protected abstract executeAsync(...args: Parameters<ToolCallback<Args>>): ReturnType<ToolCallback<Args>>;
+    register(server: McpServer): void;
+}
+export {};
+//# sourceMappingURL=base.tool.d.ts.map

package/lib/tools/base.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.tool.d.ts","sourceRoot":"","sources":["../../src/tools/base.tool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACd,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,KAAK,YAAY,CAAC,IAAI,SAAS,SAAS,GAAG,WAAW,GAAG,SAAS,IAAI,IAAI,SAAS,WAAW,GAC1F,CACE,IAAI,EAAE,CAAC,CAAC,gBAAgB,CAAC,IAAI,EAAE,UAAU,CAAC,EAC1C,KAAK,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,KAC1D,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,GAC7C,CACE,KAAK,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,KAC1D,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAElD,MAAM,WAAW,gBAAgB,CAAC,IAAI,SAAS,WAAW,GAAG,WAAW;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,IAAI,CAAC;CACd;AAED,8BAAsB,QAAQ,CAAC,IAAI,SAAS,WAAW,GAAG,WAAW;IACnE,OAAO,CAAC,QAAQ,CAAyB;IAEzC,SAAS,aAAa,OAAO,EAAE,gBAAgB,CAAC,IAAI,CAAC;IAIrD,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAEjG,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CAoBzC"}

package/lib/tools/base.tool.js

@@ -0,0 +1,33 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseTool = void 0;
+class BaseTool {
+    constructor(options) {
+        this._options = options;
+    }
+    register(server) {
+        // TODO: remove ts-ignore
+        // @ts-ignore
+        server.tool(this._options.name, this._options.description, this._options.schema, async (...args) => {
+            try {
+                const result = await this.executeAsync(...args);
+                return result;
+            }
+            catch (error) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: 'text',
+                            text: error instanceof Error ? error.message : error
+                        }
+                    ]
+                };
+            }
+        });
+    }
+}
+exports.BaseTool = BaseTool;
+//# sourceMappingURL=base.tool.js.map

package/lib/tools/base.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.tool.js","sourceRoot":"","sources":["../../src/tools/base.tool.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AA4B3D,MAAsB,QAAQ;IAG5B,YAAsB,OAA+B;QACnD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAIM,QAAQ,CAAC,MAAiB;QAC/B,yBAAyB;QACzB,aAAa;QACb,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;YACjG,IAAI,CAAC;gBACH,MAAM,MAAM,GAAmB,MAAM,IAAI,CAAC,YAAY,CAAC,GAAI,IAAuC,CAAC,CAAC;gBACpG,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;yBACrD;qBACF;iBACF,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AA7BD,4BA6BC","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 { McpServer } from '@modelcontextprotocol/sdk/server/mcp';\nimport type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol';\nimport type {\n  CallToolResultSchema,\n  ServerNotification,\n  ServerRequest\n} from '@modelcontextprotocol/sdk/types';\nimport type { z, ZodRawShape, ZodTypeAny } from 'zod';\n\nexport type CallToolResult = z.infer<typeof CallToolResultSchema>;\n\ntype ToolCallback<Args extends undefined | ZodRawShape = undefined> = Args extends ZodRawShape\n  ? (\n      args: z.objectOutputType<Args, ZodTypeAny>,\n      extra: RequestHandlerExtra<ServerRequest, ServerNotification>\n    ) => CallToolResult | Promise<CallToolResult>\n  : (\n      extra: RequestHandlerExtra<ServerRequest, ServerNotification>\n    ) => CallToolResult | Promise<CallToolResult>;\n\nexport interface IBaseToolOptions<Args extends ZodRawShape = ZodRawShape> {\n  name: string;\n  description: string;\n  schema: Args;\n}\n\nexport abstract class BaseTool<Args extends ZodRawShape = ZodRawShape> {\n  private _options: IBaseToolOptions<Args>;\n\n  protected constructor(options: IBaseToolOptions<Args>) {\n    this._options = options;\n  }\n\n  protected abstract executeAsync(...args: Parameters<ToolCallback<Args>>): ReturnType<ToolCallback<Args>>;\n\n  public register(server: McpServer): void {\n    // TODO: remove ts-ignore\n    // @ts-ignore\n    server.tool(this._options.name, this._options.description, this._options.schema, async (...args) => {\n      try {\n        const result: CallToolResult = await this.executeAsync(...(args as Parameters<ToolCallback<Args>>));\n        return result;\n      } catch (error: unknown) {\n        return {\n          isError: true,\n          content: [\n            {\n              type: 'text',\n              text: error instanceof Error ? error.message : error\n            }\n          ]\n        };\n      }\n    });\n  }\n}\n"]}

package/lib/tools/conflict-resolver.tool.d.ts

@@ -0,0 +1,9 @@
+import { BaseTool, type CallToolResult } from './base.tool';
+export declare class RushConflictResolverTool extends BaseTool {
+    constructor();
+    private _tryGetSubspaceNameFromLockfilePath;
+    executeAsync({ lockfilePath }: {
+        lockfilePath: string;
+    }): Promise<CallToolResult>;
+}
+//# sourceMappingURL=conflict-resolver.tool.d.ts.map

package/lib/tools/conflict-resolver.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-resolver.tool.d.ts","sourceRoot":"","sources":["../../src/tools/conflict-resolver.tool.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D,qBAAa,wBAAyB,SAAQ,QAAQ;;IAYpD,OAAO,CAAC,mCAAmC;IAa9B,YAAY,CAAC,EAAE,YAAY,EAAE,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;CA0B/F"}

package/lib/tools/conflict-resolver.tool.js

@@ -0,0 +1,52 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RushConflictResolverTool = void 0;
+const zod_1 = require("zod");
+const command_runner_1 = require("../utilities/command-runner");
+const common_1 = require("../utilities/common");
+const base_tool_1 = require("./base.tool");
+class RushConflictResolverTool extends base_tool_1.BaseTool {
+    constructor() {
+        super({
+            name: 'rush_pnpm_lock_file_conflict_resolver',
+            description: 'If a user requests to resolve a pnpm-lock.yaml file conflict, use this tool to automatically fix the conflict directly.',
+            schema: {
+                lockfilePath: zod_1.z.string().describe('The path to the pnpm-lock.yaml file, should pass absolute path')
+            }
+        });
+    }
+    _tryGetSubspaceNameFromLockfilePath(lockfilePath, rushConfiguration) {
+        for (const subspace of rushConfiguration.subspaces) {
+            const folderPath = subspace.getSubspaceConfigFolderPath();
+            if (lockfilePath.startsWith(folderPath)) {
+                return subspace.subspaceName;
+            }
+        }
+        return null;
+    }
+    async executeAsync({ lockfilePath }) {
+        const rushConfiguration = await (0, common_1.getRushConfiguration)();
+        const subspaceName = this._tryGetSubspaceNameFromLockfilePath(lockfilePath, rushConfiguration);
+        if (!subspaceName) {
+            throw new Error('subspace name not found');
+        }
+        const options = {
+            stdio: 'inherit',
+            currentWorkingDirectory: rushConfiguration.rushJsonFolder
+        };
+        await command_runner_1.CommandRunner.runGitCommandAsync(['checkout', '--theirs', lockfilePath], options);
+        await command_runner_1.CommandRunner.runRushCommandAsync(['update', '--subspace', subspaceName], options);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Conflict resolved successfully'
+                }
+            ]
+        };
+    }
+}
+exports.RushConflictResolverTool = RushConflictResolverTool;
+//# sourceMappingURL=conflict-resolver.tool.js.map

package/lib/tools/conflict-resolver.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-resolver.tool.js","sourceRoot":"","sources":["../../src/tools/conflict-resolver.tool.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,6BAAwB;AAIxB,gEAA4D;AAC5D,gDAA2D;AAC3D,2CAA4D;AAE5D,MAAa,wBAAyB,SAAQ,oBAAQ;IACpD;QACE,KAAK,CAAC;YACJ,IAAI,EAAE,uCAAuC;YAC7C,WAAW,EACT,yHAAyH;YAC3H,MAAM,EAAE;gBACN,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;aACpG;SACF,CAAC,CAAC;IACL,CAAC;IAEO,mCAAmC,CACzC,YAAoB,EACpB,iBAAoC;QAEpC,KAAK,MAAM,QAAQ,IAAI,iBAAiB,CAAC,SAAS,EAAE,CAAC;YACnD,MAAM,UAAU,GAAW,QAAQ,CAAC,2BAA2B,EAAE,CAAC;YAClE,IAAI,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBACxC,OAAO,QAAQ,CAAC,YAAY,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,EAAE,YAAY,EAA4B;QAClE,MAAM,iBAAiB,GAAsB,MAAM,IAAA,6BAAoB,GAAE,CAAC;QAC1E,MAAM,YAAY,GAAkB,IAAI,CAAC,mCAAmC,CAC1E,YAAY,EACZ,iBAAiB,CAClB,CAAC;QACF,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,OAAO,GAAgC;YAC3C,KAAK,EAAE,SAAS;YAChB,uBAAuB,EAAE,iBAAiB,CAAC,cAAc;SAC1D,CAAC;QACF,MAAM,8BAAa,CAAC,kBAAkB,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;QACxF,MAAM,8BAAa,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;QAEzF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,gCAAgC;iBACvC;aACF;SACF,CAAC;IACJ,CAAC;CACF;AAnDD,4DAmDC","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 { z } from 'zod';\nimport type { RushConfiguration } from '@rushstack/rush-sdk';\nimport type { IExecutableSpawnSyncOptions } from '@rushstack/node-core-library';\n\nimport { CommandRunner } from '../utilities/command-runner';\nimport { getRushConfiguration } from '../utilities/common';\nimport { BaseTool, type CallToolResult } from './base.tool';\n\nexport class RushConflictResolverTool extends BaseTool {\n  public constructor() {\n    super({\n      name: 'rush_pnpm_lock_file_conflict_resolver',\n      description:\n        'If a user requests to resolve a pnpm-lock.yaml file conflict, use this tool to automatically fix the conflict directly.',\n      schema: {\n        lockfilePath: z.string().describe('The path to the pnpm-lock.yaml file, should pass absolute path')\n      }\n    });\n  }\n\n  private _tryGetSubspaceNameFromLockfilePath(\n    lockfilePath: string,\n    rushConfiguration: RushConfiguration\n  ): string | null {\n    for (const subspace of rushConfiguration.subspaces) {\n      const folderPath: string = subspace.getSubspaceConfigFolderPath();\n      if (lockfilePath.startsWith(folderPath)) {\n        return subspace.subspaceName;\n      }\n    }\n    return null;\n  }\n\n  public async executeAsync({ lockfilePath }: { lockfilePath: string }): Promise<CallToolResult> {\n    const rushConfiguration: RushConfiguration = await getRushConfiguration();\n    const subspaceName: string | null = this._tryGetSubspaceNameFromLockfilePath(\n      lockfilePath,\n      rushConfiguration\n    );\n    if (!subspaceName) {\n      throw new Error('subspace name not found');\n    }\n\n    const options: IExecutableSpawnSyncOptions = {\n      stdio: 'inherit',\n      currentWorkingDirectory: rushConfiguration.rushJsonFolder\n    };\n    await CommandRunner.runGitCommandAsync(['checkout', '--theirs', lockfilePath], options);\n    await CommandRunner.runRushCommandAsync(['update', '--subspace', subspaceName], options);\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: 'Conflict resolved successfully'\n        }\n      ]\n    };\n  }\n}\n"]}

package/lib/tools/docs.tool.d.ts

@@ -0,0 +1,8 @@
+import { BaseTool, type CallToolResult } from './base.tool';
+export declare class RushDocsTool extends BaseTool {
+    constructor();
+    executeAsync({ userQuery }: {
+        userQuery: string;
+    }): Promise<CallToolResult>;
+}
+//# sourceMappingURL=docs.tool.d.ts.map

package/lib/tools/docs.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.tool.d.ts","sourceRoot":"","sources":["../../src/tools/docs.tool.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAY5D,qBAAa,YAAa,SAAQ,QAAQ;;IAY3B,YAAY,CAAC,EAAE,SAAS,EAAE,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;CAqBzF"}

package/lib/tools/docs.tool.js

@@ -0,0 +1,39 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RushDocsTool = void 0;
+const zod_1 = require("zod");
+const base_tool_1 = require("./base.tool");
+class RushDocsTool extends base_tool_1.BaseTool {
+    constructor() {
+        super({
+            name: 'rush_docs',
+            description: 'Search and retrieve relevant sections from Rush official documentation based on user queries.',
+            schema: {
+                userQuery: zod_1.z.string().describe('The user query to search for relevant documentation sections.')
+            }
+        });
+    }
+    async executeAsync({ userQuery }) {
+        // An example of a knowledge base that can run, but needs to be replaced with Microsoft’s service.
+        const response = await fetch('http://47.120.46.115/search', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({ query: userQuery, topK: 10 })
+        });
+        const result = (await response.json());
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: result.results.map((item) => item.text).join('\n')
+                }
+            ]
+        };
+    }
+}
+exports.RushDocsTool = RushDocsTool;
+//# sourceMappingURL=docs.tool.js.map

package/lib/tools/docs.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.tool.js","sourceRoot":"","sources":["../../src/tools/docs.tool.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,6BAAwB;AAExB,2CAA4D;AAY5D,MAAa,YAAa,SAAQ,oBAAQ;IACxC;QACE,KAAK,CAAC;YACJ,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,+FAA+F;YACjG,MAAM,EAAE;gBACN,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;aAChG;SACF,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,EAAE,SAAS,EAAyB;QAC5D,kGAAkG;QAClG,MAAM,QAAQ,GAAa,MAAM,KAAK,CAAC,6BAA6B,EAAE;YACpE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;SACrD,CAAC,CAAC;QAEH,MAAM,MAAM,GAAgB,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgB,CAAC;QAEnE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;iBACzD;aACF;SACF,CAAC;IACJ,CAAC;CACF;AAjCD,oCAiCC","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 { z } from 'zod';\n\nimport { BaseTool, type CallToolResult } from './base.tool';\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 RushDocsTool extends BaseTool {\n  public constructor() {\n    super({\n      name: 'rush_docs',\n      description:\n        'Search and retrieve relevant sections from Rush official documentation based on user queries.',\n      schema: {\n        userQuery: z.string().describe('The user query to search for relevant documentation sections.')\n      }\n    });\n  }\n\n  public async executeAsync({ userQuery }: { userQuery: string }): Promise<CallToolResult> {\n    // An example of a knowledge base that can run, but needs to be replaced with Microsoft’s service.\n    const response: Response = await fetch('http://47.120.46.115/search', {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json'\n      },\n      body: JSON.stringify({ query: userQuery, topK: 10 })\n    });\n\n    const result: IDocsResult = (await response.json()) as IDocsResult;\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: result.results.map((item) => item.text).join('\\n')\n        }\n      ]\n    };\n  }\n}\n"]}

package/lib/tools/index.d.ts

@@ -0,0 +1,8 @@
+export * from './base.tool';
+export * from './migrate-project.tool';
+export * from './project-details.tool';
+export * from './rush-command-validator.tool';
+export * from './workspace-details';
+export * from './conflict-resolver.tool';
+export * from './docs.tool';
+//# sourceMappingURL=index.d.ts.map

package/lib/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,aAAa,CAAC"}

package/lib/tools/index.js

@@ -0,0 +1,26 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./base.tool"), exports);
+__exportStar(require("./migrate-project.tool"), exports);
+__exportStar(require("./project-details.tool"), exports);
+__exportStar(require("./rush-command-validator.tool"), exports);
+__exportStar(require("./workspace-details"), exports);
+__exportStar(require("./conflict-resolver.tool"), exports);
+__exportStar(require("./docs.tool"), exports);
+//# sourceMappingURL=index.js.map

package/lib/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;AAE3D,8CAA4B;AAC5B,yDAAuC;AACvC,yDAAuC;AACvC,gEAA8C;AAC9C,sDAAoC;AACpC,2DAAyC;AACzC,8CAA4B","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nexport * from './base.tool';\nexport * from './migrate-project.tool';\nexport * from './project-details.tool';\nexport * from './rush-command-validator.tool';\nexport * from './workspace-details';\nexport * from './conflict-resolver.tool';\nexport * from './docs.tool';\n"]}

package/lib/tools/migrate-project.tool.d.ts

@@ -0,0 +1,13 @@
+import { BaseTool, type CallToolResult } from './base.tool';
+export declare class RushMigrateProjectTool extends BaseTool {
+    private _rushWorkspacePath;
+    constructor(rushWorkspacePath: string);
+    private _modifyAndSaveSubspaceJsonFileAsync;
+    private _modifyAndSaveRushConfigurationAsync;
+    executeAsync({ projectName, targetSubspaceName, targetProjectPath }: {
+        projectName: string;
+        targetProjectPath: string;
+        targetSubspaceName: string;
+    }): Promise<CallToolResult>;
+}
+//# sourceMappingURL=migrate-project.tool.d.ts.map

package/lib/tools/migrate-project.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-project.tool.d.ts","sourceRoot":"","sources":["../../src/tools/migrate-project.tool.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ5D,qBAAa,sBAAuB,SAAQ,QAAQ;IAClD,OAAO,CAAC,kBAAkB,CAAS;gBAEhB,iBAAiB,EAAE,MAAM;YAc9B,mCAAmC;YAgBnC,oCAAoC;IAerC,YAAY,CAAC,EACxB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EAClB,EAAE;QACD,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,cAAc,CAAC;CA+D5B"}

package/lib/tools/migrate-project.tool.js

@@ -0,0 +1,100 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RushMigrateProjectTool = void 0;
+const zod_1 = require("zod");
+const node_core_library_1 = require("@rushstack/node-core-library");
+const base_tool_1 = require("./base.tool");
+const common_1 = require("../utilities/common");
+const path_1 = __importDefault(require("path"));
+class RushMigrateProjectTool extends base_tool_1.BaseTool {
+    constructor(rushWorkspacePath) {
+        super({
+            name: 'rush_migrate_project',
+            description: 'Migrate a project to a different location or subspace within the Rush monorepo.',
+            schema: {
+                projectName: zod_1.z.string().describe('The name of the project to be migrated'),
+                targetProjectPath: zod_1.z.string().optional().describe('The target path to migrate the project to'),
+                targetSubspaceName: zod_1.z.string().optional().describe('The target subspace to migrate the project to')
+            }
+        });
+        this._rushWorkspacePath = rushWorkspacePath;
+    }
+    async _modifyAndSaveSubspaceJsonFileAsync(rushConfiguration, cb) {
+        const subspacesFolderPath = path_1.default.resolve(rushConfiguration.commonRushConfigFolder, 'subspaces.json');
+        const subspacesConfiguration = await node_core_library_1.JsonFile.loadAsync(subspacesFolderPath);
+        const newSubspaceNames = await cb(subspacesConfiguration.subspaceNames);
+        subspacesConfiguration.subspaceNames = newSubspaceNames;
+        await node_core_library_1.JsonFile.saveAsync(subspacesConfiguration, subspacesFolderPath, {
+            updateExistingFile: true
+        });
+    }
+    async _modifyAndSaveRushConfigurationAsync(rushConfiguration, cb) {
+        const rushConfigurationJson = rushConfiguration.rushConfigurationJson;
+        const rushConfigurationFile = rushConfiguration.rushJsonFile;
+        const newRushConfigurationProjectJson = await cb(rushConfigurationJson.projects);
+        rushConfigurationJson.projects = newRushConfigurationProjectJson;
+        await node_core_library_1.JsonFile.saveAsync(rushConfigurationJson, rushConfigurationFile, { updateExistingFile: true });
+    }
+    async executeAsync({ projectName, targetSubspaceName, targetProjectPath }) {
+        const rushConfiguration = await (0, common_1.getRushConfiguration)();
+        const project = rushConfiguration.getProjectByName(projectName);
+        if (!project) {
+            return {
+                isError: true,
+                content: [{ type: 'text', text: `Project "${projectName}" not found` }]
+            };
+        }
+        const rootPath = this._rushWorkspacePath;
+        const sourceProjectSubspaceName = project.subspace.subspaceName;
+        const sourceProjectPath = project.projectFolder;
+        const destinationPath = path_1.default.resolve(rootPath, targetProjectPath);
+        const subspacehasOnlyOneProject = project.subspace.getProjects().length === 1;
+        // 1. Remove source subspace folder
+        if (subspacehasOnlyOneProject) {
+            const subspaceConfigFolderPath = project.subspace.getSubspaceConfigFolderPath();
+            await node_core_library_1.FileSystem.deleteFolderAsync(subspaceConfigFolderPath);
+        }
+        // 2. Move project to target subspace
+        await node_core_library_1.FileSystem.moveAsync({
+            sourcePath: sourceProjectPath,
+            destinationPath
+        });
+        // 3. Update rush configuration
+        await this._modifyAndSaveRushConfigurationAsync(rushConfiguration, (projects) => {
+            const projectIndex = projects.findIndex(({ packageName }) => packageName === projectName);
+            projects[projectIndex] = {
+                ...projects[projectIndex],
+                subspaceName: targetSubspaceName,
+                projectFolder: path_1.default.relative(rootPath, destinationPath)
+            };
+            return projects;
+        });
+        // 4. Update `subspaces.json`
+        await this._modifyAndSaveSubspaceJsonFileAsync(rushConfiguration, (subspaceNames) => {
+            if (subspacehasOnlyOneProject) {
+                subspaceNames.splice(subspaceNames.indexOf(sourceProjectSubspaceName), 1);
+            }
+            if (!subspaceNames.includes(targetSubspaceName)) {
+                subspaceNames.push(targetSubspaceName);
+            }
+            return subspaceNames;
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Project "${projectName}" migrated to subspace "${targetSubspaceName}" successfully. ` +
+                        `You can ask whether user wants to run "rush update --subspace ${targetSubspaceName}" to update the project. ` +
+                        `If user says "yes" you can run "rush update --subspace ${targetSubspaceName}" directly for them.`
+                }
+            ]
+        };
+    }
+}
+exports.RushMigrateProjectTool = RushMigrateProjectTool;
+//# sourceMappingURL=migrate-project.tool.js.map

package/lib/tools/migrate-project.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-project.tool.js","sourceRoot":"","sources":["../../src/tools/migrate-project.tool.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;AAE3D,6BAAwB;AACxB,oEAAoE;AAEpE,2CAA4D;AAC5D,gDAA2D;AAC3D,gDAAwB;AAMxB,MAAa,sBAAuB,SAAQ,oBAAQ;IAGlD,YAAmB,iBAAyB;QAC1C,KAAK,CAAC;YACJ,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,iFAAiF;YAC9F,MAAM,EAAE;gBACN,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;gBAC1E,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;gBAC9F,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;aACpG;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;IAC9C,CAAC;IAEO,KAAK,CAAC,mCAAmC,CAC/C,iBAAoC,EACpC,EAA6D;QAE7D,MAAM,mBAAmB,GAAW,cAAI,CAAC,OAAO,CAC9C,iBAAiB,CAAC,sBAAsB,EACxC,gBAAgB,CACjB,CAAC;QACF,MAAM,sBAAsB,GAAgC,MAAM,4BAAQ,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAC1G,MAAM,gBAAgB,GAAa,MAAM,EAAE,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;QAClF,sBAAsB,CAAC,aAAa,GAAG,gBAAgB,CAAC;QACxD,MAAM,4BAAQ,CAAC,SAAS,CAAC,sBAAsB,EAAE,mBAAmB,EAAE;YACpE,kBAAkB,EAAE,IAAI;SACzB,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,oCAAoC,CAChD,iBAAoC,EACpC,EAE+E;QAE/E,MAAM,qBAAqB,GAA2B,iBAAiB,CAAC,qBAAqB,CAAC;QAC9F,MAAM,qBAAqB,GAAW,iBAAiB,CAAC,YAAY,CAAC;QACrE,MAAM,+BAA+B,GAAoC,MAAM,EAAE,CAC/E,qBAAqB,CAAC,QAAQ,CAC/B,CAAC;QACF,qBAAqB,CAAC,QAAQ,GAAG,+BAA+B,CAAC;QACjE,MAAM,4BAAQ,CAAC,SAAS,CAAC,qBAAqB,EAAE,qBAAqB,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;IACvG,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,EACxB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EAKlB;QACC,MAAM,iBAAiB,GAAsB,MAAM,IAAA,6BAAoB,GAAE,CAAC;QAC1E,MAAM,OAAO,GAAyC,iBAAiB,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAEtG,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,WAAW,aAAa,EAAE,CAAC;aACxE,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAW,IAAI,CAAC,kBAAkB,CAAC;QACjD,MAAM,yBAAyB,GAAW,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;QACxE,MAAM,iBAAiB,GAAW,OAAO,CAAC,aAAa,CAAC;QACxD,MAAM,eAAe,GAAW,cAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;QAC1E,MAAM,yBAAyB,GAAY,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;QAEvF,mCAAmC;QACnC,IAAI,yBAAyB,EAAE,CAAC;YAC9B,MAAM,wBAAwB,GAAW,OAAO,CAAC,QAAQ,CAAC,2BAA2B,EAAE,CAAC;YACxF,MAAM,8BAAU,CAAC,iBAAiB,CAAC,wBAAwB,CAAC,CAAC;QAC/D,CAAC;QAED,qCAAqC;QACrC,MAAM,8BAAU,CAAC,SAAS,CAAC;YACzB,UAAU,EAAE,iBAAiB;YAC7B,eAAe;SAChB,CAAC,CAAC;QAEH,+BAA+B;QAC/B,MAAM,IAAI,CAAC,oCAAoC,CAAC,iBAAiB,EAAE,CAAC,QAAQ,EAAE,EAAE;YAC9E,MAAM,YAAY,GAAW,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;YAClG,QAAQ,CAAC,YAAY,CAAC,GAAG;gBACvB,GAAG,QAAQ,CAAC,YAAY,CAAC;gBACzB,YAAY,EAAE,kBAAkB;gBAChC,aAAa,EAAE,cAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;aACxD,CAAC;YACF,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,6BAA6B;QAC7B,MAAM,IAAI,CAAC,mCAAmC,CAAC,iBAAiB,EAAE,CAAC,aAAa,EAAE,EAAE;YAClF,IAAI,yBAAyB,EAAE,CAAC;gBAC9B,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,CAAC;YAC5E,CAAC;YACD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAChD,aAAa,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YACzC,CAAC;YACD,OAAO,aAAa,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EACF,YAAY,WAAW,2BAA2B,kBAAkB,kBAAkB;wBACtF,iEAAiE,kBAAkB,2BAA2B;wBAC9G,0DAA0D,kBAAkB,sBAAsB;iBACrG;aACF;SACF,CAAC;IACJ,CAAC;CACF;AAvHD,wDAuHC","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 { z } from 'zod';\nimport { FileSystem, JsonFile } from '@rushstack/node-core-library';\n\nimport { BaseTool, type CallToolResult } from './base.tool';\nimport { getRushConfiguration } from '../utilities/common';\nimport path from 'path';\nimport type { ISubspacesConfigurationJson } from '@rushstack/rush-sdk/lib/api/SubspacesConfiguration';\nimport type { RushConfiguration, RushConfigurationProject } from '@rushstack/rush-sdk';\nimport type { IRushConfigurationProjectJson } from '@rushstack/rush-sdk/lib/api/RushConfigurationProject';\nimport type { IRushConfigurationJson } from '@rushstack/rush-sdk/lib/api/RushConfiguration';\n\nexport class RushMigrateProjectTool extends BaseTool {\n  private _rushWorkspacePath: string;\n\n  public constructor(rushWorkspacePath: string) {\n    super({\n      name: 'rush_migrate_project',\n      description: 'Migrate a project to a different location or subspace within the Rush monorepo.',\n      schema: {\n        projectName: z.string().describe('The name of the project to be migrated'),\n        targetProjectPath: z.string().optional().describe('The target path to migrate the project to'),\n        targetSubspaceName: z.string().optional().describe('The target subspace to migrate the project to')\n      }\n    });\n\n    this._rushWorkspacePath = rushWorkspacePath;\n  }\n\n  private async _modifyAndSaveSubspaceJsonFileAsync(\n    rushConfiguration: RushConfiguration,\n    cb: (subspaceNames: string[]) => Promise<string[]> | string[]\n  ): Promise<void> {\n    const subspacesFolderPath: string = path.resolve(\n      rushConfiguration.commonRushConfigFolder,\n      'subspaces.json'\n    );\n    const subspacesConfiguration: ISubspacesConfigurationJson = await JsonFile.loadAsync(subspacesFolderPath);\n    const newSubspaceNames: string[] = await cb(subspacesConfiguration.subspaceNames);\n    subspacesConfiguration.subspaceNames = newSubspaceNames;\n    await JsonFile.saveAsync(subspacesConfiguration, subspacesFolderPath, {\n      updateExistingFile: true\n    });\n  }\n\n  private async _modifyAndSaveRushConfigurationAsync(\n    rushConfiguration: RushConfiguration,\n    cb: (\n      projects: IRushConfigurationProjectJson[]\n    ) => Promise<IRushConfigurationProjectJson[]> | IRushConfigurationProjectJson[]\n  ): Promise<void> {\n    const rushConfigurationJson: IRushConfigurationJson = rushConfiguration.rushConfigurationJson;\n    const rushConfigurationFile: string = rushConfiguration.rushJsonFile;\n    const newRushConfigurationProjectJson: IRushConfigurationProjectJson[] = await cb(\n      rushConfigurationJson.projects\n    );\n    rushConfigurationJson.projects = newRushConfigurationProjectJson;\n    await JsonFile.saveAsync(rushConfigurationJson, rushConfigurationFile, { updateExistingFile: true });\n  }\n\n  public async executeAsync({\n    projectName,\n    targetSubspaceName,\n    targetProjectPath\n  }: {\n    projectName: string;\n    targetProjectPath: string;\n    targetSubspaceName: string;\n  }): Promise<CallToolResult> {\n    const rushConfiguration: RushConfiguration = await getRushConfiguration();\n    const project: RushConfigurationProject | undefined = rushConfiguration.getProjectByName(projectName);\n\n    if (!project) {\n      return {\n        isError: true,\n        content: [{ type: 'text', text: `Project \"${projectName}\" not found` }]\n      };\n    }\n\n    const rootPath: string = this._rushWorkspacePath;\n    const sourceProjectSubspaceName: string = project.subspace.subspaceName;\n    const sourceProjectPath: string = project.projectFolder;\n    const destinationPath: string = path.resolve(rootPath, targetProjectPath);\n    const subspacehasOnlyOneProject: boolean = project.subspace.getProjects().length === 1;\n\n    // 1. Remove source subspace folder\n    if (subspacehasOnlyOneProject) {\n      const subspaceConfigFolderPath: string = project.subspace.getSubspaceConfigFolderPath();\n      await FileSystem.deleteFolderAsync(subspaceConfigFolderPath);\n    }\n\n    // 2. Move project to target subspace\n    await FileSystem.moveAsync({\n      sourcePath: sourceProjectPath,\n      destinationPath\n    });\n\n    // 3. Update rush configuration\n    await this._modifyAndSaveRushConfigurationAsync(rushConfiguration, (projects) => {\n      const projectIndex: number = projects.findIndex(({ packageName }) => packageName === projectName);\n      projects[projectIndex] = {\n        ...projects[projectIndex],\n        subspaceName: targetSubspaceName,\n        projectFolder: path.relative(rootPath, destinationPath)\n      };\n      return projects;\n    });\n\n    // 4. Update `subspaces.json`\n    await this._modifyAndSaveSubspaceJsonFileAsync(rushConfiguration, (subspaceNames) => {\n      if (subspacehasOnlyOneProject) {\n        subspaceNames.splice(subspaceNames.indexOf(sourceProjectSubspaceName), 1);\n      }\n      if (!subspaceNames.includes(targetSubspaceName)) {\n        subspaceNames.push(targetSubspaceName);\n      }\n      return subspaceNames;\n    });\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text:\n            `Project \"${projectName}\" migrated to subspace \"${targetSubspaceName}\" successfully. ` +\n            `You can ask whether user wants to run \"rush update --subspace ${targetSubspaceName}\" to update the project. ` +\n            `If user says \"yes\" you can run \"rush update --subspace ${targetSubspaceName}\" directly for them.`\n        }\n      ]\n    };\n  }\n}\n"]}

package/lib/tools/project-details.tool.d.ts

@@ -0,0 +1,8 @@
+import { BaseTool, type CallToolResult } from './base.tool';
+export declare class RushProjectDetailsTool extends BaseTool {
+    constructor();
+    executeAsync({ projectName }: {
+        projectName: string;
+    }): Promise<CallToolResult>;
+}
+//# sourceMappingURL=project-details.tool.d.ts.map

package/lib/tools/project-details.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-details.tool.d.ts","sourceRoot":"","sources":["../../src/tools/project-details.tool.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D,qBAAa,sBAAuB,SAAQ,QAAQ;;IAWrC,YAAY,CAAC,EAAE,WAAW,EAAE,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;CAuC7F"}

package/lib/tools/project-details.tool.js

@@ -0,0 +1,54 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RushProjectDetailsTool = void 0;
+const zod_1 = require("zod");
+const common_1 = require("../utilities/common");
+const base_tool_1 = require("./base.tool");
+class RushProjectDetailsTool extends base_tool_1.BaseTool {
+    constructor() {
+        super({
+            name: 'rush_project_details',
+            description: 'Returns the complete project details in JSON format for a given rush project.',
+            schema: {
+                projectName: zod_1.z.string().describe('The name of the project to get details for')
+            }
+        });
+    }
+    async executeAsync({ projectName }) {
+        const rushConfiguration = await (0, common_1.getRushConfiguration)();
+        const project = rushConfiguration.getProjectByName(projectName);
+        if (!project) {
+            throw new Error(`Project ${projectName} not found`);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        packageJson: project.packageJson,
+                        /**
+                         * Example: `C:\MyRepo\libraries\my-project`
+                         */
+                        projectFolder: project.projectFolder,
+                        /**
+                         * Example: `libraries/my-project`
+                         */
+                        projectRelativeFolder: project.projectRelativeFolder,
+                        /**
+                         * Example: `C:\MyRepo\libraries\my-project\config\rush`
+                         */
+                        projectRushConfigFolder: project.projectRushConfigFolder,
+                        /**
+                         * Example: `my-subspace`
+                         */
+                        projectSubspaceName: project.subspace.subspaceName
+                    }, null, 2)
+                }
+            ]
+        };
+    }
+}
+exports.RushProjectDetailsTool = RushProjectDetailsTool;
+//# sourceMappingURL=project-details.tool.js.map

package/lib/tools/project-details.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-details.tool.js","sourceRoot":"","sources":["../../src/tools/project-details.tool.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAE3D,6BAAwB;AAGxB,gDAA2D;AAC3D,2CAA4D;AAE5D,MAAa,sBAAuB,SAAQ,oBAAQ;IAClD;QACE,KAAK,CAAC;YACJ,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,+EAA+E;YAC5F,MAAM,EAAE;gBACN,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;aAC/E;SACF,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,YAAY,CAAC,EAAE,WAAW,EAA2B;QAChE,MAAM,iBAAiB,GAAsB,MAAM,IAAA,6BAAoB,GAAE,CAAC;QAC1E,MAAM,OAAO,GAAyC,iBAAiB,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAEtG,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,YAAY,CAAC,CAAC;QACtD,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,WAAW,EAAE,OAAO,CAAC,WAAW;wBAChC;;2BAEG;wBACH,aAAa,EAAE,OAAO,CAAC,aAAa;wBACpC;;2BAEG;wBACH,qBAAqB,EAAE,OAAO,CAAC,qBAAqB;wBACpD;;2BAEG;wBACH,uBAAuB,EAAE,OAAO,CAAC,uBAAuB;wBACxD;;2BAEG;wBACH,mBAAmB,EAAE,OAAO,CAAC,QAAQ,CAAC,YAAY;qBACnD,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF;AAlDD,wDAkDC","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 { z } from 'zod';\nimport type { RushConfiguration, RushConfigurationProject } from '@rushstack/rush-sdk';\n\nimport { getRushConfiguration } from '../utilities/common';\nimport { BaseTool, type CallToolResult } from './base.tool';\n\nexport class RushProjectDetailsTool extends BaseTool {\n  public constructor() {\n    super({\n      name: 'rush_project_details',\n      description: 'Returns the complete project details in JSON format for a given rush project.',\n      schema: {\n        projectName: z.string().describe('The name of the project to get details for')\n      }\n    });\n  }\n\n  public async executeAsync({ projectName }: { projectName: string }): Promise<CallToolResult> {\n    const rushConfiguration: RushConfiguration = await getRushConfiguration();\n    const project: RushConfigurationProject | undefined = rushConfiguration.getProjectByName(projectName);\n\n    if (!project) {\n      throw new Error(`Project ${projectName} not found`);\n    }\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: JSON.stringify(\n            {\n              packageJson: project.packageJson,\n              /**\n               * Example: `C:\\MyRepo\\libraries\\my-project`\n               */\n              projectFolder: project.projectFolder,\n              /**\n               * Example: `libraries/my-project`\n               */\n              projectRelativeFolder: project.projectRelativeFolder,\n              /**\n               * Example: `C:\\MyRepo\\libraries\\my-project\\config\\rush`\n               */\n              projectRushConfigFolder: project.projectRushConfigFolder,\n              /**\n               * Example: `my-subspace`\n               */\n              projectSubspaceName: project.subspace.subspaceName\n            },\n            null,\n            2\n          )\n        }\n      ]\n    };\n  }\n}\n"]}

package/lib/tools/rush-command-validator.tool.d.ts

@@ -0,0 +1,11 @@
+import { BaseTool, type CallToolResult } from './base.tool';
+export declare const selectionParamsSet: ReadonlySet<string>;
+export declare class RushCommandValidatorTool extends BaseTool {
+    constructor();
+    executeAsync({ commandName, subCommandName, args }: {
+        commandName: string;
+        subCommandName: string;
+        args: string[];
+    }): Promise<CallToolResult>;
+}
+//# sourceMappingURL=rush-command-validator.tool.d.ts.map

package/lib/tools/rush-command-validator.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rush-command-validator.tool.d.ts","sourceRoot":"","sources":["../../src/tools/rush-command-validator.tool.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAajD,CAAC;AAEH,qBAAa,wBAAyB,SAAQ,QAAQ;;IAkBvC,YAAY,CAAC,EACxB,WAAW,EACX,cAAc,EACd,IAAI,EACL,EAAE;QACD,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,GAAG,OAAO,CAAC,cAAc,CAAC;CA2D5B"}

package/lib/tools/rush-command-validator.tool.js

@@ -0,0 +1,88 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RushCommandValidatorTool = exports.selectionParamsSet = void 0;
+const zod_1 = require("zod");
+const node_core_library_1 = require("@rushstack/node-core-library");
+const path_1 = __importDefault(require("path"));
+const common_1 = require("../utilities/common");
+const base_tool_1 = require("./base.tool");
+exports.selectionParamsSet = new Set([
+    '-t',
+    '--to',
+    '--to-except',
+    '-T',
+    '--from',
+    '-f',
+    '--only',
+    '-o',
+    '--impacted-by',
+    '-i',
+    '--impacted-by-except',
+    '-I'
+]);
+class RushCommandValidatorTool extends base_tool_1.BaseTool {
+    constructor() {
+        super({
+            name: 'rush_command_validator',
+            description: 'Validates Rush commands before execution by checking command format and ensuring compliance with Rush command standards. This tool helps prevent invalid command usage and provides guidance on proper parameter selection.',
+            schema: {
+                commandName: zod_1.z.enum(['rush', 'rushx']).describe('The main command to execute (rush or rushx)'),
+                subCommandName: zod_1.z
+                    .string()
+                    .describe('The Rush subcommand to validate (install, update, add, remove, purge, list, build, etc.)'),
+                args: zod_1.z.array(zod_1.z.string()).describe('The arguments to validate for the subcommand')
+            }
+        });
+    }
+    async executeAsync({ commandName, subCommandName, args }) {
+        var _a;
+        const rushConfiguration = await (0, common_1.getRushConfiguration)();
+        const commandLineJson = await node_core_library_1.JsonFile.loadAsync(path_1.default.resolve(rushConfiguration.commonFolder, 'config', 'rush', 'command-line.json'));
+        const conditionSubCommandNames = new Set((_a = commandLineJson.commands) === null || _a === void 0 ? void 0 : _a.filter((command) => command.commandKind !== 'global').map((command) => command.name));
+        if (conditionSubCommandNames.has(subCommandName) && !args.some((arg) => exports.selectionParamsSet.has(arg))) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `Please add selection parameters like ${Array.from(exports.selectionParamsSet).join(', ')} to the command and re-validate. The package name should be retrieved from the package.json file in your project folder.`
+                    }
+                ]
+            };
+        }
+        for (const [index, arg] of args.entries()) {
+            if (exports.selectionParamsSet.has(arg)) {
+                const packageName = args[index + 1];
+                const isValidPackage = packageName === '.' || rushConfiguration.projects.some((p) => p.packageName === packageName);
+                if (!isValidPackage) {
+                    return {
+                        isError: true,
+                        content: [
+                            {
+                                type: 'text',
+                                text: `The package "${packageName}" does not exist in the Rush workspace. You can retrive package name from 'package.json' file in the project folder.`
+                            }
+                        ]
+                    };
+                }
+            }
+        }
+        const commandStr = `${commandName} ${subCommandName} ${args.join(' ')}`;
+        const text = `Command "${commandStr}" validated successfully, you can ${commandName === 'rushx' || subCommandName === 'add' ? 'enter the project folder and ' : ''}execute it now.`;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text
+                }
+            ]
+        };
+    }
+}
+exports.RushCommandValidatorTool = RushCommandValidatorTool;
+//# sourceMappingURL=rush-command-validator.tool.js.map

package/lib/tools/rush-command-validator.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rush-command-validator.tool.js","sourceRoot":"","sources":["../../src/tools/rush-command-validator.tool.ts"],"names":[],"mappings":"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","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 { z } from 'zod';\nimport { JsonFile } from '@rushstack/node-core-library';\nimport path from 'path';\nimport type { ICommandLineJson } from '@rushstack/rush-sdk/lib/api/CommandLineJson';\nimport type { RushConfiguration } from '@rushstack/rush-sdk';\n\nimport { getRushConfiguration } from '../utilities/common';\nimport { BaseTool, type CallToolResult } from './base.tool';\n\nexport const selectionParamsSet: ReadonlySet<string> = new Set([\n  '-t',\n  '--to',\n  '--to-except',\n  '-T',\n  '--from',\n  '-f',\n  '--only',\n  '-o',\n  '--impacted-by',\n  '-i',\n  '--impacted-by-except',\n  '-I'\n]);\n\nexport class RushCommandValidatorTool extends BaseTool {\n  public constructor() {\n    super({\n      name: 'rush_command_validator',\n      description:\n        'Validates Rush commands before execution by checking command format and ensuring compliance with Rush command standards. This tool helps prevent invalid command usage and provides guidance on proper parameter selection.',\n      schema: {\n        commandName: z.enum(['rush', 'rushx']).describe('The main command to execute (rush or rushx)'),\n        subCommandName: z\n          .string()\n          .describe(\n            'The Rush subcommand to validate (install, update, add, remove, purge, list, build, etc.)'\n          ),\n        args: z.array(z.string()).describe('The arguments to validate for the subcommand')\n      }\n    });\n  }\n\n  public async executeAsync({\n    commandName,\n    subCommandName,\n    args\n  }: {\n    commandName: string;\n    subCommandName: string;\n    args: string[];\n  }): Promise<CallToolResult> {\n    const rushConfiguration: RushConfiguration = await getRushConfiguration();\n    const commandLineJson: ICommandLineJson = await JsonFile.loadAsync(\n      path.resolve(rushConfiguration.commonFolder, 'config', 'rush', 'command-line.json')\n    );\n    const conditionSubCommandNames: Set<string> = new Set(\n      commandLineJson.commands\n        ?.filter((command) => command.commandKind !== 'global')\n        .map((command) => command.name)\n    );\n\n    if (conditionSubCommandNames.has(subCommandName) && !args.some((arg) => selectionParamsSet.has(arg))) {\n      return {\n        isError: true,\n        content: [\n          {\n            type: 'text',\n            text: `Please add selection parameters like ${Array.from(selectionParamsSet).join(\n              ', '\n            )} to the command and re-validate. The package name should be retrieved from the package.json file in your project folder.`\n          }\n        ]\n      };\n    }\n\n    for (const [index, arg] of args.entries()) {\n      if (selectionParamsSet.has(arg)) {\n        const packageName: string = args[index + 1];\n        const isValidPackage: boolean =\n          packageName === '.' || rushConfiguration.projects.some((p) => p.packageName === packageName);\n\n        if (!isValidPackage) {\n          return {\n            isError: true,\n            content: [\n              {\n                type: 'text',\n                text: `The package \"${packageName}\" does not exist in the Rush workspace. You can retrive package name from 'package.json' file in the project folder.`\n              }\n            ]\n          };\n        }\n      }\n    }\n\n    const commandStr: string = `${commandName} ${subCommandName} ${args.join(' ')}`;\n    const text: string = `Command \"${commandStr}\" validated successfully, you can ${\n      commandName === 'rushx' || subCommandName === 'add' ? 'enter the project folder and ' : ''\n    }execute it now.`;\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text\n        }\n      ]\n    };\n  }\n}\n"]}

package/lib/tools/workspace-details.d.ts

@@ -0,0 +1,8 @@
+import { BaseTool, type CallToolResult } from './base.tool';
+export declare class RushWorkspaceDetailsTool extends BaseTool {
+    constructor();
+    executeAsync(): Promise<CallToolResult>;
+    private _getWorkspaceDetailsPrompt;
+    private _getRobotReadableWorkspaceDetails;
+}
+//# sourceMappingURL=workspace-details.d.ts.map

package/lib/tools/workspace-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-details.d.ts","sourceRoot":"","sources":["../../src/tools/workspace-details.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE5D,qBAAa,wBAAyB,SAAQ,QAAQ;;IAUvC,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC;IAcpD,OAAO,CAAC,0BAA0B;IA2BlC,OAAO,CAAC,iCAAiC;CA+D1C"}

package/lib/tools/workspace-details.js

@@ -0,0 +1,107 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RushWorkspaceDetailsTool = void 0;
+const common_1 = require("../utilities/common");
+const base_tool_1 = require("./base.tool");
+class RushWorkspaceDetailsTool extends base_tool_1.BaseTool {
+    constructor() {
+        super({
+            name: 'rush_workspace_details',
+            description: 'Retrieves a comprehensive overview of the Rush monorepo project graph in an LLM-friendly format. Use it to answer questions about the current Rush workspace and architecture.',
+            schema: {}
+        });
+    }
+    async executeAsync() {
+        const rushConfiguration = await (0, common_1.getRushConfiguration)();
+        const projects = rushConfiguration.projects;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: this._getWorkspaceDetailsPrompt(rushConfiguration, projects)
+                }
+            ]
+        };
+    }
+    _getWorkspaceDetailsPrompt(rushConfiguration, projects) {
+        return `
+The following is a comprehensive representation of the Rush monorepo workspace. The information is organized into two sections:
+
+1. WORKSPACE LEVEL: Contains global configuration information about the Rush workspace itself.
+2. PROJECT LEVEL: Lists all projects in the monorepo with their detailed information.
+
+WORKSPACE LEVEL information includes Rush version, pnpm version, and overall project count.
+
+PROJECT LEVEL information is separated by <project_name></project_name> tags. Each project contains:
+- its direct workspace dependencies package names, marked by "deps: [...]"
+- its package name, marked by "packageName: [...]"
+- its project type/category, marked by "projectType: [...]"
+- its source file location, marked by "projectFolder: [...]"
+- its scripts/commands, marked by "scripts: [...]"
+- its version, marked by "version: [...]"
+- additional metadata if available
+
+This data is very important. Use it to analyze the workspace and understand the project graph. The user cannot see this data, so don't reference it directly. It is read-only information to help you understand the workspace.
+
+${this._getRobotReadableWorkspaceDetails(rushConfiguration.rushConfigurationJson, projects)}
+`.trim();
+    }
+    _getRobotReadableWorkspaceDetails(rushConfiguration, projects) {
+        let serializedWorkspace = '';
+        // Add workspace-level information with clearer section marking
+        serializedWorkspace += `======== WORKSPACE LEVEL INFORMATION ========\n`;
+        serializedWorkspace += `<RUSH_WORKSPACE>\n`;
+        serializedWorkspace += `  rushVersion: [${rushConfiguration.rushVersion}]\n`;
+        serializedWorkspace += `  pnpmVersion: [${rushConfiguration.pnpmVersion}]\n`;
+        serializedWorkspace += `  projectCount: [${projects.length}]\n`;
+        serializedWorkspace += `</RUSH_WORKSPACE>\n\n`;
+        serializedWorkspace += `======== PROJECT LEVEL INFORMATION ========\n`;
+        projects.forEach((project) => {
+            serializedWorkspace += `<${project.packageName}>\n`;
+            serializedWorkspace += `  packageName: [${project.packageName}]\n`;
+            serializedWorkspace += `  version: [${project.packageJson.version}]\n`;
+            serializedWorkspace += `  projectFolder: [${project.projectFolder}]\n`;
+            serializedWorkspace += `  subspaceName: [${project.subspace.subspaceName}]\n`;
+            const projectType = project.shouldPublish ? 'publishable' : 'local';
+            serializedWorkspace += `  projectType: [${projectType}]\n`;
+            const dependencies = project.dependencyProjects;
+            const depNames = Array.from(dependencies, (dep) => dep.packageName);
+            if (depNames.length === 0) {
+                serializedWorkspace += `  deps: []\n`;
+            }
+            else if (depNames.length <= 5) {
+                serializedWorkspace += `  deps: [${depNames.join(', ')}]\n`;
+            }
+            else {
+                serializedWorkspace += `  deps: [\n    ${depNames.join(',\n    ')}\n  ]\n`;
+            }
+            if (project.packageJson.scripts) {
+                const scripts = Object.keys(project.packageJson.scripts);
+                if (scripts.length === 0) {
+                    serializedWorkspace += `  scripts: []\n`;
+                }
+                else if (scripts.length <= 5) {
+                    serializedWorkspace += `  scripts: [${scripts.join(', ')}]\n`;
+                }
+                else {
+                    serializedWorkspace += `  scripts: [\n    ${scripts.join(',\n    ')}\n  ]\n`;
+                }
+            }
+            else {
+                serializedWorkspace += `  scripts: []\n`;
+            }
+            if (project.versionPolicyName) {
+                serializedWorkspace += `  versionPolicy: [${project.versionPolicyName}]\n`;
+            }
+            if (project.reviewCategory) {
+                serializedWorkspace += `  reviewCategory: [${project.reviewCategory}]\n`;
+            }
+            serializedWorkspace += `</${project.packageName}>\n\n`;
+        });
+        return serializedWorkspace;
+    }
+}
+exports.RushWorkspaceDetailsTool = RushWorkspaceDetailsTool;
+//# sourceMappingURL=workspace-details.js.map

package/lib/tools/workspace-details.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-details.js","sourceRoot":"","sources":["../../src/tools/workspace-details.ts"],"names":[],"mappings":"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","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 { RushConfiguration, RushConfigurationProject } from '@rushstack/rush-sdk';\nimport type { IRushConfigurationJson } from '@rushstack/rush-sdk/lib/api/RushConfiguration';\n\nimport { getRushConfiguration } from '../utilities/common';\nimport { BaseTool, type CallToolResult } from './base.tool';\n\nexport class RushWorkspaceDetailsTool extends BaseTool {\n  public constructor() {\n    super({\n      name: 'rush_workspace_details',\n      description:\n        'Retrieves a comprehensive overview of the Rush monorepo project graph in an LLM-friendly format. Use it to answer questions about the current Rush workspace and architecture.',\n      schema: {}\n    });\n  }\n\n  public async executeAsync(): Promise<CallToolResult> {\n    const rushConfiguration: RushConfiguration = await getRushConfiguration();\n    const projects: RushConfigurationProject[] = rushConfiguration.projects;\n\n    return {\n      content: [\n        {\n          type: 'text',\n          text: this._getWorkspaceDetailsPrompt(rushConfiguration, projects)\n        }\n      ]\n    };\n  }\n\n  private _getWorkspaceDetailsPrompt(\n    rushConfiguration: RushConfiguration,\n    projects: RushConfigurationProject[]\n  ): string {\n    return `\nThe following is a comprehensive representation of the Rush monorepo workspace. The information is organized into two sections:\n\n1. WORKSPACE LEVEL: Contains global configuration information about the Rush workspace itself.\n2. PROJECT LEVEL: Lists all projects in the monorepo with their detailed information.\n\nWORKSPACE LEVEL information includes Rush version, pnpm version, and overall project count.\n\nPROJECT LEVEL information is separated by <project_name></project_name> tags. Each project contains:\n- its direct workspace dependencies package names, marked by \"deps: [...]\"\n- its package name, marked by \"packageName: [...]\"\n- its project type/category, marked by \"projectType: [...]\"\n- its source file location, marked by \"projectFolder: [...]\"\n- its scripts/commands, marked by \"scripts: [...]\"\n- its version, marked by \"version: [...]\"\n- additional metadata if available\n\nThis data is very important. Use it to analyze the workspace and understand the project graph. The user cannot see this data, so don't reference it directly. It is read-only information to help you understand the workspace.\n\n${this._getRobotReadableWorkspaceDetails(rushConfiguration.rushConfigurationJson, projects)}\n`.trim();\n  }\n\n  private _getRobotReadableWorkspaceDetails(\n    rushConfiguration: IRushConfigurationJson,\n    projects: RushConfigurationProject[]\n  ): string {\n    let serializedWorkspace: string = '';\n\n    // Add workspace-level information with clearer section marking\n    serializedWorkspace += `======== WORKSPACE LEVEL INFORMATION ========\\n`;\n    serializedWorkspace += `<RUSH_WORKSPACE>\\n`;\n    serializedWorkspace += `  rushVersion: [${rushConfiguration.rushVersion}]\\n`;\n    serializedWorkspace += `  pnpmVersion: [${rushConfiguration.pnpmVersion}]\\n`;\n    serializedWorkspace += `  projectCount: [${projects.length}]\\n`;\n    serializedWorkspace += `</RUSH_WORKSPACE>\\n\\n`;\n    serializedWorkspace += `======== PROJECT LEVEL INFORMATION ========\\n`;\n\n    projects.forEach((project) => {\n      serializedWorkspace += `<${project.packageName}>\\n`;\n\n      serializedWorkspace += `  packageName: [${project.packageName}]\\n`;\n      serializedWorkspace += `  version: [${project.packageJson.version}]\\n`;\n      serializedWorkspace += `  projectFolder: [${project.projectFolder}]\\n`;\n      serializedWorkspace += `  subspaceName: [${project.subspace.subspaceName}]\\n`;\n\n      const projectType: string = project.shouldPublish ? 'publishable' : 'local';\n      serializedWorkspace += `  projectType: [${projectType}]\\n`;\n\n      const dependencies: ReadonlySet<RushConfigurationProject> = project.dependencyProjects;\n      const depNames: string[] = Array.from(dependencies, (dep) => dep.packageName);\n\n      if (depNames.length === 0) {\n        serializedWorkspace += `  deps: []\\n`;\n      } else if (depNames.length <= 5) {\n        serializedWorkspace += `  deps: [${depNames.join(', ')}]\\n`;\n      } else {\n        serializedWorkspace += `  deps: [\\n    ${depNames.join(',\\n    ')}\\n  ]\\n`;\n      }\n\n      if (project.packageJson.scripts) {\n        const scripts: string[] = Object.keys(project.packageJson.scripts);\n        if (scripts.length === 0) {\n          serializedWorkspace += `  scripts: []\\n`;\n        } else if (scripts.length <= 5) {\n          serializedWorkspace += `  scripts: [${scripts.join(', ')}]\\n`;\n        } else {\n          serializedWorkspace += `  scripts: [\\n    ${scripts.join(',\\n    ')}\\n  ]\\n`;\n        }\n      } else {\n        serializedWorkspace += `  scripts: []\\n`;\n      }\n\n      if (project.versionPolicyName) {\n        serializedWorkspace += `  versionPolicy: [${project.versionPolicyName}]\\n`;\n      }\n\n      if (project.reviewCategory) {\n        serializedWorkspace += `  reviewCategory: [${project.reviewCategory}]\\n`;\n      }\n\n      serializedWorkspace += `</${project.packageName}>\\n\\n`;\n    });\n\n    return serializedWorkspace;\n  }\n}\n"]}

package/lib/utilities/command-runner.d.ts

@@ -0,0 +1,21 @@
+import { type IExecutableSpawnSyncOptions } from '@rushstack/node-core-library';
+interface ICommandResult {
+    status: number;
+    stdout: string;
+    stderr: string;
+    command: string;
+    args: string[];
+}
+export declare class CommandExecutionError extends Error {
+    constructor(command: string, args: string[], stderr: string, status: number);
+}
+export declare class CommandRunner {
+    private static readonly _commandCache;
+    private static _resolveCommand;
+    private static _executeCommandAsync;
+    static runRushCommandAsync(args: string[], options?: IExecutableSpawnSyncOptions): Promise<ICommandResult>;
+    static runRushXCommandAsync(args: string[], options?: IExecutableSpawnSyncOptions): Promise<ICommandResult>;
+    static runGitCommandAsync(args: string[], options?: IExecutableSpawnSyncOptions): Promise<ICommandResult>;
+}
+export {};
+//# sourceMappingURL=command-runner.d.ts.map

package/lib/utilities/command-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-runner.d.ts","sourceRoot":"","sources":["../../src/utilities/command-runner.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAE5F,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAInF;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAyC;IAE9E,OAAO,CAAC,MAAM,CAAC,eAAe;mBAoBT,oBAAoB;WAwBrB,mBAAmB,CACrC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,cAAc,CAAC;WAIN,oBAAoB,CACtC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,cAAc,CAAC;WAIN,kBAAkB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,cAAc,CAAC;CAG3B"}

package/lib/utilities/command-runner.js

@@ -0,0 +1,59 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandRunner = exports.CommandExecutionError = void 0;
+const node_core_library_1 = require("@rushstack/node-core-library");
+class CommandExecutionError extends Error {
+    constructor(command, args, stderr, status) {
+        super(`Command "${command} ${args.join(' ')}" failed with status ${status}:\n${stderr}`);
+        this.name = 'CommandExecutionError';
+    }
+}
+exports.CommandExecutionError = CommandExecutionError;
+class CommandRunner {
+    static _resolveCommand(command) {
+        var _a;
+        const cachedPath = this._commandCache.get(command);
+        if (cachedPath === null) {
+            throw new Error(`Command "${command}" not found in system PATH`);
+        }
+        if (cachedPath) {
+            return cachedPath;
+        }
+        const resolvedPath = (_a = node_core_library_1.Executable.tryResolve(command)) !== null && _a !== void 0 ? _a : null;
+        this._commandCache.set(command, resolvedPath);
+        if (!resolvedPath) {
+            throw new Error(`Command "${command}" not found in system PATH`);
+        }
+        return resolvedPath;
+    }
+    static async _executeCommandAsync(command, args, options) {
+        var _a;
+        const commandPath = this._resolveCommand(command);
+        const result = node_core_library_1.Executable.spawnSync(commandPath, args, options);
+        const status = (_a = result.status) !== null && _a !== void 0 ? _a : 1;
+        if (status !== 0) {
+            throw new CommandExecutionError(command, args, result.stderr, status);
+        }
+        return {
+            status,
+            stdout: result.stdout,
+            stderr: result.stderr,
+            command,
+            args
+        };
+    }
+    static async runRushCommandAsync(args, options) {
+        return this._executeCommandAsync('rush', args, options);
+    }
+    static async runRushXCommandAsync(args, options) {
+        return this._executeCommandAsync('rushx', args, options);
+    }
+    static async runGitCommandAsync(args, options) {
+        return this._executeCommandAsync('git', args, options);
+    }
+}
+exports.CommandRunner = CommandRunner;
+CommandRunner._commandCache = new Map();
+//# sourceMappingURL=command-runner.js.map

package/lib/utilities/command-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-runner.js","sourceRoot":"","sources":["../../src/utilities/command-runner.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAG3D,oEAA4F;AAU5F,MAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAAmB,OAAe,EAAE,IAAc,EAAE,MAAc,EAAE,MAAc;QAChF,KAAK,CAAC,YAAY,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,wBAAwB,MAAM,MAAM,MAAM,EAAE,CAAC,CAAC;QACzF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AALD,sDAKC;AAED,MAAa,aAAa;IAGhB,MAAM,CAAC,eAAe,CAAC,OAAe;;QAC5C,MAAM,UAAU,GAA8B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9E,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,4BAA4B,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,YAAY,GAAkB,MAAA,8BAAU,CAAC,UAAU,CAAC,OAAO,CAAC,mCAAI,IAAI,CAAC;QAC3E,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAE9C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,4BAA4B,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAEO,MAAM,CAAC,KAAK,CAAC,oBAAoB,CACvC,OAAe,EACf,IAAc,EACd,OAAqC;;QAErC,MAAM,WAAW,GAAW,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAE1D,MAAM,MAAM,GAA2C,8BAAU,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAExG,MAAM,MAAM,GAAW,MAAA,MAAM,CAAC,MAAM,mCAAI,CAAC,CAAC;QAE1C,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,qBAAqB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxE,CAAC;QAED,OAAO;YACL,MAAM;YACN,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO;YACP,IAAI;SACL,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,mBAAmB,CACrC,IAAc,EACd,OAAqC;QAErC,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,oBAAoB,CACtC,IAAc,EACd,OAAqC;QAErC,OAAO,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,kBAAkB,CACpC,IAAc,EACd,OAAqC;QAErC,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;;AAlEH,sCAmEC;AAlEyB,2BAAa,GAA+B,IAAI,GAAG,EAAE,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 * as child_process from 'child_process';\nimport { Executable, type IExecutableSpawnSyncOptions } from '@rushstack/node-core-library';\n\ninterface ICommandResult {\n  status: number;\n  stdout: string;\n  stderr: string;\n  command: string;\n  args: string[];\n}\n\nexport class CommandExecutionError extends Error {\n  public constructor(command: string, args: string[], stderr: string, status: number) {\n    super(`Command \"${command} ${args.join(' ')}\" failed with status ${status}:\\n${stderr}`);\n    this.name = 'CommandExecutionError';\n  }\n}\n\nexport class CommandRunner {\n  private static readonly _commandCache: Map<string, string | null> = new Map();\n\n  private static _resolveCommand(command: string): string {\n    const cachedPath: string | null | undefined = this._commandCache.get(command);\n    if (cachedPath === null) {\n      throw new Error(`Command \"${command}\" not found in system PATH`);\n    }\n\n    if (cachedPath) {\n      return cachedPath;\n    }\n\n    const resolvedPath: string | null = Executable.tryResolve(command) ?? null;\n    this._commandCache.set(command, resolvedPath);\n\n    if (!resolvedPath) {\n      throw new Error(`Command \"${command}\" not found in system PATH`);\n    }\n\n    return resolvedPath;\n  }\n\n  private static async _executeCommandAsync(\n    command: string,\n    args: string[],\n    options?: IExecutableSpawnSyncOptions\n  ): Promise<ICommandResult> {\n    const commandPath: string = this._resolveCommand(command);\n\n    const result: child_process.SpawnSyncReturns<string> = Executable.spawnSync(commandPath, args, options);\n\n    const status: number = result.status ?? 1;\n\n    if (status !== 0) {\n      throw new CommandExecutionError(command, args, result.stderr, status);\n    }\n\n    return {\n      status,\n      stdout: result.stdout,\n      stderr: result.stderr,\n      command,\n      args\n    };\n  }\n\n  public static async runRushCommandAsync(\n    args: string[],\n    options?: IExecutableSpawnSyncOptions\n  ): Promise<ICommandResult> {\n    return this._executeCommandAsync('rush', args, options);\n  }\n\n  public static async runRushXCommandAsync(\n    args: string[],\n    options?: IExecutableSpawnSyncOptions\n  ): Promise<ICommandResult> {\n    return this._executeCommandAsync('rushx', args, options);\n  }\n\n  public static async runGitCommandAsync(\n    args: string[],\n    options?: IExecutableSpawnSyncOptions\n  ): Promise<ICommandResult> {\n    return this._executeCommandAsync('git', args, options);\n  }\n}\n"]}

package/lib/utilities/common.d.ts

@@ -0,0 +1,3 @@
+import type { RushConfiguration } from '@rushstack/rush-sdk';
+export declare const getRushConfiguration: () => Promise<RushConfiguration>;
+//# sourceMappingURL=common.d.ts.map

package/lib/utilities/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/utilities/common.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,eAAO,MAAM,oBAAoB,QAAa,OAAO,CAAC,iBAAiB,CAMtE,CAAC"}

package/lib/utilities/common.js

@@ -0,0 +1,47 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRushConfiguration = void 0;
+const getRushConfiguration = async () => {
+    // Since the MCP server is not always started from the directory of the Rush monorepo,
+    // it’s necessary to use dynamic import to load the Rush SDK.
+    const Rush = await Promise.resolve().then(() => __importStar(require('@rushstack/rush-sdk')));
+    const rushConfiguration = Rush.RushConfiguration.loadFromDefaultLocation();
+    return rushConfiguration;
+};
+exports.getRushConfiguration = getRushConfiguration;
+//# sourceMappingURL=common.js.map

package/lib/utilities/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/utilities/common.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKpD,MAAM,oBAAoB,GAAG,KAAK,IAAgC,EAAE;IACzE,sFAAsF;IACtF,6DAA6D;IAC7D,MAAM,IAAI,GAAmB,wDAAa,qBAAqB,GAAC,CAAC;IACjE,MAAM,iBAAiB,GAAsB,IAAI,CAAC,iBAAiB,CAAC,uBAAuB,EAAE,CAAC;IAC9F,OAAO,iBAAiB,CAAC;AAC3B,CAAC,CAAC;AANW,QAAA,oBAAoB,wBAM/B","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 * as RushLib from '@rushstack/rush-sdk';\nimport type { RushConfiguration } from '@rushstack/rush-sdk';\n\nexport const getRushConfiguration = async (): Promise<RushConfiguration> => {\n  // Since the MCP server is not always started from the directory of the Rush monorepo,\n  // it’s necessary to use dynamic import to load the Rush SDK.\n  const Rush: typeof RushLib = await import('@rushstack/rush-sdk');\n  const rushConfiguration: RushConfiguration = Rush.RushConfiguration.loadFromDefaultLocation();\n  return rushConfiguration;\n};\n"]}

package/lib/utilities/log.d.ts

@@ -0,0 +1,4 @@
+import { Terminal } from '@rushstack/terminal';
+export declare const terminal: Terminal;
+export declare function log(message?: any, ...optionalParams: any[]): void;
+//# sourceMappingURL=log.d.ts.map

package/lib/utilities/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/utilities/log.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAA2B,MAAM,qBAAqB,CAAC;AAExE,eAAO,MAAM,QAAQ,EAAE,QAA8E,CAAC;AAGtG,wBAAgB,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAEjE"}

package/lib/utilities/log.js

@@ -0,0 +1,13 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.terminal = void 0;
+exports.log = log;
+const terminal_1 = require("@rushstack/terminal");
+exports.terminal = new terminal_1.Terminal(new terminal_1.ConsoleTerminalProvider({ verboseEnabled: true }));
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function log(message, ...optionalParams) {
+    exports.terminal.writeErrorLine(message, ...optionalParams);
+}
+//# sourceMappingURL=log.js.map

package/lib/utilities/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/utilities/log.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAO3D,kBAEC;AAPD,kDAAwE;AAE3D,QAAA,QAAQ,GAAa,IAAI,mBAAQ,CAAC,IAAI,kCAAuB,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAEtG,8DAA8D;AAC9D,SAAgB,GAAG,CAAC,OAAa,EAAE,GAAG,cAAqB;IACzD,gBAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,cAAc,CAAC,CAAC;AACtD,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 { Terminal, ConsoleTerminalProvider } from '@rushstack/terminal';\n\nexport const terminal: Terminal = new Terminal(new ConsoleTerminalProvider({ verboseEnabled: true }));\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function log(message?: any, ...optionalParams: any[]): void {\n  terminal.writeErrorLine(message, ...optionalParams);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rushstack/mcp-server",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "A Model Context Protocol server implementation for Rush",
   "repository": {
     "type": "git",
@@ -17,14 +17,18 @@
   },
   "license": "MIT",
   "dependencies": {
+    "@modelcontextprotocol/sdk": "~1.10.2",
+    "zod": "~3.24.3",
+    "@rushstack/terminal": "0.15.3",
+    "@rushstack/rush-sdk": "5.153.1",
     "@rushstack/node-core-library": "5.13.1",
-    "@rushstack/ts-command-line": "5.0.1",
-    "@rushstack/terminal": "0.15.3"
+    "@rushstack/ts-command-line": "5.0.1"
   },
   "devDependencies": {
     "typescript": "~5.8.2",
-    "@rushstack/heft": "0.73.5",
-    "local-node-rig": "1.0.0"
+    "@types/node": "20.17.19",
+    "local-node-rig": "1.0.0",
+    "@rushstack/heft": "0.73.5"
   },
   "scripts": {
     "build": "heft build --clean",