@ltm-blueverse/alpha-semantic-hub 0.7.0

package/plugins/.claude-plugin/README.md

@@ -0,0 +1,262 @@
+# Alpha Semantic Hub Plugins (Community Guide)
+
+> **v0.4.0** — 17 domain skills · 3 agents · 9 platform plugins · Knowledge Explorer UI
+
+Alpha Semantic Hub ships a shared plugin bundle under `plugins/` that works across every major AI coding assistant. Connect any supported platform to Alpha Semantic Hub's knowledge graph engine for semantic extraction, decision intelligence, reasoning, provenance, ontology, and export workflows.
+
+---
+
+## Platform Plugins
+
+Alpha Semantic Hub provides a dedicated plugin for each platform. Every plugin shares the same `skills/`, `agents/`, and `hooks/` bundle — only the manifest format differs. Exception: the pi plugin (`.pi-plugin/`) loads only the `skills/` bundle via the root `package.json` manifest; pi discovers skills natively and reaches agents/hooks workflows through them.
+
+| # | Platform | Plugin Folder | Setup |
+|---|----------|--------------|-------|
+| 1 | **Claude Code** | `.claude-plugin/` | `claude --plugin-dir ./plugins` |
+| 2 | **Cursor** | `.cursor-plugin/` | Cursor Marketplace → refresh |
+| 3 | **Codex** | `.codex-plugin/` | Marketplace UI → install |
+| 4 | **Cline** | `.cline-plugin/` | Cline MCP settings |
+| 5 | **Windsurf** | `.windsurf-plugin/` | `mcp_config.json` |
+| 6 | **Continue** | `.continue-plugin/` | `~/.continue/config.json` |
+| 7 | **OpenClaw** | `.openclaw-plugin/` | `mcporter.json` |
+| 8 | **VS Code** | `.vscode-plugin/` | `settings.json` MCP entry |
+| 9 | **pi** | `.pi-plugin/` | `pi install git:github.com/DeejayAI/alpha-semantic-hub` (skills bundle) |
+
+---
+
+## What's Included
+
+```
+plugins/
+├── skills/              # 17 domain skills (slash commands)
+├── agents/              # 3 specialized agents
+├── hooks/               # hooks.json
+├── .claude-plugin/      # Claude Code manifest + marketplace
+├── .cursor-plugin/      # Cursor manifest + marketplace
+├── .codex-plugin/       # Codex manifest + marketplace
+├── .cline-plugin/       # Cline manifest + marketplace
+├── .windsurf-plugin/    # Windsurf manifest + marketplace
+├── .continue-plugin/    # Continue manifest + marketplace
+├── .openclaw-plugin/    # OpenClaw manifest + marketplace
+├── .vscode-plugin/      # VS Code manifest + marketplace
+└── .pi-plugin/          # pi package (skills bundle) + guide
+```
+
+### Skills (17)
+
+`extract` · `ingest` · `query` · `ontology` · `validate` · `deduplicate` · `embed` · `reason` · `decision` · `causal` · `temporal` · `provenance` · `policy` · `explain` · `export` · `change` · `visualize`
+
+### Agents (3)
+
+`decision-advisor` · `explainability` · `kg-assistant`
+
+---
+
+## Prerequisites
+
+```bash
+git clone https://github.com/DeejayAI/alpha-semantic-hub.git
+cd alphasemantichub
+pip install alphasemantichub        # Python 3.10+
+```
+
+---
+
+## Knowledge Explorer (v0.4.0)
+
+Launch the interactive graph dashboard:
+
+```bash
+alphasemantichub-explorer --graph my_graph.json --port 8000
+```
+
+Open **http://localhost:5174** to explore:
+
+- **Graph** — interactive canvas with ForceAtlas2 layout, path highlight, community coloring
+- **Decisions** — causal chains and outcome analysis
+- **Reasoning** — run deductive / abductive rules
+- **SPARQL** — Monaco editor for graph queries
+- **Vocabulary** — ontology concept tree
+- **Lineage** — provenance lineage diagram
+- **Import / Export** — JSON, RDF, Parquet, GraphML
+
+---
+
+## Installation by Platform
+
+### Claude Code
+
+```bash
+claude --plugin-dir ./plugins
+```
+
+Or inside a session:
+
+```bash
+/plugin marketplace add ./plugins
+/plugin install alphasemantichub@alphasemantichub-local
+```
+
+Verify:
+
+```
+/alphasemantichub:decision list
+/alphasemantichub:explain decision <decision_id>
+```
+
+---
+
+### Cursor
+
+Cursor reads `.cursor-plugin/plugin.json` and `.cursor-plugin/marketplace.json` automatically. Publish the `plugins/` directory and refresh in Cursor Marketplace to pick up updates.
+
+Verify:
+
+```
+/alphasemantichub:visualize topology
+/alphasemantichub:reason deductive "IF Person(x) THEN Mortal(x)"
+```
+
+---
+
+### Codex
+
+1. Ensure your repo marketplace exists at `.agents/plugins/marketplace.json`.
+2. Set `source.path` to `./plugins` in the plugin entry.
+3. Restart Codex and install from the marketplace UI.
+
+Verify:
+
+```
+/alphasemantichub:causal chain --subject <decision_id> --depth 3
+```
+
+---
+
+### Cline
+
+In Cline MCP settings, add:
+
+```json
+{
+  "alphasemantichub": {
+    "command": "python",
+    "args": ["-m", "alphasemantichub.mcp_server"],
+    "env": {}
+  }
+}
+```
+
+---
+
+### Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "alphasemantichub": {
+      "command": "python",
+      "args": ["-m", "alphasemantichub.mcp_server"]
+    }
+  }
+}
+```
+
+---
+
+### Continue
+
+Add to `~/.continue/config.json`:
+
+```json
+{
+  "mcpServers": [
+    {
+      "name": "alphasemantichub",
+      "command": "python",
+      "args": ["-m", "alphasemantichub.mcp_server"]
+    }
+  ]
+}
+```
+
+All 17 Alpha Semantic Hub skills appear in the `@alphasemantichub` context provider dropdown.
+
+---
+
+### OpenClaw
+
+Add to `~/.openclaw/mcporter.json`:
+
+```json
+{
+  "mcpServers": {
+    "alphasemantichub": {
+      "command": "python",
+      "args": ["-m", "alphasemantichub.mcp_server"],
+      "transport": "stdio"
+    }
+  }
+}
+```
+
+Then restart the gateway:
+
+```bash
+openclaw gateway restart
+```
+
+---
+
+### VS Code
+
+Add to `settings.json` (GitHub Copilot Chat):
+
+```json
+{
+  "github.copilot.chat.mcp.servers": {
+    "alphasemantichub": {
+      "command": "python",
+      "args": ["-m", "alphasemantichub.mcp_server"]
+    }
+  }
+}
+```
+
+Or for the VS Code MCP extension:
+
+```json
+{
+  "mcp.servers": {
+    "alphasemantichub": {
+      "command": "python",
+      "args": ["-m", "alphasemantichub.mcp_server"]
+    }
+  }
+}
+```
+
+---
+
+## First Commands to Try
+
+After installing on any platform:
+
+```
+/alphasemantichub:decision record <category> "<scenario>" "<reasoning>" <outcome> <confidence>
+/alphasemantichub:decision list
+/alphasemantichub:causal chain --subject <decision_id> --depth 3
+/alphasemantichub:explain decision <decision_id>
+/alphasemantichub:validate graph
+/alphasemantichub:visualize topology
+```
+
+---
+
+## Community Notes
+
+- Keep `name` / `version` / `keywords` updated in each manifest before publishing.
+- Keep skill frontmatter (`name` + `description`) consistent for reliable discovery.
+- Include `plugins/` as-is when sharing — skills, agents, and hooks must stay bundled.

package/plugins/.claude-plugin/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "alphasemantichub-local",
+  "owner": {
+    "name": "AlphaSemanticHub",
+    "url": "https://github.com/DeejayAI/alpha-semantic-hub"
+  },
+  "plugins": [
+    {
+      "name": "alphasemantichub",
+      "description": "AlphaSemanticHub plugin for Claude: knowledge graph skills, reasoning, extraction, and visualization.",
+      "source": "./",
+      "category": "Productivity",
+      "tags": [
+        "knowledge-graph",
+        "reasoning",
+        "alphasemantichub"
+      ]
+    }
+  ]
+}

package/plugins/.claude-plugin/plugin.json

@@ -0,0 +1,33 @@
+{
+  "name": "alphasemantichub",
+  "description": "Full-stack knowledge graph skills: semantic extraction, decision intelligence, context graphs, reasoning, explainability, ontology, provenance, deduplication, visualization, and multi-format export.",
+  "version": "0.1.0",
+  "author": {
+    "name": "LTM Blueverse"
+  },
+  "homepage": "https://github.com/DeejayAI/alpha-semantic-hub",
+  "repository": "https://github.com/DeejayAI/alpha-semantic-hub",
+  "license": "MIT",
+  "keywords": [
+    "alphasemantichub",
+    "knowledge graph",
+    "context graphs",
+    "decision intelligence",
+    "explainability",
+    "causal analysis",
+    "provenance",
+    "ontology",
+    "graph analytics",
+    "semantic extraction",
+    "visualization",
+    "reasoning",
+    "extraction",
+    "mcp"
+  ],
+  "skills": "./skills",
+  "agents": [
+    "./agents/decision-advisor.md",
+    "./agents/explainability.md",
+    "./agents/kg-assistant.md"
+  ]
+}

package/plugins/.cline-plugin/README.md

@@ -0,0 +1,32 @@
+# Alpha Semantic Hub — Cline Plugin
+
+> **v0.4.0** — Adds all 17 Alpha Semantic Hub skills, 3 agents, and hook configuration to Cline (VS Code extension).
+
+## MCP Server Setup (recommended)
+
+In Cline settings, add a new MCP server:
+
+```json
+{
+  "alphasemantichub": {
+    "command": "python",
+    "args": ["-m", "alphasemantichub.mcp_server"],
+    "env": {}
+  }
+}
+```
+
+Cline will discover all 17 Alpha Semantic Hub skills and 3 agents automatically on connection.
+
+## Knowledge Explorer
+
+```bash
+alphasemantichub-explorer --graph my_graph.json --port 8000
+```
+
+Open `http://localhost:5174` for the interactive dashboard.
+
+## Requirements
+
+- Python 3.10+
+- `pip install alphasemantichub`

package/plugins/.cline-plugin/marketplace.json

@@ -0,0 +1,17 @@
+{
+  "name": "alphasemantichub-cline",
+  "plugins": [
+    {
+      "name": "alphasemantichub",
+      "description": "AlphaSemanticHub plugin for Cline: knowledge graph skills, reasoning, extraction, and visualization.",
+      "source": "./",
+      "category": "Productivity",
+      "tags": [
+        "knowledge-graph",
+        "reasoning",
+        "alphasemantichub",
+        "cline"
+      ]
+    }
+  ]
+}

package/plugins/.cline-plugin/plugin.json

@@ -0,0 +1,35 @@
+{
+  "name": "alphasemantichub-cline",
+  "displayName": "AlphaSemanticHub Cline Plugin",
+  "description": "AlphaSemanticHub plugin for Cline: knowledge graph skills, decision intelligence, reasoning, extraction, and visualization.",
+  "version": "0.1.0",
+  "author": {
+    "name": "LTM Blueverse"
+  },
+  "homepage": "https://github.com/DeejayAI/alpha-semantic-hub",
+  "repository": "https://github.com/DeejayAI/alpha-semantic-hub",
+  "license": "MIT",
+  "keywords": [
+    "alphasemantichub",
+    "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 alphasemantichub.mcp_server",
+    "transport": "stdio"
+  }
+}

package/plugins/.codex-plugin/marketplace.json

@@ -0,0 +1,21 @@
+{
+  "name": "alphasemantichub-local",
+  "interface": {
+    "displayName": "AlphaSemanticHub Local Plugins"
+  },
+  "plugins": [
+    {
+      "name": "alphasemantichub-codex",
+      "description": "AlphaSemanticHub plugin for Codex: knowledge graph commands and analytics.",
+      "source": {
+        "source": "local",
+        "path": "./"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

package/plugins/.codex-plugin/plugin.json

@@ -0,0 +1,35 @@
+{
+  "name": "alphasemantichub-codex",
+  "description": "AlphaSemanticHub plugin for Codex: knowledge graph commands, export capabilities, and reasoning workflows.",
+  "version": "0.1.0",
+  "author": {
+    "name": "LTM Blueverse"
+  },
+  "homepage": "https://github.com/DeejayAI/alpha-semantic-hub",
+  "repository": "https://github.com/DeejayAI/alpha-semantic-hub",
+  "license": "MIT",
+  "keywords": [
+    "alphasemantichub",
+    "knowledge graph",
+    "codex",
+    "context graphs",
+    "decision intelligence",
+    "explainability",
+    "causal analysis",
+    "provenance",
+    "ontology",
+    "graph analytics",
+    "semantic extraction",
+    "visualization",
+    "reasoning",
+    "extraction",
+    "mcp"
+  ],
+  "skills": "./skills",
+  "interface": {
+    "displayName": "AlphaSemanticHub Codex Plugin",
+    "shortDescription": "Knowledge graph skills for AlphaSemanticHub workflows",
+    "category": "Productivity",
+    "developerName": "LTM Blueverse"
+  }
+}

package/plugins/.continue-plugin/README.md

@@ -0,0 +1,34 @@
+# Alpha Semantic Hub — Continue Plugin
+
+> **v0.4.0** — Adds Alpha Semantic Hub as an MCP server and context provider to [Continue.dev](https://continue.dev).
+
+## MCP Server Setup
+
+Add to `~/.continue/config.json`:
+
+```json
+{
+  "mcpServers": [
+    {
+      "name": "alphasemantichub",
+      "command": "python",
+      "args": ["-m", "alphasemantichub.mcp_server"]
+    }
+  ]
+}
+```
+
+Continue will show all 17 Alpha Semantic Hub skills in the `@alphasemantichub` context provider dropdown.
+
+## Knowledge Explorer
+
+```bash
+alphasemantichub-explorer --graph my_graph.json --port 8000
+```
+
+Open `http://localhost:5174` for the interactive graph dashboard.
+
+## Requirements
+
+- Python 3.10+
+- `pip install alphasemantichub`

package/plugins/.continue-plugin/marketplace.json

@@ -0,0 +1,17 @@
+{
+  "name": "alphasemantichub-continue",
+  "plugins": [
+    {
+      "name": "alphasemantichub",
+      "description": "AlphaSemanticHub plugin for Continue.dev: knowledge graph context provider, reasoning, and extraction.",
+      "source": "./",
+      "category": "Productivity",
+      "tags": [
+        "knowledge-graph",
+        "reasoning",
+        "alphasemantichub",
+        "continue"
+      ]
+    }
+  ]
+}

package/plugins/.continue-plugin/plugin.json

@@ -0,0 +1,33 @@
+{
+  "name": "alphasemantichub-continue",
+  "displayName": "AlphaSemanticHub Continue Plugin",
+  "description": "AlphaSemanticHub plugin for Continue.dev: knowledge graph context provider, decision intelligence, reasoning, and semantic extraction.",
+  "version": "0.1.0",
+  "author": {
+    "name": "LTM Blueverse"
+  },
+  "homepage": "https://github.com/DeejayAI/alpha-semantic-hub",
+  "repository": "https://github.com/DeejayAI/alpha-semantic-hub",
+  "license": "MIT",
+  "keywords": [
+    "alphasemantichub",
+    "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 alphasemantichub.mcp_server",
+    "transport": "stdio"
+  }
+}

package/plugins/.cursor-plugin/marketplace.json

@@ -0,0 +1,18 @@
+{
+  "name": "alphasemantichub-local",
+  "owner": {
+    "name": "LTM Blueverse"
+  },
+  "metadata": {
+    "description": "AlphaSemanticHub plugin marketplace for Cursor.",
+    "version": "0.1.0",
+    "pluginRoot": "."
+  },
+  "plugins": [
+    {
+      "name": "alphasemantichub-cursor",
+      "description": "AlphaSemanticHub plugin for Cursor: knowledge graph skills and analytics.",
+      "source": "."
+    }
+  ]
+}

package/plugins/.cursor-plugin/plugin.json

@@ -0,0 +1,32 @@
+{
+  "name": "alphasemantichub-cursor",
+  "displayName": "AlphaSemanticHub Cursor Plugin",
+  "description": "AlphaSemanticHub plugin for Cursor: knowledge graph skills, reasoning, extraction, and visualization.",
+  "version": "0.1.0",
+  "author": {
+    "name": "LTM Blueverse"
+  },
+  "homepage": "https://github.com/DeejayAI/alpha-semantic-hub",
+  "repository": "https://github.com/DeejayAI/alpha-semantic-hub",
+  "license": "MIT",
+  "keywords": [
+    "alphasemantichub",
+    "knowledge graph",
+    "cursor",
+    "context graphs",
+    "decision intelligence",
+    "explainability",
+    "causal analysis",
+    "provenance",
+    "ontology",
+    "graph analytics",
+    "semantic extraction",
+    "visualization",
+    "reasoning",
+    "extraction",
+    "mcp"
+  ],
+  "skills": "./skills",
+  "agents": "./agents",
+  "hooks": "./hooks/hooks.json"
+}

package/plugins/.openclaw-plugin/README.md

@@ -0,0 +1,62 @@
+# Alpha Semantic Hub — OpenClaw Plugin
+
+> **v0.4.0** — Adds all 17 Alpha Semantic Hub skills, 3 agents, and the full MCP integration to [OpenClaw](https://openclaw.ai) — the open-source personal AI agent platform.
+
+## MCP Server Setup (recommended)
+
+### 1. Start the Alpha Semantic Hub MCP server
+
+```bash
+python -m alphasemantichub.mcp_server
+```
+
+### 2. Add to `mcporter.json`
+
+Paste the following into your OpenClaw `mcporter.json` (usually `~/.openclaw/mcporter.json`):
+
+```json
+{
+  "mcpServers": {
+    "alphasemantichub": {
+      "command": "python",
+      "args": ["-m", "alphasemantichub.mcp_server"],
+      "transport": "stdio"
+    }
+  }
+}
+```
+
+### 3. Restart the OpenClaw Gateway
+
+```bash
+openclaw gateway restart
+```
+
+OpenClaw will automatically discover all 17 Alpha Semantic Hub tools and 3 agents.
+
+## Skills
+
+All 17 skills under [`plugins/skills/`](../skills/) are available once the plugin is loaded:
+
+`extract` · `ingest` · `query` · `ontology` · `validate` · `deduplicate` · `embed` · `reason` · `decision` · `causal` · `temporal` · `provenance` · `policy` · `explain` · `export` · `change` · `visualize`
+
+## Native Tool (REST, no MCP gateway)
+
+For agents that cannot use the MCP gateway, use the `OpenClawKGTool` REST wrapper:
+
+```python
+from integrations.openclaw import OpenClawKGTool
+
+tool = OpenClawKGTool(base_url="http://localhost:8000")
+entities = tool.extract_entities("Alice manages the project.")
+tool.record_decision("Deploy model v2 to production")
+summary = tool.get_graph_summary()
+```
+
+See [`integrations/openclaw/README.md`](../../integrations/openclaw/README.md) for the full guide, including SOUL.md agent snippets.
+
+## Requirements
+
+- Python 3.10+
+- `pip install alphasemantichub`
+- OpenClaw — [openclaw.ai](https://openclaw.ai)

package/plugins/.openclaw-plugin/marketplace.json

@@ -0,0 +1,18 @@
+{
+  "name": "alphasemantichub-openclaw",
+  "plugins": [
+    {
+      "name": "alphasemantichub",
+      "description": "AlphaSemanticHub plugin for OpenClaw: knowledge graph skills, decision intelligence, reasoning, extraction, and visualization.",
+      "source": "./",
+      "category": "Productivity",
+      "tags": [
+        "knowledge-graph",
+        "reasoning",
+        "alphasemantichub",
+        "openclaw",
+        "mcp"
+      ]
+    }
+  ]
+}