anvil-dev-framework 0.1.6

package/scripts/init-project.sh

@@ -0,0 +1,541 @@
+#!/bin/bash
+
+#
+# Anvil Development Framework - Project Initialization (ANV-5)
+#
+# This script initializes Anvil in a project directory with optional
+# template selection, hook symlinks, and Linear integration.
+#
+# Usage:
+#   anvil init [directory] [options]
+#
+# Options:
+#   --template <type>   Use template: nextjs, python, saas, generic (default: generic)
+#   --with-hooks        Create symlinks to framework hooks and commands
+#   --with-linear       Run /linear-setup after initialization
+#   --force             Overwrite existing files (backs up to .claude/.backup/)
+#   --dry-run           Show what would be done without making changes
+#   --help              Show this help message
+#
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# Determine anvil directory (where this script lives)
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ANVIL_DIR="$(dirname "$SCRIPT_DIR")"
+
+# Default options
+PROJECT_DIR=""
+TEMPLATE="generic"
+WITH_HOOKS=false
+WITH_LINEAR=false
+FORCE=false
+DRY_RUN=false
+
+# =============================================================================
+# Argument Parsing
+# =============================================================================
+
+show_help() {
+    echo "Anvil Development Framework - Project Initialization"
+    echo ""
+    echo "Usage: anvil init [directory] [options]"
+    echo ""
+    echo "Options:"
+    echo "  --template <type>   Template to use: nextjs, python, saas, generic (default: generic)"
+    echo "  --with-hooks        Create symlinks to framework hooks and commands"
+    echo "  --with-linear       Run /linear-setup after initialization"
+    echo "  --force             Overwrite existing files (backs up to .claude/.backup/)"
+    echo "  --dry-run           Show what would be done without making changes"
+    echo "  --help              Show this help message"
+    echo ""
+    echo "Templates:"
+    echo "  generic    Basic template for any project type"
+    echo "  nextjs     Next.js + TypeScript + Supabase + Tailwind"
+    echo "  python     Python + FastAPI + SQLAlchemy"
+    echo "  saas       SaaS application (Next.js based)"
+    echo ""
+    echo "Examples:"
+    echo "  anvil init                           # Initialize current directory"
+    echo "  anvil init ./my-project              # Initialize specific directory"
+    echo "  anvil init --template nextjs         # Use Next.js template"
+    echo "  anvil init --with-hooks --with-linear # Full setup with hooks and Linear"
+    echo ""
+    exit 0
+}
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --template)
+            TEMPLATE="$2"
+            shift 2
+            ;;
+        --with-hooks)
+            WITH_HOOKS=true
+            shift
+            ;;
+        --with-linear)
+            WITH_LINEAR=true
+            shift
+            ;;
+        --force)
+            FORCE=true
+            shift
+            ;;
+        --dry-run)
+            DRY_RUN=true
+            shift
+            ;;
+        --help|-h)
+            show_help
+            ;;
+        -*)
+            echo -e "${RED}Error: Unknown option: $1${NC}"
+            echo "Run 'anvil init --help' for usage information."
+            exit 1
+            ;;
+        *)
+            # First non-option argument is the project directory
+            if [ -z "$PROJECT_DIR" ]; then
+                PROJECT_DIR="$1"
+            fi
+            shift
+            ;;
+    esac
+done
+
+# Default to current directory if not specified
+if [ -z "$PROJECT_DIR" ]; then
+    PROJECT_DIR="$(pwd)"
+fi
+
+# Validate template
+case $TEMPLATE in
+    generic|nextjs|python|saas)
+        ;;
+    *)
+        echo -e "${RED}Error: Unknown template: $TEMPLATE${NC}"
+        echo "Available templates: generic, nextjs, python, saas"
+        exit 1
+        ;;
+esac
+
+# Map template names to directories
+get_template_dir() {
+    case $1 in
+        nextjs) echo "saas" ;;      # nextjs uses saas template
+        python) echo "api-python" ;; # python uses api-python template
+        *) echo "$1" ;;
+    esac
+}
+
+TEMPLATE_DIR=$(get_template_dir "$TEMPLATE")
+
+# =============================================================================
+# Helper Functions
+# =============================================================================
+
+# Dry-run aware file operations
+do_mkdir() {
+    if [ "$DRY_RUN" = true ]; then
+        echo -e "  ${CYAN}[dry-run]${NC} mkdir -p $1"
+    else
+        mkdir -p "$1"
+    fi
+}
+
+do_cp() {
+    if [ "$DRY_RUN" = true ]; then
+        echo -e "  ${CYAN}[dry-run]${NC} cp $1 → $2"
+    else
+        cp "$1" "$2"
+    fi
+}
+
+do_ln() {
+    if [ "$DRY_RUN" = true ]; then
+        echo -e "  ${CYAN}[dry-run]${NC} ln -s $1 → $2"
+    else
+        ln -sf "$1" "$2"
+    fi
+}
+
+# Backup existing file before overwriting
+backup_file() {
+    local file="$1"
+    if [ -f "$file" ] && [ "$FORCE" = true ]; then
+        local backup_dir="$PROJECT_DIR/.claude/.backup/$(date +%Y%m%d-%H%M%S)"
+        local rel_path="${file#$PROJECT_DIR/}"
+        local backup_path="$backup_dir/$rel_path"
+
+        if [ "$DRY_RUN" = true ]; then
+            echo -e "  ${CYAN}[dry-run]${NC} backup $rel_path"
+        else
+            mkdir -p "$(dirname "$backup_path")"
+            cp "$file" "$backup_path"
+            echo -e "  ${YELLOW}↪${NC} Backed up: $rel_path"
+        fi
+    fi
+}
+
+# Check if file should be written (new or force mode)
+should_write() {
+    local file="$1"
+    if [ ! -f "$file" ]; then
+        return 0  # File doesn't exist, should write
+    elif [ "$FORCE" = true ]; then
+        backup_file "$file"
+        return 0  # Force mode, should write after backup
+    else
+        return 1  # File exists and no force
+    fi
+}
+
+# =============================================================================
+# Main Script
+# =============================================================================
+
+# Banner
+echo ""
+echo -e "${BLUE}Anvil Project Initialization${NC}"
+echo "══════════════════════════════"
+if [ "$DRY_RUN" = true ]; then
+    echo -e "${CYAN}[DRY RUN MODE - No changes will be made]${NC}"
+fi
+echo ""
+
+# Validate project directory
+if [ ! -d "$PROJECT_DIR" ]; then
+    echo -e "${RED}Error: Directory does not exist: $PROJECT_DIR${NC}"
+    exit 1
+fi
+
+# Check if it's a git repo
+if [ ! -d "$PROJECT_DIR/.git" ]; then
+    echo -e "${YELLOW}Warning: Not a git repository. Some features may not work.${NC}"
+fi
+
+echo -e "${BLUE}Initializing Anvil in: ${PROJECT_DIR}${NC}"
+echo -e "${BLUE}Template: ${TEMPLATE}${NC}"
+[ "$WITH_HOOKS" = true ] && echo -e "${BLUE}Hooks: enabled${NC}"
+[ "$WITH_LINEAR" = true ] && echo -e "${BLUE}Linear: enabled${NC}"
+echo ""
+
+# Create .claude directory structure
+echo -e "${BLUE}Creating directory structure...${NC}"
+do_mkdir "$PROJECT_DIR/.claude"
+do_mkdir "$PROJECT_DIR/.claude/specs/current"
+do_mkdir "$PROJECT_DIR/.claude/specs/archive"
+do_mkdir "$PROJECT_DIR/.claude/changes"
+do_mkdir "$PROJECT_DIR/.claude/handoffs"
+do_mkdir "$PROJECT_DIR/.claude/examples"
+do_mkdir "$PROJECT_DIR/.claude/commands"
+
+if [ "$DRY_RUN" = false ]; then
+    echo -e "  ${GREEN}✓${NC} .claude/"
+    echo -e "  ${GREEN}✓${NC} .claude/specs/current/"
+    echo -e "  ${GREEN}✓${NC} .claude/specs/archive/"
+    echo -e "  ${GREEN}✓${NC} .claude/changes/"
+    echo -e "  ${GREEN}✓${NC} .claude/handoffs/"
+    echo -e "  ${GREEN}✓${NC} .claude/examples/"
+    echo -e "  ${GREEN}✓${NC} .claude/commands/"
+fi
+
+# Copy project templates
+echo ""
+echo -e "${BLUE}Installing project templates...${NC}"
+
+# Check for template-specific CLAUDE.md first, fall back to generic
+TEMPLATE_CLAUDE_MD=""
+if [ -f "$ANVIL_DIR/project/templates/$TEMPLATE_DIR/CLAUDE.md" ]; then
+    TEMPLATE_CLAUDE_MD="$ANVIL_DIR/project/templates/$TEMPLATE_DIR/CLAUDE.md"
+elif [ -f "$ANVIL_DIR/project/CLAUDE.md.template" ]; then
+    TEMPLATE_CLAUDE_MD="$ANVIL_DIR/project/CLAUDE.md.template"
+fi
+
+# CLAUDE.md
+if [ -n "$TEMPLATE_CLAUDE_MD" ]; then
+    if should_write "$PROJECT_DIR/.claude/CLAUDE.md"; then
+        do_cp "$TEMPLATE_CLAUDE_MD" "$PROJECT_DIR/.claude/CLAUDE.md"
+        [ "$DRY_RUN" = false ] && echo -e "  ${GREEN}✓${NC} CLAUDE.md (from $TEMPLATE template)"
+    else
+        echo -e "  ${YELLOW}⊘${NC} CLAUDE.md (exists, use --force to overwrite)"
+    fi
+fi
+
+# constitution.md
+if should_write "$PROJECT_DIR/.claude/constitution.md"; then
+    do_cp "$ANVIL_DIR/project/constitution.md.template" "$PROJECT_DIR/.claude/constitution.md"
+    [ "$DRY_RUN" = false ] && echo -e "  ${GREEN}✓${NC} constitution.md"
+else
+    echo -e "  ${YELLOW}⊘${NC} constitution.md (exists)"
+fi
+
+# product.md
+if should_write "$PROJECT_DIR/.claude/product.md"; then
+    do_cp "$ANVIL_DIR/project/product.md.template" "$PROJECT_DIR/.claude/product.md"
+    [ "$DRY_RUN" = false ] && echo -e "  ${GREEN}✓${NC} product.md"
+else
+    echo -e "  ${YELLOW}⊘${NC} product.md (exists)"
+fi
+
+# linear.yaml (Linear team configuration)
+if [ ! -f "$PROJECT_DIR/.claude/linear.yaml" ]; then
+    if [ -f "$ANVIL_DIR/project/linear.yaml.template" ]; then
+        do_cp "$ANVIL_DIR/project/linear.yaml.template" "$PROJECT_DIR/.claude/linear.yaml"
+        [ "$DRY_RUN" = false ] && echo -e "  ${GREEN}✓${NC} linear.yaml (run /linear-setup to configure)"
+    fi
+else
+    echo -e "  ${YELLOW}⊘${NC} linear.yaml (exists)"
+fi
+
+# Copy commands
+if [ -d "$ANVIL_DIR/project/commands" ]; then
+    for file in "$ANVIL_DIR/project/commands"/*.md; do
+        if [ -f "$file" ]; then
+            BASENAME=$(basename "$file")
+            if should_write "$PROJECT_DIR/.claude/commands/$BASENAME"; then
+                do_cp "$file" "$PROJECT_DIR/.claude/commands/$BASENAME"
+                [ "$DRY_RUN" = false ] && echo -e "  ${GREEN}✓${NC} commands/$BASENAME"
+            fi
+        fi
+    done
+fi
+
+# Copy examples
+if [ -d "$ANVIL_DIR/project/examples" ]; then
+    for file in "$ANVIL_DIR/project/examples"/*; do
+        if [ -f "$file" ]; then
+            BASENAME=$(basename "$file")
+            if should_write "$PROJECT_DIR/.claude/examples/$BASENAME"; then
+                do_cp "$file" "$PROJECT_DIR/.claude/examples/$BASENAME"
+                [ "$DRY_RUN" = false ] && echo -e "  ${GREEN}✓${NC} examples/$BASENAME"
+            fi
+        fi
+    done
+fi
+
+# Install quality gate configs
+echo ""
+echo -e "${BLUE}Installing quality gate configurations...${NC}"
+
+# .coderabbit.yaml
+if [ -f "$ANVIL_DIR/quality-gates/.coderabbit.yaml" ]; then
+    if should_write "$PROJECT_DIR/.coderabbit.yaml"; then
+        do_cp "$ANVIL_DIR/quality-gates/.coderabbit.yaml" "$PROJECT_DIR/.coderabbit.yaml"
+        [ "$DRY_RUN" = false ] && echo -e "  ${GREEN}✓${NC} .coderabbit.yaml"
+    else
+        echo -e "  ${YELLOW}⊘${NC} .coderabbit.yaml (exists)"
+    fi
+fi
+
+# .pre-commit-config.yaml
+if [ -f "$ANVIL_DIR/quality-gates/.pre-commit-config.yaml" ]; then
+    if should_write "$PROJECT_DIR/.pre-commit-config.yaml"; then
+        do_cp "$ANVIL_DIR/quality-gates/.pre-commit-config.yaml" "$PROJECT_DIR/.pre-commit-config.yaml"
+        [ "$DRY_RUN" = false ] && echo -e "  ${GREEN}✓${NC} .pre-commit-config.yaml"
+    else
+        echo -e "  ${YELLOW}⊘${NC} .pre-commit-config.yaml (exists)"
+    fi
+fi
+
+# Semgrep rules
+if [ -d "$ANVIL_DIR/quality-gates/.semgrep" ]; then
+    do_mkdir "$PROJECT_DIR/.semgrep/rules"
+    for file in "$ANVIL_DIR/quality-gates/.semgrep/rules"/*.yaml; do
+        if [ -f "$file" ]; then
+            BASENAME=$(basename "$file")
+            if should_write "$PROJECT_DIR/.semgrep/rules/$BASENAME"; then
+                do_cp "$file" "$PROJECT_DIR/.semgrep/rules/$BASENAME"
+                [ "$DRY_RUN" = false ] && echo -e "  ${GREEN}✓${NC} .semgrep/rules/$BASENAME"
+            fi
+        fi
+    done
+fi
+
+# Update .gitignore
+echo ""
+echo -e "${BLUE}Updating .gitignore...${NC}"
+if [ "$DRY_RUN" = true ]; then
+    echo -e "  ${CYAN}[dry-run]${NC} Would update .gitignore"
+else
+    if [ -f "$PROJECT_DIR/.gitignore" ]; then
+        # Check if anvil entries already exist
+        if ! grep -q ".claude/handoffs/" "$PROJECT_DIR/.gitignore"; then
+            echo "" >> "$PROJECT_DIR/.gitignore"
+            echo "# Anvil Development Framework" >> "$PROJECT_DIR/.gitignore"
+            echo ".claude/handoffs/" >> "$PROJECT_DIR/.gitignore"
+            echo -e "  ${GREEN}✓${NC} Added .claude/handoffs/ to .gitignore"
+        else
+            echo -e "  ${YELLOW}⊘${NC} .gitignore already configured"
+        fi
+    else
+        echo "# Anvil Development Framework" > "$PROJECT_DIR/.gitignore"
+        echo ".claude/handoffs/" >> "$PROJECT_DIR/.gitignore"
+        echo -e "  ${GREEN}✓${NC} Created .gitignore"
+    fi
+fi
+
+# Install pre-commit hooks
+if [ "$DRY_RUN" = false ]; then
+    if command -v pre-commit &> /dev/null; then
+        if [ -f "$PROJECT_DIR/.pre-commit-config.yaml" ]; then
+            echo ""
+            echo -e "${BLUE}Installing pre-commit hooks...${NC}"
+            cd "$PROJECT_DIR" && pre-commit install
+            echo -e "  ${GREEN}✓${NC} Pre-commit hooks installed"
+        fi
+    fi
+else
+    if command -v pre-commit &> /dev/null; then
+        echo -e "  ${CYAN}[dry-run]${NC} Would install pre-commit hooks"
+    fi
+fi
+
+# =============================================================================
+# --with-hooks: Create symlinks to framework hooks and commands (ANV-14)
+# =============================================================================
+if [ "$WITH_HOOKS" = true ]; then
+    echo ""
+    echo -e "${BLUE}Creating framework symlinks...${NC}"
+
+    # Create hooks directory if it doesn't exist
+    do_mkdir "$PROJECT_DIR/.claude/hooks"
+
+    # Symlink global hooks
+    if [ -d "$ANVIL_DIR/global/hooks" ]; then
+        for hook in "$ANVIL_DIR/global/hooks"/*; do
+            if [ -f "$hook" ]; then
+                BASENAME=$(basename "$hook")
+                TARGET="$PROJECT_DIR/.claude/hooks/$BASENAME"
+                if [ ! -L "$TARGET" ] && [ ! -f "$TARGET" ]; then
+                    do_ln "$hook" "$TARGET"
+                    [ "$DRY_RUN" = false ] && echo -e "  ${GREEN}✓${NC} hooks/$BASENAME → global/hooks/$BASENAME"
+                else
+                    echo -e "  ${YELLOW}⊘${NC} hooks/$BASENAME (exists)"
+                fi
+            fi
+        done
+    fi
+
+    # Symlink global commands
+    if [ -d "$ANVIL_DIR/global/commands" ]; then
+        for cmd in "$ANVIL_DIR/global/commands"/*.md; do
+            if [ -f "$cmd" ]; then
+                BASENAME=$(basename "$cmd")
+                TARGET="$PROJECT_DIR/.claude/commands/$BASENAME"
+                if [ ! -L "$TARGET" ] && [ ! -f "$TARGET" ]; then
+                    do_ln "$cmd" "$TARGET"
+                    [ "$DRY_RUN" = false ] && echo -e "  ${GREEN}✓${NC} commands/$BASENAME → global/commands/$BASENAME"
+                else
+                    echo -e "  ${YELLOW}⊘${NC} commands/$BASENAME (exists)"
+                fi
+            fi
+        done
+    fi
+
+    # Symlink global lib
+    if [ -d "$ANVIL_DIR/global/lib" ]; then
+        do_mkdir "$PROJECT_DIR/.claude/lib"
+        for lib in "$ANVIL_DIR/global/lib"/*.py; do
+            if [ -f "$lib" ]; then
+                BASENAME=$(basename "$lib")
+                TARGET="$PROJECT_DIR/.claude/lib/$BASENAME"
+                if [ ! -L "$TARGET" ] && [ ! -f "$TARGET" ]; then
+                    do_ln "$lib" "$TARGET"
+                    [ "$DRY_RUN" = false ] && echo -e "  ${GREEN}✓${NC} lib/$BASENAME → global/lib/$BASENAME"
+                fi
+            fi
+        done
+    fi
+
+    echo -e "  ${GREEN}✓${NC} Framework symlinks created"
+fi
+
+# =============================================================================
+# --with-linear: Trigger Linear setup (ANV-15)
+# =============================================================================
+if [ "$WITH_LINEAR" = true ]; then
+    echo ""
+    echo -e "${BLUE}Linear integration requested...${NC}"
+    if [ "$DRY_RUN" = true ]; then
+        echo -e "  ${CYAN}[dry-run]${NC} Would prompt to run /linear-setup"
+    else
+        echo -e "  ${YELLOW}→${NC} Run '/linear-setup' in Claude Code to configure Linear integration"
+        echo -e "  ${YELLOW}→${NC} This will map your project to a Linear team"
+    fi
+fi
+
+# Create initial handoff
+if [ "$DRY_RUN" = true ]; then
+    echo ""
+    echo -e "  ${CYAN}[dry-run]${NC} Would create initial handoff file"
+else
+    HANDOFF_FILE="$PROJECT_DIR/.claude/handoffs/$(date +%Y-%m-%d)-anvil-init.md"
+    cat > "$HANDOFF_FILE" << EOF
+---
+session_date: $(date +%Y-%m-%d)
+session_time: $(date +%H:%M)
+branch: $(cd "$PROJECT_DIR" && git branch --show-current 2>/dev/null || echo "unknown")
+template: $TEMPLATE
+---
+
+# Session Handoff: Anvil Initialization
+
+## Session Summary
+Initialized Anvil Development Framework in this project using the **$TEMPLATE** template.
+
+## Completed This Session
+- Created .claude/ directory structure
+- Installed CLAUDE.md, constitution.md, product.md templates
+- Installed quality gate configurations
+- Updated .gitignore
+$([ "$WITH_HOOKS" = true ] && echo "- Created symlinks to framework hooks and commands")
+$([ "$WITH_LINEAR" = true ] && echo "- Linear integration requested (run /linear-setup)")
+
+## Recommended Next Task
+1. Customize .claude/CLAUDE.md with project-specific details
+2. Update .claude/constitution.md with project principles
+3. Fill out .claude/product.md with product definition
+4. Create convention examples in .claude/examples/
+$([ "$WITH_LINEAR" = true ] && echo "5. Run /linear-setup to configure Linear integration")
+
+## Critical Context for Next Session
+- This is a fresh Anvil installation
+- Templates need customization
+- Quality gates are configured but may need project-specific rules
+EOF
+fi
+
+echo ""
+if [ "$DRY_RUN" = true ]; then
+    echo -e "${CYAN}════════════════════════════════════════${NC}"
+    echo -e "${CYAN}  Dry run complete - no changes made${NC}"
+    echo -e "${CYAN}════════════════════════════════════════${NC}"
+else
+    echo -e "${GREEN}════════════════════════════════════════${NC}"
+    echo -e "${GREEN}  Anvil initialized successfully!${NC}"
+    echo -e "${GREEN}════════════════════════════════════════${NC}"
+fi
+echo ""
+echo "Project configured at: $PROJECT_DIR/.claude/"
+echo "Template: $TEMPLATE"
+echo ""
+echo "Next steps:"
+echo "  1. Edit .claude/CLAUDE.md with your project details"
+echo "  2. Review .claude/constitution.md principles"
+echo "  3. Fill out .claude/product.md"
+echo "  4. Add convention examples to .claude/examples/"
+[ "$WITH_LINEAR" = true ] && echo "  5. Run /linear-setup to configure Linear"
+echo ""
+echo "To start using Anvil, open Claude Code and run /orient"
+echo ""