docs: document multi-key support and shared connection model

2026-08-14 11:01:32 -06:00
parent 733bc2b4f9
commit 35481bf387
2 changed files with 3 additions and 1 deletions
@@ -1804,6 +1804,8 @@ export class GpuGraph extends SingletonAction<GpuSettings> {

 - [ ] **Step 3: Verify it typechecks**

+> **Post-implementation note (approved final-review fix):** the final shipped actions key all per-key state on `ev.action.id` in a `Map` (per `stateFor(action)`), because a `SingletonAction` instance is shared by every key of that UUID — the instance-field version above clobbered state across multiple keys. See commit `ccbf74c`. The runtime's `ensureConnections` also rebuilds the shared feed/poller when a key's base URL or API key changes. The logic described here (states, pulse lifecycle, render-on-change, press-to-open) is unchanged; only state ownership moved from instance fields to per-key Map entries.
+
 Run: `npm run build`
 Expected: build succeeds.