release: prepare v0.1.5 with coverage and docs updates

Author: 01rabbit

.github/workflows/ci.yml

@@ -47,7 +47,9 @@ jobs:
 
       - name: Run unit tests with coverage and enforce threshold
         run: |
+          python -m coverage erase
           python -m coverage run --source=src -m unittest discover -s tests
+          python -m coverage run --append --source=src -m unittest discover -s tests_optional
           python -m coverage report -m
           python -m coverage report --fail-under=70
 

CHANGELOG.md

@@ -9,17 +9,55 @@ and this project follows SemVer-style release intent for documented interfaces.
 
 No unreleased entries.
 
+## [0.1.5] - 2026-05-11
+
+### Added
+
+- Architecture figure embedded at the top of `docs/PHASMID_ARCHITECTURE.md` using `images/architecture_v1.png` to improve onboarding and design readability.
+- Release-log updates in `docs/REVIEW_VALIDATION_RECORD.md` for profile-based test execution and combined coverage recording.
+
+### Changed
+
+- CI coverage gate logic updated to aggregate `tests` + `tests_optional` coverage before enforcing `--fail-under=70`.
+- `CONTRIBUTING.md` validation guidance updated to document default/optional/archive-review test profiles.
+- `tests/TEST_RETENTION_MATRIX.md` updated from candidate planning to current consolidation status.
+- `0.1.4` changelog entry expanded to reflect the full scope of completed documentation and test-suite restructuring work.
+
+### Security
+
+- Coverage gating remains at 70% without threshold reduction by combining default and optional profiles, preserving verification discipline for active security boundaries.
+
 ## [0.1.4] - 2026-05-10
 
+### Added
+
+- `docs/README_INDEX.md` as a long-form documentation entrypoint and navigation index.
+- `docs/archive/` policy and archived historical analysis/evaluation documents for traceable but non-active references.
+- TUI operator screenshots (`images/TUI_HOME.png`, `images/TUI_AUDIT.png`, `images/TUI_DOCTOR.png`, `images/TUI_INSPECT.png`, `images/TUI_FACE.png`).
+- Test profile documentation and retention matrix (`tests/README.md`, `tests/TEST_RETENTION_MATRIX.md`).
+- Split test profiles for lifecycle management:
+  - `tests_optional/` for dependency-heavy or extended tests
+  - `tests_archive_review/` for historical/evaluation review tests
+
 ### Changed
 
-- Project guidance documents synchronized after issue-track completion, including AGENTS status updates and readiness-plan consistency fixes.
-- Repository-wide Python formatting refactor applied across `src/`, `tests/`, and `scripts/` using Ruff formatter.
-- README and Pi Zero 2 W workflow documentation cleaned up for duplicate or stale status wording.
+- `AGENTS.md` compressed and de-duplicated while preserving boundary/security invariants and authority order.
+- README restructured into a two-layer entry model:
+  - quick-start-first structure with requirements before install details
+  - shortened overview with deep links moved to docs index
+- TUI banner/title updated to the new PHASMID ASCII identity and synchronized with operator docs.
+- `docs/TUI_OPERATOR_CONSOLE.md` updated with screenshot-based presentation and current banner representation.
+- Test suite reorganized and consolidated:
+  - merged overlapping observability/context-profile/dual-approval/coercion-safe scenario tests
+  - moved optional and archive-review tests to dedicated profiles
+  - CI expanded to include default, optional, reproducible-build, and manual archive-review job paths
+- `tests/test_docs_and_templates.py` and `tests/test_terminology.py` aligned with README/docs archive restructuring.
+- Historical roadmap links updated to archived document paths.
 
 ### Security
 
-- Existing local-only boundary, restricted-action constraints, and neutral capture-visible language policies were preserved during refactor and documentation consolidation.
+- Existing local-only boundary, restricted-action constraints, and neutral capture-visible language policies were preserved during documentation and test-suite restructuring.
+- Capture-visible vocabulary controls and restricted-route semantics remained enforced by updated terminology and scenario tests.
 
 ## [0.1.3] - 2026-05-10
 

README.md

@@ -56,14 +56,15 @@ If the TUI does not open, run `phasmid doctor`.
 
 ## Architecture Overview
 
-![Phasmid Architecture Overview](images/architecture_v1.png)
-
-Quick legend:
-
-- **Vessel**: local container that carries multiple Disclosure Faces
-- **Disclosure Face**: operator-selected visible retrieval path
-- **Local key material**: local recovery input mixed with passphrase-derived key path
-- **Object cue**: operational access cue, not cryptographic key material
+![Phasmid Architecture Overview](images/architecture_overview.png)
+
+> Quick legend:
+> - **Vessel**: local container carrying multiple Disclosure Faces
+> - **Object cue**: operational access gate, not cryptographic key material
+> - **Restricted slot**: triggers irreversible local-state destruction on access
+>
+> Full cryptographic parameters and storage layout:
+> [docs/PHASMID_ARCHITECTURE.md](docs/PHASMID_ARCHITECTURE.md)
 
 Access flow, two-slot storage, coercion defense, and local-only boundary are documented in [`docs/PHASMID_ARCHITECTURE.md`](docs/PHASMID_ARCHITECTURE.md).
 

docs/PHASMID_ARCHITECTURE.md

@@ -2,6 +2,10 @@
 
 Phasmid is a field-evaluation prototype for local-only coercion-aware storage and the reference implementation of the Janus Eidolon System.
 
+![Phasmid architecture overview](../images/architecture_v1.png)
+
+Two-slot architecture overview: vessel structure, disclosure faces, local key material, and object-cue operating boundary.
+
 ## Architectural Layers
 
 Phasmid is organized into a few narrow local layers:

docs/REVIEW_VALIDATION_RECORD.md

@@ -19,25 +19,28 @@ Command:
 
 ```bash
 python3 -m unittest discover -s tests
+python3 -m unittest discover -s tests_optional
 ```
 
 Result:
 
 ```text
-2026-05-02, macOS Darwin arm64, python3 -m unittest discover -s tests, 151 tests passed.
+2026-05-11, macOS Darwin arm64, python3 -m unittest discover -s tests, 449 tests passed (5 skipped).
+2026-05-11, macOS Darwin arm64, python3 -m unittest discover -s tests_optional, 124 tests passed.
 ```
 
 Coverage baseline:
 
 ```bash
 python3 -m coverage run --source=src -m unittest discover -s tests
+python3 -m coverage run --append --source=src -m unittest discover -s tests_optional
 python3 -m coverage report -m
 ```
 
 Result:
 
 ```text
-coverage: 71% overall
+coverage: 71% overall (tests + tests_optional combined)
 ```
 
 The coverage baseline records a minimum acceptable regression gate (70%) for future changes.

images/architecture_overview.png

@@ -1,6 +1,6 @@
 [project]
 name = "phasmid"
-version = "0.1.4"
+version = "0.1.5"
 description = "Phasmid local-only coercion-aware storage prototype"
 requires-python = ">=3.10"
 dependencies = [