@janvitos/pi-plan-build 0.1.25 → 0.1.27

package/README.md

@@ -19,13 +19,13 @@ A global [Pi coding agent](https://github.com/badlogic/pi-mono) extension that a
   - **Switch to Build and implement here**
   - **Start fresh and implement**
   - **Stay in Plan mode**
-- Staying in Plan mode produces a durable acknowledgement and stops the run until the user responds.
+- Staying in Plan mode—or pressing Escape in the approval dialog—produces a durable acknowledgement and stops the run until the user responds.
 - Mode state survives reloads, resumes, and forks.
 - When Pi recreates the custom editor, the latest 100 user prompts from the active session branch are restored for Up/Down history navigation.
 
 ## Requirements
 
-- Pi `0.84.1` or newer
+- Pi `0.84.2` or newer
 - Node.js `22.6` or newer for the test command
 - TUI or RPC UI support for interactive questions and approval dialogs
 
@@ -62,7 +62,7 @@ Do not install more than one npm, Git, or local copy at the same time; duplicate
 | `/plan` | Select Plan mode |
 | `/build` | Select Build mode |
 | `pi --plan` | Start a new session in Plan mode |
-| `/build-fresh` | Confirm a pending clean-session implementation |
+| `/build-fresh` | Start a pending clean-session implementation manually |
 
 The agent may also enter Plan mode with `plan_enter` when planning or investigation is safer than immediate execution.
 
@@ -71,16 +71,16 @@ The agent may also enter Plan mode with `plan_enter` when planning or investigat
 When planning is complete, `plan_exit` displays the entire persisted plan and asks whether to:
 
 1. implement in the current session;
-2. prepare a clean linked implementation session; or
+2. start a clean linked implementation session; or
 3. stay in Plan mode.
 
-Selecting **Start fresh and implement** stops the current run and pre-fills `/build-fresh`. Press Enter to confirm. Pi only exposes session creation to user-invoked command contexts, so this confirmation is required. The command creates a linked child session, copies the approved plan to its canonical plan file, switches it to Build, and starts implementation without transferring the planning conversation.
+Selecting **Start fresh and implement** stops the current run and automatically dispatches `/build-fresh`. Pi 0.84.2 or newer is required for extension command dispatch from an injected user message. The command creates a linked child session, copies the approved plan to its canonical plan file, switches it to Build, and starts implementation without transferring the planning conversation.
 
-Selecting **Stay in Plan mode** displays:
+Selecting **Stay in Plan mode**, or pressing Escape while the approval dialog is open, displays:
 
 > Staying in Plan mode. Let me know when you’re ready to revise or implement the plan.
 
-The agent then stops and waits for the next user message.
+Both actions leave Plan mode active, stop the agent, and wait for the next user message.
 
 ## Plan-mode permissions
 

package/index.ts

@@ -29,6 +29,7 @@ import {
 	makePlanPath,
 	nextMode,
 	nextThinkingLevel,
+	normalizePlanExitChoice,
 	PLAN_EXIT_APPROVE_CHOICE,
 	PLAN_EXIT_FRESH_CHOICE,
 	PLAN_EXIT_STAY_ACKNOWLEDGEMENT,
@@ -289,19 +290,22 @@ export default function planBuildModes(pi: ExtensionAPI): void {
 			if (!plan.trim()) throw new Error("Cannot request plan approval because the plan file is empty");
 			pi.appendEntry(PLAN_REVIEW_ENTRY_TYPE, { plan, planPath });
 			const displayPath = shorten(planPath, ctx.cwd);
-			const choice = await ctx.ui.select(
+			const selection = normalizePlanExitChoice(await ctx.ui.select(
 				`Build Agent: Plan at ${displayPath} is complete. What would you like to do?`,
 				[PLAN_EXIT_APPROVE_CHOICE, PLAN_EXIT_FRESH_CHOICE, PLAN_EXIT_STAY_CHOICE],
-			);
-			const decision = classifyPlanExitChoice(choice);
+			));
+			const decision = classifyPlanExitChoice(selection.choice);
 			if (decision === "stay") {
 				freshImplementationPlan = undefined;
 				pi.appendEntry(MODE_NOTICE_ENTRY_TYPE, { message: PLAN_EXIT_STAY_ACKNOWLEDGEMENT });
-				return buildPlanExitStayResult(planPath, choice === undefined);
+				return buildPlanExitStayResult(planPath, selection.cancelled);
 			}
 			if (decision === "implement-fresh") {
 				freshImplementationPlan = plan;
-				ctx.ui.setEditorText("/build-fresh");
+				pi.sendUserMessage("/build-fresh", {
+					deliverAs: "followUp",
+					expandPromptTemplates: true,
+				});
 				return buildPlanExitFreshResult(planPath);
 			}
 			freshImplementationPlan = undefined;
@@ -323,7 +327,7 @@ export default function planBuildModes(pi: ExtensionAPI): void {
 			const details = result.details as { approved?: boolean; action?: string } | undefined;
 			if (details?.action === "implement-fresh" && !context.isError) {
 				return new Text(
-					theme.fg("success", "Clean-session implementation selected — press Enter to run /build-fresh."),
+					theme.fg("success", "Clean-session implementation selected — starting automatically."),
 					0,
 					0,
 				);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@janvitos/pi-plan-build",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "description": "Plan safely, approve explicitly, then implement here or in a clean session.",
   "type": "module",
   "license": "MIT",
@@ -33,7 +33,7 @@
     "prepublishOnly": "npm test"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-coding-agent": ">=0.84.2",
     "@earendil-works/pi-tui": "*",
     "typebox": "*"
   },

package/utils.ts

@@ -139,7 +139,19 @@ export const PLAN_EXIT_STAY_ACKNOWLEDGEMENT =
 
 export type PlanExitDecision = "implement-here" | "implement-fresh" | "stay";
 
-export function classifyPlanExitChoice(choice: string | undefined): PlanExitDecision {
+export interface NormalizedPlanExitChoice {
+	choice: string;
+	cancelled: boolean;
+}
+
+export function normalizePlanExitChoice(choice: string | undefined): NormalizedPlanExitChoice {
+	return {
+		choice: choice ?? PLAN_EXIT_STAY_CHOICE,
+		cancelled: choice === undefined,
+	};
+}
+
+export function classifyPlanExitChoice(choice: string): PlanExitDecision {
 	if (choice === PLAN_EXIT_APPROVE_CHOICE) return "implement-here";
 	if (choice === PLAN_EXIT_FRESH_CHOICE) return "implement-fresh";
 	return "stay";
@@ -154,7 +166,7 @@ export function buildPlanExitFreshResult(planPath: string) {
 		content: [
 			{
 				type: "text" as const,
-				text: "The user selected clean-session implementation. Stop now; the /build-fresh command has been prepared for the user to submit.",
+				text: "The user selected clean-session implementation. Stop now; /build-fresh is starting automatically.",
 			},
 		],
 		details: { approved: true, action: "implement-fresh" as const, mode: "plan" as const, planPath },