fix: update tests/README.md to use aqua

Author: westonplatter

.github/workflows/test.yaml

@@ -19,16 +19,10 @@ jobs:
       - name: Check out Git repository
         uses: actions/checkout@v4
 
-      - name: Install BATS
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y bats
-
-      - name: Install Task
-        uses: arduino/setup-task@v2
+      - name: Install tools via aqua
+        uses: aquaproj/aqua-installer@v3.0.1
         with:
-          version: 3.x
-          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          aqua_version: v2.55.0
 
       - name: Run BATS tests
         run: bats tests/

aqua.yaml

@@ -9,3 +9,5 @@ packages:
     tags: [cursor]
   - name: cli/cli@v2.83.0
     tags: [gh]
+  - name: bats-core/bats-core@v1.13.0
+    tags: [cicd]

tests/README.md

@@ -1,124 +1,49 @@
 # Taskit Test Suite
 
-## Purpose
+BATS test suite for Taskit. Tests validate Task commands using dry-run mode (`task -n`).
 
-This directory contains the BATS (Bash Automated Testing System) test suite for Taskit. Tests validate Task command functionality using dry-run mode, ensuring reliability without requiring actual tool installations.
-
-## Prerequisites
-
-Install BATS:
+## Setup
 
 ```bash
-# macOS
-brew install bats-core
-
-# Debian/Ubuntu
-apt-get install bats
-
-# Manual installation
-git clone https://github.com/bats-core/bats-core.git
-cd bats-core
-./install.sh /usr/local
+aqua install  # Installs BATS and Task
 ```
 
 ## Running Tests
 
-### Local Development
-
 ```bash
-# Run all tests
-bats tests/
-
-# Run specific test file
-bats tests/terraform_plan.bats
-
-# Run tests by tag
-bats --filter-tags basic tests/
-bats --filter-tags precondition tests/
+bats tests/                              # Run all
+bats tests/terraform_plan.bats           # Run specific file
+bats --filter-tags precondition tests/   # Run by tag
 ```
 
-### Continuous Integration
-
-Tests run automatically on:
-
-- **Pull Requests**: All PRs trigger the test suite
-- **Main Branch**: Tests run on every push to main
-
-The GitHub Actions workflow (`.github/workflows/test.yaml`) handles:
-
-1. BATS and Task installation
-2. Test execution across the `tests/` directory
-3. Result artifacts upload (30-day retention)
-
-View results in the GitHub Actions tab or PR checks section.
+CI runs automatically on PRs and main branch pushes via `.github/workflows/test.yaml`.
 
 ## Writing Tests
 
-Tests leverage Task's dry-run mode (`task -v -n`) to verify command construction without execution:
+Tests use Task's dry-run mode to verify command construction:
 
 ```bash
 @test "terraform:plan validates environment argument" {
-  # Arrange: Create test fixture
-  touch "tfvars/test-env.tfvars"
-
-  # Act: Execute task in dry-run mode
+  touch "tfvars/test-env.tfvars"  # Setup fixture
   run task -v -n terraform:plan -- test-env
-
-  # Assert: Verify output
   [ "$status" -eq 0 ]
-  [[ "$output" =~ "expected text" ]]
+  [[ "$output" =~ "tofu plan -var-file ./tfvars/test-env.tfvars" ]]
 }
 ```
 
-### Test Structure
-
-- `setup()`: Pre-test fixture creation and environment setup
-- `@test "description"`: Individual test case
-- `teardown()`: Post-test cleanup
-
-### Test Tags
+Key helpers: `setup()`, `teardown()`, `run`, `$status`, `$output`
 
-Use tags for selective test execution:
+## Quick Reference
 
-- `terraform`: Terraform-related functionality
-- `plan`: Plan command behavior
-- `basic`: Core functionality
-- `args`: Argument handling
-- `precondition`: Validation logic
-- `config`: Configuration management
-- `error`: Error handling
-
-## Best Practices
-
-1. **Dry-run Testing**: Use `task -v -n` to test without requiring actual tool installations
-2. **Debug Output**: Include `echo "Output: $output" >&3` for troubleshooting failed tests
-3. **Fixture Management**: Create temporary files in `setup()`, clean up in `teardown()`
-4. **Assertions**: Use `[ ]` for exit codes, `[[ =~ ]]` for pattern matching
+**Debug failed tests:** `echo "Output: $output" >&3`
+**Test pattern:** `task -v -n <task> -- <args>`
+**Assertions:** `[ ]` for exit codes, `[[ =~ ]]` for regex matching
+**Tags:** terraform, plan, basic, args, precondition, config, error
+**Fixtures:** Create in `setup()`, clean in `teardown()`
 
 ## Troubleshooting
 
-**Tests fail in CI but pass locally:**
-
-- Ensure proper cleanup in `teardown()`
-- Verify tests don't depend on local environment state
-- Confirm all required files are committed
-
-**Workflow doesn't run:**
-
-- Verify `.github/workflows/test.yaml` exists
-- Check GitHub Actions are enabled for the repository
-- Review branch protection rules
-
-## Workflow Permissions
-
-The CI workflow uses minimal permissions:
-
-- `actions: read` - Access workflow logs
-- `checks: write` - Report check results
-- `contents: read` - Read repository
-- `pull-requests: read` - Access PR information
-
-No secrets or credentials required for test execution.
+**CI/local mismatch:** Check `teardown()` cleanup and committed test fixtures.
 
 ## Resources