@ryan_nookpi/pi-extension-todo-write-overlay 0.1.1 → 0.2.0

package/README.md

@@ -20,6 +20,7 @@ pi install npm:@ryan_nookpi/pi-extension-todo-write-overlay
 - 세션 단위 todo 상태 저장 및 복원
 - 우측 상단 오버레이 렌더링
 - 입력 포커스를 뺏지 않는 `nonCapturing` overlay 사용
+- `/todo-overlay show` / `/todo-overlay hide` 명령으로 오버레이 표시 토글
 - 진행 중 작업 스피너 표시
 - 완료/진행/대기 상태별 색상과 아이콘 표시
 - `notes`는 상태에는 보존하지만 오버레이에는 표시하지 않음
@@ -37,6 +38,17 @@ pi install npm:@ryan_nookpi/pi-extension-todo-write-overlay
 
 기존 `todo-write`의 `완료 +2` 같은 완료 항목 접기 로직은 사용하지 않습니다. 완료된 항목도 모두 그대로 표시합니다.
 
+## 명령어
+
+```text
+/todo-overlay show
+/todo-overlay hide
+```
+
+- 기본값은 `show`입니다.
+- `hide`는 todo 상태와 reminder 주입은 유지하고, 우측 상단 오버레이 UI만 숨깁니다.
+- 인자 없이 `/todo-overlay`를 실행하면 현재 표시 상태를 알려줍니다.
+
 ## 사용 예
 
 ```json

package/index.ts

@@ -1,7 +1,6 @@
-import { StringEnum } from "@mariozechner/pi-ai";
-import type { ExtensionAPI, ExtensionContext, Theme } from "@mariozechner/pi-coding-agent";
-import type { OverlayHandle, TUI } from "@mariozechner/pi-tui";
-import { Text, truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+import type { ExtensionAPI, ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
+import type { OverlayHandle, TUI } from "@earendil-works/pi-tui";
+import { Text, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { type Static, Type } from "@sinclair/typebox";
 
 type TodoStatus = "pending" | "in_progress" | "completed";
@@ -25,7 +24,7 @@ type TodoOverlayRecord = {
 	close?: () => void;
 };
 
-const StatusEnum = StringEnum(["pending", "in_progress", "completed"] as const, {
+const StatusEnum = Type.Union([Type.Literal("pending"), Type.Literal("in_progress"), Type.Literal("completed")], {
 	description: "작업 상태",
 });
 
@@ -53,6 +52,7 @@ const todoStateStore = new Map<string, TodoState>();
 const todoOverlayStore = new Map<string, TodoOverlayRecord>();
 const todoOverlayMetaStore = new Map<string, { completedAt?: number; completedTurn?: number }>();
 const todoOverlayAgentRunningStore = new Map<string, boolean>();
+const todoOverlayHiddenStore = new Map<string, boolean>();
 const todoTurnStore = new Map<string, number>();
 const TODO_SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"] as const;
 const TODO_SPINNER_INTERVAL_MS = 120;
@@ -327,6 +327,23 @@ function setTodoOverlayAgentRunning(ctx: Pick<ExtensionContext, "cwd" | "session
 	todoOverlayAgentRunningStore.set(key, running);
 }
 
+export type TodoOverlayCommandAction = "show" | "hide" | "status" | "invalid";
+
+export function parseTodoOverlayCommand(args: string): TodoOverlayCommandAction {
+	const action = args.trim().toLowerCase();
+	if (action === "") return "status";
+	if (action === "show" || action === "hide") return action;
+	return "invalid";
+}
+
+function isTodoOverlayHidden(key: string): boolean {
+	return todoOverlayHiddenStore.get(key) ?? false;
+}
+
+function setTodoOverlayHidden(key: string, hidden: boolean): void {
+	todoOverlayHiddenStore.set(key, hidden);
+}
+
 function hideTodoOverlay(key: string): void {
 	const record = todoOverlayStore.get(key);
 	if (!record) return;
@@ -510,10 +527,47 @@ async function syncTodoOverlay(ctx: ExtensionContext, pi: Pick<ExtensionAPI, "ap
 		return;
 	}
 
+	if (isTodoOverlayHidden(key)) {
+		hideTodoOverlay(key);
+		return;
+	}
+
 	showOrUpdateTodoOverlay(ctx, key, state);
 }
 
 export default function todoWriteOverlayExtension(pi: ExtensionAPI): void {
+	pi.registerCommand("todo-overlay", {
+		description: "Show or hide the todo overlay. Usage: /todo-overlay show|hide",
+		getArgumentCompletions(prefix: string) {
+			const filtered = ["show", "hide"].filter((value) => value.startsWith(prefix.trim().toLowerCase()));
+			return filtered.length > 0 ? filtered.map((value) => ({ value, label: value })) : null;
+		},
+		async handler(args, ctx) {
+			const key = getTodoStateKey(ctx);
+			const action = parseTodoOverlayCommand(args);
+
+			if (action === "invalid") {
+				ctx.ui.notify("사용법: /todo-overlay show 또는 /todo-overlay hide", "warning");
+				return;
+			}
+
+			if (action === "status") {
+				ctx.ui.notify(`todo overlay: ${isTodoOverlayHidden(key) ? "hidden" : "shown"}`, "info");
+				return;
+			}
+
+			setTodoOverlayHidden(key, action === "hide");
+			if (action === "hide") {
+				hideTodoOverlay(key);
+				ctx.ui.notify("todo overlay를 숨겼습니다. /todo-overlay show로 다시 표시할 수 있습니다.", "info");
+				return;
+			}
+
+			await syncTodoOverlay(ctx, pi);
+			ctx.ui.notify("todo overlay를 표시합니다.", "info");
+		},
+	});
+
 	pi.registerTool({
 		name: "todo_write",
 		label: "할 일 관리",
@@ -642,6 +696,7 @@ export default function todoWriteOverlayExtension(pi: ExtensionAPI): void {
 		hideTodoOverlay(key);
 		todoOverlayMetaStore.delete(key);
 		todoOverlayAgentRunningStore.delete(key);
+		todoOverlayHiddenStore.delete(key);
 		todoTurnStore.delete(key);
 	});
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryan_nookpi/pi-extension-todo-write-overlay",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Top-right overlay todo_write tool extension for pi.",
   "license": "MIT",
   "repository": {
@@ -28,9 +28,9 @@
     ]
   },
   "peerDependencies": {
-    "@mariozechner/pi-ai": "*",
-    "@mariozechner/pi-coding-agent": "*",
-    "@mariozechner/pi-tui": "*",
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
     "@sinclair/typebox": "*"
   },
   "publishConfig": {