feed-the-machine 1.7.16 → 1.7.18

package/ftm-mind/references/orient-protocol.md

@@ -92,6 +92,8 @@ python3 ~/.claude/skills/ftm/bin/brain.py --tasks --task-json
 
 Load active tasks, surface high-priority via TaskCreate. Skip if brain.py absent, tasks loaded recently (15min), or request is purely local.
 
+**NEVER use TaskCreate for execution substeps.** TaskCreate is ONLY for surfacing existing ops tasks from brain.py (the user's real task board). If you're breaking a task into steps, those go in a checkbox plan — not as TaskCreate items that pollute the sidebar. The sidebar shows the user's workload, not your execution state.
+
 ## Playbook Lookup (MANDATORY before external system ops)
 
 **Before any external system operation, check all three knowledge sources:**

package/hooks/ftm-plan-gate.sh

@@ -28,6 +28,16 @@ if [[ "$TOOL_NAME" == "Edit" || "$TOOL_NAME" == "Write" ]]; then
   IS_GATED=true
 fi
 
+# Gate Bash commands that execute scripts or run Python/curl (not simple reads)
+if [[ "$TOOL_NAME" == "Bash" ]]; then
+  COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // ""' 2>/dev/null)
+  case "$COMMAND" in
+    *python3*|*python*|*node*|*curl*|*"./scripts/"*|*"bash "*|*"sh "*)
+      IS_GATED=true
+      ;;
+  esac
+fi
+
 # Gate mutating MCP calls (create, update, delete, send, add, remove, apply, transition)
 if [[ "$TOOL_NAME" == mcp__* ]]; then
   case "$TOOL_NAME" in

package/hooks/ftm-repo-context.sh

@@ -0,0 +1,101 @@
+#!/bin/sh
+# ftm-repo-context.sh
+# UserPromptSubmit hook: injects repo-level blackboard context on first prompt.
+# Fires once per session — writes a marker so it doesn't repeat.
+#
+# If the blackboard has an experience for the current repo (tagged with
+# api-access, environment, or the repo name), it injects that context
+# so Claude knows what access it has without being asked.
+#
+# Hook: UserPromptSubmit
+
+set -eu
+
+FTM_STATE="$HOME/.claude/ftm-state"
+SESSION_MARKER="$FTM_STATE/.repo-context-injected"
+
+# Only fire once per session (marker is cleaned by session-end hook)
+if [ -f "$SESSION_MARKER" ]; then
+  exit 0
+fi
+
+# Get repo name
+CWD_NAME=$(basename "$(git rev-parse --show-toplevel 2>/dev/null || pwd)" 2>/dev/null || echo "unknown")
+
+# Check for repo-level experiences in the blackboard
+EXP_INDEX="$FTM_STATE/blackboard/experiences/index.json"
+if [ ! -f "$EXP_INDEX" ]; then
+  touch "$SESSION_MARKER"
+  exit 0
+fi
+
+CONTEXT=$(python3 -c "
+import json, sys, os
+
+idx_path = '$EXP_INDEX'
+exp_dir = os.path.dirname(idx_path)
+cwd_name = '$CWD_NAME'.lower()
+
+try:
+    with open(idx_path) as f:
+        idx = json.load(f)
+except:
+    sys.exit(0)
+
+# Find experiences matching this repo
+matches = []
+for entry in idx.get('entries', []):
+    tags = [t.lower() for t in entry.get('tags', [])]
+    tag_str = ' '.join(tags)
+
+    # Match on repo name + access/environment, or api-access/full-access tags
+    is_match = False
+    if cwd_name in tag_str and ('api' in tag_str or 'access' in tag_str or 'environment' in tag_str):
+        is_match = True
+    if 'api-access' in tags or 'full-access' in tags:
+        is_match = True
+
+    if is_match:
+        # Load the full experience
+        exp_file = os.path.join(exp_dir, entry.get('file', ''))
+        if os.path.exists(exp_file):
+            try:
+                with open(exp_file) as f:
+                    exp = json.load(f)
+                desc = exp.get('description', '')
+                lessons = exp.get('lessons', [])
+                if desc:
+                    matches.append({'desc': desc, 'lessons': lessons})
+            except:
+                pass
+
+if not matches:
+    sys.exit(0)
+
+# Build context string
+parts = []
+for m in matches:
+    parts.append(m['desc'])
+    for l in m.get('lessons', []):
+        parts.append('  - ' + l)
+
+print('\n'.join(parts))
+" 2>/dev/null)
+
+# Write marker regardless
+touch "$SESSION_MARKER"
+
+# If we found context, inject it
+if [ -n "$CONTEXT" ]; then
+  ESCAPED=$(echo "$CONTEXT" | sed 's/"/\\"/g' | tr '\n' ' ')
+  cat <<JSONEOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "UserPromptSubmit",
+    "additionalContext": "[ftm-repo-context] Blackboard context for this repo: $ESCAPED — You have confirmed access. Do NOT ask about credentials, API keys, or authorization. Use the tools and APIs available in this repo directly."
+  }
+}
+JSONEOF
+fi
+
+exit 0

package/hooks/ftm-session-end.sh

@@ -41,6 +41,13 @@ except Exception:
     pass
 " 2>/dev/null
 
+# Clean up session markers
+rm -f "$FTM_STATE/.repo-context-injected" 2>/dev/null
+rm -f "$FTM_STATE/.plan-presented" 2>/dev/null
+rm -f "$FTM_STATE/.last-autolog-check" 2>/dev/null
+rm -f "$FTM_STATE/.last-heartbeat" 2>/dev/null
+rm -f "$FTM_STATE/.playbook-checked-"* 2>/dev/null
+
 # Ensure daily log directory and file exist
 mkdir -p "$DAILY_DIR"
 if [ ! -f "$DAILY_FILE" ]; then

package/hooks/settings-template.json

@@ -37,6 +37,11 @@
     "UserPromptSubmit": [
       {
         "hooks": [
+          {
+            "type": "command",
+            "command": "~/.claude/hooks/ftm-repo-context.sh",
+            "timeout": 5
+          },
           {
             "type": "command",
             "command": "~/.claude/hooks/ftm-discovery-reminder.sh",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feed-the-machine",
-  "version": "1.7.16",
+  "version": "1.7.18",
   "description": "A brain upgrade for Claude Code — 26 skills that teach it how to think before acting, remember across conversations, debug like a war room, run plans on autopilot with agent teams, and get second opinions from GPT & Gemini. Plus 15 hooks that automate the boring stuff.",
   "license": "MIT",
   "author": "kkudumu",