@caph42/pi-ccline 0.2.1 → 0.2.2

package/README.md

@@ -77,7 +77,8 @@ After startup the footer is whatever ccline renders. Your terminal needs Nerd Fo
   "refreshThrottleMs": 1000,
   "liveRefreshMs": 1000,
   "showProvider": true,
-  "env": {}
+  "env": {},
+  "statusBadges": {}
 }
 ```
 
@@ -90,6 +91,7 @@ After startup the footer is whatever ccline renders. Your terminal needs Nerd Fo
 | `liveRefreshMs` | `1000` | Interval of the timer that refreshes while the agent runs (so `duration` ticks every second); `0` disables the timer and leaves only event-driven refreshes. When non-zero, anything below 250 is raised to 250 |
 | `showProvider` | `true` | Whether to append the provider to the model segment, e.g. `Sonnet 4.5 (anthropic)`; `false` shows just the model name. If the terminal is narrow enough for ccline to truncate the model segment, the provider may not be visible |
 | `env` | `{}` | Extra environment variables for ccline; same-named variables override the values inherited from pi (except `COLUMNS`, which the extension writes from the current width) |
+| `statusBadges` | `{}` | Icons and colors for the status row other extensions set through `ctx.ui.setStatus`, shaped `{"<status key>": {"icon": "<glyph>", "color": "<theme token>"}}`. Built in: `pi-herdr-pstack` (its `poteto-mode` status) → the Nerd Font rocket `U+F135` in `accent`. Fields merge over the built-in entry, so `{"pi-herdr-pstack": {"icon": ""}}` drops the icon and keeps the color; `""` for both removes the badge. Status keys are matched verbatim against `setStatus` keys. A status whose text already carries ANSI colors is left untouched, and an unknown theme token falls back to uncolored text |
 
 Binary resolution order: `config.binary` → `~/.claude/ccline/ccline` → `ccline` on `PATH`.
 
@@ -102,6 +104,7 @@ Binary resolution order: `config.binary` → `~/.claude/ccline/ccline` → `ccli
 - Binary not found: the footer shows a one-line install hint.
 - Widths are always computed with `visibleWidth` / `truncateToWidth`, never with `.length`.
 - **Other extensions' `ctx.ui.setStatus` stays visible**: `render(width)` reads `footerData.getExtensionStatuses()`, sorts by key, joins them with spaces into one line, truncates with a dim `…` when too wide, and appends it below the ccline frame, matching pi's built-in footer. It reads the live map and `setStatus` itself triggers a repaint, so status changes are not limited by the 1Hz throttle.
+- **A status key can carry a badge**: `setStatus` hands over text, and whether it is styled depends on the extension that sends it (pi's own footer adds nothing). This footer therefore decorates only statuses that arrive unstyled — a Nerd Font icon and a theme color, per status key (`DEFAULT_STATUS_BADGES` in `config.ts` holds the built-in entry for pi-herdr-pstack's `poteto-mode`). The icon is counted with the rest of the row before truncating, a status whose text already contains ANSI is skipped to avoid mixing two palettes, and the color goes through one `theme.fg()` call per badge that degrades to plain text when the token is not in the theme.
 - Because there is only one footer slot globally, other extensions' custom footers (e.g. pi-cursor-provider's fast badge) get displaced once this extension is installed; their status lines still show. Conversely, when they take over, the ccline frame disappears and `/pi-ccline on` takes it back.
 - **The provider can only be folded into the model segment.** ccline 2.0.1's input schema has no provider field and the `model` segment renders only `display_name`, so the provider is appended after the model name as `name (provider)`; it isn't appended twice when the name already carries the same suffix. `showProvider: false` turns it off. **At narrow widths the provider may be invisible**: ccline wraps/truncates by `COLUMNS` itself, and in practice at width 40 the model segment is left with just `GPT-5.6` — that's upstream layout behaviour, and this extension only guarantees the provider is written into `display_name`.
 - The input JSON **omits the `version` field**: ccline 2.0.1 validates it as a Claude Code version and rejects pi's version outright.

package/README_zh.md

@@ -77,7 +77,8 @@ pi install .
   "refreshThrottleMs": 1000,
   "liveRefreshMs": 1000,
   "showProvider": true,
-  "env": {}
+  "env": {},
+  "statusBadges": {}
 }
 ```
 
@@ -90,6 +91,7 @@ pi install .
 | `liveRefreshMs` | `1000` | agent 运行期间的定时刷新间隔（让 `耗时` 逐秒走）；`0` 关闭定时器，只保留事件刷新。非 0 时低于 250 会被抬到 250 |
 | `showProvider` | `true` | 是否在模型段追加 provider，如 `Sonnet 4.5 (anthropic)`；`false` 只显示模型名。终端窄到模型段被 ccline 截断时 provider 可能不可见 |
 | `env` | `{}` | 追加给 ccline 的环境变量；同名变量覆盖 pi 继承的值（`COLUMNS` 除外，它由扩展按当前宽度写入） |
+| `statusBadges` | `{}` | 给其他扩展 `ctx.ui.setStatus` 那一行加图标和颜色，形状 `{"<status key>": {"icon": "<字形>", "color": "<主题 token>"}}`。内置一条：`pi-herdr-pstack`（它的 `poteto-mode` 状态）→ Nerd Font 火箭 `U+F135` + `accent`。字段按项合并到内置条目上，所以 `{"pi-herdr-pstack": {"icon": ""}}` 只去掉图标、保留颜色；两个字段都写 `""` 即去掉徽标。status key 与 `setStatus` 的 key 逐字匹配；文本本身已带 ANSI 颜色的状态原样保留；主题里不存在的 token 回退成不上色 |
 
 二进制解析顺序：`config.binary` → `~/.claude/ccline/ccline` → `PATH` 中的 `ccline`。
 
@@ -102,6 +104,7 @@ pi install .
 - 找不到二进制：footer 显示一行安装提示。
 - 行宽一律用 `visibleWidth` / `truncateToWidth` 计算，不用 `.length`。
 - **其他扩展的 `ctx.ui.setStatus` 照样可见**：`render(width)` 读 `footerData.getExtensionStatuses()`，按 key 排序、用空格拼成一行、超宽时用 dim `…` 截断，追加在 ccline 帧下方——行为对齐 pi 内置 footer。读的是实时 map，`setStatus` 自己会触发重绘，所以状态变化不受 1Hz 节流限制。
+- **status 可以带徽标**：`setStatus` 交过来的是文本，有没有上色取决于发它的扩展（pi 自带 footer 不再加任何样式）。所以本扩展只装饰「没有自己上色」的状态：按 status key 加 Nerd Font 图标和主题色（内置条目在 `config.ts` 的 `DEFAULT_STATUS_BADGES`，目前是 pi-herdr-pstack 的 `poteto-mode`）。图标计入整行的可见宽度再截断；文本自带 ANSI 的状态跳过装饰，避免两套配色混在一起；颜色每帧走一次 `theme.fg()`，token 不在主题里就退成纯文本。
 - 因为 footer 槽位全局只有一个，本扩展装上后其他扩展的自定义 footer（例如 pi-cursor-provider 的 fast 徽标）会被顶掉；它们的 status 行仍会显示。反过来它们抢占时 ccline 帧会消失，需要 `/pi-ccline on` 取回。
 - **provider 只能拼进模型段。** ccline 2.0.1 的输入 schema 没有 provider 字段，`model` 段只渲染 `display_name`，所以 provider 以 `名称 (provider)` 的形式追加在模型名后；名字里已经带同样的后缀时不重复追加。`showProvider: false` 可关掉。**窄宽度下 provider 可能看不到**：ccline 按 `COLUMNS` 自己折行/截断，实测宽度 40 时模型段只剩 `GPT-5.6`，这是上游布局行为，本扩展只保证把 provider 写进 `display_name`。
 - 输入 JSON **省略 `version` 字段**：ccline 2.0.1 会把它当 Claude Code 版本校验，传 pi 的版本会被直接拒绝。

package/extensions/pi-ccline/config.test.ts

@@ -4,7 +4,7 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { test } from "node:test";
 
-import { DEFAULT_CONFIG, MIN_LIVE_REFRESH_MS, MIN_THROTTLE_MS, configPath, loadConfig, normalizeConfig, saveConfig } from "./config.ts";
+import { DEFAULT_CONFIG, DEFAULT_STATUS_BADGES, MIN_LIVE_REFRESH_MS, MIN_THROTTLE_MS, configPath, loadConfig, normalizeConfig, resolveStatusBadges, saveConfig } from "./config.ts";
 
 function tempDir(): string {
 	return mkdtempSync(join(tmpdir(), "pi-ccline-config-"));
@@ -53,9 +53,58 @@ test("keeps valid overrides", () => {
 		liveRefreshMs: DEFAULT_CONFIG.liveRefreshMs,
 		showProvider: DEFAULT_CONFIG.showProvider,
 		env: {},
+		statusBadges: {},
 	});
 });
 
+test("ships a built-in poteto-mode badge and lets the config override it field by field", () => {
+	assert.deepEqual(DEFAULT_CONFIG.statusBadges, {});
+	assert.deepEqual(resolveStatusBadges(undefined), DEFAULT_STATUS_BADGES);
+
+	// Clearing only the icon keeps the built-in color.
+	const noIcon = normalizeConfig({ statusBadges: { "pi-herdr-pstack": { icon: "" } } });
+	assert.deepEqual(resolveStatusBadges(noIcon.statusBadges), { "pi-herdr-pstack": { icon: "", color: "accent" } });
+
+	// A color-only override reuses the built-in icon.
+	const recolored = normalizeConfig({ statusBadges: { "pi-herdr-pstack": { color: "warning" } } });
+	assert.deepEqual(resolveStatusBadges(recolored.statusBadges), { "pi-herdr-pstack": { icon: DEFAULT_STATUS_BADGES["pi-herdr-pstack"]?.icon, color: "warning" } });
+});
+
+test("badges can be added for other status keys, and unusable entries are dropped", () => {
+	const config = normalizeConfig({
+		statusBadges: {
+			"ssh-remote": { color: "success" },
+			" ssh-remote ": { color: "error" },
+			["x".repeat(65)]: { icon: "y" },
+			mcp: { icon: "\n\t" },
+			broken: 5,
+			"": { icon: "x" },
+		},
+	});
+	// Keys are matched verbatim against `setStatus` keys, so a padded or oversized
+	// key is dropped rather than rewritten into something that can only miss.
+	assert.deepEqual(config.statusBadges, { "ssh-remote": { color: "success" } });
+});
+
+test("prototype-named keys stay own data properties", () => {
+	// Only JSON can carry an own `__proto__` key; an object literal would set the prototype.
+	const raw = JSON.parse('{"statusBadges":{"constructor":{"icon":"C"},"__proto__":{"color":"error"}}}');
+	const config = normalizeConfig(raw);
+	const resolved = resolveStatusBadges(config.statusBadges);
+	assert.equal(Object.hasOwn(resolved, "constructor"), true);
+	assert.equal(Object.hasOwn(resolved, "__proto__"), true);
+	assert.equal(Object.getPrototypeOf(resolved), Object.prototype);
+	assert.deepEqual(resolved.constructor, { icon: "C", color: "" });
+	assert.deepEqual(resolved["__proto__"], { icon: "", color: "error" });
+});
+
+test("a badge icon is cleaned and capped instead of breaking the status row", () => {
+	const [icon = ""] = Object.values(normalizeConfig({ statusBadges: { k: { icon: "  \u001b[31mabcde  " } } }).statusBadges);
+	assert.deepEqual(icon, { icon: "abcd" });
+	assert.deepEqual(normalizeConfig({ statusBadges: [] }).statusBadges, {});
+	assert.deepEqual(normalizeConfig({ statusBadges: "none" }).statusBadges, {});
+});
+
 test("showProvider defaults on and ignores non-boolean values", () => {
 	assert.equal(DEFAULT_CONFIG.showProvider, true);
 	assert.equal(normalizeConfig({}).showProvider, true);

package/extensions/pi-ccline/config.ts

@@ -20,6 +20,12 @@ export interface PiCclineConfig {
 	showProvider: boolean;
 	/** Extra environment variables passed to the binary. */
 	env: Record<string, string>;
+	/**
+	 * Per status-key badges for other extensions' `ctx.ui.setStatus` rows, merged
+	 * over `DEFAULT_STATUS_BADGES` at render time. Only the fields a user set are
+	 * stored, so a newer built-in default still applies when a field is absent.
+	 */
+	statusBadges: Record<string, StatusBadgeOverride>;
 }
 
 export const DEFAULT_CONFIG: PiCclineConfig = {
@@ -30,8 +36,84 @@ export const DEFAULT_CONFIG: PiCclineConfig = {
 	liveRefreshMs: 1000,
 	showProvider: true,
 	env: {},
+	statusBadges: {},
 };
 
+/** A resolved badge: a Nerd Font glyph in front of the text and a theme color. */
+export interface StatusBadge {
+	/** Glyph shown before the status text; empty for none. */
+	icon: string;
+	/** pi theme foreground token (`accent`, `success`, …); empty or unknown for no color. */
+	color: string;
+}
+
+/** What a user may write per key: either field may be omitted and inherited. */
+export type StatusBadgeOverride = Partial<StatusBadge>;
+
+/**
+ * Built-in badges for statuses set by packages this footer knows about. The
+ * supplying extension sends text (and may style it itself); this footer adds an
+ * icon and a color when it left the text plain. Keys are pi's status keys,
+ * matched verbatim, never the package name.
+ */
+export const DEFAULT_STATUS_BADGES: Record<string, StatusBadge> = {
+	// pi-herdr-pstack keeps this key while the sticky poteto methodology is on.
+	"pi-herdr-pstack": { icon: "\uf135", color: "accent" },
+};
+
+/** An icon longer than this is a typo or a whole path, not a glyph. */
+const MAX_BADGE_ICON_CODEPOINTS = 4;
+const MAX_BADGE_KEY_LENGTH = 64;
+
+/** A badge is text: drop CSI/OSC escapes, then any remaining control character. */
+const ESCAPE_SEQUENCE = /\u001b\[[0-?]*[ -/]*[@-~]|\u001b\][^\u0007\u001b]*(?:\u0007|\u001b\\)|\u001b[@-Z\\-_]/g;
+const CONTROL_CHARACTERS = /[\u0000-\u001f\u007f-\u009f]/g;
+
+function cleanBadgeText(value: string): string {
+	return value.replace(ESCAPE_SEQUENCE, "").replace(CONTROL_CHARACTERS, "").trim();
+}
+
+function normalizeBadges(raw: unknown): Record<string, StatusBadgeOverride> {
+	if (!raw || typeof raw !== "object" || Array.isArray(raw)) return {};
+	const badges: [string, StatusBadgeOverride][] = [];
+	for (const [key, rawBadge] of Object.entries(raw as Record<string, unknown>)) {
+		// Status keys are matched verbatim against `setStatus` keys: a padded or
+		// oversized key can only ever miss, so it is dropped instead of rewritten.
+		if (!key || key !== key.trim() || key.length > MAX_BADGE_KEY_LENGTH) continue;
+		if (!rawBadge || typeof rawBadge !== "object" || Array.isArray(rawBadge)) continue;
+		const entry = rawBadge as Record<string, unknown>;
+		const badge: StatusBadgeOverride = {};
+		if (typeof entry.icon === "string") {
+			badge.icon = Array.from(cleanBadgeText(entry.icon)).slice(0, MAX_BADGE_ICON_CODEPOINTS).join("");
+		}
+		if (typeof entry.color === "string") badge.color = cleanBadgeText(entry.color);
+		if (badge.icon === undefined && badge.color === undefined) continue;
+		// An entry that ends up empty is how a built-in badge is cleared; for an
+		// unknown key it would only add noise.
+		const emptied = !badge.icon && !badge.color;
+		if (emptied && !Object.hasOwn(DEFAULT_STATUS_BADGES, key)) continue;
+		badges.push([key, badge]);
+	}
+	// fromEntries keeps keys like `__proto__` as own data properties instead of
+	// letting the assignment rewrite the prototype.
+	return Object.fromEntries(badges);
+}
+
+/** Built-in badges with the user's per-field overrides applied. */
+export function resolveStatusBadges(
+	overrides: Readonly<Record<string, StatusBadgeOverride>> | null | undefined,
+): Record<string, StatusBadge> {
+	const resolved = new Map<string, StatusBadge>();
+	for (const [key, badge] of Object.entries(DEFAULT_STATUS_BADGES)) resolved.set(key, { ...badge });
+	for (const [key, override] of Object.entries(overrides ?? {})) {
+		const merged: StatusBadge = { ...(resolved.get(key) ?? { icon: "", color: "" }) };
+		if (override.icon !== undefined) merged.icon = override.icon;
+		if (override.color !== undefined) merged.color = override.color;
+		resolved.set(key, merged);
+	}
+	return Object.fromEntries(resolved);
+}
+
 export const MIN_TIMEOUT_MS = 200;
 export const MAX_TIMEOUT_MS = 60_000;
 /** The footer re-renders often; a faster refresh rate would spawn too many processes. */
@@ -69,6 +151,7 @@ function clampLiveRefresh(value: unknown, fallback: number): number {
 }
 
 const binary = typeof source.binary === "string" && source.binary.trim() ? source.binary.trim() : null;
+const statusBadges = normalizeBadges(source.statusBadges);
 
 	return {
 		enabled: typeof source.enabled === "boolean" ? source.enabled : DEFAULT_CONFIG.enabled,
@@ -78,6 +161,7 @@ const binary = typeof source.binary === "string" && source.binary.trim() ? sourc
 		liveRefreshMs: clampLiveRefresh(source.liveRefreshMs, DEFAULT_CONFIG.liveRefreshMs),
 		showProvider: typeof source.showProvider === "boolean" ? source.showProvider : DEFAULT_CONFIG.showProvider,
 		env,
+		statusBadges,
 	};
 }
 

package/extensions/pi-ccline/footer.test.ts

@@ -7,7 +7,7 @@ import { afterEach, test } from "node:test";
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 
 import { clearBinaryCache } from "./binary.ts";
-import { DEFAULT_CONFIG, type PiCclineConfig } from "./config.ts";
+import { DEFAULT_CONFIG, DEFAULT_STATUS_BADGES, type PiCclineConfig } from "./config.ts";
 import { CclineFooter, default as piCcline } from "./index.ts";
 
 const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
@@ -198,6 +198,33 @@ test("shows extension statuses even before ccline has produced a frame", () => {
 	harness.footer.dispose();
 });
 
+test("the built-in poteto-mode badge decorates the pi-herdr-pstack status", () => {
+	// The fake theme wraps everything in dim, so the marker proves the badge color
+	// path ran through theme.fg rather than being pasted on unconditionally.
+	const statuses = new Map([
+		["pi-herdr-pstack", "poteto-mode"],
+		["other-plugin", "Other status"],
+	]);
+	const harness = attach({ binary: fakeBinary("cat > /dev/null; printf 'FAKE-CCLINE\\n'") }, undefined, statuses);
+	const [statusRow] = harness.render(80).slice(1);
+	assert.equal(statusRow?.replace(/\u001b\[[0-9;]*m/g, ""), `Other status ${DEFAULT_STATUS_BADGES["pi-herdr-pstack"]?.icon} poteto-mode`);
+	assert.match(statusRow ?? "", /\u001b\[2m/, "the badge is colored through the theme");
+	harness.footer.dispose();
+});
+
+test("a configured badge override reaches the rendered row", () => {
+	const statuses = new Map([["pi-herdr-pstack", "poteto-mode"]]);
+	const harness = attach(
+		{ binary: fakeBinary("cat > /dev/null; printf 'FAKE-CCLINE\\n'"), statusBadges: { "pi-herdr-pstack": { icon: "" } } },
+		undefined,
+		statuses,
+	);
+	const row = harness.render(80)[1] ?? "";
+	assert.equal(row.replace(/\u001b\[[0-9;]*m/g, ""), "poteto-mode");
+	assert.match(row, /\u001b\[2m/, "clearing the icon keeps the configured color");
+	harness.footer.dispose();
+});
+
 test("live ticking advances time-based segments and stops with the agent run", async () => {
 	const counter = join(tempDir("pi-ccline-live-"), "count");
 	const binary = fakeBinary(

package/extensions/pi-ccline/index.ts

@@ -2,7 +2,7 @@ import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-a
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
 import { clearBinaryCache, probeVersion, resolveBinary, spawnCcline, type ResolvedBinary } from "./binary.ts";
-import { loadConfig, saveConfig, type PiCclineConfig } from "./config.ts";
+import { loadConfig, resolveStatusBadges, saveConfig, type PiCclineConfig, type StatusBadge } from "./config.ts";
 import { buildCclineInput, collectSnapshot } from "./input.ts";
 import { RefreshScheduler, RefreshTicker } from "./refresh.ts";
 import { extensionStatusLine, loadingNotice, missingBinaryNotice, normalizeFrame, noticeFrame, withStaleMarker } from "./render.ts";
@@ -57,6 +57,8 @@ function firstLine(text: string): string {
 export class CclineFooter {
 	private readonly ctx: ExtensionContext;
 	private readonly config: PiCclineConfig;
+	/** Built-in badges with the user's overrides already merged, resolved once. */
+	private readonly badges: Record<string, StatusBadge>;
 	private readonly scheduler: RefreshScheduler;
 	/** Only runs while the agent is active so an idle session spawns nothing. */
 	private readonly ticker: RefreshTicker;
@@ -91,6 +93,7 @@ export class CclineFooter {
 	constructor(ctx: ExtensionContext, config: PiCclineConfig) {
 		this.ctx = ctx;
 		this.config = config;
+		this.badges = resolveStatusBadges(config.statusBadges);
 		this.scheduler = new RefreshScheduler({
 			throttleMs: config.refreshThrottleMs,
 			task: () => this.refresh(),
@@ -283,7 +286,11 @@ export class CclineFooter {
 				return null;
 			}
 		})();
-		const status = extensionStatusLine(statuses, safeWidth, this.theme ? this.theme.fg("dim", "…") : "…");
+		const status = extensionStatusLine(statuses, safeWidth, this.theme ? this.theme.fg("dim", "…") : "…", {
+			badges: this.badges,
+			// render.ts catches a throwing token, so a stale theme entry costs only its color.
+			colorize: this.theme ? (color, text) => this.theme?.fg(color, text) ?? text : null,
+		});
 		return status ? [...lines, status] : lines;
 	}
 

package/extensions/pi-ccline/render.test.ts

@@ -89,3 +89,60 @@ test("a long status row is truncated by visible width with the dim ellipsis", ()
 	assert.ok(visibleWidth(row) <= 10, `visible width was ${visibleWidth(row ?? "")}`);
 	assert.ok((row ?? "").replace(/\u001b\[[0-9;]*m/g, "").endsWith("..."));
 });
+
+test("a badge adds its icon and color to the matching status key only", () => {
+	const statuses = new Map([
+		["mcp", "connected"],
+		["pi-herdr-pstack", "poteto-mode"],
+	]);
+	const line = extensionStatusLine(statuses, 80, "…", {
+		badges: { "pi-herdr-pstack": { icon: "R", color: "accent" } },
+		colorize: (color, text) => `[${color}]${text}`,
+	});
+	assert.equal(line, "connected [accent]R poteto-mode");
+});
+
+test("a status that colors itself keeps its own styling", () => {
+	const statuses = new Map([["pi-herdr-pstack", `${RED}poteto-mode${RESET}`]]);
+	const line = extensionStatusLine(statuses, 80, "…", {
+		badges: { "pi-herdr-pstack": { icon: "R", color: "accent" } },
+		colorize: (color, text) => `[${color}]${text}`,
+	});
+	assert.equal(line, `${RED}poteto-mode${RESET}`);
+});
+
+test("an unknown theme token falls back to the plain badge label", () => {
+	const line = extensionStatusLine(new Map([["k", "v"]]), 80, "…", {
+		badges: { k: { icon: "R", color: "nope" } },
+		colorize: () => {
+			throw new Error("Unknown theme color: nope");
+		},
+	});
+	assert.equal(line, "R v");
+});
+
+test("an icon with no color still shows, and an empty icon adds no gap", () => {
+	const badges = { a: { icon: "R" }, b: { icon: "", color: "accent" } };
+	const line = extensionStatusLine(new Map([["a", "one"], ["b", "two"]]), 80, "…", {
+		badges,
+		colorize: (color, text) => `[${color}]${text}`,
+	});
+	assert.equal(line, "R one [accent]two");
+});
+
+test("only own badge entries are applied, never inherited object members", () => {
+	const line = extensionStatusLine(new Map([["toString", "v"]]), 80, "…", {
+		badges: {},
+		colorize: (color, text) => `[${color}]${text}`,
+	});
+	assert.equal(line, "v");
+});
+
+test("the badge counts toward the truncated width", () => {
+	const row = extensionStatusLine(new Map([["k", "日".repeat(10)]]), 10, "...", {
+		badges: { k: { icon: "R", color: "accent" } },
+		colorize: (color, text) => `\u001b[35m${text}\u001b[39m`,
+	});
+	assert.ok(row !== null);
+	assert.ok(visibleWidth(row) <= 10, `visible width was ${visibleWidth(row ?? "")}`);
+});

package/extensions/pi-ccline/render.ts

@@ -35,6 +35,40 @@ export function sanitizeStatusText(text: string): string {
 	return text.replace(/[\r\n\t]/g, " ").replace(/ +/g, " ").trim();
 }
 
+/** The badge fields this module needs; config.ts owns the validated shape. */
+export type StatusBadgeLike = { icon?: string | undefined; color?: string | undefined };
+
+export interface StatusLineOptions {
+	/** Badges per status key; a key without an entry stays plain text. */
+	badges?: Readonly<Record<string, StatusBadgeLike>> | null | undefined;
+	/** Theme colorizer for the badge color token; missing or throwing means plain text. */
+	colorize?: ((color: string, text: string) => string) | null | undefined;
+}
+
+/**
+ * A status arrives from another extension as text, and that extension may or
+ * may not have colored it. A badge adds an icon and a color — but only to a
+ * status that did not style itself, so an extension that already uses
+ * `theme.fg` keeps its own palette instead of ending up half-colored.
+ */
+function withBadge(key: string, text: string, options: StatusLineOptions): string {
+	const badges = options.badges;
+	// Own properties only: a status key like `toString` must not resolve to the
+	// object's inherited members.
+	const badge = badges && Object.hasOwn(badges, key) ? badges[key] : undefined;
+	if (!badge) return text;
+	if (text.includes("\u001b[")) return text;
+	const label = badge.icon ? `${badge.icon} ${text}` : text;
+	const colorize = options.colorize;
+	if (!badge.color || !colorize) return label;
+	try {
+		return colorize(badge.color, label);
+	} catch {
+		// An unknown theme token must not cost the row its text.
+		return label;
+	}
+}
+
 /**
  * pi's built-in footer puts every extension status on one extra row, sorted by
  * key and joined by a space. Mirror that so `ctx.ui.setStatus` keeps working
@@ -44,12 +78,14 @@ export function extensionStatusLine(
 	statuses: Iterable<[string, string]> | null | undefined,
 	width: number,
 	ellipsis = "…",
+	options: StatusLineOptions = {},
 ): string | null {
 	if (!statuses) return null;
 	const text = [...statuses]
 		.sort(([a], [b]) => a.localeCompare(b))
-		.map(([, value]) => sanitizeStatusText(value))
-		.filter((value) => value.length > 0)
+		.map(([key, value]) => ({ key, text: sanitizeStatusText(value) }))
+		.filter((status) => status.text.length > 0)
+		.map((status) => withBadge(status.key, status.text, options))
 		.join(" ");
 	if (!text) return null;
 	const safeWidth = Math.max(1, Math.floor(width));

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@caph42/pi-ccline",
-	"version": "0.2.1",
+	"version": "0.2.2",
 	"description": "Pi extension that renders the footer by delegating to the CCometixLine (ccline) statusline binary",
 	"keywords": [
 		"pi-package",