Skip to content

feat(listall): annotate versions and refresh docs UX (#4)#5

Merged
brianrobt merged 4 commits into
masterfrom
cursor/p2-docs-ux-followups-5412
Jul 14, 2026
Merged

feat(listall): annotate versions and refresh docs UX (#4)#5
brianrobt merged 4 commits into
masterfrom
cursor/p2-docs-ux-followups-5412

Conversation

@brianrobt

@brianrobt brianrobt commented Jul 14, 2026

Copy link
Copy Markdown
Owner

Summary

Continues gvm2#4 (P2 docs / UX), covering the upstream examples moovweb/gvm#516 and #517.

Changes

gvm listall (#516)

  • Annotates latest (highest stable go1.x.y), beta, and rc
  • Does not invent LTS labels (Go has no official LTS channel)
  • Adds --latest (print one tag) and --porcelain (names only)
  • Keeps version as the first field so existing grep/applymod usage still works
  • Uses $SORT_PATH -V for portable version sorting

Docs / onboarding (#517)

  • README quick-start + command table modeled on a simple nvm-like workflow
  • Documents .go-version auto-switch and GVM_NO_CD=1
  • Restores the status-banner wording corrupted by the prior typo “fix”
  • Fresh-install locale prompt mentions gvm listall --latest
  • Triage table marks P2 fixed in 1.2.0

Conventions / repo hygiene

  • Remove AGENTS.md from the repo (agent guidance belongs in Cursor User Rules, not GitHub)

Release metadata

  • Bump to 1.2.0 (VERSION, ChangeLog, CI grep) — minor bump for new listall features

Test plan

  • tf comment test tests/gvm_listall_comment_test.sh (listall / --latest / --porcelain / -h)
  • Manual smoke from branch install: gvm listall --latestgo1.26.5; annotations present for beta/rc/latest
  • CI smoke + suite on this branch
Open in Web Open in Cursor 

Summary by CodeRabbit

  • New Features

    • Added gvm listall options for showing the latest stable Go version and producing machine-readable output.
    • Added annotations identifying stable, beta, release candidate, and latest versions.
    • Improved Go installation guidance for selecting the latest version.
  • Documentation

    • Updated README and changelog for version 1.2.0 with refreshed installation, usage, troubleshooting, and feature information.
  • Bug Fixes

    • Updated issue-triage documentation to indicate a resolved item.
  • Tests

    • Added coverage for the new listing options and help output.

@coderabbitai

coderabbitai Bot commented Jul 14, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Changes

gvm 1.2.0 release and listall enhancements

Layer / File(s) Summary
listall options and output
scripts/listall
Adds --annotate, --porcelain, and --latest, classifies versions, identifies the latest stable release, and changes output formatting.
listall validation and onboarding
tests/gvm_listall_comment_test.sh, locales/en-US_go_install_prompt.txt
Tests the new options and documents installing the latest Go version.
1.2.0 metadata and documentation
VERSION, .github/workflows/ci.yml, ChangeLog, README.md, AGENTS.md
Updates release metadata, CI assertions, changelog and README content, and removes AGENTS.md.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant gvm_listall
  participant GitRemote
  User->>gvm_listall: Run listall with options
  gvm_listall->>GitRemote: Retrieve Go version tags
  GitRemote-->>gvm_listall: Return version tags
  gvm_listall-->>User: Print latest, annotated, or porcelain versions
Loading

Suggested reviewers: matttproud, jbussdieker, keonjeo, jcollum

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly reflects the main changes: listall version annotations and documentation UX updates.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch cursor/p2-docs-ux-followups-5412

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@cursor
cursor Bot force-pushed the cursor/p2-docs-ux-followups-5412 branch from 474a90a to 454d579 Compare July 14, 2026 00:49
Address gvm2#4 / moovweb/gvm#516–#517: annotate latest/beta/rc in
gvm listall, add --latest/--porcelain, and rewrite the README quick
start for an nvm-like onboarding path.
@cursor
cursor Bot force-pushed the cursor/p2-docs-ux-followups-5412 branch from 454d579 to 44924d7 Compare July 14, 2026 00:50
Make sole-author commits by Brian Thompson the lasting rule for all
agent sessions; forbid Cursor/AI author, committer, and co-author trailers.
Keep agent guidance out of GitHub; Cursor User Rules are the intended
store for authorship and session instructions.
listall annotations and --latest/--porcelain are new features, so this
release is a minor bump rather than a patch.
@brianrobt
brianrobt marked this pull request as ready for review July 14, 2026 01:05

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (1)
scripts/listall (1)

82-84: 📐 Maintainability & Code Quality | 🔵 Trivial | 💤 Low value

Future-proofing: support go2 tags.

The default release filter explicitly checks for go1. If Go 2 is released, its tags (e.g., go2.x) will be ignored by this filter. Consider updating the condition to match any go<number> prefix to gracefully handle future versions.

♻️ Proposed refactor
-		if [[ "${version:0:7}" == "release" ]] || [[ "${version:0:3}" == "go1" ]]; then
+		if [[ "${version:0:7}" == "release" ]] || [[ "$version" == go[0-9]* ]]; then
			filtered+="$version"$'\n'
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@scripts/listall` around lines 82 - 84, Update the version filter condition in
the list-all logic to recognize any go<number> prefix rather than only the go1
prefix, while preserving the existing release-tag matching behavior. Use a
pattern-based check so tags such as go2.x and future major Go versions are
included.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@scripts/listall`:
- Around line 133-135: Update the porcelain output branch in scripts/listall to
remove the three leading spaces from the printf format, while preserving the
version value and newline output.

---

Nitpick comments:
In `@scripts/listall`:
- Around line 82-84: Update the version filter condition in the list-all logic
to recognize any go<number> prefix rather than only the go1 prefix, while
preserving the existing release-tag matching behavior. Use a pattern-based check
so tags such as go2.x and future major Go versions are included.
🪄 Autofix (Beta)

✅ Autofix completed


ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 4dd59481-98ad-4309-972c-ef805f38f410

📥 Commits

Reviewing files that changed from the base of the PR and between c3b2684 and 42f3656.

📒 Files selected for processing (8)
  • .github/workflows/ci.yml
  • AGENTS.md
  • ChangeLog
  • README.md
  • VERSION
  • locales/en-US_go_install_prompt.txt
  • scripts/listall
  • tests/gvm_listall_comment_test.sh
💤 Files with no reviewable changes (1)
  • AGENTS.md

Comment thread scripts/listall
Comment on lines 133 to 135
else
echo " $version"
printf ' %s\n' "$version"
fi

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Remove leading spaces from --porcelain output.

Porcelain mode is intended to produce machine-readable output for scripts. Including 3 leading spaces forces downstream scripts to manually trim the whitespace (e.g., using awk '{print $1}'). Removing the padding aligns better with the standard expectations of a porcelain format.

🐛 Proposed fix
	else
-		printf '   %s\n' "$version"
+		printf '%s\n' "$version"
	fi
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
else
echo " $version"
printf ' %s\n' "$version"
fi
else
printf '%s\n' "$version"
fi
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@scripts/listall` around lines 133 - 135, Update the porcelain output branch
in scripts/listall to remove the three leading spaces from the printf format,
while preserving the version value and newline output.

@brianrobt
brianrobt merged commit da0898d into master Jul 14, 2026
7 checks passed
@coderabbitai

coderabbitai Bot commented Jul 15, 2026

Copy link
Copy Markdown

Note

Autofix is a beta feature. Expect some limitations and changes as we gather feedback and continue to improve it.

Fixes Applied Successfully

Fixed 1 file(s) based on 1 unresolved review comment.

A stacked PR containing fixes has been created.

  • Stacked PR: #6
  • Files modified:
  • scripts/listall

Time taken: 2m 21s

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