feat(spec): refuse a detached value when require_equals is set

[jdx]

Stacked on #1012.

Accept --flag=value and refuse --flag value, which is clap's require_equals and aube's --inspect. A short's attached form (-i9229, -i=9229) still binds.

Carried through the spec (require_equals=#true), usage-lib, usage-argv (Flag::require_equals), #[usage(require_equals)], the clap bridge (Arg::is_require_equals_set), and gen-shadow.

This comment was generated by Claude Code.

  

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Central YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: f369b791-f424-41a2-8b8e-e096faa68e1d

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 5905697. Configure here.}

[github-actions]

Instruction counts

benchmark	trend	instructions	Δ	wall (min)	Δ
markdown	▂▁▃▃█▂▂▄▃	196,170,707 → 196,131,741	-0.02%	17.41 → 17.92ms	+2.91%
startup	█▁█████▇█	829,134 → 829,292	+0.02%	0.81 → 0.82ms	+1.02%

No instruction-count regression above 1%.

_{Only instruction counts gate. Wall clock is shown for context — on identical hardware it moves 4-20% run to run.}

_{Measured by tak — instruction-counted CLI benchmarks, stored in this repository's git notes.}

Shadow comparison

Parsing mise use -g node@20 against a shadow of mise's committed spec.
Reported, not gated: the shadow grows as the derive learns to express more, so
what to watch is the ratio rather than either column.

framework	instructions, cold parse	vs usage
usage	4216	—
argh	6292	1.5x
clap	5895248	1398x
bpaf	21917796	5198x

                                              min       p01       p10    median
usage-rs: argv -> struct                      206       209       213       221  ns
argh: argv -> struct                          271       276       281       289  ns
clap: build tree + parse -> struct         487816    489219    492691    506289  ns
bpaf: build parser + parse -> struct      1611972   1611972   1618790   1635280  ns

usage: argv -> struct                             205 ns      0.21 µs
clap: build tree + parse -> struct             498415 ns    498.42 µs
clap: parse -> struct, tree reused              23583 ns     23.58 µs
clap: build tree only                          309014 ns    309.01 µs

_{6ce760db96bd vs 0e4e896da5ac · measured on the runner, not pushed to the history.}