claude_memory 0.13.0 → 0.13.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. checksums.yaml +4 -4
  2. data/.claude-plugin/marketplace.json +1 -1
  3. data/.claude-plugin/plugin.json +1 -1
  4. data/CHANGELOG.md +25 -0
  5. data/docs/improvements.md +83 -0
  6. data/lib/claude_memory/commands/checks/fts_rank_check.rb +60 -0
  7. data/lib/claude_memory/commands/doctor_command.rb +2 -0
  8. data/lib/claude_memory/commands/index_command.rb +22 -4
  9. data/lib/claude_memory/commands/setup_vectors_command.rb +9 -3
  10. data/lib/claude_memory/distill/null_distiller.rb +24 -2
  11. data/lib/claude_memory/hook/context_injector.rb +35 -10
  12. data/lib/claude_memory/index/lexical_fts.rb +47 -23
  13. data/lib/claude_memory/index/vector_index.rb +27 -0
  14. data/lib/claude_memory/mcp/server.rb +33 -1
  15. data/lib/claude_memory/observe/reflector.rb +32 -16
  16. data/lib/claude_memory/observe/token_overlap_matcher.rb +55 -0
  17. data/lib/claude_memory/sweep/maintenance.rb +22 -0
  18. data/lib/claude_memory/sweep/sweeper.rb +1 -0
  19. data/lib/claude_memory/version.rb +1 -1
  20. data/lib/claude_memory.rb +2 -0
  21. metadata +3 -25
  22. data/.claude/CLAUDE.md +0 -4
  23. data/.claude/memory.sqlite3 +0 -0
  24. data/.claude/output-styles/memory-aware.md +0 -1
  25. data/.claude/rules/claude_memory.generated.md +0 -87
  26. data/.claude/settings.json +0 -113
  27. data/.claude/settings.local.json +0 -59
  28. data/.claude/skills/check-memory/DEPRECATED.md +0 -29
  29. data/.claude/skills/check-memory/SKILL.md +0 -87
  30. data/.claude/skills/dashboard/SKILL.md +0 -42
  31. data/.claude/skills/debug-memory +0 -1
  32. data/.claude/skills/improve/SKILL.md +0 -631
  33. data/.claude/skills/improve/feature-patterns.md +0 -1221
  34. data/.claude/skills/memory-first-workflow +0 -1
  35. data/.claude/skills/quality-update/SKILL.md +0 -229
  36. data/.claude/skills/quality-update/implementation-guide.md +0 -346
  37. data/.claude/skills/release/SKILL.md +0 -206
  38. data/.claude/skills/review-commit/SKILL.md +0 -199
  39. data/.claude/skills/review-for-quality/SKILL.md +0 -154
  40. data/.claude/skills/review-for-quality/expert-checklists.md +0 -79
  41. data/.claude/skills/setup-memory +0 -1
  42. data/.claude/skills/study-repo/SKILL.md +0 -322
  43. data/.claude/skills/study-repo/analysis-template.md +0 -323
  44. data/.claude/skills/study-repo/focus-examples.md +0 -327
  45. data/.claude/skills/upgrade-dependencies/SKILL.md +0 -154
@@ -1,87 +0,0 @@
1
- ---
2
- name: check-memory
3
- description: Explicitly check memory system before answering or exploring
4
- disable-model-invocation: true
5
- ---
6
-
7
- # Check Memory First
8
-
9
- When invoked with `/check-memory <topic>`, this skill forces a memory-first workflow.
10
-
11
- ## Task
12
-
13
- **IMPORTANT: You MUST check memory BEFORE reading any files or running any code searches.**
14
-
15
- The user is asking about: $ARGUMENTS
16
-
17
- ## Step-by-Step Workflow
18
-
19
- ### 0. Verify Memory Health
20
-
21
- Before querying, confirm the memory system is operational:
22
-
23
- ```
24
- memory.check_setup
25
- ```
26
-
27
- If status is not "healthy", inform the user and suggest running `claude-memory doctor` for details.
28
-
29
- ### 1. Query Memory (REQUIRED FIRST STEP)
30
-
31
- Run multiple memory queries to find existing knowledge:
32
-
33
- ```
34
- memory.recall "$ARGUMENTS"
35
- ```
36
-
37
- Also try specialized shortcuts:
38
- - `memory.decisions` (if implementing a feature)
39
- - `memory.architecture` (if working with frameworks)
40
- - `memory.conventions` (if writing code)
41
- - `memory.conflicts` (if encountering contradictions)
42
-
43
- ### 2. Analyze Results
44
-
45
- Review what memory returns:
46
- - **If sufficient**: Answer using recalled facts with citations
47
- - **If partial**: Note what's known and what needs investigation
48
- - **If empty**: Memory has no knowledge on this topic yet
49
-
50
- ### 3. Explore Code (ONLY IF NEEDED)
51
-
52
- If memory doesn't have enough information:
53
- - Use Read/Grep/Glob to explore the codebase
54
- - Clearly distinguish between:
55
- - **Recalled knowledge** (from memory)
56
- - **Discovered information** (from code exploration)
57
-
58
- ### 4. Provide Complete Answer
59
-
60
- Combine:
61
- - Facts from memory (with fact IDs if relevant)
62
- - New information from code exploration (if any)
63
- - Clear indication of sources
64
-
65
- ## Example Response Format
66
-
67
- ```
68
- Based on memory:
69
- - [Fact from memory with context]
70
-
71
- From code exploration:
72
- - [New findings from reading files]
73
-
74
- Answer: [Complete response combining both sources]
75
- ```
76
-
77
- ## Why This Matters
78
-
79
- Memory contains distilled knowledge from previous sessions. Checking it first:
80
- - Saves time (no need to re-explore known areas)
81
- - Provides context (decisions, patterns, conventions)
82
- - Avoids mistakes (previous lessons learned)
83
- - Reduces token usage (recalled facts are concise)
84
-
85
- ## Remember
86
-
87
- **ALWAYS start with memory queries. NEVER skip this step.**
@@ -1,42 +0,0 @@
1
- ---
2
- name: dashboard
3
- description: Launch a local web dashboard for ClaudeMemory debugging and observability
4
- ---
5
-
6
- # Dashboard
7
-
8
- Launch the ClaudeMemory debugging dashboard to visualize memory system health, activity, and efficacy.
9
-
10
- ## Task
11
-
12
- Start the dashboard web server so the user can inspect what's happening behind the scenes.
13
-
14
- ## Steps
15
-
16
- 1. Run the dashboard command:
17
-
18
- ```bash
19
- claude-memory dashboard
20
- ```
21
-
22
- This starts a local web server (default port 3377) and opens it in the browser.
23
-
24
- ## What the Dashboard Shows
25
-
26
- - **Health Status**: Database health, hook configuration, vector index status
27
- - **Overview**: Fact/entity/content counts, top predicates, entity type distribution, 30-day activity timeline
28
- - **Activity**: Live event log of hook executions (ingest, context, sweep), memory recalls, and store extractions with timing and details
29
- - **Facts**: Searchable fact explorer with status filtering, predicate/object search
30
- - **Efficacy**: Recall hit rate, total results served, average results per query, top queries by result count
31
-
32
- ## Options
33
-
34
- - `--port PORT` - Use a different port (default: 3377)
35
- - `--no-open` - Don't auto-open the browser
36
-
37
- ## Notes
38
-
39
- - Dashboard auto-refreshes every 30 seconds
40
- - Activity events are recorded by hooks and MCP tools into the `activity_events` table
41
- - The dashboard reads from both global and project databases
42
- - Press Ctrl+C to stop the server
@@ -1 +0,0 @@
1
- ../../skills/debug-memory