feed-the-machine 1.5.0 → 1.6.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-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