pi-tidy-footer 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 [中文](#中文)
 
+## [0.5.0] - 2026-07-23
+
+### Added
+
+- `/es` command: extension sort (renamed from `/se`), show or set sort order
+- `/ew` command: toggle extension wrap mode (on/off), persisted across sessions; when on, extension statuses wrap at entry boundaries instead of truncating with `...`
+- `peerDependencies` declared for `@earendil-works/pi-ai`, `@earendil-works/pi-coding-agent`, and `@earendil-works/pi-tui`
+- `homepage` field added to package.json
+
+### Changed
+
+- Extension status wrapping: entries now wrap atomically at extension boundary (single-entry overflow still truncates); replaces the native footer's single-line truncation behaviour
+- `pi.extensions` value changed from a single-file path (`./extensions/pi-tidy-footer.ts`) to a directory path (`./extensions`) for compatibility with pi.dev indexing
+- `package.json` fields reordered to standard convention
+- `/se` renamed to `/es` for consistency with other `/e-` prefixed extension commands
+- Description and README updated
+
 ## [0.4.0] - 2026-07-22
 
 ### Added
@@ -63,6 +80,23 @@
 
 ## 中文
 
+## [0.5.0] - 2026-07-23
+
+### 新增
+
+- `/es` 命令：扩展排序（原 `/se` 重命名），查看或设置排列顺序
+- `/ew` 命令：切换扩展换行模式（开/关），持久化存储；开启后扩展状态按条目边界换行，不再截断加 `...`
+- 声明 `peerDependencies`：`@earendil-works/pi-ai`、`@earendil-works/pi-coding-agent`、`@earendil-works/pi-tui`
+- 新增 `homepage` 字段
+
+### 变更
+
+- 扩展状态换行：以扩展条目为原子换行（单条超宽仍截断），替代原生 footer 的单行截断行为
+- `pi.extensions` 从单文件路径改为目录路径（`./extensions`），兼容 pi.dev 索引
+- `package.json` 字段顺序按行业规范重新排列
+- 描述与 README 更新：「插件自定义排序与换行、token 余额显示、Git 文件状态、工具活动指示」
+- `/se` 重命名为 `/es`，与后续 `e-` 前缀扩展命令统一
+
 ## [0.4.0] - 2026-07-22
 
 ### 新增

package/README.md

@@ -2,7 +2,7 @@
 
 [中文](#中文)
 
-Tidy footer for Pi coding agent — native layout, layered with new features: extension sort order, token balance display (color-coded warnings with configurable thresholds), git status tokens, and tool activity indicators; minor display tweaks for selected third-party extensions, keeping it clean.
+Tidy footer for Pi coding agent — native layout, layered with new features: extension sorting and wrapping, token balance display (color-coded warnings with configurable thresholds), git file status, and tool activity indicators; minor display tweaks for extension labels, keeping it clean.
 
 ## Install
 
@@ -12,8 +12,8 @@ pi install npm:pi-tidy-footer
 
 ## Features
 
-- **Account balance** — Shows DeepSeek or Kimi account balance after the model name (`¤¥` format), yellow below warn threshold, red below alert threshold, both configurable
 - **Extension sort order** — Custom sort order for extension statuses, persisted across sessions; run empty command to view the current order prompt
+- **Account balance** — Shows DeepSeek or Kimi account balance after the model name (`¤¥` format), yellow below warn threshold, red below alert threshold, both configurable
 - **Git status tokens** — Repo state next to the branch name: `⇡` ahead, `⇣` behind, `+` staged, `~` modified, `?` untracked, `!` conflicts; hidden when clean
 - **Tool activity indicator** — Shows the running tool (highlighted) before the model name with brief hold for fast tools; hidden when idle
 - **Hide per-session cost** — Removes `$0.604` from the left stats area, keeping it token-focused
@@ -32,13 +32,14 @@ pi install npm:pi-tidy-footer
 | --- | --- |
 | `/tf` | Toggle pi-tidy-footer (on/off) |
 | `/bt <warn> <alert>` | Set balance yellow/red thresholds (warn > alert required) |
-| `/se` | Show or set extension status sort order |
+| `/es` | Extension sort (no args = show order, args = set order) |
+| `/ew` | Toggle extension wrap (on/off) |
 
 ---
 
 ## 中文
 
-为 Pi coding agent 打造的整洁页脚 — 沿用原生布局，叠加了新的功能：插件自定义排序、token 余额显示（颜色警告、自定义警告阈值）、Git 状态标记、工具活动指示；对部分第三方插件进行名称显示微调，保持简洁。
+为 Pi coding agent 打造的整洁页脚 — 沿用原生布局，叠加了新的功能：插件自定义排序与换行、token 余额显示（颜色警告、自定义警告阈值）、Git 文件状态、工具活动指示；对插件标签进行显示微调，保持简洁。
 
 ## 安装
 
@@ -48,8 +49,8 @@ pi install npm:pi-tidy-footer
 
 ## 功能
 
-- **账户余额** — 模型名后显示 DeepSeek / Kimi 账户余额（`¤¥` 格式），低于预警值（warn）变黄，低于警报值（alert）变红，阈值可自定义
 - **插件自定义排序** — 扩展状态按自定义顺序排列，持久化存储；可使用空命令查看排序字段提示
+- **账户余额** — 模型名后显示 DeepSeek / Kimi 账户余额（`¤¥` 格式），低于预警值（warn）变黄，低于警报值（alert）变红，阈值可自定义
 - **Git 状态标记** — 分支名旁显示仓库状态：`⇡` 领先、`⇣` 落后、`+` 已暂存、`~` 已修改、`?` 未跟踪、`!` 冲突；干净仓库不显示
 - **工具活动指示** — 模型名前实时显示正在运行的工具（高亮），快工具至少有短暂停留；空闲时不显示
 - **去除会话费用显示** — 从左侧统计模块移除 `$0.604`，让统计专注 token
@@ -68,4 +69,5 @@ pi install npm:pi-tidy-footer
 | --- | --- |
 | `/tf` | 切换 pi-tidy-footer 页脚（开/关） |
 | `/bt <warn> <alert>` | 设置余额黄/红阈值（warn > alert） |
-| `/se` | 查看或设置扩展状态排列顺序 |
+| `/es` | 扩展排序（空参查看，传参设置） |
+| `/ew` | 切换扩展换行模式（开/关） |

package/extensions/pi-tidy-footer.ts

@@ -73,6 +73,30 @@ function writePersistedEnabled(enabled: boolean): void {
 	}
 }
 
+function readWrapEnabled(): boolean {
+	try {
+		return JSON.parse(readFileSync(STATE_FILE, "utf-8")).wrapEnabled === true;
+	} catch {
+		return false;
+	}
+}
+
+function writeWrapEnabled(wrap: boolean): void {
+	try {
+		const prev: any = existsSync(STATE_FILE)
+			? JSON.parse(readFileSync(STATE_FILE, "utf-8"))
+			: {};
+		mkdirSync(STATE_DIR, { recursive: true });
+		writeFileSync(
+			STATE_FILE,
+			JSON.stringify({ ...prev, wrapEnabled: wrap }),
+			"utf-8",
+		);
+	} catch {
+		/* no-op */
+	}
+}
+
 function readExtensionOrder(): string[] {
 	const fallback = ["caveman", "ponytail", "mcp", "pi-lens-lsp"];
 	try {
@@ -271,6 +295,8 @@ function makeFooter(
 	let balanceLastFetch = 0;
 	let balanceInFlight = false;
 
+	const wrapEnabled = readWrapEnabled();
+
 	const runGitStatus = () => {
 		if (disposed) return;
 		if (gitInFlight) {
@@ -517,8 +543,8 @@ function makeFooter(
 				line2 = theme.fg("dim", left);
 			}
 
-			/* extension statuses */
-			const extItems: string[] = [];
+			/* extension statuses — keep key for grouped wrapping */
+			const extItems: [string, string][] = [];
 			const raw = fd.getExtensionStatuses();
 			let mcpRgb = ""; // capture original MCP accent colour so theme changes work
 			if (raw.size > 0) {
@@ -535,7 +561,7 @@ function makeFooter(
 							const s = (v as string)
 								.replace("caveman level:", "Caveman:")
 								.replace(/(FULL|ULTRA|LITE|OFF)/g, (w) => w.toLowerCase());
-							return s;
+							return [k, s] as [string, string];
 						}
 						if (k === "ponytail") {
 							const s = (v as string)
@@ -545,11 +571,11 @@ function makeFooter(
 									" 🐴 \x1b[38;2;128;128;128mponytail:",
 									" 🐴\x1b[38;2;128;128;128mponytail:",
 								);
-							return s;
+							return [k, s] as [string, string];
 						}
-						return (v as string).trim();
+						return [k, (v as string).trim()] as [string, string];
 					})
-					.filter(Boolean);
+					.filter(([, v]) => Boolean(v));
 				extItems.push(...sorted);
 			}
 
@@ -565,13 +591,34 @@ function makeFooter(
 				line2,
 			];
 			if (extItems.length > 0) {
-				let statusLine = extItems.join(" ");
-				// Rewrite MCP: prefix with dim colour, reset after the colon
-				statusLine = statusLine.replace(
-					/MCP:/,
-					`\x1b[38;2;128;128;128mMCP:${mcpRgb || "\x1b[38;2;138;190;183m"}`,
-				);
-				lines.push(truncateToWidth(statusLine, width, theme.fg("dim", "...")));
+				if (wrapEnabled) {
+					let current = "";
+					for (const [, text] of extItems) {
+						// MCP colour rewrite
+						const seg = text.replace(
+							/MCP:/,
+							`\x1b[38;2;128;128;128mMCP:${mcpRgb || "\x1b[38;2;138;190;183m"}`,
+						);
+						const test = current ? `${current} ${seg}` : seg;
+						if (visibleWidth(test) > width) {
+							if (current) lines.push(current);
+							current = seg;
+						} else {
+							current = test;
+						}
+					}
+					// ponytail: last-resort truncation only if a single entry exceeds terminal width
+					if (current && visibleWidth(current) > width) {
+						lines.push(truncateToWidth(current, width, theme.fg("dim", "...")));
+					} else if (current) {
+						lines.push(current);
+					}
+				} else {
+					const statusLine = extItems.map(([, t]) => t).join(" ");
+					lines.push(
+						truncateToWidth(statusLine, width, theme.fg("dim", "...")),
+					);
+				}
 			}
 
 			return lines;
@@ -716,9 +763,21 @@ export default function (pi: any) {
 		},
 	});
 
-	pi.registerCommand("se", {
-		description:
-			"Sort extension statuses (no args = show order, keys = set order)",
+	pi.registerCommand("ew", {
+		description: "Toggle extension wrap (on/off)",
+		handler: async (_args: string, ctx: any) => {
+			const next = !readWrapEnabled();
+			writeWrapEnabled(next);
+			if (enabled) applyFooter(ctx);
+			ctx.ui.notify(
+				next ? "Extension wrap ON" : "Extension wrap OFF (truncate)",
+				"info",
+			);
+		},
+	});
+
+	pi.registerCommand("es", {
+		description: "Extension sort (no args = show order, keys = set order)",
 		handler: async (args: string, ctx: any) => {
 			const trimmed = args.trim();
 			if (!trimmed) {

package/package.json

@@ -1,32 +1,38 @@
 {
   "name": "pi-tidy-footer",
-  "version": "0.4.0",
-  "description": "Tidy footer for Pi coding agent — native layout, layered with new features: extension sort order, token balance display (color-coded warnings with configurable thresholds), git status tokens, and tool activity indicators; minor display tweaks for selected third-party extensions, keeping it clean.",
+  "version": "0.5.0",
+  "description": "Tidy footer for Pi coding agent — native layout, layered with new features: extension sorting and wrapping, token balance display (color-coded warnings with configurable thresholds), git file status, and tool activity indicators; minor display tweaks for extension labels, keeping it clean.",
   "type": "module",
-  "main": "extensions/pi-tidy-footer.ts",
   "license": "MIT",
+  "author": "eriiic7z",
+  "homepage": "https://github.com/eriiic7z/pi-tidy-footer#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/eriiic7z/pi-tidy-footer.git"
   },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "extension"
+  ],
+  "main": "extensions/pi-tidy-footer.ts",
   "files": [
     "extensions",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
   ],
-  "pi": {
-    "extensions": [
-      "./extensions/pi-tidy-footer.ts"
-    ]
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
   },
-  "keywords": [
-    "pi-package",
-    "pi-extension",
-    "extension"
-  ],
-  "author": "eriiic7z",
   "devDependencies": {
     "@types/node": "^26.1.1"
+  },
+  "pi": {
+    "extensions": [
+      "./extensions"
+    ]
   }
 }