ai-mind-map 1.1.0

package/dist/context/token-budget.d.ts

@@ -0,0 +1,121 @@
+/**
+ * AI Mind Map — Token Budget Manager
+ *
+ * Explicit token budget management inspired by Aider's `--map-tokens`
+ * approach.  Provides per-component budgets, enforcement, smart
+ * truncation at logical boundaries, dynamic reallocation, and
+ * formatted budget reports.
+ */
+import type { TokenBudget } from '../types.js';
+/** Label for a budget component (matches the keys of {@link TokenBudget}). */
+export type BudgetComponent = 'graphResults' | 'changeSummary' | 'memoryRetrieval' | 'fileContent';
+/** Snapshot of a single component's budget state. */
+export interface ComponentBudgetState {
+    component: BudgetComponent;
+    label: string;
+    used: number;
+    budget: number;
+    remaining: number;
+}
+/** Full budget report across all components. */
+export interface BudgetReport {
+    components: ComponentBudgetState[];
+    totalUsed: number;
+    totalBudget: number;
+    totalRemaining: number;
+    /** Estimated savings vs reading entire files naively. */
+    savingsPercent: number;
+}
+/**
+ * Manages token budgets across all context components.
+ *
+ * Usage:
+ * ```ts
+ * const mgr = new TokenBudgetManager(config.tokenBudgets);
+ * const text = mgr.enforceComponentBudget('graphResults', longText);
+ * mgr.recordUsage('graphResults', text);
+ * const report = mgr.generateReport();
+ * ```
+ */
+export declare class TokenBudgetManager {
+    /** Per-component budgets (immutable originals). */
+    private readonly baseBudgets;
+    /** Current effective budgets (may be reallocated). */
+    private readonly effectiveBudgets;
+    /** Running token counts per component. */
+    private readonly usage;
+    /** Total budget across all components. */
+    private readonly totalBudget;
+    /** Estimated naive cost (for savings calculation). */
+    private naiveCost;
+    constructor(budgets: TokenBudget);
+    /** Get the current effective budget for a component. */
+    getBudget(component: BudgetComponent): number;
+    /** Get current token usage for a component. */
+    getUsage(component: BudgetComponent): number;
+    /** Get remaining tokens for a component. */
+    getRemaining(component: BudgetComponent): number;
+    /** Get total tokens used across all components. */
+    getTotalUsed(): number;
+    /** Get total tokens remaining across all components. */
+    getTotalRemaining(): number;
+    /** Check whether the total budget has been exceeded. */
+    isOverBudget(): boolean;
+    /**
+     * Record that `tokenCount` tokens were consumed by `component`.
+     *
+     * @param component  - The budget component.
+     * @param text       - The text whose tokens to count (or supply a number).
+     */
+    recordUsage(component: BudgetComponent, text: string | number): void;
+    /**
+     * Record the "naive" cost — the estimated tokens if entire files were
+     * sent without compression.  Used for savings calculation.
+     */
+    recordNaiveCost(tokens: number): void;
+    /** Reset all usage counters (e.g., for a new request). */
+    resetUsage(): void;
+    /**
+     * Enforce the budget for a component by truncating content if necessary.
+     *
+     * @param component - The budget component.
+     * @param text      - The input text.
+     * @returns The (possibly truncated) text that fits within the budget.
+     */
+    enforceComponentBudget(component: BudgetComponent, text: string): string;
+    /**
+     * Enforce the total context budget on a final assembled context string.
+     *
+     * @param text - The assembled context.
+     * @returns The (possibly truncated) text.
+     */
+    enforceTotalBudget(text: string): string;
+    /**
+     * Reallocate unused budget from components that used less than their
+     * allocation to components that need more.
+     *
+     * Call this after all components have submitted their initial content
+     * but before final assembly.
+     */
+    reallocate(): void;
+    /**
+     * Generate a structured budget report.
+     */
+    generateReport(): BudgetReport;
+    /**
+     * Generate a formatted text table of the budget report.
+     *
+     * Example output:
+     * ```
+     * Token Budget Report:
+     * ┌──────────────────┬───────┬──────────┬────────────┐
+     * │ Component        │ Used  │ Budget   │ Remaining  │
+     * ├──────────────────┼───────┼──────────┼────────────┤
+     * │ Graph Results    │ 1,200 │ 2,000    │ 800        │
+     * │ Change Summary   │   450 │ 1,000    │ 550        │
+     * ...
+     * ```
+     */
+    formatReport(): string;
+}
+//# sourceMappingURL=token-budget.d.ts.map

package/dist/context/token-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-budget.d.ts","sourceRoot":"","sources":["../../src/context/token-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAW/C,8EAA8E;AAC9E,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,eAAe,GACf,iBAAiB,GACjB,aAAa,CAAC;AAElB,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;CACxB;AAoBD;;;;;;;;;;GAUG;AACH,qBAAa,kBAAkB;IAC7B,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAc;IAC/C,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,0CAA0C;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,sDAAsD;IACtD,OAAO,CAAC,SAAS,CAAK;gBAEV,OAAO,EAAE,WAAW;IAchC,wDAAwD;IACxD,SAAS,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM;IAI7C,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM;IAI5C,4CAA4C;IAC5C,YAAY,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM;IAIhD,mDAAmD;IACnD,YAAY,IAAI,MAAM;IAQtB,wDAAwD;IACxD,iBAAiB,IAAI,MAAM;IAI3B,wDAAwD;IACxD,YAAY,IAAI,OAAO;IAMvB;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMpE;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIrC,0DAA0D;IAC1D,UAAU,IAAI,IAAI;IAYlB;;;;;;OAMG;IACH,sBAAsB,CAAC,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAoBxE;;;;;OAKG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAcxC;;;;;;OAMG;IACH,UAAU,IAAI,IAAI;IA2ClB;;OAEG;IACH,cAAc,IAAI,YAAY;IAwB9B;;;;;;;;;;;;;OAaG;IACH,YAAY,IAAI,MAAM;CAIvB"}

package/dist/context/token-budget.js

@@ -0,0 +1,282 @@
+/**
+ * AI Mind Map — Token Budget Manager
+ *
+ * Explicit token budget management inspired by Aider's `--map-tokens`
+ * approach.  Provides per-component budgets, enforcement, smart
+ * truncation at logical boundaries, dynamic reallocation, and
+ * formatted budget reports.
+ */
+import { estimateTokens, truncateToTokenBudget, } from '../utils/token-counter.js';
+import { Logger } from '../utils/logger.js';
+const logger = new Logger({ prefix: 'TokenBudget' });
+/** Human-readable labels for each budget component. */
+const COMPONENT_LABELS = {
+    graphResults: 'Graph Results',
+    changeSummary: 'Change Summary',
+    memoryRetrieval: 'Memory Retrieval',
+    fileContent: 'File Content',
+};
+/** All component keys in display order. */
+const ALL_COMPONENTS = [
+    'graphResults',
+    'changeSummary',
+    'memoryRetrieval',
+    'fileContent',
+];
+// ── Budget Manager Class ─────────────────────────────────────
+/**
+ * Manages token budgets across all context components.
+ *
+ * Usage:
+ * ```ts
+ * const mgr = new TokenBudgetManager(config.tokenBudgets);
+ * const text = mgr.enforceComponentBudget('graphResults', longText);
+ * mgr.recordUsage('graphResults', text);
+ * const report = mgr.generateReport();
+ * ```
+ */
+export class TokenBudgetManager {
+    /** Per-component budgets (immutable originals). */
+    baseBudgets;
+    /** Current effective budgets (may be reallocated). */
+    effectiveBudgets;
+    /** Running token counts per component. */
+    usage;
+    /** Total budget across all components. */
+    totalBudget;
+    /** Estimated naive cost (for savings calculation). */
+    naiveCost = 0;
+    constructor(budgets) {
+        this.baseBudgets = { ...budgets };
+        this.effectiveBudgets = { ...budgets };
+        this.totalBudget = budgets.totalContext;
+        this.usage = {
+            graphResults: 0,
+            changeSummary: 0,
+            memoryRetrieval: 0,
+            fileContent: 0,
+        };
+    }
+    // ── Query ──────────────────────────────────────────────
+    /** Get the current effective budget for a component. */
+    getBudget(component) {
+        return this.effectiveBudgets[component];
+    }
+    /** Get current token usage for a component. */
+    getUsage(component) {
+        return this.usage[component];
+    }
+    /** Get remaining tokens for a component. */
+    getRemaining(component) {
+        return Math.max(0, this.effectiveBudgets[component] - this.usage[component]);
+    }
+    /** Get total tokens used across all components. */
+    getTotalUsed() {
+        let sum = 0;
+        for (const c of ALL_COMPONENTS) {
+            sum += this.usage[c];
+        }
+        return sum;
+    }
+    /** Get total tokens remaining across all components. */
+    getTotalRemaining() {
+        return Math.max(0, this.totalBudget - this.getTotalUsed());
+    }
+    /** Check whether the total budget has been exceeded. */
+    isOverBudget() {
+        return this.getTotalUsed() > this.totalBudget;
+    }
+    // ── Recording ──────────────────────────────────────────
+    /**
+     * Record that `tokenCount` tokens were consumed by `component`.
+     *
+     * @param component  - The budget component.
+     * @param text       - The text whose tokens to count (or supply a number).
+     */
+    recordUsage(component, text) {
+        const tokens = typeof text === 'number' ? text : estimateTokens(text);
+        this.usage[component] += tokens;
+        logger.debug(`${COMPONENT_LABELS[component]}: +${tokens} tokens (total: ${this.usage[component]})`);
+    }
+    /**
+     * Record the "naive" cost — the estimated tokens if entire files were
+     * sent without compression.  Used for savings calculation.
+     */
+    recordNaiveCost(tokens) {
+        this.naiveCost += tokens;
+    }
+    /** Reset all usage counters (e.g., for a new request). */
+    resetUsage() {
+        for (const c of ALL_COMPONENTS) {
+            this.usage[c] = 0;
+        }
+        this.naiveCost = 0;
+        // Restore effective budgets to base values.
+        Object.assign(this.effectiveBudgets, this.baseBudgets);
+        logger.debug('Budget usage reset');
+    }
+    // ── Enforcement ────────────────────────────────────────
+    /**
+     * Enforce the budget for a component by truncating content if necessary.
+     *
+     * @param component - The budget component.
+     * @param text      - The input text.
+     * @returns The (possibly truncated) text that fits within the budget.
+     */
+    enforceComponentBudget(component, text) {
+        const budget = this.getRemaining(component);
+        if (budget <= 0) {
+            logger.warn(`${COMPONENT_LABELS[component]}: budget exhausted, returning empty`);
+            return `[${COMPONENT_LABELS[component]}: budget exhausted]`;
+        }
+        const tokens = estimateTokens(text);
+        if (tokens <= budget) {
+            return text;
+        }
+        logger.debug(`${COMPONENT_LABELS[component]}: truncating ${tokens} → ${budget} tokens`);
+        return truncateToTokenBudget(text, budget);
+    }
+    /**
+     * Enforce the total context budget on a final assembled context string.
+     *
+     * @param text - The assembled context.
+     * @returns The (possibly truncated) text.
+     */
+    enforceTotalBudget(text) {
+        const remaining = this.getTotalRemaining();
+        const tokens = estimateTokens(text);
+        if (tokens <= remaining) {
+            return text;
+        }
+        logger.debug(`Total budget: truncating ${tokens} → ${remaining} tokens`);
+        return truncateToTokenBudget(text, remaining);
+    }
+    // ── Dynamic Reallocation ───────────────────────────────
+    /**
+     * Reallocate unused budget from components that used less than their
+     * allocation to components that need more.
+     *
+     * Call this after all components have submitted their initial content
+     * but before final assembly.
+     */
+    reallocate() {
+        // Calculate how much each component has left.
+        let surplus = 0;
+        const needMore = [];
+        for (const c of ALL_COMPONENTS) {
+            const remaining = this.effectiveBudgets[c] - this.usage[c];
+            if (remaining > 50) {
+                // This component has surplus — make it available.
+                surplus += remaining;
+                // Shrink its effective budget to what it actually used + 10% buffer.
+                this.effectiveBudgets[c] = Math.ceil(this.usage[c] * 1.1);
+                surplus -= this.effectiveBudgets[c] - this.usage[c]; // Subtract the buffer
+            }
+            else if (remaining < 0) {
+                needMore.push(c);
+            }
+        }
+        // Recalculate surplus after adjustments.
+        surplus = 0;
+        for (const c of ALL_COMPONENTS) {
+            const remaining = this.effectiveBudgets[c] - this.usage[c];
+            if (remaining > 0) {
+                surplus += remaining;
+            }
+        }
+        if (surplus <= 0 || needMore.length === 0) {
+            return;
+        }
+        // Distribute surplus evenly among components that need more.
+        const perComponent = Math.floor(surplus / needMore.length);
+        for (const c of needMore) {
+            this.effectiveBudgets[c] += perComponent;
+            logger.debug(`Reallocated +${perComponent} tokens to ${COMPONENT_LABELS[c]}`);
+        }
+    }
+    // ── Reporting ──────────────────────────────────────────
+    /**
+     * Generate a structured budget report.
+     */
+    generateReport() {
+        const totalUsed = this.getTotalUsed();
+        const components = ALL_COMPONENTS.map((c) => ({
+            component: c,
+            label: COMPONENT_LABELS[c],
+            used: this.usage[c],
+            budget: this.effectiveBudgets[c],
+            remaining: Math.max(0, this.effectiveBudgets[c] - this.usage[c]),
+        }));
+        const savingsPercent = this.naiveCost > 0
+            ? Math.round((1 - totalUsed / this.naiveCost) * 100)
+            : 0;
+        return {
+            components,
+            totalUsed,
+            totalBudget: this.totalBudget,
+            totalRemaining: Math.max(0, this.totalBudget - totalUsed),
+            savingsPercent,
+        };
+    }
+    /**
+     * Generate a formatted text table of the budget report.
+     *
+     * Example output:
+     * ```
+     * Token Budget Report:
+     * ┌──────────────────┬───────┬──────────┬────────────┐
+     * │ Component        │ Used  │ Budget   │ Remaining  │
+     * ├──────────────────┼───────┼──────────┼────────────┤
+     * │ Graph Results    │ 1,200 │ 2,000    │ 800        │
+     * │ Change Summary   │   450 │ 1,000    │ 550        │
+     * ...
+     * ```
+     */
+    formatReport() {
+        const report = this.generateReport();
+        return formatBudgetTable(report);
+    }
+}
+// ── Formatting Helpers ───────────────────────────────────────
+/**
+ * Format a number with thousands separators.
+ * e.g. 12345 → "12,345"
+ */
+function formatNumber(n) {
+    return n.toLocaleString('en-US');
+}
+/**
+ * Right-pad or right-align a string within a fixed width.
+ */
+function padRight(str, width) {
+    return str.padEnd(width);
+}
+function padLeft(str, width) {
+    return str.padStart(width);
+}
+/**
+ * Build the formatted budget table string.
+ */
+function formatBudgetTable(report) {
+    const colW = { name: 18, used: 7, budget: 10, remaining: 12 };
+    const totalW = colW.name + colW.used + colW.budget + colW.remaining + 13; // + borders
+    const border = (left, mid, right, fill) => `${left}${fill.repeat(colW.name + 2)}${mid}${fill.repeat(colW.used + 2)}${mid}${fill.repeat(colW.budget + 2)}${mid}${fill.repeat(colW.remaining + 2)}${right}`;
+    const row = (name, used, budget, remaining) => `│ ${padRight(name, colW.name)} │ ${padLeft(used, colW.used)} │ ${padLeft(budget, colW.budget)} │ ${padLeft(remaining, colW.remaining)} │`;
+    const lines = [
+        'Token Budget Report:',
+        border('┌', '┬', '┐', '─'),
+        row('Component', 'Used', 'Budget', 'Remaining'),
+        border('├', '┼', '┤', '─'),
+    ];
+    for (const c of report.components) {
+        lines.push(row(c.label, formatNumber(c.used), formatNumber(c.budget), formatNumber(c.remaining)));
+    }
+    lines.push(border('├', '┼', '┤', '─'));
+    lines.push(row('TOTAL', formatNumber(report.totalUsed), formatNumber(report.totalBudget), formatNumber(report.totalRemaining)));
+    lines.push(border('└', '┴', '┘', '─'));
+    if (report.savingsPercent > 0) {
+        lines.push(`Estimated savings: ${report.savingsPercent}% vs naive file reading`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=token-budget.js.map

package/dist/context/token-budget.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * AI Mind Map — MCP Server Entry Point
+ *
+ * Creates the MCP server with stdio transport, registers all tools,
+ * initialises ALL real subsystems (knowledge graph, change tracker,
+ * persistent memory, context engine), and handles graceful shutdown.
+ *
+ * Usage:
+ *   ai-mind-map [--project-root <path>] [--db-path <path>] [--log-level debug|info|warn|error]
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;GASG"}