feed-the-machine 1.6.0 → 1.7.0

package/ftm-upgrade/scripts/check-version.sh

@@ -1,76 +1,76 @@
-#!/usr/bin/env bash
-# check-version.sh — Check for feed-the-machine updates via GitHub Releases
-# Outputs: UP_TO_DATE | UPGRADE_AVAILABLE <version> <changelog_url> | CHECK_FAILED <reason>
-
-set -uo pipefail
-
-CACHE_DIR="${HOME}/.cache/ftm-brain"
-CACHE_FILE="${CACHE_DIR}/version-check"
-VERSION_FILE="${HOME}/.claude/skills/ftm-version.txt"
-REPO="kkudumu/ftm-brain"
-
-# Ensure cache directory exists
-mkdir -p "${CACHE_DIR}"
-
-# Check if cache is fresh (less than 60 minutes old)
-if [ -f "${CACHE_FILE}" ]; then
-  STALE=$(find "${CACHE_FILE}" -mmin +60 2>/dev/null | wc -l | tr -d ' ')
-  if [ "${STALE}" = "0" ]; then
-    # Cache is fresh — return cached result
-    cat "${CACHE_FILE}"
-    exit 0
-  fi
-fi
-
-# Check that gh CLI is installed
-if ! command -v gh >/dev/null 2>&1; then
-  RESULT="CHECK_FAILED gh_not_installed"
-  printf '%s\n' "${RESULT}" | tee "${CACHE_FILE}"
-  exit 0
-fi
-
-# Query latest release from GitHub
-RELEASE_OUTPUT=$(gh release list -R "${REPO}" --limit 1 2>&1)
-GH_EXIT=$?
-
-if [ ${GH_EXIT} -ne 0 ]; then
-  # Distinguish between network and repo errors
-  if printf '%s' "${RELEASE_OUTPUT}" | grep -qi "could not resolve\|network\|timeout\|no such host"; then
-    RESULT="CHECK_FAILED no_internet"
-  elif printf '%s' "${RELEASE_OUTPUT}" | grep -qi "not found\|404\|Could not find"; then
-    RESULT="CHECK_FAILED repo_not_found"
-  else
-    REASON=$(printf '%s' "${RELEASE_OUTPUT}" | tr '\n' ' ' | cut -c1-80)
-    RESULT="CHECK_FAILED ${REASON}"
-  fi
-  printf '%s\n' "${RESULT}" | tee "${CACHE_FILE}"
-  exit 0
-fi
-
-# Parse latest release tag (first column of gh release list output)
-LATEST_TAG=$(printf '%s' "${RELEASE_OUTPUT}" | awk 'NR==1{print $1}')
-
-if [ -z "${LATEST_TAG}" ]; then
-  RESULT="CHECK_FAILED no_releases_found"
-  printf '%s\n' "${RESULT}" | tee "${CACHE_FILE}"
-  exit 0
-fi
-
-# Read current installed version
-if [ -f "${VERSION_FILE}" ]; then
-  CURRENT_VERSION=$(tr -d '[:space:]' < "${VERSION_FILE}")
-else
-  CURRENT_VERSION="unknown"
-fi
-
-# Compare versions
-if [ "${CURRENT_VERSION}" = "${LATEST_TAG}" ]; then
-  RESULT="UP_TO_DATE"
-else
-  CHANGELOG_URL="https://github.com/${REPO}/releases/tag/${LATEST_TAG}"
-  RESULT="UPGRADE_AVAILABLE ${LATEST_TAG} ${CHANGELOG_URL}"
-fi
-
-# Write to cache and output
-printf '%s\n' "${RESULT}" | tee "${CACHE_FILE}"
-exit 0
+#!/usr/bin/env bash
+# check-version.sh — Check for feed-the-machine updates via GitHub Releases
+# Outputs: UP_TO_DATE | UPGRADE_AVAILABLE <version> <changelog_url> | CHECK_FAILED <reason>
+
+set -uo pipefail
+
+CACHE_DIR="${HOME}/.cache/ftm-brain"
+CACHE_FILE="${CACHE_DIR}/version-check"
+VERSION_FILE="${HOME}/.claude/skills/ftm-version.txt"
+REPO="kkudumu/ftm-brain"
+
+# Ensure cache directory exists
+mkdir -p "${CACHE_DIR}"
+
+# Check if cache is fresh (less than 60 minutes old)
+if [ -f "${CACHE_FILE}" ]; then
+  STALE=$(find "${CACHE_FILE}" -mmin +60 2>/dev/null | wc -l | tr -d ' ')
+  if [ "${STALE}" = "0" ]; then
+    # Cache is fresh — return cached result
+    cat "${CACHE_FILE}"
+    exit 0
+  fi
+fi
+
+# Check that gh CLI is installed
+if ! command -v gh >/dev/null 2>&1; then
+  RESULT="CHECK_FAILED gh_not_installed"
+  printf '%s\n' "${RESULT}" | tee "${CACHE_FILE}"
+  exit 0
+fi
+
+# Query latest release from GitHub
+RELEASE_OUTPUT=$(gh release list -R "${REPO}" --limit 1 2>&1)
+GH_EXIT=$?
+
+if [ ${GH_EXIT} -ne 0 ]; then
+  # Distinguish between network and repo errors
+  if printf '%s' "${RELEASE_OUTPUT}" | grep -qi "could not resolve\|network\|timeout\|no such host"; then
+    RESULT="CHECK_FAILED no_internet"
+  elif printf '%s' "${RELEASE_OUTPUT}" | grep -qi "not found\|404\|Could not find"; then
+    RESULT="CHECK_FAILED repo_not_found"
+  else
+    REASON=$(printf '%s' "${RELEASE_OUTPUT}" | tr '\n' ' ' | cut -c1-80)
+    RESULT="CHECK_FAILED ${REASON}"
+  fi
+  printf '%s\n' "${RESULT}" | tee "${CACHE_FILE}"
+  exit 0
+fi
+
+# Parse latest release tag (first column of gh release list output)
+LATEST_TAG=$(printf '%s' "${RELEASE_OUTPUT}" | awk 'NR==1{print $1}')
+
+if [ -z "${LATEST_TAG}" ]; then
+  RESULT="CHECK_FAILED no_releases_found"
+  printf '%s\n' "${RESULT}" | tee "${CACHE_FILE}"
+  exit 0
+fi
+
+# Read current installed version
+if [ -f "${VERSION_FILE}" ]; then
+  CURRENT_VERSION=$(tr -d '[:space:]' < "${VERSION_FILE}")
+else
+  CURRENT_VERSION="unknown"
+fi
+
+# Compare versions
+if [ "${CURRENT_VERSION}" = "${LATEST_TAG}" ]; then
+  RESULT="UP_TO_DATE"
+else
+  CHANGELOG_URL="https://github.com/${REPO}/releases/tag/${LATEST_TAG}"
+  RESULT="UPGRADE_AVAILABLE ${LATEST_TAG} ${CHANGELOG_URL}"
+fi
+
+# Write to cache and output
+printf '%s\n' "${RESULT}" | tee "${CACHE_FILE}"
+exit 0

package/ftm-upgrade/scripts/upgrade.sh

@@ -1,143 +1,143 @@
-#!/usr/bin/env bash
-# upgrade.sh — Download and install latest feed-the-machine release
-# Usage: upgrade.sh [--version <tag>]
-
-set -uo pipefail
-
-REPO="kkudumu/ftm-brain"
-SKILLS_DIR="${HOME}/.claude/skills"
-VERSION_FILE="${SKILLS_DIR}/ftm-version.txt"
-DOWNLOAD_DIR="/tmp/ftm-upgrade"
-CACHE_FILE="${HOME}/.cache/ftm-brain/version-check"
-
-# ── Helpers ──────────────────────────────────────────────────────────────────
-
-log()  { printf '[ftm-upgrade] %s\n' "$*"; }
-die()  { printf '[ftm-upgrade] ERROR: %s\n' "$*" >&2; exit 1; }
-
-# ── Preflight checks ─────────────────────────────────────────────────────────
-
-if ! command -v gh >/dev/null 2>&1; then
-  die "GitHub CLI (gh) is not installed. Install it with: brew install gh"
-fi
-
-if ! command -v tar >/dev/null 2>&1; then
-  die "tar is required but not found."
-fi
-
-# ── Determine target version ─────────────────────────────────────────────────
-
-TARGET_VERSION=""
-while [ $# -gt 0 ]; do
-  case "$1" in
-    --version) TARGET_VERSION="$2"; shift 2 ;;
-    *) die "Unknown argument: $1" ;;
-  esac
-done
-
-if [ -z "${TARGET_VERSION}" ]; then
-  log "Fetching latest release tag..."
-  TARGET_VERSION=$(gh release list -R "${REPO}" --limit 1 2>&1 | awk 'NR==1{print $1}')
-  if [ -z "${TARGET_VERSION}" ]; then
-    die "Could not determine latest release. Check GitHub access and repository name."
-  fi
-fi
-
-log "Target version: ${TARGET_VERSION}"
-
-# ── Read current version ─────────────────────────────────────────────────────
-
-if [ -f "${VERSION_FILE}" ]; then
-  CURRENT_VERSION=$(tr -d '[:space:]' < "${VERSION_FILE}")
-else
-  CURRENT_VERSION="(not installed)"
-fi
-
-log "Current version: ${CURRENT_VERSION}"
-
-if [ "${CURRENT_VERSION}" = "${TARGET_VERSION}" ]; then
-  log "Already on the latest version (${TARGET_VERSION}). Nothing to do."
-  exit 0
-fi
-
-# ── Download ──────────────────────────────────────────────────────────────────
-
-rm -rf "${DOWNLOAD_DIR}"
-mkdir -p "${DOWNLOAD_DIR}"
-
-log "Downloading release archive for ${TARGET_VERSION}..."
-
-gh release download "${TARGET_VERSION}" \
-  -R "${REPO}" \
-  --archive tar.gz \
-  -D "${DOWNLOAD_DIR}" 2>&1 || die "Download failed. Check your internet connection and repository access."
-
-# Find the downloaded archive
-ARCHIVE=$(find "${DOWNLOAD_DIR}" -maxdepth 1 -name '*.tar.gz' | head -1)
-if [ -z "${ARCHIVE}" ]; then
-  die "No archive found in ${DOWNLOAD_DIR} after download."
-fi
-
-log "Downloaded: ${ARCHIVE}"
-
-# ── Extract ───────────────────────────────────────────────────────────────────
-
-EXTRACT_DIR="${DOWNLOAD_DIR}/extracted"
-mkdir -p "${EXTRACT_DIR}"
-
-log "Extracting archive..."
-tar -xzf "${ARCHIVE}" -C "${EXTRACT_DIR}" 2>&1 || die "Extraction failed. Archive may be corrupt."
-
-# GitHub archives typically extract into a directory named <repo>-<tag>/
-REPO_DIR=$(find "${EXTRACT_DIR}" -maxdepth 1 -mindepth 1 -type d | head -1)
-if [ -z "${REPO_DIR}" ]; then
-  die "Could not find extracted repository directory."
-fi
-
-log "Extracted to: ${REPO_DIR}"
-
-# ── Copy skill files ──────────────────────────────────────────────────────────
-
-# Look for a skills/ subdirectory in the archive; fall back to root
-SOURCE_SKILLS=""
-if [ -d "${REPO_DIR}/skills" ]; then
-  SOURCE_SKILLS="${REPO_DIR}/skills"
-elif [ -d "${REPO_DIR}" ]; then
-  # The repo root might itself contain SKILL.md files and .yml files
-  SOURCE_SKILLS="${REPO_DIR}"
-fi
-
-if [ -z "${SOURCE_SKILLS}" ]; then
-  die "No skills directory found in release archive."
-fi
-
-log "Copying skill files from ${SOURCE_SKILLS} to ${SKILLS_DIR}..."
-
-# Use rsync if available for cleaner copy, else cp
-if command -v rsync >/dev/null 2>&1; then
-  rsync -av --exclude='.git' "${SOURCE_SKILLS}/" "${SKILLS_DIR}/" 2>&1
-else
-  cp -R "${SOURCE_SKILLS}/." "${SKILLS_DIR}/" 2>&1
-fi
-
-# ── Update version file ───────────────────────────────────────────────────────
-
-printf '%s\n' "${TARGET_VERSION}" > "${VERSION_FILE}"
-
-# Invalidate version cache so next check-version.sh run is fresh
-rm -f "${CACHE_FILE}"
-
-# ── Summary ───────────────────────────────────────────────────────────────────
-
-log ""
-log "Upgrade complete."
-log "  ${CURRENT_VERSION} → ${TARGET_VERSION}"
-log "  Changelog: https://github.com/${REPO}/releases/tag/${TARGET_VERSION}"
-log ""
-log "Installed files updated in: ${SKILLS_DIR}"
-
-# ── Cleanup ───────────────────────────────────────────────────────────────────
-
-rm -rf "${DOWNLOAD_DIR}"
-
-exit 0
+#!/usr/bin/env bash
+# upgrade.sh — Download and install latest feed-the-machine release
+# Usage: upgrade.sh [--version <tag>]
+
+set -uo pipefail
+
+REPO="kkudumu/ftm-brain"
+SKILLS_DIR="${HOME}/.claude/skills"
+VERSION_FILE="${SKILLS_DIR}/ftm-version.txt"
+DOWNLOAD_DIR="/tmp/ftm-upgrade"
+CACHE_FILE="${HOME}/.cache/ftm-brain/version-check"
+
+# ── Helpers ──────────────────────────────────────────────────────────────────
+
+log()  { printf '[ftm-upgrade] %s\n' "$*"; }
+die()  { printf '[ftm-upgrade] ERROR: %s\n' "$*" >&2; exit 1; }
+
+# ── Preflight checks ─────────────────────────────────────────────────────────
+
+if ! command -v gh >/dev/null 2>&1; then
+  die "GitHub CLI (gh) is not installed. Install it with: brew install gh"
+fi
+
+if ! command -v tar >/dev/null 2>&1; then
+  die "tar is required but not found."
+fi
+
+# ── Determine target version ─────────────────────────────────────────────────
+
+TARGET_VERSION=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --version) TARGET_VERSION="$2"; shift 2 ;;
+    *) die "Unknown argument: $1" ;;
+  esac
+done
+
+if [ -z "${TARGET_VERSION}" ]; then
+  log "Fetching latest release tag..."
+  TARGET_VERSION=$(gh release list -R "${REPO}" --limit 1 2>&1 | awk 'NR==1{print $1}')
+  if [ -z "${TARGET_VERSION}" ]; then
+    die "Could not determine latest release. Check GitHub access and repository name."
+  fi
+fi
+
+log "Target version: ${TARGET_VERSION}"
+
+# ── Read current version ─────────────────────────────────────────────────────
+
+if [ -f "${VERSION_FILE}" ]; then
+  CURRENT_VERSION=$(tr -d '[:space:]' < "${VERSION_FILE}")
+else
+  CURRENT_VERSION="(not installed)"
+fi
+
+log "Current version: ${CURRENT_VERSION}"
+
+if [ "${CURRENT_VERSION}" = "${TARGET_VERSION}" ]; then
+  log "Already on the latest version (${TARGET_VERSION}). Nothing to do."
+  exit 0
+fi
+
+# ── Download ──────────────────────────────────────────────────────────────────
+
+rm -rf "${DOWNLOAD_DIR}"
+mkdir -p "${DOWNLOAD_DIR}"
+
+log "Downloading release archive for ${TARGET_VERSION}..."
+
+gh release download "${TARGET_VERSION}" \
+  -R "${REPO}" \
+  --archive tar.gz \
+  -D "${DOWNLOAD_DIR}" 2>&1 || die "Download failed. Check your internet connection and repository access."
+
+# Find the downloaded archive
+ARCHIVE=$(find "${DOWNLOAD_DIR}" -maxdepth 1 -name '*.tar.gz' | head -1)
+if [ -z "${ARCHIVE}" ]; then
+  die "No archive found in ${DOWNLOAD_DIR} after download."
+fi
+
+log "Downloaded: ${ARCHIVE}"
+
+# ── Extract ───────────────────────────────────────────────────────────────────
+
+EXTRACT_DIR="${DOWNLOAD_DIR}/extracted"
+mkdir -p "${EXTRACT_DIR}"
+
+log "Extracting archive..."
+tar -xzf "${ARCHIVE}" -C "${EXTRACT_DIR}" 2>&1 || die "Extraction failed. Archive may be corrupt."
+
+# GitHub archives typically extract into a directory named <repo>-<tag>/
+REPO_DIR=$(find "${EXTRACT_DIR}" -maxdepth 1 -mindepth 1 -type d | head -1)
+if [ -z "${REPO_DIR}" ]; then
+  die "Could not find extracted repository directory."
+fi
+
+log "Extracted to: ${REPO_DIR}"
+
+# ── Copy skill files ──────────────────────────────────────────────────────────
+
+# Look for a skills/ subdirectory in the archive; fall back to root
+SOURCE_SKILLS=""
+if [ -d "${REPO_DIR}/skills" ]; then
+  SOURCE_SKILLS="${REPO_DIR}/skills"
+elif [ -d "${REPO_DIR}" ]; then
+  # The repo root might itself contain SKILL.md files and .yml files
+  SOURCE_SKILLS="${REPO_DIR}"
+fi
+
+if [ -z "${SOURCE_SKILLS}" ]; then
+  die "No skills directory found in release archive."
+fi
+
+log "Copying skill files from ${SOURCE_SKILLS} to ${SKILLS_DIR}..."
+
+# Use rsync if available for cleaner copy, else cp
+if command -v rsync >/dev/null 2>&1; then
+  rsync -av --exclude='.git' "${SOURCE_SKILLS}/" "${SKILLS_DIR}/" 2>&1
+else
+  cp -R "${SOURCE_SKILLS}/." "${SKILLS_DIR}/" 2>&1
+fi
+
+# ── Update version file ───────────────────────────────────────────────────────
+
+printf '%s\n' "${TARGET_VERSION}" > "${VERSION_FILE}"
+
+# Invalidate version cache so next check-version.sh run is fresh
+rm -f "${CACHE_FILE}"
+
+# ── Summary ───────────────────────────────────────────────────────────────────
+
+log ""
+log "Upgrade complete."
+log "  ${CURRENT_VERSION} → ${TARGET_VERSION}"
+log "  Changelog: https://github.com/${REPO}/releases/tag/${TARGET_VERSION}"
+log ""
+log "Installed files updated in: ${SKILLS_DIR}"
+
+# ── Cleanup ───────────────────────────────────────────────────────────────────
+
+rm -rf "${DOWNLOAD_DIR}"
+
+exit 0

package/ftm-upgrade.yml

@@ -1,2 +1,2 @@
-name: ftm-upgrade
-description: Self-upgrade mechanism for ftm skills ecosystem. Checks GitHub Releases for new versions, caches results for 60min, shows changelog, and copies updated files. Use when user says "upgrade", "update skills", "new version", "check for updates", "ftm upgrade".
+name: ftm-upgrade
+description: Self-upgrade mechanism for ftm skills ecosystem. Checks GitHub Releases for new versions, caches results for 60min, shows changelog, and copies updated files. Use when user says "upgrade", "update skills", "new version", "check for updates", "ftm upgrade".

package/ftm-verify.yml

@@ -1,2 +1,2 @@
-name: ftm-verify
-description: Comprehensive post-execution verification and auto-remediation engine using dual-model adversarial analysis. Replaces ftm-retro. After ftm-executor completes a plan, this skill runs two independent verification passes in parallel — Codex (OpenAI) and Gemini (Google) — each reading the entire codebase to check plan fulfillment, documentation fidelity, build health, test quality, and wiring integrity. Falls back to Claude subagents if either CLI is unavailable. Reconciles findings from both models, auto-remediates with parallel fix agents, and reports what was found, disagreed on, and fixed. Use when user says "verify", "is the plan done", "check everything", "verify plan", "ftm-verify", "did we miss anything", "is it complete", "validate the build", "check the plan", "verify execution", "post-execution check", or after any ftm-executor run completes. Also triggers on "retro", "retrospective", "how did that go", "execution review" since this skill supersedes ftm-retro. Even if the user just says "are we good?" after a plan execution — this is the skill.
+name: ftm-verify
+description: Comprehensive post-execution verification and auto-remediation engine using dual-model adversarial analysis. Replaces ftm-retro. After ftm-executor completes a plan, this skill runs two independent verification passes in parallel — Codex (OpenAI) and Gemini (Google) — each reading the entire codebase to check plan fulfillment, documentation fidelity, build health, test quality, and wiring integrity. Falls back to Claude subagents if either CLI is unavailable. Reconciles findings from both models, auto-remediates with parallel fix agents, and reports what was found, disagreed on, and fixed. Use when user says "verify", "is the plan done", "check everything", "verify plan", "ftm-verify", "did we miss anything", "is it complete", "validate the build", "check the plan", "verify execution", "post-execution check", or after any ftm-executor run completes. Also triggers on "retro", "retrospective", "how did that go", "execution review" since this skill supersedes ftm-retro. Even if the user just says "are we good?" after a plan execution — this is the skill.

package/ftm.yml

@@ -1,2 +1,2 @@
-name: ftm
-description: Universal entry point for all ftm skills. Routes freeform text to the right ftm skill automatically. Use when user says "/ftm" followed by anything. ftm-mind is the default cognitive entry point for all unclassified input (OODA reasoning). Explicit prefixes route directly: brainstorm, execute, debug, audit, council, intent, diagram, codex-gate, pause, resume, browse, upgrade, retro, config, mind. Also use when user is unsure which ftm skill they need.
+name: ftm
+description: Universal entry point for all ftm skills. Routes freeform text to the right ftm skill automatically. Use when user says "/ftm" followed by anything. ftm-mind is the default cognitive entry point for all unclassified input (OODA reasoning). Explicit prefixes route directly: brainstorm, execute, debug, audit, council, intent, diagram, codex-gate, pause, resume, browse, upgrade, retro, config, mind. Also use when user is unsure which ftm skill they need.

package/hooks/ftm-auto-log.sh

@@ -0,0 +1,137 @@
+#!/bin/bash
+# Hook: Auto-log progress + heartbeat for ftm
+# Triggers: UserPromptSubmit while an ftm session is active
+#
+# 1. Auto-log: reminds Claude to log progress when user reports completing something
+# 2. Task inbox: surfaces unreviewed Slack/email tasks every 10 min
+# 3. Heartbeat: every 30 min, scans task state for urgent items to surface
+#
+# Heartbeat inspired by OpenClaw's HEARTBEAT.md pattern (heartbeat.ts):
+# Periodically checks task state and prompts Claude to surface time-sensitive
+# items without the user asking.
+#
+# FILES:
+#   ~/.claude/ftm-state/blackboard/context.json  - session gate (active_task check)
+#   ~/.claude/ftm-state/.last-heartbeat           - timestamp of last heartbeat
+#   ~/.claude/ftm-state/HEARTBEAT.md              - user-maintained alert/task config
+
+FTM_STATE="$HOME/.claude/ftm-state"
+CONTEXT_JSON="$FTM_STATE/blackboard/context.json"
+
+# Check if an ftm session is active by reading context.json
+FTM_ACTIVE=$(python3 -c "
+import json, sys
+try:
+    with open('$CONTEXT_JSON') as f:
+        d = json.load(f)
+    task = d.get('current_task', {})
+    status = task.get('status', '')
+    print('1' if status not in ('', 'completed', 'none') else '0')
+except Exception:
+    print('0')
+" 2>/dev/null)
+
+if [ "$FTM_ACTIVE" != "1" ]; then
+    exit 0  # Not in active ftm session, skip
+fi
+
+# Read payload from stdin (JSON) — extract prompt for action pattern matching
+STDIN_DATA=$(cat)
+USER_MESSAGE=$(echo "$STDIN_DATA" | python3 -c "
+import sys, json
+try:
+    d = json.load(sys.stdin)
+    print(d.get('prompt', ''))
+except:
+    print('')
+" 2>/dev/null)
+# Fallback: treat stdin as raw message if JSON parse failed
+if [ -z "$USER_MESSAGE" ]; then
+    USER_MESSAGE="$STDIN_DATA"
+fi
+
+# Action indicators (what users say when they've done something)
+ACTION_PATTERNS=(
+    "^[Ii] (did|completed?|finished|fixed|sent|responded|closed|created|updated|deployed|merged|pushed|committed|tested|reviewed)"
+    "^[Jj]ust (did|completed?|finished|fixed|sent|responded|closed|created|updated|deployed|merged|pushed|committed|tested|reviewed)"
+    "^[Dd]one"
+    "^[Ff]inished"
+    "^[Cc]ompleted?"
+    "^[Ss]ent (email|message|response)"
+    "^[Rr]esponded to"
+    "^[Mm]erged"
+    "^[Pp]ushed to"
+    "^[Cc]ommitted"
+    "^[Dd]eployed"
+    "^[Ff]ixed"
+    "^[Cc]losed (ticket|issue|task)"
+    "[Tt]ask.*complete"
+    "[Tt]icket.*closed"
+)
+
+# Check if message matches any action pattern
+SHOULD_LOG=false
+for pattern in "${ACTION_PATTERNS[@]}"; do
+    if echo "$USER_MESSAGE" | grep -qE "$pattern"; then
+        SHOULD_LOG=true
+        break
+    fi
+done
+
+# Also check for follow-up questions after taking action
+if echo "$USER_MESSAGE" | grep -qE "(I|i) .* (what|should|next|now)\?"; then
+    SHOULD_LOG=true
+fi
+
+# If action detected, output logging reminder for Claude to see
+if [ "$SHOULD_LOG" = true ]; then
+    echo ""
+    echo "[Auto-log] Detected progress update. Please log this to the ftm daily log."
+    echo ""
+fi
+
+# --- Dashboard sync: surface task-state changes made outside the chat ---
+CLAUDE_SYNC_FILE="$FTM_STATE/blackboard/.runtime/claude-sync-events.txt"
+if [ -s "$CLAUDE_SYNC_FILE" ]; then
+    echo ""
+    echo "[Dashboard sync] Recent dashboard updates were written to ftm-state:"
+    head -20 "$CLAUDE_SYNC_FILE"
+    echo "Please reload task state from ftm-state and treat those updates as authoritative."
+    echo ""
+    : > "$CLAUDE_SYNC_FILE"
+fi
+
+# --- Heartbeat: periodic task/urgency check ---
+# Fires every 30 minutes. Prompts Claude to scan for time-sensitive items.
+HEARTBEAT_INTERVAL=1800  # 30 minutes in seconds
+LAST_HEARTBEAT_FILE="$FTM_STATE/.last-heartbeat"
+HEARTBEAT_MD="$FTM_STATE/HEARTBEAT.md"
+
+SHOULD_HEARTBEAT=false
+if [ -f "$LAST_HEARTBEAT_FILE" ]; then
+    LAST_BEAT=$(cat "$LAST_HEARTBEAT_FILE" 2>/dev/null || echo 0)
+    NOW=$(date +%s)
+    ELAPSED=$(( NOW - LAST_BEAT ))
+    if [ "$ELAPSED" -ge "$HEARTBEAT_INTERVAL" ]; then
+        SHOULD_HEARTBEAT=true
+    fi
+else
+    # First message of session — no heartbeat on first message, just record time
+    echo "$(date +%s)" > "$LAST_HEARTBEAT_FILE"
+fi
+
+if [ "$SHOULD_HEARTBEAT" = true ]; then
+    echo "$(date +%s)" > "$LAST_HEARTBEAT_FILE"
+    echo ""
+    echo "[HEARTBEAT — $(date '+%H:%M') check-in]: 30 minutes have passed. Briefly scan for anything time-sensitive:"
+    echo "- Check ftm-state/blackboard/context.json for deadlines or blockers that need attention."
+    if [ -f "$HEARTBEAT_MD" ]; then
+        HB_CONTENT=$(cat "$HEARTBEAT_MD" 2>/dev/null)
+        HB_ACTIONABLE=$(echo "$HB_CONTENT" | grep -v "^#" | grep -v "^[[:space:]]*$" | head -3)
+        if [ -n "$HB_ACTIONABLE" ]; then
+            echo "- HEARTBEAT.md has tasks configured — read it and follow any instructions."
+        fi
+    fi
+    echo "If nothing urgent, proceed normally. If something needs attention, surface it briefly."
+    echo ""
+fi