@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,409 @@
1
+ import Foundation
2
+ import SQLite3
3
+
4
+ /// Storage layer for performance metrics using SQLite
5
+ public final class PerformanceStorageImpl {
6
+
7
+ // MARK: - Properties
8
+
9
+ private var db: OpaquePointer?
10
+ private let dbPath: URL
11
+
12
+ // MARK: - Initialization
13
+
14
+ public init() {
15
+ let appSupport = FileManager.default.urls(
16
+ for: .applicationSupportDirectory,
17
+ in: .userDomainMask
18
+ ).first!
19
+ let runicDir = appSupport.appendingPathComponent("Runic")
20
+
21
+ // Ensure directory exists
22
+ try? FileManager.default.createDirectory(at: runicDir, withIntermediateDirectories: true)
23
+
24
+ self.dbPath = runicDir.appendingPathComponent("performance.db")
25
+ }
26
+
27
+ deinit {
28
+ if let db = db {
29
+ sqlite3_close(db)
30
+ }
31
+ }
32
+
33
+ // MARK: - Database Connection
34
+
35
+ private func open() throws {
36
+ guard db == nil else { return }
37
+
38
+ let flags = SQLITE_OPEN_CREATE | SQLITE_OPEN_READWRITE | SQLITE_OPEN_FULLMUTEX
39
+ let result = sqlite3_open_v2(dbPath.path, &db, flags, nil)
40
+
41
+ guard result == SQLITE_OK else {
42
+ throw StorageError.openFailed(message: String(cString: sqlite3_errmsg(db)))
43
+ }
44
+
45
+ try createTablesIfNeeded()
46
+ }
47
+
48
+ private func close() {
49
+ if let db = db {
50
+ sqlite3_close(db)
51
+ self.db = nil
52
+ }
53
+ }
54
+
55
+ // MARK: - Schema Creation
56
+
57
+ private func createTablesIfNeeded() throws {
58
+ let schemas = [
59
+ """
60
+ CREATE TABLE IF NOT EXISTS latency_metrics (
61
+ id TEXT PRIMARY KEY,
62
+ request_id TEXT NOT NULL,
63
+ provider TEXT NOT NULL,
64
+ model TEXT,
65
+ start_time REAL NOT NULL,
66
+ end_time REAL NOT NULL,
67
+ duration_ms INTEGER NOT NULL,
68
+ success INTEGER NOT NULL,
69
+ created_at REAL NOT NULL
70
+ )
71
+ """,
72
+ """
73
+ CREATE TABLE IF NOT EXISTS quality_ratings (
74
+ id TEXT PRIMARY KEY,
75
+ request_id TEXT NOT NULL,
76
+ provider TEXT NOT NULL,
77
+ model TEXT,
78
+ rating INTEGER NOT NULL,
79
+ comment TEXT,
80
+ timestamp REAL NOT NULL
81
+ )
82
+ """,
83
+ """
84
+ CREATE TABLE IF NOT EXISTS error_events (
85
+ id TEXT PRIMARY KEY,
86
+ provider TEXT NOT NULL,
87
+ error_type TEXT NOT NULL,
88
+ error_message TEXT,
89
+ retry_count INTEGER NOT NULL,
90
+ timestamp REAL NOT NULL
91
+ )
92
+ """,
93
+ """
94
+ CREATE TABLE IF NOT EXISTS daily_stats (
95
+ provider TEXT NOT NULL,
96
+ model TEXT,
97
+ date TEXT NOT NULL,
98
+ total_requests INTEGER NOT NULL,
99
+ avg_latency_ms INTEGER NOT NULL,
100
+ p50_latency_ms INTEGER NOT NULL,
101
+ p95_latency_ms INTEGER NOT NULL,
102
+ p99_latency_ms INTEGER NOT NULL,
103
+ avg_quality_rating REAL NOT NULL,
104
+ total_ratings INTEGER NOT NULL,
105
+ rating_1_count INTEGER NOT NULL,
106
+ rating_2_count INTEGER NOT NULL,
107
+ rating_3_count INTEGER NOT NULL,
108
+ rating_4_count INTEGER NOT NULL,
109
+ rating_5_count INTEGER NOT NULL,
110
+ error_count INTEGER NOT NULL,
111
+ error_rate REAL NOT NULL,
112
+ timeout_count INTEGER NOT NULL,
113
+ quota_count INTEGER NOT NULL,
114
+ network_count INTEGER NOT NULL,
115
+ api_error_count INTEGER NOT NULL,
116
+ created_at REAL NOT NULL,
117
+ PRIMARY KEY (provider, model, date)
118
+ )
119
+ """,
120
+ "CREATE INDEX IF NOT EXISTS idx_latency_created ON latency_metrics(created_at)",
121
+ "CREATE INDEX IF NOT EXISTS idx_quality_timestamp ON quality_ratings(timestamp)",
122
+ "CREATE INDEX IF NOT EXISTS idx_error_timestamp ON error_events(timestamp)",
123
+ "CREATE INDEX IF NOT EXISTS idx_daily_stats_date ON daily_stats(date)"
124
+ ]
125
+
126
+ for schema in schemas {
127
+ try execute(schema)
128
+ }
129
+ }
130
+
131
+ // MARK: - Execute SQL
132
+
133
+ private func execute(_ sql: String) throws {
134
+ guard let db = db else {
135
+ throw StorageError.notOpen
136
+ }
137
+
138
+ var errorMessage: UnsafeMutablePointer<CChar>?
139
+ let result = sqlite3_exec(db, sql, nil, nil, &errorMessage)
140
+
141
+ if result != SQLITE_OK {
142
+ let message = errorMessage.map { String(cString: $0) } ?? "Unknown error"
143
+ sqlite3_free(errorMessage)
144
+ throw StorageError.executionFailed(message: message)
145
+ }
146
+ }
147
+
148
+ // MARK: - Save Metrics
149
+
150
+ public func save(latency: LatencyMetric) async throws {
151
+ try open()
152
+
153
+ let sql = """
154
+ INSERT OR REPLACE INTO latency_metrics
155
+ (id, request_id, provider, model, start_time, end_time, duration_ms, success, created_at)
156
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
157
+ """
158
+
159
+ var statement: OpaquePointer?
160
+ defer { sqlite3_finalize(statement) }
161
+
162
+ guard sqlite3_prepare_v2(db, sql, -1, &statement, nil) == SQLITE_OK else {
163
+ throw StorageError.prepareFailed(message: String(cString: sqlite3_errmsg(db)))
164
+ }
165
+
166
+ sqlite3_bind_text(statement, 1, latency.id, -1, unsafeBitCast(-1, to: sqlite3_destructor_type.self))
167
+ sqlite3_bind_text(statement, 2, latency.requestID, -1, unsafeBitCast(-1, to: sqlite3_destructor_type.self))
168
+ sqlite3_bind_text(statement, 3, latency.provider.rawValue, -1, unsafeBitCast(-1, to: sqlite3_destructor_type.self))
169
+
170
+ if let model = latency.model {
171
+ sqlite3_bind_text(statement, 4, model, -1, unsafeBitCast(-1, to: sqlite3_destructor_type.self))
172
+ } else {
173
+ sqlite3_bind_null(statement, 4)
174
+ }
175
+
176
+ sqlite3_bind_double(statement, 5, latency.startTime.timeIntervalSince1970)
177
+ sqlite3_bind_double(statement, 6, latency.endTime.timeIntervalSince1970)
178
+ sqlite3_bind_int(statement, 7, Int32(latency.durationMs))
179
+ sqlite3_bind_int(statement, 8, latency.success ? 1 : 0)
180
+ sqlite3_bind_double(statement, 9, latency.createdAt.timeIntervalSince1970)
181
+
182
+ guard sqlite3_step(statement) == SQLITE_DONE else {
183
+ throw StorageError.insertFailed(message: String(cString: sqlite3_errmsg(db)))
184
+ }
185
+ }
186
+
187
+ public func save(rating: QualityRating) async throws {
188
+ try open()
189
+
190
+ let sql = """
191
+ INSERT OR REPLACE INTO quality_ratings
192
+ (id, request_id, provider, model, rating, comment, timestamp)
193
+ VALUES (?, ?, ?, ?, ?, ?, ?)
194
+ """
195
+
196
+ var statement: OpaquePointer?
197
+ defer { sqlite3_finalize(statement) }
198
+
199
+ guard sqlite3_prepare_v2(db, sql, -1, &statement, nil) == SQLITE_OK else {
200
+ throw StorageError.prepareFailed(message: String(cString: sqlite3_errmsg(db)))
201
+ }
202
+
203
+ sqlite3_bind_text(statement, 1, rating.id, -1, unsafeBitCast(-1, to: sqlite3_destructor_type.self))
204
+ sqlite3_bind_text(statement, 2, rating.requestID, -1, unsafeBitCast(-1, to: sqlite3_destructor_type.self))
205
+ sqlite3_bind_text(statement, 3, rating.provider.rawValue, -1, unsafeBitCast(-1, to: sqlite3_destructor_type.self))
206
+
207
+ if let model = rating.model {
208
+ sqlite3_bind_text(statement, 4, model, -1, unsafeBitCast(-1, to: sqlite3_destructor_type.self))
209
+ } else {
210
+ sqlite3_bind_null(statement, 4)
211
+ }
212
+
213
+ sqlite3_bind_int(statement, 5, Int32(rating.rating))
214
+
215
+ if let comment = rating.comment {
216
+ sqlite3_bind_text(statement, 6, comment, -1, unsafeBitCast(-1, to: sqlite3_destructor_type.self))
217
+ } else {
218
+ sqlite3_bind_null(statement, 6)
219
+ }
220
+
221
+ sqlite3_bind_double(statement, 7, rating.timestamp.timeIntervalSince1970)
222
+
223
+ guard sqlite3_step(statement) == SQLITE_DONE else {
224
+ throw StorageError.insertFailed(message: String(cString: sqlite3_errmsg(db)))
225
+ }
226
+ }
227
+
228
+ public func save(error: ErrorEvent) async throws {
229
+ try open()
230
+
231
+ let sql = """
232
+ INSERT OR REPLACE INTO error_events
233
+ (id, provider, error_type, error_message, retry_count, timestamp)
234
+ VALUES (?, ?, ?, ?, ?, ?)
235
+ """
236
+
237
+ var statement: OpaquePointer?
238
+ defer { sqlite3_finalize(statement) }
239
+
240
+ guard sqlite3_prepare_v2(db, sql, -1, &statement, nil) == SQLITE_OK else {
241
+ throw StorageError.prepareFailed(message: String(cString: sqlite3_errmsg(db)))
242
+ }
243
+
244
+ sqlite3_bind_text(statement, 1, error.id, -1, unsafeBitCast(-1, to: sqlite3_destructor_type.self))
245
+ sqlite3_bind_text(statement, 2, error.provider.rawValue, -1, unsafeBitCast(-1, to: sqlite3_destructor_type.self))
246
+ sqlite3_bind_text(statement, 3, error.errorType.rawValue, -1, unsafeBitCast(-1, to: sqlite3_destructor_type.self))
247
+
248
+ if let message = error.errorMessage {
249
+ sqlite3_bind_text(statement, 4, message, -1, unsafeBitCast(-1, to: sqlite3_destructor_type.self))
250
+ } else {
251
+ sqlite3_bind_null(statement, 4)
252
+ }
253
+
254
+ sqlite3_bind_int(statement, 5, Int32(error.retryCount))
255
+ sqlite3_bind_double(statement, 6, error.timestamp.timeIntervalSince1970)
256
+
257
+ guard sqlite3_step(statement) == SQLITE_DONE else {
258
+ throw StorageError.insertFailed(message: String(cString: sqlite3_errmsg(db)))
259
+ }
260
+ }
261
+
262
+ // MARK: - Fetch Daily Stats
263
+
264
+ public func fetchDailyStats(
265
+ timeRange: Int,
266
+ provider: UsageProvider? = nil,
267
+ model: String? = nil
268
+ ) async throws -> [DailyPerformanceStats] {
269
+ try open()
270
+
271
+ var sql = "SELECT * FROM daily_stats WHERE date >= date('now', '-\(timeRange) days')"
272
+
273
+ if let provider = provider {
274
+ sql += " AND provider = '\(provider.rawValue)'"
275
+ }
276
+
277
+ if let model = model {
278
+ sql += " AND model = '\(model)'"
279
+ }
280
+
281
+ sql += " ORDER BY date DESC"
282
+
283
+ var statement: OpaquePointer?
284
+ defer { sqlite3_finalize(statement) }
285
+
286
+ guard sqlite3_prepare_v2(db, sql, -1, &statement, nil) == SQLITE_OK else {
287
+ throw StorageError.prepareFailed(message: String(cString: sqlite3_errmsg(db)))
288
+ }
289
+
290
+ var stats: [DailyPerformanceStats] = []
291
+
292
+ while sqlite3_step(statement) == SQLITE_ROW {
293
+ let provider = String(cString: sqlite3_column_text(statement, 0))
294
+ let model = sqlite3_column_type(statement, 1) == SQLITE_NULL
295
+ ? nil
296
+ : String(cString: sqlite3_column_text(statement, 1))
297
+ let date = String(cString: sqlite3_column_text(statement, 2))
298
+ let totalRequests = Int(sqlite3_column_int(statement, 3))
299
+ let avgLatencyMs = Int(sqlite3_column_int(statement, 4))
300
+ let p50LatencyMs = Int(sqlite3_column_int(statement, 5))
301
+ let p95LatencyMs = Int(sqlite3_column_int(statement, 6))
302
+ let p99LatencyMs = Int(sqlite3_column_int(statement, 7))
303
+ let avgQualityRating = sqlite3_column_double(statement, 8)
304
+ let totalRatings = Int(sqlite3_column_int(statement, 9))
305
+ let rating1Count = Int(sqlite3_column_int(statement, 10))
306
+ let rating2Count = Int(sqlite3_column_int(statement, 11))
307
+ let rating3Count = Int(sqlite3_column_int(statement, 12))
308
+ let rating4Count = Int(sqlite3_column_int(statement, 13))
309
+ let rating5Count = Int(sqlite3_column_int(statement, 14))
310
+ let errorCount = Int(sqlite3_column_int(statement, 15))
311
+ let errorRate = sqlite3_column_double(statement, 16)
312
+ let timeoutCount = Int(sqlite3_column_int(statement, 17))
313
+ let quotaCount = Int(sqlite3_column_int(statement, 18))
314
+ let networkCount = Int(sqlite3_column_int(statement, 19))
315
+ let apiErrorCount = Int(sqlite3_column_int(statement, 20))
316
+ let createdAt = Date(timeIntervalSince1970: sqlite3_column_double(statement, 21))
317
+
318
+ let stat = DailyPerformanceStats(
319
+ provider: provider,
320
+ model: model,
321
+ date: date,
322
+ totalRequests: totalRequests,
323
+ avgLatencyMs: avgLatencyMs,
324
+ p50LatencyMs: p50LatencyMs,
325
+ p95LatencyMs: p95LatencyMs,
326
+ p99LatencyMs: p99LatencyMs,
327
+ avgQualityRating: avgQualityRating,
328
+ totalRatings: totalRatings,
329
+ rating1Count: rating1Count,
330
+ rating2Count: rating2Count,
331
+ rating3Count: rating3Count,
332
+ rating4Count: rating4Count,
333
+ rating5Count: rating5Count,
334
+ errorCount: errorCount,
335
+ errorRate: errorRate,
336
+ timeoutCount: timeoutCount,
337
+ quotaCount: quotaCount,
338
+ networkCount: networkCount,
339
+ apiErrorCount: apiErrorCount,
340
+ createdAt: createdAt
341
+ )
342
+
343
+ stats.append(stat)
344
+ }
345
+
346
+ return stats
347
+ }
348
+
349
+ // MARK: - Database Maintenance
350
+
351
+ public func vacuum() async throws {
352
+ try open()
353
+ try execute("VACUUM")
354
+ }
355
+
356
+ public func deleteOldData(olderThan days: Int) async throws {
357
+ try open()
358
+
359
+ let cutoffDate = Date().addingTimeInterval(-Double(days) * 24 * 60 * 60)
360
+ let cutoffTimestamp = cutoffDate.timeIntervalSince1970
361
+
362
+ let queries = [
363
+ "DELETE FROM latency_metrics WHERE created_at < \(cutoffTimestamp)",
364
+ "DELETE FROM quality_ratings WHERE timestamp < \(cutoffTimestamp)",
365
+ "DELETE FROM error_events WHERE timestamp < \(cutoffTimestamp)"
366
+ ]
367
+
368
+ for query in queries {
369
+ try execute(query)
370
+ }
371
+ }
372
+
373
+ // MARK: - Error Types
374
+
375
+ public enum StorageError: Error, LocalizedError {
376
+ case notOpen
377
+ case openFailed(message: String)
378
+ case prepareFailed(message: String)
379
+ case executionFailed(message: String)
380
+ case insertFailed(message: String)
381
+
382
+ public var errorDescription: String? {
383
+ switch self {
384
+ case .notOpen:
385
+ return "Database not open"
386
+ case .openFailed(let message):
387
+ return "Failed to open database: \(message)"
388
+ case .prepareFailed(let message):
389
+ return "Failed to prepare statement: \(message)"
390
+ case .executionFailed(let message):
391
+ return "Failed to execute statement: \(message)"
392
+ case .insertFailed(let message):
393
+ return "Failed to insert data: \(message)"
394
+ }
395
+ }
396
+ }
397
+ }
398
+
399
+ // MARK: - Helper Extensions
400
+
401
+ extension String {
402
+ fileprivate init(cString pointer: UnsafePointer<UInt8>?) {
403
+ guard let pointer = pointer else {
404
+ self = ""
405
+ return
406
+ }
407
+ self = String(cString: pointer)
408
+ }
409
+ }
@@ -0,0 +1,178 @@
1
+ import Foundation
2
+
3
+ public enum UsagePolicyAction: String, Sendable, Codable, Hashable, CaseIterable {
4
+ case none
5
+ case warn
6
+ case softLimit
7
+ case hardStop
8
+
9
+ var severityRank: Int {
10
+ switch self {
11
+ case .none: 0
12
+ case .warn: 1
13
+ case .softLimit: 2
14
+ case .hardStop: 3
15
+ }
16
+ }
17
+ }
18
+
19
+ public enum UsagePolicyAnomalySeverity: Int, Sendable, Codable, Hashable {
20
+ case elevated = 1
21
+ case high = 2
22
+ case critical = 3
23
+ }
24
+
25
+ public struct UsagePolicyContext: Sendable, Codable, Hashable {
26
+ public let provider: UsageProvider
27
+ public let observedSpendUSD: Double?
28
+ public let projectedSpendUSD: Double?
29
+ public let budgetLimitUSD: Double?
30
+ public let anomalySeverity: UsagePolicyAnomalySeverity?
31
+
32
+ public init(
33
+ provider: UsageProvider,
34
+ observedSpendUSD: Double?,
35
+ projectedSpendUSD: Double?,
36
+ budgetLimitUSD: Double?,
37
+ anomalySeverity: UsagePolicyAnomalySeverity? = nil)
38
+ {
39
+ self.provider = provider
40
+ self.observedSpendUSD = observedSpendUSD
41
+ self.projectedSpendUSD = projectedSpendUSD
42
+ self.budgetLimitUSD = budgetLimitUSD
43
+ self.anomalySeverity = anomalySeverity
44
+ }
45
+ }
46
+
47
+ public enum UsagePolicyCondition: Sendable, Codable, Hashable {
48
+ case projectedBudgetOverrun(minimumPercent: Double)
49
+ case actualBudgetOverrun
50
+ case anomalySeverityAtLeast(UsagePolicyAnomalySeverity)
51
+ }
52
+
53
+ public struct UsagePolicyRule: Sendable, Codable, Hashable, Identifiable {
54
+ public let id: String
55
+ public let name: String
56
+ public let enabled: Bool
57
+ public let condition: UsagePolicyCondition
58
+ public let action: UsagePolicyAction
59
+
60
+ public init(
61
+ id: String = UUID().uuidString,
62
+ name: String,
63
+ enabled: Bool = true,
64
+ condition: UsagePolicyCondition,
65
+ action: UsagePolicyAction)
66
+ {
67
+ self.id = id
68
+ self.name = name
69
+ self.enabled = enabled
70
+ self.condition = condition
71
+ self.action = action
72
+ }
73
+ }
74
+
75
+ public struct UsagePolicyRuleMatch: Sendable, Codable, Hashable {
76
+ public let ruleID: String
77
+ public let ruleName: String
78
+ public let action: UsagePolicyAction
79
+ public let reason: String
80
+
81
+ public init(ruleID: String, ruleName: String, action: UsagePolicyAction, reason: String) {
82
+ self.ruleID = ruleID
83
+ self.ruleName = ruleName
84
+ self.action = action
85
+ self.reason = reason
86
+ }
87
+ }
88
+
89
+ public struct UsagePolicyDecision: Sendable, Codable, Hashable {
90
+ public let action: UsagePolicyAction
91
+ public let matches: [UsagePolicyRuleMatch]
92
+ public let reasons: [String]
93
+
94
+ public init(action: UsagePolicyAction, matches: [UsagePolicyRuleMatch], reasons: [String]) {
95
+ self.action = action
96
+ self.matches = matches
97
+ self.reasons = reasons
98
+ }
99
+
100
+ public var shouldThrottle: Bool {
101
+ self.action.severityRank >= UsagePolicyAction.softLimit.severityRank
102
+ }
103
+
104
+ public var shouldBlock: Bool {
105
+ self.action == .hardStop
106
+ }
107
+ }
108
+
109
+ public enum UsagePolicyEngine {
110
+ public static func evaluate(
111
+ context: UsagePolicyContext,
112
+ rules: [UsagePolicyRule]) -> UsagePolicyDecision
113
+ {
114
+ var matches: [UsagePolicyRuleMatch] = []
115
+ matches.reserveCapacity(rules.count)
116
+
117
+ for rule in rules where rule.enabled {
118
+ guard let reason = self.matchReason(for: rule.condition, context: context) else { continue }
119
+ matches.append(UsagePolicyRuleMatch(
120
+ ruleID: rule.id,
121
+ ruleName: rule.name,
122
+ action: rule.action,
123
+ reason: reason))
124
+ }
125
+
126
+ guard !matches.isEmpty else {
127
+ return UsagePolicyDecision(
128
+ action: .none,
129
+ matches: [],
130
+ reasons: ["No policy rules matched."])
131
+ }
132
+
133
+ let strongestAction = matches
134
+ .map(\.action)
135
+ .max { $0.severityRank < $1.severityRank } ?? .none
136
+
137
+ return UsagePolicyDecision(
138
+ action: strongestAction,
139
+ matches: matches,
140
+ reasons: matches.map(\.reason))
141
+ }
142
+
143
+ private static func matchReason(
144
+ for condition: UsagePolicyCondition,
145
+ context: UsagePolicyContext) -> String?
146
+ {
147
+ switch condition {
148
+ case .projectedBudgetOverrun(let minimumPercent):
149
+ guard let budget = context.budgetLimitUSD, budget > 0 else { return nil }
150
+ guard let projected = context.projectedSpendUSD, projected.isFinite else { return nil }
151
+ let overrunUSD = projected - budget
152
+ guard overrunUSD > 0 else { return nil }
153
+ let overrunPercent = overrunUSD / budget
154
+ guard overrunPercent >= max(0, minimumPercent) else { return nil }
155
+ let percentText = "\(Int((overrunPercent * 100).rounded()))%"
156
+ return "Projected spend \(UsageFormatter.usdString(projected)) is \(percentText) over budget \(UsageFormatter.usdString(budget))."
157
+
158
+ case .actualBudgetOverrun:
159
+ guard let budget = context.budgetLimitUSD, budget > 0 else { return nil }
160
+ guard let observed = context.observedSpendUSD, observed.isFinite else { return nil }
161
+ guard observed >= budget else { return nil }
162
+ return "Observed spend \(UsageFormatter.usdString(observed)) reached budget \(UsageFormatter.usdString(budget))."
163
+
164
+ case .anomalySeverityAtLeast(let required):
165
+ guard let observed = context.anomalySeverity else { return nil }
166
+ guard observed.rawValue >= required.rawValue else { return nil }
167
+ return "Anomaly severity \(self.severityLabel(observed)) meets threshold \(self.severityLabel(required))."
168
+ }
169
+ }
170
+
171
+ private static func severityLabel(_ severity: UsagePolicyAnomalySeverity) -> String {
172
+ switch severity {
173
+ case .elevated: "Elevated"
174
+ case .high: "High"
175
+ case .critical: "Critical"
176
+ }
177
+ }
178
+ }
@@ -0,0 +1,99 @@
1
+ import Foundation
2
+ import RunicCore
3
+
4
+ /// Storage for project budget limits and alert thresholds
5
+ public struct ProjectBudgetStore {
6
+ // MARK: - Types
7
+
8
+ public struct ProjectBudget: Codable, Sendable, Identifiable {
9
+ public var id: String { projectID }
10
+ public let projectID: String
11
+ public var projectName: String?
12
+ public var monthlyLimit: Double
13
+ public var alertThreshold: Double // 0.0-1.0, default 0.8 (80%)
14
+ public var enabled: Bool
15
+ public let createdAt: Date
16
+
17
+ public init(
18
+ projectID: String,
19
+ projectName: String? = nil,
20
+ monthlyLimit: Double,
21
+ alertThreshold: Double = 0.8,
22
+ enabled: Bool = true,
23
+ createdAt: Date = Date()
24
+ ) {
25
+ self.projectID = projectID
26
+ self.projectName = projectName
27
+ self.monthlyLimit = monthlyLimit
28
+ self.alertThreshold = alertThreshold
29
+ self.enabled = enabled
30
+ self.createdAt = createdAt
31
+ }
32
+ }
33
+
34
+ public struct BudgetsData: Codable {
35
+ public let version: Int
36
+ public var budgets: [String: ProjectBudget] // projectID -> budget
37
+
38
+ public init(version: Int = 1, budgets: [String: ProjectBudget] = [:]) {
39
+ self.version = version
40
+ self.budgets = budgets
41
+ }
42
+ }
43
+
44
+ // MARK: - Storage Location
45
+
46
+ private static var storageURL: URL {
47
+ let appSupport = FileManager.default.urls(for: .applicationSupportDirectory, in: .userDomainMask)[0]
48
+ let runicDir = appSupport.appendingPathComponent("Runic", isDirectory: true)
49
+ try? FileManager.default.createDirectory(at: runicDir, withIntermediateDirectories: true)
50
+ return runicDir.appendingPathComponent("project-budgets.json")
51
+ }
52
+
53
+ // MARK: - Public Methods
54
+
55
+ public static func load() -> BudgetsData {
56
+ guard FileManager.default.fileExists(atPath: storageURL.path) else {
57
+ return BudgetsData()
58
+ }
59
+
60
+ do {
61
+ let data = try Data(contentsOf: storageURL)
62
+ let decoder = JSONDecoder()
63
+ decoder.dateDecodingStrategy = .iso8601
64
+ return try decoder.decode(BudgetsData.self, from: data)
65
+ } catch {
66
+ print("[ProjectBudgetStore] Failed to load budgets: \(error)")
67
+ return BudgetsData()
68
+ }
69
+ }
70
+
71
+ public static func save(_ budgetsData: BudgetsData) throws {
72
+ let encoder = JSONEncoder()
73
+ encoder.dateEncodingStrategy = .iso8601
74
+ encoder.outputFormatting = [.prettyPrinted, .sortedKeys]
75
+
76
+ let data = try encoder.encode(budgetsData)
77
+ try data.write(to: storageURL, options: .atomic)
78
+ }
79
+
80
+ public static func getBudget(projectID: String) -> ProjectBudget? {
81
+ load().budgets[projectID]
82
+ }
83
+
84
+ public static func setBudget(_ budget: ProjectBudget) throws {
85
+ var data = load()
86
+ data.budgets[budget.projectID] = budget
87
+ try save(data)
88
+ }
89
+
90
+ public static func removeBudget(projectID: String) throws {
91
+ var data = load()
92
+ data.budgets.removeValue(forKey: projectID)
93
+ try save(data)
94
+ }
95
+
96
+ public static func getAllBudgets() -> [ProjectBudget] {
97
+ Array(load().budgets.values).sorted { $0.createdAt < $1.createdAt }
98
+ }
99
+ }