@syke1/mcp-server 1.3.6 → 1.3.8

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/index.js

@@ -522,6 +522,8 @@ async function main() {
         fileCache.initialize();
         fileCache.startWatching();
     }
+    // Web server handle (set after server starts)
+    let webServerHandle = null;
     // Switch project callback — reinitializes graph + file cache
     function switchProject(newRoot) {
         currentProjectRoot = newRoot;
@@ -533,6 +535,10 @@ async function main() {
         fileCache = new file_cache_1.FileCache(newRoot);
         fileCache.initialize();
         fileCache.startWatching();
+        // Re-wire SSE events to the new FileCache
+        if (webServerHandle) {
+            webServerHandle.setFileCache(fileCache);
+        }
         // Rebuild graph
         const graph = (0, graph_1.refreshGraph)(newRoot, currentPackageName);
         console.error(`[syke] Switched to project: ${newRoot}`);
@@ -552,7 +558,8 @@ async function main() {
     }
     // Start Express web server with file cache for SSE (only if project detected)
     if (currentProjectRoot) {
-        const webApp = (0, server_1.createWebServer)(() => (0, graph_1.getGraph)(currentProjectRoot, currentPackageName), fileCache, switchProject, () => currentProjectRoot, () => currentPackageName, () => licenseStatus, () => !!(0, provider_1.getAIProvider)());
+        const { app: webApp, setFileCache: setWebFileCache } = (0, server_1.createWebServer)(() => (0, graph_1.getGraph)(currentProjectRoot, currentPackageName), fileCache, switchProject, () => currentProjectRoot, () => currentPackageName, () => licenseStatus, () => !!(0, provider_1.getAIProvider)());
+        webServerHandle = { setFileCache: setWebFileCache };
         webApp.listen(WEB_PORT, () => {
             const dashUrl = `http://localhost:${WEB_PORT}`;
             console.error(`[syke] Web dashboard: ${dashUrl}`);

package/dist/web/server.d.ts

@@ -1,3 +1,4 @@
+import express from "express";
 import { DependencyGraph } from "../graph";
 import { FileCache } from "../watcher/file-cache";
 import { RealtimeAnalysis } from "../ai/realtime-analyzer";
@@ -24,9 +25,14 @@ export interface SwitchProjectResult {
     fileCount: number;
     edgeCount: number;
 }
-export declare function createWebServer(getGraphFn: () => DependencyGraph, fileCache?: FileCache, switchProjectFn?: (newRoot: string) => SwitchProjectResult, getProjectRoot?: () => string, getPackageName?: () => string, getLicenseStatus?: () => {
+export interface WebServerHandle {
+    app: ReturnType<typeof express>;
+    /** Re-wire SSE events when FileCache is replaced (e.g. after switchProject) */
+    setFileCache(cache: FileCache): void;
+}
+export declare function createWebServer(getGraphFn: () => DependencyGraph, initialFileCache?: FileCache, switchProjectFn?: (newRoot: string) => SwitchProjectResult, getProjectRoot?: () => string, getPackageName?: () => string, getLicenseStatus?: () => {
     plan: string;
     expiresAt?: string;
     error?: string;
     source?: string;
-}, hasAIKeyFn?: () => boolean): import("express-serve-static-core").Express;
+}, hasAIKeyFn?: () => boolean): WebServerHandle;

package/dist/web/server.js

@@ -226,7 +226,7 @@ function acknowledgeWarnings() {
 function getAllWarnings() {
     return [...warningStore];
 }
-function createWebServer(getGraphFn, fileCache, switchProjectFn, getProjectRoot, getPackageName, getLicenseStatus, hasAIKeyFn) {
+function createWebServer(getGraphFn, initialFileCache, switchProjectFn, getProjectRoot, getPackageName, getLicenseStatus, hasAIKeyFn) {
     const app = (0, express_1.default)();
     app.use(express_1.default.json());
     // Serve static files from public/
@@ -234,6 +234,7 @@ function createWebServer(getGraphFn, fileCache, switchProjectFn, getProjectRoot,
     app.use(express_1.default.static(publicDir));
     // ── SSE: Server-Sent Events for real-time updates ──
     const sseClients = new Set();
+    let currentFileCache = initialFileCache || null;
     function broadcastSSE(event, data) {
         const payload = `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
         for (const client of sseClients) {
@@ -274,7 +275,7 @@ function createWebServer(getGraphFn, fileCache, switchProjectFn, getProjectRoot,
             "Access-Control-Allow-Origin": "*",
         });
         // Send initial connection event
-        res.write(`event: connected\ndata: ${JSON.stringify({ clients: sseClients.size + 1, cacheSize: fileCache?.size || 0 })}\n\n`);
+        res.write(`event: connected\ndata: ${JSON.stringify({ clients: sseClients.size + 1, cacheSize: currentFileCache?.size || 0 })}\n\n`);
         sseClients.add(res);
         console.error(`[syke:sse] Client connected (${sseClients.size} total)`);
         _req.on("close", () => {
@@ -283,8 +284,8 @@ function createWebServer(getGraphFn, fileCache, switchProjectFn, getProjectRoot,
         });
     });
     // Wire FileCache change events → SSE broadcast + AI analysis
-    if (fileCache) {
-        fileCache.on("change", async (change) => {
+    function wireFileCacheEvents(cache) {
+        cache.on("change", async (change) => {
             const graph = getGraphFn();
             const absPath = path.normalize(path.join(graph.sourceDir, change.relativePath));
             // Compute affected nodes for visual pulse
@@ -317,7 +318,7 @@ function createWebServer(getGraphFn, fileCache, switchProjectFn, getProjectRoot,
             if (license && license.plan === "pro") {
                 broadcastSSE("analysis-start", { file: change.relativePath });
                 try {
-                    const analysis = await (0, realtime_analyzer_1.analyzeChangeRealtime)(change, graph, (relPath) => fileCache.getFileByRelPath(relPath));
+                    const analysis = await (0, realtime_analyzer_1.analyzeChangeRealtime)(change, graph, (relPath) => currentFileCache?.getFileByRelPath(relPath) ?? null);
                     broadcastSSE("analysis-result", analysis);
                     // Store warnings for MCP check_warnings tool
                     addWarning(analysis);
@@ -341,15 +342,23 @@ function createWebServer(getGraphFn, fileCache, switchProjectFn, getProjectRoot,
             }
         });
     }
+    if (currentFileCache)
+        wireFileCacheEvents(currentFileCache);
+    /** Replace the FileCache (called after switchProject) */
+    function setFileCache(cache) {
+        currentFileCache = cache;
+        wireFileCacheEvents(cache);
+        console.error(`[syke:sse] FileCache re-wired (${cache.size} files)`);
+    }
     // GET /api/cache-status — Memory cache stats
     app.get("/api/cache-status", (_req, res) => {
-        if (!fileCache) {
+        if (!currentFileCache) {
             return res.json({ enabled: false });
         }
         res.json({
             enabled: true,
-            fileCount: fileCache.size,
-            totalLines: fileCache.totalLines,
+            fileCount: currentFileCache.size,
+            totalLines: currentFileCache.totalLines,
             sseClients: sseClients.size,
         });
     });
@@ -804,5 +813,5 @@ function createWebServer(getGraphFn, fileCache, switchProjectFn, getProjectRoot,
             res.status(500).json({ error: err.message || "Failed to switch project" });
         }
     });
-    return app;
+    return { app, setFileCache };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syke1/mcp-server",
-  "version": "1.3.6",
+  "version": "1.3.8",
   "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",