@modusensus/dsh-mneme 0.6.6 → 0.6.8

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 (117) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +463 -457
  3. package/cordis.patch.yml +15 -15
  4. package/lib/api.js +783 -693
  5. package/lib/client.js +1757 -1656
  6. package/lib/commands.js +64 -64
  7. package/lib/config.js +288 -288
  8. package/lib/dream/clustering.js +118 -118
  9. package/lib/dream/decisions.js +439 -439
  10. package/lib/dream/sleep.js +561 -554
  11. package/lib/dream/tag-extractor.js +156 -156
  12. package/lib/dream.js +935 -929
  13. package/lib/embedding.js +154 -154
  14. package/lib/entities/extractor.js +242 -242
  15. package/lib/hot-memory.js +53 -53
  16. package/lib/index.js +361 -361
  17. package/lib/inject.js +208 -208
  18. package/lib/local-embedder.js +282 -282
  19. package/lib/mirror.js +170 -170
  20. package/lib/parser/tag.js +59 -59
  21. package/lib/parser/wiki-link.js +38 -38
  22. package/lib/quality-filter.js +123 -123
  23. package/lib/reranker.js +218 -218
  24. package/lib/search/adaptive.js +22 -22
  25. package/lib/search/bm25.js +96 -96
  26. package/lib/search/tag-boost.js +61 -61
  27. package/lib/service.js +1726 -1726
  28. package/lib/settings.js +172 -142
  29. package/lib/store.js +2238 -2238
  30. package/lib/summarize.js +236 -236
  31. package/lib/tools.js +290 -290
  32. package/lib/vector-index.js +116 -116
  33. package/package.json +80 -75
  34. package/scripts/benchmark-embed.js +201 -201
  35. package/scripts/benchmark-recall.js +133 -133
  36. package/scripts/benchmark-rerank.js +166 -166
  37. package/scripts/e2e-dsh.js +218 -218
  38. package/scripts/stress-dsh.js +255 -255
  39. package/scripts/sync-lib.js +52 -52
  40. package/src/api.js +783 -693
  41. package/src/commands.js +64 -64
  42. package/src/config.js +288 -288
  43. package/src/dream/clustering.js +118 -118
  44. package/src/dream/decisions.js +439 -439
  45. package/src/dream/sleep.js +561 -554
  46. package/src/dream/tag-extractor.js +156 -156
  47. package/src/dream.js +935 -929
  48. package/src/embedding.js +154 -154
  49. package/src/entities/extractor.js +242 -242
  50. package/src/hot-memory.js +53 -53
  51. package/src/index.js +361 -361
  52. package/src/inject.js +208 -208
  53. package/src/local-embedder.js +282 -282
  54. package/src/mirror.js +170 -170
  55. package/src/parser/tag.js +59 -59
  56. package/src/parser/wiki-link.js +38 -38
  57. package/src/quality-filter.js +123 -123
  58. package/src/reranker.js +218 -218
  59. package/src/search/adaptive.js +22 -22
  60. package/src/search/bm25.js +96 -96
  61. package/src/search/tag-boost.js +61 -61
  62. package/src/service.js +1726 -1726
  63. package/src/settings.js +172 -142
  64. package/src/store.js +2238 -2238
  65. package/src/summarize.js +236 -236
  66. package/src/tools.js +290 -290
  67. package/src/vector-index.js +116 -116
  68. package/test/api.test.js +594 -549
  69. package/test/audit.test.js +448 -448
  70. package/test/benchmark.test.js +35 -35
  71. package/test/boundary-v0625.test.js +82 -82
  72. package/test/client.test.js +368 -368
  73. package/test/clustering.test.js +100 -100
  74. package/test/commands.test.js +69 -69
  75. package/test/config.test.js +50 -50
  76. package/test/conflict-freeze.test.js +290 -290
  77. package/test/directory.test.js +134 -134
  78. package/test/dream.test.js +903 -901
  79. package/test/entities.test.js +522 -522
  80. package/test/epistemic.test.js +298 -298
  81. package/test/fnew-0112.test.js +311 -311
  82. package/test/fnew-03.test.js +422 -422
  83. package/test/graph-api.test.js +175 -175
  84. package/test/helpers/dream-mock.js +82 -82
  85. package/test/hot-memory.test.js +174 -174
  86. package/test/inject.test.js +103 -103
  87. package/test/llm-audit.test.js +279 -279
  88. package/test/local-embedder.test.js +227 -227
  89. package/test/mirror-dirty.test.js +424 -424
  90. package/test/mirror-edit-digest.test.js +187 -187
  91. package/test/mirror-generation.test.js +499 -499
  92. package/test/mirror.test.js +249 -249
  93. package/test/normalize-decisions.test.js +120 -120
  94. package/test/peer-blockers.test.js +190 -190
  95. package/test/policy-epoch.test.js +259 -259
  96. package/test/provenance.test.js +103 -103
  97. package/test/quality-filter.test.js +118 -118
  98. package/test/reasoning-effort.test.js +199 -199
  99. package/test/recall-evals.test.js +235 -235
  100. package/test/recall-layer.test.js +315 -315
  101. package/test/receipt-chain.test.js +451 -451
  102. package/test/reflection.test.js +226 -226
  103. package/test/reranker.test.js +240 -240
  104. package/test/search-fusion.test.js +90 -90
  105. package/test/semantic.test.js +124 -124
  106. package/test/service-search.test.js +199 -199
  107. package/test/service.test.js +435 -435
  108. package/test/settings.test.js +118 -101
  109. package/test/sleep.test.js +365 -365
  110. package/test/store.test.js +436 -436
  111. package/test/stress.test.js +209 -209
  112. package/test/summarize.test.js +191 -191
  113. package/test/tag-boost.test.js +125 -125
  114. package/test/tag.test.js +312 -312
  115. package/test/tools.test.js +285 -285
  116. package/test/vector-index.test.js +221 -221
  117. package/test/wiki-link.test.js +332 -332
@@ -1,116 +1,116 @@
1
- // Thin vector-index layer over the store's embedding column. Keeps the
2
- // current model fingerprint + stats in a dedicated `vector_meta` table so the
3
- // index can detect drift (embeddings generated by a different model) and the
4
- // Web panel can report index health. The heavy lifting (cosine search) lives
5
- // in store.searchVector; this module owns the index lifecycle.
6
-
7
- const META_SCHEMA = `
8
- CREATE TABLE IF NOT EXISTS vector_meta (
9
- key TEXT PRIMARY KEY,
10
- value TEXT NOT NULL
11
- );
12
- `;
13
-
14
- export function createVectorIndex({ store, logger }) {
15
- const db = store.db;
16
- db.exec(META_SCHEMA);
17
-
18
- function getMeta(key) {
19
- const row = db.prepare("SELECT value FROM vector_meta WHERE key = ?").get(key);
20
- return row?.value ?? undefined;
21
- }
22
-
23
- function setMeta(key, value) {
24
- db.prepare(
25
- `INSERT INTO vector_meta (key, value) VALUES (?, ?)
26
- ON CONFLICT(key) DO UPDATE SET value = excluded.value`
27
- ).run(key, String(value));
28
- }
29
-
30
- return {
31
- /** Record the model that generated the current vectors. */
32
- markModel(modelHash, dimension) {
33
- setMeta("model_hash", modelHash);
34
- setMeta("dimension", String(dimension ?? ""));
35
- setMeta("updated_at", new Date().toISOString());
36
- },
37
-
38
- modelHash() {
39
- return getMeta("model_hash");
40
- },
41
-
42
- dimension() {
43
- const raw = getMeta("dimension");
44
- return raw && Number.isInteger(Number(raw)) ? Number(raw) : undefined;
45
- },
46
-
47
- /** Store (or clear with null vector) one memory's embedding. */
48
- saveEmbedding(id, vector) {
49
- store.setEmbedding(id, vector);
50
- },
51
-
52
- /** Drop one memory's embedding. */
53
- deleteEmbedding(id) {
54
- store.setEmbedding(id, null);
55
- },
56
-
57
- /** Read one memory's cached vector; undefined when none/parse failure. */
58
- getEmbedding(id) {
59
- const row = db.prepare("SELECT embedding FROM memories WHERE id = ?").get(id);
60
- if (!row?.embedding) return undefined;
61
- try {
62
- const v = JSON.parse(row.embedding);
63
- return Array.isArray(v) && v.length ? v : undefined;
64
- } catch {
65
- return undefined;
66
- }
67
- },
68
-
69
- /** Cosine search over embedded rows; results carry a 0..1 score. */
70
- search(queryVector, { limit = 20, threshold = 0.65 } = {}) {
71
- return store.searchVector(queryVector, { limit, threshold });
72
- },
73
-
74
- /** Re-embed every row missing an embedding. Returns indexed count. */
75
- async rebuildIndex(embedder, { limit = 1000 } = {}) {
76
- // The loop needs a single-text embedder. Native embedSingle is preferred;
77
- // embed-only OpenAI-compatible clients (issue #10) are accepted too via
78
- // their `embed` single-text interface, so /vector-reindex no longer
79
- // silently returns 0 for them. An embedder exposing neither is ignored.
80
- let embedOne = null;
81
- if (embedder && typeof embedder.embedSingle === "function") {
82
- embedOne = (text) => embedder.embedSingle(text);
83
- } else if (embedder && typeof embedder.embed === "function") {
84
- embedOne = (text) => Promise.resolve(embedder.embed(text));
85
- }
86
- if (!embedOne) return { indexed: 0, skipped: 0 };
87
- const rows = store.needsEmbedding(limit);
88
- let indexed = 0;
89
- for (const row of rows) {
90
- try {
91
- const text = [row.title, row.content].filter(Boolean).join("\n");
92
- const vector = await embedOne(text);
93
- if (vector && vector.length) {
94
- store.setEmbedding(row.id, vector);
95
- indexed++;
96
- }
97
- } catch (error) {
98
- logger?.warn?.(`[dsh-mneme] rebuild embed failed for ${row.id}: ${String(error)}`);
99
- }
100
- }
101
- if (indexed > 0 && embedder.modelHash) this.markModel(embedder.modelHash, embedder.dimension);
102
- return { indexed, skipped: rows.length - indexed };
103
- },
104
-
105
- /** Index stats for the Web panel / debugging. */
106
- getStats() {
107
- return {
108
- modelHash: getMeta("model_hash"),
109
- dimension: this.dimension(),
110
- updatedAt: getMeta("updated_at"),
111
- embeddedCount: store.embeddedCount(),
112
- totalCount: store.count()
113
- };
114
- }
115
- };
116
- }
1
+ // Thin vector-index layer over the store's embedding column. Keeps the
2
+ // current model fingerprint + stats in a dedicated `vector_meta` table so the
3
+ // index can detect drift (embeddings generated by a different model) and the
4
+ // Web panel can report index health. The heavy lifting (cosine search) lives
5
+ // in store.searchVector; this module owns the index lifecycle.
6
+
7
+ const META_SCHEMA = `
8
+ CREATE TABLE IF NOT EXISTS vector_meta (
9
+ key TEXT PRIMARY KEY,
10
+ value TEXT NOT NULL
11
+ );
12
+ `;
13
+
14
+ export function createVectorIndex({ store, logger }) {
15
+ const db = store.db;
16
+ db.exec(META_SCHEMA);
17
+
18
+ function getMeta(key) {
19
+ const row = db.prepare("SELECT value FROM vector_meta WHERE key = ?").get(key);
20
+ return row?.value ?? undefined;
21
+ }
22
+
23
+ function setMeta(key, value) {
24
+ db.prepare(
25
+ `INSERT INTO vector_meta (key, value) VALUES (?, ?)
26
+ ON CONFLICT(key) DO UPDATE SET value = excluded.value`
27
+ ).run(key, String(value));
28
+ }
29
+
30
+ return {
31
+ /** Record the model that generated the current vectors. */
32
+ markModel(modelHash, dimension) {
33
+ setMeta("model_hash", modelHash);
34
+ setMeta("dimension", String(dimension ?? ""));
35
+ setMeta("updated_at", new Date().toISOString());
36
+ },
37
+
38
+ modelHash() {
39
+ return getMeta("model_hash");
40
+ },
41
+
42
+ dimension() {
43
+ const raw = getMeta("dimension");
44
+ return raw && Number.isInteger(Number(raw)) ? Number(raw) : undefined;
45
+ },
46
+
47
+ /** Store (or clear with null vector) one memory's embedding. */
48
+ saveEmbedding(id, vector) {
49
+ store.setEmbedding(id, vector);
50
+ },
51
+
52
+ /** Drop one memory's embedding. */
53
+ deleteEmbedding(id) {
54
+ store.setEmbedding(id, null);
55
+ },
56
+
57
+ /** Read one memory's cached vector; undefined when none/parse failure. */
58
+ getEmbedding(id) {
59
+ const row = db.prepare("SELECT embedding FROM memories WHERE id = ?").get(id);
60
+ if (!row?.embedding) return undefined;
61
+ try {
62
+ const v = JSON.parse(row.embedding);
63
+ return Array.isArray(v) && v.length ? v : undefined;
64
+ } catch {
65
+ return undefined;
66
+ }
67
+ },
68
+
69
+ /** Cosine search over embedded rows; results carry a 0..1 score. */
70
+ search(queryVector, { limit = 20, threshold = 0.65 } = {}) {
71
+ return store.searchVector(queryVector, { limit, threshold });
72
+ },
73
+
74
+ /** Re-embed every row missing an embedding. Returns indexed count. */
75
+ async rebuildIndex(embedder, { limit = 1000 } = {}) {
76
+ // The loop needs a single-text embedder. Native embedSingle is preferred;
77
+ // embed-only OpenAI-compatible clients (issue #10) are accepted too via
78
+ // their `embed` single-text interface, so /vector-reindex no longer
79
+ // silently returns 0 for them. An embedder exposing neither is ignored.
80
+ let embedOne = null;
81
+ if (embedder && typeof embedder.embedSingle === "function") {
82
+ embedOne = (text) => embedder.embedSingle(text);
83
+ } else if (embedder && typeof embedder.embed === "function") {
84
+ embedOne = (text) => Promise.resolve(embedder.embed(text));
85
+ }
86
+ if (!embedOne) return { indexed: 0, skipped: 0 };
87
+ const rows = store.needsEmbedding(limit);
88
+ let indexed = 0;
89
+ for (const row of rows) {
90
+ try {
91
+ const text = [row.title, row.content].filter(Boolean).join("\n");
92
+ const vector = await embedOne(text);
93
+ if (vector && vector.length) {
94
+ store.setEmbedding(row.id, vector);
95
+ indexed++;
96
+ }
97
+ } catch (error) {
98
+ logger?.warn?.(`[dsh-mneme] rebuild embed failed for ${row.id}: ${String(error)}`);
99
+ }
100
+ }
101
+ if (indexed > 0 && embedder.modelHash) this.markModel(embedder.modelHash, embedder.dimension);
102
+ return { indexed, skipped: rows.length - indexed };
103
+ },
104
+
105
+ /** Index stats for the Web panel / debugging. */
106
+ getStats() {
107
+ return {
108
+ modelHash: getMeta("model_hash"),
109
+ dimension: this.dimension(),
110
+ updatedAt: getMeta("updated_at"),
111
+ embeddedCount: store.embeddedCount(),
112
+ totalCount: store.count()
113
+ };
114
+ }
115
+ };
116
+ }
package/package.json CHANGED
@@ -1,75 +1,80 @@
1
- {
2
- "name": "@modusensus/dsh-mneme",
3
- "description": "Cross-session memory plugin for DeepSeek Harness with autoDream consolidation: SQLite store, Markdown mirrors, 7 model tools, automatic injection, session summarization, user profile/rules, custom slash commands, vector (semantic) search, and a Web GUI panel",
4
- "version": "0.6.6",
5
- "license": "MIT",
6
- "repository": {
7
- "type": "git",
8
- "url": "git+https://github.com/modusensus/dsh-mneme.git"
9
- },
10
- "homepage": "https://github.com/modusensus/dsh-mneme#readme",
11
- "bugs": {
12
- "url": "https://github.com/modusensus/dsh-mneme/issues"
13
- },
14
- "type": "module",
15
- "main": "lib/index.js",
16
- "exports": {
17
- ".": {
18
- "default": "./lib/index.js"
19
- },
20
- "./client": {
21
- "default": "./lib/client.js"
22
- },
23
- "./package.json": "./package.json"
24
- },
25
- "files": [
26
- "lib",
27
- "src",
28
- "scripts",
29
- "test",
30
- "cordis.patch.yml"
31
- ],
32
- "dsh": {
33
- "client": {
34
- "inject": [
35
- "slots",
36
- "locale",
37
- "layout",
38
- "connection"
39
- ],
40
- "platform": "web"
41
- },
42
- "bundle": {
43
- "patch": "./cordis.patch.yml"
44
- }
45
- },
46
- "peerDependencies": {
47
- "@deepseek-ai/cordis": "^4.0.1",
48
- "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
49
- "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
50
- "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
51
- "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
52
- "@deepseek-ai/schemastery": "^3.18.1"
53
- },
54
- "devDependencies": {
55
- "@deepseek-ai/cordis": "^4.0.1",
56
- "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
57
- "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
58
- "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
59
- "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
60
- "@deepseek-ai/schemastery": "^3.18.1"
61
- },
62
- "scripts": {
63
- "sync": "node scripts/sync-lib.js",
64
- "prepack": "npm run sync",
65
- "test": "node --test test/*.test.js",
66
- "e2e": "node scripts/e2e-dsh.js",
67
- "stress": "node scripts/stress-dsh.js"
68
- },
69
- "dependencies": {
70
- "@huggingface/transformers": "^4.2.0"
71
- },
72
- "overrides": {
73
- "adm-zip": "0.6.0"
74
- }
75
- }
1
+ {
2
+ "name": "@modusensus/dsh-mneme",
3
+ "description": "Cross-session memory plugin for DeepSeek Harness with autoDream consolidation: SQLite store, Markdown mirrors, 7 model tools, automatic injection, session summarization, user profile/rules, custom slash commands, vector (semantic) search, and a Web GUI panel",
4
+ "version": "0.6.8",
5
+ "license": "MIT",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "git+https://github.com/modusensus/dsh-mneme.git"
9
+ },
10
+ "homepage": "https://github.com/modusensus/dsh-mneme#readme",
11
+ "bugs": {
12
+ "url": "https://github.com/modusensus/dsh-mneme/issues"
13
+ },
14
+ "type": "module",
15
+ "main": "lib/index.js",
16
+ "exports": {
17
+ ".": {
18
+ "default": "./lib/index.js"
19
+ },
20
+ "./client": {
21
+ "default": "./lib/client.js"
22
+ },
23
+ "./package.json": "./package.json"
24
+ },
25
+ "files": [
26
+ "lib",
27
+ "src",
28
+ "scripts",
29
+ "test",
30
+ "cordis.patch.yml"
31
+ ],
32
+ "dsh": {
33
+ "client": {
34
+ "inject": [
35
+ "slots",
36
+ "locale",
37
+ "layout",
38
+ "connection"
39
+ ],
40
+ "platform": "web"
41
+ },
42
+ "bundle": {
43
+ "patch": "./cordis.patch.yml"
44
+ }
45
+ },
46
+ "peerDependencies": {
47
+ "@deepseek-ai/cordis": "^4.0.1",
48
+ "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
49
+ "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
50
+ "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
51
+ "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
52
+ "@deepseek-ai/schemastery": "^3.18.1"
53
+ },
54
+ "devDependencies": {
55
+ "@deepseek-ai/cordis": "^4.0.1",
56
+ "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
57
+ "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
58
+ "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
59
+ "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
60
+ "@deepseek-ai/schemastery": "^3.18.1",
61
+ "c8": "^12.0.0"
62
+ },
63
+ "scripts": {
64
+ "sync": "node scripts/sync-lib.js",
65
+ "prepack": "npm run sync",
66
+ "test": "node --test test/*.test.js",
67
+ "test:coverage": "c8 node --test test/*.test.js",
68
+ "e2e": "node scripts/e2e-dsh.js",
69
+ "stress": "node scripts/stress-dsh.js"
70
+ },
71
+ "dependencies": {
72
+ "@huggingface/transformers": "^4.2.0"
73
+ },
74
+ "overrides": {
75
+ "adm-zip": "0.6.0"
76
+ },
77
+ "c8": {
78
+ "reporter": ["text", "lcov"]
79
+ }
80
+ }