leo-claude-mktplace/plugins/projman/commands/suggest-version.md

description

description
Analyze CHANGELOG.md and suggest appropriate semantic version bump

Suggest Version

Analyze CHANGELOG.md and suggest appropriate semantic version bump.

Behavior

1. Read current state:

   • Read CHANGELOG.md to find current version and [Unreleased] content
   • Read .claude-plugin/marketplace.json for current marketplace version
   • Check individual plugin versions in plugins/*/. claude-plugin/plugin.json

2. Analyze [Unreleased] section:

   • Extract all entries under ### Added, ### Changed, ### Fixed, ### Removed, ### Deprecated
   • Categorize changes by impact

3. Apply SemVer rules:

   Change Type	Version Bump	Indicators
   MAJOR (X.0.0)	Breaking changes	### Removed, ### Changed with "BREAKING:", renamed/removed APIs
   MINOR (x.Y.0)	New features, backwards compatible	### Added with new commands/plugins/features
   PATCH (x.y.Z)	Bug fixes only	### Fixed only, ### Changed for non-breaking tweaks

4. Output recommendation:

   ## Version Analysis
   
   **Current version:** X.Y.Z
   **[Unreleased] summary:**
   - Added: N entries (new features/plugins)
   - Changed: N entries (M breaking)
   - Fixed: N entries
   - Removed: N entries
   
   **Recommendation:** MINOR bump → X.(Y+1).0
   **Reason:** New features added without breaking changes
   
   **To release:** ./scripts/release.sh X.Y.Z
   

5. Check version sync:

   • Compare marketplace version with individual plugin versions
   • Warn if plugins are out of sync (e.g., marketplace 4.0.0 but projman 3.1.0)

Examples

Output when MINOR bump needed:

## Version Analysis

**Current version:** 4.0.0
**[Unreleased] summary:**
- Added: 3 entries (new command, hook improvement, workflow example)
- Changed: 1 entry (0 breaking)
- Fixed: 2 entries

**Recommendation:** MINOR bump → 4.1.0
**Reason:** New features (Added section) without breaking changes

**To release:** ./scripts/release.sh 4.1.0

Output when nothing to release:

## Version Analysis

**Current version:** 4.0.0
**[Unreleased] summary:** Empty - no pending changes

**Recommendation:** No release needed

Visual Output

When executing this command, display the plugin header:

╔══════════════════════════════════════════════════════════════════╗
║  📋 PROJMAN                                                      ║
║  Version Analysis                                                ║
╚══════════════════════════════════════════════════════════════════╝

Then proceed with the version analysis.

Integration

This command helps maintain proper versioning workflow:

• Run after completing a sprint to determine version bump
• Run before /sprint-close to ensure version is updated
• Integrates with ./scripts/release.sh for actual release execution