import pytest
from src.services.task_manager import TaskManager

class TestTaskManager:
    """Group related tests in classes."""

    def test_create_task_with_valid_title(self) -> None:
        """Test names describe expected behavior."""
        manager = TaskManager(storage=InMemoryStorage())

        task = manager.create_task("Buy groceries")

        assert task.title == "Buy groceries"
        assert task.completed is False

    def test_create_task_raises_on_empty_title(self) -> None:
        """Test error conditions explicitly."""
        manager = TaskManager(storage=InMemoryStorage())

        with pytest.raises(ValidationError, match="Title cannot be empty"):
            manager.create_task("")

import pytest

@pytest.fixture
def storage() -> InMemoryStorage:
    """Create fresh storage for each test."""
    return InMemoryStorage()

@pytest.fixture
def task_manager(storage: InMemoryStorage) -> TaskManager:
    """Fixtures can depend on other fixtures."""
    return TaskManager(storage=storage)

def test_create_task(task_manager: TaskManager) -> None:
    task = task_manager.create_task("Test")
    assert task.id is not None

tests/
├── conftest.py          # Shared fixtures
├── unit/                # Isolated unit tests
│   ├── conftest.py      # Unit-specific fixtures
│   ├── test_task_manager.py
│   └── test_storage.py
├── integration/         # Component integration
│   ├── conftest.py
│   └── test_agent_workflow.py
└── contract/            # API contract tests
    └── test_agent_contracts.py

# Run with coverage
pytest --cov=src --cov-report=term-missing --cov-fail-under=80

# Generate HTML report
pytest --cov=src --cov-report=html