@narumitw/pi-plan-mode 0.27.0 → 0.31.0

package/README.md

@@ -180,7 +180,8 @@ This extension maps Codex's `ModeKind::Plan` behavior onto Pi's extension API:
 ```txt
 extensions/pi-plan-mode/
 ├── src/
-│   ├── plan-mode.ts  # Pi entrypoint and mode state
+│   ├── index.ts      # Pi package entrypoint
+│   ├── plan-mode.ts  # Extension registration and mode state
 │   └── *.ts          # Package-local prompt, policy, question, and message modules
 ├── README.md
 ├── LICENSE
@@ -188,12 +189,12 @@ extensions/pi-plan-mode/
 └── package.json
 ```
 
-Only `plan-mode.ts` is a Pi entrypoint; the other source modules are internal. The package exposes its Pi extension through `package.json`:
+`index.ts` is the Pi entrypoint and forwards to `plan-mode.ts`; the other source modules are internal. The package exposes its Pi extension through `package.json`:
 
 ```json
 {
   "pi": {
-    "extensions": ["./src/plan-mode.ts"]
+    "extensions": ["./src/index.ts"]
   }
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@narumitw/pi-plan-mode",
-	"version": "0.27.0",
+	"version": "0.31.0",
 	"description": "Pi extension that adds a Codex-like read-only /plan collaboration mode.",
 	"type": "module",
 	"license": "MIT",
@@ -19,7 +19,7 @@
 	],
 	"pi": {
 		"extensions": [
-			"./src/plan-mode.ts"
+			"./src/index.ts"
 		]
 	},
 	"scripts": {
@@ -28,8 +28,8 @@
 		"typecheck": "tsc --noEmit"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "2.5.3",
-		"@earendil-works/pi-coding-agent": "0.80.10",
+		"@biomejs/biome": "2.5.5",
+		"@earendil-works/pi-coding-agent": "0.82.1",
 		"typescript": "7.0.2"
 	},
 	"repository": {

package/src/completion-tool.ts

@@ -22,9 +22,7 @@ export const PLAN_MODE_COMPLETE_PARAMS = {
 	},
 } as const;
 
-type NormalizePlanModeCompletionResult =
-	| { ok: true; plan: string }
-	| { ok: false; error: string };
+type NormalizePlanModeCompletionResult = { ok: true; plan: string } | { ok: false; error: string };
 
 export function normalizePlanModeCompletion(input: unknown): NormalizePlanModeCompletionResult {
 	if (!isRecord(input) || typeof input.plan !== "string") {

package/src/index.ts

@@ -0,0 +1 @@
+export { default } from "./plan-mode.js";

package/src/question-tool.ts

@@ -23,7 +23,11 @@ type PlanModeQuestionAnswer = {
 	optionIndex?: number;
 };
 
-type PlanModeQuestionReason = "cancelled" | "ui_unavailable" | "plan_mode_inactive" | "invalid_input";
+type PlanModeQuestionReason =
+	| "cancelled"
+	| "ui_unavailable"
+	| "plan_mode_inactive"
+	| "invalid_input";
 
 type PlanModeQuestionDetails = {
 	cancelled: boolean;
@@ -47,8 +51,14 @@ export const PLAN_MODE_QUESTION_PARAMS = {
 				additionalProperties: false,
 				required: ["id", "header", "question", "options"],
 				properties: {
-					id: { type: "string", description: "Stable identifier for mapping answers (snake_case)." },
-					header: { type: "string", description: "Short header label shown in the UI (12 or fewer chars)." },
+					id: {
+						type: "string",
+						description: "Stable identifier for mapping answers (snake_case).",
+					},
+					header: {
+						type: "string",
+						description: "Short header label shown in the UI (12 or fewer chars).",
+					},
 					question: { type: "string", description: "Single-sentence prompt shown to the user." },
 					options: {
 						type: "array",
@@ -79,7 +89,9 @@ type NormalizePlanModeQuestionParamsResult =
 	| { ok: true; questions: PlanModeQuestion[] }
 	| { ok: false; error: string };
 
-export function normalizePlanModeQuestionParams(input: unknown): NormalizePlanModeQuestionParamsResult {
+export function normalizePlanModeQuestionParams(
+	input: unknown,
+): NormalizePlanModeQuestionParamsResult {
 	if (!isRecord(input) || !Array.isArray(input.questions)) {
 		return { ok: false, error: "questions must be an array" };
 	}
@@ -96,7 +108,10 @@ export function normalizePlanModeQuestionParams(input: unknown): NormalizePlanMo
 		const header = stringField(rawQuestion.header);
 		const question = stringField(rawQuestion.question);
 		if (!id || !header || !question) {
-			return { ok: false, error: `question ${questionIndex + 1} requires non-empty id, header, and question` };
+			return {
+				ok: false,
+				error: `question ${questionIndex + 1} requires non-empty id, header, and question`,
+			};
 		}
 		if (!Array.isArray(rawQuestion.options)) {
 			return { ok: false, error: `question ${questionIndex + 1} options must be an array` };
@@ -114,7 +129,10 @@ export function normalizePlanModeQuestionParams(input: unknown): NormalizePlanMo
 			}
 			const label = stringField(rawOption.label);
 			if (!label) {
-				return { ok: false, error: `question ${questionIndex + 1} option ${optionIndex + 1} requires a label` };
+				return {
+					ok: false,
+					error: `question ${questionIndex + 1} option ${optionIndex + 1} requires a label`,
+				};
 			}
 			const description = stringField(rawOption.description);
 			if (!description) {
@@ -138,7 +156,10 @@ export async function askPlanModeQuestions(
 	for (const question of questions) {
 		const choices = question.options.map(formatPlanModeQuestionChoice);
 		const otherChoice = `${question.options.length + 1}. Other (free-form)`;
-		const choice = await ctx.ui.select(`${question.header}: ${question.question}`, [...choices, otherChoice]);
+		const choice = await ctx.ui.select(`${question.header}: ${question.question}`, [
+			...choices,
+			otherChoice,
+		]);
 		if (!choice) return undefined;
 		if (choice === otherChoice) {
 			const customAnswer = (await ctx.ui.editor(question.question, ""))?.trim();
@@ -171,9 +192,14 @@ function formatPlanModeQuestionChoice(option: PlanModeQuestionOption, index: num
 	return `${index + 1}. ${option.label}${option.description ? ` — ${option.description}` : ""}`;
 }
 
-export function planModeQuestionAnswered(questions: PlanModeQuestion[], answers: PlanModeQuestionAnswer[]) {
+export function planModeQuestionAnswered(
+	questions: PlanModeQuestion[],
+	answers: PlanModeQuestionAnswer[],
+) {
 	return {
-		content: [{ type: "text" as const, text: formatPlanModeQuestionPayload({ cancelled: false, answers }) }],
+		content: [
+			{ type: "text" as const, text: formatPlanModeQuestionPayload({ cancelled: false, answers }) },
+		],
 		details: { cancelled: false, questions, answers } satisfies PlanModeQuestionDetails,
 	};
 }
@@ -184,7 +210,12 @@ export function planModeQuestionCancelled(
 	message: string,
 ) {
 	return {
-		content: [{ type: "text" as const, text: formatPlanModeQuestionPayload({ cancelled: true, reason, message }) }],
+		content: [
+			{
+				type: "text" as const,
+				text: formatPlanModeQuestionPayload({ cancelled: true, reason, message }),
+			},
+		],
 		details: { cancelled: true, reason, questions } satisfies PlanModeQuestionDetails,
 	};
 }

package/src/state.ts

@@ -1,16 +1,11 @@
 import {
-	PLAN_MODE_COMPLETE_TOOL_NAME,
 	normalizePlanModeCompletion,
+	PLAN_MODE_COMPLETE_TOOL_NAME,
 	planFromCompletionDetails,
 } from "./completion-tool.js";
-import {
-	PLAN_MODE_THINKING_LEVELS,
-	type PlanModeFixedThinkingLevel,
-} from "./settings.js";
+import { PLAN_MODE_THINKING_LEVELS, type PlanModeFixedThinkingLevel } from "./settings.js";
 
-export type PlanCompletionSource =
-	| typeof PLAN_MODE_COMPLETE_TOOL_NAME
-	| "legacy_proposed_plan";
+export type PlanCompletionSource = typeof PLAN_MODE_COMPLETE_TOOL_NAME | "legacy_proposed_plan";
 
 export interface PlanModeState {
 	enabled: boolean;
@@ -49,23 +44,19 @@ export function restorePlanModeState(entries: unknown[], stateEntryType: string)
 	if (!isRecord(entry?.data)) return { enabled: false, awaitingAction: false };
 
 	const enabled = entry.data.enabled === true;
-	const persistedSource = enabled
-		? planCompletionSource(entry.data.latestPlanSource)
-		: undefined;
+	const persistedSource = enabled ? planCompletionSource(entry.data.latestPlanSource) : undefined;
 	const persistedPlan = enabled
 		? normalizePersistedPlan(entry.data.latestPlan, persistedSource)
 		: undefined;
 	const recoveredPlan =
-		enabled && !persistedPlan
-			? latestCompletionPlan(branch.slice(stateEntryIndex + 1))
-			: undefined;
+		enabled && !persistedPlan ? latestCompletionPlan(branch.slice(stateEntryIndex + 1)) : undefined;
 	const latestPlan = persistedPlan ?? recoveredPlan;
 	return {
 		enabled,
 		latestPlan,
 		latestPlanSource: enabled
-			? (persistedPlan ? persistedSource : undefined) ??
-				(recoveredPlan ? PLAN_MODE_COMPLETE_TOOL_NAME : undefined)
+			? ((persistedPlan ? persistedSource : undefined) ??
+				(recoveredPlan ? PLAN_MODE_COMPLETE_TOOL_NAME : undefined))
 			: undefined,
 		awaitingAction: enabled && latestPlan !== undefined,
 		selectedToolNames: stringArray(entry.data.selectedToolNames),
@@ -73,12 +64,8 @@ export function restorePlanModeState(entries: unknown[], stateEntryType: string)
 		previousThinkingLevel: enabled
 			? fixedThinkingLevel(entry.data.previousThinkingLevel)
 			: undefined,
-		appliedThinkingLevel: enabled
-			? fixedThinkingLevel(entry.data.appliedThinkingLevel)
-			: undefined,
-		manualThinkingLevel: enabled
-			? fixedThinkingLevel(entry.data.manualThinkingLevel)
-			: undefined,
+		appliedThinkingLevel: enabled ? fixedThinkingLevel(entry.data.appliedThinkingLevel) : undefined,
+		manualThinkingLevel: enabled ? fixedThinkingLevel(entry.data.manualThinkingLevel) : undefined,
 	};
 }