test: verify Seriatim source installation

README.md

@@ -82,6 +82,29 @@ ANSIBLE_COLLECTIONS_PATH="$PWD/.ansible/collections" \
   ../.venv/bin/ansible-lint .
 ```
 
+## Development and integration validation
+
+Create the workspace virtual environment described by the control repository
+and run the complete local suite from this repository with:
+
+```sh
+tests/integration
+```
+
+The driver installs the pinned collection into the ignored local `.ansible`
+directory, runs static checks, and then mutates the local host using privilege
+escalation. It manages `/usr/local/src/seriatim`,
+`/usr/local/src/seriatim.ansible-build-state`, and
+`/usr/local/bin/seriatim`; do not run it where those paths contain data that
+must be preserved. It verifies convergence, idempotence, platform guards,
+authoritative source cleanup, compiler-version invalidation, and preservation
+of a working installation after a failed build.
+
+The driver uses temporary Go wrappers and removes them on exit. It attempts to
+restore the default role state after a failure. Recovery consists only of
+rerunning `tests/integration` or the default `tests/converge.yml`; no manual
+deletion of managed paths is required.
+
 ## License
 
 BSD-3-Clause