Files
claude-mem/src/hooks/CLAUDE.md
T
Alex Newman 2659ec3231 fix: Claude Code 2.1.1 compatibility + log-level audit + path validation fixes (#614)
* Refactor CLAUDE.md and related files for December 2025 updates

- Updated CLAUDE.md in src/services/worker with new entries for December 2025, including changes to Search.ts, GeminiAgent.ts, SDKAgent.ts, and SessionManager.ts.
- Revised CLAUDE.md in src/shared to reflect updates and new entries for December 2025, including paths.ts and worker-utils.ts.
- Modified hook-constants.ts to clarify exit codes and their behaviors.
- Added comprehensive hooks reference documentation for Claude Code, detailing usage, events, and examples.
- Created initial CLAUDE.md files in various directories to track recent activity.

* fix: Merge user-message-hook output into context-hook hookSpecificOutput

- Add footer message to additionalContext in context-hook.ts
- Remove user-message-hook from SessionStart hooks array
- Fixes issue where stderr+exit(1) approach was silently discarded

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Update logs and documentation for recent plugin and worker service changes

- Added detailed logs for worker service activities from Dec 10, 2025 to Jan 7, 2026, including initialization patterns, cleanup confirmations, and diagnostic logging.
- Updated plugin documentation with recent activities, including plugin synchronization and configuration changes from Dec 3, 2025 to Jan 7, 2026.
- Enhanced the context hook and worker service logs to reflect improvements and fixes in the plugin architecture.
- Documented the migration and verification processes for the Claude memory system and its integration with the marketplace.

* Refactor hooks architecture and remove deprecated user-message-hook

- Updated hook configurations in CLAUDE.md and hooks.json to reflect changes in session start behavior.
- Removed user-message-hook functionality as it is no longer utilized in Claude Code 2.1.0; context is now injected silently.
- Enhanced context-hook to handle session context injection without user-visible messages.
- Cleaned up documentation across multiple files to align with the new hook structure and removed references to obsolete hooks.
- Adjusted timing and command execution for hooks to improve performance and reliability.

* fix: Address PR #610 review issues

- Replace USER_MESSAGE_ONLY test with BLOCKING_ERROR test in hook-constants.test.ts
- Standardize Claude Code 2.1.0 note wording across all three documentation files
- Exclude deprecated user-message-hook.ts from logger-usage-standards test

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: Remove hardcoded fake token counts from context injection

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Address PR #610 review issues by fixing test files, standardizing documentation notes, and verifying code quality improvements.

* fix: Add path validation to CLAUDE.md distribution to prevent invalid directory creation

- Add isValidPathForClaudeMd() function to reject invalid paths:
  - Tilde paths (~) that Node.js doesn't expand
  - URLs (http://, https://)
  - Paths with spaces (likely command text or PR references)
  - Paths with # (GitHub issue/PR references)
  - Relative paths that escape project boundary

- Integrate validation in updateFolderClaudeMdFiles loop
- Add 6 unit tests for path validation
- Update .gitignore to prevent accidental commit of malformed directories
- Clean up existing invalid directories (~/, PR #610..., git diff..., https:)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* fix: Implement path validation in CLAUDE.md generation to prevent invalid directory creation

- Added `isValidPathForClaudeMd()` function to validate file paths in `src/utils/claude-md-utils.ts`.
- Integrated path validation in `updateFolderClaudeMdFiles` to skip invalid paths.
- Added 6 new unit tests in `tests/utils/claude-md-utils.test.ts` to cover various rejection cases.
- Updated `.gitignore` to prevent tracking of invalid directories.
- Cleaned up existing invalid directories in the repository.

* feat: Promote critical WARN logs to ERROR level across codebase

Comprehensive log-level audit promoting 38+ WARN messages to ERROR for
improved debugging and incident response:

- Parser: observation type errors, data contamination
- SDK/Agents: empty init responses (Gemini, OpenRouter)
- Worker/Queue: session recovery, auto-recovery failures
- Chroma: sync failures, search failures (now treated as critical)
- SQLite: search failures (primary data store)
- Session/Generator: failures, missing context
- Infrastructure: shutdown, process management failures
- File Operations: CLAUDE.md updates, config reads
- Branch Management: recovery checkout failures

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* fix: Address PR #614 review issues

- Remove incorrectly tracked tilde-prefixed files from git
- Fix absolute path validation to check projectRoot boundaries
- Add test coverage for absolute path validation edge cases

Closes review issues:
- Issue 1: ~/ prefixed files removed from tracking
- Issue 3: Absolute paths now validated against projectRoot
- Issue 4: Added 3 new test cases for absolute path scenarios

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* build assets and context

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-07 23:34:20 -05:00

5.3 KiB

# Recent Activity

Dec 9, 2025

ID Time T Title Read
#23126 6:40 PM Removed SKIP_TOOLS Check from saveHook Function ~288
#23125 " 🔵 SKIP_TOOLS Reference Still Present in saveHook Function ~224
#23124 " Removed SKIP_TOOLS Constant from save-hook.ts ~297
#23123 6:39 PM 🔵 Current SKIP_TOOLS Implementation in save-hook.ts ~397
#23122 " 🔴 Hardened Spinner Stop Mechanism with Timeout and Logging ~361
#23121 " 🔵 Current Spinner Stop Implementation in summary-hook.ts ~348
#23118 6:38 PM Phase 6: StopInput Interface Type Safety Restored ~248
#23117 6:37 PM Phase 6: PostToolUseInput Interface Type Safety Restored ~222
#23116 " Phase 6: UserPromptSubmitInput Interface Type Safety Restored ~216
#23115 " Phase 6: SessionStartInput Interface Type Safety Restored ~341
#23114 " 🔵 Current State of context-hook.ts Interface ~409
#23113 " 🔵 Current State of summary-hook.ts Interface and Spinner Stop ~397
#23112 " 🔵 Current State of save-hook.ts Interface and SKIP_TOOLS ~395
#23111 " 🔵 Current State of new-hook.ts Interface ~381
#23076 6:27 PM Added Comment Explaining Exit Code 3 in user-message-hook.ts ~245
#23075 6:26 PM Deleted Expired Announcement Code from user-message-hook.ts ~354
#23074 " Replaced Verbose Manual Mode Help with Error in cleanup-hook.ts ~222
#23073 " Removed cwd from cleanup-hook Debug Logging ~177
#23072 " Simplified SessionEndInput Interface in cleanup-hook.ts ~236

Dec 10, 2025

ID Time T Title Read
#23407 2:14 PM 🔵 New Hook Implementation Structure ~264

Dec 13, 2025

ID Time T Title Read
#25389 9:30 PM 🔴 Save Hook Error Logging Enhanced With Tool Context ~361
#25388 " 🔴 New Hook Now Logs SDK Agent Start Errors ~344
#25387 9:29 PM 🔴 New Hook Now Logs Session Initialization Errors ~350
#25386 " 🔴 Context Hook Now Logs Error Text Before Throwing ~338
#25385 " Added Logger Import to New Hook ~249
#25384 " Added Logger Import to Context Hook ~223
#25383 " 🔵 New Hook Has Two Silent Failure Points ~392
#25382 9:28 PM 🔵 Save Hook Has Partial Error Logging ~351
#25381 " 🔵 Summary Hook Has Partial Error Logging ~345
#25380 " 🔵 Context Hook Silent Failure Pattern Confirmed ~354

Dec 14, 2025

ID Time T Title Read
#26730 11:24 PM 🔵 Context Hook TypeScript Source Shows EnsureWorkerRunning as First Action ~441
#26729 " 🔵 Context Hook TypeScript Source Calls ensureWorkerRunning Before API Requests ~411
#26260 8:32 PM 🔵 User Message Hook Calls Context Inject with colors=true Parameter ~300
#26244 8:29 PM 🔵 Context Hook Delegates to Worker API Context Endpoint ~260
#25692 4:24 PM 🔵 Summary hook extracts last user and assistant messages from transcript file before sending to worker ~465

Dec 17, 2025

ID Time T Title Read
#28449 4:23 PM 🔵 New Hook Session Initialization Flow ~385

Dec 19, 2025

ID Time T Title Read
#30105 8:11 PM 🔵 Hook Response Utility Standardizes Hook Output Format ~387
#30103 8:10 PM 🔵 Context Hook Injects Mode-Based Memory Context During SessionStart ~460

Dec 20, 2025

ID Time T Title Read
#31085 7:59 PM 🔵 Summary Hook Uses session_id from Hook Input ~315

Dec 27, 2025

ID Time T Title Read
#33216 9:07 PM 🔵 UserPromptSubmit Hook (new-hook.ts) Initializes Session and Starts SDK Agent via Two HTTP Endpoints ~735
#33211 9:04 PM 🔵 User Message Hook Displays Context Info via stderr in Parallel with Context Injection ~476
#33210 9:03 PM 🔵 Summary Hook (summary-hook.ts) Extracts Messages and Triggers Summarization ~479
#33209 " 🔵 SessionStart Hook (context-hook.ts) Fetches Context Injection via HTTP ~520

Jan 7, 2026

ID Time T Title Read
#38235 7:42 PM Deprecated User Message Hook Source File ~399
#38176 7:26 PM ⚖️ Plan Created to Merge User Message into Context Hook JSON Output ~536
#38175 " 🔵 Complete Claude-Mem Hook Output Architecture Documented ~530
#38174 " 🔵 UserPromptSubmit Hook Initializes Sessions and Strips Slash Commands ~480
#38173 7:25 PM 🔵 Standard Hook Response Pattern for Non-SessionStart Hooks ~343
#38172 7:22 PM 🔵 Claude Code Hook Output Architecture Clarified - Exit Code Pattern is Correct for User-Only Display ~523
#38170 7:21 PM 🔵 User-Message-Hook TypeScript Source Shows Exit Code 1 Strategy for User-Only Display ~203