# Flag names documentation may mention even though the CLI does not accept them.
#
# The CLI-surface doc lint (see CONTRIBUTING.md) checks every brutus invocation in
# a fenced code block, every backticked flag name in prose, and every flag name in
# a Go comment under cmd/ and pkg/ against the flags cobra actually registers.
# This file is the escape hatch for deliberate mentions. Every entry MUST carry a
# '#' reason: the gate rejects an entry without one, because an unexplained
# exception is how a stale flag reference survives forever.
#
# Keep this list as short as possible. If a mention is not deliberate, fix the
# document instead of allowing it.

--reveal            # Apollo's old reveal flag, renamed to --enrich by the discover/enrich split. The apollo command test deliberately names the removed flag to pin the new behavior: "Discovery note must mention --enrich (not --reveal)".
--domain-generated  # Not a flag: a prose compound. The enum-source comments say "--domain-generated candidates", meaning the candidates generated from --domain.
--allow-undefined   # Not a brutus flag: a wasm-ld linker flag. build.sh passes it via RUSTFLAGS so the Go host functions declared in host_io.rs are emitted as wasm imports rather than failing as undefined symbols; the rdp wasm-freshness test explains why the artifact cannot be built without it.
