@hailer/mcp 0.2.3 → 0.2.5

package/.claude/commands/install-plugin.md

@@ -0,0 +1,261 @@
+---
+description: Install a plugin from local marketplace clone to .claude/ folder
+---
+
+# Install Plugin from Local Marketplace
+
+Copies plugin files from local marketplace repo to project's `.claude/` folder.
+
+## Usage
+
+```
+/install-plugin <plugin-name>
+```
+
+## Pre-flight Checks
+
+### 1. Marketplace Path
+```bash
+PROJECT_ROOT="$(pwd)"
+MARKETPLACE_PATH="$PROJECT_ROOT/hailer-marketplace"
+if [ ! -d "$MARKETPLACE_PATH" ]; then
+  echo "ERROR: Marketplace not found at $MARKETPLACE_PATH"
+  echo "Clone it: git clone git@github.com:Bdolf/Hailer-Marketplace.git $MARKETPLACE_PATH"
+  exit 1
+fi
+```
+
+### 2. Plugin Exists
+```bash
+PLUGIN_NAME="$1"
+if [ ! -d "$MARKETPLACE_PATH/$PLUGIN_NAME" ]; then
+  echo "ERROR: Plugin '$PLUGIN_NAME' not found in marketplace"
+  echo "Available plugins:"
+  ls -1 "$MARKETPLACE_PATH" | grep -v "^\." | grep -v "node_modules"
+  exit 1
+fi
+```
+
+## Installation Steps
+
+For each plugin, copy files to the correct locations:
+
+| Source | Destination |
+|--------|-------------|
+| `{plugin}/agents/*.md` | `.claude/agents/` |
+| `{plugin}/skills/*/` | `.claude/skills/` |
+| `{plugin}/hooks/*.cjs` | `.claude/hooks/` |
+| `{plugin}/hooks/hooks.json` | Merge into `.claude/settings.json` |
+| `{plugin}/.lsp.json` | Install to `~/.claude/plugins/cache/` (LSP support) |
+
+## Execution Script
+
+```bash
+#!/bin/bash
+
+PROJECT_ROOT="$(pwd)"
+MARKETPLACE_PATH="$PROJECT_ROOT/hailer-marketplace"
+PLUGIN_NAME="$1"
+PLUGIN_PATH="$MARKETPLACE_PATH/$PLUGIN_NAME"
+TARGET_CLAUDE=".claude"
+
+# Pre-flight
+if [ ! -d "$PLUGIN_PATH" ]; then
+  echo "ERROR: Plugin '$PLUGIN_NAME' not found"
+  exit 1
+fi
+
+# Create target dirs if needed
+mkdir -p "$TARGET_CLAUDE/agents" "$TARGET_CLAUDE/skills" "$TARGET_CLAUDE/hooks"
+
+# Copy agents
+if [ -d "$PLUGIN_PATH/agents" ]; then
+  cp -v "$PLUGIN_PATH/agents/"*.md "$TARGET_CLAUDE/agents/" 2>/dev/null
+  echo "Installed agents"
+fi
+
+# Copy skills (entire directories)
+if [ -d "$PLUGIN_PATH/skills" ]; then
+  cp -rv "$PLUGIN_PATH/skills/"* "$TARGET_CLAUDE/skills/" 2>/dev/null || true
+  echo "Installed skills"
+fi
+
+# Copy hooks
+if [ -d "$PLUGIN_PATH/hooks" ]; then
+  find "$PLUGIN_PATH/hooks" -name "*.cjs" -exec cp -v {} "$TARGET_CLAUDE/hooks/" \;
+  echo "Installed hooks"
+fi
+
+# Auto-install LSP if plugin has .lsp.json
+if [ -f "$PLUGIN_PATH/.lsp.json" ]; then
+  echo "Plugin includes LSP support, installing..."
+
+  # Use typescript-lsp from marketplace as LSP source
+  LSP_SOURCE="$MARKETPLACE_PATH/typescript-lsp"
+  LSP_CACHE="$HOME/.claude/plugins/cache/hailer-mcp-marketplace/typescript-lsp/1.0.0"
+  LSP_INSTALLED="$HOME/.claude/plugins/installed_plugins.json"
+
+  # Create plugin cache directory
+  mkdir -p "$LSP_CACHE/.claude-plugin"
+
+  # Copy .lsp.json from the LSP plugin source (not the current plugin)
+  if [ -f "$LSP_SOURCE/.lsp.json" ]; then
+    cp "$LSP_SOURCE/.lsp.json" "$LSP_CACHE/.lsp.json"
+  else
+    cp "$PLUGIN_PATH/.lsp.json" "$LSP_CACHE/.lsp.json"
+  fi
+
+  # Copy the actual plugin.json from typescript-lsp plugin
+  if [ -f "$LSP_SOURCE/.claude-plugin/plugin.json" ]; then
+    cp "$LSP_SOURCE/.claude-plugin/plugin.json" "$LSP_CACHE/.claude-plugin/plugin.json"
+  else
+    # Fallback: create minimal plugin.json
+    cat > "$LSP_CACHE/.claude-plugin/plugin.json" << 'PLUGINJSON'
+{
+  "name": "typescript-lsp",
+  "version": "1.0.0",
+  "description": "TypeScript/JavaScript LSP support"
+}
+PLUGINJSON
+  fi
+
+  # Register in installed_plugins.json
+  node -e "
+    const fs = require('fs');
+    const path = '$LSP_INSTALLED';
+
+    let data = { version: 2, plugins: {} };
+    if (fs.existsSync(path)) {
+      data = JSON.parse(fs.readFileSync(path, 'utf-8'));
+    }
+
+    const key = 'typescript-lsp@hailer-mcp-marketplace';
+    if (!data.plugins[key]) {
+      data.plugins[key] = [{
+        scope: 'user',
+        installPath: '$LSP_CACHE',
+        version: '1.0.0',
+        installedAt: new Date().toISOString(),
+        lastUpdated: new Date().toISOString()
+      }];
+      fs.writeFileSync(path, JSON.stringify(data, null, 2));
+      console.log('LSP registered in installed_plugins.json');
+    } else {
+      console.log('LSP already registered');
+    }
+  "
+
+  # Enable LSP tool in settings.json and .env.local
+  node -e "
+    const fs = require('fs');
+
+    // 1. Update .claude/settings.json
+    const settingsPath = '.claude/settings.json';
+    let settings = {};
+    if (fs.existsSync(settingsPath)) {
+      settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
+    }
+    if (!settings.env) settings.env = {};
+    if (settings.env.ENABLE_LSP_TOOL !== '1') {
+      settings.env.ENABLE_LSP_TOOL = '1';
+      fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+      console.log('ENABLE_LSP_TOOL set in .claude/settings.json');
+    } else {
+      console.log('ENABLE_LSP_TOOL already in settings.json');
+    }
+
+    // 2. Update .env
+    const envPath = '.env';
+    let envContent = '';
+    if (fs.existsSync(envPath)) {
+      envContent = fs.readFileSync(envPath, 'utf-8');
+    }
+    if (!envContent.includes('ENABLE_LSP_TOOL=')) {
+      const line = (envContent && !envContent.endsWith('\n') ? '\n' : '') + 'ENABLE_LSP_TOOL=1\n';
+      fs.appendFileSync(envPath, line);
+      console.log('ENABLE_LSP_TOOL added to .env');
+    } else {
+      console.log('ENABLE_LSP_TOOL already in .env');
+    }
+  "
+
+  echo "LSP config installed"
+fi
+
+echo "Files copied. Updating CLAUDE.md..."
+```
+
+## Update CLAUDE.md (Node.js)
+
+Run after file copy to add agent to the main `<agents>` table:
+
+```bash
+node << 'EOF'
+const fs = require("fs");
+const path = require("path");
+
+const PLUGIN_NAME = process.env.PLUGIN_NAME;
+const AGENTS_DIR = ".claude/agents";
+const CLAUDE_MD = "CLAUDE.md";
+
+// Find agent files for this plugin
+const agentFiles = fs.readdirSync(AGENTS_DIR)
+  .filter(f => f.startsWith("agent-" + PLUGIN_NAME) || f.includes(PLUGIN_NAME))
+  .filter(f => f.endsWith(".md"));
+
+if (agentFiles.length === 0) {
+  console.log("No agent files found for " + PLUGIN_NAME);
+  process.exit(0);
+}
+
+let content = fs.readFileSync(CLAUDE_MD, "utf-8");
+
+for (const agentFile of agentFiles) {
+  const agentPath = path.join(AGENTS_DIR, agentFile);
+  const agentContent = fs.readFileSync(agentPath, "utf-8");
+  const agentName = path.basename(agentFile, ".md");
+
+  // Parse frontmatter
+  const modelMatch = agentContent.match(/^model:\s*(\w+)/m);
+  const descMatch = agentContent.match(/^description:\s*(.{1,30})/m);
+  const model = modelMatch ? modelMatch[1] : "sonnet";
+  const desc = descMatch ? descMatch[1].trim() : PLUGIN_NAME;
+
+  // Check if already in agents table
+  if (content.includes("| `" + agentName + "`")) {
+    console.log(agentName + " already in <agents> table");
+    continue;
+  }
+
+  // Insert before </agents>
+  const newRow = "| " + desc + " | `" + agentName + "` | " + model + " |\n";
+  content = content.replace("</agents>", newRow + "</agents>");
+  console.log("Added " + agentName + " to <agents> table");
+}
+
+fs.writeFileSync(CLAUDE_MD, content);
+console.log("CLAUDE.md updated");
+EOF
+```
+
+Note: Set `PLUGIN_NAME` env var before running.
+
+## Full Command
+
+Run both scripts in sequence:
+```bash
+# 1. Copy files (bash)
+# 2. Update CLAUDE.md (node)
+```
+
+Then: `echo "Restart Claude Code to load: claude -c"`
+
+## List Available Plugins
+
+If no plugin name provided, list available:
+```bash
+PROJECT_ROOT="$(pwd)"
+MARKETPLACE_PATH="$PROJECT_ROOT/hailer-marketplace"
+echo "Available plugins in marketplace:"
+jq -r '.plugins[] | "  \(.name) v\(.version) - \(.description)"' "$MARKETPLACE_PATH/.claude-plugin/marketplace.json"
+```

package/.claude/commands/list-plugins.md

@@ -0,0 +1,42 @@
+---
+description: List available plugins from local marketplace
+---
+
+# List Available Marketplace Plugins
+
+Shows all plugins available in the local marketplace clone.
+
+## Usage
+
+```
+/list-plugins
+```
+
+## Execution
+
+```bash
+PROJECT_ROOT="$(pwd)"
+MARKETPLACE_PATH="$PROJECT_ROOT/hailer-marketplace"
+
+if [ ! -d "$MARKETPLACE_PATH/.git" ]; then
+  echo "Marketplace not found at $MARKETPLACE_PATH"
+  echo "Run /marketplace-setup first"
+  exit 1
+fi
+
+# Pull latest before listing
+cd "$MARKETPLACE_PATH" && git pull origin main --quiet && cd - > /dev/null
+echo "Pulled latest from marketplace"
+echo ""
+
+jq -r '.plugins[] | "  \(.name)@\(.version) - \(.description)"' \
+  "$MARKETPLACE_PATH/.claude-plugin/marketplace.json"
+```
+
+## Output (ALWAYS SHOW TO USER)
+
+After running the execution script, ALWAYS present the results to the user:
+
+1. Show total count: "**X plugins available in marketplace**"
+2. List each plugin with name, version, and description
+3. Remind user they can install with `/install-plugin <name>`

package/.claude/commands/marketplace-setup.md

@@ -0,0 +1,33 @@
+---
+description: Clone or pull the Hailer marketplace repo
+---
+
+# Marketplace Setup
+
+Clone if missing, pull if exists. Always uses project root directory.
+
+## Execution
+
+```bash
+# Get project root (where CLAUDE.md is)
+PROJECT_ROOT="$(pwd)"
+
+# Marketplace path is always relative to project root
+MARKETPLACE_PATH="$PROJECT_ROOT/hailer-marketplace"
+
+echo "Project root: $PROJECT_ROOT"
+echo "Marketplace path: $MARKETPLACE_PATH"
+
+if [ -d "$MARKETPLACE_PATH/.git" ]; then
+  cd "$MARKETPLACE_PATH" && git pull origin main
+  echo "Pulled latest"
+else
+  git clone git@github.com:Bdolf/Hailer-Marketplace.git "$MARKETPLACE_PATH"
+  echo "Cloned marketplace to $MARKETPLACE_PATH"
+fi
+```
+
+## Important
+
+The marketplace is always cloned to `./hailer-marketplace` in the project root.
+Commands should use absolute paths when working with the marketplace.

package/.claude/commands/publish-plugin.md

@@ -0,0 +1,55 @@
+---
+description: Publish a plugin to the Hailer marketplace with pre-validation
+---
+
+# Publish Plugin to Marketplace
+
+## Usage
+
+```
+/publish-plugin <name>
+/publish-plugin <source-path>
+```
+
+## Execution
+
+**Spawn the publisher agent** with the plugin info:
+
+```
+Task(
+  subagent_type="agent-marketplace-publisher",
+  prompt={
+    "task": "publish",
+    "plugin": {
+      "name": "<plugin-name>",
+      "type": "agent|skill|hook",
+      "source_path": "<path-to-source-file>",
+      "description": "<description>",
+      "author": "<author>"
+    }
+  }
+)
+```
+
+## Argument Handling
+
+If argument is a **path** (contains `/` or `.md`):
+- `source_path`: use argument directly
+- `name`: extract from filename (e.g., `agent-my-agent.md` → `my-agent`)
+- `type`: detect from path (`/agents/` → agent, `/skills/` → skill)
+
+If argument is a **name**:
+- Look for `.claude/agents/agent-{name}.md`
+- Or ask user for source path
+
+## Flow
+
+1. Orchestrator spawns `agent-marketplace-publisher`
+2. Publisher checks if plugin exists, suggests version
+3. Publisher returns `needs_confirmation` with version suggestion
+4. User confirms version
+5. Publisher creates branch, commits, pushes
+6. Publisher returns `trigger_review`
+7. Orchestrator spawns `agent-marketplace-reviewer`
+8. Reviewer validates and merges to main
+9. Done - plugin published

package/.claude/commands/uninstall-plugin.md

@@ -0,0 +1,87 @@
+---
+description: Uninstall a plugin from .claude/ folder
+---
+
+# Uninstall Plugin
+
+Removes plugin files from project's `.claude/` folder and updates CLAUDE.md.
+
+## Usage
+
+```
+/uninstall-plugin <plugin-name>
+```
+
+## Execution Script
+
+```bash
+#!/bin/bash
+
+PLUGIN_NAME="$1"
+TARGET_CLAUDE=".claude"
+
+if [ -z "$PLUGIN_NAME" ]; then
+  echo "Currently installed plugins:"
+  ls -1 "$TARGET_CLAUDE/agents/"agent-*.md 2>/dev/null | xargs -I{} basename {} .md | sed 's/^agent-//' | sort -u
+  exit 0
+fi
+
+# Remove agents matching plugin name
+REMOVED=0
+for f in "$TARGET_CLAUDE/agents/agent-$PLUGIN_NAME"*.md; do
+  if [ -f "$f" ]; then
+    rm -v "$f"
+    REMOVED=$((REMOVED + 1))
+  fi
+done
+
+# Remove skills matching plugin name
+if [ -d "$TARGET_CLAUDE/skills/$PLUGIN_NAME" ]; then
+  rm -rv "$TARGET_CLAUDE/skills/$PLUGIN_NAME"
+  REMOVED=$((REMOVED + 1))
+fi
+
+# Remove hooks matching plugin name
+find "$TARGET_CLAUDE/hooks" -name "${PLUGIN_NAME}*.cjs" -exec rm -v {} \; 2>/dev/null && REMOVED=$((REMOVED + 1))
+
+if [ $REMOVED -eq 0 ]; then
+  echo "No files found for plugin '$PLUGIN_NAME'"
+  exit 1
+fi
+
+echo "Files removed. Updating CLAUDE.md..."
+```
+
+## Update CLAUDE.md (Node.js)
+
+Run after file removal to remove agent from the main `<agents>` table:
+
+```bash
+node << EOF
+const fs = require("fs");
+
+const PLUGIN_NAME = "$PLUGIN_NAME";
+const CLAUDE_MD = "CLAUDE.md";
+
+let content = fs.readFileSync(CLAUDE_MD, "utf-8");
+
+// Remove lines containing this agent from the <agents> table
+// Match: | ... | \`agent-PLUGIN_NAME...\` | ... |
+const pattern = new RegExp("^\\\\|.*\\\`agent-" + PLUGIN_NAME + "[^\\\`]*\\\`.*\\\\|$\\\\n?", "gm");
+const newContent = content.replace(pattern, "");
+
+if (newContent !== content) {
+  fs.writeFileSync(CLAUDE_MD, newContent);
+  console.log("Removed agent-" + PLUGIN_NAME + " from <agents> table");
+} else {
+  console.log("agent-" + PLUGIN_NAME + " not found in <agents> table");
+}
+EOF
+```
+
+## Full Command
+
+Run both scripts in sequence, then:
+```
+echo "Plugin uninstalled. Restart Claude Code: claude -c"
+```

package/.claude/hooks/interactive-mode.cjs

@@ -52,10 +52,11 @@ function processHook(data) {
     process.exit(0);
   }
 
-  const lowerPrompt = prompt.toLowerCase();
-
   // Detect task types that benefit from questions
+  // Order matters - more specific patterns first
   const taskPatterns = [
+    { pattern: /publish.*market|market.*publish|update.*market|market.*update|market.*icon|market.*listing/i, type: 'marketplace-publish', questions: ['New listing or update existing? (need productId for update)', 'Metadata only or new version with code?', 'Do you have an icon? (must upload with isPublic: true)'], skill: 'marketplace-publishing' },
+    { pattern: /publish|deploy|release|update.*app|app.*update|republish/i, type: 'app-publish', questions: ['Workspace only OR marketplace too?', 'Which app? (path or name)', 'Version bump needed?'], skill: 'publish-hailer-app' },
     { pattern: /build|create|make.*app/i, type: 'app', questions: ['What data to display?', 'What layout/components?', 'What user actions needed?'] },
     { pattern: /create|add.*insight|report/i, type: 'insight', questions: ['What metrics/aggregations?', 'Which workflows to query?', 'Any filters needed?'] },
     { pattern: /import|create.*activit|bulk/i, type: 'data', questions: ['Which workflow?', 'What field values?', 'How many records?'] },
@@ -66,6 +67,7 @@ function processHook(data) {
   const matched = taskPatterns.find(p => p.pattern.test(prompt));
 
   if (matched) {
+    const skillLine = matched.skill ? `\nLoad skill: ${matched.skill}` : '';
     const output = `
 <interactive-mode>
 BEFORE STARTING: Consider asking clarifying questions.
@@ -75,7 +77,7 @@ Suggested questions to ask user:
 ${matched.questions.map(q => `- ${q}`).join('\n')}
 
 Use AskUserQuestion tool if requirements are unclear.
-Gather specifics before spawning agents or making changes.
+Gather specifics before spawning agents or making changes.${skillLine}
 </interactive-mode>
 `;
     console.log(output);

package/.claude/skills/marketplace-publishing.md

@@ -0,0 +1,155 @@
+# Marketplace Publishing Skill
+
+<when-to-use>
+User wants to publish an app to marketplace, update marketplace listing, or change marketplace app icon/metadata.
+</when-to-use>
+
+<prerequisites>
+- `productId` - Marketplace product ID (24-char hex)
+- `appId` - The app being published (24-char hex)
+- User must be Network Admin of the workspace
+</prerequisites>
+
+<option-a>
+## Update Metadata Only (No Version Change)
+
+For updating icon, name, description without publishing new code:
+
+<step-1>
+**Upload icon as PUBLIC file**
+```javascript
+upload_files({
+  files: [{ path: "/path/to/icon.png", isPublic: true }]
+})
+```
+</step-1>
+
+<critical>
+`isPublic: true` is REQUIRED for marketplace icons to display!
+</critical>
+
+<step-2>
+**Update product metadata**
+```javascript
+publish_app({
+  appId: "<appId>",
+  productId: "<productId>",  // REQUIRED for update
+  title: "App Name",
+  description: "Description",
+  version: "1.0.0",          // Current version (no bump needed)
+  versionDescription: "Release notes",
+  publisher: "Publisher Name",
+  iconFileId: "<public-file-id>"
+})
+```
+</step-2>
+</option-a>
+
+<option-b>
+## Publish New Version (Code Changes)
+
+For publishing new app code with version bump:
+
+<step-1>
+**Upload icon as PUBLIC file (if changing)**
+```javascript
+upload_files({
+  files: [{ path: "/path/to/icon.png", isPublic: true }]
+})
+```
+</step-1>
+
+<step-2>
+**Update manifest.json**
+- Bump version (must be > current, e.g., "1.0.31" → "1.0.32")
+- Update versionDescription
+</step-2>
+
+<step-3>
+**Publish app bundle**
+```javascript
+publish_hailer_app({
+  projectDirectory: "/path/to/app",
+  publishToMarket: true
+})
+```
+</step-3>
+
+<step-4>
+**Update product metadata**
+```javascript
+publish_app({
+  appId: "<appId>",
+  productId: "<productId>",
+  title: "App Name",
+  description: "Description",
+  version: "1.0.32",
+  versionDescription: "What's new",
+  publisher: "Publisher Name",
+  iconFileId: "<public-file-id>"
+})
+```
+</step-4>
+</option-b>
+
+<option-c>
+## First-Time Marketplace Listing
+
+For apps not yet in marketplace:
+
+<step-1>
+**Upload icon as PUBLIC**
+```javascript
+upload_files({
+  files: [{ path: "/path/to/icon.png", isPublic: true }]
+})
+```
+</step-1>
+
+<step-2>
+**Publish app with marketplace flag**
+```javascript
+publish_hailer_app({
+  projectDirectory: "/path/to/app",
+  publishToMarket: true
+})
+```
+Returns a `targetId`.
+</step-2>
+
+<step-3>
+**Create marketplace listing**
+```javascript
+publish_app({
+  appId: "<appId>",
+  versionId: "<targetId>",   // From step 2
+  title: "App Name",
+  description: "Description",
+  version: "1.0.0",
+  versionDescription: "Initial release",
+  publisher: "Publisher Name",
+  iconFileId: "<public-file-id>"
+})
+```
+</step-3>
+
+<note>
+Creating new listings requires admin permissions.
+</note>
+</option-c>
+
+<common-errors>
+| Error | Cause | Fix |
+|-------|-------|-----|
+| Icon shows placeholder | File not public | Re-upload with `isPublic: true` |
+| "You have to be a network admin" | Missing permissions | Get admin access |
+| "Version not greater than previous" | Version too low | Bump version higher |
+| POST /app/publish fails | Needs file upload | Use `publish_hailer_app` for code changes |
+</common-errors>
+
+<api-reference>
+- `v3.product.update` - Updates metadata (name, description, icon, images)
+- `v3.product.create` - Creates new listing (admin only)
+- `POST /app/publish` - Uploads app bundle (requires .tgz file)
+- `v3.app.product.install` - Installs/updates in workspace
+</api-reference>