From 17a1991e3c0c6eb7f699e3175b4700ab8aff52e6 Mon Sep 17 00:00:00 2001
From: mohamed_amine_hamdi <amine@1dev.space>
Date: Tue, 27 Jan 2026 00:10:58 +0100
Subject: [PATCH 1/2] Docs: add sticky navbar CSS for Mintlify

---
 docs/assets/mintlify-navbar.css | 35 +++++++++++++++++++++++++++++++++
 docs/docs.json                  |  1 +
 docs/install/node.md            | 20 +++++++++----------
 3 files changed, 46 insertions(+), 10 deletions(-)
 create mode 100644 docs/assets/mintlify-navbar.css

diff --git a/docs/assets/mintlify-navbar.css b/docs/assets/mintlify-navbar.css
new file mode 100644
index 000000000..6e63aed06
--- /dev/null
+++ b/docs/assets/mintlify-navbar.css
@@ -0,0 +1,35 @@
+/* Make Mintlify navbar sticky - override all positioning */
+#navbar {
+  position: sticky !important;
+  top: 0 !important;
+  z-index: 9999 !important;
+  width: 100% !important;
+}
+
+/* Override fixed positioning from Tailwind */
+#navbar.fixed,
+#navbar[class*="fixed"],
+div#navbar {
+  position: sticky !important;
+}
+
+/* Remove any overflow restrictions on parents that break sticky */
+* {
+  overflow-x: visible !important;
+}
+
+body,
+html,
+body > div,
+body > div > div {
+  overflow-y: visible !important;
+  overflow-x: visible !important;
+}
+
+/* Ensure layout containers don't break sticky */
+[class*="layout"],
+[class*="Layout"],
+main,
+[role="main"] {
+  overflow: visible !important;
+}
diff --git a/docs/docs.json b/docs/docs.json
index 2cc5ae78b..357d18ad5 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -7,6 +7,7 @@
     "dark": "/assets/pixel-lobster.svg"
   },
   "favicon": "/assets/pixel-lobster.svg",
+  "css": "/assets/mintlify-navbar.css",
   "colors": {
     "primary": "#FF5A36"
   },
diff --git a/docs/install/node.md b/docs/install/node.md
index 6a622e198..e23b497d5 100644
--- a/docs/install/node.md
+++ b/docs/install/node.md
@@ -1,16 +1,16 @@
 ---
 summary: "Node.js + npm install sanity: versions, PATH, and global installs"
 read_when:
-  - You installed Clawdbot but `clawdbot` is “command not found”
-  - You’re setting up Node.js/npm on a new machine
-  - `npm install -g ...` fails with permissions or PATH issues
+  - You installed Clawdbot but clawdbot is command not found
+  - You're setting up Node.js/npm on a new machine
+  - npm install -g fails with permissions or PATH issues
 ---
 
 # Node.js + npm (PATH sanity)
 
-Clawdbot’s runtime baseline is **Node 22+**.
+Clawdbot's runtime baseline is **Node 22+**.
 
-If you can run `npm install -g clawdbot@latest` but later see `clawdbot: command not found`, it’s almost always a **PATH** issue: the directory where npm puts global binaries isn’t on your shell’s PATH.
+If you can run `npm install -g clawdbot@latest` but later see `clawdbot: command not found`, it's almost always a **PATH** issue: the directory where npm puts global binaries isn't on your shell's PATH.
 
 ## Quick diagnosis
 
@@ -23,9 +23,9 @@ npm prefix -g
 echo "$PATH"
 ```
 
-If `$(npm prefix -g)/bin` (macOS/Linux) or `$(npm prefix -g)` (Windows) is **not** present inside `echo "$PATH"`, your shell can’t find global npm binaries (including `clawdbot`).
+If `$(npm prefix -g)/bin` (macOS/Linux) or `$(npm prefix -g)` (Windows) is **not** present inside `echo "$PATH"`, your shell can't find global npm binaries (including `clawdbot`).
 
-## Fix: put npm’s global bin dir on PATH
+## Fix: put npm's global bin dir on PATH
 
 1) Find your global npm prefix:
 
@@ -51,7 +51,7 @@ On Windows, add the output of `npm prefix -g` to your PATH.
 
 ## Fix: avoid `sudo npm install -g` / permission errors (Linux)
 
-If `npm install -g ...` fails with `EACCES`, switch npm’s global prefix to a user-writable directory:
+If `npm install -g ...` fails with `EACCES`, switch npm's global prefix to a user-writable directory:
 
 ```bash
 mkdir -p "$HOME/.npm-global"
@@ -63,7 +63,7 @@ Persist the `export PATH=...` line in your shell startup file.
 
 ## Recommended Node install options
 
-You’ll have the fewest surprises if Node/npm are installed in a way that:
+You'll have the fewest surprises if Node/npm are installed in a way that:
 
 - keeps Node updated (22+)
 - makes the global npm bin dir stable and on PATH in new shells
@@ -74,4 +74,4 @@ Common choices:
 - Linux: your preferred version manager, or a distro-supported install that provides Node 22+
 - Windows: official Node installer, `winget`, or a Windows Node version manager
 
-If you use a version manager (nvm/fnm/asdf/etc), ensure it’s initialized in the shell you use day-to-day (zsh vs bash) so the PATH it sets is present when you run installers.
+If you use a version manager (nvm/fnm/asdf/etc), ensure it's initialized in the shell you use day-to-day (zsh vs bash) so the PATH it sets is present when you run installers.

From af86be3d1878a0cde370ed49b1a8d98c2438da7f Mon Sep 17 00:00:00 2001
From: mohamed_amine_hamdi <amine@1dev.space>
Date: Tue, 27 Jan 2026 00:23:19 +0100
Subject: [PATCH 2/2] Update heartbeat-visibility.ts

---
 src/infra/heartbeat-visibility.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/infra/heartbeat-visibility.ts b/src/infra/heartbeat-visibility.ts
index e4943464c..c24b10417 100644
--- a/src/infra/heartbeat-visibility.ts
+++ b/src/infra/heartbeat-visibility.ts
@@ -1,6 +1,6 @@
 import type { ClawdbotConfig } from "../config/config.js";
 import type { ChannelHeartbeatVisibilityConfig } from "../config/types.channels.js";
-import type { DeliverableMessageChannel, GatewayMessageChannel } from "../utils/message-channel.js";
+import type { GatewayMessageChannel } from "../utils/message-channel.js";
 
 export type ResolvedHeartbeatVisibility = {
   showOk: boolean;