pi-editor-footer 0.11.0 → 0.12.2

package/CHANGELOG.md

@@ -1,9 +1,33 @@
-# Changelog
+## [0.12.2](https://github.com/Rianico/pi-editor-footer/compare/v0.12.1...v0.12.2) (2026-09-13)
 
-All notable changes to this project will be documented in this file.
+### Bug Fixes
+
+* **context:** tier-color the context window section by usage ([#30](https://github.com/Rianico/pi-editor-footer/issues/30)) ([8152d90](https://github.com/Rianico/pi-editor-footer/commit/8152d90b3c1b4013154eff95cc885e79e7564f6f))
 
 ## [Unreleased]
 
+## [0.12.1](https://github.com/Rianico/pi-editor-footer/compare/v0.12.0...v0.12.1) (2026-09-07)
+
+### Bug Fixes
+
+* add .npmrc and clean allowScripts for npm install-scripts ([fc362cb](https://github.com/Rianico/pi-editor-footer/commit/fc362cbb654dbf886f92f774e2a5e87aa4ec5914))
+
+## [0.12.0](https://github.com/Rianico/pi-editor-footer/compare/v0.11.0...v0.12.0) (2026-09-07)
+
+### Features
+
+* **detail:** show model invocation badge to the right of skill path ([0f03593](https://github.com/Rianico/pi-editor-footer/commit/0f0359347d7ae3de740400c587c5b0ff4a6fb57e))
+* **detail:** use distinct highlight for human vs model badge ([e242df1](https://github.com/Rianico/pi-editor-footer/commit/e242df14975e10b6bfd32f8a48e5f943d7579864))
+
+### Bug Fixes
+
+* allow pnpm builds for esbuild and genai ([36e139e](https://github.com/Rianico/pi-editor-footer/commit/36e139e9443ef928a4366c3d7c8afe494b6e0850))
+* make prepare tolerant to missing husky for pi install ([23ebb62](https://github.com/Rianico/pi-editor-footer/commit/23ebb62cd8d732656fd113da27c807ffa34579fc))
+
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
 ## [0.11.0] - 2026-08-29
 
 ### Changed

package/dist/agent-run-ledger.js

@@ -85,9 +85,7 @@ export function aggregateAgentTurns(turns, live, startMs, now) {
     totalTokens = inputTokens + outputTokens;
     const totalMs = startMs === null ? 0 : Math.max(0, now - startMs);
     const measurementMs = outputTokens > 0 && generationMs > 0 ? generationMs : null;
-    const tps = measurementMs === null
-        ? null
-        : round(outputTokens / (measurementMs / 1000), 1);
+    const tps = measurementMs === null ? null : round(outputTokens / (measurementMs / 1000), 1);
     const validCost = Number.isFinite(costUsd) && costUsd > 0;
     const validTokens = Number.isFinite(totalTokens) && totalTokens > 0;
     return {
@@ -98,9 +96,7 @@ export function aggregateAgentTurns(turns, live, startMs, now) {
         outputTokens,
         stallMs,
         stallCount,
-        rateUsdPerMTokens: validCost && validTokens
-            ? round(costUsd / (totalTokens / 1_000_000), 2)
-            : null,
+        rateUsdPerMTokens: validCost && validTokens ? round(costUsd / (totalTokens / 1_000_000), 2) : null,
         generationMs,
         totalTokens,
         costUsd: validCost ? costUsd : 0,
@@ -117,9 +113,7 @@ export function aggregateAgentTurns(turns, live, startMs, now) {
  */
 export function capInputForIdle(input, contextTokens, sessionTotalInput) {
     let capped = input;
-    if (typeof contextTokens === "number" &&
-        Number.isFinite(contextTokens) &&
-        contextTokens > 0) {
+    if (typeof contextTokens === "number" && Number.isFinite(contextTokens) && contextTokens > 0) {
         capped = Math.min(capped, contextTokens);
     }
     if (sessionTotalInput > 0) {
@@ -129,9 +123,7 @@ export function capInputForIdle(input, contextTokens, sessionTotalInput) {
 }
 export function capInputForLive(input, contextTokens) {
     let capped = input;
-    if (typeof contextTokens === "number" &&
-        Number.isFinite(contextTokens) &&
-        contextTokens > 0) {
+    if (typeof contextTokens === "number" && Number.isFinite(contextTokens) && contextTokens > 0) {
         capped = Math.min(capped, contextTokens);
     }
     return Math.max(0, capped);
@@ -197,9 +189,7 @@ export class AgentRunLedger {
     }
     /** Synthetic live input including live delta: trigger + Σ(outputs+tools) + liveDelta. */
     getSyntheticLiveInput(liveDeltaTokens) {
-        const d = typeof liveDeltaTokens === "number" && Number.isFinite(liveDeltaTokens)
-            ? liveDeltaTokens
-            : 0;
+        const d = typeof liveDeltaTokens === "number" && Number.isFinite(liveDeltaTokens) ? liveDeltaTokens : 0;
         return (this.triggerTokens +
             this.accumOutputTokens +
             this.accumToolTokens +
@@ -378,23 +368,15 @@ export class AgentRunLedger {
         if (!base)
             return null;
         // When both exist, agentLive already sums outputs, so use it; else liveTurn
-        const displayOutput = agentLive
-            ? agentLive.outputTokens
-            : liveTurn.outputTokens;
+        const displayOutput = agentLive ? agentLive.outputTokens : liveTurn.outputTokens;
         const displayCost = agentLive ? agentLive.costUsd : liveTurn.costUsd;
         const displayStallMs = agentLive ? agentLive.stallMs : liveTurn.stallMs;
-        const displayStallCount = agentLive
-            ? agentLive.stallCount
-            : liveTurn.stallCount;
-        const displayGenerationMs = agentLive
-            ? agentLive.generationMs
-            : liveTurn.generationMs;
+        const displayStallCount = agentLive ? agentLive.stallCount : liveTurn.stallCount;
+        const displayGenerationMs = agentLive ? agentLive.generationMs : liveTurn.generationMs;
         const displayTtft = agentLive ? agentLive.ttftMs : liveTurn.ttftMs;
         const displayTps = agentLive ? agentLive.tps : liveTurn.tps;
         const displayTotalMs = agentLive ? agentLive.totalMs : liveTurn.totalMs;
-        const displayMeasurementMs = agentLive
-            ? agentLive.measurementMs
-            : liveTurn.measurementMs;
+        const displayMeasurementMs = agentLive ? agentLive.measurementMs : liveTurn.measurementMs;
         return {
             tps: displayTps,
             ttftMs: displayTtft,

package/dist/ansi-color.js

@@ -0,0 +1,142 @@
+const BASIC16 = [
+    [0, 0, 0],
+    [128, 0, 0],
+    [0, 128, 0],
+    [128, 128, 0],
+    [0, 0, 128],
+    [128, 0, 128],
+    [0, 128, 128],
+    [192, 192, 192],
+    [128, 128, 128],
+    [255, 0, 0],
+    [0, 255, 0],
+    [255, 255, 0],
+    [0, 0, 255],
+    [255, 0, 255],
+    [0, 255, 255],
+    [255, 255, 255],
+];
+/** 6x6x6 colour-cube channel values (indices 0-5). */
+const CUBE_VALUES = [0, 95, 135, 175, 215, 255];
+/** Grayscale ramp values (indices 232-255: 24 grays from 8 to 238). */
+const GRAY_VALUES = Array.from({ length: 24 }, (_, i) => 8 + i * 10);
+/** Anything but the truecolor marker means the 256-colour ramp. */
+export function normalizeColorMode(mode) {
+    return mode === "truecolor" ? "truecolor" : "256color";
+}
+export function indexToRgb(n) {
+    if (n >= 0 && n < 16) {
+        const [r, g, b] = BASIC16[n] ?? [0, 0, 0];
+        return { r, g, b };
+    }
+    if (n >= 16 && n <= 231) {
+        const v = n - 16;
+        return {
+            r: CUBE_VALUES[Math.floor(v / 36)] ?? 0,
+            g: CUBE_VALUES[Math.floor(v / 6) % 6] ?? 0,
+            b: CUBE_VALUES[v % 6] ?? 0,
+        };
+    }
+    if (n >= 232 && n <= 255) {
+        const gray = 8 + (n - 232) * 10;
+        return { r: gray, g: gray, b: gray };
+    }
+    return null;
+}
+function findClosestCubeIndex(value) {
+    let minDist = Infinity;
+    let minIdx = 0;
+    for (let i = 0; i < CUBE_VALUES.length; i++) {
+        const dist = Math.abs(value - (CUBE_VALUES[i] ?? 0));
+        if (dist < minDist) {
+            minDist = dist;
+            minIdx = i;
+        }
+    }
+    return minIdx;
+}
+function findClosestGrayIndex(gray) {
+    let minDist = Infinity;
+    let minIdx = 0;
+    for (let i = 0; i < GRAY_VALUES.length; i++) {
+        const dist = Math.abs(gray - (GRAY_VALUES[i] ?? 0));
+        if (dist < minDist) {
+            minDist = dist;
+            minIdx = i;
+        }
+    }
+    return minIdx;
+}
+function colorDistance(r1, g1, b1, r2, g2, b2) {
+    const dr = r1 - r2;
+    const dg = g1 - g2;
+    const db = b1 - b2;
+    // Weighted Euclidean distance (the eye is more sensitive to green).
+    return dr * dr * 0.299 + dg * dg * 0.587 + db * db * 0.114;
+}
+/** Quantise RGB to the closest xterm-256 index (same rule as the theme loader). */
+export function rgbTo256(r, g, b) {
+    const rIdx = findClosestCubeIndex(r);
+    const gIdx = findClosestCubeIndex(g);
+    const bIdx = findClosestCubeIndex(b);
+    const cubeR = CUBE_VALUES[rIdx] ?? 0;
+    const cubeG = CUBE_VALUES[gIdx] ?? 0;
+    const cubeB = CUBE_VALUES[bIdx] ?? 0;
+    const cubeIndex = 16 + 36 * rIdx + 6 * gIdx + bIdx;
+    const cubeDist = colorDistance(r, g, b, cubeR, cubeG, cubeB);
+    const gray = Math.round(0.299 * r + 0.587 * g + 0.114 * b);
+    const grayIdx = findClosestGrayIndex(gray);
+    const grayValue = GRAY_VALUES[grayIdx] ?? 0;
+    const grayIndex = 232 + grayIdx;
+    const grayDist = colorDistance(r, g, b, grayValue, grayValue, grayValue);
+    const spread = Math.max(r, g, b) - Math.min(r, g, b);
+    // Only consider grayscale when the colour is nearly neutral AND closer.
+    if (spread < 10 && grayDist < cubeDist)
+        return grayIndex;
+    return cubeIndex;
+}
+/** Parse `#RRGGBB`. Throws on malformed input — callers pass literals, not user data. */
+export function hexToRgb(hex) {
+    const cleaned = hex.startsWith("#") ? hex.slice(1) : hex;
+    if (cleaned.length !== 6)
+        throw new Error(`Invalid hex color: ${hex}`);
+    const { r, g, b } = {
+        r: parseInt(cleaned.slice(0, 2), 16),
+        g: parseInt(cleaned.slice(2, 4), 16),
+        b: parseInt(cleaned.slice(4, 6), 16),
+    };
+    if (Number.isNaN(r) || Number.isNaN(g) || Number.isNaN(b)) {
+        throw new Error(`Invalid hex color: ${hex}`);
+    }
+    return { r, g, b };
+}
+/** Parse a theme token's ANSI escape back into RGB (truecolor or 256 index). */
+export function parseFgAnsiToRgb(theme, color) {
+    const ansi = theme.getFgAnsi(color);
+    const trueColor = ansi.match(/38;2;(\d+);(\d+);(\d+)/);
+    if (trueColor) {
+        return {
+            r: Number(trueColor[1]),
+            g: Number(trueColor[2]),
+            b: Number(trueColor[3]),
+        };
+    }
+    const palette = ansi.match(/38;5;(\d+)/);
+    if (palette)
+        return indexToRgb(Number(palette[1]));
+    return null;
+}
+/** SGR foreground sequence for an RGB value at the terminal's colour fidelity. */
+export function rgbToFgAnsi({ r, g, b }, mode) {
+    return normalizeColorMode(mode) === "truecolor"
+        ? `\x1b[38;2;${r};${g};${b}m`
+        : `\x1b[38;5;${rgbTo256(r, g, b)}m`;
+}
+/**
+ * Colour `s` with an exact hex, bypassing the theme's named-token lookup.
+ * Returned painter resets only the foreground (`\x1b[39m`), matching `theme.fg`.
+ */
+export function hexFg(hex, mode) {
+    const ansi = rgbToFgAnsi(hexToRgb(hex), mode);
+    return (s) => `${ansi}${s}\x1b[39m`;
+}

package/dist/border-renderer.js

@@ -1,5 +1,5 @@
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-import { buildLabel, } from "./model-info.js";
+import { applyModelInfo, buildLabel } from "./model-info.js";
 function stripAnsi(s) {
     return s.replace(/\x1b\[[0-9;]*m/g, "");
 }
@@ -30,9 +30,8 @@ export class BorderRenderer {
             const info = this.getModelInfo();
             const glow = (s) => {
                 try {
-                    const maybeGlow = 
-                    // SAFETY: intentional unsafe cast — validated at runtime
-                    theme.getThinkingBorderColor;
+                    const maybeGlow = // SAFETY: intentional unsafe cast — validated at runtime
+                     theme.getThinkingBorderColor;
                     if (typeof maybeGlow === "function")
                         return maybeGlow.call(theme, info.level)(s);
                 }
@@ -93,9 +92,8 @@ export class BorderRenderer {
             const theme = this.getLiveTheme();
             const glow = (s) => {
                 try {
-                    const maybeGlow = 
-                    // SAFETY: intentional unsafe cast — validated at runtime
-                    theme.getThinkingBorderColor;
+                    const maybeGlow = // SAFETY: intentional unsafe cast — validated at runtime
+                     theme.getThinkingBorderColor;
                     if (typeof maybeGlow === "function")
                         return maybeGlow.call(theme, this.getModelInfo().level)(s);
                 }
@@ -136,12 +134,8 @@ function embedTopWithLeftAndRight(lines, width, leftText, rightText, getGlow) {
         displayLeft = truncateToWidth(leftText, maxLeft, "");
     if (rightW > maxRight)
         displayRight = truncateToWidth(rightText, maxRight, "");
-    const leftSegment = displayLeft
-        ? `${getGlow("─")} ${displayLeft} `
-        : getGlow("─");
-    const rightSegment = displayRight
-        ? ` ${displayRight} ${getGlow("─")}`
-        : getGlow("─");
+    const leftSegment = displayLeft ? `${getGlow("─")} ${displayLeft} ` : getGlow("─");
+    const rightSegment = displayRight ? ` ${displayRight} ${getGlow("─")}` : getGlow("─");
     const used = visibleWidth(leftSegment) + visibleWidth(rightSegment);
     const middleWidth = Math.max(0, width - used);
     const middle = getGlow("─".repeat(middleWidth));
@@ -174,12 +168,8 @@ function embedBottomBorder(lines, width, leftText, rightText, getGlow) {
         displayLeft = truncateToWidth(leftText, maxLeft, "");
     if (rightW > maxRight)
         displayRight = truncateToWidth(rightText, maxRight, "");
-    const leftSegment = displayLeft
-        ? `${getGlow("─")} ${displayLeft} `
-        : getGlow("─");
-    const rightSegment = displayRight
-        ? ` ${displayRight} ${getGlow("─")}`
-        : getGlow("─");
+    const leftSegment = displayLeft ? `${getGlow("─")} ${displayLeft} ` : getGlow("─");
+    const rightSegment = displayRight ? ` ${displayRight} ${getGlow("─")}` : getGlow("─");
     const used = visibleWidth(leftSegment) + visibleWidth(rightSegment);
     const middleWidth = Math.max(0, width - used);
     const middle = getGlow("─".repeat(middleWidth));

package/dist/chrome-composition.js

@@ -20,15 +20,20 @@
 import { resolveGlyphs, resolveIconMode } from "./icons.js";
 import { formatTopContextFromSnapshot } from "./chrome-state.js";
 import { formatRunActivityTopRight } from "./run-activity.js";
-import { formatTelemetryTokens, formatTurnDuration, formatTurnTelemetry, } from "./telemetry.js";
+import { formatTelemetryTokens, formatTurnDuration, formatTurnTelemetry } from "./telemetry.js";
+import { hexFg } from "./ansi-color.js";
 /**
- * Read the live pi theme into a typed { fg } surface. The cast is a SAFETY seam — a pi theme
- * missing `fg` degrades to identity rather than throwing, keeping the chrome resilient.
+ * Read the live pi theme into a typed { fg, fgHex } surface. The cast is a SAFETY
+ * seam — a pi theme missing `fg` degrades to identity rather than throwing, keeping
+ * the chrome resilient. `fgHex` needs no theme call at all: the named-token lookup
+ * rejects raw hex, so hex is rendered straight to SGR at the theme's colour mode.
  */
 export function adaptTheme(rawTheme) {
-    const t = rawTheme; // SAFETY: pi theme seam — fg is optional, guarded below
+    const t = rawTheme;
+    const mode = typeof t.getColorMode === "function" ? t.getColorMode() : undefined;
     return {
         fg: (style, s) => (typeof t.fg === "function" ? t.fg(style, s) : s),
+        fgHex: (hex, s) => hexFg(hex, mode)(s),
     };
 }
 /** Optional thinking-border glow (pi theme extension). Falls back to identity. */

package/dist/chrome-state.js

@@ -15,20 +15,30 @@
  * inside this module, not part of its external seam.
  */
 import { getUsageTotals } from "./state.js";
-import { cacheHitColor, contextUsageColor } from "./color-policy.js";
+import { cacheHitColor, CONTEXT_TIER_HEX, CONTEXT_TIER_THEME_COLOR, contextUsageTier, } from "./color-policy.js";
 import { fmtTokens } from "./format.js";
 // ---------------------------------------------------------------------------
 // Context bar formatting — moved from footer.ts to centralize chrome rendering.
 // Re-exported from footer.ts for backward compatibility.
 // ---------------------------------------------------------------------------
-function renderBar(theme, pct, barWidth, ascii) {
+/**
+ * Painter for one context tier: exact hex when the live theme can emit raw hex,
+ * else the nearest semantic token (tests/mocks, themes without colour mode).
+ */
+function contextPainter(theme, tier) {
+    const hex = CONTEXT_TIER_HEX[tier];
+    const fgHex = theme.fgHex;
+    if (fgHex)
+        return (s) => fgHex.call(theme, hex, s);
+    return (s) => theme.fg(CONTEXT_TIER_THEME_COLOR[tier], s);
+}
+function renderBar(theme, paint, pct, barWidth, ascii) {
     const filled = Math.max(0, Math.min(barWidth, Math.round((pct / 100) * barWidth)));
     const empty = barWidth - filled;
-    const color = contextUsageColor(pct);
     const filledCell = ascii ? "#" : "█";
     const emptyCell = ascii ? "-" : "░";
     return (theme.fg("dim", "[") +
-        theme.fg(color, filledCell.repeat(filled)) +
+        paint(filledCell.repeat(filled)) +
         theme.fg("dim", emptyCell.repeat(empty)) +
         theme.fg("dim", "]"));
 }
@@ -37,17 +47,15 @@ export function formatContextBar(contextUsage, theme, glyphs, isAscii, barWidth
     if (contextWindow <= 0)
         return "";
     const contextPct = contextUsage?.percent ?? 0;
-    const contextColor = contextUsageColor(contextPct);
-    const pctText = theme.fg(contextColor, `${contextPct.toFixed(1)}%`);
+    const paint = contextPainter(theme, contextUsageTier(contextPct, contextWindow));
+    const pctText = paint(`${contextPct.toFixed(1)}%`);
     const contextTokens = contextUsage?.tokens ?? 0;
-    const ctxText = `${theme.fg(contextColor, fmtTokens(contextTokens))}${theme.fg("dim", "/")}${theme.fg(contextColor, fmtTokens(contextWindow))}`;
+    const ctxText = `${paint(fmtTokens(contextTokens))}${theme.fg("dim", "/")}${paint(fmtTokens(contextWindow))}`;
     const baseCore = `${pctText} ${theme.fg("dim", "·")} ${ctxText}`;
     const base = showIconBar
-        ? `${theme.fg(contextColor, glyphs.context)} ${renderBar(theme, contextPct, barWidth, isAscii)} ${baseCore}`
+        ? `${paint(glyphs.context)} ${renderBar(theme, paint, contextPct, barWidth, isAscii)} ${baseCore}`
         : baseCore;
-    const rate = cacheHitRate !== undefined && Number.isFinite(cacheHitRate)
-        ? cacheHitRate
-        : 0;
+    const rate = cacheHitRate !== undefined && Number.isFinite(cacheHitRate) ? cacheHitRate : 0;
     const cacheText = `${glyphs.cacheHit} ${rate.toFixed(1)}%`;
     return `${theme.fg(cacheHitColor(rate), cacheText)} ${theme.fg("dim", "|")} ${base}`;
 }
@@ -75,7 +83,8 @@ export function createChromeSnapshot(ctx, footerState) {
     const totals = getUsageTotals(
     // ast-grep-ignore: require-safety-comment-for-as-unknown-as
     // SAFETY: pi seam
-    /* SAFETY: intentional unsafe cast — validated at runtime */ (ctx ?? {}));
+    /* SAFETY: intentional unsafe cast — validated at runtime */ (ctx ??
+        {}));
     // footerState may be absent when called from LiveBorder (context-only); use empty defaults
     // SAFETY: pi seam
     const git = footerState?.git ??
@@ -93,7 +102,7 @@ export function createChromeSnapshot(ctx, footerState) {
             commit: null,
             // ast-grep-ignore: require-safety-comment-for-as-unknown-as
             // SAFETY: intentional unsafe cast — validated at runtime
-            /* SAFETY: intentional unsafe cast — validated at runtime */ 
+            /* SAFETY: intentional unsafe cast — validated at runtime */
         }; // SAFETY: pi seam — intentional unsafe cast, validated at runtime
     const runtime = footerState?.runtime ?? null;
     return {

package/dist/color-policy.js

@@ -5,24 +5,37 @@ export function stressColor(value, warn = 70, danger = 90) {
         return "warning";
     return "accent";
 }
-export function contextUsageColor(pct) {
-    // 12.5 / 25 / 50 quotas — four urgency tiers, increasingly aggressive as context fills.
-    // 0 – 12.5%  dim      — plenty of headroom, visually quiet.
-    // 12.5 – 25% accent   — first nudge, noticeable but calm.
-    // 25 – 50%   warning  — half consumed, needs attention.
-    // 50 – 100%  error     — critical, about to run out.
-    // Uses theme semantic tokens (dim/accent/warning/error) so the progression
-    // respects the active theme and remains legible on light/dark/custom palettes.
-    // A fixed hex palette (e.g. grey→sky→amber→red) would be more vivid but
-    // would ignore the user's theme and can clash with light backgrounds —
-    // semantic tokens keep the "aggressive" ordering while staying theme-coherent.
-    if (pct >= 50)
-        return "error";
-    if (pct >= 25)
-        return "warning";
-    if (pct >= 12.5)
-        return "accent";
-    return "dim";
+/**
+ * Fixed tier palette (nord green / nord yellow / dark red). Hex, not theme tokens:
+ * the tiers are an alarm scale the user picked explicitly, so they must read the
+ * same on every theme. `CONTEXT_TIER_THEME_COLOR` is only the fallback for themes
+ * that cannot emit raw hex.
+ */
+export const CONTEXT_TIER_HEX = {
+    ok: "#A3BE8C",
+    warn: "#EBCB8B",
+    critical: "#9A3939",
+};
+/** Semantic token approximating each tier — used when raw hex is unavailable. */
+export const CONTEXT_TIER_THEME_COLOR = {
+    ok: "success",
+    warn: "warning",
+    critical: "error",
+};
+/**
+ * Tier from the share of the context window consumed.
+ *
+ * Budgets scale with the window: a 1M window only earns 12.5 / 25 % of slack
+ * before the same alarm, while smaller windows (compacted far sooner) keep the
+ * looser 25 / 50 % steps.
+ */
+export function contextUsageTier(pct, contextWindow) {
+    const [warnAt, criticalAt] = contextWindow >= 1_000_000 ? [12.5, 25] : [25, 50];
+    if (pct >= criticalAt)
+        return "critical";
+    if (pct >= warnAt)
+        return "warn";
+    return "ok";
 }
 export function cacheHitColor(value) {
     if (value < 30)

package/dist/config.js

@@ -46,9 +46,7 @@ function deepMerge(base, override) {
     if (typeof base !== "object" || base === null || Array.isArray(base)) {
         return override ?? base;
     }
-    if (typeof override !== "object" ||
-        override === null ||
-        Array.isArray(override)) {
+    if (typeof override !== "object" || override === null || Array.isArray(override)) {
         return base;
     }
     const result = { ...base };

package/dist/cursor-policy.js

@@ -17,15 +17,13 @@ function removeSoftwareCursor(line, cursorMarker = "") {
 function configureCursor(tui, cursorStyle) {
     if (cursorStyle === "block")
         return;
-    const setShow = 
-    // SAFETY: intentional unsafe cast — validated at runtime
-    tui.setShowHardwareCursor;
+    const setShow = // SAFETY: intentional unsafe cast — validated at runtime
+     tui.setShowHardwareCursor;
     if (typeof setShow === "function")
         setShow.call(tui, true);
     const seq = CURSOR_STYLE_SEQUENCES[cursorStyle];
     // SAFETY: intentional unsafe cast — validated at runtime
-    const term = tui
-        .terminal;
+    const term = tui.terminal;
     if (seq && term && typeof term.write === "function")
         term.write(seq);
 }

package/dist/detail-chrome.js

@@ -16,7 +16,7 @@
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
-import { contentLineCount, renderDetail, scroll, } from "./detail-render.js";
+import { contentLineCount, renderDetail, scroll } from "./detail-render.js";
 import { decorateWindow } from "./window-presentation.js";
 /** Height cap of the detail window (the user's spec: up to 5 lines). */
 export const MAX_LINES = 5;
@@ -52,6 +52,28 @@ function resolveSkillPath(skillName) {
         candidates.push(path.join(home, "stowfiles", "dotfiles", ".pi", "agent", "skills", name, "SKILL.md"));
         candidates.push(path.join(home, "stowfiles", "dotfiles", ".pi", "agent", ".agents", "skills", name, "SKILL.md"));
     }
+    // subskill candidates (any parent skill -> subskills/<name>)
+    const bases = [
+        path.join(cwd, ".agents", "skills"),
+        path.join(cwd, ".pi", "agent", "skills"),
+        path.join(cwd, ".pi", "skills"),
+        path.join(cwd, "skills"),
+    ];
+    if (home) {
+        bases.push(path.join(home, ".agents", "skills"), path.join(home, ".pi", "agent", "skills"), path.join(home, ".pi", "skills"));
+    }
+    for (const base of bases) {
+        try {
+            const entries = fs.readdirSync(base, { withFileTypes: true });
+            for (const e of entries) {
+                const isDir = e.isDirectory() || e.isSymbolicLink();
+                if (!isDir)
+                    continue;
+                candidates.push(path.join(base, e.name, "subskills", name, "SKILL.md"));
+            }
+        }
+        catch { }
+    }
     for (const p of candidates) {
         try {
             if (fs.existsSync(p))
@@ -66,6 +88,21 @@ function resolveSkillPath(skillName) {
         return path.join(home, ".pi", "agent", "skills", name, "SKILL.md");
     return path.join(cwd, ".pi", "agent", "skills", name, "SKILL.md");
 }
+function parseInvocation(skillPath) {
+    try {
+        const content = fs.readFileSync(skillPath, "utf-8");
+        const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+        if (!fmMatch)
+            return "model";
+        const fm = fmMatch[1] ?? "";
+        if (/^\s*disable-model-invocation\s*:\s*true\b/m.test(fm))
+            return "human";
+        return "model";
+    }
+    catch {
+        return undefined;
+    }
+}
 function detailItemOf(item) {
     const detail = {
         label: item.label,
@@ -82,6 +119,11 @@ function detailItemOf(item) {
         if (resolved !== undefined)
             detail.path = resolved;
     }
+    if (detail.kind === "skill" && detail.path) {
+        const inv = parseInvocation(detail.path);
+        if (inv)
+            detail.invocation = inv;
+    }
     return detail;
 }
 export class DetailChrome {
@@ -138,6 +180,8 @@ export class DetailChrome {
             border: (s) => t.fg("border", s),
             highlight: (s) => t.fg("accent", t.bold(s)),
             dim: (s) => t.fg("dim", s),
+            model: (s) => t.fg("success", s),
+            human: (s) => t.fg("warning", s),
         };
         const innerWidth = Math.max(1, width - 4);
         const lines = renderDetail(detailItemOf(item), innerWidth, this.maxLines, this.scrollOffset);

package/dist/detail-render.js

@@ -42,9 +42,11 @@ export function renderDetail(item, width, maxLines, scrollOffset) {
     const markerLen = marker.length;
     let header;
     const rawPath = item.path?.trim() ?? "";
+    const invocationSeg = item.invocation ? ` · ${item.invocation}` : "";
+    const invocationLen = invocationSeg.length;
     if (rawPath !== "") {
         const normalized = normalizePath(rawPath);
-        const availableForPath = Math.max(0, wrapWidth - base.length - markerLen - 2);
+        const availableForPath = Math.max(0, wrapWidth - base.length - markerLen - invocationLen - 2);
         let pathSeg = "";
         if (availableForPath >= 10) {
             const truncated = normalized.length <= availableForPath
@@ -52,19 +54,30 @@ export function renderDetail(item, width, maxLines, scrollOffset) {
                 : truncateMiddle(normalized, availableForPath);
             pathSeg = `  ${truncated}`;
         }
-        const totalLen = base.length + pathSeg.length + markerLen;
+        const totalLen = base.length + pathSeg.length + invocationLen + markerLen;
         if (totalLen <= wrapWidth) {
-            header = base + pathSeg + marker;
+            header = base + pathSeg + invocationSeg + marker;
         }
-        else if (pathSeg !== "") {
-            const baseWidth = Math.max(0, wrapWidth - pathSeg.length - markerLen);
-            header = truncateToWidth(base, baseWidth) + pathSeg + marker;
+        else if (pathSeg !== "" || invocationSeg !== "") {
+            const suffixLen = pathSeg.length + invocationLen + markerLen;
+            const baseWidth = Math.max(0, wrapWidth - suffixLen);
+            header = truncateToWidth(base, baseWidth) + pathSeg + invocationSeg + marker;
         }
         else {
             const nameWidth = Math.max(0, wrapWidth - markerLen);
             header = truncateToWidth(base, nameWidth) + marker;
         }
     }
+    else if (invocationSeg !== "") {
+        const totalLen = base.length + invocationLen + markerLen;
+        if (totalLen <= wrapWidth) {
+            header = base + invocationSeg + marker;
+        }
+        else {
+            const baseWidth = Math.max(0, wrapWidth - invocationLen - markerLen);
+            header = truncateToWidth(base, baseWidth) + invocationSeg + marker;
+        }
+    }
     else if (overflows) {
         const nameWidth = Math.max(0, wrapWidth - markerLen);
         header = truncateToWidth(base, nameWidth) + marker;
@@ -83,8 +96,7 @@ export function contentLineCount(item, width) {
     if (!item || item.description.trim() === "") {
         return 0;
     }
-    return wrapDescription(item.description, Math.max(1, Math.floor(width)))
-        .length;
+    return wrapDescription(item.description, Math.max(1, Math.floor(width))).length;
 }
 /**
  * Next scroll offset after moving by `delta` (-1 = back/up, +1 = forward/down).