@janvitos/pi-plan-build 0.1.36 → 0.1.38

package/README.md

@@ -91,7 +91,7 @@ Both actions leave Plan mode active, stop the agent, and wait for the next user
 
 When Pi uses `"tuiMode": "fullscreen"` and the saved plan contains top-level `- [ ]` items under `## Implementation Steps`, `plan_exit` offers the additional **Implement step by step** approval action. This is opt-in per plan; it does not replace either one-shot implementation option or **Stay in Plan mode**.
 
-The passive 64-column right panel reserves terminal columns, so the transcript and editor reflow instead of being covered. Long step instructions wrap across aligned continuation rows rather than being clipped. It never accepts focus or keyboard input and collapses below 132 terminal columns. The panel is a visual status aid only; all control happens through ordinary prompts. The agent interprets intent contextually, so these are examples rather than required commands:
+The passive 64-column right panel reserves terminal columns, so the transcript and editor reflow instead of being covered. Long step instructions and panel guidance wrap instead of being clipped. It never accepts focus or keyboard input and collapses below 132 terminal columns. The panel is a visual status aid only; all control happens through ordinary prompts. Its guidance remains visible, and the main transcript says, “Awaiting your instructions.” The agent interprets intent contextually, so these are examples rather than required commands:
 
 - “Implement the next step,” “Start step 2,” or simply “Approved” / “Go ahead.”
 - “Step 1 is complete,” “I verified that one,” or “I already handled this.”

package/index.ts

@@ -53,6 +53,7 @@ import {
 	PLAN_EXIT_FRESH_CHOICE,
 	PLAN_EXIT_STAY_ACKNOWLEDGEMENT,
 	PLAN_EXIT_STAY_CHOICE,
+	PLAN_STEP_READY_ACKNOWLEDGEMENT,
 	renderModeComposer,
 	type Mode,
 	unique,
@@ -64,6 +65,7 @@ const PLAN_REVIEW_ENTRY_TYPE = "pi-plan-build-review";
 const LEGACY_PLAN_REVIEW_ENTRY_TYPE = "opencode-plan-review";
 const MODE_NOTICE_ENTRY_TYPE = "pi-plan-build-notice";
 const LEGACY_MODE_NOTICE_ENTRY_TYPE = "opencode-mode-notice";
+const PLAN_STEP_GUIDANCE_ENTRY_TYPE = "pi-plan-build-step-guidance";
 const STATUS_KEY = "pi-plan-build-mode";
 const PLAN_STEP_CHOICE = "Implement step by step";
 const PANEL_WIDTH = 64;
@@ -119,10 +121,13 @@ export default function planBuildModes(pi: ExtensionAPI): void {
 		const message = typeof entry.data?.message === "string" ? entry.data.message : "Plan mode unchanged.";
 		return new Text(theme.fg("warning", message), 0, 0);
 	};
+	const renderPlanStepGuidance: EntryRenderer = (_entry, _options, theme) =>
+		new Text(theme.fg("success", PLAN_STEP_READY_ACKNOWLEDGEMENT), 0, 0);
 	pi.registerEntryRenderer<{ plan: string }>(PLAN_REVIEW_ENTRY_TYPE, renderPlanReview);
 	pi.registerEntryRenderer<{ plan: string }>(LEGACY_PLAN_REVIEW_ENTRY_TYPE, renderPlanReview);
 	pi.registerEntryRenderer<{ message: string }>(MODE_NOTICE_ENTRY_TYPE, renderModeNotice);
 	pi.registerEntryRenderer<{ message: string }>(LEGACY_MODE_NOTICE_ENTRY_TYPE, renderModeNotice);
+	pi.registerEntryRenderer(PLAN_STEP_GUIDANCE_ENTRY_TYPE, renderPlanStepGuidance);
 
 	function stateData(): StoredState {
 		return { version: 1, selectedMode, pendingReminder, toolsBeforeModes, ...(execution ? { execution } : {}) };
@@ -527,8 +532,8 @@ export default function planBuildModes(pi: ExtensionAPI): void {
 			}
 			const choices = [
 				PLAN_EXIT_APPROVE_CHOICE,
-				...(stepExecution ? [PLAN_STEP_CHOICE] : []),
 				PLAN_EXIT_FRESH_CHOICE,
+				...(stepExecution ? [PLAN_STEP_CHOICE] : []),
 				PLAN_EXIT_STAY_CHOICE,
 			];
 			const selection = normalizePlanExitChoice(await ctx.ui.select(
@@ -541,6 +546,7 @@ export default function planBuildModes(pi: ExtensionAPI): void {
 				await selectMode("build", ctx, "tool");
 				updateExecution(stepExecution);
 				ensurePanelLayout();
+				pi.appendEntry(PLAN_STEP_GUIDANCE_ENTRY_TYPE);
 				return {
 					content: [{ type: "text", text: "Step-by-step execution is ready. Stop now and wait for the user's natural-language instruction in the composer; the plan panel is visual-only." }],
 					details: { approved: true, action: "step-by-step", mode: "build", planPath },
@@ -588,7 +594,7 @@ export default function planBuildModes(pi: ExtensionAPI): void {
 		renderResult(result, _options, theme, context) {
 			const details = result.details as { approved?: boolean; action?: string } | undefined;
 			if (details?.action === "step-by-step" && !context.isError) {
-				return new Text(theme.fg("success", "Step-by-step execution ready — waiting for your instruction."), 0, 0);
+				return new Text(theme.fg("success", "Step-by-step execution ready"), 0, 0);
 			}
 			if (details?.action === "implement-fresh" && !context.isError) {
 				return new Text(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@janvitos/pi-plan-build",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "description": "Plan safely, approve explicitly, then implement here or in a clean session.",
   "type": "module",
   "license": "MIT",

package/plan-panel.ts

@@ -34,6 +34,9 @@ export class PlanPanel implements Component {
 			const clipped = truncateToWidth(content, contentWidth, "");
 			return `${border("│")} ${clipped}${" ".repeat(Math.max(0, contentWidth - visibleWidth(clipped)))} ${border("│")}`;
 		};
+		const pushWrapped = (lines: string[], content: string) => {
+			for (const line of wrapTextWithAnsi(content, contentWidth)) lines.push(pad(line));
+		};
 		const done = this.state.steps.filter((step) => step.status === "completed" || step.status === "skipped").length;
 		const status = this.state.status === "completed" ? "complete" : this.state.status;
 		const currentIndex = this.state.steps.findIndex((step) => step.id === this.state.selectedStepId);
@@ -65,8 +68,8 @@ export class PlanPanel implements Component {
 		}
 		lines.push(border(`├${"─".repeat(inner)}┤`));
 		if (this.state.status === "completed") lines.push(pad(this.theme.fg("success", "Plan complete")));
-		else if (this.state.status === "paused") lines.push(pad("Tell the agent to resume, cancel, or hide the plan."));
-		else if (current?.status === "ready") lines.push(pad("Tell the agent to implement, complete, edit, skip, cancel, or hide this step."));
+		else if (this.state.status === "paused") pushWrapped(lines, "Tell the agent to resume, cancel, or hide the plan.");
+		else if (current?.status === "ready") pushWrapped(lines, "Tell the agent to implement, complete, edit, or skip steps. You can also cancel or hide the plan.");
 		lines.push(border(`╰${"─".repeat(inner)}╯`));
 		return lines.map((line) => truncateToWidth(line, safeWidth, ""));
 	}

package/utils.ts

@@ -136,6 +136,7 @@ export const PLAN_EXIT_FRESH_CHOICE = "Start fresh and implement";
 export const PLAN_EXIT_STAY_CHOICE = "Stay in Plan mode";
 export const PLAN_EXIT_STAY_ACKNOWLEDGEMENT =
 	"Staying in Plan mode. Let me know when you’re ready to revise or implement the plan.";
+export const PLAN_STEP_READY_ACKNOWLEDGEMENT = "Awaiting your instructions.";
 
 export type PlanExitDecision = "implement-here" | "implement-fresh" | "stay";