@hailer/mcp 0.0.3 → 0.0.5

package/.claude/hooks/post-scaffold-hook.cjs

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+/**
+ * Claude Code PostToolUse Hook - Asks user about spawning app builder agent
+ *
+ * This hook triggers after scaffold_hailer_app completes successfully
+ * and ASKS the user if they want to spawn the app builder agent.
+ */
+
+const path = require('path');
+
+// Read hook input from stdin
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', chunk => input += chunk);
+process.stdin.on('end', () => {
+  try {
+    const data = JSON.parse(input);
+    processHook(data);
+  } catch {
+    // Invalid JSON, exit silently
+    process.exit(0);
+  }
+});
+
+function processHook(data) {
+  const { tool_name, tool_input, tool_output } = data;
+
+  // Only trigger for scaffold_hailer_app
+  if (tool_name !== 'mcp__hailer__scaffold_hailer_app') {
+    process.exit(0);
+  }
+
+  // Check if scaffold was successful (look for "Setup Complete" in output)
+  if (!tool_output || !tool_output.includes('Setup Complete')) {
+    process.exit(0);
+  }
+
+  // Extract project info from tool_input
+  const projectName = tool_input?.projectName || 'the app';
+  const description = tool_input?.description || 'Hailer data app';
+
+  // Try to determine project path
+  const cwd = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+  const projectPath = tool_input?.targetDirectory
+    ? path.join(tool_input.targetDirectory, projectName)
+    : path.join(cwd, projectName);
+
+  // Build the AskUserQuestion instruction
+  const output = `
+============================================================
+✅ App Scaffolded Successfully!
+============================================================
+
+**Project:** ${projectName}
+**Location:** ${projectPath}
+**Dev Server:** http://localhost:3000 (running)
+
+The app structure is ready. Now you need to build the actual components.
+
+----------------------------------------
+⚠️ MANDATORY: ASK THE USER
+----------------------------------------
+
+You MUST use AskUserQuestion with EXACTLY this format:
+
+\`\`\`json
+{
+  "questions": [
+    {
+      "question": "Would you like me to spawn a builder agent to create the app components?",
+      "header": "Build App",
+      "options": [
+        {
+          "label": "Yes, spawn builder",
+          "description": "Spawn isolated agent with TypeScript + SDK patterns"
+        },
+        {
+          "label": "No, I'll build manually",
+          "description": "Continue in current session"
+        }
+      ],
+      "multiSelect": false
+    }
+  ]
+}
+\`\`\`
+
+----------------------------------------
+IF USER SAYS YES: Follow these steps
+----------------------------------------
+
+1. Load the spawn-app-builder skill:
+   \`\`\`javascript
+   Skill("spawn-app-builder")
+   \`\`\`
+
+2. Get workflow context:
+   \`\`\`javascript
+   list_workflows_minimal()
+   \`\`\`
+
+3. Use the Task tool template from the skill with:
+   - PROJECT_PATH: ${projectPath}
+   - TASK_DESCRIPTION: ${description}
+   - WORKFLOWS_INFO: (from list_workflows_minimal)
+
+----------------------------------------
+IF USER SAYS NO: Load skills in current session
+----------------------------------------
+
+\`\`\`javascript
+Skill("building-hailer-apps-skill")
+Skill("hailer-app-builder")
+\`\`\`
+
+Then continue building in the current conversation.
+
+============================================================
+ASK THE USER NOW - Do not skip this question!
+============================================================
+`;
+
+  console.error(output);
+  process.exit(0);
+}

package/.claude/hooks/prompt-skill-loader.cjs

@@ -23,12 +23,19 @@ process.stdin.on('end', () => {
   try {
     const data = JSON.parse(input);
     processHook(data);
-  } catch (e) {
+  } catch {
     // Invalid JSON, exit silently
     process.exit(0);
   }
 });
 
+// Mapping from followUp types to skill file names
+const FOLLOW_UP_SKILLS = {
+  'build-app-flow': 'MCP-build-data-app-skill',
+  'spawn-builder-flow': 'spawn-app-builder',
+  'publish-template-flow': 'MCP-publish-template-skill'
+};
+
 // ALL keywords are now ambiguous - always ask for clarification
 const AMBIGUOUS_KEYWORDS = [
   // Pull operations
@@ -187,12 +194,63 @@ const AMBIGUOUS_KEYWORDS = [
       question: 'What would you like to do with Hailer apps?',
       options: [
         { label: 'Scaffold new app', description: 'Create a new app project from template', skill: 'MCP-scaffold-hailer-app-skill' },
+        { label: 'Build data app', description: 'Build app to visualize/manage workspace data', skill: 'MCP-scaffold-hailer-app-skill', followUp: 'build-app-flow' },
         { label: 'Create app entry', description: 'Register an app in Hailer (no scaffold)', skill: 'MCP-create-app-skill' },
         { label: 'List apps', description: 'View existing apps in workspace', skill: 'MCP-list-apps-skill' },
         { label: 'Update app', description: 'Modify app properties', skill: 'MCP-update-app-skill' }
       ]
     }
   },
+  // Build data app / visualize data operations
+  {
+    keyword: /\b(visualize|dashboard|data.?manager|manage.?data|data.?app)\b/i,
+    contextPatterns: [
+      /\b(build|create|make).*(visualize|dashboard|data)\b/i
+    ],
+    skill: 'MCP-scaffold-hailer-app-skill',
+    disambiguation: {
+      keyword: 'data app',
+      question: 'What kind of data app would you like to build?',
+      options: [
+        { label: 'Full data manager', description: 'Browse, edit, create across all workflows', skill: 'MCP-scaffold-hailer-app-skill', followUp: 'build-app-flow' },
+        { label: 'Dashboard overview', description: 'Cards/stats for workflows at a glance', skill: 'MCP-scaffold-hailer-app-skill', followUp: 'build-app-flow' },
+        { label: 'Specific workflow app', description: 'Focus on one or few workflows', skill: 'MCP-scaffold-hailer-app-skill', followUp: 'build-app-flow' }
+      ]
+    }
+  },
+  // Write app code / Code the app operations
+  {
+    keyword: /\b(code|write|implement|develop).{0,20}(app|component|feature)\b/i,
+    contextPatterns: [
+      /\b(start|begin).{0,10}(code|coding|writing|implementing)\b/i,
+      /\bwrite.{0,10}(code|component|feature)\b/i,
+      /\bcode.{0,10}(app|component)\b/i
+    ],
+    skill: 'spawn-app-builder',
+    disambiguation: {
+      keyword: 'code app',
+      question: 'What would you like to do?',
+      options: [
+        { label: 'Spawn app builder agent', description: 'Launch isolated agent with TypeScript + SDK skills embedded', skill: 'spawn-app-builder', followUp: 'spawn-builder-flow' },
+        { label: 'Load skills in current session', description: 'Load skills here instead of spawning new agent', skill: 'hailer-app-builder', loadMultiple: ['building-hailer-apps-skill', 'hailer-app-builder'] },
+        { label: 'Scaffold new app first', description: 'Create project structure then write code', skill: 'MCP-scaffold-hailer-app-skill' }
+      ]
+    }
+  },
+  // Continue app development / dev on app / work on app / build more / add features
+  {
+    keyword: /\b(dev|work|continue|build|add|improve|enhance|extend|modify|change|update|fix).{0,15}(on|the|to|for)?.{0,10}(app|component|dashboard|feature|ui|code)\b/i,
+    contextPatterns: [],  // Always require disambiguation for safety
+    skill: 'spawn-app-builder',
+    disambiguation: {
+      keyword: 'dev app',
+      question: 'How should I proceed with app development?',
+      options: [
+        { label: 'Spawn builder agent', description: 'RECOMMENDED: Isolated agent with TypeScript + SDK skills', skill: 'spawn-app-builder', followUp: 'spawn-builder-flow' },
+        { label: 'Load skills here', description: 'Continue in this conversation with skills loaded', skill: 'hailer-app-builder', loadMultiple: ['building-hailer-apps-skill', 'hailer-app-builder'] }
+      ]
+    }
+  },
   // Publish/Deploy operations
   {
     keyword: /\b(publish|deploy)\b/i,
@@ -205,10 +263,30 @@ const AMBIGUOUS_KEYWORDS = [
       question: 'What would you like to publish or deploy?',
       options: [
         { label: 'Publish Hailer app', description: 'Build and upload app to production', skill: 'MCP-publish-hailer-app-skill' },
+        { label: 'Publish workspace template', description: 'Share workspace config in marketplace', skill: 'MCP-publish-template-skill' },
         { label: 'Share app with users', description: 'Add members to access an app', skill: 'MCP-add-app-member-skill' }
       ]
     }
   },
+  // Template/Marketplace operations
+  {
+    keyword: /\b(template|marketplace)\b/i,
+    contextPatterns: [
+      /\b(publish|create|install|list).?template\b/i,
+      /\btemplate.?(publish|create|install|list)\b/i
+    ],
+    skill: 'MCP-publish-template-skill',
+    disambiguation: {
+      keyword: 'template',
+      question: 'What would you like to do with templates?',
+      options: [
+        { label: 'Publish template', description: 'Share workspace config in marketplace', skill: 'MCP-publish-template-skill', followUp: 'publish-template-flow' },
+        { label: 'Install template', description: 'Add template to workspace', skill: null },
+        { label: 'List templates', description: 'View available templates', skill: null },
+        { label: 'Get template details', description: 'View template info', skill: null }
+      ]
+    }
+  },
   // Function field / Calculated field operations
   {
     keyword: /\b(function.?field|calculated.?field|formula)\b/i,
@@ -311,8 +389,8 @@ const AMBIGUOUS_KEYWORDS = [
   }
 ];
 
-// No more direct keywords - all require disambiguation
-const DIRECT_KEYWORDS = [];
+// Note: DIRECT_KEYWORDS removed - all keywords now require disambiguation
+// Flow instructions are now loaded from skill files instead of inline functions
 
 function processHook(data) {
   const { prompt, cwd } = data;
@@ -334,6 +412,7 @@ function processHook(data) {
   const skillsToLoad = [];
   const disambiguationsNeeded = [];
   const seenDisambiguations = new Set(); // Avoid duplicate questions
+  const loadedFollowUpSkills = new Set(); // Avoid duplicate follow-up skill content
 
   // Check all ambiguous keywords
   for (const entry of AMBIGUOUS_KEYWORDS) {
@@ -406,6 +485,10 @@ function processHook(data) {
           output += `  - If "${opt.label}": Load Skill(${opt.skill}), then run with: yes | npm run workflows-sync\n`;
         } else if (opt.action === 'cancel') {
           output += `  - If "${opt.label}": Acknowledge cancellation, do NOT run any sync command\n`;
+        } else if (opt.followUp === 'publish-template-flow') {
+          output += `  - If "${opt.label}": Load Skill(${opt.skill}), then use EXACTLY this AskUserQuestion (see below)\n`;
+        } else if (opt.loadMultiple && Array.isArray(opt.loadMultiple)) {
+          output += `  - If "${opt.label}": Load BOTH skills in order: Skill(${opt.loadMultiple.join('), Skill(')}), then proceed\n`;
         } else if (opt.skill) {
           output += `  - If "${opt.label}": Load Skill(${opt.skill}), then proceed\n`;
         } else {
@@ -413,6 +496,24 @@ function processHook(data) {
         }
       }
       output += '\n';
+
+      // Add follow-up skill content (deduplicated - each skill only included once)
+      for (const opt of disamb.options) {
+        if (opt.followUp && !loadedFollowUpSkills.has(opt.followUp)) {
+          const skillName = FOLLOW_UP_SKILLS[opt.followUp];
+          if (skillName) {
+            const skillPath = path.join(projectDir, '.claude', 'skills', skillName, 'SKILL.md');
+            if (fs.existsSync(skillPath)) {
+              loadedFollowUpSkills.add(opt.followUp);
+              output += '\n' + '-'.repeat(40) + '\n';
+              output += `📚 FOLLOW-UP SKILL: ${skillName}\n`;
+              output += '-'.repeat(40) + '\n';
+              output += fs.readFileSync(skillPath, 'utf8');
+              output += '\n';
+            }
+          }
+        }
+      }
     }
 
     output += '='.repeat(60) + '\n';
@@ -445,8 +546,8 @@ function processHook(data) {
     output += '='.repeat(60) + '\n';
   }
 
-  // Output to stdout - UserPromptSubmit hooks add stdout to context
-  console.log(output);
+  // Output to stderr - displays to user
+  console.error(output);
 
   process.exit(0);
 }

package/.claude/hooks/publish-template-guard.cjs

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+/**
+ * Claude Code PreToolUse Hook - Ensures all required fields before publish_template
+ *
+ * This hook intercepts publish_template calls and blocks them if required fields
+ * are missing, prompting Claude to gather all information first.
+ *
+ * Required fields from Hailer UI:
+ * - title (Name) - max 64 chars
+ * - description - max 4096 chars
+ * - version - e.g. "1.0.0"
+ * - versionDescription - release notes
+ * - publisher - publishing company name
+ * - iconFileId - uploaded icon (JPEG/PNG)
+ * - imageFileIds - preview images array (optional but recommended)
+ */
+
+// Read hook input from stdin
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', chunk => input += chunk);
+process.stdin.on('end', () => {
+  try {
+    const data = JSON.parse(input);
+    processHook(data);
+  } catch {
+    // Invalid JSON, allow the call
+    console.log(JSON.stringify({ decision: 'allow' }));
+    process.exit(0);
+  }
+});
+
+function processHook(data) {
+  const { tool_name, tool_input } = data;
+
+  // Only intercept publish_template (MCP tool name format)
+  if (!tool_name || !tool_name.includes('publish_template')) {
+    console.log(JSON.stringify({ decision: 'allow' }));
+    process.exit(0);
+  }
+
+  // Parse tool input
+  let args = {};
+  try {
+    if (typeof tool_input === 'string') {
+      args = JSON.parse(tool_input);
+    } else if (typeof tool_input === 'object') {
+      args = tool_input;
+    }
+  } catch {
+    // Can't parse, let it through
+    console.log(JSON.stringify({ decision: 'allow' }));
+    process.exit(0);
+  }
+
+  // Check for missing required fields
+  const missing = [];
+  if (!args.title) missing.push('title (Name, max 64 chars)');
+  if (!args.description) missing.push('description (max 4096 chars)');
+  if (!args.version) missing.push('version (e.g. "1.0.0")');
+  if (!args.versionDescription) missing.push('versionDescription (release notes)');
+  if (!args.publisher) missing.push('publisher (company name)');
+  if (!args.iconFileId) missing.push('iconFileId (upload icon first)');
+
+  if (missing.length > 0) {
+    console.log(JSON.stringify({
+      decision: 'block',
+      message: `BLOCKED: publish_template is missing required fields.
+
+Missing: ${missing.join(', ')}
+
+Before calling publish_template, you MUST gather ALL information from the user.
+
+Use AskUserQuestion with these questions:
+
+\`\`\`json
+{
+  "questions": [
+    {
+      "question": "What should be the template name? (max 64 characters)",
+      "header": "Name",
+      "options": [
+        { "label": "Enter name", "description": "Type a descriptive template name" },
+        { "label": "Use workspace name", "description": "Use current workspace name as template name" }
+      ],
+      "multiSelect": false
+    }
+  ]
+}
+\`\`\`
+
+Then ask for:
+1. **Name** (title) - Template display name (max 64 chars)
+2. **Description** - What this template includes (max 4096 chars)
+3. **Version** - Semantic version like "1.0.0"
+4. **Version description** - Release notes for this version
+5. **Publisher** - Company or person publishing this template
+6. **Icon** - Ask how to provide icon (URL, file path, or existing fileId)
+
+After gathering info:
+1. Upload icon with isPublic: true (CRITICAL!):
+   upload_files({ files: [{ path: "...", isPublic: true }] })
+2. Then call publish_template with ALL fields:
+
+publish_template({
+  title: "Template Name",
+  description: "What it does...",
+  version: "1.0.0",
+  versionDescription: "Initial release with...",
+  publisher: "Company Name",
+  iconFileId: "<24-char-id>",
+  imageFileIds: ["<24-char-id>"]  // Optional: preview images
+})
+
+DO NOT call publish_template until you have ALL required information.`
+    }));
+    process.exit(0);
+  }
+
+  // All required fields provided, allow the call
+  console.log(JSON.stringify({ decision: 'allow' }));
+  process.exit(0);
+}

package/.claude/hooks/skill-loader.cjs

@@ -24,7 +24,7 @@ process.stdin.on('end', () => {
   try {
     const data = JSON.parse(input);
     processHook(data);
-  } catch (e) {
+  } catch {
     // Invalid JSON, exit silently
     process.exit(0);
   }

package/.claude/settings.json

@@ -30,6 +30,28 @@
             "timeout": 5
           }
         ]
+      },
+      {
+        "matcher": "mcp__hailer__publish_template",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/publish-template-guard.cjs\"",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "mcp__hailer__scaffold_hailer_app",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/post-scaffold-hook.cjs\"",
+            "timeout": 5
+          }
+        ]
       }
     ]
   }