@pi-unipi/unipi 3.0.0-alpha.26 → 3.0.0-alpha.28

package/CHANGELOG.md

@@ -6,6 +6,40 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [3.0.0-alpha.28] — 2026-10-04
+
+### Changed
+- `utility`: **`/unipi:summarize` re-summarizes the last reply**, with the session as context. The command sends only `/skill:summarize`, plus any text you add, which reaches the skill as your question ("what would it change?" now asks about the last reply). It no longer wraps your text in a "summarize this session" prompt.
+
+## [3.0.0-alpha.27] — 2026-10-04
+
+### Added
+- `core`: 4 new Unicrab hints for the footer changes — three what's-new tips (tokens and cost under the input, the Footer settings, the responsive drop) and a setting hint for `footer.rainbow`.
+- `footer`: **Glance settings** — the stats strip under the input, the frame badges and the rainbow are configurable in `/unipi:settings` → **Footer**: per-part strip toggles (`strip.turns`, `strip.time`, `strip.speed`, `strip.tokens`, `strip.cost`, `strip.compactions`, `strip.cache`), a **Rainbow** mode (`always` / `brand-only` / `off`), the background-task line (`processLine`), and badge toggles (`badges.mode`, `badges.planPermission`, `badges.fusion`, `badges.kanboard`).
+- `footer`: **session tokens and cost in the stats line** — `↑12.3k in · ↓4.1k out` and `$1.23` (`sub` on subscription models); sums skip failed/aborted replies.
+- `footer`: **responsive to the terminal** — narrow widths drop stats parts by priority (compactions → cache → time → turns → speed → cost → tokens) whole instead of truncating mid-part, and the frame degrades its badges (kanboard → fusion → plan/permission → mode) before the branch or model truncate; below 20 terminal rows the stats and task lines hide while the frame stays.
+
+- `workflow`: **plan reviews in two parts** — plans have a `## Summary` for the approver and an `## Implementation` for whoever builds it; the review overlay shows them side by side at 120+ columns (Tab switches pane) and stacked on narrower terminals.
+
+### Changed
+- `workflow`: **plan mode is no longer read-only by allowlist** — research, memory, subagents and read-only shell run as normal; only writes outside the plan file, `docs/plans/` and temp dirs are blocked (in every permission mode), and state-changing shell asks first (skipped in `full`).
+- `workflow`: **plan with the user before submitting** — the plan-mode prompt asks the model to settle shaping decisions with `ask_user`; `plan_submit` refuses while `### Open questions` lists items or when the plan is unchanged since "Keep planning", and Approve/Discard end the turn.
+- `fusion`: the lead's shell-delegation nudge counts per request (it no longer fires at the start of a new prompt) and treats piped read-only commands (`grep … | head`, `2>&1`) as trivial.
+
+### Removed
+- `footer`: the **classic segment renderer** — presets, separators, segments, `/unipi:footer-help` and their settings (`preset`, `separator`, `zoneSeparator`, `showFullLabels`, `groups`, `glanceMode`) are gone; the glance frame is the only footer. Old keys in existing config files are ignored. `enabled: false` gives the plain pi editor.
+
+### Changed (footer)
+- `footer`: the **Color mode** setting now offers `auto` / `truecolor` / `256` / `none` (the hub previously offered `mono`, which the footer silently treated as `auto`; stored `mono` values load as `none`).
+- `footer`: the 1-second refresh no longer replays the whole session branch — the scan is incremental (full rescan on branch change or compaction), the stats read a cached snapshot instead of walking the branch per paint, settings loads are memoized, and the redraw fires only when something displayed changed.
+- `core` / `autocomplete`: `/unipi:footer-help` command entries removed.
+
+### Fixed
+- `footer`: the MODULE_READY announcement now reports the package version instead of a hard-coded `0.1.0`.
+
+### Docs
+- README: the glance-footer caption names tokens, cost and the responsive fit; a new What's new row for alpha.27 (classic footer removed).
+
 ## [3.0.0-alpha.26] — 2026-10-04
 
 ### Fixed

package/README.md

@@ -27,9 +27,16 @@
 ## Install
 
 ```bash
-pi install npm:@pi-unipi/unipi
+pi install npm:@pi-unipi/unipi@alpha
 ```
 
+> [!NOTE]
+> **UniPi 3 is in alpha.** This README describes v3, published under the npm
+> `alpha` tag. Plain `pi install npm:@pi-unipi/unipi` still installs the stable
+> 2.x line ([2.x README](https://github.com/Neuron-Mr-White/unipi/tree/main#readme)).
+> To update an alpha install: `pi update npm:@pi-unipi/unipi@alpha`. To go back
+> to stable: `pi install npm:@pi-unipi/unipi@latest`.
+
 UniPi needs [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent)
 `0.87.1` or later. This command installs 21 extension packages. Each package
 also works alone.
@@ -44,8 +51,9 @@ This screenshot shows one turn in a demo session:
 - **Memory** finds the test setup from an earlier session and saves a new fact
   for later sessions.
 - **The glance footer** frames the input box. It shows the git branch, the
-  mode, the context use and the model. The strip below it shows turns, steps,
-  wall time, tool time, time to first token, tokens per second and cache hits.
+  mode, the context use and the model. The strip below it shows tokens in and
+  out, cost, speed, turns, time and cache hits. It fits itself to the window:
+  on a narrow screen the less important parts drop out first.
 
 ## Why UniPi
 
@@ -241,10 +249,10 @@ The recent releases, in short. The [changelog](CHANGELOG.md) has the details.
 
 | Release | What changed for you |
 |---|---|
+| alpha.27 | The footer shows tokens in and out and the session cost under the input. It fits narrow and short windows. Each part of the stats line, the frame badges and the rainbow can be turned off in `/unipi:settings` → Footer. The classic footer is gone. |
 | alpha.25 | The Unicrab splash at startup. A new `/unipi:info`: this session, the context bucket, compaction savings and `s`/`p`/`g` scope tags. Prompts that UniPi sends for you (goal, summarize, answer) show as a UniPi panel, not as your own message. |
 | alpha.24 | The `summarize` skill and `/unipi:summarize [focus]`. Long work ends with a short recap: the answer first, then findings, open items and questions. |
 | alpha.23 | `/unipi:settings` explains each setting and each option in a panel below the list. Web tools with no working provider hide from the agent. |
-| alpha.22 | Simple mode is the default. Each tool call is one line, and `Ctrl+O` opens it. Images no longer overlap the text below them. |
 
 ## Docs
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "3.0.0-alpha.26",
+  "version": "3.0.0-alpha.28",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -83,26 +83,26 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "3.0.0-alpha.26",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.26",
-    "@pi-unipi/btw": "3.0.0-alpha.26",
-    "@pi-unipi/command-enchantment": "3.0.0-alpha.26",
-    "@pi-unipi/compactor": "3.0.0-alpha.26",
-    "@pi-unipi/core": "3.0.0-alpha.26",
-    "@pi-unipi/footer": "3.0.0-alpha.26",
-    "@pi-unipi/fusion": "3.0.0-alpha.26",
-    "@pi-unipi/info-screen": "3.0.0-alpha.26",
-    "@pi-unipi/input-shortcuts": "3.0.0-alpha.26",
-    "@pi-unipi/kanboard": "3.0.0-alpha.26",
-    "@pi-unipi/mcp": "3.0.0-alpha.26",
-    "@pi-unipi/memory": "3.0.0-alpha.26",
-    "@pi-unipi/notify": "3.0.0-alpha.26",
-    "@pi-unipi/skill-registry": "3.0.0-alpha.26",
-    "@pi-unipi/subagents": "3.0.0-alpha.26",
-    "@pi-unipi/updater": "3.0.0-alpha.26",
-    "@pi-unipi/utility": "3.0.0-alpha.26",
-    "@pi-unipi/web-api": "3.0.0-alpha.26",
-    "@pi-unipi/workflow": "3.0.0-alpha.26"
+    "@pi-unipi/ask-user": "3.0.0-alpha.28",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.28",
+    "@pi-unipi/btw": "3.0.0-alpha.28",
+    "@pi-unipi/command-enchantment": "3.0.0-alpha.28",
+    "@pi-unipi/compactor": "3.0.0-alpha.28",
+    "@pi-unipi/core": "3.0.0-alpha.28",
+    "@pi-unipi/footer": "3.0.0-alpha.28",
+    "@pi-unipi/fusion": "3.0.0-alpha.28",
+    "@pi-unipi/info-screen": "3.0.0-alpha.28",
+    "@pi-unipi/input-shortcuts": "3.0.0-alpha.28",
+    "@pi-unipi/kanboard": "3.0.0-alpha.28",
+    "@pi-unipi/mcp": "3.0.0-alpha.28",
+    "@pi-unipi/memory": "3.0.0-alpha.28",
+    "@pi-unipi/notify": "3.0.0-alpha.28",
+    "@pi-unipi/skill-registry": "3.0.0-alpha.28",
+    "@pi-unipi/subagents": "3.0.0-alpha.28",
+    "@pi-unipi/updater": "3.0.0-alpha.28",
+    "@pi-unipi/utility": "3.0.0-alpha.28",
+    "@pi-unipi/web-api": "3.0.0-alpha.28",
+    "@pi-unipi/workflow": "3.0.0-alpha.28"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.87.1",

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "3.0.0-alpha.26",
+  "version": "3.0.0-alpha.28",
   "description": "Structured user input tool for Pi coding agent — single-select, multi-select, freeform",
   "type": "module",
   "main": "index.ts",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.26"
+    "@pi-unipi/core": "3.0.0-alpha.28"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/autocomplete/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/command-enchantment",
-  "version": "3.0.0-alpha.26",
+  "version": "3.0.0-alpha.28",
   "description": "Enhanced TUI autocomplete for /unipi:* commands — colored, sorted, and grouped by package",
   "type": "module",
   "main": "src/index.ts",

package/packages/autocomplete/src/constants.ts

@@ -118,9 +118,8 @@ export const COMMAND_REGISTRY: Record<string, string> = {
   "unipi:kanboard-do":       "kanboard",
   "unipi:kanboard-autowork": "kanboard",
 
-  // footer (3 commands)
+  // footer (1 command)
   "unipi:footer":            "footer",
-  "unipi:footer-help":       "footer",
 
   // updater (3 commands)
   "unipi:readme":            "updater",
@@ -161,7 +160,7 @@ export const COMMAND_DESCRIPTIONS: Record<string, string> = {
   "unipi:cleanup":    "Remove stale UniPi temp files and leftovers (preview first)",
   "unipi:doctor":     "Check UniPi's runtime: config, model cache, Decision Model, skills",
   "unipi:answer":     "Answer the last reply — fixed input under the scrollable reply, per question, or web form",
-  "unipi:summarize":  "Summarize this session — answer first, then findings, open items, questions; add text to set a focus",
+  "unipi:summarize":  "Summarize your last reply again (answer first, then findings, open items, questions). Add text to ask about it",
   "unipi:skills":     "Manage skills — on/off per project, listed or not, the skill vault",
 
   "unipi:kanboard":        "Kanboard — capture tasks, run them, open the board",
@@ -183,8 +182,7 @@ export const COMMAND_DESCRIPTIONS: Record<string, string> = {
   "unipi:compact-help":     "Show compactor command help",
   "unipi:notify-event":     "Toggle a notify event without the TUI: <event> <on|off>",
 
-  "unipi:footer":            "Toggle footer or switch preset",
-  "unipi:footer-help":       "Show footer segment guide",
+  "unipi:footer":            "Toggle footer on or off",
 
   "unipi:readme":            "Browse package README files",
   "unipi:changelog":         "Browse changelog (Keep a Changelog format)",

package/packages/background-tasks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "3.0.0-alpha.26",
+  "version": "3.0.0-alpha.28",
   "description": "Background tasks for UniPi — durable shell jobs and delegated background agents with a footer dock",
   "type": "module",
   "main": "src/index.ts",
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-ai": "^0.87.1",
-    "@pi-unipi/core": "3.0.0-alpha.26",
+    "@pi-unipi/core": "3.0.0-alpha.28",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "3.0.0-alpha.26",
+  "version": "3.0.0-alpha.28",
   "description": "A pi extension for parallel side conversations with /unipi:btw — part of the Unipi suite",
   "type": "module",
   "main": "extensions/btw.ts",
@@ -37,7 +37,7 @@
     "@earendil-works/pi-tui": "^0.87.1"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.26"
+    "@pi-unipi/core": "3.0.0-alpha.28"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "3.0.0-alpha.26",
+  "version": "3.0.0-alpha.28",
   "description": "Compaction for Pi — lossless zero-LLM or model summaries, rebuilt from full history, with session recall",
   "type": "module",
   "main": "src/index.ts",
@@ -33,8 +33,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.26",
-    "@pi-unipi/info-screen": "3.0.0-alpha.26",
+    "@pi-unipi/core": "3.0.0-alpha.28",
+    "@pi-unipi/info-screen": "3.0.0-alpha.28",
     "@earendil-works/pi-agent-core": "^0.87.1"
   },
   "peerDependencies": {

package/packages/core/constants.ts

@@ -239,7 +239,6 @@ export const UPDATER_DIRS = {
 /** Footer command names */
 export const FOOTER_COMMANDS = {
   FOOTER: "footer",
-  FOOTER_HELP: "footer-help",
 } as const;
 
 /** Compactor defaults */

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "3.0.0-alpha.26",
+  "version": "3.0.0-alpha.28",
   "description": "Shared utilities, event types, and constants for Unipi extension suite",
   "type": "module",
   "license": "MIT",

package/packages/core/src/hints/lines.ts

@@ -244,7 +244,7 @@ export const HINT_LINES: readonly Hint[] = [
     when: "startup",
   },
 
-  // ─── setting (12) ───────────────────────────────────────────────────────────
+  // ─── setting (13) ───────────────────────────────────────────────────────────
   {
     id: "set.render-style",
     category: "setting",
@@ -319,6 +319,12 @@ export const HINT_LINES: readonly Hint[] = [
     text: "Info Screen → Unicrab splash in /unipi:settings: auto-close, stay until a key, or off.",
     when: "startup",
   },
+  {
+    id: "set.footer-rainbow",
+    category: "setting",
+    text: "footer.rainbow in /unipi:settings: always, brand-only, or off when the shimmer distracts you.",
+    when: "startup",
+  },
 
   // ─── capability (10) ────────────────────────────────────────────────────────
   {
@@ -493,7 +499,7 @@ export const HINT_LINES: readonly Hint[] = [
     teaches: "/unipi:cleanup",
   },
 
-  // ─── whatsnew (12) ───────────────────────────────────────────────────────────
+  // ─── whatsnew (15) ───────────────────────────────────────────────────────────
   {
     id: "new.unicrab",
     category: "whatsnew",
@@ -582,6 +588,28 @@ export const HINT_LINES: readonly Hint[] = [
     when: "startup",
     since: "3.0.0-alpha.25",
   },
+  {
+    id: "new.footer-tokens-cost",
+    category: "whatsnew",
+    text: "The footer now counts tokens in and out and what the session cost, right under the input.",
+    when: "startup",
+    since: "3.0.0-alpha.27",
+  },
+  {
+    id: "new.footer-settings",
+    category: "whatsnew",
+    text: "Too busy down there? /unipi:settings → Footer turns off any stats part, badge or the rainbow.",
+    when: "startup",
+    teaches: "/unipi:settings",
+    since: "3.0.0-alpha.27",
+  },
+  {
+    id: "new.footer-responsive",
+    category: "whatsnew",
+    text: "Shrink the window and the footer drops its least important stats first, no cut-off text.",
+    when: "startup",
+    since: "3.0.0-alpha.27",
+  },
 
   // ─── workflow (8) ───────────────────────────────────────────────────────────
   {

package/packages/footer/README.md

@@ -1,6 +1,6 @@
 # Footer
 
-Show live session stats and the state of every UniPi package at the bottom of the terminal.
+Frames the input box and shows live session stats at the bottom of the terminal.
 
 `@pi-unipi/footer` · part of [UniPi](../../README.md)
 
@@ -8,11 +8,10 @@ Show live session stats and the state of every UniPi package at the bottom of th
 
 ## What it does
 
-- Puts a frame around the input box. This is **glance mode**, and it is on by default.
-- Shows a stats line below the input. It shows turns, steps, model time and tool time. It also shows average time to first token (TTFT), tokens per second, compactions and cache hit rate.
+- Puts a frame around the input box (**the glance frame**, always on when the footer is enabled).
+- Shows a stats line below the input: input/output tokens, cost, average time to first token (TTFT), tokens per second, turns, steps, model and tool time, cache hit rate, and compactions.
 - Shows a line above the input with counts of background tasks: running, stopped, failed and done.
-- Shows a status line with segments from each package when glance mode is off. This is the **classic** footer.
-- Lets you select a preset, separator, icon style and color mode, and turn each segment on or off.
+- Adapts to the terminal: parts of the stats line drop by priority when the terminal is narrow, badges leave the frame titles before the branch or model truncate, and on very short terminals the stats and task lines hide.
 
 ## Quick start
 
@@ -36,35 +35,23 @@ The footer starts with the session. Open `/unipi:settings` → **Footer** to cha
 |---|---|
 | `/unipi:footer` | Turns the footer on or off. |
 | `/unipi:footer on` | Turns the footer on. |
-| `/unipi:footer off` | Turns the footer off. |
-| `/unipi:footer-help` | Shows each active segment with its icon, label and description. |
+| `/unipi:footer off` | Turns the footer off (plain pi editor). |
 
 ## The glance frame
 
-The glance frame has three parts:
+The frame has three parts:
 
-- **Top border.** The UNIPI brand, the long-horizon mode, the git branch, and the plan and permission mode. The brand shows a moving rainbow. The frame also shows the rainbow when the thinking level is `xhigh` or `max`.
+- **Top border.** The UNIPI brand, the long-horizon mode, the git branch, and the plan and permission mode. The brand shows a moving rainbow. The frame also shows the rainbow when the thinking level is `xhigh` or `max` (unless **Rainbow** is `brand-only`).
 - **Bottom border.** The workspace name, context use and window size, the model and the thinking level. With a [Fusion](../fusion/README.md) pair, it shows the lead and the sidekick. It also shows Kanboard claims.
 - **Stats line.** The line below the input. A part stays hidden until it has data. For example, compactions show only after the first compaction.
 
 The background-task line reads the [Background Tasks](../background-tasks/README.md) registry. It shows nothing when no task exists.
 
-Set **Glance mode** to off to get the classic status line.
+## Responsive behavior
 
-## Presets
-
-A preset selects the segments of the classic status line.
-
-| Preset | Segments |
-|---|---|
-| `default` | brand, mode, model, directory, git, context, compactions, tokens, TPS, cost, clock, duration |
-| `classic` | mode, model, API state, tool count, git, TPS, context, cost, compactions, memory, command, loop status, extensions |
-| `minimal` | mode, model, git, context, clock |
-| `compact` | mode, model, git, TPS, context, cost, clock, duration |
-| `full` | all groups, with a second row |
-| `ascii` | the same segments as `compact` |
-
-The hub list also shows `dense`, `devops` and `zen`. These names have no preset definition, so the footer uses `default` for them. To select `compact`, `full` or `ascii`, edit the settings file.
+- **Width.** Each stats-line part has a priority. When the line does not fit, the lowest-priority parts drop whole (never mid-part), in this order: compactions, cache, time, turns, speed, cost — tokens always survive. The frame titles degrade the same way: the Kanboard label, the Fusion pair, the plan/permission cluster and the mode label drop (lowest value first) before the branch or model ever truncate.
+- **Width safety.** Nothing ever writes the last terminal column (a full-width line desyncs wrapping terminals).
+- **Height.** Below 20 terminal rows the stats line and the background-task line hide; the frame stays.
 
 ## Settings
 
@@ -72,33 +59,32 @@ Open `/unipi:settings` → **Footer**. The file is `~/.unipi/config/footer/confi
 
 | Key | Default | What it does |
 |---|---|---|
-| `enabled` | `true` | Turns the footer on or off. |
-| `glanceMode` | `true` | Uses the glance frame around the input. |
-| `preset` | `default` | Selects the segments of the classic status line. |
-| `showFullLabels` | `false` | Shows full labels in place of short labels. |
-| `separator` | `powerline-thin` | Segment divider: `powerline`, `powerline-thin`, `slash`, `pipe`, `dot`, `ascii`. |
-| `zoneSeparator` | `│` | Divider between the left, center and right zones. |
+| `enabled` | `true` | Turns the footer on or off. `false` leaves the plain pi editor. |
 | `iconStyle` | `nerd` | Icon set: `nerd` (needs a Nerd Font), `emoji` or `text`. |
-| `colorMode` | `auto` | `auto`, `truecolor`, `256` or `none`. |
-| `groups.<group>.show` | `true` (`notify`: `false`) | Shows or hides a segment group. |
-| `groups.<group>.segments.<id>` | per segment | Shows or hides one segment. |
-
-`colorMode: auto` uses 24-bit color where the terminal supports it. It uses 256 colors in terminals such as Apple Terminal. It uses no color when the `NO_COLOR` environment variable exists.
-
-The hub **Color mode** list shows `mono`. The footer does not know this value and uses `auto`. Use `none` in the file to turn off color.
-
-For the full list of segments and icons, refer to [Footer customization](../../FOOTER_CUSTOMIZATION.md).
+| `colorMode` | `auto` | `auto`, `truecolor`, `256` or `none`. The legacy value `mono` loads as `none`. |
+| `rainbow` | `always` | `always` animates the brand (and the whole frame at `xhigh`/`max` thinking); `brand-only` never animates the whole frame; `off` disables the animation. |
+| `processLine` | `true` | Shows the background-task line above the input. |
+| `strip.turns` | `true` | Turn and step counters. |
+| `strip.time` | `true` | Model time and tool time. |
+| `strip.speed` | `true` | Average TTFT and tokens per second. |
+| `strip.tokens` | `true` | Session input and output tokens. |
+| `strip.cost` | `true` | Session cost, or `sub` when the model runs on a subscription. |
+| `strip.compactions` | `true` | Compaction count, sizes and recency. |
+| `strip.cache` | `true` | Cache hit percentage. |
+| `badges.mode` | `true` | Long-horizon mode label beside the brand. |
+| `badges.planPermission` | `true` | PLAN badge and permission mode in the top border. |
+| `badges.fusion` | `true` | Fusion lead and sidekick in the bottom border. |
+| `badges.kanboard` | `true` | Kanboard claims label in the top border. |
+
+`colorMode: auto` uses 24-bit color where the terminal supports it, 256 colors in terminals such as Apple Terminal, and no color when the `NO_COLOR` environment variable exists.
+
+Old v2 keys (`preset`, `separator`, `zoneSeparator`, `showFullLabels`, `groups`, `glanceMode`) in existing config files are ignored.
 
 ## How it works
 
-The footer listens to UniPi events on the [event bus](../../docs/architecture/event-bus.md). Examples are `MEMORY_STORED`, `MCP_SERVER_STARTED`, `RALPH_LOOP_START`, `WORKFLOW_START`, `COMPACTOR_COMPACTED` and `NOTIFICATION_SENT`. It keeps the last data of each event. Thus a package that loads after the footer still shows its data.
-
-Some segments read data directly: the Pi session, the Kanboard registry and the Info Screen cache. The footer draws again each second.
-
-The classic status line puts segments that do not fit into a second row.
+The footer listens to UniPi events on the [event bus](../../docs/architecture/event-bus.md) for mode, plan and permission state. Usage data comes from an incremental scan of the session branch: each second only new entries are processed (a compaction or branch change triggers a full rescan), the same pass filling a cached snapshot for the stats line. The TPS tracker is fed live by pi's streaming events and reconciled by the same scan. The footer redraws when something it displays changed — plus once a second while the rainbow animates.
 
 ## See also
 
-- [Footer customization](../../FOOTER_CUSTOMIZATION.md)
 - [Info Screen](../info-screen/README.md)
 - [Settings reference](../../docs/reference/settings.md)

package/packages/footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "3.0.0-alpha.26",
+  "version": "3.0.0-alpha.28",
   "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "3.0.0-alpha.26",
-    "@pi-unipi/background-tasks": "3.0.0-alpha.26"
+    "@pi-unipi/core": "3.0.0-alpha.28",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.28"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.87.1",

package/packages/footer/src/commands.ts

@@ -1,15 +1,14 @@
 /**
  * @pi-unipi/footer — Commands
  *
- * Footer commands: /unipi:footer (toggle) and /unipi:footer <preset>.
+ * /unipi:footer — toggle the footer on/off.
  */
 
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { UNIPI_PREFIX, FOOTER_COMMANDS } from "@pi-unipi/core";
-import { loadFooterSettings, saveFooterSettings } from "./config.js";
-import { showFooterHelp } from "./help.js";
-import type { FooterSegment } from "./types.js";
-import { applyGlanceMode, type FooterState } from "./index.js";
+import { saveFooterSettings } from "./config.js";
+import type { FooterState } from "./index.js";
+import { fullRescan } from "./index.js";
 
 /**
  * Register footer commands.
@@ -21,34 +20,17 @@ export function registerCommands(pi: ExtensionAPI, state: FooterState): void {
     handler: async (args, ctx) => {
       const arg = args?.trim().toLowerCase();
 
-      // on
-      if (arg === "on") {
-        state.enabled = true;
-        state.renderer.setActive(true);
-        saveFooterSettings({ enabled: true });
-        state.setupUI?.(pi, ctx);
-        ctx.ui.notify("Footer enabled", "info");
-        return;
-      }
+      let enable: boolean;
+      if (arg === "on") enable = true;
+      else if (arg === "off") enable = false;
+      else enable = !state.enabled;
 
-      // off
-      if (arg === "off") {
-        state.enabled = false;
-        state.renderer.setActive(false);
-        ctx.ui.setFooter(undefined);
-        ctx.ui.setWidget("footer-top", undefined);
-        ctx.ui.setWidget("footer-secondary", undefined);
-        saveFooterSettings({ enabled: false });
-        ctx.ui.notify("Footer disabled", "info");
-        return;
-      }
-
-      // Toggle (no args or unknown args)
-      state.enabled = !state.enabled;
-      state.renderer.setActive(state.enabled);
+      state.enabled = enable;
+      saveFooterSettings({ enabled: enable });
 
-      if (state.enabled) {
+      if (enable) {
         state.setupUI?.(pi, ctx);
+        fullRescan(state);
         ctx.ui.notify("Footer enabled", "info");
       } else {
         ctx.ui.setFooter(undefined);
@@ -56,17 +38,6 @@ export function registerCommands(pi: ExtensionAPI, state: FooterState): void {
         ctx.ui.setWidget("footer-secondary", undefined);
         ctx.ui.notify("Footer disabled", "info");
       }
-
-      saveFooterSettings({ enabled: state.enabled });
-    },
-  });
-
-  // /unipi:footer-help — show help overlay
-  pi.registerCommand(`${UNIPI_PREFIX}${FOOTER_COMMANDS.FOOTER_HELP}`, {
-    description: "Show footer segment guide (icons, labels, descriptions)",
-    handler: async (_args, _ctx) => {
-      const allSegments = Array.from(state.segmentLookup.values());
-      showFooterHelp(pi, allSegments, state.renderer.getPresetName());
     },
   });
 }