Add comprehensive test automation pipeline with CI/CD

.github/workflows/CLAUDE.md

@@ -0,0 +1,11 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+### Jan 13, 2026
+
+| ID | Time | T | Title | Read |
+|----|------|---|-------|------|
+| #167 | 10:49 PM | 🟣 | Test Automation Orchestrator for Themer-Up | ~817 |
+</claude-mem-context>

.github/workflows/ci.yml

@@ -0,0 +1,206 @@
+name: CI Pipeline
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+# Cancel in-progress runs for the same branch
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  BATS_VERSION: "1.10.0"
+
+jobs:
+  # ============================================
+  # Stage 1: Static Analysis (runs in parallel)
+  # ============================================
+
+  shellcheck:
+    name: ShellCheck Linting
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Run ShellCheck
+        uses: ludeeus/action-shellcheck@master
+        with:
+          scandir: './scripts'
+          format: gcc
+          severity: warning
+
+  validate-json:
+    name: Validate JSON Configs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Validate theme JSON files
+        run: |
+          echo "Validating JSON files..."
+          for file in themes/*/iterm2.json themes/*/vscode.json themes/*/theme.json; do
+            if [[ -f "$file" ]]; then
+              echo "Checking $file"
+              python3 -m json.tool "$file" > /dev/null || exit 1
+            fi
+          done
+          echo "All JSON files valid!"
+
+  validate-yaml:
+    name: Validate YAML Configs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install yamllint
+        run: pip install yamllint
+
+      - name: Validate YAML files
+        run: |
+          for file in themes/*/*.yaml; do
+            if [[ -f "$file" ]]; then
+              echo "Checking $file"
+              yamllint -d relaxed "$file" || exit 1
+            fi
+          done
+          echo "All YAML files valid!"
+
+  # ============================================
+  # Stage 2: Unit Tests (parallel by script)
+  # ============================================
+
+  unit-tests:
+    name: Unit Tests
+    runs-on: macos-latest
+    needs: [shellcheck]  # Only run if linting passes
+    strategy:
+      fail-fast: false
+      matrix:
+        test-file:
+          - backup
+          - restore
+          - apply
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Cache BATS installation
+        uses: actions/cache@v4
+        id: bats-cache
+        with:
+          path: ~/.local/bats
+          key: bats-${{ env.BATS_VERSION }}-macos
+
+      - name: Install BATS
+        if: steps.bats-cache.outputs.cache-hit != 'true'
+        run: |
+          git clone https://github.com/bats-core/bats-core.git
+          cd bats-core
+          ./install.sh ~/.local/bats
+
+      - name: Add BATS to PATH
+        run: echo "$HOME/.local/bats/bin" >> "$GITHUB_PATH"
+
+      - name: Run unit tests
+        env:
+          TEST_FILE: ${{ matrix.test-file }}
+        run: |
+          bats "tests/unit/${TEST_FILE}.bats" --tap
+
+  # ============================================
+  # Stage 3: Integration Tests (after unit tests)
+  # ============================================
+
+  integration-tests:
+    name: Integration Tests
+    runs-on: macos-latest
+    needs: [unit-tests]  # Only run if unit tests pass
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Cache BATS installation
+        uses: actions/cache@v4
+        id: bats-cache
+        with:
+          path: ~/.local/bats
+          key: bats-${{ env.BATS_VERSION }}-macos
+
+      - name: Install BATS
+        if: steps.bats-cache.outputs.cache-hit != 'true'
+        run: |
+          git clone https://github.com/bats-core/bats-core.git
+          cd bats-core
+          ./install.sh ~/.local/bats
+
+      - name: Add BATS to PATH
+        run: echo "$HOME/.local/bats/bin" >> "$GITHUB_PATH"
+
+      - name: Run integration tests
+        run: |
+          bats tests/integration/*.bats --tap
+
+  # ============================================
+  # Stage 4: Theme Validation (parallel check)
+  # ============================================
+
+  theme-validation:
+    name: Validate Themes
+    runs-on: ubuntu-latest
+    needs: [validate-json, validate-yaml]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check theme completeness
+        run: |
+          REQUIRED_FILES=("iterm2.json" "p10k.zsh" "mprocs.yaml" "theme.json")
+
+          for theme_dir in themes/*/; do
+            theme_name=$(basename "$theme_dir")
+            echo "Validating theme: $theme_name"
+
+            for file in "${REQUIRED_FILES[@]}"; do
+              if [[ ! -f "${theme_dir}${file}" ]]; then
+                echo "ERROR: Missing $file in $theme_name"
+                exit 1
+              fi
+            done
+
+            echo "  All required files present"
+          done
+
+  # ============================================
+  # Final: Summary Job
+  # ============================================
+
+  ci-success:
+    name: CI Success
+    runs-on: ubuntu-latest
+    needs: [shellcheck, validate-json, validate-yaml, unit-tests, integration-tests, theme-validation]
+    if: always()
+    steps:
+      - name: Check all jobs passed
+        env:
+          SHELLCHECK_RESULT: ${{ needs.shellcheck.result }}
+          JSON_RESULT: ${{ needs.validate-json.result }}
+          YAML_RESULT: ${{ needs.validate-yaml.result }}
+          UNIT_RESULT: ${{ needs.unit-tests.result }}
+          INTEGRATION_RESULT: ${{ needs.integration-tests.result }}
+          THEME_RESULT: ${{ needs.theme-validation.result }}
+        run: |
+          if [[ "$SHELLCHECK_RESULT" != "success" ]] || \
+             [[ "$JSON_RESULT" != "success" ]] || \
+             [[ "$YAML_RESULT" != "success" ]] || \
+             [[ "$UNIT_RESULT" != "success" ]] || \
+             [[ "$INTEGRATION_RESULT" != "success" ]] || \
+             [[ "$THEME_RESULT" != "success" ]]; then
+            echo "One or more jobs failed"
+            exit 1
+          fi
+          echo "All CI checks passed!"

.shellcheckrc

@@ -0,0 +1,18 @@
+# ShellCheck configuration for themer-up
+# https://www.shellcheck.net/wiki/
+
+# Set severity to warning (ignore style/info suggestions)
+# Style issues (SC2250, SC2292) are valid suggestions but not errors
+severity=warning
+
+# Exclude warnings that don't apply to our use case
+# SC2312: Consider invoking this command separately (we handle exit codes)
+# SC2012: Use find instead of ls (our use case is controlled)
+# SC2129: Consider using grouped redirects (readability preference)
+exclude=SC2312,SC2012,SC2129
+
+# Set default shell dialect
+shell=bash
+
+# External sources (for sourced files)
+external-sources=true

Makefile

@@ -0,0 +1,126 @@
+# Themer-Up Makefile
+# Orchestrates testing, linting, and development tasks
+
+.PHONY: all test test-unit test-integration lint clean install-deps help
+
+# Default target
+all: lint test
+
+# ─────────────────────────────────────────────────────
+# Testing Targets
+# ─────────────────────────────────────────────────────
+
+## Run all tests (linting + unit + integration)
+test: lint test-unit test-integration
+
+## Run unit tests only (fast feedback)
+test-unit:
+	@echo "Running unit tests..."
+	@bats tests/unit/*.bats --tap
+
+## Run integration tests only
+test-integration:
+	@echo "Running integration tests..."
+	@bats tests/integration/*.bats --tap
+
+## Run tests in parallel (requires GNU parallel)
+test-parallel:
+	@./scripts/test.sh --parallel
+
+## Run tests with verbose output
+test-verbose:
+	@./scripts/test.sh --verbose
+
+## Run fast tests only (skip integration)
+test-fast:
+	@./scripts/test.sh --fast
+
+# ─────────────────────────────────────────────────────
+# Linting Targets
+# ─────────────────────────────────────────────────────
+
+## Run shellcheck on all scripts
+lint:
+	@./scripts/lint.sh
+
+## Validate all JSON config files
+lint-json:
+	@echo "Validating JSON files..."
+	@for f in themes/*/iterm2.json themes/*/vscode.json themes/*/theme.json; do \
+		if [ -f "$$f" ]; then python3 -m json.tool "$$f" > /dev/null && echo "  ✓ $$f"; fi; \
+	done
+
+## Validate all YAML config files
+lint-yaml:
+	@echo "Validating YAML files..."
+	@for f in themes/*/*.yaml; do \
+		if [ -f "$$f" ]; then yamllint -d relaxed "$$f" && echo "  ✓ $$f"; fi; \
+	done
+
+# ─────────────────────────────────────────────────────
+# Development Targets
+# ─────────────────────────────────────────────────────
+
+## Install development dependencies
+install-deps:
+	@echo "Installing dependencies..."
+	@which bats > /dev/null || brew install bats-core
+	@which shellcheck > /dev/null || brew install shellcheck
+	@which yamllint > /dev/null || pip install yamllint
+	@echo "Done!"
+
+## Apply synthwave theme (default)
+apply:
+	@./scripts/apply.sh synthwave
+
+## Create a backup of current configs
+backup:
+	@./scripts/backup.sh
+
+## Restore from latest backup
+restore:
+	@./scripts/restore.sh
+
+## Clean temporary test files
+clean:
+	@echo "Cleaning temporary files..."
+	@rm -rf /tmp/themer-test-*
+	@rm -f /tmp/bats_output
+	@echo "Done!"
+
+# ─────────────────────────────────────────────────────
+# CI Simulation
+# ─────────────────────────────────────────────────────
+
+## Simulate full CI pipeline locally
+ci: lint lint-json test-unit test-integration
+	@echo ""
+	@echo "✅ CI simulation passed!"
+
+# ─────────────────────────────────────────────────────
+# Help
+# ─────────────────────────────────────────────────────
+
+## Show this help message
+help:
+	@echo "Themer-Up Development Commands"
+	@echo "══════════════════════════════"
+	@echo ""
+	@grep -E '^##' Makefile | sed 's/## /  /'
+	@echo ""
+	@echo "Usage: make <target>"
+	@echo ""
+	@echo "Testing:"
+	@echo "  make test           - Run all tests"
+	@echo "  make test-unit      - Run unit tests only"
+	@echo "  make test-fast      - Skip integration tests"
+	@echo "  make test-parallel  - Run tests in parallel"
+	@echo ""
+	@echo "Linting:"
+	@echo "  make lint           - Run shellcheck"
+	@echo "  make lint-json      - Validate JSON files"
+	@echo ""
+	@echo "Development:"
+	@echo "  make install-deps   - Install dev dependencies"
+	@echo "  make apply          - Apply synthwave theme"
+	@echo "  make ci             - Simulate CI locally"

scripts/apply.sh

@@ -3,7 +3,8 @@
 
 set -e
 
-THEMER_DIR="$HOME/dev/themer-up"
+# Allow override via environment variable for testing and custom installs
+THEMER_DIR="${THEMER_DIR:-$HOME/dev/themer-up}"
 THEME_NAME="${1:-synthwave}"
 THEME_DIR="$THEMER_DIR/themes/$THEME_NAME"
 

scripts/backup.sh

@@ -1,7 +1,9 @@
 #!/bin/bash
 # Backup current theme configs before applying new theme
 
-BACKUP_DIR="$HOME/.themer-up-backup/$(date +%Y%m%d_%H%M%S)"
+# Support custom backup location via environment variable
+BACKUP_BASE="${THEMER_BACKUP_DIR:-$HOME/.themer-up-backup}"
+BACKUP_DIR="${BACKUP_BASE}/$(date +%Y%m%d_%H%M%S)"
 mkdir -p "$BACKUP_DIR"
 
 echo "Backing up to: $BACKUP_DIR"
@@ -43,6 +45,6 @@ if [ -f "$HOME/.tmux.conf" ]; then
 fi
 
 # Keep only last 5 backups
-ls -dt "$HOME/.themer-up-backup"/*/ 2>/dev/null | tail -n +6 | xargs rm -rf 2>/dev/null || true
+ls -dt "${BACKUP_BASE}"/*/ 2>/dev/null | tail -n +6 | xargs rm -rf 2>/dev/null || true
 
 echo "Backup complete."