Add comprehensive release notes review capability for Perseus repository #2839
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Overview
This PR adds a comprehensive toolset for reviewing, analyzing, and searching release notes across the Perseus monorepo. The new capability enables developers, project managers, and stakeholders to efficiently explore the rich history of changes across all Perseus packages.
Problem Addressed
Previously, reviewing release notes required manually checking individual CHANGELOG.md files across 12+ packages, making it difficult to:
Solution
Created a multi-faceted release notes review system with:
🔧 Core Tool (
utils/release-notes-reviewer.js)🌐 Web Interface (
utils/release-notes-viewer.html)📚 Documentation (
utils/README.md)🎬 Demo (
utils/demo.sh)Key Features
Multi-Package Support: Analyzes all Perseus packages (perseus, perseus-core, perseus-editor, math-input, etc.)
Powerful Search: Find changes by keyword across 1000+ releases
Release Analytics: Generate summaries with change counts and contributor metrics
# Get recent activity overview node utils/release-notes-reviewer.js recent 10Package-Specific Analysis: Focus on individual packages
# Review latest perseus-core changes node utils/release-notes-reviewer.js package perseus-core 5Example Usage
The tool immediately provides value for common workflows:
For Developers: Quickly assess upgrade impact and find relevant changes
For Project Managers: Generate release summaries and track development velocity
For QA Teams: Identify areas needing testing focus after releases
For Documentation: Create targeted change logs for specific features
Implementation Details
Testing
Verified functionality with:
The tool is production-ready and can immediately help teams understand Perseus development history and plan future work.
✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.