habithive-code 0.2.0 → 0.2.1

package/README.md

@@ -10,6 +10,11 @@ two things effortless:
 > them from their official sources under their own licenses. All credit for those
 > projects belongs to their authors (see [Credits](#credits)).
 
+## Prerequisites
+
+- **Node.js ≥ 18**
+- Internet access to fetch `opencode` and `oh-my-openagent` on first `habithive setup` (nothing else is required up front)
+
 ## Install
 
 ```sh
@@ -17,6 +22,22 @@ npm i -g habithive-code
 habithive setup            # full stack (below).  add --minimal to skip the extras
 ```
 
+### Clone from source (GitLab)
+
+For development, or if you'd rather run from a checkout than the published package:
+
+```sh
+git clone https://repository.hclhealthcare.in/hive/habit-hive-code.git
+cd habit-hive-code
+npm test                        # sanity check — expect "16 passed, 0 failed"
+node bin/habithive.mjs status   # smoke test without installing anything globally
+npm i -g .                      # optional: makes `habithive` available globally from this checkout
+habithive setup                 # wire opencode + oh-my-opencode + the habithive plugin
+```
+
+Cloning requires a GitLab account with access to the `hive` group on
+`repository.hclhealthcare.in` — ask your GitLab admin to add you if you don't have it yet.
+
 `habithive setup` sets up, from each tool's **official source** (nothing but the two
 skills is bundled):
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "habithive-code",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "A control layer for opencode: one-command install, live simple/complex mode switching, and a model tree for oh-my-opencode agents.",
   "type": "module",
   "bin": {

package/src/logo.js

@@ -1,14 +1,29 @@
 // habithive-code — home-screen wordmark in opencode's TUI.
 //
-// Renders a big <ascii_font> "HABITHIVE" (block font, clean outline) into the
-// `home_logo` slot. A @opentui/core renderable is a valid slot node, so there's
-// no JSX build step. We probe-construct once at register time (inside try/catch,
-// OUTSIDE opencode's render loop) so any failure aborts gracefully instead of
-// crashing the home screen — the slot is only registered if the probe succeeds.
+// Renders a big <ascii_font> "HABITHIVE" (block font: white fill, black outline —
+// same monochrome, high-contrast look as opencode's own wordmark) into the
+// `home_logo` slot, with a slow breathing-brightness animation. A @opentui/core
+// renderable is a valid slot node, so there's no JSX build step. We probe-construct
+// once at register time (inside try/catch, OUTSIDE opencode's render loop) so any
+// failure aborts gracefully instead of crashing the home screen — the slot is only
+// registered if the probe succeeds.
 
-const TEXT = "habithive";     // ascii_font uppercases it
-const FONT = "block";     // tiny | slick | block | huge | shade | grid | pallet
-const COLOR = "#7c3aed";  // violet
+const TEXT = "habithive";  // ascii_font uppercases it
+const FONT = "block";      // tiny | slick | block | huge | shade | grid | pallet
+// `block` renders two color layers: [fill, outline]. White-on-black, opencode-style.
+const FILL = "#ffffff";
+const OUTLINE = "#000000";
+const PULSE_MS = 90;       // animation frame interval
+const PULSE_STEPS = 40;    // full breathing cycle length
+
+// Brightness for step i of a triangle-wave breathing cycle, as a hex gray "#rrggbb".
+function breathGray(i) {
+  const t = i / PULSE_STEPS; // 0..1
+  const tri = t < 0.5 ? t * 2 : (1 - t) * 2; // 0 -> 1 -> 0
+  const v = Math.round(150 + tri * 105); // 150..255, never fully dims out
+  const hex = v.toString(16).padStart(2, "0");
+  return `#${hex}${hex}${hex}`;
+}
 
 export async function registerLogo(api) {
   try {
@@ -18,11 +33,15 @@ export async function registerLogo(api) {
     try { rctx = (rnd && rnd.renderContext) || (rnd && rnd.root && rnd.root.ctx) || null; } catch {}
     if (!rctx) return;
 
-    let AsciiFont;
-    try { AsciiFont = (await import("@opentui/core")).ASCIIFontRenderable; } catch { return; }
+    let AsciiFont, RenderableEvents;
+    try {
+      const mod = await import("@opentui/core");
+      AsciiFont = mod.ASCIIFontRenderable;
+      RenderableEvents = mod.RenderableEvents;
+    } catch { return; }
     if (typeof AsciiFont !== "function") return;
 
-    const make = () => new AsciiFont(rctx, { text: TEXT, font: FONT, color: COLOR });
+    const make = () => new AsciiFont(rctx, { text: TEXT, font: FONT, color: [FILL, OUTLINE] });
 
     // Prove construction works before registering (a throw here is caught → no crash).
     try {
@@ -30,7 +49,31 @@ export async function registerLogo(api) {
       if (probe && typeof probe.destroyRecursively === "function") probe.destroyRecursively();
     } catch { return; }
 
-    api.slots.register({ slots: { home_logo: () => make() } });
+    api.slots.register({
+      slots: {
+        home_logo: () => {
+          const node = make();
+          try {
+            let step = 0;
+            const timer = setInterval(() => {
+              try {
+                step = (step + 1) % PULSE_STEPS;
+                node.color = [breathGray(step), OUTLINE];
+              } catch { clearInterval(timer); }
+            }, PULSE_MS);
+            const stop = () => clearInterval(timer);
+            if (RenderableEvents && typeof node.once === "function") {
+              node.once(RenderableEvents.DESTROYED, stop);
+            } else if (typeof node.on === "function") {
+              node.on("destroyed", stop);
+            }
+          } catch {
+            // animation is best-effort; a static logo still renders if this fails
+          }
+          return node;
+        },
+      },
+    });
   } catch {
     // never break the home screen
   }