-
{key}
+
{key}
{typeof value === "object" ? JSON.stringify(value) : String(value)}
@@ -248,6 +363,8 @@ export function GraphInspectorPanel({
);
}
+/* ─── styles ─────────────────────────────────────────────────────── */
+
const inputStyle: CSSProperties = {
width: "100%",
background: "rgba(4, 10, 18, 0.5)",
@@ -284,19 +401,12 @@ const secondaryActionButtonStyle: CSSProperties = {
const predictionCardStyle: CSSProperties = {
textAlign: "left",
- padding: 12,
+ padding: "10px 12px",
background: "rgba(88, 166, 255, 0.08)",
border: "1px solid rgba(88, 166, 255, 0.12)",
borderRadius: 10,
cursor: "pointer",
-};
-
-const pathStepStyle: CSSProperties = {
- color: "#e6edf3",
- fontSize: 13,
- padding: "8px 10px",
- background: "rgba(255, 255, 255, 0.03)",
- borderRadius: 8,
+ width: "100%",
};
const propertyCardStyle: CSSProperties = {
@@ -338,3 +448,58 @@ const sectionTitleStyle: CSSProperties = {
textTransform: "uppercase",
letterSpacing: "0.08em",
};
+
+const pathFlowContainerStyle: CSSProperties = {
+ display: "flex",
+ alignItems: "center",
+ gap: 0,
+ flexWrap: "wrap",
+ rowGap: 8,
+};
+
+const pathNodeChipStyle: CSSProperties = {
+ display: "inline-flex",
+ alignItems: "center",
+ gap: 6,
+ padding: "5px 10px",
+ borderRadius: 999,
+ background: "rgba(88,166,255,0.1)",
+ border: "1px solid rgba(88,166,255,0.22)",
+ color: "#e6edf3",
+ fontSize: 12,
+ fontWeight: 600,
+ maxWidth: 160,
+};
+
+const pathNodeIndexStyle: CSSProperties = {
+ display: "inline-flex",
+ alignItems: "center",
+ justifyContent: "center",
+ width: 16,
+ height: 16,
+ borderRadius: "50%",
+ background: "rgba(88,166,255,0.22)",
+ color: "#79c0ff",
+ fontSize: 9,
+ fontWeight: 800,
+ flexShrink: 0,
+};
+
+const pathEdgeConnectorStyle: CSSProperties = {
+ display: "inline-flex",
+ alignItems: "center",
+ gap: 2,
+ flexShrink: 0,
+};
+
+const pathEdgeLabelStyle: CSSProperties = {
+ fontSize: 9,
+ fontWeight: 700,
+ color: "#6a7f97",
+ letterSpacing: "0.04em",
+ textTransform: "uppercase",
+ maxWidth: 70,
+ overflow: "hidden",
+ textOverflow: "ellipsis",
+ whiteSpace: "nowrap",
+};
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/GraphLoadingOverlay.tsx b/explorer/src/workspaces/GraphWorkspace/GraphLoadingOverlay.tsx
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/GraphLoadingOverlay.tsx
rename to explorer/src/workspaces/GraphWorkspace/GraphLoadingOverlay.tsx
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/GraphRuntimeStage.tsx b/explorer/src/workspaces/GraphWorkspace/GraphRuntimeStage.tsx
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/GraphRuntimeStage.tsx
rename to explorer/src/workspaces/GraphWorkspace/GraphRuntimeStage.tsx
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/GraphWorkspace.tsx b/explorer/src/workspaces/GraphWorkspace/GraphWorkspace.tsx
similarity index 97%
rename from semantica-explorer/src/workspaces/GraphWorkspace/GraphWorkspace.tsx
rename to explorer/src/workspaces/GraphWorkspace/GraphWorkspace.tsx
index a01dd32c..0c04357d 100644
--- a/semantica-explorer/src/workspaces/GraphWorkspace/GraphWorkspace.tsx
+++ b/explorer/src/workspaces/GraphWorkspace/GraphWorkspace.tsx
@@ -1,6 +1,7 @@
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
import { batchMergeEdges, batchMergeNodes, graph } from "../../store/graphStore";
+import { logEvent } from "../../store/registryStore";
import type { EdgeAttributes, NodeAttributes } from "../../store/graphStore";
import { curveGroupForPair } from "../../store/edgePairKeys.js";
import { InspectorPanel, MetricChip, SurfaceCard } from "../../ui/primitives";
@@ -630,6 +631,7 @@ export function GraphWorkspace() {
const [searchResults, setSearchResults] = useState
([]);
const [searchError, setSearchError] = useState("");
const [predictionType, setPredictionType] = useState("");
+ const [isRunningPredictions, setIsRunningPredictions] = useState(false);
const [predictions, setPredictions] = useState([]);
const [pathTargetId, setPathTargetId] = useState("");
const [pathResult, setPathResult] = useState(null);
@@ -814,6 +816,7 @@ export function GraphWorkspace() {
const handleRunPredictions = useCallback(async () => {
if (!selectedNodeId) return;
+ setIsRunningPredictions(true);
try {
const response = await fetch("/api/enrich/links", {
method: "POST",
@@ -833,6 +836,8 @@ export function GraphWorkspace() {
} catch (predictionError) {
console.error("[GraphWorkspace] prediction failed", predictionError);
setPredictions([]);
+ } finally {
+ setIsRunningPredictions(false);
}
}, [predictionType, selectedNodeId]);
@@ -899,6 +904,7 @@ export function GraphWorkspace() {
attributes: buildRealtimeNodeAttributes(payload),
},
]);
+ logEvent("add-node", `Added node ${payload.label ?? payload.id}${payload.nodeType ? ` (${payload.nodeType})` : ""} via realtime ws`, { nodeId: payload.id, nodeType: payload.nodeType });
sceneRef.current?.getRuntime()?.requestRender();
}
if (eventType === "ADD_EDGE") {
@@ -911,6 +917,7 @@ export function GraphWorkspace() {
attributes: buildRealtimeEdgeAttributes(payload),
},
]);
+ logEvent("add-edge", `Added edge ${payload.edgeType ?? payload.id} (${payload.source_id} → ${payload.target_id}) via realtime ws`, { edgeId: payload.id, edgeType: payload.edgeType, source: payload.source_id, target: payload.target_id });
sceneRef.current?.getRuntime()?.requestRender();
}
} catch (socketError) {
@@ -1293,10 +1300,34 @@ export function GraphWorkspace() {
disabled: showLoadingOverlay || !searchQuery.trim(),
onClick: () => void handleSearch(),
},
+ {
+ id: "zoom-in",
+ label: "＋ Zoom In",
+ title: "Zoom in (or scroll up on the canvas)",
+ onClick: () => {
+ const runtime = sceneRef.current?.getRuntime();
+ if (runtime?.renderer === "sigma") {
+ const camera = (runtime.scene as import("sigma").default).getCamera();
+ camera.animatedZoom({ duration: 200 });
+ }
+ },
+ },
+ {
+ id: "zoom-out",
+ label: "－ Zoom Out",
+ title: "Zoom out (or scroll down on the canvas)",
+ onClick: () => {
+ const runtime = sceneRef.current?.getRuntime();
+ if (runtime?.renderer === "sigma") {
+ const camera = (runtime.scene as import("sigma").default).getCamera();
+ camera.animatedUnzoom({ duration: 200 });
+ }
+ },
+ },
{
id: "fit-view",
label: "Fit View",
- title: "Reset the camera to the current view",
+ title: "Reset the camera to fit the whole graph",
onClick: () => sceneRef.current?.fitView(),
},
{
@@ -1581,6 +1612,7 @@ export function GraphWorkspace() {
predictionType={predictionType}
onPredictionTypeChange={setPredictionType}
onRunPredictions={() => void handleRunPredictions()}
+ isRunningPredictions={isRunningPredictions}
pathTargetId={pathTargetId}
onPathTargetChange={setPathTargetId}
onTracePath={() => void handleTracePath()}
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/GraphWorkspaceShell.tsx b/explorer/src/workspaces/GraphWorkspace/GraphWorkspaceShell.tsx
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/GraphWorkspaceShell.tsx
rename to explorer/src/workspaces/GraphWorkspace/GraphWorkspaceShell.tsx
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/SigmaSceneAdapter.tsx b/explorer/src/workspaces/GraphWorkspace/SigmaSceneAdapter.tsx
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/SigmaSceneAdapter.tsx
rename to explorer/src/workspaces/GraphWorkspace/SigmaSceneAdapter.tsx
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/TimelinePanel.tsx b/explorer/src/workspaces/GraphWorkspace/TimelinePanel.tsx
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/TimelinePanel.tsx
rename to explorer/src/workspaces/GraphWorkspace/TimelinePanel.tsx
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/behaviors/clickSelectionBehavior.ts b/explorer/src/workspaces/GraphWorkspace/behaviors/clickSelectionBehavior.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/behaviors/clickSelectionBehavior.ts
rename to explorer/src/workspaces/GraphWorkspace/behaviors/clickSelectionBehavior.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/behaviors/fitViewBehavior.ts b/explorer/src/workspaces/GraphWorkspace/behaviors/fitViewBehavior.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/behaviors/fitViewBehavior.ts
rename to explorer/src/workspaces/GraphWorkspace/behaviors/fitViewBehavior.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/behaviors/focusCameraBehavior.ts b/explorer/src/workspaces/GraphWorkspace/behaviors/focusCameraBehavior.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/behaviors/focusCameraBehavior.ts
rename to explorer/src/workspaces/GraphWorkspace/behaviors/focusCameraBehavior.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/behaviors/hoverActivationBehavior.ts b/explorer/src/workspaces/GraphWorkspace/behaviors/hoverActivationBehavior.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/behaviors/hoverActivationBehavior.ts
rename to explorer/src/workspaces/GraphWorkspace/behaviors/hoverActivationBehavior.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/behaviors/pathHighlightBehavior.ts b/explorer/src/workspaces/GraphWorkspace/behaviors/pathHighlightBehavior.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/behaviors/pathHighlightBehavior.ts
rename to explorer/src/workspaces/GraphWorkspace/behaviors/pathHighlightBehavior.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/behaviors/searchFocusBehavior.ts b/explorer/src/workspaces/GraphWorkspace/behaviors/searchFocusBehavior.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/behaviors/searchFocusBehavior.ts
rename to explorer/src/workspaces/GraphWorkspace/behaviors/searchFocusBehavior.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/behaviors/types.ts b/explorer/src/workspaces/GraphWorkspace/behaviors/types.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/behaviors/types.ts
rename to explorer/src/workspaces/GraphWorkspace/behaviors/types.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/behaviors/viewModeSwitchBehavior.ts b/explorer/src/workspaces/GraphWorkspace/behaviors/viewModeSwitchBehavior.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/behaviors/viewModeSwitchBehavior.ts
rename to explorer/src/workspaces/GraphWorkspace/behaviors/viewModeSwitchBehavior.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/graphAnalytics.ts b/explorer/src/workspaces/GraphWorkspace/graphAnalytics.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/graphAnalytics.ts
rename to explorer/src/workspaces/GraphWorkspace/graphAnalytics.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/graphConfig.ts b/explorer/src/workspaces/GraphWorkspace/graphConfig.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/graphConfig.ts
rename to explorer/src/workspaces/GraphWorkspace/graphConfig.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/graphLoading.ts b/explorer/src/workspaces/GraphWorkspace/graphLoading.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/graphLoading.ts
rename to explorer/src/workspaces/GraphWorkspace/graphLoading.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/graphSceneLayers.ts b/explorer/src/workspaces/GraphWorkspace/graphSceneLayers.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/graphSceneLayers.ts
rename to explorer/src/workspaces/GraphWorkspace/graphSceneLayers.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/graphSceneState.ts b/explorer/src/workspaces/GraphWorkspace/graphSceneState.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/graphSceneState.ts
rename to explorer/src/workspaces/GraphWorkspace/graphSceneState.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/graphTheme.ts b/explorer/src/workspaces/GraphWorkspace/graphTheme.ts
similarity index 86%
rename from semantica-explorer/src/workspaces/GraphWorkspace/graphTheme.ts
rename to explorer/src/workspaces/GraphWorkspace/graphTheme.ts
index bce23092..ea033613 100644
--- a/semantica-explorer/src/workspaces/GraphWorkspace/graphTheme.ts
+++ b/explorer/src/workspaces/GraphWorkspace/graphTheme.ts
@@ -265,16 +265,16 @@ export const GRAPH_THEME: GraphTheme = {
],
overview: {
nodeBase: "#0B1320",
- nodeCore: "#435D7A",
+ nodeCore: "#5A7A9E",
nodeMuted: "#121927",
- nodeBorder: "#64758C",
- nodeTintMix: 0.03,
- nodeCoreMix: 0.52,
+ nodeBorder: "#7A92AE",
+ nodeTintMix: 0.14,
+ nodeCoreMix: 0.72,
nodeShellAlpha: 0.97,
nodeCoreAlpha: 1,
- edgeBackbone: "rgba(83, 111, 148, 0.04)",
- edgeStructure: "rgba(72, 90, 118, 0.009)",
- edgeInspection: "rgba(98, 120, 148, 0.026)",
+ edgeBackbone: "rgba(100, 148, 210, 0.38)",
+ edgeStructure: "rgba(88, 140, 200, 0.28)",
+ edgeInspection: "rgba(110, 165, 230, 0.48)",
},
accent: {
selected: "#F2D288",
@@ -285,12 +285,12 @@ export const GRAPH_THEME: GraphTheme = {
inferred: "#D07B4D",
},
muted: {
- fallback: "rgba(96, 112, 136, 0.1)",
- nodeAlpha: 0.085,
- edgeOverview: "rgba(82, 100, 124, 0.009)",
- edgeStructure: "rgba(92, 112, 138, 0.02)",
- edgeInspection: "rgba(124, 148, 176, 0.066)",
- edgeFocus: "rgba(160, 186, 218, 0.16)",
+ fallback: "rgba(96, 112, 136, 0.18)",
+ nodeAlpha: 0.12,
+ edgeOverview: "rgba(82, 100, 124, 0.12)",
+ edgeStructure: "rgba(92, 112, 138, 0.18)",
+ edgeInspection: "rgba(124, 148, 176, 0.26)",
+ edgeFocus: "rgba(160, 186, 218, 0.42)",
},
background: {
canvas: "#07101A",
@@ -305,36 +305,36 @@ export const GRAPH_THEME: GraphTheme = {
zoomTiers: {
overview: {
maxRatio: Number.POSITIVE_INFINITY,
- nodeScale: 0.66,
- labelThreshold: 0.985,
- labelBudget: 10,
- edgePriorityThreshold: 0.72,
+ nodeScale: 0.88,
+ labelThreshold: 0.92,
+ labelBudget: 28,
+ edgePriorityThreshold: 0.55,
arrowPriorityThreshold: Number.POSITIVE_INFINITY,
- edgeSizeScale: 0.34,
+ edgeSizeScale: 0.62,
showBadges: false,
showCurves: false,
showContextualArrows: false,
},
structure: {
maxRatio: 1.2,
- nodeScale: 0.98,
- labelThreshold: 0.88,
- labelBudget: 36,
- edgePriorityThreshold: 0.4,
- arrowPriorityThreshold: 0.75,
- edgeSizeScale: 0.92,
+ nodeScale: 1.02,
+ labelThreshold: 0.82,
+ labelBudget: 60,
+ edgePriorityThreshold: 0.3,
+ arrowPriorityThreshold: 0.65,
+ edgeSizeScale: 1.05,
showBadges: true,
showCurves: true,
showContextualArrows: true,
},
inspection: {
maxRatio: 0.5,
- nodeScale: 1,
- labelThreshold: 0.7,
- labelBudget: 80,
+ nodeScale: 1.08,
+ labelThreshold: 0.6,
+ labelBudget: 120,
edgePriorityThreshold: 0,
- arrowPriorityThreshold: 0.58,
- edgeSizeScale: 1.04,
+ arrowPriorityThreshold: 0.45,
+ edgeSizeScale: 1.18,
showBadges: true,
showCurves: true,
showContextualArrows: true,
@@ -398,13 +398,13 @@ export const GRAPH_THEME: GraphTheme = {
inspection: { base: 1.2, emphasis: 1.7, muted: 0.6 },
},
states: {
- default: { color: "base", sizeMultiplier: 0.72, minSize: 0.68, forceLabel: false, zIndex: 0, borderBoost: -0.42 },
- hovered: { color: "hovered", sizeMultiplier: 1.18, minSize: 12.5, forceLabel: true, zIndex: 4, borderBoost: 0.22 },
- selected: { color: "selected", sizeMultiplier: 1.06, minSize: 10.5, forceLabel: true, zIndex: 3, borderBoost: 0.2 },
- neighbor: { color: "base", sizeMultiplier: 0.84, minSize: 4.8, forceLabel: true, zIndex: 2, borderBoost: -0.08 },
- path: { color: "path", sizeMultiplier: 1.01, minSize: 6.2, forceLabel: true, zIndex: 2, borderBoost: 0.08 },
- inactive: { color: "muted", sizeMultiplier: 0.32, minSize: 0.46, forceLabel: false, zIndex: 0, borderBoost: -0.42 },
- muted: { color: "muted", sizeMultiplier: 0.32, minSize: 0.46, forceLabel: false, zIndex: 0, borderBoost: -0.42 },
+ default: { color: "base", sizeMultiplier: 0.92, minSize: 3.5, forceLabel: false, zIndex: 0, borderBoost: -0.18 },
+ hovered: { color: "hovered", sizeMultiplier: 1.28, minSize: 13.5, forceLabel: true, zIndex: 4, borderBoost: 0.28 },
+ selected: { color: "selected", sizeMultiplier: 1.14, minSize: 11.5, forceLabel: true, zIndex: 3, borderBoost: 0.24 },
+ neighbor: { color: "base", sizeMultiplier: 0.96, minSize: 5.5, forceLabel: true, zIndex: 2, borderBoost: 0.04 },
+ path: { color: "path", sizeMultiplier: 1.08, minSize: 7.0, forceLabel: true, zIndex: 2, borderBoost: 0.12 },
+ inactive: { color: "muted", sizeMultiplier: 0.48, minSize: 1.8, forceLabel: false, zIndex: 0, borderBoost: -0.28 },
+ muted: { color: "muted", sizeMultiplier: 0.48, minSize: 1.8, forceLabel: false, zIndex: 0, borderBoost: -0.28 },
},
variants: {
default: { sizeMultiplier: 1, borderBoost: 0, haloBoost: 0, badgeVisibleFrom: "inspection" },
@@ -437,14 +437,14 @@ export const GRAPH_THEME: GraphTheme = {
},
edges: {
states: {
- default: { color: "structure", sizeMultiplier: 0.74, minSize: 0.18, zIndex: 0, forceArrow: false, hide: false },
- backbone: { color: "backbone", sizeMultiplier: 0.72, minSize: 0.18, zIndex: 1, forceArrow: false, hide: false },
- hovered: { color: "hover", sizeMultiplier: 1.42, minSize: 1.45, zIndex: 3, forceArrow: true, hide: false },
- selected: { color: "hover", sizeMultiplier: 1.42, minSize: 1.45, zIndex: 3, forceArrow: true, hide: false },
- neighbor: { color: "focus", sizeMultiplier: 0.92, minSize: 0.5, zIndex: 1, forceArrow: false, hide: false },
- path: { color: "path", sizeMultiplier: 1.5, minSize: 1.8, zIndex: 4, forceArrow: true, hide: false },
- inactive: { color: "muted", sizeMultiplier: 1, minSize: 0.16, zIndex: 0, forceArrow: false, hide: true },
- muted: { color: "muted", sizeMultiplier: 1, minSize: 0.16, zIndex: 0, forceArrow: false, hide: true },
+ default: { color: "structure", sizeMultiplier: 0.96, minSize: 0.9, zIndex: 0, forceArrow: false, hide: false },
+ backbone: { color: "backbone", sizeMultiplier: 1.0, minSize: 1.0, zIndex: 1, forceArrow: false, hide: false },
+ hovered: { color: "hover", sizeMultiplier: 1.6, minSize: 2.2, zIndex: 3, forceArrow: true, hide: false },
+ selected: { color: "hover", sizeMultiplier: 1.6, minSize: 2.2, zIndex: 3, forceArrow: true, hide: false },
+ neighbor: { color: "focus", sizeMultiplier: 1.1, minSize: 1.2, zIndex: 1, forceArrow: false, hide: false },
+ path: { color: "path", sizeMultiplier: 1.7, minSize: 2.4, zIndex: 4, forceArrow: true, hide: false },
+ inactive: { color: "muted", sizeMultiplier: 0.6, minSize: 0.5, zIndex: 0, forceArrow: false, hide: false },
+ muted: { color: "muted", sizeMultiplier: 0.6, minSize: 0.5, zIndex: 0, forceArrow: false, hide: false },
},
variants: {
line: { baseType: "line", arrowPolicy: "hidden", curveStrength: 0, sizeMultiplier: 1, glowAlpha: 0 },
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/plugins/explorationEffectsPlugin.tsx b/explorer/src/workspaces/GraphWorkspace/plugins/explorationEffectsPlugin.tsx
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/plugins/explorationEffectsPlugin.tsx
rename to explorer/src/workspaces/GraphWorkspace/plugins/explorationEffectsPlugin.tsx
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/plugins/explorationEffectsPluginPhaseC.tsx b/explorer/src/workspaces/GraphWorkspace/plugins/explorationEffectsPluginPhaseC.tsx
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/plugins/explorationEffectsPluginPhaseC.tsx
rename to explorer/src/workspaces/GraphWorkspace/plugins/explorationEffectsPluginPhaseC.tsx
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/plugins/index.ts b/explorer/src/workspaces/GraphWorkspace/plugins/index.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/plugins/index.ts
rename to explorer/src/workspaces/GraphWorkspace/plugins/index.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/plugins/legendPlugin.tsx b/explorer/src/workspaces/GraphWorkspace/plugins/legendPlugin.tsx
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/plugins/legendPlugin.tsx
rename to explorer/src/workspaces/GraphWorkspace/plugins/legendPlugin.tsx
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/plugins/neighborhoodPanelPlugin.tsx b/explorer/src/workspaces/GraphWorkspace/plugins/neighborhoodPanelPlugin.tsx
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/plugins/neighborhoodPanelPlugin.tsx
rename to explorer/src/workspaces/GraphWorkspace/plugins/neighborhoodPanelPlugin.tsx
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/plugins/temporalOverlayPlugin.tsx b/explorer/src/workspaces/GraphWorkspace/plugins/temporalOverlayPlugin.tsx
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/plugins/temporalOverlayPlugin.tsx
rename to explorer/src/workspaces/GraphWorkspace/plugins/temporalOverlayPlugin.tsx
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/plugins/types.ts b/explorer/src/workspaces/GraphWorkspace/plugins/types.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/plugins/types.ts
rename to explorer/src/workspaces/GraphWorkspace/plugins/types.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/scene.ts b/explorer/src/workspaces/GraphWorkspace/scene.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/scene.ts
rename to explorer/src/workspaces/GraphWorkspace/scene.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/sigmaNativeRendering.ts b/explorer/src/workspaces/GraphWorkspace/sigmaNativeRendering.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/sigmaNativeRendering.ts
rename to explorer/src/workspaces/GraphWorkspace/sigmaNativeRendering.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/types.ts b/explorer/src/workspaces/GraphWorkspace/types.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/types.ts
rename to explorer/src/workspaces/GraphWorkspace/types.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/useGraphData.ts b/explorer/src/workspaces/GraphWorkspace/useGraphData.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/useGraphData.ts
rename to explorer/src/workspaces/GraphWorkspace/useGraphData.ts
diff --git a/semantica-explorer/src/workspaces/GraphWorkspace/useLoadGraph.ts b/explorer/src/workspaces/GraphWorkspace/useLoadGraph.ts
similarity index 100%
rename from semantica-explorer/src/workspaces/GraphWorkspace/useLoadGraph.ts
rename to explorer/src/workspaces/GraphWorkspace/useLoadGraph.ts
diff --git a/semantica-explorer/src/workspaces/ImportExportWorkspace/ImportExportWorkspace.tsx b/explorer/src/workspaces/ImportExportWorkspace/ImportExportWorkspace.tsx
similarity index 96%
rename from semantica-explorer/src/workspaces/ImportExportWorkspace/ImportExportWorkspace.tsx
rename to explorer/src/workspaces/ImportExportWorkspace/ImportExportWorkspace.tsx
index abf32aba..44b0df58 100644
--- a/semantica-explorer/src/workspaces/ImportExportWorkspace/ImportExportWorkspace.tsx
+++ b/explorer/src/workspaces/ImportExportWorkspace/ImportExportWorkspace.tsx
@@ -4,6 +4,7 @@
import { useState, useCallback } from "react";
import { useDropzone } from "react-dropzone";
import { UploadCloud, Download, FileJson, FileText, CheckCircle2, AlertCircle, Loader2 } from "lucide-react";
+import { logEvent } from "../../store/registryStore";
const THEME_CSS = `
.glass-panel {
@@ -107,6 +108,11 @@ export function ImportExportWorkspace() {
const data = await res.json();
showToast("success", `Imported ${data.nodes_imported} nodes and ${data.edges_imported} edges!`);
+ logEvent("import", `Imported ${data.nodes_imported} nodes · ${data.edges_imported} edges from ${file.name}`, {
+ file: file.name,
+ nodesImported: data.nodes_imported,
+ edgesImported: data.edges_imported,
+ });
setFile(null);
} catch (err: any) {
showToast("error", err.message || "An error occurred during import");
@@ -142,6 +148,7 @@ export function ImportExportWorkspace() {
document.body.removeChild(a);
showToast("success", "Export complete! Your download should begin shortly.");
+ logEvent("export", `Exported graph as ${exportFormat.toUpperCase()}`, { format: exportFormat });
} catch (err: any) {
showToast("error", err.message || "An error occurred during export");
} finally {
diff --git a/semantica-explorer/src/workspaces/LineageWorkspace/LineageDiagram.tsx b/explorer/src/workspaces/LineageWorkspace/LineageDiagram.tsx
similarity index 100%
rename from semantica-explorer/src/workspaces/LineageWorkspace/LineageDiagram.tsx
rename to explorer/src/workspaces/LineageWorkspace/LineageDiagram.tsx
diff --git a/explorer/src/workspaces/ManageWorkspace/KGOverviewTab.tsx b/explorer/src/workspaces/ManageWorkspace/KGOverviewTab.tsx
new file mode 100644
index 00000000..60866143
--- /dev/null
+++ b/explorer/src/workspaces/ManageWorkspace/KGOverviewTab.tsx
@@ -0,0 +1,339 @@
+/**
+ * src/workspaces/ManageWorkspace/KGOverviewTab.tsx
+ *
+ * Quick-view dashboard for the Knowledge Graph: node/edge counts,
+ * type distributions, and top connected nodes.
+ */
+import { useState, useEffect, useCallback } from "react";
+import { Network, RefreshCw, Loader2 } from "lucide-react";
+
+interface KGStats {
+ node_count: number;
+ edge_count: number;
+ node_types?: Record;
+ edge_types?: Record;
+ [key: string]: unknown;
+}
+
+interface NodeItem {
+ id: string;
+ type: string;
+ content: string;
+ properties?: Record;
+}
+
+interface NodeListResponse {
+ nodes: NodeItem[];
+ total: number;
+}
+
+function TypeBar({ label, count, total, color }: { label: string; count: number; total: number; color: string }) {
+ const pct = total > 0 ? Math.round((count / total) * 100) : 0;
+ return (
+
+
+ {label}
+
+
+
+ {count.toLocaleString()}
+ {pct}%
+
+
{
+ const map: Record = {};
+ for (const node of nodes) {
+ const val = String(node[key] ?? "unknown");
+ map[val] = (map[val] ?? 0) + 1;
+ }
+ return map;
+}
+
+export function KGOverviewTab() {
+ const [stats, setStats] = useState(null);
+ const [loading, setLoading] = useState(false);
+ const [error, setError] = useState("");
+ const [topNodes, setTopNodes] = useState<{ node: NodeItem; neighborCount: number }[]>([]);
+ const [nodeTypeMap, setNodeTypeMap] = useState>({});
+
+ const fetchOverview = useCallback(async () => {
+ setLoading(true);
+ setError("");
+ try {
+ const [statsRes, nodesRes] = await Promise.all([
+ fetch("/api/graph/stats"),
+ fetch("/api/graph/nodes?limit=500"),
+ ]);
+
+ if (statsRes.ok) {
+ const statsData: KGStats = await statsRes.json();
+ setStats(statsData);
+ }
+
+ if (nodesRes.ok) {
+ const nodesData: NodeListResponse = await nodesRes.json();
+ const nodes = nodesData.nodes ?? [];
+ setNodeTypeMap(buildTypeMap(nodes, "type"));
+
+ // Simulate neighbor counts via edges fetch for top-N
+ const edgesRes = await fetch("/api/graph/edges?limit=2000");
+ if (edgesRes.ok) {
+ const edgesData = await edgesRes.json();
+ const edges: { source: string; target: string }[] = edgesData.edges ?? [];
+ const degreeMap: Record = {};
+ for (const edge of edges) {
+ degreeMap[edge.source] = (degreeMap[edge.source] ?? 0) + 1;
+ degreeMap[edge.target] = (degreeMap[edge.target] ?? 0) + 1;
+ }
+ const sorted = nodes
+ .map((n) => ({ node: n, neighborCount: degreeMap[n.id] ?? 0 }))
+ .sort((a, b) => b.neighborCount - a.neighborCount)
+ .slice(0, 10);
+ setTopNodes(sorted);
+ }
+ }
+ } catch {
+ setError("Failed to load graph overview. Ensure the server is running.");
+ } finally {
+ setLoading(false);
+ }
+ }, []);
+
+ useEffect(() => {
+ void fetchOverview();
+ }, [fetchOverview]);
+
+ const nodeTypeEntries = Object.entries(nodeTypeMap).sort((a, b) => b[1] - a[1]);
+ const edgeTypeEntries = stats?.edge_types
+ ? Object.entries(stats.edge_types).sort((a, b) => b[1] - a[1])
+ : [];
+
+ const totalNodes = stats?.node_count ?? 0;
+ const totalEdges = stats?.edge_count ?? 0;
+
+ return (
+
+ {/* Header */}
+
+
+
+
+
KG Overview
+
Quick view of the Knowledge Graph structure and health
+
+
+
void fetchOverview()} disabled={loading} style={refreshBtnStyle}>
+ {loading ? Refresh
+
+
+
+ {error ? (
+
+ {error}
+
+ ) : null}
+
+
+ {/* Stats chips */}
+
+ {[
+ { label: "Nodes", value: totalNodes.toLocaleString(), color: "#4aa3ff", sub: `${nodeTypeEntries.length} types` },
+ { label: "Edges", value: totalEdges.toLocaleString(), color: "#4cc38a", sub: `${edgeTypeEntries.length} relationship types` },
+ { label: "Density", value: totalNodes > 1 ? ((totalEdges / (totalNodes * (totalNodes - 1))) * 100).toFixed(3) + "%" : "—", color: "#d2a8ff", sub: "graph density" },
+ ].map(({ label, value, color, sub }) => (
+
+
{label}
+
{loading ? "—" : value}
+
{sub}
+
+ ))}
+
+
+ {/* Type breakdowns */}
+
+ {/* Node types */}
+
+
Node Type Breakdown
+ {loading ? (
+
+ {[80, 65, 45, 35, 25].map((w, i) => (
+
+ ))}
+
+ ) : nodeTypeEntries.length === 0 ? (
+
No data — load the graph first.
+ ) : (
+ nodeTypeEntries.slice(0, 8).map(([type, count], i) => (
+
+ ))
+ )}
+
+
+ {/* Edge types */}
+
+
Edge Type Breakdown
+ {loading ? (
+
+ {[70, 55, 48, 30, 20].map((w, i) => (
+
+ ))}
+
+ ) : edgeTypeEntries.length === 0 ? (
+
Edge type breakdown requires the stats endpoint to return edge_types.
+ ) : (
+ edgeTypeEntries.slice(0, 8).map(([type, count], i) => (
+
+ ))
+ )}
+
+
+
+ {/* Top connected nodes */}
+ {topNodes.length > 0 ? (
+
+
Top Connected Nodes (by degree)
+
+ {topNodes.map(({ node, neighborCount }, rank) => (
+
+
#{rank + 1}
+
+
+ {node.content || node.id}
+
+
{node.type}
+
+
+ {neighborCount} conn.
+
+
+ ))}
+
+
+ ) : null}
+
+
{ (e.currentTarget as HTMLDivElement).style.background = "rgba(74,163,255,0.07)"; }}
+ onMouseLeave={(e) => { (e.currentTarget as HTMLDivElement).style.background = "transparent"; }}
+ >
+ {hasChildren ? (
+ setExpanded((v) => !v)}
+ style={{ background: "transparent", border: "none", color: "#8b949e", cursor: "pointer", padding: 0, display: "flex", alignItems: "center" }}
+ >
+ {expanded ?
+ ) : (
+ onSelect(concept)}
+ style={{ flex: 1, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" }}
+ >
+ {concept.pref_label || concept.uri}
+
+ {children.length > 0 ? (
+ {children.length}
+ ) : null}
+
+ {expanded && hasChildren
+ ? children.map((child) => (
+
+ {/* Scheme header */}
+
setExpanded((v) => !v)}
+ style={schemeHeaderStyle}
+ >
+
+ {expanded ? {scheme.label}
+
+
+ {isLoading ? "…" : `${totalConcepts} concept${totalConcepts !== 1 ? "s" : ""}`}
+
+
+
+ {/* Concept tree */}
+ {expanded ? (
+
+ {isLoading ? (
+
Loading concepts…
+ ) : hierarchy.length === 0 ? (
+
+ No concepts found in this scheme.
+
+ ) : (
+ hierarchy.map((concept) => (
+
+ ))
+ )}
+
+ ) : null}
+
(null);
+
+ return (
+
+ {/* Header */}
+
+
+
+
+
Ontology Summary
+
+ {isLoading
+ ? "Loading schemes…"
+ : `${schemes.length} vocabulary scheme${schemes.length !== 1 ? "s" : ""} loaded`}
+
+
+
+ {onOpenVocabularyBrowser ? (
+
+ Open Full Browser
+
+ ) : null}
+
+
+
+ {/* Scheme tree column */}
+
+ {isLoading ? (
+
+ {[90, 75, 60].map((w, i) => (
+
+ ))}
+
+ ) : schemes.length === 0 ? (
+
+
+
No vocabulary schemes loaded
+
+ Import a .ttl or .rdf file via the Vocabulary Browser to see your ontology here.
+
+
+ ) : (
+
+ {schemes.map((scheme) => (
+
+ )}
+
+
+ {/* Concept detail panel */}
+ {selectedConcept ? (
+
+
+
+ Concept Detail
+
+
setSelectedConcept(null)} style={{ background: "transparent", border: "none", color: "#8b949e", cursor: "pointer", fontSize: 16 }}>×
+
+
+
+ {selectedConcept.pref_label}
+
+ {selectedConcept.notation ? (
+
Notation: {selectedConcept.notation}
+ ) : null}
+
+ {selectedConcept.uri}
+
+
+ {selectedConcept.description ? (
+
+
Description
+
{selectedConcept.description}
+
+ ) : null}
+
+ {selectedConcept.alt_labels?.length ? (
+
+
Alternative Labels
+
+ {selectedConcept.alt_labels.map((label) => (
+ {label}
+ ))}
+
+
+ ) : null}
+
+ {(selectedConcept.children?.length ?? 0) > 0 ? (
+
+
Narrower Concepts ({selectedConcept.children!.length})
+
+ {selectedConcept.children!.slice(0, 8).map((child) => (
+
setSelectedConcept(child)}
+ style={{ color: "#79c0ff", fontSize: 12, cursor: "pointer", padding: "3px 0" }}
+ >
+ → {child.pref_label}
+
+ ))}
+ {selectedConcept.children!.length > 8 ? (
+
+{selectedConcept.children!.length - 8} more
+ ) : null}
+
+
+ ) : null}
+
+ ) : null}
+
+
`
5. `/semantica:validate graph`
+## MCP Server (Windsurf · Cline · Continue · VS Code · Claude Desktop · Any tool)
+
+Semantica includes a full MCP server (`semantica/mcp_server.py`) that exposes 12 tools and 3 resources over stdio — compatible with any MCP-aware tool.
+
+### Start the server
+
+```bash
+python -m semantica.mcp_server
+```
+
+### Configure in your tool
+
+**Claude Desktop** — `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+ "mcpServers": {
+ "semantica": {
+ "command": "python",
+ "args": ["-m", "semantica.mcp_server"]
+ }
+ }
+}
+```
+
+**Windsurf** — `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+ "mcpServers": {
+ "semantica": {
+ "command": "python",
+ "args": ["-m", "semantica.mcp_server"]
+ }
+ }
+}
+```
+
+**Cline** — Cline MCP settings panel → Add server:
+
+```json
+{
+ "semantica": {
+ "command": "python",
+ "args": ["-m", "semantica.mcp_server"]
+ }
+}
+```
+
+**Continue** — `~/.continue/config.json`:
+
+```json
+{
+ "mcpServers": [
+ {
+ "name": "semantica",
+ "command": "python",
+ "args": ["-m", "semantica.mcp_server"]
+ }
+ ]
+}
+```
+
+**VS Code** — `settings.json`:
+
+```json
+{
+ "mcp.servers": {
+ "semantica": {
+ "command": "python",
+ "args": ["-m", "semantica.mcp_server"]
+ }
+ }
+}
+```
+
+### Available MCP tools
+
+| Tool | Description |
+|---|---|
+| `extract_entities` | Named entity recognition from text |
+| `extract_relations` | Relation and triplet extraction from text |
+| `record_decision` | Record a decision with full context and metadata |
+| `query_decisions` | Query recorded decisions by natural language or category |
+| `find_precedents` | Find past decisions similar to a scenario |
+| `get_causal_chain` | Trace upstream/downstream causal chain from a decision |
+| `add_entity` | Add a node/entity to the knowledge graph |
+| `add_relationship` | Add a directed edge between two entities |
+| `run_reasoning` | Run IF/THEN rules over facts to derive new facts |
+| `get_graph_analytics` | PageRank centrality and community detection |
+| `export_graph` | Export graph as Turtle, JSON-LD, N-Triples, or JSON |
+| `get_graph_summary` | Node count, decision count, graph status |
+
+### Available MCP resources
+
+| URI | Description |
+|---|---|
+| `semantica://graph/summary` | High-level graph statistics |
+| `semantica://decisions/list` | All recorded decisions |
+| `semantica://schema/info` | Server info and capability list |
+
+### Environment variables
+
+| Variable | Description |
+|---|---|
+| `SEMANTICA_KG_PATH` | Path to a persisted graph to load on start |
+| `SEMANTICA_LOG_LEVEL` | Log level: DEBUG, INFO, WARNING (default: WARNING) |
+
## Community Notes
- Keep plugin name/version/keywords updated in each manifest before publishing.
diff --git a/plugins/.cline-plugin/README.md b/plugins/.cline-plugin/README.md
new file mode 100644
index 00000000..c097b82b
--- /dev/null
+++ b/plugins/.cline-plugin/README.md
@@ -0,0 +1,24 @@
+# Semantica — Cline Plugin
+
+Adds all 17 Semantica skills, 3 agents, and hook configuration to Cline (VS Code extension).
+
+## MCP Server Setup (recommended)
+
+In Cline settings, add a new MCP server:
+
+```json
+{
+ "semantica": {
+ "command": "python",
+ "args": ["-m", "semantica.mcp_server"],
+ "env": {}
+ }
+}
+```
+
+Cline will discover all 12 Semantica tools automatically on connection.
+
+## Requirements
+
+- Python 3.8+
+- `pip install semantica`
diff --git a/plugins/.cline-plugin/marketplace.json b/plugins/.cline-plugin/marketplace.json
new file mode 100644
index 00000000..335fb8fc
--- /dev/null
+++ b/plugins/.cline-plugin/marketplace.json
@@ -0,0 +1,17 @@
+{
+ "name": "semantica-cline",
+ "plugins": [
+ {
+ "name": "semantica",
+ "description": "Semantica plugin for Cline: knowledge graph skills, reasoning, extraction, and visualization.",
+ "source": "./",
+ "category": "Productivity",
+ "tags": [
+ "knowledge-graph",
+ "reasoning",
+ "semantica",
+ "cline"
+ ]
+ }
+ ]
+}
diff --git a/plugins/.cline-plugin/plugin.json b/plugins/.cline-plugin/plugin.json
new file mode 100644
index 00000000..81c004c4
--- /dev/null
+++ b/plugins/.cline-plugin/plugin.json
@@ -0,0 +1,35 @@
+{
+ "name": "semantica-cline",
+ "displayName": "Semantica Cline Plugin",
+ "description": "Semantica plugin for Cline: knowledge graph skills, decision intelligence, reasoning, extraction, and visualization.",
+ "version": "0.1.0",
+ "author": {
+ "name": "Semantica Contributors"
+ },
+ "homepage": "https://github.com/Hawksight-AI/semantica",
+ "repository": "https://github.com/Hawksight-AI/semantica",
+ "license": "MIT",
+ "keywords": [
+ "semantica",
+ "knowledge graph",
+ "cline",
+ "context graphs",
+ "decision intelligence",
+ "explainability",
+ "causal analysis",
+ "provenance",
+ "ontology",
+ "graph analytics",
+ "semantic extraction",
+ "visualization",
+ "reasoning",
+ "mcp"
+ ],
+ "skills": "../skills",
+ "agents": "../agents",
+ "hooks": "../hooks/hooks.json",
+ "mcp": {
+ "server": "python -m semantica.mcp_server",
+ "transport": "stdio"
+ }
+}
diff --git a/plugins/.continue-plugin/README.md b/plugins/.continue-plugin/README.md
new file mode 100644
index 00000000..b1a4ca2d
--- /dev/null
+++ b/plugins/.continue-plugin/README.md
@@ -0,0 +1,26 @@
+# Semantica — Continue Plugin
+
+Adds Semantica as an MCP server and context provider to [Continue.dev](https://continue.dev).
+
+## MCP Server Setup
+
+Add to `~/.continue/config.json`:
+
+```json
+{
+ "mcpServers": [
+ {
+ "name": "semantica",
+ "command": "python",
+ "args": ["-m", "semantica.mcp_server"]
+ }
+ ]
+}
+```
+
+Continue will show all Semantica tools in the `@semantica` context provider dropdown.
+
+## Requirements
+
+- Python 3.8+
+- `pip install semantica`
diff --git a/plugins/.continue-plugin/marketplace.json b/plugins/.continue-plugin/marketplace.json
new file mode 100644
index 00000000..0ff7e099
--- /dev/null
+++ b/plugins/.continue-plugin/marketplace.json
@@ -0,0 +1,17 @@
+{
+ "name": "semantica-continue",
+ "plugins": [
+ {
+ "name": "semantica",
+ "description": "Semantica plugin for Continue.dev: knowledge graph context provider, reasoning, and extraction.",
+ "source": "./",
+ "category": "Productivity",
+ "tags": [
+ "knowledge-graph",
+ "reasoning",
+ "semantica",
+ "continue"
+ ]
+ }
+ ]
+}
diff --git a/plugins/.continue-plugin/plugin.json b/plugins/.continue-plugin/plugin.json
new file mode 100644
index 00000000..da93dc38
--- /dev/null
+++ b/plugins/.continue-plugin/plugin.json
@@ -0,0 +1,33 @@
+{
+ "name": "semantica-continue",
+ "displayName": "Semantica Continue Plugin",
+ "description": "Semantica plugin for Continue.dev: knowledge graph context provider, decision intelligence, reasoning, and semantic extraction.",
+ "version": "0.1.0",
+ "author": {
+ "name": "Semantica Contributors"
+ },
+ "homepage": "https://github.com/Hawksight-AI/semantica",
+ "repository": "https://github.com/Hawksight-AI/semantica",
+ "license": "MIT",
+ "keywords": [
+ "semantica",
+ "knowledge graph",
+ "continue",
+ "context provider",
+ "decision intelligence",
+ "explainability",
+ "causal analysis",
+ "provenance",
+ "ontology",
+ "semantic extraction",
+ "reasoning",
+ "mcp"
+ ],
+ "skills": "../skills",
+ "agents": "../agents",
+ "hooks": "../hooks/hooks.json",
+ "mcp": {
+ "server": "python -m semantica.mcp_server",
+ "transport": "stdio"
+ }
+}
diff --git a/plugins/.vscode-plugin/README.md b/plugins/.vscode-plugin/README.md
new file mode 100644
index 00000000..5a0b7531
--- /dev/null
+++ b/plugins/.vscode-plugin/README.md
@@ -0,0 +1,36 @@
+# Semantica — VS Code Plugin
+
+Adds Semantica as an MCP server to VS Code (via GitHub Copilot Chat or any MCP-aware extension).
+
+## MCP Server Setup
+
+Add to your VS Code `settings.json`:
+
+```json
+{
+ "github.copilot.chat.mcp.servers": {
+ "semantica": {
+ "command": "python",
+ "args": ["-m", "semantica.mcp_server"]
+ }
+ }
+}
+```
+
+Or if using the VS Code MCP extension directly:
+
+```json
+{
+ "mcp.servers": {
+ "semantica": {
+ "command": "python",
+ "args": ["-m", "semantica.mcp_server"]
+ }
+ }
+}
+```
+
+## Requirements
+
+- Python 3.8+
+- `pip install semantica`
diff --git a/plugins/.vscode-plugin/marketplace.json b/plugins/.vscode-plugin/marketplace.json
new file mode 100644
index 00000000..76f4b2a2
--- /dev/null
+++ b/plugins/.vscode-plugin/marketplace.json
@@ -0,0 +1,17 @@
+{
+ "name": "semantica-vscode",
+ "plugins": [
+ {
+ "name": "semantica",
+ "description": "Semantica plugin for VS Code: knowledge graph skills, reasoning, extraction, and visualization.",
+ "source": "./",
+ "category": "Productivity",
+ "tags": [
+ "knowledge-graph",
+ "reasoning",
+ "semantica",
+ "vscode"
+ ]
+ }
+ ]
+}
diff --git a/plugins/.vscode-plugin/plugin.json b/plugins/.vscode-plugin/plugin.json
new file mode 100644
index 00000000..a39c097e
--- /dev/null
+++ b/plugins/.vscode-plugin/plugin.json
@@ -0,0 +1,35 @@
+{
+ "name": "semantica-vscode",
+ "displayName": "Semantica VS Code Plugin",
+ "description": "Semantica plugin for VS Code: knowledge graph skills, decision intelligence, reasoning, extraction, and visualization via MCP server.",
+ "version": "0.1.0",
+ "author": {
+ "name": "Semantica Contributors"
+ },
+ "homepage": "https://github.com/Hawksight-AI/semantica",
+ "repository": "https://github.com/Hawksight-AI/semantica",
+ "license": "MIT",
+ "keywords": [
+ "semantica",
+ "knowledge graph",
+ "vscode",
+ "context graphs",
+ "decision intelligence",
+ "explainability",
+ "causal analysis",
+ "provenance",
+ "ontology",
+ "graph analytics",
+ "semantic extraction",
+ "visualization",
+ "reasoning",
+ "mcp"
+ ],
+ "skills": "../skills",
+ "agents": "../agents",
+ "hooks": "../hooks/hooks.json",
+ "mcp": {
+ "server": "python -m semantica.mcp_server",
+ "transport": "stdio"
+ }
+}
diff --git a/plugins/.windsurf-plugin/README.md b/plugins/.windsurf-plugin/README.md
new file mode 100644
index 00000000..4718e807
--- /dev/null
+++ b/plugins/.windsurf-plugin/README.md
@@ -0,0 +1,29 @@
+# Semantica — Windsurf Plugin
+
+Adds all 17 Semantica skills, 3 agents, and hook configuration to Windsurf.
+
+## MCP Server Setup (recommended)
+
+Add to your Windsurf MCP config (`~/.codeium/windsurf/mcp_config.json`):
+
+```json
+{
+ "mcpServers": {
+ "semantica": {
+ "command": "python",
+ "args": ["-m", "semantica.mcp_server"]
+ }
+ }
+}
+```
+
+Windsurf will then have access to all 12 Semantica tools (extract, record_decision, query_decisions, find_precedents, get_causal_chain, add_entity, add_relationship, run_reasoning, get_graph_analytics, export_graph, and more) directly in the AI panel.
+
+## Skills
+
+All 17 skills under `plugins/skills/` are available as slash commands once the plugin is loaded.
+
+## Requirements
+
+- Python 3.8+
+- `pip install semantica`
diff --git a/plugins/.windsurf-plugin/marketplace.json b/plugins/.windsurf-plugin/marketplace.json
new file mode 100644
index 00000000..e5ea82db
--- /dev/null
+++ b/plugins/.windsurf-plugin/marketplace.json
@@ -0,0 +1,17 @@
+{
+ "name": "semantica-windsurf",
+ "plugins": [
+ {
+ "name": "semantica",
+ "description": "Semantica plugin for Windsurf: knowledge graph skills, reasoning, extraction, and visualization.",
+ "source": "./",
+ "category": "Productivity",
+ "tags": [
+ "knowledge-graph",
+ "reasoning",
+ "semantica",
+ "windsurf"
+ ]
+ }
+ ]
+}
diff --git a/plugins/.windsurf-plugin/plugin.json b/plugins/.windsurf-plugin/plugin.json
new file mode 100644
index 00000000..cbf45713
--- /dev/null
+++ b/plugins/.windsurf-plugin/plugin.json
@@ -0,0 +1,35 @@
+{
+ "name": "semantica-windsurf",
+ "displayName": "Semantica Windsurf Plugin",
+ "description": "Semantica plugin for Windsurf: knowledge graph skills, decision intelligence, reasoning, extraction, and visualization.",
+ "version": "0.1.0",
+ "author": {
+ "name": "Semantica Contributors"
+ },
+ "homepage": "https://github.com/Hawksight-AI/semantica",
+ "repository": "https://github.com/Hawksight-AI/semantica",
+ "license": "MIT",
+ "keywords": [
+ "semantica",
+ "knowledge graph",
+ "windsurf",
+ "context graphs",
+ "decision intelligence",
+ "explainability",
+ "causal analysis",
+ "provenance",
+ "ontology",
+ "graph analytics",
+ "semantic extraction",
+ "visualization",
+ "reasoning",
+ "mcp"
+ ],
+ "skills": "../skills",
+ "agents": "../agents",
+ "hooks": "../hooks/hooks.json",
+ "mcp": {
+ "server": "python -m semantica.mcp_server",
+ "transport": "stdio"
+ }
+}
diff --git a/semantica-explorer/README.md b/semantica-explorer/README.md
deleted file mode 100644
index c3c21da2..00000000
--- a/semantica-explorer/README.md
+++ /dev/null
@@ -1,75 +0,0 @@
-# React + TypeScript + Vite
-
-This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
-
-Currently, two official plugins are available:
-
-- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
-- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
-
-## React Compiler
-
-The React Compiler is enabled on this template. See [this documentation](https://react.dev/learn/react-compiler) for more information.
-
-Note: This will impact Vite dev & build performances.
-
-## Expanding the ESLint configuration
-
-If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
-
-```js
-export default defineConfig([
- globalIgnores(['dist']),
- {
- files: ['**/*.{ts,tsx}'],
- extends: [
- // Other configs...
-
- // Remove tseslint.configs.recommended and replace with this
- tseslint.configs.recommendedTypeChecked,
- // Alternatively, use this for stricter rules
- tseslint.configs.strictTypeChecked,
- // Optionally, add this for stylistic rules
- tseslint.configs.stylisticTypeChecked,
-
- // Other configs...
- ],
- languageOptions: {
- parserOptions: {
- project: ['./tsconfig.node.json', './tsconfig.app.json'],
- tsconfigRootDir: import.meta.dirname,
- },
- // other options...
- },
- },
-])
-```
-
-You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
-
-```js
-// eslint.config.js
-import reactX from 'eslint-plugin-react-x'
-import reactDom from 'eslint-plugin-react-dom'
-
-export default defineConfig([
- globalIgnores(['dist']),
- {
- files: ['**/*.{ts,tsx}'],
- extends: [
- // Other configs...
- // Enable lint rules for React
- reactX.configs['recommended-typescript'],
- // Enable lint rules for React DOM
- reactDom.configs.recommended,
- ],
- languageOptions: {
- parserOptions: {
- project: ['./tsconfig.node.json', './tsconfig.app.json'],
- tsconfigRootDir: import.meta.dirname,
- },
- // other options...
- },
- },
-])
-```
diff --git a/semantica-explorer/src/workspaces/DecisionWorkspace/DecisionWorkspace.tsx b/semantica-explorer/src/workspaces/DecisionWorkspace/DecisionWorkspace.tsx
deleted file mode 100644
index 07b38f82..00000000
--- a/semantica-explorer/src/workspaces/DecisionWorkspace/DecisionWorkspace.tsx
+++ /dev/null
@@ -1,115 +0,0 @@
-/**
- * src/workspaces/DecisionWorkspace/DecisionWorkspace.tsx
- */
-import { useState, useEffect } from "react";
-
-const THEME_CSS = `
- .glass-panel {
- background: linear-gradient(135deg, rgba(13,17,23,0.75), rgba(22,27,34,0.6));
- backdrop-filter: blur(16px) saturate(1.2);
- -webkit-backdrop-filter: blur(16px) saturate(1.2);
- border: 1px solid rgba(88,166,255,0.2);
- box-shadow: 0 8px 32px rgba(0,0,0,0.5), inset 1px 1px 0 rgba(255,255,255,0.05);
- }
-`;
-
-
-
-function CausalChainNode({ hop, title, desc }: { hop: number, title: string, desc: string }) {
- return (
-
- );
-}
-
-export function DecisionWorkspace() {
- const [decisions, setDecisions] = useState([]);
- const [selectedDecision, setSelectedDecision] = useState(null);
- const [chain, setChain] = useState([]);
- const [loading, setLoading] = useState(false);
-
- useEffect(() => {
- fetch("/api/decisions")
- .then(res => res.json())
- .then(data => {
- setDecisions(data);
- if (data.length > 0) handleSelectDecision(data[0]);
- })
- .catch(console.error);
- }, []);
-
- const handleSelectDecision = async (d: any) => {
- setSelectedDecision(d);
- setLoading(true);
- try {
- const res = await fetch(`/api/decisions/${d.decision_id}/chain`);
- const data = await res.json();
- setChain(data.chain || []);
- } catch (e) {
- console.error(e);
- } finally {
- setLoading(false);
- }
- };
-
- return (
-
-
-
- {/* Left Column: Decisions List */}
-
-
- Decision Tree
-
-
- {decisions.map(d => (
-
handleSelectDecision(d)}
- style={{
- textAlign: "left", padding: "12px 16px", borderRadius: 8, cursor: "pointer",
- background: selectedDecision?.decision_id === d.decision_id ? "rgba(88,166,255,0.15)" : "transparent",
- border: `1px solid ${selectedDecision?.decision_id === d.decision_id ? "#58a6ff" : "rgba(255,255,255,0.1)"}`,
- color: selectedDecision?.decision_id === d.decision_id ? "#ffffff" : "#c9d1d9",
- transition: "all 0.2s"
- }}
- >
- {d.decision_id}
- {d.category || 'Uncategorized'}
-
- ))}
-
-
-
- {/* Right Column: Causal Chains */}
-
-
-
- {selectedDecision ? (
- <>
-
{selectedDecision.decision_id}
-
Outcome: {selectedDecision.outcome}
-
-
-
Causal Chain
- {loading ? (
-
Loading chain...
- ) : chain.length > 0 ? (
- chain.map((c, i) => (
-
- ))
- ) : (
-
No causal chain found.
- )}
-
-
- ) : (
-
Select a decision to view details
- )}
-
-
