@sriinnu/runic 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (584) hide show
  1. package/.swiftformat +50 -0
  2. package/.swiftlint.yml +160 -0
  3. package/CHANGELOG.md +307 -0
  4. package/CONTRIBUTING.md +456 -0
  5. package/Icon.icns +0 -0
  6. package/Icon.icon/Assets/runic.png +0 -0
  7. package/Icon.icon/icon.json +36 -0
  8. package/LICENSE +21 -0
  9. package/Package.resolved +51 -0
  10. package/Package.swift +136 -0
  11. package/Packages/Helix/LICENSE +21 -0
  12. package/Packages/Helix/Package.swift +29 -0
  13. package/Packages/Helix/README.md +976 -0
  14. package/Packages/Helix/Sources/Helix/Binding.swift +111 -0
  15. package/Packages/Helix/Sources/Helix/CommandParser.swift +160 -0
  16. package/Packages/Helix/Sources/Helix/CommandSignature.swift +117 -0
  17. package/Packages/Helix/Sources/Helix/ExpressibleFromArgument.swift +72 -0
  18. package/Packages/Helix/Sources/Helix/HelpGenerator.swift +175 -0
  19. package/Packages/Helix/Sources/Helix/NameSpecification.swift +98 -0
  20. package/Packages/Helix/Sources/Helix/ParsableCommand.swift +204 -0
  21. package/Packages/Helix/Sources/Helix/Platform/DarwinPlatformContext.swift +44 -0
  22. package/Packages/Helix/Sources/Helix/Platform/LinuxPlatformContext.swift +34 -0
  23. package/Packages/Helix/Sources/Helix/Platform/PlatformContext+Default.swift +91 -0
  24. package/Packages/Helix/Sources/Helix/Platform/PlatformContext.swift +94 -0
  25. package/Packages/Helix/Sources/Helix/Platform/PlatformPath.swift +167 -0
  26. package/Packages/Helix/Sources/Helix/Platform/Stdio.swift +99 -0
  27. package/Packages/Helix/Sources/Helix/Platform/WebPlatformContext.swift +146 -0
  28. package/Packages/Helix/Sources/Helix/Platform/WindowsPlatformContext.swift +97 -0
  29. package/Packages/Helix/Sources/Helix/Program.swift +204 -0
  30. package/Packages/Helix/Sources/Helix/PropertyWrappers.swift +367 -0
  31. package/Packages/Silo/LICENSE +21 -0
  32. package/Packages/Silo/Package.swift +34 -0
  33. package/Packages/Silo/README.md +466 -0
  34. package/Packages/Silo/Sources/Silo/BinaryCookiesReader.swift +169 -0
  35. package/Packages/Silo/Sources/Silo/BrowserCookieAnalytics.swift +365 -0
  36. package/Packages/Silo/Sources/Silo/BrowserCookieBackends.swift +594 -0
  37. package/Packages/Silo/Sources/Silo/BrowserCookieClient.swift +326 -0
  38. package/Packages/Silo/Sources/Silo/BrowserCookieExport.swift +154 -0
  39. package/Packages/Silo/Sources/Silo/BrowserCookieImport.swift +119 -0
  40. package/Packages/Silo/Sources/Silo/BrowserCookieMockStore.swift +121 -0
  41. package/Packages/Silo/Sources/Silo/BrowserCookieModels.swift +391 -0
  42. package/Packages/Silo/Sources/Silo/ChromiumCookieReader.swift +240 -0
  43. package/Packages/Silo/Sources/Silo/CryptoSupport.swift +86 -0
  44. package/Packages/Silo/Sources/Silo/FirefoxCookieReader.swift +172 -0
  45. package/Packages/Silo/Sources/Silo/LinuxChromiumCookieReader.swift +172 -0
  46. package/Packages/Silo/Sources/Silo/LinuxSecretService.swift +105 -0
  47. package/Packages/Silo/Sources/Silo/MacOSChromiumCookieReader.swift +191 -0
  48. package/Packages/Silo/Sources/Silo/SQLiteSnapshot.swift +41 -0
  49. package/Packages/Silo/Sources/Silo/WindowsChromiumCookieReader.swift +110 -0
  50. package/README.md +109 -0
  51. package/RuniciOS/App/RuniciOSApp.swift +105 -0
  52. package/RuniciOS/Core/iOSUsageStore.swift +192 -0
  53. package/RuniciOS/Views/ProviderDetailView.swift +312 -0
  54. package/RuniciOS/Views/ProviderListView.swift +228 -0
  55. package/RuniciOS/Widgets/LargeWidget.swift +367 -0
  56. package/RuniciOS/Widgets/LiveActivity.swift +342 -0
  57. package/RuniciOS/Widgets/LockScreenWidget.swift +273 -0
  58. package/RuniciOS/Widgets/MediumWidget.swift +370 -0
  59. package/RuniciOS/Widgets/RunicWidget.swift +274 -0
  60. package/RuniciOS/Widgets/SmallWidget.swift +281 -0
  61. package/RuniciOS/Widgets/WidgetModels.swift +285 -0
  62. package/RuniciOS/Widgets/WidgetTimeline.swift +270 -0
  63. package/Scripts/CREATION-SUMMARY.md +367 -0
  64. package/Scripts/DIRECTORY-STRUCTURE.md +358 -0
  65. package/Scripts/GETTING-STARTED-CHECKLIST.md +364 -0
  66. package/Scripts/INDEX.md +365 -0
  67. package/Scripts/QUICK-REFERENCE.md +164 -0
  68. package/Scripts/README-SCRIPTS.md +926 -0
  69. package/Scripts/build-android.sh +526 -0
  70. package/Scripts/build-ios.sh +529 -0
  71. package/Scripts/build-macos.sh +603 -0
  72. package/Scripts/build-windows.sh +504 -0
  73. package/Scripts/build_icon.sh +49 -0
  74. package/Scripts/changelog-to-html.sh +89 -0
  75. package/Scripts/check-release-assets.sh +10 -0
  76. package/Scripts/ci-config.yml +474 -0
  77. package/Scripts/compile_and_run.sh +219 -0
  78. package/Scripts/compile_and_run_adhoc.sh +4 -0
  79. package/Scripts/docs-list.mjs +119 -0
  80. package/Scripts/make_appcast.sh +58 -0
  81. package/Scripts/package_app.sh +409 -0
  82. package/Scripts/release-lib.sh +214 -0
  83. package/Scripts/release.sh +76 -0
  84. package/Scripts/setup-all.sh +387 -0
  85. package/Scripts/setup-ios.sh +404 -0
  86. package/Scripts/setup-react-native.sh +523 -0
  87. package/Scripts/sign-and-notarize.sh +122 -0
  88. package/Scripts/test_live_update.sh +38 -0
  89. package/Scripts/validate_changelog.sh +23 -0
  90. package/Scripts/verify_appcast.sh +92 -0
  91. package/Sources/Runic/About.swift +93 -0
  92. package/Sources/Runic/AppNotifications.swift +115 -0
  93. package/Sources/Runic/Controllers/StatusItemController+Actions.swift +657 -0
  94. package/Sources/Runic/Controllers/StatusItemController+Animation.swift +518 -0
  95. package/Sources/Runic/Controllers/StatusItemController+ChartSubmenus.swift +810 -0
  96. package/Sources/Runic/Controllers/StatusItemController+CustomProviders.swift +87 -0
  97. package/Sources/Runic/Controllers/StatusItemController+Menu.swift +1379 -0
  98. package/Sources/Runic/Controllers/StatusItemController+MenuCards.swift +337 -0
  99. package/Sources/Runic/Controllers/StatusItemController+MenuHelpers.swift +395 -0
  100. package/Sources/Runic/Controllers/StatusItemController.swift +360 -0
  101. package/Sources/Runic/Core/BudgetNotificationManager.swift +80 -0
  102. package/Sources/Runic/Core/Login/ClaudeLoginRunner.swift +103 -0
  103. package/Sources/Runic/Core/Login/CodexLoginRunner.swift +154 -0
  104. package/Sources/Runic/Core/Login/CursorLoginRunner.swift +206 -0
  105. package/Sources/Runic/Core/Login/GeminiLoginRunner.swift +95 -0
  106. package/Sources/Runic/Core/Rendering/IconRenderer.swift +1216 -0
  107. package/Sources/Runic/Core/Rendering/IconView.swift +120 -0
  108. package/Sources/Runic/Core/Rendering/ProviderBrandIcon.swift +71 -0
  109. package/Sources/Runic/Core/RunicAnimation.swift +53 -0
  110. package/Sources/Runic/Core/RunicColors.swift +73 -0
  111. package/Sources/Runic/Core/RunicCornerRadius.swift +15 -0
  112. package/Sources/Runic/Core/RunicSpacing.swift +68 -0
  113. package/Sources/Runic/Core/Stores/AuggieTokenStore.swift +143 -0
  114. package/Sources/Runic/Core/Stores/AzureOpenAITokenStore.swift +143 -0
  115. package/Sources/Runic/Core/Stores/CerebrasTokenStore.swift +143 -0
  116. package/Sources/Runic/Core/Stores/CohereTokenStore.swift +143 -0
  117. package/Sources/Runic/Core/Stores/CopilotTokenStore.swift +143 -0
  118. package/Sources/Runic/Core/Stores/CustomProviderStore.swift +158 -0
  119. package/Sources/Runic/Core/Stores/DeepSeekTokenStore.swift +143 -0
  120. package/Sources/Runic/Core/Stores/FireworksTokenStore.swift +143 -0
  121. package/Sources/Runic/Core/Stores/GroqTokenStore.swift +143 -0
  122. package/Sources/Runic/Core/Stores/KimiTokenStore.swift +143 -0
  123. package/Sources/Runic/Core/Stores/MiniMaxCookieHeaderStore.swift +143 -0
  124. package/Sources/Runic/Core/Stores/MiniMaxGroupIDStore.swift +143 -0
  125. package/Sources/Runic/Core/Stores/MiniMaxTokenStore.swift +143 -0
  126. package/Sources/Runic/Core/Stores/MistralTokenStore.swift +143 -0
  127. package/Sources/Runic/Core/Stores/OpenRouterTokenStore.swift +143 -0
  128. package/Sources/Runic/Core/Stores/PerplexityTokenStore.swift +143 -0
  129. package/Sources/Runic/Core/Stores/ProviderToggleStore.swift +30 -0
  130. package/Sources/Runic/Core/Stores/QwenTokenStore.swift +143 -0
  131. package/Sources/Runic/Core/Stores/SambaNovaTokenStore.swift +143 -0
  132. package/Sources/Runic/Core/Stores/SettingsStore.swift +1702 -0
  133. package/Sources/Runic/Core/Stores/TogetherTokenStore.swift +143 -0
  134. package/Sources/Runic/Core/Stores/UsageStore+Accessors.swift +20 -0
  135. package/Sources/Runic/Core/Stores/UsageStore+Status.swift +189 -0
  136. package/Sources/Runic/Core/Stores/UsageStore+TokenCost.swift +33 -0
  137. package/Sources/Runic/Core/Stores/UsageStore+WidgetSnapshot.swift +67 -0
  138. package/Sources/Runic/Core/Stores/UsageStore.swift +3564 -0
  139. package/Sources/Runic/Core/Stores/XAITokenStore.swift +143 -0
  140. package/Sources/Runic/Core/Stores/ZaiTokenStore.swift +143 -0
  141. package/Sources/Runic/Core/UsageExporter.swift +193 -0
  142. package/Sources/Runic/Date+RelativeDescription.swift +21 -0
  143. package/Sources/Runic/HiddenWindowView.swift +32 -0
  144. package/Sources/Runic/InstallOrigin.swift +9 -0
  145. package/Sources/Runic/KeyboardShortcuts+Names.swift +6 -0
  146. package/Sources/Runic/MouseLocationReader.swift +65 -0
  147. package/Sources/Runic/Notifications+Runic.swift +6 -0
  148. package/Sources/Runic/OpenAICreditsPurchaseWindowController.swift +503 -0
  149. package/Sources/Runic/ProviderRegistry.swift +100 -0
  150. package/Sources/Runic/ProviderSwitcherButtons.swift +267 -0
  151. package/Sources/Runic/Providers/Antigravity/AntigravityLoginFlow.swift +11 -0
  152. package/Sources/Runic/Providers/Antigravity/AntigravityProviderImplementation.swift +14 -0
  153. package/Sources/Runic/Providers/Auggie/AuggieProviderImplementation.swift +24 -0
  154. package/Sources/Runic/Providers/Azure/AzureProviderImplementation.swift +52 -0
  155. package/Sources/Runic/Providers/Bedrock/BedrockProviderImplementation.swift +42 -0
  156. package/Sources/Runic/Providers/Cerebras/CerebrasProviderImplementation.swift +24 -0
  157. package/Sources/Runic/Providers/Claude/ClaudeLoginFlow.swift +26 -0
  158. package/Sources/Runic/Providers/Claude/ClaudeProviderImplementation.swift +14 -0
  159. package/Sources/Runic/Providers/Codex/CodexLoginFlow.swift +18 -0
  160. package/Sources/Runic/Providers/Codex/CodexProviderImplementation.swift +15 -0
  161. package/Sources/Runic/Providers/Cohere/CohereProviderImplementation.swift +24 -0
  162. package/Sources/Runic/Providers/Copilot/CopilotLoginFlow.swift +193 -0
  163. package/Sources/Runic/Providers/Copilot/CopilotProviderImplementation.swift +110 -0
  164. package/Sources/Runic/Providers/Cursor/CursorLoginFlow.swift +28 -0
  165. package/Sources/Runic/Providers/Cursor/CursorProviderImplementation.swift +15 -0
  166. package/Sources/Runic/Providers/DeepSeek/DeepSeekProviderImplementation.swift +24 -0
  167. package/Sources/Runic/Providers/Factory/FactoryLoginFlow.swift +12 -0
  168. package/Sources/Runic/Providers/Factory/FactoryProviderImplementation.swift +15 -0
  169. package/Sources/Runic/Providers/Fireworks/FireworksProviderImplementation.swift +24 -0
  170. package/Sources/Runic/Providers/Gemini/GeminiLoginFlow.swift +20 -0
  171. package/Sources/Runic/Providers/Gemini/GeminiProviderImplementation.swift +15 -0
  172. package/Sources/Runic/Providers/Groq/GroqProviderImplementation.swift +24 -0
  173. package/Sources/Runic/Providers/Kimi/KimiProviderImplementation.swift +24 -0
  174. package/Sources/Runic/Providers/MiniMax/MiniMaxProviderImplementation.swift +32 -0
  175. package/Sources/Runic/Providers/Mistral/MistralProviderImplementation.swift +24 -0
  176. package/Sources/Runic/Providers/OpenRouter/OpenRouterProviderImplementation.swift +24 -0
  177. package/Sources/Runic/Providers/Perplexity/PerplexityProviderImplementation.swift +24 -0
  178. package/Sources/Runic/Providers/SambaNova/SambaNovaProviderImplementation.swift +24 -0
  179. package/Sources/Runic/Providers/Shared/ProviderCatalog.swift +15 -0
  180. package/Sources/Runic/Providers/Shared/ProviderImplementation.swift +48 -0
  181. package/Sources/Runic/Providers/Shared/ProviderImplementationRegistry.swift +66 -0
  182. package/Sources/Runic/Providers/Shared/ProviderLoginFlow.swift +12 -0
  183. package/Sources/Runic/Providers/Shared/ProviderSettingsDescriptors.swift +99 -0
  184. package/Sources/Runic/Providers/Shared/SystemSettingsLinks.swift +18 -0
  185. package/Sources/Runic/Providers/Together/TogetherProviderImplementation.swift +24 -0
  186. package/Sources/Runic/Providers/XAI/XAIProviderImplementation.swift +24 -0
  187. package/Sources/Runic/Providers/Zai/ZaiProviderImplementation.swift +24 -0
  188. package/Sources/Runic/Resources/ProviderIcon-antigravity.svg +2 -0
  189. package/Sources/Runic/Resources/ProviderIcon-auggie.svg +3 -0
  190. package/Sources/Runic/Resources/ProviderIcon-azure.svg +5 -0
  191. package/Sources/Runic/Resources/ProviderIcon-bedrock.svg +7 -0
  192. package/Sources/Runic/Resources/ProviderIcon-cerebras.svg +3 -0
  193. package/Sources/Runic/Resources/ProviderIcon-claude.svg +1 -0
  194. package/Sources/Runic/Resources/ProviderIcon-codex.svg +1 -0
  195. package/Sources/Runic/Resources/ProviderIcon-cohere.svg +3 -0
  196. package/Sources/Runic/Resources/ProviderIcon-copilot.svg +1 -0
  197. package/Sources/Runic/Resources/ProviderIcon-cursor.svg +3 -0
  198. package/Sources/Runic/Resources/ProviderIcon-deepseek.svg +4 -0
  199. package/Sources/Runic/Resources/ProviderIcon-factory.svg +3 -0
  200. package/Sources/Runic/Resources/ProviderIcon-fireworks.svg +3 -0
  201. package/Sources/Runic/Resources/ProviderIcon-gemini.svg +1 -0
  202. package/Sources/Runic/Resources/ProviderIcon-groq.svg +1 -0
  203. package/Sources/Runic/Resources/ProviderIcon-kimi.svg +4 -0
  204. package/Sources/Runic/Resources/ProviderIcon-minimax.svg +1 -0
  205. package/Sources/Runic/Resources/ProviderIcon-mistral.svg +5 -0
  206. package/Sources/Runic/Resources/ProviderIcon-openrouter.svg +7 -0
  207. package/Sources/Runic/Resources/ProviderIcon-perplexity.svg +4 -0
  208. package/Sources/Runic/Resources/ProviderIcon-qwen.svg +9 -0
  209. package/Sources/Runic/Resources/ProviderIcon-sambanova.svg +4 -0
  210. package/Sources/Runic/Resources/ProviderIcon-together.svg +5 -0
  211. package/Sources/Runic/Resources/ProviderIcon-vertexai.svg +17 -0
  212. package/Sources/Runic/Resources/ProviderIcon-xai.svg +3 -0
  213. package/Sources/Runic/Resources/ProviderIcon-zai.svg +5 -0
  214. package/Sources/Runic/Resources/RunicMenubarIcon.svg +7 -0
  215. package/Sources/Runic/RunicApp.swift +357 -0
  216. package/Sources/Runic/SessionQuotaNotifications.swift +58 -0
  217. package/Sources/Runic/UsagePaceText.swift +52 -0
  218. package/Sources/Runic/UsageProgressBar.swift +224 -0
  219. package/Sources/Runic/Utilities/DisplayLink.swift +96 -0
  220. package/Sources/Runic/Utilities/LoadingPattern.swift +60 -0
  221. package/Sources/Runic/Utilities/PerformanceConstants.swift +85 -0
  222. package/Sources/Runic/Views/Menu/AlertsMenuView.swift +256 -0
  223. package/Sources/Runic/Views/Menu/ChartPanelStyle.swift +22 -0
  224. package/Sources/Runic/Views/Menu/CostComparativeChartMenuView.swift +275 -0
  225. package/Sources/Runic/Views/Menu/CostHistoryChartMenuView.swift +377 -0
  226. package/Sources/Runic/Views/Menu/CreditsHistoryChartMenuView.swift +312 -0
  227. package/Sources/Runic/Views/Menu/EfficiencyMetricsMenuView.swift +312 -0
  228. package/Sources/Runic/Views/Menu/HeroStatCardsMenuView.swift +228 -0
  229. package/Sources/Runic/Views/Menu/HourlyActivityChartMenuView.swift +228 -0
  230. package/Sources/Runic/Views/Menu/InlineUsageChartView.swift +162 -0
  231. package/Sources/Runic/Views/Menu/MenuCardEntranceModifier.swift +64 -0
  232. package/Sources/Runic/Views/Menu/MenuCardSidebarView.swift +268 -0
  233. package/Sources/Runic/Views/Menu/MenuCardSkeletonView.swift +104 -0
  234. package/Sources/Runic/Views/Menu/MenuCardView.swift +1900 -0
  235. package/Sources/Runic/Views/Menu/MenuContent.swift +150 -0
  236. package/Sources/Runic/Views/Menu/MenuDescriptor.swift +369 -0
  237. package/Sources/Runic/Views/Menu/MenuHighlightStyle.swift +42 -0
  238. package/Sources/Runic/Views/Menu/ModelBreakdownMenuView.swift +235 -0
  239. package/Sources/Runic/Views/Menu/OverviewMenuView.swift +141 -0
  240. package/Sources/Runic/Views/Menu/ProjectBreakdownMenuView.swift +209 -0
  241. package/Sources/Runic/Views/Menu/ProjectBudgetMenuView.swift +220 -0
  242. package/Sources/Runic/Views/Menu/ProviderTabBarView.swift +88 -0
  243. package/Sources/Runic/Views/Menu/SubscriptionUtilizationChartMenuView.swift +201 -0
  244. package/Sources/Runic/Views/Menu/UsageBreakdownChartMenuView.swift +398 -0
  245. package/Sources/Runic/Views/Menu/UsageHeatmapMenuView.swift +232 -0
  246. package/Sources/Runic/Views/Menu/UsageTimelineChartMenuView.swift +417 -0
  247. package/Sources/Runic/Views/Menu/UsageWindowComparisonChartMenuView.swift +190 -0
  248. package/Sources/Runic/Views/Menu/WeeklyActivityChartMenuView.swift +132 -0
  249. package/Sources/Runic/Views/Performance/PerformanceDashboardView.swift +618 -0
  250. package/Sources/Runic/Views/Preferences/LiquidComponents.swift +305 -0
  251. package/Sources/Runic/Views/Preferences/PreferencesAboutPane.swift +271 -0
  252. package/Sources/Runic/Views/Preferences/PreferencesAdvancedPane.swift +268 -0
  253. package/Sources/Runic/Views/Preferences/PreferencesAlertsPane.swift +422 -0
  254. package/Sources/Runic/Views/Preferences/PreferencesAnalyticsPane.swift +641 -0
  255. package/Sources/Runic/Views/Preferences/PreferencesBudgetsPane.swift +344 -0
  256. package/Sources/Runic/Views/Preferences/PreferencesComponents.swift +230 -0
  257. package/Sources/Runic/Views/Preferences/PreferencesCustomProvidersPane.swift +322 -0
  258. package/Sources/Runic/Views/Preferences/PreferencesDebugPane.swift +469 -0
  259. package/Sources/Runic/Views/Preferences/PreferencesGeneralPane.swift +231 -0
  260. package/Sources/Runic/Views/Preferences/PreferencesHelpPane.swift +50 -0
  261. package/Sources/Runic/Views/Preferences/PreferencesIntegrationsPane.swift +497 -0
  262. package/Sources/Runic/Views/Preferences/PreferencesPerformancePane.swift +288 -0
  263. package/Sources/Runic/Views/Preferences/PreferencesProvidersPane.swift +3435 -0
  264. package/Sources/Runic/Views/Preferences/PreferencesSelection.swift +25 -0
  265. package/Sources/Runic/Views/Preferences/PreferencesSyncPane.swift +59 -0
  266. package/Sources/Runic/Views/Preferences/PreferencesView.swift +206 -0
  267. package/Sources/Runic/Views/Rating/QualityRatingView.swift +238 -0
  268. package/Sources/Runic/Views/Team/TeamDashboardView.swift +371 -0
  269. package/Sources/Runic/Views/Team/TeamInviteSheet.swift +175 -0
  270. package/Sources/Runic/Views/Team/TeamManagementView.swift +761 -0
  271. package/Sources/Runic/Views/Team/TeamMemberRow.swift +181 -0
  272. package/Sources/RunicCLI/CLIEntry.swift +942 -0
  273. package/Sources/RunicCLI/CLIRenderer.swift +87 -0
  274. package/Sources/RunicCLI/Commands/EnhancedUsageCommand.swift +588 -0
  275. package/Sources/RunicCLI/Commands/ModelsCommand.swift +362 -0
  276. package/Sources/RunicCLI/Commands/ProjectsCommand.swift +439 -0
  277. package/Sources/RunicCLI/Commands/ResetCommand.swift +429 -0
  278. package/Sources/RunicCLI/Commands/UsageLedgerSourceFactory.swift +168 -0
  279. package/Sources/RunicClaudeWatchdog/main.swift +122 -0
  280. package/Sources/RunicClaudeWebProbe/main.swift +62 -0
  281. package/Sources/RunicCore/AlertRuleStore.swift +187 -0
  282. package/Sources/RunicCore/BrowserCookieImportOrder.swift +25 -0
  283. package/Sources/RunicCore/CopilotUsageModels.swift +84 -0
  284. package/Sources/RunicCore/CostUsageFetcher.swift +119 -0
  285. package/Sources/RunicCore/CostUsageModels.swift +479 -0
  286. package/Sources/RunicCore/CreditsModels.swift +50 -0
  287. package/Sources/RunicCore/CustomProviders/CustomProviderModels.swift +269 -0
  288. package/Sources/RunicCore/CustomProviders/GenericProviderFetcher.swift +622 -0
  289. package/Sources/RunicCore/CustomProviders/ProviderTemplates.swift +500 -0
  290. package/Sources/RunicCore/Host/PTY/TTYCommandRunner.swift +679 -0
  291. package/Sources/RunicCore/Host/Process/SubprocessRunner.swift +135 -0
  292. package/Sources/RunicCore/Integrations/GitHubIntegration.swift +173 -0
  293. package/Sources/RunicCore/Logging/JSONStderrLogHandler.swift +79 -0
  294. package/Sources/RunicCore/Logging/OSLogLogHandler.swift +86 -0
  295. package/Sources/RunicCore/Logging/RunicLog.swift +123 -0
  296. package/Sources/RunicCore/Models/EnhancedUsageModels.swift +371 -0
  297. package/Sources/RunicCore/OpenAIDashboardModels.swift +210 -0
  298. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardBrowserCookieImporter.swift +676 -0
  299. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardFetcher.swift +492 -0
  300. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardNavigationDelegate.swift +51 -0
  301. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardParser.swift +483 -0
  302. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardScrapeScript.swift +558 -0
  303. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardWebViewCache.swift +204 -0
  304. package/Sources/RunicCore/OpenAIWeb/OpenAIDashboardWebsiteDataStore.swift +78 -0
  305. package/Sources/RunicCore/PathEnvironment.swift +482 -0
  306. package/Sources/RunicCore/Performance/PerformanceModels.swift +371 -0
  307. package/Sources/RunicCore/Performance/PerformanceStorageImpl.swift +409 -0
  308. package/Sources/RunicCore/Policy/UsagePolicyEngine.swift +178 -0
  309. package/Sources/RunicCore/ProjectBudgetStore.swift +99 -0
  310. package/Sources/RunicCore/ProviderCostSnapshot.swift +29 -0
  311. package/Sources/RunicCore/Providers/Antigravity/AntigravityProviderDescriptor.swift +66 -0
  312. package/Sources/RunicCore/Providers/Antigravity/AntigravityStatusProbe.swift +685 -0
  313. package/Sources/RunicCore/Providers/Auggie/AuggieProviderDescriptor.swift +83 -0
  314. package/Sources/RunicCore/Providers/Auggie/AuggieUsageFetcher.swift +142 -0
  315. package/Sources/RunicCore/Providers/Azure/AzureProviderDescriptor.swift +141 -0
  316. package/Sources/RunicCore/Providers/Azure/AzureUsageFetcher.swift +186 -0
  317. package/Sources/RunicCore/Providers/Bedrock/BedrockProviderDescriptor.swift +126 -0
  318. package/Sources/RunicCore/Providers/Bedrock/BedrockUsageFetcher.swift +168 -0
  319. package/Sources/RunicCore/Providers/Cerebras/CerebrasProviderDescriptor.swift +84 -0
  320. package/Sources/RunicCore/Providers/Cerebras/CerebrasUsageFetcher.swift +75 -0
  321. package/Sources/RunicCore/Providers/Claude/ClaudeCLISession.swift +332 -0
  322. package/Sources/RunicCore/Providers/Claude/ClaudeOAuth/ClaudeOAuthCredentials.swift +180 -0
  323. package/Sources/RunicCore/Providers/Claude/ClaudeOAuth/ClaudeOAuthUsageFetcher.swift +137 -0
  324. package/Sources/RunicCore/Providers/Claude/ClaudeProviderDescriptor.swift +207 -0
  325. package/Sources/RunicCore/Providers/Claude/ClaudeStatusProbe.swift +654 -0
  326. package/Sources/RunicCore/Providers/Claude/ClaudeUsageDataSource.swift +28 -0
  327. package/Sources/RunicCore/Providers/Claude/ClaudeUsageFetcher.swift +480 -0
  328. package/Sources/RunicCore/Providers/Claude/ClaudeWeb/ClaudeWebAPIFetcher.swift +780 -0
  329. package/Sources/RunicCore/Providers/Codex/CodexOAuth/CodexOAuthCredentials.swift +146 -0
  330. package/Sources/RunicCore/Providers/Codex/CodexOAuth/CodexOAuthUsageFetcher.swift +269 -0
  331. package/Sources/RunicCore/Providers/Codex/CodexOAuth/CodexTokenRefresher.swift +100 -0
  332. package/Sources/RunicCore/Providers/Codex/CodexProviderDescriptor.swift +243 -0
  333. package/Sources/RunicCore/Providers/Codex/CodexStatusProbe.swift +125 -0
  334. package/Sources/RunicCore/Providers/Codex/CodexUsageDataSource.swift +24 -0
  335. package/Sources/RunicCore/Providers/Codex/CodexWebDashboardStrategy.swift +181 -0
  336. package/Sources/RunicCore/Providers/Cohere/CohereProviderDescriptor.swift +83 -0
  337. package/Sources/RunicCore/Providers/Cohere/CohereUsageFetcher.swift +85 -0
  338. package/Sources/RunicCore/Providers/Copilot/CopilotDeviceFlow.swift +123 -0
  339. package/Sources/RunicCore/Providers/Copilot/CopilotGitHubCLITokenReader.swift +114 -0
  340. package/Sources/RunicCore/Providers/Copilot/CopilotProviderDescriptor.swift +100 -0
  341. package/Sources/RunicCore/Providers/Copilot/CopilotUsageFetcher.swift +291 -0
  342. package/Sources/RunicCore/Providers/Copilot/CopilotVSCodeTokenReader.swift +386 -0
  343. package/Sources/RunicCore/Providers/Cursor/CursorProviderDescriptor.swift +65 -0
  344. package/Sources/RunicCore/Providers/Cursor/CursorStatusProbe.swift +594 -0
  345. package/Sources/RunicCore/Providers/DeepSeek/DeepSeekProviderDescriptor.swift +85 -0
  346. package/Sources/RunicCore/Providers/DeepSeek/DeepSeekUsageFetcher.swift +108 -0
  347. package/Sources/RunicCore/Providers/Factory/FactoryLocalStorageImporter.swift +398 -0
  348. package/Sources/RunicCore/Providers/Factory/FactoryProviderDescriptor.swift +65 -0
  349. package/Sources/RunicCore/Providers/Factory/FactoryStatusProbe.swift +1275 -0
  350. package/Sources/RunicCore/Providers/Fireworks/FireworksProviderDescriptor.swift +84 -0
  351. package/Sources/RunicCore/Providers/Fireworks/FireworksUsageFetcher.swift +75 -0
  352. package/Sources/RunicCore/Providers/Gemini/GeminiProviderDescriptor.swift +65 -0
  353. package/Sources/RunicCore/Providers/Gemini/GeminiStatusProbe.swift +835 -0
  354. package/Sources/RunicCore/Providers/Groq/GroqProviderDescriptor.swift +83 -0
  355. package/Sources/RunicCore/Providers/Groq/GroqUsageFetcher.swift +71 -0
  356. package/Sources/RunicCore/Providers/Kimi/KimiProviderDescriptor.swift +83 -0
  357. package/Sources/RunicCore/Providers/Kimi/KimiUsageFetcher.swift +77 -0
  358. package/Sources/RunicCore/Providers/MiniMax/MiniMaxProviderDescriptor.swift +92 -0
  359. package/Sources/RunicCore/Providers/MiniMax/MiniMaxSettingsReader.swift +54 -0
  360. package/Sources/RunicCore/Providers/MiniMax/MiniMaxUsageFetcher.swift +171 -0
  361. package/Sources/RunicCore/Providers/MiniMax/MiniMaxWebUsageFetcher.swift +911 -0
  362. package/Sources/RunicCore/Providers/Mistral/MistralProviderDescriptor.swift +84 -0
  363. package/Sources/RunicCore/Providers/Mistral/MistralUsageFetcher.swift +75 -0
  364. package/Sources/RunicCore/Providers/OpenRouter/OpenRouterProviderDescriptor.swift +87 -0
  365. package/Sources/RunicCore/Providers/OpenRouter/OpenRouterUsageFetcher.swift +207 -0
  366. package/Sources/RunicCore/Providers/Perplexity/PerplexityProviderDescriptor.swift +84 -0
  367. package/Sources/RunicCore/Providers/Perplexity/PerplexityUsageFetcher.swift +75 -0
  368. package/Sources/RunicCore/Providers/ProviderBranding.swift +25 -0
  369. package/Sources/RunicCore/Providers/ProviderCLIConfig.swift +17 -0
  370. package/Sources/RunicCore/Providers/ProviderDescriptor.swift +129 -0
  371. package/Sources/RunicCore/Providers/ProviderFetchPlan.swift +263 -0
  372. package/Sources/RunicCore/Providers/ProviderSettingsSnapshot.swift +98 -0
  373. package/Sources/RunicCore/Providers/ProviderTokenResolver.swift +501 -0
  374. package/Sources/RunicCore/Providers/ProviderVersionDetector.swift +68 -0
  375. package/Sources/RunicCore/Providers/Providers.swift +184 -0
  376. package/Sources/RunicCore/Providers/Qwen/QwenProviderDescriptor.swift +84 -0
  377. package/Sources/RunicCore/Providers/Qwen/QwenSettingsReader.swift +30 -0
  378. package/Sources/RunicCore/Providers/Qwen/QwenUsageStats.swift +317 -0
  379. package/Sources/RunicCore/Providers/SambaNova/SambaNovaProviderDescriptor.swift +84 -0
  380. package/Sources/RunicCore/Providers/SambaNova/SambaNovaUsageFetcher.swift +75 -0
  381. package/Sources/RunicCore/Providers/Together/TogetherProviderDescriptor.swift +83 -0
  382. package/Sources/RunicCore/Providers/Together/TogetherUsageFetcher.swift +75 -0
  383. package/Sources/RunicCore/Providers/VertexAI/VertexAIProviderDescriptor.swift +123 -0
  384. package/Sources/RunicCore/Providers/VertexAI/VertexAISettingsReader.swift +48 -0
  385. package/Sources/RunicCore/Providers/VertexAI/VertexAIUsageFetcher.swift +144 -0
  386. package/Sources/RunicCore/Providers/XAI/XAIProviderDescriptor.swift +83 -0
  387. package/Sources/RunicCore/Providers/XAI/XAIUsageFetcher.swift +75 -0
  388. package/Sources/RunicCore/Providers/Zai/ZaiProviderDescriptor.swift +72 -0
  389. package/Sources/RunicCore/Providers/Zai/ZaiSettingsReader.swift +41 -0
  390. package/Sources/RunicCore/Providers/Zai/ZaiUsageStats.swift +724 -0
  391. package/Sources/RunicCore/Sync/BackgroundSyncManager.swift +385 -0
  392. package/Sources/RunicCore/Sync/SyncConflictResolver.swift +310 -0
  393. package/Sources/RunicCore/Sync/SyncProtocol.swift +288 -0
  394. package/Sources/RunicCore/Sync/SyncRecord.swift +405 -0
  395. package/Sources/RunicCore/Sync/SyncUsageExample.swift +294 -0
  396. package/Sources/RunicCore/Sync/TeamSyncRecords.swift +775 -0
  397. package/Sources/RunicCore/Sync/iCloudSyncEngine.swift +333 -0
  398. package/Sources/RunicCore/Team/TeamModels.swift +583 -0
  399. package/Sources/RunicCore/Team/TeamShowbackExporter.swift +495 -0
  400. package/Sources/RunicCore/Team/TeamStore.swift +792 -0
  401. package/Sources/RunicCore/TextParsing.swift +55 -0
  402. package/Sources/RunicCore/UsageFetcher.swift +694 -0
  403. package/Sources/RunicCore/UsageFormatter.swift +410 -0
  404. package/Sources/RunicCore/UsageLedger/ClaudeUsageLogSource.swift +329 -0
  405. package/Sources/RunicCore/UsageLedger/CodexUsageLogSource.swift +448 -0
  406. package/Sources/RunicCore/UsageLedger/OTelGenAILedgerAdapter.swift +550 -0
  407. package/Sources/RunicCore/UsageLedger/UsageLedger.swift +29 -0
  408. package/Sources/RunicCore/UsageLedger/UsageLedgerAggregator.swift +660 -0
  409. package/Sources/RunicCore/UsageLedger/UsageLedgerInsightsAdvisor.swift +209 -0
  410. package/Sources/RunicCore/UsageLedger/UsageLedgerModels.swift +417 -0
  411. package/Sources/RunicCore/UsageLedger/UsageLedgerProjectIdentity.swift +245 -0
  412. package/Sources/RunicCore/UsagePace.swift +81 -0
  413. package/Sources/RunicCore/Vendored/CostUsage/CostUsageCache.swift +73 -0
  414. package/Sources/RunicCore/Vendored/CostUsage/CostUsageJsonl.swift +74 -0
  415. package/Sources/RunicCore/Vendored/CostUsage/CostUsagePricing.swift +208 -0
  416. package/Sources/RunicCore/Vendored/CostUsage/CostUsageScanner+Claude.swift +455 -0
  417. package/Sources/RunicCore/Vendored/CostUsage/CostUsageScanner+Timestamp.swift +132 -0
  418. package/Sources/RunicCore/Vendored/CostUsage/CostUsageScanner.swift +589 -0
  419. package/Sources/RunicCore/WidgetSnapshot.swift +183 -0
  420. package/Sources/RunicMacroSupport/ProviderRegistrationMacros.swift +14 -0
  421. package/Sources/RunicMacros/ProviderRegistrationMacros.swift +216 -0
  422. package/Sources/RunicWidget/RunicWidgetBundle.swift +79 -0
  423. package/Sources/RunicWidget/RunicWidgetProvider.swift +283 -0
  424. package/Sources/RunicWidget/RunicWidgetViews.swift +680 -0
  425. package/Tests/RunicTests/AntigravityStatusProbeTests.swift +50 -0
  426. package/Tests/RunicTests/AppDelegateTests.swift +43 -0
  427. package/Tests/RunicTests/BrowserCookieOrderLabelTests.swift +22 -0
  428. package/Tests/RunicTests/CLIArgumentParsingTests.swift +70 -0
  429. package/Tests/RunicTests/CLICostTests.swift +65 -0
  430. package/Tests/RunicTests/CLIProviderSelectionTests.swift +22 -0
  431. package/Tests/RunicTests/CLISnapshotTests.swift +72 -0
  432. package/Tests/RunicTests/CLIWebFallbackTests.swift +58 -0
  433. package/Tests/RunicTests/ClaudeOAuthTests.swift +164 -0
  434. package/Tests/RunicTests/ClaudeResilienceTests.swift +30 -0
  435. package/Tests/RunicTests/ClaudeUsageTests.swift +370 -0
  436. package/Tests/RunicTests/CodexOAuthTests.swift +122 -0
  437. package/Tests/RunicTests/CodexUsageLogSourceTests.swift +82 -0
  438. package/Tests/RunicTests/CopilotTokenResolverTests.swift +75 -0
  439. package/Tests/RunicTests/CopilotVSCodeTokenReaderTests.swift +75 -0
  440. package/Tests/RunicTests/CostUsageDecodingTests.swift +394 -0
  441. package/Tests/RunicTests/CostUsagePricingTests.swift +50 -0
  442. package/Tests/RunicTests/CostUsageScannerTests.swift +700 -0
  443. package/Tests/RunicTests/CursorStatusProbeTests.swift +323 -0
  444. package/Tests/RunicTests/FactoryStatusProbeTests.swift +69 -0
  445. package/Tests/RunicTests/GeminiAPITestHelpers.swift +94 -0
  446. package/Tests/RunicTests/GeminiLoginAlertTests.swift +28 -0
  447. package/Tests/RunicTests/GeminiStatusProbeAPITests.swift +283 -0
  448. package/Tests/RunicTests/GeminiStatusProbePlanTests.swift +279 -0
  449. package/Tests/RunicTests/GeminiStatusProbeTests.swift +233 -0
  450. package/Tests/RunicTests/GeminiTestEnvironment.swift +87 -0
  451. package/Tests/RunicTests/GoogleWorkspaceStatusTests.swift +73 -0
  452. package/Tests/RunicTests/InstallOriginTests.swift +18 -0
  453. package/Tests/RunicTests/KeyboardShortcutsBundleTests.swift +9 -0
  454. package/Tests/RunicTests/LiveAccountTests.swift +24 -0
  455. package/Tests/RunicTests/LoadingPatternTests.swift +35 -0
  456. package/Tests/RunicTests/MenuCardModelTests.swift +545 -0
  457. package/Tests/RunicTests/MiniMaxCookieHeaderStoreTestSupport.swift +8 -0
  458. package/Tests/RunicTests/MiniMaxGroupIDStoreTestSupport.swift +8 -0
  459. package/Tests/RunicTests/MiniMaxParsingTests.swift +68 -0
  460. package/Tests/RunicTests/MiniMaxTokenStoreTestSupport.swift +8 -0
  461. package/Tests/RunicTests/OTelGenAILedgerAdapterTests.swift +112 -0
  462. package/Tests/RunicTests/OpenAIDashboardBrowserCookieImporterTests.swift +17 -0
  463. package/Tests/RunicTests/OpenAIDashboardFetcherCreditsWaitTests.swift +75 -0
  464. package/Tests/RunicTests/OpenAIDashboardOffscreenHostTests.swift +27 -0
  465. package/Tests/RunicTests/OpenAIDashboardParserTests.swift +134 -0
  466. package/Tests/RunicTests/OpenAIWebAccountSwitchTests.swift +53 -0
  467. package/Tests/RunicTests/OpenRouterTokenStoreTestSupport.swift +92 -0
  468. package/Tests/RunicTests/PathBuilderTests.swift +237 -0
  469. package/Tests/RunicTests/ProviderFetchPipelineTests.swift +160 -0
  470. package/Tests/RunicTests/ProviderIconResourcesTests.swift +38 -0
  471. package/Tests/RunicTests/ProviderMetadataStatusLinkTests.swift +16 -0
  472. package/Tests/RunicTests/ProviderRegistryTests.swift +29 -0
  473. package/Tests/RunicTests/ProviderSettingsDescriptorTests.swift +202 -0
  474. package/Tests/RunicTests/ProviderToggleStoreTests.swift +51 -0
  475. package/Tests/RunicTests/RunicTests.swift +120 -0
  476. package/Tests/RunicTests/SessionQuotaNotificationLogicTests.swift +36 -0
  477. package/Tests/RunicTests/SettingsStoreTests.swift +161 -0
  478. package/Tests/RunicTests/StatusItemAnimationTests.swift +49 -0
  479. package/Tests/RunicTests/StatusMenuTests.swift +434 -0
  480. package/Tests/RunicTests/StatusProbeTests.swift +377 -0
  481. package/Tests/RunicTests/SubprocessRunnerTests.swift +20 -0
  482. package/Tests/RunicTests/SubscriptionDetectionTests.swift +65 -0
  483. package/Tests/RunicTests/TTYCommandRunnerTests.swift +148 -0
  484. package/Tests/RunicTests/TTYIntegrationTests.swift +41 -0
  485. package/Tests/RunicTests/TeamShowbackExporterTests.swift +159 -0
  486. package/Tests/RunicTests/TextParsingTests.swift +12 -0
  487. package/Tests/RunicTests/UsageFormatterTests.swift +112 -0
  488. package/Tests/RunicTests/UsageLedgerAnomalyDetectionTests.swift +172 -0
  489. package/Tests/RunicTests/UsageLedgerForecastTests.swift +213 -0
  490. package/Tests/RunicTests/UsageLedgerInsightsAdvisorTests.swift +83 -0
  491. package/Tests/RunicTests/UsageLedgerProjectNameTests.swift +170 -0
  492. package/Tests/RunicTests/UsagePaceTests.swift +77 -0
  493. package/Tests/RunicTests/UsagePaceTextTests.swift +109 -0
  494. package/Tests/RunicTests/UsagePolicyEngineTests.swift +91 -0
  495. package/Tests/RunicTests/WidgetSnapshotTests.swift +45 -0
  496. package/Tests/RunicTests/ZaiProviderTests.swift +61 -0
  497. package/Tests/RunicTests/ZaiTokenStoreTestSupport.swift +6 -0
  498. package/TestsLinux/PlatformGatingTests.swift +46 -0
  499. package/appcast.xml +105 -0
  500. package/assets/logo-concept-stack.svg +24 -0
  501. package/assets/logo-minimal-bars.svg +15 -0
  502. package/assets/logo.svg +20 -0
  503. package/assets/logo2.svg +43 -0
  504. package/bin/docs-list +5 -0
  505. package/bin/install-runic-cli.sh +32 -0
  506. package/build-and-run.sh +369 -0
  507. package/docs/.nojekyll +1 -0
  508. package/docs/CNAME +1 -0
  509. package/docs/antigravity.md +75 -0
  510. package/docs/architecture.md +32 -0
  511. package/docs/claude.md +93 -0
  512. package/docs/cli-commands/integration_guide.md +371 -0
  513. package/docs/cli-commands/quick_reference.md +362 -0
  514. package/docs/cli-commands/readme.md +361 -0
  515. package/docs/cli.md +156 -0
  516. package/docs/cloudkit_sync_guide.md +495 -0
  517. package/docs/codebase_review.md +288 -0
  518. package/docs/codex-oauth.md +635 -0
  519. package/docs/codex.md +104 -0
  520. package/docs/codexbar.png +0 -0
  521. package/docs/copilot.md +44 -0
  522. package/docs/cursor.md +46 -0
  523. package/docs/design/designcomparisonchart.md +510 -0
  524. package/docs/design/implementationguide.md +792 -0
  525. package/docs/design/menubaricondesignconcepts.md +796 -0
  526. package/docs/design/mockups/hybridiconconcept.svg +62 -0
  527. package/docs/design/mockups/infinityiconconcept.svg +41 -0
  528. package/docs/design/mockups/infinityiconstates.svg +129 -0
  529. package/docs/design/mockups/wavelogorefined.svg +48 -0
  530. package/docs/design/quick_summary.md +426 -0
  531. package/docs/design/readme.md +478 -0
  532. package/docs/design/sizespecifications.md +575 -0
  533. package/docs/design-system.md +836 -0
  534. package/docs/factory.md +103 -0
  535. package/docs/gemini.md +73 -0
  536. package/docs/icon.md +37 -0
  537. package/docs/icon.png +0 -0
  538. package/docs/index.html +175 -0
  539. package/docs/keychain_fix.md +274 -0
  540. package/docs/minimax.md +71 -0
  541. package/docs/packaging.md +25 -0
  542. package/docs/progress-bar-improvements.md +240 -0
  543. package/docs/progress-bar-quick-reference.md +283 -0
  544. package/docs/progress-bar-technical-details.md +432 -0
  545. package/docs/progress-bar-visual-test.swift +375 -0
  546. package/docs/provider.md +202 -0
  547. package/docs/providers.md +86 -0
  548. package/docs/refactor/macros.md +35 -0
  549. package/docs/refresh-loop.md +22 -0
  550. package/docs/releasing-homebrew.md +35 -0
  551. package/docs/releasing.md +121 -0
  552. package/docs/research/concrete_todo_2026-02-22.md +47 -0
  553. package/docs/research/core-feature-research.md +248 -0
  554. package/docs/research/feature_uiux_roadmap_2026-02-22.md +202 -0
  555. package/docs/research/parity_matrix.md +49 -0
  556. package/docs/research/provider_expansion_candidates_2026-02-22.md +80 -0
  557. package/docs/research/provider_model_token_project_matrix_2026-02-23.md +46 -0
  558. package/docs/research/release_gate_checklist.md +57 -0
  559. package/docs/site.css +505 -0
  560. package/docs/sparkle.md +28 -0
  561. package/docs/status.md +28 -0
  562. package/docs/sync/implementation.md +393 -0
  563. package/docs/sync/readme.md +317 -0
  564. package/docs/sync_files_summary.md +391 -0
  565. package/docs/sync_quick_reference.md +225 -0
  566. package/docs/todo.md +11 -0
  567. package/docs/ui.md +29 -0
  568. package/docs/web-integration.md +9 -0
  569. package/docs/widgets.md +85 -0
  570. package/docs/workflows/error-handling-improvements.md +434 -0
  571. package/docs/workflows/folder_structure.md +299 -0
  572. package/docs/workflows/loading_states.md +446 -0
  573. package/docs/workflows/loading_states_examples.md +565 -0
  574. package/docs/workflows/loading_states_flow.md +430 -0
  575. package/docs/workflows/performance_optimizations.md +457 -0
  576. package/docs/workflows/phase1-cli-testing-report.md +313 -0
  577. package/docs/workflows/quick_reference.md +228 -0
  578. package/docs/workflows/readme.md +59 -0
  579. package/docs/workflows/recent_improvements.md +275 -0
  580. package/docs/workflows/sync_enablement_summary.md +400 -0
  581. package/docs/zai.md +43 -0
  582. package/package.json +36 -0
  583. package/runic.png +0 -0
  584. package/version.env +2 -0
@@ -0,0 +1,455 @@
1
+ import Foundation
2
+
3
+ extension CostUsageScanner {
4
+ // MARK: - Claude
5
+
6
+ private static func defaultClaudeProjectsRoots(options: Options) -> [URL] {
7
+ if let override = options.claudeProjectsRoots { return override }
8
+
9
+ var roots: [URL] = []
10
+
11
+ if let env = ProcessInfo.processInfo.environment["CLAUDE_CONFIG_DIR"]?
12
+ .trimmingCharacters(in: .whitespacesAndNewlines),
13
+ !env.isEmpty
14
+ {
15
+ for part in env.split(separator: ",") {
16
+ let raw = String(part).trimmingCharacters(in: .whitespacesAndNewlines)
17
+ guard !raw.isEmpty else { continue }
18
+ let url = URL(fileURLWithPath: raw)
19
+ if url.lastPathComponent == "projects" {
20
+ roots.append(url)
21
+ } else {
22
+ roots.append(url.appendingPathComponent("projects", isDirectory: true))
23
+ }
24
+ }
25
+ } else {
26
+ let home = FileManager.default.homeDirectoryForCurrentUser
27
+ roots.append(home.appendingPathComponent(".config/claude/projects", isDirectory: true))
28
+ roots.append(home.appendingPathComponent(".claude/projects", isDirectory: true))
29
+ }
30
+
31
+ return roots
32
+ }
33
+
34
+ static func parseClaudeFile(
35
+ fileURL: URL,
36
+ range: CostUsageDayRange,
37
+ startOffset: Int64 = 0) -> ClaudeParseResult
38
+ {
39
+ var days: [String: [String: [Int]]] = [:]
40
+ // Track seen message+request IDs to deduplicate streaming chunks within a JSONL file.
41
+ // Claude emits multiple lines per message with cumulative usage, so we only count once.
42
+ var seenKeys: Set<String> = []
43
+
44
+ struct ClaudeTokens: Sendable {
45
+ let input: Int
46
+ let cacheRead: Int
47
+ let cacheCreate: Int
48
+ let output: Int
49
+ let costNanos: Int
50
+ }
51
+
52
+ func add(dayKey: String, model: String, tokens: ClaudeTokens) {
53
+ guard CostUsageDayRange.isInRange(dayKey: dayKey, since: range.scanSinceKey, until: range.scanUntilKey)
54
+ else { return }
55
+ let normModel = CostUsagePricing.normalizeClaudeModel(model)
56
+ var dayModels = days[dayKey] ?? [:]
57
+ var packed = dayModels[normModel] ?? [0, 0, 0, 0, 0]
58
+ packed[0] = (packed[safe: 0] ?? 0) + tokens.input
59
+ packed[1] = (packed[safe: 1] ?? 0) + tokens.cacheRead
60
+ packed[2] = (packed[safe: 2] ?? 0) + tokens.cacheCreate
61
+ packed[3] = (packed[safe: 3] ?? 0) + tokens.output
62
+ packed[4] = (packed[safe: 4] ?? 0) + tokens.costNanos
63
+ dayModels[normModel] = packed
64
+ days[dayKey] = dayModels
65
+ }
66
+
67
+ let maxLineBytes = 512 * 1024
68
+ // Keep the full line so usage at the tail isn't dropped on large tool outputs.
69
+ let prefixBytes = maxLineBytes
70
+ let costScale = 1_000_000_000.0
71
+
72
+ let parsedBytes = (try? CostUsageJsonl.scan(
73
+ fileURL: fileURL,
74
+ offset: startOffset,
75
+ maxLineBytes: maxLineBytes,
76
+ prefixBytes: prefixBytes,
77
+ onLine: { line in
78
+ guard !line.bytes.isEmpty else { return }
79
+ guard !line.wasTruncated else { return }
80
+ guard line.bytes.containsAscii(#""type":"assistant""#) else { return }
81
+ guard line.bytes.containsAscii(#""usage""#) else { return }
82
+
83
+ guard
84
+ let obj = (try? JSONSerialization.jsonObject(with: line.bytes)) as? [String: Any],
85
+ let type = obj["type"] as? String,
86
+ type == "assistant"
87
+ else { return }
88
+
89
+ guard let tsText = obj["timestamp"] as? String else { return }
90
+ guard let dayKey = Self.dayKeyFromTimestamp(tsText) ?? Self.dayKeyFromParsedISO(tsText) else { return }
91
+
92
+ guard let message = obj["message"] as? [String: Any] else { return }
93
+ guard let model = message["model"] as? String else { return }
94
+ guard let usage = message["usage"] as? [String: Any] else { return }
95
+
96
+ // Deduplicate by message.id + requestId (streaming chunks have same usage).
97
+ let messageId = message["id"] as? String
98
+ let requestId = obj["requestId"] as? String
99
+ if let messageId, let requestId {
100
+ let key = "\(messageId):\(requestId)"
101
+ if seenKeys.contains(key) { return }
102
+ seenKeys.insert(key)
103
+ } else {
104
+ // Older logs omit IDs; treat each line as distinct to avoid dropping usage.
105
+ }
106
+
107
+ func toInt(_ v: Any?) -> Int {
108
+ if let n = v as? NSNumber { return n.intValue }
109
+ return 0
110
+ }
111
+
112
+ let input = max(0, toInt(usage["input_tokens"]))
113
+ let cacheCreate = max(0, toInt(usage["cache_creation_input_tokens"]))
114
+ let cacheRead = max(0, toInt(usage["cache_read_input_tokens"]))
115
+ let output = max(0, toInt(usage["output_tokens"]))
116
+ if input == 0, cacheCreate == 0, cacheRead == 0, output == 0 { return }
117
+
118
+ let cost = CostUsagePricing.claudeCostUSD(
119
+ model: model,
120
+ inputTokens: input,
121
+ cacheReadInputTokens: cacheRead,
122
+ cacheCreationInputTokens: cacheCreate,
123
+ outputTokens: output)
124
+ let costNanos = cost.map { Int(($0 * costScale).rounded()) } ?? 0
125
+ let tokens = ClaudeTokens(
126
+ input: input,
127
+ cacheRead: cacheRead,
128
+ cacheCreate: cacheCreate,
129
+ output: output,
130
+ costNanos: costNanos)
131
+ add(dayKey: dayKey, model: model, tokens: tokens)
132
+ })) ?? startOffset
133
+
134
+ return ClaudeParseResult(days: days, parsedBytes: parsedBytes)
135
+ }
136
+
137
+ private static func claudeRootCandidates(for rootPath: String) -> [String] {
138
+ if rootPath.hasPrefix("/var/") {
139
+ return ["/private" + rootPath, rootPath]
140
+ }
141
+ if rootPath.hasPrefix("/private/var/") {
142
+ let trimmed = String(rootPath.dropFirst("/private".count))
143
+ return [rootPath, trimmed]
144
+ }
145
+ return [rootPath]
146
+ }
147
+
148
+ private final class ClaudeScanState {
149
+ var cache: CostUsageCache
150
+ var rootCache: [String: Int64]
151
+ var touched: Set<String>
152
+
153
+ init(cache: CostUsageCache) {
154
+ self.cache = cache
155
+ self.rootCache = cache.roots ?? [:]
156
+ self.touched = []
157
+ }
158
+ }
159
+
160
+ private static func processClaudeFile(
161
+ url: URL,
162
+ size: Int64,
163
+ mtimeMs: Int64,
164
+ range: CostUsageDayRange,
165
+ state: ClaudeScanState)
166
+ {
167
+ let path = url.path
168
+ state.touched.insert(path)
169
+
170
+ if let cached = state.cache.files[path],
171
+ cached.mtimeUnixMs == mtimeMs,
172
+ cached.size == size
173
+ {
174
+ return
175
+ }
176
+
177
+ if let cached = state.cache.files[path] {
178
+ let startOffset = cached.parsedBytes ?? cached.size
179
+ let canIncremental = size > cached.size && startOffset > 0 && startOffset <= size
180
+ if canIncremental {
181
+ let delta = Self.parseClaudeFile(
182
+ fileURL: url,
183
+ range: range,
184
+ startOffset: startOffset)
185
+ if !delta.days.isEmpty {
186
+ Self.applyFileDays(cache: &state.cache, fileDays: delta.days, sign: 1)
187
+ }
188
+
189
+ var mergedDays = cached.days
190
+ Self.mergeFileDays(existing: &mergedDays, delta: delta.days)
191
+ state.cache.files[path] = Self.makeFileUsage(
192
+ mtimeUnixMs: mtimeMs,
193
+ size: size,
194
+ days: mergedDays,
195
+ parsedBytes: delta.parsedBytes)
196
+ return
197
+ }
198
+
199
+ Self.applyFileDays(cache: &state.cache, fileDays: cached.days, sign: -1)
200
+ }
201
+
202
+ let parsed = Self.parseClaudeFile(fileURL: url, range: range)
203
+ let usage = Self.makeFileUsage(
204
+ mtimeUnixMs: mtimeMs,
205
+ size: size,
206
+ days: parsed.days,
207
+ parsedBytes: parsed.parsedBytes)
208
+ state.cache.files[path] = usage
209
+ Self.applyFileDays(cache: &state.cache, fileDays: usage.days, sign: 1)
210
+ }
211
+
212
+ private static func scanClaudeRoot(
213
+ root: URL,
214
+ range: CostUsageDayRange,
215
+ state: ClaudeScanState)
216
+ {
217
+ let rootPath = root.path
218
+ let rootCandidates = Self.claudeRootCandidates(for: rootPath)
219
+ let prefixes = Set(rootCandidates).map { path in
220
+ path.hasSuffix("/") ? path : "\(path)/"
221
+ }
222
+ let rootExists = rootCandidates.contains { FileManager.default.fileExists(atPath: $0) }
223
+ let canonicalRootPath = rootCandidates.first(where: {
224
+ FileManager.default.fileExists(atPath: $0)
225
+ }) ?? rootPath
226
+
227
+ guard rootExists else {
228
+ let stale = state.cache.files.keys.filter { path in
229
+ prefixes.contains(where: { path.hasPrefix($0) })
230
+ }
231
+ for path in stale {
232
+ if let old = state.cache.files[path] {
233
+ Self.applyFileDays(cache: &state.cache, fileDays: old.days, sign: -1)
234
+ }
235
+ state.cache.files.removeValue(forKey: path)
236
+ }
237
+ for candidate in rootCandidates {
238
+ state.rootCache.removeValue(forKey: candidate)
239
+ }
240
+ return
241
+ }
242
+
243
+ let rootAttrs = (try? FileManager.default.attributesOfItem(atPath: canonicalRootPath)) ?? [:]
244
+ let rootMtime = (rootAttrs[.modificationDate] as? Date)?.timeIntervalSince1970 ?? 0
245
+ let rootMtimeMs = Int64(rootMtime * 1000)
246
+ let cachedRootMtime = rootCandidates.compactMap { state.rootCache[$0] }.first
247
+ let canSkipEnumeration = cachedRootMtime == rootMtimeMs && rootMtimeMs > 0
248
+
249
+ if canSkipEnumeration {
250
+ let cachedPaths = state.cache.files.keys.filter { path in
251
+ prefixes.contains(where: { path.hasPrefix($0) })
252
+ }
253
+ for path in cachedPaths {
254
+ guard FileManager.default.fileExists(atPath: path) else {
255
+ if let old = state.cache.files[path] {
256
+ Self.applyFileDays(cache: &state.cache, fileDays: old.days, sign: -1)
257
+ }
258
+ state.cache.files.removeValue(forKey: path)
259
+ continue
260
+ }
261
+ let attrs = (try? FileManager.default.attributesOfItem(atPath: path)) ?? [:]
262
+ let size = (attrs[.size] as? NSNumber)?.int64Value ?? 0
263
+ if size <= 0 { continue }
264
+ let mtime = (attrs[.modificationDate] as? Date)?.timeIntervalSince1970 ?? 0
265
+ let mtimeMs = Int64(mtime * 1000)
266
+ Self.processClaudeFile(
267
+ url: URL(fileURLWithPath: path),
268
+ size: size,
269
+ mtimeMs: mtimeMs,
270
+ range: range,
271
+ state: state)
272
+ }
273
+ return
274
+ }
275
+
276
+ let keys: [URLResourceKey] = [
277
+ .isRegularFileKey,
278
+ .contentModificationDateKey,
279
+ .fileSizeKey,
280
+ ]
281
+
282
+ guard let enumerator = FileManager.default.enumerator(
283
+ at: root,
284
+ includingPropertiesForKeys: keys,
285
+ options: [.skipsHiddenFiles, .skipsPackageDescendants])
286
+ else { return }
287
+
288
+ for case let url as URL in enumerator {
289
+ guard url.pathExtension.lowercased() == "jsonl" else { continue }
290
+ guard let values = try? url.resourceValues(forKeys: Set(keys)) else { continue }
291
+ guard values.isRegularFile == true else { continue }
292
+ let size = Int64(values.fileSize ?? 0)
293
+ if size <= 0 { continue }
294
+
295
+ let mtime = values.contentModificationDate?.timeIntervalSince1970 ?? 0
296
+ let mtimeMs = Int64(mtime * 1000)
297
+ Self.processClaudeFile(
298
+ url: url,
299
+ size: size,
300
+ mtimeMs: mtimeMs,
301
+ range: range,
302
+ state: state)
303
+ }
304
+
305
+ if rootMtimeMs > 0 {
306
+ state.rootCache[canonicalRootPath] = rootMtimeMs
307
+ for candidate in rootCandidates where candidate != canonicalRootPath {
308
+ state.rootCache.removeValue(forKey: candidate)
309
+ }
310
+ }
311
+ }
312
+
313
+ static func loadClaudeDaily(range: CostUsageDayRange, now: Date, options: Options) -> CostUsageDailyReport {
314
+ var cache = CostUsageCacheIO.load(provider: .claude, cacheRoot: options.cacheRoot)
315
+ let nowMs = Int64(now.timeIntervalSince1970 * 1000)
316
+
317
+ let refreshMs = Int64(max(0, options.refreshMinIntervalSeconds) * 1000)
318
+ let shouldRefresh = refreshMs == 0 || cache.lastScanUnixMs == 0 || nowMs - cache.lastScanUnixMs > refreshMs
319
+
320
+ let roots = self.defaultClaudeProjectsRoots(options: options)
321
+
322
+ var touched: Set<String> = []
323
+
324
+ if shouldRefresh {
325
+ if options.forceRescan {
326
+ cache = CostUsageCache()
327
+ }
328
+ let scanState = ClaudeScanState(cache: cache)
329
+
330
+ for root in roots {
331
+ Self.scanClaudeRoot(
332
+ root: root,
333
+ range: range,
334
+ state: scanState)
335
+ }
336
+
337
+ cache = scanState.cache
338
+ touched = scanState.touched
339
+ cache.roots = scanState.rootCache.isEmpty ? nil : scanState.rootCache
340
+
341
+ for key in cache.files.keys where !touched.contains(key) {
342
+ if let old = cache.files[key] {
343
+ Self.applyFileDays(cache: &cache, fileDays: old.days, sign: -1)
344
+ }
345
+ cache.files.removeValue(forKey: key)
346
+ }
347
+
348
+ Self.pruneDays(cache: &cache, sinceKey: range.scanSinceKey, untilKey: range.scanUntilKey)
349
+ cache.lastScanUnixMs = nowMs
350
+ CostUsageCacheIO.save(provider: .claude, cache: cache, cacheRoot: options.cacheRoot)
351
+ }
352
+
353
+ return Self.buildClaudeReportFromCache(cache: cache, range: range)
354
+ }
355
+
356
+ private static func buildClaudeReportFromCache(
357
+ cache: CostUsageCache,
358
+ range: CostUsageDayRange) -> CostUsageDailyReport
359
+ {
360
+ var entries: [CostUsageDailyReport.Entry] = []
361
+ var totalInput = 0
362
+ var totalOutput = 0
363
+ var totalCacheRead = 0
364
+ var totalCacheCreate = 0
365
+ var totalTokens = 0
366
+ var totalCost: Double = 0
367
+ var costSeen = false
368
+ let costScale = 1_000_000_000.0
369
+
370
+ let dayKeys = cache.days.keys.sorted().filter {
371
+ CostUsageDayRange.isInRange(dayKey: $0, since: range.sinceKey, until: range.untilKey)
372
+ }
373
+
374
+ for day in dayKeys {
375
+ guard let models = cache.days[day] else { continue }
376
+ let modelNames = models.keys.sorted()
377
+
378
+ var dayInput = 0
379
+ var dayOutput = 0
380
+ var dayCacheRead = 0
381
+ var dayCacheCreate = 0
382
+
383
+ var breakdown: [CostUsageDailyReport.ModelBreakdown] = []
384
+ var dayCost: Double = 0
385
+ var dayCostSeen = false
386
+
387
+ for model in modelNames {
388
+ let packed = models[model] ?? [0, 0, 0, 0]
389
+ let input = packed[safe: 0] ?? 0
390
+ let cacheRead = packed[safe: 1] ?? 0
391
+ let cacheCreate = packed[safe: 2] ?? 0
392
+ let output = packed[safe: 3] ?? 0
393
+ let cachedCost = packed[safe: 4] ?? 0
394
+
395
+ // Cache tokens are tracked separately; totalTokens includes input + cache.
396
+ dayInput += input
397
+ dayCacheRead += cacheRead
398
+ dayCacheCreate += cacheCreate
399
+ dayOutput += output
400
+
401
+ let cost = cachedCost > 0
402
+ ? Double(cachedCost) / costScale
403
+ : CostUsagePricing.claudeCostUSD(
404
+ model: model,
405
+ inputTokens: input,
406
+ cacheReadInputTokens: cacheRead,
407
+ cacheCreationInputTokens: cacheCreate,
408
+ outputTokens: output)
409
+ breakdown.append(CostUsageDailyReport.ModelBreakdown(modelName: model, costUSD: cost))
410
+ if let cost {
411
+ dayCost += cost
412
+ dayCostSeen = true
413
+ }
414
+ }
415
+
416
+ breakdown.sort { lhs, rhs in (rhs.costUSD ?? -1) < (lhs.costUSD ?? -1) }
417
+ let top = Array(breakdown.prefix(3))
418
+
419
+ let dayTotal = dayInput + dayCacheRead + dayCacheCreate + dayOutput
420
+ let entryCost = dayCostSeen ? dayCost : nil
421
+ entries.append(CostUsageDailyReport.Entry(
422
+ date: day,
423
+ inputTokens: dayInput,
424
+ outputTokens: dayOutput,
425
+ cacheReadTokens: dayCacheRead,
426
+ cacheCreationTokens: dayCacheCreate,
427
+ totalTokens: dayTotal,
428
+ costUSD: entryCost,
429
+ modelsUsed: modelNames,
430
+ modelBreakdowns: top))
431
+
432
+ totalInput += dayInput
433
+ totalOutput += dayOutput
434
+ totalCacheRead += dayCacheRead
435
+ totalCacheCreate += dayCacheCreate
436
+ totalTokens += dayTotal
437
+ if let entryCost {
438
+ totalCost += entryCost
439
+ costSeen = true
440
+ }
441
+ }
442
+
443
+ let summary: CostUsageDailyReport.Summary? = entries.isEmpty
444
+ ? nil
445
+ : CostUsageDailyReport.Summary(
446
+ totalInputTokens: totalInput,
447
+ totalOutputTokens: totalOutput,
448
+ cacheReadTokens: totalCacheRead,
449
+ cacheCreationTokens: totalCacheCreate,
450
+ totalTokens: totalTokens,
451
+ totalCostUSD: costSeen ? totalCost : nil)
452
+
453
+ return CostUsageDailyReport(data: entries, summary: summary)
454
+ }
455
+ }
@@ -0,0 +1,132 @@
1
+ import Foundation
2
+
3
+ private final class CostUsageISO8601FormatterBox: @unchecked Sendable {
4
+ let lock = NSLock()
5
+ let withFractional: ISO8601DateFormatter = {
6
+ let fmt = ISO8601DateFormatter()
7
+ fmt.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
8
+ return fmt
9
+ }()
10
+
11
+ let plain: ISO8601DateFormatter = {
12
+ let fmt = ISO8601DateFormatter()
13
+ fmt.formatOptions = [.withInternetDateTime]
14
+ return fmt
15
+ }()
16
+ }
17
+
18
+ private enum CostUsageTimestampParser {
19
+ static let box = CostUsageISO8601FormatterBox()
20
+
21
+ static func parseISO(_ text: String) -> Date? {
22
+ self.box.lock.lock()
23
+ defer { self.box.lock.unlock() }
24
+ return self.box.withFractional.date(from: text) ?? self.box.plain.date(from: text)
25
+ }
26
+ }
27
+
28
+ extension CostUsageScanner {
29
+ static func dayKeyFromTimestamp(_ text: String) -> String? {
30
+ let bytes = Array(text.utf8)
31
+ guard bytes.count >= 20 else { return nil }
32
+ guard bytes[safe: 4] == 45, bytes[safe: 7] == 45 else { return nil }
33
+ guard let year = Self.parse4(bytes, at: 0),
34
+ let month = Self.parse2(bytes, at: 5),
35
+ let day = Self.parse2(bytes, at: 8) else { return nil }
36
+
37
+ var hour = 0
38
+ var minute = 0
39
+ var second = 0
40
+
41
+ if bytes[safe: 10] == 84 {
42
+ guard bytes.count >= 19 else { return nil }
43
+ guard bytes[safe: 13] == 58, bytes[safe: 16] == 58 else { return nil }
44
+ guard let parsedHour = Self.parse2(bytes, at: 11),
45
+ let parsedMinute = Self.parse2(bytes, at: 14),
46
+ let parsedSecond = Self.parse2(bytes, at: 17) else { return nil }
47
+ hour = parsedHour
48
+ minute = parsedMinute
49
+ second = parsedSecond
50
+ }
51
+
52
+ var tzIndex: Int?
53
+ var tzSign = 0
54
+ for idx in stride(from: bytes.count - 1, through: 11, by: -1) {
55
+ let byte = bytes[idx]
56
+ if byte == 90 {
57
+ tzIndex = idx
58
+ tzSign = 0
59
+ break
60
+ }
61
+ if byte == 43 {
62
+ tzIndex = idx
63
+ tzSign = 1
64
+ break
65
+ }
66
+ if byte == 45 {
67
+ tzIndex = idx
68
+ tzSign = -1
69
+ break
70
+ }
71
+ }
72
+
73
+ guard let tzStart = tzIndex else { return nil }
74
+ var offsetSeconds = 0
75
+ if tzSign != 0 {
76
+ let offsetStart = tzStart + 1
77
+ guard let hours = Self.parse2(bytes, at: offsetStart) else { return nil }
78
+ var minutes = 0
79
+ if bytes.count > offsetStart + 2 {
80
+ if bytes[safe: offsetStart + 2] == 58 {
81
+ guard let parsedMinutes = Self.parse2(bytes, at: offsetStart + 3) else { return nil }
82
+ minutes = parsedMinutes
83
+ } else if let parsedMinutes = Self.parse2(bytes, at: offsetStart + 2) {
84
+ minutes = parsedMinutes
85
+ }
86
+ }
87
+ offsetSeconds = tzSign * ((hours * 3600) + (minutes * 60))
88
+ }
89
+
90
+ var comps = DateComponents()
91
+ comps.calendar = Calendar(identifier: .gregorian)
92
+ comps.timeZone = TimeZone(secondsFromGMT: offsetSeconds)
93
+ comps.year = year
94
+ comps.month = month
95
+ comps.day = day
96
+ comps.hour = hour
97
+ comps.minute = minute
98
+ comps.second = second
99
+
100
+ guard let date = comps.date else { return nil }
101
+ let local = Calendar.current.dateComponents([.year, .month, .day], from: date)
102
+ guard let localYear = local.year,
103
+ let localMonth = local.month,
104
+ let localDay = local.day else { return nil }
105
+ return String(format: "%04d-%02d-%02d", localYear, localMonth, localDay)
106
+ }
107
+
108
+ static func dayKeyFromParsedISO(_ text: String) -> String? {
109
+ guard let date = CostUsageTimestampParser.parseISO(text) else { return nil }
110
+ return CostUsageDayRange.dayKey(from: date)
111
+ }
112
+
113
+ private static func parse2(_ bytes: [UInt8], at index: Int) -> Int? {
114
+ guard let d0 = parseDigit(bytes[safe: index]),
115
+ let d1 = parseDigit(bytes[safe: index + 1]) else { return nil }
116
+ return d0 * 10 + d1
117
+ }
118
+
119
+ private static func parse4(_ bytes: [UInt8], at index: Int) -> Int? {
120
+ guard let d0 = parseDigit(bytes[safe: index]),
121
+ let d1 = parseDigit(bytes[safe: index + 1]),
122
+ let d2 = parseDigit(bytes[safe: index + 2]),
123
+ let d3 = parseDigit(bytes[safe: index + 3]) else { return nil }
124
+ return d0 * 1000 + d1 * 100 + d2 * 10 + d3
125
+ }
126
+
127
+ private static func parseDigit(_ byte: UInt8?) -> Int? {
128
+ guard let byte else { return nil }
129
+ guard byte >= 48, byte <= 57 else { return nil }
130
+ return Int(byte - 48)
131
+ }
132
+ }