Skip to content

feat: add version feature reporting#2548

Merged
mnriem merged 1 commit into
github:mainfrom
PascalThuet:codex/version-feature-reporting-pr
May 14, 2026
Merged

feat: add version feature reporting#2548
mnriem merged 1 commit into
github:mainfrom
PascalThuet:codex/version-feature-reporting-pr

Conversation

@PascalThuet
Copy link
Copy Markdown
Contributor

@PascalThuet PascalThuet commented May 13, 2026

Summary

Follow-up to #2498 and #2519.

Adds local CLI capability reporting to specify version so users and coding agents can determine whether the installed CLI supports key workflows before trying them.

Changes

  • Add specify version --features for human-readable local capability output.
  • Add specify version --features --json for machine-readable capability output.
  • Reject specify version --json without --features to keep the JSON surface scoped.
  • Document the new options in the core command reference.

Notes

This intentionally stays local and offline. It does not check latest releases or inspect project state; those remain separate follow-ups.

Validation

Local:

  • uv run pytest tests/test_cli_version.py -v
  • git diff --check origin/main

CI:

  • Full pytest, ruff, and markdownlint coverage runs via GitHub Actions on the PR.

AI Disclosure

  • I did not use AI assistance for this contribution
  • I did use AI assistance (describe below)

Used AI assistance to inspect CLI command structure, implement the scoped feature-reporting change, add tests/docs, and run local validation. The changes were reviewed before submission.

@PascalThuet PascalThuet changed the title [codex] Add version feature reporting feat: add version feature reporting May 13, 2026
@PascalThuet PascalThuet marked this pull request as ready for review May 13, 2026 22:55
@PascalThuet PascalThuet requested a review from mnriem as a code owner May 13, 2026 22:55
@mnriem mnriem requested a review from Copilot May 14, 2026 12:23
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a specify version --features (and --features --json) subcommand mode that reports the installed CLI's local capability flags, so users and coding agents can detect feature support without network calls. Follows up on #2498/#2519.

Changes:

  • Add _feature_capabilities() helper and extend version command with --features / --json flags (rejecting --json without --features).
  • Add TestVersionCommand covering the text output, JSON output, and the validation error.
  • Document the new flags in docs/reference/core.md.
Show a summary per file
File Description
src/specify_cli/init.py Adds capability flags helper and new --features/--json options on the version command
tests/test_cli_version.py Tests for text output, JSON output, and --json without --features rejection
docs/reference/core.md Documents the new flags and intended audience

Copilot's findings

Tip

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

  • Files reviewed: 3/3 changed files
  • Comments generated: 0

@mnriem mnriem merged commit e6afba9 into github:main May 14, 2026
11 checks passed
@mnriem
Copy link
Copy Markdown
Collaborator

mnriem commented May 14, 2026

Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants