@syke1/mcp-server 1.3.5 → 1.3.7

package/README.md

@@ -10,30 +10,39 @@ Works with **Claude Code**, **Cursor**, **Windsurf**, and any MCP-compatible AI
 
 ![SYKE Node Detail](https://syke.cloud/images/node-detail.png)
 
+## How It Works
+
+1. **On startup**, SYKE scans your source directory and builds a complete dependency graph using static import analysis.
+2. **Your AI agent modifies files freely** — no interruptions during normal work.
+3. **Before build/deploy**, the AI calls `gate_build` to check if all changes are safe.
+4. **If dependencies break**, SYKE detects cascading failures and blocks the build with a `FAIL` verdict.
+5. **The dashboard** shows a real-time visualization of your dependency graph with risk indicators.
+
+> **SYKE is a safety net, not a gatekeeper.** It doesn't block your AI while working — it catches what your AI missed before you ship.
+
 ## Quick Start
 
-### 1. Add to your MCP config
+### 1. Create config file
 
-**Claude Code** (`~/.claude/mcp.json`):
+Create `~/.syke/config.json`:
 
 ```json
 {
-  "mcpServers": {
-    "syke": {
-      "command": "npx",
-      "args": ["@syke1/mcp-server@latest"],
-      "env": {
-        "SYKE_LICENSE_KEY": "your-key-here",
-        "SYKE_WEB_PORT": "3333",
-        "GEMINI_KEY": "your-gemini-key",
-        "OPENAI_KEY": "your-openai-key",
-        "ANTHROPIC_KEY": "your-anthropic-key"
-      }
-    }
-  }
+  "licenseKey": "SYKE-XXXX-XXXX-XXXX-XXXX",
+  "geminiKey": "your-gemini-api-key"
 }
 ```
 
+> Get your license key at [syke.cloud/dashboard](https://syke.cloud/dashboard/). You only need ONE AI key. Supported: `geminiKey`, `openaiKey`, `anthropicKey`.
+
+### 2. Register MCP server
+
+**Claude Code:**
+
+```bash
+claude mcp add syke -- npx @syke1/mcp-server@latest
+```
+
 **Cursor** (`.cursor/mcp.json`):
 
 ```json
@@ -41,12 +50,7 @@ Works with **Claude Code**, **Cursor**, **Windsurf**, and any MCP-compatible AI
   "mcpServers": {
     "syke": {
       "command": "npx",
-      "args": ["@syke1/mcp-server@latest"],
-      "env": {
-        "SYKE_LICENSE_KEY": "your-key-here",
-        "SYKE_WEB_PORT": "3333",
-        "GEMINI_KEY": "your-gemini-key"
-      }
+      "args": ["@syke1/mcp-server@latest"]
     }
   }
 }
@@ -59,28 +63,27 @@ Works with **Claude Code**, **Cursor**, **Windsurf**, and any MCP-compatible AI
   "mcpServers": {
     "syke": {
       "command": "npx",
-      "args": ["@syke1/mcp-server@latest"],
-      "env": {
-        "SYKE_LICENSE_KEY": "your-key-here",
-        "SYKE_WEB_PORT": "3333",
-        "GEMINI_KEY": "your-gemini-key"
-      }
+      "args": ["@syke1/mcp-server@latest"]
     }
   }
 }
 ```
 
-> **Note:** You only need ONE AI key. SYKE auto-selects: Gemini > OpenAI > Anthropic. Set `SYKE_AI_PROVIDER` to force a specific one.
-
 > **Windows note:** If `npx` is not found, use the full path: `"command": "C:\\Program Files\\nodejs\\npx.cmd"`
 
-### 2. Restart your AI agent
+### 3. Add build gate to your project
 
-SYKE auto-detects your project language and builds the dependency graph on startup.
+Add this line to your project's `CLAUDE.md` (or equivalent AI instruction file):
 
-### 3. Open the dashboard
+```
+After completing code changes, always run the gate_build MCP tool before committing or deploying.
+```
+
+This ensures your AI agent automatically runs SYKE's safety check after every task — no manual prompting needed.
 
-A web dashboard opens automatically at `http://localhost:3333` (configurable via `SYKE_WEB_PORT`) showing your live dependency graph.
+### 4. Restart your AI agent
+
+SYKE auto-detects your project language and builds the dependency graph on startup. Open `http://localhost:3333` to see your live dashboard.
 
 ## Features
 
@@ -101,14 +104,14 @@ A web dashboard opens automatically at `http://localhost:3333` (configurable via
 
 SYKE supports three AI providers for semantic analysis. Bring your own key:
 
-| Provider | Model | Env Variable |
-|----------|-------|-------------|
-| Google Gemini | `gemini-2.5-flash` | `GEMINI_KEY` |
-| OpenAI | `gpt-4o-mini` | `OPENAI_KEY` |
-| Anthropic | `claude-sonnet-4-20250514` | `ANTHROPIC_KEY` |
+| Provider | Model | Config Key | Env Variable |
+|----------|-------|-----------|-------------|
+| Google Gemini | `gemini-2.5-flash` | `geminiKey` | `GEMINI_KEY` |
+| OpenAI | `gpt-4o-mini` | `openaiKey` | `OPENAI_KEY` |
+| Anthropic | `claude-sonnet-4-20250514` | `anthropicKey` | `ANTHROPIC_KEY` |
 
 **Auto-selection:** SYKE uses the first available key (Gemini > OpenAI > Anthropic).
-**Force provider:** Set `SYKE_AI_PROVIDER=openai` (or `gemini`, `anthropic`) to override.
+**Force provider:** Set `aiProvider` in config (or `SYKE_AI_PROVIDER` env var) to override.
 
 ### Language Support
 
@@ -116,10 +119,55 @@ Auto-detected, zero-config: **Dart/Flutter**, **TypeScript/JavaScript**, **Pytho
 
 ### Web Dashboard
 
-Live dependency graph visualization at `localhost:3333` (or your custom `SYKE_WEB_PORT`) with:
-- Interactive node graph (click any file to see its connections)
+Live dependency graph visualization at `localhost:3333` with:
+- Interactive 3D node graph (click any file to see its connections)
 - Real-time cascade monitoring
 - Risk level indicators
+- Server offline detection with auto-reconnect
+
+## Configuration
+
+SYKE reads from `~/.syke/config.json` (primary) with environment variable overrides:
+
+| Config Key | Env Variable | Description | Required |
+|-----------|-------------|-------------|----------|
+| `licenseKey` | `SYKE_LICENSE_KEY` | Pro license key from dashboard | No (Free tier works without) |
+| `geminiKey` | `GEMINI_KEY` | Google Gemini API key for `ai_analyze` | No (any one AI key) |
+| `openaiKey` | `OPENAI_KEY` | OpenAI API key for `ai_analyze` | No (any one AI key) |
+| `anthropicKey` | `ANTHROPIC_KEY` | Anthropic API key for `ai_analyze` | No (any one AI key) |
+| `aiProvider` | `SYKE_AI_PROVIDER` | Force AI provider: `gemini`, `openai`, or `anthropic` | No (auto-selects) |
+| `port` | `SYKE_WEB_PORT` | Dashboard port (default: 3333) | No |
+
+**Full config example** (`~/.syke/config.json`):
+
+```json
+{
+  "licenseKey": "SYKE-XXXX-XXXX-XXXX-XXXX",
+  "geminiKey": "AIza...",
+  "openaiKey": "",
+  "anthropicKey": "",
+  "port": 3333
+}
+```
+
+## Recommended Workflow
+
+```
+You (developer)          AI Agent            SYKE
+     |                      |                  |
+     |-- "Add feature X" -->|                  |
+     |                      |-- modifies files |
+     |                      |-- modifies files |
+     |                      |-- modifies files |
+     |                      |                  |
+     |                      |-- gate_build --->|
+     |                      |                  |-- scans graph
+     |                      |                  |-- checks impact
+     |                      |<-- PASS/FAIL ----|
+     |                      |                  |
+     |<-- "Done. Safe to    |                  |
+     |    build." ----------|                  |
+```
 
 ## Pricing
 
@@ -136,27 +184,7 @@ Live dependency graph visualization at `localhost:3333` (or your custom `SYKE_WE
 - AI semantic analysis (BYOK — Gemini, OpenAI, or Claude)
 - Priority support
 
-Get your license key at [syke.cloud/dashboard](https://syke.cloud/dashboard/).
-
-## Configuration
-
-| Environment Variable | Description | Required |
-|---------------------|-------------|----------|
-| `SYKE_LICENSE_KEY` | Pro license key from dashboard | No (Free tier works without) |
-| `GEMINI_KEY` | Google Gemini API key for `ai_analyze` | No (any one AI key) |
-| `OPENAI_KEY` | OpenAI API key for `ai_analyze` | No (any one AI key) |
-| `ANTHROPIC_KEY` | Anthropic API key for `ai_analyze` | No (any one AI key) |
-| `SYKE_AI_PROVIDER` | Force AI provider: `gemini`, `openai`, or `anthropic` | No (auto-selects) |
-| `SYKE_WEB_PORT` | Dashboard port (default: 3333) | No |
-| `SYKE_NO_BROWSER` | Set to `1` to disable auto-open browser | No |
-| `SYKE_currentProjectRoot` | Override auto-detected project root | No |
-
-## How It Works
-
-1. **On startup**, SYKE scans your source directory and builds a complete dependency graph using static import analysis.
-2. **When your AI modifies a file**, call `gate_build` to check if the change is safe before building.
-3. **If dependencies break**, SYKE detects cascading failures and blocks the build with a `FAIL` verdict.
-4. **The dashboard** shows a real-time visualization of your dependency graph with risk indicators.
+Sign up at [syke.cloud](https://syke.cloud) — 3-day free trial included.
 
 ## License
 

package/dist/ai/provider.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAIProvider = getAIProvider;
 exports.getProviderName = getProviderName;
 const generative_ai_1 = require("@google/generative-ai");
+const config_1 = require("../config");
 // ── Gemini ──────────────────────────────────────────────────────────
 class GeminiProvider {
     constructor(apiKey) {
@@ -133,16 +134,19 @@ let cachedProvider = undefined;
 function getAIProvider() {
     if (cachedProvider !== undefined)
         return cachedProvider;
-    const forced = process.env.SYKE_AI_PROVIDER?.toLowerCase();
+    const forced = (0, config_1.getConfig)("aiProvider", "SYKE_AI_PROVIDER")?.toLowerCase();
+    const geminiKey = (0, config_1.getConfig)("geminiKey", "GEMINI_KEY");
+    const openaiKey = (0, config_1.getConfig)("openaiKey", "OPENAI_KEY");
+    const anthropicKey = (0, config_1.getConfig)("anthropicKey", "ANTHROPIC_KEY");
     if (forced) {
-        if (forced === "gemini" && process.env.GEMINI_KEY) {
-            cachedProvider = new GeminiProvider(process.env.GEMINI_KEY);
+        if (forced === "gemini" && geminiKey) {
+            cachedProvider = new GeminiProvider(geminiKey);
         }
-        else if (forced === "openai" && process.env.OPENAI_KEY) {
-            cachedProvider = new OpenAIProvider(process.env.OPENAI_KEY);
+        else if (forced === "openai" && openaiKey) {
+            cachedProvider = new OpenAIProvider(openaiKey);
         }
-        else if (forced === "anthropic" && process.env.ANTHROPIC_KEY) {
-            cachedProvider = new AnthropicProvider(process.env.ANTHROPIC_KEY);
+        else if (forced === "anthropic" && anthropicKey) {
+            cachedProvider = new AnthropicProvider(anthropicKey);
         }
         else {
             console.error(`[syke] SYKE_AI_PROVIDER=${forced} but no matching API key found`);
@@ -151,14 +155,14 @@ function getAIProvider() {
         return cachedProvider;
     }
     // Auto-select
-    if (process.env.GEMINI_KEY) {
-        cachedProvider = new GeminiProvider(process.env.GEMINI_KEY);
+    if (geminiKey) {
+        cachedProvider = new GeminiProvider(geminiKey);
     }
-    else if (process.env.OPENAI_KEY) {
-        cachedProvider = new OpenAIProvider(process.env.OPENAI_KEY);
+    else if (openaiKey) {
+        cachedProvider = new OpenAIProvider(openaiKey);
     }
-    else if (process.env.ANTHROPIC_KEY) {
-        cachedProvider = new AnthropicProvider(process.env.ANTHROPIC_KEY);
+    else if (anthropicKey) {
+        cachedProvider = new AnthropicProvider(anthropicKey);
     }
     else {
         cachedProvider = null;

package/dist/config.d.ts

@@ -0,0 +1,19 @@
+interface SykeConfig {
+    licenseKey?: string;
+    geminiKey?: string;
+    openaiKey?: string;
+    anthropicKey?: string;
+    aiProvider?: string;
+    port?: number;
+}
+/**
+ * Get a config value. Env var takes priority over config file.
+ */
+export declare function getConfig(key: keyof SykeConfig, envVar?: string): string | undefined;
+/**
+ * Get all resolved config (for logging/debug)
+ */
+export declare function getAllConfig(): Record<string, string | undefined>;
+export declare const CONFIG_DIR_PATH: string;
+export declare const CONFIG_FILE_PATH: string;
+export {};

package/dist/config.js

@@ -0,0 +1,98 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIG_FILE_PATH = exports.CONFIG_DIR_PATH = void 0;
+exports.getConfig = getConfig;
+exports.getAllConfig = getAllConfig;
+/**
+ * Central config reader for SYKE MCP Server.
+ *
+ * Priority: environment variables > ~/.syke/config.json
+ *
+ * IDE users (Cursor, Windsurf, etc.) set env vars in their MCP config.
+ * Terminal users (Claude Code CLI) edit ~/.syke/config.json directly.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const CONFIG_DIR = path.join(os.homedir(), ".syke");
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+let cached = null;
+/**
+ * Read ~/.syke/config.json (cached after first read)
+ */
+function readConfigFile() {
+    if (cached)
+        return cached;
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            cached = JSON.parse(fs.readFileSync(CONFIG_FILE, "utf-8"));
+            return cached;
+        }
+    }
+    catch {
+        // ignore parse errors
+    }
+    cached = {};
+    return cached;
+}
+/**
+ * Get a config value. Env var takes priority over config file.
+ */
+function getConfig(key, envVar) {
+    // 1. Environment variable
+    if (envVar && process.env[envVar]) {
+        return process.env[envVar];
+    }
+    // 2. Config file
+    const file = readConfigFile();
+    const val = file[key];
+    return val !== undefined && val !== null ? String(val) : undefined;
+}
+/**
+ * Get all resolved config (for logging/debug)
+ */
+function getAllConfig() {
+    return {
+        licenseKey: getConfig("licenseKey", "SYKE_LICENSE_KEY"),
+        geminiKey: getConfig("geminiKey", "GEMINI_KEY"),
+        openaiKey: getConfig("openaiKey", "OPENAI_KEY"),
+        anthropicKey: getConfig("anthropicKey", "ANTHROPIC_KEY"),
+        aiProvider: getConfig("aiProvider", "SYKE_AI_PROVIDER"),
+        port: getConfig("port", "SYKE_WEB_PORT"),
+    };
+}
+exports.CONFIG_DIR_PATH = CONFIG_DIR;
+exports.CONFIG_FILE_PATH = CONFIG_FILE;

package/dist/graph.js

@@ -48,10 +48,12 @@ function buildGraph(projectRoot, packageName) {
     const allSourceDirs = [];
     for (const plugin of detectedPlugins) {
         const dirs = plugin.getSourceDirs(projectRoot);
+        console.error(`[syke:debug] ${plugin.id} getSourceDirs(${projectRoot}) => ${dirs.length} dirs: ${dirs.join(", ")}`);
         for (const dir of dirs) {
             if (!allSourceDirs.includes(dir))
                 allSourceDirs.push(dir);
             const sourceFiles = plugin.discoverFiles(dir);
+            console.error(`[syke:debug] ${plugin.id} discoverFiles(${dir}) => ${sourceFiles.length} files`);
             for (const f of sourceFiles) {
                 files.add(f);
                 if (!forward.has(f))

package/dist/index.js

@@ -55,10 +55,11 @@ const provider_1 = require("./ai/provider");
 const server_1 = require("./web/server");
 const file_cache_1 = require("./watcher/file-cache");
 const validator_1 = require("./license/validator");
+const config_1 = require("./config");
 // Configuration — auto-detect if env vars not set
 let currentProjectRoot = process.env.SYKE_currentProjectRoot || (0, plugin_1.detectProjectRoot)();
 let currentPackageName = process.env.SYKE_currentPackageName || (0, plugin_1.detectPackageName)(currentProjectRoot, (0, plugin_1.detectLanguages)(currentProjectRoot));
-const WEB_PORT = parseInt(process.env.SYKE_WEB_PORT || "3333", 10);
+const WEB_PORT = parseInt((0, config_1.getConfig)("port", "SYKE_WEB_PORT") || "3333", 10);
 function resolveFilePath(fileArg, projectRoot, sourceDir) {
     const srcDir = sourceDir || path.join(projectRoot, "src");
     const srcDirName = path.basename(srcDir); // "lib" or "src"

package/dist/languages/plugin.js

@@ -114,7 +114,8 @@ function discoverAllFiles(rootDir, extensions, extraSkipDirs) {
         try {
             entries = fs.readdirSync(dir, { withFileTypes: true });
         }
-        catch {
+        catch (err) {
+            console.error(`[syke] discoverAllFiles walk error for ${dir}: ${err.message}`);
             return;
         }
         for (const entry of entries) {
@@ -178,7 +179,9 @@ function findSourceDirsWithFiles(root, extensions) {
             }
         }
     }
-    catch { }
+    catch (err) {
+        console.error(`[syke] findSourceDirsWithFiles error for ${root}: ${err.message}`);
+    }
     return dirs;
 }
 // ── Register All Plugins ──

package/dist/license/validator.js

@@ -42,9 +42,9 @@ const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const https = __importStar(require("https"));
 const crypto = __importStar(require("crypto"));
-const CACHE_DIR = path.join(os.homedir(), ".syke");
+const config_1 = require("../config");
+const CACHE_DIR = config_1.CONFIG_DIR_PATH;
 const CACHE_FILE = path.join(CACHE_DIR, ".license-cache.json");
-const CONFIG_FILE = path.join(CACHE_DIR, "config.json");
 // Cache durations
 const CACHE_MAX_AGE = 24 * 60 * 60 * 1000; // 24 hours
 const CACHE_GRACE_PERIOD = 7 * 24 * 60 * 60 * 1000; // 7 days offline grace
@@ -82,21 +82,9 @@ function getDeviceName() {
  * Read license key from env var or config file
  */
 function getLicenseKey() {
-    // 1. Environment variable
-    const envKey = process.env.SYKE_LICENSE_KEY;
-    if (envKey && envKey.startsWith("SYKE-"))
-        return envKey;
-    // 2. Config file
-    try {
-        if (fs.existsSync(CONFIG_FILE)) {
-            const config = JSON.parse(fs.readFileSync(CONFIG_FILE, "utf-8"));
-            if (config.licenseKey && config.licenseKey.startsWith("SYKE-"))
-                return config.licenseKey;
-        }
-    }
-    catch {
-        // ignore
-    }
+    const key = (0, config_1.getConfig)("licenseKey", "SYKE_LICENSE_KEY");
+    if (key && key.startsWith("SYKE-"))
+        return key;
     return null;
 }
 /**

package/dist/web/public/app.js

@@ -49,8 +49,25 @@ document.addEventListener("DOMContentLoaded", async () => {
   setupTabs();
   setupProjectModal();
   initSSE();
+  startHealthCheck();
 });
 
+// Periodic server health check (catches server down even without SSE)
+let healthCheckTimer = null;
+function startHealthCheck() {
+  if (healthCheckTimer) return;
+  healthCheckTimer = setInterval(async () => {
+    try {
+      const res = await fetch("/api/project-info", { signal: AbortSignal.timeout(3000) });
+      if (res.ok) {
+        // Server is alive — if overlay was showing, hideServerOffline handles reconnection
+      }
+    } catch (e) {
+      showServerOffline();
+    }
+  }, 10000); // Check every 10 seconds
+}
+
 // ═══════════════════════════════════════════
 // WELCOME OVERLAY
 // ═══════════════════════════════════════════
@@ -2116,12 +2133,22 @@ async function initSSE() {
     updateSSEStatus("PROJECT LOADED", "connected");
   });
 
-  sseSource.onerror = () => {
+  sseSource.onerror = async () => {
     console.warn("[SYKE:SSE] Connection error");
     updateSSEStatus("OFFLINE", "offline");
     sseSource.close();
     sseSource = null;
     if (sseBlocked) return; // Don't reconnect if Pro-only block
+
+    // Check if server is actually down (not just SSE hiccup)
+    try {
+      const probe = await fetch("/api/project-info");
+      if (!probe.ok) throw new Error("not ok");
+    } catch (e) {
+      // Server is truly down — show offline overlay
+      showServerOffline();
+    }
+
     if (sseReconnectTimer) clearTimeout(sseReconnectTimer);
     sseReconnectTimer = setTimeout(initSSE, 3000);
   };
@@ -2262,6 +2289,124 @@ function setupResizeHandle() {
 // ═══════════════════════════════════════════
 // PROJECT SELECTOR
 // ═══════════════════════════════════════════
+let licenseTimerInterval = null;
+
+function updateLicenseBadge(plan, expiresAt) {
+  const badge = document.getElementById("license-badge");
+  if (!badge) return;
+
+  const planEl = badge.querySelector(".license-plan");
+  const timerEl = badge.querySelector(".license-timer");
+
+  // Clear previous timer
+  if (licenseTimerInterval) {
+    clearInterval(licenseTimerInterval);
+    licenseTimerInterval = null;
+  }
+
+  badge.className = "license-badge";
+
+  if (plan === "pro" && expiresAt) {
+    const expiry = new Date(expiresAt);
+    const now = new Date();
+    const diffMs = expiry - now;
+
+    if (diffMs <= 0) {
+      // Expired
+      badge.classList.add("expired");
+      planEl.textContent = "EXPIRED";
+      timerEl.textContent = "";
+    } else {
+      const totalDays = Math.ceil(diffMs / (1000 * 60 * 60 * 24));
+
+      if (totalDays <= 3) {
+        // Trial or near-expiry
+        badge.classList.add("trial-urgent");
+        planEl.textContent = "TRIAL";
+      } else if (totalDays <= 14) {
+        badge.classList.add("trial");
+        planEl.textContent = "TRIAL";
+      } else {
+        badge.classList.add("pro");
+        planEl.textContent = "PRO";
+      }
+
+      // Live countdown
+      function tick() {
+        const remaining = new Date(expiresAt) - new Date();
+        if (remaining <= 0) {
+          timerEl.textContent = "EXPIRED";
+          badge.className = "license-badge expired";
+          planEl.textContent = "EXPIRED";
+          clearInterval(licenseTimerInterval);
+          return;
+        }
+        const d = Math.floor(remaining / (1000 * 60 * 60 * 24));
+        const h = Math.floor((remaining % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60));
+        const m = Math.floor((remaining % (1000 * 60 * 60)) / (1000 * 60));
+        const s = Math.floor((remaining % (1000 * 60)) / 1000);
+
+        if (d > 0) {
+          timerEl.textContent = `D-${d} ${String(h).padStart(2,"0")}:${String(m).padStart(2,"0")}:${String(s).padStart(2,"0")}`;
+        } else {
+          timerEl.textContent = `${String(h).padStart(2,"0")}:${String(m).padStart(2,"0")}:${String(s).padStart(2,"0")}`;
+        }
+      }
+      tick();
+      licenseTimerInterval = setInterval(tick, 1000);
+    }
+  } else if (plan === "pro") {
+    // Pro without expiry (permanent or subscription)
+    badge.classList.add("pro");
+    planEl.textContent = "PRO";
+    timerEl.textContent = "";
+  } else {
+    // Free
+    badge.classList.add("free");
+    planEl.textContent = "FREE";
+    timerEl.textContent = "";
+  }
+}
+
+let offlineRetryTimer = null;
+
+function showServerOffline() {
+  const overlay = document.getElementById("server-offline-overlay");
+  if (overlay) overlay.classList.remove("hidden");
+  // Hide other content
+  const topbar = document.getElementById("topbar");
+  if (topbar) topbar.style.opacity = "0.2";
+
+  // Auto-retry every 3 seconds
+  if (!offlineRetryTimer) {
+    offlineRetryTimer = setInterval(async () => {
+      const retryEl = document.getElementById("offline-retry-status");
+      try {
+        const res = await fetch("/api/project-info");
+        if (res.ok) {
+          // Server is back!
+          clearInterval(offlineRetryTimer);
+          offlineRetryTimer = null;
+          hideServerOffline();
+          await loadProjectInfo();
+          await loadGraph();
+          await loadHubFiles();
+          initSSE();
+        }
+      } catch (e) {
+        if (retryEl) retryEl.textContent = "Retrying connection... (" + new Date().toLocaleTimeString() + ")";
+      }
+    }, 3000);
+  }
+}
+
+function hideServerOffline() {
+  const overlay = document.getElementById("server-offline-overlay");
+  if (overlay) overlay.classList.add("hidden");
+  const topbar = document.getElementById("topbar");
+  if (topbar) topbar.style.opacity = "1";
+}
+
 async function loadProjectInfo() {
   try {
     const res = await fetch("/api/project-info");
@@ -2274,8 +2419,11 @@ async function loadProjectInfo() {
       el.textContent = short;
       el.title = info.projectRoot + " | " + info.languages.join(", ") + " | " + info.fileCount + " files";
     }
+    hideServerOffline();
+    updateLicenseBadge(info.plan, info.expiresAt);
   } catch (e) {
     console.warn("[SYKE] Failed to load project info:", e);
+    showServerOffline();
   }
 }
 
@@ -2343,7 +2491,7 @@ async function browseDir(dirPath) {
       });
     }
   } catch (e) {
-    if (listEl) listEl.innerHTML = '<div class="browse-empty">NETWORK ERROR</div>';
+    if (listEl) listEl.innerHTML = '<div class="browse-empty">CONNECTION LOST — server may have restarted</div>';
   }
 }
 

package/dist/web/public/index.html

@@ -24,6 +24,10 @@
       <span id="current-project" class="project-path">Loading...</span>
       <button id="btn-change-project" class="top-btn" title="Switch project">OPEN</button>
     </div>
+    <div id="license-badge" class="license-badge free">
+      <span class="license-plan">FREE</span>
+      <span class="license-timer"></span>
+    </div>
     <div class="top-controls">
       <button id="btn-cycles" class="top-btn" title="Detect circular dependencies">CYCLES</button>
       <button id="btn-stats" class="top-btn" title="Toggle statistics panel">STATS</button>
@@ -57,6 +61,17 @@
       </div>
       <div id="3d-graph"></div>
       <!-- Welcome Overlay (shown when no project loaded) -->
+      <div id="server-offline-overlay" class="welcome-overlay hidden">
+        <div class="welcome-content">
+          <div class="welcome-logo">
+            <div class="welcome-pulse-ring offline-pulse"><span class="welcome-pulse-dot offline-dot"></span></div>
+            <span class="welcome-title">SYKE</span>
+          </div>
+          <p class="welcome-subtitle" style="color:#ff5f57">SERVER OFFLINE</p>
+          <p class="welcome-msg">MCP server is not running.<br>Start Claude Code to launch the server.</p>
+          <div id="offline-retry-status" style="font-family:var(--font-mono,'JetBrains Mono',monospace);font-size:11px;color:rgba(255,255,255,0.3);margin-top:12px">Retrying connection...</div>
+        </div>
+      </div>
       <div id="welcome-overlay" class="welcome-overlay hidden">
         <div class="welcome-content">
           <div class="welcome-logo">

package/dist/web/public/style.css

@@ -123,6 +123,70 @@ body {
   text-transform: uppercase;
 }
 
+/* ── License Badge ── */
+.license-badge {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 5px 16px;
+  border-radius: 20px;
+  font-size: 11px;
+  font-weight: 700;
+  letter-spacing: 2px;
+  border: 1px solid;
+  transition: all 0.3s;
+  cursor: default;
+}
+
+.license-badge.free {
+  color: #8899aa;
+  border-color: rgba(136,153,170,0.4);
+  background: rgba(136,153,170,0.12);
+}
+
+.license-badge.pro {
+  color: #ffd700;
+  border-color: rgba(255,215,0,0.4);
+  background: rgba(255,215,0,0.08);
+  text-shadow: 0 0 8px rgba(255,215,0,0.3);
+}
+
+.license-badge.trial {
+  color: var(--risk-medium);
+  border-color: rgba(255,159,10,0.4);
+  background: rgba(255,159,10,0.08);
+}
+
+.license-badge.trial-urgent {
+  color: var(--risk-high);
+  border-color: rgba(255,45,85,0.4);
+  background: rgba(255,45,85,0.08);
+  animation: license-urgent 1.5s ease-in-out infinite;
+}
+
+.license-badge.expired {
+  color: var(--risk-high);
+  border-color: rgba(255,45,85,0.4);
+  background: rgba(255,45,85,0.1);
+}
+
+@keyframes license-urgent {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.6; }
+}
+
+.license-plan {
+  font-weight: 700;
+}
+
+.license-timer {
+  font-size: 9px;
+  font-weight: 400;
+  letter-spacing: 1px;
+  opacity: 0.85;
+  font-variant-numeric: tabular-nums;
+}
+
 .top-controls {
   display: flex;
   gap: 8px;
@@ -1349,8 +1413,14 @@ main {
   text-shadow: 0 0 8px rgba(48,209,88,0.5);
 }
 .sse-indicator.offline {
-  color: var(--text-secondary);
-  border-color: var(--text-secondary);
+  color: #ff5f57;
+  border-color: #ff5f57;
+  text-shadow: 0 0 8px rgba(255,95,87,0.5);
+  animation: offline-blink 1.5s ease-in-out infinite;
+}
+@keyframes offline-blink {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.4; }
 }
 .sse-indicator.warning {
   color: var(--risk-medium);
@@ -1391,7 +1461,7 @@ main {
 .pulse-dot.analyzing { background: var(--accent); box-shadow: 0 0 12px var(--accent); }
 .pulse-dot.danger { background: var(--risk-high); box-shadow: 0 0 12px var(--risk-high); }
 .pulse-dot.critical { background: #ff0040; box-shadow: 0 0 16px #ff0040; }
-.pulse-dot.offline { background: var(--text-secondary); box-shadow: none; }
+.pulse-dot.offline { background: #ff5f57; box-shadow: 0 0 8px rgba(255,95,87,0.5); }
 
 /* ═══════════════════════════════════════════ */
 /* Realtime Monitor Panel                      */
@@ -1888,6 +1958,9 @@ main {
   animation: pulse-glow 2s ease-in-out infinite;
 }
 
+.offline-pulse { border-color: #ff5f57; }
+.offline-dot { background: #ff5f57; box-shadow: 0 0 12px #ff5f57; }
+
 .welcome-title {
   font-size: 42px;
   font-weight: 700;

package/dist/web/server.js

@@ -730,6 +730,7 @@ function createWebServer(getGraphFn, fileCache, switchProjectFn, getProjectRoot,
             fileCount: graph.files.size,
             edgeCount,
             plan: license?.plan || "free",
+            expiresAt: license?.expiresAt || null,
             freeFileLimit: 50,
         });
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syke1/mcp-server",
-  "version": "1.3.5",
+  "version": "1.3.7",
   "mcpName": "io.github.khalomsky/syke",
   "description": "AI code impact analysis MCP server — dependency graphs, cascade detection, and a mandatory build gate for AI coding agents",
   "main": "dist/index.js",