@kubb/cli 5.0.0-beta.4 → 5.0.0-beta.41

package/src/commands/mcp.ts

@@ -3,10 +3,34 @@ import { version } from '../../package.json'
 
 export const command = defineCommand({
   name: 'mcp',
-  description: 'Start the server to enable the MCP client to interact with the LLM.',
-  async run() {
-    const { runMcp } = await import('../runners/mcp.ts')
+  description:
+    'Start a Model Context Protocol (MCP) server that exposes Kubb code generation as tools for AI assistants. Once running, configure your AI client (Claude, Cursor, Windsurf, etc.) to connect to it — the assistant can then call kubb generate directly without leaving the chat.',
+  examples: [
+    'kubb mcp',
+    'kubb mcp --port 3001',
+    '# Then add to your MCP client config:',
+    '# { "mcpServers": { "kubb": { "command": "npx", "args": ["kubb", "mcp"] } } }',
+  ],
+  options: {
+    port: {
+      type: 'string',
+      short: 'p',
+      description: 'Port for HTTP MCP server (omit for stdio)',
+      hint: 'number',
+    },
+    host: {
+      type: 'string',
+      description: 'Hostname to bind to (HTTP mode only)',
+      default: 'localhost',
+    },
+  },
+  async run({ values }) {
+    const { run } = await import('../runners/mcp/run.ts')
 
-    await runMcp({ version })
+    await run({
+      version,
+      port: values.port,
+      host: values.host,
+    })
   },
 })

package/src/commands/validate.ts

@@ -3,18 +3,20 @@ import { version } from '../../package.json'
 
 export const command = defineCommand({
   name: 'validate',
-  description: 'Validate a Swagger/OpenAPI file',
+  description:
+    'Parse and validate an OpenAPI/Swagger file for structural correctness. Reports schema errors, missing required fields, and malformed references. Use this before running generate to catch spec issues early.',
+  examples: ['kubb validate --input ./openapi.yaml', 'kubb validate --input https://petstore3.swagger.io/api/v3/openapi.json'],
   options: {
     input: {
       type: 'string',
-      description: 'Path to Swagger/OpenAPI file',
+      description: 'Path or URL to the OpenAPI/Swagger file to validate',
       short: 'i',
       required: true,
     },
   },
   async run({ values }) {
-    const { runValidate } = await import('../runners/validate.ts')
+    const { run } = await import('../runners/validate/run.ts')
 
-    await runValidate({ input: values.input, version })
+    await run({ input: values.input, version })
   },
 })

package/src/constants.ts

@@ -1,42 +1,22 @@
-/**
- * Default filename for the Kubb configuration file.
- *
- * Used by the `init` command when scaffolding new projects and by the `agent` default config.
- */
-export const KUBB_CONFIG_FILENAME = 'kubb.config.ts' as const
+import { KUBB_CONFIG_FILENAME } from '@internals/shared'
 
 /**
  * NPM registry endpoint used to check for @kubb/cli updates.
  */
 export const KUBB_NPM_PACKAGE_URL = 'https://registry.npmjs.org/@kubb/cli/latest' as const
 
-/**
- * OpenTelemetry ingestion endpoint for anonymous usage telemetry.
- */
-export const OTLP_ENDPOINT = 'https://otlp.kubb.dev' as const
-
 /**
  * Horizontal rule rendered above/below the plain-logger generation summary.
  */
 export const SUMMARY_SEPARATOR = '─'.repeat(27)
 
-/**
- * Maximum number of █ characters in a plugin timing bar.
- */
-export const SUMMARY_MAX_BAR_LENGTH = 10 as const
-
-/**
- * Divides elapsed milliseconds into bar-length units (1 block per 100 ms).
- */
-export const SUMMARY_TIME_SCALE_DIVISOR = 100 as const
-
 /**
  * Glob pattern for paths the file watcher ignores.
  */
 export const WATCHER_IGNORED_PATHS = '**/{.git,node_modules}/**' as const
 
 /**
- * Flags that short-circuit execution (help/version) — no telemetry notice is shown.
+ * Flags that short-circuit execution (help/version), no telemetry notice is shown.
  */
 export const QUIET_FLAGS = new Set(['--help', '-h', '--version', '-v'] as const)
 
@@ -45,60 +25,9 @@ export const agentDefaults = {
   host: 'localhost',
   configFile: KUBB_CONFIG_FILENAME,
   retryTimeout: '30000',
-  studioUrl: 'https://studio.kubb.dev',
+  studioUrl: 'https://kubb.studio',
   /**
    * Relative path from the @kubb/agent package root to the server entry.
    */
   serverEntryPath: '.output/server/index.mjs',
 } as const
-
-/**
- * Default values used during interactive `init` scaffolding.
- */
-export const initDefaults = {
-  inputPath: './openapi.yaml',
-  outputPath: './src/gen',
-  plugins: ['plugin-ts'],
-} as const
-
-/**
- * Maps each plugin value to the default config snippet inserted by `init`.
- * The `satisfies` constraint ensures all values remain plain strings while
- * `as const` keeps the object deeply immutable.
- */
-export const pluginDefaultConfigs = {
-  'plugin-ts': `pluginTs({
-      output: { path: 'models' },
-    })`,
-  'plugin-client': `pluginClient({
-      output: { path: 'clients' },
-    })`,
-  'plugin-react-query': `pluginReactQuery({
-      output: { path: 'hooks' },
-    })`,
-  'plugin-vue-query': `pluginVueQuery({
-      output: { path: 'hooks' },
-    })`,
-  'plugin-zod': `pluginZod({
-      output: { path: 'zod' },
-    })`,
-  'plugin-faker': `pluginFaker({
-      output: { path: 'mocks' },
-    })`,
-  'plugin-msw': `pluginMsw({
-      output: { path: 'msw' },
-    })`,
-  'plugin-cypress': `pluginCypress({
-      output: { path: 'cypress' },
-    })`,
-  'plugin-mcp': `pluginMcp({
-      output: { path: 'mcp' },
-    })`,
-  'plugin-redoc': `pluginRedoc({
-      output: { path: 'redoc' },
-    })`,
-} as const satisfies Record<string, string>
-
-/**
- * Color palette used by randomCliColor() for deterministic plugin name coloring.
- */

package/src/index.ts

@@ -1,24 +1,26 @@
 import { styleText } from 'node:util'
-import { createCLI } from '@internals/utils'
+import { createCLI, isFlag } from '@internals/utils'
+import { Telemetry } from '@kubb/core'
 import { version } from '../package.json'
 import { QUIET_FLAGS } from './constants.ts'
-import { isFlag } from './utils/flags.ts'
-import { isTelemetryDisabled } from './utils/telemetry.ts'
 
 const cli = createCLI()
 
 function shouldShowTelemetryNotice(argv: Array<string>): boolean {
-  if (isTelemetryDisabled()) {
+  if (Telemetry.isDisabled()) {
     return false
   }
+
   // Skip when the user is just asking for help or version info
   if (argv.some((arg) => isFlag(QUIET_FLAGS, arg))) {
     return false
   }
+
   // Skip in non-interactive / scripting contexts
   if (!process.stdout.isTTY) {
     return false
   }
+
   return true
 }