Repository navigation
ShellGuard TOTP v0.0.1.3
π¦ 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
remoteUpdatedAtmirror stamp against the nullable serverupdated_atfield β anull == nullmatch 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
contentDescriptionand 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)
assembleDebugbuild successful- Live on-device verification: remote sync restored + card layout confirmed on physical Pixel 8
π¦ Upgrade Notes
versionCode8 β 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