memento-mcp-server 1.24.0-d → 1.24.0-e

package/README.en.md

@@ -21,8 +21,7 @@ Memento MCP Server is a Model Context Protocol (MCP) server that helps AI Agents
 - **Memory Pinning**: Pin/unpin important memories
 - **Memory Deletion**: Soft/hard deletion
 - **Anchor System**: Set important memories as anchors for context management
-- **Meta Memory Statistics**: Query statistics such as memory search success rate and confidence scores
-- **Memory Conversion**: Automatic conversion from Episodic Memory to Semantic Memory
+> **Note**: Anchor recovery, embedding migration, Episodic → Semantic conversion, and meta memory statistics are exposed through the HTTP Management API, not MCP tools.
 
 ### 🔍 Advanced Search
 - **FTS5 Text Search**: SQLite's Full-Text Search
@@ -39,7 +38,7 @@ Memento MCP Server is a Model Context Protocol (MCP) server that helps AI Agents
 - **Auto Cleanup**: Automated soft/hard deletion
 
 ### 📊 Performance Monitoring (HTTP Management API)
-- **Security**: HTTP API has no authentication; use only on **internal networks or with MCP clients**. See [docs/reference/en/security.md](docs/reference/en/security.md).
+- **Security**: HTTP server splits browser-session and header-based trust. `/auth/session` starts the cookie-backed browser flow; `/admin` and `/api` require a browser session; `/api/v1/quality`, `/tools`, and `/mcp` require `Authorization: Bearer` or `X-API-Key`. See [docs/reference/en/security.md](docs/reference/en/security.md).
 - **Real-time Metrics**: Database, search, memory performance monitoring
 - **Real-time Alerts**: Automatic performance checks every 30 seconds with threshold-based alerts
 - **Error Logging**: Structured error logging and statistics collection
@@ -49,9 +48,10 @@ Memento MCP Server is a Model Context Protocol (MCP) server that helps AI Agents
 
 ### 🔗 Memory Graph View (Browser)
 
-After starting the HTTP server, visualize semantic relationships between memories as an interactive graph in your browser.
+After starting the HTTP server, you can visualize semantic relationships between memories as an interactive graph in your browser. `/dashboard` is the preferred entry point for the full admin flow, and opening `/graph` directly now offers the same `/auth/session` re-auth path so signed-out users can recover the session in place.
 
 ```
+http://localhost:9001/dashboard
 http://localhost:9001/graph
 ```
 
@@ -166,8 +166,7 @@ const results = await client.callTool({
 
 ### MCP Tools (Core 14)
 
-> **Important**: MCP client exposes 14 core memory management functions.  
-> Management functions are separated into HTTP API endpoints.
+> **Important**: MCP client exposes 14 core memory management functions. Operational functions are exposed through the HTTP Management API below, not through MCP.
 
 #### Basic Memory Management (7)
 | Tool | Description | Parameters |
@@ -180,21 +179,22 @@ const results = await client.callTool({
 | `get_memory_neighbors` | Find neighbor memories | memory_id, limit |
 | `memory_injection` | Generate context injection prompt | query, token_budget |
 
-#### Anchor System (5)
+#### Anchor System (4)
 | Tool | Description | Parameters |
 |------|-------------|------------|
 | `set_anchor` | Set anchor | memory_id, slot |
 | `get_anchor` | Get anchor | slot |
 | `search_local` | Search around anchor | slot, query, limit |
 | `clear_anchor` | Clear anchor | slot |
-| `restore_anchors` | Restore anchors | agent_id |
 
-#### Advanced Features (3)
+#### Procedural Memory (3)
 | Tool | Description | Parameters |
 |------|-------------|------------|
-| `migrate_embeddings` | Migrate embeddings | target_provider, batch_size |
-| `convert_episodic_to_semantic` | Convert Episodic → Semantic | memory_id, limit |
-| `get_meta_memory_stats` | Get meta memory statistics | memory_id, memory_ids |
+| `remember_procedure` | Store procedural memory | content, workflow_name, skill_name, steps, etc. |
+| `procedural_diff` | Compare procedural memory versions | left_id, right_id |
+| `procedural_rollback` | Roll back procedural memory to a previous version | current_id, target_version_id |
+
+**HTTP-only (not MCP)**: `restore_anchors`, `migrate_embeddings`, `convert_episodic_to_semantic`, `get_meta_memory_stats` - see the HTTP Management API below.
 
 ### HTTP Management API
 
@@ -333,7 +333,7 @@ npm run test -- --coverage
 ### M1: Personal Use (Current Implementation)
 - **Storage**: better-sqlite3 embedded
 - **Index**: FTS5 + sqlite-vec
-- **Authentication**: None (local only)
+- **Authentication**: Split browser-session and header-based trust model (`/auth/session` starts the cookie-backed browser flow; `/admin` and `/api` require a browser session; `/api/v1/quality`, `/tools`, and `/mcp` require `Authorization: Bearer` or `X-API-Key`)
 - **Operation**: Local execution
 - **MCP Client**: Exposes 14 core tools
 - **Management Functions**: Separated into HTTP API

package/README.md

@@ -40,8 +40,7 @@ Memento MCP Server는 AI Agent가 장기 기억을 저장하고 관리할 수
 - **기억 고정**: 중요한 기억 고정/해제
 - **기억 삭제**: 소프트/하드 삭제
 - **앵커 시스템**: 중요한 기억을 앵커로 설정하여 컨텍스트 관리
-- **메타 메모리 통계**: 기억 검색 성공률, 신뢰도 점수 등 통계 조회
-- **기억 변환**: Episodic Memory를 Semantic Memory로 자동 변환
+> **참고**: 앵커 복원, 임베딩 마이그레이션, Episodic → Semantic 변환, 메타 메모리 통계는 MCP 도구가 아니라 HTTP 관리 API로만 제공됩니다.
 
 ### 🔍 고급 검색
 - **FTS5 텍스트 검색**: SQLite의 Full-Text Search
@@ -59,7 +58,7 @@ Memento MCP Server는 AI Agent가 장기 기억을 저장하고 관리할 수
 - **자동 정리**: 소프트/하드 삭제 자동화
 
 ### 📊 성능 모니터링 (HTTP 관리 API)
-- **보안**: HTTP API는 인증이 없으며 **내부망/MCP 전용** 사용을 권장합니다. 자세한 내용은 [docs/reference/ko/security.md](docs/reference/ko/security.md)를 참고하세요.
+- **보안**: HTTP 서버는 브라우저 세션과 헤더 기반 신뢰 경계를 분리합니다. `/auth/session`은 쿠키 기반 브라우저 세션을 시작하고, `/admin`과 `/api`는 브라우저 세션이 필요하며, `/api/v1/quality`, `/tools`, `/mcp`는 `Authorization: Bearer` 또는 `X-API-Key`가 필요합니다. 자세한 내용은 [docs/reference/ko/security.md](docs/reference/ko/security.md)를 참고하세요.
 - **실시간 메트릭**: 데이터베이스, 검색, 메모리 성능 모니터링
 - **실시간 알림**: 30초마다 자동 성능 체크 및 임계값 기반 알림
 - **에러 로깅**: 구조화된 에러 로깅 및 통계 수집
@@ -69,9 +68,10 @@ Memento MCP Server는 AI Agent가 장기 기억을 저장하고 관리할 수
 
 ### 🔗 메모리 그래프 뷰 (브라우저)
 
-HTTP 서버 실행 후 브라우저에서 기억들의 의미적 관계를 그래프로 시각화할 수 있습니다.
+HTTP 서버 실행 후 브라우저에서 기억들의 의미적 관계를 그래프로 시각화할 수 있습니다. 전체 관리 흐름은 `/dashboard`에서 여는 편이 가장 안전하며, `/graph`를 직접 열어도 동일한 `/auth/session` 기반 재인증 패널로 세션을 시작하거나 복구할 수 있습니다.
 
 ```
+http://localhost:9001/dashboard
 http://localhost:9001/graph
 ```
 
@@ -528,7 +528,7 @@ npm run test -- --coverage
 ### M1: 개인용 (현재 구현)
 - **스토리지**: better-sqlite3 임베디드
 - **인덱스**: FTS5 + sqlite-vec
-- **인증**: 없음 (로컬 전용)
+- **인증**: 브라우저 세션 + 헤더 기반 분리 신뢰 모델 (/auth/session은 쿠키 세션, /admin·/api는 브라우저 세션, /api/v1/quality·/tools·/mcp는 Authorization Bearer 또는 X-API-Key)
 - **운영**: 로컬 실행
 - **MCP 클라이언트**: 핵심 14개 도구 노출
 - **관리 기능**: HTTP API로 분리

package/node_modules/@memento/core/dist/bootstrap.d.ts

@@ -25,6 +25,7 @@ import { DatabaseLockMonitor } from './infrastructure/database/database-lock-mon
 import { MetaMemoryService } from './domains/memory/services/meta-memory-service.js';
 import { IntrospectionScanCache } from './domains/memory/services/introspection-scan-cache.js';
 import { TelemetryService } from './domains/telemetry/services/telemetry-service.js';
+import { RuntimeDiagnosticsLogger } from './domains/monitoring/services/runtime-diagnostics-logger.js';
 export interface ServerServices {
     searchEngine: SearchEngine;
     hybridSearchEngine: HybridSearchEngine;
@@ -50,6 +51,10 @@ export interface ServerServices {
     sleepConsolidationService?: SleepConsolidationService;
     /** 006 observability telemetry */
     telemetryService?: TelemetryService;
+    /** 런타임 샘플 및 부트스트랩 이벤트 진단 로거 */
+    runtimeDiagnosticsLogger?: RuntimeDiagnosticsLogger;
+    /** diagnostics sampler cleanup hook */
+    runtimeDiagnosticsSamplerCleanup?: () => Promise<void>;
 }
 export declare function initializeServices(db: Database.Database): Promise<ServerServices>;
 //# sourceMappingURL=bootstrap.d.ts.map

package/node_modules/@memento/core/dist/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAC;AAEzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uDAAuD,CAAC;AAC/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,4DAA4D,CAAC;AACrG,OAAO,EAAE,qBAAqB,EAAE,MAAM,sDAAsD,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,4DAA4D,CAAC;AACrG,OAAO,EAAE,sBAAsB,EAAuB,MAAM,oCAAoC,CAAC;AAEjG,OAAO,EAAE,aAAa,EAAE,MAAM,oDAAoD,CAAC;AAGnF,OAAO,EAAE,eAAe,EAAE,MAAM,mDAAmD,CAAC;AAEpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACxF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AACvG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAC;AAC9F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAI1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AAE5F,OAAO,EAAE,yBAAyB,EAAE,MAAM,iEAAiE,CAAC;AAG5G,OAAO,EAAE,sBAAsB,EAAE,MAAM,uDAAuD,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uDAAuD,CAAC;AAG/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAErF,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,kBAAkB,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;IAC7D,iBAAiB,EAAE,kBAAkB,CAAC;IACtC,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,yBAAyB,CAAC,EAAE,0BAA0B,CAAC;IACvD,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,aAAa,EAAE,aAAa,CAAC;IAC7B,eAAe,EAAE,eAAe,CAAC;IACjC,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,kBAAkB,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;IAC7D,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,mGAAmG;IACnG,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,8BAA8B;IAC9B,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IACtD,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,CAmJvF"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAC;AAEzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uDAAuD,CAAC;AAC/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,4DAA4D,CAAC;AACrG,OAAO,EAAE,qBAAqB,EAAE,MAAM,sDAAsD,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,4DAA4D,CAAC;AACrG,OAAO,EAAE,sBAAsB,EAAuB,MAAM,oCAAoC,CAAC;AAEjG,OAAO,EAAE,aAAa,EAAE,MAAM,oDAAoD,CAAC;AAGnF,OAAO,EAAE,eAAe,EAAE,MAAM,mDAAmD,CAAC;AAEpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACxF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AACvG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAC;AAC9F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAI1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AAE5F,OAAO,EAAE,yBAAyB,EAAE,MAAM,iEAAiE,CAAC;AAG5G,OAAO,EAAE,sBAAsB,EAAE,MAAM,uDAAuD,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,uDAAuD,CAAC;AAG/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,6DAA6D,CAAC;AAEvG,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,kBAAkB,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;IAC7D,iBAAiB,EAAE,kBAAkB,CAAC;IACtC,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,uBAAuB,EAAE,uBAAuB,CAAC;IACjD,yBAAyB,CAAC,EAAE,0BAA0B,CAAC;IACvD,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,aAAa,EAAE,aAAa,CAAC;IAC7B,eAAe,EAAE,eAAe,CAAC;IACjC,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,kBAAkB,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;IAC7D,cAAc,CAAC,EAAE,eAAe,CAAC;IACjC,mGAAmG;IACnG,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,8BAA8B;IAC9B,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;IACtD,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,+BAA+B;IAC/B,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD,uCAAuC;IACvC,gCAAgC,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,CAkQvF"}

package/node_modules/@memento/core/dist/bootstrap.js

@@ -34,6 +34,7 @@ import { MetaMemoryService } from './domains/memory/services/meta-memory-service
 import { IntrospectionScanCache } from './domains/memory/services/introspection-scan-cache.js';
 import { TelemetryRepository } from './domains/telemetry/repositories/telemetry-repository.js';
 import { TelemetryService } from './domains/telemetry/services/telemetry-service.js';
+import { RuntimeDiagnosticsLogger } from './domains/monitoring/services/runtime-diagnostics-logger.js';
 export async function initializeServices(db) {
     try {
         const searchEngine = new SearchEngine();
@@ -64,6 +65,12 @@ export async function initializeServices(db) {
         await reflexionWorker.start();
         const performanceMonitor = getPerformanceMonitor();
         performanceMonitor.initialize(db);
+        const runtimeDiagnosticsLogger = new RuntimeDiagnosticsLogger(mementoConfig.diagnosticsEnabled, mementoConfig.diagnosticsLogDir);
+        await runtimeDiagnosticsLogger.writeEvent({
+            type: 'bootstrap_start',
+            timestamp: new Date().toISOString(),
+            diagnosticsEnabled: mementoConfig.diagnosticsEnabled
+        });
         const walCheckpointScheduler = new WalCheckpointScheduler(db, {
             intervalMs: mementoConfig.walCheckpointIntervalMs,
             walSizeWarningThreshold: mementoConfig.walSizeWarningThreshold,
@@ -71,16 +78,21 @@ export async function initializeServices(db) {
             useDedicatedConnection: mementoConfig.walCheckpointUseDedicatedConnection,
             maxRetries: mementoConfig.walCheckpointMaxRetries,
             retryBackoffMs: mementoConfig.walCheckpointRetryBackoffMs
-        }, logger, performanceMonitor);
+        }, logger, performanceMonitor, runtimeDiagnosticsLogger);
         const databaseLockMonitor = new DatabaseLockMonitor(db, {
             intervalMs: mementoConfig.lockMonitorIntervalMs,
             warningThresholdMs: mementoConfig.lockMonitorWarningThresholdMs,
             dangerThresholdMs: mementoConfig.lockMonitorDangerThresholdMs,
             criticalThresholdMs: mementoConfig.lockMonitorCriticalThresholdMs
-        }, logger, performanceMonitor, walCheckpointScheduler);
-        walCheckpointScheduler.start();
-        databaseLockMonitor.start();
-        logger.info('WAL 체크포인트 스케줄러 및 데이터베이스 락 모니터 시작됨');
+        }, logger, performanceMonitor, walCheckpointScheduler, runtimeDiagnosticsLogger);
+        if (mementoConfig.walCheckpointEnabled) {
+            walCheckpointScheduler.start();
+            logger.info('WAL 체크포인트 스케줄러 시작됨');
+        }
+        if (mementoConfig.dbLockMonitorEnabled) {
+            databaseLockMonitor.start();
+            logger.info('데이터베이스 락 모니터 시작됨');
+        }
         let consolidationScoreService;
         const writeCoalescingManager = new WriteCoalescingManager(1000, async (writes) => {
             if (!db || writes.length === 0)
@@ -128,6 +140,7 @@ export async function initializeServices(db) {
         const introspectionScanCache = new IntrospectionScanCache();
         const telemetryRepository = new TelemetryRepository(db);
         const batchScheduler = getBatchScheduler();
+        batchScheduler.setDiagnosticsLogger(runtimeDiagnosticsLogger);
         batchScheduler.setTelemetryCleanupRepository(telemetryRepository);
         const telemetryService = new TelemetryService(telemetryRepository, () => getBatchScheduler());
         batchScheduler.setIntrospectionScanCache(introspectionScanCache);
@@ -137,7 +150,94 @@ export async function initializeServices(db) {
             telemetryService
         });
         batchScheduler.setSleepConsolidationService(sleepConsolidationService);
-        await batchScheduler.start(db, reflexionWorker);
+        if (mementoConfig.batchSchedulerEnabled) {
+            await batchScheduler.start(db, reflexionWorker);
+        }
+        let runtimeDiagnosticsSamplerCleanup;
+        if (mementoConfig.diagnosticsEnabled) {
+            let runtimeDiagnosticsSamplerStopped = false;
+            let runtimeDiagnosticsSamplerInFlight = null;
+            let runtimeDiagnosticsSamplerTimer = null;
+            const scheduleRuntimeDiagnosticsSampler = () => {
+                if (runtimeDiagnosticsSamplerStopped) {
+                    return;
+                }
+                runtimeDiagnosticsSamplerTimer = setTimeout(() => {
+                    runtimeDiagnosticsSamplerTimer = null;
+                    void runRuntimeDiagnosticsSampler();
+                }, mementoConfig.diagnosticsIntervalMs);
+                runtimeDiagnosticsSamplerTimer.unref?.();
+            };
+            const runRuntimeDiagnosticsSampler = async () => {
+                if (runtimeDiagnosticsSamplerStopped) {
+                    return;
+                }
+                const currentRun = (async () => {
+                    if (runtimeDiagnosticsSamplerStopped) {
+                        return;
+                    }
+                    try {
+                        const batchSchedulerStatus = batchScheduler.getStatus();
+                        await runtimeDiagnosticsLogger.writeSample({
+                            type: 'runtime_sample',
+                            timestamp: new Date().toISOString(),
+                            memory: process.memoryUsage(),
+                            uptime: process.uptime(),
+                            batchScheduler: {
+                                isRunning: batchSchedulerStatus.isRunning,
+                                activeJobs: batchSchedulerStatus.activeJobs ?? [],
+                                uptime: batchSchedulerStatus.uptime ?? 0,
+                                lastExecution: batchSchedulerStatus.lastExecution
+                                    ? Object.fromEntries(Array.from(batchSchedulerStatus.lastExecution.entries()).map(([jobName, executedAt]) => [
+                                        jobName,
+                                        executedAt.toISOString()
+                                    ]))
+                                    : undefined,
+                                totalExecutions: batchSchedulerStatus.totalExecutions
+                                    ? Object.fromEntries(batchSchedulerStatus.totalExecutions.entries())
+                                    : undefined,
+                                errorCount: batchSchedulerStatus.errorCount
+                                    ? Object.fromEntries(batchSchedulerStatus.errorCount.entries())
+                                    : undefined
+                            },
+                            walCheckpointEnabled: mementoConfig.walCheckpointEnabled,
+                            dbLockMonitorEnabled: mementoConfig.dbLockMonitorEnabled
+                        });
+                    }
+                    catch (error) {
+                        try {
+                            logger.error('런타임 진단 샘플 기록 실패', {
+                                error: error instanceof Error ? error.message : String(error)
+                            });
+                        }
+                        catch {
+                            // diagnostics best-effort: sampler failure must not abort bootstrap
+                        }
+                    }
+                })();
+                runtimeDiagnosticsSamplerInFlight = currentRun;
+                try {
+                    await currentRun;
+                }
+                finally {
+                    if (runtimeDiagnosticsSamplerInFlight === currentRun) {
+                        runtimeDiagnosticsSamplerInFlight = null;
+                    }
+                }
+                if (!runtimeDiagnosticsSamplerStopped) {
+                    scheduleRuntimeDiagnosticsSampler();
+                }
+            };
+            scheduleRuntimeDiagnosticsSampler();
+            runtimeDiagnosticsSamplerCleanup = async () => {
+                runtimeDiagnosticsSamplerStopped = true;
+                if (runtimeDiagnosticsSamplerTimer) {
+                    clearTimeout(runtimeDiagnosticsSamplerTimer);
+                    runtimeDiagnosticsSamplerTimer = null;
+                }
+                await runtimeDiagnosticsSamplerInFlight;
+            };
+        }
         return {
             searchEngine,
             hybridSearchEngine,
@@ -159,7 +259,9 @@ export async function initializeServices(db) {
             batchScheduler,
             introspectionScanCache,
             sleepConsolidationService,
-            telemetryService
+            telemetryService,
+            runtimeDiagnosticsLogger,
+            runtimeDiagnosticsSamplerCleanup
         };
     }
     catch (error) {

package/node_modules/@memento/core/dist/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"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"}

package/node_modules/@memento/core/dist/domains/embedding/services/embedding-migration-service.d.ts

@@ -15,9 +15,15 @@ export declare class EmbeddingMigrationService {
     createPlan(sourceProvider: EmbeddingProvider, targetProvider: EmbeddingProvider, overrides?: Partial<EmbeddingMigrationPlan>): EmbeddingMigrationPlan;
     listTargets(db: Database, plan: EmbeddingMigrationPlan, limit?: number): EmbeddingMigrationTarget[];
     initializeProgress(total: number, resumeFromId?: string): MigrationProgress;
+    private resolveEffectiveMonitor;
     execute(db: Database, plan: EmbeddingMigrationPlan, monitor?: MigrationMonitorOptions): Promise<MigrationResult>;
+    private processMigrationRow;
+    private runMigrationBatchLoop;
+    private finalizeMigrationExecution;
     private safeParseEmbedding;
     rollback(db: Database, entries: ReadonlyArray<MigrationRollbackEntry>): void;
+    private applyRollbackDelete;
+    private applyRollbackRestore;
     listHistory(db: Database, limit?: number): MigrationHistoryRecord[];
 }
 export declare const embeddingMigrationService: EmbeddingMigrationService;

package/node_modules/@memento/core/dist/domains/embedding/services/embedding-migration-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedding-migration-service.d.ts","sourceRoot":"","sources":["../../../../src/domains/embedding/services/embedding-migration-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAuC,MAAM,0CAA0C,CAAC;AACvH,OAAO,KAAK,EAEV,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EAEjB,sBAAsB,EACtB,eAAe,EAIhB,MAAM,0CAA0C,CAAC;AA+BlD;;;;GAIG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,YAAY;IAcpB,UAAU,CACR,cAAc,EAAE,iBAAiB,EACjC,cAAc,EAAE,iBAAiB,EACjC,SAAS,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC9C,sBAAsB;IAiCzB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,wBAAwB,EAAE;IAsCnG,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAcrE,OAAO,CACX,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,sBAAsB,EAC5B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,eAAe,CAAC;IA2O3B,OAAO,CAAC,kBAAkB;IAc1B,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,sBAAsB,CAAC,GAAG,IAAI;IA+D5E,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,GAAE,MAAW,GAAG,sBAAsB,EAAE;CAGxE;AAED,eAAO,MAAM,yBAAyB,2BAAkC,CAAC"}
+{"version":3,"file":"embedding-migration-service.d.ts","sourceRoot":"","sources":["../../../../src/domains/embedding/services/embedding-migration-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAa,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAuC,MAAM,0CAA0C,CAAC;AACvH,OAAO,KAAK,EAEV,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EAEjB,sBAAsB,EACtB,eAAe,EAIhB,MAAM,0CAA0C,CAAC;AA+BlD;;;;GAIG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,YAAY;IAcpB,UAAU,CACR,cAAc,EAAE,iBAAiB,EACjC,cAAc,EAAE,iBAAiB,EACjC,SAAS,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC9C,sBAAsB;IAiCzB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,wBAAwB,EAAE;IAsCnG,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAe3E,OAAO,CAAC,uBAAuB;IAMzB,OAAO,CACX,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,sBAAsB,EAC5B,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,eAAe,CAAC;IA6H3B,OAAO,CAAC,mBAAmB;IAyG3B,OAAO,CAAC,qBAAqB;IA0B7B,OAAO,CAAC,0BAA0B;IAsDlC,OAAO,CAAC,kBAAkB;IAc1B,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,sBAAsB,CAAC,GAAG,IAAI;IA+C5E,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,oBAAoB;IAoB5B,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,GAAE,MAAW,GAAG,sBAAsB,EAAE;CAGxE;AAED,eAAO,MAAM,yBAAyB,2BAAkC,CAAC"}

package/node_modules/@memento/core/dist/domains/embedding/services/embedding-migration-service.js

@@ -115,10 +115,13 @@ export class EmbeddingMigrationService {
             stepHistory: []
         };
     }
-    async execute(db, plan, monitor = {}) {
-        const effectiveMonitor = monitor.runId && !monitor.reporter
+    resolveEffectiveMonitor(monitor) {
+        return monitor.runId && !monitor.reporter
             ? { ...monitor, reporter: migrationMonitorService }
             : monitor;
+    }
+    async execute(db, plan, monitor = {}) {
+        const effectiveMonitor = this.resolveEffectiveMonitor(monitor);
         const totalRow = db
             .prepare('SELECT COUNT(*) AS count FROM memory_embedding WHERE embedding_provider = ?')
             .get(plan.sourceProvider);
@@ -147,7 +150,6 @@ export class EmbeddingMigrationService {
                 rolledBack: false
             };
         }
-        let lastProcessedId = plan.resumeFromId ?? null;
         const selectStatement = db.prepare(`
       SELECT memory_id, embedding, model, embedding_provider, projection_type, dim, dimensions, created_at
       FROM memory_embedding
@@ -190,67 +192,95 @@ export class EmbeddingMigrationService {
     `);
         const processBatch = (batch) => {
             for (const row of batch) {
-                progress.processed += 1;
-                progress.lastMemoryId = row.memory_id;
-                try {
-                    const parsed = this.safeParseEmbedding(row.embedding);
-                    const assessment = vectorCompatibilityService.assessProviderCompatibility(parsed, plan.targetProvider, {
-                        targetDimensions: plan.targetDimensions,
-                        normalization: normalizationMode
+                this.processMigrationRow({
+                    row,
+                    plan,
+                    normalizationMode,
+                    existingStatement,
+                    upsertStatement,
+                    progress,
+                    errors,
+                    rollbackEntries,
+                    reportEvery,
+                    effectiveMonitor
+                });
+            }
+        };
+        this.runMigrationBatchLoop(plan, selectStatement, progress, plan.resumeFromId ?? null, processBatch, effectiveMonitor);
+        return this.finalizeMigrationExecution({
+            db,
+            plan,
+            progress,
+            step,
+            errors,
+            rollbackEntries,
+            effectiveMonitor
+        });
+    }
+    processMigrationRow(params) {
+        const { row, plan, normalizationMode, existingStatement, upsertStatement, progress, errors, rollbackEntries, reportEvery, effectiveMonitor } = params;
+        progress.processed += 1;
+        progress.lastMemoryId = row.memory_id;
+        try {
+            const parsed = this.safeParseEmbedding(row.embedding);
+            const assessment = vectorCompatibilityService.assessProviderCompatibility(parsed, plan.targetProvider, {
+                targetDimensions: plan.targetDimensions,
+                normalization: normalizationMode
+            });
+            const storedVector = assessment.projection.vector;
+            const serialized = JSON.stringify(storedVector);
+            const projectionType = assessment.projection.projectionType;
+            const normalizedFlag = assessment.projection.normalized ? 1 : 0;
+            const targetModel = plan.targetModel ?? row.model ?? `compat-${plan.targetProvider}`;
+            const createdBy = plan.createdBy ?? DEFAULT_CREATED_BY;
+            if (!plan.dryRun) {
+                const existing = existingStatement.get(row.memory_id, plan.targetProvider, projectionType);
+                upsertStatement.run(row.memory_id, plan.targetProvider, projectionType, serialized, plan.targetDimensions, targetModel, plan.targetDimensions, 32, normalizedFlag, 1, createdBy);
+                if (existing) {
+                    rollbackEntries.push({
+                        memoryId: row.memory_id,
+                        provider: plan.targetProvider,
+                        projectionType,
+                        operation: 'restore',
+                        embedding: existing.embedding,
+                        dim: existing.dim,
+                        dimensions: existing.dimensions,
+                        model: existing.model,
+                        precision: existing.precision,
+                        normalized: existing.normalized,
+                        version: existing.version,
+                        createdBy: existing.created_by,
+                        createdAt: existing.created_at ?? undefined
                     });
-                    const storedVector = assessment.projection.vector;
-                    const serialized = JSON.stringify(storedVector);
-                    const projectionType = assessment.projection.projectionType;
-                    const normalizedFlag = assessment.projection.normalized ? 1 : 0;
-                    const targetModel = plan.targetModel ?? row.model ?? `compat-${plan.targetProvider}`;
-                    const createdBy = plan.createdBy ?? DEFAULT_CREATED_BY;
-                    if (!plan.dryRun) {
-                        const existing = existingStatement.get(row.memory_id, plan.targetProvider, projectionType);
-                        upsertStatement.run(row.memory_id, plan.targetProvider, projectionType, serialized, plan.targetDimensions, targetModel, plan.targetDimensions, 32, normalizedFlag, 1, createdBy);
-                        if (existing) {
-                            rollbackEntries.push({
-                                memoryId: row.memory_id,
-                                provider: plan.targetProvider,
-                                projectionType,
-                                operation: 'restore',
-                                embedding: existing.embedding,
-                                dim: existing.dim,
-                                dimensions: existing.dimensions,
-                                model: existing.model,
-                                precision: existing.precision,
-                                normalized: existing.normalized,
-                                version: existing.version,
-                                createdBy: existing.created_by,
-                                createdAt: existing.created_at ?? undefined
-                            });
-                        }
-                        else {
-                            rollbackEntries.push({
-                                memoryId: row.memory_id,
-                                provider: plan.targetProvider,
-                                projectionType,
-                                operation: 'delete'
-                            });
-                        }
-                    }
-                    progress.succeeded += 1;
                 }
-                catch (error) {
-                    progress.failed += 1;
-                    errors.push({
+                else {
+                    rollbackEntries.push({
                         memoryId: row.memory_id,
                         provider: plan.targetProvider,
-                        message: error instanceof Error ? error.message : 'Unknown error'
+                        projectionType,
+                        operation: 'delete'
                     });
                 }
-                finally {
-                    progress.updatedAt = new Date();
-                    if (reportEvery > 0 && progress.processed % reportEvery === 0) {
-                        this.notifyProgress(progress, effectiveMonitor);
-                    }
-                }
             }
-        };
+            progress.succeeded += 1;
+        }
+        catch (error) {
+            progress.failed += 1;
+            errors.push({
+                memoryId: row.memory_id,
+                provider: plan.targetProvider,
+                message: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+        finally {
+            progress.updatedAt = new Date();
+            if (reportEvery > 0 && progress.processed % reportEvery === 0) {
+                this.notifyProgress(progress, effectiveMonitor);
+            }
+        }
+    }
+    runMigrationBatchLoop(plan, selectStatement, progress, initialLastId, processBatch, effectiveMonitor) {
+        let lastProcessedId = initialLastId;
         while (true) {
             const batch = selectStatement.all(plan.sourceProvider, lastProcessedId, lastProcessedId, plan.batchSize ?? DEFAULT_BATCH_SIZE);
             if (!batch.length) {
@@ -260,6 +290,9 @@ export class EmbeddingMigrationService {
             lastProcessedId = batch[batch.length - 1]?.memory_id ?? lastProcessedId;
             this.notifyProgress(progress, effectiveMonitor);
         }
+    }
+    finalizeMigrationExecution(params) {
+        const { db, plan, progress, step, errors, rollbackEntries, effectiveMonitor } = params;
         const endTime = new Date();
         const success = progress.failed === 0;
         let rolledBack = false;
@@ -342,16 +375,22 @@ export class EmbeddingMigrationService {
     `);
         for (const entry of [...entries].reverse()) {
             if (entry.operation === 'delete') {
-                deleteStatement.run(entry.memoryId, entry.provider, entry.projectionType);
+                this.applyRollbackDelete(deleteStatement, entry);
             }
             else {
-                if (!entry.embedding) {
-                    throw new Error(`Rollback 데이터가 누락되었습니다: ${entry.memoryId}`);
-                }
-                restoreStatement.run(entry.memoryId, entry.provider, entry.projectionType, entry.embedding, entry.dim ?? entry.dimensions ?? 0, entry.model ?? null, entry.dimensions ?? entry.dim ?? 0, entry.precision ?? 32, entry.normalized ?? 0, entry.version ?? 1, entry.createdBy ?? DEFAULT_CREATED_BY, entry.createdAt ?? new Date().toISOString());
+                this.applyRollbackRestore(restoreStatement, entry);
             }
         }
     }
+    applyRollbackDelete(deleteStatement, entry) {
+        deleteStatement.run(entry.memoryId, entry.provider, entry.projectionType);
+    }
+    applyRollbackRestore(restoreStatement, entry) {
+        if (!entry.embedding) {
+            throw new Error(`Rollback 데이터가 누락되었습니다: ${entry.memoryId}`);
+        }
+        restoreStatement.run(entry.memoryId, entry.provider, entry.projectionType, entry.embedding, entry.dim ?? entry.dimensions ?? 0, entry.model ?? null, entry.dimensions ?? entry.dim ?? 0, entry.precision ?? 32, entry.normalized ?? 0, entry.version ?? 1, entry.createdBy ?? DEFAULT_CREATED_BY, entry.createdAt ?? new Date().toISOString());
+    }
     listHistory(db, limit = 20) {
         return migrationHistoryService.listHistory(db, { limit });
     }