fix: show dimmed reset hint while rate-limit window is inactive

Fix: rate limits
- Do not render epoch reset timestamp (1970-01-01) when API returns resetAt 0
- Inactive window reads 'Reset at: N/A start using to begin countdown',
  with the hint in dimmed italic (brightBlack) and N/A in label grey
- Active window renders reset time and countdown in the same grey as the label
- resetTime is now nullable (null when resetAt <= 0)
- Add WindowLimitData unit tests covering resetAt 0, valid resetAt, remaining,
  and empty defaults

Author: Khip01

CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to this project will be documented in this file.
 
+## Unreleased
+
+### Fixes
+
+- TUI page 4 (Rate Limits) no longer renders an epoch reset timestamp
+  (`1970-01-01`) when a limit window has not started yet (API returns
+  `resetAt: 0`). When a window has no usage yet, the reset line reads
+  `Reset at: N/A start using to begin countdown`: the `N/A` shares the grey
+  color of the `Reset at:` label and the hint is rendered dimmed italic
+  (`brightBlack`, via RichText) so it does not draw attention while the
+  countdown is inactive. Once the window has a real `resetAt`, the line renders
+  the scheduled reset time and relative countdown in the same grey style as the
+  label, so only the active countdown is emphasized. This mirrors the official
+  `cmd` CLI which only shows a reset clock for a valid, future reset timestamp.
+
 ## v1.3.2 (2026-08-04)
 
 ### Features

lib/src/services/api_client.dart

@@ -98,7 +98,7 @@ class WindowLimitData {
         resetAt: (json['resetAt'] as num?)?.toInt() ?? 0,
       );
 
-  DateTime get resetTime => DateTime.fromMillisecondsSinceEpoch(resetAt);
+  DateTime? get resetTime => resetAt > 0 ? DateTime.fromMillisecondsSinceEpoch(resetAt) : null;
   double get remaining => cap - used;
 }
 

lib/src/tui/app.dart

@@ -1122,8 +1122,7 @@ class AppState extends State<CmdBridgeApp> {
                   Text('EXCEEDED', style: TextStyle(color: Colors.red, fontWeight: FontWeight.bold)),
               ]),
               SizedBox(height: 1),
-              Text('  Resets at: ${_fmtDate(c.fiveHour.resetTime)}  ${_relativeTime(c.fiveHour.resetTime)}',
-                  style: TextStyle(color: Colors.grey)),
+              _resetLine(c.fiveHour),
             ]),
           ));
         } else {
@@ -1152,8 +1151,7 @@ class AppState extends State<CmdBridgeApp> {
                   Text('EXCEEDED', style: TextStyle(color: Colors.red, fontWeight: FontWeight.bold)),
               ]),
               SizedBox(height: 1),
-              Text('  Resets at: ${_fmtDate(c.weekly.resetTime)}  ${_relativeTime(c.weekly.resetTime)}',
-                  style: TextStyle(color: Colors.grey)),
+              _resetLine(c.weekly),
             ]),
           ));
         } else {
@@ -2026,6 +2024,27 @@ class AppState extends State<CmdBridgeApp> {
     return '${dt.year}-${dt.month.toString().padLeft(2, '0')}-${dt.day.toString().padLeft(2, '0')} ${dt.hour.toString().padLeft(2, '0')}:${dt.minute.toString().padLeft(2, '0')}';
   }
 
+  Component _resetLine(WindowLimitData w) {
+    final reset = w.resetTime;
+    if (reset == null) {
+      return RichText(
+        text: TextSpan(children: [
+          const TextSpan(
+              text: '  Reset at: N/A ', style: TextStyle(color: Colors.grey)),
+          TextSpan(
+            text: 'start using to begin countdown',
+            style: TextStyle(
+              color: Colors.brightBlack,
+              fontStyle: FontStyle.italic,
+            ),
+          ),
+        ]),
+      );
+    }
+    return Text('  Reset at: ${_fmtDate(reset)}  ${_relativeTime(reset)}',
+        style: TextStyle(color: Colors.grey));
+  }
+
   String _relativeTime(DateTime target) {
     final diff = target.difference(DateTime.now());
     if (diff.isNegative) return '(overdue)';

test/api_client_test.dart

@@ -0,0 +1,47 @@
+import 'package:test/test.dart';
+import 'package:commandcode_bridge/src/services/api_client.dart';
+
+void main() {
+  group('WindowLimitData', () {
+    test('resetTime is null when resetAt is 0 (no active window)', () {
+      final w = WindowLimitData.fromJson({
+        'used': 0,
+        'cap': 3,
+        'exceeded': false,
+        'resetAt': 0,
+      });
+      expect(w.resetTime, isNull);
+    });
+
+    test('resetTime resolves positive resetAt to a real date', () {
+      final w = WindowLimitData.fromJson({
+        'used': 2.13,
+        'cap': 6,
+        'exceeded': false,
+        'resetAt': 1786253751340,
+      });
+      final rt = w.resetTime;
+      expect(rt, isNotNull);
+      expect(rt!.millisecondsSinceEpoch, 1786253751340);
+    });
+
+    test('remaining is cap minus used', () {
+      final w = WindowLimitData.fromJson({
+        'used': 2.13,
+        'cap': 6,
+        'exceeded': false,
+        'resetAt': 1786253751340,
+      });
+      expect(w.remaining, closeTo(3.87, 0.001));
+    });
+
+    test('missing fields default to safe values', () {
+      final w = WindowLimitData.fromJson({});
+      expect(w.used, 0);
+      expect(w.cap, 0);
+      expect(w.exceeded, isFalse);
+      expect(w.resetAt, 0);
+      expect(w.resetTime, isNull);
+    });
+  });
+}