@shell-shock/plugin-mcp 0.1.1

package/dist/components/mcp-command.cjs

@@ -0,0 +1,223 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _stryke_path_join = require("@stryke/path/join");
+let _alloy_js_core = require("@alloy-js/core");
+let _power_plant_alloy_js_typescript = require("@power-plant/alloy-js/typescript");
+let _shell_shock_core_contexts_power_plant = require("@shell-shock/core/contexts/power-plant");
+
+//#region src/components/mcp-command.tsx
+function toFlagName(input) {
+	return input.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/[^a-z0-9-]/gi, "-").replace(/-{2,}/g, "-").replace(/^-+|-+$/g, "").toLowerCase();
+}
+function toToolName(path) {
+	return path.replace(/[/:\s]+/g, "_").replace(/[^\w-]/g, "_").replace(/_{2,}/g, "_").replace(/^_+|_+$/g, "").toLowerCase();
+}
+function serializeCommand(command) {
+	const optionList = Object.values(command.options ?? {}).map((option) => `--${toFlagName(option.name)} (${option.type}${option.required ? ", required" : ""})`).join(", ");
+	const argList = command.args.map((arg) => `${arg.name}:${arg.type}${arg.required ? " (required)" : ""}${arg.variadic ? "[]" : ""}`).join(", ");
+	const commandPath = command.path ?? command.name;
+	return `{
+    id: ${JSON.stringify(command.id)},
+    name: ${JSON.stringify(command.name)},
+    path: ${JSON.stringify(commandPath)},
+    segments: ${JSON.stringify(command.segments)},
+    title: ${JSON.stringify(command.title)},
+    description: ${JSON.stringify(command.description + (optionList ? `\nOptions: ${optionList}` : "") + (argList ? `\nArgs: ${argList}` : ""))},
+    toolName: ${JSON.stringify(toToolName(commandPath) || command.name)},
+    options: ${JSON.stringify(Object.values(command.options ?? {}).map((option) => ({
+		name: option.name,
+		title: option.title,
+		description: option.description,
+		type: option.type,
+		required: option.required,
+		variadic: option.variadic
+	})), null, 2)},
+    args: ${JSON.stringify(command.args.map((arg) => ({
+		name: arg.name,
+		title: arg.title,
+		description: arg.description,
+		type: arg.type,
+		required: arg.required,
+		variadic: arg.variadic
+	})), null, 2)}
+  }`;
+}
+/**
+* Generates the MCP command module using Alloy source generation.
+*/
+function McpCommandModule(props) {
+	const context = (0, _shell_shock_core_contexts_power_plant.usePowerlines)();
+	const resolvedPath = (0, _stryke_path_join.joinPaths)(context.entryPath, "mcp", "command.ts");
+	const commands = props.commands.filter((command) => !command.virtual && command.path !== props.commandName).map((command) => serializeCommand(command)).join(",\n");
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(_power_plant_alloy_js_typescript.TypescriptFile, {
+		path: resolvedPath,
+		imports: {
+			"@shell-shock/core": ["defineMetadata", "defineOptions"],
+			"@modelcontextprotocol/server": ["McpServer"],
+			"@modelcontextprotocol/server/stdio": ["StdioServerTransport"],
+			"shell-shock:exec": ["spawn"],
+			"zod/v4": ["* as z"]
+		},
+		get children() {
+			return _alloy_js_core.code`
+const COMMAND_NAME = ${JSON.stringify(props.commandName)};
+const APP_NAME = ${JSON.stringify(props.appName)};
+
+const COMMANDS = [
+${commands}
+];
+
+export const metadata = defineMetadata({
+  title: "MCP Server",
+  description:
+    "Starts an MCP stdio server that exposes this Shell Shock application's commands as tools.",
+  icon: "🔌",
+  tags: ["Utility", "MCP"]
+});
+
+export const options = defineOptions({
+  includeSelf: {
+    type: "boolean",
+    title: "Include MCP Command",
+    description:
+      "Whether to expose the MCP command itself as a tool in the generated server.",
+    default: false,
+    required: false,
+    variadic: false
+  }
+});
+
+function toCliArgs(optionsMap: Record<string, unknown>): string[] {
+  const args: string[] = [];
+
+  for (const [rawName, rawValue] of Object.entries(optionsMap ?? {})) {
+    if (!/^[a-zA-Z0-9_\-]+$/.test(rawName)) {
+      continue;
+    }
+
+    const flag = toFlagName(rawName);
+    if (!flag) {
+      continue;
+    }
+
+    if (rawValue === undefined || rawValue === null) {
+      continue;
+    }
+
+    if (typeof rawValue === "boolean") {
+      args.push(rawValue ? "--" + flag : "--no-" + flag);
+      continue;
+    }
+
+    if (Array.isArray(rawValue)) {
+      for (const item of rawValue) {
+        if (item === undefined || item === null) {
+          continue;
+        }
+
+        args.push("--" + flag, String(item));
+      }
+      continue;
+    }
+
+    args.push("--" + flag, String(rawValue));
+  }
+
+  return args;
+}
+
+export default async function handler(options: { includeSelf?: boolean }) {
+  const commandMap = new Map<string, typeof COMMANDS[number]>();
+  const usedToolNames = new Set<string>();
+  const includeSelf = options.includeSelf === true;
+
+  for (const command of COMMANDS) {
+    if (!includeSelf && command.path === COMMAND_NAME) {
+      continue;
+    }
+
+    let toolName = command.toolName;
+    if (usedToolNames.has(toolName)) {
+      let index = 2;
+      while (usedToolNames.has(toolName + "_" + String(index))) {
+        index += 1;
+      }
+
+      toolName = toolName + "_" + String(index);
+    }
+
+    usedToolNames.add(toolName);
+    commandMap.set(toolName, command);
+  }
+
+  const server = new McpServer({
+    name: APP_NAME + "-shell-shock",
+    version: "1.0.0"
+  });
+
+  for (const [toolName, command] of commandMap.entries()) {
+    server.registerTool(
+      toolName,
+      {
+        title: command.title,
+        description: command.description,
+        inputSchema: z.object({
+          options: z.record(z.unknown()).optional(),
+          args: z.array(z.string()).optional(),
+          cwd: z.string().optional(),
+          timeoutMs: z.number().int().positive().optional()
+        })
+      },
+      async input => {
+        const commandArgv = [
+          ...command.segments,
+          ...toCliArgs((input.options ?? {}) as Record<string, unknown>),
+          ...((input.args ?? []) as string[])
+        ];
+
+        const launchArgv =
+          process.argv.length >= 2
+            ? [process.argv[0]!, process.argv[1]!, ...commandArgv]
+            : [COMMAND_NAME, ...commandArgv];
+
+        const result = await spawn(launchArgv, {
+          cwd: input.cwd,
+          timeoutMs: input.timeoutMs ?? 300_000
+        });
+
+        const output = [result.stdout, result.stderr]
+          .filter(Boolean)
+          .join("\n")
+          .trim();
+
+        const isError = (result.code ?? 0) !== 0;
+
+        return {
+          isError,
+          content: [
+            {
+              type: "text" as const,
+              text:
+                output.length > 0
+                  ? output
+                  : isError
+                    ? "Command failed with exit code " +
+                      String(result.code ?? 1) +
+                      "."
+                    : "Command completed successfully."
+            }
+          ]
+        };
+      }
+    );
+  }
+
+  await server.connect(new StdioServerTransport());
+}
+`;
+		}
+	});
+}
+
+//#endregion
+exports.McpCommandModule = McpCommandModule;

package/dist/components/mcp-command.d.cts

@@ -0,0 +1,14 @@
+import { CommandTree } from "@shell-shock/core";
+//#region src/components/mcp-command.d.ts
+interface McpCommandModuleProps {
+  appName: string;
+  commandName: string;
+  commands: CommandTree[];
+}
+/**
+ * Generates the MCP command module using Alloy source generation.
+ */
+declare function McpCommandModule(props: McpCommandModuleProps): import("@alloy-js/core").Children;
+//#endregion
+export { McpCommandModule, McpCommandModuleProps };
+//# sourceMappingURL=mcp-command.d.cts.map

package/dist/components/mcp-command.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-command.d.cts","names":[],"sources":["../../src/components/mcp-command.tsx"],"mappings":";;UAyBiB;EACf;EACA;EACA,UAAU;;;;;iBAoFI,iBAAiB,OAAO,iDAAqB"}

package/dist/components/mcp-command.d.mts

@@ -0,0 +1,14 @@
+import { CommandTree } from "@shell-shock/core";
+//#region src/components/mcp-command.d.ts
+interface McpCommandModuleProps {
+  appName: string;
+  commandName: string;
+  commands: CommandTree[];
+}
+/**
+ * Generates the MCP command module using Alloy source generation.
+ */
+declare function McpCommandModule(props: McpCommandModuleProps): import("@alloy-js/core").Children;
+//#endregion
+export { McpCommandModule, McpCommandModuleProps };
+//# sourceMappingURL=mcp-command.d.mts.map

package/dist/components/mcp-command.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-command.d.mts","names":[],"sources":["../../src/components/mcp-command.tsx"],"mappings":""}

package/dist/components/mcp-command.mjs

@@ -0,0 +1,223 @@
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { joinPaths } from "@stryke/path/join";
+import { code } from "@alloy-js/core";
+import { TypescriptFile } from "@power-plant/alloy-js/typescript";
+import { usePowerlines } from "@shell-shock/core/contexts/power-plant";
+
+//#region src/components/mcp-command.tsx
+function toFlagName(input) {
+	return input.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/[^a-z0-9-]/gi, "-").replace(/-{2,}/g, "-").replace(/^-+|-+$/g, "").toLowerCase();
+}
+function toToolName(path) {
+	return path.replace(/[/:\s]+/g, "_").replace(/[^\w-]/g, "_").replace(/_{2,}/g, "_").replace(/^_+|_+$/g, "").toLowerCase();
+}
+function serializeCommand(command) {
+	const optionList = Object.values(command.options ?? {}).map((option) => `--${toFlagName(option.name)} (${option.type}${option.required ? ", required" : ""})`).join(", ");
+	const argList = command.args.map((arg) => `${arg.name}:${arg.type}${arg.required ? " (required)" : ""}${arg.variadic ? "[]" : ""}`).join(", ");
+	const commandPath = command.path ?? command.name;
+	return `{
+    id: ${JSON.stringify(command.id)},
+    name: ${JSON.stringify(command.name)},
+    path: ${JSON.stringify(commandPath)},
+    segments: ${JSON.stringify(command.segments)},
+    title: ${JSON.stringify(command.title)},
+    description: ${JSON.stringify(command.description + (optionList ? `\nOptions: ${optionList}` : "") + (argList ? `\nArgs: ${argList}` : ""))},
+    toolName: ${JSON.stringify(toToolName(commandPath) || command.name)},
+    options: ${JSON.stringify(Object.values(command.options ?? {}).map((option) => ({
+		name: option.name,
+		title: option.title,
+		description: option.description,
+		type: option.type,
+		required: option.required,
+		variadic: option.variadic
+	})), null, 2)},
+    args: ${JSON.stringify(command.args.map((arg) => ({
+		name: arg.name,
+		title: arg.title,
+		description: arg.description,
+		type: arg.type,
+		required: arg.required,
+		variadic: arg.variadic
+	})), null, 2)}
+  }`;
+}
+/**
+* Generates the MCP command module using Alloy source generation.
+*/
+function McpCommandModule(props) {
+	const context = usePowerlines();
+	const resolvedPath = joinPaths(context.entryPath, "mcp", "command.ts");
+	const commands = props.commands.filter((command) => !command.virtual && command.path !== props.commandName).map((command) => serializeCommand(command)).join(",\n");
+	return createComponent(TypescriptFile, {
+		path: resolvedPath,
+		imports: {
+			"@shell-shock/core": ["defineMetadata", "defineOptions"],
+			"@modelcontextprotocol/server": ["McpServer"],
+			"@modelcontextprotocol/server/stdio": ["StdioServerTransport"],
+			"shell-shock:exec": ["spawn"],
+			"zod/v4": ["* as z"]
+		},
+		get children() {
+			return code`
+const COMMAND_NAME = ${JSON.stringify(props.commandName)};
+const APP_NAME = ${JSON.stringify(props.appName)};
+
+const COMMANDS = [
+${commands}
+];
+
+export const metadata = defineMetadata({
+  title: "MCP Server",
+  description:
+    "Starts an MCP stdio server that exposes this Shell Shock application's commands as tools.",
+  icon: "🔌",
+  tags: ["Utility", "MCP"]
+});
+
+export const options = defineOptions({
+  includeSelf: {
+    type: "boolean",
+    title: "Include MCP Command",
+    description:
+      "Whether to expose the MCP command itself as a tool in the generated server.",
+    default: false,
+    required: false,
+    variadic: false
+  }
+});
+
+function toCliArgs(optionsMap: Record<string, unknown>): string[] {
+  const args: string[] = [];
+
+  for (const [rawName, rawValue] of Object.entries(optionsMap ?? {})) {
+    if (!/^[a-zA-Z0-9_\-]+$/.test(rawName)) {
+      continue;
+    }
+
+    const flag = toFlagName(rawName);
+    if (!flag) {
+      continue;
+    }
+
+    if (rawValue === undefined || rawValue === null) {
+      continue;
+    }
+
+    if (typeof rawValue === "boolean") {
+      args.push(rawValue ? "--" + flag : "--no-" + flag);
+      continue;
+    }
+
+    if (Array.isArray(rawValue)) {
+      for (const item of rawValue) {
+        if (item === undefined || item === null) {
+          continue;
+        }
+
+        args.push("--" + flag, String(item));
+      }
+      continue;
+    }
+
+    args.push("--" + flag, String(rawValue));
+  }
+
+  return args;
+}
+
+export default async function handler(options: { includeSelf?: boolean }) {
+  const commandMap = new Map<string, typeof COMMANDS[number]>();
+  const usedToolNames = new Set<string>();
+  const includeSelf = options.includeSelf === true;
+
+  for (const command of COMMANDS) {
+    if (!includeSelf && command.path === COMMAND_NAME) {
+      continue;
+    }
+
+    let toolName = command.toolName;
+    if (usedToolNames.has(toolName)) {
+      let index = 2;
+      while (usedToolNames.has(toolName + "_" + String(index))) {
+        index += 1;
+      }
+
+      toolName = toolName + "_" + String(index);
+    }
+
+    usedToolNames.add(toolName);
+    commandMap.set(toolName, command);
+  }
+
+  const server = new McpServer({
+    name: APP_NAME + "-shell-shock",
+    version: "1.0.0"
+  });
+
+  for (const [toolName, command] of commandMap.entries()) {
+    server.registerTool(
+      toolName,
+      {
+        title: command.title,
+        description: command.description,
+        inputSchema: z.object({
+          options: z.record(z.unknown()).optional(),
+          args: z.array(z.string()).optional(),
+          cwd: z.string().optional(),
+          timeoutMs: z.number().int().positive().optional()
+        })
+      },
+      async input => {
+        const commandArgv = [
+          ...command.segments,
+          ...toCliArgs((input.options ?? {}) as Record<string, unknown>),
+          ...((input.args ?? []) as string[])
+        ];
+
+        const launchArgv =
+          process.argv.length >= 2
+            ? [process.argv[0]!, process.argv[1]!, ...commandArgv]
+            : [COMMAND_NAME, ...commandArgv];
+
+        const result = await spawn(launchArgv, {
+          cwd: input.cwd,
+          timeoutMs: input.timeoutMs ?? 300_000
+        });
+
+        const output = [result.stdout, result.stderr]
+          .filter(Boolean)
+          .join("\n")
+          .trim();
+
+        const isError = (result.code ?? 0) !== 0;
+
+        return {
+          isError,
+          content: [
+            {
+              type: "text" as const,
+              text:
+                output.length > 0
+                  ? output
+                  : isError
+                    ? "Command failed with exit code " +
+                      String(result.code ?? 1) +
+                      "."
+                    : "Command completed successfully."
+            }
+          ]
+        };
+      }
+    );
+  }
+
+  await server.connect(new StdioServerTransport());
+}
+`;
+		}
+	});
+}
+
+//#endregion
+export { McpCommandModule };
+//# sourceMappingURL=mcp-command.mjs.map

package/dist/components/mcp-command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-command.mjs","names":[],"sources":[],"mappings":""}

package/dist/generator.cjs

@@ -0,0 +1,46 @@
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+const require_components_mcp_command = require('./components/mcp-command.cjs');
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _shell_shock_core_helpers_power_plant = require("@shell-shock/core/helpers/power-plant");
+let _shell_shock_core_plugin_utils = require("@shell-shock/core/plugin-utils");
+
+//#region src/generator.tsx
+/**
+* Power Plant generator for the Shell Shock MCP server command module.
+*
+* @see https://github.com/storm-software/power-plant/tree/main/packages/generators/alloy-js
+*/
+const mcpGenerator = (0, _shell_shock_core_helpers_power_plant.defineCommandGenerator)({
+	meta: {
+		name: "shell-shock-mcp",
+		title: "Shell Shock MCP Generator",
+		description: "Generates an MCP stdio server command module from the Shell Shock command tree specification.",
+		version: "1.0",
+		tags: [
+			"shell-shock",
+			"mcp",
+			"alloy-js"
+		]
+	},
+	generator: async (_commands, options) => {
+		if (options.template) {
+			await (0, _shell_shock_core_helpers_power_plant.renderCommandTemplate)(options, options.template);
+			return;
+		}
+		const context = options.context;
+		const commands = (await (0, _shell_shock_core_plugin_utils.getCommandList)(context)).sort((a, b) => (a.path ?? a.name).localeCompare(b.path ?? b.name));
+		await (0, _shell_shock_core_helpers_power_plant.renderCommandTemplate)(options, (0, _alloy_js_core_jsx_runtime.createComponent)(require_components_mcp_command.McpCommandModule, {
+			get appName() {
+				return context.config.name;
+			},
+			get commandName() {
+				return context.config.mcp.command.name;
+			},
+			commands
+		}));
+	}
+});
+
+//#endregion
+exports.default = mcpGenerator;
+exports.mcpGenerator = mcpGenerator;

package/dist/generator.d.cts

@@ -0,0 +1,10 @@
+//#region src/generator.d.ts
+/**
+ * Power Plant generator for the Shell Shock MCP server command module.
+ *
+ * @see https://github.com/storm-software/power-plant/tree/main/packages/generators/alloy-js
+ */
+declare const mcpGenerator: import("@power-plant/core").GeneratorConfigObject<Record<string, import("@shell-shock/schema").SerializedCommandTree>, import("@shell-shock/core/helpers/power-plant").CommandGeneratorOptions, void>;
+//#endregion
+export { mcpGenerator as default, mcpGenerator };
+//# sourceMappingURL=generator.d.cts.map

package/dist/generator.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.cts","names":[],"sources":["../src/generator.tsx"],"mappings":";;;;;;cA+Ba,0CAAY,sBAAA,6CAAA,wEAAA"}

package/dist/generator.d.mts

@@ -0,0 +1,10 @@
+//#region src/generator.d.ts
+/**
+ * Power Plant generator for the Shell Shock MCP server command module.
+ *
+ * @see https://github.com/storm-software/power-plant/tree/main/packages/generators/alloy-js
+ */
+declare const mcpGenerator: import("@power-plant/core").GeneratorConfigObject<Record<string, import("@shell-shock/schema").SerializedCommandTree>, import("@shell-shock/core/helpers/power-plant").CommandGeneratorOptions, void>;
+//#endregion
+export { mcpGenerator as default, mcpGenerator };
+//# sourceMappingURL=generator.d.mts.map

package/dist/generator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.mts","names":[],"sources":["../src/generator.tsx"],"mappings":""}

package/dist/generator.mjs

@@ -0,0 +1,45 @@
+import { McpCommandModule } from "./components/mcp-command.mjs";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { defineCommandGenerator, renderCommandTemplate } from "@shell-shock/core/helpers/power-plant";
+import { getCommandList } from "@shell-shock/core/plugin-utils";
+
+//#region src/generator.tsx
+/**
+* Power Plant generator for the Shell Shock MCP server command module.
+*
+* @see https://github.com/storm-software/power-plant/tree/main/packages/generators/alloy-js
+*/
+const mcpGenerator = defineCommandGenerator({
+	meta: {
+		name: "shell-shock-mcp",
+		title: "Shell Shock MCP Generator",
+		description: "Generates an MCP stdio server command module from the Shell Shock command tree specification.",
+		version: "1.0",
+		tags: [
+			"shell-shock",
+			"mcp",
+			"alloy-js"
+		]
+	},
+	generator: async (_commands, options) => {
+		if (options.template) {
+			await renderCommandTemplate(options, options.template);
+			return;
+		}
+		const context = options.context;
+		const commands = (await getCommandList(context)).sort((a, b) => (a.path ?? a.name).localeCompare(b.path ?? b.name));
+		await renderCommandTemplate(options, createComponent(McpCommandModule, {
+			get appName() {
+				return context.config.name;
+			},
+			get commandName() {
+				return context.config.mcp.command.name;
+			},
+			commands
+		}));
+	}
+});
+
+//#endregion
+export { mcpGenerator as default, mcpGenerator };
+//# sourceMappingURL=generator.mjs.map

package/dist/generator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.mjs","names":[],"sources":[],"mappings":""}