sdl-mcp 0.12.1 → 0.12.3

package/README.md

@@ -356,6 +356,16 @@ Each gateway tool accepts an `action` discriminator field (e.g., `{ action: "sym
 
 ---
 
+### SDL Galaxy Graph Viewer
+
+Built-in 3D graph viewer at `/ui/viewer` for cluster-level galaxy navigation, symbol-level LOD expansion, graph activity overlays, search/community/impact/edge lenses, skin packs, and idle ambient mode. The previous `/ui/graph` explorer redirects to `/ui/viewer`; legacy graph REST endpoints remain available for scripts.
+
+[Graph Viewer Deep Dive →](./docs/feature-deep-dives/graph-viewer.md)
+
+---
+
+<br/>
+
 ### Observability Dashboard
 
 Built-in read-only dashboard surfaces every metric needed to diagnose SDL-MCP behaviour without parsing stderr logs. GlitterKill dark UI at `/ui/observability` on the HTTP transport or the loopback-only `sdl-mcp serve --stdio --dashboard-port <port>` sidecar, plus REST + SSE APIs (`/api/observability/snapshot`, `/timeseries`, `/beam-explain`, `/stream`) for programmatic access. Surfaces cache hit rates, predictive-context outcome learning, hybrid-retrieval breakdowns (FTS / vector / PPR / RRF), beam-search decision traces, indexing pipeline metrics, write-pool and drain saturation, packed-wire token efficiency, and runtime CPU/memory/event-loop probes. See [Observability Dashboard Deep Dive](./docs/feature-deep-dives/observability-dashboard.md).

package/config/sdlmcp.config.example.json

@@ -104,8 +104,12 @@
     "pass2Concurrency": 1,
     "algorithmRefresh": {
       "enabled": true,
-      "pageRank": { "enabled": true },
-      "kCore": { "enabled": true },
+      "pageRank": {
+        "enabled": true
+      },
+      "kCore": {
+        "enabled": true
+      },
       "louvain": {
         "enabled": true,
         "maxCallEdges": 10000
@@ -154,8 +158,12 @@
     "enabled": true,
     "provider": "local",
     "embeddingProfile": "specialized",
-    "symbolEmbeddingModels": ["jina-embeddings-v2-base-code"],
-    "fileSummaryEmbeddingModels": ["nomic-embed-text-v1.5"],
+    "symbolEmbeddingModels": [
+      "jina-embeddings-v2-base-code"
+    ],
+    "fileSummaryEmbeddingModels": [
+      "nomic-embed-text-v1.5"
+    ],
     "modelCacheDir": null,
     "generateSummaries": true,
     "summaryProvider": "mock",
@@ -170,7 +178,9 @@
     "fileSummaryEmbeddingMaxChars": 4096,
     "embeddingsSequential": false,
     "modelVariant": "default",
-    "executionProviders": ["cpu"],
+    "executionProviders": [
+      "cpu"
+    ],
     "retrieval": {
       "mode": "hybrid",
       "extensionsOptional": true,
@@ -212,7 +222,11 @@
     "providers": {
       "scip": {
         "enabled": true,
-        "indexes": [{ "path": "index.scip" }]
+        "indexes": [
+          {
+            "path": "index.scip"
+          }
+        ]
       },
       "lsp": {
         "enabled": true,
@@ -244,6 +258,9 @@
     "otlpEndpoint": null,
     "sampleRate": 1
   },
+  "wire": {
+    "shortIds": true
+  },
   "observability": {
     "enabled": true,
     "sampleIntervalMs": 2000,
@@ -271,7 +288,13 @@
   },
   "runtime": {
     "enabled": true,
-    "allowedRuntimes": ["node", "typescript", "python", "shell", "powershell"],
+    "allowedRuntimes": [
+      "node",
+      "typescript",
+      "python",
+      "shell",
+      "powershell"
+    ],
     "allowedExecutables": [],
     "maxDurationMs": 30000,
     "maxStdoutBytes": 1048576,
@@ -331,7 +354,11 @@
     "generator": {
       "enabled": true,
       "binary": "scip-io",
-      "args": ["--include-additional-configs", "--timeout", "3600"],
+      "args": [
+        "--include-additional-configs",
+        "--timeout",
+        "3600"
+      ],
       "autoInstall": true,
       "timeoutMs": 18000000,
       "cleanupAfterIngest": true,
@@ -345,5 +372,26 @@
     "prefetch": {
       "policy": "{\"enabled\":true,\"mode\":\"safe\",\"minSamples\":20,\"suppressionWasteRate\":0.8,\"boostHitRate\":0.35,\"retentionDays\":14,\"maxPriorityBoost\":25,\"maxBudgetTrimPercent\":50}"
     }
+  },
+  "viewer": {
+    "enabled": true,
+    "skinsDir": null,
+    "fps": 60,
+    "ambient": {
+      "enabled": true,
+      "idleSeconds": 180,
+      "fps": 30
+    },
+    "layout": {
+      "engine": "auto",
+      "iterations": 300,
+      "cacheDir": null,
+      "maxSymbolsPerClusterExpand": 5000
+    },
+    "skins": {
+      "maxZipBytes": 52428800,
+      "maxEntries": 500,
+      "maxDecompressedBytes": 209715200
+    }
   }
 }