goke 6.12.1 → 6.12.3

package/dist/__test__/index.test.js

@@ -1009,10 +1009,11 @@ describe('space-separated subcommands', () => {
         // Should show error message instead of root help
         expect(stripAnsi(errOutput)).toContain('Unknown command: foo');
     });
-    test('unknown command without prefix outputs error', async () => {
+    test('unknown command without prefix outputs error and help', async () => {
         let errOutput = '';
+        let stdOutput = '';
         const cli = goke('mycli', {
-            stdout: { write() { } },
+            stdout: { write(data) { stdOutput += data; } },
             stderr: { write(data) { errOutput += data; } },
             exit: () => { },
         });
@@ -1023,7 +1024,10 @@ describe('space-separated subcommands', () => {
         await cli.parse(['node', 'bin', 'something'], { run: true });
         expect(cli.matchedCommand).toBeUndefined();
         expect(stripAnsi(errOutput)).toContain('Unknown command: something');
-        expect(stripAnsi(errOutput)).toContain('mycli --help');
+        // Should output help so the user can see available commands
+        expect(stripAnsi(stdOutput)).toContain('Usage:');
+        expect(stripAnsi(stdOutput)).toContain('mcp login');
+        expect(stripAnsi(stdOutput)).toContain('build');
     });
     test('no args without default command outputs root help', async () => {
         const stdout = createTestOutputStream();
@@ -1080,6 +1084,19 @@ describe('space-separated subcommands', () => {
         await cli.parse(['node', 'bin', 'deploy'], { run: true });
         expect(receivedScript).toBe('deploy');
     });
+    test('default command WITH positional args alongside other commands', async () => {
+        let defaultScript;
+        let buildRan = false;
+        const cli = gokeTestable('mycli');
+        cli.command('[file]', 'Process a file').action(async (file) => {
+            defaultScript = file;
+        });
+        cli.command('build', 'Build project').action(async () => { buildRan = true; });
+        // Passing an arg that is NOT a known command should route to the default
+        await cli.parse(['node', 'bin', 'readme.md'], { run: true });
+        expect(defaultScript).toBe('readme.md');
+        expect(buildRan).toBe(false);
+    });
     test('default command rejects unknown nonexistent command', async () => {
         let defaultRan = false;
         let unknownFired = false;
@@ -2089,3 +2106,126 @@ describe('getAction()', () => {
         expect(() => cmd.getAction()).toThrow(/No action registered/);
     });
 });
+describe('command routing with conflicting enum options', () => {
+    test('commands with same option name but different enums route correctly', async () => {
+        const cli = gokeTestable('egaki');
+        let matched = '';
+        cli.command('image <prompt>', 'Generate images')
+            .option('-m, --model [model]', z.enum(['imagen-4', 'dall-e-3']).describe('Image model'))
+            .action((prompt, options) => { matched = `image:${prompt}:${options.model}`; });
+        cli.command('video <prompt>', 'Generate videos')
+            .option('-m, --model [model]', z.enum(['veo-3', 'grok-video']).describe('Video model'))
+            .action((prompt, options) => { matched = `video:${prompt}:${options.model}`; });
+        await cli.parse(['node', 'bin', 'video', 'test', '--model', 'grok-video']);
+        expect(matched).toBe('video:test:grok-video');
+    });
+    test('first-defined command still works with its own enum values', async () => {
+        const cli = gokeTestable('egaki');
+        let matched = '';
+        cli.command('image <prompt>', 'Generate images')
+            .option('-m, --model [model]', z.enum(['imagen-4', 'dall-e-3']).describe('Image model'))
+            .action((prompt, options) => { matched = `image:${prompt}:${options.model}`; });
+        cli.command('video <prompt>', 'Generate videos')
+            .option('-m, --model [model]', z.enum(['veo-3', 'grok-video']).describe('Video model'))
+            .action((prompt, options) => { matched = `video:${prompt}:${options.model}`; });
+        await cli.parse(['node', 'bin', 'image', 'sunset', '--model', 'dall-e-3']);
+        expect(matched).toBe('image:sunset:dall-e-3');
+    });
+    test('parent child command matches before parent <arg>', async () => {
+        const cli = gokeTestable('mycli');
+        let matched = '';
+        cli.command('parent <arg>', 'Parent with positional')
+            .action((arg) => { matched = `parent:${arg}`; });
+        cli.command('parent child', 'Parent child subcommand')
+            .action(() => { matched = 'parent child'; });
+        await cli.parse(['node', 'bin', 'parent', 'child']);
+        expect(matched).toBe('parent child');
+    });
+    test('parent <arg> still works for non-subcommand args', async () => {
+        const cli = gokeTestable('mycli');
+        let matched = '';
+        cli.command('parent <arg>', 'Parent with positional')
+            .action((arg) => { matched = `parent:${arg}`; });
+        cli.command('parent child', 'Parent child subcommand')
+            .action(() => { matched = 'parent child'; });
+        await cli.parse(['node', 'bin', 'parent', 'something']);
+        expect(matched).toBe('parent:something');
+    });
+    test('multi-word commands with same first word and conflicting enums route correctly', async () => {
+        const cli = gokeTestable('egaki');
+        let matched = '';
+        cli.command('image create <prompt>', 'Create image')
+            .option('--model [model]', z.enum(['imagen']).describe('Create model'))
+            .action((prompt, options) => { matched = `create:${prompt}:${options.model}`; });
+        cli.command('image edit <prompt>', 'Edit image')
+            .option('--model [model]', z.enum(['edit-model']).describe('Edit model'))
+            .action((prompt, options) => { matched = `edit:${prompt}:${options.model}`; });
+        await cli.parse(['node', 'bin', 'image', 'edit', 'test', '--model', 'edit-model']);
+        expect(matched).toBe('edit:test:edit-model');
+    });
+    test('aliased command with conflicting enum routes correctly', async () => {
+        const cli = gokeTestable('egaki');
+        let matched = '';
+        cli.command('image <prompt>', 'Generate images')
+            .option('--model [model]', z.enum(['imagen']).describe('Image model'))
+            .action((prompt, options) => { matched = `image:${prompt}:${options.model}`; });
+        cli.command('video <prompt>', 'Generate videos')
+            .alias('v')
+            .option('--model [model]', z.enum(['veo']).describe('Video model'))
+            .action((prompt, options) => { matched = `video:${prompt}:${options.model}`; });
+        await cli.parse(['node', 'bin', 'v', 'test', '--model', 'veo']);
+        expect(matched).toBe('video:test:veo');
+    });
+    test('global boolean flag before command does not disable routing precheck', async () => {
+        const cli = gokeTestable('egaki');
+        let matched = '';
+        cli.option('--verbose', 'Verbose output');
+        cli.command('image <prompt>', 'Generate images')
+            .option('--model [model]', z.enum(['imagen']).describe('Image model'))
+            .action((prompt, options) => { matched = `image:${prompt}:${options.model}`; });
+        cli.command('video <prompt>', 'Generate videos')
+            .option('--model [model]', z.enum(['veo']).describe('Video model'))
+            .action((prompt, options) => { matched = `video:${prompt}:${options.model}`; });
+        await cli.parse(['node', 'bin', '--verbose', 'video', 'test', '--model', 'veo']);
+        expect(matched).toBe('video:test:veo');
+    });
+    test('global value option before command keeps routing precheck enabled', async () => {
+        const cli = gokeTestable('egaki');
+        let matched = '';
+        cli.option('--config <path>', z.string().describe('Config path'));
+        cli.command('image <prompt>', 'Generate images')
+            .option('--model [model]', z.enum(['imagen']).describe('Image model'))
+            .action((prompt, options) => { matched = `image:${prompt}:${options.model}`; });
+        cli.command('video <prompt>', 'Generate videos')
+            .option('--model [model]', z.enum(['veo']).describe('Video model'))
+            .action((prompt, options) => { matched = `video:${prompt}:${options.model}`; });
+        await cli.parse(['node', 'bin', '--config', 'config.json', 'video', 'test', '--model', 'veo']);
+        expect(matched).toBe('video:test:veo');
+    });
+    test('global value option with equals syntax keeps routing precheck enabled', async () => {
+        const cli = gokeTestable('egaki');
+        let matched = '';
+        cli.option('--config <path>', z.string().describe('Config path'));
+        cli.command('image <prompt>', 'Generate images')
+            .option('--model [model]', z.enum(['imagen']).describe('Image model'))
+            .action((prompt, options) => { matched = `image:${prompt}:${options.model}`; });
+        cli.command('video <prompt>', 'Generate videos')
+            .option('--model [model]', z.enum(['veo']).describe('Video model'))
+            .action((prompt, options) => { matched = `video:${prompt}:${options.model}`; });
+        await cli.parse(['node', 'bin', '--config=config.json', 'video', 'test', '--model', 'veo']);
+        expect(matched).toBe('video:test:veo');
+    });
+    test('global boolean flag with explicit equals value keeps routing precheck enabled', async () => {
+        const cli = gokeTestable('egaki');
+        let matched = '';
+        cli.option('--verbose', 'Verbose output');
+        cli.command('image <prompt>', 'Generate images')
+            .option('--model [model]', z.enum(['imagen']).describe('Image model'))
+            .action((prompt, options) => { matched = `image:${prompt}:${options.model}`; });
+        cli.command('video <prompt>', 'Generate videos')
+            .option('--model [model]', z.enum(['veo']).describe('Video model'))
+            .action((prompt, options) => { matched = `video:${prompt}:${options.model}`; });
+        await cli.parse(['node', 'bin', '--verbose=false', 'video', 'test', '--model', 'veo']);
+        expect(matched).toBe('video:test:veo');
+    });
+});

package/dist/__test__/readme-examples.test.js

@@ -291,6 +291,52 @@ describe('generateDocs', () => {
         const pages = generateDocs({ cli });
         expect(pages).toEqual([]);
     });
+    test('supports basePath option for links', async () => {
+        const cli = gokeTestable('mycli');
+        cli.command('deploy', 'Deploy the app');
+        cli.command('status', 'Show status');
+        const pages = generateDocs({ cli, basePath: '/docs/cli' });
+        const index = pages.find((p) => p.slug === 'index');
+        expect(index.content).toContain('[\`deploy\`](/docs/cli/deploy.md)');
+        expect(index.content).toContain('[\`status\`](/docs/cli/status.md)');
+    });
+    test('basePath with trailing slash is normalized', async () => {
+        const cli = gokeTestable('mycli');
+        cli.command('deploy', 'Deploy the app');
+        const pages = generateDocs({ cli, basePath: '/docs/cli/' });
+        const index = pages.find((p) => p.slug === 'index');
+        expect(index.content).toContain('[\`deploy\`](/docs/cli/deploy.md)');
+    });
+    test('escapes angle-bracket placeholders in descriptions for MDX safety', async () => {
+        const cli = gokeTestable('strada');
+        cli
+            .command('issues view <fingerprint>', 'View issue details by <fingerprint>')
+            .option('--project <slug>', 'Filter by <project> slug');
+        cli
+            .command('deploy <env>', 'Deploy to <env> environment using `<config>` file');
+        const pages = generateDocs({ cli });
+        // Index page: command descriptions should have <word> escaped
+        const index = pages.find((p) => p.slug === 'index');
+        expect(index.content).toContain('View issue details by `<fingerprint>`');
+        expect(index.content).toContain('Deploy to `<env>` environment using `<config>` file');
+        // Command page: description prose should have <word> escaped
+        const issuesPage = pages.find((p) => p.slug === 'issues-view');
+        expect(issuesPage.content).toContain('View issue details by `<fingerprint>`');
+        // Options table: description should have <word> escaped
+        expect(issuesPage.content).toContain('Filter by `<project>` slug');
+        // Arguments table: already uses backtick-wrapped bracket syntax
+        expect(issuesPage.content).toContain('`<fingerprint>`');
+        // Verify no bare <word> outside backticks in any page
+        for (const page of pages) {
+            // Strip inline code and fenced code blocks, then check for bare <word>
+            const stripped = page.content
+                .replace(/```[\s\S]*?```/g, '') // remove fenced blocks
+                .replace(/`[^`]+`/g, ''); // remove inline code
+            const bareAngle = /<[a-zA-Z_][\w.-]*>/g;
+            const matches = stripped.match(bareAngle);
+            expect(matches, `bare <word> found in page "${page.slug}": ${matches}`).toBeNull();
+        }
+    });
     test('skips deprecated options', async () => {
         const cli = gokeTestable('mycli');
         cli

package/dist/goke.d.ts

@@ -698,6 +698,8 @@ interface DocPage {
 interface GenerateDocsOptions {
     /** The Goke CLI instance to generate docs from. */
     cli: Goke<any>;
+    /** Base path prefix for links between pages (e.g. "/docs/cli"). Defaults to ".". */
+    basePath?: string;
 }
 /**
  * Generate markdown documentation pages for every command in a CLI.
@@ -715,13 +717,13 @@ interface GenerateDocsOptions {
  *   .command('deploy <env>', 'Deploy to an environment')
  *   .option('--force', 'Skip confirmation')
  *
- * const pages = generateDocs({ cli })
+ * const pages = generateDocs({ cli, basePath: '/docs/cli' })
  * for (const page of pages) {
  *   fs.writeFileSync(`docs/${page.slug}.md`, page.content)
  * }
  * ```
  */
-declare function generateDocs({ cli }: GenerateDocsOptions): DocPage[];
+declare function generateDocs({ cli, basePath }: GenerateDocsOptions): DocPage[];
 export type { GokeOutputStream, GokeConsole, GokeOptions, GokeProcess, GokeExecutionContext, GokeExecutionContextOverride, GokeFs, DocPage, GenerateDocsOptions };
 export { createConsole, Command, GokeProcessExit, openInBrowser, generateDocs };
 export type { ShellType };

package/dist/goke.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"goke.d.ts","sourceRoot":"","sources":["../src/goke.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"goke.d.ts","sourceRoot":"","sources":["../src/goke.ts"],"names":[],"mappings":"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"}

package/dist/goke.js

@@ -1288,21 +1288,27 @@ class Goke extends EventEmitter {
             const bLength = b.name.split(' ').filter(Boolean).length;
             return bLength - aLength;
         });
-        // Search sub-commands — mri() can throw coercion errors, catch them
+        // Search sub-commands using two-pass matching:
+        // 1. First pass: parse without schema coercion to find the matching command.
+        //    This avoids z.enum() or other schema validation throwing for the wrong
+        //    command's options before isMatched() can reject it.
+        // 2. Second pass: re-parse with full coercion for the matched command only.
         try {
             for (const command of sortedCommands) {
-                const parsed = this.mri(argv.slice(2), command);
+                const parsed = this.mri(argv.slice(2), command, true);
                 const result = command.isMatched(parsed.args);
                 if (result.matched) {
                     shouldParse = false;
-                    const matchedCommandName = parsed.args.slice(0, result.consumedArgs).join(' ');
+                    // Re-parse with coercion now that we know this is the right command
+                    const coerced = this.mri(argv.slice(2), command);
+                    const matchedCommandName = coerced.args.slice(0, result.consumedArgs).join(' ');
                     const parsedInfo = {
-                        ...parsed,
-                        args: parsed.args.slice(result.consumedArgs),
+                        ...coerced,
+                        args: coerced.args.slice(result.consumedArgs),
                     };
                     this.setParsedInfo(parsedInfo, command, matchedCommandName);
                     this.emit(`command:${matchedCommandName}`, command);
-                    break; // Stop after first match (greedy matching)
+                    break;
                 }
             }
             if (shouldParse) {
@@ -1397,8 +1403,8 @@ class Goke extends EventEmitter {
                 }
                 else {
                     // Unknown command with no matching prefix: show error + root help
-                    this.console.error(`Unknown command: ${this.args.join(' ')}`);
-                    this.console.error(`Run "${this.name} --help" to see available commands.`);
+                    this.console.error(`Unknown command: ${this.args.join(' ')}\n`);
+                    this.outputHelp();
                 }
                 this.exit(1);
             }
@@ -1412,7 +1418,9 @@ class Goke extends EventEmitter {
         return parsedArgv;
     }
     mri(argv, 
-    /** Matched command */ command) {
+    /** Matched command */ command, 
+    /** Skip schema coercion (used during command matching to avoid throwing for wrong commands) */
+    skipCoercion) {
         // All added options
         const cliOptions = [
             ...this.globalCommand.options,
@@ -1504,41 +1512,43 @@ class Goke extends EventEmitter {
             if (key !== '_') {
                 const keys = key.split('.');
                 let value = parsed[key];
-                // Apply schema coercion if this option has a schema.
-                // When value is boolean `true` and the option takes a value, it's mri's sentinel
-                // for "flag present, no value given":
-                //   - Required options (<...>): preserve `true` so checkOptionValue() throws
-                //   - Optional options ([...]) with schema AND a default: skip this
-                //     key entirely so the preset default (written into `options` at
-                //     the top of this function) survives. This keeps the type-level
-                //     `HasSchemaDefault` promise honest at runtime.
-                //   - Optional options ([...]) with schema and NO default: replace
-                //     `true` with `undefined` so the caller sees "flag present, no value"
-                //     as `undefined`.
-                const schemaInfo = schemaMap.get(key);
-                if (schemaInfo && value !== undefined) {
-                    if (value === true && requiredValueOptions.has(key)) {
-                        // Keep sentinel for checkOptionValue() to detect
-                    }
-                    else if (value === true && optionalValueOptions.has(key)) {
-                        if (optionsWithDefault.has(key)) {
-                            // Preserve the preset default — don't overwrite with undefined.
-                            continue;
+                if (!skipCoercion) {
+                    // Apply schema coercion if this option has a schema.
+                    // When value is boolean `true` and the option takes a value, it's mri's sentinel
+                    // for "flag present, no value given":
+                    //   - Required options (<...>): preserve `true` so checkOptionValue() throws
+                    //   - Optional options ([...]) with schema AND a default: skip this
+                    //     key entirely so the preset default (written into `options` at
+                    //     the top of this function) survives. This keeps the type-level
+                    //     `HasSchemaDefault` promise honest at runtime.
+                    //   - Optional options ([...]) with schema and NO default: replace
+                    //     `true` with `undefined` so the caller sees "flag present, no value"
+                    //     as `undefined`.
+                    const schemaInfo = schemaMap.get(key);
+                    if (schemaInfo && value !== undefined) {
+                        if (value === true && requiredValueOptions.has(key)) {
+                            // Keep sentinel for checkOptionValue() to detect
+                        }
+                        else if (value === true && optionalValueOptions.has(key)) {
+                            if (optionsWithDefault.has(key)) {
+                                // Preserve the preset default — don't overwrite with undefined.
+                                continue;
+                            }
+                            value = undefined;
+                        }
+                        else {
+                            value = coerceBySchema(value, schemaInfo.jsonSchema, schemaInfo.optionName);
                         }
-                        value = undefined;
                     }
-                    else {
-                        value = coerceBySchema(value, schemaInfo.jsonSchema, schemaInfo.optionName);
+                    else if (value === true && optionalValueOptions.has(key)) {
+                        // Untyped optional-value flag with no schema: normalize bare `true`
+                        // to `''` so callers get a clean `string | undefined` shape. `''`
+                        // means "flag passed with no argument", distinct from `undefined`
+                        // (flag omitted). This matches the new type inference that treats
+                        // `[value]` as `string` instead of `string | boolean`.
+                        value = '';
                     }
                 }
-                else if (value === true && optionalValueOptions.has(key)) {
-                    // Untyped optional-value flag with no schema: normalize bare `true`
-                    // to `''` so callers get a clean `string | undefined` shape. `''`
-                    // means "flag passed with no argument", distinct from `undefined`
-                    // (flag omitted). This matches the new type inference that treats
-                    // `[value]` as `string` instead of `string | boolean`.
-                    value = '';
-                }
                 setDotProp(options, keys, value);
             }
         }
@@ -1651,13 +1661,15 @@ class Goke extends EventEmitter {
  *   .command('deploy <env>', 'Deploy to an environment')
  *   .option('--force', 'Skip confirmation')
  *
- * const pages = generateDocs({ cli })
+ * const pages = generateDocs({ cli, basePath: '/docs/cli' })
  * for (const page of pages) {
  *   fs.writeFileSync(`docs/${page.slug}.md`, page.content)
  * }
  * ```
  */
-function generateDocs({ cli }) {
+function generateDocs({ cli, basePath = '.' }) {
+    // Normalize: strip trailing slash
+    basePath = basePath.replace(/\/+$/, '') || '.';
     const pages = [];
     // Collect global options (from globalCommand), excluding deprecated
     const globalOptions = cli.globalCommand.options.filter((o) => !o.deprecated);
@@ -1679,9 +1691,9 @@ function generateDocs({ cli }) {
         for (const cmd of visibleCommands) {
             if (cmd.isDefaultCommand)
                 continue;
-            const desc = cmd.description.split('\n')[0].trim();
+            const desc = escapeAngleBrackets(cmd.description.split('\n')[0].trim());
             const slug = cmd.name.replace(/\s+/g, '-');
-            lines.push(`| [\`${cmd.name}\`](./${slug}.md) | ${desc} |`);
+            lines.push(`| [\`${cmd.name}\`](${basePath}/${slug}.md) | ${desc} |`);
         }
         lines.push('');
         if (globalOptions.length > 0) {
@@ -1701,7 +1713,7 @@ function generateDocs({ cli }) {
         lines.push(`# ${title}`);
         lines.push('');
         if (cmd.description) {
-            lines.push(cmd.description);
+            lines.push(escapeAngleBrackets(cmd.description));
             lines.push('');
         }
         // Usage line
@@ -1766,6 +1778,19 @@ function generateDocs({ cli }) {
     }
     return pages;
 }
+/**
+ * Wraps bare `<word>` angle-bracket placeholders in backticks so MDX parsers
+ * don't interpret them as JSX tags. Skips content already inside inline code
+ * (single backticks) or fenced code blocks.
+ */
+function escapeAngleBrackets(text) {
+    // Split on inline code spans to avoid double-wrapping
+    return text.replace(/(`.+?`)|(<[a-zA-Z_][\w.-]*>)/g, (match, codeSpan) => {
+        if (codeSpan)
+            return match; // already inside backticks
+        return `\`${match}\``;
+    });
+}
 function formatOptionsTable(options) {
     const lines = [];
     lines.push('| Option | Default | Description |');
@@ -1773,7 +1798,7 @@ function formatOptionsTable(options) {
     for (const opt of options) {
         const defaultVal = opt.default !== undefined ? `\`${String(opt.default)}\`` : '-';
         // Escape pipe characters in description for markdown tables
-        const desc = opt.description.replace(/\|/g, '\\|').replace(/\n/g, ' ');
+        const desc = escapeAngleBrackets(opt.description.replace(/\|/g, '\\|').replace(/\n/g, ' '));
         lines.push(`| \`${opt.rawName}\` | ${defaultVal} | ${desc} |`);
     }
     return lines.join('\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "goke",
-  "version": "6.12.1",
+  "version": "6.12.3",
   "type": "module",
   "description": "Simple yet powerful framework for building command-line apps. Inspired by cac.",
   "repository": {
@@ -24,7 +24,6 @@
   "imports": {
     "#runtime": {
       "types": "./dist/runtime-node.d.ts",
-      "development": "./src/runtime-node.ts",
       "node": "./dist/runtime-node.js",
       "default": "./dist/runtime-browser.js"
     }

package/src/__test__/index.test.ts

@@ -1295,10 +1295,11 @@ describe('space-separated subcommands', () => {
     expect(stripAnsi(errOutput)).toContain('Unknown command: foo')
   })
 
-  test('unknown command without prefix outputs error', async () => {
+  test('unknown command without prefix outputs error and help', async () => {
     let errOutput = ''
+    let stdOutput = ''
     const cli = goke('mycli', {
-      stdout: { write() {} },
+      stdout: { write(data) { stdOutput += data } },
       stderr: { write(data) { errOutput += data } },
       exit: () => {},
     })
@@ -1313,7 +1314,10 @@ describe('space-separated subcommands', () => {
 
     expect(cli.matchedCommand).toBeUndefined()
     expect(stripAnsi(errOutput)).toContain('Unknown command: something')
-    expect(stripAnsi(errOutput)).toContain('mycli --help')
+    // Should output help so the user can see available commands
+    expect(stripAnsi(stdOutput)).toContain('Usage:')
+    expect(stripAnsi(stdOutput)).toContain('mcp login')
+    expect(stripAnsi(stdOutput)).toContain('build')
   })
 
   test('no args without default command outputs root help', async () => {
@@ -1391,6 +1395,23 @@ describe('space-separated subcommands', () => {
     expect(receivedScript).toBe('deploy')
   })
 
+  test('default command WITH positional args alongside other commands', async () => {
+    let defaultScript: string | undefined
+    let buildRan = false
+    const cli = gokeTestable('mycli')
+
+    cli.command('[file]', 'Process a file').action(async (file) => {
+      defaultScript = file
+    })
+    cli.command('build', 'Build project').action(async () => { buildRan = true })
+
+    // Passing an arg that is NOT a known command should route to the default
+    await cli.parse(['node', 'bin', 'readme.md'], { run: true })
+
+    expect(defaultScript).toBe('readme.md')
+    expect(buildRan).toBe(false)
+  })
+
   test('default command rejects unknown nonexistent command', async () => {
     let defaultRan = false
     let unknownFired = false
@@ -2671,3 +2692,170 @@ describe('getAction()', () => {
     expect(() => cmd.getAction()).toThrow(/No action registered/)
   })
 })
+
+describe('command routing with conflicting enum options', () => {
+  test('commands with same option name but different enums route correctly', async () => {
+    const cli = gokeTestable('egaki')
+    let matched = ''
+
+    cli.command('image <prompt>', 'Generate images')
+      .option('-m, --model [model]', z.enum(['imagen-4', 'dall-e-3']).describe('Image model'))
+      .action((prompt, options) => { matched = `image:${prompt}:${options.model}` })
+
+    cli.command('video <prompt>', 'Generate videos')
+      .option('-m, --model [model]', z.enum(['veo-3', 'grok-video']).describe('Video model'))
+      .action((prompt, options) => { matched = `video:${prompt}:${options.model}` })
+
+    await cli.parse(['node', 'bin', 'video', 'test', '--model', 'grok-video'])
+    expect(matched).toBe('video:test:grok-video')
+  })
+
+  test('first-defined command still works with its own enum values', async () => {
+    const cli = gokeTestable('egaki')
+    let matched = ''
+
+    cli.command('image <prompt>', 'Generate images')
+      .option('-m, --model [model]', z.enum(['imagen-4', 'dall-e-3']).describe('Image model'))
+      .action((prompt, options) => { matched = `image:${prompt}:${options.model}` })
+
+    cli.command('video <prompt>', 'Generate videos')
+      .option('-m, --model [model]', z.enum(['veo-3', 'grok-video']).describe('Video model'))
+      .action((prompt, options) => { matched = `video:${prompt}:${options.model}` })
+
+    await cli.parse(['node', 'bin', 'image', 'sunset', '--model', 'dall-e-3'])
+    expect(matched).toBe('image:sunset:dall-e-3')
+  })
+
+  test('parent child command matches before parent <arg>', async () => {
+    const cli = gokeTestable('mycli')
+    let matched = ''
+
+    cli.command('parent <arg>', 'Parent with positional')
+      .action((arg) => { matched = `parent:${arg}` })
+
+    cli.command('parent child', 'Parent child subcommand')
+      .action(() => { matched = 'parent child' })
+
+    await cli.parse(['node', 'bin', 'parent', 'child'])
+    expect(matched).toBe('parent child')
+  })
+
+  test('parent <arg> still works for non-subcommand args', async () => {
+    const cli = gokeTestable('mycli')
+    let matched = ''
+
+    cli.command('parent <arg>', 'Parent with positional')
+      .action((arg) => { matched = `parent:${arg}` })
+
+    cli.command('parent child', 'Parent child subcommand')
+      .action(() => { matched = 'parent child' })
+
+    await cli.parse(['node', 'bin', 'parent', 'something'])
+    expect(matched).toBe('parent:something')
+  })
+
+  test('multi-word commands with same first word and conflicting enums route correctly', async () => {
+    const cli = gokeTestable('egaki')
+    let matched = ''
+
+    cli.command('image create <prompt>', 'Create image')
+      .option('--model [model]', z.enum(['imagen']).describe('Create model'))
+      .action((prompt, options) => { matched = `create:${prompt}:${options.model}` })
+
+    cli.command('image edit <prompt>', 'Edit image')
+      .option('--model [model]', z.enum(['edit-model']).describe('Edit model'))
+      .action((prompt, options) => { matched = `edit:${prompt}:${options.model}` })
+
+    await cli.parse(['node', 'bin', 'image', 'edit', 'test', '--model', 'edit-model'])
+    expect(matched).toBe('edit:test:edit-model')
+  })
+
+  test('aliased command with conflicting enum routes correctly', async () => {
+    const cli = gokeTestable('egaki')
+    let matched = ''
+
+    cli.command('image <prompt>', 'Generate images')
+      .option('--model [model]', z.enum(['imagen']).describe('Image model'))
+      .action((prompt, options) => { matched = `image:${prompt}:${options.model}` })
+
+    cli.command('video <prompt>', 'Generate videos')
+      .alias('v')
+      .option('--model [model]', z.enum(['veo']).describe('Video model'))
+      .action((prompt, options) => { matched = `video:${prompt}:${options.model}` })
+
+    await cli.parse(['node', 'bin', 'v', 'test', '--model', 'veo'])
+    expect(matched).toBe('video:test:veo')
+  })
+
+  test('global boolean flag before command does not disable routing precheck', async () => {
+    const cli = gokeTestable('egaki')
+    let matched = ''
+
+    cli.option('--verbose', 'Verbose output')
+
+    cli.command('image <prompt>', 'Generate images')
+      .option('--model [model]', z.enum(['imagen']).describe('Image model'))
+      .action((prompt, options) => { matched = `image:${prompt}:${options.model}` })
+
+    cli.command('video <prompt>', 'Generate videos')
+      .option('--model [model]', z.enum(['veo']).describe('Video model'))
+      .action((prompt, options) => { matched = `video:${prompt}:${options.model}` })
+
+    await cli.parse(['node', 'bin', '--verbose', 'video', 'test', '--model', 'veo'])
+    expect(matched).toBe('video:test:veo')
+  })
+
+  test('global value option before command keeps routing precheck enabled', async () => {
+    const cli = gokeTestable('egaki')
+    let matched = ''
+
+    cli.option('--config <path>', z.string().describe('Config path'))
+
+    cli.command('image <prompt>', 'Generate images')
+      .option('--model [model]', z.enum(['imagen']).describe('Image model'))
+      .action((prompt, options) => { matched = `image:${prompt}:${options.model}` })
+
+    cli.command('video <prompt>', 'Generate videos')
+      .option('--model [model]', z.enum(['veo']).describe('Video model'))
+      .action((prompt, options) => { matched = `video:${prompt}:${options.model}` })
+
+    await cli.parse(['node', 'bin', '--config', 'config.json', 'video', 'test', '--model', 'veo'])
+    expect(matched).toBe('video:test:veo')
+  })
+
+  test('global value option with equals syntax keeps routing precheck enabled', async () => {
+    const cli = gokeTestable('egaki')
+    let matched = ''
+
+    cli.option('--config <path>', z.string().describe('Config path'))
+
+    cli.command('image <prompt>', 'Generate images')
+      .option('--model [model]', z.enum(['imagen']).describe('Image model'))
+      .action((prompt, options) => { matched = `image:${prompt}:${options.model}` })
+
+    cli.command('video <prompt>', 'Generate videos')
+      .option('--model [model]', z.enum(['veo']).describe('Video model'))
+      .action((prompt, options) => { matched = `video:${prompt}:${options.model}` })
+
+    await cli.parse(['node', 'bin', '--config=config.json', 'video', 'test', '--model', 'veo'])
+    expect(matched).toBe('video:test:veo')
+  })
+
+  test('global boolean flag with explicit equals value keeps routing precheck enabled', async () => {
+    const cli = gokeTestable('egaki')
+    let matched = ''
+
+    cli.option('--verbose', 'Verbose output')
+
+    cli.command('image <prompt>', 'Generate images')
+      .option('--model [model]', z.enum(['imagen']).describe('Image model'))
+      .action((prompt, options) => { matched = `image:${prompt}:${options.model}` })
+
+    cli.command('video <prompt>', 'Generate videos')
+      .option('--model [model]', z.enum(['veo']).describe('Video model'))
+      .action((prompt, options) => { matched = `video:${prompt}:${options.model}` })
+
+    await cli.parse(['node', 'bin', '--verbose=false', 'video', 'test', '--model', 'veo'])
+    expect(matched).toBe('video:test:veo')
+  })
+})

package/src/__test__/readme-examples.test.ts

@@ -358,6 +358,64 @@ describe('generateDocs', () => {
     expect(pages).toEqual([])
   })
 
+  test('supports basePath option for links', async () => {
+    const cli = gokeTestable('mycli')
+    cli.command('deploy', 'Deploy the app')
+    cli.command('status', 'Show status')
+
+    const pages = generateDocs({ cli, basePath: '/docs/cli' })
+    const index = pages.find((p) => p.slug === 'index')!
+    expect(index.content).toContain('[\`deploy\`](/docs/cli/deploy.md)')
+    expect(index.content).toContain('[\`status\`](/docs/cli/status.md)')
+  })
+
+  test('basePath with trailing slash is normalized', async () => {
+    const cli = gokeTestable('mycli')
+    cli.command('deploy', 'Deploy the app')
+
+    const pages = generateDocs({ cli, basePath: '/docs/cli/' })
+    const index = pages.find((p) => p.slug === 'index')!
+    expect(index.content).toContain('[\`deploy\`](/docs/cli/deploy.md)')
+  })
+
+  test('escapes angle-bracket placeholders in descriptions for MDX safety', async () => {
+    const cli = gokeTestable('strada')
+    cli
+      .command('issues view <fingerprint>', 'View issue details by <fingerprint>')
+      .option('--project <slug>', 'Filter by <project> slug')
+
+    cli
+      .command('deploy <env>', 'Deploy to <env> environment using `<config>` file')
+
+    const pages = generateDocs({ cli })
+
+    // Index page: command descriptions should have <word> escaped
+    const index = pages.find((p) => p.slug === 'index')!
+    expect(index.content).toContain('View issue details by `<fingerprint>`')
+    expect(index.content).toContain('Deploy to `<env>` environment using `<config>` file')
+
+    // Command page: description prose should have <word> escaped
+    const issuesPage = pages.find((p) => p.slug === 'issues-view')!
+    expect(issuesPage.content).toContain('View issue details by `<fingerprint>`')
+
+    // Options table: description should have <word> escaped
+    expect(issuesPage.content).toContain('Filter by `<project>` slug')
+
+    // Arguments table: already uses backtick-wrapped bracket syntax
+    expect(issuesPage.content).toContain('`<fingerprint>`')
+
+    // Verify no bare <word> outside backticks in any page
+    for (const page of pages) {
+      // Strip inline code and fenced code blocks, then check for bare <word>
+      const stripped = page.content
+        .replace(/```[\s\S]*?```/g, '') // remove fenced blocks
+        .replace(/`[^`]+`/g, '') // remove inline code
+      const bareAngle = /<[a-zA-Z_][\w.-]*>/g
+      const matches = stripped.match(bareAngle)
+      expect(matches, `bare <word> found in page "${page.slug}": ${matches}`).toBeNull()
+    }
+  })
+
   test('skips deprecated options', async () => {
     const cli = gokeTestable('mycli')
     cli

package/src/goke.ts

@@ -1927,22 +1927,28 @@ class Goke<Opts = {}> extends EventEmitter {
       return bLength - aLength
     })
 
-    // Search sub-commands — mri() can throw coercion errors, catch them
+    // Search sub-commands using two-pass matching:
+    // 1. First pass: parse without schema coercion to find the matching command.
+    //    This avoids z.enum() or other schema validation throwing for the wrong
+    //    command's options before isMatched() can reject it.
+    // 2. Second pass: re-parse with full coercion for the matched command only.
     try {
       for (const command of sortedCommands) {
-        const parsed = this.mri(argv.slice(2), command)
+        const parsed = this.mri(argv.slice(2), command, true)
 
         const result = command.isMatched(parsed.args as string[])
         if (result.matched) {
           shouldParse = false
-          const matchedCommandName = parsed.args.slice(0, result.consumedArgs).join(' ')
+          // Re-parse with coercion now that we know this is the right command
+          const coerced = this.mri(argv.slice(2), command)
+          const matchedCommandName = coerced.args.slice(0, result.consumedArgs).join(' ')
           const parsedInfo = {
-            ...parsed,
-            args: parsed.args.slice(result.consumedArgs),
+            ...coerced,
+            args: coerced.args.slice(result.consumedArgs),
           }
           this.setParsedInfo(parsedInfo, command, matchedCommandName)
           this.emit(`command:${matchedCommandName}`, command)
-          break // Stop after first match (greedy matching)
+          break
         }
       }
 
@@ -2039,8 +2045,8 @@ class Goke<Opts = {}> extends EventEmitter {
           this.outputHelpForPrefix(firstArg, matchingCommands)
         } else {
           // Unknown command with no matching prefix: show error + root help
-          this.console.error(`Unknown command: ${this.args.join(' ')}`)
-          this.console.error(`Run "${this.name} --help" to see available commands.`)
+          this.console.error(`Unknown command: ${this.args.join(' ')}\n`)
+          this.outputHelp()
         }
         this.exit(1)
       }
@@ -2060,7 +2066,9 @@ class Goke<Opts = {}> extends EventEmitter {
 
   private mri(
     argv: string[],
-    /** Matched command */ command?: Command
+    /** Matched command */ command?: Command,
+    /** Skip schema coercion (used during command matching to avoid throwing for wrong commands) */
+    skipCoercion?: boolean,
   ): ParsedArgv {
     // All added options
     const cliOptions = [
@@ -2167,37 +2175,39 @@ class Goke<Opts = {}> extends EventEmitter {
         const keys = key.split('.')
         let value = parsed[key]
 
-        // Apply schema coercion if this option has a schema.
-        // When value is boolean `true` and the option takes a value, it's mri's sentinel
-        // for "flag present, no value given":
-        //   - Required options (<...>): preserve `true` so checkOptionValue() throws
-        //   - Optional options ([...]) with schema AND a default: skip this
-        //     key entirely so the preset default (written into `options` at
-        //     the top of this function) survives. This keeps the type-level
-        //     `HasSchemaDefault` promise honest at runtime.
-        //   - Optional options ([...]) with schema and NO default: replace
-        //     `true` with `undefined` so the caller sees "flag present, no value"
-        //     as `undefined`.
-        const schemaInfo = schemaMap.get(key)
-        if (schemaInfo && value !== undefined) {
-          if (value === true && requiredValueOptions.has(key)) {
-            // Keep sentinel for checkOptionValue() to detect
-          } else if (value === true && optionalValueOptions.has(key)) {
-            if (optionsWithDefault.has(key)) {
-              // Preserve the preset default — don't overwrite with undefined.
-              continue
+        if (!skipCoercion) {
+          // Apply schema coercion if this option has a schema.
+          // When value is boolean `true` and the option takes a value, it's mri's sentinel
+          // for "flag present, no value given":
+          //   - Required options (<...>): preserve `true` so checkOptionValue() throws
+          //   - Optional options ([...]) with schema AND a default: skip this
+          //     key entirely so the preset default (written into `options` at
+          //     the top of this function) survives. This keeps the type-level
+          //     `HasSchemaDefault` promise honest at runtime.
+          //   - Optional options ([...]) with schema and NO default: replace
+          //     `true` with `undefined` so the caller sees "flag present, no value"
+          //     as `undefined`.
+          const schemaInfo = schemaMap.get(key)
+          if (schemaInfo && value !== undefined) {
+            if (value === true && requiredValueOptions.has(key)) {
+              // Keep sentinel for checkOptionValue() to detect
+            } else if (value === true && optionalValueOptions.has(key)) {
+              if (optionsWithDefault.has(key)) {
+                // Preserve the preset default — don't overwrite with undefined.
+                continue
+              }
+              value = undefined
+            } else {
+              value = coerceBySchema(value, schemaInfo.jsonSchema, schemaInfo.optionName)
             }
-            value = undefined
-          } else {
-            value = coerceBySchema(value, schemaInfo.jsonSchema, schemaInfo.optionName)
+          } else if (value === true && optionalValueOptions.has(key)) {
+            // Untyped optional-value flag with no schema: normalize bare `true`
+            // to `''` so callers get a clean `string | undefined` shape. `''`
+            // means "flag passed with no argument", distinct from `undefined`
+            // (flag omitted). This matches the new type inference that treats
+            // `[value]` as `string` instead of `string | boolean`.
+            value = ''
           }
-        } else if (value === true && optionalValueOptions.has(key)) {
-          // Untyped optional-value flag with no schema: normalize bare `true`
-          // to `''` so callers get a clean `string | undefined` shape. `''`
-          // means "flag passed with no argument", distinct from `undefined`
-          // (flag omitted). This matches the new type inference that treats
-          // `[value]` as `string` instead of `string | boolean`.
-          value = ''
         }
 
         setDotProp(options, keys, value)
@@ -2316,6 +2326,8 @@ interface DocPage {
 interface GenerateDocsOptions {
   /** The Goke CLI instance to generate docs from. */
   cli: Goke<any>
+  /** Base path prefix for links between pages (e.g. "/docs/cli"). Defaults to ".". */
+  basePath?: string
 }
 
 /**
@@ -2334,13 +2346,15 @@ interface GenerateDocsOptions {
  *   .command('deploy <env>', 'Deploy to an environment')
  *   .option('--force', 'Skip confirmation')
  *
- * const pages = generateDocs({ cli })
+ * const pages = generateDocs({ cli, basePath: '/docs/cli' })
  * for (const page of pages) {
  *   fs.writeFileSync(`docs/${page.slug}.md`, page.content)
  * }
  * ```
  */
-function generateDocs({ cli }: GenerateDocsOptions): DocPage[] {
+function generateDocs({ cli, basePath = '.' }: GenerateDocsOptions): DocPage[] {
+  // Normalize: strip trailing slash
+  basePath = basePath.replace(/\/+$/, '') || '.'
   const pages: DocPage[] = []
 
   // Collect global options (from globalCommand), excluding deprecated
@@ -2365,9 +2379,9 @@ function generateDocs({ cli }: GenerateDocsOptions): DocPage[] {
     lines.push('|---------|-------------|')
     for (const cmd of visibleCommands) {
       if (cmd.isDefaultCommand) continue
-      const desc = cmd.description.split('\n')[0].trim()
+      const desc = escapeAngleBrackets(cmd.description.split('\n')[0].trim())
       const slug = cmd.name.replace(/\s+/g, '-')
-      lines.push(`| [\`${cmd.name}\`](./${slug}.md) | ${desc} |`)
+      lines.push(`| [\`${cmd.name}\`](${basePath}/${slug}.md) | ${desc} |`)
     }
     lines.push('')
 
@@ -2390,7 +2404,7 @@ function generateDocs({ cli }: GenerateDocsOptions): DocPage[] {
     lines.push('')
 
     if (cmd.description) {
-      lines.push(cmd.description)
+      lines.push(escapeAngleBrackets(cmd.description))
       lines.push('')
     }
 
@@ -2462,6 +2476,19 @@ function generateDocs({ cli }: GenerateDocsOptions): DocPage[] {
   return pages
 }
 
+/**
+ * Wraps bare `<word>` angle-bracket placeholders in backticks so MDX parsers
+ * don't interpret them as JSX tags. Skips content already inside inline code
+ * (single backticks) or fenced code blocks.
+ */
+function escapeAngleBrackets(text: string): string {
+  // Split on inline code spans to avoid double-wrapping
+  return text.replace(/(`.+?`)|(<[a-zA-Z_][\w.-]*>)/g, (match, codeSpan) => {
+    if (codeSpan) return match // already inside backticks
+    return `\`${match}\``
+  })
+}
+
 function formatOptionsTable(options: Option[]): string {
   const lines: string[] = []
   lines.push('| Option | Default | Description |')
@@ -2469,7 +2496,7 @@ function formatOptionsTable(options: Option[]): string {
   for (const opt of options) {
     const defaultVal = opt.default !== undefined ? `\`${String(opt.default)}\`` : '-'
     // Escape pipe characters in description for markdown tables
-    const desc = opt.description.replace(/\|/g, '\\|').replace(/\n/g, ' ')
+    const desc = escapeAngleBrackets(opt.description.replace(/\|/g, '\\|').replace(/\n/g, ' '))
     lines.push(`| \`${opt.rawName}\` | ${defaultVal} | ${desc} |`)
   }
   return lines.join('\n')