MCP Standards

#!/bin/bash # Claude Checkpoint Manager # Provides easy rollback and management of Claude Code checkpoints set -e # Colors RED='\033[0;31m' GREEN='\033[0;32m' YELLOW='\033[1;33m' BLUE='\033[0;34m' NC='\033[0m' # No Color # Configuration CHECKPOINT_DIR=".claude/checkpoints" BACKUP_DIR=".claude/backups" # Help function show_help() { cat << EOF Claude Checkpoint Manager ======================== Usage: $0 <command> [options] Commands: list List all checkpoints show <id> Show details of a specific checkpoint rollback <id> Rollback to a specific checkpoint diff <id> Show diff since checkpoint clean Clean old checkpoints (older than 7 days) summary Show session summary Options: --hard For rollback: use git reset --hard (destructive) --soft For rollback: use git reset --soft (default) --branch For rollback: create new branch from checkpoint Examples: $0 list $0 show checkpoint-20240130-143022 $0 rollback checkpoint-20240130-143022 --branch $0 diff session-end-session-20240130-150000 EOF } # List all checkpoints function list_checkpoints() { echo -e "${BLUE}📋 Available Checkpoints:${NC}" echo "" # List checkpoint tags echo -e "${YELLOW}Git Tags:${NC}" local tags=$(git tag -l 'checkpoint-*' -l 'session-end-*' -l 'task-*' --sort=-creatordate | head -20) if [ -n "$tags" ]; then echo "$tags" else echo "No checkpoint tags found" fi echo "" # List checkpoint branches echo -e "${YELLOW}Checkpoint Branches:${NC}" local branches=$(git branch -a | grep "checkpoint/" | sed 's/^[ *]*//') if [ -n "$branches" ]; then echo "$branches" else echo "No checkpoint branches found" fi echo "" # List checkpoint files if [ -d "$CHECKPOINT_DIR" ]; then echo -e "${YELLOW}Recent Checkpoint Files:${NC}" find "$CHECKPOINT_DIR" -name "*.json" -type f -printf "%T@ %p\n" | \ sort -rn | head -10 | cut -d' ' -f2- | xargs -I {} basename {} fi } # Show checkpoint details function show_checkpoint() { local checkpoint_id="$1" echo -e "${BLUE}📍 Checkpoint Details: $checkpoint_id${NC}" echo "" # Check if it's a tag if git tag -l "$checkpoint_id" | grep -q "$checkpoint_id"; then echo -e "${YELLOW}Type:${NC} Git Tag" echo -e "${YELLOW}Commit:${NC} $(git rev-list -n 1 "$checkpoint_id")" echo -e "${YELLOW}Date:${NC} $(git log -1 --format=%ai "$checkpoint_id")" echo -e "${YELLOW}Message:${NC}" git log -1 --format=%B "$checkpoint_id" | sed 's/^/ /' echo "" echo -e "${YELLOW}Files changed:${NC}" git diff-tree --no-commit-id --name-status -r "$checkpoint_id" | sed 's/^/ /' # Check if it's a branch elif git branch -a | grep -q "$checkpoint_id"; then echo -e "${YELLOW}Type:${NC} Git Branch" echo -e "${YELLOW}Latest commit:${NC}" git log -1 --oneline "$checkpoint_id" else echo -e "${RED}❌ Checkpoint not found: $checkpoint_id${NC}" exit 1 fi } # Rollback to checkpoint function rollback_checkpoint() { local checkpoint_id="$1" local mode="$2" echo -e "${YELLOW}🔄 Rolling back to checkpoint: $checkpoint_id${NC}" echo "" # Verify checkpoint exists if ! git tag -l "$checkpoint_id" | grep -q "$checkpoint_id" && \ ! git branch -a | grep -q "$checkpoint_id"; then echo -e "${RED}❌ Checkpoint not found: $checkpoint_id${NC}" exit 1 fi # Create backup before rollback local backup_name="backup-$(date +%Y%m%d-%H%M%S)" echo "Creating backup: $backup_name" git tag "$backup_name" -m "Backup before rollback to $checkpoint_id" case "$mode" in "--hard") echo -e "${RED}⚠️ Performing hard reset (destructive)${NC}" git reset --hard "$checkpoint_id" echo -e "${GREEN}✅ Rolled back to $checkpoint_id (hard reset)${NC}" ;; "--branch") local branch_name="rollback-$checkpoint_id-$(date +%Y%m%d-%H%M%S)" echo "Creating new branch: $branch_name" git checkout -b "$branch_name" "$checkpoint_id" echo -e "${GREEN}✅ Created branch $branch_name from $checkpoint_id${NC}" ;; "--stash"|*) echo "Stashing current changes..." git stash push -m "Stash before rollback to $checkpoint_id" git reset --soft "$checkpoint_id" echo -e "${GREEN}✅ Rolled back to $checkpoint_id (soft reset)${NC}" echo "Your changes are stashed. Use 'git stash pop' to restore them." ;; esac } # Show diff since checkpoint function diff_checkpoint() { local checkpoint_id="$1" echo -e "${BLUE}📊 Changes since checkpoint: $checkpoint_id${NC}" echo "" if git tag -l "$checkpoint_id" | grep -q "$checkpoint_id"; then git diff "$checkpoint_id" elif git branch -a | grep -q "$checkpoint_id"; then git diff "$checkpoint_id" else echo -e "${RED}❌ Checkpoint not found: $checkpoint_id${NC}" exit 1 fi } # Clean old checkpoints function clean_checkpoints() { local days=${1:-7} echo -e "${YELLOW}🧹 Cleaning checkpoints older than $days days...${NC}" echo "" # Clean old checkpoint files if [ -d "$CHECKPOINT_DIR" ]; then find "$CHECKPOINT_DIR" -name "*.json" -type f -mtime +$days -delete echo "✅ Cleaned old checkpoint files" fi # List old tags (but don't delete automatically) echo "" echo "Old checkpoint tags (manual deletion required):" git tag -l 'checkpoint-*' --sort=-creatordate | tail -n +50 || echo "No old tags found" } # Show session summary function show_summary() { echo -e "${BLUE}📊 Session Summary${NC}" echo "" # Find most recent session summary if [ -d "$CHECKPOINT_DIR" ]; then local latest_summary=$(find "$CHECKPOINT_DIR" -name "summary-*.md" -type f -printf "%T@ %p\n" | \ sort -rn | head -1 | cut -d' ' -f2-) if [ -n "$latest_summary" ]; then echo -e "${YELLOW}Latest session summary:${NC}" cat "$latest_summary" else echo "No session summaries found" fi fi } # Main command handling case "$1" in list) list_checkpoints ;; show) if [ -z "$2" ]; then echo -e "${RED}Error: Please specify a checkpoint ID${NC}" show_help exit 1 fi show_checkpoint "$2" ;; rollback) if [ -z "$2" ]; then echo -e "${RED}Error: Please specify a checkpoint ID${NC}" show_help exit 1 fi rollback_checkpoint "$2" "$3" ;; diff) if [ -z "$2" ]; then echo -e "${RED}Error: Please specify a checkpoint ID${NC}" show_help exit 1 fi diff_checkpoint "$2" ;; clean) clean_checkpoints "$2" ;; summary) show_summary ;; help|--help|-h) show_help ;; *) echo -e "${RED}Error: Unknown command: $1${NC}" echo "" show_help exit 1 ;; esac