@pi-unipi/footer 2.20.4 → 3.0.0-alpha.0

package/README.md

@@ -6,7 +6,7 @@ Subscribes to events from every package and renders segments using Pi's `setFoot
 
 ## Glance Footer (new in 2.12)
 
-An experimental input surface, on by default and toggleable in `/unipi:footer-settings` → Appearance → **Glance Footer**:
+An experimental input surface, on by default and toggleable in `/unipi:settings` (Footer) → **Glance mode**:
 
 ```
 ╭─ 󰚩 UNIPI │  feat/footer-default-v2 │ ───────────────────────────╮
@@ -27,7 +27,7 @@ An experimental input surface, on by default and toggleable in `/unipi:footer-se
 |---------|-------------|
 | `/unipi:footer` | Toggle footer on/off |
 | `/unipi:footer on` / `/unipi:footer off` | Enable/disable explicitly |
-| `/unipi:footer-settings` | Open settings TUI — preset, separator, icon style, glance mode, per-segment toggles |
+| `/unipi:settings` | Hub — preset, separator, zone separator, icon style, glance mode, per-segment toggles (Footer group) |
 | `/unipi:footer-help` | Show footer segment guide |
 
 ## Special Triggers

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "2.20.4",
-  "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
+  "version": "3.0.0-alpha.0",
+  "description": "Persistent status bar for Unipi \u2014 subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",
   "license": "MIT",
@@ -32,12 +32,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.4",
-    "@pi-unipi/background-tasks": "2.20.4"
+    "@pi-unipi/core": "3.0.0-alpha.0",
+    "@pi-unipi/background-tasks": "3.0.0-alpha.0"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "^0.84.0",
-    "@earendil-works/pi-tui": "^0.84.0"
+    "@earendil-works/pi-coding-agent": "^0.86.0",
+    "@earendil-works/pi-tui": "^0.86.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",

package/src/commands.ts

@@ -1,26 +1,20 @@
 /**
  * @pi-unipi/footer — Commands
  *
- * Footer commands: /unipi:footer (toggle), /unipi:footer <preset>,
- * /unipi:footer-settings.
+ * Footer commands: /unipi:footer (toggle) and /unipi:footer <preset>.
  */
 
 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 { showFooterSettings } from "./tui/settings-tui.js";
 import { showFooterHelp } from "./help.js";
-import type { FooterGroup, FooterSegment } from "./types.js";
+import type { FooterSegment } from "./types.js";
 import { applyGlanceMode, type FooterState } from "./index.js";
 
 /**
  * Register footer commands.
  */
-export function registerCommands(
-  pi: ExtensionAPI,
-  state: FooterState,
-  groups?: FooterGroup[],
-): void {
+export function registerCommands(pi: ExtensionAPI, state: FooterState): void {
   // /unipi:footer — toggle on/off only
   pi.registerCommand(`${UNIPI_PREFIX}${FOOTER_COMMANDS.FOOTER}`, {
     description: "Toggle footer on/off",
@@ -67,44 +61,6 @@ export function registerCommands(
     },
   });
 
-  // /unipi:footer-settings — open settings TUI
-  pi.registerCommand(`${UNIPI_PREFIX}${FOOTER_COMMANDS.FOOTER_SETTINGS}`, {
-    description: "Open footer settings (toggle groups and segments)",
-    handler: async (_args, ctx) => {
-      if (!ctx.hasUI) {
-        ctx.ui.notify("Footer settings requires a TUI", "warning");
-        return;
-      }
-
-      if (groups && groups.length > 0) {
-        showFooterSettings(ctx, groups, () => {
-          // Instant, focus-safe updates: mode flag + renderer reset. Widget
-          // renders read state.glanceMode every frame, so the strip/classic
-          // row swap is live immediately. The EDITOR component swap is
-          // deferred to overlay close — see .finally below.
-          const updated = loadFooterSettings();
-          state.renderer.setPreset(updated.preset);
-          state.glanceMode = updated.glanceMode !== false;
-          state.renderer.resetLayoutCache();
-        }).finally(() => {
-          // Overlay closed → focus back on the editor; safe to swap it now.
-          applyGlanceMode(state, ctx as unknown as Parameters<typeof applyGlanceMode>[1]);
-        });
-      } else {
-        // Fallback: show text summary
-        const settings = loadFooterSettings();
-        const info = [
-          `Enabled: ${settings.enabled}`,
-          `Preset: ${state.renderer.getPresetName()}`,
-          `Separator: ${settings.separator}`,
-          `Icon: ${settings.iconStyle}`,
-          `Groups: ${Object.entries(settings.groups).filter(([, g]) => g.show).map(([id]) => id).join(", ")}`,
-        ].join("\n");
-        ctx.ui.notify(info, "info");
-      }
-    },
-  });
-
   // /unipi:footer-help — show help overlay
   pi.registerCommand(`${UNIPI_PREFIX}${FOOTER_COMMANDS.FOOTER_HELP}`, {
     description: "Show footer segment guide (icons, labels, descriptions)",

package/src/config.ts

@@ -9,7 +9,8 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import * as os from "node:os";
 import type { FooterSettings, FooterGroupSettings, SeparatorStyle, IconStyle, ColorMode } from "./types.js";
-import { UNIPI_SETTINGS_KEY } from "@pi-unipi/core";
+import { UNIPI_SETTINGS_KEY, getSettings, registerSettings, setSettings } from "@pi-unipi/core";
+import { getFooterRegistry } from "./registry/index.js";
 
 /** Default footer settings */
 export const DEFAULT_FOOTER_SETTINGS: FooterSettings = {
@@ -80,17 +81,89 @@ function writeSettingsFile(settings: Record<string, unknown>): boolean {
  * Load footer settings from settings.json.
  * Falls back to defaults for any missing fields.
  */
-export function loadFooterSettings(): FooterSettings {
-  const raw = readSettingsFile();
-  if (!raw) return { ...DEFAULT_FOOTER_SETTINGS };
+// Registered with the unified settings hub; the engine's migration imports
+// the legacy pi-settings unipi.footer block into the canonical layout once.
+// The "Segments…" page resolves sections from the LIVE FooterRegistry at
+// open time — it replaces the deleted legacy footer overlay.
+registerSettings({
+  namespace: "footer",
+  label: "Footer",
+  defaults: DEFAULT_FOOTER_SETTINGS as unknown as Record<string, unknown>,
+  schema: [
+    {
+      title: "General",
+      fields: [
+        { key: "enabled", type: "boolean", label: "Footer enabled" },
+        {
+          key: "preset",
+          type: "enum",
+          label: "Preset",
+          options: ["default", "classic", "minimal", "dense", "devops", "zen"],
+          description: "Segment layout preset (glance mode uses its own frame)",
+        },
+        { key: "glanceMode", type: "boolean", label: "Glance mode", description: "The input-box frame renderer" },
+        { key: "showFullLabels", type: "boolean", label: "Full labels", description: "Labeled instead of compact segments" },
+        {
+          key: "separator",
+          type: "enum",
+          label: "Separator",
+          description: "Segment divider style",
+          options: ["powerline", "powerline-thin", "slash", "pipe", "dot", "ascii"],
+        },
+        {
+          key: "zoneSeparator",
+          type: "enum",
+          label: "Zone separator",
+          description: "Divider between zones (left · center · right)",
+          options: ["│", "╎", "·", "─", "none"],
+        },
+        {
+          key: "iconStyle",
+          type: "enum",
+          label: "Icon style",
+          options: [
+            { value: "emoji", label: "emoji" },
+            { value: "nerd", label: "nerd font" },
+            { value: "text", label: "text only" },
+          ],
+        },
+        {
+          key: "colorMode",
+          type: "enum",
+          label: "Color mode",
+          options: ["auto", "truecolor", "256", "mono"],
+        },
+      ],
+    },
+    {
+      title: "Segments",
+      fields: [
+        {
+          key: "segments-page",
+          type: "page",
+          label: "Segments…",
+          description: "Per-group and per-segment visibility",
+          sections: () =>
+            getFooterRegistry().getAllGroups().map((g) => ({
+              title: g.name,
+              fields: [
+                { key: `groups.${g.id}.show`, type: "boolean" as const, label: `Show ${g.name}` },
+                ...g.segments.map((seg) => ({
+                  key: `groups.${g.id}.segments.${seg.id}`,
+                  type: "boolean" as const,
+                  label: seg.label,
+                })),
+              ],
+            })),
+        },
+      ],
+    },
+  ],
+});
 
+export function loadFooterSettings(): FooterSettings {
+  const footer = getSettings("footer", process.cwd());
   try {
-    const unipi = raw[UNIPI_SETTINGS_KEY] as Record<string, unknown> | undefined;
-    if (!unipi) return { ...DEFAULT_FOOTER_SETTINGS };
-
-    const footer = unipi.footer as Record<string, unknown> | undefined;
-    if (!footer) return { ...DEFAULT_FOOTER_SETTINGS };
-
     return {
       enabled: typeof footer.enabled === "boolean" ? footer.enabled : DEFAULT_FOOTER_SETTINGS.enabled,
       preset: typeof footer.preset === "string" ? footer.preset : DEFAULT_FOOTER_SETTINGS.preset,
@@ -116,14 +189,12 @@ export function loadFooterSettings(): FooterSettings {
  * Merges with existing settings (preserves other keys).
  */
 export function saveFooterSettings(partial: Partial<FooterSettings>): boolean {
-  const raw = readSettingsFile() ?? {};
-  const unipi = (raw[UNIPI_SETTINGS_KEY] as Record<string, unknown>) ?? {};
-  const existing = (unipi.footer as Record<string, unknown>) ?? {};
-
-  unipi.footer = { ...existing, ...partial };
-  raw[UNIPI_SETTINGS_KEY] = unipi;
-
-  return writeSettingsFile(raw);
+  try {
+    setSettings("footer", partial as Record<string, unknown>, "global", process.cwd());
+    return true;
+  } catch {
+    return false;
+  }
 }
 
 /**

package/src/events.ts

@@ -153,6 +153,50 @@ export function subscribeToEvents(
     })
   );
 
+  // ─── Plan mode / permission mode (workflow) ─────────────────────────────
+
+  unsubscribers.push(
+    pi.events.on(UNIPI_EVENTS.PLAN_MODE_CHANGED, (event: unknown) => {
+      try {
+        const active = (event as { active?: boolean })?.active === true;
+        const existing = registry.getGroupData("core") as Record<string, unknown> | undefined;
+        registry.updateData("core", { ...existing, planMode: active });
+      } catch {
+        // Silently ignore — event handler errors are non-blocking.
+      }
+    })
+  );
+
+  unsubscribers.push(
+    pi.events.on(UNIPI_EVENTS.PERMISSION_MODE_CHANGED, (event: unknown) => {
+      try {
+        const mode = (event as { mode?: string })?.mode;
+        if (typeof mode === "string" && mode.length > 0) {
+          const existing = registry.getGroupData("core") as Record<string, unknown> | undefined;
+          registry.updateData("core", { ...existing, permissionMode: mode });
+        }
+      } catch {
+        // Silently ignore — event handler errors are non-blocking.
+      }
+    })
+  );
+
+  // ─── Long-horizon events ────────────────────────────────────────────────
+
+  unsubscribers.push(
+    pi.events.on(UNIPI_EVENTS.LONG_HORIZON_MODE_RESOLVED, (event: unknown) => {
+      try {
+        const mode = (event as { mode?: string })?.mode;
+        if (typeof mode === "string" && mode.length > 0) {
+          const existing = registry.getGroupData("core") as Record<string, unknown> | undefined;
+          registry.updateData("core", { ...existing, lhMode: mode });
+        }
+      } catch {
+        // Silently ignore — event handler errors are non-blocking.
+      }
+    })
+  );
+
   // ─── Ralph events ──────────────────────────────────────────────────────
 
   unsubscribers.push(

package/src/glance-editor.ts

@@ -25,6 +25,12 @@ import { lolcatRainbow, paintLolcatGradient } from "./rendering/lolcat.js";
 export interface GlanceStatus {
 	/** Workspace/project directory name (bottom-left). */
 	workspace: string;
+	/** Active long-horizon mode label, beside the brand (null → omitted). */
+	lhMode: string | null;
+	/** Plan mode is active (top-right PLAN badge). */
+	planMode: boolean;
+	/** Permission mode (ask | auto | full) shown top-right (null → omitted). */
+	permissionMode: string | null;
 	/** Git branch for the top title (null → omitted). */
 	branch: string | null;
 	/** Context usage percent (null when unknown). */
@@ -56,6 +62,55 @@ const SEP = " \u2502 "; // │
 const RESET = "\x1b[0m";
 const LEAD_FG = "\x1b[1m\x1b[38;2;181;189;104m"; // bold accent (matches success tint)
 const DIM_FG = "\x1b[38;2;120;124;134m"; // muted grey
+const WARN_FG = "\x1b[38;2;214;140;60m"; // warning / full-permission
+// PLAN badge: dark text on a warning-coloured block. Targeted-off closes keep
+// the surrounding border span intact.
+const PLAN_BG = "\x1b[1m\x1b[48;2;214;140;60m\x1b[38;2;26;20;14m";
+const PLAN_BG_OFF = "\x1b[49m\x1b[39m\x1b[22m";
+
+/** Top-right permission/plan cluster: ` PLAN  auto ` (plain text returned too). */
+export function renderTopRightBadges(planMode: boolean, permissionMode: string | null): string {
+	const parts: string[] = [];
+	if (planMode) parts.push(`${PLAN_BG} PLAN ${PLAN_BG_OFF}`);
+	if (permissionMode) {
+		const painted =
+			permissionMode === "full"
+				? `${WARN_FG}${permissionMode}${RESET}`
+				: permissionMode === "ask"
+					? `${LEAD_FG}${permissionMode}${RESET}`
+					: `${DIM_FG}${permissionMode}${RESET}`;
+		parts.push(painted);
+	}
+	return parts.length > 0 ? `${parts.join(" ")} ` : "";
+}
+
+/** Same cluster without the permission label (narrow-terminal fallback). */
+export function renderTopRightBadgesNoPermission(planMode: boolean): string {
+	return planMode ? `${PLAN_BG} PLAN ${PLAN_BG_OFF} ` : "";
+}
+
+/**
+ * Top-frame layout: the right cluster plus the rule fill, with the narrow-
+ * terminal policy applied (drop the permission label first).
+ */
+export function planTopFrameWidths(
+	safe: number,
+	plainLeadWidth: number,
+	planMode: boolean,
+	permissionMode: string | null,
+): { cluster: string; filler: number; permissionDropped: boolean } {
+	const fits = (cluster: string): number => safe - 2 - plainLeadWidth - visibleWidth(stripControls(cluster));
+	let cluster = renderTopRightBadges(planMode, permissionMode);
+	let permissionDropped = false;
+	if (cluster.length > 0 && fits(cluster) < 2) {
+		const withoutPermission = renderTopRightBadgesNoPermission(planMode);
+		if (withoutPermission !== cluster) {
+			cluster = withoutPermission;
+			permissionDropped = true;
+		}
+	}
+	return { cluster, filler: Math.max(2, fits(cluster)), permissionDropped };
+}
 
 type FusionDisplay = NonNullable<GlanceStatus["fusion"]>;
 
@@ -140,15 +195,18 @@ export function composeGlanceTitles(
 	brand: string,
 	branch: string | null,
 	workspace: string,
+	lhMode: string | null = null,
 ): { titleParts: string[]; leftTitle: string } {
 	const titleParts: string[] = [];
 	if (getResolvedIconStyle() === "text") {
 		titleParts.push(brand);
+		if (lhMode) titleParts.push(`mode:${lhMode}`);
 		if (branch) titleParts.push(`branch:${branch}`);
 		return { titleParts, leftTitle: ` workspace:${workspace} ` };
 	}
 	const brandIcon = getIcon("model");
 	titleParts.push(`${brandIcon ? brandIcon + " " : ""}${brand}`);
+	if (lhMode) titleParts.push(lhMode);
 	if (branch) {
 		const gitIcon = getIcon("git");
 		titleParts.push(`${gitIcon ? gitIcon + " " : ""}${branch}`);
@@ -218,19 +276,24 @@ export class GlanceEditor extends CustomEditor {
 		// Brand rendered as an animated lolcat gradient (phase from wall time;
 		// the footer's 1s refresh timer re-renders, so it shimmers each tick).
 		const brand = lolcatRainbow("UNIPI", Date.now() / 1000);
-		const { titleParts, leftTitle } = composeGlanceTitles(brand, st.branch, st.workspace);
+		const { titleParts, leftTitle } = composeGlanceTitles(brand, st.branch, st.workspace, st.lhMode);
 		const title = titleParts.join(SEP);
 		const leadRule = `${BORDER.horizontal} `;
 		const titleText = ` ${title}${SEP}`;
-		// Width ledger counts PLAIN text — strip SGR (rainbow codes) first.
-		const topFiller = Math.max(
-			2,
-			safe - 2 - visibleWidth(stripControls(leadRule + titleText)),
+		// Right-aligned PLAN/permission cluster. Narrow terminals drop the
+		// permission label first; the final truncateToWidth trims the rest.
+		const plainLead = visibleWidth(stripControls(leadRule + titleText));
+		const { cluster: topCluster, filler: topFiller } = planTopFrameWidths(
+			safe,
+			plainLead,
+			st.planMode,
+			st.permissionMode,
 		);
 		const top =
 			border(BORDER.topLeft) +
 			border(leadRule + titleText) +
 			border(repeat(BORDER.horizontal, topFiller)) +
+			topCluster +
 			border(BORDER.topRight);
 
 		// ── Body rows: │ content │ ──

package/src/index.ts

@@ -7,7 +7,7 @@
 
 import type { ExtensionAPI, Theme, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-import { UNIPI_EVENTS, emitEvent, UNIPI_PREFIX, FOOTER_COMMANDS, getSharedFusionStatus } from "@pi-unipi/core";
+import { UNIPI_EVENTS, emitEvent, UNIPI_PREFIX, FOOTER_COMMANDS, getSharedFusionStatus, getSharedLongHorizonMode, getSharedPlanPermissionStatus } from "@pi-unipi/core";
 import { FooterRegistry, getFooterRegistry } from "./registry/index.js";
 import { FooterRenderer } from "./rendering/renderer.js";
 import { subscribeToEvents } from "./events.js";
@@ -30,6 +30,7 @@ import { STATUS_EXT_SEGMENTS } from "./segments/status-ext.js";
 import type { FooterGroup, FooterSegment } from "./types.js";
 import { tpsTracker } from "./tps-tracker.js";
 import { renderProcessLine } from "./process-line.js";
+import { MODE_LABELS } from "./segments/long-horizon.js";
 
 /** All segment groups */
 const ALL_GROUPS: FooterGroup[] = [
@@ -191,7 +192,7 @@ export default function footerExtension(pi: ExtensionAPI): void {
 
   // ─── Register commands ──────────────────────────────────────────────────
 
-  registerCommands(pi, state, ALL_GROUPS);
+  registerCommands(pi, state);
 
   // ─── Emit MODULE_READY ──────────────────────────────────────────────────
 
@@ -199,7 +200,7 @@ export default function footerExtension(pi: ExtensionAPI): void {
     emitEvent(pi, UNIPI_EVENTS.MODULE_READY, {
       name: "@pi-unipi/footer",
       version: "0.1.0",
-      commands: [`${UNIPI_PREFIX}${FOOTER_COMMANDS.FOOTER}`, `${UNIPI_PREFIX}${FOOTER_COMMANDS.FOOTER_SETTINGS}`, `${UNIPI_PREFIX}${FOOTER_COMMANDS.FOOTER_HELP}`],
+      commands: [`${UNIPI_PREFIX}${FOOTER_COMMANDS.FOOTER}`, `${UNIPI_PREFIX}${FOOTER_COMMANDS.FOOTER_HELP}`],
       tools: [],
     });
   });
@@ -440,8 +441,29 @@ function installGlanceEditor(
         if (modelName.startsWith("Claude ")) modelName = modelName.slice(7);
         const branch = (st.footerData as any)?.getGitBranch?.() ?? null;
         const fusion = getSharedFusionStatus() ?? null;
+        // Pull the mode from the shared holder (set on both resume and live
+        // turns); fall back to the registry data the event listener writes.
+        const lhModeRaw = getSharedLongHorizonMode()
+          ?? (st.registry.getGroupData("core") as { lhMode?: string } | undefined)?.lhMode;
+        const lhMode = typeof lhModeRaw === "string" && lhModeRaw.length > 0
+          ? MODE_LABELS[lhModeRaw] ?? lhModeRaw
+          : null;
+        // Plan/permission state rides the same CORE registry data, written by
+        // the workflow module's events (also re-emitted on session_start).
+        const coreData = st.registry.getGroupData("core") as
+          | { planMode?: boolean; permissionMode?: string }
+          | undefined;
+        const sharedBadges = getSharedPlanPermissionStatus();
         return {
           workspace,
+          lhMode,
+          planMode: sharedBadges.planMode || coreData?.planMode === true,
+          permissionMode:
+            typeof sharedBadges.permissionMode === "string" && sharedBadges.permissionMode.length > 0
+              ? sharedBadges.permissionMode
+              : typeof coreData?.permissionMode === "string" && coreData.permissionMode.length > 0
+                ? coreData.permissionMode
+                : null,
           branch: typeof branch === "string" ? branch : null,
           contextPct: typeof usage?.percent === "number" ? usage.percent : null,
           contextWindow: typeof usage?.contextWindow === "number" ? usage.contextWindow : 0,

package/src/presets.ts

@@ -15,7 +15,7 @@ import { getDefaultColors } from "./rendering/theme.js";
 /** Default preset — glance-style status line + branded head */
 const DEFAULT_PRESET: PresetDef = {
   leftSegments: [
-    "uni", "model", "thinking_level", "directory", "git",
+    "uni", "lh_mode", "model", "thinking_level", "directory", "git",
   ],
   rightSegments: [
     "context_pct", "tokens_total",
@@ -29,7 +29,7 @@ const DEFAULT_PRESET: PresetDef = {
 /** Classic preset — the pre-v3 balanced view (kept for /unipi:footer) */
 const CLASSIC_PRESET: PresetDef = {
   leftSegments: [
-    "model", "api_state", "tool_count", "git",
+    "lh_mode", "model", "api_state", "tool_count", "git",
   ],
   rightSegments: [
     "tps", "context_pct", "cost",
@@ -46,7 +46,7 @@ const CLASSIC_PRESET: PresetDef = {
 /** Minimal preset — just the essentials */
 const MINIMAL_PRESET: PresetDef = {
   leftSegments: [
-    "model", "git",
+    "lh_mode", "model", "git",
   ],
   rightSegments: [
     "context_pct",
@@ -59,7 +59,7 @@ const MINIMAL_PRESET: PresetDef = {
 /** Compact preset — core + key stats */
 const COMPACT_PRESET: PresetDef = {
   leftSegments: [
-    "model", "git",
+    "lh_mode", "model", "git",
   ],
   rightSegments: [
     "tps", "context_pct", "cost",
@@ -72,7 +72,7 @@ const COMPACT_PRESET: PresetDef = {
 /** Full preset — everything */
 const FULL_PRESET: PresetDef = {
   leftSegments: [
-    "model", "api_state", "tool_count", "git", "current_command", "session",
+    "lh_mode", "model", "api_state", "tool_count", "git", "current_command", "session",
   ],
   rightSegments: [
     "tps", "context_pct", "cost", "tokens_total",
@@ -97,7 +97,7 @@ const FULL_PRESET: PresetDef = {
 /** ASCII preset — safe for any terminal */
 const ASCII_PRESET: PresetDef = {
   leftSegments: [
-    "model", "git",
+    "lh_mode", "model", "git",
   ],
   rightSegments: [
     "tps", "context_pct", "cost",

package/src/segments/core.ts

@@ -11,6 +11,7 @@ import type { FooterSegment, FooterSegmentContext, RenderedSegment, SemanticColo
 import { applyColor } from "../rendering/theme.js";
 import { getIcon } from "../rendering/icons.js";
 import { tpsTracker } from "../tps-tracker.js";
+import { LONG_HORIZON_SEGMENTS } from "./long-horizon.js";
 
 // ─── Helpers ────────────────────────────────────────────────────────────────
 
@@ -403,6 +404,7 @@ export const CORE_SEGMENTS: FooterSegment[] = [
   { id: "session", label: "Session", shortLabel: "SES", description: "Session identifier", zone: "left", render: renderSessionSegment, defaultShow: false },
   { id: "hostname", label: "Hostname", shortLabel: "HST", description: "Machine hostname", zone: "left", render: renderHostnameSegment, defaultShow: false },
   { id: "uni", label: "Unipi", shortLabel: "UNI", description: "Unipi brand mark", zone: "left", render: renderUniBrandSegment, defaultShow: true },
+  ...LONG_HORIZON_SEGMENTS,
   { id: "directory", label: "Directory", shortLabel: "DIR", description: "Current directory name", zone: "left", render: renderDirectorySegment, defaultShow: true },
   { id: "clock", label: "Clock", shortLabel: "CLK", description: "Current wall time (HH:MM:SS)", zone: "right", render: renderClockSegment, defaultShow: true },
   { id: "duration", label: "Duration", shortLabel: "DUR", description: "Session duration", zone: "right", render: renderDurationSegment, defaultShow: true },

package/src/segments/long-horizon.ts

@@ -0,0 +1,47 @@
+/**
+ * @pi-unipi/footer — Long-horizon mode segment
+ *
+ * Renders the active long-horizon mode right beside the UNIPI brand mark:
+ * "Goal Mode" · "Ralph Mode" · "Swarm Mode" · "Graph Mode" · "Regular Mode".
+ *
+ * The segment lives in the CORE group (for placement) but reads a module
+ * store fed by LONG_HORIZON_MODE_RESOLVED events — group-data binding would
+ * require it to live in its own group, which lands it after the whole core
+ * block. Hidden until the first mode event arrives, so sessions without
+ * long-horizon installed show nothing.
+ */
+
+import type { FooterSegment, FooterSegmentContext, RenderedSegment } from "../types.js";
+import { applyColor } from "../rendering/theme.js";
+
+export const MODE_LABELS: Record<string, string> = {
+  goal: "Goal Mode",
+  ralph: "Ralph Mode",
+  swarm: "Swarm Mode",
+  graph: "Graph Mode",
+  none: "Regular Mode",
+};
+
+/**
+ * Mode rides the CORE group's data ({ lhMode }) via registry.updateData —
+ * the data-change notification is what triggers a footer re-render (a
+ * module store alone never invalidates).
+ */
+function renderModeSegment(ctx: FooterSegmentContext): RenderedSegment {
+  const mode = (ctx.data as { lhMode?: string } | undefined)?.lhMode;
+  if (typeof mode !== "string" || mode.length === 0) return { content: "", visible: false };
+  const label = MODE_LABELS[mode] ?? mode;
+  return { content: applyColor("model", label, ctx.theme, ctx.colors), visible: true };
+}
+
+export const LONG_HORIZON_SEGMENTS: FooterSegment[] = [
+  {
+    id: "lh_mode",
+    label: "Mode",
+    shortLabel: "MODE",
+    description: "Active long-horizon mode (Goal/Ralph/Swarm/Graph/Regular)",
+    zone: "left",
+    render: renderModeSegment,
+    defaultShow: true,
+  },
+];

package/src/tui/settings-tui.ts

@@ -1,503 +0,0 @@
-/**
- * @pi-unipi/footer — Settings TUI
- *
- * Unified settings overlay with 3 categories:
- * - Appearance: preset, separator, icon style, full labels
- * - Segments: group → segment drill-down
- * - Labels & Help: label mode, zone headers
- *
- * Uses pi-tui SettingsList for vim/arrow keybinding support.
- */
-
-import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
-import { Key, matchesKey, SettingsList, type SettingItem, type SettingsListTheme } from "@earendil-works/pi-tui";
-import { loadFooterSettings, saveFooterSettings } from "../config.js";
-import { PRESET_NAMES } from "../presets.js";
-import { setIconStyle } from "../rendering/icons.js";
-import type { FooterGroup, FooterSettings, SeparatorStyle, IconStyle } from "../types.js";
-import { boxInnerWidth, OverlayTheme } from "@pi-unipi/core";
-
-// ─── Section types ─────────────────────────────────────────────────────
-
-type Section = "appearance" | "segments" | "labels";
-const SECTIONS: Section[] = ["appearance", "segments", "labels"];
-const SECTION_LABELS: Record<Section, string> = {
-  appearance: "Appearance",
-  segments: "Segments",
-  labels: "Labels & Help",
-};
-
-// ─── Valid option values ───────────────────────────────────────────────
-
-const SEPARATOR_STYLES: SeparatorStyle[] = ["powerline", "powerline-thin", "slash", "pipe", "dot", "ascii"];
-const ICON_STYLES: IconStyle[] = ["nerd", "emoji", "text"];
-const ZONE_SEPARATOR_OPTIONS = ["│", "╎", "·", "─", "none"];
-
-// ─── Theme for SettingsList ────────────────────────────────────────────
-
-const THEME: SettingsListTheme = {
-  label: (text, selected) => selected ? `\x1b[1m${text}\x1b[0m` : `\x1b[2m${text}\x1b[0m`,
-  value: (text, selected) => selected ? `\x1b[35m${text}\x1b[0m` : `\x1b[35m${text}\x1b[0m`,
-  description: (text) => `\x1b[90m${text}\x1b[0m`,
-  cursor: `\x1b[36m▸\x1b[0m`,
-  hint: (text) => `\x1b[2m${text}\x1b[0m`,
-};
-
-// ─── Shared box-drawing helper ────────────────────────────────────────
-
-const overlay = new OverlayTheme();
-
-
-// ─── Show the footer settings overlay ──────────────────────────────────
-
-/**
- * Returns the overlay's promise so callers can run post-close actions
- * (e.g. the glance editor swap) AFTER focus has returned to the editor —
- * setEditorComponent() steals keyboard focus and would strand this very
- * overlay unclosable if invoked from onSettingsChanged while it is open.
- */
-export function showFooterSettings(ctx: ExtensionCommandContext, groups: FooterGroup[], onSettingsChanged?: () => void): Promise<void> {
-  return ctx.ui.custom<void>(
-    (tui, _theme, _keybindings, done) => {
-      const overlay = new FooterSettingsOverlay(groups, onSettingsChanged);
-      overlay.onClose = () => done();
-
-      return {
-        focused: true,
-        invalidate: () => overlay.invalidate(),
-        render: (width: number) => overlay.render(width),
-        handleInput: (data: string) => {
-          overlay.handleInput(data);
-          tui.requestRender();
-        },
-        dispose: () => {},
-      };
-    },
-    {
-      overlay: true,
-      overlayOptions: () => ({
-        anchor: "center" as const,
-      }),
-    },
-  ).catch(() => {
-    // Silently ignore — overlay errors are non-blocking.
-  });
-}
-
-// ─── Footer settings overlay component ─────────────────────────────────
-
-class FooterSettingsOverlay {
-  private settings: FooterSettings;
-  private groups: FooterGroup[];
-  private section: Section = "appearance";
-  private selectedGroupId: string | null = null;
-  onClose?: () => void;
-  private onSettingsChanged?: () => void;
-
-  // Per-section SettingsList instances
-  private appearanceList!: SettingsList;
-  private groupList!: SettingsList;
-  private segmentList: SettingsList | null = null;
-  private labelsList!: SettingsList;
-
-  constructor(groups: FooterGroup[], onSettingsChanged?: () => void) {
-    this.settings = loadFooterSettings();
-    this.groups = groups;
-    this.onSettingsChanged = onSettingsChanged;
-    this.buildAppearanceList();
-    this.buildGroupList();
-    this.buildLabelsList();
-  }
-
-  invalidate(): void {
-    this.appearanceList?.invalidate();
-    this.groupList?.invalidate();
-    this.segmentList?.invalidate();
-    this.labelsList?.invalidate();
-  }
-
-  handleInput(data: string): void {
-    // Tab cycles sections
-    if (data === "\t" || matchesKey(data, Key.shift("tab"))) {
-      const idx = SECTIONS.indexOf(this.section);
-      if (data === "\t") {
-        this.section = SECTIONS[(idx + 1) % SECTIONS.length];
-      } else {
-        this.section = SECTIONS[(idx - 1 + SECTIONS.length) % SECTIONS.length];
-      }
-      // If leaving segments drill-down, go back to groups
-      if (this.section !== "segments") {
-        this.selectedGroupId = null;
-        this.segmentList = null;
-      }
-      return;
-    }
-
-    // q — always close
-    if (data === "q") {
-      this.onClose?.();
-      return;
-    }
-
-    // Escape — back from drill-down, or close at root
-    if (matchesKey(data, "escape")) {
-      if (this.section === "segments" && this.selectedGroupId) {
-        this.backToGroups();
-      } else {
-        this.onClose?.();
-      }
-      return;
-    }
-
-    // j — navigate down (same as down arrow)
-    if (data === "j") {
-      this.currentList?.handleInput("\x1b[B");
-      return;
-    }
-
-    // k — navigate up (same as up arrow)
-    if (data === "k") {
-      this.currentList?.handleInput("\x1b[A");
-      return;
-    }
-
-    // l — drill into group from segments section (same as Enter)
-    if (data === "l" && this.section === "segments" && !this.selectedGroupId) {
-      const focusedId = this.getFocusedGroupId();
-      if (focusedId) {
-        this.enterSegmentsMode(focusedId);
-      }
-      return;
-    }
-
-    // Space — toggle on/off
-    if (data === " ") {
-      this.currentList?.handleInput("\r");
-      return;
-    }
-
-    // h — back from segment drill-down
-    if (data === "h" && this.section === "segments" && this.selectedGroupId) {
-      this.backToGroups();
-      return;
-    }
-
-    // / — focus search in segments section
-    if (data === "/") {
-      this.currentList?.handleInput("/");
-      return;
-    }
-
-    // Enter in segments/groups mode — enter segments for the focused group
-    if (data === "\r" && this.section === "segments" && !this.selectedGroupId) {
-      const focusedId = this.getFocusedGroupId();
-      if (focusedId) {
-        this.enterSegmentsMode(focusedId);
-      }
-      return;
-    }
-
-    // Left arrow / backspace in segment drill-down — back to groups
-    if (this.section === "segments" && this.selectedGroupId && (matchesKey(data, Key.left) || data === "\x7f")) {
-      this.backToGroups();
-      return;
-    }
-
-    // Delegate to current SettingsList
-    this.currentList?.handleInput(data);
-  }
-
-  private get currentList(): SettingsList | null {
-    switch (this.section) {
-      case "appearance": return this.appearanceList;
-      case "segments":
-        return this.segmentList ?? this.groupList;
-      case "labels": return this.labelsList;
-    }
-  }
-
-  // ─── Build SettingsList instances ──────────────────────────────────
-
-  private buildAppearanceList(): void {
-    const items: SettingItem[] = [
-      {
-        id: "glanceMode",
-        label: "Glance Footer",
-        description: "Experimental: framed input box + session strip (replaces classic row)",
-        currentValue: this.settings.glanceMode !== false ? "on" : "off",
-        values: ["on", "off"],
-      },
-      {
-        id: "preset",
-        label: "Preset",
-        description: "Footer layout preset",
-        currentValue: this.settings.preset,
-        values: PRESET_NAMES,
-      },
-      {
-        id: "separator",
-        label: "Separator",
-        description: "Segment divider style",
-        currentValue: this.settings.separator,
-        values: SEPARATOR_STYLES,
-      },
-      {
-        id: "iconStyle",
-        label: "Icon Style",
-        description: "emoji · nerd (Nerd Font) · text (glance: branch:x, workspace:y)",
-        currentValue: this.settings.iconStyle,
-        values: ICON_STYLES,
-      },
-      {
-        id: "zoneSeparator",
-        label: "Zone Separator",
-        description: "Divider between zones (left · center · right)",
-        currentValue: this.settings.zoneSeparator ?? "│",
-        values: ZONE_SEPARATOR_OPTIONS,
-      },
-      {
-        id: "showFullLabels",
-        label: "Full Labels",
-        description: "Show descriptive labels instead of abbreviations",
-        currentValue: this.settings.showFullLabels ? "on" : "off",
-        values: ["on", "off"],
-      },
-    ];
-
-    this.appearanceList = new SettingsList(
-      items,
-      Math.min(items.length + 2, 12),
-      THEME,
-      (id, newValue) => this.onAppearanceChange(id, newValue),
-      () => this.onClose?.(),
-      { enableSearch: false },
-    );
-  }
-
-  private buildGroupList(): void {
-    const items: SettingItem[] = this.groups.map((group) => {
-      const groupSettings = this.settings.groups[group.id] ?? { show: group.defaultShow, segments: {} };
-      const isEnabled = groupSettings.show;
-      const segCount = group.segments.length;
-      const enabledCount = group.segments.filter(s => {
-        const segOverride = groupSettings.segments?.[s.id];
-        return segOverride !== undefined ? segOverride : s.defaultShow;
-      }).length;
-
-      return {
-        id: group.id,
-        label: group.name,
-        description: `${enabledCount}/${segCount} segments · Enter to drill down`,
-        currentValue: isEnabled ? "on" : "off",
-        values: ["on", "off"],
-      };
-    });
-
-    this.groupList = new SettingsList(
-      items,
-      Math.min(items.length + 2, 15),
-      THEME,
-      (id, newValue) => this.onGroupChange(id, newValue),
-      () => this.onClose?.(),
-      { enableSearch: true },
-    );
-  }
-
-  private buildSegmentList(groupId: string): void {
-    const group = this.groups.find(g => g.id === groupId);
-    if (!group) {
-      this.segmentList = null;
-      return;
-    }
-
-    const groupSettings = this.settings.groups[group.id] ?? { show: group.defaultShow, segments: {} };
-
-    const items: SettingItem[] = group.segments.map((seg) => {
-      const isEnabled = groupSettings.segments?.[seg.id] ?? seg.defaultShow;
-      return {
-        id: seg.id,
-        label: `${seg.shortLabel}  ${seg.label}`,
-        description: seg.description,
-        currentValue: isEnabled ? "on" : "off",
-        values: ["on", "off"],
-      };
-    });
-
-    this.segmentList = new SettingsList(
-      items,
-      Math.min(items.length + 2, 15),
-      THEME,
-      (id, newValue) => this.onSegmentChange(groupId, id, newValue),
-      () => this.backToGroups(),
-      { enableSearch: true },
-    );
-  }
-
-  private buildLabelsList(): void {
-    const items: SettingItem[] = [
-      {
-        id: "showFullLabelsAlways",
-        label: "Full Labels",
-        description: "Always show descriptive labels instead of abbreviations",
-        currentValue: this.settings.showFullLabels ? "on" : "off",
-        values: ["on", "off"],
-      },
-      {
-        id: "showZoneHeaders",
-        label: "Zone Headers",
-        description: "Show zone labels (Identity / Metrics / Time)",
-        currentValue: "off", // TODO: implement zone headers
-        values: ["on", "off"],
-      },
-    ];
-
-    this.labelsList = new SettingsList(
-      items,
-      Math.min(items.length + 2, 12),
-      THEME,
-      (id, newValue) => this.onLabelsChange(id, newValue),
-      () => this.onClose?.(),
-      { enableSearch: false },
-    );
-  }
-
-  // ─── Change handlers ───────────────────────────────────────────────
-
-  private onAppearanceChange(id: string, newValue: string): void {
-    switch (id) {
-      case "glanceMode":
-        this.settings.glanceMode = newValue === "on";
-        break;
-      case "preset":
-        this.settings.preset = newValue;
-        break;
-      case "separator":
-        this.settings.separator = newValue as SeparatorStyle;
-        break;
-      case "iconStyle":
-        this.settings.iconStyle = newValue as IconStyle;
-        setIconStyle(newValue as IconStyle);
-        break;
-      case "zoneSeparator":
-        this.settings.zoneSeparator = newValue;
-        break;
-      case "showFullLabels":
-        this.settings.showFullLabels = newValue === "on";
-        // Sync with labels section
-        this.labelsList.updateValue("showFullLabelsAlways", newValue);
-        break;
-    }
-    saveFooterSettings(this.settings);
-    this.appearanceList.updateValue(id, newValue);
-    this.onSettingsChanged?.();
-  }
-
-  private onGroupChange(groupId: string, newValue: string): void {
-    const groupSettings = this.settings.groups[groupId] ?? { show: true, segments: {} };
-    groupSettings.show = newValue === "on";
-    this.settings.groups[groupId] = groupSettings;
-    saveFooterSettings(this.settings);
-    this.groupList.updateValue(groupId, newValue);
-    this.onSettingsChanged?.();
-  }
-
-  private onSegmentChange(groupId: string, segmentId: string, newValue: string): void {
-    const groupSettings = this.settings.groups[groupId] ?? { show: true, segments: {} };
-    if (!groupSettings.segments) groupSettings.segments = {};
-    groupSettings.segments[segmentId] = newValue === "on";
-    this.settings.groups[groupId] = groupSettings;
-    saveFooterSettings(this.settings);
-    this.segmentList?.updateValue(segmentId, newValue);
-    this.onSettingsChanged?.();
-  }
-
-  private onLabelsChange(id: string, newValue: string): void {
-    switch (id) {
-      case "showFullLabelsAlways":
-        this.settings.showFullLabels = newValue === "on";
-        // Sync with appearance section
-        this.appearanceList.updateValue("showFullLabels", newValue);
-        break;
-      case "showZoneHeaders":
-        // TODO: implement zone headers setting
-        break;
-    }
-    saveFooterSettings(this.settings);
-    this.labelsList.updateValue(id, newValue);
-    this.onSettingsChanged?.();
-  }
-
-  // ─── Section navigation ────────────────────────────────────────────
-
-  private getFocusedGroupId(): string | null {
-    if (this.selectedGroupId) return this.selectedGroupId;
-    // Access SettingsList internal state — it doesn't expose a getSelectedId() method
-    const list = this.groupList as unknown as {
-      selectedIndex: number;
-      items: SettingItem[];
-      filteredItems: SettingItem[];
-      searchEnabled: boolean;
-    };
-    const displayItems = list.searchEnabled ? list.filteredItems : list.items;
-    return displayItems[list.selectedIndex]?.id ?? null;
-  }
-
-  private enterSegmentsMode(groupId: string): void {
-    this.selectedGroupId = groupId;
-    this.buildSegmentList(groupId);
-  }
-
-  private backToGroups(): void {
-    this.selectedGroupId = null;
-    this.segmentList = null;
-    // Rebuild group list to reflect segment changes
-    this.buildGroupList();
-  }
-
-  // ─── Render ────────────────────────────────────────────────────────
-
-  render(width: number): string[] {
-    const innerWidth = boxInnerWidth(width);
-    const lines: string[] = [];
-
-    // Header
-    lines.push(overlay.borderLine(innerWidth, "top"));
-    lines.push(overlay.frameLine(`\x1b[1m\x1b[36m⚙  Footer Settings\x1b[0m`, innerWidth));
-
-    // Section tabs
-    const tabParts = SECTIONS.map((s) => {
-      const label = SECTION_LABELS[s];
-      if (s === this.section) {
-        return `\x1b[1m\x1b[36m[${label}]\x1b[0m`;
-      }
-      return `\x1b[2m${label}\x1b[0m`;
-    });
-    lines.push(overlay.frameLine(`  ${tabParts.join("  ")}`, innerWidth));
-    lines.push(overlay.ruleLine(innerWidth));
-
-    // Section content
-    const activeList = this.currentList;
-    if (activeList) {
-      const contentLines = activeList.render(innerWidth - 2);
-      for (const line of contentLines) {
-        lines.push(overlay.frameLine(` ${line}`, innerWidth));
-      }
-    }
-
-    // Footer hints
-    lines.push(overlay.ruleLine(innerWidth));
-
-    let hints: string;
-    if (this.section === "segments" && this.selectedGroupId) {
-      hints = "j/k navigate · Space toggle · h/Esc back · / search · q close";
-    } else if (this.section === "segments") {
-      hints = "j/k navigate · Space toggle · l/Enter segments · / search · q close";
-    } else {
-      hints = "j/k navigate · Space/Enter change · Tab section · q close";
-    }
-    lines.push(overlay.frameLine(`\x1b[2m${hints}\x1b[0m`, innerWidth));
-    lines.push(overlay.borderLine(innerWidth, "bottom"));
-
-    return lines;
-  }
-}