Testbased performance monitor

README.md

@@ -19,6 +19,7 @@ Start here:
 - `docs/markitect-tool-integration-usecases.md`
 - `docs/markitect-tool-capacity-risks.md`
 - `examples/markitect-tool-contract/`
+- `docs/test-performance-monitoring.md`
 - `docs/phase-memory-boundary.md`
 - `docs/system-layer-extraction-inventory.md`
 - `docs/system-layer-migration-backlog.md`
@@ -33,6 +34,10 @@ This repo uses Python 3.12+, setuptools, a `src/` package layout, and pytest.
 python3 -m pytest
 ```
 
+Pytest records a compact rolling performance history under
+`.pytest_cache/kontextual/performance-history.json`; see
+`docs/test-performance-monitoring.md`.
+
 The first runtime slice implements artifacts, collections, relationships,
 in-memory storage, ingestion adapters, query, workflow run manifests, and
 agent-facing context packages. The current roadmap re-scopes the next work