[bhelm]

What this PR does

Makes the Swift public SleepStagerV2.stageSession establish stable timestamp order before binary-search clipping, matching the Kotlin twin. Already-monotonic streams keep the allocation-free fast path; only genuinely shuffled inputs allocate a stable reorder. The uncached recipe consumes the already-ordered clipped streams directly, preserving same-second emission order.

Permanent mirrored native tests cover deterministic shuffled streams, freeze the existing sorted-input result, and use cache-isolated translated windows to prove two order-sensitive same-timestamp gravity outcomes remain distinct while timestamp-group shuffling preserves each outcome. Padding constants and the parity rollout harness are unchanged.

Type of change

• Bug fix
• New feature
• Refactor / cleanup
• Documentation
• CI / tooling

How it was tested

• RED on unchanged 6df88d0d: the permanent Swift shuffled-input regression failed with sorted all-light versus shuffled light+REM.
• RED mutation check: a legal unstable same-timestamp tie reorder made both retained-signal oracle runs change from wake to light.
• Final focused Swift public outcome regression: passed.
• Final mirrored Kotlin public outcome regression: passed with JDK 17, one worker, Kotlin compilation in-process, and parallelism disabled.
• Production-identical full StrandAnalytics suite before the final test-only oracle refinement: 1,439 tests executed, 2 skipped, 0 failures.
• Production-identical full Android :app:testFullDebugUnitTest before the final test-only oracle refinement: passed.
• Parity ratchet against the exact base: 59 differential, 2,605 exempt, 0 errors.
• Independent final delta review: no P0/P1/P2 findings.
• No manual or hardware testing required: this changes pure sleep analytics ordering only.

Checklist

• Swift package tests pass for any package I touched (swift test in Packages/<name>)
• Android unit tests pass if I touched android/ (./gradlew testFullDebugUnitTest)
• No new build warnings introduced
• UI changes use only StrandDesign tokens — no hardcoded colors, fonts, or spacing
• No hardcoded hex frame bytes; protocol facts live in the schema / decoders
• Follows the conventions in docs/CONTRIBUTING.md
• I did not commit generated output (Strand.xcodeproj/) or any secrets/keystores

Related issues

Closes #67

[bhelm]

Superseded by upstream merge ryanbr#1456 (82bfd3d). The upstream version contains the reviewed stable sort, equal-timestamp behavioral regressions, and current #66 context. Closing without merge; the S3 differential harness remains tracked separately under #17.