test: golden-snapshot the CLI surface and guard schema drift

[JulianMaurin]

The CLI's contract (every flag, subcommand, value-hint, help string,
exit code) was only spot-checked structurally, so a dropped flag or
renamed leaf could regress unnoticed.

Add an insta JSON golden of the full generated schema (version
redacted, since it's release-stamped) — intentional CLI changes are
accepted with cargo insta review, accidental drift shows as a red
diff. Also assert directly that the stack subcommands in the schema
equal the NATIVE_COMMANDS registry, closing the two-list drift that
the old shim allowed (a deleted leaf used to vanish silently).

Co-Authored-By: Claude Opus 4.8 (1M context) noreply@anthropic.com

Depends-On: #1658

[mergify]

Merge Protections

🟢 All 7 merge protections satisfied — ready to merge.

Show 7 satisfied protections

🟢 ⛓️ Depends-On Requirements

Requirement based on the presence of Depends-On in the body of the pull request

• depends-on = Mergifyio/mergify-cli#1658 [⛓️ feat(cli): generate shell completions and a man page #1658]

🟢 🤖 Continuous Integration

• all of:
  • check-success=ci-gate

🟢 👀 Review Requirements

• any of:
  • #approved-reviews-by>=2
  • author = dependabot[bot]
  • author = mergify-ci-bot
  • author = renovate[bot]

🟢 Enforce conventional commit

Make sure that we follow https://www.conventionalcommits.org/en/v1.0.0/

• title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert|ui)(?:\(.+\))?:

🟢 🔎 Reviews

• #changes-requested-reviews-by = 0
• #review-requested = 0
• #review-threads-unresolved = 0

🟢 📕 PR description

• body ~= (?ms:.{48,})

🟢 🚦 Auto-queue

When all merge protections are satisfied, this pull request will be queued automatically.

[JulianMaurin]

This pull request is part of a Mergify stack:

#	Pull Request	Link
1	feat(cli): generate shell completions and a man page	#1658
2	test: golden-snapshot the CLI surface and guard schema drift	#1659	👈
3	refactor: dedupe the GIT_SEQUENCE_EDITOR lookup and drop port cruft	#1660
4	docs(agents): rewrite AGENTS.md for the Rust workspace	#1661
5	fix(cli): render stack-squash validation errors via clap	#1671
6	feat(install): drop completions and a man page during install	#1674

[JulianMaurin]

Revision history

#	Type	Changes	Reason	Date
1	initial	8ead627		2026-06-19 07:52 UTC
2	rebase	8ead627 → 4e826a7 (rebase only)		2026-06-19 07:52 UTC
3	content	4e826a7 → 10d5ea0 (raw)		2026-06-19 16:51 UTC
4	content	10d5ea0 → c655221 (raw)	Regenerate the CLI schema snapshot: the local --verbose entries on stack list and queue show were dropped when unified onto the global flag.	2026-06-22 09:10 UTC
5	rebase	c655221 → 2350cd3 (rebase only)		2026-06-22 09:15 UTC
6	rebase	2350cd3 → 902b96f (rebase only)		2026-06-22 13:00 UTC
7	rebase	902b96f → b47a14c (rebase only)		2026-06-23 07:41 UTC
8	rebase	b47a14c → 793f601 (rebase only)		2026-06-23 09:11 UTC

[mergify]

Queued — the merge queue status continues in this comment ↓.

[mergify]

Merge Queue Status

• ✅ Entered queue — 2026-06-23 09:44 UTC · Rule: default · triggered by merge protections
• ✅ Checks skipped · PR is already up-to-date
• ✅ Merged — 2026-06-23 09:45 UTC · at d051fabbf59a19e3b53312395889ba345e34c517 · squash

This pull request spent 34 seconds in the queue, including 7 seconds running CI.

Required conditions to merge

• depends-on = Mergifyio/mergify-cli#1658 [⛓️ feat(cli): generate shell completions and a man page #1658]
  • test: golden-snapshot the CLI surface and guard schema drift #1659
• all of [🛡 Merge Protections rule Enforce conventional commit]:
  • title ~= ^(fix|feat|docs|style|refactor|perf|test|build|ci|chore|revert|ui)(?:\(.+\))?:
    • test: golden-snapshot the CLI surface and guard schema drift #1659
• all of [🛡 Merge Protections rule 👀 Review Requirements]:
  • any of:
    • #approved-reviews-by>=2
      • test: golden-snapshot the CLI surface and guard schema drift #1659
    • author = dependabot[bot]
      • test: golden-snapshot the CLI surface and guard schema drift #1659
    • author = mergify-ci-bot
      • test: golden-snapshot the CLI surface and guard schema drift #1659
    • author = renovate[bot]
      • test: golden-snapshot the CLI surface and guard schema drift #1659
• all of [🛡 Merge Protections rule 📕 PR description]:
  • body ~= (?ms:.{48,})
    • test: golden-snapshot the CLI surface and guard schema drift #1659
• all of [🛡 Merge Protections rule 🔎 Reviews]:
  • #changes-requested-reviews-by = 0
    • test: golden-snapshot the CLI surface and guard schema drift #1659
  • #review-requested = 0
    • test: golden-snapshot the CLI surface and guard schema drift #1659
  • #review-threads-unresolved = 0
    • test: golden-snapshot the CLI surface and guard schema drift #1659
• all of [🛡 Merge Protections rule 🤖 Continuous Integration]:
  • all of:
    • check-success=ci-gate