@hir4ta/mneme 0.24.1 → 0.24.3

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "mneme",
   "description": "A plugin that provides long-term memory for Claude Code. It automatically saves context lost during auto-compact, offering features for session restoration, recording technical decisions, and learning developer patterns.",
-  "version": "0.24.1",
+  "version": "0.24.3",
   "author": {
     "name": "hir4ta"
   },

package/README.ja.md

@@ -1,6 +1,6 @@
 # mneme
 
-![Version](https://img.shields.io/badge/version-0.24.1-blue)
+![Version](https://img.shields.io/badge/version-0.24.3-blue)
 ![Node.js](https://img.shields.io/badge/node-%3E%3D22.5.0-brightgreen)
 [![NPM Version](https://img.shields.io/npm/v/%40hir4ta%2Fmneme)](https://www.npmjs.com/package/@hir4ta/mneme)
 [![MIT License](https://img.shields.io/npm/l/%40hir4ta%2Fmneme)](https://github.com/hir4ta/mneme/blob/main/LICENSE)

package/README.md

@@ -1,6 +1,6 @@
 # mneme
 
-![Version](https://img.shields.io/badge/version-0.24.1-blue)
+![Version](https://img.shields.io/badge/version-0.24.3-blue)
 ![Node.js](https://img.shields.io/badge/node-%3E%3D22.5.0-brightgreen)
 [![NPM Version](https://img.shields.io/npm/v/%40hir4ta%2Fmneme)](https://www.npmjs.com/package/@hir4ta/mneme)
 [![MIT License](https://img.shields.io/npm/l/%40hir4ta%2Fmneme)](https://github.com/hir4ta/mneme/blob/main/LICENSE)

package/dist/server.js

@@ -4493,7 +4493,7 @@ misc.get("/project", (c) => {
     }
   } catch {
   }
-  const version = "0.24.1";
+  const version = "0.24.3";
   return c.json({
     name: projectName,
     path: projectRoot,

package/hooks/user-prompt-submit.sh

@@ -4,8 +4,9 @@
 #
 # Purpose: Search mneme for relevant context and approved rules,
 # inject as additionalContext using shared search-core logic.
+# Also injects Claude Session ID (workaround for anthropics/claude-code#16538).
 #
-# Input (stdin): JSON with prompt, cwd
+# Input (stdin): JSON with prompt, session_id, cwd
 # Output (stdout): JSON with hookSpecificOutput.additionalContext (if matches found)
 #
 
@@ -23,13 +24,16 @@ fi
 
 prompt=$(echo "$input_json" | jq -r ".prompt // empty" 2>/dev/null || echo "")
 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 "")
 
+# Determine if search should run (session ID is always injected regardless)
+run_search=true
 if [ -z "$prompt" ] || [ ${#prompt} -lt 10 ]; then
-  exit 0
+  run_search=false
 fi
 
 if [[ "$prompt" == /mneme* ]]; then
-  exit 0
+  run_search=false
 fi
 
 if [ -z "$cwd" ]; then
@@ -37,104 +41,114 @@ if [ -z "$cwd" ]; then
 fi
 cwd=$(cd "$cwd" 2>/dev/null && pwd || echo "$cwd")
 
-# Cap very large prompts to avoid overly expensive search
-if [ ${#prompt} -gt 4000 ]; then
-  prompt="${prompt:0:4000}"
-fi
-
 if ! validate_mneme "$cwd"; then
   exit 0
 fi
 
-PLUGIN_ROOT="$(get_plugin_root)"
-
-search_script=$(find_script "$PLUGIN_ROOT" "prompt-search")
-if [ -z "$search_script" ]; then
-  exit 0
-fi
-
-# Detect changed files for file-based session recommendation
-changed_files=""
-if command -v git >/dev/null 2>&1 && git -C "$cwd" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
-  changed_files=$(cd "$cwd" && {
-    git diff --name-only HEAD 2>/dev/null
-    git diff --name-only --cached 2>/dev/null
-  } | sort -u | head -20 | paste -sd "," - 2>/dev/null || echo "")
-fi
-
-search_output=$(invoke_node "$search_script" \
-  --query "$prompt" --project "$cwd" --limit 5 \
-  ${changed_files:+--files "$changed_files"} 2>/dev/null || echo "")
+# --- Search (skipped for short prompts and /mneme commands) ---
+context_message=""
+rules_message=""
 
-if [ -z "$search_output" ]; then
-  exit 0
-fi
+if [ "$run_search" = true ]; then
+  # Cap very large prompts to avoid overly expensive search
+  if [ ${#prompt} -gt 4000 ]; then
+    prompt="${prompt:0:4000}"
+  fi
 
-success=$(echo "$search_output" | jq -r ".success // false" 2>/dev/null || echo "false")
-if [ "$success" != "true" ]; then
-  exit 0
-fi
+  PLUGIN_ROOT="$(get_plugin_root)"
+
+  search_script=$(find_script "$PLUGIN_ROOT" "prompt-search")
+  if [ -n "$search_script" ]; then
+    # Detect changed files for file-based session recommendation
+    changed_files=""
+    if command -v git >/dev/null 2>&1 && git -C "$cwd" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+      changed_files=$(cd "$cwd" && {
+        git diff --name-only HEAD 2>/dev/null
+        git diff --name-only --cached 2>/dev/null
+      } | sort -u | head -20 | paste -sd "," - 2>/dev/null || echo "")
+    fi
 
-# Format session/interaction context (existing behavior)
-context_message=""
-context_lines=$(echo "$search_output" | jq -r '
-  .results
-  | map(select(.score >= 3 and (.type == "session" or .type == "unit")))
-  | .[:3]
-  | map("[\(.type):\(.id)] \(.title) | match: \((.matchedFields // []) | join(","))")
-  | join("\n")
-')
-
-# Format file-based session recommendations
-file_rec_lines=$(echo "$search_output" | jq -r '
-  .fileRecommendations // []
-  | .[:3]
-  | map("[session:\(.sessionId)] \(.title) | files: \(.matchedFiles | join(", "))")
-  | join("\n")
-')
-
-if [ -n "$context_lines" ] && [ "$context_lines" != "null" ] || \
-   [ -n "$file_rec_lines" ] && [ "$file_rec_lines" != "null" ]; then
-  context_parts=""
-  if [ -n "$context_lines" ] && [ "$context_lines" != "null" ]; then
-    context_parts="Related context found (sessions/units):
+    search_output=$(invoke_node "$search_script" \
+      --query "$prompt" --project "$cwd" --limit 5 \
+      ${changed_files:+--files "$changed_files"} 2>/dev/null || echo "")
+
+    if [ -n "$search_output" ]; then
+      success=$(echo "$search_output" | jq -r ".success // false" 2>/dev/null || echo "false")
+      if [ "$success" = "true" ]; then
+        # Format session/interaction context
+        context_lines=$(echo "$search_output" | jq -r '
+          .results
+          | map(select(.score >= 3 and (.type == "session" or .type == "unit")))
+          | .[:3]
+          | map("[\(.type):\(.id)] \(.title) | match: \((.matchedFields // []) | join(","))")
+          | join("\n")
+        ')
+
+        # Format file-based session recommendations
+        file_rec_lines=$(echo "$search_output" | jq -r '
+          .fileRecommendations // []
+          | .[:3]
+          | map("[session:\(.sessionId)] \(.title) | files: \(.matchedFiles | join(", "))")
+          | join("\n")
+        ')
+
+        if [ -n "$context_lines" ] && [ "$context_lines" != "null" ] || \
+           [ -n "$file_rec_lines" ] && [ "$file_rec_lines" != "null" ]; then
+          context_parts=""
+          if [ -n "$context_lines" ] && [ "$context_lines" != "null" ]; then
+            context_parts="Related context found (sessions/units):
 ${context_lines}"
-  fi
-  if [ -n "$file_rec_lines" ] && [ "$file_rec_lines" != "null" ]; then
-    if [ -n "$context_parts" ]; then
-      context_parts="${context_parts}
+          fi
+          if [ -n "$file_rec_lines" ] && [ "$file_rec_lines" != "null" ]; then
+            if [ -n "$context_parts" ]; then
+              context_parts="${context_parts}
 "
-    fi
-    context_parts="${context_parts}Related sessions (editing same files):
+            fi
+            context_parts="${context_parts}Related sessions (editing same files):
 ${file_rec_lines}"
-  fi
-  context_message="<mneme-context>
+          fi
+          context_message="<mneme-context>
 ${context_parts}
 To explore deeper: use /mneme:search with specific technical terms, error messages, or file paths.
 </mneme-context>"
-fi
-
-# Format approved rules
-rules_message=""
-rules_lines=$(echo "$search_output" | jq -r '
-  .rules // []
-  | map(select(.score >= 2))
-  | .[:5]
-  | map("[\(.sourceType):\(.id)] (\(.priority // "—")) \(.text)")
-  | join("\n")
-')
-
-if [ -n "$rules_lines" ] && [ "$rules_lines" != "null" ]; then
-  rules_message="<mneme-rules>
+        fi
+
+        # Format approved rules
+        rules_lines=$(echo "$search_output" | jq -r '
+          .rules // []
+          | map(select(.score >= 2))
+          | .[:5]
+          | map("[\(.sourceType):\(.id)] (\(.priority // "—")) \(.text)")
+          | join("\n")
+        ')
+
+        if [ -n "$rules_lines" ] && [ "$rules_lines" != "null" ]; then
+          rules_message="<mneme-rules>
 Approved development rules (apply during this response):
 ${rules_lines}
 </mneme-rules>"
+        fi
+      fi
+    fi
+  fi
 fi
 
-# Combine both sections
+# --- Assemble full context ---
 full_context=""
+
+# Session ID injection (workaround for anthropics/claude-code#16538:
+# Plugin SessionStart hooks don't surface additionalContext to Claude)
+if [ -n "$session_id" ]; then
+  full_context="**Claude Session ID:** ${session_id}"
+fi
+
 if [ -n "$context_message" ]; then
-  full_context="$context_message"
+  if [ -n "$full_context" ]; then
+    full_context="${full_context}
+${context_message}"
+  else
+    full_context="$context_message"
+  fi
 fi
 if [ -n "$rules_message" ]; then
   if [ -n "$full_context" ]; then

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hir4ta/mneme",
-  "version": "0.24.1",
+  "version": "0.24.3",
   "description": "Long-term memory plugin for Claude Code - automated session saving, recording technical decisions, and web dashboard",
   "keywords": [
     "claude",

package/skills/save/SKILL.md

@@ -5,7 +5,7 @@ description: |
   Use when: (1) finishing meaningful implementation work, (2) capturing reusable guidance,
   (3) before ending a long session.
 disable-model-invocation: false
-allowed-tools: Read, Write, Edit, Glob, Grep, Bash, mcp__mneme-db__mneme_save_interactions, mcp__mneme-db__mneme_update_session_summary, mcp__mneme-db__mneme_mark_session_committed, mcp__mneme-db__mneme_rule_linter, mcp__mneme-db__mneme_search_eval
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash, mcp__mneme-db__mneme_save_interactions, mcp__mneme-db__mneme_update_session_summary, mcp__mneme-db__mneme_mark_session_committed, mcp__mneme-db__mneme_validate_sources, mcp__mneme-db__mneme_list_sessions, mcp__mneme-db__mneme_rule_linter, mcp__mneme-db__mneme_search_eval
 ---
 
 # /mneme:save
@@ -43,20 +43,40 @@ Always render missing required fields as blocking errors before write.
 
 ## Session ID resolution
 
+**STOP. Before doing ANYTHING else, find the Claude Session ID.**
+
+The UserPromptSubmit hook injects the session ID into every prompt's context. Look for this exact line in the system-reminder messages above:
+
+```
+**Claude Session ID:** <UUID>
+```
+
+Copy the full UUID value (36 characters, e.g. `a1b2c3d4-e5f6-7890-abcd-ef1234567890`).
+
 <required>
-- Get the full Claude Session ID from the SessionStart context injected at the top of this conversation (look for `**Claude Session ID:**`)
-- Do NOT run any Bash commands to discover the session ID
-- NEVER run exploratory commands like `printenv`, `find`, `echo $MNEME_SESSION_ID`, or `ls -t ~/.claude/projects/*/`
+- The Claude Session ID is ALREADY in this conversation — injected by the UserPromptSubmit hook on every prompt
+- Search for the literal text `**Claude Session ID:**` in system-reminder messages above
+- Copy the full 36-character UUID that follows it
+- Do NOT run Bash, Glob, Grep, or any other tool to discover the session ID
+- Do NOT call `mneme_list_sessions` to find it (that is only for the fallback below)
+- Do NOT run `printenv`, `find`, `echo`, `ls`, `stat`, or any exploratory commands
 </required>
 
+**Fallback (only if `**Claude Session ID:**` is genuinely not found in the conversation):**
+1. Call `mneme_list_sessions` with the current project path and `limit: 1` to get the most recent session
+2. Use that session's `sessionId` as the Claude Session ID
+3. If that also fails, ask the user for the session ID
+
 ## Execution phases
 
-1. **Master session merge**
-- Merge linked/resumed child sessions into the master session.
+1. **Master session merge (only if resumed)**
+- Check if this is a resumed session: look for `(Resumed)` in the `**Session:**` line of the SessionStart context
+- **If NOT resumed**: skip this phase (fresh session, no merge needed)
+- **If resumed**: the `mneme_save_interactions` tool automatically resolves session-links internally, so just pass the current `claudeSessionId` — it saves to the correct master session
+- No manual action needed in most cases; this phase exists as a checkpoint
 
 2. **Interactions commit**
 - Save transcript interactions to `.mneme/local.db` via `mneme_save_interactions`.
-- Do NOT call `mneme_mark_session_committed` yet (wait until after Phase 3).
 
 3. **Session summary extraction (required MCP)**
 - Extract from the conversation: `title`, `goal`, `outcome`, `description`, `tags`, `sessionType`.
@@ -70,12 +90,12 @@ Always render missing required fields as blocking errors before write.
   - `handoff`: continuation info (stoppedReason, notes, nextSteps)
   - `references`: referenced document URLs and file paths (type, url, path, title, description)
 - **MUST call `mneme_update_session_summary`** MCP tool with all extracted data.
-  This writes the summary to `.mneme/sessions/` JSON file, ensuring the session is preserved on SessionEnd.
-- **Then call `mneme_mark_session_committed`** to finalize the commit.
+  This writes the summary to `.mneme/sessions/` JSON file and **automatically marks the session as committed** (no separate `mneme_mark_session_committed` call needed).
 
 <required>
 - Call `mneme_update_session_summary` with: `claudeSessionId`, `title`, `summary` (`goal`, `outcome`), `tags`, `sessionType`, `filesModified`, `technologies`
-- Call `mneme_mark_session_committed` AFTER `mneme_update_session_summary` succeeds
+- Do NOT call `mneme_mark_session_committed` separately — it is called internally by `mneme_update_session_summary`
+- Only call `mneme_mark_session_committed` explicitly if `mneme_update_session_summary` failed and you need error recovery
 - Do NOT skip this step even for short/research sessions
 </required>
 
@@ -117,6 +137,18 @@ The following data is easily lost in summaries, so save it explicitly as structu
 - Official documentation URLs confirmed via WebFetch/WebSearch
 - Important file paths referenced
 
+### Pre-read: Load valid tags before extraction (Phases 4-6)
+
+Before writing any decisions, patterns, or rules, read `.mneme/tags.json` to get the list of valid tag IDs.
+
+<required>
+- Read `.mneme/tags.json` and extract all `id` values from the `tags` array
+- Only use tag IDs that exist in this file — do NOT invent new tag IDs
+- If no existing tag fits perfectly, use the closest match from the list
+- Common tag IDs: `frontend`, `backend`, `api`, `db`, `infra`, `feature`, `bugfix`, `refactor`, `test`, `docs`, `config`, `perf`, `security`, `architecture`, `auth`, `cache`, `search`, `batch`, `integration`, `mcp`, `llm`, `error-handling`, `type`, `ui`
+- The full list has 66+ tags across categories: domain, phase, infra, cloud, architecture, feature, ui, data, ai, quality, workflow
+</required>
+
 4. **Decision extraction (source)**
 - Persist concrete choices and rationale to `decisions/YYYY/MM/*.json`.
 - Apply the classification matrix: only extract items that are **one-time choices with context-specific reasoning**.
@@ -132,6 +164,7 @@ Decision content quality:
   - BAD: `["Use HS256"]`
   - GOOD: `["Use HS256 -> rejected: key rotation difficult in production"]`
   If alternatives is a string array, append " -> rejected: reason" to each entry.
+- `tags`: MUST use only IDs from `.mneme/tags.json` (loaded in pre-read step above)
 </required>
 
 5. **Pattern extraction (source)**
@@ -150,6 +183,11 @@ Pattern content quality:
   - BAD: "when impact is limited"
   - GOOD: "when call sites are 5 or fewer and the interface is stable"
 - **Expected outcomes**: concrete effects when this pattern is applied
+- `type`: MUST be one of: `"good"`, `"bad"`, `"error-solution"`
+  - `"good"`: best practice to follow
+  - `"bad"`: anti-pattern to avoid
+  - `"error-solution"`: additionally requires `errorPattern` and `solution` fields
+- `tags`: MUST use only IDs from `.mneme/tags.json` (loaded in pre-read step above)
 </required>
 
 6. **Rule extraction (source)**
@@ -170,6 +208,7 @@ Rule content quality:
 - `category`: rule classification (type-safety, testing, security, performance, etc.)
 - Active rule must include: `id`, `key`, `text`, `category`, `tags`, `priority`, `rationale`
 - `priority` must be one of: `p0`, `p1`, `p2`
+- `tags`: MUST use only IDs from `.mneme/tags.json` (loaded in pre-read step above)
 </required>
 
 7. **Development rule candidates report**
@@ -178,9 +217,10 @@ Rule content quality:
 - Only items approved by the engineer in the dashboard become active development rules.
 - Do not perform inline approval.
 
-8. **Auto quality checks (required MCP)**
-- Run `mneme_rule_linter` (`ruleType: "all"`).
-- Run `mneme_search_eval` (`mode: "run"`).
+8. **Auto quality checks (required MCP, run in parallel)**
+- Run these two tools **in parallel** (they are independent, no dependency between them):
+  - `mneme_rule_linter` (`ruleType: "all"`)
+  - `mneme_search_eval` (`mode: "run"`)
 
 ## Source definitions and exclusivity (must follow)