@modusensus/dsh-mneme 0.6.7 → 0.6.9

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 (139) hide show
  1. package/.github/workflows/test.yml +32 -0
  2. package/.release-notes-v0.6.9.md +13 -0
  3. package/CHANGELOG.md +89 -0
  4. package/LICENSE +21 -21
  5. package/README.md +219 -463
  6. package/SECURITY.md +544 -0
  7. package/docs/devlog/2026-08-14-dsh-mneme-dev-log.md +247 -0
  8. package/docs/devlog/2026-08-15-dsh-mneme-audit-stress-dev-log.md +145 -0
  9. package/docs/devlog/2026-08-15-dsh-mneme-pipeline-dev-log.md +56 -0
  10. package/docs/devlog/2026-08-15-dsh-mneme-reflection-dev-log.md +77 -0
  11. package/docs/devlog/2026-08-15-dsh-mneme-review-fixes-dev-log.md +64 -0
  12. package/docs/devlog/2026-08-15-dsh-mneme-semantic-dev-log.md +90 -0
  13. package/dsh-mneme/CHANGELOG.md +248 -0
  14. package/dsh-mneme/LICENSE +21 -0
  15. package/dsh-mneme/README.md +465 -0
  16. package/{cordis.patch.yml → dsh-mneme/cordis.patch.yml} +15 -15
  17. package/dsh-mneme/docs/AGENT_MEMORY_RESEARCH.md +183 -0
  18. package/dsh-mneme/docs/ENTITIES.md +245 -0
  19. package/dsh-mneme/docs/LOCAL_MODEL.md +141 -0
  20. package/dsh-mneme/docs/MIGRATION.md +127 -0
  21. package/dsh-mneme/docs/SEMANTIC.md +256 -0
  22. package/dsh-mneme/docs/SLEEP.md +163 -0
  23. package/{lib → dsh-mneme/lib}/api.js +783 -783
  24. package/{lib → dsh-mneme/lib}/client.js +1757 -1757
  25. package/{src → dsh-mneme/lib}/commands.js +64 -64
  26. package/{lib → dsh-mneme/lib}/config.js +298 -288
  27. package/{lib → dsh-mneme/lib}/dream/clustering.js +118 -118
  28. package/{src → dsh-mneme/lib}/dream/decisions.js +488 -439
  29. package/{lib → dsh-mneme/lib}/dream/sleep.js +561 -554
  30. package/{src → dsh-mneme/lib}/dream/tag-extractor.js +156 -156
  31. package/{lib → dsh-mneme/lib}/dream.js +958 -929
  32. package/{src → dsh-mneme/lib}/embedding.js +154 -154
  33. package/{src → dsh-mneme/lib}/entities/extractor.js +242 -242
  34. package/{src → dsh-mneme/lib}/hot-memory.js +53 -53
  35. package/{lib → dsh-mneme/lib}/index.js +361 -361
  36. package/{src → dsh-mneme/lib}/inject.js +208 -208
  37. package/{lib → dsh-mneme/lib}/local-embedder.js +282 -282
  38. package/{lib → dsh-mneme/lib}/mirror.js +170 -170
  39. package/{lib → dsh-mneme/lib}/parser/tag.js +59 -59
  40. package/{lib → dsh-mneme/lib}/parser/wiki-link.js +38 -38
  41. package/{src → dsh-mneme/lib}/quality-filter.js +123 -123
  42. package/{lib → dsh-mneme/lib}/reranker.js +218 -218
  43. package/{lib → dsh-mneme/lib}/search/adaptive.js +22 -22
  44. package/{lib → dsh-mneme/lib}/search/bm25.js +96 -96
  45. package/{src → dsh-mneme/lib}/search/tag-boost.js +61 -61
  46. package/{src → dsh-mneme/lib}/service.js +1726 -1726
  47. package/{lib → dsh-mneme/lib}/settings.js +172 -172
  48. package/{lib → dsh-mneme/lib}/store.js +2238 -2238
  49. package/{lib → dsh-mneme/lib}/summarize.js +236 -236
  50. package/{lib → dsh-mneme/lib}/tools.js +290 -290
  51. package/{lib → dsh-mneme/lib}/vector-index.js +116 -116
  52. package/dsh-mneme/package-lock.json +1936 -0
  53. package/dsh-mneme/package.json +80 -0
  54. package/{scripts → dsh-mneme/scripts}/benchmark-embed.js +201 -201
  55. package/{scripts → dsh-mneme/scripts}/benchmark-recall.js +133 -133
  56. package/{scripts → dsh-mneme/scripts}/benchmark-rerank.js +166 -166
  57. package/{scripts → dsh-mneme/scripts}/e2e-dsh.js +218 -218
  58. package/{scripts → dsh-mneme/scripts}/stress-dsh.js +255 -255
  59. package/{scripts → dsh-mneme/scripts}/sync-lib.js +52 -52
  60. package/{src → dsh-mneme/src}/api.js +783 -783
  61. package/{lib → dsh-mneme/src}/commands.js +64 -64
  62. package/{src → dsh-mneme/src}/config.js +298 -288
  63. package/{src → dsh-mneme/src}/dream/clustering.js +118 -118
  64. package/{lib → dsh-mneme/src}/dream/decisions.js +488 -439
  65. package/{src → dsh-mneme/src}/dream/sleep.js +561 -554
  66. package/{lib → dsh-mneme/src}/dream/tag-extractor.js +156 -156
  67. package/{src → dsh-mneme/src}/dream.js +958 -929
  68. package/{lib → dsh-mneme/src}/embedding.js +154 -154
  69. package/{lib → dsh-mneme/src}/entities/extractor.js +242 -242
  70. package/{lib → dsh-mneme/src}/hot-memory.js +53 -53
  71. package/{src → dsh-mneme/src}/index.js +361 -361
  72. package/{lib → dsh-mneme/src}/inject.js +208 -208
  73. package/{src → dsh-mneme/src}/local-embedder.js +282 -282
  74. package/{src → dsh-mneme/src}/mirror.js +170 -170
  75. package/{src → dsh-mneme/src}/parser/tag.js +59 -59
  76. package/{src → dsh-mneme/src}/parser/wiki-link.js +38 -38
  77. package/{lib → dsh-mneme/src}/quality-filter.js +123 -123
  78. package/{src → dsh-mneme/src}/reranker.js +218 -218
  79. package/{src → dsh-mneme/src}/search/adaptive.js +22 -22
  80. package/{src → dsh-mneme/src}/search/bm25.js +96 -96
  81. package/{lib → dsh-mneme/src}/search/tag-boost.js +61 -61
  82. package/{lib → dsh-mneme/src}/service.js +1726 -1726
  83. package/{src → dsh-mneme/src}/settings.js +172 -172
  84. package/{src → dsh-mneme/src}/store.js +2238 -2238
  85. package/{src → dsh-mneme/src}/summarize.js +236 -236
  86. package/{src → dsh-mneme/src}/tools.js +290 -290
  87. package/{src → dsh-mneme/src}/vector-index.js +116 -116
  88. package/{test → dsh-mneme/test}/api.test.js +594 -594
  89. package/{test → dsh-mneme/test}/audit.test.js +448 -448
  90. package/{test → dsh-mneme/test}/benchmark.test.js +35 -35
  91. package/{test → dsh-mneme/test}/boundary-v0625.test.js +82 -82
  92. package/{test → dsh-mneme/test}/client.test.js +368 -368
  93. package/{test → dsh-mneme/test}/clustering.test.js +100 -100
  94. package/{test → dsh-mneme/test}/commands.test.js +69 -69
  95. package/{test → dsh-mneme/test}/config.test.js +50 -50
  96. package/{test → dsh-mneme/test}/conflict-freeze.test.js +290 -290
  97. package/{test → dsh-mneme/test}/directory.test.js +134 -134
  98. package/{test → dsh-mneme/test}/dream.test.js +1060 -901
  99. package/{test → dsh-mneme/test}/entities.test.js +522 -522
  100. package/{test → dsh-mneme/test}/epistemic.test.js +298 -298
  101. package/{test → dsh-mneme/test}/fnew-0112.test.js +311 -311
  102. package/{test → dsh-mneme/test}/fnew-03.test.js +422 -422
  103. package/{test → dsh-mneme/test}/graph-api.test.js +175 -175
  104. package/{test → dsh-mneme/test}/helpers/dream-mock.js +82 -82
  105. package/{test → dsh-mneme/test}/hot-memory.test.js +174 -174
  106. package/{test → dsh-mneme/test}/inject.test.js +103 -103
  107. package/{test → dsh-mneme/test}/llm-audit.test.js +279 -279
  108. package/{test → dsh-mneme/test}/local-embedder.test.js +227 -227
  109. package/{test → dsh-mneme/test}/mirror-dirty.test.js +424 -424
  110. package/{test → dsh-mneme/test}/mirror-edit-digest.test.js +187 -187
  111. package/{test → dsh-mneme/test}/mirror-generation.test.js +499 -499
  112. package/{test → dsh-mneme/test}/mirror.test.js +249 -249
  113. package/{test → dsh-mneme/test}/normalize-decisions.test.js +120 -120
  114. package/{test → dsh-mneme/test}/peer-blockers.test.js +190 -190
  115. package/{test → dsh-mneme/test}/policy-epoch.test.js +259 -259
  116. package/{test → dsh-mneme/test}/provenance.test.js +103 -103
  117. package/{test → dsh-mneme/test}/quality-filter.test.js +118 -118
  118. package/{test → dsh-mneme/test}/reasoning-effort.test.js +199 -199
  119. package/{test → dsh-mneme/test}/recall-evals.test.js +235 -235
  120. package/{test → dsh-mneme/test}/recall-layer.test.js +315 -315
  121. package/{test → dsh-mneme/test}/receipt-chain.test.js +451 -451
  122. package/{test → dsh-mneme/test}/reflection.test.js +226 -226
  123. package/{test → dsh-mneme/test}/reranker.test.js +240 -240
  124. package/{test → dsh-mneme/test}/search-fusion.test.js +90 -90
  125. package/{test → dsh-mneme/test}/semantic.test.js +124 -124
  126. package/{test → dsh-mneme/test}/service-search.test.js +199 -199
  127. package/{test → dsh-mneme/test}/service.test.js +435 -435
  128. package/{test → dsh-mneme/test}/settings.test.js +118 -118
  129. package/{test → dsh-mneme/test}/sleep.test.js +365 -365
  130. package/{test → dsh-mneme/test}/store.test.js +436 -436
  131. package/{test → dsh-mneme/test}/stress.test.js +209 -209
  132. package/{test → dsh-mneme/test}/summarize.test.js +191 -191
  133. package/{test → dsh-mneme/test}/tag-boost.test.js +125 -125
  134. package/{test → dsh-mneme/test}/tag.test.js +312 -312
  135. package/{test → dsh-mneme/test}/tools.test.js +285 -285
  136. package/{test → dsh-mneme/test}/vector-index.test.js +221 -221
  137. package/{test → dsh-mneme/test}/wiki-link.test.js +332 -332
  138. package/package.json +18 -40
  139. package//346/250/252/345/271/205.png +0 -0
@@ -1,35 +1,35 @@
1
- import test from "node:test";
2
- import assert from "node:assert/strict";
3
- import { runBenchmark, TEST_CASES } from "../scripts/benchmark-recall.js";
4
-
5
- // The benchmark harness must stay a working evaluation: it runs the real
6
- // searchMemories pipeline over the seeded store and the fused configuration
7
- // must not fall behind the legacy one (that is the whole point of the third
8
- // recall path).
9
- test("benchmark harness runs both configurations", async () => {
10
- const report = await runBenchmark({ topK: 5 });
11
- assert.equal(report.runs.length, 2);
12
- assert.equal(report.runs[0].config, "legacy");
13
- assert.equal(report.runs[1].config, "fused");
14
- for (const run of report.runs) {
15
- assert.equal(run.rows.length, TEST_CASES.length);
16
- assert.ok(run.recallAtK >= 0 && run.recallAtK <= 1);
17
- }
18
- });
19
-
20
- test("fused configuration never trails legacy on Recall@5", async () => {
21
- const report = await runBenchmark({ topK: 5 });
22
- const [legacy, fused] = report.runs;
23
- assert.ok(
24
- fused.recallAtK >= legacy.recallAtK,
25
- `fused (${fused.recallAtK}) must be >= legacy (${legacy.recallAtK})`
26
- );
27
- });
28
-
29
- test("test cases cover the scattered-term BM25 territory", () => {
30
- assert.ok(TEST_CASES.length >= 10);
31
- assert.ok(TEST_CASES.some((tc) => tc.expected.length >= 2), "multi-target cases present");
32
- for (const tc of TEST_CASES) {
33
- assert.ok(tc.query && tc.expected.length > 0);
34
- }
35
- });
1
+ import test from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import { runBenchmark, TEST_CASES } from "../scripts/benchmark-recall.js";
4
+
5
+ // The benchmark harness must stay a working evaluation: it runs the real
6
+ // searchMemories pipeline over the seeded store and the fused configuration
7
+ // must not fall behind the legacy one (that is the whole point of the third
8
+ // recall path).
9
+ test("benchmark harness runs both configurations", async () => {
10
+ const report = await runBenchmark({ topK: 5 });
11
+ assert.equal(report.runs.length, 2);
12
+ assert.equal(report.runs[0].config, "legacy");
13
+ assert.equal(report.runs[1].config, "fused");
14
+ for (const run of report.runs) {
15
+ assert.equal(run.rows.length, TEST_CASES.length);
16
+ assert.ok(run.recallAtK >= 0 && run.recallAtK <= 1);
17
+ }
18
+ });
19
+
20
+ test("fused configuration never trails legacy on Recall@5", async () => {
21
+ const report = await runBenchmark({ topK: 5 });
22
+ const [legacy, fused] = report.runs;
23
+ assert.ok(
24
+ fused.recallAtK >= legacy.recallAtK,
25
+ `fused (${fused.recallAtK}) must be >= legacy (${legacy.recallAtK})`
26
+ );
27
+ });
28
+
29
+ test("test cases cover the scattered-term BM25 territory", () => {
30
+ assert.ok(TEST_CASES.length >= 10);
31
+ assert.ok(TEST_CASES.some((tc) => tc.expected.length >= 2), "multi-target cases present");
32
+ for (const tc of TEST_CASES) {
33
+ assert.ok(tc.query && tc.expected.length > 0);
34
+ }
35
+ });
@@ -1,82 +1,82 @@
1
- // v0.6.5 整合边界测试:跨 v0.6.1-0.6.4 的边界场景。
2
- // 覆盖:循环 wiki-link / 空 tag 清除 / 超长 tag 丢弃 / 多 tag 目录分组 /
3
- // autoTag 非法输出 fail-safe / tag 搜索大小写。
4
- import { test } from "node:test";
5
- import assert from "node:assert/strict";
6
- import { createStore } from "../src/store.js";
7
- import { createService } from "../src/service.js";
8
- import { parseWikiLinks } from "../src/parser/wiki-link.js";
9
- import { parseTags } from "../src/parser/tag.js";
10
- import { extractQueryTags } from "../src/search/tag-boost.js";
11
-
12
- function makeService(config = {}) {
13
- const store = createStore(":memory:");
14
- const service = createService({ store, mirror: null, config });
15
- return { store, service };
16
- }
17
-
18
- test("wiki-link: mutual links (A→B and B→A) resolve without loops", () => {
19
- const { store, service } = makeService({ wikiLinkEnabled: true });
20
- const a = service.saveWithDedupe({
21
- type: "preference", title: "Alpha", content: "参见 [[Beta]]", importance: 3,
22
- }).memory;
23
- const b = service.saveWithDedupe({
24
- type: "preference", title: "Beta", content: "反链 [[Alpha]]", importance: 3,
25
- }).memory;
26
- store.saveWikiLinks({ memoryId: a.id, title: a.title, targets: ["Beta"] });
27
- store.saveWikiLinks({ memoryId: b.id, title: b.title, targets: ["Alpha"] });
28
- const ab = service.getForwardLinks(a.id);
29
- const ba = service.getBacklinks(a.id);
30
- assert.ok(ab.some((r) => r.target.id === b.id), "A links to B");
31
- assert.ok(ba.some((r) => r.source.id === b.id), "B backlinks to A");
32
- store.close();
33
- });
34
-
35
- test("tags: setting empty array clears the live tag row", () => {
36
- const { store } = makeService();
37
- const a = store.save({ type: "preference", title: "A", content: "c", tags: [] });
38
- store.setMemoryTags(a.id, ["规划", "前端"]);
39
- assert.deepEqual(store.getMemoryTags(a.id), ["规划", "前端"]);
40
- store.setMemoryTags(a.id, []);
41
- assert.deepEqual(store.getMemoryTags(a.id), []);
42
- store.close();
43
- });
44
-
45
- test("parseTags: over-length and invalid tags are dropped", () => {
46
- const out = parseTags("#短 #这是一个超过二十个字符的超级长标签 #ok_123 #带-连字符");
47
- assert.ok(out.includes("短"), "short CJK tag kept");
48
- assert.ok(out.includes("ok_123"), "alnum underscore kept");
49
- assert.ok(out.includes("带-连字符"), "hyphen kept");
50
- assert.ok(!out.some((t) => t.length > 20), "no tag exceeds 20 chars");
51
- });
52
-
53
- test("tag search: matches case-insensitively and composes with keywords", async () => {
54
- const { store, service } = makeService();
55
- const a = service.saveWithDedupe({
56
- type: "preference", title: "规划", content: "博客重构", importance: 3,
57
- }).memory;
58
- store.setMemoryTags(a.id, ["规划"]);
59
- const r = await service.searchMemories("tag:规划 博客", {
60
- mode: "keyword", limit: 10, useRerank: false,
61
- });
62
- assert.ok(r.some((m) => m.id === a.id), "tag: prefix + keyword composition");
63
- store.close();
64
- });
65
-
66
- test("directory: many-tag memory appears under every tag group", () => {
67
- const { store, service } = makeService();
68
- const a = store.save({ type: "preference", title: "多标签", content: "c", tags: [] });
69
- store.setMemoryTags(a.id, ["规划", "前端", "博客"]);
70
- const dir = store.getDirectory();
71
- const groups = dir.groups.filter((g) => g.tag === "规划" || g.tag === "前端" || g.tag === "博客");
72
- assert.equal(groups.length, 3, "one group per tag");
73
- for (const g of groups) {
74
- assert.ok(g.memories.some((m) => m.id === a.id), `memory under ${g.tag}`);
75
- }
76
- store.close();
77
- });
78
-
79
- test("extractQueryTags: known-tag mention is case-insensitive", () => {
80
- const tags = extractQueryTags("PLANNING 进度", ["planning"]);
81
- assert.deepEqual(tags, ["planning"]);
82
- });
1
+ // v0.6.5 整合边界测试:跨 v0.6.1-0.6.4 的边界场景。
2
+ // 覆盖:循环 wiki-link / 空 tag 清除 / 超长 tag 丢弃 / 多 tag 目录分组 /
3
+ // autoTag 非法输出 fail-safe / tag 搜索大小写。
4
+ import { test } from "node:test";
5
+ import assert from "node:assert/strict";
6
+ import { createStore } from "../src/store.js";
7
+ import { createService } from "../src/service.js";
8
+ import { parseWikiLinks } from "../src/parser/wiki-link.js";
9
+ import { parseTags } from "../src/parser/tag.js";
10
+ import { extractQueryTags } from "../src/search/tag-boost.js";
11
+
12
+ function makeService(config = {}) {
13
+ const store = createStore(":memory:");
14
+ const service = createService({ store, mirror: null, config });
15
+ return { store, service };
16
+ }
17
+
18
+ test("wiki-link: mutual links (A→B and B→A) resolve without loops", () => {
19
+ const { store, service } = makeService({ wikiLinkEnabled: true });
20
+ const a = service.saveWithDedupe({
21
+ type: "preference", title: "Alpha", content: "参见 [[Beta]]", importance: 3,
22
+ }).memory;
23
+ const b = service.saveWithDedupe({
24
+ type: "preference", title: "Beta", content: "反链 [[Alpha]]", importance: 3,
25
+ }).memory;
26
+ store.saveWikiLinks({ memoryId: a.id, title: a.title, targets: ["Beta"] });
27
+ store.saveWikiLinks({ memoryId: b.id, title: b.title, targets: ["Alpha"] });
28
+ const ab = service.getForwardLinks(a.id);
29
+ const ba = service.getBacklinks(a.id);
30
+ assert.ok(ab.some((r) => r.target.id === b.id), "A links to B");
31
+ assert.ok(ba.some((r) => r.source.id === b.id), "B backlinks to A");
32
+ store.close();
33
+ });
34
+
35
+ test("tags: setting empty array clears the live tag row", () => {
36
+ const { store } = makeService();
37
+ const a = store.save({ type: "preference", title: "A", content: "c", tags: [] });
38
+ store.setMemoryTags(a.id, ["规划", "前端"]);
39
+ assert.deepEqual(store.getMemoryTags(a.id), ["规划", "前端"]);
40
+ store.setMemoryTags(a.id, []);
41
+ assert.deepEqual(store.getMemoryTags(a.id), []);
42
+ store.close();
43
+ });
44
+
45
+ test("parseTags: over-length and invalid tags are dropped", () => {
46
+ const out = parseTags("#短 #这是一个超过二十个字符的超级长标签 #ok_123 #带-连字符");
47
+ assert.ok(out.includes("短"), "short CJK tag kept");
48
+ assert.ok(out.includes("ok_123"), "alnum underscore kept");
49
+ assert.ok(out.includes("带-连字符"), "hyphen kept");
50
+ assert.ok(!out.some((t) => t.length > 20), "no tag exceeds 20 chars");
51
+ });
52
+
53
+ test("tag search: matches case-insensitively and composes with keywords", async () => {
54
+ const { store, service } = makeService();
55
+ const a = service.saveWithDedupe({
56
+ type: "preference", title: "规划", content: "博客重构", importance: 3,
57
+ }).memory;
58
+ store.setMemoryTags(a.id, ["规划"]);
59
+ const r = await service.searchMemories("tag:规划 博客", {
60
+ mode: "keyword", limit: 10, useRerank: false,
61
+ });
62
+ assert.ok(r.some((m) => m.id === a.id), "tag: prefix + keyword composition");
63
+ store.close();
64
+ });
65
+
66
+ test("directory: many-tag memory appears under every tag group", () => {
67
+ const { store, service } = makeService();
68
+ const a = store.save({ type: "preference", title: "多标签", content: "c", tags: [] });
69
+ store.setMemoryTags(a.id, ["规划", "前端", "博客"]);
70
+ const dir = store.getDirectory();
71
+ const groups = dir.groups.filter((g) => g.tag === "规划" || g.tag === "前端" || g.tag === "博客");
72
+ assert.equal(groups.length, 3, "one group per tag");
73
+ for (const g of groups) {
74
+ assert.ok(g.memories.some((m) => m.id === a.id), `memory under ${g.tag}`);
75
+ }
76
+ store.close();
77
+ });
78
+
79
+ test("extractQueryTags: known-tag mention is case-insensitive", () => {
80
+ const tags = extractQueryTags("PLANNING 进度", ["planning"]);
81
+ assert.deepEqual(tags, ["planning"]);
82
+ });