agent-nuvira 2.7.2 → 3.0.0

package/dist/memory/enhanced-manager.js

@@ -1,280 +0,0 @@
-/**
- * EnhancedMemoryManager — Memory manager with background sync.
- *
- * Extends the base MemoryManager with:
- * - Background sync for zero-cost per-turn operations
- * - Session-end extraction for fact distillation
- * - Drift detection for memory file safety
- * - Daemon thread management
- *
- * This is the recommended entry point for production use.
- */
-import { EventEmitter } from 'events';
-import { getMemoryManager } from './manager.js';
-import { BackgroundSyncManager } from './background-sync.js';
-import { SessionExtractionManager } from './session-extraction.js';
-import { DriftDetector } from './drift-detector.js';
-import { getSQLiteStore } from './sqlite-store.js';
-import { getCrossSessionPersistence } from './cross-session.js';
-import { logger } from '../utils/logger.js';
-// ─── Enhanced Memory Manager ────────────────────────────────────────────────
-export class EnhancedMemoryManager extends EventEmitter {
-    baseManager;
-    backgroundSync;
-    sessionExtraction;
-    driftDetector;
-    config;
-    metrics;
-    sessionId = null;
-    sqliteStore = null;
-    crossSession = null;
-    constructor(config) {
-        super();
-        this.config = {
-            enableBackgroundSync: config?.enableBackgroundSync ?? true,
-            enableDriftDetection: config?.enableDriftDetection ?? true,
-            enableSessionExtraction: config?.enableSessionExtraction ?? true,
-            enableSQLite: config?.enableSQLite ?? true,
-            syncConcurrency: config?.syncConcurrency ?? 3,
-            drainTimeoutMs: config?.drainTimeoutMs ?? 5000,
-        };
-        this.baseManager = getMemoryManager();
-        this.backgroundSync = new BackgroundSyncManager({
-            maxConcurrent: this.config.syncConcurrency,
-            drainTimeoutMs: this.config.drainTimeoutMs,
-        });
-        this.sessionExtraction = new SessionExtractionManager();
-        this.driftDetector = new DriftDetector();
-        // Initialize SQLite if enabled
-        if (this.config.enableSQLite) {
-            this.sqliteStore = getSQLiteStore();
-            this.crossSession = getCrossSessionPersistence();
-        }
-        this.metrics = {
-            turnsBuffered: 0,
-            factsExtracted: 0,
-            driftsDetected: 0,
-            backgroundTasksQueued: 0,
-            backgroundTasksCompleted: 0,
-        };
-        this.setupEventHandlers();
-    }
-    /**
-     * Setup event handlers for background sync.
-     */
-    setupEventHandlers() {
-        this.backgroundSync.on('task:completed', (event) => {
-            this.metrics.backgroundTasksCompleted++;
-            this.emit('sync:completed', event);
-        });
-        this.backgroundSync.on('task:failed', (event) => {
-            logger.debug(`Background sync task failed: ${event.error}`);
-            this.emit('sync:failed', event);
-        });
-        this.backgroundSync.on('task:execute', (task, resolve, reject) => {
-            this.executeSyncTask(task, resolve, reject);
-        });
-    }
-    /**
-     * Begin a session.
-     */
-    async startSession(sessionId) {
-        this.sessionId = sessionId;
-        await this.baseManager.startSession(sessionId);
-        // Load cross-session context if SQLite is enabled
-        if (this.crossSession) {
-            const context = await this.crossSession.loadSessionContext(sessionId);
-            this.emit('session:started', { sessionId, contextLoaded: true });
-        }
-        else {
-            this.emit('session:started', { sessionId, contextLoaded: false });
-        }
-    }
-    /**
-     * Build memory block for a query.
-     */
-    async buildMemoryBlock(query) {
-        return this.baseManager.buildMemoryBlock(query);
-    }
-    /**
-     * Record a completed user↔assistant turn (buffered, zero-cost).
-     */
-    async recordTurn(userText, assistantText) {
-        // Buffer for session extraction
-        if (this.config.enableSessionExtraction) {
-            this.sessionExtraction.bufferTurn(userText, assistantText);
-            this.metrics.turnsBuffered++;
-        }
-        // Save to SQLite if enabled
-        if (this.sqliteStore && this.sessionId) {
-            const trajectoryId = `traj_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
-            this.sqliteStore.addTrajectory({
-                id: trajectoryId,
-                sessionId: this.sessionId,
-                userText,
-                assistantText,
-            });
-        }
-        // Queue background sync
-        if (this.config.enableBackgroundSync) {
-            this.backgroundSync.enqueue({
-                type: 'sync',
-                data: { userText, assistantText, sessionId: this.sessionId },
-                priority: 0,
-            });
-            this.metrics.backgroundTasksQueued++;
-        }
-        // Record in base manager (best-effort)
-        await this.baseManager.recordTurn(userText, assistantText).catch(() => { });
-    }
-    /**
-     * End the session — flush buffered turns into durable facts.
-     */
-    async endSession() {
-        const sid = this.sessionId;
-        if (!sid)
-            return null;
-        // Extract facts from buffered turns
-        if (this.config.enableSessionExtraction) {
-            const result = await this.sessionExtraction.extractAtSessionEnd();
-            this.metrics.factsExtracted += result.statistics.factsExtracted;
-            // Save extracted facts to SQLite
-            if (this.sqliteStore) {
-                for (const fact of result.facts) {
-                    this.sqliteStore.addMemory({
-                        id: `mem_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
-                        content: fact.content,
-                        type: fact.type,
-                        tags: fact.tags,
-                        source: fact.source,
-                        confidence: fact.confidence,
-                        sessionId: sid,
-                    });
-                }
-                // Save extracted patterns
-                for (const pattern of result.patterns) {
-                    this.sqliteStore.upsertPattern({
-                        id: `pat_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
-                        pattern,
-                        examples: [],
-                        confidence: 0.5,
-                    });
-                }
-                // Save extracted lessons
-                for (const lesson of result.lessons) {
-                    this.sqliteStore.addLesson({
-                        id: `les_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
-                        lesson,
-                        context: 'session-extraction',
-                        severity: 'medium',
-                    });
-                }
-            }
-            this.emit('session:extracted', result);
-        }
-        // Drain background sync queue
-        if (this.config.enableBackgroundSync) {
-            await this.backgroundSync.drain(this.config.drainTimeoutMs);
-        }
-        // End base session
-        const endedSid = await this.baseManager.endSession();
-        this.sessionId = null;
-        this.emit('session:ended', { sessionId: sid });
-        return endedSid;
-    }
-    /**
-     * Execute a sync task in background.
-     */
-    async executeSyncTask(task, resolve, reject) {
-        try {
-            // Process the sync task
-            await this.baseManager.recordTurn(task.data.userText, task.data.assistantText);
-            resolve();
-        }
-        catch (err) {
-            reject(err);
-        }
-    }
-    /**
-     * Add a memory with drift detection.
-     */
-    async addMemoryWithDriftDetection(filePath, content) {
-        if (this.config.enableDriftDetection) {
-            // Check for drift
-            const driftCheck = this.driftDetector.checkDrift(filePath);
-            if (driftCheck.hasDrift) {
-                this.metrics.driftsDetected++;
-                this.emit('drift:detected', { path: filePath, driftCheck });
-                // Create backup
-                const backupPath = this.driftDetector.backup(filePath);
-                // Merge changes
-                const merged = this.driftDetector.merge(filePath, content, driftCheck.currentContent || '');
-                // Write merged content
-                const fs = await import('fs');
-                fs.writeFileSync(filePath, merged, 'utf-8');
-                return { success: true, driftDetected: true };
-            }
-            // Snapshot before write
-            this.driftDetector.snapshot(filePath);
-        }
-        // Write content
-        const fs = await import('fs');
-        fs.writeFileSync(filePath, content, 'utf-8');
-        return { success: true, driftDetected: false };
-    }
-    /**
-     * Get metrics.
-     */
-    getMetrics() {
-        return {
-            ...this.metrics,
-            backgroundSync: this.backgroundSync.getMetrics(),
-            sqlite: this.sqliteStore?.getStats(),
-        };
-    }
-    /**
-     * Get SQLite store.
-     */
-    getSQLiteStore() {
-        return this.sqliteStore;
-    }
-    /**
-     * Get cross-session persistence.
-     */
-    getCrossSession() {
-        return this.crossSession;
-    }
-    /**
-     * Get background sync manager.
-     */
-    getBackgroundSync() {
-        return this.backgroundSync;
-    }
-    /**
-     * Get drift detector.
-     */
-    getDriftDetector() {
-        return this.driftDetector;
-    }
-    /**
-     * Shutdown gracefully.
-     */
-    async shutdown() {
-        await this.backgroundSync.shutdown();
-        this.removeAllListeners();
-    }
-}
-// ─── Singleton ──────────────────────────────────────────────────────────────
-let _instance = null;
-export function getEnhancedMemoryManager() {
-    if (!_instance)
-        _instance = new EnhancedMemoryManager();
-    return _instance;
-}
-export function resetEnhancedMemoryManager() {
-    if (_instance) {
-        _instance.shutdown();
-        _instance = null;
-    }
-}
-//# sourceMappingURL=enhanced-manager.js.map

package/dist/memory/enhanced-manager.js.map

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

package/dist/memory/session-extraction.d.ts

@@ -1,93 +0,0 @@
-/**
- * SessionExtraction — Extract facts from buffered turns at session end.
- *
- * Distills conversation turns into durable facts, patterns, and lessons.
- * Uses rules + optional LLM for extraction.
- *
- * Features:
- * - Rule-based extraction (no LLM required)
- * - LLM-enhanced extraction (optional)
- * - Pattern detection
- * - Lesson extraction
- * - Confidence scoring
- */
-import { type MemoryStore } from '../tools/memory-tools.js';
-interface ExtractedFact {
-    content: string;
-    type: 'fact' | 'preference' | 'lesson' | 'observation' | 'pattern';
-    confidence: number;
-    source: string;
-    tags: string[];
-}
-interface ExtractionResult {
-    facts: ExtractedFact[];
-    patterns: string[];
-    lessons: string[];
-    statistics: {
-        turnsProcessed: number;
-        factsExtracted: number;
-        patternsDetected: number;
-        lessonsLearned: number;
-    };
-}
-export declare class SessionExtractionManager {
-    private memoryStore;
-    private bufferedTurns;
-    private maxBufferedTurns;
-    constructor(memoryStore?: MemoryStore);
-    /**
-     * Buffer a conversation turn.
-     */
-    bufferTurn(userText: string, assistantText: string): void;
-    /**
-     * Extract facts from buffered turns at session end.
-     */
-    extractAtSessionEnd(): Promise<ExtractionResult>;
-    /**
-     * Extract facts from a single turn.
-     */
-    private extractFromTurn;
-    /**
-     * Extract preference from user text.
-     */
-    private extractPreference;
-    /**
-     * Extract project fact from conversation.
-     */
-    private extractProjectFact;
-    /**
-     * Extract lesson from assistant text.
-     */
-    private extractLesson;
-    /**
-     * Check if this is a repeated action.
-     */
-    private isRepeatedAction;
-    /**
-     * Extract pattern from turn.
-     */
-    private extractPattern;
-    /**
-     * Extract topic from text.
-     */
-    private extractTopic;
-    /**
-     * Extract observation from text.
-     */
-    private extractObservation;
-    /**
-     * Detect cross-turn patterns.
-     */
-    private detectCrossTurnPatterns;
-    /**
-     * Get buffered turn count.
-     */
-    getBufferedTurnCount(): number;
-    /**
-     * Clear buffer.
-     */
-    clearBuffer(): void;
-}
-export declare function getSessionExtractionManager(): SessionExtractionManager;
-export {};
-//# sourceMappingURL=session-extraction.d.ts.map

package/dist/memory/session-extraction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-extraction.d.ts","sourceRoot":"","sources":["../../src/memory/session-extraction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAU5E,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,aAAa,GAAG,SAAS,CAAC;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,UAAU,gBAAgB;IACxB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE;QACV,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAID,qBAAa,wBAAwB;IACnC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,gBAAgB,CAAM;gBAElB,WAAW,CAAC,EAAE,WAAW;IAIrC;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAazD;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA2CtD;;OAEG;IACH,OAAO,CAAC,eAAe;IAuEvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgC/B;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;OAEG;IACH,WAAW,IAAI,IAAI;CAGpB;AAMD,wBAAgB,2BAA2B,IAAI,wBAAwB,CAGtE"}

package/dist/memory/session-extraction.js

@@ -1,290 +0,0 @@
-/**
- * SessionExtraction — Extract facts from buffered turns at session end.
- *
- * Distills conversation turns into durable facts, patterns, and lessons.
- * Uses rules + optional LLM for extraction.
- *
- * Features:
- * - Rule-based extraction (no LLM required)
- * - LLM-enhanced extraction (optional)
- * - Pattern detection
- * - Lesson extraction
- * - Confidence scoring
- */
-import { getMemoryStore } from '../tools/memory-tools.js';
-// ─── Session Extraction Manager ─────────────────────────────────────────────
-export class SessionExtractionManager {
-    memoryStore;
-    bufferedTurns = [];
-    maxBufferedTurns = 50;
-    constructor(memoryStore) {
-        this.memoryStore = memoryStore || getMemoryStore();
-    }
-    /**
-     * Buffer a conversation turn.
-     */
-    bufferTurn(userText, assistantText) {
-        this.bufferedTurns.push({
-            userText,
-            assistantText,
-            timestamp: Date.now(),
-        });
-        // Keep buffer bounded
-        if (this.bufferedTurns.length > this.maxBufferedTurns) {
-            this.bufferedTurns = this.bufferedTurns.slice(-this.maxBufferedTurns);
-        }
-    }
-    /**
-     * Extract facts from buffered turns at session end.
-     */
-    async extractAtSessionEnd() {
-        const turns = [...this.bufferedTurns];
-        this.bufferedTurns = [];
-        const facts = [];
-        const patterns = [];
-        const lessons = [];
-        // Rule-based extraction
-        for (const turn of turns) {
-            const extracted = this.extractFromTurn(turn);
-            facts.push(...extracted.facts);
-            patterns.push(...extracted.patterns);
-            lessons.push(...extracted.lessons);
-        }
-        // Detect cross-turn patterns
-        const crossTurnPatterns = this.detectCrossTurnPatterns(turns);
-        patterns.push(...crossTurnPatterns);
-        // Store extracted facts
-        for (const fact of facts) {
-            this.memoryStore.add({
-                content: fact.content,
-                type: fact.type,
-                tags: fact.tags,
-                source: fact.source,
-            });
-        }
-        return {
-            facts,
-            patterns,
-            lessons,
-            statistics: {
-                turnsProcessed: turns.length,
-                factsExtracted: facts.length,
-                patternsDetected: patterns.length,
-                lessonsLearned: lessons.length,
-            },
-        };
-    }
-    /**
-     * Extract facts from a single turn.
-     */
-    extractFromTurn(turn) {
-        const facts = [];
-        const patterns = [];
-        const lessons = [];
-        const userText = turn.userText.toLowerCase();
-        const assistantText = turn.assistantText.toLowerCase();
-        // Extract preferences
-        if (userText.includes('prefer') || userText.includes('like') || userText.includes('want')) {
-            facts.push({
-                content: this.extractPreference(turn.userText),
-                type: 'preference',
-                confidence: 0.8,
-                source: 'user-statement',
-                tags: ['preference', 'user'],
-            });
-        }
-        // Extract facts about the project
-        if (userText.includes('project') || userText.includes('code') || userText.includes('file')) {
-            const fact = this.extractProjectFact(turn.userText, turn.assistantText);
-            if (fact) {
-                facts.push(fact);
-            }
-        }
-        // Extract lessons from errors
-        if (assistantText.includes('error') || assistantText.includes('failed') || assistantText.includes('fix')) {
-            const lesson = this.extractLesson(turn.assistantText);
-            if (lesson) {
-                lessons.push(lesson);
-                facts.push({
-                    content: lesson,
-                    type: 'lesson',
-                    confidence: 0.9,
-                    source: 'error-resolution',
-                    tags: ['lesson', 'error', 'fix'],
-                });
-            }
-        }
-        // Extract patterns from repeated actions
-        if (this.isRepeatedAction(turn)) {
-            patterns.push(this.extractPattern(turn));
-        }
-        // Extract observations about the environment
-        if (userText.includes('environment') || userText.includes('setup') || userText.includes('config')) {
-            facts.push({
-                content: this.extractObservation(turn.userText),
-                type: 'observation',
-                confidence: 0.7,
-                source: 'environment',
-                tags: ['observation', 'environment'],
-            });
-        }
-        return {
-            facts,
-            patterns,
-            lessons,
-            statistics: {
-                turnsProcessed: 1,
-                factsExtracted: facts.length,
-                patternsDetected: patterns.length,
-                lessonsLearned: lessons.length,
-            },
-        };
-    }
-    /**
-     * Extract preference from user text.
-     */
-    extractPreference(text) {
-        // Simple extraction - find preference statement
-        const patterns = [
-            /(?:prefer|like|want|need)\s+(.+?)(?:\.|$)/i,
-            /(?:please|kindly)\s+(.+?)(?:\.|$)/i,
-            /(?:don't|do not)\s+(?:want|like)\s+(.+?)(?:\.|$)/i,
-        ];
-        for (const pattern of patterns) {
-            const match = text.match(pattern);
-            if (match) {
-                return `User preference: ${match[1].trim()}`;
-            }
-        }
-        return `User stated: ${text.slice(0, 200)}`;
-    }
-    /**
-     * Extract project fact from conversation.
-     */
-    extractProjectFact(userText, assistantText) {
-        // Look for factual statements about the project
-        const patterns = [
-            /(?:this project|the codebase|our app)\s+(?:is|uses|has|runs)\s+(.+?)(?:\.|$)/i,
-            /(?:we|I)\s+(?:use|are using|have)\s+(.+?)(?:\s+for|\s+to|\s+in|\s+on|\s+\.)/i,
-        ];
-        for (const pattern of patterns) {
-            const match = userText.match(pattern);
-            if (match) {
-                return {
-                    content: `Project fact: ${match[1].trim()}`,
-                    type: 'fact',
-                    confidence: 0.8,
-                    source: 'user-statement',
-                    tags: ['fact', 'project'],
-                };
-            }
-        }
-        return null;
-    }
-    /**
-     * Extract lesson from assistant text.
-     */
-    extractLesson(text) {
-        // Look for lesson patterns
-        const patterns = [
-            /(?:the issue|the problem|the error)\s+(?:was|is)\s+(.+?)(?:\.|$)/i,
-            /(?:to fix|to resolve|to solve)\s+(?:this|the)\s+(?:issue|problem|error),?\s+(.+?)(?:\.|$)/i,
-            /(?:the solution|the fix)\s+(?:is|was)\s+(.+?)(?:\.|$)/i,
-        ];
-        for (const pattern of patterns) {
-            const match = text.match(pattern);
-            if (match) {
-                return `Lesson learned: ${match[1].trim()}`;
-            }
-        }
-        return null;
-    }
-    /**
-     * Check if this is a repeated action.
-     */
-    isRepeatedAction(turn) {
-        // Simple heuristic - check for similar patterns
-        const recentTurns = this.bufferedTurns.slice(-5);
-        const userWords = turn.userText.toLowerCase().split(/\s+/);
-        let similarCount = 0;
-        for (const recent of recentTurns) {
-            const recentWords = recent.userText.toLowerCase().split(/\s+/);
-            const overlap = userWords.filter((w) => recentWords.includes(w)).length;
-            if (overlap > userWords.length * 0.5) {
-                similarCount++;
-            }
-        }
-        return similarCount >= 2;
-    }
-    /**
-     * Extract pattern from turn.
-     */
-    extractPattern(turn) {
-        return `Repeated pattern: User asked about ${this.extractTopic(turn.userText)}`;
-    }
-    /**
-     * Extract topic from text.
-     */
-    extractTopic(text) {
-        // Simple topic extraction
-        const words = text.toLowerCase().split(/\s+/);
-        const stopWords = new Set(['the', 'a', 'an', 'is', 'are', 'was', 'were', 'i', 'you', 'we', 'they', 'it']);
-        const meaningfulWords = words.filter((w) => !stopWords.has(w) && w.length > 3);
-        return meaningfulWords.slice(0, 3).join(' ') || 'unknown topic';
-    }
-    /**
-     * Extract observation from text.
-     */
-    extractObservation(text) {
-        return `Observation: ${text.slice(0, 200)}`;
-    }
-    /**
-     * Detect cross-turn patterns.
-     */
-    detectCrossTurnPatterns(turns) {
-        const patterns = [];
-        // Detect topic clustering
-        const topicCounts = new Map();
-        for (const turn of turns) {
-            const topic = this.extractTopic(turn.userText);
-            topicCounts.set(topic, (topicCounts.get(topic) || 0) + 1);
-        }
-        for (const [topic, count] of topicCounts) {
-            if (count >= 3) {
-                patterns.push(`Frequent topic: ${topic} (${count} times)`);
-            }
-        }
-        // Detect time-based patterns
-        if (turns.length >= 5) {
-            const timeGaps = [];
-            for (let i = 1; i < turns.length; i++) {
-                timeGaps.push(turns[i].timestamp - turns[i - 1].timestamp);
-            }
-            const avgGap = timeGaps.reduce((a, b) => a + b, 0) / timeGaps.length;
-            if (avgGap < 60_000) {
-                patterns.push('Rapid-fire conversation pattern detected');
-            }
-        }
-        return patterns;
-    }
-    /**
-     * Get buffered turn count.
-     */
-    getBufferedTurnCount() {
-        return this.bufferedTurns.length;
-    }
-    /**
-     * Clear buffer.
-     */
-    clearBuffer() {
-        this.bufferedTurns = [];
-    }
-}
-// ─── Singleton ──────────────────────────────────────────────────────────────
-let _instance = null;
-export function getSessionExtractionManager() {
-    if (!_instance)
-        _instance = new SessionExtractionManager();
-    return _instance;
-}
-//# sourceMappingURL=session-extraction.js.map