pi-profiles-manager 1.0.1

package/README.md

@@ -0,0 +1,96 @@
+# pi-profiles-manager 🚀
+
+Interactive SDD model profile management built natively for the [Pi Coding Agent](https://github.com/earendil-works/pi-mono).
+
+Manage your Gentle AI `models.json` configurations dynamically from a beautiful Terminal User Interface (TUI) without ever leaving your session.
+
+---
+
+## 🌟 Features
+
+### 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.
+
+### 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.
+
+---
+
+## 📸 Interface Preview (Compact Format)
+
+```text
+Profiles Manager
+──────────────────────────────────────────────────
+> ✨ Create New Profile from Current Config
+  FREE
+  antigravity
+  deus
+
+↑↓ navigate • enter select • esc close
+```
+
+```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
+```
+
+```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
+```
+
+---
+
+## 🛠 Installation
+
+Clone this repository directly into your Pi extensions directory:
+
+```bash
+git clone https://github.com/javinnav/pi-profiles-manager.git ~/.pi/agent/extensions/profiles-manager
+```
+
+Apply the changes immediately by reloading the active session:
+
+```text
+/reload
+```
+
+---
+
+## 🚀 Usage
+
+*Ensure the active Pi Session recognizes the newly linked extension context.*
+
+Open the Profiles Manager by triggering its slash command:
+
+```text
+/profiles
+```
+
+Alternatively, to quickly snapshot your current session's `models.json` without routing through the UI:
+
+```text
+/profiles save <profile-name>
+```
+
+---
+
+## 💖 Credits and Acknowledgments
+
+- **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).

package/index.ts

@@ -0,0 +1,352 @@
+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);
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+  });
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "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"
+  }
+}