feat(bridge): establish local pi status bridge

Deliver the initial local bridge, Noctalia v4/v5 adapters, desktop client, service unit, tests, and implementation documentation for persistent Pi status and control.
2026-07-27 14:51:45 +02:00
commit b7fea83ed6
91 changed files with 15029 additions and 0 deletions
@@ -0,0 +1,14 @@
+# Pi Status Bridge Noctalia plugin
+
+This Noctalia v4 plugin is deliberately **presentation-only**. It renders
+state supplied through its `plugin:pi-status-bridge` IPC handler and opens its
+panel with `pluginApi.togglePanel`.
+
+Use `pi-status-bridge-client` to query the owner-only Unix bridge socket. A
+local integration script should translate responses and events into the plugin
+IPC handler's `setBridgeState(state, projectLabel, attentionCount, detail)`
+call. The plugin never starts Pi, opens TCP, chooses a worktree silently, or
+approves extension requests.
+
+Install/register it through Noctalia's normal plugin workflow, then add its
+bar widget in Noctalia settings.