@rackbops/ac-plugin-contract 2.0.0-alpha.33 → 2.0.0-alpha.35

package/AUTHORING.md

@@ -367,6 +367,16 @@ override a card's height per layout; picking that same default height back clear
 pinning it, so an un-touched card keeps tracking whatever this manifest declares even after a redeploy changes
 it.
 
+**A panel keeps its own data fresh.** The shell mounts a panel when its tab is opened and leaves it mounted
+until the operator navigates away: it never remounts one to refresh it. (It used to, on any return to the
+window more than a minute after the panel was opened, which reset every filter, selection and half-typed field
+the panel held, every time.) So a panel whose data goes stale while it is open refreshes it itself, in place,
+into the state already on screen: the Board polls every 60 s, and Issues (`issues-classic`) reads its list
+again when the tab comes back (`focus` on `window`, or `visibilitychange` to visible) more than a minute after
+it opened or last refreshed. A panel that does neither -- Agents, the Admin board's cards -- reads when it is
+opened and after its own actions. Only Home is still refreshed by the shell, which remounts it for Refresh, the
+heartbeat and a return after a minute.
+
 ### The `@ac/host` browser module
 
 `@ac/host` (typed as `BrowserHostApi` in `@ac/contract`) is the one shared module instance the shell and every

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rackbops/ac-plugin-contract",
-  "version": "2.0.0-alpha.33",
+  "version": "2.0.0-alpha.35",
   "private": false,
   "type": "module",
   "description": "The artifact-console plugin ABI for out-of-repo plugin authors: HostApi, the acPlugin manifest contribution points, the generated manifest JSON Schema, and the @ac/host ambient browser declaration.",