@yaosu/pi-path-guard 1.1.0 → 1.1.1

package/README.md

@@ -22,7 +22,7 @@ pi install /path/to/pi-path-guard
 # Try without installing (no settings change / 临时试用，不写入 settings)
 pi -e ./pi-path-guard
 
-# npm (after publishing / 发布后): scope package
+# npm: scope package
 # pi install npm:@yaosu/pi-path-guard
 ```
 
@@ -36,6 +36,7 @@ After installing, run `/reload` or restart pi. 安装后 `/reload` 或重启 pi
 - `/guard <strict|normal|loose|trusted|naked>` — quick switch (trusted requires a warning; naked requires a double warning) 快捷切换（trusted 需警告确认；naked 需两级确认）
 - Invalid argument → falls back to the interactive picker 非法参数 → 兜底弹出交互选择
 - Every new session resets to `normal` 每次新会话自动回到 `normal`
+- The active mode is shown in the footer status bar (`🛡 <mode>`, `🛡 NAKED` in warning color) 当前模式显示在底部状态栏（`🛡 <mode>`，naked 用警示色 `🛡 NAKED`）
 
 ### Guard mode matrix / 防护模式矩阵
 
@@ -72,13 +73,13 @@ After installing, run `/reload` or restart pi. 安装后 `/reload` 或重启 pi
 
 ## Development / 开发与测试
 
-Automated tests (96 assertions) load the real extension with a mocked pi API, covering the 5 modes × protected paths / dangerous commands / truncation / git destructive matrix, plus `/guard` command interaction, trusted-mode confirmation, and naked-mode double confirmation:
+Automated tests (99 assertions) load the real extension with a mocked pi API, covering the 5 modes × protected paths / dangerous commands / truncation / git destructive matrix, plus `/guard` command interaction, trusted-mode confirmation, naked-mode double confirmation, and the footer status indicator:
 
 ```bash
 cd tests && node --experimental-strip-types test-pathguard.ts
 ```
 
-自动化测试（96 断言）模拟 pi API 加载真实扩展，覆盖 5 种模式 × 受保护路径 / 危险命令 / 截断 / git 破坏性等判定矩阵，以及 `/guard` 命令交互、trusted 确认与 naked 两级确认流程：
+自动化测试（99 断言）模拟 pi API 加载真实扩展，覆盖 5 种模式 × 受保护路径 / 危险命令 / 截断 / git 破坏性等判定矩阵，以及 `/guard` 命令交互、trusted 确认与 naked 两级确认、底部状态栏指示等流程：
 
 ```bash
 cd tests && node --experimental-strip-types test-pathguard.ts

package/extensions/path-guard.ts

@@ -52,6 +52,7 @@ import type {
 	EditToolInput,
 	WriteToolInput,
 	ToolCallEventResult,
+	ExtensionUIContext,
 } from "@earendil-works/pi-coding-agent";
 import {
 	resolve,
@@ -250,10 +251,27 @@ type GuardVerdict =
 
 // ─── Entry ────────────────────────────────────────────────────────────
 
+/** Set the current guard mode and mirror it into the TUI footer status bar. */
+function setMode(mode: GuardMode, ui: ExtensionUIContext) {
+	currentMode = mode;
+	refreshModeStatus(ui);
+}
+
+/**
+ * Show the active guard mode in the footer status bar (persists across renders).
+ * naked is highlighted in warning color so the "bare" state is unmissable.
+ */
+function refreshModeStatus(ui: ExtensionUIContext) {
+	const t = ui.theme;
+	const color = currentMode === "naked" ? "warning" : "accent";
+	const label = currentMode === "naked" ? "🛡 NAKED" : `🛡 ${currentMode}`;
+	ui.setStatus("path-guard", t.fg(color, label));
+}
+
 export default function (pi: ExtensionAPI) {
 	// Reset to normal on every new session (startup, /new, /resume all fire session_start)
-	pi.on("session_start", () => {
-		currentMode = "normal";
+	pi.on("session_start", (_event, ctx) => {
+		setMode("normal", ctx.ui);
 	});
 
 	// /guard slash command: view / switch guard mode
@@ -273,6 +291,7 @@ export default function (pi: ExtensionAPI) {
 					return;
 				}
 				currentMode = m;
+				refreshModeStatus(ctx.ui);
 				ctx.ui.notify(
 					`Path Guard switched to: ${m} (session-only; new sessions reset to normal)`,
 					"info",
@@ -309,6 +328,7 @@ export default function (pi: ExtensionAPI) {
 					return;
 				}
 				currentMode = picked;
+				refreshModeStatus(ctx.ui);
 				ctx.ui.notify(
 					`Path Guard switched to: ${picked} (session-only; new sessions reset to normal)`,
 					"info",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaosu/pi-path-guard",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "type": "module",
   "description": "Path Guard for pi — blocks destructive commands & path overwrites, protects .env/keys, with strict/normal/loose/trusted/naked guard modes (/guard). pi 防误删/防误覆盖扩展，支持 5 种防护模式。",
   "keywords": [