frontmcp 1.2.0 → 1.3.0

package/src/core/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../src/core/help.ts"],"names":[],"mappings":"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","sourcesContent":["import { Command } from 'commander';\nimport { c } from './colors';\n\n/**\n * Command groups in display order, mapped to the command names they contain.\n * The `skills` group is handled separately to show subcommands inline.\n */\nconst GROUPS: [label: string, commands: string[]][] = [\n  ['Getting Started', ['create', 'init', 'doctor']],\n  ['Development', ['dev', 'build', 'test', 'inspector']],\n  ['Process Manager', ['start', 'stop', 'restart', 'status', 'list', 'logs', 'socket', 'service']],\n  ['Package Manager', ['install', 'uninstall', 'configure']],\n];\n\nconst EXAMPLES: string[] = [\n  'npx frontmcp create my-mcp              # Scaffold a new project',\n  'frontmcp dev                             # Start dev server with hot-reload',\n  'frontmcp build --target node             # Build for Node.js deployment',\n  'frontmcp start my-app --port 3005        # Start managed server',\n  'frontmcp install @company/my-mcp         # Install from npm registry',\n  'frontmcp skills search \"openapi\"         # Find skills in catalog',\n];\n\n/** Format a top-level command line with cyan name and dim arg placeholders. */\nfunction formatCommandLine(sub: Command, padWidth: number): string {\n  const rawName = sub.name();\n  const rawArgs = sub.registeredArguments.map((a) => (a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');\n  const rawTerm = rawArgs ? `${rawName} ${rawArgs}` : rawName;\n\n  const name = c('cyan', rawName);\n  const args = sub.registeredArguments.map((a) => c('dim', a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');\n  const term = args ? `${name} ${args}` : name;\n\n  const padding = ' '.repeat(Math.max(2, padWidth - rawTerm.length + 2));\n  return `  ${term}${padding}${sub.description()}`;\n}\n\n/** Format a skills subcommand as \"skills <subname> <args>\". */\nfunction formatSkillsLine(sub: Command, padWidth: number): string {\n  const rawPrefix = `skills ${sub.name()}`;\n  const rawArgs = sub.registeredArguments.map((a) => (a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');\n  const rawTerm = rawArgs ? `${rawPrefix} ${rawArgs}` : rawPrefix;\n\n  const prefix = c('cyan', rawPrefix);\n  const args = sub.registeredArguments.map((a) => c('dim', a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');\n  const term = args ? `${prefix} ${args}` : prefix;\n\n  const padding = ' '.repeat(Math.max(2, padWidth - rawTerm.length + 2));\n  return `  ${term}${padding}${sub.description()}`;\n}\n\n/**\n * Apply custom help formatting to the top-level program so that\n * `frontmcp --help` groups commands under section headers, shows skills\n * subcommands inline, and appends a concise Examples block.\n */\nexport function customizeHelp(program: Command): void {\n  program.configureHelp({\n    formatHelp(cmd, helper) {\n      let termWidth = helper.padWidth(cmd, helper);\n      const lines: string[] = [];\n\n      // Adjust padWidth to account for skills subcommand terms (e.g. \"skills search <query>\")\n      const allCommands = helper.visibleCommands(cmd);\n      const skillsCmd = allCommands.find((c) => c.name() === 'skills');\n      const skillsSubs = skillsCmd ? helper.visibleCommands(skillsCmd) : [];\n      if (skillsCmd) {\n        for (const sub of skillsSubs) {\n          const rawArgs = sub.registeredArguments\n            .map((a) => (a.required ? `<${a.name()}>` : `[${a.name()}]`))\n            .join(' ');\n          const rawTerm = rawArgs ? `skills ${sub.name()} ${rawArgs}` : `skills ${sub.name()}`;\n          termWidth = Math.max(termWidth, rawTerm.length);\n        }\n      }\n\n      // Description\n      const desc = helper.commandDescription(cmd);\n      if (desc) lines.push(desc, '');\n\n      // Usage\n      lines.push(c('bold', 'Usage'));\n      lines.push(`  ${helper.commandUsage(cmd)}`, '');\n\n      // Grouped commands\n      for (const [label, names] of GROUPS) {\n        const matching = names.map((n) => allCommands.find((c) => c.name() === n)).filter(Boolean) as Command[];\n        if (matching.length === 0) continue;\n\n        lines.push(c('bold', label));\n        for (const sub of matching) {\n          lines.push(formatCommandLine(sub, termWidth));\n        }\n        lines.push('');\n      }\n\n      // Skills — show subcommands inline\n      if (skillsCmd && skillsSubs.length > 0) {\n        lines.push(c('bold', 'Skills'));\n        for (const sub of skillsSubs) {\n          lines.push(formatSkillsLine(sub, termWidth));\n        }\n        lines.push('');\n      }\n\n      // Other commands not in any group\n      const renderedNames = new Set([...GROUPS.flatMap(([, names]) => names), 'skills']);\n      const other = allCommands.filter((sc) => !renderedNames.has(sc.name()));\n      if (other.length > 0) {\n        lines.push(c('bold', 'Other'));\n        for (const sub of other) {\n          lines.push(formatCommandLine(sub, termWidth));\n        }\n        lines.push('');\n      }\n\n      // Global options\n      const opts = helper.visibleOptions(cmd);\n      if (opts.length > 0) {\n        lines.push(c('bold', 'Options'));\n        for (const opt of opts) {\n          const term = helper.optionTerm(opt);\n          const padding = ' '.repeat(Math.max(2, termWidth - term.length + 2));\n          lines.push(`  ${term}${padding}${helper.optionDescription(opt)}`);\n        }\n        lines.push('');\n      }\n\n      return lines.join('\\n');\n    },\n  });\n\n  program.addHelpText('after', () => {\n    const lines = [\n      c('bold', 'Examples'),\n      ...EXAMPLES.map((ex) => `  ${ex}`),\n      '',\n      c('dim', `Use ${c('cyan', 'frontmcp <command> --help')} for detailed usage of any command.`),\n      '',\n    ];\n    return '\\n' + lines.join('\\n');\n  });\n}\n"]}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../src/core/help.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Command } from 'commander';\n\nimport { c } from './colors';\nimport { isCommandHidden, isProjectCommand } from './project-commands';\n\ninterface CommanderArgument {\n  name(): string;\n  required: boolean;\n}\n\n// commander v13 exposes registered arguments on the private `_args` property.\n// Newer (v14+) versions expose `registeredArguments`; prefer that when present.\nfunction getArgs(cmd: Command): CommanderArgument[] {\n  const fromNewApi = (cmd as unknown as { registeredArguments?: CommanderArgument[] }).registeredArguments;\n  if (fromNewApi) return fromNewApi;\n  return ((cmd as unknown as { _args?: CommanderArgument[] })._args ?? []) as CommanderArgument[];\n}\n\n/**\n * Command groups in display order, mapped to the command names they contain.\n * The `skills` group is handled separately to show subcommands inline.\n */\nconst GROUPS: [label: string, commands: string[]][] = [\n  ['Getting Started', ['create', 'init', 'doctor']],\n  ['Development', ['dev', 'build', 'test', 'inspector']],\n  ['Process Manager', ['start', 'stop', 'restart', 'status', 'list', 'logs', 'socket', 'service']],\n  ['Package Manager', ['install', 'uninstall', 'configure']],\n];\n\nconst EXAMPLES: string[] = [\n  'npx frontmcp create my-mcp              # Scaffold a new project',\n  'frontmcp dev                             # Start dev server with hot-reload',\n  'frontmcp build --target node             # Build for Node.js deployment',\n  'frontmcp start my-app --port 3005        # Start managed server',\n  'frontmcp install @company/my-mcp         # Install from npm registry',\n  'frontmcp skills search \"openapi\"         # Find skills in catalog',\n];\n\n/** Format a top-level command line with cyan name and dim arg placeholders. */\nfunction formatCommandLine(sub: Command, padWidth: number): string {\n  const argsList = getArgs(sub);\n  const rawName = sub.name();\n  const rawArgs = argsList.map((a) => (a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');\n  const rawTerm = rawArgs ? `${rawName} ${rawArgs}` : rawName;\n\n  const name = c('cyan', rawName);\n  const args = argsList.map((a) => c('dim', a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');\n  const term = args ? `${name} ${args}` : name;\n\n  const padding = ' '.repeat(Math.max(2, padWidth - rawTerm.length + 2));\n  return `  ${term}${padding}${sub.description()}`;\n}\n\n/** Format a skills subcommand as \"skills <subname> <args>\". */\nfunction formatSkillsLine(sub: Command, padWidth: number): string {\n  const argsList = getArgs(sub);\n  const rawPrefix = `skills ${sub.name()}`;\n  const rawArgs = argsList.map((a) => (a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');\n  const rawTerm = rawArgs ? `${rawPrefix} ${rawArgs}` : rawPrefix;\n\n  const prefix = c('cyan', rawPrefix);\n  const args = argsList.map((a) => c('dim', a.required ? `<${a.name()}>` : `[${a.name()}]`)).join(' ');\n  const term = args ? `${prefix} ${args}` : prefix;\n\n  const padding = ' '.repeat(Math.max(2, padWidth - rawTerm.length + 2));\n  return `  ${term}${padding}${sub.description()}`;\n}\n\n/**\n * Apply custom help formatting to the top-level program so that\n * `frontmcp --help` groups commands under section headers, shows skills\n * subcommands inline, and appends a concise Examples block.\n */\nexport function customizeHelp(program: Command): void {\n  program.configureHelp({\n    formatHelp(cmd, helper) {\n      let termWidth = helper.padWidth(cmd, helper);\n      const lines: string[] = [];\n\n      // Adjust padWidth to account for skills subcommand terms (e.g. \"skills search <query>\")\n      const allCommands = helper.visibleCommands(cmd);\n      const skillsCmd = allCommands.find((c) => c.name() === 'skills');\n      const skillsSubs = skillsCmd ? helper.visibleCommands(skillsCmd) : [];\n      if (skillsCmd) {\n        for (const sub of skillsSubs) {\n          const rawArgs = getArgs(sub)\n            .map((a) => (a.required ? `<${a.name()}>` : `[${a.name()}]`))\n            .join(' ');\n          const rawTerm = rawArgs ? `skills ${sub.name()} ${rawArgs}` : `skills ${sub.name()}`;\n          termWidth = Math.max(termWidth, rawTerm.length);\n        }\n      }\n\n      // Description\n      const desc = helper.commandDescription(cmd);\n      if (desc) lines.push(desc, '');\n\n      // Usage\n      lines.push(c('bold', 'Usage'));\n      lines.push(`  ${helper.commandUsage(cmd)}`, '');\n\n      // Grouped commands\n      for (const [label, names] of GROUPS) {\n        const matching = names.map((n) => allCommands.find((c) => c.name() === n)).filter(Boolean) as Command[];\n        if (matching.length === 0) continue;\n\n        lines.push(c('bold', label));\n        for (const sub of matching) {\n          lines.push(formatCommandLine(sub, termWidth));\n        }\n        lines.push('');\n      }\n\n      // Skills — show subcommands inline\n      if (skillsCmd && skillsSubs.length > 0) {\n        lines.push(c('bold', 'Skills'));\n        for (const sub of skillsSubs) {\n          lines.push(formatSkillsLine(sub, termWidth));\n        }\n        lines.push('');\n      }\n\n      // Project commands (registered via cli.commands in frontmcp.config).\n      // Hide commands marked with `hidden: true`.\n      const projectCommands = allCommands.filter((sc) => isProjectCommand(sc) && !isCommandHidden(sc));\n      if (projectCommands.length > 0) {\n        lines.push(c('bold', 'Project Commands'));\n        for (const sub of projectCommands) {\n          lines.push(formatCommandLine(sub, termWidth));\n        }\n        lines.push('');\n      }\n\n      // Other commands not in any group\n      const renderedNames = new Set([...GROUPS.flatMap(([, names]) => names), 'skills']);\n      const other = allCommands.filter((sc) => !renderedNames.has(sc.name()) && !isProjectCommand(sc));\n      if (other.length > 0) {\n        lines.push(c('bold', 'Other'));\n        for (const sub of other) {\n          lines.push(formatCommandLine(sub, termWidth));\n        }\n        lines.push('');\n      }\n\n      // Global options\n      const opts = helper.visibleOptions(cmd);\n      if (opts.length > 0) {\n        lines.push(c('bold', 'Options'));\n        for (const opt of opts) {\n          const term = helper.optionTerm(opt);\n          const padding = ' '.repeat(Math.max(2, termWidth - term.length + 2));\n          lines.push(`  ${term}${padding}${helper.optionDescription(opt)}`);\n        }\n        lines.push('');\n      }\n\n      return lines.join('\\n');\n    },\n  });\n\n  program.addHelpText('after', () => {\n    const lines = [\n      c('bold', 'Examples'),\n      ...EXAMPLES.map((ex) => `  ${ex}`),\n      '',\n      c('dim', `Use ${c('cyan', 'frontmcp <command> --help')} for detailed usage of any command.`),\n      '',\n    ];\n    return '\\n' + lines.join('\\n');\n  });\n}\n"]}

package/src/core/program.d.ts

@@ -1,2 +1,2 @@
 import { Command } from 'commander';
-export declare function createProgram(): Command;
+export declare function createProgram(cwd?: string, argv?: string[]): Promise<Command>;

package/src/core/program.js

@@ -4,26 +4,70 @@ exports.createProgram = createProgram;
 const commander_1 = require("commander");
 const register_1 = require("../commands/build/register");
 const register_2 = require("../commands/dev/register");
-const register_3 = require("../commands/mcpb/register");
-const register_4 = require("../commands/package/register");
-const register_5 = require("../commands/pm/register");
-const register_6 = require("../commands/scaffold/register");
-const register_7 = require("../commands/skills/register");
+const register_3 = require("../commands/eject/register");
+const register_4 = require("../commands/install/register");
+const register_5 = require("../commands/mcpb/register");
+const register_6 = require("../commands/package/register");
+const register_7 = require("../commands/pm/register");
+const register_8 = require("../commands/scaffold/register");
+const register_9 = require("../commands/skills/register");
 const help_1 = require("./help");
+const project_commands_1 = require("./project-commands");
 const version_1 = require("./version");
-function createProgram() {
+/**
+ * Skip project-command registration for invocations that only print the
+ * package version (`frontmcp --version` / `-V`) — those don't need the
+ * config-load cost.
+ *
+ * Bare `frontmcp` and `frontmcp --help` / `-h` DO need the load: both
+ * render the help banner, which must include project verbs registered
+ * via `cli.commands` (issue #409). `--list-commands` also needs the
+ * load — that's the whole point of the flag.
+ */
+function shouldSkipProjectCommandLoad(argv) {
+    const args = argv.slice(2);
+    // Bare `frontmcp` shows the help banner → must include project verbs.
+    if (args.length === 0)
+        return false;
+    const firstVerbIdx = args.findIndex((a) => !a.startsWith('-'));
+    if (firstVerbIdx !== -1)
+        return false;
+    // No verb token — pure flag invocation. `--list-commands` and the
+    // help flags all render output that must include project verbs.
+    if (args.includes('--list-commands'))
+        return false;
+    if (args.includes('--help') || args.includes('-h'))
+        return false;
+    // What's left is --version / -V (or any pure metadata flag that
+    // doesn't render the verb listing). Skip the project-command load.
+    const metadataFlags = new Set(['--version', '-V']);
+    return args.every((a) => metadataFlags.has(a));
+}
+async function createProgram(cwd = process.cwd(), argv = process.argv) {
     const program = new commander_1.Command();
     program
         .name('frontmcp')
         .description('Build, test, and deploy MCP servers with FrontMCP')
-        .version((0, version_1.getSelfVersion)(), '-V, --version');
+        .version((0, version_1.getSelfVersion)(), '-V, --version')
+        .option('--list-commands', 'List every registered verb (built-in + project) and exit')
+        // Issue #400 — top-level `--config <path>` option. Commands that
+        // consume the unified config (dev, test, inspector, eject, pm, skills) read
+        // `program.opts().config` (or `FRONTMCP_CONFIG` env) to locate the
+        // file. Override precedence:
+        //   explicit --config > FRONTMCP_CONFIG > upward walk from cwd
+        .option('-c, --config <path>', 'Path to frontmcp.config file (overrides upward search and FRONTMCP_CONFIG env)');
     (0, register_2.registerDevCommands)(program);
     (0, register_1.registerBuildCommands)(program);
-    (0, register_6.registerScaffoldCommands)(program);
-    (0, register_5.registerPmCommands)(program);
-    (0, register_4.registerPackageCommands)(program);
-    (0, register_7.registerSkillsCommands)(program);
-    (0, register_3.registerMcpbCommands)(program);
+    (0, register_8.registerScaffoldCommands)(program);
+    (0, register_7.registerPmCommands)(program);
+    (0, register_6.registerPackageCommands)(program);
+    (0, register_9.registerSkillsCommands)(program);
+    (0, register_5.registerMcpbCommands)(program);
+    (0, register_3.registerEjectCommands)(program);
+    (0, register_4.registerInstallCommands)(program);
+    if (!shouldSkipProjectCommandLoad(argv)) {
+        await (0, project_commands_1.registerProjectCommands)(program, cwd);
+    }
     (0, help_1.customizeHelp)(program);
     return program;
 }

package/src/core/program.js.map

@@ -1 +1 @@
-{"version":3,"file":"program.js","sourceRoot":"","sources":["../../../src/core/program.ts"],"names":[],"mappings":";;AAYA,sCAkBC;AA9BD,yCAAoC;AAEpC,yDAAmE;AACnE,uDAA+D;AAC/D,wDAAiE;AACjE,2DAAuE;AACvE,sDAA6D;AAC7D,4DAAyE;AACzE,0DAAqE;AACrE,iCAAuC;AACvC,uCAA2C;AAE3C,SAAgB,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,UAAU,CAAC;SAChB,WAAW,CAAC,mDAAmD,CAAC;SAChE,OAAO,CAAC,IAAA,wBAAc,GAAE,EAAE,eAAe,CAAC,CAAC;IAE9C,IAAA,8BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,gCAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,mCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,6BAAkB,EAAC,OAAO,CAAC,CAAC;IAC5B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,iCAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,+BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,oBAAa,EAAC,OAAO,CAAC,CAAC;IAEvB,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { Command } from 'commander';\n\nimport { registerBuildCommands } from '../commands/build/register';\nimport { registerDevCommands } from '../commands/dev/register';\nimport { registerMcpbCommands } from '../commands/mcpb/register';\nimport { registerPackageCommands } from '../commands/package/register';\nimport { registerPmCommands } from '../commands/pm/register';\nimport { registerScaffoldCommands } from '../commands/scaffold/register';\nimport { registerSkillsCommands } from '../commands/skills/register';\nimport { customizeHelp } from './help';\nimport { getSelfVersion } from './version';\n\nexport function createProgram(): Command {\n  const program = new Command();\n\n  program\n    .name('frontmcp')\n    .description('Build, test, and deploy MCP servers with FrontMCP')\n    .version(getSelfVersion(), '-V, --version');\n\n  registerDevCommands(program);\n  registerBuildCommands(program);\n  registerScaffoldCommands(program);\n  registerPmCommands(program);\n  registerPackageCommands(program);\n  registerSkillsCommands(program);\n  registerMcpbCommands(program);\n  customizeHelp(program);\n\n  return program;\n}\n"]}
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../../../src/core/program.ts"],"names":[],"mappings":";;AAyCA,sCAgCC;AAzED,yCAAoC;AAEpC,yDAAmE;AACnE,uDAA+D;AAC/D,yDAAmE;AACnE,2DAAuE;AACvE,wDAAiE;AACjE,2DAAuE;AACvE,sDAA6D;AAC7D,4DAAyE;AACzE,0DAAqE;AACrE,iCAAuC;AACvC,yDAA6D;AAC7D,uCAA2C;AAE3C;;;;;;;;;GASG;AACH,SAAS,4BAA4B,CAAC,IAAc;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,sEAAsE;IACtE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,IAAI,YAAY,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACtC,kEAAkE;IAClE,gEAAgE;IAChE,IAAI,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACjE,gEAAgE;IAChE,mEAAmE;IACnE,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAEM,KAAK,UAAU,aAAa,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE,EAAE,OAAiB,OAAO,CAAC,IAAI;IAC5F,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,UAAU,CAAC;SAChB,WAAW,CAAC,mDAAmD,CAAC;SAChE,OAAO,CAAC,IAAA,wBAAc,GAAE,EAAE,eAAe,CAAC;SAC1C,MAAM,CAAC,iBAAiB,EAAE,0DAA0D,CAAC;QACtF,iEAAiE;QACjE,4EAA4E;QAC5E,mEAAmE;QACnE,6BAA6B;QAC7B,+DAA+D;SAC9D,MAAM,CAAC,qBAAqB,EAAE,gFAAgF,CAAC,CAAC;IAEnH,IAAA,8BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,gCAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,mCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,6BAAkB,EAAC,OAAO,CAAC,CAAC;IAC5B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,iCAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,+BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,gCAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IAEjC,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAA,0CAAuB,EAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;IAED,IAAA,oBAAa,EAAC,OAAO,CAAC,CAAC;IAEvB,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { Command } from 'commander';\n\nimport { registerBuildCommands } from '../commands/build/register';\nimport { registerDevCommands } from '../commands/dev/register';\nimport { registerEjectCommands } from '../commands/eject/register';\nimport { registerInstallCommands } from '../commands/install/register';\nimport { registerMcpbCommands } from '../commands/mcpb/register';\nimport { registerPackageCommands } from '../commands/package/register';\nimport { registerPmCommands } from '../commands/pm/register';\nimport { registerScaffoldCommands } from '../commands/scaffold/register';\nimport { registerSkillsCommands } from '../commands/skills/register';\nimport { customizeHelp } from './help';\nimport { registerProjectCommands } from './project-commands';\nimport { getSelfVersion } from './version';\n\n/**\n * Skip project-command registration for invocations that only print the\n * package version (`frontmcp --version` / `-V`) — those don't need the\n * config-load cost.\n *\n * Bare `frontmcp` and `frontmcp --help` / `-h` DO need the load: both\n * render the help banner, which must include project verbs registered\n * via `cli.commands` (issue #409). `--list-commands` also needs the\n * load — that's the whole point of the flag.\n */\nfunction shouldSkipProjectCommandLoad(argv: string[]): boolean {\n  const args = argv.slice(2);\n  // Bare `frontmcp` shows the help banner → must include project verbs.\n  if (args.length === 0) return false;\n  const firstVerbIdx = args.findIndex((a) => !a.startsWith('-'));\n  if (firstVerbIdx !== -1) return false;\n  // No verb token — pure flag invocation. `--list-commands` and the\n  // help flags all render output that must include project verbs.\n  if (args.includes('--list-commands')) return false;\n  if (args.includes('--help') || args.includes('-h')) return false;\n  // What's left is --version / -V (or any pure metadata flag that\n  // doesn't render the verb listing). Skip the project-command load.\n  const metadataFlags = new Set(['--version', '-V']);\n  return args.every((a) => metadataFlags.has(a));\n}\n\nexport async function createProgram(cwd: string = process.cwd(), argv: string[] = process.argv): Promise<Command> {\n  const program = new Command();\n\n  program\n    .name('frontmcp')\n    .description('Build, test, and deploy MCP servers with FrontMCP')\n    .version(getSelfVersion(), '-V, --version')\n    .option('--list-commands', 'List every registered verb (built-in + project) and exit')\n    // Issue #400 — top-level `--config <path>` option. Commands that\n    // consume the unified config (dev, test, inspector, eject, pm, skills) read\n    // `program.opts().config` (or `FRONTMCP_CONFIG` env) to locate the\n    // file. Override precedence:\n    //   explicit --config > FRONTMCP_CONFIG > upward walk from cwd\n    .option('-c, --config <path>', 'Path to frontmcp.config file (overrides upward search and FRONTMCP_CONFIG env)');\n\n  registerDevCommands(program);\n  registerBuildCommands(program);\n  registerScaffoldCommands(program);\n  registerPmCommands(program);\n  registerPackageCommands(program);\n  registerSkillsCommands(program);\n  registerMcpbCommands(program);\n  registerEjectCommands(program);\n  registerInstallCommands(program);\n\n  if (!shouldSkipProjectCommandLoad(argv)) {\n    await registerProjectCommands(program, cwd);\n  }\n\n  customizeHelp(program);\n\n  return program;\n}\n"]}

package/src/core/project-commands.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Project-defined CLI commands (issue #409).
+ *
+ * Reads `cli.commands` from the project's frontmcp.config and registers
+ * each entry as a top-level Commander verb. The runner is spawned as a
+ * child process (tsx for `.ts` entries, node for `.js`/`.mjs`/`.cjs`).
+ *
+ * Failure to load the config is non-fatal: project commands are an
+ * optional layer on top of the built-in CLI, so a missing/broken config
+ * just yields zero project commands and never blocks `frontmcp --help`.
+ */
+import type { Command } from 'commander';
+import type { ProjectCommandEntry, ProjectCommandOption } from '../config/frontmcp-config.types';
+interface ProjectCommandRecord {
+    readonly verb: string;
+    readonly entry: ProjectCommandEntry;
+    readonly cwd: string;
+}
+/** Thrown when a dispatched runner exits non-zero or by signal. cli.ts uses
+ * the exit code without printing the stack again. */
+export declare class ProjectCommandFailedError extends Error {
+    readonly verb: string;
+    readonly exitCode: number;
+    readonly signal: NodeJS.Signals | null;
+    constructor(verb: string, exitCode: number, signal: NodeJS.Signals | null);
+}
+/**
+ * Load `cli.commands` from `frontmcp.config` (in `cwd`) and attach each as
+ * a top-level command on the program. No-op if no config is found.
+ */
+export declare function registerProjectCommands(program: Command, cwd?: string): Promise<void>;
+/**
+ * Spawn the project entry file as a child process and forward stdio. The
+ * child receives positionals as argv plus a `FRONTMCP_PROJECT_COMMAND` env
+ * var with the full payload (verb, positionals, options, cwd) so the runner
+ * can reconstruct context without re-parsing argv.
+ *
+ * Throws `ProjectCommandFailedError` (not a generic Error) on non-zero exit
+ * so cli.ts can exit with the child's code without re-printing the message.
+ */
+export declare function dispatchToEntry(record: ProjectCommandRecord, actionArgs: unknown[]): Promise<void>;
+export declare function isProjectCommand(cmd: Command): boolean;
+export declare function isCommandHidden(cmd: Command): boolean;
+export type { ProjectCommandEntry, ProjectCommandOption };

package/src/core/project-commands.js

@@ -0,0 +1,216 @@
+"use strict";
+/**
+ * Project-defined CLI commands (issue #409).
+ *
+ * Reads `cli.commands` from the project's frontmcp.config and registers
+ * each entry as a top-level Commander verb. The runner is spawned as a
+ * child process (tsx for `.ts` entries, node for `.js`/`.mjs`/`.cjs`).
+ *
+ * Failure to load the config is non-fatal: project commands are an
+ * optional layer on top of the built-in CLI, so a missing/broken config
+ * just yields zero project commands and never blocks `frontmcp --help`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectCommandFailedError = void 0;
+exports.registerProjectCommands = registerProjectCommands;
+exports.dispatchToEntry = dispatchToEntry;
+exports.isProjectCommand = isProjectCommand;
+exports.isCommandHidden = isCommandHidden;
+const tslib_1 = require("tslib");
+const child_process_1 = require("child_process");
+const path = tslib_1.__importStar(require("path"));
+const frontmcp_config_loader_1 = require("../config/frontmcp-config.loader");
+const colors_1 = require("./colors");
+const PROJECT_COMMAND_MARK = Symbol.for('frontmcp.project-command');
+/** Thrown when a dispatched runner exits non-zero or by signal. cli.ts uses
+ * the exit code without printing the stack again. */
+class ProjectCommandFailedError extends Error {
+    verb;
+    exitCode;
+    signal;
+    constructor(verb, exitCode, signal) {
+        super(signal
+            ? `Project command "${verb}" terminated by signal ${signal}`
+            : `Project command "${verb}" exited with code ${exitCode}`);
+        this.verb = verb;
+        this.exitCode = exitCode;
+        this.signal = signal;
+        this.name = 'ProjectCommandFailedError';
+    }
+}
+exports.ProjectCommandFailedError = ProjectCommandFailedError;
+/**
+ * Load `cli.commands` from `frontmcp.config` (in `cwd`) and attach each as
+ * a top-level command on the program. No-op if no config is found.
+ */
+async function registerProjectCommands(program, cwd = process.cwd()) {
+    const cfg = await safeLoad(cwd);
+    const commands = cfg?.cli?.commands;
+    if (!commands)
+        return;
+    for (const [verb, entry] of Object.entries(commands)) {
+        try {
+            const resolved = resolveAndCheckEntry(cwd, entry.entry);
+            attachCommand(program, { verb, entry: { ...entry, entry: resolved }, cwd });
+        }
+        catch (err) {
+            process.stderr.write((0, colors_1.c)('yellow', `⚠ Skipping project command "${verb}": ${err.message}\n`));
+        }
+    }
+}
+async function safeLoad(cwd) {
+    try {
+        return await (0, frontmcp_config_loader_1.tryLoadFrontMcpConfig)(cwd);
+    }
+    catch (err) {
+        process.stderr.write((0, colors_1.c)('yellow', `⚠ Could not load frontmcp.config for project commands: ${err.message}\n`));
+        return undefined;
+    }
+}
+/** Reject entry paths that escape the project cwd. */
+function resolveAndCheckEntry(cwd, entry) {
+    if (path.isAbsolute(entry)) {
+        throw new Error(`entry must be a project-relative path, not absolute: "${entry}"`);
+    }
+    const resolved = path.resolve(cwd, entry);
+    const rel = path.relative(cwd, resolved);
+    if (rel.startsWith('..') || path.isAbsolute(rel)) {
+        throw new Error(`entry "${entry}" escapes the project directory`);
+    }
+    return resolved;
+}
+function attachCommand(program, record) {
+    const { verb, entry } = record;
+    const cmd = program.command(verb);
+    if (entry.description)
+        cmd.description(entry.description);
+    if (entry.hidden) {
+        cmd._hidden = true;
+    }
+    for (const arg of entry.arguments ?? []) {
+        cmd.argument(formatArgumentToken(arg), arg.description ?? '');
+    }
+    for (const opt of entry.options ?? []) {
+        if (opt.default !== undefined) {
+            // Commander v13 types only allow string/boolean/string[] as a default,
+            // but accepts arbitrary JS values at runtime. Cast to keep numbers
+            // (e.g. `default: 4` for a `<num>` flag) flowing through as-is.
+            cmd.option(opt.flags, opt.description ?? '', opt.default);
+        }
+        else {
+            cmd.option(opt.flags, opt.description ?? '');
+        }
+    }
+    cmd.action(async (...args) => {
+        await dispatchToEntry(record, args);
+    });
+    cmd[PROJECT_COMMAND_MARK] = true;
+}
+function formatArgumentToken(arg) {
+    const inner = arg.variadic ? `${arg.name}...` : arg.name;
+    return arg.required ? `<${inner}>` : `[${inner}]`;
+}
+/**
+ * Spawn the project entry file as a child process and forward stdio. The
+ * child receives positionals as argv plus a `FRONTMCP_PROJECT_COMMAND` env
+ * var with the full payload (verb, positionals, options, cwd) so the runner
+ * can reconstruct context without re-parsing argv.
+ *
+ * Throws `ProjectCommandFailedError` (not a generic Error) on non-zero exit
+ * so cli.ts can exit with the child's code without re-printing the message.
+ */
+async function dispatchToEntry(record, actionArgs) {
+    // Commander invokes action with: ...positionals, options, command
+    const options = (actionArgs[actionArgs.length - 2] ?? {});
+    const positionals = actionArgs.slice(0, actionArgs.length - 2);
+    const entryAbs = record.entry.entry; // already resolved + safety-checked at register time
+    const runner = pickRunner(entryAbs);
+    const payload = {
+        verb: record.verb,
+        positionals,
+        options,
+        cwd: record.cwd,
+    };
+    const childArgv = [...runner.args, entryAbs, ...flattenPositionals(positionals), ...flattenOptions(options)];
+    const child = (0, child_process_1.spawn)(runner.cmd, childArgv, {
+        cwd: record.cwd,
+        stdio: 'inherit',
+        env: {
+            ...process.env,
+            FRONTMCP_PROJECT_COMMAND: JSON.stringify(payload),
+        },
+    });
+    await new Promise((resolve, reject) => {
+        child.on('error', reject);
+        child.on('exit', (code, signal) => {
+            if (signal) {
+                reject(new ProjectCommandFailedError(record.verb, 1, signal));
+                return;
+            }
+            if (code !== 0) {
+                reject(new ProjectCommandFailedError(record.verb, code ?? 1, null));
+                return;
+            }
+            resolve();
+        });
+    });
+}
+function pickRunner(entryAbs) {
+    const ext = path.extname(entryAbs).toLowerCase();
+    if (ext === '.ts' || ext === '.tsx' || ext === '.mts' || ext === '.cts') {
+        return { cmd: process.execPath, args: ['--import', 'tsx'] };
+    }
+    return { cmd: process.execPath, args: [] };
+}
+function flattenPositionals(positionals) {
+    const out = [];
+    for (const v of positionals) {
+        if (Array.isArray(v)) {
+            for (const item of v)
+                out.push(String(item));
+        }
+        else if (v !== undefined && v !== null) {
+            out.push(String(v));
+        }
+    }
+    return out;
+}
+/**
+ * Forward parsed options to the child as long-flag tokens so a runner that
+ * uses its own argv parser (Commander, yargs, etc.) sees the same values
+ * the parent did. Booleans become `--flag` (when true; omitted when false);
+ * other scalars become `--flag value`; arrays repeat the flag per element.
+ */
+function flattenOptions(options) {
+    const out = [];
+    for (const [key, value] of Object.entries(options)) {
+        const flag = `--${toKebab(key)}`;
+        if (value === undefined || value === null)
+            continue;
+        if (value === true) {
+            out.push(flag);
+        }
+        else if (value === false) {
+            // omit; absence is the default false
+        }
+        else if (Array.isArray(value)) {
+            for (const item of value) {
+                out.push(flag, String(item));
+            }
+        }
+        else {
+            out.push(flag, String(value));
+        }
+    }
+    return out;
+}
+function toKebab(s) {
+    return s.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
+}
+function isProjectCommand(cmd) {
+    return cmd[PROJECT_COMMAND_MARK] === true;
+}
+function isCommandHidden(cmd) {
+    return cmd._hidden === true;
+}
+//# sourceMappingURL=project-commands.js.map

package/src/core/project-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-commands.js","sourceRoot":"","sources":["../../../src/core/project-commands.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Project-defined CLI commands (issue #409).\n *\n * Reads `cli.commands` from the project's frontmcp.config and registers\n * each entry as a top-level Commander verb. The runner is spawned as a\n * child process (tsx for `.ts` entries, node for `.js`/`.mjs`/`.cjs`).\n *\n * Failure to load the config is non-fatal: project commands are an\n * optional layer on top of the built-in CLI, so a missing/broken config\n * just yields zero project commands and never blocks `frontmcp --help`.\n */\n\nimport { spawn } from 'child_process';\nimport * as path from 'path';\n\nimport type { Command } from 'commander';\n\nimport { tryLoadFrontMcpConfig } from '../config/frontmcp-config.loader';\nimport type {\n  ProjectCommandArgument,\n  ProjectCommandEntry,\n  ProjectCommandOption,\n} from '../config/frontmcp-config.types';\nimport { c } from './colors';\n\nconst PROJECT_COMMAND_MARK: unique symbol = Symbol.for('frontmcp.project-command');\n\ninterface ProjectCommandRecord {\n  readonly verb: string;\n  readonly entry: ProjectCommandEntry;\n  readonly cwd: string;\n}\n\n/** Thrown when a dispatched runner exits non-zero or by signal. cli.ts uses\n * the exit code without printing the stack again. */\nexport class ProjectCommandFailedError extends Error {\n  constructor(\n    readonly verb: string,\n    readonly exitCode: number,\n    readonly signal: NodeJS.Signals | null,\n  ) {\n    super(\n      signal\n        ? `Project command \"${verb}\" terminated by signal ${signal}`\n        : `Project command \"${verb}\" exited with code ${exitCode}`,\n    );\n    this.name = 'ProjectCommandFailedError';\n  }\n}\n\n/**\n * Load `cli.commands` from `frontmcp.config` (in `cwd`) and attach each as\n * a top-level command on the program. No-op if no config is found.\n */\nexport async function registerProjectCommands(program: Command, cwd: string = process.cwd()): Promise<void> {\n  const cfg = await safeLoad(cwd);\n  const commands = cfg?.cli?.commands;\n  if (!commands) return;\n\n  for (const [verb, entry] of Object.entries(commands)) {\n    try {\n      const resolved = resolveAndCheckEntry(cwd, entry.entry);\n      attachCommand(program, { verb, entry: { ...entry, entry: resolved }, cwd });\n    } catch (err) {\n      process.stderr.write(c('yellow', `⚠ Skipping project command \"${verb}\": ${(err as Error).message}\\n`));\n    }\n  }\n}\n\nasync function safeLoad(cwd: string): Promise<Awaited<ReturnType<typeof tryLoadFrontMcpConfig>>> {\n  try {\n    return await tryLoadFrontMcpConfig(cwd);\n  } catch (err) {\n    process.stderr.write(\n      c('yellow', `⚠ Could not load frontmcp.config for project commands: ${(err as Error).message}\\n`),\n    );\n    return undefined;\n  }\n}\n\n/** Reject entry paths that escape the project cwd. */\nfunction resolveAndCheckEntry(cwd: string, entry: string): string {\n  if (path.isAbsolute(entry)) {\n    throw new Error(`entry must be a project-relative path, not absolute: \"${entry}\"`);\n  }\n  const resolved = path.resolve(cwd, entry);\n  const rel = path.relative(cwd, resolved);\n  if (rel.startsWith('..') || path.isAbsolute(rel)) {\n    throw new Error(`entry \"${entry}\" escapes the project directory`);\n  }\n  return resolved;\n}\n\nfunction attachCommand(program: Command, record: ProjectCommandRecord): void {\n  const { verb, entry } = record;\n  const cmd = program.command(verb);\n  if (entry.description) cmd.description(entry.description);\n  if (entry.hidden) {\n    (cmd as unknown as { _hidden: boolean })._hidden = true;\n  }\n\n  for (const arg of entry.arguments ?? []) {\n    cmd.argument(formatArgumentToken(arg), arg.description ?? '');\n  }\n\n  for (const opt of entry.options ?? []) {\n    if (opt.default !== undefined) {\n      // Commander v13 types only allow string/boolean/string[] as a default,\n      // but accepts arbitrary JS values at runtime. Cast to keep numbers\n      // (e.g. `default: 4` for a `<num>` flag) flowing through as-is.\n      cmd.option(opt.flags, opt.description ?? '', opt.default as string | boolean | string[]);\n    } else {\n      cmd.option(opt.flags, opt.description ?? '');\n    }\n  }\n\n  cmd.action(async (...args: unknown[]) => {\n    await dispatchToEntry(record, args);\n  });\n\n  (cmd as unknown as Record<symbol, boolean>)[PROJECT_COMMAND_MARK] = true;\n}\n\nfunction formatArgumentToken(arg: ProjectCommandArgument): string {\n  const inner = arg.variadic ? `${arg.name}...` : arg.name;\n  return arg.required ? `<${inner}>` : `[${inner}]`;\n}\n\n/**\n * Spawn the project entry file as a child process and forward stdio. The\n * child receives positionals as argv plus a `FRONTMCP_PROJECT_COMMAND` env\n * var with the full payload (verb, positionals, options, cwd) so the runner\n * can reconstruct context without re-parsing argv.\n *\n * Throws `ProjectCommandFailedError` (not a generic Error) on non-zero exit\n * so cli.ts can exit with the child's code without re-printing the message.\n */\nexport async function dispatchToEntry(record: ProjectCommandRecord, actionArgs: unknown[]): Promise<void> {\n  // Commander invokes action with: ...positionals, options, command\n  const options = (actionArgs[actionArgs.length - 2] ?? {}) as Record<string, unknown>;\n  const positionals = actionArgs.slice(0, actionArgs.length - 2);\n\n  const entryAbs = record.entry.entry; // already resolved + safety-checked at register time\n  const runner = pickRunner(entryAbs);\n\n  const payload = {\n    verb: record.verb,\n    positionals,\n    options,\n    cwd: record.cwd,\n  };\n\n  const childArgv = [...runner.args, entryAbs, ...flattenPositionals(positionals), ...flattenOptions(options)];\n\n  const child = spawn(runner.cmd, childArgv, {\n    cwd: record.cwd,\n    stdio: 'inherit',\n    env: {\n      ...process.env,\n      FRONTMCP_PROJECT_COMMAND: JSON.stringify(payload),\n    },\n  });\n\n  await new Promise<void>((resolve, reject) => {\n    child.on('error', reject);\n    child.on('exit', (code, signal) => {\n      if (signal) {\n        reject(new ProjectCommandFailedError(record.verb, 1, signal));\n        return;\n      }\n      if (code !== 0) {\n        reject(new ProjectCommandFailedError(record.verb, code ?? 1, null));\n        return;\n      }\n      resolve();\n    });\n  });\n}\n\ninterface Runner {\n  cmd: string;\n  args: string[];\n}\n\nfunction pickRunner(entryAbs: string): Runner {\n  const ext = path.extname(entryAbs).toLowerCase();\n  if (ext === '.ts' || ext === '.tsx' || ext === '.mts' || ext === '.cts') {\n    return { cmd: process.execPath, args: ['--import', 'tsx'] };\n  }\n  return { cmd: process.execPath, args: [] };\n}\n\nfunction flattenPositionals(positionals: unknown[]): string[] {\n  const out: string[] = [];\n  for (const v of positionals) {\n    if (Array.isArray(v)) {\n      for (const item of v) out.push(String(item));\n    } else if (v !== undefined && v !== null) {\n      out.push(String(v));\n    }\n  }\n  return out;\n}\n\n/**\n * Forward parsed options to the child as long-flag tokens so a runner that\n * uses its own argv parser (Commander, yargs, etc.) sees the same values\n * the parent did. Booleans become `--flag` (when true; omitted when false);\n * other scalars become `--flag value`; arrays repeat the flag per element.\n */\nfunction flattenOptions(options: Record<string, unknown>): string[] {\n  const out: string[] = [];\n  for (const [key, value] of Object.entries(options)) {\n    const flag = `--${toKebab(key)}`;\n    if (value === undefined || value === null) continue;\n    if (value === true) {\n      out.push(flag);\n    } else if (value === false) {\n      // omit; absence is the default false\n    } else if (Array.isArray(value)) {\n      for (const item of value) {\n        out.push(flag, String(item));\n      }\n    } else {\n      out.push(flag, String(value));\n    }\n  }\n  return out;\n}\n\nfunction toKebab(s: string): string {\n  return s.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();\n}\n\nexport function isProjectCommand(cmd: Command): boolean {\n  return (cmd as unknown as Record<symbol, boolean>)[PROJECT_COMMAND_MARK] === true;\n}\n\nexport function isCommandHidden(cmd: Command): boolean {\n  return (cmd as unknown as { _hidden?: boolean })._hidden === true;\n}\n\n// Re-export the unused-types so external consumers can build option specs.\nexport type { ProjectCommandEntry, ProjectCommandOption };\n"]}