status

.artifacts/20260831-105824-plan-code-ui-audit/brief.md

@@ -0,0 +1,53 @@
+# Audit Brief
+
+- Task ID: 20260831-105824-plan-code-ui-audit
+- Orchestrator: build
+- Repository: /Users/shane/dev/voice-ios
+- Primary plan: /Users/shane/dev/voice-ios/PLAN.md
+- Original contract: /Users/shane/dev/voice-ios/UPDATE_PATH.md
+- Reference projects: /Users/shane/dev/hope-voice-api and /Users/shane/dev/hope_companion
+
+## Objective
+
+Determine whether the documented iOS implementation is actually complete, identify and fix confirmed defects, and create an evidence-based UI/UX redesign specification that incorporates the square Hope visual element.
+
+## In Scope
+
+- Swift and SwiftUI source, project configuration, resources, docs, and repository test coverage.
+- PLAN.md claims versus UPDATE_PATH.md requirements and exit criteria.
+- LiveKit connection lifecycle, stale callbacks, task/transcript/control protocols, media reconciliation, TLS behavior, persistence, error handling, accessibility, and user flow.
+- Current simulator build/runtime behavior where available.
+- Visual and interaction analysis of current UI and Hope reference assets/code.
+
+## Out of Scope
+
+- Unrequested server-side changes.
+- Claiming real-device behavior without real-device evidence.
+- Reverting unrelated user or agent changes.
+- Committing .artifacts or product changes unless explicitly requested.
+
+## Constraints
+
+- Build is orchestration-only and must not implement product code.
+- All product code/config/test changes must be made by the coder agent.
+- Reviewer must not edit implementation files.
+- Prefer minimal, evidence-backed fixes.
+- Use XcodeBuildMCP for Apple build/run/test work after loading its skill and checking session defaults.
+- Preserve existing design-system patterns unless the UI specification deliberately proposes a later redesign.
+
+## Acceptance Criteria
+
+1. Produce a requirements matrix for PLAN.md/UPDATE_PATH.md with evidence and unresolved qualification gaps.
+2. Report review findings ordered by severity with file/line references and reproduction or reasoning.
+3. Inspect current UI and locate/analyze the square Hope reference element.
+4. Produce a detailed but implementable UI update specification covering hierarchy, navigation, states, components, visual language, accessibility, and rollout.
+5. Route confirmed fixes to coder; coder verifies and writes implementation.md.
+6. Independently review fixes and repeat until approved or concretely blocked.
+7. Record exact build/test/simulator verification and avoid overstating device-only behavior.
+
+## Required Deliverables
+
+- review.md from reviewer.
+- ui-ux-spec.md from the UI/UX review agent.
+- implementation.md from coder if code changes are needed.
+- Updated manifest.md with final evidence and risks.