diff --git a/.claude-plugin/CLAUDE.md b/.claude-plugin/CLAUDE.md deleted file mode 100644 index f1d5f402..00000000 --- a/.claude-plugin/CLAUDE.md +++ /dev/null @@ -1,136 +0,0 @@ - -# Recent Activity - -### Oct 25, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #2374 | 2:55 PM | ✅ | Marketplace metadata version synchronized to 4.2.11 | ~157 | - -### Oct 27, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #2757 | 1:23 AM | 🟣 | Released v4.3.3 with Configurable Session Display and First-Time Setup UX | ~391 | - -### Nov 4, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #3706 | 9:47 PM | ✅ | Marketplace Plugin Version Synchronized to 5.0.2 | ~162 | -| #3655 | 3:43 PM | ✅ | Version bumped to 5.0.1 across project | ~354 | - -### Nov 5, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #4068 | 10:58 PM | ✅ | Committed v5.1.0 release with comprehensive release notes | ~486 | -| #4066 | 10:57 PM | ✅ | Updated marketplace.json version to 5.1.0 | ~192 | -| #3739 | 2:24 PM | ✅ | Updated version to 5.0.3 across project manifests | ~322 | - -### Nov 6, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #4099 | 1:13 PM | 🟣 | Theme Toggle for Light/Dark Mode | ~253 | -| #4096 | " | ✅ | Marketplace Metadata Version Sync | ~179 | -| #4092 | 1:12 PM | 🔵 | Marketplace Configuration for Claude-Mem Plugin | ~194 | -| #4078 | 12:50 PM | 🔴 | Fixed PM2 ENOENT error on Windows systems | ~286 | -| #4075 | 12:49 PM | ✅ | Marketplace plugin version synchronized to 5.1.1 | ~189 | - -### Nov 7, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #4612 | 6:33 PM | ✅ | Version Bumped to 5.2.0 Across All Package Metadata | ~359 | -| #4598 | 6:31 PM | ✅ | PR #69 Merged: cleanup/worker Branch Integration | ~469 | -| #4298 | 11:54 AM | 🔴 | Fixed PostToolUse Hook Schema Compliance | ~310 | -| #4295 | 11:53 AM | ✅ | Synchronized Plugin Marketplace Version to 5.1.4 | ~188 | - -### Nov 8, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #5150 | 7:37 PM | 🟣 | Troubleshooting Skill Added to Claude-Mem Plugin | ~427 | -| #5133 | 7:29 PM | ✅ | Version 5.2.3 Released with Build Process | ~487 | - -### Nov 9, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #5941 | 7:14 PM | ✅ | Marketplace Version Updated to 5.4.0 | ~157 | - -### Nov 10, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #6341 | 1:49 PM | ✅ | Version Bumped to 5.4.1 | ~239 | - -### Nov 11, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #6602 | 1:51 PM | ✅ | Version 5.4.5 Released to GitHub | ~279 | -| #6601 | " | ✅ | Version Patch Bump 5.4.4 to 5.4.5 | ~233 | - -### Nov 14, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #8212 | 3:06 PM | 🔵 | Version Consistency Verification Across Multiple Configuration Files | ~238 | - -### Nov 25, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #14882 | 1:32 PM | 🔵 | Marketplace Configuration Defines Plugin Version and Source Directory | ~366 | - -### Nov 30, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #18064 | 10:52 PM | ✅ | Bumped version to 6.3.7 in marketplace.json | ~179 | -| #18060 | 10:51 PM | 🔵 | Read marketplace.json plugin manifest | ~190 | - -### Dec 1, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #18428 | 3:33 PM | 🔵 | Version Conflict in Marketplace Configuration | ~191 | - -### Dec 4, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #20049 | 3:23 PM | ✅ | Updated marketplace.json version to 6.5.2 | ~203 | - -### Dec 9, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #22559 | 1:08 AM | ✅ | Version 7.0.3 committed to repository | ~261 | -| #22551 | 1:07 AM | ✅ | Marketplace metadata updated to version 7.0.3 | ~179 | - -### Dec 10, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #23440 | 2:25 PM | ✅ | Marketplace Configuration Updated to 7.0.8 | ~188 | - -### Dec 14, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #26799 | 11:39 PM | ✅ | Marketplace Manifest Version Updated to 7.2.3 | ~248 | -| #26796 | " | ✅ | Version Bumped to 7.2.3 in marketplace.json | ~259 | -| #26792 | 11:38 PM | 🔵 | Current Version Confirmed as 7.2.2 Across All Configuration Files | ~291 | - -### Dec 16, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #28306 | 10:08 PM | 🔵 | Marketplace Configuration Also Shows Version 7.3.3 | ~220 | -| #27555 | 4:48 PM | ✅ | Version bump committed to main branch | ~242 | -| #27553 | " | ✅ | Version consistency verified across all configuration files | ~195 | -| #27551 | 4:47 PM | ✅ | Marketplace.json version updated to 7.3.1 | ~207 | - \ No newline at end of file diff --git a/.claude/skills/CLAUDE.md b/.claude/skills/CLAUDE.md deleted file mode 100644 index 9be5808a..00000000 --- a/.claude/skills/CLAUDE.md +++ /dev/null @@ -1,29 +0,0 @@ -# Project-Level Skills - -This directory contains skills **for developing and maintaining the claude-mem project itself**, not skills that are released as part of the plugin. - -## Distinction - -**Project Skills** (`.claude/skills/`): -- Used by developers working on claude-mem -- Not included in the plugin distribution -- Project-specific workflows (version bumps, release management, etc.) -- Not synced to `~/.claude/plugins/marketplaces/thedotmack/` - -**Plugin Skills** (`plugin/skills/`): -- Released as part of the claude-mem plugin -- Available to all users who install the plugin -- General-purpose memory search functionality -- Synced to user installations via `npm run sync-marketplace` - -## Skills in This Directory - -### version-bump -Manages semantic versioning for the claude-mem project itself. Handles updating all three version files (package.json, marketplace.json, plugin.json), creating git tags, and GitHub releases. - -**Usage**: Only for claude-mem maintainers releasing new versions. - -## Adding New Skills - -**For claude-mem development** → Add to `.claude/skills/` -**For end users** → Add to `plugin/skills/` (gets distributed with plugin) \ No newline at end of file diff --git a/docs/CLAUDE.md b/docs/CLAUDE.md deleted file mode 100644 index 4a15d484..00000000 --- a/docs/CLAUDE.md +++ /dev/null @@ -1,83 +0,0 @@ - -# Recent Activity - - - -### Nov 6, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #4241 | 11:19 PM | 🟣 | Object-Oriented Architecture Design Document Created | ~662 | -| #4240 | 11:11 PM | 🟣 | Worker Service Rewrite Blueprint Created | ~541 | -| #4239 | 11:07 PM | 🟣 | Comprehensive Worker Service Performance Analysis Document Created | ~541 | -| #4238 | 10:59 PM | 🔵 | Overhead Analysis Document Checked | ~203 | - -### Nov 7, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #4609 | 6:33 PM | ✅ | PR #69 Successfully Merged to Main Branch | ~516 | -| #4600 | 6:31 PM | 🟣 | Added Worker Service Documentation Suite | ~441 | -| #4597 | " | 🔄 | Worker Service Refactored to Object-Oriented Architecture | ~473 | - -### Nov 8, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #5539 | 10:20 PM | 🔵 | Harsh critical audit of context-hook reveals systematic anti-patterns | ~3154 | -| #5497 | 9:29 PM | 🔵 | Harsh critical audit of context-hook reveals systematic anti-patterns | ~2815 | -| #5495 | 9:28 PM | 🔵 | Context Hook Audit Reveals Project Anti-Patterns | ~660 | -| #5476 | 9:17 PM | 🔵 | Critical Code Audit Identified 14 Anti-Patterns in Context Hook | ~887 | -| #5391 | 8:45 PM | 🔵 | Critical Code Quality Audit of Context Hook Implementation | ~720 | -| #5150 | 7:37 PM | 🟣 | Troubleshooting Skill Added to Claude-Mem Plugin | ~427 | - -### Nov 9, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #6161 | 11:55 PM | 🔵 | YC W26 Application Research and Preparation Completed for Claude-Mem | ~1628 | -| #6155 | 11:47 PM | ✅ | Comprehensive Y Combinator Winter 2026 Application Notes Created | ~1045 | -| #5979 | 7:58 PM | 🔵 | Smart Contextualization Feature Architecture | ~560 | -| #5971 | 7:49 PM | 🔵 | Hooks Reference Documentation Structure | ~448 | -| #5929 | 7:08 PM | ✅ | Documentation Updates for v5.4.0 Skill-Based Search Migration | ~604 | -| #5927 | " | ✅ | Updated Configuration Documentation for Skill-Based Search | ~497 | -| #5920 | 7:05 PM | ✅ | Renamed Architecture Documentation File Reference | ~271 | - -### Nov 18, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #11515 | 8:22 PM | 🔵 | Smart Contextualization Architecture Retrieved with Command Hook Pattern Details | ~502 | - -### Dec 8, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #22294 | 9:43 PM | 🔵 | Documentation Site Structure Located | ~359 | - -### Dec 12, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #24430 | 8:27 PM | ✅ | Removed Final Platform Check Reference from Linux Section | ~320 | -| #24429 | " | ✅ | Final Platform Check Reference Removal from Linux Section | ~274 | -| #24428 | " | ✅ | Corrected Second Line Number Reference for Migration Marker Logic | ~267 | -| #24427 | 8:26 PM | ✅ | Updated Line Number Reference for PM2 Cleanup Implementation | ~260 | -| #24426 | " | ✅ | Removed Platform Check from Manual Marker Deletion Scenario | ~338 | -| #24425 | " | ✅ | Removed Platform Check from Fresh Install Scenario Flow | ~314 | -| #24424 | 8:25 PM | ✅ | Renumbered Manual Marker Deletion Scenario | ~285 | -| #24423 | " | ✅ | Renumbered Fresh Install Scenario | ~243 | -| #24422 | " | ✅ | Removed Obsolete Windows Platform Detection Scenario | ~311 | -| #24421 | " | ✅ | Removed Platform Check from macOS Migration Documentation | ~294 | -| #24420 | 8:24 PM | ✅ | Platform Check Removed from Migration Documentation | ~288 | -| #24417 | 8:16 PM | ✅ | Code Reference Example Updated to Reflect Actual Cross-Platform Implementation | ~366 | -| #24416 | " | ✅ | Architecture Decision Documentation Updated to Reflect Cross-Platform PM2 Cleanup Rationale | ~442 | -| #24415 | 8:15 PM | ✅ | Migration Marker Lifecycle Documentation Updated for Unified Cross-Platform Behavior | ~463 | -| #24414 | " | ✅ | Platform Comparison Table Updated to Reflect Unified Cross-Platform Migration | ~351 | -| #24413 | " | ✅ | Windows Platform-Specific Documentation Completely Rewritten for Unified Migration | ~428 | -| #24412 | " | ✅ | User Experience Timeline Updated for Cross-Platform PM2 Cleanup | ~291 | -| #24411 | 8:14 PM | ✅ | Migration Marker Lifecycle Documentation Updated for All Platforms | ~277 | -| #24410 | " | ✅ | Marker File Platform Behavior Documentation Updated for Unified Migration | ~282 | -| #24409 | " | ✅ | Migration Steps Documentation Updated for Cross-Platform PM2 Cleanup | ~278 | -| #24408 | 8:13 PM | ✅ | PM2 Migration Documentation Updated to Remove Windows Platform Check | ~280 | - \ No newline at end of file diff --git a/docs/public/CLAUDE.md b/docs/public/CLAUDE.md deleted file mode 100644 index bb075855..00000000 --- a/docs/public/CLAUDE.md +++ /dev/null @@ -1,88 +0,0 @@ -# Claude-Mem Public Documentation - -## What This Folder Is - -This `docs/public/` folder contains the **Mintlify documentation site** - the official user-facing documentation for claude-mem. It's a structured documentation platform with a specific file format and organization. - -## Folder Structure - -``` -docs/ -├── public/ ← You are here (Mintlify MDX files) -│ ├── *.mdx - User-facing documentation pages -│ ├── docs.json - Mintlify configuration and navigation -│ ├── architecture/ - Technical architecture docs -│ ├── usage/ - User guides and workflows -│ └── *.webp, *.gif - Assets (logos, screenshots) -└── context/ ← Internal documentation (DO NOT put here) - └── *.md - Planning docs, audits, references -``` - -## File Requirements - -### Mintlify Documentation Files (.mdx) -All official documentation files must be: -- Written in `.mdx` format (Markdown with JSX support) -- Listed in `docs.json` navigation structure -- Follow Mintlify's schema and conventions - -The documentation is organized into these sections: -- **Get Started**: Introduction, installation, usage guides -- **Best Practices**: Context engineering, progressive disclosure -- **Configuration & Development**: Settings, dev workflow, troubleshooting -- **Architecture**: System design, components, technical details - -### Configuration File -`docs.json` defines: -- Site metadata (name, description, theme) -- Navigation structure -- Branding (logos, colors) -- Footer links and social media - -## What Does NOT Belong Here - -**Planning documents, design docs, and reference materials go in `/docs/context/` instead:** - -Files that belong in `/docs/context/` (NOT here): -- Planning documents (`*-plan.md`, `*-outline.md`) -- Implementation analysis (`*-audit.md`, `*-code-reference.md`) -- Error tracking (`typescript-errors.md`) -- Internal design documents -- PR review responses -- Reference materials (like `agent-sdk-ref.md`) -- Work-in-progress documentation - -## How to Add Official Documentation - -1. Create a new `.mdx` file in the appropriate subdirectory -2. Add the file path to `docs.json` navigation -3. Use Mintlify's frontmatter and components -4. Follow the existing documentation style -5. Test locally: `npx mintlify dev` - -## Development Workflow - -**For contributors working on claude-mem:** -- Read `/CLAUDE.md` in the project root for development instructions -- Place planning/design docs in `/docs/context/` -- Only add user-facing documentation to `/docs/public/` -- Test documentation locally with Mintlify CLI before committing - -## Testing Documentation - -```bash -# Validate docs structure -npx mintlify validate - -# Check for broken links -npx mintlify broken-links - -# Run local dev server -npx mintlify dev -``` - -## Summary - -**Simple Rule**: -- `/docs/public/` = Official user documentation (Mintlify .mdx files) ← YOU ARE HERE -- `/docs/context/` = Internal docs, plans, references, audits \ No newline at end of file diff --git a/plugin/.claude-plugin/CLAUDE.md b/plugin/.claude-plugin/CLAUDE.md deleted file mode 100644 index f9635d63..00000000 --- a/plugin/.claude-plugin/CLAUDE.md +++ /dev/null @@ -1,21 +0,0 @@ - -# Recent Activity - -### Nov 6, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #4091 | 1:12 PM | 🔵 | Claude Plugin Configuration Structure | ~170 | - -### Nov 9, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #5739 | 4:43 PM | 🔵 | Plugin Metadata Configuration | ~199 | - -### Dec 8, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #22284 | 9:41 PM | 🔵 | Claude Plugin Metadata Configuration | ~183 | - \ No newline at end of file diff --git a/plugin/CLAUDE.md b/plugin/CLAUDE.md deleted file mode 100644 index fb048ea7..00000000 --- a/plugin/CLAUDE.md +++ /dev/null @@ -1,9 +0,0 @@ - -# Recent Activity - -### Jan 10, 2026 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #39050 | 3:44 PM | 🔵 | Plugin commands directory is empty | ~255 | - \ No newline at end of file diff --git a/plugin/hooks/CLAUDE.md b/plugin/hooks/CLAUDE.md deleted file mode 100644 index f7ac464e..00000000 --- a/plugin/hooks/CLAUDE.md +++ /dev/null @@ -1,35 +0,0 @@ - -# Recent Activity - -### Oct 25, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #2518 | 11:47 PM | 🔴 | Removed Invalid 'matcher' Field from SessionStart Hook | ~228 | -| #2517 | " | 🔵 | Project hooks.json Template Also Empty | ~222 | -| #2501 | 11:11 PM | 🔵 | Context Hook Fails Due to Missing @anthropic-ai/sdk Dependency | ~245 | - -### Oct 27, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #2718 | 12:00 AM | 🔴 | Removed incorrect failOnError configuration from hook | ~165 | - -### Nov 18, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #11518 | 8:22 PM | 🔵 | Smart Contextualization Switched from Skill to HTTP API | ~498 | - -### Dec 24, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #32309 | 3:09 PM | 🔵 | Claude-mem hooks system configuration structure | ~435 | - -### Jan 9, 2026 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #38802 | 5:11 PM | 🔵 | Claude-Mem Hook Configuration Architecture | ~450 | - \ No newline at end of file diff --git a/plugin/scripts/CLAUDE.md b/plugin/scripts/CLAUDE.md deleted file mode 100644 index 3470ebc4..00000000 --- a/plugin/scripts/CLAUDE.md +++ /dev/null @@ -1,125 +0,0 @@ -Never read built source files in this directory. These are compiled outputs — read the source files in `src/` instead. - - -# Recent Activity - -### Dec 4, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #20052 | 3:23 PM | ✅ | Built and deployed version 6.5.2 to marketplace | ~321 | - -### Dec 7, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #21251 | 6:06 PM | 🔵 | Context Hook Plugin Architecture and Worker Communication | ~405 | - -### Dec 8, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #22092 | 6:40 PM | 🔵 | Queue Depth Check Not Found in Minified Code | ~217 | -| #22091 | " | 🔵 | Save Hook Script Structure Revealed | ~472 | -| #22085 | 6:34 PM | 🔵 | Examined pre-tool-use-hook.js implementation showing timing-only logic | ~330 | - -### Dec 9, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #22557 | 1:08 AM | ✅ | Build completed for version 7.0.3 | ~342 | - -### Dec 10, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #23444 | 2:25 PM | 🟣 | Build Pipeline Execution Successful | ~293 | - -### Dec 11, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #24057 | 2:56 PM | ✅ | Hook Scripts Shebang Verification | ~294 | -| #24056 | 2:55 PM | ✅ | Worker CLI Shebang Verification | ~258 | -| #24055 | " | ✅ | Build Successful with Bun Runtime Shebangs | ~355 | - -### Dec 12, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #24636 | 10:46 PM | 🔵 | Duplicate Smart Install Scripts in Project Structure | ~288 | -| #24635 | " | 🔵 | Claude-Mem Smart Install Script Architecture | ~371 | -| #24359 | 7:00 PM | 🟣 | Phase 1 Critical Code Fixes Completed via Agent Task | ~441 | -| #24358 | 6:59 PM | ✅ | Completed Phase 1 Code Fixes for better-sqlite3 Migration | ~385 | -| #24357 | " | ✅ | Removed createRequire Import from smart-install.js | ~284 | -| #24356 | " | ✅ | Removed Native Module Verification from main() Function | ~384 | -| #24355 | " | ✅ | Removed better-sqlite3 Error Detection from runNpmInstall() | ~324 | -| #24354 | 6:58 PM | ✅ | Removed getWindowsErrorHelp() Function from smart-install.js | ~356 | -| #24353 | " | ✅ | Removed verifyNativeModules() Function from smart-install.js | ~340 | -| #24352 | " | ✅ | Removed better-sqlite3 Existence Check from needsInstall() | ~266 | -| #24351 | " | ✅ | Removed BETTER_SQLITE3_PATH Constant from smart-install.js | ~226 | -| #24344 | 6:56 PM | 🔵 | smart-install.js Contains Obsolete better-sqlite3 Dependencies | ~380 | - -### Dec 13, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #25286 | 8:41 PM | 🔵 | New Hook Fails with Node.js Path Error | ~298 | -| #25285 | " | 🔵 | Context Hook Runs Successfully with Node.js | ~306 | -| #25283 | " | 🔵 | Bun Wrapper Analysis: Fallback Detection System | ~416 | - -### Dec 14, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #26800 | 11:39 PM | ✅ | Version 7.2.3 Build Complete With Worker Restart Fix | ~394 | -| #26791 | 11:38 PM | ✅ | Phase 3 Complete: Project Built Successfully With Worker Restart Fix | ~446 | -| #26720 | 11:23 PM | 🔵 | Smart Install Handles Dependencies But No Worker Coordination | ~468 | -| #26719 | " | 🔵 | Worker CLI Provides Start/Stop/Restart Commands With Health Check Validation | ~490 | -| #26718 | " | 🔵 | Worker CLI Restart Implementation Details | ~452 | -| #26717 | 11:22 PM | 🔵 | Context Hook Worker Startup Logic Handles Initial Start But Not Post-Update Restart | ~485 | -| #26716 | " | 🔵 | Context Hook Worker Startup Logic Revealed | ~538 | -| #26715 | " | 🔵 | Smart Install Script Handles Dependency Installation Without Worker Restart | ~430 | -| #26052 | 7:13 PM | 🔵 | Examined Minified Context Hook Source Code | ~285 | -| #25686 | 4:22 PM | 🔵 | SessionRoutes tracks missing last_user_message errors at two different locations | ~456 | -| #25685 | " | 🔵 | Progress summary generation system uses Claude to create XML-formatted session checkpoints | ~461 | - -### Dec 16, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #27554 | 4:48 PM | ✅ | Project built successfully with version 7.3.1 | ~306 | - -### Dec 17, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #28924 | 7:29 PM | 🔵 | Plugin MCP Server Uses Bun Runtime | ~283 | - -### Dec 26, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #32983 | 11:04 PM | 🟣 | Complete build and deployment pipeline executed | ~260 | - -### Jan 4, 2026 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #36873 | 1:55 AM | 🔵 | Smart-Install Script Analyzed for Homebrew Path Implementation | ~466 | - -### Jan 7, 2026 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #38169 | 7:21 PM | 🔵 | SessionStart Hook Output Pattern Investigation Complete | ~464 | -| #38168 | " | 🔵 | Smart-Install Script Outputs All Status Messages to stderr via console.error | ~438 | -| #38167 | 7:20 PM | 🔵 | Context-Hook Uses stdin Event Handlers for Non-TTY JSON Output Mode | ~396 | -| #38166 | " | 🔵 | User-Message-Hook Executes at Top Level with Await and Exit Code 1 | ~423 | -| #38165 | " | 🔵 | Context-Hook Has Minimal Console Output in Compiled Code | ~333 | -| #38164 | " | 🔵 | Worker-Service Script is Large 1575-Line Multi-Purpose Service Manager | ~352 | -| #38163 | 7:19 PM | 🔵 | Worker-Service Script Uses console.log and console.error for Output | ~385 | -| #38162 | " | 🔵 | Smart-Install Script Auto-Installs Bun and UV Dependencies | ~495 | -| #38161 | " | 🔵 | User-Message-Hook Outputs to stderr and Exits with Code 1 | ~211 | -| #38160 | 7:18 PM | 🔵 | Context-Hook Returns JSON with hookSpecificOutput Structure | ~470 | - \ No newline at end of file diff --git a/plugin/ui/CLAUDE.md b/plugin/ui/CLAUDE.md deleted file mode 100644 index 66c38643..00000000 --- a/plugin/ui/CLAUDE.md +++ /dev/null @@ -1,60 +0,0 @@ - -# Recent Activity - -### Nov 5, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #3910 | 8:28 PM | ✅ | Refined stats counter visual design | ~343 | -| #3909 | " | 🟣 | Added clarifying descriptions to settings UI | ~335 | -| #3812 | 6:08 PM | 🟣 | Enhanced card typography and centered content layout | ~358 | - -### Nov 8, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #5133 | 7:29 PM | ✅ | Version 5.2.3 Released with Build Process | ~487 | -| #4916 | 1:49 PM | ⚖️ | Claude Mem Pro Premium Offering Implementation Plan Finalized | ~946 | -| #4902 | 1:35 PM | 🟣 | Claude Mem Pro Premium Project Initialization | ~679 | -| #4901 | 1:31 PM | ⚖️ | Premium claude-mem Project Architecture and Planning | ~797 | - -### Dec 1, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #18480 | 3:39 PM | ✅ | Successfully Rebuilt Plugin After Merge Conflict Resolution | ~294 | - -### Dec 4, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #20052 | 3:23 PM | ✅ | Built and deployed version 6.5.2 to marketplace | ~321 | - -### Dec 9, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #22557 | 1:08 AM | ✅ | Build completed for version 7.0.3 | ~342 | - -### Dec 10, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #23444 | 2:25 PM | 🟣 | Build Pipeline Execution Successful | ~293 | - -### Dec 16, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #27554 | 4:48 PM | ✅ | Project built successfully with version 7.3.1 | ~306 | - -### Dec 26, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #32983 | 11:04 PM | 🟣 | Complete build and deployment pipeline executed | ~260 | -| #32965 | 10:53 PM | 🔵 | Found plugin/ui/viewer.html - potential styling source | ~201 | -| #32966 | " | 🔵 | viewer.html contains modal CSS including modal-header and modal-body | ~218 | -| #32967 | " | 🔵 | ContextSettingsModal.tsx uses CSS classes defined in viewer.html | ~218 | -| #32968 | " | 🔵 | Need to add CSS for footer to viewer.html | ~223 | - \ No newline at end of file diff --git a/ragtime/CLAUDE.md b/ragtime/CLAUDE.md deleted file mode 100644 index 8a44ee8f..00000000 --- a/ragtime/CLAUDE.md +++ /dev/null @@ -1,22 +0,0 @@ - -# Recent Activity - -### Dec 19, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #30153 | 8:24 PM | 🔵 | Context Builder Creates Formatted Email Investigation Context | ~384 | -| #30152 | " | 🔵 | Ragtime Current Implementation: Manual Context Injection Via buildContextForEmail | ~357 | - -### Dec 20, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #30437 | 4:23 PM | 🔵 | Ragtime processes emails through Claude Agent SDK with claude-mem plugin | ~397 | -| #30436 | 4:22 PM | 🔵 | Ragtime displays worker URL on localhost:37777 | ~219 | -| #30340 | 3:42 PM | 🔄 | Relocated simple ragtime.ts to ragtime folder | ~219 | -| #30339 | 3:41 PM | ✅ | Deleted overengineered ragtime.ts script | ~201 | -| #30336 | 3:40 PM | 🔵 | Ragtime Email Corpus Processor Architecture | ~495 | -| #30335 | " | 🔵 | Ragtime Uses Separate Noncommercial License | ~259 | -| #30252 | 3:17 PM | 🟣 | Multi-Format Email Corpus Loader | ~436 | - \ No newline at end of file diff --git a/scripts/CLAUDE.md b/scripts/CLAUDE.md deleted file mode 100644 index a505642c..00000000 --- a/scripts/CLAUDE.md +++ /dev/null @@ -1 +0,0 @@ -Never read built source files in this directory. These are compiled outputs — read the source files in `src/` instead. diff --git a/scripts/anti-pattern-test/CLAUDE.md b/scripts/anti-pattern-test/CLAUDE.md deleted file mode 100644 index 128b293e..00000000 --- a/scripts/anti-pattern-test/CLAUDE.md +++ /dev/null @@ -1,137 +0,0 @@ -# Error Handling Anti-Pattern Rules - -This folder contains `detect-error-handling-antipatterns.ts` - run it before committing any error handling changes. - -## The Try-Catch Problem That Cost 10 Hours - -A single overly-broad try-catch block wasted 10 hours of debugging time by silently swallowing errors. -**This pattern is BANNED.** - -## BEFORE You Write Any Try-Catch - -**RUN THIS TEST FIRST:** -```bash -bun run scripts/anti-pattern-test/detect-error-handling-antipatterns.ts -``` - -**You MUST answer these 5 questions to the user BEFORE writing try-catch:** - -1. **What SPECIFIC error am I catching?** (Name the error type: `FileNotFoundError`, `NetworkTimeout`, `ValidationError`) -2. **Show documentation proving this error can occur** (Link to docs or show me the source code) -3. **Why can't this error be prevented?** (If it can be prevented, prevent it instead) -4. **What will the catch block DO?** (Must include logging + either rethrow OR explicit fallback) -5. **Why shouldn't this error propagate?** (Justify swallowing it rather than letting caller handle) - -**If you cannot answer ALL 5 questions with specifics, DO NOT write the try-catch.** - -## FORBIDDEN PATTERNS (Zero Tolerance) - -### CRITICAL - Never Allowed - -```typescript -// FORBIDDEN: Empty catch -try { - doSomething(); -} catch {} - -// FORBIDDEN: Catch without logging -try { - doSomething(); -} catch (error) { - return null; // Silent failure! -} - -// FORBIDDEN: Large try blocks (>10 lines) -try { - // 50 lines of code - // Multiple operations - // Different failure modes -} catch (error) { - logger.error('Something failed'); // Which thing?! -} - -// FORBIDDEN: Promise empty catch -promise.catch(() => {}); // Error disappears into void - -// FORBIDDEN: Try-catch to fix TypeScript errors -try { - // @ts-ignore - const value = response.propertyThatDoesntExist; -} catch {} -``` - -### ALLOWED Patterns - -```typescript -// GOOD: Specific, logged, explicit handling -try { - await fetch(url); -} catch (error) { - if (error instanceof NetworkError) { - logger.warn('SYNC', 'Network request failed, will retry', { url }, error); - return null; // Explicit: null means "fetch failed" - } - throw error; // Unexpected errors propagate -} - -// GOOD: Minimal scope, clear recovery -try { - JSON.parse(data); -} catch (error) { - logger.error('CONFIG', 'Corrupt settings file, using defaults', {}, error); - return DEFAULT_SETTINGS; -} - -// GOOD: Fire-and-forget with logging -backgroundTask() - .catch(error => logger.warn('BACKGROUND', 'Task failed', {}, error)); - -// GOOD: Ignored anti-pattern for genuine hot paths only -try { - checkIfProcessAlive(pid); -} catch (error) { - // [ANTI-PATTERN IGNORED]: Tight loop checking 100s of PIDs during cleanup - return false; -} -``` - -## Ignoring Anti-Patterns (Rare) - -**Only for genuine hot paths** where logging would cause performance problems: - -```typescript -// [ANTI-PATTERN IGNORED]: Reason why logging is impossible -``` - -**Rules:** -- **Hot paths only** - code in tight loops called 1000s of times -- If you can add logging, ADD LOGGING - don't ignore -- Valid examples: - - "Tight loop checking process exit status during cleanup" - - "Health check polling every 100ms" -- Invalid examples: - - "Expected JSON parse failures" - Just add logger.debug - - "Common fallback path" - Just add logger.debug - -## The Meta-Rule - -**UNCERTAINTY TRIGGERS RESEARCH, NOT TRY-CATCH** - -When you're unsure if a property exists or a method signature is correct: -1. **READ** the source code or documentation -2. **VERIFY** with the Read tool -3. **USE** TypeScript types to catch errors at compile time -4. **WRITE** code you KNOW is correct - -Never use try-catch to paper over uncertainty. That wastes hours of debugging time later. - -## Critical Path Protection - -These files are **NEVER** allowed to have catch-and-continue: -- `SDKAgent.ts` - Errors must propagate, not hide -- `GeminiAgent.ts` - Must fail loud, not silent -- `OpenRouterAgent.ts` - Must fail loud, not silent -- `SessionStore.ts` - Database errors must propagate -- `worker-service.ts` - Core service errors must be visible - -On critical paths, prefer **NO TRY-CATCH** and let errors propagate naturally. \ No newline at end of file diff --git a/src/CLAUDE.md b/src/CLAUDE.md deleted file mode 100644 index 59ab83fc..00000000 --- a/src/CLAUDE.md +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/src/cli/CLAUDE.md b/src/cli/CLAUDE.md deleted file mode 100644 index 80af5e45..00000000 --- a/src/cli/CLAUDE.md +++ /dev/null @@ -1,34 +0,0 @@ - -# Recent Activity - -### Dec 10, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #23825 | 11:12 PM | ✅ | Worker Port Set to 38888 for Migration Phase | ~283 | -| #23824 | " | 🔵 | Worker Port Sourced from getWorkerPort() Utility | ~247 | -| #23816 | 10:52 PM | 🟣 | Worker CLI Command Interface Created | ~325 | - -### Dec 11, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #24060 | 2:58 PM | 🔴 | Worker CLI Start Command Exit Behavior Fixed | ~232 | - -### Dec 12, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #24359 | 7:00 PM | 🟣 | Phase 1 Critical Code Fixes Completed via Agent Task | ~441 | -| #24358 | 6:59 PM | ✅ | Completed Phase 1 Code Fixes for better-sqlite3 Migration | ~385 | -| #24348 | 6:57 PM | 🔴 | Added Defensive Break Statement to worker-cli.ts Restart Case | ~269 | -| #24345 | " | 🔵 | worker-cli.ts Missing Break Statement in Switch Case | ~318 | - -### Dec 14, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #26766 | 11:30 PM | ⚖️ | Root Cause Identified: Missing Post-Install Worker Restart Trigger in Plugin Update Flow | ~604 | -| #26722 | 11:23 PM | 🔵 | Worker CLI TypeScript Source Shows Simple ProcessManager Delegation | ~394 | -| #26721 | " | 🔵 | Worker CLI Source Code Shows Simple Restart Logic Without Delays | ~425 | - \ No newline at end of file diff --git a/src/cli/adapters/CLAUDE.md b/src/cli/adapters/CLAUDE.md deleted file mode 100644 index 59ab83fc..00000000 --- a/src/cli/adapters/CLAUDE.md +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/src/cli/handlers/CLAUDE.md b/src/cli/handlers/CLAUDE.md deleted file mode 100644 index 59ab83fc..00000000 --- a/src/cli/handlers/CLAUDE.md +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file diff --git a/src/services/CLAUDE.md b/src/services/CLAUDE.md deleted file mode 100644 index c2153a04..00000000 --- a/src/services/CLAUDE.md +++ /dev/null @@ -1,61 +0,0 @@ - -# Recent Activity - -### Dec 10, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #23832 | 11:15 PM | 🔵 | Current worker-service.ts Lacks Admin Endpoints | ~393 | - -### Dec 14, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #26740 | 11:26 PM | 🔵 | Worker Service Refactored to Orchestrator with Background Initialization | ~421 | -| #26739 | 11:25 PM | 🔵 | Worker Service Architecture Uses Domain Services and Background Initialization | ~438 | -| #26255 | 8:31 PM | 🔵 | Context Generator Timeline Rendering Logic Details File Grouping Implementation | ~397 | -| #26251 | 8:30 PM | 🔵 | Worker Service Orchestrates Domain Services and Route Handlers | ~292 | -| #26246 | 8:29 PM | 🔵 | Context Generator Implements Rich Date-Grouped Timeline Format | ~468 | - -### Dec 17, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #28548 | 4:49 PM | 🔵 | Worker service cleanup method uses Unix-specific process management | ~323 | -| #28446 | 4:23 PM | 🔵 | Worker Service Refactored to Orchestrator Pattern | ~529 | - -### Dec 18, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #29340 | 3:11 PM | ✅ | Constructor Initialization Comment Updated | ~267 | -| #29339 | " | ✅ | Class Member Comment Updated in WorkerService | ~267 | -| #29338 | " | ✅ | Service Import Comment Updated | ~222 | -| #29337 | 3:10 PM | ✅ | Terminology Update in Worker Service Documentation | ~268 | -| #29239 | 12:11 AM | 🔵 | Worker Service Refactored as Domain-Driven Orchestrator | ~477 | - -### Dec 20, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #30808 | 6:05 PM | 🔴 | Fixed worker readiness check to fail on initialization errors | ~315 | -| #30800 | 6:03 PM | 🔵 | Dual Error Logging in Background Initialization | ~367 | -| #30799 | " | 🔵 | Background Initialization Invocation Pattern | ~365 | -| #30797 | " | 🔵 | Background Initialization Sequence and Error Handler Confirmed | ~450 | -| #30795 | 6:02 PM | 🔵 | Readiness Endpoint Returns 503 During Initialization | ~397 | -| #30793 | " | 🔵 | Dual Initialization State Tracking Pattern | ~388 | -| #30791 | " | 🔵 | Worker Service Constructor Defers SearchRoutes Initialization | ~387 | -| #30790 | " | 🔵 | Initialization Promise Resolver Pattern Located | ~321 | -| #30788 | " | 🔵 | Worker Service Initialization Resolves Promise Despite Errors | ~388 | - -### Jan 1, 2026 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #35654 | 11:29 PM | ✅ | Added APPROVED OVERRIDE annotation for instruction loading HTTP route error handler | ~339 | -| #35651 | 11:28 PM | ✅ | Added APPROVED OVERRIDE annotation for shutdown error handler with process.exit | ~354 | -| #35649 | " | ✅ | Added APPROVED OVERRIDE annotation for readiness check retry loop error handling | ~374 | -| #35647 | " | ✅ | Added APPROVED OVERRIDE annotation for port availability probe error handling | ~327 | -| #35646 | " | ✅ | Added APPROVED OVERRIDE annotation for Cursor context file update error handling | ~342 | -| #35643 | 11:27 PM | ✅ | Added APPROVED OVERRIDE annotation for PID file cleanup error handling | ~320 | - \ No newline at end of file diff --git a/src/services/domain/CLAUDE.md b/src/services/domain/CLAUDE.md deleted file mode 100644 index 6e975c04..00000000 --- a/src/services/domain/CLAUDE.md +++ /dev/null @@ -1,12 +0,0 @@ - -# Recent Activity - - - -### Jan 25, 2026 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #41877 | 12:09 PM | ⚖️ | Deploy Existing Consumer Preview Without Creating New Packages | ~361 | -| #41873 | 12:03 PM | 🔵 | Claude-mem mode configuration system types documented | ~504 | - \ No newline at end of file diff --git a/src/services/infrastructure/CLAUDE.md b/src/services/infrastructure/CLAUDE.md deleted file mode 100644 index 8a46e854..00000000 --- a/src/services/infrastructure/CLAUDE.md +++ /dev/null @@ -1,10 +0,0 @@ - -# Recent Activity - -### Jan 4, 2026 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #36864 | 1:52 AM | 🔵 | ProcessManager Module Imports Reviewed | ~245 | -| #36860 | 1:50 AM | 🔵 | ProcessManager Source Code Reviewed for WMIC Implementation | ~608 | - \ No newline at end of file diff --git a/src/services/sqlite/CLAUDE.md b/src/services/sqlite/CLAUDE.md deleted file mode 100644 index 719663bb..00000000 --- a/src/services/sqlite/CLAUDE.md +++ /dev/null @@ -1,93 +0,0 @@ - -# Recent Activity - -### Dec 8, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #22310 | 9:46 PM | 🟣 | Complete Hook Lifecycle Documentation Generated | ~603 | -| #22305 | 9:45 PM | 🔵 | Session Summary Storage and Status Lifecycle | ~472 | -| #22304 | " | 🔵 | Session Creation Idempotency and Observation Storage | ~481 | -| #22303 | " | 🔵 | SessionStore CRUD Operations for Hook Integration | ~392 | -| #22300 | 9:44 PM | 🔵 | SessionStore Database Management and Schema Migrations | ~455 | -| #22299 | " | 🔵 | Database Schema and Entity Types | ~460 | -| #21976 | 5:24 PM | 🟣 | storeObservation Saves tool_use_id to Database | ~298 | - -### Dec 10, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #23808 | 10:42 PM | 🔵 | migrations.ts Already Migrated to bun:sqlite | ~312 | -| #23807 | " | 🔵 | SessionSearch.ts Already Migrated to bun:sqlite | ~321 | -| #23805 | " | 🔵 | Database.ts Already Migrated to bun:sqlite | ~290 | -| #23784 | 9:59 PM | ✅ | SessionStore.ts db.pragma() Converted to db.query().all() Pattern | ~198 | -| #23783 | 9:58 PM | ✅ | SessionStore.ts Migration004 Multi-Statement db.exec() Converted to db.run() | ~220 | -| #23782 | " | ✅ | SessionStore.ts initializeSchema() db.exec() Converted to db.run() | ~197 | -| #23781 | " | ✅ | SessionStore.ts Constructor PRAGMA Calls Converted to db.run() | ~215 | -| #23780 | " | ✅ | SessionStore.ts Type Annotation Updated | ~183 | -| #23779 | " | ✅ | SessionStore.ts Import Updated to bun:sqlite | ~237 | -| #23778 | 9:57 PM | ✅ | Database.ts Import Updated to bun:sqlite | ~177 | -| #23777 | " | 🔵 | SessionStore.ts Current Implementation - better-sqlite3 Import and API Usage | ~415 | -| #23776 | " | 🔵 | migrations.ts Current Implementation - better-sqlite3 Import | ~285 | -| #23775 | " | 🔵 | Database.ts Current Implementation - better-sqlite3 Import | ~286 | -| #23774 | " | 🔵 | SessionSearch.ts Current Implementation - better-sqlite3 Import | ~309 | -| #23671 | 8:36 PM | 🔵 | getUserPromptsByIds Method Implementation with Filtering and Ordering | ~326 | -| #23670 | " | 🔵 | getUserPromptsByIds Method Location in SessionStore | ~145 | -| #23635 | 8:10 PM | 🔴 | Fixed SessionStore.ts Concepts Filter SQL Parameter Bug | ~297 | -| #23634 | " | 🔵 | SessionStore.ts Concepts Filter Bug Confirmed at Line 849 | ~356 | -| #23522 | 5:27 PM | 🔵 | Complete TypeScript Type Definitions for Database Entities | ~433 | -| #23521 | " | 🔵 | Database Schema Structure with 7 Migration Versions | ~461 | - -### Dec 18, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #29868 | 8:19 PM | 🔵 | SessionStore Architecture Review for Mode Metadata Addition | ~350 | -| #29243 | 12:13 AM | 🔵 | Observations Table Schema Migration: Text Field Made Nullable | ~496 | -| #29241 | 12:12 AM | 🔵 | Migration001: Core Schema for Sessions, Memories, Overviews, Diagnostics, Transcripts | ~555 | -| #29238 | 12:11 AM | 🔵 | Observation Type Schema Evolution: Five to Six Types | ~331 | -| #29237 | " | 🔵 | SQLite SessionStore with Schema Migrations and WAL Mode | ~520 | - -### Dec 21, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #31622 | 8:26 PM | 🔄 | Completed SessionStore logging standardization | ~270 | -| #31621 | " | 🔄 | Standardized error logging for boundary timestamps query | ~253 | -| #31620 | " | 🔄 | Standardized error logging in getTimelineAroundObservation | ~252 | -| #31619 | " | 🔄 | Replaced console.log with logger.debug in SessionStore | ~263 | - -### Dec 27, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #33213 | 9:04 PM | 🔵 | SessionStore Implements KISS Session ID Threading via INSERT OR IGNORE Pattern | ~673 | - -### Dec 28, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #33548 | 10:59 PM | ✅ | Reverted memory_session_id NULL Initialization to contentSessionId Placeholder | ~421 | -| #33546 | 10:57 PM | 🔴 | Fixed createSDKSession to Initialize memory_session_id as NULL | ~406 | -| #33545 | " | 🔵 | createSDKSession Sets memory_session_id Equal to content_session_id Initially | ~378 | -| #33544 | " | 🔵 | SessionStore Migration 17 Already Renamed Session ID Columns | ~451 | - -### Jan 2, 2026 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #36028 | 9:20 PM | 🔄 | Try-Catch Block Removed from Database Migration | ~291 | - -### Jan 3, 2026 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #36653 | 11:03 PM | 🔵 | storeObservation Method Signature Shows Parameter Named memorySessionId | ~474 | -| #36652 | " | 🔵 | createSDKSession Implementation Confirms NULL Initialization With Security Rationale | ~488 | -| #36650 | 11:02 PM | 🔵 | Phase 1 Analysis Reveals Implementation-Test Mismatch on NULL vs Placeholder Initialization | ~687 | -| #36649 | " | 🔵 | SessionStore Implementation Reveals NULL-Based Memory Session ID Initialization Pattern | ~770 | -| #36175 | 6:52 PM | ✅ | MigrationRunner Re-exported from Migrations.ts | ~405 | -| #36172 | " | 🔵 | Migrations.ts Contains Legacy Migration System | ~650 | -| #36163 | 6:48 PM | 🔵 | SessionStore Method Inventory and Extraction Boundaries | ~692 | -| #36162 | 6:47 PM | 🔵 | SessionStore Architecture and Migration History | ~593 | - \ No newline at end of file diff --git a/src/services/worker/CLAUDE.md b/src/services/worker/CLAUDE.md deleted file mode 100644 index 5cee7bed..00000000 --- a/src/services/worker/CLAUDE.md +++ /dev/null @@ -1,123 +0,0 @@ - -# Recent Activity - -### Dec 10, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #23673 | 8:36 PM | ✅ | Add Project Filter Parameter to Session and Prompt Hydration in Search | ~306 | -| #23596 | 5:54 PM | ⚖️ | Import/Export Bug Fix Priority and Scope | ~415 | -| #23595 | 5:53 PM | 🔴 | SearchManager Returns Wrong Format for Empty Results | ~320 | -| #23594 | " | 🔵 | SearchManager Search Method Control Flow | ~313 | -| #23591 | 5:51 PM | 🔵 | SearchManager JSON Response Structure | ~231 | -| #23590 | " | 🔵 | Import/Export Feature Status Review | ~490 | -| #23583 | 5:50 PM | 🔵 | SearchManager Hybrid Search Architecture | ~495 | - -### Dec 13, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #25191 | 8:04 PM | 🔵 | ChromaSync Instantiated in DatabaseManager Constructor | ~315 | - -### Dec 14, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #26263 | 8:32 PM | 🔵 | SearchManager Timeline Methods Use Rich Formatting, Search Method Uses Flat Tables | ~464 | -| #26243 | 8:29 PM | 🔵 | FormattingService Provides Basic Table Format Without Dates or File Grouping | ~390 | -| #26240 | " | 🔵 | SearchManager Formats Results as Tables, Timeline Uses Rich Date-Grouped Format | ~416 | -| #26108 | 7:43 PM | ✅ | changes() Method Format Logic Removed | ~401 | -| #26107 | " | ✅ | changes() Method Format Parameter Removed | ~317 | -| #26106 | 7:42 PM | ✅ | decisions() Method Format Logic Removed | ~405 | -| #26105 | " | ✅ | decisions() Method Format Parameter Removed | ~310 | -| #26104 | " | ✅ | Main search() Method Format Handling Removed | ~430 | -| #26103 | 7:41 PM | ✅ | FormattingService.ts Rewritten to Table Format | ~457 | -| #26102 | " | 🔵 | SearchManager.ts Format Parameter Removal Status | ~478 | - -### Dec 15, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #27043 | 6:04 PM | 🔵 | Subagent confirms no version switcher UI exists, only orphaned backend infrastructure | ~539 | -| #27041 | 6:03 PM | 🔵 | Branch switching code isolated to two backend files, no frontend UI components | ~473 | -| #27037 | 6:02 PM | 🔵 | Branch switching functionality exists in SettingsRoutes with UI switcher removal intent | ~463 | - -### Dec 16, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #27727 | 5:45 PM | 🔵 | SearchManager returns raw data arrays when format=json is specified | ~349 | - -### Dec 17, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #28473 | 4:25 PM | 🔵 | PaginationHelper LIMIT+1 Trick and Project Path Sanitization | ~499 | -| #28458 | 4:24 PM | 🔵 | SDK Agent Observer-Only Event-Driven Query Loop | ~513 | -| #28455 | " | 🔵 | Event-Driven Session Manager with Zero-Latency Queuing | ~566 | - -### Dec 18, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #29240 | 12:12 AM | 🔵 | SDK Agent Event-Driven Query Loop with Tool Restrictions | ~507 | - -### Dec 20, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #31100 | 8:01 PM | 🔵 | Summary and Memory Message Generation in SDK Agent | ~324 | - -### Dec 25, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #32616 | 8:43 PM | 🔵 | Comprehensive analysis of "enable billing" setting and its impact on rate limiting | ~533 | -| #32599 | 8:40 PM | 🔄 | Added validation and explicit default for Gemini model configuration | ~393 | -| #32598 | " | 🔵 | Gemini configuration loaded from settings or environment variables | ~363 | -| #32591 | 8:38 PM | 🔴 | Removed Unsupported Gemini Model from Agent | ~282 | -| #32583 | " | 🔵 | Gemini Agent Implementation Details | ~434 | -| #32543 | 7:29 PM | 🔄 | Rate limiting applied conditionally based on billing status | ~164 | -| #32542 | " | 🔄 | Query Gemini now accepts billing status | ~163 | -| #32541 | " | 🔄 | Gemini config now includes billing status | ~182 | -| #32540 | " | 🔄 | Rate limiting logic refactored for Gemini billing | ~164 | - -### Dec 26, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #32949 | 10:55 PM | 🔵 | Complete settings persistence flow for Xiaomi MIMO v2 Flash model | ~320 | -| #32948 | 10:53 PM | 🔵 | OpenRouterAgent uses CLAUDE_MEM_OPENROUTER_MODEL setting with Xiaomi as default | ~183 | - -### Dec 27, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #33215 | 9:06 PM | 🔵 | SessionManager Implements Event-Driven Lifecycle with Database-First Persistence and Auto-Initialization | ~853 | -| #33214 | " | 🔵 | SDKAgent Implements Event-Driven Query Loop with Init/Continuation Prompt Selection | ~769 | - -### Dec 28, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #33551 | 11:00 PM | 🔵 | GeminiAgent Does Not Implement Resume Functionality | ~307 | -| #33550 | " | 🔵 | OpenRouterAgent Does Not Implement Resume Functionality | ~294 | -| #33549 | 10:59 PM | 🔴 | SDKAgent Now Checks memorySessionId Differs From contentSessionId Before Resume | ~419 | -| #33547 | " | 🔵 | All Agents Call storeObservation with contentSessionId Instead of memorySessionId | ~407 | -| #33543 | 10:56 PM | 🔵 | SDKAgent Already Implements Memory Session ID Capture and Resume Logic | ~467 | -| #33542 | " | 🔵 | SessionManager Already Uses Renamed Session ID Fields | ~390 | - -### Dec 30, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #34504 | 2:31 PM | 🔵 | SDKAgent V2 Message Handling and Processing Flow Detailed | ~583 | -| #34459 | 2:23 PM | 🔵 | Complete SDKAgent V2 Architecture with Comprehensive Message Processing | ~619 | -| #34453 | 2:21 PM | 🔵 | Memory Agent Configured as Observer-Only | ~379 | - -### Jan 4, 2026 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #36853 | 1:49 AM | 🔵 | GeminiAgent Implementation Reviewed for Model Support | ~555 | - \ No newline at end of file diff --git a/src/shared/CLAUDE.md b/src/shared/CLAUDE.md deleted file mode 100644 index 28d6fe73..00000000 --- a/src/shared/CLAUDE.md +++ /dev/null @@ -1,113 +0,0 @@ - -# Recent Activity - -### Nov 10, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #6295 | 1:18 PM | 🔵 | Path Configuration Structure for claude-mem | ~305 | - -### Dec 5, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #20730 | 9:06 PM | 🔵 | Path Configuration Module with ESM/CJS Compatibility | ~578 | -| #20718 | 9:00 PM | 🔵 | Worker Service Auto-Start and Health Check System | ~448 | -| #20410 | 7:21 PM | 🔵 | Path utilities provide cross-runtime directory management with Claude integration support | ~478 | -| #20409 | 7:20 PM | 🔵 | Worker utilities provide automatic PM2 startup with health checking and port configuration | ~479 | - -### Dec 9, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #23141 | 6:42 PM | 🔵 | Located getSettingsPath Function in paths.ts | ~261 | -| #23134 | 6:41 PM | ✅ | Set CLAUDE_MEM_SKIP_TOOLS Default Value in SettingsDefaultsManager | ~261 | -| #23133 | " | ✅ | Added CLAUDE_MEM_SKIP_TOOLS to SettingsDefaults Interface | ~231 | -| #23131 | 6:40 PM | 🔵 | SettingsDefaultsManager Structure and Configuration Schema | ~363 | -| #22858 | 2:28 PM | 🔄 | Removed Brittle save.md Validation from paths.ts | ~305 | -| #22852 | 2:26 PM | 🔵 | Located save.md Validation Logic in paths.ts | ~255 | -| #22805 | 2:01 PM | 🔵 | Early Settings Silent Failure Point Identified | ~363 | -| #22803 | " | 🔵 | Worker Utilities Current Implementation Review | ~390 | -| #22518 | 12:59 AM | 🔵 | Worker Utils StartWorker Implementation Uses Plugin Root for PM2 | ~311 | - -### Dec 10, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #23831 | 11:15 PM | 🔵 | Current hook-error-handler.ts References PM2 | ~277 | -| #23830 | " | 🔵 | Current worker-utils.ts Implementation Uses PM2 | ~431 | -| #23812 | 10:49 PM | 🔵 | Current Worker Startup Uses PM2 and PowerShell; Phase 2 Will Replace | ~428 | -| #23811 | " | 🔵 | Existing Paths Configuration for Phase 2 Reference | ~297 | - -### Dec 12, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #24405 | 8:12 PM | 🔵 | PM2 Legacy Cleanup Migration in Worker Startup | ~303 | -| #24400 | 8:10 PM | 🔵 | Retrieved PM2 Cleanup Implementation Details from Memory | ~355 | -| #24362 | 7:00 PM | 🟣 | Implemented PM2 Cleanup One-Time Marker in worker-utils.ts | ~376 | -| #24361 | " | ✅ | Added File System Imports to worker-utils.ts for PM2 Marker | ~263 | -| #24360 | " | 🔵 | worker-utils.ts Contains PM2 Cleanup Logic Without One-Time Marker | ~390 | - -### Dec 13, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #25088 | 7:18 PM | 🟣 | Added CLAUDE_MEM_EMBEDDING_FUNCTION to Settings Interface | ~269 | - -### Dec 14, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #26790 | 11:38 PM | 🔴 | Fixed Undefined Port Variable in Error Logger | ~340 | -| #26789 | " | 🔴 | Fixed Undefined Port Variable in Error Logging | ~316 | -| #26788 | " | 🔵 | Worker Utils Already Imports Required Dependencies for Implementation | ~283 | -| #26787 | " | 🟣 | Phase 2 Complete: Pre-Restart Delay Added to Version Mismatch Handler | ~436 | -| #26786 | " | 🟣 | Phase 2 Complete: Pre-Restart Delay Added to ensureWorkerVersionMatches Function | ~420 | -| #26785 | 11:37 PM | 🟣 | Phase 1 Complete: PRE_RESTART_SETTLE_DELAY Constant Added to Hook Timeouts | ~351 | -| #26784 | " | 🟣 | Phase 1 Complete: PRE_RESTART_SETTLE_DELAY Constant Added to HOOK_TIMEOUTS | ~370 | -| #26783 | " | 🔵 | Hook Constants File Defines Timeout Values and Platform Multiplier | ~452 | -| #26782 | " | 🔵 | hook-constants.ts Defines Timeout Constants With Windows Platform Multiplier | ~418 | -| #26766 | 11:30 PM | ⚖️ | Root Cause Identified: Missing Post-Install Worker Restart Trigger in Plugin Update Flow | ~604 | -| #26765 | " | 🔵 | Explore Agent Confirms Root Cause: No Proactive Worker Restart After Plugin Updates | ~613 | -| #26732 | 11:25 PM | 🔵 | Worker Utils Implements Version Mismatch Detection and Auto-Restart | ~516 | -| #26731 | 11:24 PM | 🔵 | ensureWorkerRunning Implementation Shows 2.5 Second Startup Wait With Version Check | ~522 | -| #25695 | 4:27 PM | 🟣 | Added comprehensive error logging to transcript parser for debugging message extraction failures | ~473 | -| #25693 | 4:24 PM | 🔵 | Transcript parser extracts messages from JSONL file by scanning backwards for role-specific entries | ~491 | - -### Dec 17, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #28464 | 4:25 PM | 🔵 | Platform-Adjusted Hook Timeout Configuration | ~468 | -| #28461 | " | 🔵 | Dual ESM/CJS Path Resolution System | ~479 | -| #28452 | 4:23 PM | 🔵 | Worker Version Matching and Auto-Restart System | ~510 | - -### Dec 18, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #29797 | 7:09 PM | 🔵 | Settings System Uses CLAUDE_MEM_MODE for Mode Selection | ~353 | -| #29234 | 12:10 AM | 🔵 | Centralized Settings Management with Environment Defaults | ~394 | - -### Dec 20, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #31086 | 7:59 PM | 🔵 | Transcript Parser Extracts Messages from JSONL Hook Files | ~327 | -| #30939 | 6:57 PM | 🔵 | Worker Utils File Examined for Error Handling Inconsistency | ~393 | -| #30855 | 6:22 PM | 🔵 | Transcript Parser Content Format Handling Examined | ~406 | - -### Dec 25, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #32616 | 8:43 PM | 🔵 | Comprehensive analysis of "enable billing" setting and its impact on rate limiting | ~533 | -| #32538 | 7:28 PM | ✅ | Set default Gemini billing to disabled | ~164 | - -### Jan 7, 2026 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #38175 | 7:26 PM | 🔵 | Complete Claude-Mem Hook Output Architecture Documented | ~530 | - \ No newline at end of file diff --git a/src/ui/viewer/constants/CLAUDE.md b/src/ui/viewer/constants/CLAUDE.md deleted file mode 100644 index a0154d52..00000000 --- a/src/ui/viewer/constants/CLAUDE.md +++ /dev/null @@ -1,9 +0,0 @@ - -# Recent Activity - -### Dec 26, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #32982 | 11:04 PM | 🔵 | Read default settings configuration file | ~233 | - \ No newline at end of file diff --git a/src/utils/CLAUDE.md b/src/utils/CLAUDE.md deleted file mode 100644 index 031cfda9..00000000 --- a/src/utils/CLAUDE.md +++ /dev/null @@ -1,58 +0,0 @@ - -# Recent Activity - -### Nov 5, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #4035 | 10:24 PM | 🔵 | logger.ts file exists but is empty | ~220 | - -### Nov 10, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #6521 | 5:43 PM | 🔵 | Code Review: Enhanced HTTP Logging and Double Entries Bug Fix | ~482 | - -### Nov 17, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #10019 | 12:14 AM | 🔵 | TranscriptParser Utility: JSONL Parsing with Type-Safe Entry Filtering | ~569 | - -### Nov 23, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #14626 | 6:25 PM | 🔵 | Stop Hook Summary Not in Transcript Validator Schema | ~359 | - -### Nov 28, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #17238 | 11:34 PM | 🔵 | Existing TranscriptParser TypeScript implementation handles nested message structure | ~493 | - -### Dec 5, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #20407 | 7:20 PM | 🔵 | Tag stripping utilities implement dual-tag privacy system with ReDoS protection | ~415 | - -### Dec 8, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #22310 | 9:46 PM | 🟣 | Complete Hook Lifecycle Documentation Generated | ~603 | -| #22306 | 9:45 PM | 🔵 | Dual-Tag Privacy System with ReDoS Protection | ~461 | - -### Dec 14, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #25691 | 4:24 PM | 🔵 | happy_path_error__with_fallback utility logs errors to silent.log and returns fallback values | ~460 | - -### Dec 20, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #30883 | 6:38 PM | 🔵 | Tag-Stripping DRY Violation Analysis | ~152 | - \ No newline at end of file diff --git a/tests/CLAUDE.md b/tests/CLAUDE.md deleted file mode 100644 index f894f837..00000000 --- a/tests/CLAUDE.md +++ /dev/null @@ -1,58 +0,0 @@ - -# Recent Activity - -### Nov 10, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #6358 | 3:14 PM | 🔵 | SDK Agent Spatial Awareness Implementation | ~309 | - -### Nov 21, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #13289 | 2:20 PM | 🟣 | Comprehensive Test Suite for Transcript Transformation | ~320 | - -### Nov 23, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #14617 | 6:15 PM | 🟣 | Test Suite Successfully Passing - All 8 Tests Green | ~498 | -| #14615 | 6:14 PM | 🟣 | YAGNI-Focused Test Suite for Transcript Transformation | ~457 | - -### Dec 5, 2025 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #20732 | 9:07 PM | 🔵 | Smart Install Version Marker Tests for Upgrade Detection | ~452 | -| #20399 | 7:17 PM | 🔵 | Smart install tests validate version tracking with backward compatibility | ~311 | -| #20392 | 7:15 PM | 🔵 | Memory tag stripping tests validate dual-tag system for JSON context filtering | ~404 | -| #20391 | " | 🔵 | User prompt tag stripping tests validate privacy controls for memory exclusion | ~182 | - -### Jan 3, 2026 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #36663 | 11:06 PM | ✅ | Third Validation Test Updated: Resume Safety Check Now Uses NULL Comparison | ~417 | -| #36662 | " | ✅ | Second Validation Test Updated: Post-Capture Check Now Uses NULL Comparison | ~418 | -| #36661 | 11:05 PM | ✅ | First Validation Test Updated: Placeholder Detection Now Checks for NULL | ~482 | -| #36660 | " | ✅ | Updated Session ID Usage Validation Test Header to Reflect NULL-Based Architecture | ~588 | -| #36659 | " | ✅ | Sixth Test Fix: Updated Multi-Observation Test to Use Memory Session ID | ~486 | -| #36658 | " | ✅ | Fifth Test Fix: Updated storeSummary Tests to Use Actual Memory Session ID After Capture | ~555 | -| #36657 | 11:04 PM | ✅ | Fourth Test Fix: Updated storeObservation Tests to Use Actual Memory Session ID After Capture | ~547 | -| #36656 | " | ✅ | Third Test Fix: Updated getSessionById Test to Expect NULL for Uncaptured Memory Session ID | ~436 | -| #36655 | " | ✅ | Second Test Fix: Updated updateMemorySessionId Test to Expect NULL Before Update | ~395 | -| #36654 | " | ✅ | First Test Fix: Updated Memory Session ID Initialization Test to Expect NULL | ~426 | -| #36650 | 11:02 PM | 🔵 | Phase 1 Analysis Reveals Implementation-Test Mismatch on NULL vs Placeholder Initialization | ~687 | -| #36648 | " | 🔵 | Session ID Refactor Test Suite Documents Database Migration 17 and Dual ID System | ~651 | -| #36647 | 11:01 PM | 🔵 | SessionStore Test Suite Validates Prompt Counting and Timestamp Override Features | ~506 | -| #36646 | " | 🔵 | Session ID Architecture Revealed Through Test File Analysis | ~611 | - -### Jan 4, 2026 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #36858 | 1:50 AM | 🟣 | Phase 1 Implementation Completed via Subagent | ~499 | -| #36854 | 1:49 AM | 🟣 | gemini-3-flash Model Tests Added to GeminiAgent Test Suite | ~470 | -| #36851 | " | 🔵 | GeminiAgent Test Structure Analyzed | ~565 | - \ No newline at end of file diff --git a/tests/infrastructure/CLAUDE.md b/tests/infrastructure/CLAUDE.md deleted file mode 100644 index 29caf82f..00000000 --- a/tests/infrastructure/CLAUDE.md +++ /dev/null @@ -1,13 +0,0 @@ - -# Recent Activity - -### Jan 4, 2026 - -| ID | Time | T | Title | Read | -|----|------|---|-------|------| -| #36870 | 1:54 AM | 🟣 | Phase 2 Implementation Completed via Subagent | ~572 | -| #36866 | 1:53 AM | 🔄 | WMIC Test Refactored to Use Direct Logic Testing | ~533 | -| #36865 | 1:52 AM | ✅ | WMIC Test File Updated with Improved Mock Implementation | ~370 | -| #36863 | 1:51 AM | 🟣 | WMIC Parsing Test File Created | ~581 | -| #36861 | " | 🔵 | Existing ProcessManager Test File Structure Analyzed | ~516 | - \ No newline at end of file diff --git a/tests/utils/CLAUDE.md b/tests/utils/CLAUDE.md deleted file mode 100644 index 59ab83fc..00000000 --- a/tests/utils/CLAUDE.md +++ /dev/null @@ -1,3 +0,0 @@ - - - \ No newline at end of file