[gen740]

Summary

• add relation metadata APIs: together, conflicts, and depends_on
• validate relations at parse time and render them in generated help
• add hidden/deprecated metadata plus default/env/required help rendering
• split argument base tags and validation helpers into dedicated headers

Validation

• nix run .#build
• ctest --test-dir build --output-on-failure

[Copilot]

Pull request overview

This PR extends the CLI20 schema/help system with first-class “relation” metadata (groups, conflicts, depends_on), adds hidden/deprecated/default/env/required metadata rendering in generated help, and refactors argument base tags + compile-time validation into dedicated headers.

Changes:

• Add cli::relations(...) API with group, conflicts, and depends_on, including compile-time schema checks and parse-time validation.
• Enhance help generation with hidden/deprecated fields and inline metadata (required/env/default + relation hints), plus a customizable ANSI palette.
• Add docs + examples for relations and update the docs playground to render ANSI output.

Reviewed changes

Copilot reviewed 25 out of 26 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
tests/test_parse.cc	Adds relation schema fixtures + parse-time validation tests.
tests/test_help.cc	Updates color/help expectations; adds tests for hidden/deprecated/metadata + relations rendering.
include/cli/relation.hh	Introduces relation model types and builder functions (group/conflicts/depends_on/relations).
include/cli/parser.hh	Validates relations after required/env handling; extends format_help to accept a palette.
include/cli/help.hh	Renders hidden/deprecated/default/env/required and relation metadata; adds “Option groups” section; palette-aware styling.
include/cli/color.hh	Renames color mode to detect and adds HelpPalette + palette-aware resolve_color.
include/cli/argument.hh	Adds hidden/deprecated fields to parameters; wires relation validation into ArgumentSpec; refactors includes.
include/cli/argument_validation.hh	New header for compile-time validation helpers, including relation well-formedness checks.
include/cli/argument_base.hh	New header containing tag base classes + Nargs/Presence primitives.
flake.nix	Updates docs npm dependency hash.
examples/relations.cc	Adds a runnable example demonstrating relations.
docs/src/components/ExamplePlayground.tsx	Renders ANSI output as HTML via ansi_up for docs playground output.
docs/sidebars.ts	Adds the new Relations doc page to the sidebar.
docs/package.json	Adds ansi_up dependency.
docs/package-lock.json	Locks ansi_up dependency.
docs/docs/relations.mdx	New documentation page describing relations API and behavior.
docs/docs/examples/relations.mdx	New example doc page for the relations example.
docs/docs/examples/index.mdx	Inserts Relations into the examples index and renumbers subsequent entries.
docs/docs/examples/git.mdx	Adjusts sidebar position/title numbering.
docs/docs/examples/env-fallback.mdx	Adjusts sidebar position/title numbering.
docs/docs/examples/distribution-and-platform.mdx	Adjusts sidebar position/title numbering.
docs/docs/examples/custom-action.mdx	Adjusts sidebar position/title numbering.
docs/docs/examples/compiler.mdx	Adjusts sidebar position/title numbering.
docs/docs/examples/callback-entry-point.mdx	Adjusts sidebar position/title numbering.
docs/docs/examples/bind.mdx	Adjusts sidebar position/title numbering.
docs/docs/examples/advanced.mdx	Adjusts sidebar position/title numbering.

Files not reviewed (1)

• docs/package-lock.json: Language not supported

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.