rust-integration-test-scaffolder

name	rust-integration-test-scaffolder
description	Scaffold integration tests in src-tauri/tests/ following the project's strict rules. Use when creating new Rust tests, ensuring CI compatibility, or preventing false sense of test coverage from unit tests in src/.

Rust Integration Test Scaffolder

Scaffold integration tests for LibrAgent following the project's strict testing rules.

Critical Rule

CI runs cargo test --tests, NOT cargo test --lib.

• #[cfg(test)] blocks inside src/ are NEVER executed in CI
• Only tests in tests/ directory (integration tests) run in CI
• On Windows, cargo test --lib crashes with STATUS_ENTRYPOINT_NOT_FOUND due to DLL shadowing
• test = false is set in Cargo.toml for library crates

Template

use sqlx::sqlite::SqlitePoolOptions;
use sea_orm::SqlxSqliteConnector;
use tauri_mcp_agent_lib::migration::Migrator;
use sea_orm_migration::MigratorTrait;

async fn setup_db() -> sea_orm::DatabaseConnection {
    let pool = SqlitePoolOptions::new()
        .connect("sqlite::memory:")
        .await
        .unwrap();
    let db = SqlxSqliteConnector::from_sqlx_sqlite_pool(pool);
    Migrator::up(&db, None).await.unwrap();
    db
}

#[tokio::test]
async fn test_descriptive_name() {
    let db = setup_db().await;
    // Test implementation here
}

Test Categories

Database/Repository Tests

• Test SeaORM entity mappings
• Test repository queries
• Test migration up/down
• Test foreign key constraints

MCP Integration Tests

• Test builtin server tool execution
• Test session isolation
• Test MCPServiceProxy routing
• Test external MCP server connection

Command Handler Tests

• Test Tauri command inputs/outputs
• Test error handling paths
• Test permission validation

Placement

• src-tauri/tests/<module>_tests.rs - Integration tests by module
• Use descriptive filenames matching the module being tested

Verification

# Run all integration tests (CI command)
cargo test --tests

# Run specific test file
cargo test --test <file_stem>