OpenAgentsControl/scripts/tests/README.md

OpenCode Installer Tests

This directory contains test scripts for validating the OpenCode installer functionality and compatibility.

CI Integration: These tests run automatically via .github/workflows/installer-checks.yml on any PR that modifies install.sh, update.sh, or registry.json.

Quick Start

# Run all installer tests
for test in scripts/tests/test-*.sh; do bash "$test"; done

# Run specific test
bash scripts/tests/test-non-interactive.sh

Available Tests

1. Compatibility Test (test-compatibility.sh)

Tests the installer's compatibility across different platforms and bash versions.

Run locally:

bash scripts/tests/test-compatibility.sh

Run remotely:

curl -fsSL https://raw.githubusercontent.com/darrenhinde/OpenAgentsControl/main/scripts/tests/test-compatibility.sh | bash

What it tests:

• ✅ Bash version (3.2+ required)
• ✅ Required dependencies (curl, jq)
• ✅ Script syntax validation
• ✅ Help command functionality
• ✅ List command functionality
• ✅ Profile argument parsing (with and without dashes)
• ✅ Array operations
• ✅ Parameter expansion
• ✅ Temp directory operations
• ✅ File operations
• ✅ Network connectivity

Expected output:

╔════════════════════════════════════════════════════════════════╗
║         OpenCode Installer Compatibility Test                 ║
╚════════════════════════════════════════════════════════════════╝

System Information:
  Platform: macOS
  Bash Version: 3.2.57(1)-release
  Shell: /bin/bash

[12 tests run...]

╔════════════════════════════════════════════════════════════════╗
║                  All Tests Passed! ✓                          ║
╚════════════════════════════════════════════════════════════════╝

---

2. Non-Interactive Mode Test (test-non-interactive.sh)

Critical test - validates piped execution (curl | bash) scenarios.

Run locally:

bash scripts/tests/test-non-interactive.sh

What it tests:

• ✅ Fresh install via pipe (simulates curl | bash -s profile)
• ✅ Collision handling in non-interactive mode
• ✅ All profiles work non-interactively
• ✅ stdin detection and TTY handling
• ✅ NON_INTERACTIVE flag behavior
• ✅ Error handling without user input

Why this matters: Catches bugs where interactive prompts fail silently when stdin is not a terminal.

---

3. End-to-End Installation Test (test-e2e-install.sh)

Full installation workflow validation.

Run locally:

bash scripts/tests/test-e2e-install.sh

What it tests:

• ✅ Essential profile installs expected files
• ✅ Developer profile installs expected files
• ✅ Custom installation directory works
• ✅ Skip existing files strategy preserves user content
• ✅ File content validity (not empty/corrupted)
• ✅ Directory structure correctness
• ✅ Registry consistency
• ✅ Help and list commands

---

4. Collision Detection Test (test-collision-detection.sh)

Tests the installer's file collision detection and handling strategies.

Run locally:

bash scripts/tests/test-collision-detection.sh

What it tests:

• ✅ Detection of existing files
• ✅ Skip existing strategy
• ✅ Overwrite strategy
• ✅ Backup & overwrite strategy
• ✅ Collision reporting
• ✅ File grouping by type

---

Running All Tests

# From repository root
for test in scripts/tests/test-*.sh; do
    echo "Running $test..."
    bash "$test"
    echo ""
done

---

Test Requirements

All tests require:

• Bash 3.2 or higher
• curl (for network tests)
• jq (for JSON parsing tests)
• Internet connection (for remote fetch tests)

---

Adding New Tests

When adding new test scripts:

1. Naming convention: test-<feature>.sh
2. Make executable: chmod +x scripts/tests/test-<feature>.sh
3. Add shebang: #!/usr/bin/env bash
4. Use colors: Follow existing color scheme (GREEN, RED, YELLOW)
5. Exit codes: Exit 0 on success, 1 on failure
6. Documentation: Update this README

Example test structure:

#!/usr/bin/env bash

set -e

GREEN='\033[0;32m'
RED='\033[0;31m'
NC='\033[0m'

echo "Testing feature X..."

# Test 1
if [[ condition ]]; then
    echo -e "${GREEN}✓${NC} Test 1 passed"
else
    echo -e "${RED}✗${NC} Test 1 failed"
    exit 1
fi

echo "All tests passed!"

---

CI/CD Integration

These tests can be integrated into CI/CD pipelines:

GitHub Actions example:

name: Test Installer
on: [push, pull_request]
jobs:
  test:
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        os: [ubuntu-latest, macos-latest]
    steps:
      - uses: actions/checkout@v2
      - name: Install dependencies
        run: |
          if [[ "$OSTYPE" == "darwin"* ]]; then
            brew install jq
          else
            sudo apt-get install -y jq
          fi
      - name: Run compatibility tests
        run: bash scripts/tests/test-compatibility.sh

---

Troubleshooting Tests

Test fails with "command not found"

Install missing dependencies:

# macOS
brew install curl jq

# Ubuntu/Debian
sudo apt-get install curl jq

# Fedora/RHEL
sudo dnf install curl jq

Network tests fail

Check internet connectivity:

curl -I https://github.com

Permission errors

Make sure scripts are executable:

chmod +x scripts/tests/*.sh

---

Test Coverage

Current test coverage:

• ✅ Platform compatibility (macOS, Linux, Windows)
• ✅ Bash version compatibility (3.2+)
• ✅ Argument parsing
• ✅ File collision handling
• ✅ Network operations
• ✅ File system operations
• ✅ Non-interactive/piped execution
• ✅ Profile installation end-to-end
• ✅ Registry validation
• ✅ Error handling scenarios

Future test additions:

• Component dependency resolution
• Rollback functionality
• Windows (Git Bash) specific tests

---

Contributing

When contributing tests:

1. Ensure tests are idempotent (can run multiple times)
2. Clean up temporary files/directories
3. Provide clear success/failure messages
4. Test on multiple platforms if possible
5. Update this README with new test documentation