@memnexus-ai/mx-agent-cli 0.1.166 → 0.1.167

package/dist/agent-config/hooks/auto-capture-precompact.sh

@@ -0,0 +1,176 @@
+#!/bin/bash
+# auto-capture-precompact.sh — Automatic memory capture before context compaction
+#
+# The highest-value automatic capture signal: fires when ~95% of context window
+# is full, meaning rich context (decisions, debugging sessions, architecture
+# discussions) is about to be lost forever.
+#
+# Unlike auto-checkpoint.sh (which saves a resumption checkpoint), this hook
+# extracts structured knowledge — decisions, problems solved, patterns — and
+# saves it as a permanent memory.
+#
+# Fires on: PreCompact
+# Input: JSON on stdin with transcript_path, session_id, trigger
+# Output: none (side-effect only — saves memory via mx CLI)
+# Exit: always 0 (never blocks compaction)
+
+# Fail-open: any error -> allow compaction without saving
+trap 'exit 0' ERR
+
+# ── 1. Parse hook input ──────────────────────────────────────────────────
+INPUT=$(cat)
+
+TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // empty' 2>/dev/null)
+_SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty' 2>/dev/null)
+
+# Skip if no transcript or required tools missing
+if [[ -z "$TRANSCRIPT_PATH" || ! -f "$TRANSCRIPT_PATH" ]]; then
+  exit 0
+fi
+command -v jq >/dev/null 2>&1 || exit 0
+command -v mx >/dev/null 2>&1 || exit 0
+
+# ── 2. Extract structured data from transcript ──────────────────────────
+
+tmpdir=$(mktemp -d)
+trap 'rm -rf "$tmpdir"; exit 0' EXIT ERR
+
+# Total line count (proxy for session depth)
+_TOTAL_LINES=$(wc -l < "$TRANSCRIPT_PATH" 2>/dev/null || echo "0")
+
+# Files modified (Write/Edit tool calls)
+FILES_MODIFIED=$(jq -r '
+  select(.type == "assistant") |
+  .message.content[]? |
+  select(.type == "tool_use" and (.name == "Write" or .name == "Edit")) |
+  .input.file_path // empty
+' "$TRANSCRIPT_PATH" 2>/dev/null | grep -v '^$' | sort -u | head -30)
+
+# Files read (Read tool calls — indicates areas of investigation)
+FILES_READ=$(jq -r '
+  select(.type == "assistant") |
+  .message.content[]? |
+  select(.type == "tool_use" and .name == "Read") |
+  .input.file_path // empty
+' "$TRANSCRIPT_PATH" 2>/dev/null | grep -v '^$' | sort | uniq -c | sort -rn | head -15 | awk '{print $2}')
+
+# Bash commands run (significant actions)
+BASH_COMMANDS=$(jq -r '
+  select(.type == "assistant") |
+  .message.content[]? |
+  select(.type == "tool_use" and .name == "Bash") |
+  .input.command // empty
+' "$TRANSCRIPT_PATH" 2>/dev/null | grep -v '^$' | grep -vE '^(ls|pwd|echo|cat |head |tail )' | tail -20)
+
+# Git activity
+GIT_COMMITS=$(echo "$BASH_COMMANDS" | grep -oE 'git commit' | wc -l | tr -d ' ')
+GIT_PUSHES=$(echo "$BASH_COMMANDS" | grep -oE 'git push' | wc -l | tr -d ' ')
+PR_CREATES=$(echo "$BASH_COMMANDS" | grep -oE 'gh pr create' | wc -l | tr -d ' ')
+PR_MERGES=$(echo "$BASH_COMMANDS" | grep -oE 'gh pr merge' | wc -l | tr -d ' ')
+
+# PR and issue references from all text content
+ALL_TEXT=$(jq -r '
+  select(.type == "user" or .type == "assistant") |
+  .message.content |
+  if type == "array" then
+    [.[] | select(.type == "text") | .text] | join("\n")
+  elif type == "string" then .
+  else empty end
+' "$TRANSCRIPT_PATH" 2>/dev/null)
+
+GH_REFS=$(echo "$ALL_TEXT" | grep -oE '(PR |#)[0-9]+' 2>/dev/null | sort -u | head -15 | tr '\n' ', ' | sed 's/,$//')
+
+# User messages (to understand intent and topics)
+USER_MESSAGES=$(jq -r '
+  select(.type == "user") |
+  .message.content |
+  if type == "array" then
+    [.[] | select(.type == "text") | .text] | join("\n")
+  elif type == "string" then .
+  else empty end
+' "$TRANSCRIPT_PATH" 2>/dev/null | head -c 3000)
+
+# Last few assistant text blocks (conclusions/results)
+RECENT_RESULTS=$(tail -100 "$TRANSCRIPT_PATH" | jq -r '
+  select(.type == "assistant") |
+  .message.content |
+  if type == "array" then
+    [.[] | select(.type == "text") | .text] | join("\n")
+  elif type == "string" then .
+  else empty end
+' 2>/dev/null | tail -c 2000)
+
+# Tool usage summary
+TOOL_SUMMARY=$(jq -r '
+  select(.type == "assistant") |
+  .message.content[]? |
+  select(.type == "tool_use") | .name
+' "$TRANSCRIPT_PATH" 2>/dev/null | sort | uniq -c | sort -rn | head -10 | awk '{printf "%s(%d) ", $2, $1}')
+
+# ── 3. Significance filter ───────────────────────────────────────────────
+# Skip if session was trivial (very few tool calls, no files modified)
+TOOL_COUNT=$(jq -r '
+  select(.type == "assistant") |
+  .message.content[]? |
+  select(.type == "tool_use") | .name
+' "$TRANSCRIPT_PATH" 2>/dev/null | wc -l | tr -d ' ')
+
+if [[ "$TOOL_COUNT" -lt 5 && -z "$FILES_MODIFIED" ]]; then
+  # Trivial session — not worth capturing
+  exit 0
+fi
+
+# ── 4. Build structured memory content ───────────────────────────────────
+WORKTREE_NAME="${CLAUDE_WORKTREE_NAME:-unknown}"
+GIT_BRANCH="${CLAUDE_WORKTREE_BRANCH:-$(git branch --show-current 2>/dev/null || echo 'unknown')}"
+
+# Build files list
+MOD_LIST=""
+if [[ -n "$FILES_MODIFIED" ]]; then
+  MOD_LIST=$(echo "$FILES_MODIFIED" | sed 's|^/workspace/[^/]*/||' | sed 's/^/- /')
+fi
+
+READ_LIST=""
+if [[ -n "$FILES_READ" ]]; then
+  READ_LIST=$(echo "$FILES_READ" | sed 's|^/workspace/[^/]*/||' | head -10 | sed 's/^/- /')
+fi
+
+# Build activity summary
+ACTIVITY=""
+[[ "$GIT_COMMITS" -gt 0 ]] && ACTIVITY="${ACTIVITY}${GIT_COMMITS} commits, "
+[[ "$GIT_PUSHES" -gt 0 ]] && ACTIVITY="${ACTIVITY}${GIT_PUSHES} pushes, "
+[[ "$PR_CREATES" -gt 0 ]] && ACTIVITY="${ACTIVITY}${PR_CREATES} PRs created, "
+[[ "$PR_MERGES" -gt 0 ]] && ACTIVITY="${ACTIVITY}${PR_MERGES} PRs merged, "
+ACTIVITY="${ACTIVITY}${TOOL_COUNT} tool calls"
+
+CONTENT="[Auto-Captured] Session context before compaction — ${WORKTREE_NAME}
+
+Branch: ${GIT_BRANCH}
+Activity: ${ACTIVITY}
+GitHub refs: ${GH_REFS:-none}
+
+Files modified:
+${MOD_LIST:-None}
+
+Files investigated:
+${READ_LIST:-None}
+
+Tools used: ${TOOL_SUMMARY}
+
+What the user was working on:
+$(echo "$USER_MESSAGES" | head -c 1500)
+
+Recent results/conclusions:
+$(echo "$RECENT_RESULTS" | head -c 1500)"
+
+# Truncate total content
+CONTENT=$(echo "$CONTENT" | head -c 6000)
+
+# ── 5. Save memory ──────────────────────────────────────────────────────
+mx memories create \
+  --conversation-id "NEW" \
+  --content "$CONTENT" \
+  --topics "auto-captured,context-compaction" \
+  >/dev/null 2>&1 || true
+
+exit 0

package/dist/agent-config/hooks/auto-capture-session-end.sh

@@ -0,0 +1,178 @@
+#!/bin/bash
+# auto-capture-session-end.sh — Automatic memory capture on session exit
+#
+# Fires when the user exits a Claude Code session. Creates a session-level
+# summary memory capturing what was accomplished, key decisions, and next steps.
+#
+# This is the "wrap-up" signal — holistic view of the session that individual
+# turn-level captures would miss.
+#
+# Fires on: Stop (used as session-end proxy — fires on every turn, but we
+#           only save if enough work was done since last save)
+# Input: JSON on stdin with transcript_path, session_id
+# Output: none (side-effect only — saves memory via mx CLI)
+# Exit: always 0 (never blocks)
+
+# Fail-open: any error -> allow session to end normally
+trap 'exit 0' ERR
+
+# ── 1. Parse hook input ──────────────────────────────────────────────────
+INPUT=$(cat)
+
+TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // empty' 2>/dev/null)
+_SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty' 2>/dev/null)
+STOP_HOOK_ACTIVE=$(echo "$INPUT" | jq -r '.stop_hook_active // false' 2>/dev/null)
+
+# Skip if already in a hook loop
+if [[ "$STOP_HOOK_ACTIVE" == "true" ]]; then
+  exit 0
+fi
+
+# Skip if no transcript or required tools missing
+if [[ -z "$TRANSCRIPT_PATH" || ! -f "$TRANSCRIPT_PATH" ]]; then
+  exit 0
+fi
+command -v jq >/dev/null 2>&1 || exit 0
+command -v mx >/dev/null 2>&1 || exit 0
+
+# ── 2. Debounce — only save periodically, not every turn ─────────────────
+WORKTREE_NAME="${CLAUDE_WORKTREE_NAME:-unknown}"
+STATE_FILE="/tmp/.mx-session-capture-${WORKTREE_NAME}"
+CURRENT_LINES=$(wc -l < "$TRANSCRIPT_PATH" 2>/dev/null || echo "0")
+
+# Check how many lines since last save
+LAST_SAVED_LINES=0
+if [[ -f "$STATE_FILE" ]]; then
+  LAST_SAVED_LINES=$(cat "$STATE_FILE" 2>/dev/null || echo "0")
+fi
+
+LINES_SINCE_SAVE=$((CURRENT_LINES - LAST_SAVED_LINES))
+
+# Only save if significant work has happened (>100 transcript lines since last save)
+# This prevents saving on every trivial stop event
+if [[ "$LINES_SINCE_SAVE" -lt 100 ]]; then
+  exit 0
+fi
+
+# ── 3. Extract session summary data ──────────────────────────────────────
+
+tmpdir=$(mktemp -d)
+trap 'rm -rf "$tmpdir"; exit 0' EXIT ERR
+
+# Only look at lines since last save
+OFFSET=$((LAST_SAVED_LINES + 1))
+if [[ "$LAST_SAVED_LINES" -gt 0 ]]; then
+  SEGMENT=$(tail -n +${OFFSET} "$TRANSCRIPT_PATH")
+else
+  SEGMENT=$(cat "$TRANSCRIPT_PATH")
+fi
+
+# Files modified in this segment
+FILES_MODIFIED=$(echo "$SEGMENT" | jq -r '
+  select(.type == "assistant") |
+  .message.content[]? |
+  select(.type == "tool_use" and (.name == "Write" or .name == "Edit")) |
+  .input.file_path // empty
+' 2>/dev/null | grep -v '^$' | sort -u | head -20)
+
+# Tool call count
+TOOL_COUNT=$(echo "$SEGMENT" | jq -r '
+  select(.type == "assistant") |
+  .message.content[]? |
+  select(.type == "tool_use") | .name
+' 2>/dev/null | wc -l | tr -d ' ')
+
+# Skip if segment was trivial
+if [[ "$TOOL_COUNT" -lt 5 && -z "$FILES_MODIFIED" ]]; then
+  # Update state but don't save — avoids re-checking trivial segments
+  echo "$CURRENT_LINES" > "$STATE_FILE" 2>/dev/null || true
+  exit 0
+fi
+
+# Git activity in this segment
+BASH_COMMANDS=$(echo "$SEGMENT" | jq -r '
+  select(.type == "assistant") |
+  .message.content[]? |
+  select(.type == "tool_use" and .name == "Bash") |
+  .input.command // empty
+' 2>/dev/null)
+
+GIT_COMMITS=$(echo "$BASH_COMMANDS" | grep -cE 'git commit' 2>/dev/null || echo "0")
+PR_REFS=$(echo "$BASH_COMMANDS" | grep -oE 'gh pr (create|merge) [^\n]*' 2>/dev/null | head -5)
+
+# User messages (intent)
+USER_MESSAGES=$(echo "$SEGMENT" | jq -r '
+  select(.type == "user") |
+  .message.content |
+  if type == "array" then
+    [.[] | select(.type == "text") | .text] | join("\n")
+  elif type == "string" then .
+  else empty end
+' 2>/dev/null | head -c 2000)
+
+# Recent assistant conclusions
+RECENT_TEXT=$(echo "$SEGMENT" | tail -50 | jq -r '
+  select(.type == "assistant") |
+  .message.content |
+  if type == "array" then
+    [.[] | select(.type == "text") | .text] | join("\n")
+  elif type == "string" then .
+  else empty end
+' 2>/dev/null | tail -c 1500)
+
+# PR and issue references
+GH_REFS=$(echo "$SEGMENT" | jq -r '
+  select(.type == "user" or .type == "assistant") |
+  .message.content |
+  if type == "array" then
+    [.[] | select(.type == "text") | .text] | join("\n")
+  elif type == "string" then .
+  else empty end
+' 2>/dev/null | grep -oE '(PR |#)[0-9]+' | sort -u | head -10 | tr '\n' ', ' | sed 's/,$//')
+
+# ── 4. Build session summary ─────────────────────────────────────────────
+GIT_BRANCH="${CLAUDE_WORKTREE_BRANCH:-$(git branch --show-current 2>/dev/null || echo 'unknown')}"
+
+MOD_LIST=""
+if [[ -n "$FILES_MODIFIED" ]]; then
+  MOD_LIST=$(echo "$FILES_MODIFIED" | sed 's|^/workspace/[^/]*/||' | sed 's/^/- /')
+fi
+
+CONTENT="[Auto-Captured] Session activity — ${WORKTREE_NAME}
+
+Branch: ${GIT_BRANCH}
+Commits: ${GIT_COMMITS}
+Tool calls: ${TOOL_COUNT}
+GitHub refs: ${GH_REFS:-none}
+
+Files modified:
+${MOD_LIST:-None}
+
+What was worked on:
+$(echo "$USER_MESSAGES" | head -c 1200)
+
+Outcomes:
+$(echo "$RECENT_TEXT" | head -c 1200)"
+
+# Add PR activity if any
+if [[ -n "$PR_REFS" ]]; then
+  CONTENT="${CONTENT}
+
+PR activity:
+${PR_REFS}"
+fi
+
+# Truncate
+CONTENT=$(echo "$CONTENT" | head -c 5000)
+
+# ── 5. Save memory ──────────────────────────────────────────────────────
+mx memories create \
+  --conversation-id "NEW" \
+  --content "$CONTENT" \
+  --topics "auto-captured,session-summary" \
+  >/dev/null 2>&1 || true
+
+# ── 6. Update state ──────────────────────────────────────────────────────
+echo "$CURRENT_LINES" > "$STATE_FILE" 2>/dev/null || true
+
+exit 0

package/dist/agent-config/hooks/auto-checkpoint.sh

@@ -0,0 +1,102 @@
+#!/bin/bash
+# auto-checkpoint.sh — Claude Code PreCompact hook
+# Saves a checkpoint memory before context compaction so agents can resume
+# after losing context. Uses the /mx-checkpoint template format.
+#
+# Fires on: PreCompact (auto or manual compaction)
+# Input: JSON on stdin with transcript_path, session_id, trigger
+# Output: none (side-effect only — saves memory via mx CLI)
+# Exit: always 0 (never blocks compaction)
+
+# Fail-open: any error → allow compaction without saving
+trap 'exit 0' ERR
+
+# ── 1. Parse hook input ──────────────────────────────────────────────────
+INPUT=$(cat)
+
+TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // empty' 2>/dev/null)
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // empty' 2>/dev/null)
+TRIGGER=$(echo "$INPUT" | jq -r '.trigger // .source // "auto"' 2>/dev/null)
+
+# Skip if no transcript available or jq missing
+if [[ -z "$TRANSCRIPT_PATH" || ! -f "$TRANSCRIPT_PATH" ]]; then
+  exit 0
+fi
+
+command -v jq >/dev/null 2>&1 || exit 0
+command -v mx >/dev/null 2>&1 || exit 0
+
+# ── 2. Extract context from transcript ───────────────────────────────────
+
+# Recent user/assistant text (last ~200 lines of transcript, text content only)
+RECENT_TEXT=$(tail -200 "$TRANSCRIPT_PATH" | \
+  jq -r '
+    select(.type == "user" or .type == "assistant") |
+    .message.content[]? |
+    select(.type == "text") |
+    .text // empty
+  ' 2>/dev/null | tail -c 8000)
+
+# Files touched (from tool_use entries: Read, Edit, Write, Glob)
+FILES_TOUCHED=$(tail -500 "$TRANSCRIPT_PATH" | \
+  jq -r '
+    select(.type == "assistant") |
+    .message.content[]? |
+    select(.type == "tool_use") |
+    .input.file_path // empty
+  ' 2>/dev/null | grep -v '^$' | sort -u | head -30)
+
+# Git branch and PR references
+GIT_BRANCH="${CLAUDE_WORKTREE_BRANCH:-}"
+if [[ -z "$GIT_BRANCH" ]]; then
+  GIT_BRANCH=$(git branch --show-current 2>/dev/null || echo "unknown")
+fi
+
+# GitHub issue/PR references from recent text
+GH_REFS=$(echo "$RECENT_TEXT" | grep -oE '#[0-9]+|PR #[0-9]+|issue #[0-9]+' 2>/dev/null | sort -u | head -10 | tr '\n' ', ' | sed 's/,$//')
+
+# Worktree info
+WORKTREE_NAME="${CLAUDE_WORKTREE_NAME:-unknown}"
+
+# ── 3. Format checkpoint memory ─────────────────────────────────────────
+
+# Build files list (indented)
+FILES_LIST=""
+if [[ -n "$FILES_TOUCHED" ]]; then
+  FILES_LIST=$(echo "$FILES_TOUCHED" | sed 's/^/- /')
+fi
+
+CONTENT="[Auto-Checkpoint] Context compaction (${TRIGGER}) — ${WORKTREE_NAME}
+
+Branch: ${GIT_BRANCH}
+Session: ${SESSION_ID}
+GitHub refs: ${GH_REFS:-none detected}
+
+Goal: [Auto-captured checkpoint before context compaction]
+
+Current status: Context window reached capacity. This checkpoint captures the working state just before compaction so the next session can resume.
+
+Key files:
+${FILES_LIST:-No file paths detected in recent transcript.}
+
+Key terms: ${WORKTREE_NAME}, ${GIT_BRANCH}, auto-checkpoint, context-compaction
+
+Next steps: Resume work from this checkpoint. Review the recent context below to understand what was in progress.
+
+---
+Recent context (last messages before compaction):
+
+${RECENT_TEXT:-No recent text extracted from transcript.}"
+
+# ── 4. Save checkpoint memory ───────────────────────────────────────────
+
+# Use a named memory so it's easy to find and gets overwritten each compaction
+mx memories create \
+  --name "auto-checkpoint-${WORKTREE_NAME}" \
+  --conversation-id "NEW" \
+  --content "$CONTENT" \
+  --topics "checkpoint,context-compaction" \
+  >/dev/null 2>&1 || true
+
+# Always allow compaction to proceed
+exit 0