feat(hooks): Hook Enhancement v2 - Response Structuring & Expanded Capture

.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "memory-capture",
       "description": "Git-backed memory system for Claude Code. Captures decisions, learnings, and context as git notes with semantic search and automatic recall.",
-      "version": "0.1.0",
+      "version": "0.3.0",
       "author": {
         "name": "Robert Allen",
         "email": "zircote@gmail.com"

.env.example

@@ -42,3 +42,8 @@
 # Override XDG data home (affects default data directory)
 # Default: ~/.local/share
 # XDG_DATA_HOME=~/.local/share
+#
+# =============================================================================
+# HuggingFace tokenizer parallelism warnings (System)
+# =============================================================================
+# TOKENIZERS_PARALLELISM=false

.gitignore

@@ -78,3 +78,6 @@ dmypy.json
 .cs-session-state.json
 .prompt-log.json
 .prompt-log-enabled
+
+# Memory plugin local index
+.memory/

CHANGELOG.md

@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2025-12-19
+
 ### Added
 
 #### Claude Code Hooks Integration
@@ -150,5 +152,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Developer Guide with full API reference
 - README with quick start
 
-[unreleased]: https://github.com/zircote/git-notes-memory/compare/v0.1.0...HEAD
+[unreleased]: https://github.com/zircote/git-notes-memory/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/zircote/git-notes-memory/compare/v0.1.0...v0.3.0
 [0.1.0]: https://github.com/zircote/git-notes-memory/releases/tag/v0.1.0

README.md

@@ -73,9 +73,13 @@ When used as a Claude Code plugin, the following slash commands are available:
 
 The plugin includes hooks that integrate with Claude Code's hook system for automatic memory context:
 
-- **SessionStart**: Injects relevant project memories at session start
-- **UserPromptSubmit**: Detects capture-worthy content in user prompts (opt-in)
-- **Stop**: Prompts for uncaptured content and syncs the search index
+| Hook | Description |
+|------|-------------|
+| **SessionStart** | Injects relevant project memories and response guidance at session start |
+| **UserPromptSubmit** | Detects capture markers like `[remember]` and `@memory` in prompts |
+| **PostToolUse** | Surfaces related memories after file operations (Read/Write/Edit) |
+| **PreCompact** | Auto-captures high-confidence content before context compaction |
+| **Stop** | Prompts for uncaptured content and syncs the search index |
 
 See [User Guide](docs/USER_GUIDE.md#hooks-integration) for configuration options.
 
@@ -114,6 +118,8 @@ Environment variables (see `.env.example` for all options):
 | `HOOK_ENABLED` | Master switch for hooks | `true` |
 | `HOOK_SESSION_START_ENABLED` | Enable SessionStart context injection | `true` |
 | `HOOK_USER_PROMPT_ENABLED` | Enable signal detection in prompts | `false` |
+| `HOOK_POST_TOOL_USE_ENABLED` | Enable file-contextual memory injection | `true` |
+| `HOOK_PRE_COMPACT_ENABLED` | Enable auto-capture before compaction | `true` |
 | `HOOK_STOP_ENABLED` | Enable Stop hook processing | `true` |
 | `HOOK_DEBUG` | Enable debug logging to stderr | `false` |
 

commands/capture.md

@@ -43,7 +43,8 @@ If `$ARGUMENTS` is empty or very short (< 10 characters):
 Use Bash to invoke the Python library:
 
 ```bash
-uv run python3 -c "
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(ls -d ~/.claude/plugins/cache/git-notes-memory/memory-capture/*/ 2>/dev/null | head -1)}"
+uv run --directory "$PLUGIN_ROOT" python3 -c "
 from git_notes_memory import get_capture_service
 
 capture = get_capture_service()

commands/recall.md

@@ -34,7 +34,8 @@ If query is empty:
 Use Bash to invoke the Python library:
 
 ```bash
-uv run python3 -c "
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(ls -d ~/.claude/plugins/cache/git-notes-memory/memory-capture/*/ 2>/dev/null | head -1)}"
+uv run --directory "$PLUGIN_ROOT" python3 -c "
 from git_notes_memory import get_recall_service
 
 recall = get_recall_service()

commands/search.md

@@ -32,7 +32,8 @@ Use Bash to invoke the Python library:
 
 **Semantic Search** (default - vector similarity):
 ```bash
-uv run python3 -c "
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(ls -d ~/.claude/plugins/cache/git-notes-memory/memory-capture/*/ 2>/dev/null | head -1)}"
+uv run --directory "$PLUGIN_ROOT" python3 -c "
 from git_notes_memory import get_recall_service
 
 recall = get_recall_service()
@@ -58,7 +59,8 @@ else:
 
 **Text Search** (keyword/FTS matching):
 ```bash
-uv run python3 -c "
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(ls -d ~/.claude/plugins/cache/git-notes-memory/memory-capture/*/ 2>/dev/null | head -1)}"
+uv run --directory "$PLUGIN_ROOT" python3 -c "
 from git_notes_memory import get_recall_service
 
 recall = get_recall_service()

commands/status.md

@@ -22,7 +22,8 @@ Check if `--verbose` flag is present.
 
 **Basic Status**:
 ```bash
-uv run python3 -c "
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(ls -d ~/.claude/plugins/cache/git-notes-memory/memory-capture/*/ 2>/dev/null | head -1)}"
+uv run --directory "$PLUGIN_ROOT" python3 -c "
 from git_notes_memory import get_sync_service
 from git_notes_memory.index import IndexService
 from git_notes_memory.config import get_embedding_model, get_index_path, get_data_path
@@ -61,11 +62,12 @@ print(f'| Data Directory | {get_data_path()} |')
 
 **Verbose Status**:
 ```bash
-uv run python3 -c "
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(ls -d ~/.claude/plugins/cache/git-notes-memory/memory-capture/*/ 2>/dev/null | head -1)}"
+uv run --directory "$PLUGIN_ROOT" python3 -c "
+import subprocess
 from git_notes_memory import get_sync_service
 from git_notes_memory.index import IndexService
 from git_notes_memory.config import get_embedding_model, get_index_path, get_data_path, NAMESPACES
-import subprocess
 
 sync = get_sync_service()
 index_path = get_index_path()

commands/sync.md

@@ -26,9 +26,10 @@ Use Bash to invoke the Python library based on mode:
 
 **Incremental Sync** (default):
 ```bash
-uv run python3 -c "
-from git_notes_memory import get_sync_service
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(ls -d ~/.claude/plugins/cache/git-notes-memory/memory-capture/*/ 2>/dev/null | head -1)}"
+uv run --directory "$PLUGIN_ROOT" python3 -c "
 import time
+from git_notes_memory import get_sync_service
 
 sync = get_sync_service()
 start = time.time()
@@ -45,9 +46,10 @@ print(f'| Duration | {duration:.2f}s |')
 
 **Full Reindex**:
 ```bash
-uv run python3 -c "
-from git_notes_memory import get_sync_service
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(ls -d ~/.claude/plugins/cache/git-notes-memory/memory-capture/*/ 2>/dev/null | head -1)}"
+uv run --directory "$PLUGIN_ROOT" python3 -c "
 import time
+from git_notes_memory import get_sync_service
 
 sync = get_sync_service()
 start = time.time()
@@ -64,7 +66,8 @@ print(f'| Duration | {duration:.2f}s |')
 
 **Verify Consistency**:
 ```bash
-uv run python3 -c "
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(ls -d ~/.claude/plugins/cache/git-notes-memory/memory-capture/*/ 2>/dev/null | head -1)}"
+uv run --directory "$PLUGIN_ROOT" python3 -c "
 from git_notes_memory import get_sync_service
 
 sync = get_sync_service()
@@ -87,7 +90,8 @@ else:
 
 **Repair**:
 ```bash
-uv run python3 -c "
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(ls -d ~/.claude/plugins/cache/git-notes-memory/memory-capture/*/ 2>/dev/null | head -1)}"
+uv run --directory "$PLUGIN_ROOT" python3 -c "
 from git_notes_memory import get_sync_service
 
 sync = get_sync_service()
@@ -113,7 +117,8 @@ else:
 
 If `--dry-run` is specified, show what would happen without making changes:
 ```bash
-uv run python3 -c "
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(ls -d ~/.claude/plugins/cache/git-notes-memory/memory-capture/*/ 2>/dev/null | head -1)}"
+uv run --directory "$PLUGIN_ROOT" python3 -c "
 from git_notes_memory import get_sync_service
 
 sync = get_sync_service()