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

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

@@ -53,6 +53,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 +328,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 +528,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 +697,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.1.2",
   "description": "Top-right overlay todo_write tool extension for pi.",
   "license": "MIT",
   "repository": {