pi-better-harness 0.3.5 → 0.3.6

package/node_modules/pi-better-plan/README.md

@@ -7,6 +7,7 @@
 - Gives models `update_plan` and `get_plan` tools for atomic, explicit progress updates.
 - Shows the complete checklist of completed, active, pending, and blocked steps above the editor.
 - Persists plan state and display preferences on the active Pi session branch.
+- Keeps a completed plan visible for 30 seconds, then clears it automatically.
 - Opens the complete plan with `/plan`.
 
 Plan progress is checklist progress, not an estimate of effort. The extension never infers completion from prose or successful tool calls.

package/node_modules/pi-better-plan/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-better-plan",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Structured execution plans with persistent progress for Pi.",
   "license": "MIT",
   "type": "module",
@@ -70,4 +70,4 @@
   "engines": {
     "node": ">=22.0.0"
   }
-}
+}

package/node_modules/pi-better-plan/src/index.ts

@@ -4,6 +4,7 @@ import { Text } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
 
 import {
+  completedPlanClearDelay,
   planClearEntry,
   planDisplayEntry,
   planProgress,
@@ -42,21 +43,53 @@ export default function planExtension(pi: ExtensionAPI): void {
   let currentPlan: PlanSnapshot | null = null;
   let displayMode: PlanDisplayMode = "auto";
   let refreshWidget: ((force?: boolean) => void) | undefined;
+  let completedPlanClearTimer: ReturnType<typeof setTimeout> | undefined;
 
   const refresh = (force = false): void => refreshWidget?.(force);
 
+  const cancelCompletedPlanClear = (): void => {
+    if (completedPlanClearTimer) clearTimeout(completedPlanClearTimer);
+    completedPlanClearTimer = undefined;
+  };
+
+  const clearPlan = (): void => {
+    cancelCompletedPlanClear();
+    currentPlan = null;
+    pi.appendEntry(EXTENSION_NAME, planClearEntry());
+    refresh(true);
+  };
+
+  const scheduleCompletedPlanClear = (): void => {
+    cancelCompletedPlanClear();
+    if (!currentPlan) return;
+    const delay = completedPlanClearDelay(currentPlan);
+    if (delay === null) return;
+    const completedPlan = currentPlan;
+    const timer = setTimeout(() => {
+      if (completedPlanClearTimer !== timer) return;
+      completedPlanClearTimer = undefined;
+      if (currentPlan?.planId !== completedPlan.planId || currentPlan.revision !== completedPlan.revision) return;
+      clearPlan();
+    }, delay);
+    completedPlanClearTimer = timer;
+    timer.unref?.();
+  };
+
   const restore = (ctx: ExtensionContext): void => {
+    cancelCompletedPlanClear();
     const state = reconstructPlanState(ctx.sessionManager.getBranch());
     currentPlan = state.plan;
     displayMode = state.displayMode;
     if (ctx.hasUI) ctx.ui.setStatus(LEGACY_PLAN_NAV_STATUS_KEY, undefined);
     refresh(true);
+    scheduleCompletedPlanClear();
   };
 
   const persistPlan = (plan: PlanSnapshot): void => {
     currentPlan = plan;
     pi.appendEntry(EXTENSION_NAME, planSetEntry(plan));
     refresh(true);
+    scheduleCompletedPlanClear();
   };
 
   const setDisplayMode = (mode: PlanDisplayMode): void => {
@@ -171,9 +204,7 @@ export default function planExtension(pi: ExtensionAPI): void {
       const input = args.trim().toLowerCase();
       if (!input) return showFullPlan(ctx);
       if (input === "clear") {
-        currentPlan = null;
-        pi.appendEntry(EXTENSION_NAME, planClearEntry());
-        refresh(true);
+        clearPlan();
         ctx.ui.notify("Plan cleared.", "info");
         return;
       }
@@ -209,6 +240,7 @@ export default function planExtension(pi: ExtensionAPI): void {
     };
   });
   pi.on("session_shutdown", async (_event, ctx) => {
+    cancelCompletedPlanClear();
     refreshWidget = undefined;
     try {
       ctx.ui.setStatus(LEGACY_PLAN_NAV_STATUS_KEY, undefined);

package/node_modules/pi-better-plan/src/plan-state.ts

@@ -4,6 +4,7 @@ import { EXTENSION_NAME } from "./types.js";
 const MAX_STEPS = 50;
 const MAX_STEP_CHARS = 500;
 const MAX_EXPLANATION_CHARS = 2_000;
+export const COMPLETED_PLAN_RETENTION_MS = 30_000;
 
 interface SessionEntryLike {
   type: string;
@@ -54,6 +55,7 @@ export function replacePlan(
   steps: readonly PlanStepInput[],
   explanation?: string,
   now = nowSeconds(),
+  completedAtMs = Date.now(),
 ): PlanSnapshot {
   const error = validatePlanInput(steps, explanation);
   if (error) throw new Error(error);
@@ -68,6 +70,8 @@ export function replacePlan(
       status: item.status,
     };
   });
+  const isComplete = normalizedSteps.every((item) => item.status === "completed");
+  const currentIsComplete = current?.steps.every((item) => item.status === "completed") === true;
 
   return {
     version: 1,
@@ -77,9 +81,18 @@ export function replacePlan(
     steps: normalizedSteps,
     createdAt: current?.createdAt ?? now,
     updatedAt: now,
+    ...(isComplete
+      ? { completedAtMs: currentIsComplete ? current.completedAtMs ?? current.updatedAt * 1_000 : completedAtMs }
+      : {}),
   };
 }
 
+export function completedPlanClearDelay(plan: PlanSnapshot, now = Date.now()): number | null {
+  if (planProgress(plan).state !== "complete") return null;
+  const completedAtMs = plan.completedAtMs ?? plan.updatedAt * 1_000;
+  return Math.max(0, completedAtMs + COMPLETED_PLAN_RETENTION_MS - now);
+}
+
 export function planProgress(plan: PlanSnapshot): PlanProgress {
   const completed = plan.steps.filter((item) => item.status === "completed").length;
   const pending = plan.steps.filter((item) => item.status === "pending").length;
@@ -149,6 +162,7 @@ function isPlanSnapshot(value: unknown): value is PlanSnapshot {
     typeof candidate.revision === "number" &&
     Array.isArray(candidate.steps) &&
     typeof candidate.createdAt === "number" &&
-    typeof candidate.updatedAt === "number"
+    typeof candidate.updatedAt === "number" &&
+    (candidate.completedAtMs === undefined || typeof candidate.completedAtMs === "number")
   );
 }

package/node_modules/pi-better-plan/src/types.ts

@@ -20,6 +20,7 @@ export interface PlanSnapshot {
   steps: PlanStep[];
   createdAt: number;
   updatedAt: number;
+  completedAtMs?: number;
 }
 
 export interface PlanProgress {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-better-harness",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "Pi extension bundle for a write sandbox, subagents, background tasks, SSH, goals, and structured plans.",
   "license": "MIT",
   "type": "module",
@@ -52,7 +52,7 @@
   "dependencies": {
     "pi-better-background-tasks": "0.2.11",
     "pi-better-goal": "0.2.1",
-    "pi-better-plan": "0.1.3",
+    "pi-better-plan": "0.1.4",
     "pi-better-sandbox": "0.3.0",
     "pi-better-ssh": "0.1.1",
     "pi-better-subagents": "0.1.26"