cognitive-kit 1.0.0-alpha.2 → 1.0.0-alpha.3

package/docs/guides/cursor-integration.md

@@ -0,0 +1,64 @@
+# Cursor Integration Guide
+
+Connect Cognitive Kit to Cursor AI editor via MCP.
+
+## Setup
+
+### 1. Configure MCP in Cursor
+
+1. Open Cursor Settings
+2. Navigate to **Features → MCP**
+3. Click **+ Add New MCP Server**
+
+```
+Name: cognitive-kit
+Type: command
+Command: npx cognitive-kit
+```
+
+4. Add environment variables (optional):
+
+| Variable | Value |
+|----------|-------|
+| `KIT_HOST_ID` | `cursor-my-project` |
+| `KIT_HOST_NAME` | `My Project` |
+| `KIT_SOVEREIGN_KEY` | *(optional)* |
+
+### 2. Verify
+
+Run any tool from Cursor's MCP panel:
+
+```
+cognitive_reason({ problem: "Why is this function failing?" })
+```
+
+## Available Commands
+
+Via Cursor's AI chat:
+
+```
+Analyze this code using cognitive_reason:
+[code block]
+```
+
+```
+Plan the implementation using cognitive_plan:
+[requirements]
+```
+
+```
+Check for security issues using security_gate:
+[code/config]
+```
+
+```
+Research this topic using cognitive_research:
+[topic]
+```
+
+## Tips
+
+- Use `agency_execute` for complex multi-step tasks
+- Use `guardian_status` to monitor system health
+- Use `code_archaeologist` for codebase analysis
+- Use `consensus_engine` for architectural decisions

package/docs/guides/vscode-integration.md

@@ -0,0 +1,80 @@
+# VS Code Integration Guide
+
+Connect Cognitive Kit to VS Code via MCP for inline reasoning, code analysis, planning, and security auditing.
+
+## Setup
+
+### 1. Install the Kit
+
+```bash
+npm install -g cognitive-kit
+```
+
+### 2. Configure MCP
+
+Create or edit `.vscode/mcp.json` in your project:
+
+```json
+{
+  "servers": {
+    "cognitive-kit": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["cognitive-kit"],
+      "env": {
+        "KIT_HOST_ID": "vscode-${workspaceFolderBasename}",
+        "KIT_HOST_NAME": "${workspaceFolderBasename}"
+      }
+    }
+  }
+}
+```
+
+### 3. Restart VS Code
+
+The kit starts automatically. You can now use all 31 tools from the VS Code MCP interface.
+
+## VS Code Extension
+
+Alternatively, install the VS Code extension (if published):
+
+```bash
+code --install-extension cognitive-kit-vscode
+```
+
+The extension provides:
+
+- **`Cognitive Kit: Analyze Selection`** — Runs reasoning on selected code/text
+- **`Cognitive Kit: Reflect on Workspace`** — Meta-reflection on project state
+- **`Cognitive Kit: Show Status`** — Guardian metrics and tool counts
+
+## Example Workflows
+
+### Code Review
+
+1. Select a block of code
+2. Run `Cognitive Kit: Analyze Selection`
+3. The kit applies `cognitive_reason` for logical analysis
+4. Results appear in a new editor panel
+
+### Security Audit
+
+Via MCP, call:
+
+```
+security_gate(payload: "the code to inspect")
+ethics_audit(subject: "implementation decision")
+threat_mapper(systemDescription: "architecture overview")
+```
+
+### Project Planning
+
+```
+agency_execute(objective: "Design authentication module", mode: "adaptive")
+```
+
+## Requirements
+
+- VS Code ≥ 1.96
+- Node.js ≥ 20
+- Internet for first `npx` run

package/mcp.json

@@ -0,0 +1,50 @@
+{
+  "servers": {
+    "cognitive-kit": {
+      "name": "Cognitive Kit",
+      "description": "Pluggable cognitive layer — 31+ MCP tools for reasoning, research, planning, creativity, security, knowledge, analysis, agency orchestration, and adaptive pipelines",
+      "type": "stdio",
+      "command": "npx",
+      "args": ["cognitive-kit"],
+      "env": {
+        "KIT_HOST_ID": "${workspaceFolderBasename}",
+        "KIT_HOST_NAME": "${workspaceFolderBasename}",
+        "KIT_SOVEREIGN_KEY": ""
+      },
+      "icon": "🧠",
+      "tools": [
+        "cognitive_reason",
+        "cognitive_research",
+        "cognitive_plan",
+        "cognitive_create",
+        "cognitive_reflect",
+        "security_gate",
+        "ethics_audit",
+        "integrity_ledger",
+        "threat_mapper",
+        "red_team",
+        "blast_radius",
+        "guardian_status",
+        "guardian_freeze",
+        "guardian_unfreeze",
+        "memory_vam",
+        "knowledge_evolve",
+        "context_synth",
+        "code_archaeologist",
+        "sentiment_adapter",
+        "consensus_engine",
+        "execution_flow",
+        "swarm_orchestrator",
+        "meta_orchestrator",
+        "subagent_protocol",
+        "agency_execute",
+        "skill_forge",
+        "skill_list_forged",
+        "federation_status",
+        "federation_connect",
+        "federation_execute",
+        "federation_disconnect"
+      ]
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cognitive-kit",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0-alpha.3",
   "description": "Pluggable cognitive layer — port of GCS v15.3 as an embeddable MCP cognitive kit. Provides reasoning, research, planning, creativity, reflection, security, knowledge, analysis, agency orchestration, and adaptive pipelines via MCP protocol.",
   "type": "module",
   "main": "./dist/index.js",
@@ -24,6 +24,8 @@
   "files": [
     "dist",
     "types",
+    "docs",
+    "mcp.json",
     "README.md",
     "LICENSE"
   ],
@@ -33,7 +35,7 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "dev": "tsc --watch -p tsconfig.json",
-    "test": "node --experimental-vm-modules --test dist/tests/",
+    "test": "node tests/mcp-test-all.mjs && node tests/guardian-test.mjs && node tests/forge-test.mjs && node tests/federation-test.mjs",
     "start": "node dist/cli.js",
     "prepublishOnly": "npm run build"
   },