squish-memory 0.9.2 → 1.0.0

package/{.env.mcp → .env.mcp.example}

@@ -14,6 +14,24 @@ GOOGLE_CLOUD_LOCATION=us-central1
 # Or use service account:
 # GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
 
+# OpenAI Embeddings (optional, 1536-dim)
+# SQUISH_OPENAI_API_KEY=sk-...
+# SQUISH_OPENAI_API_URL=https://api.openai.com/v1/embeddings
+# SQUISH_OPENAI_EMBEDDING_MODEL=text-embedding-3-small
+
+# Ollama Embeddings (optional, model-dependent dims)
+# SQUISH_OLLAMA_URL=http://localhost:11434
+# SQUISH_OLLAMA_EMBEDDING_MODEL=nomic-embed-text:v1.5
+
+# Embedding performance & reliability
+SQUISH_EMBEDDINGS_TIMEOUT_MS=30000
+SQUISH_EMBEDDINGS_MAX_RETRIES=3
+SQUISH_EMBEDDINGS_RETRY_DELAY_MS=1000
+# Per-provider overrides (optional)
+# SQUISH_OPENAI_TIMEOUT_MS=30000
+# SQUISH_OLLAMA_TIMEOUT_MS=30000
+# SQUISH_GOOGLE_MULTIMODAL_TIMEOUT_MS=30000
+
 # QMD for local markdown search
 SQUISH_QMD_ENABLED=true
 SQUISH_QMD_COLLECTIONS=./qmd-collections
@@ -28,3 +46,8 @@ SQUISH_QMD_FALLBACK=hybrid
 SQUISH_LIFECYCLE_ENABLED=true
 SQUISH_SUMMARIZATION_ENABLED=true
 SQUISH_GOVERNANCE_ENABLED=true
+
+# Core Memory Configuration (v0.9.2+)
+# Increase limits for daily agent usage (default: 16KB total, 4KB per section)
+# SQUISH_CORE_MEMORY_TOTAL_BYTES=16384
+# SQUISH_CORE_MEMORY_SECTION_BYTES=4096

package/CHANGELOG.md

@@ -2,6 +2,108 @@
 
 All notable changes to Squish will be documented in this file.
 
+## [1.0.0] - 2026-03-17
+
+### 🚀 Major Release - Universal Plugin Architecture
+
+#### Added - Interactive Multi-Step Wizard Installer
+- **Beautiful CLI Wizard** with 5-step installation flow using `@clack/prompts`
+- Step 1: Component Selection (CLI, MCP Server, AI Agent Plugins)
+- Step 2: Plugin Selection (Claude Code, OpenClaw, Cursor, etc.)
+- Step 3: Configuration (Local/Remote mode, Embeddings provider)
+- Step 4: Review Summary with visual confirmation
+- Step 5: Automated installation with progress spinners
+- **Quick Install Mode**: `bun run install:interactive --quick` for CLI + all plugins
+- **Dry-run support**: Preview installations without making changes
+- **Configuration persistence**: Saves settings to `~/.squish/config.json`
+
+#### Added - Universal Plugin Architecture
+- **Multi-client support**: Works with Claude Code, OpenClaw, OpenCode, Codex, Cursor, VS Code, Windsurf
+- **Plugin types**: Hooks (Claude Code), Plugin-slot (OpenClaw), MCP (all others)
+- **Auto-detection**: Detects which AI agents are already installed
+- **Source indicators**: Shows which plugins have source code available (📦)
+
+#### Added - Core Infrastructure
+- **Search Tracing System**: Debug and performance analysis for searches
+  - `core/tracing/collector.ts` - Collects search traces
+  - `core/tracing/visualizer.ts` - Visualizes trace data
+  - New MCP tools: `squish_get_search_traces`, `squish_get_trace_by_id`
+- **Namespace Support**: Hierarchical memory organization
+  - `core/namespaces/index.ts` - Namespace management
+  - `core/namespaces/uri-parser.ts` - URI parsing for namespaces
+- **Memory Layers (L0/L1/L2)**: Token-efficient retrieval
+  - `core/layers/generator.ts` - Generates memory layers
+- **Self-Iteration Job**: Conversation memory extraction
+  - `core/session-hooks/self-iteration-job.ts` - Extracts memories from conversations
+  - `core/session-hooks/session-hooks.ts` - Session lifecycle hooks
+- **Database Schema Updates**:
+  - Added `namespaces` table
+  - Added `memory_layers` table
+  - Added `search_traces` table
+
+#### Fixed - Dependencies
+- **qmd package**: Fixed from non-existent `qmd@0.15.1` to `@tobilu/qmd@2.0.1`
+- **mcporter version**: Updated from `1.2.0` to `0.7.3` (matches installed version)
+- **Scoped package support**: Dependency manager now handles `@scope/package` names
+- **Binary detection**: Properly maps scoped packages to their binary names
+
+#### Changed - Code Organization
+- **Refactored CLI**: Improved imports and removed duplicates in `index.ts`
+- **Safety Checks**: Better helper functions for algorithm validation
+- **Response Builder**: Unified response builder for algorithm handlers
+- **Config Validation**: Fixed provider validation logic
+- **Association SQL**: Fixed placeholder issues in SQL queries
+- **Directory Reorganization**: Renamed `core/sessions/` to `core/session-hooks/` for clarity
+  - Session lifecycle hooks now in dedicated directory
+  - Separates session auto-load (`core/session/`) from hooks/jobs (`core/session-hooks/`)
+
+#### Documentation
+- **Interactive Installer Guide**: Complete docs for wizard usage
+- **Plugin Architecture**: Documentation for universal plugin system
+- **Installation Guide**: Quick-start for all supported AI agents
+
+### Breaking Changes
+None - fully backward compatible with 0.9.x
+
+### Migration Notes
+- Run `bun run install:interactive` to use the new wizard
+- Existing installations continue to work without changes
+- Configuration automatically migrated on first run
+
+## [0.9.3] - 2026-03-14
+
+### Added - Core Memory & Embeddings Improvements (v0.9.2+)
+
+#### Expanded Core Memory
+- Increased default core memory limit from 2KB to 16KB total (4KB per section)
+- Configurable limits via `SQUISH_CORE_MEMORY_TOTAL_BYTES` and `SQUISH_CORE_MEMORY_SECTION_BYTES`
+- Added token estimation for better LLM context budgeting
+- Core memory stats now show both byte and token usage
+
+#### Robust Embeddings System
+- Fixed hybrid fallback order: Google Multimodal → OpenAI → Ollama → Local (removed QMD from embedding chain)
+- Added retry logic with exponential backoff (3 retries default)
+- Added configurable timeouts (default 30s) with per-provider overrides
+- New `checkEmbeddingProviderHealth()` function for monitoring
+- Improved error handling and graceful degradation
+
+#### Enhanced Configuration
+- New environment variables for fine-tuning:
+  - `SQUISH_EMBEDDINGS_TIMEOUT_MS`, `SQUISH_EMBEDDINGS_MAX_RETRIES`, `SQUISH_EMBEDDINGS_RETRY_DELAY_MS`
+  - `SQUISH_OPENAI_TIMEOUT_MS`, `SQUISH_OLLAMA_TIMEOUT_MS`, `SQUISH_GOOGLE_MULTIMODAL_TIMEOUT_MS`
+- Better connection handling for all embedding providers
+
+### Changed - Infrastructure
+- Updated CI/CD workflows (`.github/workflows/ci.yml`, `release.yml`)
+- Removed old `mcp-launch-checks.yml` workflow
+- Updated release scripts (auto-detect version, better binary packaging)
+- Database schema: added `tokens_estimate` column to `core_memory` table (auto-migrated)
+
+### Security & developer experience
+- Renamed `.env.mcp` to `.env.mcp.example` (template) - added to `.gitignore`
+- Updated all documentation with new configuration options
+- Improved TypeScript type safety across codebase
+
 ## [0.9.1] - 2026-03-14
 
 ### Fixed - CLI & Database

package/QUICK-START.md

@@ -27,7 +27,7 @@ curl http://localhost:8767/health
 {
   "status": "ok",
   "server": "squish-mcp",
-  "version": "0.9.0",
+   "version": "0.9.2",
   "tools": 6
 }
 ```
@@ -48,17 +48,23 @@ curl -X POST http://localhost:8767/tools/call \
 
 ## Configure
 
-Copy `.env.mcp` to `.env` and customize:
+Copy `.env.mcp.example` to `.env` and customize:
 
 ```bash
-cp .env.mcp .env
+cp .env.mcp.example .env
 ```
 
 Key settings:
 
 - **SQUISH_MCP_PORT**: Server port (default: 8767)
-- **SQUISH_EMBEDDINGS_PROVIDER**: local|google-multimodal|hybrid
+- **SQUISH_MCP_SERVER_ENABLED**: Enable/disable MCP server (default: true)
+- **SQUISH_EMBEDDINGS_PROVIDER**: local|openai|ollama|google-multimodal|hybrid (default: local)
+- **SQUISH_MULTIMODAL_EMBEDDINGS_ENABLED**: Enable Google multimodal (default: false)
 - **SQUISH_QMD_ENABLED**: Enable markdown search (true/false)
+- **SQUISH_CORE_MEMORY_TOTAL_BYTES**: Total core memory limit in bytes (default: 16384)
+- **SQUISH_CORE_MEMORY_SECTION_BYTES**: Per-section limit in bytes (default: 4096)
+- **SQUISH_EMBEDDINGS_TIMEOUT_MS**: Timeout for embedding API calls (default: 30000)
+- **SQUISH_EMBEDDINGS_MAX_RETRIES**: Max retries for failed embedding calls (default: 3)
 
 ## Full Docs
 

package/README.md

@@ -73,14 +73,26 @@ Agent Action -----> [Squish Memory Layer]
 
 ## Quick Start
 
-### For Claude Code (Plugin)
+### Universal Plugin Installer (Recommended)
+```bash
+# Install for your AI assistant(s)
+npx squish-memory install-plugin --client=claude-code  # Claude Code
+npx squish-memory install-plugin --client=openclaw    # OpenClaw
+npx squish-memory install-plugin --client=opencode    # OpenCode
+npx squish-memory install-plugin --client=all         # All supported clients
+
+# Verify installation
+npx squish-memory install-plugin --client=claude-code --verify
+```
+
+### For Claude Code (Plugin) - Legacy Method
 ```bash
 # Install from marketplace
 /plugin marketplace add https://github.com/michielhdoteth/squish.git
 /plugin install squish@michielhdoteth-squish
 ```
 
-### For OpenClaw (npm)
+### For OpenClaw (npm) - Legacy Method
 ```bash
 npm install -g squish-memory
 ```
@@ -128,6 +140,50 @@ curl "http://localhost:3000/api/memories/search?q=TypeScript"
 - **Transport Agnostic**: MCP (stdio/SSE), CLI, or HTTP/WebSocket - choose your preference
 - **Storage Flexible**: SQLite for local, PostgreSQL for team deployments
 
+## Universal Plugin Architecture
+
+Squish now provides a **universal plugin system** that works as a plugin across all major AI assistant frameworks through a single manifest-driven installer.
+
+### How It Works
+1. Single `plugin-manifest.json` defines the plugin for all clients
+2. `npx squish-memory install-plugin --client=<target>` handles installation
+3. Auto-installs dependencies (mcporter, qmd) with pinned versions
+4. Generates client-specific configurations automatically
+5. Provides unified verification and troubleshooting
+
+### Supported Clients
+| Client | Installation Method | Status |
+|--------|-------------------|---------|
+| Claude Code | Plugin hooks (.claude-plugin/) | ✅ Stable |
+| OpenClaw | Memory slot via MCP bridge | ✅ Stable |
+| OpenCode | MCP server config | ✅ Stable |
+| Codex | MCP server config | ✅ Stable |
+| Cursor | MCP server config | ✅ Beta |
+| VS Code | MCP server config | ✅ Beta |
+| Windsurf | MCP server config | ✅ Beta |
+
+### Quick Installation Examples
+```bash
+# Install for Claude Code (recommended for Claude users)
+npx squish-memory install-plugin --client=claude-code --verify
+
+# Install for OpenClaw (recommended for OpenClaw users)  
+npx squish-memory install-plugin --client=openclaw --verify
+
+# Install for all supported clients
+npx squish-memory install-plugin --client=all --verify
+
+# Install for multiple specific clients
+npx squish-memory install-plugin --client=claude-code,openclaw,opencode --verify
+```
+
+### Benefits
+- **One manifest to rule them all**: Single source of truth
+- **Zero manual configuration**: Automatic dependency installation
+- **Version pinned dependencies**: Stable, reproducible builds
+- **Unified verification**: One command to check all clients
+- **Backward compatible**: Existing integrations still work
+
 ## Universal API
 
 Squish now provides a universal HTTP API that works with any AI agent:
@@ -188,11 +244,24 @@ PORT=3000                                   # API server port
 **Optional:**
 ```bash
 SQUISH_DATA_DIR=./.squish          # Custom data directory
-SQUISH_EMBEDDINGS_PROVIDER=local   # local, openai, or ollama
+SQUISH_EMBEDDINGS_PROVIDER=local   # local, openai, ollama, google-multimodal, hybrid
 
 # For better embeddings (optional)
 SQUISH_OPENAI_API_KEY=sk-...
+SQUISH_OPENAI_EMBEDDING_MODEL=text-embedding-3-small
 SQUISH_OLLAMA_URL=http://localhost:11434
+SQUISH_OLLAMA_EMBEDDING_MODEL=nomic-embed-text:v1.5
+SQUISH_GOOGLE_CLOUD_PROJECT=your-project
+SQUISH_GOOGLE_CLOUD_API_KEY=your-key
+
+# Embedding performance & reliability
+SQUISH_EMBEDDINGS_TIMEOUT_MS=30000
+SQUISH_EMBEDDINGS_MAX_RETRIES=3
+SQUISH_EMBEDDINGS_RETRY_DELAY_MS=1000
+
+# Core memory size (default: 16KB total, 4KB per section)
+SQUISH_CORE_MEMORY_TOTAL_BYTES=16384
+SQUISH_CORE_MEMORY_SECTION_BYTES=4096
 
 # For team mode
 DATABASE_URL=postgresql://user:pass@host/db
@@ -212,7 +281,7 @@ Squish employs a two-tier architecture for optimal performance and reliability:
 - **CLI**: Standalone command-line tool for shell-based agents and debugging
 
 ### Memory Organization
-- **Core Memory (2KB)**: Always-visible sections for persona, user info, project context, and working notes
+- **Core Memory (configurable, default 16KB total)**: Always-visible sections for persona, user info, project context, and working notes. Each section limited to 4KB by default. Token estimation helps track LLM context usage.
 - **Context Paging**: Agent-controlled retrieval with token budgeting (8KB default)
 - **Background Jobs**: Automatic memory maintenance including decay, deduplication, and consolidation
 

package/config/plugin-manifest.json

@@ -0,0 +1,152 @@
+{
+  "id": "squish-memory",
+  "name": "Squish Memory",
+  "version": "1.0.0",
+  "description": "Universal two-tier memory system for AI agents with hybrid search, core memory, and MCP-first architecture",
+  "capabilities": ["mcp", "cli", "web"],
+  "targets": {
+    "claude-code": {
+      "type": "hooks",
+      "hooks": ["SessionStart", "UserPromptSubmit", "PostToolUse", "SessionEnd"],
+      "install": {
+        "copy": [
+          { "from": ".claude-plugin/plugin.json", "to": "~/.claude/plugin.json" }
+        ]
+      },
+      "verify": {
+        "fileExists": "~/.claude/plugin.json",
+        "toolCheck": "squish_health"
+      }
+    },
+    "openclaw": {
+      "type": "plugin-slot",
+      "slot": "memory",
+      "tools": ["memory_search", "memory_get"],
+      "install": {
+        "command": "node scripts/openclaw-bootstrap.mjs --skip-tool-check"
+      },
+      "verify": {
+        "fileExists": "~/.openclaw/openclaw-memory.json",
+        "toolCheck": "memory_search"
+      }
+    },
+    "opencode": {
+      "type": "mcp",
+      "tools": ["squish_remember", "squish_search", "squish_recall", "squish_context", "squish_health"],
+      "install": {
+        "copy": [
+          { "from": "generated/mcp/mcp-servers.json", "to": "~/.config/opencode/mcp-servers.json" }
+        ]
+      },
+      "verify": {
+        "fileExists": "~/.config/opencode/mcp-servers.json",
+        "toolCheck": "squish_health"
+      }
+    },
+    "codex": {
+      "type": "mcp",
+      "tools": ["squish_remember", "squish_search", "squish_recall", "squish_context", "squish_health"],
+      "install": {
+        "copy": [
+          { "from": "generated/mcp/mcp-servers.json", "to": "~/.codex/mcp-servers.json" }
+        ]
+      },
+      "verify": {
+        "fileExists": "~/.codex/mcp-servers.json",
+        "toolCheck": "squish_health"
+      }
+    },
+    "cursor": {
+      "type": "mcp",
+      "tools": ["squish_remember", "squish_search", "squish_recall", "squish_context", "squish_health"],
+      "install": {
+        "copy": [
+          { "from": "generated/mcp/mcp-servers.json", "to": "~/.cursor/mcp.json" }
+        ]
+      },
+      "verify": {
+        "fileExists": "~/.cursor/mcp.json",
+        "toolCheck": "squish_health"
+      }
+    },
+    "vscode": {
+      "type": "mcp",
+      "tools": ["squish_remember", "squish_search", "squish_recall", "squish_context", "squish_health"],
+      "install": {
+        "copy": [
+          { "from": "generated/mcp/mcp-servers.json", "to": "~/.vscode/mcp/servers.json" }
+        ]
+      },
+      "verify": {
+        "fileExists": "~/.vscode/mcp/servers.json",
+        "toolCheck": "squish_health"
+      }
+    },
+    "windsurf": {
+      "type": "mcp",
+      "tools": ["squish_remember", "squish_search", "squish_recall", "squish_context", "squish_health"],
+      "install": {
+        "copy": [
+          { "from": "generated/mcp/mcp-servers.json", "to": "~/.windsurf/mcp-servers.json" }
+        ]
+      },
+      "verify": {
+        "fileExists": "~/.windsurf/mcp-servers.json",
+        "toolCheck": "squish_health"
+      }
+    }
+  },
+  "dependencies": {
+    "mcporter": {
+      "version": "0.7.3",
+      "autoInstall": true,
+      "optional": false,
+      "provides": ["mcp-bridge", "openclaw-memory"]
+    },
+    "@tobilu/qmd": {
+      "version": "2.0.1",
+      "autoInstall": true,
+      "optional": false,
+      "provides": ["fast-search", "bm25", "vector-search"]
+    }
+  },
+  "auth": {
+    "modes": ["none", "token"],
+    "default": "none",
+    "token": {
+      "envVar": "SQUISH_REMOTE_TOKEN",
+      "help": "Set SQUISH_REMOTE_TOKEN for remote mode authentication"
+    }
+  },
+  "pinning": {
+    "mcporter": "0.7.3",
+    "@tobilu/qmd": "2.0.1",
+    "@modelcontextprotocol/sdk": "1.27.1"
+  },
+  "entry": {
+    "mcp": "dist/commands/mcp-server.cjs",
+    "cli": "dist/index.js",
+    "plugin": "packages/plugin-openclaw/dist/index.js"
+  },
+  "compatibility": {
+    "minNodeVersion": "18.0.0",
+    "clients": [
+      { "id": "claude-code", "minVersion": "0.62.0" },
+      { "id": "openclaw", "minVersion": "2026.2.15" },
+      { "id": "opencode", "minVersion": "0.1.0" },
+      { "id": "codex", "minVersion": "0.1.0" },
+      { "id": "cursor", "minVersion": "0.45.0" },
+      { "id": "vscode-mcp", "minVersion": "1.0.0" },
+      { "id": "windsurf", "minVersion": "0.1.0" }
+    ]
+  },
+  "healthCheck": {
+    "mcpTool": "squish_health",
+    "httpEndpoint": "/health"
+  },
+  "generated": {
+    "from": "config/plugin-manifest.json",
+    "generator": "squish-memory@1.0.0",
+    "timestamp": "2026-01-17T00:00:00.000Z"
+  }
+}

package/config/plugin-manifest.schema.json

@@ -0,0 +1,244 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Squish Universal Plugin Manifest",
+  "description": "Universal plugin manifest for Squish memory system across all AI assistant clients",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "id",
+    "name",
+    "version",
+    "description",
+    "capabilities",
+    "targets",
+    "dependencies",
+    "auth"
+  ],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^@squish/(memory|plugin)-[a-z0-9-]+$",
+      "description": "Unique plugin identifier in @squish/ scope"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable plugin name"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version (major.minor.patch)"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 10,
+      "description": "Short description of the plugin"
+    },
+    "capabilities": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": ["mcp", "cli", "web", "hooks"]
+      },
+      "minItems": 1,
+      "description": "What capabilities this plugin provides"
+    },
+    "targets": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["type"],
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": ["mcp", "hooks", "plugin-slot"]
+          },
+          "slot": {
+            "type": "string",
+            "description": "Plugin slot name (for plugin-slot type)"
+          },
+          "tools": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "List of tools this plugin exposes (for mcp type)"
+          },
+          "hooks": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "SessionStart",
+                "UserPromptSubmit",
+                "PostToolUse",
+                "SessionEnd",
+                "onInstall"
+              ]
+            },
+            "description": "List of hooks to register (for hooks type)"
+          },
+          "configPath": {
+            "type": "string",
+            "description": "Relative path to client config file"
+          },
+          "install": {
+            "type": "object",
+            "properties": {
+              "copy": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "required": ["from", "to"],
+                  "properties": {
+                    "from": { "type": "string" },
+                    "to": { "type": "string" }
+                  }
+                }
+              },
+              "merge": {
+                "type": "object",
+                "properties": {
+                  "file": { "type": "string" },
+                  "strategy": { "type": "string", "enum": ["deep-merge", "replace"] }
+                }
+              },
+              "command": {
+                "type": "string",
+                "description": "Custom install command to run"
+              }
+            }
+          },
+          "verify": {
+            "type": "object",
+            "properties": {
+              "command": { "type": "string" },
+              "fileExists": { "type": "string" },
+              "toolCheck": { "type": "string" }
+            }
+          }
+        }
+      },
+      "minProperties": 1,
+      "description": "Client-specific configurations"
+    },
+    "dependencies": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["version", "autoInstall"],
+        "properties": {
+          "version": {
+            "type": "string",
+            "description": "Pinned version (e.g., '1.2.0')"
+          },
+          "autoInstall": {
+            "type": "boolean",
+            "description": "Whether to auto-install if missing"
+          },
+          "optional": {
+            "type": "boolean",
+            "default": false,
+            "description": "Whether this dependency is optional"
+          },
+          "provides": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "List of capabilities this dependency provides"
+          }
+        }
+      },
+      "description": "Runtime dependencies with version pinning"
+    },
+    "auth": {
+      "type": "object",
+      "required": ["modes", "default"],
+      "properties": {
+        "modes": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["none", "token", "oauth"]
+          },
+          "minItems": 1,
+          "description": "Supported authentication modes"
+        },
+        "default": {
+          "type": "string",
+          "enum": ["none", "token", "oauth"],
+          "description": "Default auth mode"
+        },
+        "token": {
+          "type": "object",
+          "properties": {
+            "envVar": { "type": "string" },
+            "help": { "type": "string" }
+          }
+        },
+        "oauth": {
+          "type": "object",
+          "properties": {
+            "providers": {
+              "type": "array",
+              "items": { "type": "string", "enum": ["github", "google", "anthropic"] }
+            }
+          }
+        }
+      }
+    },
+    "pinning": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "description": "Compatibility matrix for all dependencies"
+    },
+    "entry": {
+      "type": "object",
+      "properties": {
+        "mcp": {
+          "type": "string",
+          "description": "Path to MCP server entry point (for mcp capability)"
+        },
+        "plugin": {
+          "type": "string",
+          "description": "Path to plugin entry point (for plugin-slot type)"
+        },
+        "cli": {
+          "type": "string",
+          "description": "Path to CLI binary (for cli capability)"
+        }
+      }
+    },
+    "compatibility": {
+      "type": "object",
+      "properties": {
+        "minNodeVersion": { "type": "string" },
+        "maxNodeVersion": { "type": "string" },
+        "clients": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "id": { "type": "string" },
+              "minVersion": { "type": "string" },
+              "maxVersion": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "healthCheck": {
+      "type": "object",
+      "properties": {
+        "mcpTool": {
+          "type": "string",
+          "description": "Tool name to call for health check"
+        },
+        "httpEndpoint": {
+          "type": "string",
+          "description": "HTTP endpoint for health check"
+        }
+      }
+    }
+  }
+}