life-recorder-setup

# Life Recorder setup Build the native iOS target in `ios/LifeRecorder.xcodeproj`, configure the Python receiver in `receiver/`, and keep all runtime state outside the repository. ## Phone control Use Apple CoreDevice (`xcrun devicectl`) for read-only device inspection, installation, and launching the bundle on a connected device. Use the CUA iPhone Mirroring surface for visual UI actions when the phone is available. Do not bypass a passcode or protected system dialog. If iOS reports that the device is locked, ask the user to unlock it and open Life Recorder once. ## Required user permissions The user must handle or approve: - Xcode signing with their Apple developer account and development team - Trusting the Mac and enabling Developer Mode on the iPhone - Microphone permission for Life Recorder - Local-network permission for Life Recorder - Any macOS firewall or protected credential prompt Never request or store the user's Apple password, iPhone passcode, receiver token, private key, or pairing page in the repository. ## Setup workflow 1. Check that Xcode, Python, ffmpeg, whisper.cpp, and a GGML Whisper model are installed. 2. Build and install the app on the connected iPhone using the user's team and device identifier. 3. Run `receiver/setup.py` with a private data directory and `--install-agent`. Keep the generated pairing page private and delete it after pairing if desired. 4. Pair the iPhone, switch recording on, and verify a short upload and local Markdown update. 5. For a stalled queue, inspect the receiver health endpoint and the phone's pending audio count. Opening the app while unlocked reactivates its upload manager; do not force-quit it. 6. Keep `life.md`, audio, SQLite state, tokens, certificates, pairing pages, and device-specific validation artifacts outside Git. The phone records in one-minute chunks and queues them while offline. The Mac receiver transcribes with local Whisper, filters obvious repetitive/stage-direction hallucinations, and writes a continuous Markdown transcript with hourly markers. Reboots and force-quits require one manual app open because iOS does not provide a reliable silent microphone launch at boot.