Skip to content

ShellGuard TOTP v0.0.1.3

Choose a tag to compare

@github-actions github-actions released this 05 Sep 02:25
· 66 commits to main since this release

🦞 ShellGuard TOTP β€” Release v0.0.1.3 (Build 9)

The Self-Healing Mirror Hotfix

β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ•—   β–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ•—     β–ˆβ–ˆβ•—              β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—   β–ˆβ–ˆβ•—   β–ˆβ–ˆβ•—   β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—    β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—     β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—
β–ˆβ–ˆβ•”β•β•β•β•β•β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β•β•β•β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ•‘              β–ˆβ–ˆβ•”β•β•β•β•   β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—  β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—    β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—
β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—   β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ•‘              β–ˆβ–ˆβ•‘ β–ˆβ–ˆβ–ˆβ•—  β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘  β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•”β•    β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘
β•šβ•β•β•β•β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β•   β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ•‘              β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—    β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘
β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—  β•šβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•”β•β•šβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•  β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•”β•
β•šβ•β•β•β•β•β•β•β•šβ•β•  β•šβ•β•β•šβ•β•β•β•β•β•β•β•šβ•β•β•β•β•β•β•β•šβ•β•β•β•β•β•β•    β•šβ•β•   β•šβ•β•   β•šβ•β•   β•šβ•β•   β•šβ•β•   β•šβ•β•
                                                  ~ **ClawStack Mobile StudiosΒ©β„’** ~

πŸš€ The Core Summary

Welcome to v0.0.1.3 of ShellGuard TOTP β€” a targeted hotfix release patching the v0.0.1.2 remote sync regression where 2FA codes silently stopped syncing from connected ShellGuard Servers, plus a dashboard polish fix for synced code cards. No new features; existing v0.0.1.2 devices self-heal on their next sync pull. All 96 unit tests green.


πŸ’Ž Key Themes & Highlights

πŸ›‘οΈ 1. One-Way Sync Engine Restoration (CRITICAL)

  • Root cause patched: v0.0.1.2's delta-sync efficiency compared the nullable local remoteUpdatedAt mirror stamp against the nullable server updated_at field β€” a null == null match silently classified every affected pearl as "unchanged," skipping decryption and upsert while sync still reported success.
  • TotpRepository.classifyDeltaPearls: Extracted the delta classification into a pure, tested function β€” a pearl is skipped only when a local mirror row exists AND the server stamp is non-null AND equal. Null/missing server stamps always sync (v0.0.1.0 behavior restored).
  • Self-healing migration: Devices stuck on v0.0.1.2 require no migration or re-login β€” the next periodic (6h), pull-to-refresh, or manual sync populates all missing codes automatically.

🎨 2. Synced Card Visual Polish

  • Badge wrap fix: The "Read-only" text pill on synced cards wrapped to three lines ("Rea/d-on/ly"), inflating card height. The pink cloud icon now alone denotes synced read-only codes β€” semantics preserved via contentDescription and the "☁️ Synced from ShellGuard" group header. Cards render at standard single-line height.

πŸ§ͺ 3. Regression Armor

  • DeltaSyncClassificationTest (6 cases): First direct coverage of the sync delta path, including the exact production repro (fresh install + null server stamp). Suite total: 96/96 passing.

βœ… Verification Gate

  • 96/96 unit & Robolectric tests passing (100% green)
  • assembleDebug build successful
  • Live on-device verification: remote sync restored + card layout confirmed on physical Pixel 8

πŸ“¦ Upgrade Notes

  • versionCode 8 β†’ 9 (monotonic Play Console invariant); versionName "0.0.1.3"
  • No schema migration required; no settings changes
  • Recommended for all v0.0.1.2 users immediately