Phase 5 — Final sweep and demo readiness

[rsml]

Part of the demo-quality refactor tracked in docs/plans/refactor/. Branch phase-5-final-sweep. Depends on Phase 4.

Objective

Close the loop. Remove what nothing uses, polish the front door, and prove that a stranger cloning the repo can get to a running app without help.

Contents

• A knip pass plus a manual simplification sweep over the whole tree
• README polish, including a mermaid architecture diagram and status badges
• A verify-fresh-clone.sh script that clones, installs, typechecks, lints, tests, builds, and smoke tests the packaged DMG
• Repo metadata, meaning description, topics, and branch protection confirmed
• A demo runbook, delivered to the owner rather than committed

Gate

• verify-fresh-clone.sh exits 0, including the DMG smoke test
• knip reports no unused files, exports, or dependencies
• CI green on master

[rsml]

Closed by PR #58, the final sweep. knip with justified ignores (net minus 500 lines), sanctioned accessibility fixes, committed doc-path and unnamed-button checkers wired into CI and lefthook, README polish with the annotated tree, and scripts/verify-fresh-clone.sh proving the whole stack from a bare clone in 174 seconds. Phases 6 and 7 were added mid-effort and are tracked by PRs #53 and #55 and issues #50 through #52.