ai-mind-map 1.1.0

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

@@ -0,0 +1,165 @@
+/**
+ * AI Mind Map — Session Memory Manager
+ *
+ * Session-scoped memory management. Tracks facts and context within a single
+ * AI session: files worked on, tasks completed, decisions made, and token usage.
+ *
+ * Persists session data to SQLite so downstream components can query across
+ * sessions. Auto-generates a summary at session end.
+ *
+ * @module memory/session-memory
+ */
+import Database from 'better-sqlite3';
+import type { SessionSummary } from '../types.js';
+/** A fact recorded during a session. */
+export interface SessionFact {
+    id: number;
+    sessionId: string;
+    kind: 'file_worked_on' | 'task_completed' | 'decision_made' | 'note' | 'error' | 'context';
+    content: string;
+    /** Optional JSON-serialized metadata (e.g. { filePath, lineRange }). */
+    metadata: string | null;
+    createdAt: number;
+}
+/** Lightweight view returned by `listRecentSessions`. */
+export interface SessionListItem {
+    sessionId: string;
+    startedAt: number;
+    endedAt: number | null;
+    totalFacts: number;
+    summary: string;
+}
+/** Token usage counters tracked per session. */
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    contextTokens: number;
+    savedTokens: number;
+}
+/**
+ * Manages the lifecycle and content of an AI session.
+ *
+ * Usage:
+ * ```ts
+ * const sm = new SessionMemory(db);
+ * const id = sm.startSession();
+ * sm.addFact('file_worked_on', 'src/types.ts');
+ * sm.addFact('task_completed', 'Added Memory types');
+ * const summary = sm.endSession();
+ * ```
+ */
+export declare class SessionMemory {
+    private db;
+    private currentSessionId;
+    private currentStartedAt;
+    private tokenUsage;
+    private stmtInsertSession;
+    private stmtEndSession;
+    private stmtInsertFact;
+    private stmtGetFacts;
+    private stmtGetSession;
+    private stmtRecentSessions;
+    private stmtFactCountByKind;
+    private stmtUpdateTokenUsage;
+    private stmtDeleteSession;
+    private stmtDeleteFacts;
+    constructor(db: Database.Database);
+    /** Create tables if they don't already exist. */
+    private ensureSchema;
+    /** Prepare reusable statements. */
+    private prepareStatements;
+    /**
+     * Start a new session.
+     *
+     * @param sessionId - Optional custom ID. If omitted, a timestamped UUID-ish
+     *                    ID is generated.
+     * @returns The session ID.
+     * @throws If a session is already active.
+     */
+    startSession(sessionId?: string): string;
+    /**
+     * End the current session.
+     *
+     * Generates a summary from facts, persists token usage, and clears state.
+     *
+     * @returns The completed `SessionSummary`.
+     * @throws If no session is active.
+     */
+    endSession(): SessionSummary;
+    /**
+     * Get the current active session ID (or `null`).
+     */
+    getCurrentSessionId(): string | null;
+    /**
+     * Return full information about the currently active session.
+     */
+    getCurrentSessionInfo(): {
+        sessionId: string;
+        startedAt: number;
+        facts: SessionFact[];
+        tokenUsage: TokenUsage;
+        durationMs: number;
+    } | null;
+    /**
+     * Record a fact in the current session.
+     *
+     * @param kind     - Category of fact.
+     * @param content  - Human-readable description.
+     * @param metadata - Optional structured metadata (will be JSON-stringified).
+     * @returns The inserted fact ID.
+     */
+    addFact(kind: SessionFact['kind'], content: string, metadata?: Record<string, unknown>): number;
+    /**
+     * Retrieve all facts for a specific session.
+     */
+    getSessionFacts(sessionId: string): SessionFact[];
+    /**
+     * Get distinct files worked on in the current session.
+     */
+    getFilesWorkedOn(): string[];
+    /**
+     * Get tasks completed in the current session.
+     */
+    getTasksCompleted(): string[];
+    /**
+     * Get decisions made in the current session.
+     */
+    getDecisionsMade(): string[];
+    /**
+     * Record token usage for the current session.
+     *
+     * Values are *accumulated* (added to running totals).
+     */
+    recordTokenUsage(usage: Partial<TokenUsage>): void;
+    /** Read token usage counters for the active session. */
+    getTokenUsage(): TokenUsage;
+    /**
+     * List the N most recent sessions.
+     *
+     * @param limit - Maximum number of sessions to return (default 10).
+     */
+    listRecentSessions(limit?: number): SessionListItem[];
+    /**
+     * Get full details of a session by its ID.
+     */
+    getSession(sessionId: string): (SessionSummary & {
+        tokenUsage: TokenUsage;
+    }) | null;
+    /**
+     * Delete a session and all its facts.
+     *
+     * @returns `true` if the session existed and was deleted.
+     */
+    deleteSession(sessionId: string): boolean;
+    /**
+     * Build a `SessionSummary` from raw facts.
+     *
+     * Auto-generates a human-readable paragraph summarising the session's work.
+     */
+    private generateSummary;
+    private getFactsInternal;
+    private assertActiveSession;
+    /** Generate a session ID based on timestamp + random suffix. */
+    private generateSessionId;
+}
+//# sourceMappingURL=session-memory.d.ts.map

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

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

package/dist/memory/session-memory.js

@@ -0,0 +1,382 @@
+/**
+ * AI Mind Map — Session Memory Manager
+ *
+ * Session-scoped memory management. Tracks facts and context within a single
+ * AI session: files worked on, tasks completed, decisions made, and token usage.
+ *
+ * Persists session data to SQLite so downstream components can query across
+ * sessions. Auto-generates a summary at session end.
+ *
+ * @module memory/session-memory
+ */
+// ────────────────────────────────────────────────────────────────
+// SessionMemory Class
+// ────────────────────────────────────────────────────────────────
+/**
+ * Manages the lifecycle and content of an AI session.
+ *
+ * Usage:
+ * ```ts
+ * const sm = new SessionMemory(db);
+ * const id = sm.startSession();
+ * sm.addFact('file_worked_on', 'src/types.ts');
+ * sm.addFact('task_completed', 'Added Memory types');
+ * const summary = sm.endSession();
+ * ```
+ */
+export class SessionMemory {
+    db;
+    currentSessionId = null;
+    currentStartedAt = null;
+    tokenUsage = { inputTokens: 0, outputTokens: 0, contextTokens: 0, savedTokens: 0 };
+    // ── Prepared statements (lazy-initialized) ─────────────────
+    stmtInsertSession;
+    stmtEndSession;
+    stmtInsertFact;
+    stmtGetFacts;
+    stmtGetSession;
+    stmtRecentSessions;
+    stmtFactCountByKind;
+    stmtUpdateTokenUsage;
+    stmtDeleteSession;
+    stmtDeleteFacts;
+    constructor(db) {
+        this.db = db;
+        this.ensureSchema();
+        this.prepareStatements();
+    }
+    // ────────────────────────────────────────────────────────────
+    // Schema
+    // ────────────────────────────────────────────────────────────
+    /** Create tables if they don't already exist. */
+    ensureSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS sessions (
+        session_id   TEXT PRIMARY KEY,
+        started_at   INTEGER NOT NULL,
+        ended_at     INTEGER,
+        summary      TEXT NOT NULL DEFAULT '',
+        input_tokens  INTEGER NOT NULL DEFAULT 0,
+        output_tokens INTEGER NOT NULL DEFAULT 0,
+        context_tokens INTEGER NOT NULL DEFAULT 0,
+        saved_tokens  INTEGER NOT NULL DEFAULT 0
+      );
+
+      CREATE TABLE IF NOT EXISTS session_facts (
+        id         INTEGER PRIMARY KEY AUTOINCREMENT,
+        session_id TEXT NOT NULL,
+        kind       TEXT NOT NULL,
+        content    TEXT NOT NULL,
+        metadata   TEXT,
+        created_at INTEGER NOT NULL,
+        FOREIGN KEY (session_id) REFERENCES sessions(session_id) ON DELETE CASCADE
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_session_facts_session
+        ON session_facts(session_id);
+      CREATE INDEX IF NOT EXISTS idx_session_facts_kind
+        ON session_facts(session_id, kind);
+      CREATE INDEX IF NOT EXISTS idx_sessions_started
+        ON sessions(started_at DESC);
+    `);
+    }
+    /** Prepare reusable statements. */
+    prepareStatements() {
+        this.stmtInsertSession = this.db.prepare(`
+      INSERT INTO sessions (session_id, started_at) VALUES (?, ?)
+    `);
+        this.stmtEndSession = this.db.prepare(`
+      UPDATE sessions SET ended_at = ?, summary = ? WHERE session_id = ?
+    `);
+        this.stmtInsertFact = this.db.prepare(`
+      INSERT INTO session_facts (session_id, kind, content, metadata, created_at)
+      VALUES (?, ?, ?, ?, ?)
+    `);
+        this.stmtGetFacts = this.db.prepare(`
+      SELECT id, session_id AS sessionId, kind, content, metadata, created_at AS createdAt
+      FROM session_facts WHERE session_id = ? ORDER BY created_at ASC
+    `);
+        this.stmtGetSession = this.db.prepare(`
+      SELECT session_id AS sessionId, started_at AS startedAt, ended_at AS endedAt,
+             summary, input_tokens AS inputTokens, output_tokens AS outputTokens,
+             context_tokens AS contextTokens, saved_tokens AS savedTokens
+      FROM sessions WHERE session_id = ?
+    `);
+        this.stmtRecentSessions = this.db.prepare(`
+      SELECT s.session_id AS sessionId, s.started_at AS startedAt,
+             s.ended_at   AS endedAt,   s.summary,
+             (SELECT COUNT(*) FROM session_facts f WHERE f.session_id = s.session_id) AS totalFacts
+      FROM sessions s ORDER BY s.started_at DESC LIMIT ?
+    `);
+        this.stmtFactCountByKind = this.db.prepare(`
+      SELECT kind, COUNT(*) AS cnt FROM session_facts WHERE session_id = ? GROUP BY kind
+    `);
+        this.stmtUpdateTokenUsage = this.db.prepare(`
+      UPDATE sessions
+      SET input_tokens = ?, output_tokens = ?, context_tokens = ?, saved_tokens = ?
+      WHERE session_id = ?
+    `);
+        this.stmtDeleteSession = this.db.prepare(`DELETE FROM sessions WHERE session_id = ?`);
+        this.stmtDeleteFacts = this.db.prepare(`DELETE FROM session_facts WHERE session_id = ?`);
+    }
+    // ────────────────────────────────────────────────────────────
+    // Session Lifecycle
+    // ────────────────────────────────────────────────────────────
+    /**
+     * Start a new session.
+     *
+     * @param sessionId - Optional custom ID. If omitted, a timestamped UUID-ish
+     *                    ID is generated.
+     * @returns The session ID.
+     * @throws If a session is already active.
+     */
+    startSession(sessionId) {
+        if (this.currentSessionId !== null) {
+            throw new Error(`Session "${this.currentSessionId}" is already active. End it first.`);
+        }
+        const id = sessionId ?? this.generateSessionId();
+        const now = Date.now();
+        this.stmtInsertSession.run(id, now);
+        this.currentSessionId = id;
+        this.currentStartedAt = now;
+        this.tokenUsage = { inputTokens: 0, outputTokens: 0, contextTokens: 0, savedTokens: 0 };
+        return id;
+    }
+    /**
+     * End the current session.
+     *
+     * Generates a summary from facts, persists token usage, and clears state.
+     *
+     * @returns The completed `SessionSummary`.
+     * @throws If no session is active.
+     */
+    endSession() {
+        this.assertActiveSession();
+        const sessionId = this.currentSessionId;
+        const now = Date.now();
+        const facts = this.getFactsInternal(sessionId);
+        const summary = this.generateSummary(sessionId, facts);
+        // Persist
+        this.stmtEndSession.run(now, summary.summary, sessionId);
+        this.stmtUpdateTokenUsage.run(this.tokenUsage.inputTokens, this.tokenUsage.outputTokens, this.tokenUsage.contextTokens, this.tokenUsage.savedTokens, sessionId);
+        // Reset
+        this.currentSessionId = null;
+        this.currentStartedAt = null;
+        this.tokenUsage = { inputTokens: 0, outputTokens: 0, contextTokens: 0, savedTokens: 0 };
+        return summary;
+    }
+    /**
+     * Get the current active session ID (or `null`).
+     */
+    getCurrentSessionId() {
+        return this.currentSessionId;
+    }
+    /**
+     * Return full information about the currently active session.
+     */
+    getCurrentSessionInfo() {
+        if (this.currentSessionId === null || this.currentStartedAt === null) {
+            return null;
+        }
+        return {
+            sessionId: this.currentSessionId,
+            startedAt: this.currentStartedAt,
+            facts: this.getFactsInternal(this.currentSessionId),
+            tokenUsage: { ...this.tokenUsage },
+            durationMs: Date.now() - this.currentStartedAt,
+        };
+    }
+    // ────────────────────────────────────────────────────────────
+    // Facts
+    // ────────────────────────────────────────────────────────────
+    /**
+     * Record a fact in the current session.
+     *
+     * @param kind     - Category of fact.
+     * @param content  - Human-readable description.
+     * @param metadata - Optional structured metadata (will be JSON-stringified).
+     * @returns The inserted fact ID.
+     */
+    addFact(kind, content, metadata) {
+        this.assertActiveSession();
+        const now = Date.now();
+        const metaStr = metadata ? JSON.stringify(metadata) : null;
+        const info = this.stmtInsertFact.run(this.currentSessionId, kind, content, metaStr, now);
+        return Number(info.lastInsertRowid);
+    }
+    /**
+     * Retrieve all facts for a specific session.
+     */
+    getSessionFacts(sessionId) {
+        return this.getFactsInternal(sessionId);
+    }
+    /**
+     * Get distinct files worked on in the current session.
+     */
+    getFilesWorkedOn() {
+        this.assertActiveSession();
+        const facts = this.getFactsInternal(this.currentSessionId);
+        return [...new Set(facts
+                .filter(f => f.kind === 'file_worked_on')
+                .map(f => f.content))];
+    }
+    /**
+     * Get tasks completed in the current session.
+     */
+    getTasksCompleted() {
+        this.assertActiveSession();
+        return this.getFactsInternal(this.currentSessionId)
+            .filter(f => f.kind === 'task_completed')
+            .map(f => f.content);
+    }
+    /**
+     * Get decisions made in the current session.
+     */
+    getDecisionsMade() {
+        this.assertActiveSession();
+        return this.getFactsInternal(this.currentSessionId)
+            .filter(f => f.kind === 'decision_made')
+            .map(f => f.content);
+    }
+    // ────────────────────────────────────────────────────────────
+    // Token Tracking
+    // ────────────────────────────────────────────────────────────
+    /**
+     * Record token usage for the current session.
+     *
+     * Values are *accumulated* (added to running totals).
+     */
+    recordTokenUsage(usage) {
+        this.assertActiveSession();
+        if (usage.inputTokens)
+            this.tokenUsage.inputTokens += usage.inputTokens;
+        if (usage.outputTokens)
+            this.tokenUsage.outputTokens += usage.outputTokens;
+        if (usage.contextTokens)
+            this.tokenUsage.contextTokens += usage.contextTokens;
+        if (usage.savedTokens)
+            this.tokenUsage.savedTokens += usage.savedTokens;
+    }
+    /** Read token usage counters for the active session. */
+    getTokenUsage() {
+        this.assertActiveSession();
+        return { ...this.tokenUsage };
+    }
+    // ────────────────────────────────────────────────────────────
+    // Queries (cross-session)
+    // ────────────────────────────────────────────────────────────
+    /**
+     * List the N most recent sessions.
+     *
+     * @param limit - Maximum number of sessions to return (default 10).
+     */
+    listRecentSessions(limit = 10) {
+        return this.stmtRecentSessions.all(limit);
+    }
+    /**
+     * Get full details of a session by its ID.
+     */
+    getSession(sessionId) {
+        const row = this.stmtGetSession.get(sessionId);
+        if (!row)
+            return null;
+        const facts = this.getFactsInternal(sessionId);
+        return {
+            sessionId: row.sessionId,
+            startedAt: row.startedAt,
+            endedAt: row.endedAt ?? Date.now(),
+            tasksCompleted: facts.filter(f => f.kind === 'task_completed').map(f => f.content),
+            filesModified: [...new Set(facts.filter(f => f.kind === 'file_worked_on').map(f => f.content))],
+            decisionseMade: facts.filter(f => f.kind === 'decision_made').map(f => f.content),
+            memoriesCreated: 0, // Populated by caller if needed
+            tokensSaved: row.savedTokens,
+            summary: row.summary,
+            tokenUsage: {
+                inputTokens: row.inputTokens,
+                outputTokens: row.outputTokens,
+                contextTokens: row.contextTokens,
+                savedTokens: row.savedTokens,
+            },
+        };
+    }
+    /**
+     * Delete a session and all its facts.
+     *
+     * @returns `true` if the session existed and was deleted.
+     */
+    deleteSession(sessionId) {
+        if (sessionId === this.currentSessionId) {
+            throw new Error('Cannot delete the currently active session.');
+        }
+        const txn = this.db.transaction(() => {
+            this.stmtDeleteFacts.run(sessionId);
+            const info = this.stmtDeleteSession.run(sessionId);
+            return info.changes > 0;
+        });
+        return txn();
+    }
+    // ────────────────────────────────────────────────────────────
+    // Summary Generation
+    // ────────────────────────────────────────────────────────────
+    /**
+     * Build a `SessionSummary` from raw facts.
+     *
+     * Auto-generates a human-readable paragraph summarising the session's work.
+     */
+    generateSummary(sessionId, facts) {
+        const files = [...new Set(facts.filter(f => f.kind === 'file_worked_on').map(f => f.content))];
+        const tasks = facts.filter(f => f.kind === 'task_completed').map(f => f.content);
+        const decisions = facts.filter(f => f.kind === 'decision_made').map(f => f.content);
+        const errors = facts.filter(f => f.kind === 'error');
+        const notes = facts.filter(f => f.kind === 'note' || f.kind === 'context');
+        // Build text summary
+        const parts = [];
+        if (tasks.length > 0) {
+            parts.push(`Completed ${tasks.length} task(s): ${tasks.join('; ')}.`);
+        }
+        if (files.length > 0) {
+            parts.push(`Modified ${files.length} file(s): ${files.slice(0, 10).join(', ')}${files.length > 10 ? ` (+${files.length - 10} more)` : ''}.`);
+        }
+        if (decisions.length > 0) {
+            parts.push(`Made ${decisions.length} decision(s): ${decisions.join('; ')}.`);
+        }
+        if (errors.length > 0) {
+            parts.push(`Encountered ${errors.length} error(s).`);
+        }
+        if (notes.length > 0) {
+            parts.push(`Recorded ${notes.length} note(s)/context item(s).`);
+        }
+        if (parts.length === 0) {
+            parts.push('No significant activity recorded.');
+        }
+        return {
+            sessionId,
+            startedAt: this.currentStartedAt ?? Date.now(),
+            endedAt: Date.now(),
+            tasksCompleted: tasks,
+            filesModified: files,
+            decisionseMade: decisions,
+            memoriesCreated: 0,
+            tokensSaved: this.tokenUsage.savedTokens,
+            summary: parts.join(' '),
+        };
+    }
+    // ────────────────────────────────────────────────────────────
+    // Helpers
+    // ────────────────────────────────────────────────────────────
+    getFactsInternal(sessionId) {
+        return this.stmtGetFacts.all(sessionId);
+    }
+    assertActiveSession() {
+        if (this.currentSessionId === null) {
+            throw new Error('No active session. Call startSession() first.');
+        }
+    }
+    /** Generate a session ID based on timestamp + random suffix. */
+    generateSessionId() {
+        const ts = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 14);
+        const rand = Math.random().toString(36).slice(2, 8);
+        return `session-${ts}-${rand}`;
+    }
+}
+//# sourceMappingURL=session-memory.js.map

package/dist/memory/session-memory.js.map

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

package/dist/stress-test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * AI Mind Map — STRESS TEST on FlyShelf_PC
+ *
+ * Tests our MCP against a real ~1.2MB WPF codebase and measures
+ * actual token savings. No MCP protocol needed — uses modules directly.
+ *
+ * Run: node dist/stress-test.js
+ */
+export {};
+//# sourceMappingURL=stress-test.d.ts.map

package/dist/stress-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stress-test.d.ts","sourceRoot":"","sources":["../src/stress-test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}