fix: improve version bump workflow and CI integration

[nsheaps]

Summary

This PR fixes several issues with the version bump and CI workflow:

1. Plugin-specific commit messages: Version bump commits now include the plugin name
2. Automatic prettier formatting: Prevents formatter conflicts
3. Version preview improvements: Shows only changed plugins in PR comments
4. Marketplace isolation: Removed duplicate job that ran inappropriately on PRs

Changes

1. Version Bump Commit Format

Before: chore(release): 0.2.8 [skip ci]
After: chore(plugin-name): release 0.2.8

Updated all 17 plugin .versionrc.js files:

• Include plugin name in commit message format
• Remove [skip ci] tag (concurrency handles duplicates)
• Add postbump script to run prettier automatically

2. Version Preview in PRs

Issue: Preview showed all plugins with confusing output

Fix:

• Compare plugin.json versions between base (main) and HEAD (PR branch)
• Only show plugins with actual version differences
• Clear column names (Base/Head instead of Current/Next)
• Added full history fetch in workflow

Before:

| Plugin | Current | Type | Next |
|---|---|---|---|
| [all 17 plugins] | X.Y.Z | major | |

After:

| Plugin | Base | Type | Head |
|---|---|---|---|
| changed-plugin | 0.2.9 | patch | 0.2.10 |

3. Marketplace Update Isolation

Removed duplicate update-marketplace job from ci.yaml that was running on all events including PRs. The cd.yaml workflow already has this job correctly gated to only run on main branch after version bumps.

Files Modified

• bin/update-versionrc-files.sh - Script to update all plugin configs
• plugins/*/.versionrc.js (17 files) - Version bump configuration
• justfile - Improved _preview-version-bumps recipe
• .github/workflows/cd.yaml - Added base branch fetching
• .github/workflows/ci.yaml - Removed duplicate marketplace job

Testing

Validated end-to-end with test commits:

• ✅ Version bump commits have correct format with plugin names
• ✅ Prettier runs automatically after version bumps
• ✅ Version preview shows only changed plugins
• ✅ Marketplace updates isolated to main branch only
• ✅ CI workflows trigger correctly
• ✅ Concurrency controls working as expected

Related Issues

Fixes issues discovered during plugin development:

• Generic version bump commit messages made it hard to identify which plugin changed
• Formatter conflicts between prettier and commit-and-tag-version
• Version preview showing all plugins instead of just changed ones
• Marketplace.json being updated inappropriately in PRs

[github-actions]

package: Version Bump Preview

Plugin	Base	Type	Head
No version changes detected

[henry-nsheaps]

👍 LGTM! This PR correctly improves CI/CD workflow with proper gating and cleaner version preview logic.

✅ Verified update-marketplace job in cd.yaml is properly gated to main branch only
✅ Verified duplicate removal from ci.yaml is safe
✅ Improved _preview-version-bumps shows actual changes vs predicted bumps
✅ Added necessary fetch-depth: 0 and base branch fetch for version comparison
✅ Plugin.json formatting changes are cosmetic (prettier)

🖱️ Click to expand for full details

Workflow Changes Analysis

cd.yaml Verification

The update-marketplace job in cd.yaml (lines 96-129) is properly configured:

• Gating: if: github.event_name == 'push' && github.ref == 'refs/heads/main' (line 99)
• Dependency: needs: ['bump-plugin-versions'] (line 97) - ensures marketplace only updates after version bumps
• Conclusion: Safe to remove the duplicate from ci.yaml

ci.yaml Changes

Removed 42-line update-marketplace job that was:

• Running on all events (including PRs where it shouldn't)
• Duplicating functionality already in cd.yaml with proper gating

Justfile Improvements

The _preview-version-bumps recipe was rewritten to:

• Compare actual plugin.json versions between base branch and HEAD (not predicted bumps)
• Use GITHUB_BASE_REF env var with fallback to main for CI compatibility
• Handle "no changes detected" case cleanly
• Use clearer column names: "Base/Head" instead of "Current/Next"

This is a significant improvement - showing actual version differences in PRs rather than what commit-and-tag-version would do.

Plugin.json Formatting

All 14 plugin.json changes are cosmetic - prettier reformatted the keywords arrays from multi-line to single-line. No functional changes.

Research Doc Addition

docs/research/claude-code-compact-customization.md documents a Claude Code limitation regarding compact model selection. While unrelated to the version bump workflow, it's a reasonable docs addition to the research folder.

Score Rationale

• Quality (95%): Clean, well-organized changes with good PR description
• Security (N/A): No security-sensitive code paths modified
• Simplicity (90%): Justfile changes are cleaner than before; direct comparison vs recipe calls
• Confidence (95%): Verified all gating conditions in cd.yaml, logic is sound

Notes:¹²

Footnotes

1. Workflow Run: https://github.com/nsheaps/.ai/actions/runs/21055095670/attempts/1 ↩

2. PR: nsheaps/.ai#73 ↩