goke 6.6.1 → 6.7.0

package/README.md

@@ -654,6 +654,60 @@ When using brackets in option name, angled brackets indicate that a string / num
 
 **Optionality is determined solely by bracket syntax, not by the schema.** `[square brackets]` makes an option optional regardless of whether the schema is `z.string()` or `z.string().optional()`. The schema's `.optional()` is never consulted for this — it only affects type coercion. This means `z.string()` with `[--name]` is treated as optional: if the flag is omitted, `options.name` is `undefined` even though the schema has no `.optional()`.
 
+### Optional-value flags — `--flag` vs `--flag value` vs omitted
+
+A flag declared with square brackets (`--host [host]`) has **three distinct runtime states**, not two. The user can:
+
+1. **Omit the flag entirely** — no `--host` on the command line at all
+2. **Pass the flag bare** — `--host` by itself, with no value following it
+3. **Pass the flag with a value** — `--host example.com`
+
+goke surfaces all three cases through a single `string | undefined` type. There is no `boolean` in the union — bare flags are normalized to the **empty string `''`** so callers only ever deal with strings:
+
+```ts
+cli
+  .command('serve', 'Start the server')
+  .option('--host [host]', 'Optional host override')
+  .action((options) => {
+    // options.host: string | undefined
+    //   --host              → ''                (flag present, no value)
+    //   --host example.com  → 'example.com'
+    //   (omitted)           → undefined
+  })
+```
+
+**Detecting each case:**
+
+```ts
+.action((options) => {
+  if (options.host === undefined) {
+    // Flag was not passed at all — use a sensible default
+    console.log('using default host: localhost')
+  } else if (options.host === '') {
+    // Flag was passed bare: `--host` with no value following it
+    // Treat this as an explicit "opt in, but use the default/automatic value"
+    console.log('host flag passed with no value — enabling auto-discovery')
+  } else {
+    // Flag was passed with an explicit value
+    console.log(`host = ${options.host}`)
+  }
+})
+```
+
+**In most cases you don't need the three-way distinction** — a plain truthy check collapses "omitted" and "bare flag" into the same "fall back to default" branch:
+
+```ts
+.action((options) => {
+  // `--host` bare AND omitted both fall through to the default
+  const host = options.host || 'localhost'
+  startServer({ host })
+})
+```
+
+Reserve the `=== ''` check for cases where "opt in without a value" is a meaningful signal distinct from "flag omitted" — for example, `--direct` meaning "auto-discover a Chrome instance" vs `--direct ws://…` meaning "connect to this specific endpoint" vs no `--direct` meaning "don't use direct mode".
+
+> **Breaking change note (goke 6.6.0):** prior versions surfaced bare flags as `boolean` `true` inside a `string | boolean | undefined` union, forcing every call site to write `typeof options.host === 'string' ? options.host : undefined`. Code that used `options.host === true` to detect the bare-flag case must be updated to `options.host === ''`. Schema-based optional flags with `.default(...)` are unaffected — the default still kicks in when the flag is passed bare.
+
 ### Negated Options
 
 To allow an option whose value is `false`, you need to manually specify a negated option:
@@ -684,6 +738,8 @@ cli
 
 The `--` token signals the end of options. Everything after `--` is available via `options['--']` as a separate array, not mixed into positional args. This lets you distinguish between your command's own arguments and passthrough args — the same pattern used by `doppler`, `npm`, `pnpm`, and `docker`.
 
+`options['--']` is **always present** on the inferred options type as `string[]`. When no `--` token appears on the command line, it's the empty array — you never need to guard with `||` or `?.` or an `Array.isArray` cast.
+
 ```ts
 import { goke } from 'goke'
 import { z } from 'zod'
@@ -700,10 +756,10 @@ cli
     // runner run --env staging server.js -- --port 3000 --verbose
     // script = 'server.js'           (positional arg)
     // options.env = 'staging'         (runner's own option)
-    // options['--'] = ['--port', '3000', '--verbose']  (passthrough)
+    // options['--'] = ['--port', '3000', '--verbose']  (passthrough, always string[])
 
     const secrets = loadSecrets(options.env)
-    const extraArgs = (options['--'] || []).join(' ')
+    const extraArgs = options['--'].join(' ')
     execSync(`node ${script} ${extraArgs}`, {
       env: { ...process.env, ...secrets },
       stdio: 'inherit',
@@ -915,6 +971,90 @@ Always run `acme --help` before using this CLI.
 For subcommand details: `acme <command> --help`
 ````
 
+## YAML Output for Agent-Friendly CLIs
+
+When a command returns structured data, print it as YAML on stdout. YAML is the best middle ground between human-readable output and machine-processable output:
+
+- Humans can read it at a glance — no surrounding quotes on keys, less punctuation noise than JSON.
+- Agents can process it with [`yq`](https://github.com/mikefarah/yq), the YAML equivalent of `jq`, to extract specific fields or filter results.
+- It is more context-efficient than verbose prose: a compact YAML block conveys the same information in fewer tokens.
+
+```ts
+import { goke } from 'goke'
+import { stringify } from 'yaml'
+
+const cli = goke('deploy')
+
+cli
+  .command('status', 'Show deployment status')
+  .action(async (options, { console }) => {
+    const status = await fetchStatus()
+    // Output structured data as YAML on stdout
+    console.log(stringify(status))
+  })
+```
+
+Example output:
+
+```yaml
+deployment: prod-v2
+status: running
+replicas: 3
+lastDeploy: "2026-01-15T10:30:00Z"
+health:
+  cpu: 42%
+  memory: 1.2GB
+```
+
+### Processing YAML output with yq
+
+Agents can pipe the output through `yq` to extract specific fields or filter results — the same way they would use `jq` with JSON, but with cleaner, more readable output:
+
+```bash
+# Extract a single field
+deploy status | yq '.deployment'
+
+# Access nested fields
+deploy status | yq '.health.cpu'
+
+# Filter an array of results
+deploy list | yq '.[] | select(.status == "running")'
+
+# Combine multiple fields
+deploy list | yq '.[] | {name: .name, status: .status}'
+
+# Count items matching a condition
+deploy list | yq '[.[] | select(.status == "error")] | length'
+```
+
+### Keep stdout clean — send non-YAML to stderr
+
+If a command outputs YAML on stdout, all unrelated content must go to stderr: error messages, progress indicators, informational logs, warnings. This keeps stdout pipeable through `yq` without breaking the YAML parse.
+
+```ts
+cli
+  .command('deploy <env>', 'Deploy to environment')
+  .action(async (env, options, { console }) => {
+    // Progress and logs → stderr (won't pollute yq pipes)
+    console.error(`Deploying to ${env}...`)
+    console.error('Building artifacts...')
+
+    const result = await deploy(env)
+
+    // Structured result → stdout as YAML
+    console.log(stringify(result))
+  })
+```
+
+Now agents can process the output cleanly:
+
+```bash
+# Only the YAML result reaches yq — progress lines go to the terminal
+deploy deploy production | yq '.version'
+```
+
+If an error occurs, throw or write to `console.error` / `process.stderr`, and exit with a non-zero code. Never mix error text into stdout when the command is expected to output YAML.
+
 ## Contributor Notes
 
 ### Rules

package/dist/__test__/index.test.js

@@ -568,6 +568,46 @@ describe('regression: oracle-found issues', () => {
         const { options } = cli.parse('node bin --count 42'.split(' '));
         expect(options.count).toBe(42);
     });
+    test('optional value option with schema default returns default when omitted', () => {
+        // `z.number().default(30)` has input `number | undefined` → output `number`,
+        // so goke marks this option as effectively required and must surface the
+        // default value at runtime when the flag is omitted.
+        const cli = goke();
+        cli.option('--limit [n]', z.number().default(30).describe('Max items'));
+        const { options } = cli.parse('node bin'.split(' '));
+        expect(options.limit).toBe(30);
+    });
+    test('optional value option with schema default returns default when passed bare', () => {
+        // Bare `--limit` is mri's "flag present, no value" sentinel. Without a
+        // default, goke replaces it with `undefined`. With a default, goke must
+        // preserve the preset default value instead of clobbering it, so the
+        // type-level `HasSchemaDefault` promise ("property is required at runtime")
+        // holds for all three input states: omitted, bare, and with-value.
+        const cli = goke();
+        cli.option('--limit [n]', z.number().default(30).describe('Max items'));
+        const { options } = cli.parse('node bin --limit'.split(' '));
+        expect(options.limit).toBe(30);
+    });
+    test('optional value option with schema default coerces explicit value', () => {
+        const cli = goke();
+        cli.option('--limit [n]', z.number().default(30).describe('Max items'));
+        const { options } = cli.parse('node bin --limit 5'.split(' '));
+        expect(options.limit).toBe(5);
+    });
+    test('multiple optional options with defaults all preserve their defaults', () => {
+        // Regression test for the runtime-overwrite bug: when several schema-backed
+        // optional flags have defaults, passing one bare should not clobber the
+        // others, and the bare one should keep its own default.
+        const cli = goke();
+        cli
+            .option('--limit [n]', z.number().default(30))
+            .option('--sort [mode]', z.enum(['asc', 'desc']).default('asc'))
+            .option('--host [host]', z.string().default('localhost'));
+        const { options } = cli.parse('node bin --sort'.split(' '));
+        expect(options.limit).toBe(30);
+        expect(options.sort).toBe('asc');
+        expect(options.host).toBe('localhost');
+    });
     test('alias + schema coercion works', () => {
         const cli = goke();
         cli.option('-p, --port <port>', z.number().describe('Port'));
@@ -606,9 +646,13 @@ describe('edge cases: schema + defaults interaction', () => {
         // Passed with value → coerced
         const { options: opts2 } = cli.parse('node bin --count 42'.split(' '));
         expect(opts2.count).toBe(42);
-        // Passed without value → undefined (sentinel replaced)
+        // Passed without value → default preserved. Before goke 6.7.0 this test
+        // expected `undefined` because the bare-flag sentinel overwrote the
+        // preset default. With the HasSchemaDefault type inference, the runtime
+        // must keep the default so that the type-level promise ("options.count
+        // is always a number") holds for all three input states.
         const { options: opts3 } = cli.parse('node bin --count'.split(' '));
-        expect(opts3.count).toBe(undefined);
+        expect(opts3.count).toBe(10);
     });
 });
 describe('edge cases: boolean flags + schema', () => {

package/dist/__test__/types.test-d.js

@@ -288,6 +288,65 @@ describe('type-level: command() .action() option inference', () => {
             expectTypeOf(options.verbose).toEqualTypeOf();
         });
     });
+    test('schema with .default() on [value] is typed as required', () => {
+        // `z.number().default(30)` has Standard Schema input `number | undefined`
+        // but output `number`, so goke recognizes it as "effectively required"
+        // even though the bracket syntax is `[...]`. The property should NOT
+        // be optional in the action options — the runtime always produces 30
+        // when the flag is omitted or passed bare.
+        goke('test')
+            .command('list', 'List stuff')
+            .option('--limit [n]', z.number().default(30).describe('Max items'))
+            .option('--sort [mode]', z.enum(['asc', 'desc']).default('asc'))
+            .action((options) => {
+            expectTypeOf(options.limit).toEqualTypeOf();
+            expectTypeOf(options.sort).toEqualTypeOf();
+        });
+    });
+    test('schema without .default() on [value] stays optional', () => {
+        // Without a default, `[value]` remains genuinely optional at the type
+        // level — bare flag or omitted flag both produce `undefined`.
+        goke('test')
+            .command('list', 'List stuff')
+            .option('--limit [n]', z.number().describe('Max items'))
+            .option('--filter [pattern]', z.string())
+            .action((options) => {
+            expectTypeOf(options.limit).toEqualTypeOf();
+            expectTypeOf(options.filter).toEqualTypeOf();
+        });
+    });
+    test('z.string().optional() on [value] stays optional (no default)', () => {
+        // `.optional()` makes both input and output allow undefined, so
+        // HasSchemaDefault is false and the bracket-based optionality wins.
+        goke('test')
+            .command('serve', 'Start server')
+            .option('--host [host]', z.string().optional().describe('Host'))
+            .action((options) => {
+            expectTypeOf(options.host).toEqualTypeOf();
+        });
+    });
+    test('.default() combined with .optional() stays optional', () => {
+        // `z.number().default(30).optional()` has Input `number | undefined` AND
+        // Output `number | undefined`, so HasSchemaDefault is false — the user
+        // explicitly opted out of the default-inferred-as-required behavior by
+        // re-adding `.optional()`.
+        goke('test')
+            .command('list', 'List stuff')
+            .option('--limit [n]', z.number().default(30).optional())
+            .action((options) => {
+            expectTypeOf(options.limit).toEqualTypeOf();
+        });
+    });
+    test('.default() on <required> is typed as required output', () => {
+        // With `<value>` syntax the property is already required; the schema
+        // default just narrows the output type. This is the "old" behavior.
+        goke('test')
+            .command('serve', 'Start server')
+            .option('--port <port>', z.number().default(3000))
+            .action((options) => {
+            expectTypeOf(options.port).toEqualTypeOf();
+        });
+    });
     test('accessing a non-existent option in action is a type error', () => {
         goke('test')
             .command('serve', 'Start server')
@@ -339,6 +398,11 @@ describe('type-level: README TypeScript examples', () => {
         });
     });
     test('README global options and middleware example stays typed end-to-end', () => {
+        // `z.boolean().default(false)` and `z.string().default(...)` are
+        // effectively required at runtime: the default applies when the flag is
+        // omitted or passed bare, so goke types the property as required (no
+        // `| undefined`). Raw untyped boolean flags like `--dry-run` stay
+        // `boolean | undefined`.
         goke('mycli')
             .option('--verbose', z.boolean().default(false).describe('Enable verbose logging'))
             .option('--api-url [url]', z.string().default('https://api.example.com').describe('API base URL'))

package/dist/goke.d.ts

@@ -53,8 +53,24 @@ type ExtractOptionName<S extends string> = S extends `${string}--${infer Name} <
  * Determines if an option takes a required value (<...>) vs optional ([...]) vs boolean flag.
  */
 type IsOptionalOption<S extends string> = S extends `${string}<${string}>` ? false : true;
+/**
+ * Infer the input type from a StandardTypedV1-compatible schema.
+ *
+ * For Zod, this is the type accepted by `.parse()` before any transforms or
+ * defaults are applied (e.g. `z.number().default(30)` has input `number | undefined`).
+ */
+type InferSchemaInput<S> = S extends {
+    readonly "~standard": {
+        readonly types?: {
+            readonly input: infer I;
+        };
+    };
+} ? I : unknown;
 /**
  * Infer the output type from a StandardTypedV1-compatible schema.
+ *
+ * For Zod, this is the type produced by `.parse()` after transforms/defaults
+ * run (e.g. `z.number().default(30)` has output `number`).
  */
 type InferSchemaOutput<S> = S extends {
     readonly "~standard": {
@@ -63,12 +79,33 @@ type InferSchemaOutput<S> = S extends {
         };
     };
 } ? O : unknown;
+/**
+ * Detects whether a Standard Schema has a "default" behavior: its input allows
+ * `undefined` but its output does not. This matches `z.number().default(30)`
+ * and similar `.default(...)` wrappers in other libraries: the schema fills
+ * in a value whenever the caller omits it, so at runtime the property is
+ * always populated and goke can mark it as required in the options type even
+ * when the option is declared with `[value]` square brackets.
+ *
+ * The `unknown extends Input` guard excludes the `wrapJsonSchema` path, where
+ * input defaults to `unknown` because the hand-written schema has no way to
+ * express a separate input type. For those schemas we fall back to the raw
+ * bracket-based optionality, which keeps existing behavior for consumers
+ * that use `wrapJsonSchema<T>()` for truly optional options.
+ */
+type HasSchemaDefault<S> = unknown extends InferSchemaInput<S> ? false : undefined extends InferSchemaInput<S> ? undefined extends InferSchemaOutput<S> ? false : true : false;
 /**
  * Build the option type entry for a single .option() call.
- * Required options (<...>) produce a required key.
- * Optional options ([...]) and boolean flags produce an optional key.
+ *
+ * Required options (`<...>`) produce a required key.
+ * Optional options (`[...]`) produce an optional key, EXCEPT when the schema
+ * has an effective default (see `HasSchemaDefault`) — in that case goke's
+ * runtime always surfaces the default value, so the property is typed as
+ * required with the post-coercion output type.
  */
-type OptionEntry<RawName extends string, Schema> = IsOptionalOption<RawName> extends true ? {
+type OptionEntry<RawName extends string, Schema> = IsOptionalOption<RawName> extends true ? HasSchemaDefault<Schema> extends true ? {
+    [K in ExtractOptionName<RawName>]: InferSchemaOutput<Schema>;
+} : {
     [K in ExtractOptionName<RawName>]?: InferSchemaOutput<Schema>;
 } : {
     [K in ExtractOptionName<RawName>]: InferSchemaOutput<Schema>;

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

@@ -1105,8 +1105,13 @@ class Goke extends EventEmitter {
         // For optional options ([...]) we want a single, uniform shape: `string`
         // with `''` meaning "flag present but no value" — callers get clean
         // `string | undefined` types instead of `string | boolean | undefined`.
+        // The `optionsWithDefault` set tracks options whose schema produced a
+        // non-undefined default — when the user passes such an option bare, we
+        // keep the preset default instead of overwriting it with `undefined`,
+        // which matches what the new `HasSchemaDefault` type inference promises.
         const requiredValueOptions = new Set();
         const optionalValueOptions = new Set();
+        const optionsWithDefault = new Set();
         for (const cliOption of cliOptions) {
             if (cliOption.required === true) {
                 for (const name of cliOption.names) {
@@ -1118,6 +1123,11 @@ class Goke extends EventEmitter {
                     optionalValueOptions.add(name);
                 }
             }
+            if (cliOption.default !== undefined) {
+                for (const name of cliOption.names) {
+                    optionsWithDefault.add(name);
+                }
+            }
         }
         // Set option values (support dot-nested property name)
         // Apply schema-based coercion for options with schemas
@@ -1129,15 +1139,23 @@ class Goke extends EventEmitter {
                 // 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: replace with `undefined` so
-                //     any `.default(...)` on the schema kicks in (e.g. z.number().default(30)
-                //     should produce 30, not try to coerce the `''` empty-string sentinel).
+                //   - 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 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "goke",
-  "version": "6.6.1",
+  "version": "6.7.0",
   "type": "module",
   "description": "Simple yet powerful framework for building command-line apps. Inspired by cac.",
   "repository": {

package/src/__test__/index.test.ts

@@ -728,6 +728,54 @@ describe('regression: oracle-found issues', () => {
     expect(options.count).toBe(42)
   })
 
+  test('optional value option with schema default returns default when omitted', () => {
+    // `z.number().default(30)` has input `number | undefined` → output `number`,
+    // so goke marks this option as effectively required and must surface the
+    // default value at runtime when the flag is omitted.
+    const cli = goke()
+    cli.option('--limit [n]', z.number().default(30).describe('Max items'))
+
+    const { options } = cli.parse('node bin'.split(' '))
+    expect(options.limit).toBe(30)
+  })
+
+  test('optional value option with schema default returns default when passed bare', () => {
+    // Bare `--limit` is mri's "flag present, no value" sentinel. Without a
+    // default, goke replaces it with `undefined`. With a default, goke must
+    // preserve the preset default value instead of clobbering it, so the
+    // type-level `HasSchemaDefault` promise ("property is required at runtime")
+    // holds for all three input states: omitted, bare, and with-value.
+    const cli = goke()
+    cli.option('--limit [n]', z.number().default(30).describe('Max items'))
+
+    const { options } = cli.parse('node bin --limit'.split(' '))
+    expect(options.limit).toBe(30)
+  })
+
+  test('optional value option with schema default coerces explicit value', () => {
+    const cli = goke()
+    cli.option('--limit [n]', z.number().default(30).describe('Max items'))
+
+    const { options } = cli.parse('node bin --limit 5'.split(' '))
+    expect(options.limit).toBe(5)
+  })
+
+  test('multiple optional options with defaults all preserve their defaults', () => {
+    // Regression test for the runtime-overwrite bug: when several schema-backed
+    // optional flags have defaults, passing one bare should not clobber the
+    // others, and the bare one should keep its own default.
+    const cli = goke()
+    cli
+      .option('--limit [n]', z.number().default(30))
+      .option('--sort [mode]', z.enum(['asc', 'desc']).default('asc'))
+      .option('--host [host]', z.string().default('localhost'))
+
+    const { options } = cli.parse('node bin --sort'.split(' '))
+    expect(options.limit).toBe(30)
+    expect(options.sort).toBe('asc')
+    expect(options.host).toBe('localhost')
+  })
+
   test('alias + schema coercion works', () => {
     const cli = goke()
 
@@ -783,9 +831,13 @@ describe('edge cases: schema + defaults interaction', () => {
     const { options: opts2 } = cli.parse('node bin --count 42'.split(' '))
     expect(opts2.count).toBe(42)
 
-    // Passed without value → undefined (sentinel replaced)
+    // Passed without value → default preserved. Before goke 6.7.0 this test
+    // expected `undefined` because the bare-flag sentinel overwrote the
+    // preset default. With the HasSchemaDefault type inference, the runtime
+    // must keep the default so that the type-level promise ("options.count
+    // is always a number") holds for all three input states.
     const { options: opts3 } = cli.parse('node bin --count'.split(' '))
-    expect(opts3.count).toBe(undefined)
+    expect(opts3.count).toBe(10)
   })
 })
 

package/src/__test__/types.test-d.ts

@@ -362,6 +362,70 @@ describe('type-level: command() .action() option inference', () => {
       })
   })
 
+  test('schema with .default() on [value] is typed as required', () => {
+    // `z.number().default(30)` has Standard Schema input `number | undefined`
+    // but output `number`, so goke recognizes it as "effectively required"
+    // even though the bracket syntax is `[...]`. The property should NOT
+    // be optional in the action options — the runtime always produces 30
+    // when the flag is omitted or passed bare.
+    goke('test')
+      .command('list', 'List stuff')
+      .option('--limit [n]', z.number().default(30).describe('Max items'))
+      .option('--sort [mode]', z.enum(['asc', 'desc']).default('asc'))
+      .action((options) => {
+        expectTypeOf(options.limit).toEqualTypeOf<number>()
+        expectTypeOf(options.sort).toEqualTypeOf<'asc' | 'desc'>()
+      })
+  })
+
+  test('schema without .default() on [value] stays optional', () => {
+    // Without a default, `[value]` remains genuinely optional at the type
+    // level — bare flag or omitted flag both produce `undefined`.
+    goke('test')
+      .command('list', 'List stuff')
+      .option('--limit [n]', z.number().describe('Max items'))
+      .option('--filter [pattern]', z.string())
+      .action((options) => {
+        expectTypeOf(options.limit).toEqualTypeOf<number | undefined>()
+        expectTypeOf(options.filter).toEqualTypeOf<string | undefined>()
+      })
+  })
+
+  test('z.string().optional() on [value] stays optional (no default)', () => {
+    // `.optional()` makes both input and output allow undefined, so
+    // HasSchemaDefault is false and the bracket-based optionality wins.
+    goke('test')
+      .command('serve', 'Start server')
+      .option('--host [host]', z.string().optional().describe('Host'))
+      .action((options) => {
+        expectTypeOf(options.host).toEqualTypeOf<string | undefined>()
+      })
+  })
+
+  test('.default() combined with .optional() stays optional', () => {
+    // `z.number().default(30).optional()` has Input `number | undefined` AND
+    // Output `number | undefined`, so HasSchemaDefault is false — the user
+    // explicitly opted out of the default-inferred-as-required behavior by
+    // re-adding `.optional()`.
+    goke('test')
+      .command('list', 'List stuff')
+      .option('--limit [n]', z.number().default(30).optional())
+      .action((options) => {
+        expectTypeOf(options.limit).toEqualTypeOf<number | undefined>()
+      })
+  })
+
+  test('.default() on <required> is typed as required output', () => {
+    // With `<value>` syntax the property is already required; the schema
+    // default just narrows the output type. This is the "old" behavior.
+    goke('test')
+      .command('serve', 'Start server')
+      .option('--port <port>', z.number().default(3000))
+      .action((options) => {
+        expectTypeOf(options.port).toEqualTypeOf<number>()
+      })
+  })
+
   test('accessing a non-existent option in action is a type error', () => {
     goke('test')
       .command('serve', 'Start server')
@@ -418,20 +482,25 @@ describe('type-level: README TypeScript examples', () => {
   })
 
   test('README global options and middleware example stays typed end-to-end', () => {
+    // `z.boolean().default(false)` and `z.string().default(...)` are
+    // effectively required at runtime: the default applies when the flag is
+    // omitted or passed bare, so goke types the property as required (no
+    // `| undefined`). Raw untyped boolean flags like `--dry-run` stay
+    // `boolean | undefined`.
     goke('mycli')
       .option('--verbose', z.boolean().default(false).describe('Enable verbose logging'))
       .option('--api-url [url]', z.string().default('https://api.example.com').describe('API base URL'))
       .use((options, { process }) => {
-        expectTypeOf(options.verbose).toEqualTypeOf<boolean | undefined>()
-        expectTypeOf(options.apiUrl).toEqualTypeOf<string | undefined>()
+        expectTypeOf(options.verbose).toEqualTypeOf<boolean>()
+        expectTypeOf(options.apiUrl).toEqualTypeOf<string>()
         expectTypeOf(process.stdin).toEqualTypeOf<string>()
       })
       .command('deploy <env>', 'Deploy to an environment')
       .option('--dry-run', 'Preview without deploying')
       .action((env, options, ctx) => {
         expectTypeOf(env).toEqualTypeOf<string>()
-        expectTypeOf(options.verbose).toEqualTypeOf<boolean | undefined>()
-        expectTypeOf(options.apiUrl).toEqualTypeOf<string | undefined>()
+        expectTypeOf(options.verbose).toEqualTypeOf<boolean>()
+        expectTypeOf(options.apiUrl).toEqualTypeOf<string>()
         expectTypeOf(options.dryRun).toEqualTypeOf<boolean | undefined>()
         expectTypeOf(ctx).toEqualTypeOf<GokeExecutionContext>()
       })

package/src/goke.ts

@@ -332,20 +332,61 @@ type IsOptionalOption<S extends string> =
   S extends `${string}<${string}>` ? false :
   true
 
+/**
+ * Infer the input type from a StandardTypedV1-compatible schema.
+ *
+ * For Zod, this is the type accepted by `.parse()` before any transforms or
+ * defaults are applied (e.g. `z.number().default(30)` has input `number | undefined`).
+ */
+type InferSchemaInput<S> =
+  S extends { readonly "~standard": { readonly types?: { readonly input: infer I } } } ? I : unknown
+
 /**
  * Infer the output type from a StandardTypedV1-compatible schema.
+ *
+ * For Zod, this is the type produced by `.parse()` after transforms/defaults
+ * run (e.g. `z.number().default(30)` has output `number`).
  */
 type InferSchemaOutput<S> =
   S extends { readonly "~standard": { readonly types?: { readonly output: infer O } } } ? O : unknown
 
+/**
+ * Detects whether a Standard Schema has a "default" behavior: its input allows
+ * `undefined` but its output does not. This matches `z.number().default(30)`
+ * and similar `.default(...)` wrappers in other libraries: the schema fills
+ * in a value whenever the caller omits it, so at runtime the property is
+ * always populated and goke can mark it as required in the options type even
+ * when the option is declared with `[value]` square brackets.
+ *
+ * The `unknown extends Input` guard excludes the `wrapJsonSchema` path, where
+ * input defaults to `unknown` because the hand-written schema has no way to
+ * express a separate input type. For those schemas we fall back to the raw
+ * bracket-based optionality, which keeps existing behavior for consumers
+ * that use `wrapJsonSchema<T>()` for truly optional options.
+ */
+type HasSchemaDefault<S> =
+  unknown extends InferSchemaInput<S>
+    ? false
+    : undefined extends InferSchemaInput<S>
+      ? undefined extends InferSchemaOutput<S>
+        ? false
+        : true
+      : false
+
 /**
  * Build the option type entry for a single .option() call.
- * Required options (<...>) produce a required key.
- * Optional options ([...]) and boolean flags produce an optional key.
+ *
+ * Required options (`<...>`) produce a required key.
+ * Optional options (`[...]`) produce an optional key, EXCEPT when the schema
+ * has an effective default (see `HasSchemaDefault`) — in that case goke's
+ * runtime always surfaces the default value, so the property is typed as
+ * required with the post-coercion output type.
  */
 type OptionEntry<RawName extends string, Schema> =
   IsOptionalOption<RawName> extends true
-    ? { [K in ExtractOptionName<RawName>]?: InferSchemaOutput<Schema> }
+    ? HasSchemaDefault<Schema> extends true
+      ? { [K in ExtractOptionName<RawName>]: InferSchemaOutput<Schema> }
+      : { [K in ExtractOptionName<RawName>]?: InferSchemaOutput<Schema> }
     : { [K in ExtractOptionName<RawName>]: InferSchemaOutput<Schema> }
 
 /**
@@ -1619,8 +1660,13 @@ class Goke<Opts = {}> extends EventEmitter {
     // For optional options ([...]) we want a single, uniform shape: `string`
     // with `''` meaning "flag present but no value" — callers get clean
     // `string | undefined` types instead of `string | boolean | undefined`.
+    // The `optionsWithDefault` set tracks options whose schema produced a
+    // non-undefined default — when the user passes such an option bare, we
+    // keep the preset default instead of overwriting it with `undefined`,
+    // which matches what the new `HasSchemaDefault` type inference promises.
     const requiredValueOptions = new Set<string>()
     const optionalValueOptions = new Set<string>()
+    const optionsWithDefault = new Set<string>()
     for (const cliOption of cliOptions) {
       if (cliOption.required === true) {
         for (const name of cliOption.names) {
@@ -1631,6 +1677,11 @@ class Goke<Opts = {}> extends EventEmitter {
           optionalValueOptions.add(name)
         }
       }
+      if (cliOption.default !== undefined) {
+        for (const name of cliOption.names) {
+          optionsWithDefault.add(name)
+        }
+      }
     }
 
     // Set option values (support dot-nested property name)
@@ -1644,14 +1695,22 @@ class Goke<Opts = {}> extends EventEmitter {
         // 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: replace with `undefined` so
-        //     any `.default(...)` on the schema kicks in (e.g. z.number().default(30)
-        //     should produce 30, not try to coerce the `''` empty-string sentinel).
+        //   - 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)