docs(mistdemo): note Apple 2FA "Allow shows no code" workaround

[leogdion]

Context

When signing into the MistDemo web demo (mistdemo web / mistdemo auth-token), the Apple ID sign-in triggers Apple's macOS trusted-device two-factor prompt ("Apple Account Sign In Requested … used to sign in on the web"). Clicking Allow is supposed to display a 6-digit code to type into the idmsa.apple.com window, but macOS sometimes fails to show that code modal — so the six boxes stay empty and sign-in stalls.

This is Apple/macOS behavior, not a MistDemo or MistKit bug: the sign-in page is served by idmsa.apple.com and driven by Apple's CloudKit JS widget, which owns the entire Apple ID + two-factor challenge. MistDemo only captures the resulting web-auth token after sign-in succeeds (confirmed: the SMS-code fallback completes sign-in normally, proving token capture is fine).

Change

Adds a ### Troubleshooting subsection to the Web — mistdemo web section of Examples/MistDemo/README.md documenting the symptom and the reliable workaround: generate the code manually via System Settings → [name] → Sign-In & Security → Get Verification Code instead of waiting on the notification popup.

Docs-only, +26 lines, no build/test impact.

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 38b92a8f-238c-46fb-82a6-244ebf30b438

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/mistdemo-2fa-troubleshooting

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 11.40%. Comparing base (7791b09) to head (326b943).
⚠️ Report is 2 commits behind head on v1.0.0-beta.3.

❗ There is a different number of reports uploaded between BASE (7791b09) and HEAD (326b943). Click for more details.

HEAD has 9 uploads less than BASE

Flag	BASE (7791b09)	HEAD (326b943)
swift-6.2-jammy	1	0
swift-6.1-noble	1	0
swift-6.1-jammy	1	0
swift-6.2-noble	1	0
spm	3	0
swift-6.3-noble	1	0
swift-6.3-jammy	1	0

Additional details and impacted files

@@                Coverage Diff                 @@
##           v1.0.0-beta.3     #422       +/-   ##
==================================================
- Coverage          73.85%   11.40%   -62.45%     
==================================================
  Files                156      156               
  Lines               3698     3718       +20     
==================================================
- Hits                2731      424     -2307     
- Misses               967     3294     +2327     

Flag	Coverage Δ
mistdemo-spm-macos	11.40% <ø> (+0.20%)	⬆️
mistdemo-swift-6.2-jammy	11.40% <ø> (+0.20%)	⬆️
mistdemo-swift-6.2-noble	11.40% <ø> (+0.20%)	⬆️
mistdemo-swift-6.3-jammy	11.40% <ø> (+0.20%)	⬆️
mistdemo-swift-6.3-noble	11.40% <ø> (+0.20%)	⬆️
spm	?
swift-6.1-jammy	?
swift-6.1-noble	?
swift-6.2-jammy	?
swift-6.2-noble	?
swift-6.3-jammy	?
swift-6.3-noble	?

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.