fix: stop continuous API polling, refresh on page open or [r] only

Fix: polling
- Removed per-page interval auto-refresh that hit Command Code endpoints
  every 8-30s while staying on a page (e.g. Models/Cost)
- Data now refreshes only on manual [r] or once in the background when
  a page is opened, throttled to once per 10s
- Fixes spamming the Command Code API just by viewing a page

Chore: release
- Bump to 1.3.1 (package.json, pubspec.yaml, version.dart)
- Sync CHANGELOG + docs

Author: Khip01

CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project will be documented in this file.
 
+## v1.3.1 (2026-08-02)
+
+### Fixes
+
+- Removed continuous API polling: staying on a TUI page (e.g. Models or Cost)
+  no longer re-fetches Command Code data every few seconds. Data is refreshed
+  once in the background when a page is opened (throttled to once per 10s to
+  avoid spamming the API during rapid page switching) and on manual `[r]`
+  refresh. This avoids hammering the Command Code endpoints just by viewing a
+  page.
+
 ## v1.3.0 (2026-08-02)
 
 ### Features

docs/ARCHITECTURE.md

@@ -81,11 +81,12 @@ sync with Command Code pricing.
 ## Dynamic Model List
 
 The bridge does not rely solely on its bundled registry. On every TUI refresh
-(`[r]` or auto-refresh) it calls the official Command Code endpoint
-`GET /provider/v1/models`, caches the result in memory, and merges it with the
-52 bundled `ModelsDb` models. This means newly released models (for example
-`inclusionai/ling-3.0-flash-free`, `poolside/laguna-s-2.1-free`) are served by
-`/v1/models` and shown in the TUI without needing a bridge release.
+(`[r]`, or once in the background when a page is opened) it calls the official
+Command Code endpoint `GET /provider/v1/models`, caches the result in memory,
+and merges it with the 52 bundled `ModelsDb` models. This means newly released
+models (for example `inclusionai/ling-3.0-flash-free`,
+`poolside/laguna-s-2.1-free`) are served by `/v1/models` and shown in the TUI
+without needing a bridge release.
 
 - `api_client.fetchModels()` returns the live model list from the API
 - `ServerController.setLiveModelIds()` updates the in-memory cache used by `/v1/models`

docs/TUI.md

@@ -12,12 +12,20 @@
 | `6` | Proxy Config | Bridge state | Port, API URL, endpoints, uptime |
 | `7` | Cost Sync | Local CLI agent configs | Detected agents, provider list, model pricing, sync status |
 
+## Refresh Behavior
+
+Data is fetched from Command Code only when you press `[r]` (manual foreground
+refresh) or once in the background when you open a page (throttled to once per
+10 seconds). The bridge does not poll the API continuously while you stay on a
+page, so viewing the Models or Cost page does not spam the Command Code
+endpoints.
+
 ## Key Bindings
 
 | Key | Context | Action |
 |-----|---------|--------|
 | `1-7` | Always | Switch info page |
-| `r` | Always | Refresh all API data |
+| `r` | Always | Refresh all API data (manual) |
 | `o` | Always | Copy OpenAI endpoint URL to clipboard |
 | `a` | Always | Copy Anthropic URL to clipboard |
 | `p` | Always | Configure proxy port (with availability scan) |

lib/src/models/version.dart

@@ -1 +1 @@
-const bridgeVersion = '1.3.0';
+const bridgeVersion = '1.3.1';

lib/src/tui/app.dart

@@ -49,6 +49,7 @@ class AppState extends State<CmdBridgeApp> {
   bool _loadingData = false;
   bool _foregroundRefresh = true;
   DateTime? _lastAutoRefreshAt;
+  DateTime? _lastPageOpenRefreshAt;
   int _lastLogVersion = -1;
   int _lastModelVersion = 0;
 
@@ -87,25 +88,6 @@ class AppState extends State<CmdBridgeApp> {
     super.dispose();
   }
 
-  Duration _refreshIntervalForPage(_InfoPage page) {
-    switch (page) {
-      case _InfoPage.account:
-        return const Duration(seconds: 20);
-      case _InfoPage.plan:
-        return const Duration(seconds: 15);
-      case _InfoPage.usage:
-        return const Duration(seconds: 8);
-      case _InfoPage.limits:
-        return const Duration(seconds: 8);
-      case _InfoPage.models:
-        return const Duration(seconds: 30);
-      case _InfoPage.proxy:
-        return const Duration(seconds: 1);
-      case _InfoPage.cost:
-        return const Duration(seconds: 30);
-    }
-  }
-
   void _startActivePageRefresh() {
     _pageRefreshTimer?.cancel();
     _pageRefreshTimer = Timer.periodic(const Duration(seconds: 1), (_) {
@@ -123,9 +105,6 @@ class AppState extends State<CmdBridgeApp> {
   void _refreshVisiblePage() {
     if (!mounted || _panel != _Panel.main) return;
 
-    final now = DateTime.now();
-    final interval = _refreshIntervalForPage(_infoPage);
-
     if (_showLog && _lastLogVersion != LogStore.version) {
       _lastLogVersion = LogStore.version;
       setState(() {});
@@ -142,25 +121,30 @@ class AppState extends State<CmdBridgeApp> {
       setState(() {});
       return;
     }
-
-    if (_loadingData) return;
-    if (_lastAutoRefreshAt != null && now.difference(_lastAutoRefreshAt!) < interval) {
-      return;
-    }
-
-    _lastAutoRefreshAt = now;
-    _refreshData(silent: true, foreground: false);
   }
 
   void _setInfoPage(_InfoPage page) {
     _infoPage = page;
     _selectedModelIndex = 0;
     _infoScrollCtrl.jumpTo(0);
-    _lastAutoRefreshAt = null;
     _refreshVisiblePage();
+    _refreshDataOnPageOpen();
     setState(() {});
   }
 
+  /// Refresh data once in the background when a page is opened, throttled so
+  /// rapid page switching does not spam the Command Code API. Continuous
+  /// per-page polling was removed; use `[r]` for a manual foreground refresh.
+  void _refreshDataOnPageOpen() {
+    final now = DateTime.now();
+    if (_lastPageOpenRefreshAt != null &&
+        now.difference(_lastPageOpenRefreshAt!).inSeconds < 10) {
+      return;
+    }
+    _lastPageOpenRefreshAt = now;
+    _refreshData(silent: true, foreground: false);
+  }
+
   Color _notifColor() {
     final msg = _status;
     if (msg.startsWith('Data refreshed') || msg.contains('Copied')) return Colors.green;
@@ -457,6 +441,10 @@ class AppState extends State<CmdBridgeApp> {
     }
     _loadingData = true;
     _foregroundRefresh = foreground;
+    _lastAutoRefreshAt = DateTime.now();
+    if (foreground) {
+      _lastPageOpenRefreshAt = _lastAutoRefreshAt;
+    }
     if (!silent) {
       _setStatus('Fetching data...');
     }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "commandcode-bridge",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Command Code single-account proxy bridge with TUI dashboard. OpenAI-compatible endpoint for OpenCode, Cursor, etc.",
   "type": "module",
   "bin": {

pubspec.yaml

@@ -1,6 +1,6 @@
 name: commandcode_bridge
 description: Command Code single-account proxy bridge with OpenAI-compatible endpoint
-version: 1.3.0
+version: 1.3.1
 
 environment:
   sdk: ^3.10.8