claude-memory-layer 1.0.10 → 1.0.12

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 (142) hide show
  1. package/AGENTS.md +60 -0
  2. package/README.md +166 -2
  3. package/bootstrap-kb/decisions/decisions.md +244 -0
  4. package/bootstrap-kb/glossary/glossary.md +46 -0
  5. package/bootstrap-kb/modules/.claude-plugin.md +22 -0
  6. package/bootstrap-kb/modules/agents.md.md +15 -0
  7. package/bootstrap-kb/modules/claude.md.md +15 -0
  8. package/bootstrap-kb/modules/context.md.md +15 -0
  9. package/bootstrap-kb/modules/docs.md +18 -0
  10. package/bootstrap-kb/modules/handoff.md.md +15 -0
  11. package/bootstrap-kb/modules/package-lock.json.md +15 -0
  12. package/bootstrap-kb/modules/package.json.md +15 -0
  13. package/bootstrap-kb/modules/plan.md.md +15 -0
  14. package/bootstrap-kb/modules/readme.md.md +15 -0
  15. package/bootstrap-kb/modules/scripts.md +26 -0
  16. package/bootstrap-kb/modules/spec.md.md +15 -0
  17. package/bootstrap-kb/modules/specs.md +20 -0
  18. package/bootstrap-kb/modules/src.md +51 -0
  19. package/bootstrap-kb/modules/tests.md +42 -0
  20. package/bootstrap-kb/modules/tsconfig.json.md +15 -0
  21. package/bootstrap-kb/modules/vitest.config.ts.md +15 -0
  22. package/bootstrap-kb/overview/overview.md +40 -0
  23. package/bootstrap-kb/sources/manifest.json +950 -0
  24. package/bootstrap-kb/sources/manifest.md +227 -0
  25. package/bootstrap-kb/timeline/timeline.md +57 -0
  26. package/d.sh +3 -0
  27. package/deploy.sh +3 -0
  28. package/dist/cli/index.js +3577 -389
  29. package/dist/cli/index.js.map +4 -4
  30. package/dist/core/index.js +1383 -138
  31. package/dist/core/index.js.map +4 -4
  32. package/dist/hooks/post-tool-use.js +1917 -214
  33. package/dist/hooks/post-tool-use.js.map +4 -4
  34. package/dist/hooks/session-end.js +1813 -231
  35. package/dist/hooks/session-end.js.map +4 -4
  36. package/dist/hooks/session-start.js +1802 -205
  37. package/dist/hooks/session-start.js.map +4 -4
  38. package/dist/hooks/stop.js +1909 -248
  39. package/dist/hooks/stop.js.map +4 -4
  40. package/dist/hooks/user-prompt-submit.js +1861 -206
  41. package/dist/hooks/user-prompt-submit.js.map +4 -4
  42. package/dist/server/api/index.js +2341 -217
  43. package/dist/server/api/index.js.map +4 -4
  44. package/dist/server/index.js +2350 -226
  45. package/dist/server/index.js.map +4 -4
  46. package/dist/services/memory-service.js +1805 -206
  47. package/dist/services/memory-service.js.map +4 -4
  48. package/dist/ui/app.js +1447 -55
  49. package/dist/ui/index.html +318 -147
  50. package/dist/ui/style.css +892 -0
  51. package/docs/MCP_MEMORY_SERVICE_COMPARATIVE_REVIEW.md +271 -0
  52. package/docs/MEMU_ADOPTION.md +40 -0
  53. package/docs/OPERATIONS.md +18 -0
  54. package/memory/.claude-plugin/commands/2026-02-25.md +263 -0
  55. package/memory/_index.md +405 -0
  56. package/memory/default/uncategorized/2026-02-25.md +4839 -0
  57. package/memory/specs/20260207-dashboard-upgrade/2026-02-25.md +142 -0
  58. package/memory/specs/citations-system/2026-02-25.md +1121 -0
  59. package/memory/specs/endless-mode/2026-02-25.md +1392 -0
  60. package/memory/specs/entity-edge-model/2026-02-25.md +1263 -0
  61. package/memory/specs/evidence-aligner-v2/2026-02-25.md +1028 -0
  62. package/memory/specs/mcp-desktop-integration/2026-02-25.md +1334 -0
  63. package/memory/specs/post-tool-use-hook/2026-02-25.md +1164 -0
  64. package/memory/specs/private-tags/2026-02-25.md +1057 -0
  65. package/memory/specs/progressive-disclosure/2026-02-25.md +1436 -0
  66. package/memory/specs/task-entity-system/2026-02-25.md +924 -0
  67. package/memory/specs/vector-outbox-v2/2026-02-25.md +1510 -0
  68. package/memory/specs/web-viewer-ui/2026-02-25.md +1709 -0
  69. package/package.json +9 -2
  70. package/scripts/build.ts +6 -0
  71. package/scripts/fix-sync-gap.js +32 -0
  72. package/scripts/heartbeat-memory-orchestrator.sh +28 -0
  73. package/scripts/report-sync-gap.js +26 -0
  74. package/scripts/review-queue-auto-resolve.js +21 -0
  75. package/scripts/sync-gap-auto-heal.sh +17 -0
  76. package/specs/20260207-dashboard-upgrade/context.md +38 -0
  77. package/specs/20260207-dashboard-upgrade/spec.md +96 -0
  78. package/src/cli/index.ts +391 -60
  79. package/src/core/consolidated-store.ts +63 -1
  80. package/src/core/consolidation-worker.ts +115 -6
  81. package/src/core/event-store.ts +14 -0
  82. package/src/core/index.ts +1 -0
  83. package/src/core/ingest-interceptor.ts +80 -0
  84. package/src/core/markdown-mirror.ts +70 -0
  85. package/src/core/md-mirror.ts +92 -0
  86. package/src/core/mongo-sync-config.ts +165 -0
  87. package/src/core/mongo-sync-worker.ts +381 -0
  88. package/src/core/retriever.ts +540 -150
  89. package/src/core/sqlite-event-store.ts +794 -7
  90. package/src/core/sqlite-wrapper.ts +8 -0
  91. package/src/core/tag-taxonomy.ts +51 -0
  92. package/src/core/turn-state.ts +159 -0
  93. package/src/core/types.ts +51 -8
  94. package/src/core/vector-store.ts +21 -3
  95. package/src/hooks/post-tool-use.ts +68 -23
  96. package/src/hooks/session-end.ts +8 -3
  97. package/src/hooks/stop.ts +96 -25
  98. package/src/hooks/user-prompt-submit.ts +44 -5
  99. package/src/server/api/chat.ts +244 -0
  100. package/src/server/api/citations.ts +3 -3
  101. package/src/server/api/events.ts +30 -5
  102. package/src/server/api/health.ts +53 -0
  103. package/src/server/api/index.ts +9 -1
  104. package/src/server/api/projects.ts +74 -0
  105. package/src/server/api/search.ts +3 -3
  106. package/src/server/api/sessions.ts +3 -3
  107. package/src/server/api/stats.ts +89 -8
  108. package/src/server/api/turns.ts +143 -0
  109. package/src/server/api/utils.ts +46 -0
  110. package/src/services/bootstrap-organizer.ts +443 -0
  111. package/src/services/codex-session-history-importer.ts +474 -0
  112. package/src/services/memory-service.ts +508 -71
  113. package/src/services/session-history-importer.ts +215 -51
  114. package/src/ui/app.js +1447 -55
  115. package/src/ui/index.html +318 -147
  116. package/src/ui/style.css +892 -0
  117. package/tests/bootstrap-organizer.test.ts +111 -0
  118. package/tests/consolidation-worker.test.ts +75 -0
  119. package/tests/ingest-interceptor.test.ts +38 -0
  120. package/tests/markdown-mirror.test.ts +85 -0
  121. package/tests/md-mirror.test.ts +50 -0
  122. package/tests/retriever-fallback-chain.test.ts +223 -0
  123. package/tests/retriever-strategy-scope.test.ts +97 -0
  124. package/tests/retriever.memu-adoption.test.ts +122 -0
  125. package/tests/sqlite-event-store-replication.test.ts +92 -0
  126. package/.claude/settings.local.json +0 -27
  127. package/.claude-memory/test.sqlite +0 -0
  128. package/.history/package_20260201112328.json +0 -45
  129. package/.history/package_20260201113602.json +0 -45
  130. package/.history/package_20260201113713.json +0 -45
  131. package/.history/package_20260201114110.json +0 -45
  132. package/.history/package_20260201114632.json +0 -46
  133. package/.history/package_20260201133143.json +0 -45
  134. package/.history/package_20260201134319.json +0 -45
  135. package/.history/package_20260201134326.json +0 -45
  136. package/.history/package_20260201134334.json +0 -45
  137. package/.history/package_20260201134912.json +0 -45
  138. package/.history/package_20260201142928.json +0 -46
  139. package/.history/package_20260201192048.json +0 -47
  140. package/.history/package_20260202114053.json +0 -49
  141. package/.history/package_20260202121115.json +0 -49
  142. package/test_access.js +0 -49
package/bootstrap-kb/modules/package.json.md ADDED
@@ -0,0 +1,15 @@
1
+ # Module: package.json
2
+
3
+ - responsibility: inferred from top-level path `package.json/`
4
+ - files: 1
5
+ - languages: JSON
6
+ - confidence: low
7
+
8
+ ## Entry Candidates
9
+ - none detected
10
+
11
+ ## Related Commits (recent sample)
12
+ - none in selected range
13
+
14
+ ## Sources
15
+ - source: repo-path:package.json/**
package/bootstrap-kb/modules/plan.md.md ADDED
@@ -0,0 +1,15 @@
1
+ # Module: plan.md
2
+
3
+ - responsibility: inferred from top-level path `plan.md/`
4
+ - files: 1
5
+ - languages: Markdown
6
+ - confidence: low
7
+
8
+ ## Entry Candidates
9
+ - none detected
10
+
11
+ ## Related Commits (recent sample)
12
+ - none in selected range
13
+
14
+ ## Sources
15
+ - source: repo-path:plan.md/**
package/bootstrap-kb/modules/readme.md.md ADDED
@@ -0,0 +1,15 @@
1
+ # Module: README.md
2
+
3
+ - responsibility: inferred from top-level path `README.md/`
4
+ - files: 1
5
+ - languages: Markdown
6
+ - confidence: low
7
+
8
+ ## Entry Candidates
9
+ - none detected
10
+
11
+ ## Related Commits (recent sample)
12
+ - none in selected range
13
+
14
+ ## Sources
15
+ - source: repo-path:README.md/**
package/bootstrap-kb/modules/scripts.md ADDED
@@ -0,0 +1,26 @@
1
+ # Module: scripts
2
+
3
+ - responsibility: inferred from top-level path `scripts/`
4
+ - files: 6
5
+ - languages: JavaScript, Shell, TypeScript
6
+ - confidence: high
7
+
8
+ ## Entry Candidates
9
+ - none detected
10
+
11
+ ## Related Commits (recent sample)
12
+ - 2026-01-31 111f400e feat: implement complete code-memory plugin
13
+ - 2026-02-01 665cf11b feat: Add web dashboard for memory visualization
14
+ - 2026-02-01 f35da2b9 refactor: Rename project from code-memory to claude-memory-layer
15
+ - 2026-02-01 be36be70 feat: Migrate primary store from DuckDB to SQLite (WAL mode)
16
+ - 2026-02-20 d56d22ba feat(ops): add heartbeat orchestrator and sync-gap auto-heal scripts
17
+ - 2026-02-09 11d3092e feat: optional MongoDB sync for project events
18
+
19
+ ## Sources
20
+ - source: repo-path:scripts/**
21
+ - source: commit:111f400e73f0568b192a5b1b37a88622fd44d648
22
+ - source: commit:665cf11bb9a01f1bcba51ec49f53382e95cd7e32
23
+ - source: commit:f35da2b92704d7d1b5655edac3516c64a829eeef
24
+ - source: commit:be36be70f69d42d2373ac26e6c0b8e8b53ca0340
25
+ - source: commit:d56d22ba3271c1d51ea8bbaddb21f5f3d0a79d49
26
+ - source: commit:11d3092e372836f784a760fc0b4269fd44e9159f
package/bootstrap-kb/modules/spec.md.md ADDED
@@ -0,0 +1,15 @@
1
+ # Module: spec.md
2
+
3
+ - responsibility: inferred from top-level path `spec.md/`
4
+ - files: 1
5
+ - languages: Markdown
6
+ - confidence: low
7
+
8
+ ## Entry Candidates
9
+ - none detected
10
+
11
+ ## Related Commits (recent sample)
12
+ - none in selected range
13
+
14
+ ## Sources
15
+ - source: repo-path:spec.md/**
package/bootstrap-kb/modules/specs.md ADDED
@@ -0,0 +1,20 @@
1
+ # Module: specs
2
+
3
+ - responsibility: inferred from top-level path `specs/`
4
+ - files: 35
5
+ - languages: Markdown
6
+ - confidence: high
7
+
8
+ ## Entry Candidates
9
+ - none detected
10
+
11
+ ## Related Commits (recent sample)
12
+ - 2026-02-01 4bbbc717 Merge pull request #1 from buzzni/claude/idris2-memory-storage-JLk7J
13
+ - 2026-02-01 504ec3dd docs: Add citations and endless mode specification documents (#2)
14
+ - 2026-02-08 20c37b2c feat: Add interactive dashboard with modals, navigation, and detail views
15
+
16
+ ## Sources
17
+ - source: repo-path:specs/**
18
+ - source: commit:4bbbc7174f920434cfc67ee02746a9b9824ec101
19
+ - source: commit:504ec3ddd7f451fabf2cf01e073fc96e65ae124e
20
+ - source: commit:20c37b2cdffd271eaf04df9d2e87e5f23a4f853e
package/bootstrap-kb/modules/src.md ADDED
@@ -0,0 +1,51 @@
1
+ # Module: src
2
+
3
+ - responsibility: inferred from top-level path `src/`
4
+ - files: 70
5
+ - languages: TypeScript, JavaScript
6
+ - confidence: high
7
+
8
+ ## Entry Candidates
9
+ - src/cli/index.ts
10
+ - src/core/index.ts
11
+ - src/core/privacy/index.ts
12
+ - src/core/task/index.ts
13
+ - src/mcp/index.ts
14
+ - src/server/api/index.ts
15
+ - src/server/index.ts
16
+ - src/ui/app.js
17
+
18
+ ## Related Commits (recent sample)
19
+ - 2026-01-31 111f400e feat: implement complete code-memory plugin
20
+ - 2026-01-31 22b1c43d feat: add session history import functionality
21
+ - 2026-02-01 4bbbc717 Merge pull request #1 from buzzni/claude/idris2-memory-storage-JLk7J
22
+ - 2026-02-01 504ec3dd docs: Add citations and endless mode specification documents (#2)
23
+ - 2026-02-01 d04e562b feat: Add cross-project shared troubleshooting store
24
+ - 2026-02-01 65b0f64d refactor: Extract DuckDB wrapper for consistent async API
25
+ - 2026-02-01 665cf11b feat: Add web dashboard for memory visualization
26
+ - 2026-02-01 f35da2b9 refactor: Rename project from code-memory to claude-memory-layer
27
+ - 2026-02-01 be36be70 feat: Migrate primary store from DuckDB to SQLite (WAL mode)
28
+ - 2026-02-01 babfd152 feat: Enhance dashboard, CLI, and memory graduation system
29
+ - 2026-02-02 543643e7 perf: Add fast keyword search and optimize hook performance
30
+ - 2026-02-07 79464002 feat: Add memory helpfulness tracking and dashboard sort controls
31
+ - 2026-02-08 20c37b2c feat: Add interactive dashboard with modals, navigation, and detail views
32
+ - 2026-02-08 a1d93af4 fix: Align hooks with actual Claude Code input format and use lightweight service
33
+ - 2026-02-08 fd8f38af feat: Add real-time progress display for import command
34
+
35
+ ## Sources
36
+ - source: repo-path:src/**
37
+ - source: commit:111f400e73f0568b192a5b1b37a88622fd44d648
38
+ - source: commit:22b1c43d9b9f095cd2a210f529ca8bee5a1100c5
39
+ - source: commit:4bbbc7174f920434cfc67ee02746a9b9824ec101
40
+ - source: commit:504ec3ddd7f451fabf2cf01e073fc96e65ae124e
41
+ - source: commit:d04e562b5b011e0f07cdea0664db823f0caca5d0
42
+ - source: commit:65b0f64da3fd2c4b0b758b89f9d0f22301df23a7
43
+ - source: commit:665cf11bb9a01f1bcba51ec49f53382e95cd7e32
44
+ - source: commit:f35da2b92704d7d1b5655edac3516c64a829eeef
45
+ - source: commit:be36be70f69d42d2373ac26e6c0b8e8b53ca0340
46
+ - source: commit:babfd15284754bc3dbb698fcc4c81efcf53fcd85
47
+ - source: commit:543643e7a9f1d4a94f3216c2369d0212a51ff32d
48
+ - source: commit:794640023652fc38b010e1ab46ca6a9a504a09e8
49
+ - source: commit:20c37b2cdffd271eaf04df9d2e87e5f23a4f853e
50
+ - source: commit:a1d93af414821eb92d74cd02abb748849366ebfb
51
+ - source: commit:fd8f38af7cecf7d31a32a5aba9b1902178f986b1
package/bootstrap-kb/modules/tests.md ADDED
@@ -0,0 +1,42 @@
1
+ # Module: tests
2
+
3
+ - responsibility: inferred from top-level path `tests/`
4
+ - files: 12
5
+ - languages: TypeScript
6
+ - confidence: high
7
+
8
+ ## Entry Candidates
9
+ - none detected
10
+
11
+ ## Related Commits (recent sample)
12
+ - 2026-01-31 111f400e feat: implement complete code-memory plugin
13
+ - 2026-02-09 11d3092e feat: optional MongoDB sync for project events
14
+ - 2026-02-24 d278200d feat(memory): adopt memU-style scoped retrieval and staged ingest hooks
15
+ - 2026-02-24 917ad7fc feat(memory): add append-only markdown mirror for categorized event archives
16
+ - 2026-02-24 72250046 feat: append-only markdown mirror in sqlite ingest flow
17
+ - 2026-02-24 3a34d45a feat(memory): auto-refresh markdown mirror index
18
+ - 2026-02-24 df15146c chore(memory): normalize markdown mirror default category to uncategorized
19
+ - 2026-02-24 0dceb2d9 feat(retrieval): add auto fallback chain fast→deep→scope-expand→summary
20
+ - 2026-02-24 7de02967 feat(ranking): add helpfulness-driven adaptive rerank weights v1
21
+ - 2026-02-24 46f2cfa2 feat(retrieval): add ttl/decay ranking policy v1
22
+ - 2026-02-24 5fd950be feat(retrieval): add intent-rewrite deep retrieval merge flow
23
+ - 2026-02-24 d1dfe03f feat(retrieval): add graph-hop expansion with hop penalty
24
+ - 2026-02-24 7c84b5ea feat(consolidation): add hierarchical summary→rule automation with report
25
+ - 2026-02-25 db38c7e6 Feat/organize import bootstrap kb (#10)
26
+
27
+ ## Sources
28
+ - source: repo-path:tests/**
29
+ - source: commit:111f400e73f0568b192a5b1b37a88622fd44d648
30
+ - source: commit:11d3092e372836f784a760fc0b4269fd44e9159f
31
+ - source: commit:d278200d0f0666616a8556f2f25f9758b3ab9afd
32
+ - source: commit:917ad7fc97a1c2de68637dfbe4b4cdd51776ec30
33
+ - source: commit:72250046152e851ed70476a8704ca38ca633ffab
34
+ - source: commit:3a34d45a594affb034d6e416e3a29b6d2dcc20a5
35
+ - source: commit:df15146c2a8c3e389c1a2b8d6fcfb4a33f7a772d
36
+ - source: commit:0dceb2d914e67e10d140848340f30e6fd07c4f67
37
+ - source: commit:7de02967a1d59aea3e04ef1239585b93828c503a
38
+ - source: commit:46f2cfa2d99f0c8fb3a48709a97f62800f01d4fe
39
+ - source: commit:5fd950beee4d02f00b0c93be668a2e114ce9b257
40
+ - source: commit:d1dfe03f881d1a76ecd9a916cbf04c3ff2a4bf7e
41
+ - source: commit:7c84b5eacff733d8cb692eb9d47b7297a0872e43
42
+ - source: commit:db38c7e606a59478c03bac7e5bb5951954ca0813
package/bootstrap-kb/modules/tsconfig.json.md ADDED
@@ -0,0 +1,15 @@
1
+ # Module: tsconfig.json
2
+
3
+ - responsibility: inferred from top-level path `tsconfig.json/`
4
+ - files: 1
5
+ - languages: JSON
6
+ - confidence: low
7
+
8
+ ## Entry Candidates
9
+ - none detected
10
+
11
+ ## Related Commits (recent sample)
12
+ - none in selected range
13
+
14
+ ## Sources
15
+ - source: repo-path:tsconfig.json/**
package/bootstrap-kb/modules/vitest.config.ts.md ADDED
@@ -0,0 +1,15 @@
1
+ # Module: vitest.config.ts
2
+
3
+ - responsibility: inferred from top-level path `vitest.config.ts/`
4
+ - files: 1
5
+ - languages: TypeScript
6
+ - confidence: low
7
+
8
+ ## Entry Candidates
9
+ - none detected
10
+
11
+ ## Related Commits (recent sample)
12
+ - none in selected range
13
+
14
+ ## Sources
15
+ - source: repo-path:vitest.config.ts/**
package/bootstrap-kb/overview/overview.md ADDED
@@ -0,0 +1,40 @@
1
+ # Codebase Overview
2
+
3
+ - generatedAt: 2026-02-25T12:44:49.677Z
4
+ - deterministicPipeline: true
5
+ - repo: /home/walter/workspace/opensource/claude-memory-layer
6
+ - filesAnalyzed: 150
7
+ - commitsAnalyzed: 47
8
+ - confidence: high
9
+
10
+ ## Directory / Module Map
11
+ - src: 70 files (TypeScript, JavaScript)
12
+ - specs: 35 files (Markdown)
13
+ - tests: 12 files (TypeScript)
14
+ - .claude-plugin: 8 files (Markdown, JSON)
15
+ - scripts: 6 files (JavaScript, Shell, TypeScript)
16
+ - .omc: 4 files (JSON)
17
+ - docs: 2 files (Markdown)
18
+ - AGENTS.md: 1 files (Markdown)
19
+ - CLAUDE.md: 1 files (Markdown)
20
+ - context.md: 1 files (Markdown)
21
+ - d.sh: 1 files (Shell)
22
+ - deploy.sh: 1 files (Shell)
23
+ - HANDOFF.md: 1 files (Markdown)
24
+ - package-lock.json: 1 files (JSON)
25
+ - package.json: 1 files (JSON)
26
+ - plan.md: 1 files (Markdown)
27
+ - README.md: 1 files (Markdown)
28
+ - spec.md: 1 files (Markdown)
29
+ - tsconfig.json: 1 files (JSON)
30
+ - vitest.config.ts: 1 files (TypeScript)
31
+
32
+ ## Fact
33
+ - Generated from deterministic file scan and git history parsing.
34
+
35
+ ## Inference
36
+ - Module responsibilities should be reviewed by maintainers for nuanced boundaries.
37
+
38
+ ## Sources
39
+ - source: repo-scan:/home/walter/workspace/opensource/claude-memory-layer
40
+ - source: git-log:since=180 days ago;max=1000