Skip to content

Enhance CLI version checker to fetch and parse GitHub release notes #3495

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pelikhan merged 4 commits into from
Nov 8, 2025
Merged

Enhance CLI version checker to fetch and parse GitHub release notes #3495

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
b2b8171
Initial plan
Copilot Nov 8, 2025
2f558e2
Enhance CLI version checker to inspect GitHub release notes
Copilot Nov 8, 2025
787977b
Merge branch 'main' into copilot/enhance-cli-version-checker
pelikhan Nov 8, 2025
761ce90
Recompile workflow and fix duplicate section headers
Copilot Nov 8, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 33 additions & 1 deletion .github/workflows/cli-version-checker.lock.yml
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

34 changes: 33 additions & 1 deletion .github/workflows/cli-version-checker.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,9 +47,14 @@ For each CLI/MCP server:

### Version Sources
- **Claude Code**: Use `npm view @anthropic-ai/claude-code version` (faster than web-fetch)
- No public GitHub repository
- **Copilot CLI**: Use `npm view @github/copilot version`
- Repository: https://github.com/github/copilot-cli (may be private)
- **Codex**: Use `npm view @openai/codex version`
- Repository: https://github.com/openai/codex
- Release Notes: https://github.com/openai/codex/releases
- **GitHub MCP Server**: `https://api.github.com/repos/github/github-mcp-server/releases/latest`
- Release Notes: https://github.com/github/github-mcp-server/releases

**Optimization**: Fetch all versions in parallel using multiple npm view or WebFetch calls in a single turn.

Expand All @@ -60,6 +65,21 @@ For each update, analyze intermediate versions:
- Document migration requirements
- Assign risk level (Low/Medium/High)

**GitHub Release Notes (when available)**:
- **Codex**: Fetch release notes from https://github.com/openai/codex/releases/tag/rust-v{VERSION}
- Parse the "Highlights" section for key changes
- Parse the "PRs merged" or "Merged PRs" section for detailed changes
- Extract links to pull requests and issues for context
- **GitHub MCP Server**: Fetch release notes from https://github.com/github/github-mcp-server/releases/tag/v{VERSION}
- Parse release body for changelog entries
- **Copilot CLI**: Repository may be private, skip release notes if inaccessible
- **Claude Code**: No public repository, rely on NPM metadata and CLI help output

**NPM Metadata Fallback**: When GitHub release notes are unavailable, use:
- `npm view <package> --json` for package metadata
- Compare CLI help outputs between versions
- Check for version changelog in package description

### Tool Installation & Discovery
**CACHE OPTIMIZATION**:
- Before installing, check cache-memory for previous help outputs
Expand Down Expand Up @@ -96,6 +116,7 @@ Include for each updated CLI:
- **Impact Assessment**: Risk level, affected features, migration notes
- **Changelog Links**: Use plain URLs without backticks
- **CLI Changes**: New commands, flags, or removed features discovered via help
- **GitHub Release Notes**: Include highlights and PR summaries when available from GitHub releases

**URL Formatting Rules**:
- Use plain URLs without backticks around package names
Expand All @@ -116,10 +137,17 @@ Template structure:
- Impact: Risk [Low/Medium/High], affects [features]
- Migration: [Yes/No - details if yes]

## Release Highlights (from GitHub)
[Include key highlights from GitHub release notes if available]

## Merged PRs (from GitHub)
[List significant merged PRs from release notes if available]

## Package Links
- **NPM Package**: https://www.npmjs.com/package/package-name-here
- **Repository**: [GitHub URL if available]
- **Changelog**: [URL to changelog if available]
- **Release Notes**: [GitHub releases URL if available]
- **Specific Release**: [Direct link to version's release notes if available]
```

## Guidelines
Expand All @@ -130,6 +158,10 @@ Template structure:
- **CHECK CACHE FIRST**: Before re-analyzing versions, check cache-memory for recent results
- **PARALLEL FETCHING**: Fetch all versions in parallel using multiple npm/WebFetch calls in one turn
- **EARLY EXIT**: If no version changes detected, save check timestamp to cache and exit successfully
- **FETCH GITHUB RELEASE NOTES**: For tools with public GitHub repositories, fetch release notes to get detailed changelog information
- Codex: Always fetch from https://github.com/openai/codex/releases
- GitHub MCP Server: Always fetch from https://github.com/github/github-mcp-server/releases
- Copilot CLI: Try to fetch, but may be inaccessible (private repo)
- Install and test CLI tools to discover new features via `--help`
- Compare help output between old and new versions
- **SAVE TO CACHE**: Store help outputs and version check results in cache-memory
Expand Down
Loading