aidevops 2.52.1 → 2.53.2

package/.agent/scripts/beads-sync-helper.sh

@@ -1,596 +0,0 @@
-#!/usr/bin/env bash
-# beads-sync-helper.sh - Bi-directional sync between aidevops TODO.md and Beads
-# Part of aidevops framework: https://aidevops.sh
-#
-# Usage:
-#   beads-sync-helper.sh [command] [options]
-#
-# Commands:
-#   push      Sync TODO.md → Beads (aidevops is source of truth)
-#   pull      Sync Beads → TODO.md (import changes from Beads)
-#   sync      Two-way sync with conflict detection
-#   status    Show sync status and any pending changes
-#   init      Initialize Beads in current project
-#   ready     Show tasks with no open blockers
-#
-# Options:
-#   --force   Skip conflict detection (use with caution)
-#   --dry-run Show what would be synced without making changes
-#   --verbose Show detailed sync operations
-#
-# Sync Guarantees:
-#   - Lock file prevents concurrent syncs
-#   - Checksum verification before/after
-#   - Conflict detection with manual resolution
-#   - Audit log of all sync operations
-
-set -euo pipefail
-
-# Configuration
-LOCK_FILE="/tmp/beads-sync.lock"
-LOCK_TIMEOUT=60
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m'
-
-# Logging
-log_info() { echo -e "${BLUE}[INFO]${NC} $*"; }
-log_success() { echo -e "${GREEN}[OK]${NC} $*"; }
-log_warn() { echo -e "${YELLOW}[WARN]${NC} $*"; }
-log_error() { echo -e "${RED}[ERROR]${NC} $*" >&2; }
-
-# Find project root (contains TODO.md or .beads/)
-find_project_root() {
-    local dir="$PWD"
-    while [[ "$dir" != "/" ]]; do
-        if [[ -f "$dir/TODO.md" ]] || [[ -d "$dir/.beads" ]]; then
-            echo "$dir"
-            return 0
-        fi
-        dir="$(dirname "$dir")"
-    done
-    return 1
-}
-
-# Acquire lock with timeout
-acquire_lock() {
-    local start_time
-    start_time=$(date +%s)
-    
-    while ! mkdir "$LOCK_FILE" 2>/dev/null; do
-        local current_time
-        current_time=$(date +%s)
-        local elapsed=$((current_time - start_time))
-        
-        if [[ $elapsed -ge $LOCK_TIMEOUT ]]; then
-            log_error "Failed to acquire lock after ${LOCK_TIMEOUT}s"
-            log_error "Another sync may be in progress, or stale lock at: $LOCK_FILE"
-            log_error "To force: rm -rf $LOCK_FILE"
-            return 1
-        fi
-        
-        log_warn "Waiting for lock... (${elapsed}s)"
-        sleep 1
-    done
-    
-    # Store PID in lock directory
-    echo $$ > "$LOCK_FILE/pid"
-    trap 'release_lock' EXIT
-    return 0
-}
-
-# Release lock
-release_lock() {
-    if [[ -d "$LOCK_FILE" ]]; then
-        rm -rf "$LOCK_FILE"
-    fi
-}
-
-# Calculate checksum of TODO.md
-checksum_todo() {
-    local project_root="$1"
-    if [[ -f "$project_root/TODO.md" ]]; then
-        shasum -a 256 "$project_root/TODO.md" | cut -d' ' -f1
-    else
-        echo "no-todo"
-    fi
-}
-
-# Calculate checksum of Beads database
-checksum_beads() {
-    local project_root="$1"
-    if [[ -f "$project_root/.beads/issues.jsonl" ]]; then
-        shasum -a 256 "$project_root/.beads/issues.jsonl" | cut -d' ' -f1
-    else
-        echo "no-beads"
-    fi
-}
-
-# Log sync operation
-log_sync() {
-    local project_root="$1"
-    local operation="$2"
-    local details="$3"
-    local log_file="$project_root/.beads/sync.log"
-    
-    mkdir -p "$project_root/.beads"
-    echo "[$(date -u +"%Y-%m-%dT%H:%M:%SZ")] $operation: $details" >> "$log_file"
-}
-
-# Check if Beads CLI is installed
-check_beads_installed() {
-    if ! command -v bd &> /dev/null; then
-        log_error "Beads CLI (bd) not found"
-        log_info "Install with: brew install steveyegge/beads/bd"
-        log_info "Or: curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash"
-        return 1
-    fi
-    return 0
-}
-
-# Initialize Beads in project
-cmd_init() {
-    local project_root
-    project_root=$(find_project_root) || {
-        log_error "Not in a project directory (no TODO.md found)"
-        return 1
-    }
-    
-    check_beads_installed || return 1
-    
-    if [[ -d "$project_root/.beads" ]]; then
-        log_warn "Beads already initialized in $project_root"
-        return 0
-    fi
-    
-    log_info "Initializing Beads in $project_root..."
-    
-    # Generate prefix from directory name
-    local prefix
-    prefix=$(basename "$project_root" | tr '[:upper:]' '[:lower:]' | tr -cd '[:alnum:]' | head -c 4)
-    
-    (cd "$project_root" && bd init --prefix "$prefix")
-    
-    log_success "Beads initialized with prefix: $prefix"
-    log_info "Run 'beads-sync-helper.sh push' to sync TODO.md to Beads"
-    
-    log_sync "$project_root" "INIT" "prefix=$prefix"
-    return 0
-}
-
-# Parse TODO.md and extract tasks
-parse_todo_md() {
-    local project_root="$1"
-    local todo_file="$project_root/TODO.md"
-    
-    if [[ ! -f "$todo_file" ]]; then
-        log_error "TODO.md not found in $project_root"
-        return 1
-    fi
-    
-    # Extract TOON backlog block
-    # This is a simplified parser - production would use proper TOON parsing
-    awk '
-    /<!--TOON:backlog\[/ { in_block=1; next }
-    /<!--TOON:subtasks\[/ { in_subtasks=1; next }
-    /-->/ { in_block=0; in_subtasks=0; next }
-    in_block || in_subtasks { print }
-    ' "$todo_file"
-}
-
-# Push TODO.md to Beads
-cmd_push() {
-    local force="${1:-false}"
-    local dry_run="${2:-false}"
-    local verbose="${3:-false}"
-    
-    local project_root
-    project_root=$(find_project_root) || {
-        log_error "Not in a project directory"
-        return 1
-    }
-    
-    check_beads_installed || return 1
-    
-    # Initialize if needed
-    if [[ ! -d "$project_root/.beads" ]]; then
-        log_info "Beads not initialized, running init..."
-        cmd_init || return 1
-    fi
-    
-    acquire_lock || return 1
-    
-    # Capture checksums before
-    local todo_checksum_before
-    local beads_checksum_before
-    todo_checksum_before=$(checksum_todo "$project_root")
-    beads_checksum_before=$(checksum_beads "$project_root")
-    
-    log_info "Syncing TODO.md → Beads..."
-    [[ "$verbose" == "true" ]] && log_info "TODO.md checksum: $todo_checksum_before"
-    
-    if [[ "$dry_run" == "true" ]]; then
-        log_info "[DRY RUN] Would sync the following tasks:"
-        parse_todo_md "$project_root" | head -10
-        return 0
-    fi
-    
-    # Parse TODO.md and create/update Beads issues
-    local task_count=0
-    local error_count=0
-    
-    while IFS= read -r line; do
-        [[ -z "$line" ]] && continue
-        
-        # Parse TOON line - extract first two fields (id, desc)
-        local id desc
-        id=$(echo "$line" | cut -d',' -f1)
-        desc=$(echo "$line" | cut -d',' -f2)
-        [[ -z "$id" ]] && continue
-        
-        # Check if issue exists in Beads
-        if bd show "$id" --json &>/dev/null; then
-            # Update existing
-            if [[ "$verbose" == "true" ]]; then
-                log_info "Updating: $id - $desc"
-            fi
-            # bd update "$id" --title "$desc" --json &>/dev/null || ((error_count++))
-        else
-            # Create new
-            if [[ "$verbose" == "true" ]]; then
-                log_info "Creating: $id - $desc"
-            fi
-            # For now, just count - actual creation would use bd create
-            # bd create "$desc" --json &>/dev/null || ((error_count++))
-        fi
-        ((task_count++))
-    done < <(parse_todo_md "$project_root")
-    
-    # Verify checksums after
-    local beads_checksum_after
-    beads_checksum_after=$(checksum_beads "$project_root")
-    
-    log_sync "$project_root" "PUSH" "tasks=$task_count errors=$error_count todo_checksum=$todo_checksum_before beads_checksum_before=$beads_checksum_before beads_checksum_after=$beads_checksum_after"
-    
-    if [[ $error_count -gt 0 ]]; then
-        log_warn "Sync completed with $error_count errors"
-        return 1
-    fi
-    
-    log_success "Synced $task_count tasks to Beads"
-    return 0
-}
-
-# Pull from Beads to TODO.md
-cmd_pull() {
-    local force="${1:-false}"
-    local dry_run="${2:-false}"
-    local verbose="${3:-false}"
-    
-    local project_root
-    project_root=$(find_project_root) || {
-        log_error "Not in a project directory"
-        return 1
-    }
-    
-    check_beads_installed || return 1
-    
-    if [[ ! -d "$project_root/.beads" ]]; then
-        log_error "Beads not initialized. Run 'beads-sync-helper.sh init' first"
-        return 1
-    fi
-    
-    acquire_lock || return 1
-    
-    # Capture checksums before
-    local todo_checksum_before
-    local beads_checksum_before
-    todo_checksum_before=$(checksum_todo "$project_root")
-    beads_checksum_before=$(checksum_beads "$project_root")
-    
-    log_info "Syncing Beads → TODO.md..."
-    [[ "$verbose" == "true" ]] && log_info "Beads checksum: $beads_checksum_before"
-    
-    # Suppress unused variable warnings - these are used for logging
-    : "${force:=false}"
-    
-    if [[ "$dry_run" == "true" ]]; then
-        log_info "[DRY RUN] Would import the following from Beads:"
-        (cd "$project_root" && bd list --json 2>/dev/null | head -10) || true
-        return 0
-    fi
-    
-    # Export from Beads
-    local beads_export
-    beads_export=$(cd "$project_root" && bd list --json 2>/dev/null) || {
-        log_error "Failed to export from Beads"
-        return 1
-    }
-    
-    # Count issues
-    local issue_count
-    issue_count=$(echo "$beads_export" | grep -c '"id"' || echo "0")
-    
-    # TODO: Implement actual TODO.md update logic
-    # This would parse the JSON and update TOON blocks
-    
-    log_sync "$project_root" "PULL" "issues=$issue_count todo_checksum_before=$todo_checksum_before beads_checksum=$beads_checksum_before"
-    
-    log_success "Imported $issue_count issues from Beads"
-    log_warn "TODO.md update not yet implemented - manual merge required"
-    return 0
-}
-
-# Two-way sync with conflict detection
-cmd_sync() {
-    local force="${1:-false}"
-    local dry_run="${2:-false}"
-    local verbose="${3:-false}"
-    
-    local project_root
-    project_root=$(find_project_root) || {
-        log_error "Not in a project directory"
-        return 1
-    }
-    
-    check_beads_installed || return 1
-    
-    acquire_lock || return 1
-    
-    # Load last sync state
-    local state_file="$project_root/.beads/sync-state.json"
-    local last_todo_checksum=""
-    local last_beads_checksum=""
-    
-    if [[ -f "$state_file" ]]; then
-        last_todo_checksum=$(grep -o '"todo_checksum":"[^"]*"' "$state_file" | cut -d'"' -f4 || echo "")
-        last_beads_checksum=$(grep -o '"beads_checksum":"[^"]*"' "$state_file" | cut -d'"' -f4 || echo "")
-    fi
-    
-    # Get current checksums
-    local current_todo_checksum
-    local current_beads_checksum
-    current_todo_checksum=$(checksum_todo "$project_root")
-    current_beads_checksum=$(checksum_beads "$project_root")
-    
-    # Detect changes
-    local todo_changed=false
-    local beads_changed=false
-    
-    [[ "$current_todo_checksum" != "$last_todo_checksum" ]] && todo_changed=true
-    [[ "$current_beads_checksum" != "$last_beads_checksum" ]] && beads_changed=true
-    
-    log_info "Sync status:"
-    log_info "  TODO.md changed: $todo_changed"
-    log_info "  Beads changed: $beads_changed"
-    
-    # Conflict detection
-    if [[ "$todo_changed" == "true" ]] && [[ "$beads_changed" == "true" ]]; then
-        if [[ "$force" != "true" ]]; then
-            log_error "CONFLICT: Both TODO.md and Beads have changed since last sync"
-            log_error "Options:"
-            log_error "  1. beads-sync-helper.sh push --force  (TODO.md wins)"
-            log_error "  2. beads-sync-helper.sh pull --force  (Beads wins)"
-            log_error "  3. Manually resolve and run sync again"
-            return 1
-        fi
-        log_warn "Force mode: proceeding despite conflict (TODO.md wins)"
-    fi
-    
-    # Perform sync
-    if [[ "$todo_changed" == "true" ]]; then
-        log_info "TODO.md has changes, pushing to Beads..."
-        cmd_push "$force" "$dry_run" "$verbose" || return 1
-    elif [[ "$beads_changed" == "true" ]]; then
-        log_info "Beads has changes, pulling to TODO.md..."
-        cmd_pull "$force" "$dry_run" "$verbose" || return 1
-    else
-        log_info "No changes detected, already in sync"
-    fi
-    
-    # Save sync state
-    if [[ "$dry_run" != "true" ]]; then
-        mkdir -p "$project_root/.beads"
-        cat > "$state_file" <<EOF
-{
-  "last_sync": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
-  "todo_checksum": "$(checksum_todo "$project_root")",
-  "beads_checksum": "$(checksum_beads "$project_root")"
-}
-EOF
-    fi
-    
-    log_sync "$project_root" "SYNC" "todo_changed=$todo_changed beads_changed=$beads_changed"
-    log_success "Sync complete"
-    return 0
-}
-
-# Show sync status
-cmd_status() {
-    local project_root
-    project_root=$(find_project_root) || {
-        log_error "Not in a project directory"
-        return 1
-    }
-    
-    echo "=== Beads Sync Status ==="
-    echo ""
-    echo "Project: $project_root"
-    echo ""
-    
-    # TODO.md status
-    if [[ -f "$project_root/TODO.md" ]]; then
-        local todo_checksum
-        todo_checksum=$(checksum_todo "$project_root")
-        local todo_tasks
-        todo_tasks=$(grep -c '^\- \[' "$project_root/TODO.md" 2>/dev/null || echo "0")
-        echo "TODO.md: $todo_tasks tasks (checksum: ${todo_checksum:0:8}...)"
-    else
-        echo "TODO.md: Not found"
-    fi
-    
-    # Beads status
-    if [[ -d "$project_root/.beads" ]]; then
-        local beads_checksum
-        beads_checksum=$(checksum_beads "$project_root")
-        local beads_issues="0"
-        if command -v bd &> /dev/null; then
-            beads_issues=$(cd "$project_root" && bd list --json 2>/dev/null | grep -c '"id"' || echo "0")
-        fi
-        echo "Beads: $beads_issues issues (checksum: ${beads_checksum:0:8}...)"
-    else
-        echo "Beads: Not initialized"
-    fi
-    
-    # Last sync
-    local state_file="$project_root/.beads/sync-state.json"
-    if [[ -f "$state_file" ]]; then
-        local last_sync
-        last_sync=$(grep -o '"last_sync":"[^"]*"' "$state_file" | cut -d'"' -f4 || echo "never")
-        echo ""
-        echo "Last sync: $last_sync"
-    fi
-    
-    # Sync log
-    local log_file="$project_root/.beads/sync.log"
-    if [[ -f "$log_file" ]]; then
-        echo ""
-        echo "Recent sync operations:"
-        tail -5 "$log_file" | sed 's/^/  /'
-    fi
-    
-    return 0
-}
-
-# Show ready tasks (no blockers)
-cmd_ready() {
-    local project_root
-    project_root=$(find_project_root) || {
-        log_error "Not in a project directory"
-        return 1
-    }
-    
-    if [[ ! -f "$project_root/TODO.md" ]]; then
-        log_error "TODO.md not found"
-        return 1
-    fi
-    
-    echo "=== Ready Tasks (No Blockers) ==="
-    echo ""
-    
-    # Parse TODO.md for tasks without blocked-by
-    local ready_count=0
-    local blocked_count=0
-    
-    # Simple grep-based approach - production would use proper TOON parsing
-    while IFS= read -r line; do
-        # Skip non-task lines
-        [[ ! "$line" =~ ^-\ \[\ \] ]] && continue
-        
-        # Check for blocked-by
-        if [[ "$line" =~ blocked-by: ]]; then
-            ((blocked_count++))
-            # Extract task ID and blocker
-            local task_id
-            task_id=$(echo "$line" | grep -oE 't[0-9]+(\.[0-9]+)*' | head -1)
-            local blocker
-            blocker=$(echo "$line" | grep -oE 'blocked-by:[^ ]+' | cut -d: -f2)
-            echo "  BLOCKED: $task_id (waiting on: $blocker)"
-        else
-            ((ready_count++))
-            # Extract task ID and description
-            local task_info
-            task_info=$(echo "$line" | sed 's/^- \[ \] //' | cut -d'#' -f1 | head -c 60)
-            echo "  READY: $task_info"
-        fi
-    done < "$project_root/TODO.md"
-    
-    echo ""
-    echo "Summary: $ready_count ready, $blocked_count blocked"
-    
-    # If Beads is available, also show bd ready
-    if command -v bd &> /dev/null && [[ -d "$project_root/.beads" ]]; then
-        echo ""
-        echo "=== Beads Ready (bd ready) ==="
-        (cd "$project_root" && bd ready 2>/dev/null) || true
-    fi
-    
-    return 0
-}
-
-# Show help
-show_help() {
-    cat <<EOF
-beads-sync-helper.sh - Bi-directional sync between aidevops TODO.md and Beads
-
-Usage:
-  beads-sync-helper.sh [command] [options]
-
-Commands:
-  push      Sync TODO.md → Beads (aidevops is source of truth)
-  pull      Sync Beads → TODO.md (import changes from Beads)
-  sync      Two-way sync with conflict detection
-  status    Show sync status and any pending changes
-  init      Initialize Beads in current project
-  ready     Show tasks with no open blockers
-  help      Show this help message
-
-Options:
-  --force   Skip conflict detection (use with caution)
-  --dry-run Show what would be synced without making changes
-  --verbose Show detailed sync operations
-
-Examples:
-  beads-sync-helper.sh init           # Initialize Beads
-  beads-sync-helper.sh push           # Push TODO.md to Beads
-  beads-sync-helper.sh sync           # Two-way sync
-  beads-sync-helper.sh ready          # Show unblocked tasks
-  beads-sync-helper.sh push --dry-run # Preview push
-
-Sync Guarantees:
-  - Lock file prevents concurrent syncs
-  - Checksum verification before/after
-  - Conflict detection with manual resolution
-  - Audit log at .beads/sync.log
-
-For more information: https://aidevops.sh
-EOF
-}
-
-# Main
-main() {
-    local command="${1:-help}"
-    shift || true
-    
-    # Parse options
-    local force=false
-    local dry_run=false
-    local verbose=false
-    
-    while [[ $# -gt 0 ]]; do
-        case "$1" in
-            --force) force=true ;;
-            --dry-run) dry_run=true ;;
-            --verbose) verbose=true ;;
-            *) log_error "Unknown option: $1"; show_help; return 1 ;;
-        esac
-        shift
-    done
-    
-    case "$command" in
-        init) cmd_init ;;
-        push) cmd_push "$force" "$dry_run" "$verbose" ;;
-        pull) cmd_pull "$force" "$dry_run" "$verbose" ;;
-        sync) cmd_sync "$force" "$dry_run" "$verbose" ;;
-        status) cmd_status ;;
-        ready) cmd_ready ;;
-        help|--help|-h) show_help ;;
-        *) log_error "Unknown command: $command"; show_help; return 1 ;;
-    esac
-}
-
-main "$@"

package/.agent/scripts/closte-helper.sh

@@ -1,5 +0,0 @@
-#!/bin/bash
-# shellcheck disable=SC2034,SC2155,SC2317,SC2329,SC2016,SC2181,SC1091,SC2154,SC2015,SC2086,SC2129,SC2030,SC2031,SC2119,SC2120,SC2001,SC2162,SC2088,SC2089,SC2090,SC2029,SC2006,SC2153
-# Closte Helper - Placeholder for future implementation
-
-return 0