@yeaft/webchat-agent 0.1.663 → 0.1.664
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.
- package/package.json +1 -1
- package/unify/index.js +0 -1
- package/unify/init.js +0 -1
- package/unify/memory/scan.js +0 -273
package/package.json
CHANGED
package/unify/index.js
CHANGED
|
@@ -26,7 +26,6 @@ export { MemoryStore, parseEntry, serializeEntry, MEMORY_KINDS } from './memory/
|
|
|
26
26
|
|
|
27
27
|
// Phase 5: Advanced features
|
|
28
28
|
export { KINDS, KIND_PRIORITY, KIND_DESCRIPTIONS, IMPORTANCE_LEVELS, validateEntry, parseScopePath, getAncestorScopes, areScopesRelated } from './memory/types.js';
|
|
29
|
-
export { scanEntries, scoreEntry, findStaleEntries, findDuplicateGroups, summarizeScan } from './memory/scan.js';
|
|
30
29
|
export { runStopHooks } from './stop-hooks.js';
|
|
31
30
|
export { MCPManager, createMCPManager } from './mcp.js';
|
|
32
31
|
export { SkillManager, createSkillManager, parseSkill, serializeSkill } from './skills.js';
|
package/unify/init.js
CHANGED
package/unify/memory/scan.js
DELETED
|
@@ -1,273 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* scan.js — Memory header scanning and scope/tag matching
|
|
3
|
-
*
|
|
4
|
-
* Fast in-memory scanning of entry frontmatter for:
|
|
5
|
-
* - Scope tree traversal
|
|
6
|
-
* - Tag overlap scoring
|
|
7
|
-
* - Kind-based filtering
|
|
8
|
-
* - Stale entry detection (for Dream)
|
|
9
|
-
*
|
|
10
|
-
* Reference: yeaft-unify-core-systems.md §3.3, yeaft-unify-design.md §5.1
|
|
11
|
-
*/
|
|
12
|
-
|
|
13
|
-
import { KINDS, KIND_PRIORITY, IMPORTANCE_WEIGHT, getAncestorScopes } from './types.js';
|
|
14
|
-
|
|
15
|
-
// ─── Scan Results ──────────────────────────────────────────
|
|
16
|
-
|
|
17
|
-
/**
|
|
18
|
-
* @typedef {Object} ScanResult
|
|
19
|
-
* @property {object[]} entries — all parsed entries
|
|
20
|
-
* @property {Map<string, number>} scopeCount — scope → entry count
|
|
21
|
-
* @property {Map<string, number>} kindCount — kind → entry count
|
|
22
|
-
* @property {Map<string, Set<string>>} tagIndex — tag → set of entry names
|
|
23
|
-
* @property {number} totalEntries — total count
|
|
24
|
-
*/
|
|
25
|
-
|
|
26
|
-
/**
|
|
27
|
-
* Scan all entries from a MemoryStore and build indexes.
|
|
28
|
-
*
|
|
29
|
-
* @param {import('./store.js').MemoryStore} memoryStore
|
|
30
|
-
* @returns {ScanResult}
|
|
31
|
-
*/
|
|
32
|
-
export function scanEntries(memoryStore) {
|
|
33
|
-
const entries = memoryStore.listEntries();
|
|
34
|
-
|
|
35
|
-
const scopeCount = new Map();
|
|
36
|
-
const kindCount = new Map();
|
|
37
|
-
const tagIndex = new Map();
|
|
38
|
-
|
|
39
|
-
for (const entry of entries) {
|
|
40
|
-
// Scope count
|
|
41
|
-
const scope = entry.scope || 'global';
|
|
42
|
-
scopeCount.set(scope, (scopeCount.get(scope) || 0) + 1);
|
|
43
|
-
|
|
44
|
-
// Kind count
|
|
45
|
-
const kind = entry.kind || 'fact';
|
|
46
|
-
kindCount.set(kind, (kindCount.get(kind) || 0) + 1);
|
|
47
|
-
|
|
48
|
-
// Tag index
|
|
49
|
-
const tags = entry.tags || [];
|
|
50
|
-
for (const tag of tags) {
|
|
51
|
-
const lowerTag = tag.toLowerCase();
|
|
52
|
-
if (!tagIndex.has(lowerTag)) tagIndex.set(lowerTag, new Set());
|
|
53
|
-
tagIndex.get(lowerTag).add(entry.name);
|
|
54
|
-
}
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
return {
|
|
58
|
-
entries,
|
|
59
|
-
scopeCount,
|
|
60
|
-
kindCount,
|
|
61
|
-
tagIndex,
|
|
62
|
-
totalEntries: entries.length,
|
|
63
|
-
};
|
|
64
|
-
}
|
|
65
|
-
|
|
66
|
-
// ─── Scoring Functions ─────────────────────────────────────
|
|
67
|
-
|
|
68
|
-
/**
|
|
69
|
-
* Score an entry for relevance to a query context.
|
|
70
|
-
*
|
|
71
|
-
* Scoring factors:
|
|
72
|
-
* - Scope match: exact=5, parent/child=3, global=1
|
|
73
|
-
* - Tag overlap: 2 per matching tag
|
|
74
|
-
* - Kind priority: see KIND_PRIORITY
|
|
75
|
-
* - Importance weight: see IMPORTANCE_WEIGHT
|
|
76
|
-
* - Frequency bonus: log2(frequency)
|
|
77
|
-
* - Recency bonus: entries updated in last 7 days get +2
|
|
78
|
-
*
|
|
79
|
-
* @param {object} entry — memory entry
|
|
80
|
-
* @param {{ scope?: string, tags?: string[], preferKinds?: string[] }} context
|
|
81
|
-
* @returns {number} — relevance score
|
|
82
|
-
*/
|
|
83
|
-
export function scoreEntry(entry, context = {}) {
|
|
84
|
-
let score = 0;
|
|
85
|
-
|
|
86
|
-
// Scope match
|
|
87
|
-
if (context.scope && entry.scope) {
|
|
88
|
-
if (entry.scope === context.scope) {
|
|
89
|
-
score += 5; // exact match
|
|
90
|
-
} else {
|
|
91
|
-
const ancestors = getAncestorScopes(context.scope);
|
|
92
|
-
if (ancestors.includes(entry.scope)) {
|
|
93
|
-
score += 3; // ancestor match
|
|
94
|
-
} else if (entry.scope.startsWith(context.scope + '/')) {
|
|
95
|
-
score += 3; // descendant match
|
|
96
|
-
} else if (entry.scope === 'global') {
|
|
97
|
-
score += 1; // global fallback
|
|
98
|
-
}
|
|
99
|
-
}
|
|
100
|
-
}
|
|
101
|
-
|
|
102
|
-
// Tag overlap
|
|
103
|
-
if (context.tags && context.tags.length > 0 && entry.tags) {
|
|
104
|
-
const entryTags = new Set(entry.tags.map(t => t.toLowerCase()));
|
|
105
|
-
for (const tag of context.tags) {
|
|
106
|
-
if (entryTags.has(tag.toLowerCase())) {
|
|
107
|
-
score += 2;
|
|
108
|
-
}
|
|
109
|
-
}
|
|
110
|
-
}
|
|
111
|
-
|
|
112
|
-
// Kind priority
|
|
113
|
-
const kindPriority = KIND_PRIORITY[entry.kind] || 0;
|
|
114
|
-
score += kindPriority * 0.5;
|
|
115
|
-
|
|
116
|
-
// Preferred kinds bonus
|
|
117
|
-
if (context.preferKinds && context.preferKinds.includes(entry.kind)) {
|
|
118
|
-
score += 2;
|
|
119
|
-
}
|
|
120
|
-
|
|
121
|
-
// Importance weight
|
|
122
|
-
const impWeight = IMPORTANCE_WEIGHT[entry.importance] || IMPORTANCE_WEIGHT.normal;
|
|
123
|
-
score += impWeight * 0.5;
|
|
124
|
-
|
|
125
|
-
// Frequency bonus (logarithmic)
|
|
126
|
-
const freq = entry.frequency || 1;
|
|
127
|
-
score += Math.log2(Math.max(freq, 1));
|
|
128
|
-
|
|
129
|
-
// Recency bonus
|
|
130
|
-
if (entry.updated_at) {
|
|
131
|
-
const daysSince = (Date.now() - new Date(entry.updated_at).getTime()) / (1000 * 60 * 60 * 24);
|
|
132
|
-
if (daysSince <= 7) score += 2;
|
|
133
|
-
else if (daysSince <= 30) score += 1;
|
|
134
|
-
}
|
|
135
|
-
|
|
136
|
-
return score;
|
|
137
|
-
}
|
|
138
|
-
|
|
139
|
-
// ─── Stale Detection (for Dream) ────────────────────────────
|
|
140
|
-
|
|
141
|
-
/**
|
|
142
|
-
* Find entries that are potentially stale.
|
|
143
|
-
*
|
|
144
|
-
* Stale criteria:
|
|
145
|
-
* - context entries older than 30 days
|
|
146
|
-
* - entries never recalled (frequency = 1) and older than 60 days
|
|
147
|
-
* - relation entries older than 90 days
|
|
148
|
-
*
|
|
149
|
-
* @param {object[]} entries
|
|
150
|
-
* @returns {object[]} — stale entries
|
|
151
|
-
*/
|
|
152
|
-
export function findStaleEntries(entries) {
|
|
153
|
-
const now = Date.now();
|
|
154
|
-
const stale = [];
|
|
155
|
-
|
|
156
|
-
for (const entry of entries) {
|
|
157
|
-
const updatedAt = entry.updated_at ? new Date(entry.updated_at).getTime() : 0;
|
|
158
|
-
const daysSince = (now - updatedAt) / (1000 * 60 * 60 * 24);
|
|
159
|
-
|
|
160
|
-
let isStale = false;
|
|
161
|
-
|
|
162
|
-
// Context entries become stale fast
|
|
163
|
-
if (entry.kind === 'context' && daysSince > 30) {
|
|
164
|
-
isStale = true;
|
|
165
|
-
}
|
|
166
|
-
|
|
167
|
-
// Entries never recalled and old
|
|
168
|
-
if ((entry.frequency || 1) <= 1 && daysSince > 60) {
|
|
169
|
-
isStale = true;
|
|
170
|
-
}
|
|
171
|
-
|
|
172
|
-
// Relations are volatile
|
|
173
|
-
if (entry.kind === 'relation' && daysSince > 90) {
|
|
174
|
-
isStale = true;
|
|
175
|
-
}
|
|
176
|
-
|
|
177
|
-
if (isStale) {
|
|
178
|
-
stale.push({ ...entry, _daysSinceUpdate: Math.round(daysSince) });
|
|
179
|
-
}
|
|
180
|
-
}
|
|
181
|
-
|
|
182
|
-
return stale;
|
|
183
|
-
}
|
|
184
|
-
|
|
185
|
-
// ─── Duplicate Detection (for Dream Merge) ──────────────────
|
|
186
|
-
|
|
187
|
-
/**
|
|
188
|
-
* Find groups of entries that are potentially duplicates.
|
|
189
|
-
* Entries are grouped if they share ≥2 tags AND the same kind.
|
|
190
|
-
*
|
|
191
|
-
* @param {object[]} entries
|
|
192
|
-
* @returns {object[][]} — groups of potentially duplicate entries
|
|
193
|
-
*/
|
|
194
|
-
export function findDuplicateGroups(entries) {
|
|
195
|
-
const groups = [];
|
|
196
|
-
const visited = new Set();
|
|
197
|
-
|
|
198
|
-
for (let i = 0; i < entries.length; i++) {
|
|
199
|
-
if (visited.has(i)) continue;
|
|
200
|
-
|
|
201
|
-
const group = [entries[i]];
|
|
202
|
-
const eTags = new Set((entries[i].tags || []).map(t => t.toLowerCase()));
|
|
203
|
-
|
|
204
|
-
for (let j = i + 1; j < entries.length; j++) {
|
|
205
|
-
if (visited.has(j)) continue;
|
|
206
|
-
if (entries[i].kind !== entries[j].kind) continue;
|
|
207
|
-
|
|
208
|
-
const jTags = new Set((entries[j].tags || []).map(t => t.toLowerCase()));
|
|
209
|
-
let overlap = 0;
|
|
210
|
-
for (const tag of eTags) {
|
|
211
|
-
if (jTags.has(tag)) overlap++;
|
|
212
|
-
}
|
|
213
|
-
|
|
214
|
-
if (overlap >= 2) {
|
|
215
|
-
group.push(entries[j]);
|
|
216
|
-
visited.add(j);
|
|
217
|
-
}
|
|
218
|
-
}
|
|
219
|
-
|
|
220
|
-
if (group.length > 1) {
|
|
221
|
-
visited.add(i);
|
|
222
|
-
groups.push(group);
|
|
223
|
-
}
|
|
224
|
-
}
|
|
225
|
-
|
|
226
|
-
return groups;
|
|
227
|
-
}
|
|
228
|
-
|
|
229
|
-
// ─── Stats Summary ──────────────────────────────────────────
|
|
230
|
-
|
|
231
|
-
/**
|
|
232
|
-
* Generate a text summary of memory state (for Dream prompts).
|
|
233
|
-
*
|
|
234
|
-
* @param {ScanResult} scan
|
|
235
|
-
* @returns {string}
|
|
236
|
-
*/
|
|
237
|
-
export function summarizeScan(scan) {
|
|
238
|
-
const lines = [];
|
|
239
|
-
|
|
240
|
-
lines.push(`Total entries: ${scan.totalEntries}`);
|
|
241
|
-
|
|
242
|
-
// Kind breakdown
|
|
243
|
-
const kindLines = [];
|
|
244
|
-
for (const kind of KINDS) {
|
|
245
|
-
const count = scan.kindCount.get(kind) || 0;
|
|
246
|
-
if (count > 0) kindLines.push(`${kind}: ${count}`);
|
|
247
|
-
}
|
|
248
|
-
if (kindLines.length > 0) {
|
|
249
|
-
lines.push(`Kinds: ${kindLines.join(', ')}`);
|
|
250
|
-
}
|
|
251
|
-
|
|
252
|
-
// Scope breakdown (top 10)
|
|
253
|
-
const scopeEntries = [...scan.scopeCount.entries()]
|
|
254
|
-
.sort((a, b) => b[1] - a[1])
|
|
255
|
-
.slice(0, 10);
|
|
256
|
-
if (scopeEntries.length > 0) {
|
|
257
|
-
lines.push('Top scopes:');
|
|
258
|
-
for (const [scope, count] of scopeEntries) {
|
|
259
|
-
lines.push(` ${scope}: ${count}`);
|
|
260
|
-
}
|
|
261
|
-
}
|
|
262
|
-
|
|
263
|
-
// Tag cloud (top 20)
|
|
264
|
-
const tagEntries = [...scan.tagIndex.entries()]
|
|
265
|
-
.map(([tag, names]) => [tag, names.size])
|
|
266
|
-
.sort((a, b) => b[1] - a[1])
|
|
267
|
-
.slice(0, 20);
|
|
268
|
-
if (tagEntries.length > 0) {
|
|
269
|
-
lines.push(`Top tags: ${tagEntries.map(([t, c]) => `${t}(${c})`).join(', ')}`);
|
|
270
|
-
}
|
|
271
|
-
|
|
272
|
-
return lines.join('\n');
|
|
273
|
-
}
|