claude-memory-layer 1.0.26 → 1.0.28
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/.env.example +7 -0
- package/AGENTS.md +11 -0
- package/README.md +184 -41
- package/benchmarks/replay/anonymized-real-sessions.json +48 -0
- package/dist/cli/index.js +10097 -6003
- package/dist/cli/index.js.map +4 -4
- package/dist/core/index.js +9745 -5587
- package/dist/core/index.js.map +4 -4
- package/dist/hooks/post-tool-use.js +6545 -5270
- package/dist/hooks/post-tool-use.js.map +4 -4
- package/dist/hooks/semantic-daemon.js +6646 -5354
- package/dist/hooks/semantic-daemon.js.map +4 -4
- package/dist/hooks/session-end.js +6618 -5347
- package/dist/hooks/session-end.js.map +4 -4
- package/dist/hooks/session-start.js +6619 -5354
- package/dist/hooks/session-start.js.map +4 -4
- package/dist/hooks/stop.js +6614 -5325
- package/dist/hooks/stop.js.map +4 -4
- package/dist/hooks/user-prompt-submit.js +6702 -5356
- package/dist/hooks/user-prompt-submit.js.map +4 -4
- package/dist/index.js +13537 -0
- package/dist/index.js.map +7 -0
- package/dist/mcp/index.js +20770 -0
- package/dist/mcp/index.js.map +7 -0
- package/dist/server/api/index.js +6632 -5319
- package/dist/server/api/index.js.map +4 -4
- package/dist/server/index.js +6667 -5340
- package/dist/server/index.js.map +4 -4
- package/dist/services/memory-service.js +6568 -5350
- package/dist/services/memory-service.js.map +4 -4
- package/dist/ui/assets/js/bootstrap.js +244 -0
- package/dist/ui/assets/js/chat.js +373 -0
- package/dist/ui/assets/js/disclosure.js +232 -0
- package/dist/ui/assets/js/modals.js +298 -0
- package/dist/ui/assets/js/overview.js +655 -0
- package/dist/ui/assets/js/state.js +72 -0
- package/dist/ui/assets/js/views.js +468 -0
- package/dist/ui/index.html +43 -1
- package/dist/ui/index.ts +3 -0
- package/dist/ui/style.css +222 -0
- package/docs/ARCHITECTURE_COMPARISON_AND_RECOMMENDATIONS.md +627 -0
- package/docs/HERMES_MEMORY_INGESTION_ANALYSIS.md +440 -0
- package/docs/MEMORY_USEFULNESS_AUDIT.md +371 -0
- package/docs/MEMORY_USEFULNESS_AUDIT_RAW.json +80 -0
- package/docs/MEMSEARCH_PROJECT_STRUCTURE_ANALYSIS.md +333 -0
- package/docs/PRODUCT_VALIDATION_MATRIX.md +82 -0
- package/docs/PROJECT_STRUCTURE_ANALYSIS.md +421 -0
- package/docs/REFACTORING_MILESTONES_AND_ISSUES.md +501 -0
- package/docs/REFACTORING_PLAN_THIN_CORE.md +414 -0
- package/docs/REFERENCE_PROJECT_ANALYSES.md +25 -0
- package/docs/SUPERLOCALMEMORY_PROJECT_STRUCTURE_ANALYSIS.md +452 -0
- package/docs/TARGET_ARCHITECTURE_AND_FOLDER_STRUCTURE.md +446 -0
- package/docs/architecture/comparison-index.md +47 -0
- package/docs/reports/codex-real-data-validation-20260505T040447Z.md +46 -0
- package/package.json +9 -5
- package/scripts/build.ts +25 -8
- package/scripts/generate-session-qrels.ts +126 -0
- package/scripts/replay-retrieval-benchmark.ts +69 -0
- package/specs/thin-core-refactor/context.md +275 -0
- package/specs/thin-core-refactor/plan.md +536 -0
- package/specs/thin-core-refactor/spec.md +465 -0
- package/src/adapters/claude/capture/index.ts +3 -0
- package/src/adapters/claude/context/index.ts +3 -0
- package/src/adapters/claude/hooks/index.ts +21 -0
- package/src/adapters/claude/hooks/post-tool-use.ts +239 -0
- package/src/adapters/claude/hooks/prompt-injection-policy.ts +104 -0
- package/src/adapters/claude/hooks/semantic-daemon-client.ts +209 -0
- package/src/adapters/claude/hooks/semantic-daemon.ts +283 -0
- package/src/adapters/claude/hooks/session-end.ts +59 -0
- package/src/adapters/claude/hooks/session-start.ts +73 -0
- package/src/adapters/claude/hooks/stop.ts +128 -0
- package/src/adapters/claude/hooks/user-prompt-submit.ts +361 -0
- package/src/adapters/claude/index.ts +4 -0
- package/src/adapters/claude/transcript/index.ts +4 -0
- package/src/adapters/claude/transcript/transcript-reader.ts +57 -0
- package/src/adapters/claude/transcript/turn-reconstructor.ts +65 -0
- package/src/apps/cli/claude-settings-hooks.ts +138 -0
- package/src/apps/cli/codex-import-runner.ts +125 -0
- package/src/apps/cli/codex-validation-output.ts +95 -0
- package/src/apps/cli/hermes-import-runner.ts +130 -0
- package/src/apps/cli/hermes-validation-output.ts +91 -0
- package/src/apps/cli/index.ts +1731 -0
- package/src/apps/cli/mcp-install.ts +106 -0
- package/src/apps/cli/retrieval-disclosure-output.ts +196 -0
- package/src/apps/dashboard/assets/js/bootstrap.js +244 -0
- package/src/apps/dashboard/assets/js/chat.js +373 -0
- package/src/apps/dashboard/assets/js/disclosure.js +232 -0
- package/src/apps/dashboard/assets/js/modals.js +298 -0
- package/src/apps/dashboard/assets/js/overview.js +655 -0
- package/src/apps/dashboard/assets/js/state.js +72 -0
- package/src/apps/dashboard/assets/js/views.js +468 -0
- package/src/{ui → apps/dashboard}/index.html +43 -1
- package/src/apps/dashboard/index.ts +3 -0
- package/src/{ui → apps/dashboard}/style.css +222 -0
- package/src/apps/index.ts +5 -0
- package/src/apps/server/api/chat.ts +244 -0
- package/src/apps/server/api/citations.ts +105 -0
- package/src/apps/server/api/events.ts +137 -0
- package/src/apps/server/api/health.ts +53 -0
- package/src/apps/server/api/index.ts +26 -0
- package/src/apps/server/api/projects.ts +74 -0
- package/src/apps/server/api/search.ts +184 -0
- package/src/apps/server/api/sessions.ts +115 -0
- package/src/apps/server/api/stats.ts +723 -0
- package/src/apps/server/api/turns.ts +143 -0
- package/src/apps/server/api/utils.ts +65 -0
- package/src/apps/server/index.ts +111 -0
- package/src/cli/index.ts +2 -1311
- package/src/cli/retrieval-disclosure-output.ts +2 -0
- package/src/compat/index.ts +5 -0
- package/src/core/derive/fact-deriver.ts +170 -0
- package/src/core/derive/index.ts +2 -0
- package/src/core/derive/summary-deriver.ts +76 -0
- package/src/core/embedder.ts +4 -152
- package/src/core/engine/embedding-maintenance-service.ts +187 -0
- package/src/core/engine/endless-memory-services.ts +4 -0
- package/src/core/engine/index.ts +19 -0
- package/src/core/engine/memory-engine-services.ts +170 -0
- package/src/core/engine/memory-ingest-service.ts +317 -0
- package/src/core/engine/memory-query-service.ts +173 -0
- package/src/core/engine/memory-runtime-service.ts +162 -0
- package/src/core/engine/memory-service-composition.ts +231 -0
- package/src/core/engine/retrieval-analytics-service.ts +181 -0
- package/src/core/engine/retrieval-disclosure-service.ts +420 -0
- package/src/core/engine/retrieval-orchestrator.ts +377 -0
- package/src/core/engine/retrieval-services.ts +176 -0
- package/src/core/engine/shared-memory-services.ts +4 -0
- package/src/core/entity-repo.ts +1 -3
- package/src/core/event-store.ts +3 -3
- package/src/core/evidence-aligner.ts +2 -2
- package/src/core/external-market-context.ts +582 -0
- package/src/core/graduation.ts +2 -3
- package/src/core/index.ts +21 -0
- package/src/core/matcher.ts +2 -4
- package/src/core/model/memory-fact.ts +30 -0
- package/src/core/model/memory-rule.ts +14 -0
- package/src/core/model/memory-summary.ts +21 -0
- package/src/core/model/raw-event.ts +28 -0
- package/src/core/model/retrieval-result.ts +35 -0
- package/src/core/privacy/filter.ts +21 -10
- package/src/core/product-validation-matrix.ts +314 -0
- package/src/core/progressive-retriever.ts +1 -2
- package/src/core/registry/project-path.ts +54 -0
- package/src/core/registry/session-registry.ts +69 -0
- package/src/core/replay-evaluator.ts +625 -0
- package/src/core/retrieval-benchmark.ts +117 -0
- package/src/core/retrieval-quality.ts +109 -0
- package/src/core/retriever.ts +53 -15
- package/src/core/session-qrels.ts +360 -0
- package/src/core/shared-event-store.ts +1 -1
- package/src/core/sqlite-event-store.ts +35 -11
- package/src/core/task/blocker-resolver.ts +2 -2
- package/src/core/task/task-resolver.ts +0 -1
- package/src/core/vector-outbox.ts +1 -10
- package/src/core/vector-worker.ts +1 -1
- package/src/extensions/endless-memory/endless-memory-services.ts +350 -0
- package/src/extensions/endless-memory/index.ts +1 -0
- package/src/extensions/index.ts +5 -0
- package/src/extensions/mcp/handlers.ts +960 -0
- package/src/extensions/mcp/index.ts +48 -0
- package/src/extensions/mcp/tools.ts +252 -0
- package/src/extensions/shared-memory/index.ts +1 -0
- package/src/extensions/shared-memory/shared-memory-services.ts +211 -0
- package/src/extensions/vector/embedder.ts +197 -0
- package/src/extensions/vector/index.ts +1 -0
- package/src/hooks/post-tool-use.ts +3 -236
- package/src/hooks/semantic-daemon-client.ts +1 -208
- package/src/hooks/semantic-daemon.ts +6 -271
- package/src/hooks/session-end.ts +4 -79
- package/src/hooks/session-start.ts +4 -73
- package/src/hooks/stop.ts +3 -173
- package/src/hooks/user-prompt-submit.ts +3 -338
- package/src/index.ts +13 -0
- package/src/mcp/handlers.ts +2 -212
- package/src/mcp/index.ts +3 -46
- package/src/mcp/tools.ts +2 -78
- package/src/server/api/chat.ts +2 -244
- package/src/server/api/citations.ts +2 -105
- package/src/server/api/events.ts +2 -137
- package/src/server/api/health.ts +2 -53
- package/src/server/api/index.ts +2 -26
- package/src/server/api/projects.ts +2 -74
- package/src/server/api/search.ts +2 -102
- package/src/server/api/sessions.ts +2 -115
- package/src/server/api/stats.ts +2 -724
- package/src/server/api/turns.ts +2 -143
- package/src/server/api/utils.ts +2 -46
- package/src/server/index.ts +2 -100
- package/src/services/bootstrap-organizer.ts +46 -26
- package/src/services/codex-session-history-importer.ts +521 -29
- package/src/services/hermes-session-history-importer.ts +733 -0
- package/src/services/memory-service-config.ts +36 -0
- package/src/services/memory-service-registry.ts +150 -0
- package/src/services/memory-service.ts +211 -1325
- package/src/services/session-history-importer.ts +58 -14
- package/tests/README.md +23 -0
- package/tests/adapters/claude/claude-semantic-daemon-adapter.test.ts +54 -0
- package/tests/adapters/claude/claude-transcript-reconstructor.test.ts +98 -0
- package/tests/adapters/claude-hook-prompt-injection-policy.test.ts +99 -0
- package/tests/apps/app-layer-boundary.test.ts +48 -0
- package/tests/apps/claude-settings-hooks.test.ts +107 -0
- package/tests/apps/cli-disclosure-output.test.ts +212 -0
- package/tests/apps/codex-import-runner.test.ts +99 -0
- package/tests/apps/codex-validation-output.test.ts +100 -0
- package/tests/apps/hermes-import-runner.test.ts +99 -0
- package/tests/apps/mcp-install-command.test.ts +59 -0
- package/tests/apps/package-build-entrypoints.test.ts +30 -0
- package/tests/apps/search-api-disclosure.test.ts +162 -0
- package/tests/apps/stats-api-lightweight.test.ts +67 -0
- package/tests/apps/ui-disclosure-output.test.ts +140 -0
- package/tests/{bootstrap-organizer.test.ts → core/bootstrap-organizer.test.ts} +1 -1
- package/tests/{canonical-key.test.ts → core/canonical-key.test.ts} +1 -1
- package/tests/core/codex-session-history-importer-validation.test.ts +185 -0
- package/tests/{consolidation-worker.test.ts → core/consolidation-worker.test.ts} +2 -2
- package/tests/core/embedding-maintenance-service.test.ts +282 -0
- package/tests/{evidence-aligner.test.ts → core/evidence-aligner.test.ts} +1 -1
- package/tests/core/external-market-context.test.ts +209 -0
- package/tests/core/fact-deriver.test.ts +79 -0
- package/tests/core/hermes-session-history-importer-validation.test.ts +609 -0
- package/tests/{ingest-interceptor.test.ts → core/ingest-interceptor.test.ts} +1 -1
- package/tests/{markdown-mirror.test.ts → core/markdown-mirror.test.ts} +2 -2
- package/tests/{matcher.test.ts → core/matcher.test.ts} +1 -1
- package/tests/{md-mirror.test.ts → core/md-mirror.test.ts} +2 -2
- package/tests/core/memory-engine-services.test.ts +240 -0
- package/tests/core/memory-ingest-service.test.ts +296 -0
- package/tests/core/memory-query-service.test.ts +129 -0
- package/tests/core/memory-runtime-service.test.ts +201 -0
- package/tests/core/memory-service-composition.test.ts +192 -0
- package/tests/core/memory-service-config.test.ts +41 -0
- package/tests/core/memory-service-facade.test.ts +30 -0
- package/tests/core/memory-service-registry.test.ts +206 -0
- package/tests/core/product-validation-matrix.test.ts +61 -0
- package/tests/core/project-registry.test.ts +78 -0
- package/tests/core/replay-evaluator.test.ts +181 -0
- package/tests/core/retrieval-analytics-service.test.ts +210 -0
- package/tests/core/retrieval-benchmark.test.ts +93 -0
- package/tests/core/retrieval-disclosure-service.test.ts +264 -0
- package/tests/core/retrieval-orchestrator.test.ts +403 -0
- package/tests/core/retrieval-quality.test.ts +31 -0
- package/tests/core/retrieval-services.test.ts +185 -0
- package/tests/{retriever-fallback-chain.test.ts → core/retriever-fallback-chain.test.ts} +3 -3
- package/tests/{retriever-strategy-scope.test.ts → core/retriever-strategy-scope.test.ts} +70 -3
- package/tests/{retriever.memu-adoption.test.ts → core/retriever.memu-adoption.test.ts} +3 -3
- package/tests/core/session-history-importer-filter.test.ts +78 -0
- package/tests/core/session-qrels.test.ts +250 -0
- package/tests/{sqlite-event-store-replication.test.ts → core/sqlite-event-store-replication.test.ts} +36 -1
- package/tests/core/summary-deriver.test.ts +66 -0
- package/tests/extensions/embedder-warning-suppression.test.ts +53 -0
- package/tests/extensions/endless-memory-extension-boundary.test.ts +17 -0
- package/tests/extensions/endless-memory-services.test.ts +325 -0
- package/tests/extensions/mcp-context-tools.test.ts +905 -0
- package/tests/extensions/mcp-extension-boundary.test.ts +21 -0
- package/tests/extensions/mcp-package-build.test.ts +22 -0
- package/tests/extensions/mcp-project-aware-tools.test.ts +102 -0
- package/tests/extensions/shared-memory-extension-boundary.test.ts +24 -0
- package/tests/extensions/shared-memory-services.test.ts +309 -0
- package/tests/extensions/vector-extension-boundary.test.ts +21 -0
- package/.claude/settings.local.json +0 -25
- package/.npm-cache/_cacache/content-v2/sha512/04/76/c098f88dfe584a2b80870bff7421b05d17d3d9ee1027f77772332a22d3f93a9a57101a2855107f6ad82077a818bba912b2bc317f2361b5ddb09ad284d9ce +0 -0
- package/.npm-cache/_cacache/content-v2/sha512/60/25/d2ecd39cfc7cab58351162814be77f935c6d6491c10c3745d456da7ddb2117ffd90c10e53fe3c0f1ed16b403307841543634504398b16ee4e6b6dd8e0c45 +0 -0
- package/.npm-cache/_cacache/index-v5/2b/9a/7f8f40206ed8a2e0a84efaa953ccaed1f5d001e14b931083f2e7a0738007 +0 -2
- package/.npm-cache/_cacache/index-v5/2e/d9/fcfa5c6a6abdc2a3644ab84a95936047298c465a2f47ee03db8f7fe1e946 +0 -3
- package/.npm-cache/_cacache/index-v5/a9/42/e519633356d12d3d2f19da66a8301016d496c8f5c3e0554124aaa62dc043 +0 -2
- package/.npm-cache/_logs/2026-02-26T12_04_52_729Z-debug-0.log +0 -256
- package/.npm-cache/_logs/2026-02-26T12_05_36_835Z-debug-0.log +0 -18
- package/.npm-cache/_logs/2026-02-26T12_05_45_982Z-debug-0.log +0 -32
- package/.npm-cache/_logs/2026-02-26T12_05_48_515Z-debug-0.log +0 -260
- package/.npm-cache/_logs/2026-02-26T12_05_53_567Z-debug-0.log +0 -69
- package/.npm-cache/_update-notifier-last-checked +0 -0
- package/bootstrap-kb/decisions/decisions.md +0 -244
- package/bootstrap-kb/glossary/glossary.md +0 -46
- package/bootstrap-kb/modules/.claude-plugin.md +0 -22
- package/bootstrap-kb/modules/agents.md.md +0 -15
- package/bootstrap-kb/modules/claude.md.md +0 -15
- package/bootstrap-kb/modules/context.md.md +0 -15
- package/bootstrap-kb/modules/docs.md +0 -18
- package/bootstrap-kb/modules/handoff.md.md +0 -15
- package/bootstrap-kb/modules/package-lock.json.md +0 -15
- package/bootstrap-kb/modules/package.json.md +0 -15
- package/bootstrap-kb/modules/plan.md.md +0 -15
- package/bootstrap-kb/modules/readme.md.md +0 -15
- package/bootstrap-kb/modules/scripts.md +0 -26
- package/bootstrap-kb/modules/spec.md.md +0 -15
- package/bootstrap-kb/modules/specs.md +0 -20
- package/bootstrap-kb/modules/src.md +0 -51
- package/bootstrap-kb/modules/tests.md +0 -42
- package/bootstrap-kb/modules/tsconfig.json.md +0 -15
- package/bootstrap-kb/modules/vitest.config.ts.md +0 -15
- package/bootstrap-kb/overview/overview.md +0 -40
- package/bootstrap-kb/sources/manifest.json +0 -950
- package/bootstrap-kb/sources/manifest.md +0 -227
- package/bootstrap-kb/timeline/timeline.md +0 -57
- package/claude-memory-layer-1.0.14.tgz +0 -0
- package/d.sh +0 -3
- package/deploy.sh +0 -3
- package/dist/ui/app.js +0 -2101
- package/memory/.claude-plugin/commands/2026-02-25.md +0 -263
- package/memory/_index.md +0 -418
- package/memory/agent_response/uncategorized/2026-02-26.md +0 -176
- package/memory/agent_response/uncategorized/2026-03-03.md +0 -14
- package/memory/agent_response/uncategorized/2026-03-04.md +0 -1421
- package/memory/agent_response/uncategorized/2026-03-05.md +0 -48
- package/memory/default/uncategorized/2026-02-25.md +0 -4839
- package/memory/session_summary/uncategorized/2026-02-26.md +0 -13
- package/memory/session_summary/uncategorized/2026-03-03.md +0 -5
- package/memory/session_summary/uncategorized/2026-03-04.md +0 -50
- package/memory/specs/20260207-dashboard-upgrade/2026-02-25.md +0 -142
- package/memory/specs/citations-system/2026-02-25.md +0 -1121
- package/memory/specs/endless-mode/2026-02-25.md +0 -1392
- package/memory/specs/entity-edge-model/2026-02-25.md +0 -1263
- package/memory/specs/evidence-aligner-v2/2026-02-25.md +0 -1028
- package/memory/specs/mcp-desktop-integration/2026-02-25.md +0 -1334
- package/memory/specs/post-tool-use-hook/2026-02-25.md +0 -1164
- package/memory/specs/private-tags/2026-02-25.md +0 -1057
- package/memory/specs/progressive-disclosure/2026-02-25.md +0 -1436
- package/memory/specs/task-entity-system/2026-02-25.md +0 -924
- package/memory/specs/vector-outbox-v2/2026-02-25.md +0 -1510
- package/memory/specs/web-viewer-ui/2026-02-25.md +0 -1709
- package/memory/tool_observation/uncategorized/2026-02-26.md +0 -209
- package/memory/tool_observation/uncategorized/2026-03-03.md +0 -21
- package/memory/tool_observation/uncategorized/2026-03-04.md +0 -1033
- package/memory/tool_observation/uncategorized/2026-03-05.md +0 -29
- package/memory/user_prompt/uncategorized/2026-02-26.md +0 -25
- package/memory/user_prompt/uncategorized/2026-03-04.md +0 -634
- package/specs/optional-duckdb/context.md +0 -77
- package/specs/optional-duckdb/plan.md +0 -142
- package/specs/optional-duckdb/spec.md +0 -35
- package/src/ui/app.js +0 -2101
|
@@ -0,0 +1,212 @@
|
|
|
1
|
+
import { describe, expect, it } from 'vitest';
|
|
2
|
+
import {
|
|
3
|
+
formatDisclosureExpansion,
|
|
4
|
+
formatDisclosureSearch,
|
|
5
|
+
formatDisclosureSource,
|
|
6
|
+
formatPlainSearchResults
|
|
7
|
+
} from '../../src/apps/cli/retrieval-disclosure-output.js';
|
|
8
|
+
|
|
9
|
+
describe('retrieval disclosure CLI output', () => {
|
|
10
|
+
it('formats compact search envelopes with type badges, reasons, and source refs', () => {
|
|
11
|
+
const out = formatDisclosureSearch({
|
|
12
|
+
results: [
|
|
13
|
+
{
|
|
14
|
+
id: 'event:e1',
|
|
15
|
+
resultType: 'tool_evidence',
|
|
16
|
+
title: 'Tool evidence',
|
|
17
|
+
snippet: 'Applied checkout fix in src/cart.ts',
|
|
18
|
+
score: 0.91,
|
|
19
|
+
reasons: ['semantic_match', 'tool_followup'],
|
|
20
|
+
sourceRef: 'event:e1',
|
|
21
|
+
sessionId: 'session-1234567890'
|
|
22
|
+
}
|
|
23
|
+
],
|
|
24
|
+
meta: {
|
|
25
|
+
total: 1,
|
|
26
|
+
usedVector: true,
|
|
27
|
+
usedKeyword: true,
|
|
28
|
+
fallbackApplied: false
|
|
29
|
+
}
|
|
30
|
+
});
|
|
31
|
+
|
|
32
|
+
expect(out).toContain('🔎 Progressive Search Results');
|
|
33
|
+
expect(out).toContain('Meta: total=1 vector=yes keyword=yes fallback=no');
|
|
34
|
+
expect(out).toContain('[tool_evidence] Tool evidence');
|
|
35
|
+
expect(out).toContain('event:e1');
|
|
36
|
+
expect(out).toContain('semantic_match, tool_followup');
|
|
37
|
+
expect(out).toContain('session-');
|
|
38
|
+
});
|
|
39
|
+
|
|
40
|
+
it('formats expand output with target, surrounding results, sources, and expanded context', () => {
|
|
41
|
+
const out = formatDisclosureExpansion({
|
|
42
|
+
target: {
|
|
43
|
+
id: 'event:e2',
|
|
44
|
+
resultType: 'source',
|
|
45
|
+
title: 'Agent response',
|
|
46
|
+
snippet: 'Use the disclosure API',
|
|
47
|
+
score: 1,
|
|
48
|
+
reasons: ['continuity_link'],
|
|
49
|
+
sourceRef: 'event:e2'
|
|
50
|
+
},
|
|
51
|
+
surroundingFacts: [
|
|
52
|
+
{
|
|
53
|
+
id: 'event:e1',
|
|
54
|
+
resultType: 'source',
|
|
55
|
+
snippet: 'Earlier user prompt',
|
|
56
|
+
score: 1,
|
|
57
|
+
reasons: ['continuity_link'],
|
|
58
|
+
sourceRef: 'event:e1'
|
|
59
|
+
}
|
|
60
|
+
],
|
|
61
|
+
relatedSources: [{ sourceRef: 'event:e2', sourceType: 'raw_event', eventIds: ['e2'] }],
|
|
62
|
+
expandedContext: '[agent_response] Use the disclosure API'
|
|
63
|
+
});
|
|
64
|
+
|
|
65
|
+
expect(out).toContain('🧩 Expanded Retrieval Result');
|
|
66
|
+
expect(out).toContain('Target');
|
|
67
|
+
expect(out).toContain('Surrounding');
|
|
68
|
+
expect(out).toContain('Sources');
|
|
69
|
+
expect(out).toContain('[agent_response] Use the disclosure API');
|
|
70
|
+
});
|
|
71
|
+
|
|
72
|
+
it('formats shared disclosure provenance explicitly in expansion and source output', () => {
|
|
73
|
+
const expansionOut = formatDisclosureExpansion({
|
|
74
|
+
target: {
|
|
75
|
+
id: 'shared:shared-1',
|
|
76
|
+
resultType: 'rule',
|
|
77
|
+
title: 'Shared checkout troubleshooting',
|
|
78
|
+
snippet: 'clear cache and retry',
|
|
79
|
+
score: 0.88,
|
|
80
|
+
reasons: ['semantic_match'],
|
|
81
|
+
sourceRef: 'shared:shared-1',
|
|
82
|
+
metadata: {
|
|
83
|
+
sourceProjectHash: 'project-a',
|
|
84
|
+
sourceEntryId: 'e-shared',
|
|
85
|
+
topics: ['checkout']
|
|
86
|
+
}
|
|
87
|
+
},
|
|
88
|
+
relatedSources: [
|
|
89
|
+
{
|
|
90
|
+
sourceRef: 'shared:shared-1',
|
|
91
|
+
sourceType: 'shared_troubleshooting',
|
|
92
|
+
eventIds: [],
|
|
93
|
+
metadata: {
|
|
94
|
+
sourceProjectHash: 'project-a',
|
|
95
|
+
sourceEntryId: 'e-shared',
|
|
96
|
+
topics: ['checkout']
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
],
|
|
100
|
+
expandedContext: '[shared_troubleshooting] Shared checkout troubleshooting\nRoot cause: stale cache'
|
|
101
|
+
});
|
|
102
|
+
|
|
103
|
+
const sourceOut = formatDisclosureSource({
|
|
104
|
+
sourceRef: 'shared:shared-1',
|
|
105
|
+
sourceType: 'shared_troubleshooting',
|
|
106
|
+
eventIds: [],
|
|
107
|
+
rawEvents: [],
|
|
108
|
+
metadata: {
|
|
109
|
+
sourceProjectHash: 'project-a',
|
|
110
|
+
sourceEntryId: 'e-shared',
|
|
111
|
+
topics: ['checkout'],
|
|
112
|
+
rootCause: 'stale cache',
|
|
113
|
+
solution: 'clear cache and retry'
|
|
114
|
+
}
|
|
115
|
+
});
|
|
116
|
+
|
|
117
|
+
expect(expansionOut).toContain('shared_troubleshooting');
|
|
118
|
+
expect(expansionOut).toContain('sourceProjectHash: project-a');
|
|
119
|
+
expect(expansionOut).toContain('topics: checkout');
|
|
120
|
+
expect(sourceOut).toContain('Shared Metadata');
|
|
121
|
+
expect(sourceOut).toContain('rootCause: stale cache');
|
|
122
|
+
expect(sourceOut).toContain('No local raw events for this shared source.');
|
|
123
|
+
});
|
|
124
|
+
|
|
125
|
+
it('formats source output with source type, event ids, and raw event previews', () => {
|
|
126
|
+
const out = formatDisclosureSource({
|
|
127
|
+
sourceRef: 'event:e3',
|
|
128
|
+
sourceType: 'raw_event',
|
|
129
|
+
eventIds: ['e3'],
|
|
130
|
+
rawEvents: [
|
|
131
|
+
{
|
|
132
|
+
id: 'e3',
|
|
133
|
+
sessionId: 'session-1',
|
|
134
|
+
eventType: 'user_prompt',
|
|
135
|
+
content: 'Show source details',
|
|
136
|
+
canonicalKey: 'canonical/e3',
|
|
137
|
+
dedupeKey: 'session-1:e3',
|
|
138
|
+
timestamp: new Date('2026-02-24T00:00:00.000Z'),
|
|
139
|
+
metadata: {}
|
|
140
|
+
}
|
|
141
|
+
]
|
|
142
|
+
});
|
|
143
|
+
|
|
144
|
+
expect(out).toContain('📎 Retrieval Source');
|
|
145
|
+
expect(out).toContain('sourceType: raw_event');
|
|
146
|
+
expect(out).toContain('eventIds: e3');
|
|
147
|
+
expect(out).toContain('[user_prompt] Show source details');
|
|
148
|
+
});
|
|
149
|
+
|
|
150
|
+
it('formats plain search output with shared memories when includeShared is used', () => {
|
|
151
|
+
const out = formatPlainSearchResults({
|
|
152
|
+
memories: [
|
|
153
|
+
{
|
|
154
|
+
event: {
|
|
155
|
+
id: 'e1',
|
|
156
|
+
sessionId: 'session-1234567890',
|
|
157
|
+
eventType: 'agent_response',
|
|
158
|
+
content: 'Local checkout fix details',
|
|
159
|
+
canonicalKey: 'canonical/e1',
|
|
160
|
+
dedupeKey: 'session-1234567890:e1',
|
|
161
|
+
timestamp: new Date('2026-02-24T00:00:00.000Z'),
|
|
162
|
+
metadata: {}
|
|
163
|
+
},
|
|
164
|
+
score: 0.91
|
|
165
|
+
}
|
|
166
|
+
],
|
|
167
|
+
matchResult: {
|
|
168
|
+
match: {
|
|
169
|
+
event: {
|
|
170
|
+
id: 'e1',
|
|
171
|
+
sessionId: 'session-1234567890',
|
|
172
|
+
eventType: 'agent_response',
|
|
173
|
+
content: 'Local checkout fix details',
|
|
174
|
+
canonicalKey: 'canonical/e1',
|
|
175
|
+
dedupeKey: 'session-1234567890:e1',
|
|
176
|
+
timestamp: new Date('2026-02-24T00:00:00.000Z'),
|
|
177
|
+
metadata: {}
|
|
178
|
+
},
|
|
179
|
+
score: 0.91
|
|
180
|
+
},
|
|
181
|
+
confidence: 'high'
|
|
182
|
+
},
|
|
183
|
+
totalTokens: 10,
|
|
184
|
+
context: 'Local checkout fix details',
|
|
185
|
+
sharedMemories: [
|
|
186
|
+
{
|
|
187
|
+
entryId: 'shared-1',
|
|
188
|
+
sourceProjectHash: 'project-a',
|
|
189
|
+
sourceEntryId: 'e-shared',
|
|
190
|
+
title: 'Shared checkout troubleshooting',
|
|
191
|
+
symptoms: ['checkout fails'],
|
|
192
|
+
rootCause: 'stale cache',
|
|
193
|
+
solution: 'clear cache and retry',
|
|
194
|
+
topics: ['checkout'],
|
|
195
|
+
confidence: 0.88,
|
|
196
|
+
usageCount: 3,
|
|
197
|
+
promotedAt: new Date('2026-02-23T00:00:00.000Z'),
|
|
198
|
+
createdAt: new Date('2026-02-23T00:00:00.000Z')
|
|
199
|
+
}
|
|
200
|
+
]
|
|
201
|
+
});
|
|
202
|
+
|
|
203
|
+
expect(out).toContain('📚 Search Results');
|
|
204
|
+
expect(out).toContain('Total local memories found: 1');
|
|
205
|
+
expect(out).toContain('Shared memories found: 1');
|
|
206
|
+
expect(out).toContain('🌐 Shared Memories');
|
|
207
|
+
expect(out).toContain('Shared checkout troubleshooting');
|
|
208
|
+
expect(out).toContain('Source: shared:shared-1');
|
|
209
|
+
expect(out).toContain('Project: project-a');
|
|
210
|
+
expect(out).toContain('Solution: clear cache and retry');
|
|
211
|
+
});
|
|
212
|
+
});
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
import { beforeEach, describe, expect, it, vi } from 'vitest';
|
|
2
|
+
import type { ImportResult } from '../../src/services/session-history-importer.js';
|
|
3
|
+
|
|
4
|
+
const { runCodexImportOnce } = await import('../../src/apps/cli/codex-import-runner.js');
|
|
5
|
+
|
|
6
|
+
function makeImportResult(overrides: Partial<ImportResult> = {}): ImportResult {
|
|
7
|
+
return {
|
|
8
|
+
totalSessions: 1,
|
|
9
|
+
totalMessages: 2,
|
|
10
|
+
importedPrompts: 1,
|
|
11
|
+
importedResponses: 1,
|
|
12
|
+
skippedDuplicates: 0,
|
|
13
|
+
errors: [],
|
|
14
|
+
...overrides
|
|
15
|
+
};
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
function makeService() {
|
|
19
|
+
return {
|
|
20
|
+
initialize: vi.fn(async () => undefined),
|
|
21
|
+
shutdown: vi.fn(async () => undefined),
|
|
22
|
+
processPendingEmbeddings: vi.fn(async () => 2),
|
|
23
|
+
ensureEmbeddingModelForImport: vi.fn(async () => ({ changed: false, previousModel: null, currentModel: 'test', enqueued: 0 }))
|
|
24
|
+
};
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
describe('Codex import runner', () => {
|
|
28
|
+
let projectService: ReturnType<typeof makeService>;
|
|
29
|
+
let globalService: ReturnType<typeof makeService>;
|
|
30
|
+
let importer: {
|
|
31
|
+
importProject: ReturnType<typeof vi.fn>;
|
|
32
|
+
importAll: ReturnType<typeof vi.fn>;
|
|
33
|
+
importSessionFile: ReturnType<typeof vi.fn>;
|
|
34
|
+
};
|
|
35
|
+
let deps: Parameters<typeof runCodexImportOnce>[1];
|
|
36
|
+
|
|
37
|
+
beforeEach(() => {
|
|
38
|
+
projectService = makeService();
|
|
39
|
+
globalService = makeService();
|
|
40
|
+
importer = {
|
|
41
|
+
importProject: vi.fn(async () => makeImportResult()),
|
|
42
|
+
importAll: vi.fn(async () => makeImportResult({ totalSessions: 3 })),
|
|
43
|
+
importSessionFile: vi.fn(async () => makeImportResult())
|
|
44
|
+
};
|
|
45
|
+
deps = {
|
|
46
|
+
cwd: () => '/repo/current',
|
|
47
|
+
getDefaultMemoryService: vi.fn(() => globalService as never),
|
|
48
|
+
getMemoryServiceForProject: vi.fn(() => projectService as never),
|
|
49
|
+
createImporter: vi.fn(() => importer as never),
|
|
50
|
+
onProgress: vi.fn()
|
|
51
|
+
};
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
it('imports the current project from Codex sessions into the project-scoped memory service', async () => {
|
|
55
|
+
const outcome = await runCodexImportOnce({ sessionsDir: '/tmp/codex-sessions', limit: '9', sessionLimit: '1' }, deps);
|
|
56
|
+
|
|
57
|
+
expect(deps?.getMemoryServiceForProject).toHaveBeenCalledWith('/repo/current');
|
|
58
|
+
expect(deps?.getDefaultMemoryService).not.toHaveBeenCalled();
|
|
59
|
+
expect(deps?.createImporter).toHaveBeenCalledWith(projectService, { sessionsDir: '/tmp/codex-sessions' });
|
|
60
|
+
expect(projectService.initialize).toHaveBeenCalledTimes(1);
|
|
61
|
+
expect(projectService.ensureEmbeddingModelForImport).toHaveBeenCalledWith({ autoMigrate: true });
|
|
62
|
+
expect(importer.importProject).toHaveBeenCalledWith('/repo/current', expect.objectContaining({
|
|
63
|
+
projectPath: '/repo/current',
|
|
64
|
+
limit: 9,
|
|
65
|
+
sessionLimit: 1,
|
|
66
|
+
onProgress: deps?.onProgress
|
|
67
|
+
}));
|
|
68
|
+
expect(projectService.processPendingEmbeddings).toHaveBeenCalledTimes(1);
|
|
69
|
+
expect(projectService.shutdown).toHaveBeenCalledTimes(1);
|
|
70
|
+
expect(outcome).toMatchObject({ mode: 'project', storageScope: 'project', embedCount: 2 });
|
|
71
|
+
});
|
|
72
|
+
|
|
73
|
+
it('uses global storage only for explicit all-session imports without a project', async () => {
|
|
74
|
+
const outcome = await runCodexImportOnce({ all: true, processEmbeddings: false }, deps);
|
|
75
|
+
|
|
76
|
+
expect(deps?.getDefaultMemoryService).toHaveBeenCalledTimes(1);
|
|
77
|
+
expect(deps?.getMemoryServiceForProject).not.toHaveBeenCalled();
|
|
78
|
+
expect(importer.importAll).toHaveBeenCalledWith(expect.objectContaining({ force: undefined }));
|
|
79
|
+
expect(globalService.processPendingEmbeddings).not.toHaveBeenCalled();
|
|
80
|
+
expect(globalService.shutdown).toHaveBeenCalledTimes(1);
|
|
81
|
+
expect(outcome).toMatchObject({ mode: 'all', storageScope: 'global', embedCount: 0 });
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
it('imports a single Codex session file into the selected project scope', async () => {
|
|
85
|
+
await runCodexImportOnce({ project: '/repo/selected', session: '/tmp/session.jsonl', force: true }, deps);
|
|
86
|
+
|
|
87
|
+
expect(deps?.getMemoryServiceForProject).toHaveBeenCalledWith('/repo/selected');
|
|
88
|
+
expect(importer.importSessionFile).toHaveBeenCalledWith('/tmp/session.jsonl', expect.objectContaining({
|
|
89
|
+
projectPath: '/repo/selected',
|
|
90
|
+
force: true
|
|
91
|
+
}));
|
|
92
|
+
});
|
|
93
|
+
|
|
94
|
+
it('rejects non-decimal integer limits instead of partially parsing them', async () => {
|
|
95
|
+
await expect(runCodexImportOnce({ limit: '1foo' }, deps)).rejects.toThrow('Invalid --limit');
|
|
96
|
+
await expect(runCodexImportOnce({ sessionLimit: '1.5' }, deps)).rejects.toThrow('Invalid --session-limit');
|
|
97
|
+
await expect(runCodexImportOnce({ sessionLimit: '1e2' }, deps)).rejects.toThrow('Invalid --session-limit');
|
|
98
|
+
});
|
|
99
|
+
});
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
import { describe, expect, it } from 'vitest';
|
|
2
|
+
|
|
3
|
+
import { formatCodexValidationReport } from '../../src/apps/cli/codex-validation-output.js';
|
|
4
|
+
import type { CodexSessionValidationReport } from '../../src/services/codex-session-history-importer.js';
|
|
5
|
+
|
|
6
|
+
function makeReport(): CodexSessionValidationReport {
|
|
7
|
+
return {
|
|
8
|
+
generatedAt: '2026-05-05T12:00:00.000Z',
|
|
9
|
+
dryRun: true,
|
|
10
|
+
willMutate: false,
|
|
11
|
+
source: {
|
|
12
|
+
sessionsDir: '/tmp/codex-sessions',
|
|
13
|
+
projectPath: '/tmp/project-a',
|
|
14
|
+
projectFilterApplied: true,
|
|
15
|
+
sourcePaths: ['/tmp/codex-sessions']
|
|
16
|
+
},
|
|
17
|
+
limits: {
|
|
18
|
+
sessionLimit: 10,
|
|
19
|
+
maxContentChars: 10_000
|
|
20
|
+
},
|
|
21
|
+
totals: {
|
|
22
|
+
sessionsScanned: 3,
|
|
23
|
+
sessionsMatched: 2,
|
|
24
|
+
filesRead: 2,
|
|
25
|
+
recordsRead: 9,
|
|
26
|
+
messagesNormalized: 4,
|
|
27
|
+
turnsNormalized: 2,
|
|
28
|
+
userMessages: 2,
|
|
29
|
+
assistantMessages: 2,
|
|
30
|
+
malformedLines: 1,
|
|
31
|
+
skippedUnsupportedRecords: 2,
|
|
32
|
+
emptyAssistantMessages: 1,
|
|
33
|
+
truncatedMessages: 1,
|
|
34
|
+
missingProjectCwd: 1,
|
|
35
|
+
warnings: 2
|
|
36
|
+
},
|
|
37
|
+
topProjects: [
|
|
38
|
+
{
|
|
39
|
+
projectHash: 'abc12345',
|
|
40
|
+
pathLabel: '/tmp/project-a',
|
|
41
|
+
sessions: 2,
|
|
42
|
+
messagesNormalized: 4,
|
|
43
|
+
turnsNormalized: 2,
|
|
44
|
+
userMessages: 2,
|
|
45
|
+
assistantMessages: 2,
|
|
46
|
+
malformedLines: 1,
|
|
47
|
+
skippedUnsupportedRecords: 2,
|
|
48
|
+
truncatedMessages: 1,
|
|
49
|
+
emptyAssistantMessages: 1
|
|
50
|
+
}
|
|
51
|
+
],
|
|
52
|
+
sessions: [
|
|
53
|
+
{
|
|
54
|
+
sessionId: 'session-a',
|
|
55
|
+
filePath: '/tmp/codex-sessions/session-a.jsonl',
|
|
56
|
+
projectHash: 'abc12345',
|
|
57
|
+
pathLabel: '/tmp/project-a',
|
|
58
|
+
matched: true,
|
|
59
|
+
recordsRead: 9,
|
|
60
|
+
messagesNormalized: 4,
|
|
61
|
+
turnsNormalized: 2,
|
|
62
|
+
userMessages: 2,
|
|
63
|
+
assistantMessages: 2,
|
|
64
|
+
malformedLines: 1,
|
|
65
|
+
skippedUnsupportedRecords: 2,
|
|
66
|
+
emptyAssistantMessages: 1,
|
|
67
|
+
truncatedMessages: 1,
|
|
68
|
+
missingProjectCwd: false,
|
|
69
|
+
warnings: ['sample warning']
|
|
70
|
+
}
|
|
71
|
+
],
|
|
72
|
+
warnings: ['1 session(s) missing cwd', '1 malformed JSONL line(s) skipped']
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
describe('Codex validation CLI output helpers', () => {
|
|
77
|
+
it('formats JSON reports without transcript text', () => {
|
|
78
|
+
const json = formatCodexValidationReport(makeReport(), 'json');
|
|
79
|
+
const parsed = JSON.parse(json) as CodexSessionValidationReport;
|
|
80
|
+
|
|
81
|
+
expect(parsed.dryRun).toBe(true);
|
|
82
|
+
expect(parsed.willMutate).toBe(false);
|
|
83
|
+
expect(parsed.totals.sessionsScanned).toBe(3);
|
|
84
|
+
expect(json).not.toContain('please implement');
|
|
85
|
+
expect(json).not.toContain('assistant response');
|
|
86
|
+
});
|
|
87
|
+
|
|
88
|
+
it('formats markdown totals, top projects, and safety status', () => {
|
|
89
|
+
const markdown = formatCodexValidationReport(makeReport(), 'markdown');
|
|
90
|
+
|
|
91
|
+
expect(markdown).toContain('# Codex dry-run validation report');
|
|
92
|
+
expect(markdown).toContain('Dry-run: yes');
|
|
93
|
+
expect(markdown).toContain('Sessions scanned: 3');
|
|
94
|
+
expect(markdown).toContain('Sessions matched: 2');
|
|
95
|
+
expect(markdown).toContain('Malformed lines: 1');
|
|
96
|
+
expect(markdown).toContain('Skipped/unsupported records: 2');
|
|
97
|
+
expect(markdown).toContain('abc12345');
|
|
98
|
+
expect(markdown).toContain('/tmp/project-a');
|
|
99
|
+
});
|
|
100
|
+
});
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
import { beforeEach, describe, expect, it, vi } from 'vitest';
|
|
2
|
+
import type { ImportResult } from '../../src/services/session-history-importer.js';
|
|
3
|
+
|
|
4
|
+
const { runHermesImportOnce } = await import('../../src/apps/cli/hermes-import-runner.js');
|
|
5
|
+
|
|
6
|
+
function makeImportResult(overrides: Partial<ImportResult> = {}): ImportResult {
|
|
7
|
+
return {
|
|
8
|
+
totalSessions: 1,
|
|
9
|
+
totalMessages: 2,
|
|
10
|
+
importedPrompts: 1,
|
|
11
|
+
importedResponses: 1,
|
|
12
|
+
skippedDuplicates: 0,
|
|
13
|
+
errors: [],
|
|
14
|
+
...overrides
|
|
15
|
+
};
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
function makeService() {
|
|
19
|
+
return {
|
|
20
|
+
initialize: vi.fn(async () => undefined),
|
|
21
|
+
shutdown: vi.fn(async () => undefined),
|
|
22
|
+
processPendingEmbeddings: vi.fn(async () => 2),
|
|
23
|
+
ensureEmbeddingModelForImport: vi.fn(async () => ({ changed: false, previousModel: null, currentModel: 'test', enqueued: 0 }))
|
|
24
|
+
};
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
describe('Hermes import runner', () => {
|
|
28
|
+
let projectService: ReturnType<typeof makeService>;
|
|
29
|
+
let globalService: ReturnType<typeof makeService>;
|
|
30
|
+
let importer: {
|
|
31
|
+
importProject: ReturnType<typeof vi.fn>;
|
|
32
|
+
importAll: ReturnType<typeof vi.fn>;
|
|
33
|
+
importSession: ReturnType<typeof vi.fn>;
|
|
34
|
+
};
|
|
35
|
+
let deps: Parameters<typeof runHermesImportOnce>[1];
|
|
36
|
+
|
|
37
|
+
beforeEach(() => {
|
|
38
|
+
projectService = makeService();
|
|
39
|
+
globalService = makeService();
|
|
40
|
+
importer = {
|
|
41
|
+
importProject: vi.fn(async () => makeImportResult()),
|
|
42
|
+
importAll: vi.fn(async () => makeImportResult({ totalSessions: 3 })),
|
|
43
|
+
importSession: vi.fn(async () => makeImportResult())
|
|
44
|
+
};
|
|
45
|
+
deps = {
|
|
46
|
+
cwd: () => '/repo/current',
|
|
47
|
+
getDefaultMemoryService: vi.fn(() => globalService as never),
|
|
48
|
+
getMemoryServiceForProject: vi.fn(() => projectService as never),
|
|
49
|
+
createImporter: vi.fn(() => importer as never),
|
|
50
|
+
onProgress: vi.fn()
|
|
51
|
+
};
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
it('imports the current project from Hermes state.db into the project-scoped memory service', async () => {
|
|
55
|
+
const outcome = await runHermesImportOnce({ stateDb: '/tmp/hermes-state.db', limit: '9', sessionLimit: '1' }, deps);
|
|
56
|
+
|
|
57
|
+
expect(deps?.getMemoryServiceForProject).toHaveBeenCalledWith('/repo/current');
|
|
58
|
+
expect(deps?.getDefaultMemoryService).not.toHaveBeenCalled();
|
|
59
|
+
expect(deps?.createImporter).toHaveBeenCalledWith(projectService, { stateDbPath: '/tmp/hermes-state.db' });
|
|
60
|
+
expect(projectService.initialize).toHaveBeenCalledTimes(1);
|
|
61
|
+
expect(projectService.ensureEmbeddingModelForImport).toHaveBeenCalledWith({ autoMigrate: true });
|
|
62
|
+
expect(importer.importProject).toHaveBeenCalledWith('/repo/current', expect.objectContaining({
|
|
63
|
+
projectPath: '/repo/current',
|
|
64
|
+
limit: 9,
|
|
65
|
+
sessionLimit: 1,
|
|
66
|
+
onProgress: deps?.onProgress
|
|
67
|
+
}));
|
|
68
|
+
expect(projectService.processPendingEmbeddings).toHaveBeenCalledTimes(1);
|
|
69
|
+
expect(projectService.shutdown).toHaveBeenCalledTimes(1);
|
|
70
|
+
expect(outcome).toMatchObject({ mode: 'project', storageScope: 'project', embedCount: 2 });
|
|
71
|
+
});
|
|
72
|
+
|
|
73
|
+
it('uses global storage only for explicit all-session imports without a project', async () => {
|
|
74
|
+
const outcome = await runHermesImportOnce({ all: true, processEmbeddings: false }, deps);
|
|
75
|
+
|
|
76
|
+
expect(deps?.getDefaultMemoryService).toHaveBeenCalledTimes(1);
|
|
77
|
+
expect(deps?.getMemoryServiceForProject).not.toHaveBeenCalled();
|
|
78
|
+
expect(importer.importAll).toHaveBeenCalledWith(expect.objectContaining({ force: undefined }));
|
|
79
|
+
expect(globalService.processPendingEmbeddings).not.toHaveBeenCalled();
|
|
80
|
+
expect(globalService.shutdown).toHaveBeenCalledTimes(1);
|
|
81
|
+
expect(outcome).toMatchObject({ mode: 'all', storageScope: 'global', embedCount: 0 });
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
it('imports a single Hermes session into the selected project scope', async () => {
|
|
85
|
+
await runHermesImportOnce({ project: '/repo/selected', session: '20260505_010203_abcd1234', force: true }, deps);
|
|
86
|
+
|
|
87
|
+
expect(deps?.getMemoryServiceForProject).toHaveBeenCalledWith('/repo/selected');
|
|
88
|
+
expect(importer.importSession).toHaveBeenCalledWith('20260505_010203_abcd1234', expect.objectContaining({
|
|
89
|
+
projectPath: '/repo/selected',
|
|
90
|
+
force: true
|
|
91
|
+
}));
|
|
92
|
+
});
|
|
93
|
+
|
|
94
|
+
it('rejects non-decimal integer limits instead of partially parsing them', async () => {
|
|
95
|
+
await expect(runHermesImportOnce({ limit: '1foo' }, deps)).rejects.toThrow('Invalid --limit');
|
|
96
|
+
await expect(runHermesImportOnce({ sessionLimit: '1.5' }, deps)).rejects.toThrow('Invalid --session-limit');
|
|
97
|
+
await expect(runHermesImportOnce({ sessionLimit: '1e2' }, deps)).rejects.toThrow('Invalid --session-limit');
|
|
98
|
+
});
|
|
99
|
+
});
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
|
|
2
|
+
import { tmpdir } from 'node:os';
|
|
3
|
+
import { join } from 'node:path';
|
|
4
|
+
import { afterEach, describe, expect, it } from 'vitest';
|
|
5
|
+
import {
|
|
6
|
+
getDefaultClaudeDesktopConfigPath,
|
|
7
|
+
installMcpServerConfig,
|
|
8
|
+
readJsonConfig,
|
|
9
|
+
saveJsonConfig
|
|
10
|
+
} from '../../src/apps/cli/mcp-install.js';
|
|
11
|
+
|
|
12
|
+
const tempDirs: string[] = [];
|
|
13
|
+
|
|
14
|
+
function tempDir() {
|
|
15
|
+
const dir = mkdtempSync(join(tmpdir(), 'cml-mcp-install-'));
|
|
16
|
+
tempDirs.push(dir);
|
|
17
|
+
return dir;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
afterEach(() => {
|
|
21
|
+
for (const dir of tempDirs.splice(0)) {
|
|
22
|
+
rmSync(dir, { recursive: true, force: true });
|
|
23
|
+
}
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
describe('MCP install command helpers', () => {
|
|
27
|
+
it('resolves the Claude Desktop config path per platform', () => {
|
|
28
|
+
expect(getDefaultClaudeDesktopConfigPath('darwin', {}, '/Users/me')).toBe('/Users/me/Library/Application Support/Claude/claude_desktop_config.json');
|
|
29
|
+
expect(getDefaultClaudeDesktopConfigPath('linux', {}, '/home/me')).toBe('/home/me/.config/claude/claude_desktop_config.json');
|
|
30
|
+
expect(getDefaultClaudeDesktopConfigPath('win32', { APPDATA: 'C:/Users/me/AppData/Roaming' }, 'C:/Users/me')).toBe('C:/Users/me/AppData/Roaming/Claude/claude_desktop_config.json');
|
|
31
|
+
});
|
|
32
|
+
|
|
33
|
+
it('adds claude-memory-layer MCP server while preserving existing config', () => {
|
|
34
|
+
const config = installMcpServerConfig(
|
|
35
|
+
{ mcpServers: { existing: { command: 'node', args: ['server.js'] } }, other: true },
|
|
36
|
+
{ serverName: 'claude-memory-layer', command: 'claude-memory-layer-mcp', args: [] }
|
|
37
|
+
);
|
|
38
|
+
|
|
39
|
+
expect(config).toEqual({
|
|
40
|
+
mcpServers: {
|
|
41
|
+
existing: { command: 'node', args: ['server.js'] },
|
|
42
|
+
'claude-memory-layer': { command: 'claude-memory-layer-mcp', args: [] }
|
|
43
|
+
},
|
|
44
|
+
other: true
|
|
45
|
+
});
|
|
46
|
+
});
|
|
47
|
+
|
|
48
|
+
it('atomically writes config files and creates parent directories', () => {
|
|
49
|
+
const configPath = join(tempDir(), 'Claude', 'claude_desktop_config.json');
|
|
50
|
+
saveJsonConfig(configPath, installMcpServerConfig({}, { serverName: 'code-memory', command: 'node', args: ['dist/mcp/index.js'] }));
|
|
51
|
+
|
|
52
|
+
expect(readJsonConfig(configPath)).toEqual({
|
|
53
|
+
mcpServers: {
|
|
54
|
+
'code-memory': { command: 'node', args: ['dist/mcp/index.js'] }
|
|
55
|
+
}
|
|
56
|
+
});
|
|
57
|
+
expect(readFileSync(configPath, 'utf8')).toContain('"mcpServers"');
|
|
58
|
+
});
|
|
59
|
+
});
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { readFileSync } from 'node:fs';
|
|
2
|
+
|
|
3
|
+
import { describe, expect, it } from 'vitest';
|
|
4
|
+
|
|
5
|
+
interface PackageJson {
|
|
6
|
+
main: string;
|
|
7
|
+
bin: Record<string, string>;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
describe('package build entrypoints', () => {
|
|
11
|
+
it('builds the root package main declared in package.json', () => {
|
|
12
|
+
const pkg = JSON.parse(readFileSync('package.json', 'utf-8')) as PackageJson;
|
|
13
|
+
const buildScript = readFileSync('scripts/build.ts', 'utf-8');
|
|
14
|
+
|
|
15
|
+
expect(pkg.main).toBe('dist/index.js');
|
|
16
|
+
expect(buildScript).toContain("entryPoints: ['src/index.ts']");
|
|
17
|
+
expect(buildScript).toContain("outfile: 'dist/index.js'");
|
|
18
|
+
});
|
|
19
|
+
|
|
20
|
+
it('keeps MCP package bin wiring covered by the build script', () => {
|
|
21
|
+
const pkg = JSON.parse(readFileSync('package.json', 'utf-8')) as PackageJson;
|
|
22
|
+
const lock = JSON.parse(readFileSync('package-lock.json', 'utf-8')) as { packages: Record<string, { bin?: Record<string, string> }> };
|
|
23
|
+
const buildScript = readFileSync('scripts/build.ts', 'utf-8');
|
|
24
|
+
|
|
25
|
+
expect(pkg.bin['claude-memory-layer-mcp']).toBe('dist/mcp/index.js');
|
|
26
|
+
expect(lock.packages[''].bin).toMatchObject(pkg.bin);
|
|
27
|
+
expect(buildScript).toContain("entryPoints: ['src/mcp/index.ts']");
|
|
28
|
+
expect(buildScript).toContain("outfile: 'dist/mcp/index.js'");
|
|
29
|
+
});
|
|
30
|
+
});
|