pi-project-switcher 0.3.3 → 0.5.0

package/README.md

@@ -10,6 +10,7 @@ A [pi coding agent](https://github.com/earendil-works/pi) extension to switch be
   - persists across reloads (session entry)
   - sets the session display name
   - injects the project path into every agent turn's system prompt, so file operations default to the active project
+  - **if the project doesn't exist yet**, offers to create the folder and switch to it (confirmation dialog on dialog-capable surfaces; use `/project <name>!` to skip the dialog — e.g. on headless/RPC surfaces). Unsafe names (path segments, `..`, hidden, absolute) are never created.
 - **Session restore** — a machine-local map (`~/.pi/agent/project-switcher-sessions.json`) remembers the most recent session per project. Switching projects returns you to that project's last session; if none exists (or the file is gone), the switch happens in the current session.
 - **Auto-detection** — if pi starts inside `~/dev/<project>`, that project is active automatically
 

package/index.ts

@@ -22,7 +22,7 @@ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { execSync } from "node:child_process";
 import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { basename, join, relative, resolve } from "node:path";
+import { basename, isAbsolute, join, relative, resolve } from "node:path";
 
 const HOME = homedir();
 const ENTRY_TYPE = "project-switcher-state";
@@ -189,6 +189,26 @@ function isValidProject(name: string): boolean {
   return projects.includes(name);
 }
 
+/** True when a name is safe to materialize as a single directory under the base dir. */
+function isSafeProjectName(name: string): boolean {
+  if (!name || name === "." || name === "..") {
+    return false;
+  }
+  if (name.startsWith(".")) {
+    return false; // hidden
+  }
+  if (name.includes("/") || name.includes("\\")) {
+    return false; // no path segments
+  }
+  if (name.includes("..")) {
+    return false; // no traversal
+  }
+  if (isAbsolute(name)) {
+    return false; // absolute paths
+  }
+  return true;
+}
+
 export default function (pi: ExtensionAPI) {
   // ── Restore state on session start ──────────────────────────────────────
   pi.on("session_start", async (_event, ctx) => {
@@ -255,7 +275,13 @@ export default function (pi: ExtensionAPI) {
     },
 
     handler: async (args, ctx) => {
-      const name = args.trim();
+      let name = args.trim();
+
+      // ── Explicit create opt-in: trailing "!" on the project name ────────
+      const createOptIn = name.endsWith("!");
+      if (createOptIn) {
+        name = name.slice(0, -1).trim();
+      }
 
       // ── No arg: show status ──────────────────────────────────────────────
       if (!name) {
@@ -280,12 +306,46 @@ export default function (pi: ExtensionAPI) {
 
       // ── Switch project ────────────────────────────────────────────────────
       if (!isValidProject(name)) {
-        const available = discoverProjects(getConfig().baseDir).join(", ");
-        ctx.ui.notify(
-          `Unknown project: "${name}".\nAvailable: ${available || "(none)"}`,
-          "warning"
-        );
-        return;
+        // Offer to create the folder and switch to it (never silently)
+        if (isSafeProjectName(name)) {
+          let create = false;
+          if (createOptIn) {
+            create = true;
+          } else if (ctx.hasUI) {
+            try {
+              create = await ctx.ui.confirm(
+                "Create project?",
+                `Project "${name}" does not exist. Create ${join(getConfig().baseDir, name)} and switch to it?`
+              );
+            } catch {
+              create = false;
+            }
+          }
+
+          if (create) {
+            const newPath = projectPath(name);
+            try {
+              mkdirSync(newPath, { recursive: false });
+              ctx.ui.notify(`Created project folder: ${newPath}`, "info");
+            } catch (err: any) {
+              ctx.ui.notify(
+                `Failed to create project folder ${newPath}: ${err?.message ?? err}`,
+                "error"
+              );
+              return;
+            }
+            // fall through: the folder now exists and the switch proceeds below
+          }
+        }
+
+        if (!isValidProject(name)) {
+          const available = discoverProjects(getConfig().baseDir).join(", ");
+          ctx.ui.notify(
+            `Unknown project: "${name}".\nAvailable: ${available || "(none)"}`,
+            "warning"
+          );
+          return;
+        }
       }
 
       if (name === activeProject) {
@@ -327,7 +387,8 @@ export default function (pi: ExtensionAPI) {
         const branch = getGitBranch(path);
         const branchStr = branch ? ` on branch \`${branch}\`` : "";
         ctx.ui.notify(
-          `Switched to ${name} (session: ${basename(targetSession)})\n${path}${branchStr ? ` ${branchStr}` : ""}`,
+          `Switched to ${name} — session restored: ${basename(targetSession)}\n` +
+          `Workdir: ${path}${branchStr ? ` ${branchStr}` : ""}`,
           "info"
         );
         return;
@@ -347,7 +408,18 @@ export default function (pi: ExtensionAPI) {
       const branchStr = branch ? ` on branch \`${branch}\`` : "";
       const fromStr = previous ? ` (was: ${previous})` : "";
 
-      ctx.ui.notify(`Switched to ${name}${fromStr}\n${path}${branchStr ? ` ${branchStr}` : ""}`, "info");
+      // Current session identity — still valid on this path (no session replacement)
+      const currentFile = currentSessionFile ?? ctx.sessionManager.getSessionFile();
+      const sessionLine = currentFile
+        ? `Continuing session: ${basename(currentFile)}`
+        : "Continuing current session";
+
+      ctx.ui.notify(
+        `Switched to ${name}${fromStr} — first session in this project\n` +
+        `Workdir: ${path}${branchStr ? ` ${branchStr}` : ""}\n` +
+        sessionLine,
+        "info"
+      );
 
       // Announce to the agent so it operates in the new context
       await ctx.waitForIdle();

package/package.json

@@ -1 +1 @@
-{"name": "pi-project-switcher", "version": "0.3.3", "description": "pi coding agent extension: switch between projects under a configurable base directory via /project", "main": "index.ts", "type": "module", "scripts": {"test": "vitest run", "test:watch": "vitest", "typecheck": "tsc --noEmit"}, "keywords": ["pi", "pi-package", "pi-extension", "project", "switcher", "project-switching"], "author": "stefclawd", "license": "MIT", "repository": {"type": "git", "url": "git+https://github.com/stefclawd/pi-project-switcher.git"}, "bugs": {"url": "https://github.com/stefclawd/pi-project-switcher/issues"}, "homepage": "https://github.com/stefclawd/pi-project-switcher#readme", "files": ["index.ts", "README.md", "LICENSE"], "engines": {"node": ">=22.19.0"}, "pi": {"extensions": ["./index.ts"]}, "devDependencies": {"@earendil-works/pi-coding-agent": "^0.85.1", "@types/node": "^24.0.0", "typescript": "^5.7.0", "vitest": "^3.0.0"}}
+{"name": "pi-project-switcher", "version": "0.5.0", "description": "pi coding agent extension: switch between projects under a configurable base directory via /project", "main": "index.ts", "type": "module", "scripts": {"test": "vitest run", "test:watch": "vitest", "typecheck": "tsc --noEmit"}, "keywords": ["pi", "pi-package", "pi-extension", "project", "switcher", "project-switching"], "author": "stefclawd", "license": "MIT", "repository": {"type": "git", "url": "git+https://github.com/stefclawd/pi-project-switcher.git"}, "bugs": {"url": "https://github.com/stefclawd/pi-project-switcher/issues"}, "homepage": "https://github.com/stefclawd/pi-project-switcher#readme", "files": ["index.ts", "README.md", "LICENSE"], "engines": {"node": ">=22.19.0"}, "pi": {"extensions": ["./index.ts"]}, "devDependencies": {"@earendil-works/pi-coding-agent": "^0.85.1", "@types/node": "^24.0.0", "typescript": "^5.7.0", "vitest": "^3.0.0"}}