myaidev-method 0.2.4 → 0.2.6

package/src/templates/codex/commands/myai-git-release.md

@@ -0,0 +1,516 @@
+# Create releases with semantic versioning and changelog generation
+
+You are a release automation assistant specializing in semantic versioning, changelog generation, and GitHub releases.
+
+Task: Create release - $ARGUMENTS
+
+## Release Management Workflow
+
+### 1. Pre-Release Validation
+
+```bash
+echo "🔍 Validating release prerequisites..."
+
+# Ensure on correct branch
+current_branch=$(git branch --show-current)
+if [[ "$current_branch" != "main" && "$current_branch" != "master" ]]; then
+  echo "⚠️  Not on main/master branch"
+  read -p "Continue from $current_branch? (yes/no): " confirm
+  if [ "$confirm" != "yes" ]; then
+    exit 1
+  fi
+fi
+
+# Check for uncommitted changes
+if ! git diff-index --quiet HEAD --; then
+  echo "❌ Uncommitted changes detected"
+  git status
+  exit 1
+fi
+
+# Ensure branch is up to date
+git fetch origin
+if [ "$(git rev-parse HEAD)" != "$(git rev-parse @{u})" ]; then
+  echo "❌ Branch not in sync with remote"
+  echo "Run: git pull origin $current_branch"
+  exit 1
+fi
+
+# Check if tests pass
+echo "🧪 Running tests before release..."
+npm test || {
+  echo "❌ Tests must pass before release"
+  exit 1
+}
+
+echo "✅ Pre-release validation passed"
+```
+
+### 2. Determine Version Bump
+
+```bash
+determine_version_bump() {
+  echo "📊 Analyzing commits for version bump..."
+
+  # Get current version
+  if [ -f "package.json" ]; then
+    current_version=$(jq -r '.version' package.json)
+  elif [ -f "version.txt" ]; then
+    current_version=$(cat version.txt)
+  else
+    current_version="0.0.0"
+  fi
+
+  echo "Current version: $current_version"
+
+  # Get latest tag
+  latest_tag=$(git describe --tags --abbrev=0 2>/dev/null || echo "v0.0.0")
+  echo "Latest tag: $latest_tag"
+
+  # Analyze commits since last tag
+  commits=$(git log $latest_tag..HEAD --oneline 2>/dev/null || git log --oneline)
+
+  # Determine bump type based on conventional commits
+  has_breaking=false
+  has_feature=false
+  has_fix=false
+
+  while IFS= read -r commit; do
+    commit_msg=$(echo "$commit" | cut -d' ' -f2-)
+
+    # Check for breaking changes
+    if echo "$commit_msg" | grep -qE "^(BREAKING|breaking|BREAKING CHANGE|breaking change|!)"; then
+      has_breaking=true
+    fi
+
+    # Check for features
+    if echo "$commit_msg" | grep -qE "^(feat|feature|add|new):"; then
+      has_feature=true
+    fi
+
+    # Check for fixes
+    if echo "$commit_msg" | grep -qE "^(fix|bugfix|patch):"; then
+      has_fix=true
+    fi
+  done <<< "$commits"
+
+  # Determine bump type
+  if [ "$has_breaking" = true ]; then
+    bump_type="major"
+  elif [ "$has_feature" = true ]; then
+    bump_type="minor"
+  elif [ "$has_fix" = true ]; then
+    bump_type="patch"
+  else
+    bump_type="patch"
+  fi
+
+  echo "Recommended bump: $bump_type"
+
+  # Calculate new version
+  IFS='.' read -r major minor patch <<< "${current_version#v}"
+
+  case $bump_type in
+    major)
+      major=$((major + 1))
+      minor=0
+      patch=0
+      ;;
+    minor)
+      minor=$((minor + 1))
+      patch=0
+      ;;
+    patch)
+      patch=$((patch + 1))
+      ;;
+  esac
+
+  new_version="$major.$minor.$patch"
+  echo "New version: $new_version"
+
+  # Confirm version
+  read -p "Accept version $new_version? (yes/no/custom): " choice
+
+  case $choice in
+    yes)
+      echo "$new_version"
+      ;;
+    custom)
+      read -p "Enter custom version: " custom_version
+      echo "$custom_version"
+      ;;
+    *)
+      echo "Release cancelled"
+      exit 1
+      ;;
+  esac
+}
+
+# Get new version
+new_version=$(determine_version_bump)
+echo "Releasing version: $new_version"
+```
+
+### 3. Generate Changelog
+
+```bash
+generate_changelog() {
+  local version=$1
+  local previous_tag=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
+
+  echo "📝 Generating changelog for v$version..."
+
+  # Create changelog file
+  changelog_file="CHANGELOG-v$version.md"
+
+  cat > "$changelog_file" << EOF
+# Release v$version
+
+**Release Date:** $(date +%Y-%m-%d)
+
+## Changes
+
+EOF
+
+  # Get commits since last tag
+  if [ -n "$previous_tag" ]; then
+    commits=$(git log $previous_tag..HEAD --pretty=format:"%s|%an|%h" 2>/dev/null)
+  else
+    commits=$(git log --pretty=format:"%s|%an|%h")
+  fi
+
+  # Categorize commits
+  declare -A categories
+  categories=(
+    ["💥 Breaking Changes"]=""
+    ["✨ Features"]=""
+    ["🐛 Bug Fixes"]=""
+    ["📚 Documentation"]=""
+    ["🔧 Maintenance"]=""
+    ["Other"]=""
+  )
+
+  while IFS='|' read -r message author hash; do
+    # Categorize based on conventional commit format
+    case "$message" in
+      BREAKING*|breaking*|*!:*)
+        categories["💥 Breaking Changes"]+="- $message ([$hash](commit/$hash)) - $author\n"
+        ;;
+      feat*|feature*|add*|new*)
+        categories["✨ Features"]+="- $message ([$hash](commit/$hash)) - $author\n"
+        ;;
+      fix*|bugfix*|patch*)
+        categories["🐛 Bug Fixes"]+="- $message ([$hash](commit/$hash)) - $author\n"
+        ;;
+      docs*|doc*)
+        categories["📚 Documentation"]+="- $message ([$hash](commit/$hash)) - $author\n"
+        ;;
+      chore*|deps*|build*)
+        categories["🔧 Maintenance"]+="- $message ([$hash](commit/$hash)) - $author\n"
+        ;;
+      *)
+        categories["Other"]+="- $message ([$hash](commit/$hash)) - $author\n"
+        ;;
+    esac
+  done <<< "$commits"
+
+  # Write categories to changelog
+  for category in "${!categories[@]}"; do
+    if [ -n "${categories[$category]}" ]; then
+      echo -e "\n### $category\n" >> "$changelog_file"
+      echo -e "${categories[$category]}" >> "$changelog_file"
+    fi
+  done
+
+  # Add contributors
+  echo -e "\n## Contributors\n" >> "$changelog_file"
+  git log $previous_tag..HEAD --format='%aN' 2>/dev/null | sort -u | while read author; do
+    echo "- $author" >> "$changelog_file"
+  done
+
+  echo "✅ Changelog generated: $changelog_file"
+  echo "$changelog_file"
+}
+
+# Generate changelog
+changelog_file=$(generate_changelog "$new_version")
+
+# Show changelog for review
+echo ""
+echo "═══════════════════════════════════════"
+cat "$changelog_file"
+echo "═══════════════════════════════════════"
+echo ""
+
+read -p "Accept changelog? (yes/edit/cancel): " changelog_choice
+
+case $changelog_choice in
+  edit)
+    ${EDITOR:-nano} "$changelog_file"
+    ;;
+  cancel)
+    echo "Release cancelled"
+    rm "$changelog_file"
+    exit 1
+    ;;
+esac
+```
+
+### 4. Update Version in Files
+
+```bash
+update_version_files() {
+  local version=$1
+
+  echo "📝 Updating version in project files..."
+
+  # Update package.json
+  if [ -f "package.json" ]; then
+    echo "Updating package.json..."
+    jq ".version = \"$version\"" package.json > package.json.tmp
+    mv package.json.tmp package.json
+    echo "✅ package.json updated"
+  fi
+
+  # Update package-lock.json
+  if [ -f "package-lock.json" ]; then
+    echo "Updating package-lock.json..."
+    jq ".version = \"$version\"" package-lock.json > package-lock.json.tmp
+    mv package-lock.json.tmp package-lock.json
+    echo "✅ package-lock.json updated"
+  fi
+
+  # Stage all version changes
+  git add -A
+
+  echo "✅ Version files updated"
+}
+
+# Update version
+update_version_files "$new_version"
+```
+
+### 5. Commit and Tag Release
+
+```bash
+create_release_commit() {
+  local version=$1
+  local changelog_file=$2
+
+  echo "🏷️  Creating release commit and tag..."
+
+  # Create release commit
+  git commit -m "chore(release): v$version
+
+$(cat $changelog_file)
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+Co-Authored-By: Claude <noreply@anthropic.com>"
+
+  # Create annotated tag
+  git tag -a "v$version" -m "Release v$version
+
+$(head -20 $changelog_file)
+
+Full changelog: See CHANGELOG.md"
+
+  echo "✅ Release commit and tag created"
+}
+
+# Create commit and tag
+create_release_commit "$new_version" "$changelog_file"
+```
+
+### 6. Push Release
+
+```bash
+push_release() {
+  local version=$1
+
+  echo "🚀 Pushing release to remote..."
+
+  read -p "Push release v$version to origin? (yes/no): " push_confirm
+
+  if [ "$push_confirm" != "yes" ]; then
+    echo "⚠️  Release created locally but not pushed"
+    echo "To push later: git push origin $current_branch && git push origin v$version"
+    return
+  fi
+
+  # Push commit
+  git push origin "$current_branch" || {
+    echo "❌ Failed to push commit"
+    exit 1
+  }
+
+  # Push tag
+  git push origin "v$version" || {
+    echo "❌ Failed to push tag"
+    exit 1
+  }
+
+  echo "✅ Release pushed to origin"
+}
+
+# Push release
+push_release "$new_version"
+```
+
+### 7. Create GitHub Release
+
+```bash
+create_github_release() {
+  local version=$1
+
+  echo "📦 Creating GitHub release..."
+
+  # Check if gh CLI is installed
+  if ! command -v gh &> /dev/null; then
+    echo "⚠️  GitHub CLI not installed. Install with: brew install gh"
+    echo "Manual release creation: https://github.com/$(git config remote.origin.url | sed 's/.*://;s/.git$//')/releases/new"
+    return
+  fi
+
+  # Check if authenticated
+  if ! gh auth status &> /dev/null; then
+    echo "🔐 Authenticating with GitHub..."
+    gh auth login
+  fi
+
+  # Extract changelog content for this version
+  changelog_content=$(sed -n '/^# Release/,/^# Release/p' CHANGELOG.md | head -n -1)
+
+  # Create release
+  echo "Creating GitHub release..."
+
+  gh release create "v$version" \
+    --title "Release v$version" \
+    --notes "$changelog_content" \
+    || {
+      echo "❌ Failed to create GitHub release"
+      exit 1
+    }
+
+  echo "✅ GitHub release created"
+  echo "🌐 View at: https://github.com/$(git remote get-url origin | sed 's/.*://;s/.git$//')/releases/tag/v$version"
+}
+
+# Create GitHub release if available
+create_github_release "$new_version"
+```
+
+### 8. Publish to NPM (Optional)
+
+```bash
+publish_to_npm() {
+  local version=$1
+
+  if [ ! -f "package.json" ]; then
+    return
+  fi
+
+  echo "📦 NPM Publishing..."
+
+  read -p "Publish v$version to NPM? (yes/no): " npm_confirm
+
+  if [ "$npm_confirm" != "yes" ]; then
+    echo "⚠️  Skipping NPM publish"
+    return
+  fi
+
+  # Check if logged in
+  if ! npm whoami &> /dev/null; then
+    echo "🔐 Logging into NPM..."
+    npm login
+  fi
+
+  # Publish
+  echo "Publishing to NPM..."
+  npm publish --access public || {
+    echo "❌ NPM publish failed"
+    return 1
+  }
+
+  echo "✅ Published to NPM"
+  echo "🌐 View at: https://www.npmjs.com/package/$(jq -r '.name' package.json)"
+}
+
+# Publish to NPM
+publish_to_npm "$new_version"
+```
+
+## Complete Release Script
+
+```bash
+#!/bin/bash
+set -e
+
+echo "🎉 Starting release process..."
+
+# 1. Validate
+git diff-index --quiet HEAD -- || { echo "❌ Uncommitted changes"; exit 1; }
+npm test || { echo "❌ Tests failed"; exit 1; }
+
+# 2. Determine version
+new_version=$(determine_version_bump)
+
+# 3. Generate changelog
+changelog_file=$(generate_changelog "$new_version")
+
+# 4. Update files
+update_version_files "$new_version"
+
+# 5. Commit and tag
+create_release_commit "$new_version" "$changelog_file"
+
+# 6. Push
+push_release "$new_version"
+
+# 7. Create GitHub release
+create_github_release "$new_version"
+
+# 8. Publish to NPM
+publish_to_npm "$new_version"
+
+echo "✅ Release v$new_version complete!"
+echo "🌐 Release: https://github.com/$(git remote get-url origin | sed 's/.*://;s/.git$//')/releases/tag/v$new_version"
+```
+
+## Quick Release Commands
+
+**Patch release (bug fixes):**
+```bash
+/myai-git-release --patch
+```
+
+**Minor release (new features):**
+```bash
+/myai-git-release --minor
+```
+
+**Major release (breaking changes):**
+```bash
+/myai-git-release --major
+```
+
+## Environment Configuration
+
+```bash
+# GitHub (for releases)
+GH_TOKEN=your_github_token
+
+# NPM (for publishing)
+NPM_TOKEN=your_npm_token
+
+# Notifications
+SLACK_WEBHOOK_URL=https://hooks.slack.com/services/YOUR/WEBHOOK
+DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/YOUR/WEBHOOK
+
+# Release settings
+AUTO_PUBLISH_NPM=false
+CREATE_DEV_VERSION=true
+UPLOAD_ASSETS=true
+```
+
+Execute the release workflow with semantic versioning and complete automation.