pi-profiles-manager 1.0.1 → 1.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 javinnav
+
+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

@@ -1,96 +1,100 @@
-# pi-profiles-manager 🚀
+# pi-profiles-manager
 
-Interactive SDD model profile management built natively for the [Pi Coding Agent](https://github.com/earendil-works/pi-mono).
+`pi-profiles-manager` is a [Pi Coding Agent](https://github.com/badlogic/pi-mono) extension for saving, selecting, editing, importing, and exporting SDD model profiles. A profile can set an orchestrator model and thinking level, plus routes for managed subagents.
 
-Manage your Gentle AI `models.json` configurations dynamically from a beautiful Terminal User Interface (TUI) without ever leaving your session.
+## Install
 
----
+Prerequisites:
 
-## 🌟 Features
+- Pi Coding Agent
+- Node.js 22.19.0 or later (for development)
 
-### 1. Unified Profile Management
-Manage all your SDD (Spec-Driven Development) profiles via a rich interface:
-- **Create:** Read your current `models.json` setup and save it as a new profile instantly.
-- **Activate:** Apply a saved profile into the global runtime config. Changes affect the executing session immediately with no restarts required.
-- **Edit Agent Nodes:** Individually adjust `model` strings and `thinking` tiers (`low`, `medium`, `high`, `xhigh`, `max`) for any agent (`sdd-*`, `jd-*`, `review-*`, etc.).
-- **Scaffold Empty Agents:** Add specific overrides for single agents right from the UI.
-- **Delete:** Remove outdated tiers and profiles to keep your workspace tidy.
+Install the published package:
 
-### 2. Native Pi Integration 
-- Fully built on top of `@earendil-works/pi-tui`.
-- Works flawlessly with overlay navigation, meaning your terminal output isn't erased when interacting with profiles.
+```bash
+pi install npm:pi-profiles-manager
+```
 
----
+Reload an active Pi session with `/reload` if needed.
 
-## 📸 Interface Preview (Compact Format)
+## Pi command: `/profiles`
 
-```text
-Profiles Manager
-──────────────────────────────────────────────────
-> ✨ Create New Profile from Current Config
-  FREE
-  antigravity
-  deus
-
-↑↓ navigate • enter select • esc close
-```
+Pi registers one command: `/profiles`. Its actions are arguments to that command, not separate Pi commands such as `/profiles:sync`.
 
 ```text
-Action for 'antigravity'
-──────────────────────────────────────────────────
-> ▶ Activate         Apply this profile to models.json
-  ✎ Edit             Modify agents in this profile
-  ✖ Delete           Remove this profile
-  ← Back             Return to profile list
+/profiles
 ```
 
-```text
-Edit Profile 'antigravity'
-──────────────────────────────────────────────────
-> orchestrator       omni/antigravity/gemini-pro-agent (medium)
-  jd-fix-agent       omniroute/gemini-flash-low (high)
-  ...
-  ➕ Add Subagent    Add a specific configuration for a subagent
-```
+Open the interactive manager with no arguments. When entering an argument, Pi completion suggests supported actions; after `use` or `save`, it suggests matching saved profile names. Profile names may contain spaces.
 
----
+| Command | Action |
+| --- | --- |
+| `/profiles` | Open the interactive profile manager. |
+| `/profiles list` | List saved profiles. |
+| `/profiles status` | Show the active profile for the current session. |
+| `/profiles use <name>` | Activate a saved profile. |
+| `/profiles save <name>` | Save the current configuration as a profile. |
+| `/profiles next` | Activate the next profile in the configured cycle. |
+| `/profiles off` | Disable the active profile for the current session. |
+| `/profiles sync` | Discover managed `agents/*.md` files and reconcile every saved profile's subagent entries. It does not create Pi commands. |
 
-## 🛠 Installation
+The default shortcut, `ctrl+shift+p`, activates the next profile in the configured cycle.
 
-Clone this repository directly into your Pi extensions directory:
+## Where data lives
 
-```bash
-git clone https://github.com/javinnav/pi-profiles-manager.git ~/.pi/agent/extensions/profiles-manager
-```
+These locations have different purposes:
+
+### Saved profile persistence
 
-Apply the changes immediately by reloading the active session:
+Saved profiles, the default profile, cycle, and shortcut preference are persisted in:
 
 ```text
-/reload
+~/.pi/agent/pi-profiles/config.json
 ```
 
----
-
-## 🚀 Usage
+The extension creates this file and its parent directory when it saves a profile.
 
-*Ensure the active Pi Session recognizes the newly linked extension context.*
+### Managed subagent definitions
 
-Open the Profiles Manager by triggering its slash command:
+Pi agent markdown files live in the Pi agent directory:
 
 ```text
-/profiles
+~/.pi/agent/agents/*.md
 ```
 
-Alternatively, to quickly snapshot your current session's `models.json` without routing through the UI:
+Run `/profiles sync` after adding or removing these files. Sync discovers their names and reconciles each saved profile: new managed agents receive a profile entry, and entries for removed markdown files are removed. Sync updates profile data; it does not register additional Pi slash commands.
+
+### Applied subagent routes
+
+When a profile is activated, its subagent routes are applied to Pi's global agent-route configuration:
 
 ```text
-/profiles save <profile-name>
+~/.pi/agent/subagents.json
 ```
 
----
+This is separate from `pi-profiles/config.json`: the former is the active routing configuration Pi uses, while the latter stores the profiles that can be selected later.
+
+## Features
+
+- Create, activate, edit, and delete profiles.
+- Import and export versioned profile strings.
+- Set model and thinking routes for the orchestrator and managed subagents.
+- Mark a default profile for session startup and view active/default status in the UI.
+- Cycle profiles with a keyboard shortcut.
+
+## Development
+
+Clone this repository into your Pi extensions directory to develop it locally:
+
+```bash
+git clone https://github.com/javinnav/pi-profiles-manager.git ~/.pi/agent/extensions/profiles-manager
+cd ~/.pi/agent/extensions/profiles-manager
+npm ci
+npm test
+npm run typecheck
+npm run package-check
+```
 
-## 💖 Credits and Acknowledgments
+## License
 
-- **Inspiration:** Developed mirroring the clean extension and TUI architecture provided by [opencode-sdd-engram-manage](https://github.com/j0k3r-dev-rgl/sdd-engram-plugin) from @j0k3r-dev-rgl. 
-- **Dependencies:** Built leveraging the core APIs of the [Pi Coding Agent framework](https://github.com/earendil-works/pi-mono). 
-- **Ecosystem:** Powered by [Gentle AI (OpenCode)](https://github.com/Gentleman-Programming/gentle-ai).
+MIT © javinnav

package/index.ts

@@ -1,352 +1 @@
-import * as fs from "fs/promises";
-import * as os from "os";
-import * as path from "path";
-import type { ExtensionAPI, TUIContext } from "@earendil-works/pi-coding-agent";
-import { DynamicBorder } from "@earendil-works/pi-coding-agent";
-import { Container, SelectList, Text, Input } from "@earendil-works/pi-tui";
-
-const GENTLE_DIR = path.join(os.homedir(), ".pi", "gentle-ai");
-const MODELS_PATH = path.join(GENTLE_DIR, "models.json");
-const PROFILES_PATH = path.join(GENTLE_DIR, "sdd-profiles-manager.json");
-
-interface Profile {
-  name: string;
-  orchestrator: { model: string; thinking: string };
-  agents: Record<string, { model: string; thinking: string }>;
-}
-
-async function readJson(fp: string): Promise<any> {
-  try {
-    const data = await fs.readFile(fp, "utf-8");
-    return JSON.parse(data);
-  } catch (e: any) {
-    if (e.code === "ENOENT") return {};
-    throw e;
-  }
-}
-
-async function writeJson(fp: string, data: any): Promise<void> {
-  await fs.mkdir(path.dirname(fp), { recursive: true });
-  await fs.writeFile(fp, JSON.stringify(data, null, 2));
-}
-
-// Helper to ask user for a string
-async function promptInput(ctx: any, title: string, initialValue: string = ""): Promise<string | null> {
-  return await ctx.ui.custom<string | null>((tui: any, theme: any, _kb: any, done: any) => {
-    const container = new Container() as any;
-    container.focused = true; // Make container focusable
-    
-    container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
-    container.addChild(new Text(theme.fg("accent", theme.bold(title)), 1, 0));
-    
-    const input = new Input();
-    input.setValue(initialValue);
-    input.onSubmit = (val) => done(val.trim());
-    input.onEscape = () => done(null);
-    input.focused = true;
-    
-    // Wire up focus propagation
-    container.handleInput = (data: string) => {
-      input.handleInput(data);
-      tui.requestRender();
-    };
-    
-    container.addChild(input);
-    container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
-
-    return {
-      render: (w: number) => container.render(w),
-      invalidate: () => container.invalidate(),
-      handleInput: (data: string) => container.handleInput(data),
-    };
-  }, { overlay: true });
-}
-
-export default function (pi: ExtensionAPI) {
-  pi.registerCommand("profiles", {
-    description: "Manage SDD model profiles",
-    handler: async (args, ctx) => {
-      // Subcommand for save
-      if (args[0] === "save") {
-        const profileName = args[1];
-        if (!profileName) {
-          ctx.ui.notify("Error: Provide a profile name (e.g. /profiles save my-profile)", "error");
-          return;
-        }
-
-        const models = await readJson(MODELS_PATH);
-        const orchestrator = models["gentle-orchestrator"] || { model: "", thinking: "" };
-        const agents: any = {};
-        for (const key of Object.keys(models)) {
-          if (key !== "gentle-orchestrator") {
-            agents[key] = models[key];
-          }
-        }
-        const profiles = await readJson(PROFILES_PATH);
-        profiles[profileName] = { name: profileName, orchestrator, agents };
-        await writeJson(PROFILES_PATH, profiles);
-        ctx.ui.notify(`Profile '${profileName}' saved`, "success");
-        return;
-      }
-
-      while (true) {
-        let profiles: Record<string, Profile> = await readJson(PROFILES_PATH);
-        const profileNames = Object.keys(profiles);
-        
-        const items = [
-          { value: "__CREATE__", label: "✨ Create New Profile from Current Config", description: "Saves models.json into a new profile" },
-          ...profileNames.map((name) => ({
-            value: name,
-            label: name,
-            description: `Orchestrator: ${profiles[name].orchestrator?.model || "none"}`,
-          }))
-        ];
-
-        // Pick Profile
-        const selectedProfile = await ctx.ui.custom<string | null>((tui, theme, _kb, done) => {
-          const container = new Container();
-          container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
-          container.addChild(new Text(theme.fg("accent", theme.bold("Profiles Manager")), 1, 0));
-
-          const list = new SelectList(items, Math.min(items.length, 10), {
-            selectedPrefix: (t) => theme.fg("accent", t),
-            selectedText: (t) => theme.fg("accent", t),
-            description: (t) => theme.fg("muted", t),
-            scrollInfo: (t) => theme.fg("dim", t),
-            noMatch: (t) => theme.fg("warning", t),
-          });
-          list.onSelect = (item) => done(item.value);
-          list.onCancel = () => done(null);
-          container.addChild(list);
-
-          container.addChild(new Text(theme.fg("dim", "↑↓ navigate • enter select • esc close"), 1, 0));
-          container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
-
-          return {
-            render: (w) => container.render(w),
-            invalidate: () => container.invalidate(),
-            handleInput: (data) => { list.handleInput(data); tui.requestRender(); },
-          };
-        }, { overlay: true });
-
-        if (!selectedProfile) break; // Finished and exit loop
-
-        if (selectedProfile === "__CREATE__") {
-          const newName = await promptInput(ctx, "Enter new profile name:");
-          if (newName) {
-            const models = await readJson(MODELS_PATH);
-            const orchestrator = models["gentle-orchestrator"] || { model: "", thinking: "" };
-            const agents: any = {};
-            for (const key of Object.keys(models)) {
-              if (key !== "gentle-orchestrator") {
-                agents[key] = models[key];
-              }
-            }
-            profiles[newName] = { name: newName, orchestrator, agents };
-            await writeJson(PROFILES_PATH, profiles);
-            ctx.ui.notify(`Created profile '${newName}'`, "success");
-          }
-          continue;
-        }
-
-        // Action menu for existing profile
-        while (true) {
-          const actionItems = [
-            { value: "activate", label: "▶ Activate", description: "Apply this profile to models.json" },
-            { value: "edit", label: "✎ Edit", description: "Modify agents in this profile" },
-            { value: "delete", label: "✖ Delete", description: "Remove this profile" },
-            { value: "back", label: "← Back", description: "Return to profile list" },
-          ];
-
-          const selectedAction = await ctx.ui.custom<string | null>((tui, theme, _kb, done) => {
-            const container = new Container();
-            container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
-            container.addChild(new Text(theme.fg("accent", theme.bold(`Profile: '${selectedProfile}'`)), 1, 0));
-
-            const list = new SelectList(actionItems, 4, {
-              selectedPrefix: (t) => theme.fg("accent", t),
-              selectedText: (t) => theme.fg("accent", t),
-              description: (t) => theme.fg("muted", t),
-              scrollInfo: (t) => theme.fg("dim", t),
-              noMatch: (t) => theme.fg("warning", t),
-            });
-            list.onSelect = (item) => done(item.value);
-            list.onCancel = () => done(null);
-            container.addChild(list);
-            container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
-
-            return {
-              render: (w) => container.render(w),
-              invalidate: () => container.invalidate(),
-              handleInput: (data) => { list.handleInput(data); tui.requestRender(); },
-            };
-          }, { overlay: true });
-
-          if (!selectedAction || selectedAction === "back") {
-            break; // Back to profile list
-          }
-
-          if (selectedAction === "activate") {
-            const profile = profiles[selectedProfile];
-            const newModels: any = {};
-            if (profile.orchestrator) {
-              newModels["gentle-orchestrator"] = profile.orchestrator;
-            }
-            if (profile.agents) {
-              for (const key of Object.keys(profile.agents)) {
-                newModels[key] = profile.agents[key];
-              }
-            }
-            await writeJson(MODELS_PATH, newModels);
-            ctx.ui.notify(`Activated profile '${selectedProfile}'. Run /reload if needed.`, "success");
-            break; // Back to profile list after activating
-          } 
-          
-          if (selectedAction === "delete") {
-            delete profiles[selectedProfile];
-            await writeJson(PROFILES_PATH, profiles);
-            ctx.ui.notify(`Deleted profile '${selectedProfile}'.`, "success");
-            break; // Back to profile list after deleting
-          }
-          
-          if (selectedAction === "edit") {
-            // Edit Flow
-            while (true) {
-              const currentProfile = profiles[selectedProfile];
-              const agentKeys = ["orchestrator", ...Object.keys(currentProfile.agents || {})];
-              
-              const editItems = agentKeys.map(k => {
-                const conf = k === "orchestrator" ? currentProfile.orchestrator : currentProfile.agents[k];
-                return {
-                  value: k,
-                  label: k,
-                  description: `${conf?.model || "none"} (${conf?.thinking || "low"})`
-                };
-              });
-              editItems.push({ value: "__ADD__", label: "➕ Add Subagent", description: "Add a specific configuration for a subagent" });
-              editItems.push({ value: "back", label: "← Back", description: "Return to profile menu" });
-
-              const pickedAgent = await ctx.ui.custom<string | null>((tui, theme, _kb, done) => {
-                const container = new Container();
-                container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
-                container.addChild(new Text(theme.fg("accent", theme.bold(`Edit Profile '${selectedProfile}'`)), 1, 0));
-
-                const list = new SelectList(editItems, Math.min(editItems.length, 10), {
-                  selectedPrefix: (t) => theme.fg("accent", t),
-                  selectedText: (t) => theme.fg("accent", t),
-                  description: (t) => theme.fg("muted", t),
-                  scrollInfo: (t) => theme.fg("dim", t),
-                  noMatch: (t) => theme.fg("warning", t),
-                });
-                list.onSelect = (item) => done(item.value);
-                list.onCancel = () => done(null);
-                container.addChild(list);
-                container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
-
-                return {
-                  render: (w) => container.render(w),
-                  invalidate: () => container.invalidate(),
-                  handleInput: (data) => { list.handleInput(data); tui.requestRender(); },
-                };
-              }, { overlay: true });
-
-              if (!pickedAgent || pickedAgent === "back") break;
-
-              let agentName = pickedAgent;
-              // If adding, ask for agent name
-              if (agentName === "__ADD__") {
-                const newName = await promptInput(ctx, "Subagent Name (e.g. sdd-apply):");
-                if (!newName) continue;
-                agentName = newName;
-                if (!currentProfile.agents) currentProfile.agents = {};
-                currentProfile.agents[agentName] = { model: "omni/antigravity/gemini-3.6-flash-low", thinking: "low" };
-                await writeJson(PROFILES_PATH, profiles);
-              }
-
-              // Edit Agent
-              while (true) {
-                const conf = agentName === "orchestrator" ? currentProfile.orchestrator : currentProfile.agents[agentName];
-                
-                const modifierItems = [
-                  { value: "model", label: "Modify Model", description: conf?.model || "none" },
-                  { value: "thinking", label: "Modify Thinking", description: conf?.thinking || "low" },
-                  { value: "delete", label: "✖ Remove Agent from profile", description: "Delete this configuration" },
-                  { value: "back", label: "← Back", description: "" },
-                ];
-
-                const pickedMod = await ctx.ui.custom<string | null>((tui, theme, _kb, done) => {
-                  const container = new Container();
-                  container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
-                  container.addChild(new Text(theme.fg("accent", theme.bold(`Edit Agent '${agentName}'`)), 1, 0));
-                  const list = new SelectList(modifierItems, 4, {
-                    selectedPrefix: (t) => theme.fg("accent", t),
-                    selectedText: (t) => theme.fg("accent", t),
-                    description: (t) => theme.fg("muted", t),
-                    scrollInfo: (t) => theme.fg("dim", t),
-                    noMatch: (t) => theme.fg("warning", t),
-                  });
-                  list.onSelect = (item) => done(item.value);
-                  list.onCancel = () => done(null);
-                  container.addChild(list);
-                  container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
-                  return {
-                    render: (w) => container.render(w),
-                    invalidate: () => container.invalidate(),
-                    handleInput: (data) => { list.handleInput(data); tui.requestRender(); },
-                  };
-                }, { overlay: true });
-
-                if (!pickedMod || pickedMod === "back") break;
-
-                if (pickedMod === "delete") {
-                  if (agentName === "orchestrator") {
-                    ctx.ui.notify("Cannot delete orchestrator", "error");
-                  } else {
-                    delete currentProfile.agents[agentName];
-                    await writeJson(PROFILES_PATH, profiles);
-                    ctx.ui.notify(`Removed ${agentName}`, "success");
-                    break;
-                  }
-                } else if (pickedMod === "model") {
-                  const newModel = await promptInput(ctx, `Model for ${agentName}:`, conf.model);
-                  if (newModel !== null) {
-                    conf.model = newModel;
-                    await writeJson(PROFILES_PATH, profiles);
-                  }
-                } else if (pickedMod === "thinking") {
-                  const thinkingLevels = ["low", "medium", "high", "xhigh", "max"].map(t => ({ value: t, label: t }));
-                  const newThinking = await ctx.ui.custom<string | null>((tui, theme, _kb, done) => {
-                    const container = new Container();
-                    container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
-                    container.addChild(new Text(theme.fg("accent", theme.bold(`Thinking for ${agentName}`)), 1, 0));
-                    const list = new SelectList(thinkingLevels, 5, {
-                      selectedPrefix: (t) => theme.fg("accent", t),
-                      selectedText: (t) => theme.fg("accent", t),
-                      description: (t) => theme.fg("muted", t),
-                      scrollInfo: (t) => theme.fg("dim", t),
-                      noMatch: (t) => theme.fg("warning", t),
-                    });
-                    list.onSelect = (item) => done(item.value);
-                    list.onCancel = () => done(null);
-                    container.addChild(list);
-                    container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
-                    return {
-                      render: (w) => container.render(w),
-                      invalidate: () => container.invalidate(),
-                      handleInput: (data) => { list.handleInput(data); tui.requestRender(); },
-                    };
-                  }, { overlay: true });
-
-                  if (newThinking) {
-                    conf.thinking = newThinking;
-                    await writeJson(PROFILES_PATH, profiles);
-                  }
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-  });
-}
+export { default } from "./src/extension.js";

package/package.json

@@ -1,20 +1,53 @@
 {
-  "name": "pi-profiles-manager",
-  "version": "1.0.1",
-  "description": "Interactive SDD model profile management built natively for the Pi Coding Agent.",
-  "main": "index.ts",
-  "type": "module",
-  "keywords": [
-    "pi-agent-extension",
-    "pi-package"
-  ],
-  "pi": {
-    "extensions": ["index.ts"]
-  },
-  "author": "javinnav",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/javinnav/pi-profiles-manager.git"
-  }
-}
+	"name": "pi-profiles-manager",
+	"version": "1.1.1",
+	"description": "Interactive SDD model profile management built natively for the Pi Coding Agent.",
+	"main": "index.ts",
+	"type": "module",
+	"files": [
+		"index.ts",
+		"src"
+	],
+	"scripts": {
+		"dev": "npm run build -- --watch",
+		"build": "tsup index.ts --format esm --clean",
+		"typecheck": "tsc --noEmit",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"lint": "biome check .",
+		"format": "biome format --write .",
+		"package-check": "node -e \"const pkg = require('./package.json'); if (!pkg.pi || !pkg.pi.extensions) { console.error('Missing pi.extensions in package.json'); process.exit(1); }\""
+	},
+	"engines": {
+		"node": ">=22.19.0"
+	},
+	"keywords": [
+		"pi-agent-extension",
+		"pi-package"
+	],
+	"pi": {
+		"extensions": [
+			"index.ts"
+		]
+	},
+	"author": "javinnav",
+	"license": "MIT",
+	"homepage": "https://github.com/javinnav/pi-profiles-manager#readme",
+	"bugs": {
+		"url": "https://github.com/javinnav/pi-profiles-manager/issues"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/javinnav/pi-profiles-manager.git"
+	},
+	"dependencies": {
+		"@earendil-works/pi-coding-agent": "*",
+		"@earendil-works/pi-tui": "*"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.5.11",
+		"tsup": "^8.5.1",
+		"typescript": "^7.0.2",
+		"vitest": "^4.1.11"
+	}
+}