@gonrocca/zero-pi 0.1.68 → 0.1.70

package/README.md

@@ -123,6 +123,7 @@ into `/forge` for you.
 | **SDD routing skill** | Natural-language requests that say "hacelo con sdd" route into `/forge` without remembering the slash command. |
 | **`zero-sdd` theme** | A dark, high-contrast pi theme tuned for SDD work. |
 | **`zero-sunset` theme** | A warm sunset variant — gold/coral/magenta accents over warm-dark panels, with one cool tone kept for syntax legibility. Activate with `/theme zero-sunset`. |
+| **`zero-omp-neon` theme** | A high-contrast OMP-inspired neon theme with separated colour roles: cyan links/paths, gold titles, mint code/success, violet borders, and navy tool cards. Activate with `/theme zero-omp-neon`. |
 
 ## ⌨️ Commands
 
@@ -145,6 +146,69 @@ into `/forge` for you.
 | `/zero-diff <slug>` | Preview the logical spec-store merge without writing files. |
 | `/zero-resume` | Write the session handoff note now. |
 
+## 🎛️ Visual chrome: HUD, activity panel, prompt box
+
+zero-pi ships several visual extensions. They are related, but each one owns a different part of pi's TUI:
+
+| Surface | File | Where it appears | Purpose |
+| ------- | ---- | ---------------- | ------- |
+| **ZERO HUD** | `extensions/zero-hud.ts` | Footer/status line at the bottom | Persistent model/tokens/cost/diff/context/branch telemetry. |
+| **Activity panel** | `extensions/zero-activity-panel.ts` | Widget above the prompt while work is running | Live `/forge` phase progress plus recent tool cards. |
+| **Prompt box** | `extensions/zero-pretty-input-box.ts` | The input/editor box | OMP-like rounded box with ZERO chips and key hints. |
+| **Code fences** | `extensions/zero-pretty-code-fences.ts` | Markdown code blocks in chat | Bordered panels with language badges instead of raw ```txt / ```json lines. |
+| **Working phrases** | `extensions/working-phrases.ts` | Tiny loading row (`Procesando… (esc)`) | Rotating ZERO/SDD/Star Wars/DBZ phrases and themed spinner. |
+
+### ZERO HUD presets
+
+The HUD is the **bottom footer**. It is not the activity panel. Control it with:
+
+```txt
+/zero-hud preview
+/zero-hud compact
+/zero-hud minimal
+/zero-hud full
+/zero-hud ascii
+/zero-hud off
+/zero-hud on
+```
+
+Example compact HUD:
+
+```txt
+ZERO ▸ gpt-5.5 ▸ tok ↑1.1M ↓42K ▸ cost $16.22 ▸ diff +0/-0 ▸ ctx 11%
+```
+
+Startup preset can be set with:
+
+```bash
+ZERO_HUD_PRESET=full pi
+```
+
+Supported presets: `compact` (default), `minimal`, `full`, `ascii`, `off`.
+
+### Activity panel vs HUD
+
+During `/forge`, the activity panel appears **above the prompt** and summarizes the live run:
+
+```txt
+╭─ ZERO activity ───────────────────────────────────────────────────────╮
+│ SDD   ✓ clarify › ✓ explore › ⠋ plan › · analyze › · build › · veredicto
+│ Tools ⠋ subagent · ✓ read zero-hud.ts · ✓ bash npm test
+╰────────────────────────────────────────────────────────────────────────╯
+```
+
+The activity panel is transient: it clears after the agent finishes. The HUD stays in the footer across normal work.
+
+### Applying visual changes after install
+
+After `pi install npm:@gonrocca/zero-pi@<version>`, reload the active session:
+
+```txt
+/reload
+```
+
+If a visual monkeypatch was already loaded in the current process, restarting pi is the safest way to force all visual extensions to reinitialize.
+
 ### Git / PR / Issues
 
 Recommended flow: `/zero-branch <slug>` → `/zero-issue <slug>` → `/forge <slug>` (the orchestrator validates plan artifacts and can create `/zero-checkpoint` before build) → `/zero-git-validate <slug> --for=pr` → `/zero-pr <slug>` → `/zero-archive <slug>`.

package/extensions/working-phrases.ts

@@ -325,6 +325,13 @@ export default function register(pi?: PiAPI): void {
     installSpinner();
   });
 
+  // Pi can reset extension-owned UI during reload/session rebinds. Reinstall the
+  // spinner at the start of every run so the symbol survives those resets.
+  pi.on("before_agent_start", (_event, ctx) => {
+    capture(ctx);
+    installSpinner();
+  });
+
   pi.on("input", (event, ctx) => {
     capture(ctx);
     const text = (event as { text?: string })?.text ?? "";
@@ -333,6 +340,7 @@ export default function register(pi?: PiAPI): void {
 
   pi.on("agent_start", (_event, ctx) => {
     capture(ctx);
+    installSpinner();
     start();
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gonrocca/zero-pi",
-  "version": "0.1.68",
+  "version": "0.1.70",
   "description": "zero-pi — an installable layer for pi (pi.dev): the zero spec-driven development workflow (clarify → explore → plan → analyze → build → veredicto) with automatic clarify/analyze gates, per-phase model autotune, and token-efficient batched builds. Adds capability to pi without modifying pi.",
   "type": "module",
   "keywords": [

package/themes/zero-omp-neon.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "zero-omp-neon",
+  "vars": {
+    "bg": "#090b12",
+    "panel": "#111421",
+    "panel2": "#171329",
+    "panelTool": "#101a28",
+    "panelOk": "#0d1f1e",
+    "panelErr": "#2a111a",
+    "selected": "#27213f",
+    "textMain": "#ece8f6",
+    "prose": "#c9bed6",
+    "mutedCool": "#a99eb8",
+    "dimCool": "#6e657e",
+    "cyan": "#35e8ff",
+    "blue": "#67a8ff",
+    "mint": "#2dfcb3",
+    "green": "#5bff8a",
+    "gold": "#ffd166",
+    "amber": "#ff9f43",
+    "coral": "#ff7a66",
+    "rose": "#ff4f7b",
+    "magenta": "#d86bff",
+    "violet": "#a78bfa"
+  },
+  "colors": {
+    "accent": "cyan",
+    "border": "violet",
+    "borderAccent": "cyan",
+    "borderMuted": "dimCool",
+    "success": "mint",
+    "error": "rose",
+    "warning": "amber",
+    "muted": "mutedCool",
+    "dim": "dimCool",
+    "text": "textMain",
+    "thinkingText": "prose",
+    "selectedBg": "selected",
+    "userMessageBg": "panel2",
+    "userMessageText": "gold",
+    "customMessageBg": "panel",
+    "customMessageText": "prose",
+    "customMessageLabel": "cyan",
+    "toolPendingBg": "panel2",
+    "toolSuccessBg": "panelTool",
+    "toolErrorBg": "panelErr",
+    "toolTitle": "gold",
+    "toolOutput": "prose",
+    "mdHeading": "cyan",
+    "mdLink": "cyan",
+    "mdLinkUrl": "violet",
+    "mdCode": "mint",
+    "mdCodeBlock": "mint",
+    "mdCodeBlockBorder": "violet",
+    "mdQuote": "mutedCool",
+    "mdQuoteBorder": "dimCool",
+    "mdHr": "dimCool",
+    "mdListBullet": "magenta",
+    "toolDiffAdded": "mint",
+    "toolDiffRemoved": "rose",
+    "toolDiffContext": "mutedCool",
+    "syntaxComment": "dimCool",
+    "syntaxKeyword": "magenta",
+    "syntaxFunction": "cyan",
+    "syntaxVariable": "gold",
+    "syntaxString": "mint",
+    "syntaxNumber": "coral",
+    "syntaxType": "blue",
+    "syntaxOperator": "rose",
+    "syntaxPunctuation": "mutedCool",
+    "thinkingOff": "dimCool",
+    "thinkingMinimal": "mutedCool",
+    "thinkingLow": "blue",
+    "thinkingMedium": "gold",
+    "thinkingHigh": "coral",
+    "thinkingXhigh": "magenta",
+    "bashMode": "cyan"
+  },
+  "export": {
+    "pageBg": "#090b12",
+    "cardBg": "#111421",
+    "infoBg": "#171329"
+  }
+}