qmk-rgb/graphify-out/GRAPH_REPORT.md

Graph Report - qmk-rgb (2026-09-27)

Corpus Check

• 63 files · ~33,138 words
• Verdict: corpus is large enough that graph structure adds value.
• Unclassified: 3 file(s) not represented in the graph (top: (none) 3)

Summary

• 468 nodes · 1112 edges · 28 communities (21 shown, 7 thin omitted)
• Extraction: 87% EXTRACTED · 13% INFERRED · 0% AMBIGUOUS · INFERRED: 142 edges (avg confidence: 0.85)
• Token cost: 0 input · 0 output

Graph Freshness

• Built from commit: 407d52b7
• Run git rev-parse HEAD and compare to check if the graph is stale.
• Run graphify update . after code changes (no API cost).

Community Hubs (Navigation)

• device.go
• impact80.go
• LEDType
• Zone
• profile.go
• hid.go
• effects.go
• What You Must Do When Invoked
• testing.T
• info.go
• graphify.js
• opencode.json
• netdome.biz/paul/qmk-rgb
• Agent Guidelines — QMK RGB Tool
• QMK RGB Tool
• profile_list_test.go
• /qmk-rgb
• Wobkey RGB CLI — Implementation Plan
• graphify reference: extra exports and benchmark
• graphify reference: query, path, explain
• graphify reference: add a URL and watch a folder
• graphify reference: commit hook and native CLAUDE.md integration
• graphify reference: incremental update and cluster-only
• graphify reference: GitHub clone and cross-repo merge
• graphify reference: transcribe video and audio
• CLAUDE.md
• .claude/CLAUDE.md
• extraction-spec.md

God Nodes (most connected - your core abstractions)

1. Zone - 35 edges
2. LEDType - 31 edges
3. selectedZones() - 22 edges
4. AllZones() - 17 edges
5. ResolveEffect() - 15 edges
6. QMK RGB Tool - 15 edges
7. init() - 13 edges
8. NewBrightnessCmd() - 12 edges
9. OpenDevice() - 12 edges
10. selectDevice() - 12 edges

Surprising Connections (you probably didn't know these)

• runBrightness() --references--> LEDType [EXTRACTED] cmd/qmk-rgb-tool/brightness_summary_test.go → internal/via/protocol.go
• appliedFor() --references--> LEDType [EXTRACTED] cmd/qmk-rgb-tool/brightness_verify_test.go → internal/via/protocol.go
• TestSetBrightnessVerifiedReadsBackEveryZone() --calls--> AllZones() [EXTRACTED] cmd/qmk-rgb-tool/brightness_verify_test.go → internal/rgb/impact80.go
• NewColorCmd() --calls--> ParseHexColor() [EXTRACTED] cmd/qmk-rgb-tool/color.go → internal/rgb/effects.go
• TestSelectedChannelStopsOnFirstError() --calls--> AllZones() [EXTRACTED] cmd/qmk-rgb-tool/commands_test.go → internal/rgb/impact80.go

Import Cycles

• None detected.

Communities (28 total, 7 thin omitted)

Community 0 - "device.go"

Cohesion: 0.10 Nodes (38): runRealKeyboardInfo(), stubDiscovery(), TestKeyboardInfoEmitsEmptyArrayNotNull(), TestKeyboardInfoEmitsIndentedJSON(), TestKeyboardInfoPropagatesDiscoveryError(), TestKeyboardInfoWritesOnlyJSON(), formatDeviceList(), selectDevice() (+30 more)

Community 1 - "impact80.go"

Cohesion: 0.10 Nodes (35): listAllEffects(), NewEffectCmd(), resolveEffectTargets(), runEffectSet(), executeEffectCommand(), TestEffectCommandRejectsBeforeOpeningProtocol(), TestEffectCommandSuppressesSuccessAfterLaterWriteFailure(), TestEffectCommandWarnsForSkippedZones() (+27 more)

Community 2 - "LEDType"

Cohesion: 0.10 Nodes (11): TestSelectedChannelStopsOnFirstError(), LEDType, Protocol, New(), commandReport, fakeInfoProtocol, fakeZoneProtocol, infoKey (+3 more)

Community 3 - "Zone"

Cohesion: 0.21 Nodes (20): TestSelectedChannelOperations(), anyMismatch(), disableLightingOnZones(), enableLightingOnZones(), forEachSelectedZone(), setBrightnessOnZones(), setBrightnessVerified(), setColorOnZones() (+12 more)

Community 4 - "profile.go"

Cohesion: 0.10 Nodes (39): TestOneArgCommandsKeepTheirArity(), TestZeroArgCommandsAcceptNoArgs(), TestZeroArgCommandsRejectStrayTokens(), NewBrightnessCmd(), NewColorCmd(), NewDisableCmd(), NewEnableCmd(), NewInfoCmd() (+31 more)

Community 5 - "hid.go"

Cohesion: 0.18 Nodes (12): go_pkg_github_com_sstallion_go_hid, go_pkg_sync, go_pkg_time, Device, DeviceInfo, DevicesInfo, DiscoverAll(), ensureInit() (+4 more)

Community 6 - "effects.go"

Cohesion: 0.19 Nodes (12): sameZones(), TestFilterZonesDoesNotAddMissingZones(), TestFilterZonesDoesNotMutateInput(), TestFilterZonesKeepsOnlyTheSelection(), filterZones(), go_pkg_math, ParseEffect(), ParseHexColor() (+4 more)

Community 7 - "What You Must Do When Invoked"

Cohesion: 0.08 Nodes (24): For /graphify add and --watch, For /graphify query, For the commit hook and native CLAUDE.md integration, For --update and --cluster-only, /graphify, Honesty Rules, Interpreter guard for subcommands, Part A - Structural extraction for code files (+16 more)

Community 8 - "testing.T"

Cohesion: 0.06 Nodes (60): TestAgentsDocDoesNotDuplicateTheCommandTable(), TestAgentsDocDoesNotDuplicateTheEffectCatalog(), TestAgentsDocTellsAgentsToReadTheReadme(), runBrightness(), TestBrightnessReportsPlainMessageWhenAllZonesMatch(), TestBrightnessSummarisesAppliedValuesOnMismatch(), TestBrightnessSummarisesASingleMismatchingZone(), TestBrightnessSummaryNamesOnlySelectedZones() (+52 more)

Community 9 - "info.go"

Cohesion: 0.36 Nodes (9): getInfoValue(), readInfo(), readZoneInfo(), lightingEnabled(), TestLightingEnabledRequiresActiveEffectAndBrightness(), infoColor, infoGetter, infoOutput (+1 more)

Community 10 - "graphify.js"

Cohesion: 0.40 Nodes (3): IMPORTANT: keep the reminder string free of backticks and $(...) constructs., ref_fs, ref_path

Community 13 - "Agent Guidelines — QMK RGB Tool"

Cohesion: 0.10 Nodes (19): Agent Guidelines — QMK RGB Tool, Architecture, Code vs Documentation, Concurrency, Consistency, Constraints, Device Selection, Error Handling (+11 more)

Community 14 - "QMK RGB Tool"

Cohesion: 0.10 Nodes (20): Architecture, Brightness and Speed Are Not Applied Verbatim, CLI Reference, Compatibility Aliases, Effect Behavior, Features, Impact 80 Zones and Effects, Installation (+12 more)

Community 15 - "profile_list_test.go"

Cohesion: 0.46 Nodes (7): runProfileList(), TestProfileListEmitsJSONWithoutProfiles(), TestProfileListEmitsJSONWithProfiles(), TestProfileListUsesTheSharedJSONShape(), withProfilesDir(), go_pkg_path_filepath, profileListOutput

Community 16 - "/qmk-rgb"

Cohesion: 0.15 Nodes (12): 1. First, get the tool's own help, 2. If the tool is not built or no keyboard is connected, 3. When a user wants to change something, 4. Profiles, Compatibility aliases, How to answer, Known limitations, /qmk-rgb (+4 more)

Community 18 - "Wobkey RGB CLI — Implementation Plan"

Cohesion: 0.18 Nodes (10): Continue With Hardware, Cross-Platform HID Backends, Effect Families, Handoff Status, Hardware Environment, Open Issues, Status, Verification (+2 more)

Community 19 - "graphify reference: extra exports and benchmark"

Cohesion: 0.22 Nodes (8): graphify reference: extra exports and benchmark, Step 6b - Wiki (only if --wiki flag), Step 7 - Neo4j export (only if --neo4j or --neo4j-push flag), Step 7a - FalkorDB export (only if --falkordb or --falkordb-push flag), Step 7b - SVG export (only if --svg flag), Step 7c - GraphML export (only if --graphml flag), Step 7d - MCP server (only if --mcp flag), Step 8 - Token reduction benchmark (only if total_words > 5000)

Community 20 - "graphify reference: query, path, explain"

Cohesion: 0.33 Nodes (5): For /graphify explain, For /graphify path, graphify reference: query, path, explain, Step 0 — Constrained query expansion (REQUIRED before traversal), Step 1 — Traversal

Community 21 - "graphify reference: add a URL and watch a folder"

Cohesion: 0.50 Nodes (3): For /graphify add, For --watch, graphify reference: add a URL and watch a folder

Community 22 - "graphify reference: commit hook and native CLAUDE.md integration"

Cohesion: 0.50 Nodes (3): For git commit hook, For native CLAUDE.md integration, graphify reference: commit hook and native CLAUDE.md integration

Community 23 - "graphify reference: incremental update and cluster-only"

Cohesion: 0.50 Nodes (3): For --cluster-only, For --update (incremental re-extraction), graphify reference: incremental update and cluster-only

Knowledge Gaps

• 99 isolated node(s): $schema, plugin, profileListOutput, netdome.biz/paul/qmk-rgb, LEDParam (+94 more) These have ≤1 connection - possible missing edges or undocumented components. (Counts symbols only; 144 node(s) total have ≤1 connection when file, concept and rationale nodes are included.)
• 7 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 LEDType connect LEDType to impact80.go, Zone, profile.go, testing.T, info.go? High betweenness centrality (0.049) - this node is a cross-community bridge.
• Why does Zone connect Zone to impact80.go, profile.go, info.go, effects.go? High betweenness centrality (0.022) - this node is a cross-community bridge.
• Are the 3 inferred relationships involving Zone (e.g. with TestImpact80DefaultEffects() and TestImpact80LogoAndSideCatalog()) actually correct? Zone has 3 INFERRED edges - model-reasoned connections that need verification.
• Are the 18 inferred relationships involving selectedZones() (e.g. with NewBrightnessCmd() and NewColorCmd()) actually correct? selectedZones() has 18 INFERRED edges - model-reasoned connections that need verification.
• What connects $schema, plugin, profileListOutput to the rest of the system? 99 weakly-connected nodes found - possible documentation gaps or missing edges.
• Should device.go be split into smaller, more focused modules? Cohesion score 0.10077519379844961 - nodes in this community are weakly interconnected.
• Should impact80.go be split into smaller, more focused modules? Cohesion score 0.09872241579558652 - nodes in this community are weakly interconnected.