frontmcp 1.2.1 → 1.4.0

package/src/commands/dev/test.js

@@ -1,41 +1,115 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.findUserJestConfig = findUserJestConfig;
+exports.buildJestArgs = buildJestArgs;
+exports.generateJestConfig = generateJestConfig;
 exports.runTest = runTest;
 const tslib_1 = require("tslib");
-const path = tslib_1.__importStar(require("path"));
-const os = tslib_1.__importStar(require("os"));
 const child_process_1 = require("child_process");
-const colors_1 = require("../../core/colors");
+const os = tslib_1.__importStar(require("os"));
+const path = tslib_1.__importStar(require("path"));
 const utils_1 = require("@frontmcp/utils");
-const fs_1 = require("../../shared/fs");
+const config_1 = require("../../config");
+const colors_1 = require("../../core/colors");
 /**
- * Generate Jest configuration programmatically for E2E tests.
- * This eliminates the need for projects to have their own jest.e2e.config.ts.
+ * Filenames in cwd that, when present, cause `frontmcp test` to delegate to
+ * the user's own Jest config instead of injecting one. Order matters — Jest's
+ * own resolution is `ts > js > mjs > cjs > json`.
+ */
+const USER_JEST_CONFIG_FILES = [
+    'jest.config.ts',
+    'jest.config.js',
+    'jest.config.mjs',
+    'jest.config.cjs',
+    'jest.config.json',
+];
+async function findUserJestConfig(cwd) {
+    for (const name of USER_JEST_CONFIG_FILES) {
+        const p = path.join(cwd, name);
+        if (await (0, utils_1.fileExists)(p))
+            return p;
+    }
+    return undefined;
+}
+/**
+ * Build the args passed to `npx jest`. Extracted from `runTest` so the args
+ * matrix can be unit-tested without spawning a subprocess.
+ *
+ * @internal
+ */
+function buildJestArgs(configPath, opts, positionalPatterns = []) {
+    const args = ['jest', '--config', configPath];
+    if (opts.runInBand)
+        args.push('--runInBand');
+    if (opts.watch)
+        args.push('--watch');
+    if (opts.verbose)
+        args.push('--verbose');
+    if (opts.coverage)
+        args.push('--coverage');
+    if (positionalPatterns.length > 0)
+        args.push(...positionalPatterns);
+    return args;
+}
+/**
+ * Generate Jest configuration programmatically.
+ *
+ * Issue #402: the original config (a) only ran `e2e/**` and `**\/*.e2e.ts`,
+ * missing the `*.spec.ts(x)` colocated unit tests mandated by CLAUDE.md, and
+ * (b) only transformed `.ts`/`.js` with a `typescript` parser, so any `.tsx`
+ * file failed both the regex AND SWC's parser. This generator now:
+ *   - matches both colocated unit specs and e2e specs (`.ts` + `.tsx`),
+ *   - transforms `.tsx`/`.jsx` files with `tsx: true` and the automatic JSX
+ *     runtime so React components are usable in tests,
+ *   - exposes the helper for unit testing.
  */
-function generateJestConfig(cwd, opts) {
-    const testTimeout = opts.timeout ?? 60000;
+function generateJestConfig(cwd, opts, testDefaults) {
+    // Issue #400 — config defaults apply when CLI flags are absent.
+    const testTimeout = opts.timeout ?? testDefaults?.timeoutMs ?? 60000;
     return {
         // Use Node.js environment for E2E tests
         testEnvironment: 'node',
         // Root directory for tests
         rootDir: cwd,
-        // Test file patterns for E2E tests
-        testMatch: ['<rootDir>/e2e/**/*.e2e.ts', '<rootDir>/e2e/**/*.e2e.spec.ts', '<rootDir>/**/*.e2e.ts'],
-        // Transform TypeScript files using @swc/jest for speed
+        // Match both colocated unit specs (`src/**/*.spec.ts(x)`,
+        // `**/__tests__/**/*.spec.ts(x)`) AND e2e specs. The repo convention per
+        // CLAUDE.md is `.spec.ts` (NOT `.test.ts`) for unit tests; `.e2e.spec.ts`
+        // for e2e; `.pw.spec.ts` for Playwright; `.perf.spec.ts` for perf.
+        //
+        // CodeRabbit PR #425: removed `e2e/**/*.e2e.ts(x)` and `**/*.e2e.ts(x)`
+        // patterns — the convention is strictly `.e2e.spec.ts(x)`, so matching
+        // `.e2e.ts` would let stragglers that violate the convention slip
+        // through discovery.
+        testMatch: testDefaults?.testMatch ?? [
+            '<rootDir>/src/**/*.spec.ts',
+            '<rootDir>/src/**/*.spec.tsx',
+            '<rootDir>/**/__tests__/**/*.spec.ts',
+            '<rootDir>/**/__tests__/**/*.spec.tsx',
+            '<rootDir>/e2e/**/*.e2e.spec.ts',
+            '<rootDir>/e2e/**/*.e2e.spec.tsx',
+        ],
+        // Transform TypeScript files using @swc/jest for speed. Accepts both
+        // `.ts/.js` and `.tsx/.jsx`; the SWC parser is set up with `tsx: true`
+        // and the automatic JSX runtime so React components work without
+        // additional setup.
         transform: {
-            '^.+\\.[tj]s$': [
+            '^.+\\.[tj]sx?$': [
                 '@swc/jest',
                 {
                     jsc: {
                         target: 'es2022',
                         parser: {
                             syntax: 'typescript',
+                            tsx: true,
                             decorators: true,
                             dynamicImport: true,
                         },
                         transform: {
                             decoratorMetadata: true,
                             legacyDecorator: true,
+                            react: {
+                                runtime: 'automatic',
+                            },
                         },
                         keepClassNames: true,
                         externalHelpers: true,
@@ -59,14 +133,19 @@ function generateJestConfig(cwd, opts) {
         transformIgnorePatterns: ['node_modules/(?!(jose)/)'],
         // Ignore patterns
         testPathIgnorePatterns: ['/node_modules/', '/dist/'],
-        // Coverage settings
-        collectCoverage: opts.coverage ?? false,
+        // Coverage settings (issue #400: CLI > config > false)
+        collectCoverage: opts.coverage ?? testDefaults?.coverage ?? false,
         // Coverage configuration when enabled
-        ...(opts.coverage
+        ...((opts.coverage ?? testDefaults?.coverage)
             ? {
                 coverageDirectory: '<rootDir>/coverage',
                 coverageReporters: ['text', 'lcov', 'json'],
-                collectCoverageFrom: ['<rootDir>/src/**/*.ts', '!<rootDir>/src/**/*.spec.ts'],
+                collectCoverageFrom: [
+                    '<rootDir>/src/**/*.ts',
+                    '<rootDir>/src/**/*.tsx',
+                    '!<rootDir>/src/**/*.spec.ts',
+                    '!<rootDir>/src/**/*.spec.tsx',
+                ],
             }
             : {}),
         // Verbose output
@@ -85,58 +164,92 @@ function generateJestConfig(cwd, opts) {
  */
 async function runTest(opts) {
     const cwd = process.cwd();
-    // Check for e2e directory
+    // Issue #400 — resolve frontmcp.config so `test.timeoutMs` /
+    // `test.runInBand` / `test.coverage` / `test.testMatch` apply when the
+    // user didn't pass the equivalent CLI flag.
+    const resolved = await (0, config_1.resolveConfig)({
+        cwd,
+        mode: 'test',
+        configPath: typeof opts.config === 'string' ? opts.config : undefined,
+    });
+    const testDefaults = resolved.config?.test;
+    const mergedOpts = {
+        ...opts,
+        runInBand: opts.runInBand ?? testDefaults?.runInBand,
+        coverage: opts.coverage ?? testDefaults?.coverage,
+        timeout: opts.timeout ?? testDefaults?.timeoutMs,
+    };
+    // Issue #402: honor an existing `jest.config.{ts,js,mjs,cjs,json}` in cwd
+    // by delegating to it instead of injecting our own config. Users who need
+    // bespoke behaviour (custom transforms, projects, setup files, …) shouldn't
+    // be forced to overlay it on top of our injection.
+    const userConfig = await findUserJestConfig(cwd);
+    // Issue #402: previously this command HARD-REQUIRED a `./e2e/` directory
+    // and exited 1 otherwise — locking out projects that only have colocated
+    // unit specs (the CLAUDE.md convention). The new testMatch covers both;
+    // we only refuse to run when there's literally nowhere to look.
+    //
+    // CodeRabbit on PR #425: also accept `__tests__/`-only projects, since
+    // `generateJestConfig` discovers `**/__tests__/**/*.spec.ts(x)` too. The
+    // help text below matches the actual default discovery rules.
     const e2eDir = path.join(cwd, 'e2e');
+    const srcDir = path.join(cwd, 'src');
+    const testsDir = path.join(cwd, '__tests__');
     const hasE2EDir = await (0, utils_1.fileExists)(e2eDir);
-    if (!hasE2EDir) {
-        console.error((0, colors_1.c)('red', 'No e2e directory found.'));
+    const hasSrcDir = await (0, utils_1.fileExists)(srcDir);
+    const hasTestsDir = await (0, utils_1.fileExists)(testsDir);
+    if (!userConfig && !hasE2EDir && !hasSrcDir && !hasTestsDir) {
+        console.error((0, colors_1.c)('red', 'No test sources found.'));
         console.error('');
-        console.error('Expected structure:');
-        console.error('  ./e2e/');
-        console.error('    ├── your-test.e2e.ts');
-        console.error('    └── another-test.e2e.spec.ts');
+        console.error('Expected one of:');
+        console.error('  • a jest.config.{ts,js,mjs,cjs,json} in the current directory');
+        console.error('  • a ./src/ directory with colocated *.spec.ts(x) files');
+        console.error('  • a ./__tests__/ directory with *.spec.ts(x) files');
+        console.error('  • a ./e2e/ directory with *.e2e.spec.ts(x) files');
         console.error('');
-        console.error('Create an e2e directory with test files, then run:');
+        console.error('Create one of those, then run:');
         console.error('  frontmcp test');
         process.exit(1);
     }
-    // Generate Jest config and write to temp file
-    const config = generateJestConfig(cwd, opts);
-    const tempDir = os.tmpdir();
-    const configPath = path.join(tempDir, `frontmcp-jest-config-${Date.now()}.json`);
-    await fs_1.fsp.writeFile(configPath, JSON.stringify(config, null, 2));
-    // Build Jest arguments
-    const jestArgs = ['jest', '--config', configPath];
-    // Add --runInBand for sequential execution (recommended for E2E tests)
-    if (opts.runInBand) {
-        jestArgs.push('--runInBand');
+    // Build Jest arguments. With a user config, we delegate; otherwise we
+    // write our generated config to a temp file and point Jest at it.
+    let configPath;
+    if (!userConfig) {
+        const config = generateJestConfig(cwd, mergedOpts, testDefaults);
+        const tempDir = os.tmpdir();
+        configPath = path.join(tempDir, `frontmcp-jest-config-${Date.now()}.json`);
+        await (0, utils_1.writeFile)(configPath, JSON.stringify(config, null, 2));
     }
-    // Add watch mode
-    if (opts.watch) {
-        jestArgs.push('--watch');
+    // Explicit narrowing avoids the non-null assertion on userConfig. By
+    // construction, the branch above guarantees that exactly one of
+    // `configPath` or `userConfig` is set when we get here — but TS can't
+    // see through that flow, so an explicit guard keeps the type checker
+    // honest without `!`.
+    const selectedConfig = configPath ?? userConfig;
+    if (!selectedConfig) {
+        // Defensive: should be unreachable thanks to the no-sources check above.
+        throw new Error('Internal error: no Jest config selected.');
     }
-    // Add verbose flag
-    if (opts.verbose) {
-        jestArgs.push('--verbose');
+    // Positional test patterns: everything after the `test` command itself.
+    const testPatterns = opts._.slice(1);
+    const jestArgs = buildJestArgs(selectedConfig, mergedOpts, testPatterns);
+    console.log(`${(0, colors_1.c)('cyan', '[test]')} running tests in ${path.relative(process.cwd(), cwd) || '.'}`);
+    if (resolved.configPath || resolved.configDir) {
+        console.log(`${(0, colors_1.c)('gray', '[test]')} config: ${resolved.configPath ?? resolved.configDir}`);
     }
-    // Add coverage flag
-    if (opts.coverage) {
-        jestArgs.push('--coverage');
+    if (userConfig) {
+        console.log(`${(0, colors_1.c)('gray', '[test]')} using user Jest config: ${path.relative(cwd, userConfig)}`);
     }
-    // Add any additional positional args (e.g., test file patterns)
-    const testPatterns = opts._.slice(1); // Skip 'test' command itself
-    if (testPatterns.length > 0) {
-        jestArgs.push(...testPatterns);
+    else {
+        console.log(`${(0, colors_1.c)('gray', '[test]')} using auto-injected Jest configuration`);
     }
-    console.log(`${(0, colors_1.c)('cyan', '[test]')} running E2E tests in ${path.relative(process.cwd(), cwd) || '.'}`);
-    console.log(`${(0, colors_1.c)('gray', '[test]')} using auto-injected Jest configuration`);
-    if (opts.runInBand) {
+    if (mergedOpts.runInBand) {
         console.log(`${(0, colors_1.c)('gray', '[test]')} running tests sequentially (--runInBand)`);
     }
-    if (opts.watch) {
+    if (mergedOpts.watch) {
         console.log(`${(0, colors_1.c)('gray', '[test]')} watch mode enabled`);
     }
-    if (opts.coverage) {
+    if (mergedOpts.coverage) {
         console.log(`${(0, colors_1.c)('gray', '[test]')} coverage collection enabled`);
     }
     console.log(`${(0, colors_1.c)('gray', 'hint:')} press Ctrl+C to stop\n`);
@@ -157,12 +270,14 @@ async function runTest(opts) {
         catch {
             // ignore
         }
-        // Clean up temp config file
-        try {
-            await fs_1.fsp.unlink(configPath);
-        }
-        catch {
-            // ignore
+        // Clean up temp config file (only when we generated one — never the user's).
+        if (configPath) {
+            try {
+                await (0, utils_1.unlink)(configPath);
+            }
+            catch {
+                // ignore
+            }
         }
     };
     process.on('SIGINT', () => {
@@ -187,12 +302,14 @@ async function runTest(opts) {
         });
     }
     finally {
-        // Clean up temp config file
-        try {
-            await fs_1.fsp.unlink(configPath);
-        }
-        catch {
-            // ignore
+        // Clean up temp config file (only when we generated one — never the user's).
+        if (configPath) {
+            try {
+                await (0, utils_1.unlink)(configPath);
+            }
+            catch {
+                // ignore
+            }
         }
     }
 }

package/src/commands/dev/test.js.map

@@ -1 +1 @@
-{"version":3,"file":"test.js","sourceRoot":"","sources":["../../../../src/commands/dev/test.ts"],"names":[],"mappings":"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","sourcesContent":["import * as path from 'path';\nimport * as os from 'os';\nimport { spawn, ChildProcess } from 'child_process';\nimport { ParsedArgs } from '../../core/args';\nimport { c } from '../../core/colors';\nimport { fileExists } from '@frontmcp/utils';\nimport { fsp } from '../../shared/fs';\n\n/**\n * Generate Jest configuration programmatically for E2E tests.\n * This eliminates the need for projects to have their own jest.e2e.config.ts.\n */\nfunction generateJestConfig(cwd: string, opts: ParsedArgs): object {\n  const testTimeout = opts.timeout ?? 60000;\n\n  return {\n    // Use Node.js environment for E2E tests\n    testEnvironment: 'node',\n\n    // Root directory for tests\n    rootDir: cwd,\n\n    // Test file patterns for E2E tests\n    testMatch: ['<rootDir>/e2e/**/*.e2e.ts', '<rootDir>/e2e/**/*.e2e.spec.ts', '<rootDir>/**/*.e2e.ts'],\n\n    // Transform TypeScript files using @swc/jest for speed\n    transform: {\n      '^.+\\\\.[tj]s$': [\n        '@swc/jest',\n        {\n          jsc: {\n            target: 'es2022',\n            parser: {\n              syntax: 'typescript',\n              decorators: true,\n              dynamicImport: true,\n            },\n            transform: {\n              decoratorMetadata: true,\n              legacyDecorator: true,\n            },\n            keepClassNames: true,\n            externalHelpers: true,\n            loose: true,\n          },\n          module: {\n            type: 'es6',\n          },\n          sourceMaps: true,\n          swcrc: false,\n        },\n      ],\n    },\n\n    // File extensions to consider\n    moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],\n\n    // Test timeout\n    testTimeout,\n\n    // Setup files that run after Jest is initialized\n    setupFilesAfterEnv: ['@frontmcp/testing/setup'],\n\n    // Transform packages that use ESM\n    transformIgnorePatterns: ['node_modules/(?!(jose)/)'],\n\n    // Ignore patterns\n    testPathIgnorePatterns: ['/node_modules/', '/dist/'],\n\n    // Coverage settings\n    collectCoverage: opts.coverage ?? false,\n\n    // Coverage configuration when enabled\n    ...(opts.coverage\n      ? {\n          coverageDirectory: '<rootDir>/coverage',\n          coverageReporters: ['text', 'lcov', 'json'],\n          collectCoverageFrom: ['<rootDir>/src/**/*.ts', '!<rootDir>/src/**/*.spec.ts'],\n        }\n      : {}),\n\n    // Verbose output\n    verbose: opts.verbose ?? true,\n  };\n}\n\n/**\n * Run E2E tests using Jest with auto-injected configuration.\n *\n * Usage:\n *   frontmcp test                    # Run E2E tests in current directory\n *   frontmcp test --runInBand        # Run tests sequentially (recommended for E2E)\n *   frontmcp test --watch            # Run tests in watch mode\n *   frontmcp test --verbose          # Show verbose output\n *   frontmcp test --timeout 60000    # Set test timeout (default: 60000ms)\n */\nexport async function runTest(opts: ParsedArgs): Promise<void> {\n  const cwd = process.cwd();\n\n  // Check for e2e directory\n  const e2eDir = path.join(cwd, 'e2e');\n  const hasE2EDir = await fileExists(e2eDir);\n\n  if (!hasE2EDir) {\n    console.error(c('red', 'No e2e directory found.'));\n    console.error('');\n    console.error('Expected structure:');\n    console.error('  ./e2e/');\n    console.error('    ├── your-test.e2e.ts');\n    console.error('    └── another-test.e2e.spec.ts');\n    console.error('');\n    console.error('Create an e2e directory with test files, then run:');\n    console.error('  frontmcp test');\n    process.exit(1);\n  }\n\n  // Generate Jest config and write to temp file\n  const config = generateJestConfig(cwd, opts);\n  const tempDir = os.tmpdir();\n  const configPath = path.join(tempDir, `frontmcp-jest-config-${Date.now()}.json`);\n  await fsp.writeFile(configPath, JSON.stringify(config, null, 2));\n\n  // Build Jest arguments\n  const jestArgs: string[] = ['jest', '--config', configPath];\n\n  // Add --runInBand for sequential execution (recommended for E2E tests)\n  if (opts.runInBand) {\n    jestArgs.push('--runInBand');\n  }\n\n  // Add watch mode\n  if (opts.watch) {\n    jestArgs.push('--watch');\n  }\n\n  // Add verbose flag\n  if (opts.verbose) {\n    jestArgs.push('--verbose');\n  }\n\n  // Add coverage flag\n  if (opts.coverage) {\n    jestArgs.push('--coverage');\n  }\n\n  // Add any additional positional args (e.g., test file patterns)\n  const testPatterns = opts._.slice(1); // Skip 'test' command itself\n  if (testPatterns.length > 0) {\n    jestArgs.push(...testPatterns);\n  }\n\n  console.log(`${c('cyan', '[test]')} running E2E tests in ${path.relative(process.cwd(), cwd) || '.'}`);\n  console.log(`${c('gray', '[test]')} using auto-injected Jest configuration`);\n\n  if (opts.runInBand) {\n    console.log(`${c('gray', '[test]')} running tests sequentially (--runInBand)`);\n  }\n\n  if (opts.watch) {\n    console.log(`${c('gray', '[test]')} watch mode enabled`);\n  }\n\n  if (opts.coverage) {\n    console.log(`${c('gray', '[test]')} coverage collection enabled`);\n  }\n\n  console.log(`${c('gray', 'hint:')} press Ctrl+C to stop\\n`);\n\n  // Run Jest directly via node_modules/.bin or npx without shell\n  // Using shell: false with explicit args array avoids escaping issues\n  const jest = spawn('npx', jestArgs, {\n    stdio: 'inherit',\n    shell: false,\n    cwd,\n  });\n\n  // Handle cleanup\n  const cleanup = async (proc?: ChildProcess) => {\n    try {\n      if (proc) {\n        proc.kill('SIGINT');\n      }\n    } catch {\n      // ignore\n    }\n    // Clean up temp config file\n    try {\n      await fsp.unlink(configPath);\n    } catch {\n      // ignore\n    }\n  };\n\n  process.on('SIGINT', () => {\n    cleanup(jest).finally(() => {\n      process.exit(0);\n    });\n  });\n\n  // Wait for Jest to complete\n  try {\n    await new Promise<void>((resolve, reject) => {\n      jest.on('close', (code) => {\n        if (code === 0) {\n          resolve();\n        } else {\n          reject(new Error(`Jest exited with code ${code}`));\n        }\n      });\n      jest.on('error', (err) => {\n        reject(err);\n      });\n    });\n  } finally {\n    // Clean up temp config file\n    try {\n      await fsp.unlink(configPath);\n    } catch {\n      // ignore\n    }\n  }\n}\n"]}
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../../../src/commands/dev/test.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn, type ChildProcess } from 'child_process';\nimport * as os from 'os';\nimport * as path from 'path';\n\nimport { fileExists, unlink, writeFile } from '@frontmcp/utils';\n\nimport { resolveConfig } from '../../config';\nimport { type ParsedArgs } from '../../core/args';\nimport { c } from '../../core/colors';\n\n/**\n * Filenames in cwd that, when present, cause `frontmcp test` to delegate to\n * the user's own Jest config instead of injecting one. Order matters — Jest's\n * own resolution is `ts > js > mjs > cjs > json`.\n */\nconst USER_JEST_CONFIG_FILES = [\n  'jest.config.ts',\n  'jest.config.js',\n  'jest.config.mjs',\n  'jest.config.cjs',\n  'jest.config.json',\n];\n\nexport async function findUserJestConfig(cwd: string): Promise<string | undefined> {\n  for (const name of USER_JEST_CONFIG_FILES) {\n    const p = path.join(cwd, name);\n\n    if (await fileExists(p)) return p;\n  }\n  return undefined;\n}\n\n/**\n * Build the args passed to `npx jest`. Extracted from `runTest` so the args\n * matrix can be unit-tested without spawning a subprocess.\n *\n * @internal\n */\nexport function buildJestArgs(configPath: string, opts: ParsedArgs, positionalPatterns: string[] = []): string[] {\n  const args: string[] = ['jest', '--config', configPath];\n  if (opts.runInBand) args.push('--runInBand');\n  if (opts.watch) args.push('--watch');\n  if (opts.verbose) args.push('--verbose');\n  if (opts.coverage) args.push('--coverage');\n  if (positionalPatterns.length > 0) args.push(...positionalPatterns);\n  return args;\n}\n\n/**\n * Generate Jest configuration programmatically.\n *\n * Issue #402: the original config (a) only ran `e2e/**` and `**\\/*.e2e.ts`,\n * missing the `*.spec.ts(x)` colocated unit tests mandated by CLAUDE.md, and\n * (b) only transformed `.ts`/`.js` with a `typescript` parser, so any `.tsx`\n * file failed both the regex AND SWC's parser. This generator now:\n *   - matches both colocated unit specs and e2e specs (`.ts` + `.tsx`),\n *   - transforms `.tsx`/`.jsx` files with `tsx: true` and the automatic JSX\n *     runtime so React components are usable in tests,\n *   - exposes the helper for unit testing.\n */\nexport function generateJestConfig(\n  cwd: string,\n  opts: ParsedArgs,\n  testDefaults?: { timeoutMs?: number; testMatch?: string[]; coverage?: boolean },\n): object {\n  // Issue #400 — config defaults apply when CLI flags are absent.\n  const testTimeout = opts.timeout ?? testDefaults?.timeoutMs ?? 60000;\n\n  return {\n    // Use Node.js environment for E2E tests\n    testEnvironment: 'node',\n\n    // Root directory for tests\n    rootDir: cwd,\n\n    // Match both colocated unit specs (`src/**/*.spec.ts(x)`,\n    // `**/__tests__/**/*.spec.ts(x)`) AND e2e specs. The repo convention per\n    // CLAUDE.md is `.spec.ts` (NOT `.test.ts`) for unit tests; `.e2e.spec.ts`\n    // for e2e; `.pw.spec.ts` for Playwright; `.perf.spec.ts` for perf.\n    //\n    // CodeRabbit PR #425: removed `e2e/**/*.e2e.ts(x)` and `**/*.e2e.ts(x)`\n    // patterns — the convention is strictly `.e2e.spec.ts(x)`, so matching\n    // `.e2e.ts` would let stragglers that violate the convention slip\n    // through discovery.\n    testMatch: testDefaults?.testMatch ?? [\n      '<rootDir>/src/**/*.spec.ts',\n      '<rootDir>/src/**/*.spec.tsx',\n      '<rootDir>/**/__tests__/**/*.spec.ts',\n      '<rootDir>/**/__tests__/**/*.spec.tsx',\n      '<rootDir>/e2e/**/*.e2e.spec.ts',\n      '<rootDir>/e2e/**/*.e2e.spec.tsx',\n    ],\n\n    // Transform TypeScript files using @swc/jest for speed. Accepts both\n    // `.ts/.js` and `.tsx/.jsx`; the SWC parser is set up with `tsx: true`\n    // and the automatic JSX runtime so React components work without\n    // additional setup.\n    transform: {\n      '^.+\\\\.[tj]sx?$': [\n        '@swc/jest',\n        {\n          jsc: {\n            target: 'es2022',\n            parser: {\n              syntax: 'typescript',\n              tsx: true,\n              decorators: true,\n              dynamicImport: true,\n            },\n            transform: {\n              decoratorMetadata: true,\n              legacyDecorator: true,\n              react: {\n                runtime: 'automatic',\n              },\n            },\n            keepClassNames: true,\n            externalHelpers: true,\n            loose: true,\n          },\n          module: {\n            type: 'es6',\n          },\n          sourceMaps: true,\n          swcrc: false,\n        },\n      ],\n    },\n\n    // File extensions to consider\n    moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],\n\n    // Test timeout\n    testTimeout,\n\n    // Setup files that run after Jest is initialized\n    setupFilesAfterEnv: ['@frontmcp/testing/setup'],\n\n    // Transform packages that use ESM\n    transformIgnorePatterns: ['node_modules/(?!(jose)/)'],\n\n    // Ignore patterns\n    testPathIgnorePatterns: ['/node_modules/', '/dist/'],\n\n    // Coverage settings (issue #400: CLI > config > false)\n    collectCoverage: opts.coverage ?? testDefaults?.coverage ?? false,\n\n    // Coverage configuration when enabled\n    ...((opts.coverage ?? testDefaults?.coverage)\n      ? {\n          coverageDirectory: '<rootDir>/coverage',\n          coverageReporters: ['text', 'lcov', 'json'],\n          collectCoverageFrom: [\n            '<rootDir>/src/**/*.ts',\n            '<rootDir>/src/**/*.tsx',\n            '!<rootDir>/src/**/*.spec.ts',\n            '!<rootDir>/src/**/*.spec.tsx',\n          ],\n        }\n      : {}),\n\n    // Verbose output\n    verbose: opts.verbose ?? true,\n  };\n}\n\n/**\n * Run E2E tests using Jest with auto-injected configuration.\n *\n * Usage:\n *   frontmcp test                    # Run E2E tests in current directory\n *   frontmcp test --runInBand        # Run tests sequentially (recommended for E2E)\n *   frontmcp test --watch            # Run tests in watch mode\n *   frontmcp test --verbose          # Show verbose output\n *   frontmcp test --timeout 60000    # Set test timeout (default: 60000ms)\n */\nexport async function runTest(opts: ParsedArgs): Promise<void> {\n  const cwd = process.cwd();\n\n  // Issue #400 — resolve frontmcp.config so `test.timeoutMs` /\n  // `test.runInBand` / `test.coverage` / `test.testMatch` apply when the\n  // user didn't pass the equivalent CLI flag.\n  const resolved = await resolveConfig({\n    cwd,\n    mode: 'test',\n    configPath: typeof opts.config === 'string' ? opts.config : undefined,\n  });\n  const testDefaults = resolved.config?.test;\n  const mergedOpts = {\n    ...opts,\n    runInBand: opts.runInBand ?? testDefaults?.runInBand,\n    coverage: opts.coverage ?? testDefaults?.coverage,\n    timeout: opts.timeout ?? testDefaults?.timeoutMs,\n  } as ParsedArgs;\n\n  // Issue #402: honor an existing `jest.config.{ts,js,mjs,cjs,json}` in cwd\n  // by delegating to it instead of injecting our own config. Users who need\n  // bespoke behaviour (custom transforms, projects, setup files, …) shouldn't\n  // be forced to overlay it on top of our injection.\n  const userConfig = await findUserJestConfig(cwd);\n\n  // Issue #402: previously this command HARD-REQUIRED a `./e2e/` directory\n  // and exited 1 otherwise — locking out projects that only have colocated\n  // unit specs (the CLAUDE.md convention). The new testMatch covers both;\n  // we only refuse to run when there's literally nowhere to look.\n  //\n  // CodeRabbit on PR #425: also accept `__tests__/`-only projects, since\n  // `generateJestConfig` discovers `**/__tests__/**/*.spec.ts(x)` too. The\n  // help text below matches the actual default discovery rules.\n  const e2eDir = path.join(cwd, 'e2e');\n  const srcDir = path.join(cwd, 'src');\n  const testsDir = path.join(cwd, '__tests__');\n  const hasE2EDir = await fileExists(e2eDir);\n  const hasSrcDir = await fileExists(srcDir);\n  const hasTestsDir = await fileExists(testsDir);\n\n  if (!userConfig && !hasE2EDir && !hasSrcDir && !hasTestsDir) {\n    console.error(c('red', 'No test sources found.'));\n    console.error('');\n    console.error('Expected one of:');\n    console.error('  • a jest.config.{ts,js,mjs,cjs,json} in the current directory');\n    console.error('  • a ./src/ directory with colocated *.spec.ts(x) files');\n    console.error('  • a ./__tests__/ directory with *.spec.ts(x) files');\n    console.error('  • a ./e2e/ directory with *.e2e.spec.ts(x) files');\n    console.error('');\n    console.error('Create one of those, then run:');\n    console.error('  frontmcp test');\n    process.exit(1);\n  }\n\n  // Build Jest arguments. With a user config, we delegate; otherwise we\n  // write our generated config to a temp file and point Jest at it.\n  let configPath: string | undefined;\n  if (!userConfig) {\n    const config = generateJestConfig(cwd, mergedOpts, testDefaults);\n    const tempDir = os.tmpdir();\n    configPath = path.join(tempDir, `frontmcp-jest-config-${Date.now()}.json`);\n    await writeFile(configPath, JSON.stringify(config, null, 2));\n  }\n\n  // Explicit narrowing avoids the non-null assertion on userConfig. By\n  // construction, the branch above guarantees that exactly one of\n  // `configPath` or `userConfig` is set when we get here — but TS can't\n  // see through that flow, so an explicit guard keeps the type checker\n  // honest without `!`.\n  const selectedConfig = configPath ?? userConfig;\n  if (!selectedConfig) {\n    // Defensive: should be unreachable thanks to the no-sources check above.\n    throw new Error('Internal error: no Jest config selected.');\n  }\n  // Positional test patterns: everything after the `test` command itself.\n  const testPatterns = opts._.slice(1);\n  const jestArgs = buildJestArgs(selectedConfig, mergedOpts, testPatterns);\n\n  console.log(`${c('cyan', '[test]')} running tests in ${path.relative(process.cwd(), cwd) || '.'}`);\n  if (resolved.configPath || resolved.configDir) {\n    console.log(`${c('gray', '[test]')} config: ${resolved.configPath ?? resolved.configDir}`);\n  }\n  if (userConfig) {\n    console.log(`${c('gray', '[test]')} using user Jest config: ${path.relative(cwd, userConfig)}`);\n  } else {\n    console.log(`${c('gray', '[test]')} using auto-injected Jest configuration`);\n  }\n\n  if (mergedOpts.runInBand) {\n    console.log(`${c('gray', '[test]')} running tests sequentially (--runInBand)`);\n  }\n\n  if (mergedOpts.watch) {\n    console.log(`${c('gray', '[test]')} watch mode enabled`);\n  }\n\n  if (mergedOpts.coverage) {\n    console.log(`${c('gray', '[test]')} coverage collection enabled`);\n  }\n\n  console.log(`${c('gray', 'hint:')} press Ctrl+C to stop\\n`);\n\n  // Run Jest directly via node_modules/.bin or npx without shell\n  // Using shell: false with explicit args array avoids escaping issues\n  const jest = spawn('npx', jestArgs, {\n    stdio: 'inherit',\n    shell: false,\n    cwd,\n  });\n\n  // Handle cleanup\n  const cleanup = async (proc?: ChildProcess) => {\n    try {\n      if (proc) {\n        proc.kill('SIGINT');\n      }\n    } catch {\n      // ignore\n    }\n    // Clean up temp config file (only when we generated one — never the user's).\n    if (configPath) {\n      try {\n        await unlink(configPath);\n      } catch {\n        // ignore\n      }\n    }\n  };\n\n  process.on('SIGINT', () => {\n    cleanup(jest).finally(() => {\n      process.exit(0);\n    });\n  });\n\n  // Wait for Jest to complete\n  try {\n    await new Promise<void>((resolve, reject) => {\n      jest.on('close', (code) => {\n        if (code === 0) {\n          resolve();\n        } else {\n          reject(new Error(`Jest exited with code ${code}`));\n        }\n      });\n      jest.on('error', (err) => {\n        reject(err);\n      });\n    });\n  } finally {\n    // Clean up temp config file (only when we generated one — never the user's).\n    if (configPath) {\n      try {\n        await unlink(configPath);\n      } catch {\n        // ignore\n      }\n    }\n  }\n}\n"]}

package/src/commands/eject/mcp-client.d.ts

@@ -0,0 +1,25 @@
+/**
+ * MCP-client snippet emitters (issue #400).
+ *
+ * Each function takes the resolved config and returns the JSON the user
+ * pastes into their client's config file. Format choices match the
+ * existing copy-paste snippets in
+ * `libs/skills/catalog/frontmcp-deployment/examples/mcp-client-integration/`:
+ *
+ *   claude-code      → `~/.config/claude/mcp.json` (or `claude_desktop_config.json`)
+ *                       structure: `{ "mcpServers": { "<name>": { ... } } }`
+ *   claude-desktop   → same structure as claude-code; commonly stored at
+ *                       `~/Library/Application Support/Claude/claude_desktop_config.json`
+ *   cursor / vscode  → same structure (`{ "mcpServers": { ... } }`)
+ *   windsurf         → `~/.codeium/windsurf/mcp_config.json`, same shape
+ *
+ * All four shapes are byte-compatible — the differences are file location +
+ * surrounding wrapper, both of which the user handles after pasting.
+ */
+import type { FrontMcpConfigParsed, McpClientName } from '../../config';
+/**
+ * Build the user-pasteable snippet for the given client. All five clients
+ * use the `{ mcpServers: { <name>: { ... } } }` shape — they differ only in
+ * the file the user pastes it into.
+ */
+export declare function emitClientSnippet(client: McpClientName, config: FrontMcpConfigParsed): string;

package/src/commands/eject/mcp-client.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * MCP-client snippet emitters (issue #400).
+ *
+ * Each function takes the resolved config and returns the JSON the user
+ * pastes into their client's config file. Format choices match the
+ * existing copy-paste snippets in
+ * `libs/skills/catalog/frontmcp-deployment/examples/mcp-client-integration/`:
+ *
+ *   claude-code      → `~/.config/claude/mcp.json` (or `claude_desktop_config.json`)
+ *                       structure: `{ "mcpServers": { "<name>": { ... } } }`
+ *   claude-desktop   → same structure as claude-code; commonly stored at
+ *                       `~/Library/Application Support/Claude/claude_desktop_config.json`
+ *   cursor / vscode  → same structure (`{ "mcpServers": { ... } }`)
+ *   windsurf         → `~/.codeium/windsurf/mcp_config.json`, same shape
+ *
+ * All four shapes are byte-compatible — the differences are file location +
+ * surrounding wrapper, both of which the user handles after pasting.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitClientSnippet = emitClientSnippet;
+function buildServerEntry(client, config) {
+    const connection = config.clients?.[client];
+    if (!connection) {
+        throw new Error(`frontmcp.config has no \`clients.${client}\` entry. ` +
+            `Add it: \`clients: { '${client}': { transport: '...' , ... } }\``);
+    }
+    // Stdio: spawn `command` with `args` + `env`. Most MCP clients omit the
+    // `transport` field when stdio (it's the default), so we follow suit.
+    if (connection.transport === 'stdio') {
+        const command = connection.command ?? 'npx';
+        const args = connection.args ?? ['-y', config.name];
+        const entry = { command, args };
+        if (connection.env && Object.keys(connection.env).length > 0)
+            entry.env = { ...connection.env };
+        return entry;
+    }
+    // HTTP / SSE: emit `url` + `transport`. URL falls back to the configured
+    // HTTP port when none is provided. We collect every deployment port and
+    // only derive a fallback when exactly one is available — picking the
+    // first of several would point the user's client at an arbitrary server.
+    const deploymentPorts = config.deployments
+        .map((d) => ('server' in d ? d.server?.http?.port : undefined))
+        .filter((p) => typeof p === 'number');
+    const derivedDeploymentPort = deploymentPorts.length === 1 ? deploymentPorts[0] : undefined;
+    const httpPort = config.transport?.http?.port ?? derivedDeploymentPort;
+    const httpHost = config.transport?.http?.host ?? '127.0.0.1';
+    const httpPath = config.transport?.http?.path ?? '/mcp';
+    const fallbackUrl = httpPort ? `http://${httpHost}:${httpPort}${httpPath}` : undefined;
+    const url = connection.url ?? fallbackUrl;
+    if (!url) {
+        if (!connection.url && deploymentPorts.length > 1) {
+            throw new Error(`frontmcp.config \`clients.${client}.url\` is required when multiple deployment HTTP ports are configured.`);
+        }
+        throw new Error(`frontmcp.config \`clients.${client}\` needs a \`url\`, or a \`transport.http.port\` / deployment HTTP port to derive one.`);
+    }
+    const entry = { url, transport: connection.transport };
+    if (connection.env && Object.keys(connection.env).length > 0)
+        entry.env = { ...connection.env };
+    return entry;
+}
+/**
+ * Build the user-pasteable snippet for the given client. All five clients
+ * use the `{ mcpServers: { <name>: { ... } } }` shape — they differ only in
+ * the file the user pastes it into.
+ */
+function emitClientSnippet(client, config) {
+    const connection = config.clients?.[client];
+    const serverKey = connection?.name ?? config.name;
+    const entry = buildServerEntry(client, config);
+    const payload = { mcpServers: { [serverKey]: entry } };
+    return JSON.stringify(payload, null, 2);
+}
+//# sourceMappingURL=mcp-client.js.map

package/src/commands/eject/mcp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.js","sourceRoot":"","sources":["../../../../src/commands/eject/mcp-client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MCP-client snippet emitters (issue #400).\n *\n * Each function takes the resolved config and returns the JSON the user\n * pastes into their client's config file. Format choices match the\n * existing copy-paste snippets in\n * `libs/skills/catalog/frontmcp-deployment/examples/mcp-client-integration/`:\n *\n *   claude-code      → `~/.config/claude/mcp.json` (or `claude_desktop_config.json`)\n *                       structure: `{ \"mcpServers\": { \"<name>\": { ... } } }`\n *   claude-desktop   → same structure as claude-code; commonly stored at\n *                       `~/Library/Application Support/Claude/claude_desktop_config.json`\n *   cursor / vscode  → same structure (`{ \"mcpServers\": { ... } }`)\n *   windsurf         → `~/.codeium/windsurf/mcp_config.json`, same shape\n *\n * All four shapes are byte-compatible — the differences are file location +\n * surrounding wrapper, both of which the user handles after pasting.\n */\n\nimport type { FrontMcpConfigParsed, McpClientName } from '../../config';\n\ninterface ServerEntry {\n  command?: string;\n  args?: string[];\n  env?: Record<string, string>;\n  url?: string;\n  transport?: 'http' | 'sse' | 'stdio';\n}\n\nfunction buildServerEntry(client: McpClientName, config: FrontMcpConfigParsed): ServerEntry {\n  const connection = config.clients?.[client];\n  if (!connection) {\n    throw new Error(\n      `frontmcp.config has no \\`clients.${client}\\` entry. ` +\n        `Add it: \\`clients: { '${client}': { transport: '...' , ... } }\\``,\n    );\n  }\n\n  // Stdio: spawn `command` with `args` + `env`. Most MCP clients omit the\n  // `transport` field when stdio (it's the default), so we follow suit.\n  if (connection.transport === 'stdio') {\n    const command = connection.command ?? 'npx';\n    const args = connection.args ?? ['-y', config.name];\n    const entry: ServerEntry = { command, args };\n    if (connection.env && Object.keys(connection.env).length > 0) entry.env = { ...connection.env };\n    return entry;\n  }\n\n  // HTTP / SSE: emit `url` + `transport`. URL falls back to the configured\n  // HTTP port when none is provided. We collect every deployment port and\n  // only derive a fallback when exactly one is available — picking the\n  // first of several would point the user's client at an arbitrary server.\n  const deploymentPorts = config.deployments\n    .map((d) => ('server' in d ? d.server?.http?.port : undefined))\n    .filter((p): p is number => typeof p === 'number');\n  const derivedDeploymentPort = deploymentPorts.length === 1 ? deploymentPorts[0] : undefined;\n  const httpPort = config.transport?.http?.port ?? derivedDeploymentPort;\n  const httpHost = config.transport?.http?.host ?? '127.0.0.1';\n  const httpPath = config.transport?.http?.path ?? '/mcp';\n  const fallbackUrl = httpPort ? `http://${httpHost}:${httpPort}${httpPath}` : undefined;\n  const url = connection.url ?? fallbackUrl;\n  if (!url) {\n    if (!connection.url && deploymentPorts.length > 1) {\n      throw new Error(\n        `frontmcp.config \\`clients.${client}.url\\` is required when multiple deployment HTTP ports are configured.`,\n      );\n    }\n    throw new Error(\n      `frontmcp.config \\`clients.${client}\\` needs a \\`url\\`, or a \\`transport.http.port\\` / deployment HTTP port to derive one.`,\n    );\n  }\n  const entry: ServerEntry = { url, transport: connection.transport };\n  if (connection.env && Object.keys(connection.env).length > 0) entry.env = { ...connection.env };\n  return entry;\n}\n\n/**\n * Build the user-pasteable snippet for the given client. All five clients\n * use the `{ mcpServers: { <name>: { ... } } }` shape — they differ only in\n * the file the user pastes it into.\n */\nexport function emitClientSnippet(client: McpClientName, config: FrontMcpConfigParsed): string {\n  const connection = config.clients?.[client];\n  const serverKey = connection?.name ?? config.name;\n  const entry = buildServerEntry(client, config);\n  const payload = { mcpServers: { [serverKey]: entry } };\n  return JSON.stringify(payload, null, 2);\n}\n"]}

package/src/commands/eject/register.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `frontmcp eject-mcp-config <client>` (issue #400).
+ *
+ * Reads `clients.<client>` from the resolved `frontmcp.config` and prints a
+ * ready-to-paste MCP client snippet to stdout. Supported clients:
+ * `claude-code`, `claude-desktop`, `cursor`, `windsurf`, `vscode`.
+ */
+import type { Command } from 'commander';
+export declare function registerEjectCommands(program: Command): void;

package/src/commands/eject/register.js

@@ -0,0 +1,56 @@
+"use strict";
+/**
+ * `frontmcp eject-mcp-config <client>` (issue #400).
+ *
+ * Reads `clients.<client>` from the resolved `frontmcp.config` and prints a
+ * ready-to-paste MCP client snippet to stdout. Supported clients:
+ * `claude-code`, `claude-desktop`, `cursor`, `windsurf`, `vscode`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerEjectCommands = registerEjectCommands;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const utils_1 = require("@frontmcp/utils");
+const config_1 = require("../../config");
+const colors_1 = require("../../core/colors");
+const mcp_client_1 = require("./mcp-client");
+const SUPPORTED_CLIENTS = ['claude-code', 'claude-desktop', 'cursor', 'windsurf', 'vscode'];
+function registerEjectCommands(program) {
+    program
+        .command('eject-mcp-config <client>')
+        .description(`Emit a ready-to-paste MCP client snippet. Supported: ${SUPPORTED_CLIENTS.join(', ')}`)
+        .option('-o, --out <path>', 'Write the snippet to a file instead of stdout')
+        .option('--dry-run', 'When --out is set, print what would be written instead of writing')
+        .action(async (client, opts) => {
+        if (!SUPPORTED_CLIENTS.includes(client)) {
+            console.error((0, colors_1.c)('red', `Unknown client "${client}".`));
+            console.error(`Supported: ${SUPPORTED_CLIENTS.join(', ')}`);
+            process.exit(2);
+        }
+        const topLevelOpts = program.opts();
+        const resolved = await (0, config_1.resolveConfig)({
+            cwd: process.cwd(),
+            mode: 'build:ship',
+            configPath: topLevelOpts.config,
+        });
+        if (!resolved.config) {
+            console.error((0, colors_1.c)('red', 'No frontmcp.config found.'));
+            console.error('Create one with `frontmcp create` or pass --config <path>.');
+            process.exit(1);
+        }
+        const snippet = (0, mcp_client_1.emitClientSnippet)(client, resolved.config);
+        if (opts.out) {
+            const target = path.isAbsolute(opts.out) ? opts.out : path.resolve(process.cwd(), opts.out);
+            if (opts.dryRun) {
+                console.log((0, colors_1.c)('cyan', `[dry-run] would write ${target}:\n`));
+                console.log(snippet);
+                return;
+            }
+            await (0, utils_1.writeFile)(target, snippet);
+            console.log((0, colors_1.c)('green', `✓ Wrote ${target}`));
+            return;
+        }
+        console.log(snippet);
+    });
+}
+//# sourceMappingURL=register.js.map

package/src/commands/eject/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../../src/commands/eject/register.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAcH,sDA0CC;;AAtDD,mDAA6B;AAI7B,2CAA4C;AAE5C,yCAAiE;AACjE,8CAAsC;AACtC,6CAAiD;AAEjD,MAAM,iBAAiB,GAAoB,CAAC,aAAa,EAAE,gBAAgB,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AAE7G,SAAgB,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,2BAA2B,CAAC;SACpC,WAAW,CAAC,wDAAwD,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SACnG,MAAM,CAAC,kBAAkB,EAAE,+CAA+C,CAAC;SAC3E,MAAM,CAAC,WAAW,EAAE,mEAAmE,CAAC;SACxF,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAwC,EAAE,EAAE;QACzE,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,MAAuB,CAAC,EAAE,CAAC;YACzD,OAAO,CAAC,KAAK,CAAC,IAAA,UAAC,EAAC,KAAK,EAAE,mBAAmB,MAAM,IAAI,CAAC,CAAC,CAAC;YACvD,OAAO,CAAC,KAAK,CAAC,cAAc,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,EAAyB,CAAC;QAC3D,MAAM,QAAQ,GAAG,MAAM,IAAA,sBAAa,EAAC;YACnC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,IAAI,EAAE,YAAY;YAClB,UAAU,EAAE,YAAY,CAAC,MAAM;SAChC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,IAAA,UAAC,EAAC,KAAK,EAAE,2BAA2B,CAAC,CAAC,CAAC;YACrD,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAAG,IAAA,8BAAiB,EAAC,MAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAE5E,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5F,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,OAAO,CAAC,GAAG,CAAC,IAAA,UAAC,EAAC,MAAM,EAAE,yBAAyB,MAAM,KAAK,CAAC,CAAC,CAAC;gBAC7D,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,MAAM,IAAA,iBAAS,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,IAAA,UAAC,EAAC,OAAO,EAAE,WAAW,MAAM,EAAE,CAAC,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACP,CAAC","sourcesContent":["/**\n * `frontmcp eject-mcp-config <client>` (issue #400).\n *\n * Reads `clients.<client>` from the resolved `frontmcp.config` and prints a\n * ready-to-paste MCP client snippet to stdout. Supported clients:\n * `claude-code`, `claude-desktop`, `cursor`, `windsurf`, `vscode`.\n */\n\nimport * as path from 'path';\n\nimport type { Command } from 'commander';\n\nimport { writeFile } from '@frontmcp/utils';\n\nimport { resolveConfig, type McpClientName } from '../../config';\nimport { c } from '../../core/colors';\nimport { emitClientSnippet } from './mcp-client';\n\nconst SUPPORTED_CLIENTS: McpClientName[] = ['claude-code', 'claude-desktop', 'cursor', 'windsurf', 'vscode'];\n\nexport function registerEjectCommands(program: Command): void {\n  program\n    .command('eject-mcp-config <client>')\n    .description(`Emit a ready-to-paste MCP client snippet. Supported: ${SUPPORTED_CLIENTS.join(', ')}`)\n    .option('-o, --out <path>', 'Write the snippet to a file instead of stdout')\n    .option('--dry-run', 'When --out is set, print what would be written instead of writing')\n    .action(async (client: string, opts: { out?: string; dryRun?: boolean }) => {\n      if (!SUPPORTED_CLIENTS.includes(client as McpClientName)) {\n        console.error(c('red', `Unknown client \"${client}\".`));\n        console.error(`Supported: ${SUPPORTED_CLIENTS.join(', ')}`);\n        process.exit(2);\n      }\n\n      const topLevelOpts = program.opts() as { config?: string };\n      const resolved = await resolveConfig({\n        cwd: process.cwd(),\n        mode: 'build:ship',\n        configPath: topLevelOpts.config,\n      });\n\n      if (!resolved.config) {\n        console.error(c('red', 'No frontmcp.config found.'));\n        console.error('Create one with `frontmcp create` or pass --config <path>.');\n        process.exit(1);\n      }\n\n      const snippet = emitClientSnippet(client as McpClientName, resolved.config);\n\n      if (opts.out) {\n        const target = path.isAbsolute(opts.out) ? opts.out : path.resolve(process.cwd(), opts.out);\n        if (opts.dryRun) {\n          console.log(c('cyan', `[dry-run] would write ${target}:\\n`));\n          console.log(snippet);\n          return;\n        }\n        await writeFile(target, snippet);\n        console.log(c('green', `✓ Wrote ${target}`));\n        return;\n      }\n\n      console.log(snippet);\n    });\n}\n"]}

package/src/commands/install/install-claude-plugin.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Implementation of `frontmcp install --claude-plugin [--codex]` (issue #411).
+ *
+ * Flow:
+ *   1. Load frontmcp.config + package.json to determine name/version/description.
+ *   2. Spin up a transient direct-mode SDK instance to enumerate skills and
+ *      prompts (the same surfaces a built bin would expose).
+ *   3. Delegate to the shared `plugin-emitter.ts` helper.
+ *
+ * Status / dry-run paths are short-circuited before the SDK is loaded.
+ */
+export declare function runInstallCurrentProject(rawOpts: Record<string, unknown>): Promise<void>;
+export declare function runUninstallCurrentProject(rawOpts: Record<string, unknown>): Promise<void>;