@hailer/mcp 1.0.28 → 1.1.2

package/.claude/hooks/design-system-lint.cjs

@@ -0,0 +1,283 @@
+#!/usr/bin/env node
+/**
+ * <hook-name>design-system-lint</hook-name>
+ *
+ * <purpose>
+ * Warns if app code doesn't follow Hailer Design System patterns.
+ * Runs after Giuseppe writes/edits files in app directories.
+ * </purpose>
+ *
+ * <triggers>
+ * - PostToolUse on Write and Edit
+ * - Only for files in apps/ or containing Chakra imports
+ * </triggers>
+ *
+ * <checks>
+ * - Hardcoded colors (hex, rgb, hsl)
+ * - External icon libraries (react-icons, heroicons, etc.)
+ * - Plain HTML table elements instead of Chakra Table
+ * - Missing theme import when using ChakraProvider
+ * </checks>
+ *
+ * <behavior>
+ * 1. Check if file is in app directory or has Chakra imports
+ * 2. Scan content for violations
+ * 3. Output warnings to stderr (non-blocking)
+ * </behavior>
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Skip in yolo mode
+try {
+  const statePath = path.join(process.env.CLAUDE_PROJECT_DIR || process.cwd(), '.claude', 'yolo-state.json');
+  const state = JSON.parse(fs.readFileSync(statePath, 'utf8'));
+  if (state.mode === 'yolo') process.exit(0);
+} catch (e) {
+  // ENOENT is expected when not in yolo mode - only warn on unexpected errors
+  if (e.code !== 'ENOENT' && !e.message.includes('Unexpected')) {
+    console.error(`[design-system-lint] Warning: ${e.message}`);
+  }
+}
+
+// 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 (e) {
+    console.error(`[design-system-lint] Warning: ${e.message}`);
+    process.exit(0);
+  }
+});
+
+// Design system violation patterns
+const VIOLATIONS = [
+  {
+    name: 'hardcoded-hex-color',
+    pattern: /(?:color|bg|background|border|fill|stroke)[:=]\s*(?:["'`]#[0-9a-fA-F]{3,8}["'`]|\$\{[^}]*#[0-9a-fA-F]{3,8}[^}]*\})/g,
+    message: 'Hardcoded hex color found',
+    suggestion: 'Use Chakra color tokens (e.g., "gray.500", "green.400") or semantic tokens ("subtleText", "bodyText")'
+  },
+  {
+    name: 'hardcoded-rgb-color',
+    pattern: /(?:color|bg|background|border)[:=]\s*(?:["'`]rgba?\([^)]+\)["'`]|\$\{[^}]*rgba?\([^)]+\)[^}]*\})/g,
+    message: 'Hardcoded RGB/RGBA color found',
+    suggestion: 'Use Chakra color tokens instead'
+  },
+  {
+    name: 'external-icons',
+    pattern: /import\s+.*\s+from\s+["'](react-icons|@heroicons|@fortawesome|lucide-react|@tabler\/icons)/g,
+    message: 'External icon library imported',
+    suggestion: 'Use Hailer icons from design-system/theme/icons (e.g., HailerPlus, HailerSettings)'
+  },
+  {
+    name: 'plain-html-table',
+    pattern: /<(table|thead|tbody|tr|th|td)[\s>]/gi,
+    message: 'Plain HTML table elements found',
+    suggestion: 'Use Chakra UI Table components: <Table>, <Thead>, <Tbody>, <Tr>, <Th>, <Td>'
+  },
+  {
+    name: 'missing-theme-import',
+    pattern: /ChakraProvider/,
+    message: 'ChakraProvider without theme prop',
+    suggestion: 'Import and pass the Hailer theme: <ChakraProvider theme={theme}>'
+  },
+  {
+    name: 'inline-style',
+    pattern: /style\s*=\s*\{\s*\{[^}]*(?:color|background|border)[^}]*\}\s*\}/g,
+    message: 'Inline style with color/background',
+    suggestion: 'Use Chakra style props instead of inline styles'
+  },
+  {
+    name: 'wrong-stat-pattern',
+    pattern: /<Box[^>]*>[\s\S]*?<Text[^>]*fontSize=["']sm["'][^>]*>[\s\S]*?<\/Text>[\s\S]*?<(?:Heading|Text)[^>]*fontSize=["'](?:2xl|3xl|xl)["']/g,
+    message: 'Manual stat card pattern detected',
+    suggestion: 'Use Chakra Stat components: <Stat>, <StatLabel>, <StatNumber>, <StatHelpText>'
+  }
+];
+
+// Files/patterns to skip
+const SKIP_PATTERNS = [
+  /node_modules/,
+  /\.d\.ts$/,
+  /\.json$/,
+  /\.md$/,
+  /\.css$/,
+  /theme\.ts$/,  // Don't lint the theme file itself
+  /customColors\.ts$/
+];
+
+function shouldLintFile(filePath) {
+  // Skip certain files
+  for (const pattern of SKIP_PATTERNS) {
+    if (pattern.test(filePath)) {
+      return false;
+    }
+  }
+
+  // Check if it's in apps/ directory
+  if (filePath.includes('/apps/') || filePath.includes('\\apps\\')) {
+    return true;
+  }
+
+  // Check if it's a TypeScript/JavaScript file that might be an app
+  if (/\.(tsx?|jsx?)$/.test(filePath)) {
+    return true;
+  }
+
+  return false;
+}
+
+function lintContent(content, filePath) {
+  const warnings = [];
+
+  // Only lint if file has Chakra imports (indicates it's a UI file)
+  const hasChakraImport = content.includes('@chakra-ui/react') || content.includes('chakra-ui');
+  const isInApps = filePath.includes('/apps/') || filePath.includes('\\apps\\');
+
+  if (!hasChakraImport && !isInApps) {
+    return warnings;
+  }
+
+  // Single-pass scan: loop through violations once, check content for each pattern
+  // Performance: O(n*m) where n=violations, m=pattern matches. Acceptable for typical files (<50KB)
+  for (const violation of VIOLATIONS) {
+    const matches = content.match(violation.pattern);
+    if (matches) {
+      // Special handling for missing-theme-import
+      if (violation.name === 'missing-theme-import') {
+        // Only warn if ChakraProvider exists but no theme= prop nearby
+        if (content.includes('ChakraProvider') && !content.includes('theme={') && !content.includes('theme=')) {
+          warnings.push({
+            name: violation.name,
+            message: violation.message,
+            suggestion: violation.suggestion,
+            count: 1
+          });
+        }
+        continue;
+      }
+
+      warnings.push({
+        name: violation.name,
+        message: violation.message,
+        suggestion: violation.suggestion,
+        count: matches.length,
+        examples: matches.slice(0, 2).map(m => m.substring(0, 60))
+      });
+    }
+  }
+
+  return warnings;
+}
+
+function processHook(data) {
+  const { tool_name, tool_input, tool_response } = data;
+
+  // Only check Write and Edit tools on PostToolUse
+  if (tool_name !== 'Write' && tool_name !== 'Edit') {
+    process.exit(0);
+  }
+
+  // Need tool_response to confirm it's PostToolUse
+  if (tool_response === undefined) {
+    process.exit(0);
+  }
+
+  const filePath = tool_input?.file_path;
+  if (!filePath) {
+    process.exit(0);
+  }
+
+  // Check if we should lint this file
+  if (!shouldLintFile(filePath)) {
+    process.exit(0);
+  }
+
+  // Read the file content
+  let content;
+  try {
+    content = fs.readFileSync(filePath, 'utf8');
+  } catch (e) {
+    console.error(`[design-system-lint] Warning: ${e.message}`);
+    process.exit(0);
+  }
+
+  // Lint the content
+  const warnings = lintContent(content, filePath);
+
+  if (warnings.length > 0) {
+    const output = `
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎨 DESIGN SYSTEM LINT WARNINGS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+File: ${path.basename(filePath)}
+
+${warnings.map(w => `
+⚠️  ${w.message}${w.count > 1 ? ` (${w.count} occurrences)` : ''}
+   → ${w.suggestion}
+${w.examples ? w.examples.map(e => `   Example: ${e}...`).join('\n') : ''}`).join('\n')}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📚 Reference: Load \`hailer-design-system\` skill for full guide
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+`;
+    console.error(output);
+  }
+
+  process.exit(0);
+}
+
+// CLI: Lint a specific file
+if (process.argv[2] && !process.argv[2].startsWith('-')) {
+  const filePath = path.resolve(process.argv[2]);
+
+  if (!fs.existsSync(filePath)) {
+    console.error(`File not found: ${filePath}`);
+    process.exit(1);
+  }
+
+  const content = fs.readFileSync(filePath, 'utf8');
+  const warnings = lintContent(content, filePath);
+
+  if (warnings.length === 0) {
+    console.log(`✅ No design system issues found in ${path.basename(filePath)}`);
+  } else {
+    console.log(`Found ${warnings.length} issue(s) in ${path.basename(filePath)}:\n`);
+    for (const w of warnings) {
+      console.log(`⚠️  ${w.message}${w.count > 1 ? ` (${w.count}x)` : ''}`);
+      console.log(`   → ${w.suggestion}\n`);
+    }
+  }
+  process.exit(0);
+}
+
+// CLI: Help
+if (process.argv[2] === '--help' || process.argv[2] === '-h') {
+  console.log(`
+Design System Lint - Checks app code for Hailer Design System compliance
+
+Usage:
+  node design-system-lint.cjs <file>    Lint a specific file
+  node design-system-lint.cjs --help    Show this help
+
+Checks for:
+  - Hardcoded colors (hex, rgb, rgba)
+  - External icon libraries
+  - Plain HTML table elements
+  - Missing theme in ChakraProvider
+  - Inline styles with colors
+  - Manual stat card patterns
+
+As a hook:
+  PostToolUse on Write/Edit
+  Outputs warnings to stderr (non-blocking)
+`);
+  process.exit(0);
+}

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

@@ -29,9 +29,17 @@
 
 const path = require('path');
 const fs = require('fs');
-const { execSync } = require('child_process');
+const os = require('os');
 
-const TRACKER_DIR = '/tmp/.claude-scaffolded-apps';
+// Skip in yolo mode
+try {
+  const statePath = path.join(process.env.CLAUDE_PROJECT_DIR || process.cwd(), '.claude', 'yolo-state.json');
+  const state = JSON.parse(fs.readFileSync(statePath, 'utf8'));
+  if (state.mode === 'yolo') process.exit(0);
+} catch {}
+
+const TEMP_DIR = os.tmpdir();
+const TRACKER_DIR = path.join(TEMP_DIR, '.claude-scaffolded-apps');
 
 // Ensure tracker directory exists
 if (!fs.existsSync(TRACKER_DIR)) {
@@ -122,6 +130,11 @@ You MUST use AskUserQuestion with EXACTLY this format:
 IF USER SAYS YES: Follow these steps
 ----------------------------------------
 
+0. Enable builder mode (required for Giuseppe to edit app files):
+   \`\`\`bash
+   node .claude/hooks/app-edit-guard.cjs --agent-on
+   \`\`\`
+
 1. Load the spawn-app-builder skill:
    \`\`\`javascript
    Skill("spawn-app-builder")
@@ -153,7 +166,7 @@ ASK THE USER NOW - Do not skip this question!
 ============================================================
 `;
 
-  console.error(output);
+  console.log(JSON.stringify({ decision: 'allow', message: output }));
   process.exit(0);
 }
 

package/.claude/hooks/prompt-guard.cjs

@@ -0,0 +1,366 @@
+#!/usr/bin/env node
+/**
+ * <hook-name>prompt-guard</hook-name>
+ *
+ * <purpose>
+ * Consolidated UserPromptSubmit hook. Replaces 4 separate hooks:
+ * - session-structure-check (project structure + auto-update hooks)
+ * - interactive-mode (suggest clarifying questions)
+ * - sync-marketplace-agents (update CLAUDE.md with marketplace agents)
+ * - git-hooks-check (notify about missing pre-commit hook)
+ *
+ * Single Node process instead of 4 = faster, no timeouts.
+ * </purpose>
+ *
+ * <triggers>UserPromptSubmit</triggers>
+ * @version 1.0.0
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const ALLOW = JSON.stringify({ decision: 'allow' });
+const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+
+// --- Yolo mode check ---
+let isYolo = false;
+try {
+  const statePath = path.join(projectDir, '.claude', 'yolo-state.json');
+  const state = JSON.parse(fs.readFileSync(statePath, 'utf8'));
+  isYolo = state.mode === 'yolo';
+} catch {}
+
+// Skip if stdin is TTY (no piped input)
+if (process.stdin.isTTY) {
+  console.log(ALLOW);
+  process.exit(0);
+}
+
+// --- Read 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 (e) {
+    console.error('[prompt-guard] CRASH:', e.message, e.stack);
+    console.log(ALLOW);
+    process.exit(0);
+  }
+});
+
+function processHook(data) {
+  const messages = [];
+
+  // 1. Session structure check (once per session)
+  try {
+    const structureMsg = checkSessionStructure();
+    if (structureMsg) messages.push(structureMsg);
+  } catch (e) {
+    console.error('[prompt-guard] checkSessionStructure crashed:', e.message);
+  }
+
+  // 2. Interactive mode (every message, skipped in yolo)
+  try {
+    if (!isYolo) {
+      const interactiveMsg = checkInteractiveMode(data.prompt);
+      if (interactiveMsg) messages.push(interactiveMsg);
+    }
+  } catch (e) {
+    console.error('[prompt-guard] checkInteractiveMode crashed:', e.message);
+  }
+
+  // 3. Sync marketplace agents (only when plugins changed)
+  try { syncMarketplaceAgents(); } catch (e) {
+    console.error('[prompt-guard] Marketplace sync crashed:', e.message);
+  }
+
+  // 4. Git hooks check (once per session, skipped in yolo)
+  try {
+    if (!isYolo) {
+      const gitMsg = checkGitHooks();
+      if (gitMsg) console.error(gitMsg);
+    }
+  } catch (e) {
+    console.error('[prompt-guard] checkGitHooks crashed:', e.message);
+  }
+
+  // Output
+  if (messages.length > 0) {
+    console.log(JSON.stringify({
+      decision: 'allow',
+      message: messages.join('\n')
+    }));
+  } else {
+    console.log(ALLOW);
+  }
+  process.exit(0);
+}
+
+// ============================================================
+// 1. Session Structure Check (from session-structure-check.cjs)
+// ============================================================
+function checkSessionStructure() {
+  // Find project root
+  let projectRoot = projectDir;
+  while (projectRoot !== '/' && !fs.existsSync(path.join(projectRoot, '.claude'))) {
+    projectRoot = path.dirname(projectRoot);
+  }
+
+  // Session marker - only run once
+  const markerPath = path.join(projectRoot, '.claude', '.session-checked');
+  if (fs.existsSync(markerPath)) return null;
+
+  try { fs.writeFileSync(markerPath, new Date().toISOString()); } catch {}
+
+  const reminders = [];
+
+  const handoffPath = path.join(projectRoot, 'SESSION-HANDOFF.md');
+  const developmentMdPath = path.join(projectRoot, 'DEVELOPMENT.md');
+  const workspacePath = path.join(projectRoot, 'workspace');
+
+  if (fs.existsSync(handoffPath)) {
+    reminders.push('SESSION-HANDOFF.md found - read it to resume previous work, then update it.');
+  }
+  if (!fs.existsSync(developmentMdPath) && fs.existsSync(workspacePath)) {
+    reminders.push('No DEVELOPMENT.md found. Consider creating one to track project status.');
+  }
+
+  // Hooks are now project-local via $CLAUDE_PROJECT_DIR in settings.json
+  // No auto-update needed
+
+  if (reminders.length > 0) {
+    return '<session-start>\n' + reminders.join('\n') + '\n</session-start>';
+  }
+  return null;
+}
+
+// ============================================================
+// 2. Interactive Mode (from interactive-mode.cjs)
+// ============================================================
+function checkInteractiveMode(prompt) {
+  if (!prompt) return null;
+
+  const taskPatterns = [
+    { pattern: /(add|create).*(field|workflow|phase)/i, type: 'schema', questions: ['Field type?', 'Required or optional?', 'Default values?'] },
+    { pattern: /(build|create|make).*(app|dashboard|portal|ui)/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|record)|bulk/i, type: 'data', questions: ['Which workflow?', 'What field values?', 'How many records?'] },
+    { pattern: /(update|change|modify).*(activit|record|field|data)/i, type: 'update', questions: ['Which records affected?', 'What new values?', 'Confirm before applying?'] },
+  ];
+
+  // Feature implementation detection
+  const isFeatureRequest = /implement|build.*feature|add.*feature|new feature/i.test(prompt);
+  const planMarkers = (prompt.match(/step\s*\d|phase\s*\d|##|requirement|trigger|action/gi) || []).length;
+  const hasDetailedPlan = prompt.length > 500 || planMarkers >= 2;
+
+  if (isFeatureRequest && hasDetailedPlan) {
+    return `<interactive-mode>
+FEATURE IMPLEMENTATION DETECTED with detailed plan.
+
+Before implementing, ask: "Want me to create a PRD first?"
+- PRDs track requirements in docs/prd-*.md
+- Links to DEVELOPMENT.md roadmap
+- Skip only if user explicitly declines
+
+Use AskUserQuestion to offer PRD creation.
+</interactive-mode>`;
+  }
+
+  const matched = taskPatterns.find(p => p.pattern.test(prompt));
+  if (matched) {
+    return `<interactive-mode>
+BEFORE STARTING: Consider asking clarifying questions.
+
+Task type detected: ${matched.type}
+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.
+</interactive-mode>`;
+  }
+
+  return null;
+}
+
+// ============================================================
+// 3. Sync Marketplace Agents (from sync-marketplace-agents.cjs)
+// ============================================================
+function syncMarketplaceAgents() {
+  const crypto = require('crypto');
+
+  const PLUGINS_DIR = path.join(os.homedir(), '.claude', 'plugins', 'marketplaces');
+  const INSTALLED_PLUGINS = path.join(os.homedir(), '.claude', 'plugins', 'installed_plugins.json');
+  const CLAUDE_MD = path.join(projectDir, 'CLAUDE.md');
+  const SYNC_STATE_DIR = path.join(os.homedir(), '.claude', 'sync-state');
+  const PROJECT_HASH = crypto.createHash('md5').update(projectDir).digest('hex').slice(0, 12);
+  const SYNC_STATE = path.join(SYNC_STATE_DIR, `${PROJECT_HASH}.state`);
+
+  function getInstalledPluginsHash() {
+    if (!fs.existsSync(INSTALLED_PLUGINS)) return 'empty';
+    return crypto.createHash('md5').update(fs.readFileSync(INSTALLED_PLUGINS, 'utf-8')).digest('hex');
+  }
+
+  // Check if plugins changed
+  const currentHash = getInstalledPluginsHash();
+  try {
+    if (fs.existsSync(SYNC_STATE) && fs.readFileSync(SYNC_STATE, 'utf-8').trim() === currentHash) {
+      return; // No change
+    }
+  } catch {}
+
+  try {
+    const installedPlugins = getInstalledPlugins(INSTALLED_PLUGINS);
+    const agents = scanMarketplaceAgents(PLUGINS_DIR, installedPlugins);
+    updateClaudeMd(CLAUDE_MD, agents);
+
+    // Save sync state
+    fs.mkdirSync(SYNC_STATE_DIR, { recursive: true });
+    fs.writeFileSync(SYNC_STATE, currentHash);
+    console.error(`[prompt-guard] Detected plugin changes, found ${agents.length} marketplace agents`);
+  } catch (e) {
+    console.error(`[prompt-guard] Sync agents warning: ${e.message}`);
+  }
+}
+
+function getInstalledPlugins(installedPluginsPath) {
+  const plugins = new Set();
+  if (!fs.existsSync(installedPluginsPath)) return plugins;
+  try {
+    const data = JSON.parse(fs.readFileSync(installedPluginsPath, 'utf-8'));
+    if (data.plugins) for (const key of Object.keys(data.plugins)) plugins.add(key);
+  } catch {}
+  return plugins;
+}
+
+function scanMarketplaceAgents(pluginsDir, enabledPlugins) {
+  const agents = [];
+  if (!fs.existsSync(pluginsDir)) return agents;
+
+  for (const marketplace of fs.readdirSync(pluginsDir)) {
+    const marketplacePath = path.join(pluginsDir, marketplace);
+    if (!fs.statSync(marketplacePath).isDirectory()) continue;
+
+    // Flat structure: {marketplace}/agents/
+    const flatAgentsPath = path.join(marketplacePath, 'agents');
+    if (fs.existsSync(flatAgentsPath)) {
+      const pluginKey = `${marketplace}@${marketplace}`;
+      if (enabledPlugins.has(pluginKey)) {
+        for (const f of fs.readdirSync(flatAgentsPath).filter(f => f.endsWith('.md'))) {
+          const content = fs.readFileSync(path.join(flatAgentsPath, f), 'utf-8');
+          const fm = parseFrontmatter(content);
+          agents.push({ marketplace, plugin: marketplace, name: path.basename(f, '.md'), fullName: `${marketplace}:${path.basename(f, '.md')}`, description: fm.description || '', model: fm.model || 'sonnet' });
+        }
+      }
+    }
+
+    // Root-level plugins: {marketplace}/{plugin}/agents/
+    for (const item of fs.readdirSync(marketplacePath)) {
+      if (item === '.claude-plugin' || item === '.git' || item === 'plugins') continue;
+      const itemPath = path.join(marketplacePath, item);
+      if (!fs.statSync(itemPath).isDirectory()) continue;
+      if (!fs.existsSync(path.join(itemPath, '.claude-plugin', 'plugin.json'))) continue;
+      if (!enabledPlugins.has(`${item}@${marketplace}`)) continue;
+      const agentsPath = path.join(itemPath, 'agents');
+      if (!fs.existsSync(agentsPath)) continue;
+      for (const f of fs.readdirSync(agentsPath).filter(f => f.endsWith('.md'))) {
+        const content = fs.readFileSync(path.join(agentsPath, f), 'utf-8');
+        const fm = parseFrontmatter(content);
+        agents.push({ marketplace, plugin: item, name: path.basename(f, '.md'), fullName: `${item}:${path.basename(f, '.md')}`, description: fm.description || '', model: fm.model || 'sonnet' });
+      }
+    }
+
+    // Nested: {marketplace}/plugins/{plugin}/agents/
+    const nestedPath = path.join(marketplacePath, 'plugins');
+    if (fs.existsSync(nestedPath)) {
+      for (const plugin of fs.readdirSync(nestedPath)) {
+        if (!enabledPlugins.has(`${plugin}@${marketplace}`)) continue;
+        const pluginPath = path.join(nestedPath, plugin);
+        if (!fs.statSync(pluginPath).isDirectory()) continue;
+        const agentsPath = path.join(pluginPath, 'agents');
+        if (!fs.existsSync(agentsPath)) continue;
+        for (const f of fs.readdirSync(agentsPath).filter(f => f.endsWith('.md'))) {
+          const content = fs.readFileSync(path.join(agentsPath, f), 'utf-8');
+          const fm = parseFrontmatter(content);
+          agents.push({ marketplace, plugin, name: path.basename(f, '.md'), fullName: `${plugin}:${path.basename(f, '.md')}`, description: fm.description || '', model: fm.model || 'sonnet' });
+        }
+      }
+    }
+  }
+  return agents;
+}
+
+function parseFrontmatter(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!match) return {};
+  const fm = {};
+  for (const line of match[1].split('\n')) {
+    const i = line.indexOf(':');
+    if (i <= 0 || line.startsWith(' ') || line.startsWith('\t')) continue;
+    const key = line.slice(0, i).trim();
+    let value = line.slice(i + 1).trim();
+    if (key === 'description') value = value.replace(/\\n.*/g, '').slice(0, 100);
+    fm[key] = value;
+  }
+  return fm;
+}
+
+function updateClaudeMd(claudeMdPath, agents) {
+  if (!fs.existsSync(claudeMdPath)) return;
+  let content = fs.readFileSync(claudeMdPath, 'utf-8');
+
+  let table = agents.length === 0 ? 'No marketplace agents installed.' :
+    '| Agent | Plugin | Model | Description |\n|-------|--------|-------|-------------|\n' +
+    agents.map(a => `| \`${a.fullName}\` | ${a.plugin} | ${a.model} | ${a.description.slice(0, 50)}${a.description.length > 50 ? '...' : ''} |`).join('\n');
+
+  const sectionStart = content.indexOf('<config-source>');
+  const sectionEnd = content.indexOf('</config-source>');
+  if (sectionStart === -1 || sectionEnd === -1) return;
+
+  const tableStart = content.indexOf('| Agent |', sectionStart);
+  const noAgents = content.indexOf('No marketplace agents installed.', sectionStart);
+
+  let replaceStart, replaceEnd;
+  if (tableStart !== -1 && tableStart < sectionEnd) { replaceStart = tableStart; replaceEnd = sectionEnd; }
+  else if (noAgents !== -1 && noAgents < sectionEnd) { replaceStart = noAgents; replaceEnd = noAgents + 'No marketplace agents installed.'.length; }
+  else { replaceStart = content.indexOf('\n', sectionStart) + 1; replaceEnd = replaceStart; }
+
+  content = content.substring(0, replaceStart) + table + '\n\n' + content.substring(replaceEnd);
+  fs.writeFileSync(claudeMdPath, content);
+}
+
+// ============================================================
+// 4. Git Hooks Check (from git-hooks-check.cjs)
+// ============================================================
+function checkGitHooks() {
+  const SESSION_FILE = path.join(os.tmpdir(), '.claude-git-hooks-checked');
+  const SESSION_TTL = 3600000;
+
+  try {
+    if (fs.existsSync(SESSION_FILE)) {
+      const data = JSON.parse(fs.readFileSync(SESSION_FILE, 'utf8'));
+      if (data.projectDir === projectDir && (Date.now() - data.checkedAt) < SESSION_TTL) return null;
+    }
+  } catch {}
+
+  fs.writeFileSync(SESSION_FILE, JSON.stringify({ projectDir, checkedAt: Date.now() }));
+
+  const gitDir = path.join(projectDir, '.git');
+  if (!fs.existsSync(gitDir)) return null;
+
+  const hookSource = path.join(projectDir, '.claude', 'hooks', 'pre-commit-test.sh');
+  if (!fs.existsSync(hookSource)) return null;
+
+  const preCommitHook = path.join(gitDir, 'hooks', 'pre-commit');
+  if (fs.existsSync(preCommitHook)) return null;
+
+  return `
+Git pre-commit hook not installed.
+Install: ln -sf ../../.claude/hooks/pre-commit-test.sh .git/hooks/pre-commit
+`;
+}
+