Files
led-controller/graphify-out/2026-11-12/GRAPH_REPORT.md
T

762 lines
39 KiB
Markdown

# Graph Report - led-controller (2026-11-12)
## Corpus Check
- 262 files · ~238,901 words
- Verdict: corpus is large enough that graph structure adds value.
- Unclassified: 52 file(s) not represented in the graph (top: (none) 26, .mdc 6, .css 6)
## Summary
- 3524 nodes · 8659 edges · 184 communities (125 shown, 59 thin omitted)
- Extraction: 84% EXTRACTED · 16% INFERRED · 0% AMBIGUOUS · INFERRED: 1379 edges (avg confidence: 0.85)
- Token cost: 0 input · 0 output
## Graph Freshness
- Built from commit: `c4f8a513`
- 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)
- IdfDevice
- htmx Library
- machine.py
- Browser Tests & Mockup Images
- Audio UI (JS)
- ESP-NOW TX & DMX Pulse
- audio.c
- led-tool Device CLI
- ab
- Compiler
- Spec: Pi Animation Engine
- led-driver/main/ota.c
- Presets UI (JS)
- Zones UI (JS)
- patterns.c
- new_id
- Sequences UI (JS)
- server.py
- led_strip Component Docs
- Art-Net Output
- main/main.c
- esp_log
- engine.c
- ws.c
- Microdot
- led_strip_rmt_dev.c
- seqplay.c
- Devices UI (JS)
- binary_envelope.py
- Colour Picker Mockups
- PyboardCommand
- beat.c
- web.cpp
- test_sequences.py
- microdot.py
- API Docs: Outputs & Audio
- led_strip_spi_dev.c
- store_save
- Beat Detection DSP (C)
- audio_api.c
- sim_stubs.c
- run_all
- ws_client.cpp
- time
- test_presets.py
- BridgeSim
- USB Latency Tools
- Colour Picker JS
- Chromium Colour Picker JS
- WS2812
- API Tests: Devices
- Transport
- mpremote Transport
- Outputs Config (C)
- patterns.cpp
- test_routes.py
- ESPNow
- test_outputs.py
- microdot.py
- mpremote Serial Transport
- API Test Fixtures & Audio
- Microdot Request (dmx)
- Help: Zones & Palette
- ddp_test.py
- test_audio.py
- esp_timer_get_time
- os
- build_app
- main/ota.c
- Index Page Modals
- NeoPixel
- Microdot WebSocket (dmx)
- store_lock
- json
- Controller Overview & OTA Docs
- usb_cfg.cpp
- Audio Monitor Page
- Art-Net DMX Tests
- DMX Output Manager
- bridge_sim.py
- LedSimulatorApp
- unique
- ESP-NOW Sender Bridge
- net.cpp
- Microdot Async IO (dmx)
- DMX Settings
- Rig
- packet
- Microdot Routing (dmx)
- Bench Test Plan
- envelope.c
- api_call_t
- Microdot Auth (dmx)
- Serial DMX & WiFi
- DMX Pattern Player
- DMX Preset Model
- status_get_handler
- ddp.cpp
- Groups UI (JS)
- rig_seed.py
- Help: Mobile Menu Image
- Pattern Selector Mockup Image
- Driver Pattern Docs
- ._loop_main
- find_devices
- esp_timer_get_time
- Driver Message API Docs
- engine_init
- led_strip Manifest
- ws_slot_t
- Outputs UI (JS)
- DMX Driver Docs
- Help PDF: Overview
- Mockups Index Image
- read_serial
- Help: Header Toolbar Image
- Help: Preset Editor Image
- Dashboard Mockup Image
- Device Management Mockup Image
- Presets Mockup Image
- Pattern Contract
- Numpad Shortcuts (JS)
- Colour Picker Demo Image
- Settings Mockup Image
- sim_demo.py
- store_coll
- Help: Colour Palette Image
- LED Driver README
- machine.py
- SPI Example Manifest
- test_rig_sim.py
- settings_editor.js
- Help PDF: Modes
- Help: Tab Preset Strip Image
- res_device.c
- api_error
- app.js
- RMT Example Manifest
- Help Tab JS
- Settings Page Template
- led-driver/web/app.js
- sequences_route
- api_id
- dependencies
- List Search (JS)
- DMX Solid Pattern
- led-test Manifest
- VPN Autoconnect Script
- graphify Instructions
- bulk.sh Script
- deploy.sh Script
- Driver install.sh
- led-tool install.sh
- Help PDF Build Script
- Web Build Script
- Spec: Pattern Selector UI
- presets.cpp
- res_group.c
- _simlink_web.py
- _simlink_proc.py
- WLAN
- NoCaseDict
- SimRing
- dependencies
- examples/blink.py
- README.md
## God Nodes (most connected - your core abstractions)
1. `store_coll()` - 69 edges
2. `api_error()` - 51 edges
3. `api_json()` - 47 edges
4. `unique()` - 43 edges
5. `ab()` - 42 edges
6. `api_set()` - 41 edges
7. `new_id()` - 41 edges
8. `get_colours()` - 39 edges
9. `store_save()` - 39 edges
10. `esp_timer_get_time()` - 36 edges
## Surprising Connections (you probably didn't know these)
- `Preset editor modal` --semantically_similar_to--> `Preset fields (pattern, colors, delay, brightness, auto, n1-n6)` [INFERRED] [semantically similar]
web/templates/index.html → led-driver/docs/API.md
- `led-driver-style pattern engine (Preset object)` --semantically_similar_to--> `led-driver MicroPython firmware (submodule)` [INFERRED] [semantically similar]
dmx-driver/README.md → README.md
- `espnow-sender Microdot WebSocket receiver` --semantically_similar_to--> `WebSocket /ws driver message relay` [INFERRED] [semantically similar]
espnow-sender/README.md → docs/API.md
- `Art-Net output (UDP 6454)` --semantically_similar_to--> `Outputs (DDP, Art-Net, sACN, DMX serial pixel fixtures)` [INFERRED] [semantically similar]
dmx-driver/README.md → docs/API.md
- `POST /patterns/upload (led-driver parity)` --semantically_similar_to--> `Patterns resource /patterns` [INFERRED] [semantically similar]
dmx-driver/README.md → docs/API.md
## Import Cycles
- None detected.
## Hyperedges (group relationships)
- **Audio page live endpoints** — web_audio_status, web_audio_beats, web_audio_audio_wav, web_audio_time, web_audio_tap_ep [EXTRACTED 1.00]
- **Beat latency measurement methods** — docs_api_bench_endpoints, docs_bench_test_usb_latency, docs_bench_test_logic_analyzer, docs_bench_test_beat_lead [EXTRACTED 1.00]
- **Combined brightness factors** — docs_api_combined_brightness, docs_api_settings, docs_api_groups, docs_api_devices, docs_api_zones [EXTRACTED 1.00]
- **Color picker feature set** — docs_mockups_images_color_picker_demo_hsb_color_model, docs_mockups_images_color_picker_demo_hex_rgb_input, docs_mockups_images_color_picker_demo_keyboard_accessibility, docs_mockups_images_color_picker_demo_cross_platform_consistency [EXTRACTED 1.00]
- **Edit-mode-only management features** — docs_help_edit_mode, docs_help_zones_modal, docs_help_send_presets, docs_help_patterns_dialog, docs_help_colour_palette, docs_help_presets_list [EXTRACTED 1.00]
- **Preset editor actions (Try, Default, Save & Send, Remove from zone)** — docs_help_try_action, docs_help_default_preset, docs_help_save_and_send, docs_help_remove_from_zone [EXTRACTED 1.00]
- **Header actions aggregated in mobile Menu** — docs_images_help_mobile_menu_run_mode, docs_images_help_mobile_menu_profiles, docs_images_help_mobile_menu_tabs, docs_images_help_mobile_menu_presets, docs_images_help_mobile_menu_help [EXTRACTED 1.00]
- **Device/Group Modal Flow** — docs_mockups_device_management_showadddevicemodal, docs_mockups_device_management_showaddgroupmodal, docs_mockups_device_management_closemodal, docs_mockups_device_management_savedevice [EXTRACTED 1.00]
- **LED Driver UI Mockup Set** — docs_mockups_images_index_dashboard_mockup, docs_mockups_images_index_pattern_selector_mockup, docs_mockups_images_index_device_management_mockup, docs_mockups_images_index_settings_mockup, docs_mockups_images_index_presets_mockup [EXTRACTED 1.00]
- **Selectable LED Patterns** — docs_mockups_images_pattern_selector_on, docs_mockups_images_pattern_selector_off, docs_mockups_images_pattern_selector_blink, docs_mockups_images_pattern_selector_chase, docs_mockups_images_pattern_selector_circle, docs_mockups_images_pattern_selector_pulse, docs_mockups_images_pattern_selector_rainbow, docs_mockups_images_pattern_selector_transition [EXTRACTED 1.00]
- **Preset/pattern configuration schema (pattern, colors, delay, step increment, N1-N8)** — docs_mockups_presets_led_patterns, docs_mockups_presets_delay, docs_mockups_presets_step_increment, docs_mockups_presets_n_parameters, docs_mockups_presets_step_offset [EXTRACTED 1.00]
- **Device settings sections** — docs_mockups_settings_basic_settings, docs_mockups_settings_pattern_settings, docs_mockups_settings_advanced_settings, docs_mockups_settings_network_settings [EXTRACTED 1.00]
- **LED Driver UI Mockup Suite** — docs_mockups_index, docs_mockups_dashboard, docs_mockups_pattern_selector, docs_mockups_device_management, docs_mockups_readme_settings_mockup, docs_mockups_color_picker_readme_presets_mockup [EXTRACTED 1.00]
- **Pi-to-ESP32 Command Paths** — docs_specification_serial_espnow_bridge, docs_specification_wifi_driver_tcp, docs_specification_espnow, docs_specification_pi_controller [EXTRACTED 1.00]
- **led_strip backend choice (RMT vs SPI, DMA)** — scripts_led_test_managed_components_espressif__led_strip_readme_rmt_backend, scripts_led_test_managed_components_espressif__led_strip_readme_spi_backend, scripts_led_test_managed_components_espressif__led_strip_readme_dma_support, scripts_led_test_managed_components_espressif__led_strip_readme_backend_selection_flowchart [EXTRACTED 1.00]
- **led_strip pixel write and flush flow** — scripts_led_test_managed_components_espressif__led_strip_api_led_strip_set_pixel, scripts_led_test_managed_components_espressif__led_strip_api_led_strip_set_pixel_hsv, scripts_led_test_managed_components_espressif__led_strip_api_led_strip_set_pixel_rgbw, scripts_led_test_managed_components_espressif__led_strip_api_led_strip_refresh, scripts_led_test_managed_components_espressif__led_strip_api_led_strip_clear [EXTRACTED 1.00]
- **Dynamic pattern contract** — led_driver_docs_pattern_contract_class_shape, led_driver_docs_pattern_contract_run_generator_rules, led_driver_docs_pattern_contract_drawing_brightness, led_driver_docs_pattern_contract_step_semantics, led_driver_docs_pattern_contract_error_handling [EXTRACTED 1.00]
- **Pi Animation Engine Output Pipeline** — docs_specification_pixel_generator, docs_specification_output_drivers, docs_specification_output_record, docs_specification_zone_playback, docs_specification_sequencer [EXTRACTED 1.00]
- **Beat-Driven Scene Activation** — docs_specification_beat_detection_device, docs_specification_bpm_sync, docs_specification_beat_counter_phases, docs_specification_scene_queue [INFERRED 0.85]
- **Fields defining an LED preset (name, pattern, colours, parameters)** — docs_images_help_preset_editor_preset_name_field, docs_images_help_preset_editor_pattern_selector, docs_images_help_preset_editor_palette_linked_colour, docs_images_help_preset_editor_preset_parameters [INFERRED 0.85]
- **Pattern settings composed and applied to devices** — docs_mockups_images_dashboard_pattern_selection, docs_mockups_images_dashboard_brightness_speed, docs_mockups_images_dashboard_colors, docs_mockups_images_dashboard_apply_settings [INFERRED 0.85]
- **Preset lifecycle actions (create, apply, sync)** — docs_mockups_images_presets_create_preset, docs_mockups_images_presets_apply_preset, docs_mockups_images_presets_sync_presets_to_all_devices [INFERRED 0.85]
- **ESP-NOW driver delivery layers** — docs_api_binary_envelope, docs_api_delivery_digest, docs_bench_test_reliable_link, docs_bench_test_beat_double_send [INFERRED 0.85]
- **v1 message handling on driver** — led_driver_docs_api_v1_message, led_driver_docs_patterns_process_data_flow, led_driver_docs_patterns_pattern_registry, led_driver_docs_patterns_preset_short_keys, led_driver_docs_api_select_message [INFERRED 0.85]
## Communities (184 total, 59 thin omitted)
### Community 0 - "IdfDevice"
Cohesion: 0.10
Nodes (7): _idf_post(), _idf_show(), print_settings(), run_idf(), IdfDevice, IdfError, probe()
### Community 1 - "htmx Library"
Cohesion: 0.08
Nodes (101): a(), Ae(), an(), at(), B(), be(), bn(), bt() (+93 more)
### Community 3 - "Browser Tests & Mockup Images"
Cohesion: 0.06
Nodes (17): generate_image(), generate_with_html2image(), generate_with_playwright(), generate_with_selenium(), main(), browser(), _browser_sleep(), BrowserTest (+9 more)
### Community 4 - "Audio UI (JS)"
Cohesion: 0.11
Nodes (58): applyAudioStatus(), applyServerAudioUiFields(), audioRunPreferredDeviceId(), beatSyncButtonTitle(), bind(), clampLiveBpm(), clampSimulatedBpm(), clearBeatPhaseTimers() (+50 more)
### Community 5 - "ESP-NOW TX & DMX Pulse"
Cohesion: 0.09
Nodes (16): bench_on_echo(), bridge_active(), bridge_send(), bridge_start(), ap_event(), bulk_task(), espnow_tx_drop(), espnow_tx_init() (+8 more)
### Community 6 - "audio.c"
Cohesion: 0.08
Nodes (17): Pulse, audio_get_handler(), audio_register(), audio_stream_task(), beats_get_handler(), send_all(), tap_post_handler(), time_get_handler() (+9 more)
### Community 7 - "led-tool Device CLI"
Cohesion: 0.08
Nodes (12): download_presets(), download_settings(), _get_ordered_actions(), main(), resolve_flash_binary(), upload_presets(), upload_settings(), copy_file() (+4 more)
### Community 8 - "ab"
Cohesion: 0.12
Nodes (84): chase_draw(), ease_t(), first_call(), fx_aurora(), fx_bar_graph(), fx_blink(), fx_blizzard(), fx_candle_glow() (+76 more)
### Community 9 - "Compiler"
Cohesion: 0.07
Nodes (5): Template, Loader, Loader, Compiler, Loader
### Community 10 - "Spec: Pi Animation Engine"
Cohesion: 0.07
Nodes (46): Pi Animation Engine (src/engine), docs/API.md, Beat Counter and Phases, Beat Detection Device, Binary Message Protocol, BPM Sync, Dashboard UI (dashboard.html), usqlite Database Schema (presets, profiles, scenes, scene_groups) (+38 more)
### Community 11 - "led-driver/main/ota.c"
Cohesion: 0.20
Nodes (10): fail(), ota_get_handler(), ota_post_handler(), ota_preflight_handler(), ota_register(), reboot_post_handler(), add_uri(), open_nodelay() (+2 more)
### Community 12 - "Presets UI (JS)"
Cohesion: 0.09
Nodes (42): arrayToGrid(), coerceManualBeatN(), coercePresetAuto(), coercePresetBackground(), coercePresetInt(), createPresetButton(), deviceNamesForPresetOnCurrentZone(), editPresetFromTab() (+34 more)
### Community 13 - "Zones UI (JS)"
Cohesion: 0.10
Nodes (42): applyBrightnessSliders(), applyZoneContentKindEditModal(), clamp255(), computeZoneNamesTargets(), computeZonePresetUnionTargets(), computeZoneTargets(), createZone(), effectiveGroupIdsForZonePreset() (+34 more)
### Community 14 - "patterns.c"
Cohesion: 0.12
Nodes (31): fn, add_name(), all_patterns(), base_name(), builtin(), create_pattern(), exists(), file_names() (+23 more)
### Community 15 - "new_id"
Cohesion: 0.08
Nodes (13): new_id(), test_preset_round_trip(), test_profile_round_trip(), test_sequence_round_trip(), test_play_needs_steps(), test_play_needs_zone(), test_scoped_to_profile(), test_clone() (+5 more)
### Community 16 - "Sequences UI (JS)"
Cohesion: 0.08
Nodes (55): addSeqTarget(), addSequenceToTab(), addTargetsPerDriver(), appendZoneSequenceTiles(), applySequenceEditorMode(), applySequenceKindUi(), applySequenceSwitchWaitFromServer(), buildLaneGroupIdsForEditor() (+47 more)
### Community 17 - "server.py"
Cohesion: 0.14
Nodes (12): normalise_layout(), _reversed_for_column(), rig_placements(), side_name(), strip_count(), strip_places(), StripPlace, lan_ip() (+4 more)
### Community 19 - "led_strip Component Docs"
Cohesion: 0.10
Nodes (36): led_test ESP-IDF project, led_test main component (main.c), led_strip API Reference, led_model_t (WS2812/SK6812), led_pixel_format_t (GRB/GRBW), led_strip_clear(), led_strip_config_t, led_strip_del() (+28 more)
### Community 20 - "Art-Net Output"
Cohesion: 0.10
Nodes (10): ArtNet, as_channels(), build_artdmx(), _ip_bytes(), _pad(), port_lo(), sleep_ms(), ticks_diff() (+2 more)
### Community 21 - "main/main.c"
Cohesion: 0.10
Nodes (15): app_main(), dhcp_settled(), eth_event_handler(), gateway_answers(), got_ip_event_handler(), have_static_ips(), link_up_task(), parse_static() (+7 more)
### Community 22 - "esp_log"
Cohesion: 0.12
Nodes (20): app_main(), app_main(), configure_led(), app_main(), configure_led(), led_strip_rmt_config_t, led_strip_spi_config_t, led_model_t (+12 more)
### Community 23 - "engine.c"
Cohesion: 0.15
Nodes (39): build_groups(), compact(), compact_preset(), device_name_for(), driver_in_zone(), emit_c(), emit_json(), emit_zone() (+31 more)
### Community 24 - "ws.c"
Cohesion: 0.44
Nodes (5): forward(), on_open(), send_text(), ws_handler(), ws_register()
### Community 26 - "led_strip_rmt_dev.c"
Cohesion: 0.16
Nodes (10): led_strip_rmt_clear(), led_strip_rmt_del(), led_strip_rmt_refresh(), led_strip_rmt_set_pixel(), led_strip_rmt_set_pixel_rgbw(), led_strip_encoder_config_t, rmt_del_led_strip_encoder(), rmt_encode_led_strip() (+2 more)
### Community 27 - "seqplay.c"
Cohesion: 0.12
Nodes (50): engine_zone_current(), add_id(), advance_time(), anchor_bar(), audio_drives(), beat_task(), bit(), chase_mask() (+42 more)
### Community 28 - "Devices UI (JS)"
Cohesion: 0.10
Nodes (32): applyEspnowPingAggregateToDots(), applyEspnowPingToDeviceRows(), applyTcpSnapshot(), applyTransportVisibility(), collectDeviceEditPayload(), createDeviceFromModal(), createDeviceIdentifyButton(), DEVICE_DOT_CLASSES (+24 more)
### Community 29 - "binary_envelope.py"
Cohesion: 0.15
Nodes (18): brightness_0_255_from_wire(), brightness_wire_from_0_255(), _clamp_i16(), _colors_to_rgb_list(), _decode_default_blob(), _decode_preset_record(), _decode_presets_blob(), _decode_select_blob() (+10 more)
### Community 30 - "Colour Picker Mockups"
Cohesion: 0.11
Nodes (25): Chromium-style Color Picker Demo, ColorPickerChromium Component, updateColors() (Chromium demo), Custom Color Picker Demo, updateColors() (standard demo), Custom Colour Picker README, POST /api/colors (example), ColorPicker Component (+17 more)
### Community 32 - "beat.c"
Cohesion: 0.07
Nodes (23): beats_stream_task(), beat_reset(), beat_set_callback(), beat_start(), beat_subscribe(), beat_unsubscribe(), beat_dsp_bpm(), dsp_event() (+15 more)
### Community 33 - "web.cpp"
Cohesion: 0.11
Nodes (53): api_call_work(), api_fn_t, api_http_entry(), api_req_t, api_route_t, app_js_get(), brightness_post(), ddp_get() (+45 more)
### Community 34 - "test_sequences.py"
Cohesion: 0.19
Nodes (19): clock(), make(), presets(), test_animation_over_sequence_keeps_time(), test_animation_plays_once_alone(), test_animation_step_fires_overlay(), test_beat_and_time_lanes_together(), test_chase_moves_and_bounces() (+11 more)
### Community 35 - "microdot.py"
Cohesion: 0.10
Nodes (5): HTTPException, iscoroutine(), Response, aclose(), __anext__()
### Community 36 - "API Docs: Outputs & Audio"
Cohesion: 0.14
Nodes (23): Art-Net output (UDP 6454), Audio API /api/audio and /audio page routes, Profile/preset/sequence JSON bundles (import/export), Combined brightness (global x groups x device x zone), /db collection export and replace, Devices resource /devices, Driver group membership lists (group ids, z<zone id>), Device groups resource /groups (+15 more)
### Community 37 - "led_strip_spi_dev.c"
Cohesion: 0.14
Nodes (13): led_strip_t, led_strip_rmt_clear(), led_strip_rmt_del(), led_strip_rmt_refresh(), led_strip_rmt_set_pixel(), ws2812_rmt_adapter(), led_strip_new_spi_device(), __led_strip_spi_bit() (+5 more)
### Community 38 - "store_save"
Cohesion: 0.23
Nodes (12): api_register(), api_settings_defaults(), db_root(), index_of(), load_file(), mount(), store_init(), store_known() (+4 more)
### Community 39 - "Beat Detection DSP (C)"
Cohesion: 0.27
Nodes (16): beat_feed(), analyse_beat(), bar_cue(), bar_decide(), beat_dsp_feed(), beat_dsp_init(), beat_dsp_tap(), best_phase() (+8 more)
### Community 40 - "audio_api.c"
Cohesion: 0.23
Nodes (14): audio_api_register(), audio_handler(), audio_run(), events(), events_task(), ok_with_status(), send_all(), send_event() (+6 more)
### Community 41 - "sim_stubs.c"
Cohesion: 0.11
Nodes (11): espnow_tx_set_bridge(), app_main(), settings_str(), start_webserver(), esp_vfs_littlefs_register(), mic_get_level(), mic_start(), mic_stream_open() (+3 more)
### Community 42 - "run_all"
Cohesion: 0.10
Nodes (19): dim(), expected(), frame(), frame_sum(), get(), local_prefix(), main(), mismatch_detail() (+11 more)
### Community 43 - "ws_client.cpp"
Cohesion: 0.22
Nodes (6): read_handshake(), read_n(), ws_client_close(), ws_client_connect(), ws_client_recv_text(), ws_client_send_text()
### Community 44 - "time"
Cohesion: 0.17
Nodes (9): Blink, sleep(), sleep_ms(), sleep_us(), ticks_diff(), ticks_ms(), ticks_us(), time() (+1 more)
### Community 45 - "test_presets.py"
Cohesion: 0.13
Nodes (4): preset(), test_create_belongs_to_current_profile(), test_create_fills_defaults(), test_presets_scoped_to_profile()
### Community 46 - "BridgeSim"
Cohesion: 0.14
Nodes (4): BridgeSim, mac_str(), _read_json(), Strip
### Community 47 - "USB Latency Tools"
Cohesion: 0.16
Nodes (10): analyze(), edges(), main(), pct(), read(), fit_clock(), main(), pct() (+2 more)
### Community 50 - "WS2812"
Cohesion: 0.08
Nodes (13): new_ws2812_encoder(), rmt_del_ws2812_encoder(), rmt_encode_ws2812(), rmt_ws2812_encoder_reset(), rmt_ws2812_encoder_t, WS2812, channel_, encoder_ (+5 more)
### Community 52 - "Transport"
Cohesion: 0.23
Nodes (3): _convert_filesystem_error(), stdout_write_bytes(), Transport
### Community 53 - "mpremote Transport"
Cohesion: 0.12
Nodes (20): Presets Mockup Page, addColorPicker() / initializeColorPickers(), ColorPicker component (color-picker.js / color-picker.css), Preset Delay (animation speed, 10-1000 ms), ESPNow preset distribution, filterPresets() / sortPresets() search, filter and sort, LED Patterns (on, off, blink, chase, circle, pulse, rainbow, transition), Pattern Parameters N1-N8 (+12 more)
### Community 54 - "Outputs Config (C)"
Cohesion: 0.20
Nodes (17): defaults(), fail(), fill(), int_field(), num(), one_of(), put16(), resolve() (+9 more)
### Community 55 - "patterns.cpp"
Cohesion: 0.11
Nodes (28): clamp_leds(), ddp_show(), frame_alloc(), fx_fn, now_ms(), output(), pattern_def_t, name (+20 more)
### Community 59 - "microdot.py"
Cohesion: 0.14
Nodes (4): invoke_handler(), mro(), urldecode_bytes(), urldecode_str()
### Community 60 - "mpremote Serial Transport"
Cohesion: 0.13
Nodes (3): SerialIntercept, SerialTransport, TransportError
### Community 61 - "API Test Fixtures & Audio"
Cohesion: 0.16
Nodes (5): base_url(), c(), Client, profile(), restore_db()
### Community 63 - "Help: Zones & Palette"
Cohesion: 0.13
Nodes (18): Colour Palette (per profile), Zone default preset (default hint), DJ zone starter option, From Palette linked colours, LED driver JSON (presets, select, save, default, manifest), Patterns dialog, POST /presets/send, Preset editor (Try, Save, Send, Manual) (+10 more)
### Community 64 - "ddp_test.py"
Cohesion: 0.08
Nodes (24): hsv(), rig_mid(), rig_rows(), rig_xy(), set_fps(), soak_rig_bounce(), soak_rig_checker(), soak_rig_columns() (+16 more)
### Community 66 - "esp_timer_get_time"
Cohesion: 0.19
Nodes (14): espnow_tx_send(), full_mask(), handle_rx(), peer_get(), record_done(), rel_init(), rel_send(), rel_send_seq() (+6 more)
### Community 67 - "os"
Cohesion: 0.07
Nodes (7): mpremote_base(), main(), boot(), firmware_default_device_name(), TransportExecError, info(), upload()
### Community 68 - "build_app"
Cohesion: 0.24
Nodes (4): build_app(), index(), static(), web()
### Community 69 - "main/ota.c"
Cohesion: 0.12
Nodes (19): ap_switch_later(), apply_client_ip(), net_save_network(), on_ip_event(), on_wifi_event(), reconnect_cb(), ota_confirm_later(), bench_start() (+11 more)
### Community 70 - "Index Page Modals"
Cohesion: 0.11
Nodes (19): Audio Beat Detection modal, Header BPM / beat sync indicator, Colour Palette modal, Devices modal, Edit device modal, Edit Zone modal, Device groups modal, Header global brightness slider (+11 more)
### Community 74 - "store_lock"
Cohesion: 0.31
Nodes (13): engine_groups_push_all(), engine_play(), on_announce(), espnow_tx_set_mic_beats(), seqplay_init(), seqplay_overlay_stop(), seqplay_set_audio(), seqplay_stop() (+5 more)
### Community 75 - "json"
Cohesion: 0.14
Nodes (9): _default_image(), _info(), ota_update(), _default_image(), _info(), ota_update(), handle_action(), index() (+1 more)
### Community 76 - "Controller Overview & OTA Docs"
Cohesion: 0.17
Nodes (16): led_controller ESP-IDF project, POST /patterns/upload (led-driver parity), Driver app update /drivers/ota (staged files, sha, commit/abort), Firmware OTA /ota (idle slot, rollback), Patterns resource /patterns, Driver app update over ESP-NOW test (tools/driver_ota.py), led-simulator, led-tool / led-cli serial device CLI (+8 more)
### Community 77 - "usb_cfg.cpp"
Cohesion: 0.29
Nodes (5): handle_api(), handle_line(), log_vprintf(), usb_cfg_task(), write_line()
### Community 79 - "Audio Monitor Page"
Cohesion: 0.16
Nodes (16): /audio.wav live PCM stream, bar() bar-position renderer, /beats SSE event stream, draw() timeline canvas, Listen button (WAV stream playback via AudioContext), median(), Audio and beats page (/audio), stats() tap vs computer agreement (+8 more)
### Community 80 - "Art-Net DMX Tests"
Cohesion: 0.26
Nodes (9): parse(), _assert_eq(), main(), test_artnet_send_loopback(), test_build_artdmx(), test_fixture_patch(), test_pattern_blink_and_select(), test_pattern_upload() (+1 more)
### Community 82 - "bridge_sim.py"
Cohesion: 0.14
Nodes (7): driver_mac(), lan_ip(), load_config(), _merge(), sync_patterns(), _hex(), main()
### Community 84 - "unique"
Cohesion: 0.06
Nodes (15): find_id_by_field(), missing(), unique(), test_scenes(), device(), group(), test_crud(), test_group_identify_needs_devices() (+7 more)
### Community 85 - "ESP-NOW Sender Bridge"
Cohesion: 0.20
Nodes (10): ap(), _broadcast_ws(), _espnow_receive_loop(), _init_espnow(), main(), _send_espnow(), _validate_envelope(), ws() (+2 more)
### Community 86 - "net.cpp"
Cohesion: 0.08
Nodes (23): ddp_start(), app_main(), ap_timer_cb(), apply_ap(), apply_sta_config(), net_ap_on(), net_ap_ssid(), net_scan() (+15 more)
### Community 89 - "Rig"
Cohesion: 0.15
Nodes (4): bridge_downlink(), driver_mac(), mac_str(), Rig
### Community 90 - "packet"
Cohesion: 0.14
Nodes (3): packet(), send_frame(), send_sync()
### Community 92 - "Bench Test Plan"
Cohesion: 0.23
Nodes (9): Bench endpoints /test/loss and /test/beats, 30 ms beat lead (CONFIG_BEAT_LEAD_MS), Bench test: S3 controller and one LED driver, ESP32-C3 vs S3 driver comparison, Logic analyzer latency (marker GPIO, tools/analyze_edges.py), Lossy-link test (simulated loss, retries, resync), Reliable link (rel: acked unicast, retransmits, ack timeouts), Bench troubleshooting (serial ports, channel mismatch, blank UI) (+1 more)
### Community 93 - "envelope.c"
Cohesion: 0.33
Nodes (12): clamp(), color_rgb(), env_add_preset(), env_add_select(), get2(), num_or(), put(), put_le16() (+4 more)
### Community 94 - "api_call_t"
Cohesion: 0.33
Nodes (5): api_call_t, cap, done, msg, out
### Community 95 - "Microdot Auth (dmx)"
Cohesion: 0.21
Nodes (6): wraps(), print_exception(), websocket_upgrade(), websocket_wrapper(), wrapper(), with_websocket()
### Community 97 - "DMX Pattern Player"
Cohesion: 0.15
Nodes (3): main(), output_tick(), PatternPlayer
### Community 98 - "DMX Preset Model"
Cohesion: 0.08
Nodes (12): _expand(), _preset_from_map(), process_data(), _select_entries(), _targets_for_key(), create_app(), play(), serial_ports() (+4 more)
### Community 99 - "status_get_handler"
Cohesion: 0.16
Nodes (9): beat_get_info(), bridge_addr(), espnow_tx_ap_clients(), espnow_tx_stats(), reset_reason(), status_get_handler(), rel_stats(), rel_ver() (+1 more)
### Community 100 - "ddp.cpp"
Cohesion: 0.15
Nodes (5): be16(), be32(), ddp_set_enabled(), ddp_sync_task(), ddp_task()
### Community 101 - "Groups UI (JS)"
Cohesion: 0.29
Nodes (9): fetchDevicesMapForGroups(), fetchGroupsMap(), identifyGroupById(), loadGroupsModal(), loadWifiFieldsFromGroup(), openEditGroupModal(), renderGroupDevicesEditor(), renderGroupsList() (+1 more)
### Community 102 - "rig_seed.py"
Cohesion: 0.29
Nodes (6): controller_url(), _get(), _post(), seed(), seed_soon(), api_seed_layout()
### Community 103 - "Help: Mobile Menu Image"
Cohesion: 0.24
Nodes (10): Mobile Menu Help Illustration (narrow screen), Content Area (preset buttons), Menu Dropdown (Run mode, Profiles, Tabs, Presets, Help), Header Tab Buttons, Help, Menu Button (header dropdown trigger), Presets, Profiles (+2 more)
### Community 104 - "Pattern Selector Mockup Image"
Cohesion: 0.20
Nodes (11): Pattern Selector Mockup (Select LED Pattern), Apply Pattern / Cancel Actions, Blink Pattern, Chase Pattern, Circle Pattern, Off Pattern, On Pattern (solid color), Pattern Card Grid Layout (+3 more)
### Community 105 - "Driver Pattern Docs"
Cohesion: 0.24
Nodes (11): Message processing order (version, presets upsert, colour, selection), Auto vs manual (a) and manual chase flush, Built-in off / on patterns, Patterns and presets on the LED driver, MAX_PRESETS = 32, Pattern OTA via manifest / POST /patterns/upload, Pattern registry (Presets.reload_patterns), Preset short keys (p, c, d, b, a, bg, n1-n6) (+3 more)
### Community 108 - "esp_timer_get_time"
Cohesion: 0.24
Nodes (9): bench_running(), skip_unresponsive(), espnow_tx_beat(), on_beat(), send_beat_copy(), rel_peer_status(), on_ping_rsp(), esp_timer_get_time() (+1 more)
### Community 109 - "Driver Message API Docs"
Cohesion: 0.38
Nodes (10): Auto vs manual mode, Beat (re-select same preset restarts generator), Hex colour conversion and colour-order reordering, LED Driver API (message format), Pattern-specific parameters (rainbow, pulse, transition, chase, circle), Preset fields (pattern, colors, delay, brightness, auto, n1-n6), Select message (device -> [preset, step]), Step synchronization (+2 more)
### Community 110 - "engine_init"
Cohesion: 0.40
Nodes (3): engine_init(), rel_set_announce_cb(), rel_set_resync_cb()
### Community 111 - "led_strip Manifest"
Cohesion: 0.20
Nodes (9): dependencies, idf, description, repository, repository_info, commit_sha, path, url (+1 more)
### Community 112 - "ws_slot_t"
Cohesion: 0.67
Nodes (3): ws_slot_t, fd, host
### Community 113 - "Outputs UI (JS)"
Cohesion: 0.33
Nodes (8): fetchOutputs(), loadOutputsModal(), openOutputEditor(), OUTPUT_PROTOCOL_LABELS, outputSummary(), renderOutputsList(), setOutputField(), syncOutputProtocolFields()
### Community 114 - "DMX Driver Docs"
Cohesion: 0.25
Nodes (9): Controller WebSocket /ws (v1 presets/select), DMX Driver Art-Net and serial gateway, DMX fixture (output, start channel, role map; parcan/mover profiles), led-driver-style pattern engine (Preset object), Serial DMX512 output (250000 8N2), Binary envelope (main/envelope.c, test/binary_envelope.py), v1 driver messages (long/short keys), WebSocket /ws driver message relay (+1 more)
### Community 115 - "Help PDF: Overview"
Cohesion: 0.25
Nodes (9): API.md, LED controller user guide, Main web UI (Raspberry Pi app), Pattern OTA install over HTTP (/patterns/ota, upload, driver, send), Pattern parameters n1-n8, README, Serial to ESP-NOW bridge transport, WebSocket /ws (+1 more)
### Community 116 - "Mockups Index Image"
Cohesion: 0.31
Nodes (9): LED Driver UI Mockups Index (screenshot), Dashboard Mockup, Device Groups, Device Management Mockup, LED Patterns (On, Off, Blink, Chase, Circle, Pulse, Rainbow, Transition), N1-N8 Pattern Parameters, Pattern Selector Mockup, Presets Mockup (+1 more)
### Community 118 - "Help: Header Toolbar Image"
Cohesion: 0.29
Nodes (8): Header Toolbar Help Image, Edit Mode Action Bar, Run/Edit Mode Toggle Button, Patterns Action, Presets Action, Profiles Action, Header Tab Buttons, Tabs Action
### Community 119 - "Help: Preset Editor Image"
Cohesion: 0.29
Nodes (5): Default Action, Preset Pattern Selector, Preset Editor Modal (help illustration), Preset Name Field, Brightness, Delay and n1-n8 Parameters (0-255)
### Community 120 - "Dashboard Mockup Image"
Cohesion: 0.32
Nodes (8): LED Driver Control Panel Dashboard Mockup, Apply Settings Action, Brightness & Speed Card (Brightness % and Delay ms sliders), Colors Card (color swatches palette, Add Color), Connected Devices Card (devices with group and online status), Device Groups, Pattern Selection Card (On, Off, Blink, Chase, Circle, Pulse, Rainbow, Transition), Save to Device Action
### Community 121 - "Device Management Mockup Image"
Cohesion: 0.32
Nodes (8): + Add Device Button, Connected Devices List, Device Group, Device & Group Management Screen (mockup), Device Row Actions (edit, settings, stop), Online/Offline Status Badge, Devices / Groups Tab Switcher, LED Device (MAC, group, pattern)
### Community 122 - "Presets Mockup Image"
Cohesion: 0.32
Nodes (8): Preset Management UI Mockup, Apply Preset Action, Create Preset Action, LED Pattern Types (Rainbow, Pulse, Chase, Circle, Blink, Transition), Preset Card (name, pattern badge, color swatches, delay, n1, apply/edit/delete), Preset Search/Filter/Sort Toolbar (pattern filter, sort by name, grid/list toggle), Preset Parameters (colors, delay ms, n1), Sync Presets to All Devices
### Community 123 - "Pattern Contract"
Cohesion: 0.29
Nodes (6): Pattern Contract, Drawing via driver.n and apply_brightness, Pattern error handling (Presets.tick catches), Presets._load_dynamic_patterns(), Shared driver.step semantics, Global vs per-preset brightness
### Community 129 - "Colour Picker Demo Image"
Cohesion: 0.33
Nodes (6): Custom Color Picker Demo (screenshot), Hex and RGB input support, HSB (Hue, Saturation, Brightness) color model, Keyboard accessible, customizable styling, Multiple Color Pickers for LED Patterns, Single Color Picker
### Community 130 - "Settings Mockup Image"
Cohesion: 0.33
Nodes (7): Advanced Settings (Step Counter, Step Increment, Device ID, Debug Mode), Basic Settings (Device Name, LED Pin, Number of LEDs), Color Order Selector (RGB/RBG/GRB/GBR/BRG/BGR), Device Settings Page Mockup, Network Settings (Access Point Name, Password, Enable AP), Pattern Parameters N1-N6, Pattern Settings (Pattern, Brightness, Delay)
### Community 131 - "sim_demo.py"
Cohesion: 0.26
Nodes (7): Api, main(), group(), preset(), sequence(), new_id(), rig_bars()
### Community 135 - "store_coll"
Cohesion: 0.21
Nodes (30): engine_groups_changed(), api_migrate_zones(), api_preset_defaults(), api_seed_defaults(), clone_profile(), clone_zone(), content_fragment(), create_profile() (+22 more)
### Community 138 - "Help: Colour Palette Image"
Cohesion: 0.40
Nodes (6): Colour Palette modal mockup (help image), Add Swatch (+) Button, Colour Palette Modal, Palette Colour Swatches, Preset Editor 'From Palette', Profile (palette owner)
### Community 140 - "LED Driver README"
Cohesion: 0.47
Nodes (6): dev.py deploy/sync script, LED Driver README (MicroPython ESP32), Optional HTTP polling (http_poll.py), Wi-Fi TCP transport to Pi (port 8765), transport_type setting (wifi / espnow), UDP discovery (port 8766)
### Community 142 - "SPI Example Manifest"
Cohesion: 0.33
Nodes (5): dependencies, espressif/led_strip, idf, override_path, version
### Community 143 - "test_rig_sim.py"
Cohesion: 0.10
Nodes (28): all_dark(), col_of(), frames(), led_x(), lit(), mac(), make_preset(), need_sim() (+20 more)
### Community 145 - "Help PDF: Modes"
Cohesion: 0.40
Nodes (4): Edit mode, Mobile layout Menu, Run mode, Zones modal
### Community 146 - "Help: Tab Preset Strip Image"
Cohesion: 0.60
Nodes (5): Help image: Main area brightness and preset tiles, Edit Mode: drag tiles to reorder, Global Brightness Slider, Preset Tile (gradient swatch, click to select on tab devices), Tab (e.g. lounge)
### Community 149 - "res_device.c"
Cohesion: 0.18
Nodes (30): api_apply_driver_cfg(), api_effective_brightness(), api_identify_group(), clamp255(), create_device(), device_brightness(), device_config_from(), device_driver_config() (+22 more)
### Community 150 - "api_error"
Cohesion: 0.23
Nodes (21): api_body(), api_error(), api_json(), api_merge(), api_message(), api_preset_in_profile(), api_result(), api_split() (+13 more)
### Community 155 - "app.js"
Cohesion: 0.16
Nodes (35): addLog(), banner(), colourAt(), connectBridge(), deliver(), drawLabel(), drawPlaced(), drawStrip() (+27 more)
### Community 156 - "RMT Example Manifest"
Cohesion: 0.40
Nodes (4): dependencies, espressif/led_strip, override_path, version
### Community 157 - "Help Tab JS"
Cohesion: 0.36
Nodes (5): addStaticIpRow(), loadDeviceSettings(), loadNetworkStatus(), setApToggle(), switchSettingsTab()
### Community 158 - "Settings Page Template"
Cohesion: 0.50
Nodes (4): Settings modal (device, network), loadEspnowChannel(), Device Settings page (ESP-NOW channel), wifi_channel setting (1-11)
### Community 159 - "led-driver/web/app.js"
Cohesion: 0.10
Nodes (49): api(), applyMode(), attachDrag(), closeEditor(), closeSock(), deviceChoices(), direct(), discoverDevices() (+41 more)
### Community 166 - "sequences_route"
Cohesion: 0.24
Nodes (15): api_body_opt(), api_current_profile(), api_migrate_sequences(), api_sequence_defaults(), apply_update(), colors_from(), fire_sequence(), has_steps() (+7 more)
### Community 167 - "api_id"
Cohesion: 0.24
Nodes (25): api_add(), api_id(), api_set(), add_ref(), bundle(), bundle_of(), bundles_route(), export_profile() (+17 more)
### Community 170 - "dependencies"
Cohesion: 0.25
Nodes (8): dependencies, espressif/mdns, joltwallet/littlefs, rules, version, rules, version, if
### Community 171 - "List Search (JS)"
Cohesion: 0.83
Nodes (3): applyListSearch(), initListSearch(), rowSearchText()
### Community 197 - "presets.cpp"
Cohesion: 0.20
Nodes (21): patterns_index(), build_defaults(), find(), preset_from_json(), preset_to_json(), presets_add_defaults(), presets_apply_startup(), presets_at() (+13 more)
### Community 199 - "res_group.c"
Cohesion: 0.31
Nodes (15): add_error(), api_driver_config(), api_mac(), api_migrate_groups(), brightness(), driver_config(), find(), groups_route() (+7 more)
### Community 201 - "_simlink_web.py"
Cohesion: 0.16
Nodes (11): _check_flash(), on_feed(), push_pixels(), real_sleep(), recv(), recv_nowait(), _run_jobs(), _send_pixels() (+3 more)
### Community 204 - "_simlink_proc.py"
Cohesion: 0.16
Nodes (5): connect(), on_feed(), push_pixels(), _reader(), _send_pixels()
### Community 227 - "dependencies"
Cohesion: 0.33
Nodes (5): dependencies, espressif/cjson, espressif/mdns, version, version
## Knowledge Gaps
- **113 isolated node(s):** `name`, `host`, `cl`, `host`, `fd` (+108 more)
These have ≤1 connection - possible missing edges or undocumented components. (Counts symbols only; 922 node(s) total have ≤1 connection when file, concept and rationale nodes are included.)
- **59 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 `new_id()` connect `new_id` to `test_sequences.py`, `test_presets.py`, `test_rig_sim.py`, `unique`, `API Test Fixtures & Audio`?**
_High betweenness centrality (0.022) - this node is a cross-community bridge._
- **Are the 64 inferred relationships involving `store_coll()` (e.g. with `api_add()` and `api_current_profile()`) actually correct?**
_`store_coll()` has 64 INFERRED edges - model-reasoned connections that need verification._
- **What connects `name`, `host`, `cl` to the rest of the system?**
_113 weakly-connected nodes found - possible documentation gaps or missing edges._
- **Should `IdfDevice` be split into smaller, more focused modules?**
_Cohesion score 0.09915966386554621 - nodes in this community are weakly interconnected._
- **Why does `PyboardCommand` connect `PyboardCommand` to `os`, `mpremote Serial Transport`?**
_High betweenness centrality (0.019) - this node is a cross-community bridge._
- **Are the 40 inferred relationships involving `api_error()` (e.g. with `outputs_route()` and `test_output()`) actually correct?**
_`api_error()` has 40 INFERRED edges - model-reasoned connections that need verification._
- **Should `htmx Library` be split into smaller, more focused modules?**
_Cohesion score 0.07897684839432412 - nodes in this community are weakly interconnected._