frontmcp 0.9.0 → 0.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontmcp",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "FrontMCP command line interface",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -29,9 +29,10 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
-    "@frontmcp/utils": "0.9.0",
+    "@frontmcp/utils": "0.10.0",
     "tslib": "^2.3.0",
-    "@rspack/core": "^1.3.12"
+    "@rspack/core": "^1.7.6",
+    "esbuild": "^0.27.3"
   },
   "devDependencies": {
     "typescript": "^5.5.3",

package/src/args.d.ts

@@ -1,4 +1,4 @@
-export type Command = 'dev' | 'build' | 'init' | 'doctor' | 'inspector' | 'create' | 'help' | 'template' | 'version' | 'test';
+export type Command = 'dev' | 'build' | 'init' | 'doctor' | 'inspector' | 'create' | 'help' | 'template' | 'version' | 'test' | 'socket' | 'start' | 'stop' | 'restart' | 'status' | 'list' | 'logs' | 'service' | 'install' | 'uninstall' | 'configure';
 export type DeploymentAdapter = 'node' | 'vercel' | 'lambda' | 'cloudflare';
 export type RedisSetupOption = 'docker' | 'existing' | 'none';
 export interface ParsedArgs {
@@ -16,5 +16,15 @@ export interface ParsedArgs {
     target?: DeploymentAdapter;
     redis?: RedisSetupOption;
     cicd?: boolean;
+    socket?: string;
+    db?: string;
+    background?: boolean;
+    exec?: boolean;
+    port?: number;
+    force?: boolean;
+    maxRestarts?: number;
+    follow?: boolean;
+    lines?: number;
+    registry?: string;
 }
 export declare function parseArgs(argv: string[]): ParsedArgs;

package/src/args.js

@@ -36,6 +36,36 @@ function parseArgs(argv) {
             out.cicd = true;
         else if (a === '--no-cicd')
             out.cicd = false;
+        // Socket command flags
+        else if (a === '--socket' || a === '-s')
+            out.socket = argv[++i];
+        else if (a === '--db')
+            out.db = argv[++i];
+        else if (a === '--background' || a === '-b')
+            out.background = true;
+        // Build --exec flag
+        else if (a === '--exec')
+            out.exec = true;
+        // Process Manager flags
+        else if (a === '--port' || a === '-p') {
+            const parsed = parseInt(argv[++i], 10);
+            out.port = Number.isNaN(parsed) ? undefined : parsed;
+        }
+        else if (a === '--force' || a === '-f')
+            out.force = true;
+        else if (a === '--max-restarts') {
+            const parsed = parseInt(argv[++i], 10);
+            out.maxRestarts = Number.isNaN(parsed) ? undefined : parsed;
+        }
+        else if (a === '--follow' || a === '-F')
+            out.follow = true;
+        else if (a === '--lines' || a === '-n') {
+            const parsed = parseInt(argv[++i], 10);
+            out.lines = Number.isNaN(parsed) ? undefined : parsed;
+        }
+        // Install flags
+        else if (a === '--registry')
+            out.registry = argv[++i];
         else
             out._.push(a);
     }

package/src/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/args.ts"],"names":[],"mappings":";;AAiCA,8BAwBC;AAxBD,SAAgB,SAAS,CAAC,IAAc;IACtC,MAAM,GAAG,GAAe,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,IAAI;YAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;aACvD,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;YAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;aACzD,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,IAAI;YAAE,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAsB,CAAC;aAClF,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;YAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;aAClD,IAAI,CAAC,KAAK,aAAa,IAAI,CAAC,KAAK,IAAI;YAAE,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC;aAC5D,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI;YAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC;aACpD,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,IAAI;YAAE,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;aACxD,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACzC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvC,GAAG,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1D,CAAC;aAAM,IAAI,CAAC,KAAK,YAAY,IAAI,CAAC,KAAK,IAAI;YAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC;QACjE,uBAAuB;aAClB,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,IAAI;YAAE,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC;aAChD,IAAI,CAAC,KAAK,UAAU;YAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAsB,CAAC;aAClE,IAAI,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAqB,CAAC;aAC/D,IAAI,CAAC,KAAK,QAAQ;YAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;aACpC,IAAI,CAAC,KAAK,WAAW;YAAE,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC;;YACxC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC","sourcesContent":["export type Command =\n  | 'dev'\n  | 'build'\n  | 'init'\n  | 'doctor'\n  | 'inspector'\n  | 'create'\n  | 'help'\n  | 'template'\n  | 'version'\n  | 'test';\n\nexport type DeploymentAdapter = 'node' | 'vercel' | 'lambda' | 'cloudflare';\nexport type RedisSetupOption = 'docker' | 'existing' | 'none';\n\nexport interface ParsedArgs {\n  _: string[];\n  outDir?: string;\n  entry?: string;\n  help?: boolean;\n  runInBand?: boolean;\n  watch?: boolean;\n  verbose?: boolean;\n  timeout?: number;\n  coverage?: boolean;\n  adapter?: DeploymentAdapter;\n  // Create command flags\n  yes?: boolean;\n  target?: DeploymentAdapter;\n  redis?: RedisSetupOption;\n  cicd?: boolean;\n}\n\nexport function parseArgs(argv: string[]): ParsedArgs {\n  const out: ParsedArgs = { _: [] };\n  for (let i = 0; i < argv.length; i++) {\n    const a = argv[i];\n    if (a === '--out-dir' || a === '-o') out.outDir = argv[++i];\n    else if (a === '--entry' || a === '-e') out.entry = argv[++i];\n    else if (a === '--adapter' || a === '-a') out.adapter = argv[++i] as DeploymentAdapter;\n    else if (a === '--help' || a === '-h') out.help = true;\n    else if (a === '--runInBand' || a === '-i') out.runInBand = true;\n    else if (a === '--watch' || a === '-w') out.watch = true;\n    else if (a === '--verbose' || a === '-v') out.verbose = true;\n    else if (a === '--timeout' || a === '-t') {\n      const parsed = parseInt(argv[++i], 10);\n      out.timeout = Number.isNaN(parsed) ? undefined : parsed;\n    } else if (a === '--coverage' || a === '-c') out.coverage = true;\n    // Create command flags\n    else if (a === '--yes' || a === '-y') out.yes = true;\n    else if (a === '--target') out.target = argv[++i] as DeploymentAdapter;\n    else if (a === '--redis') out.redis = argv[++i] as RedisSetupOption;\n    else if (a === '--cicd') out.cicd = true;\n    else if (a === '--no-cicd') out.cicd = false;\n    else out._.push(a);\n  }\n  return out;\n}\n"]}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/args.ts"],"names":[],"mappings":"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","sourcesContent":["export type Command =\n  | 'dev'\n  | 'build'\n  | 'init'\n  | 'doctor'\n  | 'inspector'\n  | 'create'\n  | 'help'\n  | 'template'\n  | 'version'\n  | 'test'\n  | 'socket'\n  // Process Manager commands\n  | 'start'\n  | 'stop'\n  | 'restart'\n  | 'status'\n  | 'list'\n  | 'logs'\n  | 'service'\n  // Package Manager commands\n  | 'install'\n  | 'uninstall'\n  | 'configure';\n\nexport type DeploymentAdapter = 'node' | 'vercel' | 'lambda' | 'cloudflare';\nexport type RedisSetupOption = 'docker' | 'existing' | 'none';\n\nexport interface ParsedArgs {\n  _: string[];\n  outDir?: string;\n  entry?: string;\n  help?: boolean;\n  runInBand?: boolean;\n  watch?: boolean;\n  verbose?: boolean;\n  timeout?: number;\n  coverage?: boolean;\n  adapter?: DeploymentAdapter;\n  // Create command flags\n  yes?: boolean;\n  target?: DeploymentAdapter;\n  redis?: RedisSetupOption;\n  cicd?: boolean;\n  // Socket command flags\n  socket?: string;\n  db?: string;\n  background?: boolean;\n  // Build --exec flag\n  exec?: boolean;\n  // Process Manager flags\n  port?: number;\n  force?: boolean;\n  maxRestarts?: number;\n  follow?: boolean;\n  lines?: number;\n  // Install flags\n  registry?: string;\n}\n\nexport function parseArgs(argv: string[]): ParsedArgs {\n  const out: ParsedArgs = { _: [] };\n  for (let i = 0; i < argv.length; i++) {\n    const a = argv[i];\n    if (a === '--out-dir' || a === '-o') out.outDir = argv[++i];\n    else if (a === '--entry' || a === '-e') out.entry = argv[++i];\n    else if (a === '--adapter' || a === '-a') out.adapter = argv[++i] as DeploymentAdapter;\n    else if (a === '--help' || a === '-h') out.help = true;\n    else if (a === '--runInBand' || a === '-i') out.runInBand = true;\n    else if (a === '--watch' || a === '-w') out.watch = true;\n    else if (a === '--verbose' || a === '-v') out.verbose = true;\n    else if (a === '--timeout' || a === '-t') {\n      const parsed = parseInt(argv[++i], 10);\n      out.timeout = Number.isNaN(parsed) ? undefined : parsed;\n    } else if (a === '--coverage' || a === '-c') out.coverage = true;\n    // Create command flags\n    else if (a === '--yes' || a === '-y') out.yes = true;\n    else if (a === '--target') out.target = argv[++i] as DeploymentAdapter;\n    else if (a === '--redis') out.redis = argv[++i] as RedisSetupOption;\n    else if (a === '--cicd') out.cicd = true;\n    else if (a === '--no-cicd') out.cicd = false;\n    // Socket command flags\n    else if (a === '--socket' || a === '-s') out.socket = argv[++i];\n    else if (a === '--db') out.db = argv[++i];\n    else if (a === '--background' || a === '-b') out.background = true;\n    // Build --exec flag\n    else if (a === '--exec') out.exec = true;\n    // Process Manager flags\n    else if (a === '--port' || a === '-p') {\n      const parsed = parseInt(argv[++i], 10);\n      out.port = Number.isNaN(parsed) ? undefined : parsed;\n    } else if (a === '--force' || a === '-f') out.force = true;\n    else if (a === '--max-restarts') {\n      const parsed = parseInt(argv[++i], 10);\n      out.maxRestarts = Number.isNaN(parsed) ? undefined : parsed;\n    } else if (a === '--follow' || a === '-F') out.follow = true;\n    else if (a === '--lines' || a === '-n') {\n      const parsed = parseInt(argv[++i], 10);\n      out.lines = Number.isNaN(parsed) ? undefined : parsed;\n    }\n    // Install flags\n    else if (a === '--registry') out.registry = argv[++i];\n    else out._.push(a);\n  }\n  return out;\n}\n"]}

package/src/cli.js

@@ -14,6 +14,7 @@ const inspector_1 = require("./commands/inspector");
 const create_1 = require("./commands/create");
 const template_1 = require("./commands/template");
 const test_1 = require("./commands/test");
+const socket_1 = require("./commands/socket");
 function showHelp() {
     console.log(`
 ${(0, colors_1.c)('bold', 'frontmcp')} — FrontMCP command line interface
@@ -21,21 +22,60 @@ ${(0, colors_1.c)('bold', 'frontmcp')} — FrontMCP command line interface
 ${(0, colors_1.c)('bold', 'Usage')}
   frontmcp <command> [options]
 
-${(0, colors_1.c)('bold', 'Commands')}
+${(0, colors_1.c)('bold', 'Development')}
   dev                 Start in development mode (tsx --watch <entry> + async type-check)
   build               Compile entry with TypeScript (tsc)
+  build --exec        Build distributable executable bundle (esbuild)
   test                Run E2E tests with auto-injected Jest configuration
   init                Create or fix a tsconfig.json suitable for FrontMCP
   doctor              Check Node/npm versions and tsconfig requirements
   inspector           Launch MCP Inspector (npx @modelcontextprotocol/inspector)
   create [name]       Scaffold a new FrontMCP project (interactive if name omitted)
   template <type>     Scaffold a template by type (e.g., "3rd-party-integration")
-  help                Show this help message
+  socket <entry>      Start Unix socket daemon for local MCP server
 
-${(0, colors_1.c)('bold', 'Options')}
+${(0, colors_1.c)('bold', 'Process Manager')}
+  start <name>        Start a named MCP server with supervisor
+  stop <name>         Stop a managed server (graceful by default)
+  restart <name>      Restart a managed server
+  status [name]       Show process status (detail if name given, table if omitted)
+  list                List all managed processes
+  logs <name>         Tail log output for a managed server
+  service <action>    Install/uninstall systemd/launchd service
+
+${(0, colors_1.c)('bold', 'Package Manager')}
+  install <source>    Install an MCP app from npm, local path, or git
+  uninstall <name>    Remove an installed MCP app
+  configure <name>    Re-run setup questionnaire for an installed app
+
+${(0, colors_1.c)('bold', 'General Options')}
+  -h, --help           Show this help message
   -o, --out-dir <dir>  Output directory (default: ./dist)
   -e, --entry <path>   Manually specify entry file path
 
+${(0, colors_1.c)('bold', 'Build Options')}
+  --exec               Build distributable executable bundle
+  -a, --adapter <name> Deployment adapter: node, vercel, lambda, cloudflare
+
+${(0, colors_1.c)('bold', 'Start Options')}
+  -e, --entry <path>   Entry file for the server
+  -p, --port <N>       Port number for the server
+  -s, --socket <path>  Unix socket path
+  --db <path>          SQLite database path
+  --max-restarts <N>   Maximum auto-restart attempts (default: 5)
+
+${(0, colors_1.c)('bold', 'Stop Options')}
+  -f, --force          Force kill (SIGKILL instead of SIGTERM)
+
+${(0, colors_1.c)('bold', 'Logs Options')}
+  -F, --follow         Follow log output (like tail -f)
+  -n, --lines <N>      Number of lines to show (default: 50)
+
+${(0, colors_1.c)('bold', 'Install Options')}
+  --registry <url>     npm registry URL for private packages
+  -y, --yes            Silent mode (use defaults, skip questionnaire)
+  -p, --port <N>       Override default port
+
 ${(0, colors_1.c)('bold', 'Create Options')}
   -y, --yes            Use defaults (non-interactive mode)
   --target <target>    Deployment target: node, vercel, lambda, cloudflare
@@ -43,6 +83,11 @@ ${(0, colors_1.c)('bold', 'Create Options')}
   --cicd               Enable GitHub Actions CI/CD
   --no-cicd            Disable GitHub Actions CI/CD
 
+${(0, colors_1.c)('bold', 'Socket Options')}
+  -s, --socket <path>  Unix socket path (default: ~/.frontmcp/sockets/{app}.sock)
+  --db <path>          SQLite database path for persistence
+  -b, --background     Run as background daemon (detached process)
+
 ${(0, colors_1.c)('bold', 'Test Options')}
   -i, --runInBand      Run tests sequentially (recommended for E2E)
   -w, --watch          Run tests in watch mode
@@ -53,6 +98,7 @@ ${(0, colors_1.c)('bold', 'Test Options')}
 ${(0, colors_1.c)('bold', 'Examples')}
   frontmcp dev
   frontmcp build --out-dir build
+  frontmcp build --exec
   frontmcp test --runInBand
   frontmcp init
   frontmcp doctor
@@ -61,6 +107,17 @@ ${(0, colors_1.c)('bold', 'Examples')}
   npx frontmcp create my-mcp --yes             # Use defaults
   npx frontmcp create my-mcp --target vercel   # Vercel deployment
   npx frontmcp template marketplace-3rd-tools
+  frontmcp socket ./src/main.ts --socket /tmp/my-app.sock
+  frontmcp socket ./src/main.ts --socket /tmp/my-app.sock --db ~/.frontmcp/data/app.sqlite
+  frontmcp start my-app --entry ./src/main.ts --port 3005
+  frontmcp stop my-app
+  frontmcp logs my-app --follow
+  frontmcp service install my-app
+  frontmcp install @company/my-mcp --registry https://npm.company.com
+  frontmcp install ./my-local-app
+  frontmcp install github:user/repo
+  frontmcp configure my-app
+  frontmcp uninstall my-app
 `);
 }
 async function main() {
@@ -107,6 +164,61 @@ async function main() {
             case 'test':
                 await (0, test_1.runTest)(parsed);
                 break;
+            case 'socket':
+                await (0, socket_1.runSocket)(parsed);
+                break;
+            // Process Manager commands (dynamic imports)
+            case 'start': {
+                const { runStart } = await import('./commands/start.js');
+                await runStart(parsed);
+                break;
+            }
+            case 'stop': {
+                const { runStop } = await import('./commands/stop.js');
+                await runStop(parsed);
+                break;
+            }
+            case 'restart': {
+                const { runRestart } = await import('./commands/restart.js');
+                await runRestart(parsed);
+                break;
+            }
+            case 'status': {
+                const { runStatus } = await import('./commands/status.js');
+                await runStatus(parsed);
+                break;
+            }
+            case 'list': {
+                const { runList } = await import('./commands/list.js');
+                await runList(parsed);
+                break;
+            }
+            case 'logs': {
+                const { runLogs } = await import('./commands/logs.js');
+                await runLogs(parsed);
+                break;
+            }
+            case 'service': {
+                const { runService } = await import('./commands/service.js');
+                await runService(parsed);
+                break;
+            }
+            // Package Manager commands (dynamic imports)
+            case 'install': {
+                const { runInstall } = await import('./commands/install/index.js');
+                await runInstall(parsed);
+                break;
+            }
+            case 'uninstall': {
+                const { runUninstall } = await import('./commands/uninstall.js');
+                await runUninstall(parsed);
+                break;
+            }
+            case 'configure': {
+                const { runConfigure } = await import('./commands/configure.js');
+                await runConfigure(parsed);
+                break;
+            }
             case 'help':
                 showHelp();
                 break;

package/src/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n/**\n * frontmcp - FrontMCP command line interface\n */\n\nimport { c } from './colors';\nimport { Command, ParsedArgs, parseArgs } from './args';\nimport { runDev } from './commands/dev';\nimport { runBuild } from './commands/build';\nimport { runInit } from './tsconfig';\nimport { runDoctor } from './commands/doctor';\nimport { runInspector } from './commands/inspector';\nimport { runCreate } from './commands/create';\nimport { runTemplate } from './commands/template';\nimport { runTest } from './commands/test';\n\nfunction showHelp(): void {\n  console.log(`\n${c('bold', 'frontmcp')} — FrontMCP command line interface\n\n${c('bold', 'Usage')}\n  frontmcp <command> [options]\n\n${c('bold', 'Commands')}\n  dev                 Start in development mode (tsx --watch <entry> + async type-check)\n  build               Compile entry with TypeScript (tsc)\n  test                Run E2E tests with auto-injected Jest configuration\n  init                Create or fix a tsconfig.json suitable for FrontMCP\n  doctor              Check Node/npm versions and tsconfig requirements\n  inspector           Launch MCP Inspector (npx @modelcontextprotocol/inspector)\n  create [name]       Scaffold a new FrontMCP project (interactive if name omitted)\n  template <type>     Scaffold a template by type (e.g., \"3rd-party-integration\")\n  help                Show this help message\n\n${c('bold', 'Options')}\n  -o, --out-dir <dir>  Output directory (default: ./dist)\n  -e, --entry <path>   Manually specify entry file path\n\n${c('bold', 'Create Options')}\n  -y, --yes            Use defaults (non-interactive mode)\n  --target <target>    Deployment target: node, vercel, lambda, cloudflare\n  --redis <setup>      Redis setup: docker, existing, none (node target only)\n  --cicd               Enable GitHub Actions CI/CD\n  --no-cicd            Disable GitHub Actions CI/CD\n\n${c('bold', 'Test Options')}\n  -i, --runInBand      Run tests sequentially (recommended for E2E)\n  -w, --watch          Run tests in watch mode\n  -v, --verbose        Show verbose test output\n  -t, --timeout <ms>   Set test timeout (default: 60000ms)\n  -c, --coverage       Collect test coverage\n\n${c('bold', 'Examples')}\n  frontmcp dev\n  frontmcp build --out-dir build\n  frontmcp test --runInBand\n  frontmcp init\n  frontmcp doctor\n  frontmcp inspector\n  npx frontmcp create                          # Interactive mode\n  npx frontmcp create my-mcp --yes             # Use defaults\n  npx frontmcp create my-mcp --target vercel   # Vercel deployment\n  npx frontmcp template marketplace-3rd-tools\n`);\n}\n\nasync function main(): Promise<void> {\n  const argv = process.argv.slice(2);\n  const parsed: ParsedArgs = parseArgs(argv);\n  const cmd = parsed._[0] as Command | undefined;\n\n  if (parsed.help || !cmd) {\n    showHelp();\n    process.exit(0);\n  }\n\n  try {\n    switch (cmd) {\n      case 'dev':\n        await runDev(parsed);\n        break;\n      case 'build':\n        parsed.outDir = parsed.outDir || 'dist';\n        await runBuild(parsed);\n        break;\n      case 'init':\n        await runInit();\n        break;\n      case 'doctor':\n        await runDoctor();\n        break;\n      case 'inspector':\n        await runInspector();\n        break;\n      case 'create': {\n        const projectName = parsed._[1];\n        await runCreate(projectName, {\n          yes: parsed.yes,\n          target: parsed.target,\n          redis: parsed.redis,\n          cicd: parsed.cicd,\n        });\n        break;\n      }\n      case 'template': {\n        const type = parsed._[1]; // e.g. \"3rd-party-integration\"\n        await runTemplate(type);\n        break;\n      }\n      case 'test':\n        await runTest(parsed);\n        break;\n      case 'help':\n        showHelp();\n        break;\n      default:\n        console.error(c('red', `Unknown command: ${cmd}`));\n        showHelp();\n        process.exitCode = 1;\n    }\n  } catch (err: unknown) {\n    console.error('\\n' + c('red', err instanceof Error ? err.stack || err.message : String(err)));\n    process.exit(1);\n  }\n}\n\nmain();\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n/**\n * frontmcp - FrontMCP command line interface\n */\n\nimport { c } from './colors';\nimport { Command, ParsedArgs, parseArgs } from './args';\nimport { runDev } from './commands/dev';\nimport { runBuild } from './commands/build';\nimport { runInit } from './tsconfig';\nimport { runDoctor } from './commands/doctor';\nimport { runInspector } from './commands/inspector';\nimport { runCreate } from './commands/create';\nimport { runTemplate } from './commands/template';\nimport { runTest } from './commands/test';\nimport { runSocket } from './commands/socket';\n\nfunction showHelp(): void {\n  console.log(`\n${c('bold', 'frontmcp')} — FrontMCP command line interface\n\n${c('bold', 'Usage')}\n  frontmcp <command> [options]\n\n${c('bold', 'Development')}\n  dev                 Start in development mode (tsx --watch <entry> + async type-check)\n  build               Compile entry with TypeScript (tsc)\n  build --exec        Build distributable executable bundle (esbuild)\n  test                Run E2E tests with auto-injected Jest configuration\n  init                Create or fix a tsconfig.json suitable for FrontMCP\n  doctor              Check Node/npm versions and tsconfig requirements\n  inspector           Launch MCP Inspector (npx @modelcontextprotocol/inspector)\n  create [name]       Scaffold a new FrontMCP project (interactive if name omitted)\n  template <type>     Scaffold a template by type (e.g., \"3rd-party-integration\")\n  socket <entry>      Start Unix socket daemon for local MCP server\n\n${c('bold', 'Process Manager')}\n  start <name>        Start a named MCP server with supervisor\n  stop <name>         Stop a managed server (graceful by default)\n  restart <name>      Restart a managed server\n  status [name]       Show process status (detail if name given, table if omitted)\n  list                List all managed processes\n  logs <name>         Tail log output for a managed server\n  service <action>    Install/uninstall systemd/launchd service\n\n${c('bold', 'Package Manager')}\n  install <source>    Install an MCP app from npm, local path, or git\n  uninstall <name>    Remove an installed MCP app\n  configure <name>    Re-run setup questionnaire for an installed app\n\n${c('bold', 'General Options')}\n  -h, --help           Show this help message\n  -o, --out-dir <dir>  Output directory (default: ./dist)\n  -e, --entry <path>   Manually specify entry file path\n\n${c('bold', 'Build Options')}\n  --exec               Build distributable executable bundle\n  -a, --adapter <name> Deployment adapter: node, vercel, lambda, cloudflare\n\n${c('bold', 'Start Options')}\n  -e, --entry <path>   Entry file for the server\n  -p, --port <N>       Port number for the server\n  -s, --socket <path>  Unix socket path\n  --db <path>          SQLite database path\n  --max-restarts <N>   Maximum auto-restart attempts (default: 5)\n\n${c('bold', 'Stop Options')}\n  -f, --force          Force kill (SIGKILL instead of SIGTERM)\n\n${c('bold', 'Logs Options')}\n  -F, --follow         Follow log output (like tail -f)\n  -n, --lines <N>      Number of lines to show (default: 50)\n\n${c('bold', 'Install Options')}\n  --registry <url>     npm registry URL for private packages\n  -y, --yes            Silent mode (use defaults, skip questionnaire)\n  -p, --port <N>       Override default port\n\n${c('bold', 'Create Options')}\n  -y, --yes            Use defaults (non-interactive mode)\n  --target <target>    Deployment target: node, vercel, lambda, cloudflare\n  --redis <setup>      Redis setup: docker, existing, none (node target only)\n  --cicd               Enable GitHub Actions CI/CD\n  --no-cicd            Disable GitHub Actions CI/CD\n\n${c('bold', 'Socket Options')}\n  -s, --socket <path>  Unix socket path (default: ~/.frontmcp/sockets/{app}.sock)\n  --db <path>          SQLite database path for persistence\n  -b, --background     Run as background daemon (detached process)\n\n${c('bold', 'Test Options')}\n  -i, --runInBand      Run tests sequentially (recommended for E2E)\n  -w, --watch          Run tests in watch mode\n  -v, --verbose        Show verbose test output\n  -t, --timeout <ms>   Set test timeout (default: 60000ms)\n  -c, --coverage       Collect test coverage\n\n${c('bold', 'Examples')}\n  frontmcp dev\n  frontmcp build --out-dir build\n  frontmcp build --exec\n  frontmcp test --runInBand\n  frontmcp init\n  frontmcp doctor\n  frontmcp inspector\n  npx frontmcp create                          # Interactive mode\n  npx frontmcp create my-mcp --yes             # Use defaults\n  npx frontmcp create my-mcp --target vercel   # Vercel deployment\n  npx frontmcp template marketplace-3rd-tools\n  frontmcp socket ./src/main.ts --socket /tmp/my-app.sock\n  frontmcp socket ./src/main.ts --socket /tmp/my-app.sock --db ~/.frontmcp/data/app.sqlite\n  frontmcp start my-app --entry ./src/main.ts --port 3005\n  frontmcp stop my-app\n  frontmcp logs my-app --follow\n  frontmcp service install my-app\n  frontmcp install @company/my-mcp --registry https://npm.company.com\n  frontmcp install ./my-local-app\n  frontmcp install github:user/repo\n  frontmcp configure my-app\n  frontmcp uninstall my-app\n`);\n}\n\nasync function main(): Promise<void> {\n  const argv = process.argv.slice(2);\n  const parsed: ParsedArgs = parseArgs(argv);\n  const cmd = parsed._[0] as Command | undefined;\n\n  if (parsed.help || !cmd) {\n    showHelp();\n    process.exit(0);\n  }\n\n  try {\n    switch (cmd) {\n      case 'dev':\n        await runDev(parsed);\n        break;\n      case 'build':\n        parsed.outDir = parsed.outDir || 'dist';\n        await runBuild(parsed);\n        break;\n      case 'init':\n        await runInit();\n        break;\n      case 'doctor':\n        await runDoctor();\n        break;\n      case 'inspector':\n        await runInspector();\n        break;\n      case 'create': {\n        const projectName = parsed._[1];\n        await runCreate(projectName, {\n          yes: parsed.yes,\n          target: parsed.target,\n          redis: parsed.redis,\n          cicd: parsed.cicd,\n        });\n        break;\n      }\n      case 'template': {\n        const type = parsed._[1]; // e.g. \"3rd-party-integration\"\n        await runTemplate(type);\n        break;\n      }\n      case 'test':\n        await runTest(parsed);\n        break;\n      case 'socket':\n        await runSocket(parsed);\n        break;\n\n      // Process Manager commands (dynamic imports)\n      case 'start': {\n        const { runStart } = await import('./commands/start.js');\n        await runStart(parsed);\n        break;\n      }\n      case 'stop': {\n        const { runStop } = await import('./commands/stop.js');\n        await runStop(parsed);\n        break;\n      }\n      case 'restart': {\n        const { runRestart } = await import('./commands/restart.js');\n        await runRestart(parsed);\n        break;\n      }\n      case 'status': {\n        const { runStatus } = await import('./commands/status.js');\n        await runStatus(parsed);\n        break;\n      }\n      case 'list': {\n        const { runList } = await import('./commands/list.js');\n        await runList(parsed);\n        break;\n      }\n      case 'logs': {\n        const { runLogs } = await import('./commands/logs.js');\n        await runLogs(parsed);\n        break;\n      }\n      case 'service': {\n        const { runService } = await import('./commands/service.js');\n        await runService(parsed);\n        break;\n      }\n\n      // Package Manager commands (dynamic imports)\n      case 'install': {\n        const { runInstall } = await import('./commands/install/index.js');\n        await runInstall(parsed);\n        break;\n      }\n      case 'uninstall': {\n        const { runUninstall } = await import('./commands/uninstall.js');\n        await runUninstall(parsed);\n        break;\n      }\n      case 'configure': {\n        const { runConfigure } = await import('./commands/configure.js');\n        await runConfigure(parsed);\n        break;\n      }\n\n      case 'help':\n        showHelp();\n        break;\n      default:\n        console.error(c('red', `Unknown command: ${cmd}`));\n        showHelp();\n        process.exitCode = 1;\n    }\n  } catch (err: unknown) {\n    console.error('\\n' + c('red', err instanceof Error ? err.stack || err.message : String(err)));\n    process.exit(1);\n  }\n}\n\nmain();\n"]}

package/src/commands/build/exec/config.d.ts

@@ -0,0 +1,38 @@
+/**
+ * frontmcp.config.js/json schema and loader.
+ */
+import { SetupDefinition } from './setup';
+export interface FrontmcpExecConfig {
+    name: string;
+    version?: string;
+    entry?: string;
+    storage?: {
+        type: 'sqlite' | 'redis' | 'none';
+        required?: boolean;
+    };
+    network?: {
+        defaultPort?: number;
+        supportsSocket?: boolean;
+    };
+    dependencies?: {
+        system?: string[];
+        nativeAddons?: string[];
+    };
+    nodeVersion?: string;
+    esbuild?: {
+        external?: string[];
+        define?: Record<string, string>;
+        target?: string;
+        minify?: boolean;
+    };
+    setup?: SetupDefinition;
+}
+/**
+ * Load frontmcp.config.js/json from the given directory.
+ * Falls back to deriving minimal config from package.json.
+ */
+export declare function loadExecConfig(cwd: string): Promise<FrontmcpExecConfig>;
+/**
+ * Validate config and return normalized version.
+ */
+export declare function normalizeConfig(config: FrontmcpExecConfig): Required<Pick<FrontmcpExecConfig, 'name' | 'version' | 'nodeVersion'>> & FrontmcpExecConfig;

package/src/commands/build/exec/config.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * frontmcp.config.js/json schema and loader.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadExecConfig = loadExecConfig;
+exports.normalizeConfig = normalizeConfig;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const fs = tslib_1.__importStar(require("fs"));
+const CONFIG_FILENAMES = [
+    'frontmcp.config.js',
+    'frontmcp.config.json',
+    'frontmcp.config.mjs',
+    'frontmcp.config.cjs',
+];
+/**
+ * Load frontmcp.config.js/json from the given directory.
+ * Falls back to deriving minimal config from package.json.
+ */
+async function loadExecConfig(cwd) {
+    for (const filename of CONFIG_FILENAMES) {
+        const configPath = path.join(cwd, filename);
+        if (fs.existsSync(configPath)) {
+            if (filename.endsWith('.json')) {
+                const content = fs.readFileSync(configPath, 'utf-8');
+                return JSON.parse(content);
+            }
+            // JS/MJS/CJS config — require it
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const mod = require(configPath);
+            return (mod.default || mod);
+        }
+    }
+    // Fallback: derive from package.json
+    const pkgPath = path.join(cwd, 'package.json');
+    if (!fs.existsSync(pkgPath)) {
+        throw new Error('No frontmcp.config.js/json found and no package.json. Create a frontmcp.config.js to use --exec.');
+    }
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    return {
+        name: pkg.name?.replace(/^@[^/]+\//, '') || path.basename(cwd),
+        version: pkg.version || '1.0.0',
+        entry: pkg.main,
+    };
+}
+/**
+ * Validate config and return normalized version.
+ */
+function normalizeConfig(config) {
+    if (!config.name || !/^[a-zA-Z0-9._-]+$/.test(config.name)) {
+        throw new Error(`Invalid app name: "${config.name}". Must be alphanumeric with .-_ only.`);
+    }
+    return {
+        ...config,
+        name: config.name,
+        version: config.version || '1.0.0',
+        nodeVersion: config.nodeVersion || '>=22.0.0',
+    };
+}
+//# sourceMappingURL=config.js.map

package/src/commands/build/exec/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../src/commands/build/exec/config.ts"],"names":[],"mappings":";AAAA;;GAEG;;AA2CH,wCA6BC;AAKD,0CAgBC;;AA3FD,mDAA6B;AAC7B,+CAAyB;AA6BzB,MAAM,gBAAgB,GAAG;IACvB,oBAAoB;IACpB,sBAAsB;IACtB,qBAAqB;IACrB,qBAAqB;CACtB,CAAC;AAEF;;;GAGG;AACI,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,KAAK,MAAM,QAAQ,IAAI,gBAAgB,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC5C,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBACrD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAuB,CAAC;YACnD,CAAC;YACD,iCAAiC;YACjC,iEAAiE;YACjE,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAuB,CAAC;QACpD,CAAC;IACH,CAAC;IAED,qCAAqC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,kGAAkG,CACnG,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAC9D,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,OAAO;QAC/B,KAAK,EAAE,GAAG,CAAC,IAAI;KAChB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,MAA0B;IAIxD,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CACb,sBAAsB,MAAM,CAAC,IAAI,wCAAwC,CAC1E,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,MAAM;QACT,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO;QAClC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,UAAU;KAC9C,CAAC;AACJ,CAAC","sourcesContent":["/**\n * frontmcp.config.js/json schema and loader.\n */\n\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport { SetupDefinition } from './setup';\n\nexport interface FrontmcpExecConfig {\n  name: string;\n  version?: string;\n  entry?: string;\n  storage?: {\n    type: 'sqlite' | 'redis' | 'none';\n    required?: boolean;\n  };\n  network?: {\n    defaultPort?: number;\n    supportsSocket?: boolean;\n  };\n  dependencies?: {\n    system?: string[];\n    nativeAddons?: string[];\n  };\n  nodeVersion?: string;\n  esbuild?: {\n    external?: string[];\n    define?: Record<string, string>;\n    target?: string;\n    minify?: boolean;\n  };\n  setup?: SetupDefinition;\n}\n\nconst CONFIG_FILENAMES = [\n  'frontmcp.config.js',\n  'frontmcp.config.json',\n  'frontmcp.config.mjs',\n  'frontmcp.config.cjs',\n];\n\n/**\n * Load frontmcp.config.js/json from the given directory.\n * Falls back to deriving minimal config from package.json.\n */\nexport async function loadExecConfig(cwd: string): Promise<FrontmcpExecConfig> {\n  for (const filename of CONFIG_FILENAMES) {\n    const configPath = path.join(cwd, filename);\n    if (fs.existsSync(configPath)) {\n      if (filename.endsWith('.json')) {\n        const content = fs.readFileSync(configPath, 'utf-8');\n        return JSON.parse(content) as FrontmcpExecConfig;\n      }\n      // JS/MJS/CJS config — require it\n      // eslint-disable-next-line @typescript-eslint/no-require-imports\n      const mod = require(configPath);\n      return (mod.default || mod) as FrontmcpExecConfig;\n    }\n  }\n\n  // Fallback: derive from package.json\n  const pkgPath = path.join(cwd, 'package.json');\n  if (!fs.existsSync(pkgPath)) {\n    throw new Error(\n      'No frontmcp.config.js/json found and no package.json. Create a frontmcp.config.js to use --exec.',\n    );\n  }\n\n  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));\n  return {\n    name: pkg.name?.replace(/^@[^/]+\\//, '') || path.basename(cwd),\n    version: pkg.version || '1.0.0',\n    entry: pkg.main,\n  };\n}\n\n/**\n * Validate config and return normalized version.\n */\nexport function normalizeConfig(config: FrontmcpExecConfig): Required<\n  Pick<FrontmcpExecConfig, 'name' | 'version' | 'nodeVersion'>\n> &\n  FrontmcpExecConfig {\n  if (!config.name || !/^[a-zA-Z0-9._-]+$/.test(config.name)) {\n    throw new Error(\n      `Invalid app name: \"${config.name}\". Must be alphanumeric with .-_ only.`,\n    );\n  }\n\n  return {\n    ...config,\n    name: config.name,\n    version: config.version || '1.0.0',\n    nodeVersion: config.nodeVersion || '>=22.0.0',\n  };\n}\n"]}

package/src/commands/build/exec/esbuild-bundler.d.ts

@@ -0,0 +1,11 @@
+/**
+ * esbuild bundling for executable builds.
+ * Produces a single CJS file for distribution.
+ */
+import { FrontmcpExecConfig } from './config';
+export interface BundleResult {
+    bundlePath: string;
+    bundleSize: number;
+}
+export declare function bundleWithEsbuild(entryPath: string, outDir: string, config: FrontmcpExecConfig): Promise<BundleResult>;
+export declare function formatSize(bytes: number): string;

package/src/commands/build/exec/esbuild-bundler.js

@@ -0,0 +1,66 @@
+"use strict";
+/**
+ * esbuild bundling for executable builds.
+ * Produces a single CJS file for distribution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bundleWithEsbuild = bundleWithEsbuild;
+exports.formatSize = formatSize;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+// Default native addons that must be kept external
+const DEFAULT_EXTERNALS = [
+    'better-sqlite3',
+    'fsevents',
+    '@swc/core',
+    'esbuild',
+];
+async function bundleWithEsbuild(entryPath, outDir, config) {
+    // Lazy-load esbuild
+    let esbuild;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        esbuild = require('esbuild');
+    }
+    catch {
+        throw new Error('esbuild is required for --exec builds. Install it: npm install -D esbuild');
+    }
+    const bundleName = `${config.name}.bundle.js`;
+    const bundlePath = path.join(outDir, bundleName);
+    const external = [
+        ...DEFAULT_EXTERNALS,
+        ...(config.dependencies?.nativeAddons || []),
+        ...(config.esbuild?.external || []),
+    ];
+    await esbuild.build({
+        entryPoints: [entryPath],
+        bundle: true,
+        platform: 'node',
+        format: 'cjs',
+        target: config.esbuild?.target || 'node22',
+        outfile: bundlePath,
+        external,
+        keepNames: true, // preserve class names for decorator metadata
+        treeShaking: true,
+        minify: config.esbuild?.minify ?? false,
+        define: config.esbuild?.define,
+        sourcemap: false,
+        metafile: true,
+        logLevel: 'warning',
+    });
+    // Calculate bundle size
+    const fs = require('fs');
+    const stat = fs.statSync(bundlePath);
+    return {
+        bundlePath,
+        bundleSize: stat.size,
+    };
+}
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=esbuild-bundler.js.map

package/src/commands/build/exec/esbuild-bundler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild-bundler.js","sourceRoot":"","sources":["../../../../../src/commands/build/exec/esbuild-bundler.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAkBH,8CAkDC;AAED,gCAIC;;AAxED,mDAA6B;AAG7B,mDAAmD;AACnD,MAAM,iBAAiB,GAAG;IACxB,gBAAgB;IAChB,UAAU;IACV,WAAW;IACX,SAAS;CACV,CAAC;AAOK,KAAK,UAAU,iBAAiB,CACrC,SAAiB,EACjB,MAAc,EACd,MAA0B;IAE1B,oBAAoB;IACpB,IAAI,OAAiC,CAAC;IACtC,IAAI,CAAC;QACH,iEAAiE;QACjE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,GAAG,MAAM,CAAC,IAAI,YAAY,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAEjD,MAAM,QAAQ,GAAG;QACf,GAAG,iBAAiB;QACpB,GAAG,CAAC,MAAM,CAAC,YAAY,EAAE,YAAY,IAAI,EAAE,CAAC;QAC5C,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;KACpC,CAAC;IAEF,MAAM,OAAO,CAAC,KAAK,CAAC;QAClB,WAAW,EAAE,CAAC,SAAS,CAAC;QACxB,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,QAAQ;QAC1C,OAAO,EAAE,UAAU;QACnB,QAAQ;QACR,SAAS,EAAE,IAAI,EAAE,8CAA8C;QAC/D,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK;QACvC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM;QAC9B,SAAS,EAAE,KAAK;QAChB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,SAAS;KACpB,CAAC,CAAC;IAEH,wBAAwB;IACxB,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAErC,OAAO;QACL,UAAU;QACV,UAAU,EAAE,IAAI,CAAC,IAAI;KACtB,CAAC;AACJ,CAAC;AAED,SAAgB,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAClE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACpD,CAAC","sourcesContent":["/**\n * esbuild bundling for executable builds.\n * Produces a single CJS file for distribution.\n */\n\nimport * as path from 'path';\nimport { FrontmcpExecConfig } from './config';\n\n// Default native addons that must be kept external\nconst DEFAULT_EXTERNALS = [\n  'better-sqlite3',\n  'fsevents',\n  '@swc/core',\n  'esbuild',\n];\n\nexport interface BundleResult {\n  bundlePath: string;\n  bundleSize: number;\n}\n\nexport async function bundleWithEsbuild(\n  entryPath: string,\n  outDir: string,\n  config: FrontmcpExecConfig,\n): Promise<BundleResult> {\n  // Lazy-load esbuild\n  let esbuild: typeof import('esbuild');\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    esbuild = require('esbuild');\n  } catch {\n    throw new Error(\n      'esbuild is required for --exec builds. Install it: npm install -D esbuild',\n    );\n  }\n\n  const bundleName = `${config.name}.bundle.js`;\n  const bundlePath = path.join(outDir, bundleName);\n\n  const external = [\n    ...DEFAULT_EXTERNALS,\n    ...(config.dependencies?.nativeAddons || []),\n    ...(config.esbuild?.external || []),\n  ];\n\n  await esbuild.build({\n    entryPoints: [entryPath],\n    bundle: true,\n    platform: 'node',\n    format: 'cjs',\n    target: config.esbuild?.target || 'node22',\n    outfile: bundlePath,\n    external,\n    keepNames: true, // preserve class names for decorator metadata\n    treeShaking: true,\n    minify: config.esbuild?.minify ?? false,\n    define: config.esbuild?.define,\n    sourcemap: false,\n    metafile: true,\n    logLevel: 'warning',\n  });\n\n  // Calculate bundle size\n  const fs = require('fs');\n  const stat = fs.statSync(bundlePath);\n\n  return {\n    bundlePath,\n    bundleSize: stat.size,\n  };\n}\n\nexport function formatSize(bytes: number): string {\n  if (bytes < 1024) return `${bytes} B`;\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;\n  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;\n}\n"]}

package/src/commands/build/exec/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * buildExec() orchestrator — produces a distributable bundle from a FrontMCP app.
+ *
+ * Output:
+ *   dist/{name}.bundle.js       — esbuild single-file bundle
+ *   dist/{name}.manifest.json   — app metadata (runtime reqs, setup questions)
+ *   dist/{name}                 — bash runner script
+ *   dist/install-{name}.sh      — bash installer script
+ */
+import { ParsedArgs } from '../../../args';
+export declare function buildExec(opts: ParsedArgs): Promise<void>;