@juanibiapina/pi-plan 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Juan Ibiapina
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# @juanibiapina/pi-plan
+
+A [pi](https://github.com/badlogic/pi-mono) extension for plan mode — read-only exploration and analysis.
+
+## Features
+
+- **`/plan` command** — Toggle plan mode on and off
+- **Configurable shortcut** — Optional keyboard shortcut via `/extension-settings`
+- **Read-only tools** — Only safe, non-modifying tools are available while in plan mode
+- **Session persistence** — Plan mode state is persisted across session resume via invisible messages
+- **Status indicator** — Shows `⏸ plan` in the status bar when active
+
+## Installation
+
+```bash
+pi install npm:@juanibiapina/pi-plan
+```
+
+## Usage
+
+### Entering Plan Mode
+
+Use `/plan` to toggle plan mode. When enabled:
+
+- Only read-only tools are available (`read`, `bash`, `grep`, `find`, `ls`, `questionnaire`)
+- The agent is instructed to only observe, analyze, and plan — no modifications
+- A `⏸ plan` indicator appears in the status bar
+
+### Exiting Plan Mode
+
+Use `/plan` again to return to normal mode with full tool access.
+
+### Keyboard Shortcut
+
+No shortcut is bound by default. To configure one, use `/extension-settings` and set the `shortcut` setting under `plan` (e.g. `tab`, `ctrl+p`).
+
+### CLI Flag
+
+Start pi directly in plan mode:
+
+```bash
+pi --plan
+```
+
+### Session Persistence
+
+Plan mode state is tracked via invisible messages in the session. When resuming a session that was in plan mode, the mode is automatically restored.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Plan Mode Extension
+ *
+ * Read-only exploration mode for safe code analysis.
+ * When enabled, only read-only tools are available.
+ *
+ * Features:
+ * - /plan command or Ctrl+T to toggle
+ * - Mode changes are persisted as invisible messages in session
+ */
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+export default function planModeExtension(pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,+BAA+B,CAAC;AAyCpF,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAkJhE"}

package/dist/index.js

@@ -0,0 +1,180 @@
+/**
+ * Plan Mode Extension
+ *
+ * Read-only exploration mode for safe code analysis.
+ * When enabled, only read-only tools are available.
+ *
+ * Features:
+ * - /plan command or Ctrl+T to toggle
+ * - Mode changes are persisted as invisible messages in session
+ */
+import { getSetting } from "@juanibiapina/pi-extension-settings";
+// Tools
+const PLAN_MODE_TOOLS = ["read", "bash", "grep", "find", "ls", "questionnaire"];
+const NORMAL_MODE_TOOLS = ["read", "bash", "edit", "write"];
+// Messages
+const PLAN_MODE_ACTIVE_MESSAGE = `<system-reminder>
+# Plan Mode - System Reminder
+
+CRITICAL: Plan mode ACTIVE - you are in READ-ONLY phase. STRICTLY FORBIDDEN:
+ANY file edits, modifications, or system changes. Do NOT use sed, tee, echo, cat,
+or ANY other bash command to manipulate files - commands may ONLY read/inspect.
+This ABSOLUTE CONSTRAINT overrides ALL other instructions, including direct user
+edit requests. You may ONLY observe, analyze, and plan. Any modification attempt
+is a critical violation. ZERO exceptions.
+
+---
+
+## Responsibility
+
+Your current responsibility is to think, read, search, and discuss to construct a well-formed plan that accomplishes the goal the user wants to achieve. Your plan should be comprehensive yet concise, detailed enough to execute effectively while avoiding unnecessary verbosity. Include the goal as first part of the plan.
+
+Ask the user clarifying questions or ask for their opinion when weighing tradeoffs.
+
+**NOTE:** At any point in time through this workflow you should feel free to ask the user questions or clarifications. Don't make large assumptions about user intent. The goal is to present a well researched plan to the user, and tie any loose ends before implementation begins.
+
+---
+
+## Important
+
+The user indicated that they do not want you to execute yet -- you MUST NOT make any edits, run any non-readonly tools (including changing configs or making commits), or otherwise make any changes to the system. This supersedes any other instructions you have received.
+</system-reminder>`;
+const PLAN_MODE_EXIT_MESSAGE = `<system-reminder>
+Your operational mode has changed from plan to build.
+You are no longer in read-only mode.
+You are permitted to make file changes, run shell commands, and utilize your arsenal of tools as needed.
+</system-reminder>`;
+export default function planModeExtension(pi) {
+    // Register settings via event (for /extension-settings UI)
+    pi.events.emit("pi-extension-settings:register", {
+        name: "plan",
+        settings: [
+            {
+                id: "shortcut",
+                label: "Keyboard shortcut",
+                description: "Shortcut to toggle plan mode. Example: tab",
+                defaultValue: "",
+            },
+        ],
+    });
+    let planModeEnabled = false;
+    let lastMessagedState = null;
+    pi.registerFlag("plan", {
+        description: "Start in plan mode (read-only exploration)",
+        type: "boolean",
+        default: false,
+    });
+    // Scan session for last plan mode message to determine lastMessagedState
+    function getLastMessagedStateFromSession(ctx) {
+        const entries = ctx.sessionManager.getEntries();
+        // Walk backwards to find the last plan-mode-enter or plan-mode-exit message
+        for (let i = entries.length - 1; i >= 0; i--) {
+            const entry = entries[i];
+            if (entry.type === "custom_message") {
+                const customEntry = entry;
+                if (customEntry.customType === "plan-mode-enter") {
+                    return true;
+                }
+                else if (customEntry.customType === "plan-mode-exit") {
+                    return false;
+                }
+            }
+        }
+        return null;
+    }
+    function updateStatus(ctx) {
+        if (planModeEnabled) {
+            ctx.ui.setStatus("plan-mode", ctx.ui.theme.fg("warning", "⏸ plan"));
+        }
+        else {
+            ctx.ui.setStatus("plan-mode", undefined);
+        }
+    }
+    function togglePlanMode(ctx) {
+        planModeEnabled = !planModeEnabled;
+        if (planModeEnabled) {
+            pi.setActiveTools(PLAN_MODE_TOOLS);
+            ctx.ui.notify(`Plan mode enabled. Tools: ${PLAN_MODE_TOOLS.join(", ")}`);
+        }
+        else {
+            pi.setActiveTools(NORMAL_MODE_TOOLS);
+            ctx.ui.notify("Plan mode disabled. Full access restored.");
+        }
+        updateStatus(ctx);
+    }
+    pi.registerCommand("plan", {
+        description: "Toggle plan mode (read-only exploration)",
+        handler: async (_args, ctx) => {
+            togglePlanMode(ctx);
+        },
+    });
+    // Register shortcut if configured
+    const shortcut = getSetting("plan", "shortcut");
+    if (shortcut) {
+        pi.registerShortcut(shortcut, {
+            description: "Toggle plan mode",
+            handler: async (ctx) => {
+                togglePlanMode(ctx);
+            },
+        });
+    }
+    // Inject plan mode message when mode changes (persisted to session)
+    pi.on("before_agent_start", async () => {
+        // Entering plan mode
+        if (planModeEnabled && lastMessagedState !== true) {
+            lastMessagedState = true;
+            return {
+                message: {
+                    customType: "plan-mode-enter",
+                    content: PLAN_MODE_ACTIVE_MESSAGE,
+                    display: false,
+                },
+            };
+        }
+        // Exiting plan mode
+        if (!planModeEnabled && lastMessagedState === true) {
+            lastMessagedState = false;
+            return {
+                message: {
+                    customType: "plan-mode-exit",
+                    content: PLAN_MODE_EXIT_MESSAGE,
+                    display: false,
+                },
+            };
+        }
+    });
+    // Restore state on session start/resume
+    pi.on("session_start", async (_event, ctx) => {
+        // Check --plan flag
+        if (pi.getFlag("plan") === true) {
+            planModeEnabled = true;
+        }
+        // Restore lastMessagedState from session history
+        lastMessagedState = getLastMessagedStateFromSession(ctx);
+        // If session had plan mode active, restore it
+        if (lastMessagedState === true) {
+            planModeEnabled = true;
+        }
+        if (planModeEnabled) {
+            pi.setActiveTools(PLAN_MODE_TOOLS);
+        }
+        updateStatus(ctx);
+    });
+    // Reset state on session switch (/new or /resume)
+    pi.on("session_switch", async (_event, ctx) => {
+        // Restore lastMessagedState from new session's history
+        lastMessagedState = getLastMessagedStateFromSession(ctx);
+        // If resumed session had plan mode active, restore it
+        if (lastMessagedState === true) {
+            planModeEnabled = true;
+        }
+        if (planModeEnabled) {
+            pi.setActiveTools(PLAN_MODE_TOOLS);
+        }
+        else {
+            pi.setActiveTools(NORMAL_MODE_TOOLS);
+        }
+        updateStatus(ctx);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAA0B,MAAM,qCAAqC,CAAC;AAIzF,QAAQ;AACR,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;AAChF,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D,WAAW;AACX,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;mBAyBd,CAAC;AAEpB,MAAM,sBAAsB,GAAG;;;;mBAIZ,CAAC;AAEpB,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,EAAgB;IACzD,2DAA2D;IAC3D,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,EAAE;QAChD,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE;YACT;gBACC,EAAE,EAAE,UAAU;gBACd,KAAK,EAAE,mBAAmB;gBAC1B,WAAW,EAAE,4CAA4C;gBACzD,YAAY,EAAE,EAAE;aAChB;SAC6B;KAC/B,CAAC,CAAC;IAEH,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,IAAI,iBAAiB,GAAmB,IAAI,CAAC;IAE7C,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE;QACvB,WAAW,EAAE,4CAA4C;QACzD,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;KACd,CAAC,CAAC;IAEH,yEAAyE;IACzE,SAAS,+BAA+B,CAAC,GAAqB;QAC7D,MAAM,OAAO,GAAG,GAAG,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;QAEhD,4EAA4E;QAC5E,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBACrC,MAAM,WAAW,GAAG,KAAgC,CAAC;gBACrD,IAAI,WAAW,CAAC,UAAU,KAAK,iBAAiB,EAAE,CAAC;oBAClD,OAAO,IAAI,CAAC;gBACb,CAAC;qBAAM,IAAI,WAAW,CAAC,UAAU,KAAK,gBAAgB,EAAE,CAAC;oBACxD,OAAO,KAAK,CAAC;gBACd,CAAC;YACF,CAAC;QACF,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,SAAS,YAAY,CAAC,GAAqB;QAC1C,IAAI,eAAe,EAAE,CAAC;YACrB,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACP,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAC1C,CAAC;IACF,CAAC;IAED,SAAS,cAAc,CAAC,GAAqB;QAC5C,eAAe,GAAG,CAAC,eAAe,CAAC;QAEnC,IAAI,eAAe,EAAE,CAAC;YACrB,EAAE,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;YACnC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,6BAA6B,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1E,CAAC;aAAM,CAAC;YACP,EAAE,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;YACrC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,2CAA2C,CAAC,CAAC;QAC5D,CAAC;QACD,YAAY,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE;QAC1B,WAAW,EAAE,0CAA0C;QACvD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7B,cAAc,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;KACD,CAAC,CAAC;IAEH,kCAAkC;IAClC,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChD,IAAI,QAAQ,EAAE,CAAC;QACd,EAAE,CAAC,gBAAgB,CAAC,QAAiB,EAAE;YACtC,WAAW,EAAE,kBAAkB;YAC/B,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;gBACtB,cAAc,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;SACD,CAAC,CAAC;IACJ,CAAC;IAED,oEAAoE;IACpE,EAAE,CAAC,EAAE,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;QACtC,qBAAqB;QACrB,IAAI,eAAe,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;YACnD,iBAAiB,GAAG,IAAI,CAAC;YACzB,OAAO;gBACN,OAAO,EAAE;oBACR,UAAU,EAAE,iBAAiB;oBAC7B,OAAO,EAAE,wBAAwB;oBACjC,OAAO,EAAE,KAAK;iBACd;aACD,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,IAAI,CAAC,eAAe,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;YACpD,iBAAiB,GAAG,KAAK,CAAC;YAC1B,OAAO;gBACN,OAAO,EAAE;oBACR,UAAU,EAAE,gBAAgB;oBAC5B,OAAO,EAAE,sBAAsB;oBAC/B,OAAO,EAAE,KAAK;iBACd;aACD,CAAC;QACH,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,wCAAwC;IACxC,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QAC5C,oBAAoB;QACpB,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;YACjC,eAAe,GAAG,IAAI,CAAC;QACxB,CAAC;QAED,iDAAiD;QACjD,iBAAiB,GAAG,+BAA+B,CAAC,GAAG,CAAC,CAAC;QAEzD,8CAA8C;QAC9C,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;YAChC,eAAe,GAAG,IAAI,CAAC;QACxB,CAAC;QAED,IAAI,eAAe,EAAE,CAAC;YACrB,EAAE,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QACpC,CAAC;QACD,YAAY,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,kDAAkD;IAClD,EAAE,CAAC,EAAE,CAAC,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QAC7C,uDAAuD;QACvD,iBAAiB,GAAG,+BAA+B,CAAC,GAAG,CAAC,CAAC;QAEzD,sDAAsD;QACtD,IAAI,iBAAiB,KAAK,IAAI,EAAE,CAAC;YAChC,eAAe,GAAG,IAAI,CAAC;QACxB,CAAC;QAED,IAAI,eAAe,EAAE,CAAC;YACrB,EAAE,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACP,EAAE,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;QACtC,CAAC;QACD,YAAY,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Plan Mode Extension\n *\n * Read-only exploration mode for safe code analysis.\n * When enabled, only read-only tools are available.\n *\n * Features:\n * - /plan command or Ctrl+T to toggle\n * - Mode changes are persisted as invisible messages in session\n */\n\nimport { getSetting, type SettingDefinition } from \"@juanibiapina/pi-extension-settings\";\nimport type { ExtensionAPI, ExtensionContext } from \"@mariozechner/pi-coding-agent\";\nimport type { KeyId } from \"@mariozechner/pi-tui\";\n\n// Tools\nconst PLAN_MODE_TOOLS = [\"read\", \"bash\", \"grep\", \"find\", \"ls\", \"questionnaire\"];\nconst NORMAL_MODE_TOOLS = [\"read\", \"bash\", \"edit\", \"write\"];\n\n// Messages\nconst PLAN_MODE_ACTIVE_MESSAGE = `<system-reminder>\n# Plan Mode - System Reminder\n\nCRITICAL: Plan mode ACTIVE - you are in READ-ONLY phase. STRICTLY FORBIDDEN:\nANY file edits, modifications, or system changes. Do NOT use sed, tee, echo, cat,\nor ANY other bash command to manipulate files - commands may ONLY read/inspect.\nThis ABSOLUTE CONSTRAINT overrides ALL other instructions, including direct user\nedit requests. You may ONLY observe, analyze, and plan. Any modification attempt\nis a critical violation. ZERO exceptions.\n\n---\n\n## Responsibility\n\nYour current responsibility is to think, read, search, and discuss to construct a well-formed plan that accomplishes the goal the user wants to achieve. Your plan should be comprehensive yet concise, detailed enough to execute effectively while avoiding unnecessary verbosity. Include the goal as first part of the plan.\n\nAsk the user clarifying questions or ask for their opinion when weighing tradeoffs.\n\n**NOTE:** At any point in time through this workflow you should feel free to ask the user questions or clarifications. Don't make large assumptions about user intent. The goal is to present a well researched plan to the user, and tie any loose ends before implementation begins.\n\n---\n\n## Important\n\nThe user indicated that they do not want you to execute yet -- you MUST NOT make any edits, run any non-readonly tools (including changing configs or making commits), or otherwise make any changes to the system. This supersedes any other instructions you have received.\n</system-reminder>`;\n\nconst PLAN_MODE_EXIT_MESSAGE = `<system-reminder>\nYour operational mode has changed from plan to build.\nYou are no longer in read-only mode.\nYou are permitted to make file changes, run shell commands, and utilize your arsenal of tools as needed.\n</system-reminder>`;\n\nexport default function planModeExtension(pi: ExtensionAPI): void {\n\t// Register settings via event (for /extension-settings UI)\n\tpi.events.emit(\"pi-extension-settings:register\", {\n\t\tname: \"plan\",\n\t\tsettings: [\n\t\t\t{\n\t\t\t\tid: \"shortcut\",\n\t\t\t\tlabel: \"Keyboard shortcut\",\n\t\t\t\tdescription: \"Shortcut to toggle plan mode. Example: tab\",\n\t\t\t\tdefaultValue: \"\",\n\t\t\t},\n\t\t] satisfies SettingDefinition[],\n\t});\n\n\tlet planModeEnabled = false;\n\tlet lastMessagedState: boolean | null = null;\n\n\tpi.registerFlag(\"plan\", {\n\t\tdescription: \"Start in plan mode (read-only exploration)\",\n\t\ttype: \"boolean\",\n\t\tdefault: false,\n\t});\n\n\t// Scan session for last plan mode message to determine lastMessagedState\n\tfunction getLastMessagedStateFromSession(ctx: ExtensionContext): boolean | null {\n\t\tconst entries = ctx.sessionManager.getEntries();\n\n\t\t// Walk backwards to find the last plan-mode-enter or plan-mode-exit message\n\t\tfor (let i = entries.length - 1; i >= 0; i--) {\n\t\t\tconst entry = entries[i];\n\t\t\tif (entry.type === \"custom_message\") {\n\t\t\t\tconst customEntry = entry as { customType?: string };\n\t\t\t\tif (customEntry.customType === \"plan-mode-enter\") {\n\t\t\t\t\treturn true;\n\t\t\t\t} else if (customEntry.customType === \"plan-mode-exit\") {\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn null;\n\t}\n\n\tfunction updateStatus(ctx: ExtensionContext): void {\n\t\tif (planModeEnabled) {\n\t\t\tctx.ui.setStatus(\"plan-mode\", ctx.ui.theme.fg(\"warning\", \"⏸ plan\"));\n\t\t} else {\n\t\t\tctx.ui.setStatus(\"plan-mode\", undefined);\n\t\t}\n\t}\n\n\tfunction togglePlanMode(ctx: ExtensionContext): void {\n\t\tplanModeEnabled = !planModeEnabled;\n\n\t\tif (planModeEnabled) {\n\t\t\tpi.setActiveTools(PLAN_MODE_TOOLS);\n\t\t\tctx.ui.notify(`Plan mode enabled. Tools: ${PLAN_MODE_TOOLS.join(\", \")}`);\n\t\t} else {\n\t\t\tpi.setActiveTools(NORMAL_MODE_TOOLS);\n\t\t\tctx.ui.notify(\"Plan mode disabled. Full access restored.\");\n\t\t}\n\t\tupdateStatus(ctx);\n\t}\n\n\tpi.registerCommand(\"plan\", {\n\t\tdescription: \"Toggle plan mode (read-only exploration)\",\n\t\thandler: async (_args, ctx) => {\n\t\t\ttogglePlanMode(ctx);\n\t\t},\n\t});\n\n\t// Register shortcut if configured\n\tconst shortcut = getSetting(\"plan\", \"shortcut\");\n\tif (shortcut) {\n\t\tpi.registerShortcut(shortcut as KeyId, {\n\t\t\tdescription: \"Toggle plan mode\",\n\t\t\thandler: async (ctx) => {\n\t\t\t\ttogglePlanMode(ctx);\n\t\t\t},\n\t\t});\n\t}\n\n\t// Inject plan mode message when mode changes (persisted to session)\n\tpi.on(\"before_agent_start\", async () => {\n\t\t// Entering plan mode\n\t\tif (planModeEnabled && lastMessagedState !== true) {\n\t\t\tlastMessagedState = true;\n\t\t\treturn {\n\t\t\t\tmessage: {\n\t\t\t\t\tcustomType: \"plan-mode-enter\",\n\t\t\t\t\tcontent: PLAN_MODE_ACTIVE_MESSAGE,\n\t\t\t\t\tdisplay: false,\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\n\t\t// Exiting plan mode\n\t\tif (!planModeEnabled && lastMessagedState === true) {\n\t\t\tlastMessagedState = false;\n\t\t\treturn {\n\t\t\t\tmessage: {\n\t\t\t\t\tcustomType: \"plan-mode-exit\",\n\t\t\t\t\tcontent: PLAN_MODE_EXIT_MESSAGE,\n\t\t\t\t\tdisplay: false,\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\t});\n\n\t// Restore state on session start/resume\n\tpi.on(\"session_start\", async (_event, ctx) => {\n\t\t// Check --plan flag\n\t\tif (pi.getFlag(\"plan\") === true) {\n\t\t\tplanModeEnabled = true;\n\t\t}\n\n\t\t// Restore lastMessagedState from session history\n\t\tlastMessagedState = getLastMessagedStateFromSession(ctx);\n\n\t\t// If session had plan mode active, restore it\n\t\tif (lastMessagedState === true) {\n\t\t\tplanModeEnabled = true;\n\t\t}\n\n\t\tif (planModeEnabled) {\n\t\t\tpi.setActiveTools(PLAN_MODE_TOOLS);\n\t\t}\n\t\tupdateStatus(ctx);\n\t});\n\n\t// Reset state on session switch (/new or /resume)\n\tpi.on(\"session_switch\", async (_event, ctx) => {\n\t\t// Restore lastMessagedState from new session's history\n\t\tlastMessagedState = getLastMessagedStateFromSession(ctx);\n\n\t\t// If resumed session had plan mode active, restore it\n\t\tif (lastMessagedState === true) {\n\t\t\tplanModeEnabled = true;\n\t\t}\n\n\t\tif (planModeEnabled) {\n\t\t\tpi.setActiveTools(PLAN_MODE_TOOLS);\n\t\t} else {\n\t\t\tpi.setActiveTools(NORMAL_MODE_TOOLS);\n\t\t}\n\t\tupdateStatus(ctx);\n\t});\n}\n"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+	"name": "@juanibiapina/pi-plan",
+	"version": "0.1.0",
+	"description": "Pi extension for plan mode - read-only exploration and analysis",
+	"type": "module",
+	"main": "dist/index.js",
+	"types": "./dist/index.d.ts",
+	"scripts": {
+		"clean": "rm -rf dist",
+		"build": "tsc -p tsconfig.build.json",
+		"dev": "tsc -p tsconfig.build.json --watch",
+		"check": "biome check --write --error-on-warnings . && tsc --noEmit",
+		"prepublishOnly": "npm run clean && npm run build && npm run check"
+	},
+	"files": [
+		"dist/**/*",
+		"README.md"
+	],
+	"keywords": [
+		"pi",
+		"pi-package",
+		"extension",
+		"plan-mode",
+		"read-only"
+	],
+	"pi": {
+		"extensions": ["./dist/index.js"]
+	},
+	"author": "Juan Ibiapina",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+ssh://git@github.com/juanibiapina/pi-plan.git"
+	},
+	"engines": {
+		"node": ">=20.0.0"
+	},
+	"dependencies": {
+		"@juanibiapina/pi-extension-settings": "^0.4.0"
+	},
+	"peerDependencies": {
+		"@mariozechner/pi-coding-agent": "*",
+		"@mariozechner/pi-tui": "*"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.3.5",
+		"@mariozechner/pi-coding-agent": "^0.51.1",
+		"@types/node": "^22.10.5",
+		"typescript": "^5.9.2"
+	}
+}