claude-memory-layer 1.0.30 → 1.0.32
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/README.md +12 -5
- package/dist/cli/index.js +4 -3
- package/dist/cli/index.js.map +2 -2
- package/dist/core/index.js +3 -2
- package/dist/core/index.js.map +2 -2
- package/dist/hooks/post-tool-use.js +3 -2
- package/dist/hooks/post-tool-use.js.map +2 -2
- package/dist/hooks/semantic-daemon.js +3 -2
- package/dist/hooks/semantic-daemon.js.map +2 -2
- package/dist/hooks/session-end.js +3 -2
- package/dist/hooks/session-end.js.map +2 -2
- package/dist/hooks/session-start.js +3 -2
- package/dist/hooks/session-start.js.map +2 -2
- package/dist/hooks/stop.js +3 -2
- package/dist/hooks/stop.js.map +2 -2
- package/dist/hooks/user-prompt-submit.js +3 -2
- package/dist/hooks/user-prompt-submit.js.map +2 -2
- package/dist/index.js +3 -2
- package/dist/index.js.map +2 -2
- package/dist/mcp/index.js +3 -2
- package/dist/mcp/index.js.map +2 -2
- package/dist/server/api/index.js +3 -2
- package/dist/server/api/index.js.map +2 -2
- package/dist/server/index.js +3 -2
- package/dist/server/index.js.map +2 -2
- package/dist/services/memory-service.js +3 -2
- package/dist/services/memory-service.js.map +2 -2
- package/package.json +10 -3
- package/scripts/postinstall-embedding-backend.cjs +18 -16
- package/AGENTS.md +0 -71
- package/CLAUDE.md +0 -30
- package/HANDOFF.md +0 -92
- package/Memo.txt +0 -558
- package/benchmarks/replay/anonymized-real-sessions.json +0 -48
- package/config/kpi-thresholds.json +0 -7
- package/context.md +0 -636
- package/docs/ARCHITECTURE_COMPARISON_AND_RECOMMENDATIONS.md +0 -627
- package/docs/HERMES_MEMORY_INGESTION_ANALYSIS.md +0 -440
- package/docs/MCP_MEMORY_SERVICE_COMPARATIVE_REVIEW.md +0 -271
- package/docs/MEMORY_USEFULNESS_AUDIT.md +0 -371
- package/docs/MEMORY_USEFULNESS_AUDIT_RAW.json +0 -80
- package/docs/MEMSEARCH_PROJECT_STRUCTURE_ANALYSIS.md +0 -333
- package/docs/MEMU_ADOPTION.md +0 -40
- package/docs/OPERATIONS.md +0 -18
- package/docs/PRODUCT_VALIDATION_MATRIX.md +0 -82
- package/docs/PROJECT_STRUCTURE_ANALYSIS.md +0 -421
- package/docs/REFACTORING_MILESTONES_AND_ISSUES.md +0 -501
- package/docs/REFACTORING_PLAN_THIN_CORE.md +0 -414
- package/docs/REFERENCE_PROJECT_ANALYSES.md +0 -25
- package/docs/SUPERLOCALMEMORY_PROJECT_STRUCTURE_ANALYSIS.md +0 -452
- package/docs/TARGET_ARCHITECTURE_AND_FOLDER_STRUCTURE.md +0 -446
- package/docs/architecture/comparison-index.md +0 -47
- package/docs/reports/codex-real-data-validation-20260505T040447Z.md +0 -46
- package/plan.md +0 -1642
- package/scripts/build.ts +0 -159
- package/scripts/bump-patch-version.sh +0 -18
- package/scripts/delete-unknown-projects.js +0 -154
- package/scripts/fix-sync-gap.js +0 -32
- package/scripts/generate-session-qrels.ts +0 -126
- package/scripts/heartbeat-memory-orchestrator.sh +0 -28
- package/scripts/replay-retrieval-benchmark.ts +0 -69
- package/scripts/report-sync-gap.js +0 -26
- package/scripts/review-queue-auto-resolve.js +0 -21
- package/scripts/sync-gap-auto-heal.sh +0 -17
- package/spec.md +0 -624
- package/specs/20260207-dashboard-upgrade/context.md +0 -38
- package/specs/20260207-dashboard-upgrade/spec.md +0 -96
- package/specs/citations-system/context.md +0 -243
- package/specs/citations-system/plan.md +0 -495
- package/specs/citations-system/spec.md +0 -371
- package/specs/endless-mode/context.md +0 -305
- package/specs/endless-mode/plan.md +0 -620
- package/specs/endless-mode/spec.md +0 -455
- package/specs/entity-edge-model/context.md +0 -401
- package/specs/entity-edge-model/plan.md +0 -459
- package/specs/entity-edge-model/spec.md +0 -391
- package/specs/evidence-aligner-v2/context.md +0 -401
- package/specs/evidence-aligner-v2/plan.md +0 -303
- package/specs/evidence-aligner-v2/spec.md +0 -312
- package/specs/mcp-desktop-integration/context.md +0 -278
- package/specs/mcp-desktop-integration/plan.md +0 -550
- package/specs/mcp-desktop-integration/spec.md +0 -494
- package/specs/memory-utilization-improvements/context.md +0 -145
- package/specs/memory-utilization-improvements/plan.md +0 -361
- package/specs/memory-utilization-improvements/spec.md +0 -361
- package/specs/post-tool-use-hook/context.md +0 -319
- package/specs/post-tool-use-hook/plan.md +0 -469
- package/specs/post-tool-use-hook/spec.md +0 -364
- package/specs/private-tags/context.md +0 -288
- package/specs/private-tags/plan.md +0 -412
- package/specs/private-tags/spec.md +0 -345
- package/specs/progressive-disclosure/context.md +0 -346
- package/specs/progressive-disclosure/plan.md +0 -663
- package/specs/progressive-disclosure/spec.md +0 -415
- package/specs/selective-tool-observation/context.md +0 -100
- package/specs/selective-tool-observation/plan.md +0 -158
- package/specs/selective-tool-observation/spec.md +0 -127
- package/specs/task-entity-system/context.md +0 -297
- package/specs/task-entity-system/plan.md +0 -301
- package/specs/task-entity-system/spec.md +0 -314
- package/specs/thin-core-refactor/context.md +0 -275
- package/specs/thin-core-refactor/plan.md +0 -536
- package/specs/thin-core-refactor/spec.md +0 -465
- package/specs/vector-outbox-v2/context.md +0 -470
- package/specs/vector-outbox-v2/plan.md +0 -562
- package/specs/vector-outbox-v2/spec.md +0 -466
- package/specs/web-viewer-ui/context.md +0 -384
- package/specs/web-viewer-ui/plan.md +0 -797
- package/specs/web-viewer-ui/spec.md +0 -516
- package/src/adapters/claude/capture/index.ts +0 -3
- package/src/adapters/claude/context/index.ts +0 -3
- package/src/adapters/claude/hooks/index.ts +0 -21
- package/src/adapters/claude/hooks/post-tool-use.ts +0 -239
- package/src/adapters/claude/hooks/prompt-injection-policy.ts +0 -104
- package/src/adapters/claude/hooks/semantic-daemon-client.ts +0 -209
- package/src/adapters/claude/hooks/semantic-daemon.ts +0 -283
- package/src/adapters/claude/hooks/session-end.ts +0 -59
- package/src/adapters/claude/hooks/session-start.ts +0 -73
- package/src/adapters/claude/hooks/stop.ts +0 -128
- package/src/adapters/claude/hooks/user-prompt-submit.ts +0 -361
- package/src/adapters/claude/index.ts +0 -4
- package/src/adapters/claude/transcript/index.ts +0 -4
- package/src/adapters/claude/transcript/transcript-reader.ts +0 -57
- package/src/adapters/claude/transcript/turn-reconstructor.ts +0 -65
- package/src/apps/cli/claude-settings-hooks.ts +0 -138
- package/src/apps/cli/codex-import-runner.ts +0 -125
- package/src/apps/cli/codex-validation-output.ts +0 -95
- package/src/apps/cli/hermes-import-runner.ts +0 -130
- package/src/apps/cli/hermes-validation-output.ts +0 -91
- package/src/apps/cli/index.ts +0 -1735
- package/src/apps/cli/mcp-install.ts +0 -106
- package/src/apps/cli/retrieval-disclosure-output.ts +0 -196
- package/src/apps/dashboard/assets/js/bootstrap.js +0 -244
- package/src/apps/dashboard/assets/js/chat.js +0 -373
- package/src/apps/dashboard/assets/js/disclosure.js +0 -232
- package/src/apps/dashboard/assets/js/modals.js +0 -298
- package/src/apps/dashboard/assets/js/overview.js +0 -655
- package/src/apps/dashboard/assets/js/state.js +0 -72
- package/src/apps/dashboard/assets/js/views.js +0 -468
- package/src/apps/dashboard/index.html +0 -543
- package/src/apps/dashboard/index.ts +0 -3
- package/src/apps/dashboard/style.css +0 -1750
- package/src/apps/index.ts +0 -5
- package/src/apps/server/api/chat.ts +0 -244
- package/src/apps/server/api/citations.ts +0 -105
- package/src/apps/server/api/events.ts +0 -137
- package/src/apps/server/api/health.ts +0 -53
- package/src/apps/server/api/index.ts +0 -26
- package/src/apps/server/api/projects.ts +0 -74
- package/src/apps/server/api/search.ts +0 -184
- package/src/apps/server/api/sessions.ts +0 -115
- package/src/apps/server/api/stats.ts +0 -723
- package/src/apps/server/api/turns.ts +0 -143
- package/src/apps/server/api/utils.ts +0 -65
- package/src/apps/server/index.ts +0 -111
- package/src/cli/index.ts +0 -3
- package/src/cli/retrieval-disclosure-output.ts +0 -2
- package/src/compat/index.ts +0 -5
- package/src/core/canonical-key.ts +0 -186
- package/src/core/citation-generator.ts +0 -63
- package/src/core/consolidated-store.ts +0 -356
- package/src/core/consolidation-worker.ts +0 -493
- package/src/core/context-formatter.ts +0 -276
- package/src/core/continuity-manager.ts +0 -341
- package/src/core/db-wrapper.ts +0 -64
- package/src/core/derive/fact-deriver.ts +0 -170
- package/src/core/derive/index.ts +0 -2
- package/src/core/derive/summary-deriver.ts +0 -76
- package/src/core/edge-repo.ts +0 -333
- package/src/core/embedder.ts +0 -4
- package/src/core/engine/embedding-maintenance-service.ts +0 -187
- package/src/core/engine/endless-memory-services.ts +0 -4
- package/src/core/engine/index.ts +0 -19
- package/src/core/engine/memory-engine-services.ts +0 -170
- package/src/core/engine/memory-ingest-service.ts +0 -317
- package/src/core/engine/memory-query-service.ts +0 -173
- package/src/core/engine/memory-runtime-service.ts +0 -162
- package/src/core/engine/memory-service-composition.ts +0 -231
- package/src/core/engine/retrieval-analytics-service.ts +0 -181
- package/src/core/engine/retrieval-disclosure-service.ts +0 -420
- package/src/core/engine/retrieval-orchestrator.ts +0 -377
- package/src/core/engine/retrieval-services.ts +0 -176
- package/src/core/engine/shared-memory-services.ts +0 -4
- package/src/core/entity-repo.ts +0 -349
- package/src/core/event-store.ts +0 -779
- package/src/core/evidence-aligner.ts +0 -635
- package/src/core/external-market-context.ts +0 -582
- package/src/core/graduation-worker.ts +0 -171
- package/src/core/graduation.ts +0 -377
- package/src/core/index.ts +0 -64
- package/src/core/ingest-interceptor.ts +0 -80
- package/src/core/markdown-mirror.ts +0 -70
- package/src/core/matcher.ts +0 -208
- package/src/core/md-mirror.ts +0 -92
- package/src/core/metadata-extractor.ts +0 -203
- package/src/core/model/memory-fact.ts +0 -30
- package/src/core/model/memory-rule.ts +0 -14
- package/src/core/model/memory-summary.ts +0 -21
- package/src/core/model/raw-event.ts +0 -28
- package/src/core/model/retrieval-result.ts +0 -35
- package/src/core/mongo-sync-config.ts +0 -165
- package/src/core/mongo-sync-worker.ts +0 -381
- package/src/core/privacy/filter.ts +0 -190
- package/src/core/privacy/index.ts +0 -20
- package/src/core/privacy/tag-parser.ts +0 -145
- package/src/core/product-validation-matrix.ts +0 -314
- package/src/core/progressive-retriever.ts +0 -414
- package/src/core/registry/project-path.ts +0 -54
- package/src/core/registry/session-registry.ts +0 -69
- package/src/core/replay-evaluator.ts +0 -625
- package/src/core/retrieval-benchmark.ts +0 -117
- package/src/core/retrieval-quality.ts +0 -109
- package/src/core/retriever.ts +0 -800
- package/src/core/session-qrels.ts +0 -360
- package/src/core/shared-event-store.ts +0 -114
- package/src/core/shared-promoter.ts +0 -249
- package/src/core/shared-store.ts +0 -289
- package/src/core/shared-vector-store.ts +0 -203
- package/src/core/sqlite-event-store.ts +0 -1846
- package/src/core/sqlite-wrapper.ts +0 -116
- package/src/core/sync-worker.ts +0 -228
- package/src/core/tag-taxonomy.ts +0 -51
- package/src/core/task/blocker-resolver.ts +0 -333
- package/src/core/task/index.ts +0 -9
- package/src/core/task/task-matcher.ts +0 -240
- package/src/core/task/task-projector.ts +0 -358
- package/src/core/task/task-resolver.ts +0 -421
- package/src/core/turn-state.ts +0 -207
- package/src/core/types.ts +0 -952
- package/src/core/vector-outbox.ts +0 -299
- package/src/core/vector-store.ts +0 -231
- package/src/core/vector-worker.ts +0 -521
- package/src/core/working-set-store.ts +0 -257
- package/src/extensions/endless-memory/endless-memory-services.ts +0 -350
- package/src/extensions/endless-memory/index.ts +0 -1
- package/src/extensions/index.ts +0 -5
- package/src/extensions/mcp/handlers.ts +0 -960
- package/src/extensions/mcp/index.ts +0 -48
- package/src/extensions/mcp/tools.ts +0 -252
- package/src/extensions/shared-memory/index.ts +0 -1
- package/src/extensions/shared-memory/shared-memory-services.ts +0 -211
- package/src/extensions/vector/embedder.ts +0 -233
- package/src/extensions/vector/index.ts +0 -1
- package/src/hooks/post-tool-use.ts +0 -9
- package/src/hooks/semantic-daemon-client.ts +0 -1
- package/src/hooks/semantic-daemon.ts +0 -11
- package/src/hooks/session-end.ts +0 -9
- package/src/hooks/session-start.ts +0 -9
- package/src/hooks/stop.ts +0 -9
- package/src/hooks/user-prompt-submit.ts +0 -9
- package/src/index.ts +0 -13
- package/src/mcp/handlers.ts +0 -2
- package/src/mcp/index.ts +0 -4
- package/src/mcp/tools.ts +0 -2
- package/src/server/api/chat.ts +0 -2
- package/src/server/api/citations.ts +0 -2
- package/src/server/api/events.ts +0 -2
- package/src/server/api/health.ts +0 -2
- package/src/server/api/index.ts +0 -2
- package/src/server/api/projects.ts +0 -2
- package/src/server/api/search.ts +0 -2
- package/src/server/api/sessions.ts +0 -2
- package/src/server/api/stats.ts +0 -2
- package/src/server/api/turns.ts +0 -2
- package/src/server/api/utils.ts +0 -2
- package/src/server/index.ts +0 -2
- package/src/services/bootstrap-organizer.ts +0 -463
- package/src/services/codex-session-history-importer.ts +0 -966
- package/src/services/hermes-session-history-importer.ts +0 -733
- package/src/services/memory-service-config.ts +0 -36
- package/src/services/memory-service-registry.ts +0 -150
- package/src/services/memory-service.ts +0 -688
- package/src/services/session-history-importer.ts +0 -629
- package/tests/README.md +0 -23
- package/tests/adapters/claude/claude-semantic-daemon-adapter.test.ts +0 -54
- package/tests/adapters/claude/claude-transcript-reconstructor.test.ts +0 -98
- package/tests/adapters/claude-hook-prompt-injection-policy.test.ts +0 -99
- package/tests/apps/app-layer-boundary.test.ts +0 -48
- package/tests/apps/claude-settings-hooks.test.ts +0 -107
- package/tests/apps/cli-disclosure-output.test.ts +0 -212
- package/tests/apps/codex-import-runner.test.ts +0 -99
- package/tests/apps/codex-validation-output.test.ts +0 -100
- package/tests/apps/hermes-import-runner.test.ts +0 -99
- package/tests/apps/mcp-install-command.test.ts +0 -59
- package/tests/apps/package-build-entrypoints.test.ts +0 -30
- package/tests/apps/postinstall-embedding-backend.test.ts +0 -175
- package/tests/apps/search-api-disclosure.test.ts +0 -162
- package/tests/apps/stats-api-lightweight.test.ts +0 -67
- package/tests/apps/ui-disclosure-output.test.ts +0 -140
- package/tests/core/bootstrap-organizer.test.ts +0 -111
- package/tests/core/canonical-key.test.ts +0 -101
- package/tests/core/codex-session-history-importer-validation.test.ts +0 -185
- package/tests/core/consolidation-worker.test.ts +0 -75
- package/tests/core/embedding-maintenance-service.test.ts +0 -282
- package/tests/core/evidence-aligner.test.ts +0 -152
- package/tests/core/external-market-context.test.ts +0 -209
- package/tests/core/fact-deriver.test.ts +0 -79
- package/tests/core/hermes-session-history-importer-validation.test.ts +0 -609
- package/tests/core/ingest-interceptor.test.ts +0 -38
- package/tests/core/markdown-mirror.test.ts +0 -85
- package/tests/core/matcher.test.ts +0 -112
- package/tests/core/md-mirror.test.ts +0 -50
- package/tests/core/memory-engine-services.test.ts +0 -240
- package/tests/core/memory-ingest-service.test.ts +0 -296
- package/tests/core/memory-query-service.test.ts +0 -129
- package/tests/core/memory-runtime-service.test.ts +0 -201
- package/tests/core/memory-service-composition.test.ts +0 -192
- package/tests/core/memory-service-config.test.ts +0 -41
- package/tests/core/memory-service-facade.test.ts +0 -30
- package/tests/core/memory-service-registry.test.ts +0 -206
- package/tests/core/product-validation-matrix.test.ts +0 -61
- package/tests/core/project-registry.test.ts +0 -78
- package/tests/core/replay-evaluator.test.ts +0 -181
- package/tests/core/retrieval-analytics-service.test.ts +0 -210
- package/tests/core/retrieval-benchmark.test.ts +0 -93
- package/tests/core/retrieval-disclosure-service.test.ts +0 -264
- package/tests/core/retrieval-orchestrator.test.ts +0 -403
- package/tests/core/retrieval-quality.test.ts +0 -31
- package/tests/core/retrieval-services.test.ts +0 -185
- package/tests/core/retriever-fallback-chain.test.ts +0 -223
- package/tests/core/retriever-strategy-scope.test.ts +0 -164
- package/tests/core/retriever.memu-adoption.test.ts +0 -122
- package/tests/core/session-history-importer-filter.test.ts +0 -78
- package/tests/core/session-qrels.test.ts +0 -250
- package/tests/core/sqlite-event-store-replication.test.ts +0 -127
- package/tests/core/summary-deriver.test.ts +0 -66
- package/tests/extensions/embedder-warning-suppression.test.ts +0 -83
- package/tests/extensions/endless-memory-extension-boundary.test.ts +0 -17
- package/tests/extensions/endless-memory-services.test.ts +0 -325
- package/tests/extensions/mcp-context-tools.test.ts +0 -905
- package/tests/extensions/mcp-extension-boundary.test.ts +0 -21
- package/tests/extensions/mcp-package-build.test.ts +0 -22
- package/tests/extensions/mcp-project-aware-tools.test.ts +0 -102
- package/tests/extensions/shared-memory-extension-boundary.test.ts +0 -24
- package/tests/extensions/shared-memory-services.test.ts +0 -309
- package/tests/extensions/vector-extension-boundary.test.ts +0 -21
- package/tsconfig.json +0 -24
- package/vitest.config.ts +0 -15
|
@@ -1,296 +0,0 @@
|
|
|
1
|
-
import { describe, expect, it, vi } from 'vitest';
|
|
2
|
-
|
|
3
|
-
import { MemoryIngestService } from '../../src/core/engine/memory-ingest-service.js';
|
|
4
|
-
import type { AppendResult, MemoryEvent, MemoryEventInput, ToolObservationPayload } from '../../src/core/types.js';
|
|
5
|
-
|
|
6
|
-
function event(overrides: Partial<MemoryEvent>): MemoryEvent {
|
|
7
|
-
return {
|
|
8
|
-
id: '11111111-1111-4111-8111-111111111111',
|
|
9
|
-
eventType: 'user_prompt',
|
|
10
|
-
sessionId: 'session-1',
|
|
11
|
-
timestamp: new Date('2026-04-30T00:00:00.000Z'),
|
|
12
|
-
content: 'default content',
|
|
13
|
-
canonicalKey: 'default-content',
|
|
14
|
-
dedupeKey: 'session-1:default-content',
|
|
15
|
-
metadata: {},
|
|
16
|
-
...overrides
|
|
17
|
-
};
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
interface CreateServiceOptions {
|
|
21
|
-
eventsBySession?: Record<string, MemoryEvent[]>;
|
|
22
|
-
projectHash?: string | null;
|
|
23
|
-
projectPath?: string | null;
|
|
24
|
-
appendResult?: AppendResult;
|
|
25
|
-
}
|
|
26
|
-
|
|
27
|
-
function createService(options: CreateServiceOptions = {}) {
|
|
28
|
-
const eventsBySession = options.eventsBySession ?? {};
|
|
29
|
-
const appended: MemoryEventInput[] = [];
|
|
30
|
-
const initialize = vi.fn(async () => {});
|
|
31
|
-
const store = {
|
|
32
|
-
upsertSession: vi.fn(async () => {}),
|
|
33
|
-
getSessionEvents: vi.fn(async (sessionId: string) => eventsBySession[sessionId] ?? []),
|
|
34
|
-
getSessionsWithoutSummary: vi.fn(async () => Object.keys(eventsBySession)),
|
|
35
|
-
append: vi.fn(async (input: MemoryEventInput): Promise<AppendResult> => {
|
|
36
|
-
appended.push(input);
|
|
37
|
-
return options.appendResult ?? { success: true, eventId: `event-${appended.length}`, isDuplicate: false };
|
|
38
|
-
}),
|
|
39
|
-
enqueueForEmbedding: vi.fn(async (_eventId: string, _content: string) => {})
|
|
40
|
-
};
|
|
41
|
-
const markdownMirror = {
|
|
42
|
-
append: vi.fn(async (_input: MemoryEventInput, _eventId?: string) => {})
|
|
43
|
-
};
|
|
44
|
-
const createToolEmbedding = vi.fn((payload: ToolObservationPayload) => `${payload.toolName}:${payload.success}`);
|
|
45
|
-
|
|
46
|
-
return {
|
|
47
|
-
service: new MemoryIngestService({
|
|
48
|
-
initialize,
|
|
49
|
-
eventStore: store,
|
|
50
|
-
markdownMirror,
|
|
51
|
-
createToolEmbedding,
|
|
52
|
-
getProjectHash: () => options.projectHash ?? null,
|
|
53
|
-
getProjectPath: () => options.projectPath ?? null
|
|
54
|
-
}),
|
|
55
|
-
initialize,
|
|
56
|
-
store,
|
|
57
|
-
markdownMirror,
|
|
58
|
-
createToolEmbedding,
|
|
59
|
-
appended
|
|
60
|
-
};
|
|
61
|
-
}
|
|
62
|
-
|
|
63
|
-
describe('MemoryIngestService ingest pipeline', () => {
|
|
64
|
-
it('normalizes metadata, runs interceptors, appends, enqueues embeddings, and mirrors successful events', async () => {
|
|
65
|
-
const { service, store, markdownMirror, appended } = createService({
|
|
66
|
-
projectHash: 'project-hash-1',
|
|
67
|
-
projectPath: '/workspace/project'
|
|
68
|
-
});
|
|
69
|
-
const stages: string[] = [];
|
|
70
|
-
|
|
71
|
-
service.registerIngestBefore((context) => {
|
|
72
|
-
stages.push(`${context.stage}:${context.operation}`);
|
|
73
|
-
expect(context.sessionId).toBe('session-1');
|
|
74
|
-
expect(context.event.metadata).toMatchObject({
|
|
75
|
-
ingest: { operation: 'user_prompt', pipeline: 'default' },
|
|
76
|
-
scope: {
|
|
77
|
-
project: { hash: 'project-hash-1', path: '/workspace/project' },
|
|
78
|
-
turn: { id: 'turn-1' }
|
|
79
|
-
},
|
|
80
|
-
tags: ['user:alice', 'legacy', 'proj:project-hash-1']
|
|
81
|
-
});
|
|
82
|
-
});
|
|
83
|
-
service.registerIngestAfter((context) => {
|
|
84
|
-
stages.push(`${context.stage}:${context.operation}`);
|
|
85
|
-
expect(context.event).toBe(appended[0]);
|
|
86
|
-
});
|
|
87
|
-
|
|
88
|
-
const result = await service.storeUserPrompt('session-1', 'remember this', {
|
|
89
|
-
scope: { turn: { id: 'turn-1' } },
|
|
90
|
-
tags: [' user:alice ', 'bad:tag', 'legacy']
|
|
91
|
-
});
|
|
92
|
-
|
|
93
|
-
expect(result).toEqual({ success: true, eventId: 'event-1', isDuplicate: false });
|
|
94
|
-
expect(store.append).toHaveBeenCalledOnce();
|
|
95
|
-
expect(appended[0]).toMatchObject({
|
|
96
|
-
eventType: 'user_prompt',
|
|
97
|
-
sessionId: 'session-1',
|
|
98
|
-
content: 'remember this',
|
|
99
|
-
metadata: {
|
|
100
|
-
ingest: { operation: 'user_prompt', pipeline: 'default' },
|
|
101
|
-
scope: {
|
|
102
|
-
project: { hash: 'project-hash-1', path: '/workspace/project' },
|
|
103
|
-
turn: { id: 'turn-1' }
|
|
104
|
-
},
|
|
105
|
-
tags: ['user:alice', 'legacy', 'proj:project-hash-1']
|
|
106
|
-
}
|
|
107
|
-
});
|
|
108
|
-
expect((appended[0].metadata as Record<string, unknown>).ingest).toMatchObject({
|
|
109
|
-
ts: expect.any(String)
|
|
110
|
-
});
|
|
111
|
-
expect(store.enqueueForEmbedding).toHaveBeenCalledWith('event-1', 'remember this');
|
|
112
|
-
expect(markdownMirror.append).toHaveBeenCalledWith(appended[0], 'event-1');
|
|
113
|
-
expect(stages).toEqual(['before:user_prompt', 'after:user_prompt']);
|
|
114
|
-
});
|
|
115
|
-
|
|
116
|
-
it('does not enqueue embeddings or mirror duplicate append results', async () => {
|
|
117
|
-
const { service, store, markdownMirror } = createService({
|
|
118
|
-
appendResult: { success: true, eventId: 'duplicate-event', isDuplicate: true }
|
|
119
|
-
});
|
|
120
|
-
|
|
121
|
-
await expect(service.storeAgentResponse('session-1', 'duplicate response')).resolves.toEqual({
|
|
122
|
-
success: true,
|
|
123
|
-
eventId: 'duplicate-event',
|
|
124
|
-
isDuplicate: true
|
|
125
|
-
});
|
|
126
|
-
|
|
127
|
-
expect(store.enqueueForEmbedding).not.toHaveBeenCalled();
|
|
128
|
-
expect(markdownMirror.append).not.toHaveBeenCalled();
|
|
129
|
-
});
|
|
130
|
-
|
|
131
|
-
it('keeps markdown mirror failures non-breaking after a successful append', async () => {
|
|
132
|
-
const { service, store, markdownMirror } = createService();
|
|
133
|
-
markdownMirror.append.mockRejectedValueOnce(new Error('mirror is read-only'));
|
|
134
|
-
|
|
135
|
-
await expect(service.storeSessionSummary('session-1', 'summary')).resolves.toEqual({
|
|
136
|
-
success: true,
|
|
137
|
-
eventId: 'event-1',
|
|
138
|
-
isDuplicate: false
|
|
139
|
-
});
|
|
140
|
-
|
|
141
|
-
expect(store.enqueueForEmbedding).toHaveBeenCalledWith('event-1', 'summary');
|
|
142
|
-
expect(markdownMirror.append).toHaveBeenCalledOnce();
|
|
143
|
-
});
|
|
144
|
-
|
|
145
|
-
it('runs error interceptors and skips side effects when append returns a failure result', async () => {
|
|
146
|
-
const { service, store, markdownMirror } = createService({
|
|
147
|
-
appendResult: { success: false, error: 'sqlite append failed' }
|
|
148
|
-
});
|
|
149
|
-
const stages: string[] = [];
|
|
150
|
-
const errors: Error[] = [];
|
|
151
|
-
service.registerIngestAfter((context) => {
|
|
152
|
-
stages.push(context.stage);
|
|
153
|
-
});
|
|
154
|
-
service.registerIngestOnError((context) => {
|
|
155
|
-
stages.push(context.stage);
|
|
156
|
-
errors.push(context.error!);
|
|
157
|
-
expect(context.operation).toBe('agent_response');
|
|
158
|
-
expect(context.event.eventType).toBe('agent_response');
|
|
159
|
-
});
|
|
160
|
-
|
|
161
|
-
await expect(service.storeAgentResponse('session-1', 'failed append')).resolves.toEqual({
|
|
162
|
-
success: false,
|
|
163
|
-
error: 'sqlite append failed'
|
|
164
|
-
});
|
|
165
|
-
|
|
166
|
-
expect(errors.map((error) => error.message)).toEqual(['sqlite append failed']);
|
|
167
|
-
expect(stages).toEqual(['error']);
|
|
168
|
-
expect(store.enqueueForEmbedding).not.toHaveBeenCalled();
|
|
169
|
-
expect(markdownMirror.append).not.toHaveBeenCalled();
|
|
170
|
-
});
|
|
171
|
-
|
|
172
|
-
it('runs error interceptors and skips side effects when append throws', async () => {
|
|
173
|
-
const { service, store, markdownMirror } = createService();
|
|
174
|
-
const error = new Error('sqlite unavailable');
|
|
175
|
-
store.append.mockRejectedValueOnce(error);
|
|
176
|
-
const errors: Error[] = [];
|
|
177
|
-
service.registerIngestOnError((context) => {
|
|
178
|
-
errors.push(context.error!);
|
|
179
|
-
expect(context.stage).toBe('error');
|
|
180
|
-
expect(context.operation).toBe('tool_observation');
|
|
181
|
-
expect(context.event.eventType).toBe('tool_observation');
|
|
182
|
-
});
|
|
183
|
-
|
|
184
|
-
await expect(service.storeToolObservation('session-1', {
|
|
185
|
-
toolName: 'terminal',
|
|
186
|
-
success: false,
|
|
187
|
-
metadata: { turnId: 'turn-2' },
|
|
188
|
-
output: 'failed'
|
|
189
|
-
})).rejects.toThrow('sqlite unavailable');
|
|
190
|
-
|
|
191
|
-
expect(errors).toEqual([error]);
|
|
192
|
-
expect(store.enqueueForEmbedding).not.toHaveBeenCalled();
|
|
193
|
-
expect(markdownMirror.append).not.toHaveBeenCalled();
|
|
194
|
-
});
|
|
195
|
-
});
|
|
196
|
-
|
|
197
|
-
describe('MemoryIngestService session summary generation', () => {
|
|
198
|
-
it('generates the legacy rule-based summary and stores it through the ingest pipeline', async () => {
|
|
199
|
-
const { service, initialize, store, appended } = createService({
|
|
200
|
-
eventsBySession: {
|
|
201
|
-
'session-1': [
|
|
202
|
-
event({ id: '11111111-1111-4111-8111-111111111111', eventType: 'user_prompt', content: '첫 번째 작업 요청\n자세한 설명', timestamp: new Date('2026-04-30T01:00:00.000Z') }),
|
|
203
|
-
event({ id: '22222222-2222-4222-8222-222222222222', eventType: 'agent_response', content: '응답', timestamp: new Date('2026-04-30T01:01:00.000Z') }),
|
|
204
|
-
event({ id: '33333333-3333-4333-8333-333333333333', eventType: 'tool_observation', content: '{}', timestamp: new Date('2026-04-30T01:02:00.000Z'), metadata: { toolName: 'terminal', exitCode: 1 } }),
|
|
205
|
-
event({ id: '44444444-4444-4444-8444-444444444444', eventType: 'tool_observation', content: '{}', timestamp: new Date('2026-04-30T01:03:00.000Z'), metadata: { toolName: 'terminal', exitCode: 0 } }),
|
|
206
|
-
event({ id: '55555555-5555-4555-8555-555555555555', eventType: 'user_prompt', content: '두 번째 요청', timestamp: new Date('2026-04-30T01:04:00.000Z') })
|
|
207
|
-
]
|
|
208
|
-
}
|
|
209
|
-
});
|
|
210
|
-
|
|
211
|
-
await service.generateSessionSummary('session-1');
|
|
212
|
-
|
|
213
|
-
expect(initialize).toHaveBeenCalledOnce();
|
|
214
|
-
expect(store.getSessionEvents).toHaveBeenCalledWith('session-1');
|
|
215
|
-
expect(appended).toHaveLength(1);
|
|
216
|
-
expect(store.enqueueForEmbedding).toHaveBeenCalledWith(
|
|
217
|
-
'event-1',
|
|
218
|
-
'[2026-04-30] 2턴 세션. 주요 작업: 첫 번째 작업 요청 자세한 설명. 사용 툴: terminal. 오류 1건 발생'
|
|
219
|
-
);
|
|
220
|
-
expect(appended[0]).toMatchObject({
|
|
221
|
-
eventType: 'session_summary',
|
|
222
|
-
sessionId: 'session-1',
|
|
223
|
-
content: '[2026-04-30] 2턴 세션. 주요 작업: 첫 번째 작업 요청 자세한 설명. 사용 툴: terminal. 오류 1건 발생',
|
|
224
|
-
metadata: {
|
|
225
|
-
ingest: { operation: 'session_summary', pipeline: 'default' },
|
|
226
|
-
generated: 'rule-based',
|
|
227
|
-
eventCount: 5
|
|
228
|
-
}
|
|
229
|
-
});
|
|
230
|
-
});
|
|
231
|
-
|
|
232
|
-
it('does not create another summary for too-short or already summarized sessions', async () => {
|
|
233
|
-
const { service, appended } = createService({
|
|
234
|
-
eventsBySession: {
|
|
235
|
-
short: [
|
|
236
|
-
event({ id: '11111111-1111-4111-8111-111111111111', sessionId: 'short' }),
|
|
237
|
-
event({ id: '22222222-2222-4222-8222-222222222222', sessionId: 'short', eventType: 'agent_response' })
|
|
238
|
-
],
|
|
239
|
-
summarized: [
|
|
240
|
-
event({ id: '33333333-3333-4333-8333-333333333333', sessionId: 'summarized' }),
|
|
241
|
-
event({ id: '44444444-4444-4444-8444-444444444444', sessionId: 'summarized', eventType: 'agent_response' }),
|
|
242
|
-
event({ id: '55555555-5555-4555-8555-555555555555', sessionId: 'summarized', eventType: 'session_summary', content: 'already summarized' })
|
|
243
|
-
]
|
|
244
|
-
}
|
|
245
|
-
});
|
|
246
|
-
|
|
247
|
-
await service.generateSessionSummary('short');
|
|
248
|
-
await service.generateSessionSummary('summarized');
|
|
249
|
-
|
|
250
|
-
expect(appended).toEqual([]);
|
|
251
|
-
});
|
|
252
|
-
|
|
253
|
-
it('backfills only missing summary candidates and keeps failures non-critical', async () => {
|
|
254
|
-
const { service, store, appended } = createService({
|
|
255
|
-
eventsBySession: {
|
|
256
|
-
candidate: [
|
|
257
|
-
event({ id: '11111111-1111-4111-8111-111111111111', sessionId: 'candidate', eventType: 'user_prompt', content: '분석 작업' }),
|
|
258
|
-
event({ id: '22222222-2222-4222-8222-222222222222', sessionId: 'candidate', eventType: 'agent_response', content: '응답' }),
|
|
259
|
-
event({ id: '33333333-3333-4333-8333-333333333333', sessionId: 'candidate', eventType: 'tool_observation', content: '{}', metadata: { toolName: 'read_file' } })
|
|
260
|
-
],
|
|
261
|
-
tooShort: [
|
|
262
|
-
event({ id: '44444444-4444-4444-8444-444444444444', sessionId: 'tooShort', eventType: 'user_prompt' })
|
|
263
|
-
],
|
|
264
|
-
broken: [
|
|
265
|
-
event({ id: '55555555-5555-4555-8555-555555555555', sessionId: 'broken', eventType: 'user_prompt' }),
|
|
266
|
-
event({ id: '66666666-6666-4666-8666-666666666666', sessionId: 'broken', eventType: 'agent_response' }),
|
|
267
|
-
event({ id: '77777777-7777-4777-8777-777777777777', sessionId: 'broken', eventType: 'tool_observation' })
|
|
268
|
-
]
|
|
269
|
-
}
|
|
270
|
-
});
|
|
271
|
-
store.getSessionsWithoutSummary.mockResolvedValueOnce(['candidate', 'tooShort', 'broken']);
|
|
272
|
-
store.getSessionEvents.mockImplementation(async (sessionId: string) => {
|
|
273
|
-
if (sessionId === 'broken') throw new Error('corrupt session');
|
|
274
|
-
return (store as any).__eventsBySession?.[sessionId] ?? [];
|
|
275
|
-
});
|
|
276
|
-
(store as any).__eventsBySession = {
|
|
277
|
-
candidate: [
|
|
278
|
-
event({ id: '11111111-1111-4111-8111-111111111111', sessionId: 'candidate', eventType: 'user_prompt', content: '분석 작업' }),
|
|
279
|
-
event({ id: '22222222-2222-4222-8222-222222222222', sessionId: 'candidate', eventType: 'agent_response', content: '응답' }),
|
|
280
|
-
event({ id: '33333333-3333-4333-8333-333333333333', sessionId: 'candidate', eventType: 'tool_observation', content: '{}', metadata: { toolName: 'read_file' } })
|
|
281
|
-
],
|
|
282
|
-
tooShort: [
|
|
283
|
-
event({ id: '44444444-4444-4444-8444-444444444444', sessionId: 'tooShort', eventType: 'user_prompt' })
|
|
284
|
-
]
|
|
285
|
-
};
|
|
286
|
-
|
|
287
|
-
await expect(service.backfillMissingSummaries('current-session', 7)).resolves.toBeUndefined();
|
|
288
|
-
|
|
289
|
-
expect(store.getSessionsWithoutSummary).toHaveBeenCalledWith('current-session', 7);
|
|
290
|
-
expect(store.getSessionEvents).toHaveBeenCalledWith('candidate');
|
|
291
|
-
expect(store.getSessionEvents).toHaveBeenCalledWith('tooShort');
|
|
292
|
-
expect(store.getSessionEvents).toHaveBeenCalledWith('broken');
|
|
293
|
-
expect(appended).toHaveLength(1);
|
|
294
|
-
expect(appended[0].sessionId).toBe('candidate');
|
|
295
|
-
});
|
|
296
|
-
});
|
|
@@ -1,129 +0,0 @@
|
|
|
1
|
-
import { describe, expect, it, vi } from 'vitest';
|
|
2
|
-
|
|
3
|
-
import { MemoryQueryService } from '../../src/core/engine/memory-query-service.js';
|
|
4
|
-
import type { MemoryEvent } from '../../src/core/types.js';
|
|
5
|
-
|
|
6
|
-
function event(overrides: Partial<MemoryEvent> = {}): MemoryEvent {
|
|
7
|
-
return {
|
|
8
|
-
id: '11111111-1111-4111-8111-111111111111',
|
|
9
|
-
eventType: 'user_prompt',
|
|
10
|
-
sessionId: 'session-1',
|
|
11
|
-
timestamp: new Date('2026-05-02T00:00:00.000Z'),
|
|
12
|
-
content: 'default content',
|
|
13
|
-
canonicalKey: 'default-content',
|
|
14
|
-
dedupeKey: 'session-1:default-content',
|
|
15
|
-
metadata: {},
|
|
16
|
-
...overrides
|
|
17
|
-
};
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
function createService() {
|
|
21
|
-
const initialize = vi.fn(async () => {});
|
|
22
|
-
const events = [event()];
|
|
23
|
-
const turn = {
|
|
24
|
-
turnId: 'turn-1',
|
|
25
|
-
events,
|
|
26
|
-
startedAt: new Date('2026-05-02T00:00:00.000Z'),
|
|
27
|
-
promptPreview: 'default content',
|
|
28
|
-
eventCount: 1,
|
|
29
|
-
toolCount: 0,
|
|
30
|
-
hasResponse: false
|
|
31
|
-
};
|
|
32
|
-
const outboxStats = {
|
|
33
|
-
embedding: { pending: 1, processing: 2, failed: 3, total: 6 },
|
|
34
|
-
vector: { pending: 4, processing: 5, failed: 6, total: 15 }
|
|
35
|
-
};
|
|
36
|
-
const queryStore = {
|
|
37
|
-
keywordSearch: vi.fn(async () => [{ event: events[0], rank: -0.5 }]),
|
|
38
|
-
getSessionEvents: vi.fn(async () => events),
|
|
39
|
-
getRecentEvents: vi.fn(async () => events),
|
|
40
|
-
rebuildFtsIndex: vi.fn(async () => 7),
|
|
41
|
-
getOutboxStats: vi.fn(async () => outboxStats),
|
|
42
|
-
getEventsByLevel: vi.fn(async () => events),
|
|
43
|
-
getEventLevel: vi.fn(async () => 'working'),
|
|
44
|
-
getSessionTurns: vi.fn(async () => [turn]),
|
|
45
|
-
getEventsByTurn: vi.fn(async () => events),
|
|
46
|
-
countSessionTurns: vi.fn(async () => 11),
|
|
47
|
-
backfillTurnIds: vi.fn(async () => 13),
|
|
48
|
-
deleteSessionEvents: vi.fn(async () => 17)
|
|
49
|
-
};
|
|
50
|
-
const vectorStore = {
|
|
51
|
-
count: vi.fn(async () => 19)
|
|
52
|
-
};
|
|
53
|
-
const graduation = {
|
|
54
|
-
getStats: vi.fn(async () => [{ level: 'working', count: 23 }])
|
|
55
|
-
};
|
|
56
|
-
|
|
57
|
-
return {
|
|
58
|
-
service: new MemoryQueryService(initialize, queryStore, { vectorStore, graduation }),
|
|
59
|
-
initialize,
|
|
60
|
-
queryStore,
|
|
61
|
-
vectorStore,
|
|
62
|
-
graduation,
|
|
63
|
-
events,
|
|
64
|
-
turn,
|
|
65
|
-
outboxStats
|
|
66
|
-
};
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
describe('MemoryQueryService', () => {
|
|
70
|
-
it('delegates read and maintenance methods through the initialized store boundary', async () => {
|
|
71
|
-
const { service, initialize, queryStore, events, turn, outboxStats } = createService();
|
|
72
|
-
|
|
73
|
-
await expect(service.rebuildFtsIndex()).resolves.toBe(7);
|
|
74
|
-
await expect(service.getOutboxStats()).resolves.toEqual(outboxStats);
|
|
75
|
-
await expect(service.getEventsByLevel('working', { limit: 2, offset: 3 })).resolves.toEqual(events);
|
|
76
|
-
await expect(service.getEventLevel('event-1')).resolves.toBe('working');
|
|
77
|
-
await expect(service.getSessionTurns('session-1', { limit: 5, offset: 8 })).resolves.toEqual([turn]);
|
|
78
|
-
await expect(service.getEventsByTurn('turn-1')).resolves.toEqual(events);
|
|
79
|
-
await expect(service.countSessionTurns('session-1')).resolves.toBe(11);
|
|
80
|
-
await expect(service.backfillTurnIds()).resolves.toBe(13);
|
|
81
|
-
await expect(service.deleteSessionEvents('session-1')).resolves.toBe(17);
|
|
82
|
-
|
|
83
|
-
expect(initialize).toHaveBeenCalledTimes(9);
|
|
84
|
-
expect(queryStore.rebuildFtsIndex).toHaveBeenCalledOnce();
|
|
85
|
-
expect(queryStore.getOutboxStats).toHaveBeenCalledOnce();
|
|
86
|
-
expect(queryStore.getEventsByLevel).toHaveBeenCalledWith('working', { limit: 2, offset: 3 });
|
|
87
|
-
expect(queryStore.getEventLevel).toHaveBeenCalledWith('event-1');
|
|
88
|
-
expect(queryStore.getSessionTurns).toHaveBeenCalledWith('session-1', { limit: 5, offset: 8 });
|
|
89
|
-
expect(queryStore.getEventsByTurn).toHaveBeenCalledWith('turn-1');
|
|
90
|
-
expect(queryStore.countSessionTurns).toHaveBeenCalledWith('session-1');
|
|
91
|
-
expect(queryStore.backfillTurnIds).toHaveBeenCalledOnce();
|
|
92
|
-
expect(queryStore.deleteSessionEvents).toHaveBeenCalledWith('session-1');
|
|
93
|
-
});
|
|
94
|
-
|
|
95
|
-
it('composes memory statistics from event, vector, and graduation stores', async () => {
|
|
96
|
-
const { service, initialize, queryStore, vectorStore, graduation } = createService();
|
|
97
|
-
|
|
98
|
-
await expect(service.getStats()).resolves.toEqual({
|
|
99
|
-
totalEvents: 1,
|
|
100
|
-
vectorCount: 19,
|
|
101
|
-
levelStats: [{ level: 'working', count: 23 }]
|
|
102
|
-
});
|
|
103
|
-
|
|
104
|
-
expect(initialize).toHaveBeenCalledOnce();
|
|
105
|
-
expect(queryStore.getRecentEvents).toHaveBeenCalledWith(10000);
|
|
106
|
-
expect(vectorStore.count).toHaveBeenCalledOnce();
|
|
107
|
-
expect(graduation.getStats).toHaveBeenCalledOnce();
|
|
108
|
-
});
|
|
109
|
-
|
|
110
|
-
it('keeps lightweight read methods usable with only the narrow query store', async () => {
|
|
111
|
-
const initialize = vi.fn(async () => {});
|
|
112
|
-
const events = [event({ id: '22222222-2222-4222-8222-222222222222' })];
|
|
113
|
-
const queryStore = {
|
|
114
|
-
keywordSearch: vi.fn(async () => [{ event: events[0], rank: -0.5 }]),
|
|
115
|
-
getSessionEvents: vi.fn(async () => events),
|
|
116
|
-
getRecentEvents: vi.fn(async () => events)
|
|
117
|
-
};
|
|
118
|
-
const service = new MemoryQueryService(initialize, queryStore);
|
|
119
|
-
|
|
120
|
-
await expect(service.keywordSearch('query', { topK: 3 })).resolves.toEqual([{ event: events[0], score: 1 }]);
|
|
121
|
-
await expect(service.getSessionHistory('session-1')).resolves.toBe(events);
|
|
122
|
-
await expect(service.getRecentEvents(2)).resolves.toBe(events);
|
|
123
|
-
|
|
124
|
-
expect(initialize).toHaveBeenCalledTimes(3);
|
|
125
|
-
expect(queryStore.keywordSearch).toHaveBeenCalledWith('query', 3);
|
|
126
|
-
expect(queryStore.getSessionEvents).toHaveBeenCalledWith('session-1');
|
|
127
|
-
expect(queryStore.getRecentEvents).toHaveBeenCalledWith(2);
|
|
128
|
-
});
|
|
129
|
-
});
|
|
@@ -1,201 +0,0 @@
|
|
|
1
|
-
import { describe, expect, it } from 'vitest';
|
|
2
|
-
|
|
3
|
-
import {
|
|
4
|
-
createMemoryRuntimeService,
|
|
5
|
-
type MemoryRuntimeServicesFactories
|
|
6
|
-
} from '../../src/core/engine/memory-runtime-service.js';
|
|
7
|
-
import type { EventStore } from '../../src/core/event-store.js';
|
|
8
|
-
import type { Embedder } from '../../src/core/embedder.js';
|
|
9
|
-
import type { GraduationPipeline } from '../../src/core/graduation.js';
|
|
10
|
-
import type { Retriever } from '../../src/core/retriever.js';
|
|
11
|
-
import type { VectorStore } from '../../src/core/vector-store.js';
|
|
12
|
-
|
|
13
|
-
function makeHarness(options?: { readOnly?: boolean; lightweightMode?: boolean; embeddingOnly?: boolean }) {
|
|
14
|
-
const calls: string[] = [];
|
|
15
|
-
const eventStore = { marker: 'event-store' } as unknown as EventStore;
|
|
16
|
-
const vectorStore = {
|
|
17
|
-
initialize: async () => { calls.push('vector.initialize'); }
|
|
18
|
-
} as unknown as VectorStore;
|
|
19
|
-
const embedder = {
|
|
20
|
-
initialize: async () => { calls.push('embedder.initialize'); }
|
|
21
|
-
} as unknown as Embedder;
|
|
22
|
-
const graduation = {
|
|
23
|
-
marker: 'graduation',
|
|
24
|
-
recordAccess: (eventId: string, sessionId: string, confidence: number = 1.0) => {
|
|
25
|
-
calls.push(`graduation.recordAccess:${eventId}:${sessionId}:${confidence}`);
|
|
26
|
-
}
|
|
27
|
-
} as unknown as GraduationPipeline;
|
|
28
|
-
const retriever = {
|
|
29
|
-
setGraduationPipeline: (pipeline: GraduationPipeline) => {
|
|
30
|
-
calls.push(pipeline === graduation ? 'retriever.setGraduationPipeline' : 'retriever.setGraduationPipeline:unknown');
|
|
31
|
-
}
|
|
32
|
-
} as unknown as Retriever;
|
|
33
|
-
|
|
34
|
-
const vectorWorker = {
|
|
35
|
-
start: () => { calls.push('vectorWorker.start'); },
|
|
36
|
-
stop: () => { calls.push('vectorWorker.stop'); },
|
|
37
|
-
processAll: async () => {
|
|
38
|
-
calls.push('vectorWorker.processAll');
|
|
39
|
-
return 3;
|
|
40
|
-
}
|
|
41
|
-
};
|
|
42
|
-
const graduationWorker = {
|
|
43
|
-
start: () => { calls.push('graduationWorker.start'); },
|
|
44
|
-
stop: () => { calls.push('graduationWorker.stop'); },
|
|
45
|
-
forceRun: async () => {
|
|
46
|
-
calls.push('graduationWorker.forceRun');
|
|
47
|
-
return { evaluated: 2, graduated: 1, byLevel: { L0: 1 } };
|
|
48
|
-
}
|
|
49
|
-
};
|
|
50
|
-
|
|
51
|
-
const factories: MemoryRuntimeServicesFactories = {
|
|
52
|
-
createVectorWorker: (receivedEventStore, receivedVectorStore, receivedEmbedder) => {
|
|
53
|
-
calls.push(
|
|
54
|
-
receivedEventStore === eventStore && receivedVectorStore === vectorStore && receivedEmbedder === embedder
|
|
55
|
-
? 'createVectorWorker'
|
|
56
|
-
: 'createVectorWorker:unknown'
|
|
57
|
-
);
|
|
58
|
-
return vectorWorker as unknown as ReturnType<NonNullable<MemoryRuntimeServicesFactories['createVectorWorker']>>;
|
|
59
|
-
},
|
|
60
|
-
createGraduationWorker: (receivedEventStore, receivedGraduation) => {
|
|
61
|
-
calls.push(
|
|
62
|
-
receivedEventStore === eventStore && receivedGraduation === graduation
|
|
63
|
-
? 'createGraduationWorker'
|
|
64
|
-
: 'createGraduationWorker:unknown'
|
|
65
|
-
);
|
|
66
|
-
return graduationWorker as unknown as ReturnType<NonNullable<MemoryRuntimeServicesFactories['createGraduationWorker']>>;
|
|
67
|
-
}
|
|
68
|
-
};
|
|
69
|
-
|
|
70
|
-
const service = createMemoryRuntimeService({
|
|
71
|
-
sqliteStore: {
|
|
72
|
-
initialize: async () => { calls.push('sqlite.initialize'); },
|
|
73
|
-
close: async () => { calls.push('sqlite.close'); }
|
|
74
|
-
},
|
|
75
|
-
eventStore,
|
|
76
|
-
vectorStore,
|
|
77
|
-
embedder,
|
|
78
|
-
retriever,
|
|
79
|
-
graduation,
|
|
80
|
-
endlessMemoryServices: {
|
|
81
|
-
initializeFromSavedMode: async () => { calls.push('endless.initializeFromSavedMode'); },
|
|
82
|
-
shutdown: () => { calls.push('endless.shutdown'); }
|
|
83
|
-
},
|
|
84
|
-
sharedMemoryServices: {
|
|
85
|
-
initialize: async () => { calls.push('shared.initialize'); },
|
|
86
|
-
close: async () => { calls.push('shared.close'); }
|
|
87
|
-
},
|
|
88
|
-
readOnly: options?.readOnly ?? false,
|
|
89
|
-
lightweightMode: options?.lightweightMode ?? false,
|
|
90
|
-
embeddingOnly: options?.embeddingOnly ?? false,
|
|
91
|
-
factories
|
|
92
|
-
});
|
|
93
|
-
|
|
94
|
-
return { service, calls, vectorWorker };
|
|
95
|
-
}
|
|
96
|
-
|
|
97
|
-
describe('createMemoryRuntimeService', () => {
|
|
98
|
-
it('initializes only sqlite in lightweight mode and keeps initialize idempotent', async () => {
|
|
99
|
-
const harness = makeHarness({ lightweightMode: true });
|
|
100
|
-
|
|
101
|
-
await harness.service.initialize();
|
|
102
|
-
await harness.service.initialize();
|
|
103
|
-
|
|
104
|
-
expect(harness.service.isInitialized()).toBe(true);
|
|
105
|
-
expect(harness.calls).toEqual(['sqlite.initialize']);
|
|
106
|
-
await expect(harness.service.processPendingEmbeddings()).resolves.toBe(0);
|
|
107
|
-
await expect(harness.service.forceGraduation()).resolves.toEqual({ evaluated: 0, graduated: 0, byLevel: {} });
|
|
108
|
-
});
|
|
109
|
-
|
|
110
|
-
it('records memory access through the graduation pipeline without initializing runtime workers', () => {
|
|
111
|
-
const harness = makeHarness();
|
|
112
|
-
|
|
113
|
-
harness.service.recordMemoryAccess('event-1', 'session-2', 0.42);
|
|
114
|
-
|
|
115
|
-
expect(harness.service.isInitialized()).toBe(false);
|
|
116
|
-
expect(harness.calls).toEqual(['graduation.recordAccess:event-1:session-2:0.42']);
|
|
117
|
-
});
|
|
118
|
-
|
|
119
|
-
it('starts vector and graduation workers plus writable lifecycle services by default', async () => {
|
|
120
|
-
const harness = makeHarness();
|
|
121
|
-
|
|
122
|
-
await harness.service.initialize();
|
|
123
|
-
|
|
124
|
-
expect(harness.calls).toEqual([
|
|
125
|
-
'sqlite.initialize',
|
|
126
|
-
'vector.initialize',
|
|
127
|
-
'embedder.initialize',
|
|
128
|
-
'createVectorWorker',
|
|
129
|
-
'vectorWorker.start',
|
|
130
|
-
'retriever.setGraduationPipeline',
|
|
131
|
-
'createGraduationWorker',
|
|
132
|
-
'graduationWorker.start',
|
|
133
|
-
'endless.initializeFromSavedMode',
|
|
134
|
-
'shared.initialize'
|
|
135
|
-
]);
|
|
136
|
-
expect(harness.service.getVectorWorker()).toBe(harness.vectorWorker);
|
|
137
|
-
await expect(harness.service.processPendingEmbeddings()).resolves.toBe(3);
|
|
138
|
-
await expect(harness.service.forceGraduation()).resolves.toEqual({ evaluated: 2, graduated: 1, byLevel: { L0: 1 } });
|
|
139
|
-
});
|
|
140
|
-
|
|
141
|
-
it('skips workers and write lifecycle services in read-only mode', async () => {
|
|
142
|
-
const harness = makeHarness({ readOnly: true });
|
|
143
|
-
|
|
144
|
-
await harness.service.initialize();
|
|
145
|
-
|
|
146
|
-
expect(harness.calls).toEqual([
|
|
147
|
-
'sqlite.initialize',
|
|
148
|
-
'vector.initialize',
|
|
149
|
-
'embedder.initialize'
|
|
150
|
-
]);
|
|
151
|
-
expect(harness.service.getVectorWorker()).toBeNull();
|
|
152
|
-
});
|
|
153
|
-
|
|
154
|
-
it('embedding-only mode starts vector worker but skips graduation worker', async () => {
|
|
155
|
-
const harness = makeHarness({ embeddingOnly: true });
|
|
156
|
-
|
|
157
|
-
await harness.service.initialize();
|
|
158
|
-
|
|
159
|
-
expect(harness.calls).toEqual([
|
|
160
|
-
'sqlite.initialize',
|
|
161
|
-
'vector.initialize',
|
|
162
|
-
'embedder.initialize',
|
|
163
|
-
'createVectorWorker',
|
|
164
|
-
'vectorWorker.start',
|
|
165
|
-
'endless.initializeFromSavedMode',
|
|
166
|
-
'shared.initialize'
|
|
167
|
-
]);
|
|
168
|
-
await expect(harness.service.forceGraduation()).resolves.toEqual({ evaluated: 0, graduated: 0, byLevel: {} });
|
|
169
|
-
});
|
|
170
|
-
|
|
171
|
-
it('returns a fresh empty graduation result when no graduation worker exists', async () => {
|
|
172
|
-
const harness = makeHarness({ embeddingOnly: true });
|
|
173
|
-
await harness.service.initialize();
|
|
174
|
-
|
|
175
|
-
const first = await harness.service.forceGraduation();
|
|
176
|
-
first.byLevel.L0 = 99;
|
|
177
|
-
first.evaluated = 99;
|
|
178
|
-
|
|
179
|
-
const second = await harness.service.forceGraduation();
|
|
180
|
-
|
|
181
|
-
expect(second).toEqual({ evaluated: 0, graduated: 0, byLevel: {} });
|
|
182
|
-
expect(second).not.toBe(first);
|
|
183
|
-
expect(second.byLevel).not.toBe(first.byLevel);
|
|
184
|
-
});
|
|
185
|
-
|
|
186
|
-
it('shuts down workers and backing services in the historical MemoryService order', async () => {
|
|
187
|
-
const harness = makeHarness();
|
|
188
|
-
await harness.service.initialize();
|
|
189
|
-
harness.calls.length = 0;
|
|
190
|
-
|
|
191
|
-
await harness.service.shutdown();
|
|
192
|
-
|
|
193
|
-
expect(harness.calls).toEqual([
|
|
194
|
-
'graduationWorker.stop',
|
|
195
|
-
'endless.shutdown',
|
|
196
|
-
'vectorWorker.stop',
|
|
197
|
-
'shared.close',
|
|
198
|
-
'sqlite.close'
|
|
199
|
-
]);
|
|
200
|
-
});
|
|
201
|
-
});
|