@syke1/mcp-server 1.3.1 → 1.3.3

package/dist/index.js

@@ -86,6 +86,15 @@ function isFileInFreeSet(resolvedPath, graph) {
     return idx >= 0 && idx < FREE_MAX_FILES;
 }
 const PRO_UPGRADE_MSG = "This file exceeds the Free tier limit (50 files). Upgrade to Pro for unlimited analysis: https://syke.cloud/dashboard/";
+function getProToolError(toolName) {
+    if (licenseStatus.error) {
+        return `${toolName}: ${licenseStatus.error}`;
+    }
+    if (licenseStatus.expiresAt) {
+        return `${toolName}: Trial expired. Upgrade at https://syke.cloud/dashboard/`;
+    }
+    return `${toolName} requires SYKE Pro. Set SYKE_LICENSE_KEY in your MCP config or sign up at https://syke.cloud`;
+}
 async function main() {
     // Check license before starting (graceful fallback for hosted environments like Smithery)
     try {
@@ -111,7 +120,7 @@ async function main() {
     };
     process.on("SIGINT", shutdown);
     process.on("SIGTERM", shutdown);
-    const server = new index_js_1.Server({ name: "syke", version: "1.3.0" }, { capabilities: { tools: {} } });
+    const server = new index_js_1.Server({ name: "syke", version: "1.3.3" }, { capabilities: { tools: {} } });
     // List tools
     server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
         tools: [
@@ -218,6 +227,16 @@ async function main() {
             },
         ],
     }));
+    // Dashboard URL footer — shown only on the first successful tool call
+    let firstToolCall = true;
+    const DASHBOARD_FOOTER = `\n\n---\n📊 SYKE Dashboard: http://localhost:${WEB_PORT}`;
+    function appendDashboardFooter(text) {
+        if (firstToolCall && currentProjectRoot) {
+            firstToolCall = false;
+            return text + DASHBOARD_FOOTER;
+        }
+        return text;
+    }
     // Handle tool calls
     server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
         const { name, arguments: args } = request.params;
@@ -228,7 +247,7 @@ async function main() {
                 const result = (0, gate_build_1.gateCheck)(graph, files);
                 return {
                     content: [
-                        { type: "text", text: (0, gate_build_1.formatGateResult)(result) },
+                        { type: "text", text: appendDashboardFooter((0, gate_build_1.formatGateResult)(result)) },
                     ],
                     isError: result.verdict === "FAIL",
                 };
@@ -270,7 +289,7 @@ async function main() {
                         lines.push(`- ${d}`);
                     }
                 }
-                return { content: [{ type: "text", text: lines.join("\n") }] };
+                return { content: [{ type: "text", text: appendDashboardFooter(lines.join("\n")) }] };
             }
             case "check_safe": {
                 const file = args.file;
@@ -295,7 +314,7 @@ async function main() {
                     content: [
                         {
                             type: "text",
-                            text: `${result.riskLevel} — ${rel} impacts ${result.totalImpacted} file(s)`,
+                            text: appendDashboardFooter(`${result.riskLevel} — ${rel} impacts ${result.totalImpacted} file(s)`),
                         },
                     ],
                 };
@@ -339,7 +358,7 @@ async function main() {
                 // Pro-only feature
                 if (licenseStatus.plan !== "pro") {
                     return {
-                        content: [{ type: "text", text: "get_hub_files requires SYKE Pro. Upgrade at https://syke.cloud/dashboard/\n\nSet SYKE_LICENSE_KEY in your MCP config to activate Pro features." }],
+                        content: [{ type: "text", text: getProToolError("get_hub_files") }],
                     };
                 }
                 const requestedN = args.top_n || 10;
@@ -373,12 +392,7 @@ async function main() {
                 // Pro-only feature
                 if (licenseStatus.plan !== "pro") {
                     return {
-                        content: [
-                            {
-                                type: "text",
-                                text: "ai_analyze requires SYKE Pro. Upgrade at https://syke.cloud/dashboard/\n\nSet SYKE_LICENSE_KEY in your MCP config to activate Pro features.",
-                            },
-                        ],
+                        content: [{ type: "text", text: getProToolError("ai_analyze") }],
                     };
                 }
                 const file = args.file;
@@ -397,14 +411,14 @@ async function main() {
                 const impactResult = (0, analyze_impact_1.analyzeImpact)(resolved, graph);
                 const aiResult = await (0, analyzer_1.analyzeWithAI)(resolved, impactResult, graph);
                 return {
-                    content: [{ type: "text", text: aiResult }],
+                    content: [{ type: "text", text: appendDashboardFooter(aiResult) }],
                 };
             }
             case "check_warnings": {
                 // Pro-only feature (real-time monitoring)
                 if (licenseStatus.plan !== "pro") {
                     return {
-                        content: [{ type: "text", text: "check_warnings requires SYKE Pro (real-time monitoring feature). Upgrade at https://syke.cloud/dashboard/\n\nSet SYKE_LICENSE_KEY in your MCP config to activate Pro features." }],
+                        content: [{ type: "text", text: getProToolError("check_warnings") }],
                     };
                 }
                 const shouldAck = args.acknowledge || false;
@@ -448,7 +462,7 @@ async function main() {
                     lines.push(`${count} warning(s) acknowledged.`);
                 }
                 return {
-                    content: [{ type: "text", text: lines.join("\n") }],
+                    content: [{ type: "text", text: appendDashboardFooter(lines.join("\n")) }],
                 };
             }
             default:
@@ -461,8 +475,11 @@ async function main() {
         }
     });
     // Pre-warm the graph (skip if no project root — e.g. Smithery scan)
-    console.error(`[syke] Starting SYKE MCP Server v1.3.0`);
+    console.error(`[syke] Starting SYKE MCP Server v1.3.3`);
     console.error(`[syke] License: ${licenseStatus.plan.toUpperCase()} (${licenseStatus.source})`);
+    if (licenseStatus.expiresAt) {
+        console.error(`[syke] Expires: ${licenseStatus.expiresAt}`);
+    }
     // Log AI provider status
     const aiProvider = (0, provider_1.getAIProvider)();
     if (aiProvider) {
@@ -553,7 +570,7 @@ main().catch((err) => {
  * See: https://smithery.ai/docs/deploy#sandbox-server
  */
 function createSandboxServer() {
-    const sandboxServer = new index_js_1.Server({ name: "syke", version: "1.3.0" }, { capabilities: { tools: {} } });
+    const sandboxServer = new index_js_1.Server({ name: "syke", version: "1.3.3" }, { capabilities: { tools: {} } });
     sandboxServer.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
         tools: [
             {

package/dist/license/validator.js

@@ -255,6 +255,10 @@ async function checkLicense() {
     }
     // Try online validation (with device binding)
     const result = await validateOnline(key);
+    if (!result.valid) {
+        const reason = result.error || "invalid key or expired";
+        console.error(`[syke] License validation failed: ${reason}`);
+    }
     if (result.valid) {
         // Update cache
         writeCache({

package/dist/web/public/app.js

@@ -51,6 +51,27 @@ document.addEventListener("DOMContentLoaded", async () => {
   initSSE();
 });
 
+// ═══════════════════════════════════════════
+// WELCOME OVERLAY
+// ═══════════════════════════════════════════
+function showWelcomeOverlay() {
+  const overlay = document.getElementById("welcome-overlay");
+  if (overlay) overlay.classList.remove("hidden");
+
+  const btn = document.getElementById("btn-welcome-open");
+  if (btn && !btn._bound) {
+    btn.addEventListener("click", () => {
+      document.getElementById("btn-change-project").click();
+    });
+    btn._bound = true;
+  }
+}
+
+function hideWelcomeOverlay() {
+  const overlay = document.getElementById("welcome-overlay");
+  if (overlay) overlay.classList.add("hidden");
+}
+
 // ═══════════════════════════════════════════
 // GRAPH LOADING
 // ═══════════════════════════════════════════
@@ -59,6 +80,12 @@ async function loadGraph() {
   const raw = await res.json();
   console.log("[SYKE]", raw.nodes.length, "nodes", raw.edges.length, "edges");
 
+  if (raw.nodes.length === 0) {
+    showWelcomeOverlay();
+    return;
+  }
+  hideWelcomeOverlay();
+
   const nodes = raw.nodes.map(n => {
     const layer = n.data.layer || "UTIL";
     const c = LAYER_CENTERS[layer] || LAYER_CENTERS.UTIL;

package/dist/web/public/index.html

@@ -56,6 +56,34 @@
         <input type="text" id="search-input" placeholder="SEARCH TARGET...">
       </div>
       <div id="3d-graph"></div>
+      <!-- Welcome Overlay (shown when no project loaded) -->
+      <div id="welcome-overlay" class="welcome-overlay hidden">
+        <div class="welcome-content">
+          <div class="welcome-logo">
+            <div class="welcome-pulse-ring"><span class="welcome-pulse-dot"></span></div>
+            <span class="welcome-title">SYKE</span>
+          </div>
+          <p class="welcome-subtitle">CODE IMPACT RADAR</p>
+          <p class="welcome-msg">Open a project to get started</p>
+          <button id="btn-welcome-open" class="welcome-open-btn">OPEN PROJECT</button>
+          <div class="welcome-steps">
+            <div class="welcome-step">
+              <span class="step-num">1</span>
+              <span class="step-text">Open Project</span>
+            </div>
+            <div class="welcome-step-arrow">&rarr;</div>
+            <div class="welcome-step">
+              <span class="step-num">2</span>
+              <span class="step-text">Explore Graph</span>
+            </div>
+            <div class="welcome-step-arrow">&rarr;</div>
+            <div class="welcome-step">
+              <span class="step-num">3</span>
+              <span class="step-text">Monitor Changes</span>
+            </div>
+          </div>
+        </div>
+      </div>
       <!-- HTML overlay for node labels -->
       <div id="node-labels"></div>
       <!-- Layer Legend (clickable filter) -->

package/dist/web/public/style.css

@@ -1825,3 +1825,150 @@ main {
   font-size: 11px;
   letter-spacing: 2px;
 }
+
+/* ═══════════════════════════════════════════ */
+/* Welcome Overlay                             */
+/* ═══════════════════════════════════════════ */
+.welcome-overlay {
+  position: absolute;
+  top: 0; left: 0; right: 0; bottom: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 50;
+  background: radial-gradient(ellipse at center, rgba(13,26,48,0.95) 0%, rgba(5,10,24,0.98) 70%);
+  backdrop-filter: blur(2px);
+}
+
+.welcome-overlay.hidden { display: none; }
+
+.welcome-content {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 16px;
+  animation: welcome-fade-in 0.8s ease-out;
+}
+
+@keyframes welcome-fade-in {
+  0% { opacity: 0; transform: translateY(20px); }
+  100% { opacity: 1; transform: translateY(0); }
+}
+
+.welcome-logo {
+  display: flex;
+  align-items: center;
+  gap: 16px;
+}
+
+.welcome-pulse-ring {
+  position: relative;
+  width: 28px;
+  height: 28px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.welcome-pulse-ring::before {
+  content: '';
+  position: absolute;
+  width: 28px; height: 28px;
+  border-radius: 50%;
+  border: 1px solid var(--risk-high);
+  animation: pulse-ring 2s ease-out infinite;
+}
+
+.welcome-pulse-dot {
+  width: 10px;
+  height: 10px;
+  border-radius: 50%;
+  background: var(--risk-high);
+  box-shadow: 0 0 12px var(--risk-high);
+  animation: pulse-glow 2s ease-in-out infinite;
+}
+
+.welcome-title {
+  font-size: 42px;
+  font-weight: 700;
+  letter-spacing: 12px;
+  color: var(--accent);
+  text-shadow: var(--glow-cyan), 0 0 40px rgba(0,212,255,0.2);
+}
+
+.welcome-subtitle {
+  font-size: 11px;
+  color: var(--text-secondary);
+  letter-spacing: 6px;
+  margin-top: -8px;
+}
+
+.welcome-msg {
+  font-size: 14px;
+  color: var(--text-primary);
+  letter-spacing: 1px;
+  margin-top: 8px;
+}
+
+.welcome-open-btn {
+  padding: 12px 40px;
+  background: rgba(0,212,255,0.1);
+  color: var(--accent);
+  border: 1px solid var(--accent);
+  border-radius: 3px;
+  cursor: pointer;
+  font-size: 13px;
+  font-family: inherit;
+  font-weight: 700;
+  letter-spacing: 4px;
+  transition: all 0.3s;
+  margin-top: 8px;
+}
+
+.welcome-open-btn:hover {
+  background: rgba(0,212,255,0.2);
+  box-shadow: var(--glow-cyan), 0 0 40px rgba(0,212,255,0.15);
+  transform: translateY(-1px);
+}
+
+.welcome-steps {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  margin-top: 24px;
+  padding: 16px 24px;
+  background: rgba(0,0,0,0.3);
+  border: 1px solid var(--border);
+  border-radius: 4px;
+}
+
+.welcome-step {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.step-num {
+  width: 22px;
+  height: 22px;
+  border-radius: 50%;
+  border: 1px solid var(--accent-dim);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 10px;
+  font-weight: 700;
+  color: var(--accent);
+}
+
+.step-text {
+  font-size: 11px;
+  color: var(--text-secondary);
+  letter-spacing: 1px;
+}
+
+.welcome-step-arrow {
+  color: var(--text-secondary);
+  font-size: 14px;
+  opacity: 0.5;
+}

package/dist/web/server.d.ts

@@ -26,4 +26,7 @@ export interface SwitchProjectResult {
 }
 export declare function createWebServer(getGraphFn: () => DependencyGraph, fileCache?: FileCache, switchProjectFn?: (newRoot: string) => SwitchProjectResult, getProjectRoot?: () => string, getPackageName?: () => string, getLicenseStatus?: () => {
     plan: string;
+    expiresAt?: string;
+    error?: string;
+    source?: string;
 }): import("express-serve-static-core").Express;

package/dist/web/server.js

@@ -245,11 +245,26 @@ function createWebServer(getGraphFn, fileCache, switchProjectFn, getProjectRoot,
             }
         }
     }
+    /**
+     * Build a specific error message for Pro-only features based on license state.
+     */
+    function getProFeatureError(featureName) {
+        const license = getLicenseStatus?.();
+        const upgrade = "https://syke.cloud/dashboard/";
+        if (license?.error) {
+            return { error: `${featureName}: ${license.error}`, requiresPro: true, upgrade };
+        }
+        if (license?.source === "online" && license?.expiresAt) {
+            // Had a license but it's no longer valid (expired trial or subscription)
+            return { error: `Trial expired. Upgrade at ${upgrade}`, requiresPro: true, upgrade };
+        }
+        return { error: `${featureName} requires SYKE Pro. Set SYKE_LICENSE_KEY or sign up at https://syke.cloud`, requiresPro: true, upgrade };
+    }
     app.get("/api/events", (_req, res) => {
         // Pro-only: real-time monitoring via SSE
         const license = getLicenseStatus?.();
         if (!license || license.plan !== "pro") {
-            res.status(403).json({ error: "Real-time monitoring requires SYKE Pro.", upgrade: "https://syke.cloud/dashboard/" });
+            res.status(403).json(getProFeatureError("Real-time monitoring"));
             return;
         }
         res.writeHead(200, {
@@ -438,10 +453,7 @@ function createWebServer(getGraphFn, fileCache, switchProjectFn, getProjectRoot,
         // License check — Pro only
         const license = getLicenseStatus?.();
         if (!license || license.plan !== "pro") {
-            return res.status(403).json({
-                error: "AI analysis requires SYKE Pro. Upgrade at https://syke.cloud/dashboard/",
-                requiresPro: true,
-            });
+            return res.status(403).json(getProFeatureError("AI analysis"));
         }
         const { file } = req.body;
         if (!file) {
@@ -465,7 +477,7 @@ function createWebServer(getGraphFn, fileCache, switchProjectFn, getProjectRoot,
     app.get("/api/hub-files", (req, res) => {
         const license = getLicenseStatus?.();
         if (!license || license.plan !== "pro") {
-            return res.status(403).json({ error: "Hub files ranking requires SYKE Pro.", upgrade: "https://syke.cloud/dashboard/" });
+            return res.status(403).json(getProFeatureError("Hub files ranking"));
         }
         const requested = parseInt(req.query.top) || 10;
         const graph = getGraphFn();
@@ -540,7 +552,7 @@ function createWebServer(getGraphFn, fileCache, switchProjectFn, getProjectRoot,
     app.get("/api/cycles", (_req, res) => {
         const license = getLicenseStatus?.();
         if (!license || license.plan !== "pro") {
-            return res.status(403).json({ error: "This feature requires SYKE Pro.", upgrade: "https://syke.cloud/dashboard/" });
+            return res.status(403).json(getProFeatureError("Cycle detection"));
         }
         const graph = getGraphFn();
         const toRel = (f) => path.relative(graph.sourceDir, f).replace(/\\/g, "/");
@@ -628,7 +640,7 @@ function createWebServer(getGraphFn, fileCache, switchProjectFn, getProjectRoot,
     app.get("/api/simulate-delete/*splat", (req, res) => {
         const license = getLicenseStatus?.();
         if (!license || license.plan !== "pro") {
-            return res.status(403).json({ error: "This feature requires SYKE Pro.", upgrade: "https://syke.cloud/dashboard/" });
+            return res.status(403).json(getProFeatureError("Delete simulation"));
         }
         const splat = req.params.splat;
         const fileParam = Array.isArray(splat) ? splat.join("/") : splat;

package/package.json

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