ai-mind-map 1.1.0

package/dist/tools/snapshot-tools.js

@@ -0,0 +1,149 @@
+/**
+ * AI Mind Map — Snapshot & Delta MCP Tools
+ *
+ * The most important tools in the entire system for token savings.
+ * These replace the need to read the full codebase at session start.
+ *
+ * mindmap_project_map   → THE map. One call = entire project understood.
+ * mindmap_change_delta  → Only what changed since last time.
+ * mindmap_session_start → Everything combined: map + delta + memories.
+ */
+import { z } from 'zod';
+import { SnapshotEngine } from '../knowledge-graph/snapshot.js';
+const defaultEstimator = {
+    estimate: (text) => Math.ceil(text.length / 4),
+};
+function mcpText(result) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result) }],
+    };
+}
+function ok(data, estimator, saved = 0) {
+    const serialised = JSON.stringify(data);
+    const tokens = estimator.estimate(serialised);
+    return { success: true, data, tokenCount: tokens, tokensSaved: saved };
+}
+function fail(message) {
+    return { success: false, data: null, tokenCount: 0, tokensSaved: 0, message };
+}
+// ============================================================
+// Registration
+// ============================================================
+export function registerSnapshotTools(server, graph, config, estimator = defaultEstimator) {
+    const engine = new SnapshotEngine(graph, config);
+    // ── mindmap_project_map ───────────────────────────────────
+    server.tool('mindmap_project_map', `🗺️ THE PROJECT MAP. Returns a compact representation of the ENTIRE project 
+in ~1500-3000 tokens instead of 50,000+. Contains:
+- Every file with its symbols (functions, classes, types)
+- Architecture layer classification (UI, service, controller, DB, etc.)
+- Entry points (main files, routes)
+- Most-connected symbols (hotspots)
+- Token savings report
+
+THIS IS THE #1 TOKEN SAVER. Call this ONCE at the start of any session 
+instead of reading the whole codebase.`, {}, async () => {
+        try {
+            const snapshot = engine.generateSnapshot();
+            return mcpText(ok({
+                projectMap: snapshot.fileMap,
+                layers: snapshot.layers,
+                entryPoints: snapshot.entryPoints,
+                hotspots: snapshot.hotspots,
+                stats: snapshot.stats,
+                tokenSavings: snapshot.tokenCost,
+            }, estimator, snapshot.tokenCost.saved));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`project_map failed: ${msg}`));
+        }
+    });
+    // ── mindmap_change_delta ──────────────────────────────────
+    server.tool('mindmap_change_delta', `🔄 CHANGE DELTA. Shows ONLY what changed since the last session or a given time.
+Instead of re-reading the whole project, the AI gets a compact list of:
+- Which files were added/modified/deleted
+- Which symbols were affected in each file
+- New symbols that were created
+- Hot files (most changed)
+
+Use this at session start AFTER mindmap_project_map to understand the current state.`, {
+        since: z
+            .union([
+            z.enum(['last_session', 'today', 'this_week', '1h', '3h', '6h', '12h', '24h']),
+            z.string().datetime(),
+        ])
+            .default('last_session')
+            .describe('How far back to look'),
+    }, async ({ since }) => {
+        try {
+            const timestamp = resolveTimestamp(since);
+            const delta = await engine.generateChangeDelta(timestamp, since);
+            return mcpText(ok(delta, estimator));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`change_delta failed: ${msg}`));
+        }
+    });
+    // ── mindmap_session_start ─────────────────────────────────
+    server.tool('mindmap_session_start', `🚀 SESSION START — the SINGLE most important tool call.
+Returns EVERYTHING the AI needs to start working in ONE call:
+1. Complete project map (all files + symbols)
+2. Change delta (what changed since last session)
+3. Stored memories (important facts from previous sessions)
+
+Call this ONCE at the very beginning of every conversation.
+This single call replaces reading the entire codebase.
+Typical cost: ~2000-4000 tokens vs 50,000+ for full read.`, {
+        since: z
+            .union([
+            z.enum(['last_session', 'today', 'this_week', '1h', '3h', '6h', '12h', '24h']),
+            z.string().datetime(),
+        ])
+            .default('last_session')
+            .describe('How far back to look for changes'),
+    }, async ({ since }) => {
+        try {
+            const timestamp = resolveTimestamp(since);
+            const preamble = await engine.generatePreamble(timestamp);
+            return mcpText(ok({
+                projectMap: preamble.projectMap,
+                changeDelta: preamble.changeDelta,
+                memories: preamble.memories,
+                tokenCost: preamble.tokenCost,
+                tip: 'You now have full project context. Use mindmap_trace_flow, mindmap_get_code_snippet, or mindmap_debug_changes for specific tasks.',
+            }, estimator, Math.max(0, 50000 - preamble.tokenCost)));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return mcpText(fail(`session_start failed: ${msg}`));
+        }
+    });
+}
+// ============================================================
+// Utilities
+// ============================================================
+function resolveTimestamp(since) {
+    const now = Date.now();
+    switch (since) {
+        case 'last_session': return now - 4 * 60 * 60 * 1000;
+        case 'today': {
+            const d = new Date();
+            d.setHours(0, 0, 0, 0);
+            return d.getTime();
+        }
+        case 'this_week': {
+            const d = new Date();
+            d.setDate(d.getDate() - d.getDay());
+            d.setHours(0, 0, 0, 0);
+            return d.getTime();
+        }
+        case '1h': return now - 1 * 3600000;
+        case '3h': return now - 3 * 3600000;
+        case '6h': return now - 6 * 3600000;
+        case '12h': return now - 12 * 3600000;
+        case '24h': return now - 24 * 3600000;
+        default: return new Date(since).getTime();
+    }
+}
+//# sourceMappingURL=snapshot-tools.js.map

package/dist/tools/snapshot-tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,181 @@
+/**
+ * AI Mind Map — Shared Type Definitions
+ *
+ * Core types used across all components of the Mind Map system.
+ * Inspired by codebase-memory-mcp, Aider repo maps, and Mem0 architectures.
+ */
+export type NodeType = 'file' | 'function' | 'class' | 'method' | 'interface' | 'type_alias' | 'enum' | 'variable' | 'constant' | 'module' | 'namespace' | 'property' | 'constructor' | 'decorator' | 'route' | 'component' | 'hook' | 'test' | 'config';
+export type EdgeType = 'calls' | 'imports' | 'exports' | 'inherits' | 'implements' | 'uses' | 'decorates' | 'overrides' | 'contains' | 'tests' | 'depends_on' | 'routes_to';
+export interface GraphNode {
+    id: string;
+    type: NodeType;
+    name: string;
+    qualifiedName: string;
+    filePath: string;
+    startLine: number;
+    endLine: number;
+    signature: string;
+    docComment: string | null;
+    hash: string;
+    language: string;
+    visibility: 'public' | 'private' | 'protected' | 'internal' | 'unknown';
+    isAsync: boolean;
+    isStatic: boolean;
+    isExported: boolean;
+    parameters?: ParameterInfo[];
+    returnType?: string;
+    updatedAt: number;
+}
+export interface ParameterInfo {
+    name: string;
+    type: string | null;
+    defaultValue: string | null;
+    isOptional: boolean;
+    isRest: boolean;
+}
+export interface GraphEdge {
+    sourceId: string;
+    targetId: string;
+    type: EdgeType;
+    metadata?: Record<string, string>;
+}
+export type ChangeType = 'created' | 'modified' | 'deleted' | 'renamed';
+export interface FileChange {
+    filePath: string;
+    changeType: ChangeType;
+    oldPath?: string;
+    summary: string;
+    symbolsAffected: string[];
+    linesAdded: number;
+    linesRemoved: number;
+    timestamp: number;
+    sessionId: string;
+    /** Actual git diff content (patch hunks) for this file — if available. */
+    diffContent?: string;
+}
+export interface ChangeSession {
+    sessionId: string;
+    startedAt: number;
+    endedAt: number | null;
+    totalChanges: number;
+    filesModified: string[];
+    summary: string;
+}
+export type MemoryCategory = 'architecture' | 'convention' | 'decision' | 'gotcha' | 'dependency' | 'workflow' | 'context' | 'preference' | 'lesson_learned' | 'todo';
+export interface Memory {
+    id: number;
+    category: MemoryCategory;
+    content: string;
+    importance: number;
+    tags: string[];
+    relatedFiles: string[];
+    createdAt: number;
+    lastAccessedAt: number;
+    accessCount: number;
+    sessionId: string;
+    source: 'agent' | 'user' | 'auto';
+}
+export interface Decision {
+    id: number;
+    title: string;
+    description: string;
+    rationale: string;
+    alternatives: string[];
+    consequences: string[];
+    relatedFiles: string[];
+    tags: string[];
+    decidedAt: number;
+    decidedBy: string;
+    status: 'active' | 'superseded' | 'reversed';
+    supersededBy?: number;
+}
+export interface SessionSummary {
+    sessionId: string;
+    startedAt: number;
+    endedAt: number;
+    tasksCompleted: string[];
+    filesModified: string[];
+    decisionseMade: string[];
+    memoriesCreated: number;
+    tokensSaved: number;
+    summary: string;
+}
+export type CompressionLevel = 'minimal' | 'moderate' | 'aggressive';
+export type ContentType = 'source_code' | 'build_log' | 'test_output' | 'stack_trace' | 'json_data' | 'markdown' | 'plain_text' | 'diff' | 'config_file';
+export interface TokenBudget {
+    graphResults: number;
+    changeSummary: number;
+    memoryRetrieval: number;
+    fileContent: number;
+    totalContext: number;
+}
+export interface ContextTier {
+    tier: 1 | 2 | 3;
+    label: string;
+    description: string;
+    tokenBudget: number;
+    alwaysLoaded: boolean;
+}
+export interface ContextPackage {
+    tier1: string;
+    tier2: string;
+    tier3: string;
+    totalTokens: number;
+    tokensSaved: number;
+    breakdown: {
+        component: string;
+        tokens: number;
+        budget: number;
+    }[];
+}
+export interface MindMapConfig {
+    /** Root directory of the project to index */
+    projectRoot: string;
+    /** Languages to parse (auto-detected if not specified) */
+    languages: string[];
+    /** Glob patterns to ignore (in addition to .gitignore) */
+    ignore: string[];
+    /** Token budgets per component */
+    tokenBudgets: TokenBudget;
+    /** Memory configuration */
+    memory: {
+        maxMemories: number;
+        decayRate: number;
+        importanceThreshold: number;
+        maxDecisions: number;
+    };
+    /** Compression level for context engine */
+    compression: CompressionLevel;
+    /** Database file path */
+    dbPath: string;
+    /** Enable file watcher for real-time updates */
+    watchEnabled: boolean;
+    /** File watcher debounce delay in ms */
+    watchDebounceMs: number;
+    /** Maximum file size to index (bytes) */
+    maxFileSize: number;
+    /** Enable PageRank relevance ranking */
+    pageRankEnabled: boolean;
+}
+export declare const DEFAULT_CONFIG: MindMapConfig;
+export interface MindMapStats {
+    indexedFiles: number;
+    totalNodes: number;
+    totalEdges: number;
+    totalMemories: number;
+    totalDecisions: number;
+    totalChangesTracked: number;
+    lastIndexedAt: number | null;
+    lastChangeAt: number | null;
+    dbSizeBytes: number;
+    languageBreakdown: Record<string, number>;
+    tokensSavedEstimate: number;
+}
+export interface ToolResult {
+    success: boolean;
+    data: unknown;
+    tokenCount: number;
+    tokensSaved: number;
+    message?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,45 @@
+/**
+ * AI Mind Map — Shared Type Definitions
+ *
+ * Core types used across all components of the Mind Map system.
+ * Inspired by codebase-memory-mcp, Aider repo maps, and Mem0 architectures.
+ */
+export const DEFAULT_CONFIG = {
+    projectRoot: process.cwd(),
+    languages: [], // Auto-detect
+    ignore: [
+        'node_modules', '.git', 'dist', 'build', 'out', '.next',
+        '__pycache__', '.pytest_cache', 'venv', '.venv', 'env',
+        'target', 'bin/Debug', 'bin/Release', 'obj',
+        '.idea', '.vscode', '.vs',
+        'coverage', '.nyc_output',
+        '*.min.js', '*.min.css', '*.map',
+        '*.lock', 'package-lock.json', 'yarn.lock', 'pnpm-lock.yaml',
+        '*.png', '*.jpg', '*.jpeg', '*.gif', '*.svg', '*.ico',
+        '*.woff', '*.woff2', '*.ttf', '*.eot',
+        '*.pdf', '*.zip', '*.tar', '*.gz',
+        '*.exe', '*.dll', '*.so', '*.dylib',
+        '*.pyc', '*.pyo', '*.class',
+        '.env', '.env.local', '.env.production',
+    ],
+    tokenBudgets: {
+        graphResults: 2000,
+        changeSummary: 1000,
+        memoryRetrieval: 1500,
+        fileContent: 3000,
+        totalContext: 10000,
+    },
+    memory: {
+        maxMemories: 500,
+        decayRate: 0.95,
+        importanceThreshold: 0.1,
+        maxDecisions: 200,
+    },
+    compression: 'moderate',
+    dbPath: '.mindmap/mindmap.db',
+    watchEnabled: true,
+    watchDebounceMs: 500,
+    maxFileSize: 512 * 1024, // 512KB
+    pageRankEnabled: true,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6PH,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC3C,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE;IAC1B,SAAS,EAAE,EAAE,EAAG,cAAc;IAC9B,MAAM,EAAE;QACN,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO;QACvD,aAAa,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK;QACtD,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK;QAC3C,OAAO,EAAE,SAAS,EAAE,KAAK;QACzB,UAAU,EAAE,aAAa;QACzB,UAAU,EAAE,WAAW,EAAE,OAAO;QAChC,QAAQ,EAAE,mBAAmB,EAAE,WAAW,EAAE,gBAAgB;QAC5D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;QACrD,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO;QACrC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM;QACjC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS;QACnC,OAAO,EAAE,OAAO,EAAE,SAAS;QAC3B,MAAM,EAAE,YAAY,EAAE,iBAAiB;KACxC;IACD,YAAY,EAAE;QACZ,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE,KAAK;KACpB;IACD,MAAM,EAAE;QACN,WAAW,EAAE,GAAG;QAChB,SAAS,EAAE,IAAI;QACf,mBAAmB,EAAE,GAAG;QACxB,YAAY,EAAE,GAAG;KAClB;IACD,WAAW,EAAE,UAAU;IACvB,MAAM,EAAE,qBAAqB;IAC7B,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,GAAG;IACpB,WAAW,EAAE,GAAG,GAAG,IAAI,EAAG,QAAQ;IAClC,eAAe,EAAE,IAAI;CACtB,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,59 @@
+/**
+ * AI Mind Map — Logger Utility
+ *
+ * Simple structured logger that writes to stderr so it does not interfere
+ * with the MCP JSON-RPC protocol on stdout.
+ *
+ * Features:
+ * - Four log levels: debug, info, warn, error
+ * - ISO-8601 timestamp prefix
+ * - Optional file logging (append mode)
+ * - Runtime-configurable log level
+ */
+/** Supported log levels ordered by severity. */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/** Configuration for the Logger. */
+export interface LoggerOptions {
+    /** Minimum level to emit. Default: `'info'`. */
+    level?: LogLevel;
+    /** Optional file path to append log lines to. */
+    filePath?: string;
+    /** Prefix prepended to every message (e.g. component name). */
+    prefix?: string;
+    /** Whether to include colours in stderr output. Default: `true`. */
+    colors?: boolean;
+}
+/**
+ * Lightweight logger that writes to stderr and optionally to a file.
+ *
+ * ```ts
+ * const log = new Logger({ level: 'debug', prefix: 'Indexer' });
+ * log.info('Indexed 42 files');
+ * log.error('Failed to parse', filePath);
+ * ```
+ */
+export declare class Logger {
+    private level;
+    private prefix;
+    private colors;
+    private fileStream;
+    constructor(options?: LoggerOptions);
+    /** Log a debug-level message. */
+    debug(...args: unknown[]): void;
+    /** Log an info-level message. */
+    info(...args: unknown[]): void;
+    /** Log a warning-level message. */
+    warn(...args: unknown[]): void;
+    /** Log an error-level message. */
+    error(...args: unknown[]): void;
+    /** Update the minimum log level at runtime. */
+    setLevel(level: LogLevel): void;
+    /** Return the current effective log level. */
+    getLevel(): LogLevel;
+    /** Create a child logger that inherits settings but adds a sub-prefix. */
+    child(subPrefix: string): Logger;
+    /** Flush and close the file stream (if any). */
+    close(): void;
+    private emit;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,gDAAgD;AAChD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAoB3D,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,UAAU,CAA4B;gBAElC,OAAO,GAAE,aAAkB;IAoBvC,iCAAiC;IACjC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/B,iCAAiC;IACjC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,mCAAmC;IACnC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI9B,kCAAkC;IAClC,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/B,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,8CAA8C;IAC9C,QAAQ,IAAI,QAAQ;IAMpB,0EAA0E;IAC1E,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAWhC,gDAAgD;IAChD,KAAK,IAAI,IAAI;IASb,OAAO,CAAC,IAAI;CAwCb"}

package/dist/utils/logger.js

@@ -0,0 +1,142 @@
+/**
+ * AI Mind Map — Logger Utility
+ *
+ * Simple structured logger that writes to stderr so it does not interfere
+ * with the MCP JSON-RPC protocol on stdout.
+ *
+ * Features:
+ * - Four log levels: debug, info, warn, error
+ * - ISO-8601 timestamp prefix
+ * - Optional file logging (append mode)
+ * - Runtime-configurable log level
+ */
+import { createWriteStream, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+/** Numeric severity for comparison — lower means more verbose. */
+const LEVEL_VALUE = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+/** ANSI colour codes used only for stderr output (not file). */
+const LEVEL_COLOR = {
+    debug: '\x1b[90m', // grey
+    info: '\x1b[36m', // cyan
+    warn: '\x1b[33m', // yellow
+    error: '\x1b[31m', // red
+};
+const RESET = '\x1b[0m';
+/**
+ * Lightweight logger that writes to stderr and optionally to a file.
+ *
+ * ```ts
+ * const log = new Logger({ level: 'debug', prefix: 'Indexer' });
+ * log.info('Indexed 42 files');
+ * log.error('Failed to parse', filePath);
+ * ```
+ */
+export class Logger {
+    level;
+    prefix;
+    colors;
+    fileStream = null;
+    constructor(options = {}) {
+        this.level = LEVEL_VALUE[options.level ?? 'info'];
+        this.prefix = options.prefix ?? 'MindMap';
+        this.colors = options.colors ?? true;
+        if (options.filePath) {
+            try {
+                mkdirSync(dirname(options.filePath), { recursive: true });
+                this.fileStream = createWriteStream(options.filePath, { flags: 'a' });
+            }
+            catch {
+                // If we can't open the log file, silently fall back to stderr-only.
+                process.stderr.write(`[Logger] WARNING: Could not open log file at ${options.filePath}\n`);
+            }
+        }
+    }
+    // ── Public API ─────────────────────────────────────────────
+    /** Log a debug-level message. */
+    debug(...args) {
+        this.emit('debug', args);
+    }
+    /** Log an info-level message. */
+    info(...args) {
+        this.emit('info', args);
+    }
+    /** Log a warning-level message. */
+    warn(...args) {
+        this.emit('warn', args);
+    }
+    /** Log an error-level message. */
+    error(...args) {
+        this.emit('error', args);
+    }
+    /** Update the minimum log level at runtime. */
+    setLevel(level) {
+        this.level = LEVEL_VALUE[level];
+    }
+    /** Return the current effective log level. */
+    getLevel() {
+        const entries = Object.entries(LEVEL_VALUE);
+        const match = entries.find(([, v]) => v === this.level);
+        return match ? match[0] : 'info';
+    }
+    /** Create a child logger that inherits settings but adds a sub-prefix. */
+    child(subPrefix) {
+        const child = new Logger({
+            level: this.getLevel(),
+            prefix: `${this.prefix}:${subPrefix}`,
+            colors: this.colors,
+        });
+        // Share the same file stream so we don't open multiple handles.
+        child.fileStream = this.fileStream;
+        return child;
+    }
+    /** Flush and close the file stream (if any). */
+    close() {
+        if (this.fileStream) {
+            this.fileStream.end();
+            this.fileStream = null;
+        }
+    }
+    // ── Internals ──────────────────────────────────────────────
+    emit(level, args) {
+        if (LEVEL_VALUE[level] < this.level) {
+            return;
+        }
+        const timestamp = new Date().toISOString();
+        const levelTag = level.toUpperCase().padEnd(5);
+        const message = args
+            .map((a) => {
+            if (a instanceof Error) {
+                return a.stack ?? a.message;
+            }
+            if (typeof a === 'string') {
+                return a;
+            }
+            try {
+                return JSON.stringify(a);
+            }
+            catch {
+                return String(a);
+            }
+        })
+            .join(' ');
+        // Plain line for file logging.
+        const plainLine = `${timestamp} [${levelTag}] [${this.prefix}] ${message}\n`;
+        // Coloured line for stderr.
+        if (this.colors) {
+            const color = LEVEL_COLOR[level];
+            process.stderr.write(`${color}${timestamp} [${levelTag}]${RESET} [${this.prefix}] ${message}\n`);
+        }
+        else {
+            process.stderr.write(plainLine);
+        }
+        if (this.fileStream) {
+            this.fileStream.write(plainLine);
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/token-counter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * AI Mind Map — Fast Token Counter
+ *
+ * Provides a fast, dependency-free approximation of GPT-style token counts
+ * without loading the heavy tiktoken library.
+ *
+ * Algorithm:
+ *   1. Split input by whitespace and punctuation boundaries.
+ *   2. Count the resulting chunks.
+ *   3. Apply a calibrated multiplier (1.3) for sub-word tokenisation.
+ *   4. Add a correction for special / non-ASCII characters.
+ *
+ * Accuracy: within ~10% of the real cl100k_base token count.
+ * Performance: <1 ms for 10 K-character strings.
+ */
+/**
+ * Estimate the token count of `text` using a fast heuristic.
+ *
+ * @param text - The input string.
+ * @returns Estimated token count (integer, ≥ 0).
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Estimate the token count for an array of strings (summed).
+ *
+ * @param texts - The input strings.
+ * @returns Total estimated token count.
+ */
+export declare function estimateTokensMany(texts: string[]): number;
+/**
+ * Truncate `text` so that its estimated token count is ≤ `maxTokens`.
+ *
+ * The function tries to cut at a logical boundary (end of paragraph,
+ * end of function, end of sentence, etc.) rather than mid-word.
+ *
+ * @param text      - The input string.
+ * @param maxTokens - Maximum token budget.
+ * @param suffix    - Optional suffix appended to indicate truncation.
+ *                    Defaults to `"\n... [truncated]"`.
+ * @returns The (possibly truncated) string.
+ */
+export declare function truncateToTokenBudget(text: string, maxTokens: number, suffix?: string): string;
+/**
+ * Check whether `text` fits within the given token budget.
+ *
+ * @param text      - The input string.
+ * @param maxTokens - Maximum allowed tokens.
+ * @returns `true` if estimated tokens ≤ maxTokens.
+ */
+export declare function fitsWithinBudget(text: string, maxTokens: number): boolean;
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/utils/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../../src/utils/token-counter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAwBH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmCnD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAM1D;AAmBD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAA4B,GACnC,MAAM,CAoDR;AAwBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAEzE"}