# test-driver

Agentic framework for integration, end-to-end, multi-user interaction and
security testing, driven by use cases.

Tests mature alongside the software they protect: fluid and agentic while
behaviour is changing, deterministic once it settles. See `INTENT.md` for the
thesis and `SCOPE.md` for boundaries.

**Status:** research prototype. The deterministic kernel runs; agentic
realization, adaptation classification and crystallization are not built yet.
Current work: `workplans/TD-WP-0002-vertical-spike-crystallization.md`.

## Run

```bash
python3 -m pytest -q          # the whole suite
python3 -m pytest -q tests/test_reference_scenario.py
```

No third-party dependencies. Python ≥ 3.11, pytest for the suite.

## Layout

```
src/testdriver/   the kernel — intent, world, actions, drivers,
                  observers, oracles, evidence, runner
lab/              the system under test
scenarios/        reference scenarios
research/         hypotheses, experiments, findings, fitness map
docs/             concept model, improvement loop, milestones, design notes
history/          assessments and completed-work write-ups
```

## Reading order

1. `INTENT.md` — the thesis
2. `docs/TestDriverConceptModel.md` — canonical concept set
3. `docs/TestDriverClassificationDesign.md` — why adaptation cannot normalize a
   defect, and where model judgment is and is not permitted
4. `docs/TestDriverInitialMilestones.md` — canonical milestones M0–M10