fix: settings the display ignored, a memory leak, and the plugin card handler (#605)

* fix(errors): stop affected_plugins growing without bound

Each repeat of an error pattern appended every plugin in the time window to
the pattern's list again, so a plugin failing in a loop grew the display
process's memory without limit: 3,000 errors from three plugins reached 2.5
million entries. Keep the list unique.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(fonts): load a BDF font at its native size instead of PIL's default

FreeType rejects any size but a BDF strike's own, and FontManager answered
that with ImageFont.load_default() -- a different typeface -- so 5x7.bdf
requested at 8 or 10px rendered as PIL's default font. Retry at the native
strike, as element_style already does.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(web): plugin toggle failures no longer claim "operation in progress"

Every exception in POST /plugins/toggle was mapped to
PLUGIN_OPERATION_CONFLICT, so any failure told the user "A plugin operation
is already in progress". Report the failure as what it is, and record the
plugin id in the operation history for form posts too (it read a `data`
variable that only the JSON path set).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(web): route plugin card clicks through handlePluginAction

The document-level delegation checked `typeof handlePluginAction`, which is
scoped inside the plugin-manager IIFE and so never visible to it. Every card
click took a copied fallback that stopped propagation (the grid's own
listener never ran), confirmed an uninstall twice, and sent Starlark app
uninstalls to POST /plugins/uninstall instead of DELETE /starlark/apps/<id>.
Expose the handler on window and delegate to it.

Also run every test/js/unit suite under pytest: they need only node, but CI
ran one of the eight.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix(display): apply Rotation durations, WiFi messages and Vegas settings

Three settings the web UI saves never reached the display:

- Rotation & Durations: display.display_durations was never read. Every
  plugin inherits get_display_duration() and the plugin was asked first. A
  saved value now wins. The page shows unsaved screens blank with the
  plugin's own duration as a placeholder, and saving a blank removes the
  override, so one save no longer pins every screen.
- WiFi status overlay: the controller looked for wifi_status.json one
  directory above the repo. Both sides now use
  wifi_manager.get_wifi_status_path(). The message is written by rename so
  the display never reads it half-written, and the resumed plugin redraws the
  whole panel afterwards.
- Vegas: nothing called coordinator.update_config(), so saved Vegas settings
  never reached a running scroll. They are now queued when
  display.vegas_scroll changes, and applied while Vegas is stopped too, so a
  disable then re-enable works. The follower's scroll-speed default (75) now
  matches VegasModeConfig's (50).

Also throttles Vegas's per-frame live-priority scan to 4Hz. It cost 139us
per frame on a Pi 4 with two scoreboards (1.7% of a 125fps frame) and grows
with each plugin.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* fix: keep affected_plugins order when serialized; guard non-Element targets

ErrorPattern.to_dict() ran the now-ordered list through set(), so
get_error_summary() listed plugins in an unstable order. The document-level
card-action listener called event.target.closest() without checking the
target is an Element.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Chuck
2026-09-23 10:29:16 -04:00
committed by GitHub
co-authored by Claude Opus 5.5
parent 0903f9055f
commit 342e9164b8
23 changed files with 645 additions and 183 deletions
+121
View File
@@ -0,0 +1,121 @@
"""DisplayController settings that the web UI saves but the display ignored.
- Rotation & Durations: display.display_durations was never read, because
every plugin inherits get_display_duration() and the plugin was asked first.
- WiFi status overlay: the controller looked for wifi_status.json one level
above the repo, so WiFiManager's messages never reached the panel.
- Vegas: settings saved in the web UI never reached the running coordinator,
and the follower's scroll-speed default (75) disagreed with Vegas's (50).
"""
import os
import threading
from unittest.mock import MagicMock
os.environ.setdefault("EMULATOR", "true")
from src.display_controller import DisplayController
def _controller(config=None, plugin_modes=None):
dc = object.__new__(DisplayController)
dc.config = config or {}
dc.plugin_modes = plugin_modes or {}
return dc
def _plugin(duration):
plugin = MagicMock()
plugin.get_display_duration.return_value = duration
return plugin
class TestDisplayDuration:
def test_saved_duration_overrides_the_plugin(self):
dc = _controller({'display': {'display_durations': {'clock': 45}}},
{'clock': _plugin(15.0)})
assert dc._get_display_duration('clock') == 45.0
def test_unsaved_mode_uses_the_plugin_duration(self):
dc = _controller({'display': {'display_durations': {'other': 45}}},
{'clock': _plugin(12.0)})
assert dc._get_display_duration('clock') == 12.0
def test_invalid_saved_values_fall_back_to_the_plugin(self):
for bad in (0, -5, True, '30', None):
dc = _controller({'display': {'display_durations': {'clock': bad}}},
{'clock': _plugin(12.0)})
assert dc._get_display_duration('clock') == 12.0, bad
def test_unknown_mode_without_a_plugin_gets_the_default(self):
assert _controller()._get_display_duration('nothing') == 30
def test_hot_reloaded_config_is_used(self):
dc = _controller({}, {'clock': _plugin(15.0)})
dc._refresh_config_cache({'display': {'display_durations': {'clock': 60}}})
assert dc._get_display_duration('clock') == 60.0
class TestWifiStatusPath:
def test_reader_and_writer_agree(self, test_display_controller):
from src.wifi_manager import get_wifi_status_path
repo = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
path = get_wifi_status_path()
assert path.name == 'wifi_status.json'
# Inside this checkout's config/, not the directory above the repo.
assert os.path.normcase(str(path.parent.parent)) == os.path.normcase(repo)
assert test_display_controller.wifi_status_file == path
def test_status_message_is_written_whole(self, tmp_path, monkeypatch):
import json
import src.wifi_manager as wm
target = tmp_path / 'wifi_status.json'
monkeypatch.setattr(wm, 'LED_STATUS_FILE', target)
# The display polls this file and deletes one it can't parse, so it
# must appear by rename, never be seen half-written.
renames = []
real_replace = os.replace
monkeypatch.setattr(wm.os, 'replace',
lambda src, dst: (renames.append(dst), real_replace(src, dst)))
manager = object.__new__(wm.WiFiManager)
manager._show_led_message('Connecting to home...', duration=10)
assert json.loads(target.read_text())['message'] == 'Connecting to home...'
assert renames == [target]
assert not (tmp_path / 'wifi_status.json.tmp').exists()
class TestVegasSettings:
def _controller(self):
dc = _controller({'display': {'vegas_scroll': {'scroll_speed': 40}}})
dc._reconcile_flag_lock = threading.Lock()
dc._pending_plugin_reconcile = False
dc._enabled_set_changed = lambda old, new: False
dc._enabled_plugin_not_running = lambda new: False
dc.vegas_coordinator = MagicMock()
return dc
def test_changed_vegas_settings_reach_the_coordinator(self):
dc = self._controller()
old = {'display': {'vegas_scroll': {'scroll_speed': 40}}}
new = {'display': {'vegas_scroll': {'scroll_speed': 80}}}
dc._controller_config_change(old, new)
dc.vegas_coordinator.update_config.assert_called_once_with(new)
assert dc._scroll_speed == 80.0
def test_unrelated_saves_leave_vegas_alone(self):
# Applying a Vegas config rebuilds the strip, so only do it on change.
dc = self._controller()
old = {'display': {'vegas_scroll': {'scroll_speed': 40}, 'hardware': {'brightness': 50}}}
new = {'display': {'vegas_scroll': {'scroll_speed': 40}, 'hardware': {'brightness': 90}}}
dc._controller_config_change(old, new)
dc.vegas_coordinator.update_config.assert_not_called()
def test_scroll_speed_default_matches_vegas_config(self):
from src.vegas_mode.config import VegasModeConfig
assert DisplayController._vegas_scroll_speed({}) == VegasModeConfig.from_config({}).scroll_speed
def test_stopped_coordinator_applies_queued_config(self):
dc = self._controller()
dc.on_demand_active = False
dc._is_vegas_mode_active()
dc.vegas_coordinator.apply_pending_config_if_idle.assert_called_once()