# Graph Report - led-controller (2026-11-04) ## Corpus Check - 299 files · ~205,335 words - Verdict: corpus is large enough that graph structure adds value. - Unclassified: 43 file(s) not represented in the graph (top: (none) 23, .mdc 6, .lock 4) ## Summary - 3436 nodes · 7652 edges · 203 communities (113 shown, 90 thin omitted) - Extraction: 88% EXTRACTED · 12% INFERRED · 0% AMBIGUOUS · INFERRED: 923 edges (avg confidence: 0.86) - Token cost: 0 input · 0 output ## Graph Freshness - Built from commit: `24d3c114` - 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) - store_coll - htmx Library - run_tick - Browser Tests & Mockup Images - Audio UI (JS) - ESP-NOW TX & DMX Pulse - Driver OTA over ESP-NOW - led-tool Device CLI - style_mode - Compiler - Spec: Pi Animation Engine - Beat Sync on Driver - Presets UI (JS) - Zones UI (JS) - Pattern Store & Web (C) - ESP-NOW Receive Tests - Sequences UI (JS) - Driver Controller Messages - ESP-IDF System Deps - led_strip Component Docs - Art-Net Output - Reliable ESP-NOW Link (C) - led-test RMT Example - Driver Presets Store - serial - Microdot App (dmx) - Microdot App (led) - engine.c - Devices UI (JS) - DMX Driver HTTP App - Colour Picker Mockups - ESP-NOW Wire & Transport - Audio Capture (C) - Driver OTA Broadcast (C) - API Tests: Sequences & Bundles - Binary Envelope (test) - API Docs: Outputs & Audio - mpremote Commands - Driver WiFi & Background Tasks - Beat Detection DSP (C) - tests/patterns/bar_graph.py - Compiler - presets.py - Driver Test Runner - Microdot Helpers - Bridge WebSocket Blink Test - find_id_by_field - USB Latency Tools - Colour Picker JS - Chromium Colour Picker JS - led_strip_rmt_encoder.c - API Tests: Devices - Presets & Settings Mockups - mpremote Transport - Outputs Config (C) - Microdot Handlers (dmx) - MultiDict (dmx) - led_strip_spi_dev.c - Microdot Handlers (led) - MultiDict (led) - mpremote Serial Transport - API Test Fixtures & Audio - Microdot Request (dmx) - Help: Zones & Palette - Network & WebSocket (C) - Driver OTA Tool - api_error - SerialIntercept - API Tests: Zones - API Tests: Outputs & Routes - Index Page Modals - Microdot Templates (led) - Microdot Templates (dmx) - Microdot WebSocket (dmx) - Microdot WebSocket (led) - board.py - Controller Overview & OTA Docs - DMX - Driver Hello Discovery - Audio Monitor Page - Art-Net DMX Tests - DMX Output Manager - machine - Microdot Sessions (led) - API Tests: Groups - ESP-NOW Sender Bridge - Firmware OTA (C) - Microdot Async IO (dmx) - DMX Settings - Microdot Async IO (led) - API Tests: Presets - Microdot Routing (dmx) - Bench Test Plan - Microdot Routing (led) - Flame Pattern - Microdot Auth (dmx) - Serial DMX & WiFi - DMX Pattern Player - DMX Preset Model - Twinkle Pattern - Driver Settings - Groups UI (JS) - Microdot Auth (led) - Help: Mobile Menu Image - Pattern Selector Mockup Image - Driver Pattern Docs - Driver Preset Model - Blizzard - Microdot JWT Session - Driver Message API Docs - Driver Binary Envelope - led_strip Manifest - API Tests: Patterns - Outputs UI (JS) - DMX Driver Docs - Help PDF: Overview - Mockups Index Image - api_json - Help: Header Toolbar Image - Help: Preset Editor Image - Dashboard Mockup Image - Device Management Mockup Image - Presets Mockup Image - Pattern Contract - Microdot SessionDict - Meteor Pattern - ._feed_wdt - Numpad Shortcuts (JS) - Blink Pattern Test - Colour Picker Demo Image - Settings Mockup Image - Aurora Pattern - Colour Cycle Pattern - Sparkle Pattern - api_set - tests/patterns/clock_sweep.py - HTTPException (dmx) - Help: Colour Palette Image - HTTPException (led) - LED Driver README - Palette Morph Pattern - SPI Example Manifest - tests/patterns/aurora.py - marquee.py - Help PDF: Modes - Help: Tab Preset Strip Image - Blink Pattern - Circle Pattern - utime - heartbeat.py - Plasma Pattern - Radiate Pattern - Transition Pattern - Driver Runtime State - tests/patterns/plasma.py - RMT Example Manifest - Help Tab JS - Settings Page Template - groups_route - web.c - sequences_route - tests/patterns/pulse.py - store_save - breathing_dual.py - Flicker - tests/patterns/strobe_burst.py - tests/patterns/palette_morph.py - Rime Pattern - Particles - Controller Component Deps - 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 - tests/patterns/circle.py - BarGraph - candle_glow.py - Orbit - src/patterns/rain_drops.py - Pulse ## God Nodes (most connected - your core abstractions) 1. `Presets` - 67 edges 2. `store_coll()` - 64 edges 3. `api_error()` - 50 edges 4. `api_json()` - 43 edges 5. `unique()` - 37 edges 6. `api_set()` - 35 edges 7. `store_save()` - 35 edges 8. `new_id()` - 35 edges 9. `run_tick()` - 33 edges 10. `api_id()` - 28 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 (203 total, 90 thin omitted) ### Community 0 - "store_coll" Cohesion: 0.19 Nodes (33): api_register(), api_settings_defaults(), engine_groups_changed(), api_migrate_zones(), api_preset_defaults(), api_seed_defaults(), clone_profile(), clone_zone() (+25 more) ### Community 1 - "htmx Library" Cohesion: 0.08 Nodes (101): a(), Ae(), an(), at(), B(), be(), bn(), bt() (+93 more) ### Community 2 - "run_tick" Cohesion: 0.06 Nodes (22): run_tick(), main(), run_for(), main(), run_for(), main(), run_for(), main() (+14 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.07 Nodes (19): beat_set_callback(), bench_on_beat_tx(), bench_on_echo(), bench_running(), bench_start(), bench_stop(), gen_cb(), gpio_mark() (+11 more) ### Community 6 - "Driver OTA over ESP-NOW" Cohesion: 0.10 Nodes (30): handle(), _makedirs(), Ota, _remove(), safe_path(), _hash_file(), load(), _normalize_path() (+22 more) ### Community 7 - "led-tool Device CLI" Cohesion: 0.08 Nodes (15): download_presets(), download_settings(), _get_ordered_actions(), main(), resolve_flash_binary(), upload_presets(), upload_settings(), copy_file() (+7 more) ### Community 9 - "Compiler" Cohesion: 0.13 Nodes (4): 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 - "Beat Sync on Driver" Cohesion: 0.07 Nodes (37): BeatSync, _diff(), _due(), LinkRx, send(), frame(), run(), test_bad_frames() (+29 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 - "Pattern Store & Web (C)" Cohesion: 0.25 Nodes (17): add_name(), base_name(), builtin(), create_driver_pattern(), create_pattern(), exists(), file_names(), file_path() (+9 more) ### Community 15 - "ESP-NOW Receive Tests" Cohesion: 0.12 Nodes (14): get_wdt(), main(), MockESPNow, run_main_loop_iterations(), test_beat_functionality(), test_color_conversion(), test_full_message(), test_preset_creation() (+6 more) ### Community 16 - "Sequences UI (JS)" Cohesion: 0.11 Nodes (33): addSequenceToTab(), appendZoneSequenceTiles(), applySequenceSwitchWaitFromServer(), buildLaneGroupIdsForEditor(), collectLanesFromEditor(), createSequenceTileRow(), deleteCurrentSequence(), fetchGroupsMapSeq() (+25 more) ### Community 17 - "Driver Controller Messages" Cohesion: 0.09 Nodes (26): apply_brightness(), apply_clear_presets(), apply_default(), apply_device_config(), apply_patterns_ota(), apply_presets(), apply_select(), _config_flag() (+18 more) ### Community 18 - "ESP-IDF System Deps" Cohesion: 0.07 Nodes (15): audio_api_register(), app_main(), eth_event_handler(), gateway_answers(), got_ip_event_handler(), have_static_ips(), parse_static(), settings_str() (+7 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 (9): ArtNet, as_channels(), build_artdmx(), _ip_bytes(), _pad(), port_lo(), ticks_diff(), ticks_ms() (+1 more) ### Community 21 - "Reliable ESP-NOW Link (C)" Cohesion: 0.09 Nodes (21): skip_unresponsive(), espnow_tx_stats(), status_get_handler(), mic_get_level(), full_mask(), handle_rx(), peer_get(), record_done() (+13 more) ### Community 22 - "led-test RMT Example" Cohesion: 0.13 Nodes (19): app_main(), app_main(), configure_led(), app_main(), configure_led(), led_strip_rmt_config_t, led_model_t, led_pixel_format_t (+11 more) ### Community 25 - "Microdot App (dmx)" Cohesion: 0.07 Nodes (4): Microdot, mro(), _mro(), print_exception() ### Community 26 - "Microdot App (led)" Cohesion: 0.07 Nodes (4): Microdot, mro(), _mro(), print_exception() ### Community 27 - "engine.c" Cohesion: 0.05 Nodes (103): audio_handler(), audio_run(), events(), events_task(), ok_with_status(), send_all(), send_event(), send_json() (+95 more) ### Community 28 - "Devices UI (JS)" Cohesion: 0.11 Nodes (30): applyEspnowPingAggregateToDots(), applyEspnowPingToDeviceRows(), applyTcpSnapshot(), applyTransportVisibility(), collectDeviceEditPayload(), createDeviceFromModal(), createDeviceIdentifyButton(), DEVICE_DOT_CLASSES (+22 more) ### Community 29 - "DMX Driver HTTP App" Cohesion: 0.09 Nodes (9): _expand(), _preset_from_map(), process_data(), _select_entries(), _targets_for_key(), create_app(), serial_ports(), ws_handler() (+1 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 31 - "ESP-NOW Wire & Transport" Cohesion: 0.14 Nodes (21): make_sender(), _dlog(), espnow_receive_loop(), _handle_packet(), init_espnow(), _schedule_ping_rsp(), send_boot_announce(), _send_ping_rsp() (+13 more) ### Community 32 - "Audio Capture (C)" Cohesion: 0.07 Nodes (26): Pulse, audio_get_handler(), audio_register(), audio_stream_task(), beats_get_handler(), beats_stream_task(), send_all(), tap_post_handler() (+18 more) ### Community 33 - "Driver OTA Broadcast (C)" Cohesion: 0.19 Nodes (18): broadcast_chunks(), chunk_done(), command(), data_pkt(), drain_status(), drv_ota_register(), drv_ota_send(), finish() (+10 more) ### Community 34 - "API Tests: Sequences & Bundles" Cohesion: 0.13 Nodes (15): unique(), test_clone(), test_delete(), test_put(), test_put_current(), clock(), presets(), test_editing_stops_playback() (+7 more) ### Community 35 - "Binary Envelope (test)" Cohesion: 0.15 Nodes (17): 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() (+9 more) ### 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), Device groups resource /groups (+15 more) ### Community 38 - "Driver WiFi & Background Tasks" Cohesion: 0.12 Nodes (10): presets_loop(), apply_startup_pattern(), print_mem(), snapshot(), initialize_runtime(), boot_sta(), connect_until_up(), _one_association_campaign() (+2 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 - "tests/patterns/bar_graph.py" Cohesion: 0.29 Nodes (4): main(), run_for(), main(), run_for() ### Community 41 - "Compiler" Cohesion: 0.13 Nodes (4): Loader, Loader, Compiler, Loader ### Community 42 - "presets.py" Cohesion: 0.24 Nodes (4): is_reversed(), led_i(), signed(), convert_and_reorder_colors() ### Community 43 - "Driver Test Runner" Cohesion: 0.18 Nodes (17): _bootstrap_import_path(), _pattern_loaded(), _process_message(), run_all(), _smoke_preset(), test_colour_conversion_and_transition(), test_default_requires_existing_preset(), test_default_targets_gate_by_device_name() (+9 more) ### Community 44 - "Microdot Helpers" Cohesion: 0.11 Nodes (4): Request, G, urldecode_bytes(), urldecode_str() ### Community 45 - "Bridge WebSocket Blink Test" Cohesion: 0.11 Nodes (10): build_blink_envelope(), _format_mac(), _load_bridge_url(), main(), _send(), print_settings(), _default_image(), _info() (+2 more) ### Community 46 - "find_id_by_field" Cohesion: 0.33 Nodes (4): find_id_by_field(), test_scenes(), test_crud(), test_crud() ### Community 47 - "USB Latency Tools" Cohesion: 0.15 Nodes (10): analyze(), edges(), main(), pct(), read(), fit_clock(), main(), pct() (+2 more) ### Community 50 - "led_strip_rmt_encoder.c" Cohesion: 0.15 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 52 - "Presets & Settings Mockups" Cohesion: 0.14 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.23 Nodes (16): defaults(), fail(), fill(), int_field(), num(), one_of(), put16(), resolve() (+8 more) ### Community 55 - "Microdot Handlers (dmx)" Cohesion: 0.11 Nodes (5): invoke_handler(), iscoroutine(), Response, aclose(), __anext__() ### Community 57 - "led_strip_spi_dev.c" Cohesion: 0.15 Nodes (13): led_strip_spi_config_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 58 - "Microdot Handlers (led)" Cohesion: 0.11 Nodes (5): invoke_handler(), iscoroutine(), Response, aclose(), __anext__() ### Community 60 - "mpremote Serial Transport" Cohesion: 0.18 Nodes (3): SerialTransport, TransportError, TransportExecError ### Community 61 - "API Test Fixtures & Audio" Cohesion: 0.17 Nodes (5): base_url(), c(), Client, profile(), restore_db() ### Community 62 - "Microdot Request (dmx)" Cohesion: 0.13 Nodes (4): Request, G, urldecode_bytes(), urldecode_str() ### 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 - "Network & WebSocket (C)" Cohesion: 0.44 Nodes (5): forward(), on_open(), send_text(), ws_handler(), ws_register() ### Community 65 - "Driver OTA Tool" Cohesion: 0.09 Nodes (9): Controller, file_set(), walk(), main(), norm_mac(), push(), wait_back(), info() (+1 more) ### Community 66 - "api_error" Cohesion: 0.19 Nodes (22): api_body(), api_error(), api_json(), api_merge(), api_message(), api_preset_in_profile(), api_result(), api_split() (+14 more) ### Community 68 - "API Tests: Zones" Cohesion: 0.10 Nodes (10): new_id(), test_preset_round_trip(), test_profile_round_trip(), test_sequence_round_trip(), test_clone(), test_clone_default_name(), test_delete_removes_from_profile(), test_play_and_stop() (+2 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 75 - "board.py" Cohesion: 0.20 Nodes (5): apply_cpu_freq(), default_led_pin(), mcu(), upload_pattern(), _safe_pattern_filename() ### 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 78 - "Driver Hello Discovery" Cohesion: 0.17 Nodes (8): broadcast_hello_udp(), discover_controller_udp(), ipv4_broadcast(), pack_hello_bytes(), pack_hello_dict(), pack_hello_line(), udp_discovery_targets(), _udp_discovery_targets_single() ### 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.23 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 81 - "DMX Output Manager" Cohesion: 0.18 Nodes (3): main(), output_tick(), OutputManager ### Community 82 - "machine" Cohesion: 0.12 Nodes (14): Blink, _mac_hex(), run_diag(), recv_loop(), _set_channel(), _add_peer(), send_once(), _set_channel() (+6 more) ### Community 84 - "API Tests: Groups" Cohesion: 0.14 Nodes (4): device(), group(), test_group_identify_needs_devices(), test_profile_scoped_group() ### Community 85 - "ESP-NOW Sender Bridge" Cohesion: 0.24 Nodes (9): _broadcast_ws(), _espnow_receive_loop(), _init_espnow(), main(), _send_espnow(), _validate_envelope(), ws(), format_mac() (+1 more) ### Community 86 - "Firmware OTA (C)" Cohesion: 0.19 Nodes (5): fail(), ota_get_handler(), ota_post_handler(), ota_register(), reboot_post_handler() ### Community 90 - "API Tests: Presets" Cohesion: 0.15 Nodes (4): preset(), test_create_belongs_to_current_profile(), test_create_fills_defaults(), test_presets_scoped_to_profile() ### 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 94 - "Flame Pattern" Cohesion: 0.26 Nodes (6): _clamp(), Flame, _lerp_chan(), _lerp_rgb(), _palette_sample(), _triangle_255() ### Community 95 - "Microdot Auth (dmx)" Cohesion: 0.20 Nodes (3): websocket_upgrade(), websocket_wrapper(), with_websocket() ### Community 96 - "Serial DMX & WiFi" Cohesion: 0.19 Nodes (4): sleep_ms(), SerialDMX, sleep(), ap() ### Community 99 - "Twinkle Pattern" Cohesion: 0.23 Nodes (6): Twinkle, cluster_base_index(), cluster_len_bounds(), dark_adjacent(), light_adjacent(), random_cluster_len() ### Community 101 - "Groups UI (JS)" Cohesion: 0.29 Nodes (9): fetchDevicesMapForGroups(), fetchGroupsMap(), identifyGroupById(), loadGroupsModal(), loadWifiFieldsFromGroup(), openEditGroupModal(), renderGroupDevicesEditor(), renderGroupsList() (+1 more) ### Community 102 - "Microdot Auth (led)" Cohesion: 0.22 Nodes (3): websocket_upgrade(), websocket_wrapper(), with_websocket() ### 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 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 - "Driver Binary Envelope" Cohesion: 0.38 Nodes (8): _brightness_0_255_from_wire(), _decode_default_blob(), _decode_preset_record(), _decode_presets_blob(), _decode_select_blob(), parse_binary_envelope(), parse_binary_envelope_v1(), parse_binary_envelope_v2() ### Community 111 - "led_strip Manifest" Cohesion: 0.20 Nodes (9): dependencies, idf, description, repository, repository_info, commit_sha, path, url (+1 more) ### 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 117 - "api_json" Cohesion: 0.19 Nodes (27): api_body_opt(), api_effective_brightness(), api_identify_group(), clamp255(), create_device(), device_brightness(), device_config_from(), device_driver_config() (+19 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 128 - "Blink Pattern Test" Cohesion: 0.33 Nodes (3): _bootstrap_import_path(), main(), _run_ms() ### 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 135 - "api_set" Cohesion: 0.27 Nodes (21): api_add(), api_id(), api_set(), add_ref(), bundle(), bundle_of(), bundles_route(), export_profile() (+13 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 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 - "utime" Cohesion: 0.06 Nodes (16): ClockSweep, Icicles, StrobeBurst, _timestamped_print(), main(), run_for(), main(), main() (+8 more) ### Community 156 - "RMT Example Manifest" Cohesion: 0.40 Nodes (4): dependencies, espressif/led_strip, override_path, version ### 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 - "groups_route" Cohesion: 0.31 Nodes (15): add_error(), api_driver_config(), api_mac(), api_migrate_groups(), brightness(), driver_config(), find(), groups_route() (+7 more) ### Community 160 - "web.c" Cohesion: 0.26 Nodes (12): audio_page_handler(), etag(), favicon_handler(), find_file(), index_handler(), mime_for(), send_gz(), static_handler() (+4 more) ### Community 161 - "sequences_route" Cohesion: 0.26 Nodes (13): api_current_profile(), api_migrate_sequences(), api_sequence_defaults(), apply_update(), colors_from(), has_steps(), in_profile(), migrate_seq() (+5 more) ### Community 163 - "store_save" Cohesion: 0.22 Nodes (7): index_of(), load_file(), mount(), store_init(), store_known(), store_next_id(), store_replace() ### Community 170 - "Controller Component Deps" Cohesion: 0.50 Nodes (3): dependencies, espressif/mdns, joltwallet/littlefs ### Community 171 - "List Search (JS)" Cohesion: 0.83 Nodes (3): applyListSearch(), initListSearch(), rowSearchText() ## Knowledge Gaps - **97 isolated node(s):** `Design Guidelines`, `Device Management UI`, `Engine CLI`, `Output Drivers (DDP, Art-Net, sACN, USB-DMX)`, `Pixel Generator` (+92 more) These have ≤1 connection - possible missing edges or undocumented components. (Counts symbols only; 1030 node(s) total have ≤1 connection when file, concept and rationale nodes are included.) - **90 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 `unique()` connect `API Tests: Sequences & Bundles` to `API Tests: Zones`, `find_id_by_field`, `API Tests: Patterns`, `API Tests: Groups`, `API Tests: Presets`, `API Test Fixtures & Audio`?** _High betweenness centrality (0.022) - this node is a cross-community bridge._ - **Are the 41 inferred relationships involving `Presets` (e.g. with `test_save_and_load_roundtrip()` and `_TestContext`) actually correct?** _`Presets` has 41 INFERRED edges - model-reasoned connections that need verification._ - **What connects `Design Guidelines`, `Device Management UI`, `Engine CLI` to the rest of the system?** _97 weakly-connected nodes found - possible documentation gaps or missing edges._ - **Should `htmx Library` be split into smaller, more focused modules?** _Cohesion score 0.07897684839432412 - nodes in this community are weakly interconnected._ - **Why does `Microdot` connect `Microdot App (dmx)` to `HTTPException (dmx)`, `Microdot Routing (dmx)`, `Microdot Request (dmx)`?** _High betweenness centrality (0.017) - this node is a cross-community bridge._ - **Are the 59 inferred relationships involving `store_coll()` (e.g. with `api_add()` and `api_current_profile()`) actually correct?** _`store_coll()` has 59 INFERRED edges - model-reasoned connections that need verification._ - **Should `run_tick` be split into smaller, more focused modules?** _Cohesion score 0.05782312925170068 - nodes in this community are weakly interconnected._