@robhowley/spinner-verbs 1.0.1 → 2.1.2

package/README.md

@@ -30,7 +30,7 @@ Or directly from GitHub:
 pi install git:github.com/robhowley/spinner-verbs
 ```
 
-That's it. The extension registers automatically and picks up your configuration on the next session start.
+That's it. The extension registers automatically and on the next session start will randomly pick a theme for you.
 
 ### Switching Themes with `/verbs`
 
@@ -39,16 +39,25 @@ Change your verb list at any time during a session:
 ```
 /verbs game-of-thrones
 /verbs doc-emrick
+/verbs random
 /verbs (default)
 ```
 
-Run `/verbs` with no argument to get an interactive picker. Use `(default)` to restore Claude's built-in spinner.
+Run `/verbs` with no argument to get an interactive picker. Use `random` to pick a new random theme, or `(default)` to restore Claude's built-in spinner.
 
 ### Auto-configure via `settings.json`
 
 Set your preferred theme once and forget about it. Pi checks both project-local (`.pi/settings.json`) and global (`~/.pi/agent/settings.json`) settings on session start.
 
-**Use a built-in theme by name:**
+**Randomly pick a theme each session (default):**
+
+```json
+{
+  "spinnerVerbs": "random"
+}
+```
+
+**Use a specific built-in theme by name:**
 
 ```json
 {
@@ -142,3 +151,5 @@ Add the spinner verbs configuration:
 | `game-show` | Come on down..., Survey says..., Is that your final answer... |
 | `doc-emrick` | Shunting..., Sliding..., Fiddling...                          |
 | `momentum` | Making moves..., Spinning up..., Getting traction...          |
+
+Use `"spinnerVerbs": "random"` to have a theme randomly selected from the list above at each session start.

package/extensions/spinner-verbs.ts

@@ -13,26 +13,40 @@ export default function (pi: ExtensionAPI) {
     .map((f) => basename(f, ".json"));
 
   const DEFAULT = "(default)";
-  const availableWithDefault = [...available, DEFAULT];
+  const RANDOM = "random";
+  const availableWithDefault = [...available, RANDOM, DEFAULT];
+  const validChoices = new Set(availableWithDefault);
+
+  function parseVerbsData(data: unknown): string[] | undefined {
+    const verbs = (data as any)?.spinnerVerbs?.verbs ?? data;
+    return Array.isArray(verbs) && verbs.length > 0 ? verbs : undefined;
+  }
 
   function loadVerbs(name: string): string[] {
     const data = JSON.parse(readFileSync(join(verbsDir, `${name}.json`), "utf-8"));
-    return data?.spinnerVerbs?.verbs ?? data;
+    const verbs = parseVerbsData(data);
+    if (!verbs) throw new Error(`Failed to parse verbs from ${name}.json`);
+    return verbs;
+  }
+
+  function randomVerbs(): string[] {
+    const name = available[Math.floor(Math.random() * available.length)];
+    return loadVerbs(name);
   }
 
   pi.registerFlag("verbs", {
     description: `Spinner verb list (${available.join(", ")})`,
     type: "string",
-    default: "(default)",
+    default: DEFAULT,
   });
 
   let interval: ReturnType<typeof setInterval> | undefined;
 
   function activate(verbs: string[], ctx: ExtensionContext) {
     clearInterval(interval);
-    const pick = () => verbs[Math.floor(Math.random() * verbs.length)];
-    ctx.ui.setWorkingMessage(`${pick()}...`);
-    interval = setInterval(() => ctx.ui.setWorkingMessage(`${pick()}...`), 3000);
+    const tick = () => ctx.ui.setWorkingMessage(`${verbs[Math.floor(Math.random() * verbs.length)]}...`);
+    tick();
+    interval = setInterval(tick, 3000);
   }
 
   function readSettings(settingsPath: string): Record<string, unknown> | undefined {
@@ -49,8 +63,9 @@ export default function (pi: ExtensionAPI) {
     if (!settings) return undefined;
 
     const named = settings.spinnerVerbs;
-    if (typeof named === "string" && available.includes(named)) {
-      return loadVerbs(named);
+    if (typeof named === "string") {
+      if (named === RANDOM) return randomVerbs();
+      if (available.includes(named)) return loadVerbs(named);
     }
 
     const filePath = settings.spinnerVerbsFile;
@@ -62,9 +77,8 @@ export default function (pi: ExtensionAPI) {
         : join(dirname(settingsPath), filePath);
       if (existsSync(resolved)) {
         try {
-          const data = JSON.parse(readFileSync(resolved, "utf-8"));
-          const verbs = data?.spinnerVerbs?.verbs ?? data;
-          if (Array.isArray(verbs) && verbs.length > 0) return verbs;
+          const verbs = parseVerbsData(JSON.parse(readFileSync(resolved, "utf-8")));
+          if (verbs) return verbs;
         } catch {}
       }
     }
@@ -79,8 +93,9 @@ export default function (pi: ExtensionAPI) {
 
     let verbs: string[] | undefined;
 
-    if (flag && flag !== "(default)" && available.includes(flag)) {
-      verbs = loadVerbs(flag);
+    if (flag && flag !== DEFAULT) {
+      if (flag === RANDOM) verbs = randomVerbs();
+      else if (available.includes(flag)) verbs = loadVerbs(flag);
     }
 
     verbs ??= resolveVerbs(projectSettings) ?? resolveVerbs(globalSettings);
@@ -98,7 +113,7 @@ export default function (pi: ExtensionAPI) {
     },
     handler: async (args, ctx) => {
       const arg = args?.trim();
-      if (arg && arg !== DEFAULT && !available.includes(arg)) {
+      if (arg && !validChoices.has(arg)) {
         ctx.ui.notify(`Unknown verb list: ${arg}. Available: ${availableWithDefault.join(", ")}`, "error");
         return;
       }
@@ -108,6 +123,9 @@ export default function (pi: ExtensionAPI) {
         clearInterval(interval);
         ctx.ui.setWorkingMessage();
         ctx.ui.notify("Restored default spinner", "info");
+      } else if (choice === RANDOM) {
+        activate(randomVerbs(), ctx);
+        ctx.ui.notify("Spinner: random", "info");
       } else {
         activate(loadVerbs(choice), ctx);
         ctx.ui.notify(`Spinner: ${choice}`, "info");

package/package.json

@@ -1,10 +1,29 @@
 {
   "name": "@robhowley/spinner-verbs",
-  "version": "1.0.1",
+  "version": "2.1.2",
   "description": "Replace boring LLM spinner verbs with themes that have a little more personality.",
+  "author": "Rob Howley",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/robhowley/spinner-verbs"
+  },
+  "homepage": "https://github.com/robhowley/spinner-verbs",
+  "bugs": {
+    "url": "https://github.com/robhowley/spinner-verbs/issues"
+  },
   "keywords": [
     "pi-package"
   ],
+  "files": [
+    "extensions",
+    "spinner-verbs",
+    "LICENSE",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
   "pi": {
     "extensions": [
       "./extensions"