pi-keyboard 0.1.1 → 0.1.2

package/features/keyboard.feature

@@ -58,8 +58,8 @@ Feature: Pi Keyboard Lighting Indicator
     Given a user has submitted a prompt or the agent is executing a turn
     When the agent starts thinking or executing tools
     Then the keyboard state machine updates to "thinking"
-    And the keyboard lighting is set to blue color
-    And the effect mode is set to breathing
+    And the transition is buffered with a gentle intermediate ramp to avoid abrupt visual changes
+    And the keyboard lighting is set to softened oceanic blue breathing
     And the update is applied with --no-save in memory
 
   Scenario: Pi transitions to need approval state with yellow blinking light

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-keyboard",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Dynamic VIA/QMK keyboard RGB lighting indicator reflecting Pi states (idle, thinking, unread, need-approval, error)",
   "author": "Frad LEE <fradser@gmail.com>",
   "license": "MIT",

package/src/driver.ts

@@ -22,7 +22,7 @@ export function resolveCliPath(customPath?: string): string {
 
   const standardPaths = [
     join(homedir(), ".local", "bin", "via-rgb"),
-    "/opt/homebrew/bin/via-rgb",
+    "/opt/homebrew/bin", "via-rgb",
     "/usr/local/bin/via-rgb",
   ];
 
@@ -42,6 +42,8 @@ export interface HardwareApplyResult {
   error?: string;
 }
 
+const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
+
 export async function applyKeyboardState(
   state: KeyboardState,
   config: KeyboardConfig,
@@ -71,7 +73,27 @@ export async function applyKeyboardState(
 
   const task = async (): Promise<HardwareApplyResult> => {
     try {
-      // Set color, effect, speed, brightness in memory
+      // If state specifies smooth ramp (e.g. thinking blue), apply a gentle buffered transition
+      if (def.smoothRamp) {
+        const intermediateSat = Math.round(def.sat * 0.6);
+        const intermediateBrightness = Math.round(targetBrightness * 0.9);
+        const rampArgs = [
+          ...baseArgs,
+          "set",
+          "-b",
+          String(intermediateBrightness),
+          "-e",
+          String(def.effect),
+          "-s",
+          "100",
+          "-c",
+          `${def.hue} ${intermediateSat}`,
+        ];
+        await execFileAsync(cli, rampArgs, { timeout: 3000 });
+        await sleep(150); // 150ms graceful transition buffer
+      }
+
+      // Set final color, effect, speed, brightness in memory
       const setArgs = [
         ...baseArgs,
         "set",

package/src/types.ts

@@ -20,6 +20,7 @@ export interface KeyboardStateDefinition {
   brightness: number;
   pattern: KeyboardPattern;
   blinkCount?: number;
+  smoothRamp?: boolean;
 }
 
 export interface KeyboardConfig {
@@ -45,7 +46,7 @@ export const KEYBOARD_STATE_DEFINITIONS: Record<KeyboardState, KeyboardStateDefi
     hue: 0,
     sat: 0, // White
     effect: 2, // Breathing
-    speed: 100,
+    speed: 90,
     brightness: 180,
     pattern: "breathing",
   },
@@ -54,22 +55,23 @@ export const KEYBOARD_STATE_DEFINITIONS: Record<KeyboardState, KeyboardStateDefi
     label: "Green Breathing (Unread Chat)",
     labelZh: "绿色 呼吸灯 (未读消息)",
     hue: 85, // Green
-    sat: 255,
+    sat: 240,
     effect: 2, // Breathing
-    speed: 150,
-    brightness: 220,
+    speed: 130,
+    brightness: 210,
     pattern: "breathing",
   },
   thinking: {
     state: "thinking",
     label: "Blue Breathing (Thinking)",
     labelZh: "蓝色 呼吸灯 (正在思考/执行)",
-    hue: 170, // Blue
-    sat: 255,
+    hue: 165, // Calm oceanic blue (softened from harsh 170)
+    sat: 210, // Softened saturation (non-glaring)
     effect: 2, // Breathing
-    speed: 200,
-    brightness: 255,
+    speed: 120, // Calmed, gentle cadence (softened from 200)
+    brightness: 195, // Balanced ambient level (smooth from 180)
     pattern: "breathing",
+    smoothRamp: true,
   },
   need_approval: {
     state: "need_approval",