re-uploading work

crates/executor/tests/README.md

@@ -0,0 +1,112 @@
+# Executor Integration Tests
+
+This directory contains integration tests for the Attune executor service.
+
+## Test Suites
+
+### Policy Enforcer Tests (`policy_enforcer_tests.rs`)
+Tests for policy enforcement including rate limiting, concurrency control, and quota management.
+
+**Run**: `cargo test --test policy_enforcer_tests -- --ignored`
+
+### FIFO Ordering Integration Tests (`fifo_ordering_integration_test.rs`)
+Comprehensive integration and stress tests for FIFO policy execution ordering.
+
+**Run**: `cargo test --test fifo_ordering_integration_test -- --ignored --test-threads=1`
+
+## Prerequisites
+
+1. **PostgreSQL Running**:
+   ```bash
+   sudo systemctl start postgresql
+   ```
+
+2. **Database Migrations Applied**:
+   ```bash
+   cd /path/to/attune
+   sqlx migrate run
+   ```
+
+3. **Configuration**:
+   Ensure `config.development.yaml` has correct database URL or set:
+   ```bash
+   export ATTUNE__DATABASE__URL="postgresql://attune:attune@localhost/attune"
+   ```
+
+## Running Tests
+
+### All Integration Tests
+```bash
+# Run all executor integration tests (except extreme stress)
+cargo test -- --ignored --test-threads=1
+```
+
+### Individual Test Suites
+```bash
+# Policy enforcer tests
+cargo test --test policy_enforcer_tests -- --ignored
+
+# FIFO ordering tests
+cargo test --test fifo_ordering_integration_test -- --ignored --test-threads=1
+```
+
+### Individual Test with Output
+```bash
+# High concurrency stress test
+cargo test --test fifo_ordering_integration_test test_high_concurrency_stress -- --ignored --nocapture
+
+# Multiple workers simulation
+cargo test --test fifo_ordering_integration_test test_multiple_workers_simulation -- --ignored --nocapture
+```
+
+### Extreme Stress Test (10k executions)
+```bash
+# This test takes 5-10 minutes - run separately
+cargo test --test fifo_ordering_integration_test test_extreme_stress_10k_executions -- --ignored --nocapture --test-threads=1
+```
+
+## Test Organization
+
+- **Unit Tests**: Located in `src/` files (e.g., `queue_manager.rs`)
+- **Integration Tests**: Located in `tests/` directory
+- All tests requiring database are marked with `#[ignore]`
+
+## Important Notes
+
+- Use `--test-threads=1` for integration tests to avoid database contention
+- Tests create unique data using timestamps to avoid conflicts
+- All tests clean up their test data automatically
+- Stress tests output progress messages and performance metrics
+
+## Troubleshooting
+
+### Database Connection Issues
+```
+Error: Failed to connect to database
+```
+**Solution**: Ensure PostgreSQL is running and connection URL is correct.
+
+### Queue Full Errors
+```
+Error: Queue full (max length: 10000)
+```
+**Solution**: This is expected for `test_queue_full_rejection`. Other tests should not see this.
+
+### Test Data Not Cleaned Up
+If tests crash, manually clean up:
+```sql
+DELETE FROM attune.queue_stats WHERE action_id IN (
+    SELECT id FROM attune.action WHERE pack IN (
+        SELECT id FROM attune.pack WHERE ref LIKE 'fifo_test_pack_%'
+    )
+);
+DELETE FROM attune.execution WHERE action IN (SELECT id FROM attune.action WHERE pack IN (SELECT id FROM attune.pack WHERE ref LIKE 'fifo_test_pack_%'));
+DELETE FROM attune.action WHERE pack IN (SELECT id FROM attune.pack WHERE ref LIKE 'fifo_test_pack_%');
+DELETE FROM attune.pack WHERE ref LIKE 'fifo_test_pack_%';
+```
+
+## Documentation
+
+For detailed test descriptions and execution plans, see:
+- `work-summary/2025-01-fifo-integration-tests.md`
+- `docs/testing-status.md` (Executor Service section)