pi-minimal-footer 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.2] - 2026-10-07
+
+### Added
+
+- Publish the same extension as the official scoped mirror `@ryu-cz/pi-minimal-footer`, while retaining `pi-minimal-footer` as the original release path
+- Document both installation names and warn users to install only one
+
+## [0.5.1] - 2026-10-07
+
+### Changed
+
+- Keep the whole Git section in normal text foreground while commits remain to push or pull, returning to dim when synced
+- Bold changed Git divergence arrows/counts for two user submissions; further changes restart the highlight, while tool turns and extension prompts do not consume it
+
 ## [0.5.0] - 2026-10-07
 
 ### Added
@@ -196,7 +210,10 @@ 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.4.2...HEAD
+[Unreleased]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.5.2...HEAD
+[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
 [0.4.2]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.4.1...v0.4.2
 [0.4.1]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.4.0...v0.4.1
 [0.4.0]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.3.3...v0.4.0

package/README.md

@@ -7,14 +7,14 @@
   <a href="https://pi.dev/packages/pi-minimal-footer"><img src="https://img.shields.io/badge/pi-package-1a1a2e" alt="pi package"></a>
 </p>
 
-An opinionated, compact one-line footer for [Pi](https://github.com/earendil-works/pi).
+Pi minimal footer is an opinionated, compact, one-line status bar for [Pi](https://github.com/earendil-works/pi).
 
 ![Footer preview: ~/git/project   main        🧠 Karpathy  🪽 Icarus  model · 42/200k · [⣿⣿⣿⣤⠀⠀⠀⠀⠀⠀]↻1d8h](media/github-preview.png)
 
 **Left**
 
 - Working directory: `~/git/project`
-- Git branch and upstream divergence: ` main ↑2 ↓1` (`↑` to push, `↓` to pull); counts appear when an upstream is configured
+- Git branch: ` main ↑2 ↓1` (`↑` to push, `↓` to pull)
 
 **Right**
 
@@ -27,10 +27,19 @@ An opinionated, compact one-line footer for [Pi](https://github.com/earendil-wor
 
 Requires Node.js >=22.19.0. Interactive terminal UI only.
 
+Choose one npm name (they contain the same extension; do not install both):
+
 ```bash
 pi install npm:pi-minimal-footer
+# or
+pi install npm:@ryu-cz/pi-minimal-footer
 ```
 
+`pi-minimal-footer` remains the original, unscoped release path. The scoped
+`@ryu-cz/pi-minimal-footer` package is an official mirror intended to improve
+package indexing; it is not a separate extension. The scoped name is an
+indexing workaround, not a guaranteed fix for pi.dev catalog search.
+
 ## Commands
 
 | Command | Action |
@@ -60,11 +69,14 @@ 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.
-- Git sync counts are omitted for branches without an upstream, detached HEADs, and non-Git directories.
 - `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
 
+### Git
+
+Counts require a configured upstream. Unsynced branches use the theme's normal foreground; synced branches are dim. Changed counts stay bold until two subsequent user messages; further changes restart the highlight.
+
 ### Context
 
 `42/200k` means tokens used / context window. `?` means Pi has not reported usage yet, including immediately after compaction.

package/VISION.md

@@ -8,12 +8,11 @@ The [README](README.md) is the user manual. This document records current design
 
 ## Layout contract
 
-- Directory and git branch form the left group, separated by ``. Pi supplies the branch name; the extension asynchronously runs `git rev-list --left-right --count HEAD...@{upstream}` to append local/upstream divergence as `↑N`/`↓N` (push/pull). The counts are omitted when no upstream is configured, and Git work stays outside synchronous rendering so a slow repository cannot block the TUI.
+- Directory and Git branch form the left group, separated by ``.
 - Each extension status is its own `` tab. Preserve the supplied text; do not invent status labels, parentheses, or pipes.
 - Model, context, and subscription usage form the rightmost group, separated by ` · `. Model identifies the running engine; context describes its usage; the usage bar stays anchored at the right edge.
 - Powerline separators are dim. `powerlineSeparator: false` replaces them with a single space. Font availability cannot be detected reliably.
 - Measure terminal columns with `visibleWidth`, not string length. Preserve ANSI styling and wide-character accounting when truncating.
-- Git divergence refreshes on Pi's branch-change signal and normal footer state refreshes; it is best-effort and never allowed to prevent the footer from loading.
 
 ### Space allocation
 
@@ -37,6 +36,14 @@ Two cells give 6.25% steps; ten give 1.25%. Fill rounds to the nearest eighth-ce
 
 The bar and reset label have no intervening space. Reset formatting uses local clock time through 24 hours, remaining whole days/hours above 24 hours, and whole days above 10 days. Exactly 24 hours stays clock time; exactly 10 days is `↻10d0h`. Missing reset metadata leaves the bar visible without a label.
 
+## Git contract
+
+- 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.
+- 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.
+
 ## Subscription usage contract
 
 Display only the selected provider's shortest applicable window. Subscription usage and model context usage are separate measurements.
@@ -96,12 +103,18 @@ For a manual install, copy `extensions/*` into `~/.pi/agent/extensions/`.
 - `extensions/index.ts`: settings, state refresh, layout, footer lifecycle, and `/minfooter`.
 - `extensions/lib/usage-limits.ts`: usage refresh, cache, cancellation, and bar/reset rendering.
 - `extensions/lib/usage-providers.ts`: authentication, endpoint selection, and response normalization.
-- `tests/`: loader-based lifecycle/layout regression tests and usage parsing tests.
+- `tests/`: lifecycle/layout regressions, Git highlighting with a temporary repository, and usage parsing tests.
 
 Settings live under `minFooter` in Pi's configured agent directory. Read them at session start or explicit toggle; ordinary refreshes use cached settings. Preserve unrelated settings on writes. Only install the footer in interactive terminal mode.
 
 ### Checking changes
 
-For behavior changes, run `npm run check` and `npm test`. Layout tests should cover narrow widths, ANSI text, wide Unicode, field priority, and both separator modes. Subscription usage changes should cover provider switches, timeouts, stale cache, partial updates, and malformed/missing metadata as applicable. Preview in a real terminal for font-dependent appearance; automated width checks cannot prove glyph availability.
+Run `npm run check` and `npm test` for behavior changes. Cover relevant cases:
+
+- Layout: narrow widths, ANSI/wide Unicode, field priority, and separator modes.
+- Git: divergence, synced styling, highlight expiry/restart, and user submissions versus tool turns.
+- Subscription usage: provider switches, timeouts, stale cache, partial updates, and malformed/missing metadata.
+
+Preview font-dependent appearance in a real terminal; width checks cannot prove glyph availability.
 
 Keep release notes in [CHANGELOG.md](CHANGELOG.md), and keep the README focused on installation and daily use. Preserve [upstream MIT attribution](extensions/lib/LICENSE) when changing adapted provider code.

package/extensions/index.ts

@@ -116,6 +116,9 @@ interface FooterState {
   model: string;
   context: string;
   gitSync: string;
+  gitInitialized: boolean;
+  gitHighlightInputs: number;
+  gitRequest: number;
 }
 
 async function getGitSync(cwd: string): Promise<string> {
@@ -139,12 +142,23 @@ async function getGitSync(cwd: string): Promise<string> {
 
 async function updateGitSync(state: FooterState): Promise<void> {
   const cwd = state.cwd;
+  const request = ++state.gitRequest;
   const gitSync = await getGitSync(cwd);
-  if (state.cwd === cwd) state.gitSync = gitSync;
+  // Refresh events can overlap; an older result must not restart the highlight.
+  if (state.cwd !== cwd || request !== state.gitRequest) return;
+  if (state.gitInitialized && state.gitSync !== gitSync) state.gitHighlightInputs = 2;
+  state.gitSync = gitSync;
+  state.gitInitialized = true;
 }
 
 function updateState(ctx: ExtensionContext, state: FooterState): void {
-  state.cwd = ctx.cwd ?? process.cwd();
+  const cwd = ctx.cwd ?? process.cwd();
+  if (state.cwd !== cwd) {
+    state.gitSync = "";
+    state.gitInitialized = false;
+    state.gitHighlightInputs = 0;
+  }
+  state.cwd = cwd;
   state.model = ctx.model?.id ?? "no-model";
   const usage = ctx.getContextUsage();
   if (usage) {
@@ -233,7 +247,10 @@ function buildLine(
 export default function (pi: ExtensionAPI) {
   let config = readConfig();
   let enabled = config.enabled !== false;
-  const state: FooterState = { cwd: process.cwd(), model: "no-model", context: "?", gitSync: "" };
+  const state: FooterState = {
+    cwd: process.cwd(), model: "no-model", context: "?", gitSync: "",
+    gitInitialized: false, gitHighlightInputs: 0, gitRequest: 0,
+  };
   let requestRender: (() => void) | null = null;
   let disposeFooter: (() => void) | null = null;
   const usageLimits = new UsageLimits(() => requestRender?.());
@@ -284,13 +301,15 @@ export default function (pi: ExtensionAPI) {
             ? [...footerData.getExtensionStatuses().values()].filter((s) => s.trim())
             : [];
           const branch = config.showGitBranch ? footerData.getGitBranch() : null;
-          const branchText = branch ? `${branch}${state.gitSync}` : "";
+          const syncText = state.gitHighlightInputs > 0 ? theme.bold(state.gitSync) : state.gitSync;
+          const branchText = branch ? `${branch}${syncText}` : "";
           const statusSeparator = config.powerlineSeparator ? theme.fg("dim", "  ") : " ";
           const line = buildLine(
             width,
             config.showPath ? theme.fg("dim", abbreviateHome(state.cwd, homedir())) : "",
             statuses.length ? statusSeparator + statuses.map((status) => theme.fg("dim", status)).join(statusSeparator) : "",
-            branchText ? theme.fg("dim", ` ${branchText}`) : "",
+            // Keep unsynced branches readable; bold counts separately mark recent changes.
+            branchText ? theme.fg(state.gitSync ? "text" : "dim", ` ${branchText}`) : "",
             config.showModel ? theme.bold(state.model) : "",
             config.showContext ? theme.fg("dim", theme.bold(state.context)) : "",
             (available, maxCells = BASE_BAR_CELLS) => usageLimits.line(available, theme, maxCells),
@@ -322,6 +341,13 @@ export default function (pi: ExtensionAPI) {
     install(ctx);
   });
 
+  // Count user submissions, not turn_end: one prompt can trigger many tool turns.
+  // Extension-generated prompts do not consume the user's highlight window.
+  pi.on("input", (event, ctx) => {
+    if (event.source !== "extension" && state.gitHighlightInputs > 0) state.gitHighlightInputs--;
+    refresh(ctx);
+  });
+
   pi.on("model_select", async (_event, ctx) => {
     selectUsage(ctx);
     refresh(ctx);

package/package.json

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