This commit is contained in:
Forrest 2026-07-29 14:14:18 -04:00
commit d205277cdd
182 changed files with 22978 additions and 0 deletions

View file

@ -0,0 +1,207 @@
# Graph Report - . (2026-07-29)
## Corpus Check
- Corpus is ~12,356 words - fits in a single context window. You may not need a graph.
## Summary
- 522 nodes · 678 edges · 33 communities (31 shown, 2 thin omitted)
- Extraction: 95% EXTRACTED · 5% INFERRED · 0% AMBIGUOUS · INFERRED: 35 edges (avg confidence: 0.92)
- Token cost: 75,479 input · 0 output
## Community Hubs (Navigation)
- Playback Engine & App Entry
- Play History & Rediscovery
- Browser Screen & UI Widgets
- Subsonic API Client
- Subsonic Data Models
- Connection & State Providers
- Accent Theming & Palette
- Linux Desktop Runner
- Favorites State
- iOS App Runner
- Credentials & Secure Storage
- Design Tokens
- Connect / Login Sheet
- Build Config & Dependencies
- iOS App Icons
- Now Playing Screen
- Screen Providers & Consumers
- App Shell & Navigation
- JSON Parsing Helpers
- Search Screen
- Favorites Screen
- Home Screen
- Stateful Screen Widgets
- Android Launcher Icons
- Widget Tests
- Favorite Rating Controls
- Android Main Activity
- iOS Launch Images
- Launch Screen Readme
## God Nodes (most connected - your core abstractions)
1. `App Icon 1024x1024 (Flutter logo master)` - 14 edges
2. `ratune_mobile (Flutter package)` - 13 edges
3. `subsonicClientProvider` - 8 edges
4. `build` - 7 edges
5. `HomeScreen` - 7 edges
6. `build` - 7 edges
7. `connectionProvider` - 7 edges
8. `playbackProvider` - 7 edges
9. `_MyApplication` - 7 edges
10. `AppDelegate` - 5 edges
## Surprising Connections (you probably didn't know these)
- `Dart Analyzer Configuration` --conceptually_related_to--> `ratune_mobile (Flutter package)` [INFERRED]
analysis_options.yaml → pubspec.yaml
- `ratune_mobile README` --references--> `ratune_mobile (Flutter package)` [INFERRED]
README.md → pubspec.yaml
- `Linux Top-Level CMake Build` --conceptually_related_to--> `ratune_mobile (Flutter package)` [INFERRED]
linux/CMakeLists.txt → pubspec.yaml
- `App Icon 20x20 @1x` --semantically_similar_to--> `App Icon 1024x1024 (Flutter logo master)` [INFERRED] [semantically similar]
ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png → ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png
- `App Icon 20x20 @2x` --semantically_similar_to--> `App Icon 1024x1024 (Flutter logo master)` [INFERRED] [semantically similar]
ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png → ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png
## Import Cycles
- None detected.
## Hyperedges (group relationships)
- **Linux Flutter CMake Build Pipeline** — linux_cmakelists_runner, linux_flutter_cmakelists_flutter, linux_runner_cmakelists_runner [EXTRACTED 1.00]
- **Audio Playback and Theming Stack** — pubspec_just_audio, pubspec_just_audio_background, pubspec_palette_generator [INFERRED 0.65]
- **Android Launcher Icon Set (Flutter logo)** — android_app_src_main_res_mipmap_hdpi_ic_launcher_icon, android_app_src_main_res_mipmap_mdpi_ic_launcher_icon, android_app_src_main_res_mipmap_xhdpi_ic_launcher_icon, android_app_src_main_res_mipmap_xxhdpi_ic_launcher_icon, android_app_src_main_res_mipmap_xxxhdpi_ic_launcher_icon [INFERRED 0.85]
- **iOS AppIcon Set (Flutter logo)** — ios_runner_assets_xcassets_appicon_appiconset_icon_app_1024x1024_1x_icon, ios_runner_assets_xcassets_appicon_appiconset_icon_app_20x20_1x_icon, ios_runner_assets_xcassets_appicon_appiconset_icon_app_20x20_2x_icon, ios_runner_assets_xcassets_appicon_appiconset_icon_app_20x20_3x_icon, ios_runner_assets_xcassets_appicon_appiconset_icon_app_29x29_1x_icon, ios_runner_assets_xcassets_appicon_appiconset_icon_app_29x29_2x_icon, ios_runner_assets_xcassets_appicon_appiconset_icon_app_29x29_3x_icon, ios_runner_assets_xcassets_appicon_appiconset_icon_app_40x40_1x_icon, ios_runner_assets_xcassets_appicon_appiconset_icon_app_40x40_2x_icon, ios_runner_assets_xcassets_appicon_appiconset_icon_app_40x40_3x_icon, ios_runner_assets_xcassets_appicon_appiconset_icon_app_60x60_2x_icon, ios_runner_assets_xcassets_appicon_appiconset_icon_app_60x60_3x_icon, ios_runner_assets_xcassets_appicon_appiconset_icon_app_76x76_1x_icon, ios_runner_assets_xcassets_appicon_appiconset_icon_app_76x76_2x_icon, ios_runner_assets_xcassets_appicon_appiconset_icon_app_83_5x83_5_2x_icon [INFERRED 0.85]
- **iOS Launch Image Set** — ios_runner_assets_xcassets_launchimage_imageset_launchimage_image, ios_runner_assets_xcassets_launchimage_imageset_launchimage_2x_image, ios_runner_assets_xcassets_launchimage_imageset_launchimage_3x_image [INFERRED 0.85]
## Communities (33 total, 2 thin omitted)
### Community 0 - "Playback Engine & App Entry"
Cohesion: 0.05
Nodes (41): AudioPlayer?, dart:io, Duration, int?, build, main, RatuneApp, _audioSupported (+33 more)
### Community 1 - "Play History & Rediscovery"
Cohesion: 0.05
Nodes (41): dart:async, DateTime, File?, album, albumId, artist, artistId, byArtist (+33 more)
### Community 2 - "Browser Screen & UI Widgets"
Cohesion: 0.06
Nodes (40): EdgeInsetsGeometry, favorites_screen.dart, IconData, _Action, BrowseRow, _Centered, child, _DetailScaffold (+32 more)
### Community 3 - "Subsonic API Client"
Cohesion: 0.05
Nodes (40): dart:convert, dart:math, Dio, Exception, apiVersion, authErrorCode, _authParams, baseUrl (+32 more)
### Community 4 - "Subsonic Data Models"
Cohesion: 0.06
Nodes (33): json_helpers.dart, Album, albumCount, albumId, albums, all, Artist, artistId (+25 more)
### Community 5 - "Connection & State Providers"
Cohesion: 0.07
Nodes (28): bool get, favorites.dart, ../history/play_history.dart, client, connect, ConnectionController, ConnectionState, ConnStatus (+20 more)
### Community 6 - "Accent Theming & Palette"
Cohesion: 0.07
Nodes (25): Color, AccentNotifier, _ensureReadable, extractAccent, hsl, lightness, palette, picked (+17 more)
### Community 7 - "Linux Desktop Runner"
Cohesion: 0.09
Nodes (22): FlPluginRegistry, FlView, GApplication, gboolean, gchar, GObject, GtkApplication, fl_register_plugins() (+14 more)
### Community 8 - "Favorites State"
Cohesion: 0.10
Nodes (20): HistoryController, albumIds, artistIds, clear, copyWith, FavoritesController, FavoritesState, hydrate (+12 more)
### Community 9 - "iOS App Runner"
Cohesion: 0.11
Nodes (14): Any, Bool, Flutter, FlutterAppDelegate, FlutterImplicitEngineBridge, FlutterImplicitEngineDelegate, FlutterSceneDelegate, AppDelegate (+6 more)
### Community 10 - "Credentials & Secure Storage"
Cohesion: 0.11
Nodes (18): FlutterSecureStorage, alias, clear, CredentialStore, display, _kAlias, _kPass, _kUrl (+10 more)
### Community 11 - "Design Tokens"
Cohesion: 0.11
Nodes (17): _, accentDefault, background, border, borderActive, dimmed, foreground, lg (+9 more)
### Community 12 - "Connect / Login Sheet"
Cohesion: 0.15
Nodes (16): build, _busy, _connect, _ConnectSheet, _ConnectSheetState, createState, dispose, _field (+8 more)
### Community 13 - "Build Config & Dependencies"
Cohesion: 0.16
Nodes (16): Dart Analyzer Configuration, Linux Top-Level CMake Build, Linux Flutter Library CMake Build, Linux Runner Executable CMake Build, crypto (hashing/crypto), dio (HTTP client dependency), flutter_lints (dev lint rules), flutter_riverpod (state management) (+8 more)
### Community 14 - "iOS App Icons"
Cohesion: 0.13
Nodes (15): App Icon 1024x1024 (Flutter logo master), App Icon 20x20 @1x, App Icon 20x20 @2x, App Icon 20x20 @3x, App Icon 29x29 @1x, App Icon 29x29 @2x, App Icon 29x29 @3x, App Icon 40x40 @1x (+7 more)
### Community 15 - "Now Playing Screen"
Cohesion: 0.13
Nodes (14): accent, _btn, _fmt, _fmtDur, m, ref, s, song (+6 more)
### Community 16 - "Screen Providers & Consumers"
Cohesion: 0.22
Nodes (14): ConsumerWidget, AlbumScreen, ArtistScreen, BrowserScreen, build, _AlbumArtPanel, NowPlayingScreen, _Transport (+6 more)
### Community 17 - "App Shell & Navigation"
Cohesion: 0.17
Nodes (11): createState, _index, onSelect, _TabBar, _tabs, ../screens/browser_screen.dart, ../screens/connect_sheet.dart, ../screens/home_screen.dart (+3 more)
### Community 18 - "JSON Parsing Helpers"
Cohesion: 0.20
Nodes (9): asBool, asDouble, asInt, asString, null, orElse, toString, return (+1 more)
### Community 19 - "Search Screen"
Cohesion: 0.25
Nodes (8): browser_screen.dart, build, _controller, createState, dispose, _query, _Results, searchProvider
### Community 20 - "Favorites Screen"
Cohesion: 0.25
Nodes (8): build, FavoritesScreen, _SectionLabel, text, starredProvider, MaterialPageRoute, ../state/providers.dart, ../theme/tokens.dart
### Community 21 - "Home Screen"
Cohesion: 0.33
Nodes (8): build, HomeScreen, message, recentAlbumsProvider, recentSongsProvider, rediscoverProvider, rediscoverSeedProvider, ../widgets/hairline_panel.dart
### Community 22 - "Stateful Screen Widgets"
Cohesion: 0.40
Nodes (6): ConsumerState, ConsumerStatefulWidget, SearchScreen, _SearchScreenState, AppShell, _AppShellState
### Community 23 - "Android Launcher Icons"
Cohesion: 1.00
Nodes (5): App Launcher Icon (hdpi), App Launcher Icon (mdpi), App Launcher Icon (xhdpi), App Launcher Icon (xxhdpi), App Launcher Icon (xxxhdpi)
### Community 24 - "Widget Tests"
Cohesion: 0.40
Nodes (4): package:flutter_riverpod/flutter_riverpod.dart, package:flutter_test/flutter_test.dart, package:ratune_mobile/main.dart, main
### Community 25 - "Favorite Rating Controls"
Cohesion: 0.50
Nodes (4): build, _FavRating, build, favoritesProvider
### Community 27 - "iOS Launch Images"
Cohesion: 1.00
Nodes (3): Launch Image (2x), Launch Image (3x), Launch Image (1x)
## Knowledge Gaps
- **280 isolated node(s):** `XCTest`, `PlayRecord`, `RediscoverArtist`, `songId`, `title` (+275 more)
These have ≤1 connection - possible missing edges or undocumented components.
- **2 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes.
## Suggested Questions
_Questions this graph is uniquely positioned to answer:_
- **Why does `SubsonicClient` connect `Subsonic API Client` to `Connection & State Providers`?**
_High betweenness centrality (0.025) - this node is a cross-community bridge._
- **Why does `Starred2` connect `Subsonic Data Models` to `Connection & State Providers`?**
_High betweenness centrality (0.011) - this node is a cross-community bridge._
- **Why does `Song` connect `Now Playing Screen` to `Subsonic Data Models`?**
_High betweenness centrality (0.010) - this node is a cross-community bridge._
- **Are the 14 inferred relationships involving `App Icon 1024x1024 (Flutter logo master)` (e.g. with `App Icon 20x20 @1x` and `App Icon 20x20 @2x`) actually correct?**
_`App Icon 1024x1024 (Flutter logo master)` has 14 INFERRED edges - model-reasoned connections that need verification._
- **Are the 3 inferred relationships involving `ratune_mobile (Flutter package)` (e.g. with `Dart Analyzer Configuration` and `Linux Top-Level CMake Build`) actually correct?**
_`ratune_mobile (Flutter package)` has 3 INFERRED edges - model-reasoned connections that need verification._
- **What connects `XCTest`, `PlayRecord`, `RediscoverArtist` to the rest of the system?**
_280 weakly-connected nodes found - possible documentation gaps or missing edges._
- **Should `Playback Engine & App Entry` be split into smaller, more focused modules?**
_Cohesion score 0.05094130675526024 - nodes in this community are weakly interconnected._