[cte13]

Summary

The upstream sync (#80) merged three Mac-side changes whose phone counterparts were left behind. This PR brings the shared package back in step with the Mac.

• Provider tabs (upstream fix(home): retain historical usage on idle days chattymin/PokeTokenBar#377, fix: keep recently used providers' tabs and limits across calendar resets chattymin/PokeTokenBar#402). The Mac now keeps a provider's tab while it has usage this week or this month, a live 5-hour block, or any use within the 7-day quota window. The phone overlay still required usage today or a live block, so a provider used last Friday disappeared from the phone on Monday while the Mac still showed it and its limits. The rule now lives once, in PhoneProviderSnapshot.hasDisplayableUsage(now:), and both overlay branches (recounted and Mac-kept providers) call it. The payload gains an optional lastUsage date so the check still works after the Mac's week or month has rolled over; payloads from older Macs decode it as nil.
• Token formatter (upstream fix: promote compact token units at rounding boundaries chattymin/PokeTokenBar#365, Pick formatter precision from the rounded value, not the raw one chattymin/PokeTokenBar#418). The shared TokenFormatter used by the iPhone app and widget now promotes units at rounding boundaries and picks precision from the rounded value: 1M instead of 1000.0K, $100 instead of $100.0, 80% instead of 80.0%.
• Kimi Code metadata (upstream feat: add Kimi Code as a local usage provider chattymin/PokeTokenBar#403). ProviderMetadata.allKnown gains kimi_code, so the phone's provider visibility list knows the provider before the first payload that carries it.

Defect log entry added: phone copies of Mac rules drift silently on upstream sync. Keep one rule in the shared package, and grep the phone, widget and shared package for copies when syncing.

Type of change

• Bug fix
• New feature
• Refactor / cleanup
• Documentation
• Other:

Checklist

• swift build and swift test pass locally
• PR title follows Conventional Commits and title/description are written in English
• UI changes include embedded images (before/after for existing screens; image of a new screen), or there is no visible UI change
• No copyrighted assets, secrets, or private tooling references are committed (see CONTRIBUTING)
• Tests were added or updated for this change

Validation

• PokeTokenBarShared: swift test passes (65 tests). New tests: aRecountedProviderIdleTodayKeepsItsTabWhileThisMonthHasUsage, aRecountedProviderUsedInsideTheQuotaWindowSurvivesAMonthRollover (6 days back kept, 11 days back dropped), aMacOnlyProviderKeepsItsTabFromLastUsageAfterTheMacPeriodRolledOver, providerSnapshotWithoutLastUsageDecodes, and the Mac's formatter boundary cases. Reverting hasDisplayableUsage to the old rule makes the three retention tests fail.
• Root package: swift test runs 1698 tests with one failure, SessionKeySettingsRenderingTests.testSessionKeyEntryOpensInsideViewportAndPreservesDifficultyControls, which fails identically on untouched main on this machine. Three test classes were skipped locally because they reach the real Keychain and stall on a system prompt here (KeychainAutoPathTests, IncrementalStoreScanTests, testKeychainDisabledRecordsNoHistory); CI has no Keychain entries and runs them.
• No visible UI change: the phone shows the same screens with the Mac's tab retention and rounding.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NUKUCMdezMcZX7Sb2Bwu6x