@memnexus-ai/cli 1.7.162 → 1.7.164

package/hooks/capture-session-end.sh

@@ -0,0 +1,225 @@
+#!/bin/bash
+# capture-session-end.sh — Automatic memory capture on session activity
+#
+# Installed at ~/.memnexus/hooks/ by `mx mcp install` for end-user lifecycle
+# hook integration with Claude Code.
+#
+# Creates a session-level summary memory capturing what was accomplished, key
+# decisions, and next steps. This is the "wrap-up" signal — a holistic view of
+# the session that individual turn-level captures would miss.
+#
+# Fires on: Stop (fires on every turn completion, but saves only when enough
+#           new work has accumulated since the last save — debounced at >100
+#           new transcript lines)
+# 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. Check required tools ──────────────────────────────────────────────
+command -v jq >/dev/null 2>&1 || exit 0
+command -v mx >/dev/null 2>&1 || exit 0
+
+# ── 2. 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
+if [[ -z "$TRANSCRIPT_PATH" || ! -f "$TRANSCRIPT_PATH" ]]; then
+  exit 0
+fi
+
+# Validate transcript path — resolve symlinks
+REAL_TRANSCRIPT=$(realpath "$TRANSCRIPT_PATH" 2>/dev/null) || exit 0
+if [[ ! -f "$REAL_TRANSCRIPT" ]]; then
+  exit 0
+fi
+TRANSCRIPT_PATH="$REAL_TRANSCRIPT"
+
+# ── 3. Derive project name and debounce state file ───────────────────────
+# Derive a stable project identifier from the transcript path or cwd.
+# Use a hash of the project path so the state file is unique per project.
+PROJECT_DIR=$(dirname "$TRANSCRIPT_PATH" 2>/dev/null)
+if [[ -z "$PROJECT_DIR" || "$PROJECT_DIR" == "." ]]; then
+  PROJECT_DIR=$(pwd)
+fi
+PROJECT_NAME=$(basename "$PROJECT_DIR" 2>/dev/null || echo "unknown")
+
+# Hash the project directory path for a unique, collision-free state filename
+PROJECT_HASH=$(echo "$PROJECT_DIR" | md5sum 2>/dev/null | awk '{print $1}' || \
+               echo "$PROJECT_DIR" | sha256sum 2>/dev/null | awk '{print $1}' || \
+               echo "$PROJECT_DIR" | cksum | awk '{print $1}')
+STATE_DIR="${XDG_RUNTIME_DIR:-${HOME}/.memnexus/state}"
+mkdir -p "$STATE_DIR" 2>/dev/null
+STATE_FILE="${STATE_DIR}/.mx-session-capture-${PROJECT_HASH}"
+
+# ── 4. Debounce — only save when significant new work has accumulated ─────
+CURRENT_LINES=$(wc -l < "$TRANSCRIPT_PATH" 2>/dev/null || echo "0")
+
+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
+
+# ── 5. Extract session summary data ──────────────────────────────────────
+
+tmpdir=$(mktemp -d)
+trap 'rm -rf "$tmpdir"; exit 0' EXIT ERR
+
+# Only look at lines since last save to avoid re-summarising old content
+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 — update state so we don't recheck same lines
+if [[ "$TOOL_COUNT" -lt 5 && -z "$FILES_MODIFIED" ]]; then
+  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/,$//')
+
+# ── 5b. Sanitize sensitive data ──────────────────────────────────────────
+sanitize() {
+  sed -E \
+    -e 's/(api[_-]?key|token|secret|password|bearer|authorization)[[:space:]]*[:=][[:space:]]*[^[:space:],\"'"'"']+/\1=<REDACTED>/gi' \
+    -e 's/cmk_live_[A-Za-z0-9_-]+/cmk_live_<REDACTED>/g' \
+    -e 's/sk-[A-Za-z0-9_-]{20,}/sk-<REDACTED>/g' \
+    -e 's/ghp_[A-Za-z0-9]{36}/ghp_<REDACTED>/g' \
+    -e 's/gho_[A-Za-z0-9]{36}/gho_<REDACTED>/g' \
+    -e 's/-----BEGIN [A-Z ]*PRIVATE KEY-----/-----BEGIN REDACTED KEY-----/g'
+}
+
+USER_MESSAGES=$(echo "$USER_MESSAGES" | sanitize)
+BASH_COMMANDS=$(echo "$BASH_COMMANDS" | sanitize)
+RECENT_TEXT=$(echo "$RECENT_TEXT" | sanitize)
+
+# ── 6. Build session summary ─────────────────────────────────────────────
+GIT_BRANCH=$(git -C "$PROJECT_DIR" branch --show-current 2>/dev/null || \
+             git branch --show-current 2>/dev/null || echo "unknown")
+
+MOD_LIST=""
+if [[ -n "$FILES_MODIFIED" ]]; then
+  MOD_LIST=$(echo "$FILES_MODIFIED" | sed 's/^/- /')
+fi
+
+CONTENT="[Auto-Captured] Session activity — ${PROJECT_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)"
+
+# Append PR activity if any
+if [[ -n "$PR_REFS" ]]; then
+  CONTENT="${CONTENT}
+
+PR activity:
+${PR_REFS}"
+fi
+
+# Truncate to ~5000 chars
+CONTENT=$(echo "$CONTENT" | head -c 5000)
+
+# ── 7. Save memory (with timeout — never block session exit) ─────────────
+TIMEOUT_CMD=""
+if command -v timeout >/dev/null 2>&1; then
+  TIMEOUT_CMD="timeout 10"
+elif command -v gtimeout >/dev/null 2>&1; then
+  TIMEOUT_CMD="gtimeout 10"
+fi
+
+$TIMEOUT_CMD mx memories create \
+  --conversation-id "NEW" \
+  --content "$CONTENT" \
+  --topics "auto-captured,session-summary" \
+  >/dev/null 2>&1 || true
+
+# ── 8. Update debounce state ─────────────────────────────────────────────
+echo "$CURRENT_LINES" > "$STATE_FILE" 2>/dev/null || true
+
+exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memnexus-ai/cli",
-  "version": "1.7.162",
+  "version": "1.7.164",
   "description": "Command-line interface for MemNexus Core API",
   "main": "dist/index.js",
   "bin": {
@@ -22,6 +22,7 @@
   "files": [
     "dist/",
     "bin/",
+    "hooks/",
     "README.md",
     "CHANGELOG.md",
     "USAGE.md"