pi-minimal-footer 0.5.2 → 0.5.3

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.3] - 2026-10-07
+
+### Changed
+
+- Refresh local Git divergence while Pi is idle every 91 seconds by default, configurable through `minFooter.gitRefreshSeconds`; stop polling when the footer is disposed and never fetch remote refs
+
 ## [0.5.2] - 2026-10-07
 
 ### Added
@@ -210,7 +216,8 @@ First npm-ready release.
 
 - Project scaffold — `extensions/index.ts` with basic footer structure, `package.json` with pi extension manifest, `README.md`, `LICENSE` (MIT)
 
-[Unreleased]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.5.2...HEAD
+[Unreleased]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.5.3...HEAD
+[0.5.3]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.5.2...v0.5.3
 [0.5.2]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.5.1...v0.5.2
 [0.5.1]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.5.0...v0.5.1
 [0.5.0]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.4.2...v0.5.0

package/README.md

@@ -62,6 +62,7 @@ Edit `minFooter` in Pi's agent `settings.json` (normally `~/.pi/agent/settings.j
     "showModel": true,
     "showContext": true,
     "powerlineSeparator": true,
+    "gitRefreshSeconds": 91,
     "maxUsageBarCells": 10
   }
 }
@@ -69,6 +70,7 @@ Edit `minFooter` in Pi's agent `settings.json` (normally `~/.pi/agent/settings.j
 
 - `showSkills` shows **extension status text**, not installed skills. The footer does not add the example statuses itself.
 - Set `powerlineSeparator` to `false` for plain spaces instead of `` / `` if your font lacks those glyphs. The git icon `` and sync arrows also need compatible glyphs; hide Git data with `showGitBranch: false` if needed.
+- `gitRefreshSeconds`: local Git refresh interval; positive integer seconds; default/fallback `91`; no remote fetch.
 - `maxUsageBarCells` caps the Braille bar length (excluding brackets and reset time). Use a positive integer, e.g. `4` for a compact bar; invalid values fall back to `10`.
 
 ## Reading the footer

package/VISION.md

@@ -40,7 +40,7 @@ The bar and reset label have no intervening space. Reset formatting uses local c
 
 - Pi supplies the branch name. Query `git rev-list --left-right --count HEAD...@{upstream}` for `↑N` local-only and `↓N` upstream-only commits. Use local refs; never fetch automatically.
 - Query outside rendering with a one-second timeout so Git cannot block the TUI. Missing upstreams and command failures omit counts.
-- Refresh on branch-change signals and footer state updates. Ignore older query results to prevent stale counts from restarting highlights.
+- Refresh on branch-change signals and footer state updates, plus every 91 seconds while the footer is active so external commits are noticed even when Pi is idle. `minFooter.gitRefreshSeconds` accepts positive integer seconds; invalid values fall back to 91. Local-only queries permit a shorter interval than subscription usage polling without network traffic. Stop the timer on footer disposal. Ignore older query results to prevent stale counts from restarting highlights.
 - Use the theme's normal text foreground while unsynced, otherwise dim. A count change bolds the arrows/counts until two subsequent user submissions; further changes restart the window. Tool turns and extension prompts do not consume it.
 - Initial loading and working-directory changes establish an unhighlighted baseline. Zero counts hide the arrows entirely.
 

package/extensions/index.ts

@@ -32,6 +32,7 @@ interface Settings {
     showModel?: boolean;
     showContext?: boolean;
     powerlineSeparator?: boolean;
+    gitRefreshSeconds?: number;
     maxUsageBarCells?: number;
   };
 }
@@ -48,6 +49,7 @@ const DEFAULT_SETTINGS: FooterSettings = {
   showModel: true,
   showContext: true,
   powerlineSeparator: true,
+  gitRefreshSeconds: 91,
   maxUsageBarCells: MAX_BAR_CELLS,
 };
 
@@ -81,6 +83,9 @@ function writeSettings(patch: Partial<Settings>): void {
 function readConfig(): FooterSettings {
   const s = readSettings();
   const config = { ...DEFAULT_SETTINGS, ...s.minFooter };
+  if (typeof config.gitRefreshSeconds !== "number" || !Number.isSafeInteger(config.gitRefreshSeconds) || config.gitRefreshSeconds < 1) {
+    config.gitRefreshSeconds = 91;
+  }
   if (typeof config.maxUsageBarCells !== "number" || !Number.isSafeInteger(config.maxUsageBarCells) || config.maxUsageBarCells < 1) {
     config.maxUsageBarCells = MAX_BAR_CELLS;
   }
@@ -282,10 +287,26 @@ export default function (pi: ExtensionAPI) {
       const request = () => tui.requestRender();
       requestRender = request;
       let disposed = false;
+      // External commits need to become visible even when Pi is idle. Local-only
+      // queries allow a shorter interval than usage polling without network traffic.
+      const gitRefreshMs = (config.gitRefreshSeconds ?? 91) * 1000;
+      let gitTimer: ReturnType<typeof setTimeout> | null = null;
+      const scheduleGitRefresh = () => {
+        if (disposed) return;
+        gitTimer = setTimeout(() => {
+          gitTimer = null;
+          void updateGitSync(state).then(() => tui.requestRender()).finally(scheduleGitRefresh);
+        }, gitRefreshMs);
+        // Do not keep a non-interactive process alive solely for footer refresh.
+        gitTimer.unref?.();
+      };
+      scheduleGitRefresh();
       const dispose = () => {
         if (disposed) return;
         disposed = true;
         unsub();
+        if (gitTimer) clearTimeout(gitTimer);
+        gitTimer = null;
         // A superseded renderer must not stop its replacement's usage polling.
         if (requestRender === request) {
           requestRender = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-minimal-footer",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "An opinionated minimal footer extension for Pi — clean status line with path, extension statuses, model, and context usage.",
   "keywords": [
     "pi-package",