@hailer/mcp 0.1.6 → 0.1.8

package/.claude/hooks/sync-marketplace-agents.cjs

@@ -1,82 +1,98 @@
 #!/usr/bin/env node
 /**
  * Sync Marketplace Agents Hook
- * Runs once per session on first prompt, scans ENABLED plugins,
- * updates CLAUDE.md with available marketplace agents.
+ * Watches installed_plugins.json for changes and updates CLAUDE.md
+ * with available marketplace agents when plugins are installed/uninstalled.
  */
 
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
+const crypto = require('crypto');
 
-// Session marker - unique per Claude Code restart (uses parent PID)
-const SESSION_MARKER = path.join(os.tmpdir(), `claude-agent-sync-${process.ppid}`);
 const PLUGINS_DIR = path.join(os.homedir(), '.claude', 'plugins', 'marketplaces');
-const CLAUDE_MD = path.join(process.env.CLAUDE_PROJECT_DIR || process.cwd(), 'CLAUDE.md');
-const PROJECT_SETTINGS = path.join(process.env.CLAUDE_PROJECT_DIR || process.cwd(), '.claude', 'settings.json');
+const INSTALLED_PLUGINS = path.join(os.homedir(), '.claude', 'plugins', 'installed_plugins.json');
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const CLAUDE_MD = path.join(PROJECT_DIR, 'CLAUDE.md');
+const PROJECT_SETTINGS = path.join(PROJECT_DIR, '.claude', 'settings.json');
 const USER_SETTINGS = path.join(os.homedir(), '.claude', 'settings.json');
 
+// Store sync state in user's home, keyed by project path hash
+const SYNC_STATE_DIR = path.join(os.homedir(), '.claude', 'sync-state');
+const PROJECT_HASH = crypto.createHash('md5').update(PROJECT_DIR).digest('hex').slice(0, 12);
+const SYNC_STATE = path.join(SYNC_STATE_DIR, `${PROJECT_HASH}.state`);
+
 /**
- * Check if already synced this session
+ * Get hash of installed_plugins.json content
  */
-function alreadySynced() {
-  return fs.existsSync(SESSION_MARKER);
+function getInstalledPluginsHash() {
+  if (!fs.existsSync(INSTALLED_PLUGINS)) {
+    return 'empty';
+  }
+  const content = fs.readFileSync(INSTALLED_PLUGINS, 'utf-8');
+  return crypto.createHash('md5').update(content).digest('hex');
 }
 
 /**
- * Mark as synced
+ * Check if plugins have changed since last sync
  */
-function markSynced() {
-  fs.writeFileSync(SESSION_MARKER, new Date().toISOString());
+function pluginsChanged() {
+  const currentHash = getInstalledPluginsHash();
+
+  if (!fs.existsSync(SYNC_STATE)) {
+    return true; // First run
+  }
+
+  const lastHash = fs.readFileSync(SYNC_STATE, 'utf-8').trim();
+  return currentHash !== lastHash;
 }
 
 /**
- * Get enabled plugins from settings.json files
+ * Save current sync state
+ */
+function saveSyncState() {
+  const currentHash = getInstalledPluginsHash();
+  // Ensure sync state directory exists
+  if (!fs.existsSync(SYNC_STATE_DIR)) {
+    fs.mkdirSync(SYNC_STATE_DIR, { recursive: true });
+  }
+  fs.writeFileSync(SYNC_STATE, currentHash);
+}
+
+/**
+ * Get installed plugins from installed_plugins.json
  * Returns Set of "plugin@marketplace" strings
  */
-function getEnabledPlugins() {
-  const enabled = new Set();
-
-  // Check project settings
-  if (fs.existsSync(PROJECT_SETTINGS)) {
-    try {
-      const settings = JSON.parse(fs.readFileSync(PROJECT_SETTINGS, 'utf-8'));
-      if (settings.enabledPlugins) {
-        for (const [key, value] of Object.entries(settings.enabledPlugins)) {
-          if (value === true) {
-            enabled.add(key); // format: "plugin@marketplace"
-          }
-        }
-      }
-    } catch (e) { /* ignore parse errors */ }
+function getInstalledPlugins() {
+  const plugins = new Set();
+
+  if (!fs.existsSync(INSTALLED_PLUGINS)) {
+    return plugins;
   }
 
-  // Check user settings
-  if (fs.existsSync(USER_SETTINGS)) {
-    try {
-      const settings = JSON.parse(fs.readFileSync(USER_SETTINGS, 'utf-8'));
-      if (settings.enabledPlugins) {
-        for (const [key, value] of Object.entries(settings.enabledPlugins)) {
-          if (value === true) {
-            enabled.add(key);
-          }
-        }
+  try {
+    const data = JSON.parse(fs.readFileSync(INSTALLED_PLUGINS, 'utf-8'));
+    if (data.plugins) {
+      for (const pluginKey of Object.keys(data.plugins)) {
+        plugins.add(pluginKey);
       }
-    } catch (e) { /* ignore parse errors */ }
+    }
+  } catch (e) {
+    // Ignore parse errors
   }
 
-  return enabled;
+  return plugins;
 }
 
 /**
- * Scan marketplace plugins for agents (only enabled plugins)
- * Supports both flat and nested structures:
+ * Scan marketplace plugins for agents (all discovered plugins)
+ * Supports three structures:
  * - Flat: {marketplace}/agents/ (when plugin name == marketplace name)
+ * - Root-level: {marketplace}/{plugin}/agents/ (plugin dirs at marketplace root)
  * - Nested: {marketplace}/plugins/{plugin}/agents/
  */
-function scanMarketplaceAgents() {
+function scanMarketplaceAgents(enabledPlugins) {
   const agents = [];
-  const enabledPlugins = getEnabledPlugins();
 
   if (!fs.existsSync(PLUGINS_DIR)) {
     return agents;
@@ -86,6 +102,7 @@ function scanMarketplaceAgents() {
 
   for (const marketplace of marketplaces) {
     const marketplacePath = path.join(PLUGINS_DIR, marketplace);
+    if (!fs.statSync(marketplacePath).isDirectory()) continue;
 
     // Try flat structure first: {marketplace}/agents/
     const flatAgentsPath = path.join(marketplacePath, 'agents');
@@ -113,6 +130,45 @@ function scanMarketplaceAgents() {
       }
     }
 
+    // Try root-level plugins: {marketplace}/{plugin}/agents/
+    // Each subdirectory with .claude-plugin is a plugin
+    const marketplaceContents = fs.readdirSync(marketplacePath);
+    for (const item of marketplaceContents) {
+      if (item === '.claude-plugin' || item === '.git' || item === 'plugins') continue;
+
+      const itemPath = path.join(marketplacePath, item);
+      if (!fs.statSync(itemPath).isDirectory()) continue;
+
+      const pluginJsonPath = path.join(itemPath, '.claude-plugin', 'plugin.json');
+
+      // Check if this is a plugin (has .claude-plugin/plugin.json)
+      if (fs.existsSync(pluginJsonPath)) {
+        const pluginKey = `${item}@${marketplace}`;
+        if (!enabledPlugins.has(pluginKey)) continue;
+
+        const agentsPath = path.join(itemPath, 'agents');
+        if (!fs.existsSync(agentsPath)) continue;
+
+        const agentFiles = fs.readdirSync(agentsPath).filter(f => f.endsWith('.md'));
+
+        for (const agentFile of agentFiles) {
+          const agentName = path.basename(agentFile, '.md');
+          const fullPath = path.join(agentsPath, agentFile);
+          const content = fs.readFileSync(fullPath, 'utf-8');
+          const frontmatter = parseFrontmatter(content);
+
+          agents.push({
+            marketplace,
+            plugin: item,
+            name: agentName,
+            fullName: `${item}:${agentName}`,
+            description: frontmatter.description || '',
+            model: frontmatter.model || 'sonnet'
+          });
+        }
+      }
+    }
+
     // Try nested structure: {marketplace}/plugins/{plugin}/agents/
     const pluginsPath = path.join(marketplacePath, 'plugins');
     if (fs.existsSync(pluginsPath)) {
@@ -124,7 +180,10 @@ function scanMarketplaceAgents() {
           continue;
         }
 
-        const agentsPath = path.join(pluginsPath, plugin, 'agents');
+        const pluginPath = path.join(pluginsPath, plugin);
+        if (!fs.statSync(pluginPath).isDirectory()) continue;
+
+        const agentsPath = path.join(pluginPath, 'agents');
         if (!fs.existsSync(agentsPath)) continue;
 
         const agentFiles = fs.readdirSync(agentsPath).filter(f => f.endsWith('.md'));
@@ -224,24 +283,26 @@ function updateClaudeMd(agents) {
  * Main
  */
 function main() {
-  // Skip if already synced this session
-  if (alreadySynced()) {
+  // Skip if installed_plugins.json hasn't changed
+  if (!pluginsChanged()) {
     process.exit(0);
   }
 
   try {
-    const agents = scanMarketplaceAgents();
+    // Get actually installed plugins from installed_plugins.json
+    const installedPlugins = getInstalledPlugins();
+
+    // Scan agents only from installed plugins
+    const agents = scanMarketplaceAgents(installedPlugins);
     const result = updateClaudeMd(agents);
 
-    // Mark as synced
-    markSynced();
+    // Save sync state
+    saveSyncState();
 
-    // Output info if agents found
-    if (agents.length > 0) {
-      console.error(`[sync-agents] Found ${agents.length} marketplace agents`);
-      if (result.updated) {
-        console.error(`[sync-agents] Updated CLAUDE.md`);
-      }
+    // Output info
+    console.error(`[sync-agents] Detected plugin changes, found ${agents.length} marketplace agents`);
+    if (result.updated) {
+      console.error(`[sync-agents] Updated CLAUDE.md`);
     }
 
     process.exit(0);

package/CHANGELOG.md

@@ -4,6 +4,26 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.8] - 15-12-2025
+
+### Fixed
+
+- Corrected marketplace git URL to `git@gitlab.com:hailer-repos/hailer-mcp-marketplace.git`
+
+## [0.1.7] - 15-12-2025
+
+### Changed
+
+- **Marketplace Sync Hook**:
+  - Changed from session-based to hash-based sync (tracks `installed_plugins.json` changes)
+  - Added support for root-level plugin structure: `{marketplace}/{plugin}/agents/`
+  - Per-project sync state to avoid unnecessary re-syncs
+  - Improved logging when plugin changes detected
+
+- **Plugin Documentation**:
+  - Restructured CLAUDE.md with separate `<plugin-setup>` and `<plugin-contributing>` sections
+  - Clearer instructions for marketplace installation and contribution
+
 ## [0.1.5] - 12-12-2025
 
 ### Added

package/CLAUDE.md

@@ -158,33 +158,50 @@ WITHOUT AGENTS: Use MCP tools directly
 <plugin-marketplace>
 Community agents are shared via the Hailer Agent Marketplace (separate git repo).
 
-**Install marketplace:**
-```
-/plugin marketplace add gitlab:hailer-repos/hailer-mcp-marketplace
-/plugin install hailer-agents
-```
-Then restart Claude Code.
+**Marketplace URL:** `git@gitlab.com:hailer-repos/hailer-mcp-marketplace.git`
+
+**Installed marketplace agents:**
+No marketplace agents installed.
 
 **Use plugin agents:**
 ```
 Task(subagent_type="plugin:agent-name", prompt="...", model="haiku|sonnet")
 ```
 
-**Installed marketplace agents:**
-No marketplace agents installed.
+**Agent sources:**
+- Default agents: `.claude/agents/` (shipped via npm)
+- Community agents: Plugin marketplace (installed separately)
+</plugin-marketplace>
 
+<plugin-setup>
+When user asks to install plugins or set up the marketplace:
 
+1. Tell user to run these slash commands:
+   ```
+   /plugin marketplace add git@gitlab.com:hailer-repos/hailer-mcp-marketplace.git
+   /plugin install <plugin-name>
+   ```
 
+2. Tell user: "Restart Claude Code to load the new agents."
 
-**Contribute agents:**
-1. Clone `gitlab:hailer-repos/hailer-mcp-marketplace`
-2. Add agent to `agents/your-agent.md`
-3. Push to repo
+Available plugins: `permissions-handler`, `hailer-agents`
 
-**Agent sources:**
-- Default agents: `.claude/agents/` (shipped via npm)
-- Community agents: Plugin marketplace (installed separately)
-</plugin-marketplace>
+After restart, sync hook updates this file automatically with installed agents.
+</plugin-setup>
+
+<plugin-contributing>
+To contribute agents to the marketplace:
+
+1. Clone: `git clone git@gitlab.com:hailer-repos/hailer-mcp-marketplace.git`
+2. Create plugin structure:
+   ```
+   my-plugin/
+     .claude-plugin/plugin.json
+     agents/agent-my-agent.md
+   ```
+3. Follow agent structure from `<agent-structure>` section
+4. Push to repo
+</plugin-contributing>
 
 <directory>
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hailer/mcp",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "config": {
     "docker": {
       "registry": "registry.gitlab.com/hailer-repos/hailer-mcp"