@wipcomputer/post-merge-rename 1.0.0

package/LICENSE

@@ -0,0 +1,52 @@
+Dual License: MIT + AGPLv3
+
+Copyright (c) 2026 WIP Computer, Inc.
+
+
+1. MIT License (local and personal use)
+---------------------------------------
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+2. GNU Affero General Public License v3.0 (commercial and cloud use)
+--------------------------------------------------------------------
+
+If you run this software as part of a hosted service, cloud platform,
+marketplace listing, or any network-accessible offering for commercial
+purposes, the AGPLv3 terms apply. You must either:
+
+  a) Release your complete source code under AGPLv3, or
+  b) Obtain a commercial license.
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published
+by the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+
+AGPLv3 for personal use is free. Commercial licenses available.

package/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: post-merge-rename
+description: Post-merge branch renaming. Appends --merged-YYYY-MM-DD to preserve history.
+license: MIT
+interface: [cli, skill]
+metadata:
+  display-name: "Post-Merge Branch Naming"
+  version: "1.3.0"
+  homepage: "https://github.com/wipcomputer/wip-ai-devops-toolbox"
+  author: "Parker Todd Brooks"
+  category: dev-tools
+  capabilities:
+    - branch-rename
+    - history-preservation
+  requires:
+    bins: [git, bash]
+  openclaw:
+    requires:
+      bins: [git, bash]
+    emoji: "🏷️"
+compatibility: Requires git, bash.
+---
+
+# post-merge-rename
+
+Scans for merged branches that haven't been renamed and appends `--merged-YYYY-MM-DD` to preserve history. We never delete branches. We rename them.
+
+## When to Use This Skill
+
+**Use post-merge-rename for:**
+- After merging PRs, to rename the source branch
+- Cleaning up branches that were merged but not renamed
+- Runs automatically as step 10 of `wip-release`
+
+### Do NOT Use For
+
+- Unmerged branches
+- Branches you're currently working on
+
+## API Reference
+
+### CLI
+
+```bash
+bash scripts/post-merge-rename.sh              # scan + rename all merged branches
+bash scripts/post-merge-rename.sh --dry-run     # preview only
+bash scripts/post-merge-rename.sh <branch>      # rename specific branch
+```
+
+## What It Does
+
+1. Lists all local branches merged into main
+2. Skips branches already renamed (containing `--merged-`)
+3. Finds the merge date from git history
+4. Renames: `feature-branch` -> `feature-branch--merged-2026-03-09`
+5. Pushes the renamed branch to origin
+6. Deletes the old branch name from origin

package/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "@wipcomputer/post-merge-rename",
+  "version": "1.0.0",
+  "description": "Post-merge branch renaming. Appends --merged-YYYY-MM-DD to preserve history.",
+  "bin": {
+    "post-merge-rename": "./post-merge-rename.sh"
+  },
+  "license": "MIT"
+}

package/post-merge-rename.sh

@@ -0,0 +1,122 @@
+#!/usr/bin/env bash
+#
+# post-merge-rename.sh
+# Scans for branches merged into main and renames them with --merged-YYYY-MM-DD.
+# Branches already renamed (containing --merged-) are skipped.
+# Never deletes branches. Only renames.
+#
+# Usage:
+#   bash post-merge-rename.sh                    # scan + rename all
+#   bash post-merge-rename.sh <branch>           # rename a specific branch
+#   bash post-merge-rename.sh --dry-run          # preview only
+#   bash post-merge-rename.sh <branch> --dry-run # preview specific branch
+#
+# Run this after merging a PR, or periodically to catch missed renames.
+#
+# Author: CC-mini (Opus 4.6)
+# Date: 2026-03-08
+
+set -euo pipefail
+
+DRY_RUN=false
+SPECIFIC_BRANCH=""
+
+for arg in "$@"; do
+  case "$arg" in
+    --dry-run) DRY_RUN=true ;;
+    --help|-h)
+      echo "Usage: post-merge-rename.sh [<branch>] [--dry-run]"
+      echo ""
+      echo "Scans for branches merged into main and renames them"
+      echo "with --merged-YYYY-MM-DD suffix. Never deletes branches."
+      exit 0
+      ;;
+    *) SPECIFIC_BRANCH="$arg" ;;
+  esac
+done
+
+# Must be in a git repo
+if ! git rev-parse --is-inside-work-tree &>/dev/null; then
+  echo "Error: not inside a git repo."
+  exit 1
+fi
+
+# Fetch latest remote state
+git fetch origin --prune 2>/dev/null || true
+
+rename_branch() {
+  local branch="$1"
+  local trimmed
+  trimmed=$(echo "$branch" | sed 's/^[[:space:]]*//' | sed 's/[[:space:]]*$//')
+
+  # Skip main
+  [[ "$trimmed" == "main" || "$trimmed" == "master" ]] && return
+
+  # Skip already renamed
+  [[ "$trimmed" == *"--merged-"* ]] && return
+
+  # Skip current branch (can't rename the checked-out branch)
+  local current
+  current=$(git branch --show-current)
+  if [[ "$trimmed" == "$current" ]]; then
+    echo "  SKIP $trimmed (currently checked out)"
+    return
+  fi
+
+  # Find merge date: when this branch's tip became reachable from main
+  local merge_date
+  merge_date=$(git log main --format="%ai" --ancestry-path "$(git merge-base main "$trimmed" 2>/dev/null)..main" 2>/dev/null | tail -1 | cut -d' ' -f1)
+
+  # Fallback: use the branch tip's own date
+  if [[ -z "$merge_date" ]]; then
+    merge_date=$(git log "$trimmed" -1 --format="%ai" 2>/dev/null | cut -d' ' -f1)
+  fi
+
+  if [[ -z "$merge_date" ]]; then
+    echo "  SKIP $trimmed (could not determine merge date)"
+    return
+  fi
+
+  local new_name="${trimmed}--merged-${merge_date}"
+
+  if $DRY_RUN; then
+    echo "  [dry-run] $trimmed -> $new_name"
+  else
+    echo "  Renaming: $trimmed -> $new_name"
+
+    # Rename local
+    git branch -m "$trimmed" "$new_name" 2>/dev/null || true
+
+    # Push new name to remote
+    git push origin "$new_name" 2>/dev/null || true
+
+    # Remove old name from remote
+    git push origin --delete "$trimmed" 2>/dev/null || true
+  fi
+}
+
+if [[ -n "$SPECIFIC_BRANCH" && "$SPECIFIC_BRANCH" != "--dry-run" ]]; then
+  # Rename a specific branch
+  echo "Checking branch: $SPECIFIC_BRANCH"
+  if git merge-base --is-ancestor "$SPECIFIC_BRANCH" main 2>/dev/null; then
+    rename_branch "$SPECIFIC_BRANCH"
+  else
+    echo "  $SPECIFIC_BRANCH is NOT merged into main. Leaving as-is."
+  fi
+else
+  # Scan all local branches merged into main
+  echo "Scanning for merged branches..."
+  merged=$(git branch --merged main | grep -v "^\*" | grep -v "main$" | grep -v "master$" | grep -v "\-\-merged\-" || true)
+
+  if [[ -z "$merged" ]]; then
+    echo "  No unrenamed merged branches found. All clean."
+    exit 0
+  fi
+
+  while IFS= read -r branch; do
+    rename_branch "$branch"
+  done <<< "$merged"
+fi
+
+echo ""
+echo "Done."