fix(cli-mcp): wire mcp subcommand via early dispatch in main to avoid Layer conflict

Layer.launch is incompatible with @effect/cli's layer composition, so dispatch
the mcp subcommand before the CLI pipeline runs. The mcpCommand stub remains
registered so it appears in --help output. Also adds root dependency link for
@forgerock/login-framework-cli.

Author: ryanbas21

package.json

@@ -99,7 +99,11 @@
       "picomatch@2": "2.3.2",
       "picomatch@4": "4.0.4",
       "uuid": "^14.0.0",
-      "yaml": ">=2.8.3"
+      "yaml": ">=2.8.3",
+      "@forgerock/login-framework-cli": "link:tools/cli"
     }
+  },
+  "dependencies": {
+    "@forgerock/login-framework-cli": "link:tools/cli"
   }
 }

tools/cli/src/main.ts

@@ -28,19 +28,18 @@ function readCliVersion(): string {
   }
 }
 
+if (process.argv[2] === 'mcp') {
+  const { runMcpServer } = await import('./mcp.js');
+  runMcpServer();
+}
+
 const version = readCliVersion();
 
 const rootCommand = Command.make('ping-lf').pipe(
   Command.withDescription(
     'CLI for initializing, scaffolding, and updating Ping Login Widget and Login App custom component projects.',
   ),
-  Command.withSubcommands([
-    initCommand,
-    generateCommand,
-    updateCommand,
-    releasesCommand,
-    mcpCommand,
-  ]),
+  Command.withSubcommands([initCommand, generateCommand, updateCommand, releasesCommand, mcpCommand]),
 );
 
 const cli = Command.run(rootCommand, {

tools/cli/src/mcp.ts

@@ -264,6 +264,9 @@ const ServerLayer = McpServer.toolkit(mcpToolkit).pipe(
 
 export const runMcpServer = () => Layer.launch(ServerLayer).pipe(NodeRuntime.runMain);
 
-export const mcpCommand = Command.make('mcp', {}, () => Layer.launch(ServerLayer)).pipe(
+// mcpCommand is registered only so `ping-lf --help` lists `mcp` as a subcommand.
+// The actual dispatch happens in main.ts before the @effect/cli pipeline runs,
+// because Layer.launch is incompatible with the CLI's layer composition.
+export const mcpCommand = Command.make('mcp', {}, () => Effect.void).pipe(
   Command.withDescription('Start as an MCP server over stdio.'),
 );