amazingteam 3.0.0

package/scripts/plan_upgrade.sh

@@ -0,0 +1,268 @@
+#!/bin/bash
+# plan_upgrade.sh
+# Compare downstream project against foundation and generate upgrade plan
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+FOUNDATION_ROOT="$(dirname "$SCRIPT_DIR")"
+PROJECT_ROOT="${1:-.}"
+
+# Resolve to absolute path
+if [[ "${PROJECT_ROOT:0:1}" != "/" ]]; then
+    PROJECT_ROOT="$(pwd)/$PROJECT_ROOT"
+fi
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# File classification
+# Class A: Auto-generatable (safe to create/replace)
+# Class B: Auto-suggested, not auto-committed (review required)
+# Class C: Protected (human approval mandatory)
+
+CLASS_A_FILES=(
+    "tasks/_template/*"
+    ".github/ISSUE_TEMPLATE/*"
+    ".ai-team/memory/*/*.md"
+)
+
+CLASS_B_FILES=(
+    ".ai-team/agents/*.md"
+    ".ai-team/skills/*/skill.md"
+    ".ai-team/commands/*.md"
+    ".github/workflows/*.yml"
+    "AGENTS.md"
+)
+
+CLASS_C_FILES=(
+    "docs/architecture/*"
+    "docs/decisions/*"
+)
+
+echo -e "${CYAN}══════════════════════════════════════════════════${NC}"
+echo -e "${CYAN}  AI Team Foundation Upgrade Planner${NC}"
+echo -e "${CYAN}══════════════════════════════════════════════════${NC}"
+echo ""
+
+# Read versions
+FOUNDATION_VERSION=$(cat "$FOUNDATION_ROOT/VERSION" 2>/dev/null || echo "unknown")
+
+LOCK_FILE="$PROJECT_ROOT/.foundation/foundation.lock"
+if [[ -f "$LOCK_FILE" ]]; then
+    PROJECT_VERSION=$(grep "foundation_version:" "$LOCK_FILE" | cut -d: -f2 | tr -d ' ')
+    PROJECT_OVERLAY=$(grep "overlay:" "$LOCK_FILE" | cut -d: -f2 | tr -d ' ')
+else
+    PROJECT_VERSION="unknown"
+    PROJECT_OVERLAY="none"
+fi
+
+echo -e "${CYAN}Foundation Version:${NC} $FOUNDATION_VERSION"
+echo -e "${CYAN}Project Version:${NC}    $PROJECT_VERSION"
+echo -e "${CYAN}Project Overlay:${NC}    $PROJECT_OVERLAY"
+echo ""
+
+# Track changes
+MISSING_FILES=()
+OUTDATED_FILES=()
+PROTECTED_FILES=()
+LOCAL_OVERRIDES=()
+
+echo -e "${CYAN}[1] Checking for missing files...${NC}"
+echo ""
+
+# Check agents
+for agent in planner architect developer qa reviewer triage ci-analyst; do
+    if [[ ! -f "$PROJECT_ROOT/.ai-team/agents/$agent.md" ]]; then
+        MISSING_FILES+=(".ai-team/agents/$agent.md (Class B)")
+        echo -e "  ${YELLOW}Missing:${NC} .ai-team/agents/$agent.md"
+    fi
+done
+
+# Check skills
+for skill_dir in "$FOUNDATION_ROOT/.ai-team/skills"/*; do
+    if [[ -d "$skill_dir" ]]; then
+        skill=$(basename "$skill_dir")
+        if [[ ! -f "$PROJECT_ROOT/.ai-team/skills/$skill/skill.md" ]]; then
+            MISSING_FILES+=(".ai-team/skills/$skill/skill.md (Class B)")
+            echo -e "  ${YELLOW}Missing:${NC} .ai-team/skills/$skill/skill.md"
+        fi
+    fi
+done
+
+# Check commands
+for cmd in triage design implement test review ci-analyze release-check; do
+    if [[ ! -f "$PROJECT_ROOT/.ai-team/commands/$cmd.md" ]]; then
+        MISSING_FILES+=(".ai-team/commands/$cmd.md (Class B)")
+        echo -e "  ${YELLOW}Missing:${NC} .ai-team/commands/$cmd.md"
+    fi
+done
+
+# Check memory directories
+for role in planner architect developer qa reviewer triage ci-analyst failures; do
+    if [[ ! -d "$PROJECT_ROOT/.ai-team/memory/$role" ]]; then
+        MISSING_FILES+=(".ai-team/memory/$role/ (Class A)")
+        echo -e "  ${YELLOW}Missing:${NC} .ai-team/memory/$role/"
+    fi
+done
+
+# Check documentation zones
+for zone in patterns releases runbooks/ci; do
+    if [[ ! -d "$PROJECT_ROOT/docs/$zone" ]]; then
+        MISSING_FILES+=("docs/$zone/ (Class A)")
+        echo -e "  ${YELLOW}Missing:${NC} docs/$zone/"
+    fi
+done
+
+echo ""
+echo -e "${CYAN}[2] Checking for outdated files...${NC}"
+echo ""
+
+# Compare file contents (simplified - in real implementation, use proper diff)
+check_outdated() {
+    local foundation_file="$1"
+    local project_file="$2"
+    local file_class="$3"
+    
+    if [[ -f "$foundation_file" ]] && [[ -f "$project_file" ]]; then
+        if ! diff -q "$foundation_file" "$project_file" > /dev/null 2>&1; then
+            OUTDATED_FILES+=("$project_file ($file_class)")
+            echo -e "  ${BLUE}Modified:${NC} $project_file"
+        fi
+    fi
+}
+
+# Check key files for modifications
+for agent in planner architect developer qa reviewer triage ci-analyst; do
+    check_outdated \
+        "$FOUNDATION_ROOT/.ai-team/agents/$agent.md" \
+        "$PROJECT_ROOT/.ai-team/agents/$agent.md" \
+        "Class B"
+done
+
+echo ""
+echo -e "${CYAN}[3] Checking protected files...${NC}"
+echo ""
+
+# Check protected areas
+for protected in "docs/architecture" "docs/decisions"; do
+    if [[ -d "$PROJECT_ROOT/$protected" ]]; then
+        file_count=$(find "$PROJECT_ROOT/$protected" -type f 2>/dev/null | wc -l)
+        if [[ $file_count -gt 0 ]]; then
+            PROTECTED_FILES+=("$protected/ ($file_count files)")
+            echo -e "  ${RED}Protected:${NC} $protected/ ($file_count files)"
+        fi
+    fi
+done
+
+echo ""
+echo -e "${CYAN}[4] Checking local overrides...${NC}"
+echo ""
+
+OVERRIDES_FILE="$PROJECT_ROOT/.foundation/local-overrides.md"
+if [[ -f "$OVERRIDES_FILE" ]]; then
+    echo -e "  Local overrides documented at: .foundation/local-overrides.md"
+    # In a real implementation, parse and display the overrides
+else
+    echo -e "  ${YELLOW}Warning:${NC} No local-overrides.md found"
+fi
+
+echo ""
+echo -e "${CYAN}══════════════════════════════════════════════════${NC}"
+echo -e "${CYAN}Upgrade Plan Summary${NC}"
+echo -e "${CYAN}══════════════════════════════════════════════════${NC}"
+echo ""
+
+echo -e "${YELLOW}Missing Files:${NC} ${#MISSING_FILES[@]}"
+for f in "${MISSING_FILES[@]:0:5}"; do
+    echo -e "  - $f"
+done
+if [[ ${#MISSING_FILES[@]} -gt 5 ]]; then
+    echo -e "  ... and $(( ${#MISSING_FILES[@]} - 5 )) more"
+fi
+echo ""
+
+echo -e "${BLUE}Outdated Files:${NC} ${#OUTDATED_FILES[@]}"
+for f in "${OUTDATED_FILES[@]:0:5}"; do
+    echo -e "  - $f"
+done
+if [[ ${#OUTDATED_FILES[@]} -gt 5 ]]; then
+    echo -e "  ... and $(( ${#OUTDATED_FILES[@]} - 5 )) more"
+fi
+echo ""
+
+echo -e "${RED}Protected Files:${NC} ${#PROTECTED_FILES[@]}"
+for f in "${PROTECTED_FILES[@]}"; do
+    echo -e "  - $f"
+done
+echo ""
+
+# Risk assessment
+echo -e "${CYAN}Risk Assessment:${NC}"
+if [[ ${#PROTECTED_FILES[@]} -gt 0 ]]; then
+    echo -e "  ${RED}HIGH RISK${NC} - Protected files require manual review"
+elif [[ ${#OUTDATED_FILES[@]} -gt 0 ]]; then
+    echo -e "  ${YELLOW}MEDIUM RISK${NC} - Modified files need review before patching"
+elif [[ ${#MISSING_FILES[@]} -gt 0 ]]; then
+    echo -e "  ${GREEN}LOW RISK${NC} - Only additive changes needed"
+else
+    echo -e "  ${GREEN}NO CHANGES${NC} - Project is up to date"
+fi
+echo ""
+
+# Generate upgrade report
+REPORT_FILE="$PROJECT_ROOT/.foundation/upgrade-plan.md"
+cat > "$REPORT_FILE" << EOF
+# Upgrade Plan
+
+Generated: $(date -I)
+From: $PROJECT_VERSION
+To: $FOUNDATION_VERSION
+
+## Summary
+
+- Missing Files: ${#MISSING_FILES[@]}
+- Outdated Files: ${#OUTDATED_FILES[@]}
+- Protected Files: ${#PROTECTED_FILES[@]}
+
+## Missing Files
+
+$(for f in "${MISSING_FILES[@]}"; do echo "- $f"; done)
+
+## Outdated Files
+
+$(for f in "${OUTDATED_FILES[@]}"; do echo "- $f"; done)
+
+## Protected Files (Manual Review Required)
+
+$(for f in "${PROTECTED_FILES[@]}"; do echo "- $f"; done)
+
+## Recommendations
+
+$(if [[ ${#PROTECTED_FILES[@]} -gt 0 ]]; then
+    echo "1. Review all protected files before proceeding"
+    echo "2. Document any customizations in local-overrides.md"
+    echo "3. Run upgrade with --review flag"
+elif [[ ${#OUTDATED_FILES[@]} -gt 0 ]]; then
+    echo "1. Review outdated file diffs"
+    echo "2. Decide which changes to keep"
+    echo "3. Run upgrade with selective files"
+else
+    echo "1. Safe to run automatic upgrade"
+    echo "2. No conflicts detected"
+fi)
+
+## Next Steps
+
+1. Review this plan
+2. Run: ./scripts/upgrade_foundation.sh
+3. Verify changes after upgrade
+EOF
+
+echo -e "${GREEN}Upgrade plan saved to:${NC} $REPORT_FILE"
+echo ""

package/scripts/upgrade_foundation.sh

@@ -0,0 +1,365 @@
+#!/bin/bash
+# upgrade_foundation.sh
+# Apply controlled upgrade to downstream project
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+FOUNDATION_ROOT="$(dirname "$SCRIPT_DIR")"
+PROJECT_ROOT="${1:-.}"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+# Flags
+FORCE=false
+DRY_RUN=false
+SKIP_PROTECTED=true
+
+usage() {
+    echo "Usage: $0 [OPTIONS] [project-path]"
+    echo ""
+    echo "Apply controlled foundation upgrade to a downstream project."
+    echo ""
+    echo "Options:"
+    echo "  --force         Skip confirmation prompts"
+    echo "  --dry-run       Show what would be done without making changes"
+    echo "  --include-protected  Attempt to upgrade protected files (dangerous)"
+    echo "  -h, --help      Show this help message"
+    echo ""
+    echo "Examples:"
+    echo "  $0 ./my-project"
+    echo "  $0 --dry-run ."
+    echo "  $0 --force ./my-project"
+}
+
+parse_args() {
+    while [[ $# -gt 0 ]]; do
+        case $1 in
+            --force)
+                FORCE=true
+                shift
+                ;;
+            --dry-run)
+                DRY_RUN=true
+                shift
+                ;;
+            --include-protected)
+                SKIP_PROTECTED=false
+                shift
+                ;;
+            -h|--help)
+                usage
+                exit 0
+                ;;
+            *)
+                PROJECT_ROOT="$1"
+                shift
+                ;;
+        esac
+    done
+}
+
+log_info() {
+    echo -e "${CYAN}[INFO]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[SUCCESS]${NC} $1"
+}
+
+log_warning() {
+    echo -e "${YELLOW}[WARNING]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+}
+
+log_dry_run() {
+    echo -e "${BLUE}[DRY-RUN]${NC} Would: $1"
+}
+
+# File classification functions
+is_class_a() {
+    local file="$1"
+    # Class A: Auto-generatable
+    [[ "$file" == tasks/_template/* ]] && return 0
+    [[ "$file" == .github/ISSUE_TEMPLATE/* ]] && return 0
+    [[ "$file" == .ai-team/memory/* ]] && return 0
+    return 1
+}
+
+is_class_b() {
+    local file="$1"
+    # Class B: Review required
+    [[ "$file" == .ai-team/agents/* ]] && return 0
+    [[ "$file" == .ai-team/skills/* ]] && return 0
+    [[ "$file" == .ai-team/commands/* ]] && return 0
+    [[ "$file" == .github/workflows/* ]] && return 0
+    [[ "$file" == AGENTS.md ]] && return 0
+    return 1
+}
+
+is_class_c() {
+    local file="$1"
+    # Class C: Protected
+    [[ "$file" == docs/architecture/* ]] && return 0
+    [[ "$file" == docs/decisions/* ]] && return 0
+    return 1
+}
+
+is_protected() {
+    local file="$1"
+    if [[ "$SKIP_PROTECTED" == true ]] && is_class_c "$file"; then
+        return 0
+    fi
+    return 1
+}
+
+# Backup function
+create_backup() {
+    local backup_dir="$PROJECT_ROOT/.foundation/backup-$(date +%Y%m%d-%H%M%S)"
+    log_info "Creating backup at $backup_dir"
+    
+    if [[ "$DRY_RUN" == true ]]; then
+        log_dry_run "create backup at $backup_dir"
+    else
+        mkdir -p "$backup_dir"
+        # Backup key directories
+        [[ -d "$PROJECT_ROOT/.ai-team" ]] && cp -r "$PROJECT_ROOT/.ai-team" "$backup_dir/"
+        [[ -f "$PROJECT_ROOT/AGENTS.md" ]] && cp "$PROJECT_ROOT/AGENTS.md" "$backup_dir/"
+        [[ -f "$PROJECT_ROOT/opencode.jsonc" ]] && cp "$PROJECT_ROOT/opencode.jsonc" "$backup_dir/"
+    fi
+}
+
+# Add missing files
+add_missing_files() {
+    log_info "Adding missing files..."
+    
+    local added=0
+    local skipped=0
+    
+    # Agents
+    for agent in planner architect developer qa reviewer triage ci-analyst; do
+        local target="$PROJECT_ROOT/.ai-team/agents/$agent.md"
+        local source="$FOUNDATION_ROOT/.ai-team/agents/$agent.md"
+        
+        if [[ ! -f "$target" ]] && [[ -f "$source" ]]; then
+            if [[ "$DRY_RUN" == true ]]; then
+                log_dry_run "add $target"
+            else
+                mkdir -p "$(dirname "$target")"
+                cp "$source" "$target"
+                log_success "Added: .ai-team/agents/$agent.md"
+            fi
+            ((added++))
+        fi
+    done
+    
+    # Skills
+    for skill_dir in "$FOUNDATION_ROOT/.ai-team/skills"/*; do
+        if [[ -d "$skill_dir" ]]; then
+            local skill=$(basename "$skill_dir")
+            local target="$PROJECT_ROOT/.ai-team/skills/$skill/skill.md"
+            local source="$skill_dir/skill.md"
+            
+            if [[ ! -f "$target" ]] && [[ -f "$source" ]]; then
+                if [[ "$DRY_RUN" == true ]]; then
+                    log_dry_run "add $target"
+                else
+                    mkdir -p "$(dirname "$target")"
+                    cp "$source" "$target"
+                    log_success "Added: .ai-team/skills/$skill/skill.md"
+                fi
+                ((added++))
+            fi
+        fi
+    done
+    
+    # Memory directories
+    for role in planner architect developer qa reviewer triage ci-analyst failures; do
+        local target="$PROJECT_ROOT/.ai-team/memory/$role"
+        local source="$FOUNDATION_ROOT/.ai-team/memory/$role"
+        
+        if [[ ! -d "$target" ]] && [[ -d "$source" ]]; then
+            if [[ "$DRY_RUN" == true ]]; then
+                log_dry_run "add $target/"
+            else
+                mkdir -p "$target"
+                cp -r "$source"/* "$target/" 2>/dev/null || true
+                log_success "Added: .ai-team/memory/$role/"
+            fi
+            ((added++))
+        fi
+    done
+    
+    # Documentation zones
+    for zone in patterns releases runbooks/ci; do
+        local target="$PROJECT_ROOT/docs/$zone"
+        local source="$FOUNDATION_ROOT/docs/$zone"
+        
+        if [[ ! -d "$target" ]] && [[ -d "$source" ]]; then
+            if [[ "$DRY_RUN" == true ]]; then
+                log_dry_run "add $target/"
+            else
+                mkdir -p "$target"
+                cp -r "$source"/* "$target/" 2>/dev/null || true
+                log_success "Added: docs/$zone/"
+            fi
+            ((added++))
+        fi
+    done
+    
+    echo ""
+    log_info "Added: $added, Skipped: $skipped"
+}
+
+# Update outdated files (Class B only, with confirmation)
+update_outdated_files() {
+    log_info "Checking for outdated files..."
+    
+    local updated=0
+    local skipped=0
+    
+    # Check agents (Class B)
+    for agent in planner architect developer qa reviewer triage ci-analyst; do
+        local target="$PROJECT_ROOT/.ai-team/agents/$agent.md"
+        local source="$FOUNDATION_ROOT/.ai-team/agents/$agent.md"
+        
+        if [[ -f "$target" ]] && [[ -f "$source" ]]; then
+            if ! diff -q "$source" "$target" > /dev/null 2>&1; then
+                if [[ "$FORCE" == true ]]; then
+                    if [[ "$DRY_RUN" == true ]]; then
+                        log_dry_run "update $target"
+                    else
+                        cp "$source" "$target"
+                        log_success "Updated: .ai-team/agents/$agent.md"
+                    fi
+                    ((updated++))
+                else
+                    log_warning "Modified: .ai-team/agents/$agent.md (use --force to update)"
+                    ((skipped++))
+                fi
+            fi
+        fi
+    done
+    
+    echo ""
+    log_info "Updated: $updated, Skipped (use --force): $skipped"
+}
+
+# Update lock file
+update_lock_file() {
+    local lock_file="$PROJECT_ROOT/.foundation/foundation.lock"
+    local foundation_version=$(cat "$FOUNDATION_ROOT/VERSION")
+    
+    if [[ "$DRY_RUN" == true ]]; then
+        log_dry_run "update $lock_file"
+        return
+    fi
+    
+    if [[ -f "$lock_file" ]]; then
+        # Update version and last_upgrade_at
+        sed -i "s/foundation_version:.*/foundation_version: $foundation_version/" "$lock_file"
+        sed -i "s/last_upgrade_at:.*/last_upgrade_at: $(date -I)/" "$lock_file"
+        log_success "Updated foundation.lock"
+    fi
+}
+
+# Update upgrade history
+update_upgrade_history() {
+    local history_file="$PROJECT_ROOT/.foundation/upgrade-history.md"
+    local foundation_version=$(cat "$FOUNDATION_ROOT/VERSION")
+    local project_version="unknown"
+    
+    if [[ -f "$PROJECT_ROOT/.foundation/foundation.lock" ]]; then
+        project_version=$(grep "foundation_version:" "$PROJECT_ROOT/.foundation/foundation.lock" | cut -d: -f2 | tr -d ' ')
+    fi
+    
+    if [[ "$DRY_RUN" == true ]]; then
+        log_dry_run "update $history_file"
+        return
+    fi
+    
+    cat >> "$history_file" << EOF
+
+## Upgrade - $(date -I)
+
+- **From Version**: $project_version
+- **To Version**: $foundation_version
+- **Action**: Controlled upgrade applied
+- **Protected Files**: Skipped
+- **Manual Review Required**: No
+
+EOF
+    
+    log_success "Updated upgrade-history.md"
+}
+
+# Main
+parse_args "$@"
+
+# Resolve to absolute path
+if [[ "${PROJECT_ROOT:0:1}" != "/" ]]; then
+    PROJECT_ROOT="$(pwd)/$PROJECT_ROOT"
+fi
+
+FOUNDATION_VERSION=$(cat "$FOUNDATION_ROOT/VERSION" 2>/dev/null || echo "unknown")
+
+echo -e "${CYAN}══════════════════════════════════════════════════${NC}"
+echo -e "${CYAN}  AI Team Foundation Upgrade${NC}"
+echo -e "${CYAN}══════════════════════════════════════════════════${NC}"
+echo ""
+echo -e "${CYAN}Foundation Version:${NC} $FOUNDATION_VERSION"
+echo -e "${CYAN}Project Path:${NC}       $PROJECT_ROOT"
+if [[ "$DRY_RUN" == true ]]; then
+    echo -e "${BLUE}Mode:${NC}              DRY RUN (no changes will be made)"
+fi
+echo ""
+
+# Check if project has foundation lock
+if [[ ! -f "$PROJECT_ROOT/.foundation/foundation.lock" ]]; then
+    log_warning "No foundation.lock found. Is this a foundation-initialized project?"
+    if [[ "$FORCE" != true ]]; then
+        echo "Use --force to proceed anyway."
+        exit 1
+    fi
+fi
+
+# Create backup
+if [[ "$DRY_RUN" != true ]]; then
+    create_backup
+fi
+echo ""
+
+# Add missing files (Class A - always safe)
+add_missing_files
+echo ""
+
+# Update outdated files (Class B - needs review/force)
+update_outdated_files
+echo ""
+
+# Update metadata
+update_lock_file
+update_upgrade_history
+echo ""
+
+echo -e "${CYAN}══════════════════════════════════════════════════${NC}"
+echo -e "${CYAN}Upgrade Complete${NC}"
+echo -e "${CYAN}══════════════════════════════════════════════════${NC}"
+echo ""
+echo -e "${GREEN}Foundation upgraded to version:${NC} $FOUNDATION_VERSION"
+echo ""
+echo -e "Next steps:"
+echo "  1. Review changes"
+echo "  2. Run: ./scripts/validate_project_setup.sh $PROJECT_ROOT"
+echo "  3. Run: npm test (or your test command)"
+echo "  4. Commit changes"
+echo ""