|
1 | 1 | # Graph Report - lib (2026-05-21) |
2 | 2 |
|
3 | 3 | ## Corpus Check |
4 | | -- 56 files · ~31,335 words |
5 | | -- Verdict: corpus is large enough that graph structure adds value. |
| 4 | +- Corpus is ~29,315 words - fits in a single context window. You may not need a graph. |
6 | 5 |
|
7 | 6 | ## Summary |
8 | | -- 456 nodes · 577 edges · 30 communities detected |
| 7 | +- 441 nodes · 565 edges · 29 communities detected |
9 | 8 | - Extraction: 100% EXTRACTED · 0% INFERRED · 0% AMBIGUOUS |
10 | 9 | - Token cost: 0 input · 0 output |
11 | 10 |
|
12 | 11 | ## Community Hubs (Navigation) |
13 | | -- [[_COMMUNITY_Community 0|Community 0]] |
14 | | -- [[_COMMUNITY_Community 1|Community 1]] |
15 | | -- [[_COMMUNITY_Community 2|Community 2]] |
16 | | -- [[_COMMUNITY_Community 3|Community 3]] |
17 | | -- [[_COMMUNITY_Community 4|Community 4]] |
18 | | -- [[_COMMUNITY_Community 5|Community 5]] |
19 | | -- [[_COMMUNITY_Community 6|Community 6]] |
20 | | -- [[_COMMUNITY_Community 7|Community 7]] |
21 | | -- [[_COMMUNITY_Community 8|Community 8]] |
22 | | -- [[_COMMUNITY_Community 9|Community 9]] |
23 | | -- [[_COMMUNITY_Community 10|Community 10]] |
24 | | -- [[_COMMUNITY_Community 11|Community 11]] |
25 | | -- [[_COMMUNITY_Community 12|Community 12]] |
26 | | -- [[_COMMUNITY_Community 13|Community 13]] |
27 | | -- [[_COMMUNITY_Community 14|Community 14]] |
28 | | -- [[_COMMUNITY_Community 15|Community 15]] |
| 12 | +- [[_COMMUNITY_Core Services|Core Services]] |
| 13 | +- [[_COMMUNITY_Mesh Routing|Mesh Routing]] |
| 14 | +- [[_COMMUNITY_App Entry & Lifecycle|App Entry & Lifecycle]] |
| 15 | +- [[_COMMUNITY_Mesh Handshake Logic|Mesh Handshake Logic]] |
| 16 | +- [[_COMMUNITY_Binary Packet Encoding|Binary Packet Encoding]] |
| 17 | +- [[_COMMUNITY_Geo Utils & Radar|Geo Utils & Radar]] |
| 18 | +- [[_COMMUNITY_Device Database Generated|Device Database Generated]] |
| 19 | +- [[_COMMUNITY_Data Management|Data Management]] |
| 20 | +- [[_COMMUNITY_Onboarding UI|Onboarding UI]] |
| 21 | +- [[_COMMUNITY_Profile & Identity UI|Profile & Identity UI]] |
| 22 | +- [[_COMMUNITY_System Health UI|System Health UI]] |
| 23 | +- [[_COMMUNITY_Navigation & Routing|Navigation & Routing]] |
| 24 | +- [[_COMMUNITY_Mesh Packet Types|Mesh Packet Types]] |
| 25 | +- [[_COMMUNITY_App Providers|App Providers]] |
| 26 | +- [[_COMMUNITY_Message Database Generated|Message Database Generated]] |
| 27 | +- [[_COMMUNITY_Relay Task Database Generated|Relay Task Database Generated]] |
29 | 28 | - [[_COMMUNITY_Community 16|Community 16]] |
30 | 29 | - [[_COMMUNITY_Community 17|Community 17]] |
31 | 30 | - [[_COMMUNITY_Community 18|Community 18]] |
|
35 | 34 | - [[_COMMUNITY_Community 22|Community 22]] |
36 | 35 | - [[_COMMUNITY_Community 23|Community 23]] |
37 | 36 | - [[_COMMUNITY_Community 24|Community 24]] |
38 | | -- [[_COMMUNITY_Community 25|Community 25]] |
39 | | -- [[_COMMUNITY_Community 26|Community 26]] |
| 37 | +- [[_COMMUNITY_Database Providers|Database Providers]] |
| 38 | +- [[_COMMUNITY_Profile Utilities|Profile Utilities]] |
40 | 39 | - [[_COMMUNITY_Community 27|Community 27]] |
41 | 40 | - [[_COMMUNITY_Community 28|Community 28]] |
42 | | -- [[_COMMUNITY_Community 29|Community 29]] |
43 | 41 |
|
44 | 42 | ## God Nodes (most connected - your core abstractions) |
45 | 43 | 1. `package:flutter/material.dart` - 13 edges |
46 | 44 | 2. `package:logging/logging.dart` - 13 edges |
47 | 45 | 3. `dart:typed_data` - 12 edges |
48 | | -4. `package:isar_community/isar.dart` - 11 edges |
49 | | -5. `package:riverpod_annotation/riverpod_annotation.dart` - 11 edges |
50 | | -6. `package:off_chat/src/core/theme/app_theme.dart` - 10 edges |
51 | | -7. `_` - 10 edges |
52 | | -8. `dart:async` - 9 edges |
53 | | -9. `package:flutter_riverpod/flutter_riverpod.dart` - 8 edges |
54 | | -10. `package:off_chat/src/core/database/isar_service.dart` - 8 edges |
| 46 | +4. `package:riverpod_annotation/riverpod_annotation.dart` - 11 edges |
| 47 | +5. `package:off_chat/src/core/theme/app_theme.dart` - 10 edges |
| 48 | +6. `_` - 10 edges |
| 49 | +7. `dart:async` - 9 edges |
| 50 | +8. `package:flutter_riverpod/flutter_riverpod.dart` - 8 edges |
| 51 | +9. `package:off_chat/src/core/database/isar_service.dart` - 8 edges |
| 52 | +10. `package:isar_community/isar.dart` - 8 edges |
55 | 53 |
|
56 | 54 | ## Surprising Connections (you probably didn't know these) |
57 | 55 | - None detected - all connections are within the same source files. |
58 | 56 |
|
59 | 57 | ## Communities |
60 | 58 |
|
61 | | -### Community 0 - "Community 0" |
62 | | -Cohesion: 0.05 |
63 | | -Nodes (44): dart:async, dart:ui, onStart, NotificationService, _addLog, clearLogs, Function, _parseLevel (+36 more) |
64 | | - |
65 | | -### Community 1 - "Community 1" |
| 59 | +### Community 0 - "Core Services" |
66 | 60 | Cohesion: 0.04 |
67 | | -Nodes (40): Duration, Exception, IsarService, FoundDevice, Message, RelayTask, AckPacket, Exception (+32 more) |
| 61 | +Nodes (61): dart:async, dart:convert, dart:ui, NotificationService, onStart, NotificationService, _addLog, clearLogs (+53 more) |
68 | 62 |
|
69 | | -### Community 2 - "Community 2" |
70 | | -Cohesion: 0.06 |
71 | | -Nodes (35): build, SystemHealth, SystemHealthState, BLEAdvertiser, getMtuForDevice, isDeviceConnected, ReadRequestResult, _waitForBluetooth (+27 more) |
| 63 | +### Community 1 - "Mesh Routing" |
| 64 | +Cohesion: 0.05 |
| 65 | +Nodes (36): calculateScore, DirectedBeamRouter, MeshRouter, shouldRelayToPeer, StarburstRouter, AnimatedBuilder, build, _buildDeviceCard (+28 more) |
72 | 66 |
|
73 | | -### Community 3 - "Community 3" |
| 67 | +### Community 2 - "App Entry & Lifecycle" |
74 | 68 | Cohesion: 0.06 |
75 | | -Nodes (32): main, build, didChangeAppLifecycleState, dispose, initState, OffChatApp, _OffChatAppState, _setOnlineStatus (+24 more) |
| 69 | +Nodes (29): main, NotificationService, build, didChangeAppLifecycleState, dispose, initState, OffChatApp, _OffChatAppState (+21 more) |
76 | 70 |
|
77 | | -### Community 4 - "Community 4" |
78 | | -Cohesion: 0.08 |
79 | | -Nodes (24): dart:math, calculateBearing, calculateDistance, GeoUtils, build, _buildCenterAnchor, _buildDeviceBlip, _buildDistanceLabel (+16 more) |
| 71 | +### Community 3 - "Mesh Handshake Logic" |
| 72 | +Cohesion: 0.07 |
| 73 | +Nodes (26): FoundDevice, Message, RelayTask, addNeighborToBreadcrumb, clearWaitingForImage, completeSync, completeSyncWithError, dropBreadcrumb (+18 more) |
80 | 74 |
|
81 | | -### Community 5 - "Community 5" |
82 | | -Cohesion: 0.09 |
83 | | -Nodes (22): AnimatedBuilder, build, _buildDeviceCard, _buildProfileInfo, Container, DiscoveryScreen, _DiscoveryScreenState, dispose (+14 more) |
| 75 | +### Community 4 - "Binary Packet Encoding" |
| 76 | +Cohesion: 0.07 |
| 77 | +Nodes (26): dart:typed_data, decodeCoordinate, encodeCoordinate, encodeLocation, encodeMainPacket, encodeScanResponseManufacturerData, MeshPacketEncoder, ChunkedTransferManager (+18 more) |
84 | 78 |
|
85 | | -### Community 6 - "Community 6" |
86 | | -Cohesion: 0.09 |
87 | | -Nodes (22): addNeighborToBreadcrumb, clearWaitingForImage, completeSync, completeSyncWithError, dropBreadcrumb, _encryptMessage, enqueueForward, enqueueTerminalAck (+14 more) |
| 79 | +### Community 5 - "Geo Utils & Radar" |
| 80 | +Cohesion: 0.08 |
| 81 | +Nodes (24): dart:math, calculateBearing, calculateDistance, GeoUtils, build, _buildCenterAnchor, _buildDeviceBlip, _buildDistanceLabel (+16 more) |
88 | 82 |
|
89 | | -### Community 7 - "Community 7" |
| 83 | +### Community 6 - "Device Database Generated" |
90 | 84 | Cohesion: 0.09 |
91 | 85 | Nodes (21): deleteAllByIndex, deleteAllByIndexSync, deleteAllByStableIdSync, deleteByIndex, deleteByIndexSync, deleteByStableIdSync, _foundDeviceAttach, _foundDeviceDeserialize (+13 more) |
92 | 86 |
|
93 | | -### Community 8 - "Community 8" |
94 | | -Cohesion: 0.09 |
95 | | -Nodes (21): deleteAllByDeviceIdSync, deleteAllByIndex, deleteAllByIndexSync, deleteByDeviceIdSync, deleteByIndex, deleteByIndexSync, getAllByIndex, getAllByIndexSync (+13 more) |
| 87 | +### Community 7 - "Data Management" |
| 88 | +Cohesion: 0.1 |
| 89 | +Nodes (19): dart:io, Duration, Exception, IsarService, ChatController, IsarService, ProfileManager, saveProfilePicture (+11 more) |
96 | 90 |
|
97 | | -### Community 9 - "Community 9" |
| 91 | +### Community 8 - "Onboarding UI" |
98 | 92 | Cohesion: 0.1 |
99 | 93 | Nodes (20): build, _buildFinalStep, _buildFooter, _buildPageIndicator, _buildSplashStep, _buildStep, Center, Container (+12 more) |
100 | 94 |
|
101 | | -### Community 10 - "Community 10" |
| 95 | +### Community 9 - "Profile & Identity UI" |
102 | 96 | Cohesion: 0.11 |
103 | | -Nodes (17): build, _buildIdentityCard, _buildSettingCard, Container, CustomScrollView, dispose, initState, ProfileScreen (+9 more) |
| 97 | +Nodes (18): build, _buildIdentityCard, _buildSettingCard, _buildSubSettingCard, Container, CustomScrollView, dispose, initState (+10 more) |
104 | 98 |
|
105 | | -### Community 11 - "Community 11" |
| 99 | +### Community 10 - "System Health UI" |
106 | 100 | Cohesion: 0.12 |
107 | | -Nodes (15): dart:convert, dart:io, ChatController, IsarService, ProfileManager, saveProfilePicture, SimpleKeyPairData, package:crypto/crypto.dart (+7 more) |
| 101 | +Nodes (16): build, SystemHealth, SystemHealthState, build, Container, _HealthItem, IconButton, Padding (+8 more) |
108 | 102 |
|
109 | | -### Community 12 - "Community 12" |
| 103 | +### Community 11 - "Navigation & Routing" |
110 | 104 | Cohesion: 0.12 |
111 | 105 | Nodes (15): build, _calculateSelectedIndex, ChatScreen, GoRouter, _onItemTapped, router, Scaffold, ScaffoldWithNavBar (+7 more) |
112 | 106 |
|
113 | | -### Community 13 - "Community 13" |
114 | | -Cohesion: 0.15 |
115 | | -Nodes (11): dart:typed_data, decodeCoordinate, encodeCoordinate, encodeLocation, encodeMainPacket, encodeScanResponseManufacturerData, MeshPacketEncoder, ChunkedTransferManager (+3 more) |
| 107 | +### Community 12 - "Mesh Packet Types" |
| 108 | +Cohesion: 0.13 |
| 109 | +Nodes (14): AckPacket, Exception, IdentityPacket, ImagePacket, MeshPacket, NotificationService, PacketContext, parse (+6 more) |
116 | 110 |
|
117 | | -### Community 14 - "Community 14" |
| 111 | +### Community 13 - "App Providers" |
118 | 112 | Cohesion: 0.25 |
119 | 113 | Nodes (9): _, build, create, debugGetCreateSourceHash, isServiceRunning, overrideWithValue, runBuild, scanProgress (+1 more) |
120 | 114 |
|
121 | | -### Community 15 - "Community 15" |
| 115 | +### Community 14 - "Message Database Generated" |
122 | 116 | Cohesion: 0.29 |
123 | 117 | Nodes (6): IsarError, _messageAttach, _messageDeserialize, _messageEstimateSize, _messageGetId, _messageSerialize |
124 | 118 |
|
125 | | -### Community 16 - "Community 16" |
| 119 | +### Community 15 - "Relay Task Database Generated" |
126 | 120 | Cohesion: 0.29 |
127 | 121 | Nodes (6): IsarError, _relayTaskAttach, _relayTaskDeserialize, _relayTaskEstimateSize, _relayTaskGetId, _relayTaskSerialize |
128 | 122 |
|
129 | | -### Community 17 - "Community 17" |
| 123 | +### Community 16 - "Community 16" |
130 | 124 | Cohesion: 0.4 |
131 | 125 | Nodes (6): _, build, create, debugGetCreateSourceHash, overrideWithValue, runBuild |
132 | 126 |
|
133 | | -### Community 18 - "Community 18" |
| 127 | +### Community 17 - "Community 17" |
134 | 128 | Cohesion: 0.4 |
135 | 129 | Nodes (6): _, call, create, debugGetCreateSourceHash, runBuild, toString |
136 | 130 |
|
137 | | -### Community 19 - "Community 19" |
| 131 | +### Community 18 - "Community 18" |
138 | 132 | Cohesion: 0.4 |
139 | 133 | Nodes (6): _, build, create, debugGetCreateSourceHash, overrideWithValue, runBuild |
140 | 134 |
|
141 | | -### Community 20 - "Community 20" |
| 135 | +### Community 19 - "Community 19" |
142 | 136 | Cohesion: 0.4 |
143 | 137 | Nodes (4): create, debugGetCreateSourceHash, notificationService, overrideWithValue |
144 | 138 |
|
145 | | -### Community 21 - "Community 21" |
| 139 | +### Community 20 - "Community 20" |
146 | 140 | Cohesion: 0.4 |
147 | 141 | Nodes (4): create, debugGetCreateSourceHash, overrideWithValue, router |
148 | 142 |
|
149 | | -### Community 22 - "Community 22" |
| 143 | +### Community 21 - "Community 21" |
150 | 144 | Cohesion: 0.67 |
151 | 145 | Nodes (4): _, create, debugGetCreateSourceHash, runBuild |
152 | 146 |
|
153 | | -### Community 23 - "Community 23" |
| 147 | +### Community 22 - "Community 22" |
154 | 148 | Cohesion: 0.67 |
155 | 149 | Nodes (4): _, create, debugGetCreateSourceHash, runBuild |
156 | 150 |
|
157 | | -### Community 24 - "Community 24" |
| 151 | +### Community 23 - "Community 23" |
158 | 152 | Cohesion: 0.67 |
159 | 153 | Nodes (4): _, create, debugGetCreateSourceHash, runBuild |
160 | 154 |
|
161 | | -### Community 25 - "Community 25" |
| 155 | +### Community 24 - "Community 24" |
162 | 156 | Cohesion: 0.67 |
163 | 157 | Nodes (4): _, create, debugGetCreateSourceHash, runBuild |
164 | 158 |
|
165 | | -### Community 26 - "Community 26" |
| 159 | +### Community 25 - "Database Providers" |
166 | 160 | Cohesion: 0.67 |
167 | 161 | Nodes (2): debugGetCreateSourceHash, isarDatabase |
168 | 162 |
|
169 | | -### Community 27 - "Community 27" |
| 163 | +### Community 26 - "Profile Utilities" |
170 | 164 | Cohesion: 0.67 |
171 | 165 | Nodes (2): generateProfileHash, ProfileUtils |
172 | 166 |
|
173 | | -### Community 28 - "Community 28" |
| 167 | +### Community 27 - "Community 27" |
174 | 168 | Cohesion: 1.0 |
175 | 169 | Nodes (1): MeshConstants |
176 | 170 |
|
177 | | -### Community 29 - "Community 29" |
| 171 | +### Community 28 - "Community 28" |
178 | 172 | Cohesion: 1.0 |
179 | 173 | Nodes (1): title |
180 | 174 |
|
181 | 175 | ## Knowledge Gaps |
182 | | -- **354 isolated node(s):** `main`, `package:off_chat/src/app.dart`, `OffChatApp`, `_OffChatAppState`, `initState` (+349 more) |
| 176 | +- **340 isolated node(s):** `main`, `NotificationService`, `package:off_chat/src/app.dart`, `OffChatApp`, `_OffChatAppState` (+335 more) |
183 | 177 | These have ≤1 connection - possible missing edges or undocumented components. |
184 | | -- **Thin community `Community 28`** (2 nodes): `constants.dart`, `MeshConstants` |
| 178 | +- **Thin community `Community 27`** (2 nodes): `constants.dart`, `MeshConstants` |
185 | 179 | Too small to be a meaningful cluster - may be noise or needs more connections extracted. |
186 | | -- **Thin community `Community 29`** (2 nodes): `extensions.dart`, `title` |
| 180 | +- **Thin community `Community 28`** (2 nodes): `extensions.dart`, `title` |
187 | 181 | Too small to be a meaningful cluster - may be noise or needs more connections extracted. |
188 | 182 |
|
189 | 183 | ## Suggested Questions |
190 | 184 | _Questions this graph is uniquely positioned to answer:_ |
191 | 185 |
|
192 | | -- **Why does `dart:typed_data` connect `Community 13` to `Community 1`, `Community 2`, `Community 3`, `Community 4`, `Community 5`, `Community 6`, `Community 9`, `Community 11`?** |
193 | | - _High betweenness centrality (0.096) - this node is a cross-community bridge._ |
194 | | -- **Why does `package:flutter/material.dart` connect `Community 3` to `Community 0`, `Community 2`, `Community 4`, `Community 5`, `Community 9`, `Community 10`, `Community 11`, `Community 12`?** |
195 | | - _High betweenness centrality (0.081) - this node is a cross-community bridge._ |
196 | | -- **Why does `package:logging/logging.dart` connect `Community 0` to `Community 1`, `Community 2`, `Community 6`, `Community 11`, `Community 12`, `Community 13`?** |
197 | | - _High betweenness centrality (0.064) - this node is a cross-community bridge._ |
198 | | -- **What connects `main`, `package:off_chat/src/app.dart`, `OffChatApp` to the rest of the system?** |
199 | | - _354 weakly-connected nodes found - possible documentation gaps or missing edges._ |
200 | | -- **Should `Community 0` be split into smaller, more focused modules?** |
201 | | - _Cohesion score 0.05 - nodes in this community are weakly interconnected._ |
202 | | -- **Should `Community 1` be split into smaller, more focused modules?** |
| 186 | +- **Why does `dart:typed_data` connect `Binary Packet Encoding` to `Core Services`, `Mesh Routing`, `Mesh Handshake Logic`, `Geo Utils & Radar`, `Data Management`, `Onboarding UI`, `Mesh Packet Types`?** |
| 187 | + _High betweenness centrality (0.105) - this node is a cross-community bridge._ |
| 188 | +- **Why does `package:flutter/material.dart` connect `App Entry & Lifecycle` to `Mesh Routing`, `Binary Packet Encoding`, `Geo Utils & Radar`, `Data Management`, `Onboarding UI`, `Profile & Identity UI`, `System Health UI`, `Navigation & Routing`?** |
| 189 | + _High betweenness centrality (0.090) - this node is a cross-community bridge._ |
| 190 | +- **Why does `package:logging/logging.dart` connect `Core Services` to `App Entry & Lifecycle`, `Mesh Handshake Logic`, `Binary Packet Encoding`, `Data Management`, `Navigation & Routing`, `Mesh Packet Types`?** |
| 191 | + _High betweenness centrality (0.074) - this node is a cross-community bridge._ |
| 192 | +- **What connects `main`, `NotificationService`, `package:off_chat/src/app.dart` to the rest of the system?** |
| 193 | + _340 weakly-connected nodes found - possible documentation gaps or missing edges._ |
| 194 | +- **Should `Core Services` be split into smaller, more focused modules?** |
203 | 195 | _Cohesion score 0.04 - nodes in this community are weakly interconnected._ |
204 | | -- **Should `Community 2` be split into smaller, more focused modules?** |
| 196 | +- **Should `Mesh Routing` be split into smaller, more focused modules?** |
| 197 | + _Cohesion score 0.05 - nodes in this community are weakly interconnected._ |
| 198 | +- **Should `App Entry & Lifecycle` be split into smaller, more focused modules?** |
205 | 199 | _Cohesion score 0.06 - nodes in this community are weakly interconnected._ |
0 commit comments