plugin-gentleman 1.0.9 → 1.1.1

package/README.md

@@ -98,7 +98,7 @@ The ASCII representation features:
 - **Eyes** that blink and look in 8 directions (center, up, down, left, right, and 4 diagonals) *(sidebar only)*
 - **Mustache** rendered in grayscale gradient on home screen, semantic zone colors in sidebar
 - **Tongue** that appears during busy states or periodic expressive cycles *(sidebar only)*
-- **Motivational phrases** in Rioplatense Spanish style — 2-3 random phrases rotating every 3s *(sidebar only)*
+- **Motivational phrases** in Rioplatense Spanish style — single random phrase rotating every 3s *(sidebar only)*
 
 **Example phrases during busy states:**
 - *"Ponete las pilas, hermano..."*
@@ -124,9 +124,9 @@ The ASCII representation features:
 - Returns to center frequently for natural feel
 
 **Busy/Expressive State** *(when `animations: true`)*
-- Tongue appears progressively when OpenCode is processing
+- Tongue appears when OpenCode is processing
 - Eyes squint during expressive state
-- 2-3 random motivational phrases rotating every 3 seconds (36+ phrase library)
+- Single motivational phrase rotating every 3 seconds (36+ phrase library)
 - Active during detected busy states OR periodic expressive cycles
 
 **Expressive Cycle Fallback** *(when `animations: true`)*
@@ -388,7 +388,7 @@ The plugin is organized into focused modules for easy customization:
 **Adding new content:**
 
 - **Motivational phrases:** Edit `phrases.ts` — add new phrases to the `busyPhrases` array (currently 36+ phrases)
-- **ASCII art frames:** Edit `ascii-frames.ts` — modify eye positions (9 variants), blink frames (3 stages), mustache designs, or tongue frames (3 growth stages)
+- **ASCII art frames:** Edit `ascii-frames.ts` — modify eye positions (9 variants), blink frames (3 stages), mustache designs, or tongue states (binary on/off)
 - **UI logic:** Edit `components.tsx` — adjust animation timings, add new effects, or tweak component layout
 - **Configuration:** Edit `config.ts` — add new config options with type-safe defaults
 - **Detection logic:** Edit `detection.ts` — add new OS detection patterns or provider mappings
@@ -404,17 +404,17 @@ The plugin is organized into focused modules for easy customization:
 **Animation timing customization:**
 
 All animation intervals are in `components.tsx`:
-- **Look-around interval:** Line 79 — currently 3000ms (3s)
-- **Blink interval:** Line 107 — currently 2000ms with 35% chance (~5-6s average)
-- **Blink frame timing:** Lines 91-98 — currently 80-100ms per frame progression
-- **Phrase rotation:** Line 168 — currently 3000ms (3s) during expressive state
-- **Expressive cycle timing:** Lines 193-198 — first cycle at 30-45s, then every 45-60s
-- **Expressive cycle duration:** Line 189 — currently 8000ms (8s)
+- **Look-around interval:** Currently 3000ms (3s)
+- **Blink interval:** Currently 2000ms with 35% chance (~5-6s average)
+- **Blink frame timing:** Currently 80-100ms per frame progression
+- **Phrase rotation:** Currently 3000ms (3s) during expressive state
+- **Expressive cycle timing:** First cycle at 30-45s, then every 45-60s
+- **Expressive cycle duration:** Currently 8000ms (8s)
 
 **Color customization:**
 
 - **Zone colors (sidebar):** Edit `zoneColors` object in `ascii-frames.ts` (monocle, eyes, mustache, tongue)
-- **Home grayscale gradient:** Edit `HomeLogo` component in `components.tsx` (lines 22-24)
+- **Home grayscale gradient:** Edit `HomeLogo` component in `components.tsx` (top/middle/bottom color values)
 - **Theme colors:** Edit `gentleman.json` for the full color palette
 
 ---

package/ascii-frames.ts

@@ -9,15 +9,15 @@
 export const eyeNeutralCenter = [
   "     █████       █████     ",  // 27 chars
   "   ██░░░░░██   ██░░░░░██   ",  // 27 chars
-  "  ██░░███░░██ ██░░░░░░░██  ",  // 27 chars - pupils center
-  "  ██░░███░░██ ██░░░░░░░██  ",  // 27 chars - pupils center
+  "  ██░░   ░░██ ██░░░░░░░██  ",  // 27 chars - hollow pupil center
+  "  ██░░   ░░██ ██░░░░░░░██  ",  // 27 chars - hollow pupil center
   "██ ██░░░░░██   ██░░░░░██ ██",  // 27 chars
 ]
 
 export const eyeNeutralUp = [
   "     █████       █████     ",  // 27 chars
-  "   ██████░██   ██░░░░░██   ",  // 27 chars - pupils up
-  "  ██░█████░██ ██░░░░░░░██  ",  // 27 chars - pupils up
+  "   ██░░   ██   ██░░░░░██   ",  // 27 chars - hollow pupil up
+  "  ██░░░  ░░██ ██░░░░░░░██  ",  // 27 chars - hollow pupil up
   "  ██░░░░░░░██ ██░░░░░░░██  ",  // 27 chars
   "██ ██░░░░░██   ██░░░░░██ ██",  // 27 chars
 ]
@@ -26,38 +26,38 @@ export const eyeNeutralDown = [
   "     █████       █████     ",  // 27 chars
   "   ██░░░░░██   ██░░░░░██   ",  // 27 chars
   "  ██░░░░░░░██ ██░░░░░░░██  ",  // 27 chars
-  "  ██░░███░░██ ██░░░░░░░██  ",  // 27 chars - pupils down
-  "██ ██████░░██   ██░░░░░██ ██",  // 27 chars - pupils down
+  "  ██░░   ░░██ ██░░░░░░░██  ",  // 27 chars - hollow pupil down
+  "██ ██░░  ░██   ██░░░░░██ ██",  // 27 chars - hollow pupil down
 ]
 
 export const eyeNeutralLeft = [
   "     █████       █████     ",  // 27 chars
   "   ██░░░░░██   ██░░░░░██   ",  // 27 chars
-  "  ██████░░░██ ██░░░░░░░██  ",  // 27 chars - pupils left
-  "  ██████░░░██ ██░░░░░░░██  ",  // 27 chars - pupils left
+  "  ██   ░░░░██ ██░░░░░░░██  ",  // 27 chars - hollow pupil left
+  "  ██   ░░░░██ ██░░░░░░░██  ",  // 27 chars - hollow pupil left
   "██ ██░░░░░██   ██░░░░░██ ██",  // 27 chars
 ]
 
 export const eyeNeutralRight = [
   "     █████       █████     ",  // 27 chars
   "   ██░░░░░██   ██░░░░░██   ",  // 27 chars
-  "  ██░░░██████ ██░░░░░░░██  ",  // 27 chars - pupils right
-  "  ██░░░██████ ██░░░░░░░██  ",  // 27 chars - pupils right
+  "  ██░░░░░  ██ ██░░░░░░░██  ",  // 27 chars - hollow pupil right
+  "  ██░░░░░  ██ ██░░░░░░░██  ",  // 27 chars - hollow pupil right
   "██ ██░░░░░██   ██░░░░░██ ██",  // 27 chars
 ]
 
 export const eyeNeutralUpLeft = [
   "     █████       █████     ",  // 27 chars
-  "   ███████░██  ██░░░░░██   ",  // 27 chars - up-left diagonal
-  "  ████████░██ ██░░░░░░░██  ",  // 27 chars - up-left diagonal
+  "   ██   ░░██   ██░░░░░██   ",  // 27 chars - hollow pupil up-left
+  "  ██  ░░░░░██ ██░░░░░░░██  ",  // 27 chars - hollow pupil up-left
   "  ██░░░░░░░██ ██░░░░░░░██  ",  // 27 chars
   "██ ██░░░░░██   ██░░░░░██ ██",  // 27 chars
 ]
 
 export const eyeNeutralUpRight = [
   "     █████       █████     ",  // 27 chars
-  "   ██░███████  ██░░░░░██   ",  // 27 chars - up-right diagonal
-  "  ██░████████ ██░░░░░░░██  ",  // 27 chars - up-right diagonal
+  "   ██░░░░  ██  ██░░░░░██   ",  // 27 chars - hollow pupil up-right
+  "  ██░░░░░  ██ ██░░░░░░░██  ",  // 27 chars - hollow pupil up-right
   "  ██░░░░░░░██ ██░░░░░░░██  ",  // 27 chars
   "██ ██░░░░░██   ██░░░░░██ ██",  // 27 chars
 ]
@@ -66,23 +66,23 @@ export const eyeNeutralDownLeft = [
   "     █████       █████     ",  // 27 chars
   "   ██░░░░░██   ██░░░░░██   ",  // 27 chars
   "  ██░░░░░░░██ ██░░░░░░░██  ",  // 27 chars
-  "  ███████░░██ ██░░░░░░░██  ",  // 27 chars - down-left diagonal
-  "██ ████████░█   ██░░░░░██ ██",  // 27 chars - down-left diagonal
+  "  ██  ░░░░░██ ██░░░░░░░██  ",  // 27 chars - hollow pupil down-left
+  "██ ██ ░░░░██   ██░░░░░██ ██",  // 27 chars - hollow pupil down-left
 ]
 
 export const eyeNeutralDownRight = [
   "     █████       █████     ",  // 27 chars
   "   ██░░░░░██   ██░░░░░██   ",  // 27 chars
   "  ██░░░░░░░██ ██░░░░░░░██  ",  // 27 chars
-  "  ██░░░███████ ██░░░░░░░██  ",  // 27 chars - down-right diagonal
-  "██ ██░████████  ██░░░░░██ ██",  // 27 chars - down-right diagonal
+  "  ██░░░░░  ██ ██░░░░░░░██  ",  // 27 chars - hollow pupil down-right
+  "██ ██░░░░ ██   ██░░░░░██ ██",  // 27 chars - hollow pupil down-right
 ]
 
 // Squinted eyes version for busy/expressive state
 export const eyeSquinted = [
   "     █████       █████     ",  // 27 chars
   "   ██░░░░░██   ██░░░░░██   ",  // 27 chars
-  "  ██░░███░░██ ██░░░░░░░██  ",  // 27 chars
+  "  ██░░   ░░██ ██░░░░░░░██  ",  // 27 chars
   "   █████████   █████████   ",  // 27 chars
   "██  █████         █████  ██",  // 27 chars
 ]
@@ -91,8 +91,8 @@ export const eyeSquinted = [
 export const eyeBlinkHalf = [
   "     █████       █████     ",  // 27 chars - monocle border top unchanged
   "   █████████   ██████████  ",  // 27 chars - upper eyelid descends halfway
-  "  ██░░███░░██ ██░░░░░░░██  ",  // 27 chars - pupils still visible
-  "  ██░░███░░██ ██░░░░░░░██  ",  // 27 chars - pupils still visible
+  "  ██░░   ░░██ ██░░░░░░░██  ",  // 27 chars - pupils still visible
+  "  ██░░   ░░██ ██░░░░░░░██  ",  // 27 chars - pupils still visible
   "██ ██░░░░░██   ██░░░░░██ ██",  // 27 chars - bottom unchanged
 ]
 

package/components.tsx

@@ -161,11 +161,13 @@ export const SidebarMustachi = (props: { theme: TuiThemeCurrent; config: Cfg; is
   createEffect(() => {
     if (!props.config.animations || props.isBusy) return
 
+    let cycleEndTimeout: NodeJS.Timeout | undefined
+
     const triggerExpressiveCycle = () => {
       setExpressiveCycle(true)
 
       // End expressive cycle after 8 seconds
-      setTimeout(() => {
+      cycleEndTimeout = setTimeout(() => {
         setExpressiveCycle(false)
       }, 8000)
     }
@@ -181,6 +183,11 @@ export const SidebarMustachi = (props: { theme: TuiThemeCurrent; config: Cfg; is
     onCleanup(() => {
       clearTimeout(firstTimeout)
       clearInterval(interval)
+      if (cycleEndTimeout !== undefined) {
+        clearTimeout(cycleEndTimeout)
+      }
+      // Explicitly reset expressive cycle state to prevent sticking
+      setExpressiveCycle(false)
     })
   })
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "plugin-gentleman",
-  "version": "1.0.9",
+  "version": "1.1.1",
   "description": "OpenCode TUI plugin featuring Mustachi - an animated ASCII mascot with eyes, mustache, and optional motivational phrases during busy states",
   "type": "module",
   "exports": {

package/tui.tsx

@@ -19,20 +19,35 @@ const tui: TuiPlugin = async (api, options) => {
   const [value] = createSignal(boot)
   const [isBusy, setIsBusy] = createSignal(false)
 
-  await api.theme.install("./gentleman.json")
-  if (value().set_theme) {
-    api.theme.set(value().theme)
+  // Theme setup - wrapped in try-catch to avoid breaking plugin bootstrap
+  try {
+    await api.theme.install("./gentleman.json")
+    if (value().set_theme) {
+      api.theme.set(value().theme)
+    }
+  } catch (error) {
+    // Theme installation failed - log but continue with slot registration
+    // Plugin will still render with default theme
+    console.error("[plugin-gentleman] Theme setup failed:", error)
   }
 
   // Detect busy state if API exposes it
-  // This is a best-effort detection - OpenCode TUI may or may not expose this
+  // Note: Best-effort detection - OpenCode TUI may not expose session.running
+  // If unavailable, isBusy remains false and expressive cycle fallback handles animations
   createEffect(() => {
     try {
-      // Check if there's a running agent or session state
-      const hasRunningSession = api.state?.session?.running
-      setIsBusy(!!hasRunningSession)
+      // Attempt to reactively track running state if API supports it
+      // This may or may not work depending on OpenCode version
+      if (api.state?.session?.running !== undefined) {
+        setIsBusy(!!api.state.session.running)
+      } else {
+        // API doesn't expose running state - degrade gracefully
+        // Expressive cycle fallback in components.tsx will demonstrate animations
+        setIsBusy(false)
+      }
     } catch {
-      // If API doesn't expose this, animations will just use idle state
+      // If API doesn't expose this at all, stay in idle state
+      // Periodic expressive cycles ensure animations are still visible
       setIsBusy(false)
     }
   })