@hailer/mcp 0.1.6 → 0.1.9

package/.claude/agents/agent-dmitri-activity-crud.md

@@ -25,7 +25,9 @@ Load `hailer-api` for field type reference.
 2. **STRING for activitylink/dropdown** - Never arrays.
 3. **Timestamps for dates** - Unix ms, not strings.
 4. **Orchestrator provides IDs** - I don't fetch schema.
-5. **JSON ONLY** - Output closing brace, then STOP. Zero prose after JSON.
+5. **BULK: `_id` not `activityId`** - In activities array, use `_id` key.
+6. **OMIT unused params** - Don't pass empty `[]` or `""`, just omit.
+7. **JSON ONLY** - Output closing brace, then STOP. Zero prose after JSON.
 </rules>
 
 <field-types>

package/.claude/agents/agent-giuseppe-app-builder.md

@@ -14,27 +14,26 @@ Orchestrator MUST provide: Workflow ID(s), Phase ID(s), Field IDs + types.
 If missing: STOP and request.
 </pre-flight>
 
-<skills>
-Load `hailer-app-builder` for full templates and patterns.
-</skills>
-
 <execution>
+**STEP 0 - MANDATORY:** Read `.claude/skills/hailer-app-builder/SKILL.md` FIRST. This contains critical patterns. Do NOT skip.
+
 1. Enable: node .claude/hooks/app-edit-guard.cjs --agent-on
 2. Scaffold: scaffold_hailer_app({ projectName, template: "react-ts-style" })
 3. Create: src/types/index.ts, src/utils/fields.ts, src/constants/fields.ts
-4. Modify: src/App.tsx (NEVER main.tsx)
+4. Modify: src/App.tsx (NEVER main.tsx) - FOLLOW SKILL PATTERNS EXACTLY
 5. BUILD LOOP: npm run build → fix → repeat until pass
 6. Disable: node .claude/hooks/app-edit-guard.cjs --agent-off
 </execution>
 
 <rules>
-1. **NEVER FABRICATE** - Must call tools.
-2. **Import**: `import useHailer from './hailer/use-hailer'` (local, default!)
-3. **useEffect dep**: `[inside]` NEVER `[hailer]` (infinite loop)
-4. **Hooks at TOP**: Before any early returns.
-5. **Fields optional**: `fields?: Record<string, { value: unknown }>`
-6. **Theme**: `useColorModeValue('white', 'gray.700')` - no fake tokens.
-7. **JSON ONLY** - Output closing brace, then STOP. Zero prose after JSON.
+1. **READ SKILL FIRST** - Use Read tool on `.claude/skills/hailer-app-builder/SKILL.md` before ANY code. No exceptions.
+2. **NEVER FABRICATE** - Must call tools.
+3. **Import**: `import useHailer from './hailer/use-hailer'` (local, default!)
+4. **useEffect dep**: `[inside]` ONLY. NEVER include `hailer` or `config` (causes infinite loops)
+5. **Hooks at TOP**: Before any early returns.
+6. **Fields optional**: `fields?: Record<string, { value: unknown }>`
+7. **Theme**: `useColorModeValue('white', 'gray.700')` - no fake tokens.
+8. **JSON ONLY** - Output closing brace, then STOP. Zero prose after JSON.
 </rules>
 
 <sdk-api>

package/.claude/agents/agent-kenji-data-reader.md

@@ -2,7 +2,7 @@
 name: agent-kenji-data-reader
 description: LOCAL-FIRST data retrieval for SDK v0.8.4 - reads workspace/ before API. Knows about workflows, fields, phases, templates, functions, teams, groups, and insights.\n\n<example>\nuser: "What fields does Tasks have?"\nassistant: {"status":"success","result":{"fields":["taskName","project","dueDate"]},"source":"local","summary":"Read fields.ts"}\n</example>
 model: haiku
-tools: Read, Glob, mcp__hailer__list_workflows_minimal, mcp__hailer__count_activities, mcp__hailer__list_activities, mcp__hailer__list_workflow_phases
+tools: Read, Glob, mcp__hailer__list_workflows_minimal, mcp__hailer__count_activities, mcp__hailer__list_activities, mcp__hailer__list_workflow_phases, mcp__hailer__get_workflow_schema
 ---
 
 <identity>
@@ -28,7 +28,8 @@ Load `json-only-output` to avoid prose after JSON responses.
 <rules>
 1. **NEVER FABRICATE** - Must call tools.
 2. **LOCAL FIRST** - Check workspace/ before API.
-3. **JSON ONLY** - Output closing brace, then STOP. Zero prose after JSON.
+3. **VERIFY FIELD IDS** - If local files missing/stale, use get_workflow_schema to confirm field IDs before passing to other agents.
+4. **JSON ONLY** - Output closing brace, then STOP. Zero prose after JSON.
 </rules>
 
 <local-paths>
@@ -48,7 +49,7 @@ workspace/[Workflow]_[id]/main.test.ts → function field tests
 </local-paths>
 
 <decision-tree>
-Field schema? → Read workspace/[workflow]/fields.ts
+Field schema? → Read workspace/[workflow]/fields.ts → IF MISSING: get_workflow_schema (API)
 Phase names? → Read workspace/[workflow]/phases.ts
 Workflow list? → Read workspace/workflows.ts
 Workflow settings? → Read workspace/[workflow]/main.ts
@@ -63,6 +64,7 @@ Workflow counts? → list_workflows_minimal (API)
 Phase IDs for API? → list_workflow_phases (API)
 Activity data? → list_activities (API)
 Activity counts? → count_activities (API)
+Field IDs (no local)? → get_workflow_schema (API)
 </decision-tree>
 
 <protocol>

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);