@hailer/mcp 1.1.12 → 1.1.14

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

@@ -1,140 +0,0 @@
-#!/usr/bin/env node
-/**
- * <hook-name>skill-injector</hook-name>
- * <purpose>Auto-injects skill content into subagent context via SubagentStart</purpose>
- * <triggers>SubagentStart</triggers>
- *
- * Problem: Agents have skills listed in frontmatter but never actually call
- * the Skill tool. This hook reads the agent's frontmatter `skills:` list
- * and injects skill content via additionalContext when the subagent starts.
- *
- * Uses SubagentStart hook event with additionalContext (not PreToolUse updatedInput).
- *
- * Hook type: SubagentStart
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
-const AGENTS_DIR = path.join(PROJECT_DIR, '.claude', 'agents');
-const SKILLS_DIR = path.join(PROJECT_DIR, '.claude', 'skills');
-
-// Skip if stdin is TTY
-if (process.stdin.isTTY) {
-  console.log(JSON.stringify({}));
-  process.exit(0);
-}
-
-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(`[skill-injector] Parse error: ${e.message}`);
-    console.log(JSON.stringify({}));
-    process.exit(0);
-  }
-});
-
-/**
- * Parse skills: list from agent frontmatter
- */
-function getAgentSkills(agentType) {
-  const agentFile = path.join(AGENTS_DIR, `${agentType}.md`);
-  if (!fs.existsSync(agentFile)) {
-    return [];
-  }
-
-  try {
-    const content = fs.readFileSync(agentFile, 'utf8');
-    const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
-    if (!fmMatch) return [];
-
-    const frontmatter = fmMatch[1];
-    const skills = [];
-    let inSkills = false;
-
-    for (const line of frontmatter.split('\n')) {
-      if (line.match(/^skills:\s*$/)) {
-        inSkills = true;
-        continue;
-      }
-      if (inSkills) {
-        const skillMatch = line.match(/^\s+-\s+(.+)$/);
-        if (skillMatch) {
-          skills.push(skillMatch[1].trim());
-        } else {
-          break;
-        }
-      }
-    }
-
-    return skills;
-  } catch (e) {
-    console.error(`[skill-injector] Error reading ${agentFile}: ${e.message}`);
-    return [];
-  }
-}
-
-/**
- * Read skill content from SKILL.md
- */
-function readSkillContent(skillName) {
-  const skillFile = path.join(SKILLS_DIR, skillName, 'SKILL.md');
-  if (!fs.existsSync(skillFile)) {
-    return null;
-  }
-
-  try {
-    const content = fs.readFileSync(skillFile, 'utf8');
-    // Limit to 20KB per skill to avoid bloating context
-    if (content.length > 20000) {
-      return content.substring(0, 20000) + '\n\n[... truncated at 20KB ...]';
-    }
-    return content;
-  } catch (e) {
-    console.error(`[skill-injector] Error reading skill ${skillName}: ${e.message}`);
-    return null;
-  }
-}
-
-function processHook(data) {
-  const agentType = data.agent_type || '';
-
-  // Get skills for this agent type
-  const skills = getAgentSkills(agentType);
-  if (skills.length === 0) {
-    console.log(JSON.stringify({}));
-    process.exit(0);
-  }
-
-  // Load skill contents
-  const skillBlocks = [];
-  for (const skillName of skills) {
-    const content = readSkillContent(skillName);
-    if (content) {
-      skillBlocks.push(`<skill name="${skillName}">\n${content}\n</skill>`);
-    }
-  }
-
-  if (skillBlocks.length === 0) {
-    console.log(JSON.stringify({}));
-    process.exit(0);
-  }
-
-  const skillSection = `<injected-skills>\nThe following skills have been auto-loaded based on your agent configuration. Use this knowledge for your task.\n\n${skillBlocks.join('\n\n')}\n</injected-skills>`;
-
-  console.error(`[skill-injector] Injected ${skillBlocks.length} skill(s) into ${agentType}: ${skills.join(', ')}`);
-
-  console.log(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'SubagentStart',
-      additionalContext: skillSection
-    }
-  }));
-  process.exit(0);
-}

package/.claude/hooks/skill-usage-logger.cjs

@@ -1,258 +0,0 @@
-#!/usr/bin/env node
-/**
- * <hook-name>skill-usage-logger</hook-name>
- *
- * <purpose>
- * Logs every skill load for analytics - which skills are used, by which agents, in which projects.
- * </purpose>
- *
- * <triggers>
- * - PostToolUse on Skill
- * </triggers>
- *
- * <log-file>$CLAUDE_PROJECT_DIR/inbox/skill-usage.jsonl</log-file>
- */
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-const LOG_FILE = path.join(
-  process.env.HAILER_INBOX_DIR || path.join(process.env.CLAUDE_PROJECT_DIR || process.cwd(), 'inbox'),
-  'skill-usage.jsonl'
-);
-
-// 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(`[skill-usage-logger] Failed to parse input: ${e.message}`);
-    process.exit(0);
-  }
-});
-
-/**
- * Detect if running in subagent context from transcript_path
- * Subagent paths contain /subagents/
- * Returns: { isSubagent: boolean, agentName: string | null }
- */
-function detectSubagentContext(transcriptPath) {
-  if (!transcriptPath) {
-    return { isSubagent: false, agentName: null };
-  }
-
-  // Subagent paths look like: .../{session_id}/subagents/agent-{agent_id}.jsonl
-  if (transcriptPath.includes('/subagents/')) {
-    // Extract agent name from path
-    const match = transcriptPath.match(/subagents\/([^/]+)\.jsonl$/);
-    if (match) {
-      // Clean up agent ID - might be like "agent-a7004fa" or full name
-      return { isSubagent: true, agentName: match[1] };
-    }
-    return { isSubagent: true, agentName: 'unknown' };
-  }
-
-  return { isSubagent: false, agentName: null };
-}
-
-function processHook(data) {
-  const { tool_name, tool_input, tool_response, transcript_path } = data;
-
-  // Only process Skill tool
-  if (tool_name !== 'Skill') {
-    process.exit(0);
-  }
-
-  // Extract skill name from tool_input
-  const skillName = tool_input?.skill || tool_input?.command || 'unknown';
-  const skillArgs = tool_input?.args || null;
-
-  // Detect subagent context
-  const { isSubagent, agentName } = detectSubagentContext(transcript_path);
-
-  // Get project from env or cwd
-  const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
-  const project = path.basename(projectDir);
-
-  const entry = {
-    ts: new Date().toISOString(),
-    skill: skillName,
-    agent: isSubagent ? agentName : 'orchestrator',
-    isSubagent,
-    project,
-    args: skillArgs
-  };
-
-  try {
-    // Ensure directory exists
-    const logDir = path.dirname(LOG_FILE);
-    if (!fs.existsSync(logDir)) {
-      fs.mkdirSync(logDir, { recursive: true });
-    }
-
-    fs.appendFileSync(LOG_FILE, JSON.stringify(entry) + '\n');
-  } catch (err) {
-    console.error(`[skill-usage-logger] Could not write: ${err.message}`);
-  }
-
-  process.exit(0);
-}
-
-// CLI: Show recent skill loads
-if (process.argv[2] === '--recent' || process.argv[2] === '-r') {
-  const limit = parseInt(process.argv[3]) || 20;
-
-  if (!fs.existsSync(LOG_FILE)) {
-    console.log('No skill usage data yet');
-    process.exit(0);
-  }
-
-  const lines = fs.readFileSync(LOG_FILE, 'utf8').trim().split('\n');
-  const recent = lines.slice(-limit);
-
-  console.log(`Last ${recent.length} skill loads:\n`);
-  console.log('Time'.padEnd(10) + 'Skill'.padEnd(30) + 'Agent'.padEnd(20) + 'Project');
-  console.log('-'.repeat(75));
-
-  for (const line of recent) {
-    try {
-      const entry = JSON.parse(line);
-      const time = entry.ts.split('T')[1].split('.')[0];
-      const agent = entry.isSubagent ? entry.agent : 'orchestrator';
-      console.log(`${time.padEnd(10)}${entry.skill.padEnd(30)}${agent.padEnd(20)}${entry.project}`);
-    } catch {}
-  }
-  process.exit(0);
-}
-
-// CLI: Show stats by skill
-if (process.argv[2] === '--stats' || process.argv[2] === '-s') {
-  if (!fs.existsSync(LOG_FILE)) {
-    console.log('No skill usage data yet');
-    process.exit(0);
-  }
-
-  const lines = fs.readFileSync(LOG_FILE, 'utf8').trim().split('\n');
-  const skillStats = {};
-  const agentSkills = {};
-
-  for (const line of lines) {
-    try {
-      const entry = JSON.parse(line);
-
-      // Count by skill
-      if (!skillStats[entry.skill]) {
-        skillStats[entry.skill] = { total: 0, byOrchestrator: 0, bySubagent: 0 };
-      }
-      skillStats[entry.skill].total++;
-      if (entry.isSubagent) {
-        skillStats[entry.skill].bySubagent++;
-      } else {
-        skillStats[entry.skill].byOrchestrator++;
-      }
-
-      // Track which agents use which skills
-      if (entry.isSubagent && entry.agent) {
-        if (!agentSkills[entry.agent]) {
-          agentSkills[entry.agent] = new Set();
-        }
-        agentSkills[entry.agent].add(entry.skill);
-      }
-    } catch {}
-  }
-
-  console.log('Skill Usage Stats:\n');
-  console.log('Skill'.padEnd(35) + 'Total'.padEnd(8) + 'Orch'.padEnd(8) + 'Subagent');
-  console.log('-'.repeat(60));
-
-  const sorted = Object.entries(skillStats).sort((a, b) => b[1].total - a[1].total);
-  for (const [skill, s] of sorted) {
-    console.log(`${skill.padEnd(35)}${String(s.total).padEnd(8)}${String(s.byOrchestrator).padEnd(8)}${s.bySubagent}`);
-  }
-
-  console.log('-'.repeat(60));
-  console.log(`Total: ${lines.length} skill loads\n`);
-
-  // Show agent -> skill mapping
-  if (Object.keys(agentSkills).length > 0) {
-    console.log('Skills by Agent:\n');
-    for (const [agent, skills] of Object.entries(agentSkills)) {
-      console.log(`  ${agent}: ${[...skills].join(', ')}`);
-    }
-  }
-
-  process.exit(0);
-}
-
-// CLI: Show unused skills (skills in .claude/skills/ not in log)
-if (process.argv[2] === '--unused' || process.argv[2] === '-u') {
-  const skillsDir = path.join(process.cwd(), '.claude', 'skills');
-
-  if (!fs.existsSync(skillsDir)) {
-    console.log('No .claude/skills/ directory found');
-    process.exit(0);
-  }
-
-  // Get all skill directories
-  const allSkills = fs.readdirSync(skillsDir, { withFileTypes: true })
-    .filter(d => d.isDirectory())
-    .map(d => d.name);
-
-  // Get used skills from log
-  const usedSkills = new Set();
-  if (fs.existsSync(LOG_FILE)) {
-    const lines = fs.readFileSync(LOG_FILE, 'utf8').trim().split('\n');
-    for (const line of lines) {
-      try {
-        const entry = JSON.parse(line);
-        usedSkills.add(entry.skill);
-      } catch {}
-    }
-  }
-
-  const unused = allSkills.filter(s => !usedSkills.has(s));
-
-  if (unused.length === 0) {
-    console.log('All skills have been used at least once!');
-  } else {
-    console.log(`Unused skills (${unused.length}):\n`);
-    for (const skill of unused.sort()) {
-      console.log(`  - ${skill}`);
-    }
-  }
-
-  process.exit(0);
-}
-
-// CLI: Clear log
-if (process.argv[2] === '--clear') {
-  if (fs.existsSync(LOG_FILE)) {
-    fs.unlinkSync(LOG_FILE);
-    console.log('✓ Skill usage log cleared');
-  } else {
-    console.log('No log file to clear');
-  }
-  process.exit(0);
-}
-
-// CLI: Help
-if (process.argv[2] === '--help' || process.argv[2] === '-h') {
-  console.log(`
-Skill Usage Logger - Track skill loads by agents
-
-Usage:
-  node skill-usage-logger.cjs --recent [N]   Show last N skill loads (default 20)
-  node skill-usage-logger.cjs --stats        Show usage statistics
-  node skill-usage-logger.cjs --unused       Show skills never loaded
-  node skill-usage-logger.cjs --clear        Clear the log
-  node skill-usage-logger.cjs --help         Show this help
-
-Log file: ${LOG_FILE}
-`);
-  process.exit(0);
-}

package/.claude/hooks/src-edit-guard.cjs

@@ -1,240 +0,0 @@
-#!/usr/bin/env node
-/**
- * <hook-name>src-edit-guard</hook-name>
- *
- * <purpose>
- * Blocks direct edits to src/ directory.
- * Forces main agent to spawn subagents for MCP server code changes.
- * Preserves orchestrator context by delegating implementation work.
- * </purpose>
- *
- * <triggers>
- * - PreToolUse on Write and Edit tools
- * - Only when file path starts with src/
- * </triggers>
- *
- * <allowed-when>
- * - Builder mode is active (/tmp/.claude-builder-agent-active exists)
- * - File is outside src/ directory
- * </allowed-when>
- *
- * <behavior>
- * 1. Checks if file is in src/ directory
- * 2. Checks builder mode status
- * 3. Blocks with instructions to spawn general-purpose agent
- * </behavior>
- *
- * <shared-files>
- * /tmp/.claude-builder-agent-active (shared with app-edit-guard, builder-mode-manager)
- * </shared-files>
- *
- * <cli-commands>
- * --on: Enable builder mode (allow src/ edits)
- * --off: Disable builder mode (block src/ edits)
- * --status: Check current mode
- * </cli-commands>
- */
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-// Skip in subagent context - subagents can't use AskUserQuestion or Bash to recover
-if (process.env.CLAUDE_AGENT_ID || process.env.CLAUDE_SUBAGENT) {
-  console.log(JSON.stringify({ decision: 'allow' }));
-  process.exit(0);
-}
-
-// UNIFIED: Use same builder mode file as app-edit-guard.cjs
-const TEMP_DIR = os.tmpdir();
-const BUILDER_MODE_FILE = path.join(TEMP_DIR, '.claude-builder-agent-active');
-
-// 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) {
-    // Invalid JSON - allow to avoid blocking legitimate operations
-    outputAllow();
-  }
-});
-
-function outputAllow() {
-  console.log(JSON.stringify({ decision: 'allow' }));
-  process.exit(0);
-}
-
-function outputBlock(message) {
-  console.log(JSON.stringify({
-    decision: 'block',
-    reason: message
-  }));
-  process.exit(0);
-}
-
-/**
- * Check if builder mode is active (subagent editing)
- */
-function isBuilderModeActive() {
-  try {
-    return fs.existsSync(BUILDER_MODE_FILE);
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Enable builder mode
- */
-function enableBuilderMode() {
-  fs.writeFileSync(BUILDER_MODE_FILE, JSON.stringify({
-    enabledAt: new Date().toISOString(),
-    pid: process.pid
-  }));
-}
-
-/**
- * Disable builder mode
- */
-function disableBuilderMode() {
-  if (fs.existsSync(BUILDER_MODE_FILE)) {
-    fs.unlinkSync(BUILDER_MODE_FILE);
-    return true;
-  }
-  return false;
-}
-
-function processHook(data) {
-  const { tool_name, tool_input } = data;
-
-  // Only guard Write and Edit tools
-  if (tool_name !== 'Write' && tool_name !== 'Edit') {
-    outputAllow();
-    return;
-  }
-
-  const filePath = tool_input?.file_path;
-  if (!filePath) {
-    outputAllow();
-    return;
-  }
-
-  // Normalize and get relative path
-  const normalizedPath = path.resolve(filePath);
-  const projectRoot = process.env.CLAUDE_PROJECT_DIR || process.cwd();
-  const relativePath = path.relative(projectRoot, normalizedPath);
-
-  // Check if file is in src/ directory
-  const isInSrc = relativePath.startsWith('src/') || relativePath.startsWith('src\\');
-
-  if (!isInSrc) {
-    // Not in src/ directory - allow
-    outputAllow();
-    return;
-  }
-
-  // Check if builder mode is active - ALLOW
-  if (isBuilderModeActive()) {
-    outputAllow();
-    return;
-  }
-
-  // BLOCK with helpful message
-  outputBlock(`
-🚫 BLOCKED: Direct edit to source file
-
-File: ${relativePath}
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-WHY: Use a subagent to save your context for orchestration
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-TO PROCEED: Spawn a general-purpose agent with detailed instructions:
-
-Task({
-  subagent_type: "general-purpose",
-  description: "Fix issue #XX",
-  prompt: \`
-    [Detailed instructions for the change]
-
-    File to modify: ${relativePath}
-
-    [Explain what to change and why]
-  \`
-})
-
-The agent will:
-1. Make the code changes
-2. Verify the build passes
-3. Report back results
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-OR: Enable builder mode temporarily (if you need to edit directly)
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Bash: node .claude/hooks/src-edit-guard.cjs --on
-[Make your edits]
-Bash: node .claude/hooks/src-edit-guard.cjs --off
-`);
-}
-
-// CLI: Enable builder mode
-if (process.argv[2] === '--on') {
-  enableBuilderMode();
-  console.log('🔧 Builder mode ENABLED - src/ edits now allowed');
-  process.exit(0);
-}
-
-// CLI: Disable builder mode
-if (process.argv[2] === '--off') {
-  if (disableBuilderMode()) {
-    console.log('🔒 Builder mode DISABLED - src/ edits blocked again');
-  } else {
-    console.log('ℹ️  Builder mode was not active');
-  }
-  process.exit(0);
-}
-
-// CLI: Check status
-if (process.argv[2] === '--status') {
-  if (isBuilderModeActive()) {
-    const data = JSON.parse(fs.readFileSync(BUILDER_MODE_FILE, 'utf8'));
-    console.log(`🔧 Builder mode is ACTIVE (enabled at ${data.enabledAt})`);
-  } else {
-    console.log('🔒 Builder mode is OFF - src/ edits are blocked');
-  }
-  process.exit(0);
-}
-
-// CLI: Help
-if (process.argv[2] === '--help' || process.argv[2] === '-h') {
-  console.log(`
-Source Code Edit Guard - Blocks direct edits to src/ directory
-
-Usage:
-  node src-edit-guard.cjs --on       Enable builder mode (allow edits)
-  node src-edit-guard.cjs --off      Disable builder mode (block edits)
-  node src-edit-guard.cjs --status   Check current mode
-  node src-edit-guard.cjs --help     Show this help
-
-UNIFIED SYSTEM: This hook uses the same builder mode file as app-edit-guard.cjs.
-Enabling builder mode here also enables it for Hailer app edits, and vice versa.
-
-Preferred commands (via app-edit-guard.cjs):
-  node app-edit-guard.cjs --agent-on    Enable global builder mode
-  node app-edit-guard.cjs --agent-off   Disable global builder mode
-
-As a hook:
-  Reads JSON from stdin with tool_name and tool_input
-  Outputs JSON with decision: "allow" or "block"
-
-Purpose:
-  Forces the main Claude agent to spawn subagents for code changes.
-  This saves context in the main agent for orchestration tasks.
-`);
-  process.exit(0);
-}