test-driver/README.md

42 lines
1.4 KiB
Markdown
Raw Normal View History

2026-08-22 18:48:27 +00:00
# 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 M0M10