qmk-rgb/graphify-out/GRAPH_REPORT.md

Graph Report - impact-80 (2026-09-25)

Corpus Check

• 38 files · ~18,786 words
• Verdict: corpus is large enough that graph structure adds value.
• Unclassified: 1 file(s) not represented in the graph (top: (none) 1)

Summary

• 231 nodes · 406 edges · 23 communities (16 shown, 7 thin omitted)
• Extraction: 94% EXTRACTED · 6% INFERRED · 0% AMBIGUOUS · INFERRED: 25 edges (avg confidence: 0.85)
• Token cost: 0 input · 0 output

Graph Freshness

• Built from commit: 216e2dbe
• 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)

• Open Issues
• main.go
• hid.go
• OpenDevice
• device.go
• What You Must Do When Invoked
• testing.T
• Agent Guidelines — Wobkey Impact 80 RGB CLI
• Protocol
• Wobkey RGB CLI
• graphify.js
• graphify reference: extra exports and benchmark
• opencode.json
• github.com/wobkey/rgb
• 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. OpenDevice() - 14 edges
2. What You Must Do When Invoked - 12 edges
3. init() - 10 edges
4. /graphify - 10 edges
5. Agent Guidelines — Wobkey Impact 80 RGB CLI - 10 edges
6. Keyboard - 8 edges
7. Device - 8 edges
8. graphify reference: extra exports and benchmark - 8 edges
9. Go Development - 8 edges
10. Wobkey RGB CLI - 8 edges

Surprising Connections (you probably didn't know these)

• Info --references--> Device [EXTRACTED] cmd/wobkey/main.go → internal/device/device.go
• NewColorCmd() --calls--> ParseHexColor() [EXTRACTED] cmd/wobkey/rgb/color.go → internal/rgb/effects.go
• GetAvailableEffects() --references--> Keyboard [EXTRACTED] cmd/wobkey/rgb/effect.go → internal/device/device.go
• OpenDevice() --calls--> Discover() [EXTRACTED] cmd/wobkey/rgb/rgb.go → internal/device/device.go
• OpenDevice() --references--> Keyboard [EXTRACTED] cmd/wobkey/rgb/rgb.go → internal/device/device.go

Import Cycles

• None detected.

Communities (23 total, 7 thin omitted)

Community 0 - "Open Issues"

Cohesion: 0.25 Nodes (7): 1. Impact 80 Effect Mapping, 2. Cross-Platform HID Backends, 3. Documentation and Release Artifacts, Open Issues, Quick Commands for Next Session, Status, Wobkey RGB CLI — Implementation Plan

Community 1 - "main.go"

Cohesion: 0.23 Nodes (12): Execute(), main(), go_pkg_encoding_json, go_pkg_fmt, go_pkg_github_com_spf13_cobra, go_pkg_math, go_pkg_os, ParseHexColor() (+4 more)

Community 2 - "hid.go"

Cohesion: 0.10 Nodes (20): go_pkg_bytes, go_pkg_strings, go_pkg_syscall, go_pkg_time, go_pkg_unsafe, Device, DevicesInfo, DiscoverAll() (+12 more)

Community 3 - "OpenDevice"

Cohesion: 0.19 Nodes (20): init(), NewBrightnessCmd(), NewColorCmd(), NewDisableCmd(), GetAvailableEffects(), NewEffectCmd(), NewEnableCmd(), NewInfoCmd() (+12 more)

Community 4 - "device.go"

Cohesion: 0.29 Nodes (11): go_pkg_path_filepath, Discover(), Device, Keyboard, LoadKeyboards(), matchKeyboards(), TestLoadKeyboards(), TestLoadKeyboardsEmptyFile() (+3 more)

Community 5 - "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 6 - "testing.T"

Cohesion: 0.15 Nodes (14): TestDeviceFlagIsInheritedByRGBCommands(), TestLightingEnabledRequiresActiveEffectAndBrightness(), go_pkg_testing, testing.T, TestColorToHSV(), TestQMKValueIDs(), TestDisableLightingUsesAllImpact80Channels(), TestEnableLightingUsesAllImpact80Channels() (+6 more)

Community 7 - "Agent Guidelines — Wobkey Impact 80 RGB CLI"

Cohesion: 0.11 Nodes (17): Agent Guidelines — Wobkey Impact 80 RGB CLI, Architecture, CLI Interface, Concurrency, Constraints, Error Handling, Go Development, graphify (+9 more)

Community 9 - "Protocol"

Cohesion: 0.27 Nodes (4): Protocol, LEDType, Message, transport

Community 10 - "Wobkey RGB CLI"

Cohesion: 0.18 Nodes (10): Architecture, CLI Reference, Installation, Linux HID Device Permissions, Option 1: Quick (Per Session), Option 2: Permanent (udev Rule), Protocol, Supported Keyboards (+2 more)

Community 11 - "graphify.js"

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

Community 12 - "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 15 - "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 16 - "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 17 - "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 18 - "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

• 75 isolated node(s): $schema, plugin, github.com/wobkey/rgb, LEDParam, graphify (+70 more) These have ≤1 connection - possible missing edges or undocumented components. (Counts symbols only; 110 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 Protocol connect Protocol to main.go, hid.go, OpenDevice, device.go? High betweenness centrality (0.026) - this node is a cross-community bridge.
• Why does OpenDevice() connect OpenDevice to Protocol, hid.go, device.go? High betweenness centrality (0.018) - this node is a cross-community bridge.
• Are the 8 inferred relationships involving OpenDevice() (e.g. with NewBrightnessCmd() and NewColorCmd()) actually correct? OpenDevice() has 8 INFERRED edges - model-reasoned connections that need verification.
• What connects $schema, plugin, github.com/wobkey/rgb to the rest of the system? 75 weakly-connected nodes found - possible documentation gaps or missing edges.
• Should hid.go be split into smaller, more focused modules? Cohesion score 0.10052910052910052 - nodes in this community are weakly interconnected.
• Should What You Must Do When Invoked be split into smaller, more focused modules? Cohesion score 0.08 - nodes in this community are weakly interconnected.
• Should Agent Guidelines — Wobkey Impact 80 RGB CLI be split into smaller, more focused modules? Cohesion score 0.1111111111111111 - nodes in this community are weakly interconnected.