attune/crates/executor/tests/README.md

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:

   sudo systemctl start postgresql
   

2. Database Migrations Applied:

   cd /path/to/attune
   sqlx migrate run
   

3. Configuration: Ensure config.development.yaml has correct database URL or set:

   export ATTUNE__DATABASE__URL="postgresql://attune:attune@localhost/attune"
   

Running Tests

All Integration Tests

# Run all executor integration tests (except extreme stress)
cargo test -- --ignored --test-threads=1

Individual Test Suites

# 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

# 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)

# 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:

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)