Skip to content

fix(metrics): improve statistics display and align CLI help with contract#928

Merged
loonghao merged 1 commit into
mainfrom
fix/metrics-stats-and-help
May 28, 2026
Merged

fix(metrics): improve statistics display and align CLI help with contract#928
loonghao merged 1 commit into
mainfrom
fix/metrics-stats-and-help

Conversation

@loonghao
Copy link
Copy Markdown
Owner

Summary

  • Add overhead column to metrics comparison table so Total = stages + overhead (no unexplained gaps)
  • Add overhead row to Stage Averages section — percentages now sum to ~100%
  • Fix Performance Insights to use average overhead across all runs instead of only latest run
  • Update CLI help text to include all 11 usage modes from the command-syntax-rules contract
  • Fix vx pkg subcommand listing (updateshim-update)
  • Enforce vx git / vx gh prefix usage rules in AGENTS.md and CLAUDE.md
  • Add efficient git/gh output patterns for AI agents

Test plan

  • vx cargo build passes
  • vx cargo test -p vx-metrics — all 18 tests pass
  • vx cargo clippy -p vx-metrics -p vx -- -D warnings — clean
  • vx cargo fmt -- --check — clean
  • CI workflow passes on all platforms

…ract

- Add overhead column to metrics comparison table for complete timing breakdown
- Add overhead row to Stage Averages section (stages now sum to 100%)
- Change Performance Insights to show average overhead across all runs
  instead of only the latest run, reducing confusion
- Update CLI help text to include all 11 usage modes from the
  command-syntax-rules contract (env, run, sync/lock were missing)
- Fix pkg subcommand listing (update → shim-update)
- Add GLOBAL OPTIONS section to help output
- Enforce vx git / vx gh usage in AGENTS.md and CLAUDE.md
- Add efficient output patterns documentation for agents
@loonghao loonghao merged commit a4f7156 into main May 28, 2026
42 checks passed
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.

1 participant