@mrclrchtr/supi-extras 1.8.0 → 1.9.0

package/README.md

@@ -1,3 +1,5 @@
+![SuPi](assets/logo.png)
+
 # @mrclrchtr/supi-extras
 
 Adds a bundle of small quality-of-life features to the [pi coding agent](https://github.com/earendil-works/pi).
@@ -14,7 +16,7 @@ For local development:
 pi install ./packages/supi-extras
 ```
 
-After editing the source, run `/reload`.
+![Stash picker overlay](https://raw.githubusercontent.com/mrclrchtr/supi/main/screenshots/supi-extras-stash.png)
 
 ## What you get
 

package/node_modules/@mrclrchtr/supi-core/README.md

@@ -1,29 +1,20 @@
+![SuPi](assets/logo.png)
+
 # @mrclrchtr/supi-core
 
 Shared infrastructure for SuPi extensions.
 
-This package is mainly for extension authors. It gives you a common config system, settings plumbing, context helpers, registries, and a small extension surface that registers `/supi-settings`.
+This is a **pure library** — it does not register any pi commands or tools. The `/supi-settings` command is now available through `@mrclrchtr/supi-settings`.
 
 ## Install
 
-### As a dependency for another extension
-
 ```bash
 pnpm add @mrclrchtr/supi-core
 ```
 
-### As a pi package
-
-```bash
-pi install npm:@mrclrchtr/supi-core
-```
-
-Installing it as a pi package adds the minimal `/supi-settings` extension surface.
-
 ## Package surfaces
 
 - `@mrclrchtr/supi-core/api` — reusable helpers for other packages and extensions
-- `@mrclrchtr/supi-core/extension` — minimal pi extension that registers `/supi-settings`
 
 ## What you get from the API
 
@@ -101,7 +92,6 @@ const message = wrapExtensionContext("my-extension", "hello", {
 ## Source
 
 - `src/api.ts` — exported library surface
-- `src/extension.ts` — minimal `/supi-settings` entrypoint
 - `src/config.ts` — shared config loading and writing
 - `src/config-settings.ts` — config-backed settings registration helper
 - `src/settings-ui.ts` — shared settings overlay

package/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {
@@ -40,7 +40,6 @@
     "./config": "./src/config.ts",
     "./context": "./src/context.ts",
     "./debug": "./src/debug-registry.ts",
-    "./extension": "./src/extension.ts",
     "./package.json": "./package.json",
     "./path": "./src/path.ts",
     "./project": "./src/project.ts",
@@ -50,10 +49,5 @@
     "./terminal": "./src/terminal.ts",
     "./tool-framework": "./src/tool-framework.ts",
     "./types": "./src/types.ts"
-  },
-  "pi": {
-    "extensions": [
-      "./src/extension.ts"
-    ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-extras",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "SuPi extras — command aliases, skill shorthand, tab spinner, /supi-stash prompt stash with TUI overlay, and other small utilities",
   "license": "MIT",
   "repository": {
@@ -21,7 +21,7 @@
   ],
   "dependencies": {
     "clipboardy": "^5.3.1",
-    "@mrclrchtr/supi-core": "1.8.0"
+    "@mrclrchtr/supi-core": "1.9.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-core"
@@ -41,9 +41,9 @@
   },
   "pi": {
     "extensions": [
-      "./src/extension.ts",
-      "node_modules/@mrclrchtr/supi-core/src/extension.ts"
-    ]
+      "./src/extension.ts"
+    ],
+    "image": "https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-extras/assets/logo.png"
   },
   "exports": {
     "./api": "./src/api.ts",

package/src/tab-spinner.ts

@@ -15,6 +15,18 @@ import { formatTitle, signalDone } from "@mrclrchtr/supi-core/terminal";
 const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 const AGENT_END_SETTLE_MS = 200;
 
+/** Icons shown in the terminal title when a review phase completes. */
+const BRIEF_DONE_ICON = "\u{1F4CB}"; // 📋 clipboard
+const REVIEW_DONE_ICON = "\u{1F50D}"; // 🔍 magnifying glass
+const REVIEW_FAILED_ICON = "\u2717"; // ✗ ballot x
+
+type ReviewTitleState =
+  | { kind: "none" }
+  | { kind: "brief-done" }
+  | { kind: "brief-failed" }
+  | { kind: "review-done" }
+  | { kind: "review-failed" };
+
 // biome-ignore lint/complexity/noExcessiveLinesPerFunction: spinner state and event wiring are intentionally colocated
 export default function tabSpinner(pi: ExtensionAPI) {
   let timer: ReturnType<typeof setInterval> | null = null;
@@ -24,6 +36,7 @@ export default function tabSpinner(pi: ExtensionAPI) {
   let hasActiveAgent = false;
   let pendingAgentEnd = false;
   let askUserActive = 0;
+  let reviewTitleState: ReviewTitleState = { kind: "none" };
   let currentCtx: ExtensionContext | undefined;
   let cachedSessionName: string | undefined;
   let cachedCwd: string | undefined;
@@ -34,6 +47,39 @@ export default function tabSpinner(pi: ExtensionAPI) {
     return formatTitle(getSessionNameSafe(), cachedCwd);
   }
 
+  /** Set the terminal title to the review-phase icon if one is active. */
+  function applyReviewTitle(): boolean {
+    if (timer) return false; // spinner is active, don't override
+
+    const baseTitle = title();
+    const icon = reviewTitleIcon();
+    if (!icon) return false;
+
+    safelySetTitle(`${icon} ${baseTitle}`);
+    return true;
+  }
+
+  /** Return the appropriate review title icon, or empty string when idle. */
+  function reviewTitleIcon(): string {
+    switch (reviewTitleState.kind) {
+      case "brief-done":
+        return BRIEF_DONE_ICON;
+      case "brief-failed":
+        return REVIEW_FAILED_ICON;
+      case "review-done":
+        return REVIEW_DONE_ICON;
+      case "review-failed":
+        return REVIEW_FAILED_ICON;
+      case "none":
+        return "";
+    }
+  }
+
+  /** Clear any active review title state and let normal title logic resume. */
+  function clearReviewTitle() {
+    reviewTitleState = { kind: "none" };
+  }
+
   function clearPendingAgentEnd() {
     pendingAgentEnd = false;
     if (pendingAgentEndTimer) {
@@ -85,24 +131,24 @@ export default function tabSpinner(pi: ExtensionAPI) {
     }
   }
 
-  /** Restore the base title immediately. */
+  /** Restore the base title, or show the review icon if one is active. */
   function stop() {
     clearPendingAgentEnd();
     clearSpinnerTimer();
     frame = 0;
-    const baseTitle = title();
-    safelySetTitle(baseTitle);
+    if (applyReviewTitle()) return;
+    safelySetTitle(title());
   }
 
-  /** Show the ✓ done symbol in the title and play the terminal bell. */
+  /** Show the ✓ done symbol, or the review icon if one is active. */
   function showDone() {
     clearPendingAgentEnd();
     clearSpinnerTimer();
     frame = 0;
-    const baseTitle = title();
     if (!currentCtx) return;
+    if (applyReviewTitle()) return;
     try {
-      signalDone(currentCtx, baseTitle);
+      signalDone(currentCtx, title());
     } catch {
       handleStaleContext();
     }
@@ -172,6 +218,7 @@ export default function tabSpinner(pi: ExtensionAPI) {
   });
 
   pi.on("agent_start", async (_event, ctx) => {
+    clearReviewTitle();
     if (pendingAgentEnd) {
       resumePendingAgent(ctx);
       return;
@@ -191,6 +238,7 @@ export default function tabSpinner(pi: ExtensionAPI) {
 
   pi.on("session_shutdown", async (_event, ctx) => {
     unregisterEvents();
+    clearReviewTitle();
     activeCount = 0;
     rememberContext(ctx);
     stop();
@@ -217,4 +265,22 @@ export default function tabSpinner(pi: ExtensionAPI) {
       if (askUserActive === 0 && activeCount > 0) start();
     }),
   );
+
+  unregisterBusHandlers.push(
+    pi.events.on("supi:review:brief-done", (payload: unknown) => {
+      const data = payload as { kind: string };
+      reviewTitleState =
+        data.kind === "success" ? { kind: "brief-done" } : { kind: "brief-failed" };
+      applyReviewTitle();
+    }),
+  );
+
+  unregisterBusHandlers.push(
+    pi.events.on("supi:review:review-done", (payload: unknown) => {
+      const data = payload as { kind: string };
+      reviewTitleState =
+        data.kind === "success" ? { kind: "review-done" } : { kind: "review-failed" };
+      applyReviewTitle();
+    }),
+  );
 }

package/node_modules/@mrclrchtr/supi-core/src/extension.ts

@@ -1 +0,0 @@
-export { registerSettingsCommand as default } from "./settings/settings-command.ts";