@mblarsen/pi-task-ui 0.1.0 → 0.2.0

package/README.md

@@ -63,6 +63,19 @@ Parents are independently executable. Their status and progress are not derived
 
 The bundled `task-ui` Agent Skill teaches the agent when to create task sets, mirror backend transitions, maintain execution telemetry, and avoid fabricating state. Invoke it explicitly with `/skill:task-ui` or let Pi load it when the request matches its description.
 
+## Checkpoint reminders
+
+The extension sends a hidden context reminder after these successful tool calls:
+
+- a Bash command that invokes `git commit`
+- `link_send`
+
+The reminder runs only when the projection contains an active or pending task. It asks the agent to reconcile task status, progress, and execution state before work continues. It also asks the agent to report task-ui changes in the next natural status update without interrupting the current work.
+
+The extension sends at most one reminder per agent turn. A compound Bash command must succeed as a whole. For example, `git commit && git push` does not trigger a reminder when the push fails.
+
+The reminder is hidden from the transcript, but it remains part of the agent context. Task state remains in TUI-only session entries and does not enter the agent context.
+
 ### Execution telemetry
 
 Create and update operations accept:

package/index.ts

@@ -53,6 +53,31 @@ type SnapshotEvent = { tasks: ExternalTaskInput[]; focusedTaskId?: string };
 type RemoveEvent = { taskId: string };
 type OutputEvent = { taskId: string; text: string };
 type FocusEvent = { taskId?: string };
+type TaskUiCheckpoint = "git commit" | "link_send";
+type ToolResultCheckpointInput = { toolName: string; input: unknown; isError: boolean };
+
+const GIT_COMMIT_COMMAND = /(?:^|(?:&&|\|\||[;()\n])\s*)git(?:\s+-C\s+(?:"[^"]*"|'[^']*'|[^\s;&|()]+))?\s+commit(?=$|[\s;&|()])/;
+
+export function checkpointForToolResult(event: ToolResultCheckpointInput): TaskUiCheckpoint | undefined {
+	if (event.isError !== false) return undefined;
+	if (event.toolName === "link_send") return "link_send";
+	if (event.toolName !== "bash" || typeof event.input !== "object" || event.input === null) return undefined;
+	const command = (event.input as { command?: unknown }).command;
+	return typeof command === "string" && GIT_COMMIT_COMMAND.test(command) ? "git commit" : undefined;
+}
+
+function checkpointReminder(trigger: TaskUiCheckpoint): string {
+	return `Task UI checkpoint: A successful ${trigger} just occurred.
+
+Before continuing, reconcile task-ui with the actual work state:
+- update affected task statuses, progress, and execution state;
+- add newly discovered work only when it is meaningful;
+- do not mark a task complete merely because this checkpoint succeeded.
+
+If task-ui is already accurate, make no changes.
+
+If you change task-ui, mention the update in your next natural user-facing status message. Do not interrupt, pause, or redirect the current work solely to report it; resume the ongoing work immediately.`;
+}
 
 type AgentTaskInput = {
 	id?: string;
@@ -272,6 +297,7 @@ function taskLine(
 	const content = `${indent}${glyph} ${taskLabel}`;
 	if (task.status === "failed") return theme.fg("error", content);
 	if (task.status === "pending") return theme.fg("muted", content);
+	if (task.status === "stopped") return theme.fg("dim", content);
 	return focused ? theme.bold(content) : content;
 }
 
@@ -333,7 +359,7 @@ export class TaskBarComponent {
 						task.label,
 						width,
 						this.theme,
-						task.status === "completed",
+						task.status === "completed" || task.status === "stopped",
 					));
 				}
 			}
@@ -371,6 +397,7 @@ export default function taskUiExtension(pi: ExtensionAPI): void {
 	let sessionActive = false;
 	let spinnerFrame = 0;
 	let animationTimer: ReturnType<typeof setInterval> | undefined;
+	let checkpointReminderQueued = false;
 
 	const stopAnimation = () => {
 		if (animationTimer) clearInterval(animationTimer);
@@ -688,9 +715,36 @@ export default function taskUiExtension(pi: ExtensionAPI): void {
 		handler: async (_args, ctx) => toggleOverlay(ctx),
 	});
 
+	pi.on("tool_result", async (event, ctx) => {
+		const checkpoint = checkpointForToolResult(event);
+		const hasUnfinishedTasks = state.tasks.some((task) => task.status === "pending" || task.status === "in_progress");
+		if (!checkpoint || !hasUnfinishedTasks || checkpointReminderQueued) return;
+
+		checkpointReminderQueued = true;
+		try {
+			pi.sendMessage({
+				customType: "task-ui-checkpoint-reminder",
+				content: checkpointReminder(checkpoint),
+				display: false,
+				details: { checkpoint, timestamp: Date.now() },
+			}, { deliverAs: "steer" });
+		} catch (error) {
+			checkpointReminderQueued = false;
+			if (ctx.hasUI) {
+				const message = error instanceof Error ? error.message : String(error);
+				ctx.ui.notify(`Task UI checkpoint reminder failed: ${message}`, "warning");
+			}
+		}
+	});
+
+	pi.on("turn_start", async () => {
+		checkpointReminderQueued = false;
+	});
+
 	pi.on("session_start", async (_event, ctx) => {
 		currentCtx = ctx;
 		sessionActive = true;
+		checkpointReminderQueued = false;
 		state = createInitialTaskUiState();
 		for (const entry of ctx.sessionManager.getBranch()) {
 			if (entry.type !== "custom" || entry.customType !== STATE_ENTRY_TYPE) continue;
@@ -705,6 +759,7 @@ export default function taskUiExtension(pi: ExtensionAPI): void {
 	});
 
 	pi.on("session_tree", async (_event, ctx) => {
+		checkpointReminderQueued = false;
 		state = createInitialTaskUiState();
 		for (const entry of ctx.sessionManager.getBranch()) {
 			if (entry.type !== "custom" || entry.customType !== STATE_ENTRY_TYPE) continue;
@@ -717,6 +772,7 @@ export default function taskUiExtension(pi: ExtensionAPI): void {
 
 	pi.on("session_shutdown", async () => {
 		sessionActive = false;
+		checkpointReminderQueued = false;
 		currentCtx = undefined;
 		stopAnimation();
 		overlayHandle?.hide();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mblarsen/pi-task-ui",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Backend-neutral task sidebar and agent tools for Pi.",
   "license": "MIT",
   "type": "module",

package/skill/SKILL.md

@@ -87,6 +87,21 @@ When the worker stops running but the task remains unfinished, set `executing: f
 
 Spawning a sub-agent does not automatically update task-ui. The coordinating agent must call the backend tool and the matching `task_ui_update` separately.
 
+## Checkpoint reminders
+
+The extension can send a hidden task-ui checkpoint reminder after a successful `git commit` or `link_send` tool call.
+
+When you receive this reminder:
+
+1. Compare the projection with the actual work state.
+2. Update affected task status, progress, and execution state.
+3. Add newly discovered work only when it is meaningful.
+4. Do not mark work complete only because the checkpoint succeeded.
+5. If you change task-ui, mention the change in your next natural status update.
+6. Resume the current work without waiting for confirmation.
+
+If the projection is accurate, do not change it.
+
 ## Finish or interrupt work
 
 After successful completion, call `task_ui_update` with `status: "completed"`, `executing: false`, and `progress: 100`.