agentic-loop 3.4.0 → 3.4.2

package/bin/ralph.sh

@@ -57,6 +57,7 @@ source "$RALPH_LIB/verify.sh"
 source "$RALPH_LIB/prd.sh"
 source "$RALPH_LIB/signs.sh"
 source "$RALPH_LIB/test.sh"
+source "$RALPH_LIB/ci.sh"
 
 # Run auto-config if config.json was just created
 if [[ "${_ralph_needs_autoconfig:-}" == "true" ]]; then
@@ -111,6 +112,9 @@ main() {
     coverage)
       ralph_test_coverage "$@"
       ;;
+    ci)
+      ralph_ci "$@"
+      ;;
     sign)
       ralph_sign "$@"
       ;;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-loop",
-  "version": "3.4.0",
+  "version": "3.4.2",
   "description": "Autonomous AI coding loop - PRD-driven development with Claude Code",
   "author": "Allie Jones <allie@allthrive.ai>",
   "license": "MIT",

package/ralph/ci.sh

@@ -0,0 +1,130 @@
+#!/usr/bin/env bash
+# shellcheck shell=bash
+# ci.sh - Set up GitHub Actions CI/CD workflows
+
+# Install GitHub Actions workflows
+ralph_ci() {
+  local cmd="${1:-install}"
+
+  case "$cmd" in
+    install)
+      install_github_workflows
+      ;;
+    status)
+      check_ci_status
+      ;;
+    *)
+      echo "Usage: ralph ci [install|status]"
+      echo ""
+      echo "Commands:"
+      echo "  install  - Install GitHub Actions workflows"
+      echo "  status   - Check CI status"
+      ;;
+  esac
+}
+
+install_github_workflows() {
+  echo ""
+  print_info "=== Setting up GitHub Actions CI/CD ==="
+  echo ""
+
+  # Check if this is a git repo
+  if [[ ! -d ".git" ]]; then
+    print_error "Not a git repository. Run 'git init' first."
+    return 1
+  fi
+
+  # Create workflows directory
+  mkdir -p .github/workflows
+
+  # Copy workflow templates
+  local template_dir="$RALPH_TEMPLATES/github/workflows"
+
+  if [[ ! -d "$template_dir" ]]; then
+    print_error "Workflow templates not found at $template_dir"
+    return 1
+  fi
+
+  # Install PR workflow
+  if [[ -f ".github/workflows/pr.yml" ]]; then
+    echo "  PR workflow already exists, skipping..."
+  else
+    cp "$template_dir/pr.yml" .github/workflows/pr.yml
+    print_success "Created .github/workflows/pr.yml (fast lint checks)"
+  fi
+
+  # Install nightly workflow
+  if [[ -f ".github/workflows/nightly.yml" ]]; then
+    echo "  Nightly workflow already exists, skipping..."
+  else
+    cp "$template_dir/nightly.yml" .github/workflows/nightly.yml
+    print_success "Created .github/workflows/nightly.yml (full test suite)"
+  fi
+
+  echo ""
+  echo "Workflows installed:"
+  echo ""
+  echo "  📋 PR Check (.github/workflows/pr.yml)"
+  echo "     Runs on: Pull requests to main/master"
+  echo "     Checks: Lint, TypeScript, Build"
+  echo "     Speed: Fast (~1-2 min)"
+  echo ""
+  echo "  🌙 Nightly Tests (.github/workflows/nightly.yml)"
+  echo "     Runs on: Daily at 3am UTC + manual trigger"
+  echo "     Checks: Full test suite + PRD testSteps + Coverage"
+  echo "     Speed: Comprehensive (~5-10 min)"
+  echo ""
+
+  # Check if we need to customize for monorepo
+  local backend_dir frontend_dir
+  backend_dir=$(get_config '.directories.backend' "")
+  frontend_dir=$(get_config '.directories.frontend' "")
+
+  if [[ -n "$backend_dir" ]] || [[ -n "$frontend_dir" ]]; then
+    print_warning "Monorepo detected. You may need to customize workflow paths."
+    echo ""
+    echo "  Edit .github/workflows/*.yml to add:"
+    [[ -n "$backend_dir" ]] && echo "    - working-directory: $backend_dir"
+    [[ -n "$frontend_dir" ]] && echo "    - working-directory: $frontend_dir"
+    echo ""
+  fi
+
+  # Remind about secrets
+  echo "Next steps:"
+  echo "  1. Review and customize the workflows if needed"
+  echo "  2. Commit and push: git add .github && git commit -m 'ci: Add GitHub Actions workflows'"
+  echo "  3. Set up any required secrets in GitHub repo settings"
+  echo ""
+
+  return 0
+}
+
+check_ci_status() {
+  echo ""
+  print_info "=== CI/CD Status ==="
+  echo ""
+
+  # Check for workflow files
+  if [[ -f ".github/workflows/pr.yml" ]]; then
+    print_success "PR workflow: installed"
+  else
+    print_warning "PR workflow: not installed"
+  fi
+
+  if [[ -f ".github/workflows/nightly.yml" ]]; then
+    print_success "Nightly workflow: installed"
+  else
+    print_warning "Nightly workflow: not installed"
+  fi
+
+  # Check GitHub CLI
+  if command -v gh &>/dev/null; then
+    echo ""
+    echo "Recent workflow runs:"
+    gh run list --limit 5 2>/dev/null || echo "  (unable to fetch - check 'gh auth login')"
+  else
+    echo ""
+    echo "Install GitHub CLI (gh) to see workflow status:"
+    echo "  brew install gh && gh auth login"
+  fi
+}

package/ralph/setup.sh

@@ -26,6 +26,7 @@ ralph_setup() {
   setup_claude_md
   setup_mcp
   setup_precommit_hooks
+  setup_github_ci "$pkg_root"
 
   echo ""
   echo "  ========================================"
@@ -463,3 +464,53 @@ EOF
     echo "  Then run: pre-commit install"
   fi
 }
+
+# Set up GitHub Actions CI/CD
+setup_github_ci() {
+  local pkg_root="$1"
+  local template_dir="$pkg_root/templates/github/workflows"
+
+  # Skip if not a git repo
+  if [[ ! -d ".git" ]]; then
+    return 0
+  fi
+
+  # Skip if templates don't exist
+  if [[ ! -d "$template_dir" ]]; then
+    return 0
+  fi
+
+  # Skip if already set up
+  if [[ -f ".github/workflows/pr.yml" ]] && [[ -f ".github/workflows/nightly.yml" ]]; then
+    return 0
+  fi
+
+  echo ""
+  echo "  GitHub Actions CI/CD can be configured:"
+  echo "    - PR checks: Fast lint/typecheck on pull requests"
+  echo "    - Nightly: Full test suite + PRD tests at 3am UTC"
+  echo ""
+  read -r -p "  Set up GitHub Actions? [Y/n] " response
+
+  if [[ "$response" =~ ^[Nn]$ ]]; then
+    echo "  Skipped GitHub Actions (run 'ralph ci install' later)"
+    return 0
+  fi
+
+  echo "Setting up GitHub Actions CI/CD..."
+
+  # Create workflows directory
+  mkdir -p .github/workflows
+
+  # Install PR workflow
+  if [[ ! -f ".github/workflows/pr.yml" ]]; then
+    cp "$template_dir/pr.yml" .github/workflows/pr.yml
+    echo "  Created .github/workflows/pr.yml (fast PR checks)"
+  fi
+
+  # Install nightly workflow
+  if [[ ! -f ".github/workflows/nightly.yml" ]]; then
+    cp "$template_dir/nightly.yml" .github/workflows/nightly.yml
+    echo "  Created .github/workflows/nightly.yml (nightly full tests)"
+  fi
+}

package/templates/github/workflows/nightly.yml

@@ -0,0 +1,105 @@
+# Nightly comprehensive test suite
+# Runs full tests + all PRD testSteps
+
+name: Nightly Tests
+
+on:
+  schedule:
+    # Run at 3am UTC every day
+    - cron: '0 3 * * *'
+  workflow_dispatch: # Allow manual trigger
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    services:
+      # Add postgres if your project needs it
+      postgres:
+        image: postgres:15
+        env:
+          POSTGRES_USER: test
+          POSTGRES_PASSWORD: test
+          POSTGRES_DB: test
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    env:
+      DATABASE_URL: postgresql://test:test@localhost:5432/test
+
+    steps:
+      - uses: actions/checkout@v4
+
+      # Python setup
+      - name: Set up Python
+        if: hashFiles('pyproject.toml') != '' || hashFiles('requirements.txt') != ''
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install Python dependencies
+        if: hashFiles('pyproject.toml') != ''
+        run: |
+          pip install uv
+          uv pip install -e ".[dev]" --system 2>/dev/null || pip install -e ".[dev]" 2>/dev/null || pip install -e . 2>/dev/null || true
+
+      # Node.js setup
+      - name: Set up Node.js
+        if: hashFiles('package.json') != ''
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install Node dependencies
+        if: hashFiles('package.json') != ''
+        run: npm ci
+
+      # Run database migrations if needed
+      - name: Run migrations
+        if: hashFiles('alembic.ini') != ''
+        run: alembic upgrade head
+        continue-on-error: true
+
+      # Python tests
+      - name: Python tests
+        if: hashFiles('pyproject.toml') != '' || hashFiles('pytest.ini') != ''
+        run: |
+          pytest -v --tb=short 2>/dev/null || python -m pytest -v --tb=short 2>/dev/null || true
+
+      # Node tests
+      - name: Node tests
+        if: hashFiles('package.json') != ''
+        run: npm test 2>/dev/null || true
+
+      # PRD testSteps (if ralph is set up)
+      - name: Install ralph
+        run: npm install -g thrivekit 2>/dev/null || true
+
+      - name: Run PRD tests
+        if: hashFiles('.ralph/prd.json') != ''
+        run: ralph test prd 2>/dev/null || true
+        continue-on-error: true
+
+      # Coverage report
+      - name: Coverage report
+        if: hashFiles('pyproject.toml') != ''
+        run: |
+          pip install pytest-cov
+          pytest --cov --cov-report=term-missing 2>/dev/null || true
+        continue-on-error: true
+
+  notify:
+    needs: test
+    runs-on: ubuntu-latest
+    if: failure()
+    steps:
+      - name: Notify on failure
+        run: |
+          echo "Nightly tests failed! Check the workflow run for details."
+          # Add Slack/Discord notification here if desired

package/templates/github/workflows/pr.yml

@@ -0,0 +1,56 @@
+# Fast PR checks - lint only, no tests
+# Tests run in nightly workflow to keep PRs fast
+
+name: PR Check
+
+on:
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      # Python linting
+      - name: Set up Python
+        if: hashFiles('pyproject.toml') != '' || hashFiles('requirements.txt') != ''
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install Python dependencies
+        if: hashFiles('pyproject.toml') != ''
+        run: |
+          pip install ruff
+          pip install -e . 2>/dev/null || true
+
+      - name: Ruff lint
+        if: hashFiles('pyproject.toml') != '' || hashFiles('ruff.toml') != ''
+        run: ruff check .
+
+      # Node.js linting
+      - name: Set up Node.js
+        if: hashFiles('package.json') != ''
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install Node dependencies
+        if: hashFiles('package.json') != ''
+        run: npm ci
+
+      - name: ESLint
+        if: hashFiles('package.json') != ''
+        run: npm run lint 2>/dev/null || npx eslint . 2>/dev/null || true
+
+      - name: TypeScript check
+        if: hashFiles('tsconfig.json') != ''
+        run: npx tsc --noEmit
+
+      # Build check (catches import/bundling errors)
+      - name: Build
+        if: hashFiles('package.json') != ''
+        run: npm run build 2>/dev/null || true