A native iPhone and Apple Watch remote foundation for compatible Samsung TVs running Tizen. The product's primary goal is deliberate wrist movements that produce directional TV button presses. The working brand is provisional and must be cleared before publication.

Current state

This is an engineering starter repository, not a finished TV remote. It includes two native SwiftUI demo apps, tested domain and adapter Swift packages, an Xcode project, and implementation briefs for parallel agents. WatchBridge now has shared control-plane contracts, an injected phone-actor seam, and platform source/test membership; see B's handoff. The demo buttons update a local label only. Live TV pairing, WatchConnectivity relay, Keychain storage, Core Motion capture/classification, and App Store assets remain planned work. No physical-device compatibility is claimed.

The intended path is Apple Watch → WatchConnectivity → iPhone → local TV WebSocket. The watch is the control surface; the iPhone is required as a relay. Gestures operate in an explicit active watch session. The app must stop sensing and disarm when inactive. No promise of all-day, wrist-down, or phone-free control.

Open and check

Open Wristivo.xcodeproj in Xcode. Choose Wristivo for iPhone or WristivoWatch for watchOS. The generated project is committed, so no project generator installation is needed to open it.

bash Scripts/check.sh          # shared package tests and privacy plist syntax
bash Scripts/check.sh --apps   # also compile unsigned iOS + watchOS device builds

Baseline: iOS 17, watchOS 10, Swift 6; development host initially verified with Xcode 27 / Swift 6.4. Supporting these deployment targets still requires later runtime testing. See setup.

Start here

Document	Purpose
Product brief	Scope, flows, hardware and success criteria
Architecture	Modules, lifecycle, trust boundaries
Command contracts	Versioned watch/phone command semantics
Parallel agent plan	Work ownership, prompts, dependencies and merge order
Integration runbook	Responsibilities of the integrating engineer
Platform feasibility	Apple constraints and evidence
Gesture specification	Calibration, false-trigger control, physical tests
Samsung integration	Pairing, display name, protocol, compatibility
Security and privacy	Token storage, TLS, data handling
Release checklist	Apple account, review and release gates
Brand and IP	Name, assets, licenses, legal clearance
Gitea setup	Private remote, branch protection, CI
Validation record	What was actually checked

Read AGENTS.md before assigning implementation. Only the integrating engineer changes shared contracts, signing settings, project wiring, or main. The next milestone is one real right-wrist movement producing exactly one right press on the owner's TV, with reliable stop/disarm behavior.