feed-the-machine 1.5.0 → 1.6.0

package/hooks/ftm-discovery-reminder.sh

@@ -1,90 +1,90 @@
-#!/usr/bin/env bash
-# ftm-discovery-reminder.sh
-# UserPromptSubmit hook that detects when a user's prompt mentions
-# external systems, migrations, rerouting, or stakeholder coordination.
-# Injects a reminder about the discovery interview before Claude starts working.
-#
-# This is a soft nudge, not a block — it adds additionalContext that
-# reminds Claude about the ftm-mind discovery interview protocol.
-#
-# Hook: UserPromptSubmit
-
-set -euo pipefail
-
-INPUT=$(cat)
-PROMPT=$(echo "$INPUT" | jq -r '.prompt // ""')
-
-# Lowercase the prompt for matching
-PROMPT_LOWER=$(echo "$PROMPT" | tr '[:upper:]' '[:lower:]')
-
-# Patterns that indicate external system work requiring discovery interview
-EXTERNAL_PATTERNS=(
-  "reroute"
-  "migrate"
-  "migration"
-  "move.*to.*board"
-  "move.*to.*project"
-  "point.*to.*new"
-  "update.*integration"
-  "change.*endpoint"
-  "switch.*from.*to"
-  "redirect.*to"
-  "jira.*automation"
-  "freshservice.*automation"
-  "update.*workflow"
-  "change.*routing"
-  "slack.*message.*to"
-  "email.*to"
-  "draft.*message"
-  "notify.*about"
-  "check.*with"
-  "coordinate.*with"
-  "ask.*about"
-  "tell.*about.*change"
-)
-
-# Patterns that indicate the user already provided comprehensive context
-# (e.g., pasted a Slack thread, gave detailed instructions)
-CONTEXT_SIGNALS=(
-  "here's the slack"
-  "here's the thread"
-  "here's what they said"
-  "per the conversation"
-  "just do it"
-  "no questions"
-  "skip the interview"
-  "don't ask"
-)
-
-# Check if user already provided enough context
-for signal in "${CONTEXT_SIGNALS[@]}"; do
-  if [[ "$PROMPT_LOWER" == *"$signal"* ]]; then
-    exit 0  # User explicitly provided context or asked to skip
-  fi
-done
-
-# Check for external system patterns
-MATCHED=false
-MATCHED_PATTERN=""
-for pattern in "${EXTERNAL_PATTERNS[@]}"; do
-  if echo "$PROMPT_LOWER" | grep -qE "$pattern"; then
-    MATCHED=true
-    MATCHED_PATTERN="$pattern"
-    break
-  fi
-done
-
-if [[ "$MATCHED" == "false" ]]; then
-  exit 0  # No external system work detected
-fi
-
-# Inject discovery interview reminder
-cat <<JSON
-{
-  "hookSpecificOutput": {
-    "hookEventName": "UserPromptSubmit",
-    "additionalContext": "[ftm-discovery-reminder] This request involves external systems or stakeholder coordination (matched: ${MATCHED_PATTERN}). Before generating a plan or starting work, run the Discovery Interview from ftm-mind section 10. Ask 2-4 focused questions about: (1) who else needs to know, (2) downstream dependencies, (3) anything to leave as-is, (4) timeline/approval constraints. The user's answers should feed into the plan. Skip the interview ONLY if the user already provided comprehensive context in their message or explicitly said to skip it."
-  }
-}
-JSON
-exit 0
+#!/usr/bin/env bash
+# ftm-discovery-reminder.sh
+# UserPromptSubmit hook that detects when a user's prompt mentions
+# external systems, migrations, rerouting, or stakeholder coordination.
+# Injects a reminder about the discovery interview before Claude starts working.
+#
+# This is a soft nudge, not a block — it adds additionalContext that
+# reminds Claude about the ftm-mind discovery interview protocol.
+#
+# Hook: UserPromptSubmit
+
+set -euo pipefail
+
+INPUT=$(cat)
+PROMPT=$(echo "$INPUT" | jq -r '.prompt // ""')
+
+# Lowercase the prompt for matching
+PROMPT_LOWER=$(echo "$PROMPT" | tr '[:upper:]' '[:lower:]')
+
+# Patterns that indicate external system work requiring discovery interview
+EXTERNAL_PATTERNS=(
+  "reroute"
+  "migrate"
+  "migration"
+  "move.*to.*board"
+  "move.*to.*project"
+  "point.*to.*new"
+  "update.*integration"
+  "change.*endpoint"
+  "switch.*from.*to"
+  "redirect.*to"
+  "jira.*automation"
+  "freshservice.*automation"
+  "update.*workflow"
+  "change.*routing"
+  "slack.*message.*to"
+  "email.*to"
+  "draft.*message"
+  "notify.*about"
+  "check.*with"
+  "coordinate.*with"
+  "ask.*about"
+  "tell.*about.*change"
+)
+
+# Patterns that indicate the user already provided comprehensive context
+# (e.g., pasted a Slack thread, gave detailed instructions)
+CONTEXT_SIGNALS=(
+  "here's the slack"
+  "here's the thread"
+  "here's what they said"
+  "per the conversation"
+  "just do it"
+  "no questions"
+  "skip the interview"
+  "don't ask"
+)
+
+# Check if user already provided enough context
+for signal in "${CONTEXT_SIGNALS[@]}"; do
+  if [[ "$PROMPT_LOWER" == *"$signal"* ]]; then
+    exit 0  # User explicitly provided context or asked to skip
+  fi
+done
+
+# Check for external system patterns
+MATCHED=false
+MATCHED_PATTERN=""
+for pattern in "${EXTERNAL_PATTERNS[@]}"; do
+  if echo "$PROMPT_LOWER" | grep -qE "$pattern"; then
+    MATCHED=true
+    MATCHED_PATTERN="$pattern"
+    break
+  fi
+done
+
+if [[ "$MATCHED" == "false" ]]; then
+  exit 0  # No external system work detected
+fi
+
+# Inject discovery interview reminder
+cat <<JSON
+{
+  "hookSpecificOutput": {
+    "hookEventName": "UserPromptSubmit",
+    "additionalContext": "[ftm-discovery-reminder] This request involves external systems or stakeholder coordination (matched: ${MATCHED_PATTERN}). Before generating a plan or starting work, run the Discovery Interview from ftm-mind section 10. Ask 2-4 focused questions about: (1) who else needs to know, (2) downstream dependencies, (3) anything to leave as-is, (4) timeline/approval constraints. The user's answers should feed into the plan. Skip the interview ONLY if the user already provided comprehensive context in their message or explicitly said to skip it."
+  }
+}
+JSON
+exit 0

package/hooks/ftm-drafts-gate.sh

@@ -1,61 +1,61 @@
-#!/usr/bin/env bash
-# ftm-drafts-gate.sh
-# PreToolUse hook for Slack/Gmail send tools.
-#
-# Before allowing a message to be sent via Slack or Gmail, checks that
-# a corresponding draft exists in .ftm-drafts/ (project root) or
-# ~/.claude/ftm-drafts/ (global fallback).
-#
-# If no draft exists, blocks the send and tells Claude to save the draft first.
-#
-# Hook: PreToolUse (matcher: mcp__slack__slack_post_message|mcp__slack__slack_reply_to_thread|mcp__gmail__send_email)
-
-set -euo pipefail
-
-INPUT=$(cat)
-TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // ""')
-
-# Only gate send tools (not reads/searches)
-case "$TOOL_NAME" in
-  *slack_post_message*|*slack_reply_to_thread*|*send_email*)
-    ;;
-  *)
-    exit 0  # Not a send tool, allow
-    ;;
-esac
-
-# Check for drafts in project .ftm-drafts/ or global ~/.claude/ftm-drafts/
-CWD=$(echo "$INPUT" | jq -r '.cwd // ""')
-PROJECT_DRAFTS="${CWD}/.ftm-drafts"
-GLOBAL_DRAFTS="$HOME/.claude/ftm-drafts"
-
-HAS_RECENT_DRAFT=false
-
-# Check both locations for any draft file modified in the last 30 minutes
-for DRAFTS_DIR in "$PROJECT_DRAFTS" "$GLOBAL_DRAFTS"; do
-  if [[ -d "$DRAFTS_DIR" ]]; then
-    # Find draft files modified in the last 30 minutes
-    RECENT=$(find "$DRAFTS_DIR" -name "*.md" -mmin -30 2>/dev/null | head -1)
-    if [[ -n "$RECENT" ]]; then
-      HAS_RECENT_DRAFT=true
-      break
-    fi
-  fi
-done
-
-if [[ "$HAS_RECENT_DRAFT" == "true" ]]; then
-  # Draft exists, allow the send (the external-action-guard will still prompt for approval)
-  exit 0
-fi
-
-# No draft found — block and tell Claude to save one first
-cat <<JSON
-{
-  "hookSpecificOutput": {
-    "hookEventName": "PreToolUse",
-    "permissionDecision": "deny",
-    "permissionDecisionReason": "[ftm-drafts-gate] No draft found in .ftm-drafts/ before sending. Save the message to .ftm-drafts/ first (using the draft-before-send protocol from ftm-mind section 3.5), then retry the send. This creates an audit trail and lets the user review before sending."
-  }
-}
-JSON
-exit 0
+#!/usr/bin/env bash
+# ftm-drafts-gate.sh
+# PreToolUse hook for Slack/Gmail send tools.
+#
+# Before allowing a message to be sent via Slack or Gmail, checks that
+# a corresponding draft exists in .ftm-drafts/ (project root) or
+# ~/.claude/ftm-drafts/ (global fallback).
+#
+# If no draft exists, blocks the send and tells Claude to save the draft first.
+#
+# Hook: PreToolUse (matcher: mcp__slack__slack_post_message|mcp__slack__slack_reply_to_thread|mcp__gmail__send_email)
+
+set -euo pipefail
+
+INPUT=$(cat)
+TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // ""')
+
+# Only gate send tools (not reads/searches)
+case "$TOOL_NAME" in
+  *slack_post_message*|*slack_reply_to_thread*|*send_email*)
+    ;;
+  *)
+    exit 0  # Not a send tool, allow
+    ;;
+esac
+
+# Check for drafts in project .ftm-drafts/ or global ~/.claude/ftm-drafts/
+CWD=$(echo "$INPUT" | jq -r '.cwd // ""')
+PROJECT_DRAFTS="${CWD}/.ftm-drafts"
+GLOBAL_DRAFTS="$HOME/.claude/ftm-drafts"
+
+HAS_RECENT_DRAFT=false
+
+# Check both locations for any draft file modified in the last 30 minutes
+for DRAFTS_DIR in "$PROJECT_DRAFTS" "$GLOBAL_DRAFTS"; do
+  if [[ -d "$DRAFTS_DIR" ]]; then
+    # Find draft files modified in the last 30 minutes
+    RECENT=$(find "$DRAFTS_DIR" -name "*.md" -mmin -30 2>/dev/null | head -1)
+    if [[ -n "$RECENT" ]]; then
+      HAS_RECENT_DRAFT=true
+      break
+    fi
+  fi
+done
+
+if [[ "$HAS_RECENT_DRAFT" == "true" ]]; then
+  # Draft exists, allow the send (the external-action-guard will still prompt for approval)
+  exit 0
+fi
+
+# No draft found — block and tell Claude to save one first
+cat <<JSON
+{
+  "hookSpecificOutput": {
+    "hookEventName": "PreToolUse",
+    "permissionDecision": "deny",
+    "permissionDecisionReason": "[ftm-drafts-gate] No draft found in .ftm-drafts/ before sending. Save the message to .ftm-drafts/ first (using the draft-before-send protocol from ftm-mind section 3.5), then retry the send. This creates an audit trail and lets the user review before sending."
+  }
+}
+JSON
+exit 0

package/hooks/ftm-event-logger.mjs

@@ -1,107 +1,107 @@
-#!/usr/bin/env node
-
-/**
- * FTM Event Logger — PostToolUse hook
- * Appends structured JSONL entries to ~/.claude/ftm-state/events.log
- * Debounced: fires every 3rd tool use to avoid overhead
- */
-
-import { readFileSync, appendFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
-
-const HOME = homedir();
-const STATE_DIR = join(HOME, '.claude', 'ftm-state');
-const LOG_PATH = join(STATE_DIR, 'events.log');
-const COUNTER_PATH = join(STATE_DIR, '.event-counter');
-const ARCHIVE_DIR = join(STATE_DIR, 'event-archives');
-const MAX_AGE_DAYS = 30;
-
-// Ensure directories exist
-if (!existsSync(STATE_DIR)) mkdirSync(STATE_DIR, { recursive: true });
-
-// Read stdin for hook input
-let input = '';
-process.stdin.setEncoding('utf-8');
-process.stdin.on('data', (chunk) => { input += chunk; });
-process.stdin.on('end', () => {
-  try {
-    const hookData = JSON.parse(input);
-
-    // Debounce: only fire every 3rd tool use
-    let counter = 0;
-    try {
-      counter = parseInt(readFileSync(COUNTER_PATH, 'utf-8').trim(), 10) || 0;
-    } catch { /* first run */ }
-
-    counter++;
-    writeFileSync(COUNTER_PATH, String(counter));
-
-    if (counter % 3 !== 0) {
-      process.exit(0); // Skip this invocation
-    }
-
-    // Build log entry
-    const entry = {
-      timestamp: new Date().toISOString(),
-      event_type: 'tool_use',
-      tool_name: hookData.tool_name || 'unknown',
-      tool_input_keys: hookData.tool_input ? Object.keys(hookData.tool_input) : [],
-      session_id: process.env.CLAUDE_SESSION_ID || 'unknown',
-      skill_context: detectSkillContext(hookData),
-    };
-
-    // Append JSONL
-    appendFileSync(LOG_PATH, JSON.stringify(entry) + '\n');
-
-    // Log rotation: check once per 100 writes
-    if (counter % 100 === 0) {
-      rotateOldEntries();
-    }
-
-  } catch (e) {
-    // Never crash — logging failure should not block execution
-    process.exit(0);
-  }
-});
-
-function detectSkillContext(hookData) {
-  const toolName = hookData.tool_name || '';
-  if (toolName === 'Skill') return hookData.tool_input?.skill || 'unknown-skill';
-  if (toolName === 'Agent') return 'agent-dispatch';
-  return null;
-}
-
-function rotateOldEntries() {
-  try {
-    if (!existsSync(LOG_PATH)) return;
-
-    const lines = readFileSync(LOG_PATH, 'utf-8').split('\n').filter(Boolean);
-    const cutoff = Date.now() - (MAX_AGE_DAYS * 24 * 60 * 60 * 1000);
-
-    const recent = [];
-    const archived = [];
-
-    for (const line of lines) {
-      try {
-        const entry = JSON.parse(line);
-        if (new Date(entry.timestamp).getTime() > cutoff) {
-          recent.push(line);
-        } else {
-          archived.push(line);
-        }
-      } catch {
-        recent.push(line); // Keep unparseable lines
-      }
-    }
-
-    if (archived.length > 0) {
-      if (!existsSync(ARCHIVE_DIR)) mkdirSync(ARCHIVE_DIR, { recursive: true });
-      const archivePath = join(ARCHIVE_DIR, `events-${new Date().toISOString().slice(0, 10)}.log`);
-      appendFileSync(archivePath, archived.join('\n') + '\n');
-      writeFileSync(LOG_PATH, recent.join('\n') + (recent.length > 0 ? '\n' : ''));
-    }
-  } catch {
-    // Rotation failure is non-critical
-  }
-}
+#!/usr/bin/env node
+
+/**
+ * FTM Event Logger — PostToolUse hook
+ * Appends structured JSONL entries to ~/.claude/ftm-state/events.log
+ * Debounced: fires every 3rd tool use to avoid overhead
+ */
+
+import { readFileSync, appendFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+const HOME = homedir();
+const STATE_DIR = join(HOME, '.claude', 'ftm-state');
+const LOG_PATH = join(STATE_DIR, 'events.log');
+const COUNTER_PATH = join(STATE_DIR, '.event-counter');
+const ARCHIVE_DIR = join(STATE_DIR, 'event-archives');
+const MAX_AGE_DAYS = 30;
+
+// Ensure directories exist
+if (!existsSync(STATE_DIR)) mkdirSync(STATE_DIR, { recursive: true });
+
+// Read stdin for hook input
+let input = '';
+process.stdin.setEncoding('utf-8');
+process.stdin.on('data', (chunk) => { input += chunk; });
+process.stdin.on('end', () => {
+  try {
+    const hookData = JSON.parse(input);
+
+    // Debounce: only fire every 3rd tool use
+    let counter = 0;
+    try {
+      counter = parseInt(readFileSync(COUNTER_PATH, 'utf-8').trim(), 10) || 0;
+    } catch { /* first run */ }
+
+    counter++;
+    writeFileSync(COUNTER_PATH, String(counter));
+
+    if (counter % 3 !== 0) {
+      process.exit(0); // Skip this invocation
+    }
+
+    // Build log entry
+    const entry = {
+      timestamp: new Date().toISOString(),
+      event_type: 'tool_use',
+      tool_name: hookData.tool_name || 'unknown',
+      tool_input_keys: hookData.tool_input ? Object.keys(hookData.tool_input) : [],
+      session_id: process.env.CLAUDE_SESSION_ID || 'unknown',
+      skill_context: detectSkillContext(hookData),
+    };
+
+    // Append JSONL
+    appendFileSync(LOG_PATH, JSON.stringify(entry) + '\n');
+
+    // Log rotation: check once per 100 writes
+    if (counter % 100 === 0) {
+      rotateOldEntries();
+    }
+
+  } catch (e) {
+    // Never crash — logging failure should not block execution
+    process.exit(0);
+  }
+});
+
+function detectSkillContext(hookData) {
+  const toolName = hookData.tool_name || '';
+  if (toolName === 'Skill') return hookData.tool_input?.skill || 'unknown-skill';
+  if (toolName === 'Agent') return 'agent-dispatch';
+  return null;
+}
+
+function rotateOldEntries() {
+  try {
+    if (!existsSync(LOG_PATH)) return;
+
+    const lines = readFileSync(LOG_PATH, 'utf-8').split('\n').filter(Boolean);
+    const cutoff = Date.now() - (MAX_AGE_DAYS * 24 * 60 * 60 * 1000);
+
+    const recent = [];
+    const archived = [];
+
+    for (const line of lines) {
+      try {
+        const entry = JSON.parse(line);
+        if (new Date(entry.timestamp).getTime() > cutoff) {
+          recent.push(line);
+        } else {
+          archived.push(line);
+        }
+      } catch {
+        recent.push(line); // Keep unparseable lines
+      }
+    }
+
+    if (archived.length > 0) {
+      if (!existsSync(ARCHIVE_DIR)) mkdirSync(ARCHIVE_DIR, { recursive: true });
+      const archivePath = join(ARCHIVE_DIR, `events-${new Date().toISOString().slice(0, 10)}.log`);
+      appendFileSync(archivePath, archived.join('\n') + '\n');
+      writeFileSync(LOG_PATH, recent.join('\n') + (recent.length > 0 ? '\n' : ''));
+    }
+  } catch {
+    // Rotation failure is non-critical
+  }
+}