gitmem-mcp 1.0.0 → 1.0.1

package/hooks/scripts/post-tool-use.sh

@@ -73,11 +73,6 @@ case "$TOOL_NAME" in
         QUERY=$(parse_json "$HOOK_INPUT" ".tool_input.query")
         DETAIL="query: ${QUERY:-<no query>}"
         ;;
-    mcp__supabase__semantic_search|mcp__supabase__scar_search)
-        EVENT_TYPE="LOOKED"
-        QUERY=$(parse_json "$HOOK_INPUT" ".tool_input.query")
-        DETAIL="query: ${QUERY:-<no query>}"
-        ;;
     Bash)
         COMMAND=$(parse_json "$HOOK_INPUT" ".tool_input.command")
         if echo "$COMMAND" | grep -qE '(git\s+push|git\s+tag|npm\s+publish|npx\s+supabase\s+db\s+push|deploy|supabase\s+functions\s+deploy)'; then
@@ -85,17 +80,6 @@ case "$TOOL_NAME" in
             DETAIL="command: $COMMAND"
         fi
         ;;
-    mcp__linear__update_issue)
-        STATE=$(parse_json "$HOOK_INPUT" ".tool_input.state")
-        STATE_LOWER=$(echo "$STATE" | tr '[:upper:]' '[:lower:]')
-        case "$STATE_LOWER" in
-            done|complete|completed|closed)
-                EVENT_TYPE="ACTION"
-                ISSUE_ID=$(parse_json "$HOOK_INPUT" ".tool_input.id")
-                DETAIL="issue: ${ISSUE_ID:-unknown} -> ${STATE}"
-                ;;
-        esac
-        ;;
     Write|Edit)
         FILE_PATH=$(parse_json "$HOOK_INPUT" ".tool_input.file_path")
         if echo "$FILE_PATH" | grep -qE '\.(sql|env)$'; then

package/hooks/scripts/recall-check.sh

@@ -15,7 +15,6 @@
 #
 # Filter layer: Only triggers on consequential actions:
 #   - Bash: git push, git tag, npm publish, deploy commands
-#   - Linear: state changes to Done/Complete
 #   - Write/Edit: .sql migrations, .env files
 #
 # Input: JSON via stdin with tool_name and tool_input
@@ -103,16 +102,6 @@ case "$TOOL_NAME" in
             IS_CONSEQUENTIAL=true
         fi
         ;;
-    mcp__linear__update_issue)
-        # Check for Done/Complete state transitions
-        STATE=$(parse_json "$HOOK_INPUT" ".tool_input.state")
-        STATE_LOWER=$(echo "$STATE" | tr '[:upper:]' '[:lower:]')
-        case "$STATE_LOWER" in
-            done|complete|completed|closed)
-                IS_CONSEQUENTIAL=true
-                ;;
-        esac
-        ;;
     Write|Edit)
         # Check for sensitive file types
         FILE_PATH=$(parse_json "$HOOK_INPUT" ".tool_input.file_path")

package/hooks/scripts/session-close-check.sh

@@ -101,7 +101,7 @@ if [ "$SESSION_STARTED" = "true" ]; then
     cat <<'HOOKJSON'
 {
   "decision": "block",
-  "reason": "GITMEM SESSION STILL OPEN: You have an active GitMem session that hasn't been closed. Please run `session_close` (or `gm-close`) before ending the session. This persists your session data, captures learnings, and records scar usage.\n\nIf this is a trivial session (< 30min, purely exploratory), use close_type: 'quick'. Otherwise use 'standard' for full closing reflection."
+  "reason": "GITMEM SESSION STILL OPEN — Run the standard closing ceremony:\n\n1. YOU (the agent) ANSWER these 7 reflection questions based on the session. Display your answers to the human:\n   - what_broke: What broke that you didn't expect?\n   - what_took_longer: What took longer than it should have?\n   - do_differently: What would you do differently next time?\n   - what_worked: What pattern or approach worked well?\n   - wrong_assumption: What assumption was wrong?\n   - scars_applied: Which scars or institutional knowledge did you apply?\n   - institutional_memory: What from this session should be captured?\n\n2. ASK the human: 'Any corrections or additions to my answers?' WAIT for their response.\n\n3. WRITE structured payload to .gitmem/closing-payload.json with closing_reflection (7 fields above, incorporating human corrections), task_completion (timestamps), and human_corrections.\n\n4. CALL session_close with session_id and close_type: 'standard'.\n\nFor trivial sessions (< 30min, exploratory only), use close_type: 'quick' instead — no questions needed."
 }
 HOOKJSON
     exit 0

package/hooks/scripts/session-start.sh

@@ -98,7 +98,7 @@ fi
 if [ "$GITMEM_DETECTED" = "false" ]; then
     for SERVER_PATH in \
         "${GITMEM_SERVER_PATH:-}" \
-        "/workspace/gitmem/dist/index.js" \
+        "$(which gitmem-mcp 2>/dev/null || echo '')" \
         "$(which gitmem 2>/dev/null || echo '')"; do
         if [ -n "$SERVER_PATH" ] && [ -f "$SERVER_PATH" ]; then
             GITMEM_DETECTED=true
@@ -108,6 +108,61 @@ if [ "$GITMEM_DETECTED" = "false" ]; then
     done
 fi
 
+# ============================================================================
+# MCP Server Readiness Gate
+# ============================================================================
+#
+# Problem: MCP servers start asynchronously when Claude Code launches.
+# If the user types fast, their first message is processed before gitmem's
+# MCP server finishes connecting. This hook acts as a gate — by waiting here,
+# we force Claude Code to delay processing the first user message until
+# the gitmem server is likely ready.
+#
+# Strategy: Poll for the gitmem node process, then wait a buffer for
+# MCP handshake completion. Total budget: ~8s (within 10s hook timeout).
+
+if [ "$GITMEM_DETECTED" = "true" ]; then
+    GATE_START=$(date +%s%N 2>/dev/null || date +%s)
+    MAX_WAIT_SECS=7
+    POLL_INTERVAL=0.3
+    HANDSHAKE_BUFFER=0.5
+    SERVER_FOUND=false
+
+    echo "[$(date)] MCP readiness gate: waiting up to ${MAX_WAIT_SECS}s for gitmem server process..." >> "$PLUGIN_LOG"
+
+    # Build list of patterns to match the gitmem server process
+    # Covers: direct node invocation, npx, and symlinked binaries
+    GITMEM_PATTERNS=(
+        "gitmem/dist/index.js"
+        "gitmem-mcp"
+    )
+
+    # Poll every 0.3s. Max iterations = MAX_WAIT_SECS / 0.3 ≈ 23
+    MAX_POLLS=$(( MAX_WAIT_SECS * 10 / 3 ))
+    POLL=0
+    while [ "$POLL" -lt "$MAX_POLLS" ]; do
+        for PATTERN in "${GITMEM_PATTERNS[@]}"; do
+            if pgrep -f "$PATTERN" > /dev/null 2>&1; then
+                SERVER_FOUND=true
+                WAIT_SECS=$(( POLL * 3 / 10 ))
+                echo "[$(date)] MCP readiness gate: gitmem process found (pattern: $PATTERN) after ~${WAIT_SECS}.$(( POLL * 3 % 10 ))s" >> "$PLUGIN_LOG"
+                # Buffer for MCP protocol handshake to complete
+                sleep "$HANDSHAKE_BUFFER"
+                break 2
+            fi
+        done
+        sleep "$POLL_INTERVAL"
+        POLL=$((POLL + 1))
+    done
+
+    if [ "$SERVER_FOUND" = "false" ]; then
+        echo "[$(date)] MCP readiness gate: gitmem process NOT found after ${MAX_WAIT_SECS}s — proceeding anyway (config detected, server may use different process name)" >> "$PLUGIN_LOG"
+    fi
+
+    GATE_END=$(date +%s%N 2>/dev/null || date +%s)
+    echo "[$(date)] MCP readiness gate completed" >> "$PLUGIN_LOG"
+fi
+
 # ============================================================================
 # Create session state directory
 # ============================================================================
@@ -126,27 +181,48 @@ echo "0" > "$STATE_DIR/last_nag_time"
 if [ "$GITMEM_DETECTED" = "true" ]; then
     echo "[$(date)] Gitmem DETECTED via ${DETECT_SOURCE} — instructing agent to call session_start via MCP" >> "$PLUGIN_LOG"
 
-    # Always instruct agent to call ToolSearch + session_start via MCP.
+    # Instruct agent to call session_start via MCP.
     # The MCP server creates sessions with its own PID, enabling multi-session
     # isolation (Phase 1, GIT-19). CLI binary invocation was removed because
     # the CLI PID dies immediately, defeating PID-based session identity.
-    cat <<'HOOK_MSG'
+    #
+    # NOTE: ToolSearch (tengu_mcp_tool_search) was removed. MCP tools load
+    # eagerly now — no deferral step needed. Just call session_start directly.
+    #
+    # Read project from .gitmem/config.json if available.
+    # Fallback: let session_start default (reads config.json server-side too).
+    GITMEM_PROJECT=""
+    if [ -f ".gitmem/config.json" ] && command -v jq &>/dev/null; then
+        GITMEM_PROJECT=$(jq -r '.project // empty' .gitmem/config.json 2>/dev/null || true)
+    fi
+
+    if [ -n "$GITMEM_PROJECT" ]; then
+        echo "[$(date)] Project from config: ${GITMEM_PROJECT}" >> "$PLUGIN_LOG"
+        cat <<HOOK_MSG
 SESSION START — ACTIVE
 
-All MCP tools are deferred. You MUST load them first via ToolSearch.
+Call mcp__gitmem__session_start(project: "${GITMEM_PROJECT}") as your FIRST tool call.
+HOOK_MSG
+    else
+        cat <<'HOOK_MSG'
+SESSION START — ACTIVE
 
-Step 1 — Load tools:
-  ToolSearch(query: "+gitmem session", max_results: 5)
+Call mcp__gitmem__session_start() as your FIRST tool call.
+HOOK_MSG
+    fi
 
-Step 2 — Start session:
-  mcp__gitmem__session_start(project: "orchestra_dev")
+    cat <<'HOOK_MSG2'
 
 IMPORTANT:
-- Do NOT skip Step 1. Without it, session_start will not exist as a callable tool.
-- Do NOT say "tools aren't available" — ToolSearch makes them available.
-- Do NOT respond to the user until both steps complete.
-- Execute Step 1 and Step 2 as your FIRST two tool calls of the session.
-HOOK_MSG
+- Do NOT respond to the user until session_start completes.
+- Do NOT diagnose tool availability — gitmem tools are loaded via --mcp-config.
+- If session_start fails, report the error directly instead of investigating.
+
+You have persistent memory. session_start just loaded context from your last
+session — open threads, recent decisions, what was learned. This compounds
+every session. Use recall before tasks to see what past sessions discovered.
+The more you use it, the better it gets.
+HOOK_MSG2
 else
     echo "[$(date)] Gitmem NOT detected (checked: project .mcp.json, mcp-config, ~/.claude.json, disk)" >> "$PLUGIN_LOG"
     echo "GITMEM PLUGIN: GitMem MCP server not detected. Session lifecycle hooks are inactive. To enable, ensure gitmem is configured via --mcp-config, project .mcp.json, or set GITMEM_ENABLED=true."

package/hooks/tests/test-hooks.sh

@@ -456,22 +456,7 @@ else
          "exit=$EXIT_CODE, file=$([ -f $AUDIT_FILE ] && cat $AUDIT_FILE || echo 'missing')"
 fi
 
-# Test 4.3: semantic_search call → LOOKED event logged
-setup_state 0 0
-create_session_registry "test-session"
-rm -f "/tmp/gitmem-hooks-test-$$/audit.jsonl"
-OUTPUT=$(echo '{"tool_name":"mcp__supabase__semantic_search","tool_input":{"query":"hook enforcement"}}' | \
-    bash "$SCRIPT_DIR/scripts/post-tool-use.sh" 2>/dev/null)
-
-if [ -f "$AUDIT_FILE" ] && grep -q '"type":"LOOKED"' "$AUDIT_FILE" && grep -q 'semantic_search' "$AUDIT_FILE"; then
-    pass "semantic_search → LOOKED event in audit.jsonl"
-else
-    fail "semantic_search → LOOKED event" \
-         "audit.jsonl contains LOOKED + semantic_search" \
-         "$([ -f $AUDIT_FILE ] && cat $AUDIT_FILE || echo 'missing')"
-fi
-
-# Test 4.4: Consequential Bash (git push) → ACTION event logged
+# Test 4.3: Consequential Bash (git push) → ACTION event logged
 setup_state 0 0
 create_session_registry "test-session"
 rm -f "/tmp/gitmem-hooks-test-$$/audit.jsonl"
@@ -486,7 +471,7 @@ else
          "$([ -f $AUDIT_FILE ] && cat $AUDIT_FILE || echo 'missing')"
 fi
 
-# Test 4.5: Non-consequential Bash (ls) → no audit entry
+# Test 4.4: Non-consequential Bash (ls) → no audit entry
 setup_state 0 0
 create_session_registry "test-session"
 rm -f "/tmp/gitmem-hooks-test-$$/audit.jsonl"
@@ -502,38 +487,7 @@ else
          "exit=$EXIT_CODE, audit=$([ -f $AUDIT_FILE ] && cat $AUDIT_FILE || echo 'missing')"
 fi
 
-# Test 4.6: Linear update_issue to Done → ACTION event
-setup_state 0 0
-create_session_registry "test-session"
-rm -f "/tmp/gitmem-hooks-test-$$/audit.jsonl"
-OUTPUT=$(echo '{"tool_name":"mcp__linear__update_issue","tool_input":{"id":"OD-100","state":"Done"}}' | \
-    bash "$SCRIPT_DIR/scripts/post-tool-use.sh" 2>/dev/null)
-
-if [ -f "$AUDIT_FILE" ] && grep -q '"type":"ACTION"' "$AUDIT_FILE" && grep -q 'OD-100' "$AUDIT_FILE"; then
-    pass "Linear update_issue Done → ACTION event"
-else
-    fail "Linear Done → ACTION event" \
-         "audit.jsonl contains ACTION + OD-100" \
-         "$([ -f $AUDIT_FILE ] && cat $AUDIT_FILE || echo 'missing')"
-fi
-
-# Test 4.7: Linear update_issue to non-Done state → no audit entry
-setup_state 0 0
-create_session_registry "test-session"
-rm -f "/tmp/gitmem-hooks-test-$$/audit.jsonl"
-OUTPUT=$(echo '{"tool_name":"mcp__linear__update_issue","tool_input":{"id":"OD-100","state":"In Progress"}}' | \
-    bash "$SCRIPT_DIR/scripts/post-tool-use.sh" 2>/dev/null)
-EXIT_CODE=$?
-
-if [ $EXIT_CODE -eq 0 ] && [ ! -f "$AUDIT_FILE" ]; then
-    pass "Linear update to In Progress → no audit entry"
-else
-    fail "Linear non-Done → no audit" \
-         "no audit.jsonl" \
-         "audit=$([ -f $AUDIT_FILE ] && cat $AUDIT_FILE || echo 'missing')"
-fi
-
-# Test 4.8: Write .sql file → ACTION event
+# Test 4.5: Write .sql file → ACTION event
 setup_state 0 0
 create_session_registry "test-session"
 rm -f "/tmp/gitmem-hooks-test-$$/audit.jsonl"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gitmem-mcp",
-  "version": "1.0.0",
-  "description": "Institutional memory for AI coding agents. Never repeat the same mistake.",
+  "version": "1.0.1",
+  "description": "Institutional memory for AI coding agents. Memory that compounds.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -33,6 +33,7 @@
     "zod": "^3.22.0"
   },
   "devDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.38",
     "@testcontainers/postgresql": "^10.6.0",
     "@types/node": "^20.0.0",
     "@types/pg": "^8.10.0",

package/schema/setup.sql

@@ -10,7 +10,7 @@ CREATE EXTENSION IF NOT EXISTS vector;
 -- ============================================================================
 CREATE TABLE IF NOT EXISTS gitmem_learnings (
   id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  learning_type TEXT NOT NULL CHECK (learning_type IN ('scar', 'win', 'pattern')),
+  learning_type TEXT NOT NULL CHECK (learning_type IN ('scar', 'win', 'pattern', 'anti_pattern')),
   title TEXT NOT NULL,
   description TEXT NOT NULL,
   severity TEXT CHECK (severity IN ('critical', 'high', 'medium', 'low')),