Ln 743 Test Infrastructure

ln-743-test-infrastructure

Type: L3 Worker Category: 7XX Project Bootstrap Parent: ln-740-quality-setup

Sets up testing frameworks, coverage tools, and sample tests for projects.

---

Purpose & Scope

Does:

• Detects project stack to choose appropriate test framework
• Creates test configuration files
• Sets up coverage reporting with thresholds
• Creates sample tests demonstrating patterns
• Verifies test suite runs successfully

Does NOT:

• Configure linters (ln-741 does this)
• Set up pre-commit hooks (ln-742 does this)
• Write actual application tests (developers do this)

---

Supported Stacks

---

Phase 1: Check Existing Tests

Before creating test infrastructure, check what exists.

Files to Check:

Decision Logic:

1. If complete test setup exists: SKIP (inform user)
2. If partial setup: ASK to extend or replace
3. If no tests: CREATE from templates

---

Phase 2: Create Test Configuration

TypeScript/​React (Vitest)

Create vitest.config.ts:

• Use v8 coverage provider (faster than Istanbul)
• Configure jsdom environment for React
• Set coverage thresholds (80% minimum)
• Create setup file for testing-library

Dependencies:

npm install -D vitest @vitest/​coverage-v8 @testing-library/​react @testing-library/​jest-dom jsdom

.NET (xUnit)

Create test project:

dotnet new xunit -n {Project}.Tests
dotnet sln add tests/​{Project}.Tests

Dependencies (in .csproj):

• Microsoft.NET.Test.Sdk
• xunit
• xunit.runner.visualstudio
• Moq
• FluentAssertions
• coverlet.collector

Python (pytest)

Add to pyproject.toml or create pytest.ini:

• Configure test discovery paths
• Set coverage thresholds (80% minimum)
• Configure coverage reporting

Dependencies:

pip install pytest pytest-cov pytest-asyncio
# OR with uv:
uv add --dev pytest pytest-cov pytest-asyncio

---

Phase 3: Create Test Directory Structure

TypeScript

src/
├── components/
│   ├── Button.tsx
│   └── Button.test.tsx  # Co-located tests
├── test/
│   └── setup.ts         # Test setup file

.NET

tests/
├── {Project}.Tests/
│   ├── Controllers/
│   │   └── SampleControllerTests.cs
│   ├── Services/
│   └── {Project}.Tests.csproj
└── {Project}.IntegrationTests/  # Optional

Python

tests/
├── __init__.py
├── conftest.py          # Fixtures
├── unit/
│   └── test_sample.py
└── integration/         # Optional

---

Phase 4: Create Sample Tests

Create one sample test per stack demonstrating:

• AAA pattern (Arrange-Act-Assert)
• Test naming conventions
• Basic assertions
• Framework-specific patterns

TypeScript Sample Test

Shows:

• render() from testing-library
• screen queries
• Jest-dom matchers

.NET Sample Test

Shows:

• [Fact] attribute
• Moq for mocking
• FluentAssertions syntax

Python Sample Test

Shows:

• pytest fixtures
• assert statements
• parametrized tests (optional)

---

Phase 5: Verify Test Run

After setup, verify tests work.

TypeScript:

npm test
npm run test:coverage

Expected: Sample test passes, coverage report generated

.NET:

dotnet test
dotnet test --collect:"XPlat Code Coverage"

Expected: Sample test passes, coverage collected

Python:

pytest
pytest --cov=src --cov-report=term-missing

Expected: Sample test passes, coverage report shown

On Failure: Check test configuration, dependencies, verify sample test syntax.

---

Coverage Requirements

Configure CI to fail if coverage drops below thresholds.

---

Critical Rules

RULE 1: Coverage thresholds MUST be configured. No exceptions.

RULE 2: Sample tests MUST pass. Don't create broken examples.

RULE 3: Use AAA pattern (Arrange-Act-Assert) in all sample tests.

RULE 4: Co-locate unit tests with source (TypeScript) or use tests/ directory (.NET, Python).

---

Definition of Done

• Test framework installed and configured
• Coverage tool configured with 80% threshold
• Test directory structure created
• Sample test created and passing
• npm test / dotnet test / pytest runs successfully
• Coverage report generates
• User informed of:
  • How to run tests
  • Where to add new tests
  • Coverage requirements

---

Reference Files

---

Error Handling

---

Version: 2.0.0 Last Updated: 2026-01-10