gnn-test-suite

name	gnn-test-suite
description	GNN comprehensive test suite execution and management. Use when running tests, writing new test cases, checking coverage, debugging test failures, or validating pipeline correctness across all 25 GNN modules.

GNN Test Suite (Step 2)

Purpose

Executes the comprehensive test suite across all GNN pipeline modules. Manages test discovery, execution, coverage reporting, and result aggregation.

Key Commands

# Run all tests via pipeline step
python src/2_tests.py --comprehensive

# Run tests directly with pytest
uv run --extra dev python -m pytest src/tests/ -v

# Module-specific tests
uv run --extra dev python -m pytest src/tests/test_gnn_*.py -v
uv run --extra dev python -m pytest src/tests/test_render_*.py -v
uv run --extra dev python -m pytest src/tests/test_export_*.py -v

# Check coverage
pytest --cov=src --cov-report=term-missing

# Run with specific markers
uv run --extra dev python -m pytest src/tests/ -v -m "not slow"

# Quick smoke test
uv run --extra dev python -m pytest src/tests/ -x -q --tb=short

Test Organization

src/tests/
├── test_gnn_*.py              # GNN parsing tests
├── test_render_*.py           # Code generation tests
├── test_export_*.py           # Export format tests
├── test_visualization_*.py    # Visualization tests
├── test_pipeline_*.py         # Pipeline integration tests
└── conftest.py                # Shared fixtures

Writing New Tests

• Place tests in src/tests/test_{module}_*.py
• Use real methods only in production code
• Follow existing patterns: fixtures, parametrize, clear assertions
• Target >80% coverage per module

Current Status

• 1,522+ tests passing
• 100% pipeline success rate
• All 25 steps validated

MCP Tools

This module registers tools with the GNN MCP server (see mcp.py):

• run_all_tests
• run_integration_tests
• run_unit_tests

References

• AGENTS.md — Module documentation
• README.md — Usage guide
• SPEC.md — Module specification
• ../../pytest.ini — Pytest configuration

---

Documentation

• README: Module Overview
• AGENTS: Agentic Workflows
• SPEC: Architectural Specification
• SKILL: Capability API