frontmcp 1.2.0 → 1.3.0

package/src/config/frontmcp-config.types.d.ts

@@ -268,6 +268,127 @@ export interface McpbDeployment extends DeploymentBase {
     deterministic?: boolean;
 }
 export type DeploymentTarget = NodeDeployment | DistributedDeployment | CliDeployment | VercelDeployment | LambdaDeployment | CloudflareDeployment | BrowserDeployment | SdkDeployment | McpbDeployment;
+/** Positional argument for a project-defined command. */
+export interface ProjectCommandArgument {
+    /** Argument name (kebab-case). Shown in --help. */
+    name: string;
+    /** Required (`<name>`) vs optional (`[name]`). @default false */
+    required?: boolean;
+    /** One-line description. */
+    description?: string;
+    /** Variadic (`<name...>`/`[name...]`). @default false */
+    variadic?: boolean;
+}
+/** Named option for a project-defined command. */
+export interface ProjectCommandOption {
+    /** Commander flag spec, e.g. `-f, --force` or `-p, --port <num>`. */
+    flags: string;
+    /** One-line description. */
+    description?: string;
+    /** Default value forwarded to Commander. */
+    default?: string | number | boolean;
+}
+/** A single project-defined CLI command. */
+export interface ProjectCommandEntry {
+    /** Path to the runner module (TS or JS), relative to project root. */
+    entry: string;
+    /** One-line description shown under "Project commands" in --help. */
+    description?: string;
+    /** Positional arguments. */
+    arguments?: ProjectCommandArgument[];
+    /** Named options. */
+    options?: ProjectCommandOption[];
+    /** Hide from --help. Verb is still invokable. @default false */
+    hidden?: boolean;
+}
+/** CLI extension block — see `cli.commands` in frontmcp.config. */
+export interface CliExtensionConfig {
+    /**
+     * Map of verb name → command definition. Verb names may include `:`,
+     * `_`, and `-` (e.g. `project:init`, `db-migrate`). Reserved verbs (the
+     * built-in ones) are rejected at config-load time.
+     */
+    commands?: Record<string, ProjectCommandEntry>;
+}
+/**
+ * Per-protocol defaults consumed by `dev` / `inspector` / `pm start` /
+ * `pm socket` so server-startup flags don't have to be re-typed on every
+ * CLI invocation.
+ */
+export interface TransportConfig {
+    /** Default protocol when no flag is set. */
+    default?: 'http' | 'sse' | 'stdio';
+    /** HTTP transport defaults — overridden by `--port` / per-deployment `server.http.port`. */
+    http?: {
+        /** Default HTTP port. */
+        port?: number;
+        /** Mount path (e.g., '/mcp'). */
+        path?: string;
+        /** Bind address. */
+        host?: string;
+    };
+    /** Stdio transport defaults — used by `inspector` to spawn the server. */
+    stdio?: {
+        command?: string;
+        args?: string[];
+    };
+}
+/**
+ * Top-level env overlays. `shared` applies everywhere; mode-specific
+ * overlays (`dev`, `test`, `ship`) are merged on top of `shared`.
+ *
+ * Effective env = `shared` ⊕ `<mode>` (later wins). `.env` / `.env.local`
+ * files still load and take precedence over config overlays (parity with
+ * existing `dev` behavior).
+ */
+export interface EnvOverlays {
+    shared?: Record<string, string>;
+    dev?: Record<string, string>;
+    test?: Record<string, string>;
+    ship?: Record<string, string>;
+}
+export type McpClientName = 'claude-code' | 'claude-desktop' | 'cursor' | 'windsurf' | 'vscode';
+export interface ClientConnection {
+    /** Display name. Defaults to the top-level `name` field. */
+    name?: string;
+    /** Transport protocol. */
+    transport: 'http' | 'sse' | 'stdio';
+    /** Spawn command (for `stdio` transport). */
+    command?: string;
+    /** Spawn args (for `stdio` transport). */
+    args?: string[];
+    /** Env vars to set on the spawned client. */
+    env?: Record<string, string>;
+    /** Server URL (for `http` / `sse` transport). */
+    url?: string;
+}
+/**
+ * Per-client connection descriptors consumed by `frontmcp eject-mcp-config
+ * <client>` to emit ready-to-paste `.mcp.json` /
+ * `claude_desktop_config.json` / Cursor / Windsurf / VS Code snippets.
+ */
+export type ClientsConfig = Partial<Record<McpClientName, ClientConnection>>;
+/**
+ * `frontmcp test` defaults. CLI flags (`--timeout`, `--runInBand`,
+ * `--coverage`, positional test patterns) override these.
+ */
+export interface TestConfig {
+    timeoutMs?: number;
+    runInBand?: boolean;
+    testMatch?: string[];
+    coverage?: boolean;
+}
+/**
+ * `frontmcp skills install` / `export` defaults. `install` is the list of
+ * catalog skill names a project depends on so `frontmcp skills install`
+ * with no arguments installs the curated set.
+ */
+export interface SkillsCliConfig {
+    provider?: 'claude' | 'codex';
+    bundle?: 'recommended' | 'minimal' | 'full' | 'none';
+    install?: string[];
+    exportTarget?: 'cursor' | 'windsurf' | 'copilot';
+}
 export interface FrontMcpConfig {
     /** JSON Schema pointer for IDE autocomplete. */
     $schema?: string;
@@ -283,5 +404,17 @@ export interface FrontMcpConfig {
     deployments: DeploymentTarget[];
     /** Build/bundler options. */
     build?: BuildOptions;
+    /** Project-defined CLI extensions (issue #409). */
+    cli?: CliExtensionConfig;
+    /** Transport defaults consumed by `dev` / `inspector` / `pm start` / `pm socket`. */
+    transport?: TransportConfig;
+    /** Env overlays merged in addition to `.env` / `.env.local`. */
+    env?: EnvOverlays;
+    /** Per-client snippets emitted by `frontmcp eject-mcp-config <client>`. */
+    clients?: ClientsConfig;
+    /** `frontmcp test` defaults overridden by CLI flags. */
+    test?: TestConfig;
+    /** `frontmcp skills install` / `export` defaults. */
+    skills?: SkillsCliConfig;
 }
 export {};

package/src/config/frontmcp-config.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontmcp-config.types.js","sourceRoot":"","sources":["../../../src/config/frontmcp-config.types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG","sourcesContent":["/**\n * FrontMCP Configuration Types\n *\n * Defines the unified deployment configuration schema.\n * Used by `frontmcp.config.(json|yml|js|ts)` files.\n *\n * Separation of concerns:\n * - frontmcp.config = deployment (targets, server defaults, cookies, CSP)\n * - @FrontMcp() = runtime (auth, tools, resources, transport)\n * - Environment variables = secrets/overrides (Redis password, API keys)\n */\n\n// ============================================\n// Server Defaults\n// ============================================\n\nexport interface CorsConfig {\n  /** Allowed origins. Empty array = permissive. */\n  origins?: string[];\n  /** Allow credentials (cookies, authorization headers). @default false */\n  credentials?: boolean;\n  /** Preflight cache max age in seconds. */\n  maxAge?: number;\n}\n\nexport interface CspConfig {\n  /** Enable CSP headers. @default false */\n  enabled?: boolean;\n  /** CSP directives (e.g., 'default-src': \"'self'\"). */\n  directives?: Record<string, string | string[]>;\n  /** Report URI for CSP violations. */\n  reportUri?: string;\n  /** Use Content-Security-Policy-Report-Only instead. @default false */\n  reportOnly?: boolean;\n}\n\nexport interface CookiesConfig {\n  /** LB affinity cookie name. @default '__frontmcp_node' */\n  affinity?: string;\n  /** Cookie domain. */\n  domain?: string;\n  /** SameSite policy. @default 'Strict' */\n  sameSite?: 'Strict' | 'Lax' | 'None';\n}\n\nexport interface SecurityHeadersConfig {\n  /** Strict-Transport-Security. Set to false to disable. */\n  hsts?: string | false;\n  /** X-Content-Type-Options. Set to false to disable. @default 'nosniff' */\n  contentTypeOptions?: string | false;\n  /** X-Frame-Options. Set to false to disable. @default 'DENY' */\n  frameOptions?: string | false;\n  /** Custom response headers. */\n  custom?: Record<string, string>;\n}\n\n/**\n * HTTP options — aligns with `@FrontMcp({ http })`.\n *\n * Available on targets that serve HTTP:\n * - node, distributed: full (port + cors)\n * - vercel, lambda, cloudflare: no port (platform-managed), but cors applies\n * - browser, sdk, cli: not available\n */\nexport interface HttpConfig {\n  /** HTTP port. Only for node/distributed. @default 3000 */\n  port?: number;\n  /** Unix socket path (alternative to port). Only for node/distributed. */\n  socketPath?: string;\n  /** MCP entry path ('' or '/mcp'). @default '' */\n  entryPath?: string;\n  /** CORS configuration. */\n  cors?: CorsConfig;\n}\n\n/**\n * Server-level options for targets that handle HTTP responses.\n * Separated from HttpConfig because these apply even to serverless\n * targets that don't control the port (Cloudflare, Vercel, Lambda).\n */\nexport interface ServerDefaults {\n  /** HTTP configuration (port, cors). */\n  http?: HttpConfig;\n  /** Content Security Policy. */\n  csp?: CspConfig;\n  /** Cookie configuration. */\n  cookies?: CookiesConfig;\n  /** Security headers. */\n  headers?: SecurityHeadersConfig;\n}\n\n// ============================================\n// Build Options\n// ============================================\n\nexport interface EsbuildOptions {\n  /** Dependencies to exclude from bundle. */\n  external?: string[];\n  /** Global defines. */\n  define?: Record<string, string>;\n  /** Build target (e.g., 'node22'). */\n  target?: string;\n  /** Minify output. */\n  minify?: boolean;\n}\n\nexport interface BuildOptions {\n  /** esbuild/bundler options. */\n  esbuild?: EsbuildOptions;\n  /** System/native dependencies for CLI packaging. */\n  dependencies?: {\n    system?: string[];\n    nativeAddons?: string[];\n  };\n  /** Storage type for CLI setup. */\n  storage?: {\n    type: 'sqlite' | 'redis' | 'none';\n    required?: boolean;\n  };\n  /** Network defaults. */\n  network?: {\n    defaultPort?: number;\n    supportsSocket?: boolean;\n  };\n}\n\n// ============================================\n// HA Configuration (distributed target only)\n// ============================================\n\nexport interface HaDeploymentConfig {\n  /** Heartbeat interval in ms. @default 10000 */\n  heartbeatIntervalMs?: number;\n  /** Heartbeat TTL in ms (should be 2-3x interval). @default 30000 */\n  heartbeatTtlMs?: number;\n  /** Grace period before claiming orphaned sessions. @default 5000 */\n  takeoverGracePeriodMs?: number;\n  /** Redis key prefix for HA keys. @default 'mcp:ha:' */\n  redisKeyPrefix?: string;\n}\n\n// ============================================\n// CLI Configuration (cli target only)\n// ============================================\n\nexport interface CliTargetConfig {\n  /** CLI description. */\n  description?: string;\n  /** Default output format. @default 'text' */\n  outputDefault?: 'text' | 'json';\n  /** Require authentication for CLI. */\n  authRequired?: boolean;\n  /** Tools to exclude from CLI. */\n  excludeTools?: string[];\n  /** OAuth configuration for CLI authentication. */\n  oauth?: {\n    serverUrl?: string;\n    clientId?: string;\n    defaultScope?: string;\n    portRange?: [number, number];\n  };\n}\n\n// ============================================\n// Wrangler Configuration (cloudflare target only)\n// ============================================\n\nexport interface WranglerConfig {\n  /** Worker name. */\n  name?: string;\n  /** Compatibility date. */\n  compatibilityDate?: string;\n}\n\n// ============================================\n// Deployment Targets\n// ============================================\n\nexport type DeploymentTargetType =\n  | 'node'\n  | 'distributed'\n  | 'cli'\n  | 'vercel'\n  | 'lambda'\n  | 'cloudflare'\n  | 'browser'\n  | 'sdk'\n  | 'mcpb';\n\ninterface DeploymentBase {\n  /** Deployment target type. */\n  target: DeploymentTargetType;\n  /** Output directory override. @default 'dist/{target}' */\n  outDir?: string;\n  /** Environment variables injected at build time. */\n  env?: Record<string, string>;\n}\n\nexport interface NodeDeployment extends DeploymentBase {\n  target: 'node';\n  /** Server config (http with port, csp, cookies, headers). */\n  server?: ServerDefaults;\n}\n\nexport interface DistributedDeployment extends DeploymentBase {\n  target: 'distributed';\n  /** Server config (http with port, csp, cookies, headers). */\n  server?: ServerDefaults;\n  /** HA configuration. */\n  ha?: HaDeploymentConfig;\n}\n\nexport interface CliDeployment extends DeploymentBase {\n  target: 'cli';\n  /** Output JS bundle instead of native binary. */\n  js?: boolean;\n  /** CLI-specific configuration. */\n  cli?: CliTargetConfig;\n  /** Single Executable Application settings. */\n  sea?: { enabled?: boolean };\n}\n\nexport interface VercelDeployment extends DeploymentBase {\n  target: 'vercel';\n  /** Server config (no port — platform-managed, but cors/csp/cookies apply). */\n  server?: ServerDefaults;\n}\n\nexport interface LambdaDeployment extends DeploymentBase {\n  target: 'lambda';\n  /** Server config (no port — platform-managed, but cors/csp/cookies apply). */\n  server?: ServerDefaults;\n}\n\nexport interface CloudflareDeployment extends DeploymentBase {\n  target: 'cloudflare';\n  /** Server config (no port — platform-managed, but cors/csp/cookies apply). */\n  server?: ServerDefaults;\n  /** Wrangler configuration. */\n  wrangler?: WranglerConfig;\n}\n\nexport interface BrowserDeployment extends DeploymentBase {\n  target: 'browser';\n  /** No server — browser bundles are client-side. */\n}\n\nexport interface SdkDeployment extends DeploymentBase {\n  target: 'sdk';\n  /** No server — SDK is a library. */\n}\n\n// ============================================\n// MCPB Deployment (MCP Bundle)\n// ============================================\n\nexport interface McpbAuthor {\n  name: string;\n  email?: string;\n  url?: string;\n}\n\nexport type McpbUserConfigType = 'string' | 'number' | 'boolean' | 'directory' | 'file';\n\nexport interface McpbUserConfigEntry {\n  type: McpbUserConfigType;\n  title: string;\n  description?: string;\n  required?: boolean;\n  default?: string | number | boolean;\n  multiple?: boolean;\n  sensitive?: boolean;\n  min?: number;\n  max?: number;\n}\n\nexport interface McpbCompatibility {\n  /** Semver range for Claude Desktop (e.g., \">=1.0.0\"). */\n  claude_desktop?: string;\n  /** Supported platforms. */\n  platforms?: Array<'darwin' | 'win32' | 'linux'>;\n  /** Runtime version constraints. */\n  runtimes?: {\n    node?: string;\n    python?: string;\n  };\n}\n\nexport type McpbRepository = string | { type: string; url: string };\n\nexport interface McpbDeployment extends DeploymentBase {\n  target: 'mcpb';\n  /** Human-friendly display name. */\n  displayName?: string;\n  /** Long markdown description. */\n  longDescription?: string;\n  /** Author object — overrides parsed package.json.author. */\n  author?: McpbAuthor;\n  /** SPDX license identifier — overrides package.json.license. */\n  license?: string;\n  /** Project homepage URL. */\n  homepage?: string;\n  /** Source repository. */\n  repository?: McpbRepository;\n  /** Documentation URL. */\n  documentation?: string;\n  /** Support URL (issues/contact). */\n  support?: string;\n  /** Path to icon (PNG) relative to project root. */\n  icon?: string;\n  /** Keywords for search. */\n  keywords?: string[];\n  /** Privacy policy URLs. */\n  privacyPolicies?: string[];\n  /** Runtime/platform compatibility constraints. */\n  compatibility?: McpbCompatibility;\n  /** User-configurable inputs (injected as env vars). */\n  userConfig?: Record<string, McpbUserConfigEntry>;\n  /** Single-executable binary integration. */\n  sea?: {\n    /** Build SEA binary for host platform. */\n    enabled?: boolean;\n    /** Directory of pre-built cross-platform SEA binaries to merge. */\n    mergeFrom?: string;\n  };\n  /** Include node_modules/ in archive (opt-in). */\n  includeNodeModules?: boolean;\n  /** Deterministic archive output. @default true */\n  deterministic?: boolean;\n}\n\nexport type DeploymentTarget =\n  | NodeDeployment\n  | DistributedDeployment\n  | CliDeployment\n  | VercelDeployment\n  | LambdaDeployment\n  | CloudflareDeployment\n  | BrowserDeployment\n  | SdkDeployment\n  | McpbDeployment;\n\n// ============================================\n// Top-Level Config\n// ============================================\n\nexport interface FrontMcpConfig {\n  /** JSON Schema pointer for IDE autocomplete. */\n  $schema?: string;\n  /** Server name (alphanumeric, .-_ allowed). */\n  name: string;\n  /** Server version (semver). @default '1.0.0' */\n  version?: string;\n  /** Entry point file path. */\n  entry?: string;\n  /** Node.js version requirement. @default '>=22.0.0' */\n  nodeVersion?: string;\n  /** Build targets — server config lives inside each target that needs it. */\n  deployments: DeploymentTarget[];\n  /** Build/bundler options. */\n  build?: BuildOptions;\n}\n"]}
+{"version":3,"file":"frontmcp-config.types.js","sourceRoot":"","sources":["../../../src/config/frontmcp-config.types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG","sourcesContent":["/**\n * FrontMCP Configuration Types\n *\n * Defines the unified deployment configuration schema.\n * Used by `frontmcp.config.(json|yml|js|ts)` files.\n *\n * Separation of concerns:\n * - frontmcp.config = deployment (targets, server defaults, cookies, CSP)\n * - @FrontMcp() = runtime (auth, tools, resources, transport)\n * - Environment variables = secrets/overrides (Redis password, API keys)\n */\n\n// ============================================\n// Server Defaults\n// ============================================\n\nexport interface CorsConfig {\n  /** Allowed origins. Empty array = permissive. */\n  origins?: string[];\n  /** Allow credentials (cookies, authorization headers). @default false */\n  credentials?: boolean;\n  /** Preflight cache max age in seconds. */\n  maxAge?: number;\n}\n\nexport interface CspConfig {\n  /** Enable CSP headers. @default false */\n  enabled?: boolean;\n  /** CSP directives (e.g., 'default-src': \"'self'\"). */\n  directives?: Record<string, string | string[]>;\n  /** Report URI for CSP violations. */\n  reportUri?: string;\n  /** Use Content-Security-Policy-Report-Only instead. @default false */\n  reportOnly?: boolean;\n}\n\nexport interface CookiesConfig {\n  /** LB affinity cookie name. @default '__frontmcp_node' */\n  affinity?: string;\n  /** Cookie domain. */\n  domain?: string;\n  /** SameSite policy. @default 'Strict' */\n  sameSite?: 'Strict' | 'Lax' | 'None';\n}\n\nexport interface SecurityHeadersConfig {\n  /** Strict-Transport-Security. Set to false to disable. */\n  hsts?: string | false;\n  /** X-Content-Type-Options. Set to false to disable. @default 'nosniff' */\n  contentTypeOptions?: string | false;\n  /** X-Frame-Options. Set to false to disable. @default 'DENY' */\n  frameOptions?: string | false;\n  /** Custom response headers. */\n  custom?: Record<string, string>;\n}\n\n/**\n * HTTP options — aligns with `@FrontMcp({ http })`.\n *\n * Available on targets that serve HTTP:\n * - node, distributed: full (port + cors)\n * - vercel, lambda, cloudflare: no port (platform-managed), but cors applies\n * - browser, sdk, cli: not available\n */\nexport interface HttpConfig {\n  /** HTTP port. Only for node/distributed. @default 3000 */\n  port?: number;\n  /** Unix socket path (alternative to port). Only for node/distributed. */\n  socketPath?: string;\n  /** MCP entry path ('' or '/mcp'). @default '' */\n  entryPath?: string;\n  /** CORS configuration. */\n  cors?: CorsConfig;\n}\n\n/**\n * Server-level options for targets that handle HTTP responses.\n * Separated from HttpConfig because these apply even to serverless\n * targets that don't control the port (Cloudflare, Vercel, Lambda).\n */\nexport interface ServerDefaults {\n  /** HTTP configuration (port, cors). */\n  http?: HttpConfig;\n  /** Content Security Policy. */\n  csp?: CspConfig;\n  /** Cookie configuration. */\n  cookies?: CookiesConfig;\n  /** Security headers. */\n  headers?: SecurityHeadersConfig;\n}\n\n// ============================================\n// Build Options\n// ============================================\n\nexport interface EsbuildOptions {\n  /** Dependencies to exclude from bundle. */\n  external?: string[];\n  /** Global defines. */\n  define?: Record<string, string>;\n  /** Build target (e.g., 'node22'). */\n  target?: string;\n  /** Minify output. */\n  minify?: boolean;\n}\n\nexport interface BuildOptions {\n  /** esbuild/bundler options. */\n  esbuild?: EsbuildOptions;\n  /** System/native dependencies for CLI packaging. */\n  dependencies?: {\n    system?: string[];\n    nativeAddons?: string[];\n  };\n  /** Storage type for CLI setup. */\n  storage?: {\n    type: 'sqlite' | 'redis' | 'none';\n    required?: boolean;\n  };\n  /** Network defaults. */\n  network?: {\n    defaultPort?: number;\n    supportsSocket?: boolean;\n  };\n}\n\n// ============================================\n// HA Configuration (distributed target only)\n// ============================================\n\nexport interface HaDeploymentConfig {\n  /** Heartbeat interval in ms. @default 10000 */\n  heartbeatIntervalMs?: number;\n  /** Heartbeat TTL in ms (should be 2-3x interval). @default 30000 */\n  heartbeatTtlMs?: number;\n  /** Grace period before claiming orphaned sessions. @default 5000 */\n  takeoverGracePeriodMs?: number;\n  /** Redis key prefix for HA keys. @default 'mcp:ha:' */\n  redisKeyPrefix?: string;\n}\n\n// ============================================\n// CLI Configuration (cli target only)\n// ============================================\n\nexport interface CliTargetConfig {\n  /** CLI description. */\n  description?: string;\n  /** Default output format. @default 'text' */\n  outputDefault?: 'text' | 'json';\n  /** Require authentication for CLI. */\n  authRequired?: boolean;\n  /** Tools to exclude from CLI. */\n  excludeTools?: string[];\n  /** OAuth configuration for CLI authentication. */\n  oauth?: {\n    serverUrl?: string;\n    clientId?: string;\n    defaultScope?: string;\n    portRange?: [number, number];\n  };\n}\n\n// ============================================\n// Wrangler Configuration (cloudflare target only)\n// ============================================\n\nexport interface WranglerConfig {\n  /** Worker name. */\n  name?: string;\n  /** Compatibility date. */\n  compatibilityDate?: string;\n}\n\n// ============================================\n// Deployment Targets\n// ============================================\n\nexport type DeploymentTargetType =\n  | 'node'\n  | 'distributed'\n  | 'cli'\n  | 'vercel'\n  | 'lambda'\n  | 'cloudflare'\n  | 'browser'\n  | 'sdk'\n  | 'mcpb';\n\ninterface DeploymentBase {\n  /** Deployment target type. */\n  target: DeploymentTargetType;\n  /** Output directory override. @default 'dist/{target}' */\n  outDir?: string;\n  /** Environment variables injected at build time. */\n  env?: Record<string, string>;\n}\n\nexport interface NodeDeployment extends DeploymentBase {\n  target: 'node';\n  /** Server config (http with port, csp, cookies, headers). */\n  server?: ServerDefaults;\n}\n\nexport interface DistributedDeployment extends DeploymentBase {\n  target: 'distributed';\n  /** Server config (http with port, csp, cookies, headers). */\n  server?: ServerDefaults;\n  /** HA configuration. */\n  ha?: HaDeploymentConfig;\n}\n\nexport interface CliDeployment extends DeploymentBase {\n  target: 'cli';\n  /** Output JS bundle instead of native binary. */\n  js?: boolean;\n  /** CLI-specific configuration. */\n  cli?: CliTargetConfig;\n  /** Single Executable Application settings. */\n  sea?: { enabled?: boolean };\n}\n\nexport interface VercelDeployment extends DeploymentBase {\n  target: 'vercel';\n  /** Server config (no port — platform-managed, but cors/csp/cookies apply). */\n  server?: ServerDefaults;\n}\n\nexport interface LambdaDeployment extends DeploymentBase {\n  target: 'lambda';\n  /** Server config (no port — platform-managed, but cors/csp/cookies apply). */\n  server?: ServerDefaults;\n}\n\nexport interface CloudflareDeployment extends DeploymentBase {\n  target: 'cloudflare';\n  /** Server config (no port — platform-managed, but cors/csp/cookies apply). */\n  server?: ServerDefaults;\n  /** Wrangler configuration. */\n  wrangler?: WranglerConfig;\n}\n\nexport interface BrowserDeployment extends DeploymentBase {\n  target: 'browser';\n  /** No server — browser bundles are client-side. */\n}\n\nexport interface SdkDeployment extends DeploymentBase {\n  target: 'sdk';\n  /** No server — SDK is a library. */\n}\n\n// ============================================\n// MCPB Deployment (MCP Bundle)\n// ============================================\n\nexport interface McpbAuthor {\n  name: string;\n  email?: string;\n  url?: string;\n}\n\nexport type McpbUserConfigType = 'string' | 'number' | 'boolean' | 'directory' | 'file';\n\nexport interface McpbUserConfigEntry {\n  type: McpbUserConfigType;\n  title: string;\n  description?: string;\n  required?: boolean;\n  default?: string | number | boolean;\n  multiple?: boolean;\n  sensitive?: boolean;\n  min?: number;\n  max?: number;\n}\n\nexport interface McpbCompatibility {\n  /** Semver range for Claude Desktop (e.g., \">=1.0.0\"). */\n  claude_desktop?: string;\n  /** Supported platforms. */\n  platforms?: Array<'darwin' | 'win32' | 'linux'>;\n  /** Runtime version constraints. */\n  runtimes?: {\n    node?: string;\n    python?: string;\n  };\n}\n\nexport type McpbRepository = string | { type: string; url: string };\n\nexport interface McpbDeployment extends DeploymentBase {\n  target: 'mcpb';\n  /** Human-friendly display name. */\n  displayName?: string;\n  /** Long markdown description. */\n  longDescription?: string;\n  /** Author object — overrides parsed package.json.author. */\n  author?: McpbAuthor;\n  /** SPDX license identifier — overrides package.json.license. */\n  license?: string;\n  /** Project homepage URL. */\n  homepage?: string;\n  /** Source repository. */\n  repository?: McpbRepository;\n  /** Documentation URL. */\n  documentation?: string;\n  /** Support URL (issues/contact). */\n  support?: string;\n  /** Path to icon (PNG) relative to project root. */\n  icon?: string;\n  /** Keywords for search. */\n  keywords?: string[];\n  /** Privacy policy URLs. */\n  privacyPolicies?: string[];\n  /** Runtime/platform compatibility constraints. */\n  compatibility?: McpbCompatibility;\n  /** User-configurable inputs (injected as env vars). */\n  userConfig?: Record<string, McpbUserConfigEntry>;\n  /** Single-executable binary integration. */\n  sea?: {\n    /** Build SEA binary for host platform. */\n    enabled?: boolean;\n    /** Directory of pre-built cross-platform SEA binaries to merge. */\n    mergeFrom?: string;\n  };\n  /** Include node_modules/ in archive (opt-in). */\n  includeNodeModules?: boolean;\n  /** Deterministic archive output. @default true */\n  deterministic?: boolean;\n}\n\nexport type DeploymentTarget =\n  | NodeDeployment\n  | DistributedDeployment\n  | CliDeployment\n  | VercelDeployment\n  | LambdaDeployment\n  | CloudflareDeployment\n  | BrowserDeployment\n  | SdkDeployment\n  | McpbDeployment;\n\n// ============================================\n// CLI extension (issue #409)\n// ============================================\n\n/** Positional argument for a project-defined command. */\nexport interface ProjectCommandArgument {\n  /** Argument name (kebab-case). Shown in --help. */\n  name: string;\n  /** Required (`<name>`) vs optional (`[name]`). @default false */\n  required?: boolean;\n  /** One-line description. */\n  description?: string;\n  /** Variadic (`<name...>`/`[name...]`). @default false */\n  variadic?: boolean;\n}\n\n/** Named option for a project-defined command. */\nexport interface ProjectCommandOption {\n  /** Commander flag spec, e.g. `-f, --force` or `-p, --port <num>`. */\n  flags: string;\n  /** One-line description. */\n  description?: string;\n  /** Default value forwarded to Commander. */\n  default?: string | number | boolean;\n}\n\n/** A single project-defined CLI command. */\nexport interface ProjectCommandEntry {\n  /** Path to the runner module (TS or JS), relative to project root. */\n  entry: string;\n  /** One-line description shown under \"Project commands\" in --help. */\n  description?: string;\n  /** Positional arguments. */\n  arguments?: ProjectCommandArgument[];\n  /** Named options. */\n  options?: ProjectCommandOption[];\n  /** Hide from --help. Verb is still invokable. @default false */\n  hidden?: boolean;\n}\n\n/** CLI extension block — see `cli.commands` in frontmcp.config. */\nexport interface CliExtensionConfig {\n  /**\n   * Map of verb name → command definition. Verb names may include `:`,\n   * `_`, and `-` (e.g. `project:init`, `db-migrate`). Reserved verbs (the\n   * built-in ones) are rejected at config-load time.\n   */\n  commands?: Record<string, ProjectCommandEntry>;\n}\n\n// ============================================\n// Top-Level Config\n// ============================================\n\n// ============================================\n// Transport defaults (issue #400)\n// ============================================\n\n/**\n * Per-protocol defaults consumed by `dev` / `inspector` / `pm start` /\n * `pm socket` so server-startup flags don't have to be re-typed on every\n * CLI invocation.\n */\nexport interface TransportConfig {\n  /** Default protocol when no flag is set. */\n  default?: 'http' | 'sse' | 'stdio';\n  /** HTTP transport defaults — overridden by `--port` / per-deployment `server.http.port`. */\n  http?: {\n    /** Default HTTP port. */\n    port?: number;\n    /** Mount path (e.g., '/mcp'). */\n    path?: string;\n    /** Bind address. */\n    host?: string;\n  };\n  /** Stdio transport defaults — used by `inspector` to spawn the server. */\n  stdio?: {\n    command?: string;\n    args?: string[];\n  };\n}\n\n// ============================================\n// Env overlays (issue #400)\n// ============================================\n\n/**\n * Top-level env overlays. `shared` applies everywhere; mode-specific\n * overlays (`dev`, `test`, `ship`) are merged on top of `shared`.\n *\n * Effective env = `shared` ⊕ `<mode>` (later wins). `.env` / `.env.local`\n * files still load and take precedence over config overlays (parity with\n * existing `dev` behavior).\n */\nexport interface EnvOverlays {\n  shared?: Record<string, string>;\n  dev?: Record<string, string>;\n  test?: Record<string, string>;\n  ship?: Record<string, string>;\n}\n\n// ============================================\n// MCP client connection snippets (issue #400)\n// ============================================\n\nexport type McpClientName = 'claude-code' | 'claude-desktop' | 'cursor' | 'windsurf' | 'vscode';\n\nexport interface ClientConnection {\n  /** Display name. Defaults to the top-level `name` field. */\n  name?: string;\n  /** Transport protocol. */\n  transport: 'http' | 'sse' | 'stdio';\n  /** Spawn command (for `stdio` transport). */\n  command?: string;\n  /** Spawn args (for `stdio` transport). */\n  args?: string[];\n  /** Env vars to set on the spawned client. */\n  env?: Record<string, string>;\n  /** Server URL (for `http` / `sse` transport). */\n  url?: string;\n}\n\n/**\n * Per-client connection descriptors consumed by `frontmcp eject-mcp-config\n * <client>` to emit ready-to-paste `.mcp.json` /\n * `claude_desktop_config.json` / Cursor / Windsurf / VS Code snippets.\n */\nexport type ClientsConfig = Partial<Record<McpClientName, ClientConnection>>;\n\n// ============================================\n// Test runner defaults (issue #400)\n// ============================================\n\n/**\n * `frontmcp test` defaults. CLI flags (`--timeout`, `--runInBand`,\n * `--coverage`, positional test patterns) override these.\n */\nexport interface TestConfig {\n  timeoutMs?: number;\n  runInBand?: boolean;\n  testMatch?: string[];\n  coverage?: boolean;\n}\n\n// ============================================\n// Skills install / export defaults (issue #400)\n// ============================================\n\n/**\n * `frontmcp skills install` / `export` defaults. `install` is the list of\n * catalog skill names a project depends on so `frontmcp skills install`\n * with no arguments installs the curated set.\n */\nexport interface SkillsCliConfig {\n  provider?: 'claude' | 'codex';\n  bundle?: 'recommended' | 'minimal' | 'full' | 'none';\n  install?: string[];\n  exportTarget?: 'cursor' | 'windsurf' | 'copilot';\n}\n\n// ============================================\n// Top-level config\n// ============================================\n\nexport interface FrontMcpConfig {\n  /** JSON Schema pointer for IDE autocomplete. */\n  $schema?: string;\n  /** Server name (alphanumeric, .-_ allowed). */\n  name: string;\n  /** Server version (semver). @default '1.0.0' */\n  version?: string;\n  /** Entry point file path. */\n  entry?: string;\n  /** Node.js version requirement. @default '>=22.0.0' */\n  nodeVersion?: string;\n  /** Build targets — server config lives inside each target that needs it. */\n  deployments: DeploymentTarget[];\n  /** Build/bundler options. */\n  build?: BuildOptions;\n  /** Project-defined CLI extensions (issue #409). */\n  cli?: CliExtensionConfig;\n\n  // Issue #400 — config drives every command, not just `build`\n  /** Transport defaults consumed by `dev` / `inspector` / `pm start` / `pm socket`. */\n  transport?: TransportConfig;\n  /** Env overlays merged in addition to `.env` / `.env.local`. */\n  env?: EnvOverlays;\n  /** Per-client snippets emitted by `frontmcp eject-mcp-config <client>`. */\n  clients?: ClientsConfig;\n  /** `frontmcp test` defaults overridden by CLI flags. */\n  test?: TestConfig;\n  /** `frontmcp skills install` / `export` defaults. */\n  skills?: SkillsCliConfig;\n}\n"]}

package/src/config/index.d.ts

@@ -2,4 +2,5 @@ export { defineConfig } from './define-config';
 export { loadFrontMcpConfig, tryLoadFrontMcpConfig, validateConfig, findDeployment, getDeploymentTargets, } from './frontmcp-config.loader';
 export { frontmcpConfigSchema } from './frontmcp-config.schema';
 export type { FrontMcpConfigParsed } from './frontmcp-config.schema';
-export type { FrontMcpConfig, ServerDefaults, DeploymentTarget, DeploymentTargetType } from './frontmcp-config.types';
+export type { ClientConnection, ClientsConfig, EnvOverlays, DeploymentTarget, DeploymentTargetType, FrontMcpConfig, McpClientName, ServerDefaults, SkillsCliConfig, TestConfig, TransportConfig, CliExtensionConfig, ProjectCommandEntry, ProjectCommandArgument, ProjectCommandOption, } from './frontmcp-config.types';
+export { resolveConfig, type ResolvedFrontMcpConfig, type ResolveConfigOptions, type ResolveMode, } from './frontmcp-config.resolve';

package/src/config/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.frontmcpConfigSchema = exports.getDeploymentTargets = exports.findDeployment = exports.validateConfig = exports.tryLoadFrontMcpConfig = exports.loadFrontMcpConfig = exports.defineConfig = void 0;
+exports.resolveConfig = exports.frontmcpConfigSchema = exports.getDeploymentTargets = exports.findDeployment = exports.validateConfig = exports.tryLoadFrontMcpConfig = exports.loadFrontMcpConfig = exports.defineConfig = void 0;
 var define_config_1 = require("./define-config");
 Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return define_config_1.defineConfig; } });
 var frontmcp_config_loader_1 = require("./frontmcp-config.loader");
@@ -11,4 +11,6 @@ Object.defineProperty(exports, "findDeployment", { enumerable: true, get: functi
 Object.defineProperty(exports, "getDeploymentTargets", { enumerable: true, get: function () { return frontmcp_config_loader_1.getDeploymentTargets; } });
 var frontmcp_config_schema_1 = require("./frontmcp-config.schema");
 Object.defineProperty(exports, "frontmcpConfigSchema", { enumerable: true, get: function () { return frontmcp_config_schema_1.frontmcpConfigSchema; } });
+var frontmcp_config_resolve_1 = require("./frontmcp-config.resolve");
+Object.defineProperty(exports, "resolveConfig", { enumerable: true, get: function () { return frontmcp_config_resolve_1.resolveConfig; } });
 //# sourceMappingURL=index.js.map

package/src/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":";;;AAAA,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,mEAMkC;AALhC,4HAAA,kBAAkB,OAAA;AAClB,+HAAA,qBAAqB,OAAA;AACrB,wHAAA,cAAc,OAAA;AACd,wHAAA,cAAc,OAAA;AACd,8HAAA,oBAAoB,OAAA;AAEtB,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA","sourcesContent":["export { defineConfig } from './define-config';\nexport {\n  loadFrontMcpConfig,\n  tryLoadFrontMcpConfig,\n  validateConfig,\n  findDeployment,\n  getDeploymentTargets,\n} from './frontmcp-config.loader';\nexport { frontmcpConfigSchema } from './frontmcp-config.schema';\nexport type { FrontMcpConfigParsed } from './frontmcp-config.schema';\nexport type { FrontMcpConfig, ServerDefaults, DeploymentTarget, DeploymentTargetType } from './frontmcp-config.types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":";;;AAAA,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,mEAMkC;AALhC,4HAAA,kBAAkB,OAAA;AAClB,+HAAA,qBAAqB,OAAA;AACrB,wHAAA,cAAc,OAAA;AACd,wHAAA,cAAc,OAAA;AACd,8HAAA,oBAAoB,OAAA;AAEtB,mEAAgE;AAAvD,8HAAA,oBAAoB,OAAA;AAmB7B,qEAKmC;AAJjC,wHAAA,aAAa,OAAA","sourcesContent":["export { defineConfig } from './define-config';\nexport {\n  loadFrontMcpConfig,\n  tryLoadFrontMcpConfig,\n  validateConfig,\n  findDeployment,\n  getDeploymentTargets,\n} from './frontmcp-config.loader';\nexport { frontmcpConfigSchema } from './frontmcp-config.schema';\nexport type { FrontMcpConfigParsed } from './frontmcp-config.schema';\nexport type {\n  ClientConnection,\n  ClientsConfig,\n  EnvOverlays,\n  DeploymentTarget,\n  DeploymentTargetType,\n  FrontMcpConfig,\n  McpClientName,\n  ServerDefaults,\n  SkillsCliConfig,\n  TestConfig,\n  TransportConfig,\n  CliExtensionConfig,\n  ProjectCommandEntry,\n  ProjectCommandArgument,\n  ProjectCommandOption,\n} from './frontmcp-config.types';\nexport {\n  resolveConfig,\n  type ResolvedFrontMcpConfig,\n  type ResolveConfigOptions,\n  type ResolveMode,\n} from './frontmcp-config.resolve';\n"]}

package/src/core/args.d.ts

@@ -35,8 +35,21 @@ export interface ParsedArgs {
     maxRestarts?: number;
     follow?: boolean;
     lines?: number;
+    autoPort?: boolean;
+    showConflict?: boolean;
     registry?: string;
     nx?: boolean;
+    stdio?: boolean;
+    serve?: boolean;
+    logFile?: string;
+    bufferSize?: number;
+    reloadDeadlineMs?: number;
+    config?: string;
+    out?: string;
+    dryRun?: boolean;
+    provider?: 'claude' | 'codex';
+    bundle?: 'recommended' | 'minimal' | 'full' | 'none';
+    exportTarget?: 'cursor' | 'windsurf' | 'copilot';
 }
 /**
  * @deprecated Use commander-based parsing via {@link createProgram} instead.

package/src/core/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/core/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  | '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' | 'distributed';\nexport type BuildTarget =\n  | 'cli'\n  | 'node'\n  | 'sdk'\n  | 'browser'\n  | 'cloudflare'\n  | 'vercel'\n  | 'lambda'\n  | 'distributed'\n  | 'mcpb';\n\nconst DEPLOYMENT_ADAPTERS: readonly DeploymentAdapter[] = ['node', 'vercel', 'lambda', 'cloudflare', 'distributed'];\nconst BUILD_TARGETS: readonly BuildTarget[] = [\n  'cli',\n  'node',\n  'sdk',\n  'browser',\n  'cloudflare',\n  'vercel',\n  'lambda',\n  'distributed',\n  'mcpb',\n];\n\nexport function isDeploymentAdapter(val: string): val is DeploymentAdapter {\n  return (DEPLOYMENT_ADAPTERS as readonly string[]).includes(val);\n}\n\nexport function isBuildTarget(val: string): val is BuildTarget {\n  return (BUILD_TARGETS as readonly string[]).includes(val);\n}\n\nexport type RedisSetupOption = 'docker' | 'existing' | 'none';\nexport type PackageManagerOption = 'npm' | 'yarn' | 'pnpm';\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  // Build --target flag (unified build target)\n  buildTarget?: BuildTarget;\n  // Build --js flag (cli target: produce JS bundle instead of SEA binary)\n  js?: boolean;\n  // MCPB flags\n  sea?: boolean;\n  mergeFrom?: string;\n  icon?: string;\n  noDeterministic?: boolean;\n  stageOnly?: boolean;\n  // Create command flags\n  yes?: boolean;\n  target?: DeploymentAdapter;\n  redis?: RedisSetupOption;\n  cicd?: boolean;\n  pm?: PackageManagerOption;\n  // Socket command flags\n  socket?: string;\n  db?: string;\n  background?: 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  // Create --nx flag\n  nx?: boolean;\n}\n\n/**\n * @deprecated Use commander-based parsing via {@link createProgram} instead.\n * Kept for backward compatibility and existing test coverage.\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 === '--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') {\n      const val = argv[++i];\n      if (isDeploymentAdapter(val)) out.target = val;\n      if (isBuildTarget(val)) out.buildTarget = val;\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 if (a === '--pm') out.pm = argv[++i] as PackageManagerOption;\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    else if (a === '--js') out.js = 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    // Create --nx flag\n    else if (a === '--nx') out.nx = true;\n    // Install flags\n    else if (a === '--registry') out.registry = argv[++i];\n    else out._.push(a);\n  }\n  return out;\n}\n"]}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/core/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  | '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' | 'distributed';\nexport type BuildTarget =\n  | 'cli'\n  | 'node'\n  | 'sdk'\n  | 'browser'\n  | 'cloudflare'\n  | 'vercel'\n  | 'lambda'\n  | 'distributed'\n  | 'mcpb';\n\nconst DEPLOYMENT_ADAPTERS: readonly DeploymentAdapter[] = ['node', 'vercel', 'lambda', 'cloudflare', 'distributed'];\nconst BUILD_TARGETS: readonly BuildTarget[] = [\n  'cli',\n  'node',\n  'sdk',\n  'browser',\n  'cloudflare',\n  'vercel',\n  'lambda',\n  'distributed',\n  'mcpb',\n];\n\nexport function isDeploymentAdapter(val: string): val is DeploymentAdapter {\n  return (DEPLOYMENT_ADAPTERS as readonly string[]).includes(val);\n}\n\nexport function isBuildTarget(val: string): val is BuildTarget {\n  return (BUILD_TARGETS as readonly string[]).includes(val);\n}\n\nexport type RedisSetupOption = 'docker' | 'existing' | 'none';\nexport type PackageManagerOption = 'npm' | 'yarn' | 'pnpm';\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  // Build --target flag (unified build target)\n  buildTarget?: BuildTarget;\n  // Build --js flag (cli target: produce JS bundle instead of SEA binary)\n  js?: boolean;\n  // MCPB flags\n  sea?: boolean;\n  mergeFrom?: string;\n  icon?: string;\n  noDeterministic?: boolean;\n  stageOnly?: boolean;\n  // Create command flags\n  yes?: boolean;\n  target?: DeploymentAdapter;\n  redis?: RedisSetupOption;\n  cicd?: boolean;\n  pm?: PackageManagerOption;\n  // Socket command flags\n  socket?: string;\n  db?: string;\n  background?: boolean;\n  // Process Manager flags\n  port?: number;\n  force?: boolean;\n  maxRestarts?: number;\n  follow?: boolean;\n  lines?: number;\n  // `frontmcp dev` flags (issue #398)\n  autoPort?: boolean;\n  showConflict?: boolean;\n  // Install flags\n  registry?: string;\n  // Create --nx flag\n  nx?: boolean;\n  // Issue #399 — `frontmcp dev` watch-aware stdio bridge\n  stdio?: boolean;\n  serve?: boolean;\n  logFile?: string;\n  bufferSize?: number;\n  reloadDeadlineMs?: number;\n  // Issue #400 — top-level config flag (forwarded from program.opts().config)\n  config?: string;\n  // Issue #400 — eject-mcp-config flags\n  out?: string;\n  dryRun?: boolean;\n  // Issue #400 — skills install / export defaults via config\n  provider?: 'claude' | 'codex';\n  bundle?: 'recommended' | 'minimal' | 'full' | 'none';\n  exportTarget?: 'cursor' | 'windsurf' | 'copilot';\n}\n\n/**\n * @deprecated Use commander-based parsing via {@link createProgram} instead.\n * Kept for backward compatibility and existing test coverage.\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 === '--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') {\n      const val = argv[++i];\n      if (isDeploymentAdapter(val)) out.target = val;\n      if (isBuildTarget(val)) out.buildTarget = val;\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 if (a === '--pm') out.pm = argv[++i] as PackageManagerOption;\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    else if (a === '--js') out.js = 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    // Create --nx flag\n    else if (a === '--nx') out.nx = true;\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/core/bridge.js

@@ -75,6 +75,45 @@ function toParsedArgs(commandName, positionalArgs, options) {
     // Package manager
     if (options['registry'] !== undefined)
         out.registry = options['registry'];
+    // Dev (issue #398): port conflict handling
+    if (options['autoPort'] !== undefined)
+        out.autoPort = options['autoPort'];
+    if (options['showConflict'] !== undefined)
+        out.showConflict = options['showConflict'];
+    // Dev (issue #399): watch-aware stdio bridge
+    if (options['stdio'] !== undefined)
+        out.stdio = options['stdio'];
+    if (options['serve'] !== undefined)
+        out.serve = options['serve'];
+    if (options['logFile'] !== undefined)
+        out.logFile = options['logFile'];
+    if (options['bufferSize'] !== undefined) {
+        out.bufferSize =
+            typeof options['bufferSize'] === 'number' ? options['bufferSize'] : parseInt(String(options['bufferSize']), 10);
+    }
+    if (options['reloadDeadlineMs'] !== undefined) {
+        out.reloadDeadlineMs =
+            typeof options['reloadDeadlineMs'] === 'number'
+                ? options['reloadDeadlineMs']
+                : parseInt(String(options['reloadDeadlineMs']), 10);
+    }
+    // Issue #400 — top-level --config flag forwarded from program.opts()
+    if (options['config'] !== undefined)
+        out.config = options['config'];
+    // Issue #400 — eject-mcp-config
+    if (options['out'] !== undefined)
+        out.out = options['out'];
+    if (options['dryRun'] !== undefined)
+        out.dryRun = options['dryRun'];
+    // Issue #400 — skills install/export defaults via config (still allow CLI override)
+    if (options['provider'] !== undefined)
+        out.provider = options['provider'];
+    if (options['bundle'] !== undefined) {
+        out.bundle = options['bundle'];
+    }
+    if (options['exportTarget'] !== undefined) {
+        out.exportTarget = options['exportTarget'];
+    }
     return out;
 }
 //# sourceMappingURL=bridge.js.map

package/src/core/bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../src/core/bridge.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type BuildTarget,\n  type DeploymentAdapter,\n  type PackageManagerOption,\n  type ParsedArgs,\n  type RedisSetupOption,\n} from './args';\n\n/**\n * Convert commander's parsed command name, positional arguments, and options\n * into the {@link ParsedArgs} shape expected by existing handlers.\n */\nexport function toParsedArgs(\n  commandName: string,\n  positionalArgs: string[],\n  options: Record<string, unknown>,\n): ParsedArgs {\n  const out: ParsedArgs = { _: [commandName, ...positionalArgs] };\n\n  // General\n  if (options['outDir'] !== undefined) out.outDir = options['outDir'] as string;\n  if (options['entry'] !== undefined) out.entry = options['entry'] as string;\n\n  // Build --target resolution\n  if (commandName === 'build') {\n    if (options['target'] !== undefined) out.buildTarget = options['target'] as BuildTarget;\n    if (options['js'] !== undefined) out.js = options['js'] as boolean;\n    if (options['sea'] !== undefined) out.sea = options['sea'] as boolean;\n    if (options['mergeFrom'] !== undefined) out.mergeFrom = options['mergeFrom'] as string;\n    if (options['icon'] !== undefined) out.icon = options['icon'] as string;\n    if (options['deterministic'] === false) out.noDeterministic = true;\n    if (options['stageOnly'] !== undefined) out.stageOnly = options['stageOnly'] as boolean;\n  }\n\n  // Create\n  if (options['yes'] !== undefined) out.yes = options['yes'] as boolean;\n  if (commandName === 'create' && options['target'] !== undefined) out.target = options['target'] as DeploymentAdapter;\n  if (options['redis'] !== undefined) out.redis = options['redis'] as RedisSetupOption;\n  if (options['cicd'] !== undefined) out.cicd = options['cicd'] as boolean;\n  if (options['pm'] !== undefined) out.pm = options['pm'] as PackageManagerOption;\n  if (options['nx'] !== undefined) out.nx = options['nx'] as boolean;\n\n  // Test\n  if (options['runInBand'] !== undefined) out.runInBand = options['runInBand'] as boolean;\n  if (options['watch'] !== undefined) out.watch = options['watch'] as boolean;\n  if (options['verbose'] !== undefined) out.verbose = options['verbose'] as boolean;\n  if (options['timeout'] !== undefined) out.timeout = options['timeout'] as number;\n  if (options['coverage'] !== undefined) out.coverage = options['coverage'] as boolean;\n\n  // PM - start / socket\n  if (options['port'] !== undefined) out.port = options['port'] as number;\n  if (options['socket'] !== undefined) out.socket = options['socket'] as string;\n  if (options['db'] !== undefined) out.db = options['db'] as string;\n  if (options['background'] !== undefined) out.background = options['background'] as boolean;\n  if (options['maxRestarts'] !== undefined) out.maxRestarts = options['maxRestarts'] as number;\n\n  // PM - stop\n  if (options['force'] !== undefined) out.force = options['force'] as boolean;\n\n  // PM - logs\n  if (options['follow'] !== undefined) out.follow = options['follow'] as boolean;\n  if (options['lines'] !== undefined) out.lines = options['lines'] as number;\n\n  // Package manager\n  if (options['registry'] !== undefined) out.registry = options['registry'] as string;\n\n  return out;\n}\n"]}
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../src/core/bridge.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type BuildTarget,\n  type DeploymentAdapter,\n  type PackageManagerOption,\n  type ParsedArgs,\n  type RedisSetupOption,\n} from './args';\n\n/**\n * Convert commander's parsed command name, positional arguments, and options\n * into the {@link ParsedArgs} shape expected by existing handlers.\n */\nexport function toParsedArgs(\n  commandName: string,\n  positionalArgs: string[],\n  options: Record<string, unknown>,\n): ParsedArgs {\n  const out: ParsedArgs = { _: [commandName, ...positionalArgs] };\n\n  // General\n  if (options['outDir'] !== undefined) out.outDir = options['outDir'] as string;\n  if (options['entry'] !== undefined) out.entry = options['entry'] as string;\n\n  // Build --target resolution\n  if (commandName === 'build') {\n    if (options['target'] !== undefined) out.buildTarget = options['target'] as BuildTarget;\n    if (options['js'] !== undefined) out.js = options['js'] as boolean;\n    if (options['sea'] !== undefined) out.sea = options['sea'] as boolean;\n    if (options['mergeFrom'] !== undefined) out.mergeFrom = options['mergeFrom'] as string;\n    if (options['icon'] !== undefined) out.icon = options['icon'] as string;\n    if (options['deterministic'] === false) out.noDeterministic = true;\n    if (options['stageOnly'] !== undefined) out.stageOnly = options['stageOnly'] as boolean;\n  }\n\n  // Create\n  if (options['yes'] !== undefined) out.yes = options['yes'] as boolean;\n  if (commandName === 'create' && options['target'] !== undefined) out.target = options['target'] as DeploymentAdapter;\n  if (options['redis'] !== undefined) out.redis = options['redis'] as RedisSetupOption;\n  if (options['cicd'] !== undefined) out.cicd = options['cicd'] as boolean;\n  if (options['pm'] !== undefined) out.pm = options['pm'] as PackageManagerOption;\n  if (options['nx'] !== undefined) out.nx = options['nx'] as boolean;\n\n  // Test\n  if (options['runInBand'] !== undefined) out.runInBand = options['runInBand'] as boolean;\n  if (options['watch'] !== undefined) out.watch = options['watch'] as boolean;\n  if (options['verbose'] !== undefined) out.verbose = options['verbose'] as boolean;\n  if (options['timeout'] !== undefined) out.timeout = options['timeout'] as number;\n  if (options['coverage'] !== undefined) out.coverage = options['coverage'] as boolean;\n\n  // PM - start / socket\n  if (options['port'] !== undefined) out.port = options['port'] as number;\n  if (options['socket'] !== undefined) out.socket = options['socket'] as string;\n  if (options['db'] !== undefined) out.db = options['db'] as string;\n  if (options['background'] !== undefined) out.background = options['background'] as boolean;\n  if (options['maxRestarts'] !== undefined) out.maxRestarts = options['maxRestarts'] as number;\n\n  // PM - stop\n  if (options['force'] !== undefined) out.force = options['force'] as boolean;\n\n  // PM - logs\n  if (options['follow'] !== undefined) out.follow = options['follow'] as boolean;\n  if (options['lines'] !== undefined) out.lines = options['lines'] as number;\n\n  // Package manager\n  if (options['registry'] !== undefined) out.registry = options['registry'] as string;\n\n  // Dev (issue #398): port conflict handling\n  if (options['autoPort'] !== undefined) out.autoPort = options['autoPort'] as boolean;\n  if (options['showConflict'] !== undefined) out.showConflict = options['showConflict'] as boolean;\n\n  // Dev (issue #399): watch-aware stdio bridge\n  if (options['stdio'] !== undefined) out.stdio = options['stdio'] as boolean;\n  if (options['serve'] !== undefined) out.serve = options['serve'] as boolean;\n  if (options['logFile'] !== undefined) out.logFile = options['logFile'] as string;\n  if (options['bufferSize'] !== undefined) {\n    out.bufferSize =\n      typeof options['bufferSize'] === 'number' ? options['bufferSize'] : parseInt(String(options['bufferSize']), 10);\n  }\n  if (options['reloadDeadlineMs'] !== undefined) {\n    out.reloadDeadlineMs =\n      typeof options['reloadDeadlineMs'] === 'number'\n        ? options['reloadDeadlineMs']\n        : parseInt(String(options['reloadDeadlineMs']), 10);\n  }\n\n  // Issue #400 — top-level --config flag forwarded from program.opts()\n  if (options['config'] !== undefined) out.config = options['config'] as string;\n  // Issue #400 — eject-mcp-config\n  if (options['out'] !== undefined) out.out = options['out'] as string;\n  if (options['dryRun'] !== undefined) out.dryRun = options['dryRun'] as boolean;\n  // Issue #400 — skills install/export defaults via config (still allow CLI override)\n  if (options['provider'] !== undefined) out.provider = options['provider'] as 'claude' | 'codex';\n  if (options['bundle'] !== undefined) {\n    out.bundle = options['bundle'] as 'recommended' | 'minimal' | 'full' | 'none';\n  }\n  if (options['exportTarget'] !== undefined) {\n    out.exportTarget = options['exportTarget'] as 'cursor' | 'windsurf' | 'copilot';\n  }\n\n  return out;\n}\n"]}

package/src/core/cli.d.ts

@@ -1,8 +1,2 @@
 #!/usr/bin/env node
-/**
- * frontmcp - FrontMCP command line interface
- *
- * Uses commander.js for argument parsing, command management, and
- * auto-generated help. Interactive TUI is handled by @clack/prompts.
- */
 export {};

package/src/core/cli.js

@@ -1,23 +1,43 @@
 #!/usr/bin/env node
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * frontmcp - FrontMCP command line interface
  *
  * Uses commander.js for argument parsing, command management, and
  * auto-generated help. Interactive TUI is handled by @clack/prompts.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-const program_1 = require("./program");
 const colors_1 = require("./colors");
+const program_1 = require("./program");
+const project_commands_1 = require("./project-commands");
 async function main() {
     try {
-        const program = (0, program_1.createProgram)();
+        const program = await (0, program_1.createProgram)();
+        // `--list-commands` is a top-level metadata flag. Only honor it when it
+        // appears BEFORE any verb token — otherwise `frontmcp my-tool --list-commands`
+        // would bypass the user's `my-tool` action.
+        const argv = process.argv.slice(2);
+        const firstVerbIdx = argv.findIndex((a) => !a.startsWith('-'));
+        const preVerb = firstVerbIdx === -1 ? argv : argv.slice(0, firstVerbIdx);
+        if (preVerb.includes('--list-commands')) {
+            for (const sub of program.commands) {
+                const tag = (0, project_commands_1.isProjectCommand)(sub) ? '[project]' : '[built-in]';
+                process.stdout.write(`${sub.name()}\t${tag}\t${sub.description() ?? ''}\n`);
+            }
+            setImmediate(() => process.exit(0));
+            return;
+        }
         await program.parseAsync(process.argv);
         // Defer process.exit() by one event-loop tick so native addon destructors
         // (ONNX runtime, etc.) can release mutexes before V8 tears down.
         setImmediate(() => process.exit(0));
     }
     catch (err) {
+        if (err instanceof project_commands_1.ProjectCommandFailedError) {
+            // The child already printed its own output via stdio:'inherit'; just
+            // exit with its code. Don't re-print a stack trace.
+            process.exit(err.exitCode);
+        }
         console.error('\n' + (0, colors_1.c)('red', err instanceof Error ? err.stack || err.message : String(err)));
         process.exit(1);
     }

package/src/core/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/core/cli.ts"],"names":[],"mappings":";;AACA;;;;;GAKG;;AAEH,uCAA0C;AAC1C,qCAA6B;AAE7B,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,uBAAa,GAAE,CAAC;QAChC,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,0EAA0E;QAC1E,iEAAiE;QACjE,YAAY,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,IAAA,UAAC,EAAC,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC","sourcesContent":["#!/usr/bin/env node\n/**\n * frontmcp - FrontMCP command line interface\n *\n * Uses commander.js for argument parsing, command management, and\n * auto-generated help. Interactive TUI is handled by @clack/prompts.\n */\n\nimport { createProgram } from './program';\nimport { c } from './colors';\n\nasync function main(): Promise<void> {\n  try {\n    const program = createProgram();\n    await program.parseAsync(process.argv);\n    // Defer process.exit() by one event-loop tick so native addon destructors\n    // (ONNX runtime, etc.) can release mutexes before V8 tears down.\n    setImmediate(() => process.exit(0));\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/core/cli.ts"],"names":[],"mappings":";;;AACA;;;;;GAKG;AACH,qCAA6B;AAC7B,uCAA0C;AAC1C,yDAAiF;AAEjF,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAA,uBAAa,GAAE,CAAC;QAEtC,wEAAwE;QACxE,+EAA+E;QAC/E,4CAA4C;QAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QACzE,IAAI,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACxC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACnC,MAAM,GAAG,GAAG,IAAA,mCAAgB,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;gBAC/D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YAC9E,CAAC;YACD,YAAY,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;QAED,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,0EAA0E;QAC1E,iEAAiE;QACjE,YAAY,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,GAAG,YAAY,4CAAyB,EAAE,CAAC;YAC7C,qEAAqE;YACrE,oDAAoD;YACpD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,IAAA,UAAC,EAAC,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC","sourcesContent":["#!/usr/bin/env node\n/**\n * frontmcp - FrontMCP command line interface\n *\n * Uses commander.js for argument parsing, command management, and\n * auto-generated help. Interactive TUI is handled by @clack/prompts.\n */\nimport { c } from './colors';\nimport { createProgram } from './program';\nimport { isProjectCommand, ProjectCommandFailedError } from './project-commands';\n\nasync function main(): Promise<void> {\n  try {\n    const program = await createProgram();\n\n    // `--list-commands` is a top-level metadata flag. Only honor it when it\n    // appears BEFORE any verb token — otherwise `frontmcp my-tool --list-commands`\n    // would bypass the user's `my-tool` action.\n    const argv = process.argv.slice(2);\n    const firstVerbIdx = argv.findIndex((a) => !a.startsWith('-'));\n    const preVerb = firstVerbIdx === -1 ? argv : argv.slice(0, firstVerbIdx);\n    if (preVerb.includes('--list-commands')) {\n      for (const sub of program.commands) {\n        const tag = isProjectCommand(sub) ? '[project]' : '[built-in]';\n        process.stdout.write(`${sub.name()}\\t${tag}\\t${sub.description() ?? ''}\\n`);\n      }\n      setImmediate(() => process.exit(0));\n      return;\n    }\n\n    await program.parseAsync(process.argv);\n    // Defer process.exit() by one event-loop tick so native addon destructors\n    // (ONNX runtime, etc.) can release mutexes before V8 tears down.\n    setImmediate(() => process.exit(0));\n  } catch (err: unknown) {\n    if (err instanceof ProjectCommandFailedError) {\n      // The child already printed its own output via stdio:'inherit'; just\n      // exit with its code. Don't re-print a stack trace.\n      process.exit(err.exitCode);\n    }\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/core/help.d.ts

@@ -1,4 +1,4 @@
-import { Command } from 'commander';
+import type { Command } from 'commander';
 /**
  * Apply custom help formatting to the top-level program so that
  * `frontmcp --help` groups commands under section headers, shows skills

package/src/core/help.js

@@ -2,6 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.customizeHelp = customizeHelp;
 const colors_1 = require("./colors");
+const project_commands_1 = require("./project-commands");
+// commander v13 exposes registered arguments on the private `_args` property.
+// Newer (v14+) versions expose `registeredArguments`; prefer that when present.
+function getArgs(cmd) {
+    const fromNewApi = cmd.registeredArguments;
+    if (fromNewApi)
+        return fromNewApi;
+    return (cmd._args ?? []);
+}
 /**
  * Command groups in display order, mapped to the command names they contain.
  * The `skills` group is handled separately to show subcommands inline.
@@ -22,22 +31,24 @@ const EXAMPLES = [
 ];
 /** Format a top-level command line with cyan name and dim arg placeholders. */
 function formatCommandLine(sub, padWidth) {
+    const argsList = getArgs(sub);
     const rawName = sub.name();
-    const rawArgs = sub.registeredArguments.map((a) => (a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');
+    const rawArgs = argsList.map((a) => (a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');
     const rawTerm = rawArgs ? `${rawName} ${rawArgs}` : rawName;
     const name = (0, colors_1.c)('cyan', rawName);
-    const args = sub.registeredArguments.map((a) => (0, colors_1.c)('dim', a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');
+    const args = argsList.map((a) => (0, colors_1.c)('dim', a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');
     const term = args ? `${name} ${args}` : name;
     const padding = ' '.repeat(Math.max(2, padWidth - rawTerm.length + 2));
     return `  ${term}${padding}${sub.description()}`;
 }
 /** Format a skills subcommand as "skills <subname> <args>". */
 function formatSkillsLine(sub, padWidth) {
+    const argsList = getArgs(sub);
     const rawPrefix = `skills ${sub.name()}`;
-    const rawArgs = sub.registeredArguments.map((a) => (a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');
+    const rawArgs = argsList.map((a) => (a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');
     const rawTerm = rawArgs ? `${rawPrefix} ${rawArgs}` : rawPrefix;
     const prefix = (0, colors_1.c)('cyan', rawPrefix);
-    const args = sub.registeredArguments.map((a) => (0, colors_1.c)('dim', a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');
+    const args = argsList.map((a) => (0, colors_1.c)('dim', a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');
     const term = args ? `${prefix} ${args}` : prefix;
     const padding = ' '.repeat(Math.max(2, padWidth - rawTerm.length + 2));
     return `  ${term}${padding}${sub.description()}`;
@@ -58,7 +69,7 @@ function customizeHelp(program) {
             const skillsSubs = skillsCmd ? helper.visibleCommands(skillsCmd) : [];
             if (skillsCmd) {
                 for (const sub of skillsSubs) {
-                    const rawArgs = sub.registeredArguments
+                    const rawArgs = getArgs(sub)
                         .map((a) => (a.required ? `<${a.name()}>` : `[${a.name()}]`))
                         .join(' ');
                     const rawTerm = rawArgs ? `skills ${sub.name()} ${rawArgs}` : `skills ${sub.name()}`;
@@ -91,9 +102,19 @@ function customizeHelp(program) {
                 }
                 lines.push('');
             }
+            // Project commands (registered via cli.commands in frontmcp.config).
+            // Hide commands marked with `hidden: true`.
+            const projectCommands = allCommands.filter((sc) => (0, project_commands_1.isProjectCommand)(sc) && !(0, project_commands_1.isCommandHidden)(sc));
+            if (projectCommands.length > 0) {
+                lines.push((0, colors_1.c)('bold', 'Project Commands'));
+                for (const sub of projectCommands) {
+                    lines.push(formatCommandLine(sub, termWidth));
+                }
+                lines.push('');
+            }
             // Other commands not in any group
             const renderedNames = new Set([...GROUPS.flatMap(([, names]) => names), 'skills']);
-            const other = allCommands.filter((sc) => !renderedNames.has(sc.name()));
+            const other = allCommands.filter((sc) => !renderedNames.has(sc.name()) && !(0, project_commands_1.isProjectCommand)(sc));
             if (other.length > 0) {
                 lines.push((0, colors_1.c)('bold', 'Other'));
                 for (const sub of other) {