@hir4ta/mneme 0.17.0

package/hooks/session-start.sh

@@ -0,0 +1,380 @@
+#!/usr/bin/env bash
+#
+# session-start.sh - SessionStart hook for mneme plugin
+#
+# Purpose: Initialize session JSON and inject context via additionalContext
+#
+# Input (stdin): JSON with session_id, cwd, trigger (startup|resume|clear|compact)
+# Output (stdout): JSON with hookSpecificOutput.additionalContext
+# Exit codes: 0 = success (continue session)
+#
+# Dependencies: jq
+#
+
+set -euo pipefail
+
+# Read input from stdin
+input_json=$(cat)
+
+# Check for jq (required dependency)
+if ! command -v jq &> /dev/null; then
+    echo "[mneme] Warning: jq not found. Install with: brew install jq" >&2
+    echo "[mneme] Session tracking disabled for this session." >&2
+    exit 0  # Non-blocking - allow session to continue without mneme
+fi
+
+cwd=$(echo "$input_json" | jq -r '.cwd // empty' 2>/dev/null || echo "")
+session_id=$(echo "$input_json" | jq -r '.session_id // empty' 2>/dev/null || echo "")
+
+# If no cwd, use PWD
+if [ -z "$cwd" ]; then
+    cwd="${PWD}"
+fi
+
+# Resolve cwd to absolute path
+cwd=$(cd "$cwd" 2>/dev/null && pwd || echo "$cwd")
+
+# Determine plugin root directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
+
+# Find .mneme directory
+mneme_dir="${cwd}/.mneme"
+sessions_dir="${mneme_dir}/sessions"
+rules_dir="${mneme_dir}/rules"
+patterns_dir="${mneme_dir}/patterns"
+session_links_dir="${mneme_dir}/session-links"
+
+# Check if mneme is initialized
+if [ ! -d "$mneme_dir" ]; then
+    echo "[mneme] Not initialized in this project. Run: npx @hir4ta/mneme --init" >&2
+    exit 0
+fi
+
+# Current timestamp and date parts
+now=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+date_part=$(echo "$now" | cut -d'T' -f1)
+year_part=$(echo "$date_part" | cut -d'-' -f1)
+month_part=$(echo "$date_part" | cut -d'-' -f2)
+
+# Generate session ID based on session_id (not date)
+if [ -n "$session_id" ]; then
+    session_short_id="${session_id:0:8}"
+else
+    session_short_id=$(uuidgen 2>/dev/null | tr '[:upper:]' '[:lower:]' | cut -c1-8 || date +%s | md5sum | cut -c1-8)
+fi
+
+# file_id is now just the session_short_id (no date prefix)
+file_id="${session_short_id}"
+
+# Get git info
+current_branch=""
+git_user_name="unknown"
+git_user_email=""
+
+if git -C "$cwd" rev-parse --git-dir &> /dev/null 2>&1; then
+    current_branch=$(git -C "$cwd" rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
+    git_user_name=$(git -C "$cwd" config user.name 2>/dev/null || echo "unknown")
+    git_user_email=$(git -C "$cwd" config user.email 2>/dev/null || echo "")
+fi
+
+# Get project name from directory
+project_name=$(basename "$cwd")
+
+# Get repository name from git remote origin
+repository=""
+if git -C "$cwd" rev-parse --git-dir &> /dev/null 2>&1; then
+    git_remote_url=$(git -C "$cwd" remote get-url origin 2>/dev/null || echo "")
+    if [ -n "$git_remote_url" ]; then
+        # Extract user/repo from SSH or HTTPS URL
+        # git@github.com:user/repo.git → user/repo
+        # https://github.com/user/repo.git → user/repo
+        # Extract user/repo from SSH or HTTPS URL (BSD sed compatible)
+        repository=$(echo "$git_remote_url" | sed -E 's|.*[:/]([^/]+/[^/]+)(\.git)?$|\1|' | sed 's/\.git$//')
+    fi
+fi
+
+# ============================================
+# Check session-links for master session
+# ============================================
+master_session_id=""
+master_session_path=""
+session_link_file="${session_links_dir}/${file_id}.json"
+
+if [ -f "$session_link_file" ]; then
+    master_session_id=$(jq -r '.masterSessionId // empty' "$session_link_file" 2>/dev/null || echo "")
+    if [ -n "$master_session_id" ]; then
+        # Find master session file
+        master_session_path=$(find "$sessions_dir" -name "${master_session_id}.json" -type f 2>/dev/null | head -1)
+        echo "[mneme] Session linked to master: ${master_session_id}" >&2
+    fi
+fi
+
+# ============================================
+# Find existing session file or create new one
+# ============================================
+session_path=""
+is_resumed=false
+
+# Search for existing session file across all year/month directories
+if [ -d "$sessions_dir" ]; then
+    existing_file=$(find "$sessions_dir" -name "${file_id}.json" -type f 2>/dev/null | head -1)
+    if [ -n "$existing_file" ] && [ -f "$existing_file" ]; then
+        session_path="$existing_file"
+        is_resumed=true
+    fi
+fi
+
+# If no existing file, create in current year/month directory
+if [ -z "$session_path" ]; then
+    session_year_month_dir="${sessions_dir}/${year_part}/${month_part}"
+    mkdir -p "$session_year_month_dir"
+    session_path="${session_year_month_dir}/${file_id}.json"
+fi
+
+# ============================================
+# Find recent sessions for auto-suggestion (latest 3)
+# ============================================
+recent_sessions_info=""
+if [ -d "$sessions_dir" ] && [ "$is_resumed" = false ]; then
+    # Get all sessions sorted by createdAt descending, excluding current
+    recent_sessions=$(find "$sessions_dir" -name "*.json" -type f 2>/dev/null | while read -r f; do
+        if [ -f "$f" ]; then
+            session_data=$(jq -r '[.id, .createdAt, .title // "", .context.branch // ""] | @tsv' "$f" 2>/dev/null || echo "")
+            if [ -n "$session_data" ]; then
+                echo "$session_data"
+            fi
+        fi
+    done | sort -t$'\t' -k2 -r | head -4)  # Get 4 to filter out current
+
+    # Build recent sessions list (excluding current session)
+    count=0
+    while IFS=$'\t' read -r sid screated stitle sbranch; do
+        if [ -n "$sid" ] && [ "$sid" != "$file_id" ] && [ $count -lt 3 ]; then
+            count=$((count + 1))
+            # Format: [id] title (date, branch)
+            date_part_session=$(echo "$screated" | cut -d'T' -f1 2>/dev/null || echo "")
+            title_display="${stitle:-no title}"
+            branch_display="${sbranch:-no branch}"
+            recent_sessions_info="${recent_sessions_info}  ${count}. [${sid}] ${title_display} (${date_part_session}, ${branch_display})\n"
+        fi
+    done <<< "$recent_sessions"
+fi
+
+# ============================================
+# Initialize or update session JSON
+# ============================================
+if [ "$is_resumed" = true ]; then
+    # Resume: reset status to null for re-processing at SessionEnd
+    jq --arg resumedAt "$now" '.status = null | .resumedAt = $resumedAt' "$session_path" > "${session_path}.tmp" \
+        && mv "${session_path}.tmp" "$session_path"
+    echo "[mneme] Session resumed (status reset): ${session_path}" >&2
+else
+    # New session: create initial JSON (log-focused schema)
+    # Note: summary, discussions, errors, handoff are set by /mneme:save
+    session_json=$(jq -n \
+        --arg id "$file_id" \
+        --arg sessionId "${session_id:-$session_short_id}" \
+        --arg createdAt "$now" \
+        --arg branch "$current_branch" \
+        --arg projectDir "$cwd" \
+        --arg projectName "$project_name" \
+        --arg repository "$repository" \
+        --arg userName "$git_user_name" \
+        --arg userEmail "$git_user_email" \
+        '{
+            id: $id,
+            sessionId: $sessionId,
+            createdAt: $createdAt,
+            title: "",
+            tags: [],
+            context: {
+                branch: (if $branch == "" then null else $branch end),
+                projectDir: $projectDir,
+                projectName: $projectName,
+                repository: (if $repository == "" then null else $repository end),
+                user: {
+                    name: $userName,
+                    email: (if $userEmail == "" then null else $userEmail end)
+                } | with_entries(select(.value != null))
+            } | with_entries(select(.value != null)),
+            metrics: {
+                userMessages: 0,
+                assistantResponses: 0,
+                thinkingBlocks: 0,
+                toolUsage: []
+            },
+            files: [],
+            status: null
+        }')
+
+    echo "$session_json" > "$session_path"
+    echo "[mneme] Session initialized: ${session_path}" >&2
+fi
+
+# ============================================
+# Update master session workPeriods (if linked)
+# ============================================
+if [ -n "$master_session_id" ] && [ -n "$master_session_path" ] && [ -f "$master_session_path" ]; then
+    # Use full session_id for consistency with session-end.sh
+    claude_session_id="${session_id:-$session_short_id}"
+
+    # Check if workPeriod already exists for this claudeSessionId (prevent duplicates on clear/compact)
+    existing_period=$(jq --arg cid "$claude_session_id" '.workPeriods // [] | map(select(.claudeSessionId == $cid and .endedAt == null)) | length' "$master_session_path" 2>/dev/null || echo "0")
+
+    if [ "$existing_period" = "0" ]; then
+        # Add new workPeriod entry to master session
+        jq --arg claudeSessionId "$claude_session_id" \
+           --arg startedAt "$now" '
+            .workPeriods = ((.workPeriods // []) + [{
+                claudeSessionId: $claudeSessionId,
+                startedAt: $startedAt,
+                endedAt: null
+            }]) |
+            .updatedAt = $startedAt
+        ' "$master_session_path" > "${master_session_path}.tmp" \
+            && mv "${master_session_path}.tmp" "$master_session_path"
+        echo "[mneme] Master session workPeriods updated: ${master_session_path}" >&2
+    else
+        echo "[mneme] Master session workPeriod already exists for this Claude session" >&2
+    fi
+fi
+
+# Get relative path for additionalContext
+# Extract year/month from session_path
+session_relative_path="${session_path#$cwd/}"
+
+# ============================================
+# Initialize tags.json if not exists
+# ============================================
+tags_path="${mneme_dir}/tags.json"
+default_tags_path="${SCRIPT_DIR}/default-tags.json"
+
+if [ ! -f "$tags_path" ]; then
+    if [ -f "$default_tags_path" ]; then
+        cp "$default_tags_path" "$tags_path"
+        echo "[mneme] Tags master file created: ${tags_path}" >&2
+    fi
+fi
+
+# ============================================
+# Initialize local database
+# ============================================
+local_db_path="${mneme_dir}/local.db"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+schema_path="${PLUGIN_ROOT}/lib/schema.sql"
+
+# Initialize local database if not exists
+if [ ! -f "$local_db_path" ]; then
+    if [ -f "$schema_path" ]; then
+        sqlite3 "$local_db_path" < "$schema_path"
+        echo "[mneme] Local database initialized: ${local_db_path}" >&2
+    fi
+fi
+# Configure pragmas
+sqlite3 "$local_db_path" "PRAGMA journal_mode = WAL; PRAGMA busy_timeout = 5000; PRAGMA synchronous = NORMAL;" 2>/dev/null || true
+
+# ============================================
+# Ensure rules templates exist
+# ============================================
+rules_timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+init_rules_file() {
+    local path="$1"
+    if [ ! -f "$path" ]; then
+        cat <<RULEEOF > "$path"
+{
+  "schemaVersion": 1,
+  "createdAt": "${rules_timestamp}",
+  "updatedAt": "${rules_timestamp}",
+  "items": []
+}
+RULEEOF
+    fi
+}
+
+init_rules_file "${rules_dir}/review-guidelines.json"
+init_rules_file "${rules_dir}/dev-rules.json"
+
+# ============================================
+# Build additionalContext (superpowers style)
+# ============================================
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+
+# Read using-mneme skill content
+using_mneme_content=$(cat "${PLUGIN_ROOT}/skills/using-mneme/skill.md" 2>/dev/null || echo "")
+
+# Escape for JSON using pure bash (superpowers style)
+escape_for_json() {
+    local input="$1"
+    local output=""
+    local i char
+    for (( i=0; i<${#input}; i++ )); do
+        char="${input:$i:1}"
+        case "$char" in
+            $'\\') output+='\\' ;;
+            '"') output+='\"' ;;
+            $'\n') output+='\n' ;;
+            $'\r') output+='\r' ;;
+            $'\t') output+='\t' ;;
+            *) output+="$char" ;;
+        esac
+    done
+    printf '%s' "$output"
+}
+
+using_mneme_escaped=$(escape_for_json "$using_mneme_content")
+
+resume_note=""
+needs_summary=false
+if [ "$is_resumed" = true ]; then
+    resume_note=" (Resumed)"
+    # Check if title is empty
+    session_title=$(jq -r '.title // ""' "$session_path" 2>/dev/null || echo "")
+    if [ -z "$session_title" ]; then
+        needs_summary=true
+    fi
+fi
+
+# Build the session info (no auto-save instruction)
+session_info="**Session:** ${file_id}${resume_note}
+**Path:** ${session_relative_path}
+
+Sessions are saved:
+- **Automatically** before Auto-Compact (context 95% full)
+- **Manually** via \`/mneme:save\` or asking \"save the session\""
+
+# Add recent sessions suggestion for new sessions
+if [ "$is_resumed" = false ] && [ -n "$recent_sessions_info" ]; then
+    session_info="${session_info}
+
+---
+**Recent sessions:**
+$(echo -e "$recent_sessions_info")
+Continue from a previous session? Use \`/mneme:resume <id>\` or \`/mneme:resume\` to see more."
+fi
+
+# Add summary creation prompt if needed (for resumed sessions)
+if [ "$needs_summary" = true ]; then
+    session_info="${session_info}
+
+---
+**Note:** This session was resumed but has no summary yet.
+When you have enough context, consider creating a summary with \`/mneme:save\` to capture:
+- What was accomplished in the previous session
+- Key decisions made
+- Any ongoing work or next steps"
+fi
+
+session_info_escaped=$(escape_for_json "$session_info")
+
+# Output context injection as JSON (superpowers style)
+cat <<EOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "SessionStart",
+    "additionalContext": "${session_info_escaped}\n\n${using_mneme_escaped}"
+  }
+}
+EOF
+
+exit 0

package/hooks/user-prompt-submit.sh

@@ -0,0 +1,253 @@
+#!/usr/bin/env bash
+#
+# user-prompt-submit.sh - UserPromptSubmit hook for mneme plugin
+#
+# Purpose: Search mneme for relevant context and inject as additionalContext
+#
+# Input (stdin): JSON with prompt, cwd
+# Output (stdout): JSON with hookSpecificOutput.additionalContext (if matches found)
+# Exit codes: 0 = success (continue with optional context)
+#
+# Dependencies: jq
+#
+
+set -euo pipefail
+
+# Read input from stdin
+input_json=$(cat)
+
+# Check for jq (required dependency)
+if ! command -v jq &> /dev/null; then
+    echo "[mneme] Warning: jq not found, memory search skipped." >&2
+    exit 0  # Non-blocking - continue without memory search
+fi
+
+# Extract prompt and cwd
+prompt=$(echo "$input_json" | jq -r '.prompt // empty' 2>/dev/null || echo "")
+cwd=$(echo "$input_json" | jq -r '.cwd // empty' 2>/dev/null || echo "")
+
+# Exit if no prompt or short prompt (less than 10 chars)
+if [ -z "$prompt" ] || [ ${#prompt} -lt 10 ]; then
+    exit 0
+fi
+
+# Use PWD if cwd is empty
+if [ -z "$cwd" ]; then
+    cwd="${PWD}"
+fi
+
+# Define mneme directory
+mneme_dir="${cwd}/.mneme"
+
+# Local database path
+local_db_path="${mneme_dir}/local.db"
+
+# Exit if no .mneme directory
+if [ ! -d "$mneme_dir" ]; then
+    exit 0
+fi
+
+# Skip if prompt starts with /mneme (user is explicitly using mneme)
+if [[ "$prompt" == /mneme* ]]; then
+    exit 0
+fi
+
+# Extract keywords from prompt (first 5 significant words, excluding common words)
+# Simple extraction: take words longer than 3 chars, limit to 5
+raw_keywords=$(echo "$prompt" | tr '[:upper:]' '[:lower:]' | \
+    tr -cs '[:alnum:]' '\n' | \
+    awk 'length > 3' | \
+    grep -vE '^(this|that|with|from|have|will|would|could|should|what|when|where|which|there|their|them|they|been|being|were|does|done|make|just|only|also|into|over|such|than|then|some|these|those|very|after|before|about|through)$' | \
+    head -5)
+
+# Exit if no keywords extracted
+if [ -z "$raw_keywords" ]; then
+    exit 0
+fi
+
+# Expand keywords using tag aliases from tags.json (fuzzy-search style)
+tags_path="${mneme_dir}/tags.json"
+expanded_keywords="$raw_keywords"
+
+if [ -f "$tags_path" ]; then
+    # For each keyword, check if it matches any tag id, label, or alias
+    # If matched, expand to include all related terms
+    while IFS= read -r kw; do
+        [ -z "$kw" ] && continue
+        # Search for matching tag and get all related terms
+        related_terms=$(jq -r --arg kw "$kw" '
+            .tags[]? |
+            select(
+                (.id | ascii_downcase) == $kw or
+                (.label | ascii_downcase) == $kw or
+                (.aliases[]? | ascii_downcase) == $kw
+            ) |
+            [.id, .label] + .aliases | .[] | ascii_downcase
+        ' "$tags_path" 2>/dev/null | sort -u)
+
+        if [ -n "$related_terms" ]; then
+            # Add related terms to expanded keywords
+            expanded_keywords="${expanded_keywords}
+${related_terms}"
+        fi
+    done <<< "$raw_keywords"
+fi
+
+# Remove duplicates and build grep pattern
+keywords=$(echo "$expanded_keywords" | sort -u | tr '\n' '|' | sed 's/|$//')
+
+# Exit if no keywords
+if [ -z "$keywords" ]; then
+    exit 0
+fi
+
+# Search local SQLite database for interactions
+search_local_db() {
+    local pattern="$1"
+    local results=""
+
+    # Check if sqlite3 is available and local DB exists
+    if ! command -v sqlite3 &> /dev/null || [ ! -f "$local_db_path" ]; then
+        echo ""
+        return
+    fi
+
+    # Convert pattern to SQLite FTS5 or LIKE-compatible format
+    # Replace | with OR for FTS5, escape special chars
+    local fts_pattern=$(echo "$pattern" | sed 's/|/ OR /g')
+    local like_pattern=$(echo "$pattern" | sed 's/|/%/g')
+
+    # Try FTS5 first, fallback to LIKE
+    local db_matches=""
+
+    # Search interactions (project-local database)
+    # Limit to 3 most recent matches
+    db_matches=$(sqlite3 -separator '|' "$local_db_path" "
+        SELECT DISTINCT session_id, substr(content, 1, 100) as snippet
+        FROM interactions
+        WHERE content LIKE '%${like_pattern}%' OR thinking LIKE '%${like_pattern}%'
+        ORDER BY timestamp DESC
+        LIMIT 3;
+    " 2>/dev/null || echo "")
+
+    if [ -n "$db_matches" ]; then
+        while IFS='|' read -r session_id snippet; do
+            [ -z "$session_id" ] && continue
+            # Truncate snippet and clean up
+            snippet=$(echo "$snippet" | tr '\n' ' ' | sed 's/  */ /g' | head -c 80)
+            results="${results}[interaction:${session_id:0:8}] ${snippet}...\n"
+        done <<< "$db_matches"
+    fi
+
+    echo -e "$results"
+}
+
+# Search function - simple grep-based search
+search_mneme() {
+    local pattern="$1"
+    local results=""
+
+    # Search sessions (limit to recent 10 files)
+    if [ -d "${mneme_dir}/sessions" ]; then
+        local session_matches=$(find "${mneme_dir}/sessions" -name "*.json" -type f 2>/dev/null | \
+            xargs -I{} sh -c "grep -l -i -E '$pattern' '{}' 2>/dev/null || true" | \
+            head -3)
+
+        for file in $session_matches; do
+            if [ -f "$file" ]; then
+                local title=$(jq -r '.title // .summary.title // ""' "$file" 2>/dev/null | head -1)
+                local id=$(jq -r '.id // ""' "$file" 2>/dev/null)
+                if [ -n "$title" ] && [ -n "$id" ]; then
+                    results="${results}[session:${id}] ${title}\n"
+                fi
+            fi
+        done
+    fi
+
+    # Search decisions
+    if [ -d "${mneme_dir}/decisions" ]; then
+        local decision_matches=$(find "${mneme_dir}/decisions" -name "*.json" -type f 2>/dev/null | \
+            xargs -I{} sh -c "grep -l -i -E '$pattern' '{}' 2>/dev/null || true" | \
+            head -3)
+
+        for file in $decision_matches; do
+            if [ -f "$file" ]; then
+                local title=$(jq -r '.title // ""' "$file" 2>/dev/null | head -1)
+                local decision=$(jq -r '.decision // ""' "$file" 2>/dev/null | head -1)
+                if [ -n "$title" ]; then
+                    results="${results}[decision] ${title}: ${decision}\n"
+                fi
+            fi
+        done
+    fi
+
+    # Search patterns
+    if [ -d "${mneme_dir}/patterns" ]; then
+        for file in "${mneme_dir}/patterns"/*.json; do
+            if [ -f "$file" ]; then
+                local pattern_matches=$(jq -r --arg p "$pattern" \
+                    '.patterns[]? | select(.errorPattern | test($p; "i")) | "[pattern] \(.errorPattern | .[0:50])... → \(.solution | .[0:50])..."' \
+                    "$file" 2>/dev/null | head -2)
+                if [ -n "$pattern_matches" ]; then
+                    results="${results}${pattern_matches}\n"
+                fi
+            fi
+        done
+    fi
+
+    # Search local SQLite database
+    local db_results=$(search_local_db "$pattern")
+    if [ -n "$db_results" ]; then
+        results="${results}${db_results}"
+    fi
+
+    echo -e "$results"
+}
+
+# Perform search
+search_results=$(search_mneme "$keywords")
+
+# Exit if no results
+if [ -z "$search_results" ] || [ "$search_results" = "\n" ]; then
+    exit 0
+fi
+
+# Escape for JSON
+escape_for_json() {
+    local input="$1"
+    local output=""
+    local i char
+    for (( i=0; i<${#input}; i++ )); do
+        char="${input:$i:1}"
+        case "$char" in
+            $'\\') output+='\\' ;;
+            '"') output+='\"' ;;
+            $'\n') output+='\n' ;;
+            $'\r') output+='\r' ;;
+            $'\t') output+='\t' ;;
+            *) output+="$char" ;;
+        esac
+    done
+    printf '%s' "$output"
+}
+
+# Build context message
+context_message="<mneme-context>
+Related memories found:
+$(echo -e "$search_results")
+Use /mneme:search for more details.
+</mneme-context>"
+
+context_escaped=$(escape_for_json "$context_message")
+
+# Output JSON with additionalContext
+cat <<EOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "UserPromptSubmit",
+    "additionalContext": "${context_escaped}"
+  }
+}
+EOF
+
+exit 0