Kord/graphify-out/GRAPH_REPORT.md

181 lines
6.2 KiB
Markdown

# Graph Report - . (2026-04-09)
## Corpus Check
- 124 files · ~92,302 words
- Verdict: corpus is large enough that graph structure adds value.
## Summary
- 316 nodes · 549 edges · 29 communities detected
- Extraction: 64% EXTRACTED · 36% INFERRED · 0% AMBIGUOUS · INFERRED: 197 edges (avg confidence: 0.5)
- Token cost: 0 input · 0 output
## God Nodes (most connected - your core abstractions)
1. `FishingService` - 55 edges
2. `MusicService` - 38 edges
3. `RefinementService` - 13 edges
4. `VoiceService` - 8 edges
5. `PermissionAuditService` - 7 edges
6. `execute()` - 6 edges
7. `InviteService` - 6 edges
8. `AuditLogService` - 6 edges
9. `EventService` - 6 edges
10. `buildEventEmbed()` - 5 edges
## Surprising Connections (you probably didn't know these)
- None detected - all connections are within the same source files.
## Communities
### Community 0 - "Community 0"
Cohesion: 0.05
Nodes (6): ActivityTrackerService, buildEventEmbed(), EventService, resolveAnnouncementChannel(), toDiscordTimestamps(), KordClient
### Community 1 - "Community 1"
Cohesion: 0.08
Nodes (1): FishingService
### Community 2 - "Community 2"
Cohesion: 0.11
Nodes (6): extractYouTubeVideoId(), formatDuration(), isYouTubePlaylistUrl(), MusicService, parseDurationSeconds(), parseDurationTextToSeconds()
### Community 3 - "Community 3"
Cohesion: 0.14
Nodes (5): getNestedValue(), normalizeDiscordLocale(), resolveLocale(), StaticI18nProvider, t()
### Community 4 - "Community 4"
Cohesion: 0.15
Nodes (3): BotError, ErrorReporter, withErrorHandler()
### Community 5 - "Community 5"
Cohesion: 0.16
Nodes (4): execute(), getOverallColor(), PermissionAuditService, SetupWizardRenderer
### Community 6 - "Community 6"
Cohesion: 0.37
Nodes (1): RefinementService
### Community 7 - "Community 7"
Cohesion: 0.18
Nodes (3): BigEmojiService, MimicService, WebhookService
### Community 8 - "Community 8"
Cohesion: 0.36
Nodes (9): Fishing Game Backend Logic, Authentication/Authorization Layer, Database Schema Design (User/Item), Frontend Game Client (React/Unity), Payment Gateway Integration (Stripe/PayPal), Real-time Communication (WebSockets), Game State Management (Session/Persistence), Analytics/Telemetry Tracking (+1 more)
### Community 9 - "Community 9"
Cohesion: 0.46
Nodes (1): VoiceService
### Community 10 - "Community 10"
Cohesion: 0.52
Nodes (6): buildStatusLabel(), execute(), formatReminderOffsets(), parseReminderOffsets(), parseSeoulDateTime(), toDiscordTimestamps()
### Community 11 - "Community 11"
Cohesion: 0.33
Nodes (2): buildFishingGauge(), buildFishingLane()
### Community 12 - "Community 12"
Cohesion: 0.6
Nodes (1): InviteService
### Community 13 - "Community 13"
Cohesion: 0.47
Nodes (1): AuditLogService
### Community 14 - "Community 14"
Cohesion: 0.4
Nodes (0):
### Community 15 - "Community 15"
Cohesion: 0.4
Nodes (0):
### Community 16 - "Community 16"
Cohesion: 0.83
Nodes (3): buildErrorMessage(), execute(), respond()
### Community 17 - "Community 17"
Cohesion: 0.5
Nodes (1): FeverService
### Community 18 - "Community 18"
Cohesion: 0.67
Nodes (1): PresenceService
### Community 19 - "Community 19"
Cohesion: 1.0
Nodes (0):
### Community 20 - "Community 20"
Cohesion: 1.0
Nodes (2): main.ts, config.ts
### Community 21 - "Community 21"
Cohesion: 1.0
Nodes (1): FishingGameConcept
### Community 22 - "Community 22"
Cohesion: 1.0
Nodes (0):
### Community 23 - "Community 23"
Cohesion: 1.0
Nodes (0):
### Community 24 - "Community 24"
Cohesion: 1.0
Nodes (1): Gemma 4 Response
### Community 25 - "Community 25"
Cohesion: 1.0
Nodes (1): Tool Use Concept
### Community 26 - "Community 26"
Cohesion: 1.0
Nodes (1): Capability Summary
### Community 27 - "Community 27"
Cohesion: 1.0
Nodes (1): db.ts
### Community 28 - "Community 28"
Cohesion: 1.0
Nodes (1): logger.ts
## Knowledge Gaps
- **Thin community `Community 19`** (2 nodes): `language.ts`, `execute()`
Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 20`** (2 nodes): `main.ts`, `config.ts`
Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 21`** (1 nodes): `FishingGameConcept`
Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 22`** (1 nodes): `jest.config.js`
Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 23`** (1 nodes): `i18n.test.ts`
Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 24`** (1 nodes): `Gemma 4 Response`
Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 25`** (1 nodes): `Tool Use Concept`
Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 26`** (1 nodes): `Capability Summary`
Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 27`** (1 nodes): `db.ts`
Too small to be a meaningful cluster - may be noise or needs more connections extracted.
- **Thin community `Community 28`** (1 nodes): `logger.ts`
Too small to be a meaningful cluster - may be noise or needs more connections extracted.
## Suggested Questions
_Questions this graph is uniquely positioned to answer:_
- **Why does `FishingService` connect `Community 1` to `Community 11`?**
_High betweenness centrality (0.272) - this node is a cross-community bridge._
- **Why does `RefinementService` connect `Community 6` to `Community 0`?**
_High betweenness centrality (0.067) - this node is a cross-community bridge._
- **Should `Community 0` be split into smaller, more focused modules?**
_Cohesion score 0.05 - nodes in this community are weakly interconnected._
- **Should `Community 1` be split into smaller, more focused modules?**
_Cohesion score 0.08 - nodes in this community are weakly interconnected._
- **Should `Community 2` be split into smaller, more focused modules?**
_Cohesion score 0.11 - nodes in this community are weakly interconnected._
- **Should `Community 3` be split into smaller, more focused modules?**
_Cohesion score 0.14 - nodes in this community are weakly interconnected._