chore(deps): bump clap_usage from v6.9.0 to v6.10.0

[dependabot]

Bumps clap_usage from v6.9.0 to v6.10.0.

Release notes

Sourced from clap_usage's releases.

v6.10.0: Default-subcommand help pages, typed Go CLI fields, and Go help/version rendering

Help output can now mark and append the default subcommand's page, usage generate go can emit typed struct fields, and the Go runtime gains argv.RenderRequest plus fixes so generated parsers actually surface --help and --version. Embedders that parse spec text also get proper diagnostics, a path for relative includes, and environment-variable expansion in include paths.

Added

• (help) Mark the default subcommand and optionally append its help page (#1424, @​lu-zero). A visible default_subcommand is now listed with (default) in the command list. The new default_subcommand_help #true setting (Rust: #[usage(default_subcommand_help)]) appends the default child's own page after the parent's, so ex --help shows the default command's flags and args without hoisting them into the root grammar. Hidden defaults are neither marked nor appended, flatten_help skips the append since it already inlines every child, and usage lint reports default_subcommand_help without a default_subcommand. Supported in the Rust and Go help renderers. Fixes #1423.

  default_subcommand "install"
  default_subcommand_help #true
  cmd "install" help="Put a package on the system" {
      flag "-u --update"
      arg "[package]"
  }

• (go) Explicitly typed fields from usage generate go (#1441, @​zeitlinger). The repeatable --field-type KEY=TYPE flag binds a generated flag or argument key constant (for example FlagTimeout or FlagRunTimeout) to int, int64, uint64, float64, bool, or duration (time.Duration); variadic entries become typed slices. Conversion happens once on the final resolved value after argv/env/default precedence and validation, and invalid values return argv.CodeInvalidValue. Unknown keys, duplicate bindings, unsupported types, and valueless or count flags are rejected at generation time. Library callers get usage::go::generate_with_types and ValueType; unconfigured output is unchanged. Typed output requires the runtime from this release (argv.NativeInt).

  usage generate go -f mycli.usage.kdl -o tables.go \
    --field-type FlagTimeout=duration --field-type FlagJobs=int

• (go) argv.RenderRequest renders help and version requests (#1439, @​zeitlinger). Go applications no longer need to rebuild the command chain and pick a renderer themselves: pass the parser's CodeHelp/CodeVersion error, the help metadata, root command, and the same words given to the parser, and get back the rendered text. It handles short, long, and recursive help plus short/long version (falling back to Version when LongVersion is empty), preserves invoked aliases and shared-command ancestry, and includes inherited globals from the correct route. Output, write errors, and exit status stay with the caller; ordinary errors return ("", false).

  meta := HelpMeta
  meta.Version = buildVersion
  if text, handled := argv.RenderRequest(request, meta, Root, args, HelpText); handled {
      io.WriteString(os.Stdout, text)
  }

• (spec) Environment variables in include paths (#1446, @​jdx). Spec::parse_str_with_path_and_env accepts an environment map so include file="$CONFIG_ROOT/shared.usage.kdl" expands $NAME and ${NAME} (with $$ for a literal dollar sign) without mutating the process environment. Undefined variables return a diagnostic, nested includes inherit the same map, and relative paths still resolve from the declaring file. Expansion applies only to include paths.

• (spec) Spec::parse_str_with_path (#1443, @​jdx). Callers that extract spec text from a larger file (script comments, a rendered template) can now say which file it came from, so relative include paths resolve against it. FromStr still rejects relative includes since it has no path to resolve them against.

Fixed

• (go) Generated Go parsers return help and version requests (#1437, @​zeitlinger). Generated Parse previously ignored the built-in -h/--help and -V/--version flags, so a CLI with required arguments reported a missing argument and one without could continue into normal execution. They now become CodeHelp/CodeVersion errors that preserve the selected command and short/long spelling; declared flags that shadow the built-ins still bind normally, and disabled built-ins stay disabled. Regenerate your Go code to pick this up.
• (go) argv.Walk keeps the full help-topic command chain (#1440, @​zeitlinger). Walk(root, []string{"help", "config", "ls"}) resolved Cmd to ls but left Chain containing only the root, so the help renderers selected the wrong page and dropped the topic's ancestors. The chain now follows the actual parsed route, including through commands shared by more than one parent.
• (help) No repeated global flags on the appended default-subcommand page (#1436, @​lu-zero). With default_subcommand_help, a root flag declared global (such as --color) appeared once under the root's Flags: and again under the appended child's Global flags:. The appended page now omits its Global flags: section, in both the Rust and Go renderers.
• (parse) Suggest -- when a refused flag could have been a value (#1430, @​jdx). mise exec node --version only offered tip: a similar argument exists: '--verbose', even though exec can only take that value after --. Following clap's rule, the error now also prints tip: to pass '--version' as a value, use '-- --version' when the command takes positionals and no -- precedes the token, and either there is no close spelling match or a positional is double_dash = "required"/"automatic". Ordinary typos still get only the spelling suggestion, and nothing is offered once a -- has already been typed or when the command takes no positionals. Related to jdx/mise#13202.
• (spec) String-parsed specs get proper diagnostics (#1443, @​jdx). A spec parsed via str::parse::<Spec>() had no source text attached, so errors like unsupported flag key bogus_key rendered a caret under a blank line at 1:1. The diagnostic now points at the offending line and column, which is what embedders such as mise show for a task's usage field.
• (spec) Include resolution is logged at debug instead of info (#1444, @​jdx). It was the library's only info! call, so embedders whose loggers show info by default (mise, for every task run using a shared .usage.kdl) printed an include: /path/... line on every invocation.

New Contributors

• @​zeitlinger made their first contribution in #1440

... (truncated)

Changelog

Sourced from clap_usage's changelog.

6.10.0 - 2026-09-19

🚀 Features

• (go) generate explicitly typed CLI fields by @​zeitlinger in #1441
• (help) mark the default subcommand and opt in to appending its page by @​lu-zero in #1424
• (parse) render Go help and version requests by @​zeitlinger in #1439
• (spec) expand environment variables in include paths by @​jdx in #1446

🐛 Bug Fixes

• (cli) migrate to rmcp 3.4 server config by @​jdx in #1448
• (complete) preserve the full Go help-topic command chain by @​zeitlinger in #1440
• (help) drop repeated global flags from the appended default-subcommand page by @​lu-zero in #1436
• (parse) suggest -- when a refused flag could have been a value by @​jdx in #1430
• (parse) return help and version requests from generated Go parsers by @​zeitlinger in #1437
• (spec) give a string-parsed spec its source by @​jdx in #1443
• (spec) log include resolution at debug level by @​jdx in #1444

🛡️ Security

• (deps) update dependency aube to latest by @​renovate[bot] in #1433
• (deps) update node.js to 24 by @​renovate[bot] in #1434
• stop clipping the GitHub star count in the nav overflow menu by @​jdx in #1429
• add entire trail runners by @​jdx in #1445

🔍 Other Changes

• remove entire and codex agent hooks by @​jdx in 5a9da44
• refresh aube-lock workflow pin by @​jdx in #1447

📦️ Dependency Updates

• bump mbx to 1.11.1 by @​jdx in 8f406f0
• update dependency github:jdx/tak to v0.0.10 by @​renovate[bot] in #1431
• update dependency cargo-binstall to v1.23.0 by @​renovate[bot] in #1432
• update dependency hk to latest by @​renovate[bot] in #1435

6.9.1 - 2026-09-14

🐛 Bug Fixes

• (docs) align benchmark section by @​jdx in 1f0d82f
• (parse) keep implicit default after a default-only flag by @​lu-zero in #1418

🔍 Other Changes

• (go) tidy the Go modules, require Go 1.26, and run go fix by @​sahidvelji in #1421
• (go) lint every Go module with gofumpt, golangci-lint, and go fix by @​sahidvelji in #1425
• replace lefthook with hk for git hooks by @​sahidvelji in #1422

... (truncated)

Commits

• d5f56ec chore: release v6.10.0 (#1428)
• ef04a40 chore: refresh aube-lock workflow pin (#1447)
• da558f7 fix(cli): migrate to rmcp 3.4 server config (#1448)
• 909a9ed feat(parse): render Go help and version requests (#1439)
• 98497e1 feat(spec): expand environment variables in include paths (#1446)
• b07f784 chore: add entire trail runners (#1445)
• 5a9da44 chore: remove entire and codex agent hooks
• 53587a0 feat(go): generate explicitly typed CLI fields (#1441)
• 8696ba8 fix(complete): preserve the full Go help-topic command chain (#1440)
• c790e97 fix(spec): log include resolution at debug level (#1444)
• Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

[dependabot]

Superseded by #16.