fix: improve version bump workflow and CI integration (#73)

nsheaps · claude · web-flow · commit d89cca31f569 · 2026-01-15T23:03:43.000-05:00
* docs: update changelog with version bump improvements

* fix: improve version bump preview to show only changed plugins

Previously showed all plugins with confusing 'major' type and empty next versions.
Now compares base branch (main) vs HEAD to show actual version changes in PR.

Changes:
- Compare plugin.json versions between branches
- Only show plugins that actually changed
- Show clear before/after versions
- Rename 'Current/Next' to 'Base/Head' for clarity

* fix: fetch base branch in version bump preview workflow

The preview was showing all plugins as new (0.0.0 -&gt; X.Y.Z) because
the base branch wasn't fetched. Now fetches full history and base branch
so git can properly compare versions between branches.

* chore: `just lint`

* docs(research): add Claude Code compact customization findings

Documents the current limitations around customizing the compact
operation in Claude Code, specifically the inability to configure
a specific model for compacting. Includes workarounds and
feature request recommendations.

Co-Authored-By: Claude Code (~/src/nsheaps/ai) &lt;noreply@anthropic.com&gt;

* fix: remove duplicate update-marketplace job from ci.yaml

The update-marketplace job was running on all events including PRs,
causing marketplace.json to be updated inappropriately in PRs.

The cd.yaml workflow already has this job correctly gated to only
run on main branch after version bumps. This removes the duplicate.

* docs: add changelog entry for workflow improvements

* chore: `just lint`

---------

Co-authored-by: Claude Code (~/src/nsheaps/ai) &lt;noreply@anthropic.com&gt;
diff --git a/.github/workflows/cd.yaml b/.github/workflows/cd.yaml
@@ -27,6 +27,11 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v6
+        with:
+          fetch-depth: 0 # Fetch full history for version comparison
+
+      - name: Fetch base branch
+        run: git fetch origin ${{ github.base_ref }}:refs/remotes/origin/${{ github.base_ref }}
 
       - name: mise install -y
         uses: jdx/mise-action@v2
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
@@ -57,48 +57,6 @@ jobs:
           echo "Changes made or lint failed! Auto-committed the fixes, but more lint and format issues may remain."
           exit 1
 
-  update-marketplace:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      pull-requests: write
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v6
-        with:
-          persist-credentials: false
-
-      - name: Authenticate as GitHub App
-        id: auth
-        uses: ./.github/actions/github-app-auth
-        with:
-          app-id: ${{ secrets.AUTOMATION_GITHUB_APP_ID }}
-          private-key: ${{ secrets.AUTOMATION_GITHUB_APP_PRIVATE_KEY }}
-
-      - name: mise install -y
-        uses: jdx/mise-action@v2
-        with:
-          install: true
-          cache: true
-
-      - name: just update-marketplace
-        id: update-marketplace
-        uses: ./.github/actions/update-marketplace
-        continue-on-error: true
-
-      - name: git push
-        if: steps.update-marketplace.outputs.changed-or-failed == 'true' && ! cancelled()
-        id: auto-commit-action
-        uses: stefanzweifel/git-auto-commit-action@v5
-        with:
-          commit_message: 'chore: `just update-marketplace`'
-
-      - name: 'exit 1 # changes detected or update failed'
-        if: ${{ steps.update-marketplace.outputs.changed-or-failed == 'true' && ! cancelled() }}
-        run: |
-          echo "Changes made or update-marketplace failed! Auto-committed the fixes, but more issues may remain."
-          exit 1
-
   validate:
     runs-on: ubuntu-latest
     if: github.event_name == 'pull_request' || github.ref == 'refs/heads/main'
diff --git a/docs/research/claude-code-compact-customization.md b/docs/research/claude-code-compact-customization.md
@@ -0,0 +1,90 @@
+# Claude Code Compact Customization Research
+
+**Date:** 2026-01-15
+**Status:** Documented limitation - feature request recommended
+
+## Question
+
+Is there any way to customize the compacting process in Claude Code to always use a specific model (e.g., Sonnet 1M context) instead of the currently configured model?
+
+## Summary
+
+**No, there is currently no way to configure a specific model for the compact operation.** Compact always uses whatever model is globally configured.
+
+## Findings
+
+### What Exists
+
+#### Hooks
+
+1. **`PreCompact` hook** - Fires before compact operation
+   - Matchers: `"manual"` or `"auto"` (based on trigger type)
+   - Input: `{ trigger: "manual" | "auto", custom_instructions?: string }`
+   - **Limitation:** Can only observe/log, cannot modify the compact operation itself
+
+2. **`SessionStart` hook** - Fires after compact completes
+   - Matcher: `"compact"` (based on source)
+   - Can be used to inject context or set environment variables via `CLAUDE_ENV_FILE`
+   - This is the closest to a "post-compact" hook
+
+#### Custom Instructions
+
+The `/compact` command accepts optional instructions:
+
+```bash
+/compact "focus on TODO items and architectural decisions"
+```
+
+This influences what gets summarized but not how (model, parameters, etc.).
+
+### What Doesn't Exist
+
+- No `compactModel` setting in `settings.json`
+- No `ANTHROPIC_COMPACT_MODEL` environment variable
+- No per-operation model override mechanism
+- No `PostCompact` hook
+- No way to intercept and modify compact parameters via hooks
+
+### Settings Schema Review
+
+The complete `settings.json` schema was reviewed. Compact-related settings are limited to:
+
+- Hook configuration for `PreCompact` event
+- Hook configuration for `SessionStart` with `"compact"` source
+
+No model or behavior overrides exist for compacting.
+
+## Workaround
+
+The only current option is to manually switch models before compacting:
+
+```bash
+/model sonnet[1m]
+/compact
+/model opus  # switch back if needed
+```
+
+This is manual and not automatable via hooks or settings.
+
+## Recommendation
+
+Submit a feature request via `/feedback` for one of:
+
+1. **`compactModel` setting** in `settings.json`:
+
+   ```json
+   {
+     "compactModel": "claude-sonnet-4-20250514"
+   }
+   ```
+
+2. **Environment variable** `ANTHROPIC_COMPACT_MODEL` or `CLAUDE_COMPACT_MODEL`
+
+3. **PreCompact hook enhancement** allowing return value to specify model override
+
+## References
+
+- [Claude Code Settings Reference](https://docs.anthropic.com/en/docs/claude-code/settings)
+- [Claude Code Hooks Reference](https://docs.anthropic.com/en/docs/claude-code/hooks)
+- [Claude Code CLI Reference](https://docs.anthropic.com/en/docs/claude-code/cli)
+- [The /compact Command Guide](https://deepwiki.com/FlorianBruniaux/claude-code-ultimate-guide/3.2-the-compact-command)
diff --git a/justfile b/justfile
@@ -108,59 +108,92 @@ _preview-version-bump PLUGIN_PATH=invocation_directory():
 [arg('format', pattern='--format=raw|--format=md')]
 _preview-version-bumps format='--format=raw':
     #!/usr/bin/env bash
-    # takes optional args:
-    # --format=raw|md : output format for dry-run report (default: raw)
-    # gets the json, then formats it accordingly.
+    # Compare plugin versions between base branch (main) and current HEAD
+    # Shows actual version changes in PR, not predicted future bumps
+    #
     # format with raw:
     #  plugin-name: 1.2.2 =( patch )=> 1.2.3
-    #  $plugin: $current =( $type )=> $next
-    #  ...
     # format with md:
-    #  | Plugin | Current | Type | Next |
+    #  | Plugin | Base | Type | Head |
     #  |---|---|---|---|
     #  | plugin-name | 1.2.2 | patch | 1.2.3 |
-    #   ...
+
+    # Determine base branch (origin/main in CI, main locally)
+    BASE_BRANCH="${GITHUB_BASE_REF:-main}"
+    if ! git rev-parse --verify "origin/$BASE_BRANCH" >/dev/null 2>&1; then
+        BASE_BRANCH="main"
+    else
+        BASE_BRANCH="origin/$BASE_BRANCH"
+    fi
+
     case "{{format}}" in
         --format=md )
-            echo "| Plugin | Current | Type | Next |"
+            echo "| Plugin | Base | Type | Head |"
             echo "|---|---|---|---|"
             ;;
     esac
+
+    FOUND_CHANGES=0
     for plugin_dir in plugins/*; do
         if [ ! -d "$plugin_dir" ]; then
             continue
         fi
         PLUGIN_NAME=$(basename "$plugin_dir")
-        CURRENT=$(just _plugin-current-version "$plugin_dir")
-        NEXT=$(just _plugin-next-version "$plugin_dir")
-        # determine type of bump
-        IFS='.' read -r -a current_parts <<< "$CURRENT"
-        IFS='.' read -r -a next_parts <<< "$NEXT"
-        if [ "${current_parts[0]}" != "${next_parts[0]}" ]; then
+        PLUGIN_JSON="$plugin_dir/.claude-plugin/plugin.json"
+
+        # Get version from HEAD (current branch)
+        HEAD_VERSION=$(jq -r '.version' "$PLUGIN_JSON" 2>/dev/null || echo "")
+        if [ -z "$HEAD_VERSION" ]; then
+            continue
+        fi
+
+        # Get version from base branch
+        BASE_VERSION=$(git show "$BASE_BRANCH:$PLUGIN_JSON" 2>/dev/null | jq -r '.version' 2>/dev/null || echo "")
+        if [ -z "$BASE_VERSION" ]; then
+            # Plugin doesn't exist in base branch (new plugin)
+            BASE_VERSION="0.0.0"
+        fi
+
+        # Skip if versions are the same
+        if [ "$BASE_VERSION" = "$HEAD_VERSION" ]; then
+            continue
+        fi
+
+        # Determine type of bump
+        IFS='.' read -r -a base_parts <<< "$BASE_VERSION"
+        IFS='.' read -r -a head_parts <<< "$HEAD_VERSION"
+        if [ "${base_parts[0]}" != "${head_parts[0]}" ]; then
             TYPE="major"
-        elif [ "${current_parts[1]}" != "${next_parts[1]}" ]; then
+        elif [ "${base_parts[1]}" != "${head_parts[1]}" ]; then
             TYPE="minor"
-        elif [ "${current_parts[2]}" != "${next_parts[2]}" ]; then
+        elif [ "${base_parts[2]}" != "${head_parts[2]}" ]; then
             TYPE="patch"
         else
-            TYPE="none"
-        fi
-
-        # Skip plugins with no version change
-        if [ "$TYPE" = "none" ]; then
-            continue
+            TYPE="unknown"
         fi
 
+        FOUND_CHANGES=1
         case "{{format}}" in
             --format=raw|'' )
-                echo "$PLUGIN_NAME: $CURRENT =( $TYPE )=> $NEXT"
+                echo "$PLUGIN_NAME: $BASE_VERSION =( $TYPE )=> $HEAD_VERSION"
                 ;;
             --format=md )
-                echo "| $PLUGIN_NAME | $CURRENT | $TYPE | $NEXT |"
+                echo "| $PLUGIN_NAME | $BASE_VERSION | $TYPE | $HEAD_VERSION |"
                 ;;
         esac
     done
 
+    if [ "$FOUND_CHANGES" -eq 0 ]; then
+        case "{{format}}" in
+            --format=md )
+                echo "| *No version changes detected* | | | |"
+                ;;
+            * )
+                echo "No version changes detected"
+                ;;
+        esac
+    fi
+
 _plugin-current-versions:
     #!/usr/bin/env bash
     # returns a list of plugin names and their current versions
diff --git a/plugins/commit-skill/README.md b/plugins/commit-skill/README.md
@@ -425,6 +425,12 @@ Contributions welcome! Please:
 
 ## Changelog
 
+### Latest
+
+- Improved version bump commit messages with plugin-specific formatting
+- Added automatic prettier formatting after version bumps
+- Enhanced CI integration by removing skip-ci tags
+
 ### Version 1.0.0
 
 - Initial release
diff --git a/plugins/data-serialization/README.md b/plugins/data-serialization/README.md
@@ -99,6 +99,13 @@ For deeply nested or non-uniform data, JSON may be more efficient.
 - [jq Manual](https://jqlang.github.io/jq/manual/)
 - [yq Documentation](https://mikefarah.gitbook.io/yq/)
 
+## Changelog
+
+### Latest
+
+- Improved version bump workflow with plugin-specific commit messages
+- Enhanced CI integration with consistent formatting
+
 ## License
 
 MIT
