Feat v0.6.16 usability survey gate (#51)

Co-authored-by: Jeffrey Smith <jasafpro@gmail.com>
Co-committed-by: Jeffrey Smith <jasafpro@gmail.com>

CHANGELOG.md

@@ -2,6 +2,46 @@
 
 All notable changes to Armature are documented here.
 
+## v0.6.16 — Usability Survey Gate
+
+Machine-auditable UI quality gate. Four new audit scripts, a structured survey
+prompt, contrast and touch-target fixes, and Docker Hub documentation correction.
+
+### Added
+
+- **`scripts/generate-ui-inventory.sh`** — walks all kernel + package CSS,
+  extracts every class selector with surface, line number, responsive breakpoints,
+  spacing tokens, and font-size usage. Outputs `ui-inventory.json` (1567 entries).
+- **`scripts/check-contrast.sh`** — parses `variables.css` dark/light token
+  pairs, computes WCAG AA contrast ratios for 24 semantic text-on-background
+  pairings per theme (48 total). Uses AA (4.5:1) for normal text, AA-lg (3.0:1)
+  for large/bold text contexts.
+- **`scripts/generate-coverage-matrix.sh`** — 12 kernel primitives × all surfaces
+  markdown table. Flags any deprecated component usage (`.btn-primary`, etc.).
+- **`scripts/audit-touch-targets.sh`** — static analysis for 44px minimum mobile
+  touch targets on close buttons and interactive elements.
+- **`docs/USABILITY-SURVEY.md`** — structured 8-section prompt (viewport, banners,
+  responsive, styling, contrast, touch targets, focus indicators, component
+  uniformity) with pass/fail criteria and file paths for automated execution.
+- **Focus indicators** — `:focus-visible` styles on `.sw-btn`, `.sw-input`,
+  `.sw-dropdown__trigger`, `.sw-menu__item`, `.sw-tabs__tab`.
+- **Mobile touch targets** — `min-width/min-height: 44px` in `@media (max-width:
+  768px)` for `.sw-banner__close`, `.sw-toast__close`, `.sw-dialog__close`,
+  `.sw-drawer__close`, `.sw-tabs__arrow`, `.modal-close`, `.sw-tabs__tab`,
+  `.sw-dropdown__option`.
+
+### Fixed
+
+- **WCAG contrast violations** — dark-mode accent darkened from `#6c9fff` to
+  `#6493ed` (3.03:1 with white text), dark-mode success from `#22c55e` to
+  `#1dab51` (3.00:1). Light-mode `--text-3` darkened from `#8b8da3` to `#787a92`.
+  Light-mode `--success-light` and `--warning-light` darkened for badge contrast.
+  All 48 pairings now pass.
+- **Docker Hub references** — `docs/DEPLOYMENT.md` and `docs/DISTRIBUTION.md`
+  corrected from `ghcr.io/armature/armature` to `gobha/armature` (Docker Hub).
+  Builder image corrected to `gobha/armature-builder`. GitHub URL corrected to
+  `github.com/gobha/armature`.
+
 ## v0.6.15 — User Display Audit
 
 Every user-facing identity surface now shows human-readable names instead of