feed-the-machine 1.6.0 → 1.7.0

package/hooks/ftm-blackboard-enforcer.sh

@@ -1,93 +1,93 @@
-#!/usr/bin/env bash
-# ftm-blackboard-enforcer.sh
-# Stop hook that nudges Claude to record an experience if meaningful work
-# was done but no blackboard entry was written.
-#
-# Uses additionalContext (not "decision: block") so Claude can still act on
-# the reminder. A blocking stop creates a deadlock — Claude can't write files
-# after the user ends the conversation.
-#
-# "Meaningful work" = 3+ edits tracked by the edit counter,
-# or ftm skills were invoked (checked via context.json).
-#
-# Hook: Stop
-
-set -euo pipefail
-
-# shellcheck disable=SC2034
-INPUT=$(cat)
-
-STATE_DIR="$HOME/.claude/ftm-state"
-BB_DIR="$STATE_DIR/blackboard"
-EDIT_COUNTER="$STATE_DIR/.edit-count"
-CONTEXT_FILE="$BB_DIR/context.json"
-EXPERIENCES_DIR="$BB_DIR/experiences"
-
-# Check 1: Were there meaningful edits this session?
-# Edit counter contains just a number now (no session ID).
-# If the counter file is recent (< 4 hours) and >= 3, count as meaningful.
-HAD_EDITS=false
-if [[ -f "$EDIT_COUNTER" ]]; then
-  COUNTER_AGE=$(( $(date +%s) - $(stat -c %Y "$EDIT_COUNTER" 2>/dev/null || stat -f %m "$EDIT_COUNTER" 2>/dev/null || echo "0") ))
-  if [[ "$COUNTER_AGE" -lt 14400 ]]; then
-    STORED_COUNT=$(cat "$EDIT_COUNTER" 2>/dev/null || echo "0")
-    if [[ "$STORED_COUNT" -ge 3 ]]; then
-      HAD_EDITS=true
-    fi
-  fi
-fi
-
-# Check 2: Were ftm skills invoked this session?
-HAD_SKILLS=false
-if [[ -f "$CONTEXT_FILE" ]]; then
-  SKILLS_COUNT=$(jq -r '.session_metadata.skills_invoked | length' "$CONTEXT_FILE" 2>/dev/null || echo "0")
-  if [[ "$SKILLS_COUNT" -gt 0 ]]; then
-    HAD_SKILLS=true
-  fi
-fi
-
-# If no meaningful work detected, allow stop quietly
-if [[ "$HAD_EDITS" == "false" && "$HAD_SKILLS" == "false" ]]; then
-  # Clean up session markers
-  rm -f "$EDIT_COUNTER" "$STATE_DIR/.plan-presented" 2>/dev/null
-  exit 0
-fi
-
-# Check 3: Was an experience recorded today?
-TODAY=$(date +%Y-%m-%d)
-HAS_EXPERIENCE=false
-
-if [[ -d "$EXPERIENCES_DIR" ]]; then
-  TODAY_EXPERIENCE=$(find "$EXPERIENCES_DIR" -name "${TODAY}*" -type f 2>/dev/null | head -1)
-  if [[ -n "$TODAY_EXPERIENCE" ]]; then
-    HAS_EXPERIENCE=true
-  fi
-fi
-
-# Also check if context.json was updated today (recent_decisions not empty)
-if [[ -f "$CONTEXT_FILE" ]]; then
-  DECISIONS_COUNT=$(jq -r '.recent_decisions | length' "$CONTEXT_FILE" 2>/dev/null || echo "0")
-  LAST_UPDATED=$(jq -r '.session_metadata.last_updated // ""' "$CONTEXT_FILE" 2>/dev/null || echo "")
-  if [[ "$DECISIONS_COUNT" -gt 0 && -n "$LAST_UPDATED" ]]; then
-    if [[ "$LAST_UPDATED" == *"$TODAY"* ]]; then
-      HAS_EXPERIENCE=true
-    fi
-  fi
-fi
-
-if [[ "$HAS_EXPERIENCE" == "true" ]]; then
-  # Blackboard was written, clean up and allow stop
-  rm -f "$EDIT_COUNTER" "$STATE_DIR/.plan-presented" 2>/dev/null
-  exit 0
-fi
-
-# Work was done but no blackboard write — nudge (don't block)
-cat <<'JSON'
-{
-  "stopReason": "[ftm-blackboard-enforcer] You did meaningful work this session but did not record an experience to the blackboard. Before finishing, please: (1) Update ~/.claude/ftm-state/blackboard/context.json with current_task status and recent_decisions. (2) Write an experience file to ~/.claude/ftm-state/blackboard/experiences/ with task_type, tags, outcome, and lessons. (3) Update ~/.claude/ftm-state/blackboard/experiences/index.json with the new entry. This is how ftm learns — skipping it means the next session starts from zero."
-}
-JSON
-
-# Clean up session markers regardless — don't let stale state carry over
-rm -f "$EDIT_COUNTER" "$STATE_DIR/.plan-presented" 2>/dev/null
-exit 0
+#!/usr/bin/env bash
+# ftm-blackboard-enforcer.sh
+# Stop hook that nudges Claude to record an experience if meaningful work
+# was done but no blackboard entry was written.
+#
+# Uses additionalContext (not "decision: block") so Claude can still act on
+# the reminder. A blocking stop creates a deadlock — Claude can't write files
+# after the user ends the conversation.
+#
+# "Meaningful work" = 3+ edits tracked by the edit counter,
+# or ftm skills were invoked (checked via context.json).
+#
+# Hook: Stop
+
+set -euo pipefail
+
+# shellcheck disable=SC2034
+INPUT=$(cat)
+
+STATE_DIR="$HOME/.claude/ftm-state"
+BB_DIR="$STATE_DIR/blackboard"
+EDIT_COUNTER="$STATE_DIR/.edit-count"
+CONTEXT_FILE="$BB_DIR/context.json"
+EXPERIENCES_DIR="$BB_DIR/experiences"
+
+# Check 1: Were there meaningful edits this session?
+# Edit counter contains just a number now (no session ID).
+# If the counter file is recent (< 4 hours) and >= 3, count as meaningful.
+HAD_EDITS=false
+if [[ -f "$EDIT_COUNTER" ]]; then
+  COUNTER_AGE=$(( $(date +%s) - $(stat -c %Y "$EDIT_COUNTER" 2>/dev/null || stat -f %m "$EDIT_COUNTER" 2>/dev/null || echo "0") ))
+  if [[ "$COUNTER_AGE" -lt 14400 ]]; then
+    STORED_COUNT=$(cat "$EDIT_COUNTER" 2>/dev/null || echo "0")
+    if [[ "$STORED_COUNT" -ge 3 ]]; then
+      HAD_EDITS=true
+    fi
+  fi
+fi
+
+# Check 2: Were ftm skills invoked this session?
+HAD_SKILLS=false
+if [[ -f "$CONTEXT_FILE" ]]; then
+  SKILLS_COUNT=$(jq -r '.session_metadata.skills_invoked | length' "$CONTEXT_FILE" 2>/dev/null || echo "0")
+  if [[ "$SKILLS_COUNT" -gt 0 ]]; then
+    HAD_SKILLS=true
+  fi
+fi
+
+# If no meaningful work detected, allow stop quietly
+if [[ "$HAD_EDITS" == "false" && "$HAD_SKILLS" == "false" ]]; then
+  # Clean up session markers
+  rm -f "$EDIT_COUNTER" "$STATE_DIR/.plan-presented" 2>/dev/null
+  exit 0
+fi
+
+# Check 3: Was an experience recorded today?
+TODAY=$(date +%Y-%m-%d)
+HAS_EXPERIENCE=false
+
+if [[ -d "$EXPERIENCES_DIR" ]]; then
+  TODAY_EXPERIENCE=$(find "$EXPERIENCES_DIR" -name "${TODAY}*" -type f 2>/dev/null | head -1)
+  if [[ -n "$TODAY_EXPERIENCE" ]]; then
+    HAS_EXPERIENCE=true
+  fi
+fi
+
+# Also check if context.json was updated today (recent_decisions not empty)
+if [[ -f "$CONTEXT_FILE" ]]; then
+  DECISIONS_COUNT=$(jq -r '.recent_decisions | length' "$CONTEXT_FILE" 2>/dev/null || echo "0")
+  LAST_UPDATED=$(jq -r '.session_metadata.last_updated // ""' "$CONTEXT_FILE" 2>/dev/null || echo "")
+  if [[ "$DECISIONS_COUNT" -gt 0 && -n "$LAST_UPDATED" ]]; then
+    if [[ "$LAST_UPDATED" == *"$TODAY"* ]]; then
+      HAS_EXPERIENCE=true
+    fi
+  fi
+fi
+
+if [[ "$HAS_EXPERIENCE" == "true" ]]; then
+  # Blackboard was written, clean up and allow stop
+  rm -f "$EDIT_COUNTER" "$STATE_DIR/.plan-presented" 2>/dev/null
+  exit 0
+fi
+
+# Work was done but no blackboard write — nudge (don't block)
+cat <<'JSON'
+{
+  "stopReason": "[ftm-blackboard-enforcer] You did meaningful work this session but did not record an experience to the blackboard. Before finishing, please: (1) Update ~/.claude/ftm-state/blackboard/context.json with current_task status and recent_decisions. (2) Write an experience file to ~/.claude/ftm-state/blackboard/experiences/ with task_type, tags, outcome, and lessons. (3) Update ~/.claude/ftm-state/blackboard/experiences/index.json with the new entry. This is how ftm learns — skipping it means the next session starts from zero."
+}
+JSON
+
+# Clean up session markers regardless — don't let stale state carry over
+rm -f "$EDIT_COUNTER" "$STATE_DIR/.plan-presented" 2>/dev/null
+exit 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