rinco-pi-hud 1.4.0 → 1.6.0

package/NOTICE

@@ -4,7 +4,12 @@ License: MIT.
 
 This package contains a dynamic HUD footer for Pi, adapted from the Footer
 portion of pi-zentui by Luka: https://github.com/lmilojevicc/pi-zentui
-License: MIT.
+Footer integration snapshot: version 0.32.0, commit
+9e8e798cfcce26cee9e1def4daf3668616482610.
+Adapted modules include template joining/compact layout, custom values,
+repository paths, optional telemetry, and passive live metadata.
+License: MIT. The original copyright and license text is retained at
+extensions/hud/ZENTUI-LICENSE.
 
 Session, model, activity, MCP, configuration-count, and Codex subscription
 status capabilities are adapted from pi-shannon-statusline by RealAlexandreAI:

package/README.md

@@ -54,6 +54,9 @@ pi install "$PWD"
 | `/zentui statusline enable\|disable\|toggle` | Show or hide the whole footer |
 | `/zentui row project\|session\|activity\|usage <enable\|disable\|toggle>` | Turn one row on or off |
 | `/zentui format "<template>"` | Replace the four rows with a single-line template |
+| `/zentui compact-format "<template>"` | Opt into a wrapped template below 80 columns; `clear` removes it |
+| `/zentui footer hud\|hidden\|native` | Four-group/template HUD, statuses only, or Pi’s native footer |
+| `/zentui layout\|segments\|extensions` | Open a settings section directly |
 | `/codex-status` | Print Codex subscription usage and rate-limit windows |
 | `/usage-refresh` | Refresh the model usage or balance shown in the footer |
 
@@ -98,7 +101,9 @@ Variables accept `$name` or `${name}`. The [footer reference](docs/footer.md) li
 
 `/zentui` writes to `~/.pi/agent/rinco-pi-hud.json` and applies changes immediately. It covers the separator style, icon mode (`nerd`, `ascii`, or `auto`), footer colors (Pi theme tokens or terminal palette styles), context rendering (text, gauge, or both), the project refresh interval, and third-party extension statuses with their own placement and color mode.
 
-See [docs/footer.md](docs/footer.md) for the full variable and segment reference.
+Footer colors follow the active Pi theme by default, including theme switches and automatic light/dark changes. In `/zentui`, **Footer colors → theme** enables this behavior; **terminal** keeps the original Sakura RGB palette. Explicit custom colors (hex, indexed, or `fg:`/`bg:` styles) remain fixed in either mode. Remove those entries from `colors` to restore automatic theme colors.
+
+Footer features are adapted from Zentui **0.32.0**, without installing its editor, messages, working line, tool display, or OMP adapter. New opt-in features include repository-relative paths, `$join_sep`, compact templates, extension-published values, safe status hyperlinks, PR/CI metadata, and average token rate. Defaults and existing configurations remain unchanged. See [docs/upstream-zentui.md](docs/upstream-zentui.md) for the exact snapshot and integration boundaries, and [docs/footer.md](docs/footer.md) for configuration and examples.
 
 ## Project contents
 
@@ -156,7 +161,7 @@ The footer measures the terminal and wraps at segment boundaries, so narrow wind
 <details>
 <summary>Colors look incorrect</summary>
 
-The default RGB palette follows Pi's detected terminal color mode, with 256-color approximation when needed. Check terminal capability settings and try the theme color source in `/zentui`.
+The default palette follows the active Pi theme. If the footer still uses fixed colors, select **Footer colors → theme** in `/zentui` and remove explicit color overrides from `~/.pi/agent/rinco-pi-hud.json`. Third-party statuses set to `original` retain their own colors. Truecolor and 256-color output follow Pi's detected terminal capabilities.
 </details>
 
 <details>

package/docs/CONTRIBUTING.md

@@ -61,6 +61,14 @@ Tests live in `tests/`:
 - `model-usage-refresh.test.ts` — Model usage refresh integration.
 - `token-switch-usage.test.ts` — Token Switch balance formatting.
 - `deepseek-balance.test.ts` — DeepSeek balance parsing, formatting, and query safety.
+- `footer-template-enhancements.test.ts` — Conditional joining, compact packing and alignment.
+- `footer-options.test.ts` — New layout persistence, direct commands and settings routes.
+- `footer-lifecycle.test.ts` — Root wiring, ownership/demand cleanup, clock teardown and inactive network gating.
+- `repository-path.test.ts` — Repository paths, worktrees, safe fallback and stale roots.
+- `live-metadata.test.ts` — Demand gating, GitHub identity/TTL and completed-call token rate.
+- `zentui-footer-integration.test.ts` — Publisher bounds, atomic values, links, hidden mode and optional telemetry.
+
+Upstream source versions and adaptation boundaries are recorded in [upstream-zentui.md](upstream-zentui.md).
 
 When adding tests:
 

package/docs/README.zh-CN.md

@@ -54,6 +54,9 @@ pi install "$PWD"
 | `/zentui statusline enable\|disable\|toggle` | 显示或隐藏整个脚注 |
 | `/zentui row project\|session\|activity\|usage <enable\|disable\|toggle>` | 开关某一行 |
 | `/zentui format "<template>"` | 用单行模板替换四行布局 |
+| `/zentui compact-format "<template>"` | 设置低于 80 列时使用的换行模板；`clear` 清除 |
+| `/zentui footer hud\|hidden\|native` | HUD、仅第三方状态、恢复 Pi 原生脚注 |
+| `/zentui layout\|segments\|extensions` | 直接打开对应设置页 |
 | `/codex-status` | 打印 Codex 订阅用量与限额窗口 |
 | `/usage-refresh` | 立即刷新脚注上的模型用量或余额 |
 
@@ -98,7 +101,9 @@ Usage 行跟随当前模型的 Provider：
 
 `/zentui` 把配置写入 `~/.pi/agent/rinco-pi-hud.json`，改动立即生效。可配置分隔符样式、图标模式（`nerd`、`ascii`、`auto`）、脚注配色（Pi 主题色或终端调色板样式）、Context 渲染方式（文本、进度条或两者）、项目刷新间隔，以及第三方扩展状态的位置与颜色模式。
 
-完整的变量与状态段参考见 [docs/footer.md](footer.md)。
+脚注默认自动跟随当前 Pi 主题，包括手动切换主题和自动明暗切换。在 `/zentui` 中选择 **Footer colors → theme** 启用跟随，选择 **terminal** 则保留原有 Sakura RGB 配色。显式自定义颜色（十六进制、索引色或 `fg:`/`bg:` 样式）在两种模式下都会保留；删除 `colors` 中的相应配置即可恢复自动配色。
+
+已适配 Zentui **0.32.0** 的 Footer 新功能：仓库相对路径、`$join_sep` 条件分隔符、窄屏模板、扩展发布的自定义值、安全状态超链接，以及按需启用的 PR/CI 与平均 Token 速率。默认四行 HUD、原有配置及余额查询保持不变；不接管编辑器、消息、工作进度行或工具展示，也不引入 OMP 适配。同步快照和边界见[上游集成记录](upstream-zentui.md)，配置示例和完整变量参考见 [docs/footer.md](footer.md)。
 
 ## 仓库结构
 
@@ -156,7 +161,7 @@ npx tsx assets/readme/source/build-assets.mts /tmp/footer.json
 <details>
 <summary>颜色显示异常</summary>
 
-默认 RGB 配色跟随 Pi 检测到的终端颜色模式，必要时近似为 256 色。请检查终端能力配置，也可以在 `/zentui` 中切换到主题色源。
+默认配色自动跟随当前 Pi 主题。如果脚注仍使用固定颜色，请在 `/zentui` 中选择 **Footer colors → theme**，并删除 `~/.pi/agent/rinco-pi-hud.json` 中的显式颜色覆盖。设为 `original` 的第三方扩展状态会保留自己的颜色。Truecolor 与 256 色输出仍按 Pi 检测到的终端能力选择。
 </details>
 
 <details>

package/docs/footer.md

@@ -26,6 +26,48 @@ Control each default-layout row independently:
 
 The command shape is `/zentui row <project|session|activity|usage> <enable|disable|toggle>`. Values persist under `footerRows`; all four default to `true`. Row switches apply only to the default layout and do not alter a custom single-line `footerFormat`.
 
+## Footer modes
+
+- `/zentui footer hud`: enable the normal four groups or configured templates.
+- `/zentui footer hidden`: show only allowed third-party statuses, no row when none exist.
+- `/zentui footer native`: release ownership to Pi; saved HUD choices remain unchanged.
+
+Hidden and HUD share the existing per-key `extensionStatuses` placement/color policy.
+Native is Pi-owned and does not apply this policy. `/zentui layout`, `segments`, and
+`extensions` open the corresponding settings tabs directly.
+
+## Repository paths
+
+`pathDisplay` defaults to `{ "mode": "basename", "depth": 0 }`.
+Select `repository` in Layout → Path display, or set:
+
+```json
+{ "pathDisplay": { "mode": "repository", "depth": 2 } }
+```
+
+Repository root displays `.`; `/repo/packages/core/src` displays `…/core/src` at depth 2.
+Zero depth is unlimited. Worktrees are supported. Until a root qualified for the current cwd
+is available, missing/failed/unsafe roots fall back to the unlimited full path with home `~`
+abbreviation; a stale root is never used to produce a relative path.
+
+## Colors and theme switching
+
+By default, `colorSources.starship` is `"theme"`. Built-in footer colors use semantic Pi theme tokens such as `accent`, `muted`, `success`, `warning`, and `error`; runtime labels also use the active theme. Switching themes, including automatic light/dark switching, recolors the footer without reloading the extension. This applies to both the default rows and custom templates.
+
+To enable theme colors in an existing configuration, use **Footer colors → theme** in `/zentui`, or set:
+
+```json
+{
+  "colorSources": {
+    "starship": "theme"
+  }
+}
+```
+
+Select `"terminal"` to retain the original Sakura RGB defaults and Starship runtime colors. Changing the source does not write a palette into your configuration.
+
+Entries you explicitly set under `colors` override the selected defaults. Semantic tokens (for example, `"cwd": "bold accent"`) follow the theme; hex colors, indexed colors, and explicit `fg:`/`bg:` styles remain fixed. Remove an override to restore the default for that segment. Third-party extension statuses in `original` color mode retain their own ANSI colors; use `zentui` color mode to recolor them with the HUD.
+
 ## Built-in status segments
 
 | Key | Default | Group | Description |
@@ -81,6 +123,12 @@ Clear it:
 - `( ... )` — conditional group; hidden when all contained variables are empty
 - `$fill` — layout partition marker (0 = left only, 1 = left/right, 2 = left/middle/right)
 - `$sep` — styled ` | ` separator, does not cause a conditional group to show
+- `$join_sep` — insert the styled separator only between populated sibling fields
+
+For example, `$session_name$join_sep($git_branch $git_status)$join_sep$runtime` joins only
+populated fields, with no orphan separator when an intervening field is missing. Each group
+and top-level fill/wrap boundary has its own join scope. Do not pad `$join_sep` with spaces;
+the separator already owns spacing. Templates without it retain their previous behavior.
 
 ### Variable list
 
@@ -125,7 +173,13 @@ Clear it:
 | `$tool_counts` | Native tool completion counts |
 | `$running_tools` | Recently running tools |
 | `$active_agents` | Active primary agent runs |
+| `$subscription` | Optional `(sub)` when Pi reports OAuth subscription use (also kimi-coding) |
+| `$auto_compaction` | Optional `(auto)` when public, trust-aware Pi settings report automatic compaction |
+| `$pr_number` / `$pr_url` | Current open GitHub PR number / plain HTTPS URL, qualified against local HEAD |
+| `$ci` | `CI passing`, `CI running`, `CI failed`, `CI no checks`, or `CI stale`; unavailable data is empty |
+| `$token_rate` | Current interaction’s completed-call average, e.g. `48 tok/s avg` |
 | `$sep` | Styled ` | ` |
+| `$join_sep` | Conditional sibling separator |
 | `$fill` | Layout marker, renders nothing |
 
 ### Aliases
@@ -140,6 +194,8 @@ $tag → $git_tag
 $duration → $session_duration
 $session → $session_name
 $thinking_level → $thinking
+$thinkingLevel → $thinking
+$codex_quota → $codex_usage
 $turn_count → $turn
 $codex → $codex_usage
 $tools → $tool_counts
@@ -147,6 +203,102 @@ $agents → $active_agents
 $separator → $sep
 ```
 
+## Opt-in compact templates
+
+Set a separate narrow layout (used below 80 terminal columns):
+
+```text
+/zentui compact-format "$cwd$wrap(on $git_branch)$fill$context$wrap_sep$tokens$wrap_sep$extension_statuses"
+```
+
+`$wrap` starts an independently packable chunk with a space boundary.
+`$wrap_sep` uses the configured default-layout separator only when chunks share a row.
+The first top-level `$fill` divides left/right zones; right-hand chunks have priority in
+template order and are right-aligned. Nested/additional fills do not create extra zones.
+`$extension_statuses` expands allowed third-party statuses into separate chunks; the existing
+`$extensions` still reports installed packages. Wide templates keep their existing status placements.
+
+`compactFooterMaxLines` defaults to 2 (range 1–8), and omitted/truncated chunks use `…`.
+Layout → Responsive compact controls `responsiveFooter`; an empty compact format is inert.
+Use `/zentui compact-format clear` to return to the existing layout at every width.
+Custom templates and wide templates are otherwise unchanged; arbitrary narrow layouts cannot keep every field.
+
+## Custom extension values
+
+Alias stable publisher keys in JSON, then explicitly reference them in templates:
+
+```json
+{
+  "footerVariables": { "quota": "@scope/usage:quota" },
+  "customValueColorMode": "original",
+  "customValueColors": { "@scope/usage:quota": "bold success" },
+  "footerFormat": "$cwd$fill($quota)($sep$cost)",
+  "compactFooterFormat": "$cwd$fill($quota)$wrap_sep$context"
+}
+```
+
+Aliases cannot shadow builtins, builtin aliases, structural/prototype names, except an explicit
+`ci` alias may replace GitHub CI and suppress its query. At most 16 aliases are accepted.
+Unpublished/empty values drop optional groups. Nothing is automatically appended to templates.
+
+Original color mode preserves safe publisher SGR/HTTP(S) links; Zentui mode uses the current
+HUD extension-status color. `customValueColors` overrides are keyed by publisher ID across
+aliases: explicit styles replace publisher styling, `""` removes styling, and deleting a leaf
+restores inheritance. These JSON-only per-value overrides are independent of `setStatus()` colors.
+Layout → Custom value colors changes the shared mode.
+
+Publish through Pi's shared event bus using Zentui protocol v1:
+
+```typescript
+const key = "@scope/usage:quota";
+const capability = { supported: false, active: false, key };
+pi.events.emit("zentui:variable-capability", capability);
+if (capability.active) {
+  pi.events.emit("zentui:variable", { key, text: "Quota 80%" });
+  ctx.ui.setStatus(key, undefined); // remove only your own fallback
+} else {
+  ctx.ui.setStatus(key, "Quota 80%");
+}
+// Removal also works after demand becomes inactive:
+pi.events.emit("zentui:variable", { key, text: undefined });
+```
+
+Capability probes receive `supported: true`, `version: 1`, and current `active` demand.
+Probe again on each publisher refresh. Active means an owned, enabled current TUI Footer
+references the alias in its wide or enabled compact template, not guaranteed visibility at every width.
+Hidden/native/disabled/unowned consumers are inactive. Registry limits: 16 publisher keys,
+64 UTF-16 units per key, 256 per raw text. Inactive/malformed/oversized updates are ignored;
+empty text removes a value. Session replacement, shutdown or lost ownership/demand clears values.
+Publishers must republish on reactivation and own their refresh/freshness resources.
+A custom value is kept whole or omitted with template recomposition, never partially cropped.
+
+## Status hyperlinks and live metadata
+
+Third-party statuses in `original` mode preserve only SGR and HTTP(S) OSC 8 hyperlinks.
+Unsafe protocols, title, clipboard, cursor controls and embedded line breaks are stripped;
+links and styles are closed before adjacent content. Zentui mode strips publisher styling/links.
+
+```text
+/zentui format "$cwd( · PR #$pr_number)( · $ci)$fill($token_rate)"
+```
+
+PR/CI collection is opt-in through template references and requires installed/authenticated
+`gh` plus an unambiguous `github.com` Git remote. No tools are installed or authenticated
+automatically, and no fetch/write is performed. Repository/head changes invalidate results;
+missing CLI/auth/PR, mismatched local/PR HEAD, detached HEAD or conflicting remotes yield empty values.
+A 30-second cache is refreshed by normal session/project synchronization, not an extra polling timer.
+A stale retained check snapshot shows `CI stale`. An explicit `ci` custom alias uses only publisher data.
+
+`$token_rate` divides completed output by observed model-call duration in the current interaction.
+It includes first-byte wait, excludes tools/gaps, and never estimates in-flight output speed.
+It retains completed values until the next interaction; incomplete measurements show `— tok/s avg`.
+
+Optional subscription and compaction markers use public Pi capabilities only and render empty
+when unavailable. Automatic compaction reads respect public project trust and are refreshed during
+normal Footer synchronization. They do not change Pi settings.
+
+See [the integration record](upstream-zentui.md) for the pinned source and differences from full Zentui.
+
 ## Model quota
 
 The status line automatically switches quota display based on model provider:

package/docs/upstream-zentui.md

@@ -0,0 +1,81 @@
+# Zentui Footer integration
+
+## Snapshot
+
+- Source: https://github.com/lmilojevicc/pi-zentui
+- Package version: **0.32.0**
+- Commit: `9e8e798cfcce26cee9e1def4daf3668616482610`
+- License: MIT; original copyright and full terms are in
+  [extensions/hud/ZENTUI-LICENSE](../extensions/hud/ZENTUI-LICENSE).
+
+This is a selective source adaptation, **not a dependency update or a complete Zentui fork**.
+No extra runtime dependency is installed. Pi 1.3–1.x remains supported.
+
+## Adapted capabilities
+
+| Upstream capability | HUD integration |
+| --- | --- |
+| Repository-relative cwd | `pathDisplay.mode: "repository"`, worktree-aware root, depth after relative conversion, unlimited full-path fallback when no current safe root exists |
+| Conditional joining | `$join_sep` in local group/fill/wrap scopes, ignoring empty and control-only fields |
+| Compact templates | `compactFooterFormat`, `$wrap`, `$wrap_sep`, first `$fill` left/right alignment, 1–8 line cap |
+| Extension statuses in compact layouts | `$extension_statuses`; existing `$extensions` still means installed-package count |
+| Custom publisher values | Protocol v1 events, `footerVariables` aliases, demand/ownership/session gating, atomic fitting |
+| Custom value colors | `customValueColorMode` and JSON-only publisher-keyed `customValueColors` overrides |
+| Original status hyperlinks | Preserve safe HTTP(S) OSC 8 and SGR only; close links/styles before neighboring content |
+| Passive live metadata | Template-opt-in `$pr_number`, `$pr_url`, `$ci`, `$token_rate` |
+| Atomic telemetry | `$cache_read` and `$cache_write` already existed; add optional `$subscription` / `$auto_compaction` |
+| Thinking variable | `$thinkingLevel` aliases the existing `$thinking` |
+| Status-only / native mode | `/zentui footer hidden` keeps permitted statuses; `native` releases Footer ownership |
+| Direct settings access | `/zentui layout`, `segments`, `extensions` |
+
+## Deliberate differences
+
+- Four semantic HUD groups remain the default. Compact rendering is **opt-in**: an empty compact
+  format never replaces the default layout. A configured compact format is selected below
+  **80 terminal columns** when `responsiveFooter` is enabled.
+- Keep the independent, flat `~/.pi/agent/rinco-pi-hud.json` schema. Upstream
+  `components.footer.styles.starship` objects are not automatically imported.
+- Keep existing theme defaults, legacy configuration migration, and all HUD counters, skills,
+  MCP file counts, model/provider labels, live context and usage totals.
+- Keep the existing Codex quota client and DeepSeek / Token Switch balance probes.
+  `$codex_quota` is a compatibility alias for `$codex_usage`, not a new collector.
+  Upstream's separate official-OpenAI response-header quota collector is not installed.
+- Status placement/color policy is shared between HUD and Hidden modes; native mode belongs to
+  Pi and is not decorated to enforce HUD visibility settings.
+- GitHub supports unambiguous `github.com` fetch remotes only. It uses existing `git` and `gh`
+  executables, never installs/authenticates tools, and does not fetch or mutate the repository.
+  Private GitHub Enterprise hosts, detached HEAD, conflicting remotes, missing auth/CLI/PR,
+  or a PR head that differs from local HEAD render empty.
+- No editors, user-message styling, working-line protocol, tool display, experimental thinking,
+  selector patches, OMP data/adapter, or full upstream component/preset settings are installed.
+  Avoid installing full Zentui alongside this package unless exactly one owns Footer.
+
+## Refresh and safety
+
+PR/CI demand comes only from enabled HUD templates (including an enabled compact format),
+not from defaults or merely configured aliases. An explicit custom `ci` alias suppresses
+GitHub CI demand. Queries are read-only, bounded, negative-cached for 30 seconds, and
+qualified against repository/worktree, branch, remotes and HEAD before and after lookup.
+Current UI sync and project refresh ticks drive collection; there is no extra GitHub polling timer.
+Expired retained CI reads `CI stale`. Stop, replacement, cwd changes and lost demand discard
+in-flight results. A successful unchanged snapshot reuses cached GitHub data.
+
+Token rate is final output divided by observed completed model-call duration in the current
+agent interaction; first-byte wait is included, tools/inter-call gaps are excluded. It is not a
+live streaming speed estimate. Completed values remain until the next interaction; missing or
+incomplete measurement reads `— tok/s avg`.
+
+Publishers retain responsibility for their values' freshness and fallback statuses.
+No publication data is saved to disk. Values that cannot fit whole are removed and the template
+is recomposed, never shown as a partial quota. The protocol bounds remain 16 keys, 64 UTF-16
+units per key and 256 units per raw value.
+
+## Future updates
+
+1. Pin and record the new upstream SHA before comparing source.
+2. Compare Footer/template, runtime/git, status sanitization, custom-value protocol and telemetry
+   modules, rather than replacing upstream's composition root.
+3. Preserve this project's configuration file, four-group layout, provider probes and Pi compatibility.
+4. Add tests for both new behavior and old layouts, including narrow widths, ANSI/OSC,
+   transient errors, stale responses, disabled demand and session/ownership cleanup.
+5. Run `npm run verify` and `npm run pack:check`; separately smoke-test a real Pi TUI.

package/extensions/hud/ZENTUI-LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Luka
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/extensions/hud/commands/settings-controller.ts

@@ -6,6 +6,7 @@ import {
 	saveExtensionStatusColorMode,
 	saveExtensionStatusPlacement,
 	saveFooterFormatPatch,
+	saveFooterOptionsPatch,
 	saveFooterRowsPatch,
 	saveFooterSegmentsPatch,
 	saveGitBranchPatch,
@@ -48,6 +49,11 @@ export function registerSettingsController(pi: ExtensionAPI, deps: SettingsContr
 			updateConfig(saveFooterSegmentsPatch(patch));
 			deps.restartSessionTimer();
 		},
+		setFooterOptions(patch, ctx) {
+			updateConfig(saveFooterOptionsPatch(patch));
+			deps.applyConfiguredUi(ctx);
+			deps.restartSessionTimer();
+		},
 		setFooterFormat(value) {
 			updateConfig(saveFooterFormatPatch(value));
 			deps.restartSessionTimer();

package/extensions/hud/commands/settings.ts

@@ -16,6 +16,7 @@ import {
 	type ExtensionStatusColorMode,
 	type ExtensionStatusPlacement,
 	type FooterRowsConfig,
+	type FooterOptionsPatch,
 	type FooterSegmentsConfig,
 	type GitBranchConfig,
 	type GitBranchMaxLength,
@@ -45,7 +46,7 @@ const extensionStatusPlacementValues: ExtensionStatusPlacement[] = [
 const extensionStatusColorModeValues: ExtensionStatusColorMode[] = ["zentui", "original"];
 const contextStyleValues: ContextStyle[] = ["text", "gauge", "text+gauge"];
 const separatorStyleValues: SeparatorStyle[] = ["pipe", "dot", "chevron", "none"];
-const pathDisplayModeValues: PathDisplayMode[] = ["basename", "full"];
+const pathDisplayModeValues: PathDisplayMode[] = ["basename", "full", "repository"];
 const pathDepthValues = ["0", "1", "2", "3", "4", "5"] as const;
 const branchLengthPresetValues = ["full", "10", "20", "30", "40", "50"] as const;
 const iconModeValues: IconMode[] = ["auto", "nerd", "ascii"];
@@ -74,6 +75,7 @@ type SettingsCommandDeps = {
 	setFooterRows: (patch: Partial<FooterRowsConfig>) => void;
 	setFooterSegments: (patch: Partial<FooterSegmentsConfig>) => void;
 	setFooterFormat: (value: string) => void;
+	setFooterOptions?: (patch: FooterOptionsPatch, ctx: ExtensionContext) => void;
 	setIconMode: (mode: IconMode) => void;
 	setContextStyle: (style: ContextStyle) => void;
 	setSeparator: (separator: SeparatorStyle) => void;
@@ -92,7 +94,7 @@ const colorSettingLabels: Record<ColorSettingId, string> = {
 
 const colorSettingDescriptions: Record<ColorSettingId, string> = {
 	starship:
-		"Choose whether footer runtime/git/context colors use Pi theme tokens or terminal palette styles.",
+		"Follow the active Pi theme automatically (theme), or keep the original Sakura/runtime palette (terminal). Explicit color overrides are preserved.",
 };
 
 const featureSettingLabels: Record<FeatureSettingId, string> = {
@@ -181,6 +183,14 @@ const footerSegmentSettingDescriptions: Record<FooterSegmentSettingId, string> =
 };
 
 const directCommandSuggestions = [
+	"layout",
+	"extensions",
+	"segments",
+	"footer hud",
+	"footer hidden",
+	"footer native",
+	"compact-format clear",
+	'compact-format "$cwd$fill$context"',
 	"statusline enable",
 	"statusline disable",
 	"statusline toggle",
@@ -262,7 +272,7 @@ function isContextStyle(value: string): value is ContextStyle {
 }
 
 function isPathDisplayMode(value: string): value is PathDisplayMode {
-	return value === "basename" || value === "full";
+	return value === "basename" || value === "full" || value === "repository";
 }
 
 function isPathDepthValue(value: string): boolean {
@@ -323,7 +333,7 @@ function footerSegmentPatch(
 }
 
 function usageText(): string {
-	return 'Usage: /zentui statusline [enable|disable|toggle], /zentui row [project|session|activity|usage] [enable|disable|toggle], or /zentui format "<template>"';
+	return 'Usage: /zentui statusline [enable|disable|toggle], /zentui row [project|session|activity|usage] [enable|disable|toggle], or /zentui format "<template>", /zentui compact-format "<template>"|clear, /zentui footer hud|hidden|native, /zentui layout|extensions|segments';
 }
 
 function isFooterRow(value: string): value is keyof FooterRowsConfig {
@@ -376,7 +386,7 @@ function parseDirectFeatureCommand(
 
 function parseFormatCommand(args: string): { value: string | undefined } | undefined {
 	const trimmed = args.trim();
-	if (!trimmed.toLowerCase().startsWith("format")) return undefined;
+	if (!/^format(?:\s|$)/i.test(trimmed)) return undefined;
 
 	const rest = trimmed.slice("format".length).trim();
 	if (!rest || rest.toLowerCase() === "clear") return { value: undefined };
@@ -437,6 +447,30 @@ function buildItems(
 	}
 	if (section === "layout") {
 		return [
+			{
+				id: "footerStyle",
+				label: "Footer content",
+				currentValue: config.footerStyle,
+				values: ["hud", "hidden"],
+			},
+			{
+				id: "responsiveFooter",
+				label: "Responsive compact",
+				currentValue: featureValue(config.responsiveFooter),
+				values: featureStateValues,
+			},
+			{
+				id: "compactFooterMaxLines",
+				label: "Compact max lines",
+				currentValue: String(config.compactFooterMaxLines),
+				values: ["1", "2", "3", "4", "5", "6", "7", "8"],
+			},
+			{
+				id: "customValueColorMode",
+				label: "Custom value colors",
+				currentValue: config.customValueColorMode,
+				values: ["original", "zentui"],
+			},
 			{
 				id: "contextStyle",
 				label: "Context style",
@@ -454,7 +488,7 @@ function buildItems(
 			{
 				id: "pathDisplay",
 				label: "Path display",
-				description: "Show cwd as basename or full path (home contracted to ~).",
+				description: "Show cwd as basename, full path (~), or relative to the repository root.",
 				currentValue: config.pathDisplay.mode,
 				values: pathDisplayModeValues,
 			},
@@ -462,7 +496,7 @@ function buildItems(
 				id: "pathDepth",
 				label: "Path depth",
 				description:
-					"In full mode, trailing directories to show (0 = all, max 5). Ignored for basename.",
+					"In full/repository mode, trailing directories to show (0 = all, max 5). Ignored for basename.",
 				currentValue: String(config.pathDisplay.depth),
 				values: [...pathDepthValues],
 			},
@@ -575,6 +609,38 @@ export function registerZentuiSettingsCommand(pi: ExtensionAPI, deps: SettingsCo
 		handler: async (_args, ctx) => {
 			const args = typeof _args === "string" ? _args : "";
 
+			const initialSection = new Map<string, SettingsSection>([
+				["layout", "layout"],
+				["extensions", "extensionSegments"],
+				["segments", "builtinSegments"],
+			]).get(args.trim().toLowerCase());
+
+			const footerCommand = /^footer\s+(hud|hidden|native)$/i.exec(args.trim());
+			const compactCommand = /^compact-format(?:\s|$)/i.test(args.trim())
+				? parseFormatCommand(args.trim().replace(/^compact-format/i, "format"))
+				: undefined;
+			if (footerCommand || compactCommand) {
+				try {
+					if (footerCommand) {
+						const style = footerCommand[1]?.toLowerCase();
+						if (style === "hud" || style === "hidden") {
+							if (!deps.setFooterOptions) throw new Error("Footer options unavailable");
+							deps.setFooterOptions({ footerStyle: style }, ctx);
+						}
+						deps.setUiFeatures({ statusLine: style !== "native" }, ctx);
+					} else if (compactCommand) {
+						if (!deps.setFooterOptions) throw new Error("Footer options unavailable");
+						deps.setFooterOptions({ compactFooterFormat: compactCommand.value ?? "" }, ctx);
+					}
+					deps.requestRender();
+					if (ctx.hasUI) ctx.ui.notify("Footer settings updated", "info");
+				} catch (error) {
+					const message = error instanceof Error ? error.message : String(error);
+					if (ctx.hasUI) ctx.ui.notify(`Could not update footer settings: ${message}`, "error");
+				}
+				return;
+			}
+
 			const formatCommand = parseFormatCommand(args);
 			if (formatCommand) {
 				try {
@@ -630,7 +696,7 @@ export function registerZentuiSettingsCommand(pi: ExtensionAPI, deps: SettingsCo
 				return;
 			}
 
-			if (args.trim()) {
+			if (args.trim() && !initialSection) {
 				if (ctx.hasUI) ctx.ui.notify(usageText(), "warning");
 				return;
 			}
@@ -640,7 +706,7 @@ export function registerZentuiSettingsCommand(pi: ExtensionAPI, deps: SettingsCo
 
 			await ctx.ui.custom<void>((tui, theme, _keybindings, done) => {
 				const settingsListTheme = deps.settingsListTheme ?? getSettingsListTheme();
-				let activeSection: SettingsSection = "coloring";
+				let activeSection: SettingsSection = initialSection ?? "coloring";
 				const applyFeatureChange = (id: FeatureSettingId, newValue: FeatureState) => {
 					deps.setUiFeatures(featurePatch(id, newValue), ctx);
 					deps.requestRender();
@@ -670,6 +736,25 @@ export function registerZentuiSettingsCommand(pi: ExtensionAPI, deps: SettingsCo
 									return;
 								}
 
+								const footerPatch: FooterOptionsPatch | undefined =
+									id === "footerStyle" && (newValue === "hud" || newValue === "hidden")
+										? { footerStyle: newValue }
+										: id === "responsiveFooter" && isFeatureState(newValue)
+											? { responsiveFooter: newValue === "enabled" }
+											: id === "compactFooterMaxLines" && /^[1-8]$/.test(newValue)
+												? { compactFooterMaxLines: Number(newValue) }
+												: id === "customValueColorMode" && isExtensionStatusColorMode(newValue)
+													? { customValueColorMode: newValue }
+													: undefined;
+								if (footerPatch) {
+									if (!deps.setFooterOptions) throw new Error("Footer options unavailable");
+									deps.setFooterOptions(footerPatch, ctx);
+									settingsList.updateValue(id, newValue);
+									deps.requestRender();
+									tui.requestRender();
+									return;
+								}
+
 								if (isLayoutSettingId(id)) {
 									if (id === "contextStyle" && isContextStyle(newValue)) {
 										deps.setContextStyle(newValue);

package/extensions/hud/config/config.ts

@@ -50,7 +50,10 @@ export {
 
 export { ensureConfigExists, loadConfig } from "./file-io.js";
 
+export type { FooterOptionsPatch } from "./persist.js";
+
 export {
+	saveFooterOptionsPatch,
 	saveColorSourcesPatch,
 	saveContextStylePatch,
 	saveContextThresholdsPatch,