token-pilot 0.1.1

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAU/E"}

package/dist/config/loader.js

@@ -0,0 +1,31 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { DEFAULT_CONFIG } from './defaults.js';
+export async function loadConfig(projectRoot) {
+    const configPath = resolve(projectRoot, '.token-pilot.json');
+    try {
+        const raw = await readFile(configPath, 'utf-8');
+        const userConfig = JSON.parse(raw);
+        return deepMerge(structuredClone(DEFAULT_CONFIG), userConfig);
+    }
+    catch {
+        return structuredClone(DEFAULT_CONFIG);
+    }
+}
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        if (source[key] &&
+            typeof source[key] === 'object' &&
+            !Array.isArray(source[key]) &&
+            target[key] &&
+            typeof target[key] === 'object') {
+            result[key] = deepMerge(target[key], source[key]);
+        }
+        else {
+            result[key] = source[key];
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,WAAmB;IAClD,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;IAE7D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,SAAS,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,UAAU,CAAqB,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,eAAe,CAAC,cAAc,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,MAA2B,EAAE,MAA2B;IACzE,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAE7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IACE,MAAM,CAAC,GAAG,CAAC;YACX,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ;YAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,MAAM,CAAC,GAAG,CAAC;YACX,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,EAC/B,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/context-registry.d.ts

@@ -0,0 +1,31 @@
+import type { ContextEntry, LoadedRegion, SymbolInfo } from '../types.js';
+/**
+ * Advisory Context Registry.
+ * Tracks what was sent to the LLM but never blocks re-sends.
+ * The MCP server cannot know the true state of the LLM's context window.
+ */
+export declare class ContextRegistry {
+    private entries;
+    private sessionStart;
+    trackLoad(path: string, region: LoadedRegion): void;
+    setContentHash(path: string, hash: string): void;
+    getLoaded(path: string): LoadedRegion[] | null;
+    isSymbolLoaded(path: string, symbolName: string): boolean;
+    isStale(path: string, currentHash: string): boolean;
+    /**
+     * Generate a compact reminder for previously loaded content.
+     * Returns a brief summary instead of full re-read.
+     */
+    compactReminder(path: string, symbols: SymbolInfo[]): string;
+    forget(path: string, symbolName?: string): void;
+    forgetAll(): void;
+    summary(): {
+        files: number;
+        totalTokens: number;
+        sessionDuration: number;
+        entries: ContextEntry[];
+    };
+    estimateTokens(): number;
+    invalidateByGitDiff(changedFiles: string[]): void;
+}
+//# sourceMappingURL=context-registry.d.ts.map

package/dist/core/context-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-registry.d.ts","sourceRoot":"","sources":["../../src/core/context-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI1E;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,YAAY,CAAc;IAElC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IA0BnD,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAOhD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,GAAG,IAAI;IAK9C,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAMzD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAMnD;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM;IAiC5D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAgB/C,SAAS,IAAI,IAAI;IAIjB,OAAO,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,EAAE,CAAA;KAAE;IAUnG,cAAc,IAAI,MAAM;IAQxB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI;CAMlD"}

package/dist/core/context-registry.js

@@ -0,0 +1,133 @@
+import { formatDuration } from './format-duration.js';
+/**
+ * Advisory Context Registry.
+ * Tracks what was sent to the LLM but never blocks re-sends.
+ * The MCP server cannot know the true state of the LLM's context window.
+ */
+export class ContextRegistry {
+    entries = new Map();
+    sessionStart = Date.now();
+    trackLoad(path, region) {
+        const existing = this.entries.get(path);
+        if (existing) {
+            // Replace region of same type/symbol, add new ones
+            const idx = existing.loaded.findIndex(r => r.type === region.type && r.symbolName === region.symbolName);
+            if (idx >= 0) {
+                existing.loaded[idx] = region;
+            }
+            else {
+                existing.loaded.push(region);
+            }
+            existing.tokenEstimate = existing.loaded.reduce((sum, r) => sum + r.tokens, 0);
+            existing.loadedAt = Date.now();
+        }
+        else {
+            this.entries.set(path, {
+                path,
+                loaded: [region],
+                contentHash: '',
+                tokenEstimate: region.tokens,
+                loadedAt: Date.now(),
+            });
+        }
+    }
+    setContentHash(path, hash) {
+        const entry = this.entries.get(path);
+        if (entry) {
+            entry.contentHash = hash;
+        }
+    }
+    getLoaded(path) {
+        const entry = this.entries.get(path);
+        return entry?.loaded ?? null;
+    }
+    isSymbolLoaded(path, symbolName) {
+        const entry = this.entries.get(path);
+        if (!entry)
+            return false;
+        return entry.loaded.some(r => r.symbolName === symbolName);
+    }
+    isStale(path, currentHash) {
+        const entry = this.entries.get(path);
+        if (!entry || !entry.contentHash)
+            return true;
+        return entry.contentHash !== currentHash;
+    }
+    /**
+     * Generate a compact reminder for previously loaded content.
+     * Returns a brief summary instead of full re-read.
+     */
+    compactReminder(path, symbols) {
+        const entry = this.entries.get(path);
+        if (!entry)
+            return '';
+        const elapsed = formatDuration(Date.now() - entry.loadedAt);
+        const lines = [
+            `REMINDER: ${path} (previously loaded ${elapsed} ago, unchanged)`,
+            '',
+        ];
+        for (const region of entry.loaded) {
+            if (region.type === 'structure') {
+                lines.push(`  Structure loaded (${region.tokens} tokens)`);
+                // Add brief symbol list
+                for (const sym of symbols.slice(0, 5)) {
+                    lines.push(`    ${sym.kind} ${sym.name} [L${sym.location.startLine}-${sym.location.endLine}]`);
+                }
+                if (symbols.length > 5) {
+                    lines.push(`    ... (${symbols.length - 5} more symbols)`);
+                }
+            }
+            else if (region.type === 'symbol' && region.symbolName) {
+                lines.push(`  ${region.symbolName} [L${region.startLine}-${region.endLine}] (${region.tokens} tokens)`);
+            }
+            else if (region.type === 'full') {
+                lines.push(`  Full file loaded (${region.tokens} tokens)`);
+            }
+        }
+        lines.push('');
+        lines.push('HINT: File unchanged since last read. Use read_symbol() to reload specific parts, or read_diff() to see changes.');
+        return lines.join('\n');
+    }
+    forget(path, symbolName) {
+        if (symbolName) {
+            const entry = this.entries.get(path);
+            if (entry) {
+                entry.loaded = entry.loaded.filter(r => r.symbolName !== symbolName);
+                if (entry.loaded.length === 0) {
+                    this.entries.delete(path);
+                }
+                else {
+                    entry.tokenEstimate = entry.loaded.reduce((sum, r) => sum + r.tokens, 0);
+                }
+            }
+        }
+        else {
+            this.entries.delete(path);
+        }
+    }
+    forgetAll() {
+        this.entries.clear();
+    }
+    summary() {
+        const allEntries = Array.from(this.entries.values());
+        return {
+            files: allEntries.length,
+            totalTokens: allEntries.reduce((sum, e) => sum + e.tokenEstimate, 0),
+            sessionDuration: Date.now() - this.sessionStart,
+            entries: allEntries,
+        };
+    }
+    estimateTokens() {
+        let total = 0;
+        for (const entry of this.entries.values()) {
+            total += entry.tokenEstimate;
+        }
+        return total;
+    }
+    invalidateByGitDiff(changedFiles) {
+        for (const file of changedFiles) {
+            this.entries.delete(file);
+        }
+    }
+}
+//# sourceMappingURL=context-registry.js.map

package/dist/core/context-registry.js.map

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

package/dist/core/file-cache.d.ts

@@ -0,0 +1,34 @@
+import type { CacheEntry } from '../types.js';
+export declare class FileCache {
+    private cache;
+    private maxSizeBytes;
+    private currentSizeBytes;
+    private smallFileThreshold;
+    private hits;
+    private misses;
+    constructor(maxSizeMB?: number, smallFileThreshold?: number);
+    get(filePath: string): CacheEntry | null;
+    set(filePath: string, entry: CacheEntry): void;
+    isSmallFile(filePath: string): Promise<boolean>;
+    isStale(filePath: string): Promise<boolean>;
+    invalidate(filePath?: string): void;
+    invalidateByGitDiff(changedFiles: string[]): Promise<void>;
+    stats(): {
+        entries: number;
+        sizeBytes: number;
+        hitRate: number;
+    };
+    getSmallFileThreshold(): number;
+    cachedPaths(): string[];
+    private evictLRU;
+}
+/**
+ * Read a file and create a cache-ready content hash.
+ */
+export declare function readFileWithHash(filePath: string): Promise<{
+    content: string;
+    lines: string[];
+    hash: string;
+    mtime: number;
+}>;
+//# sourceMappingURL=file-cache.d.ts.map

package/dist/core/file-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cache.d.ts","sourceRoot":"","sources":["../../src/core/file-cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,aAAa,CAAC;AAE7D,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;gBAEP,SAAS,SAAM,EAAE,kBAAkB,SAAK;IAKpD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAWxC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAiBxC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/C,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAejD,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAa7B,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhE,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAShE,qBAAqB,IAAI,MAAM;IAI/B,WAAW,IAAI,MAAM,EAAE;IAIvB,OAAO,CAAC,QAAQ;CAejB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CASD"}

package/dist/core/file-cache.js

@@ -0,0 +1,120 @@
+import { stat, readFile } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+export class FileCache {
+    cache = new Map();
+    maxSizeBytes;
+    currentSizeBytes = 0;
+    smallFileThreshold;
+    hits = 0;
+    misses = 0;
+    constructor(maxSizeMB = 100, smallFileThreshold = 80) {
+        this.maxSizeBytes = maxSizeMB * 1024 * 1024;
+        this.smallFileThreshold = smallFileThreshold;
+    }
+    get(filePath) {
+        const entry = this.cache.get(filePath);
+        if (!entry) {
+            this.misses++;
+            return null;
+        }
+        entry.lastAccess = Date.now();
+        this.hits++;
+        return entry;
+    }
+    set(filePath, entry) {
+        const existingSize = this.cache.get(filePath)?.content.length ?? 0;
+        const newSize = entry.content.length;
+        // Evict LRU if needed
+        while (this.currentSizeBytes - existingSize + newSize > this.maxSizeBytes && this.cache.size > 0) {
+            this.evictLRU();
+        }
+        if (existingSize > 0) {
+            this.currentSizeBytes -= existingSize;
+        }
+        this.cache.set(filePath, entry);
+        this.currentSizeBytes += newSize;
+    }
+    async isSmallFile(filePath) {
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            return content.split('\n').length <= this.smallFileThreshold;
+        }
+        catch {
+            return false;
+        }
+    }
+    async isStale(filePath) {
+        const entry = this.cache.get(filePath);
+        if (!entry)
+            return true;
+        try {
+            const fileStat = await stat(filePath);
+            if (fileStat.mtimeMs !== entry.mtime) {
+                return true;
+            }
+            return false;
+        }
+        catch {
+            return true;
+        }
+    }
+    invalidate(filePath) {
+        if (filePath) {
+            const entry = this.cache.get(filePath);
+            if (entry) {
+                this.currentSizeBytes -= entry.content.length;
+                this.cache.delete(filePath);
+            }
+        }
+        else {
+            this.cache.clear();
+            this.currentSizeBytes = 0;
+        }
+    }
+    async invalidateByGitDiff(changedFiles) {
+        for (const file of changedFiles) {
+            this.invalidate(file);
+        }
+    }
+    stats() {
+        const total = this.hits + this.misses;
+        return {
+            entries: this.cache.size,
+            sizeBytes: this.currentSizeBytes,
+            hitRate: total > 0 ? this.hits / total : 0,
+        };
+    }
+    getSmallFileThreshold() {
+        return this.smallFileThreshold;
+    }
+    cachedPaths() {
+        return Array.from(this.cache.keys());
+    }
+    evictLRU() {
+        let oldest = null;
+        let oldestTime = Infinity;
+        for (const [path, entry] of this.cache) {
+            if (entry.lastAccess < oldestTime) {
+                oldestTime = entry.lastAccess;
+                oldest = path;
+            }
+        }
+        if (oldest) {
+            this.invalidate(oldest);
+        }
+    }
+}
+/**
+ * Read a file and create a cache-ready content hash.
+ */
+export async function readFileWithHash(filePath) {
+    const content = await readFile(filePath, 'utf-8');
+    const fileStat = await stat(filePath);
+    return {
+        content,
+        lines: content.split('\n'),
+        hash: createHash('sha256').update(content).digest('hex'),
+        mtime: fileStat.mtimeMs,
+    };
+}
+//# sourceMappingURL=file-cache.js.map

package/dist/core/file-cache.js.map

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

package/dist/core/format-duration.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Shared duration formatter. Used by server and context-registry.
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=format-duration.d.ts.map

package/dist/core/format-duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-duration.d.ts","sourceRoot":"","sources":["../../src/core/format-duration.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjD"}

package/dist/core/format-duration.js

@@ -0,0 +1,13 @@
+/**
+ * Shared duration formatter. Used by server and context-registry.
+ */
+export function formatDuration(ms) {
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m ${s % 60}s`;
+    return `${Math.floor(m / 60)}h ${m % 60}m`;
+}
+//# sourceMappingURL=format-duration.js.map

package/dist/core/format-duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-duration.js","sourceRoot":"","sources":["../../src/core/format-duration.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC;IAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC;IACtC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC;AAC7C,CAAC"}

package/dist/core/session-analytics.d.ts

@@ -0,0 +1,26 @@
+import type { ContextModeStatus } from '../integration/context-mode-detector.js';
+export interface ToolCall {
+    tool: string;
+    path?: string;
+    tokensReturned: number;
+    tokensWouldBe: number;
+    timestamp: number;
+    delegatedToContextMode?: boolean;
+}
+/**
+ * Tracks token savings and tool usage across a session.
+ * When context-mode is detected, includes unified reporting.
+ */
+export declare class SessionAnalytics {
+    private calls;
+    private sessionStart;
+    private contextModeStatus;
+    setContextModeStatus(status: ContextModeStatus): void;
+    record(call: ToolCall): void;
+    /**
+     * Generate a session report.
+     */
+    report(): string;
+    reset(): void;
+}
+//# sourceMappingURL=session-analytics.d.ts.map

package/dist/core/session-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-analytics.d.ts","sourceRoot":"","sources":["../../src/core/session-analytics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAEjF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,iBAAiB,CAA0E;IAEnG,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAIrD,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAI5B;;OAEG;IACH,MAAM,IAAI,MAAM;IA8EhB,KAAK,IAAI,IAAI;CAId"}

package/dist/core/session-analytics.js

@@ -0,0 +1,91 @@
+import { formatDuration } from './format-duration.js';
+/**
+ * Tracks token savings and tool usage across a session.
+ * When context-mode is detected, includes unified reporting.
+ */
+export class SessionAnalytics {
+    calls = [];
+    sessionStart = Date.now();
+    contextModeStatus = { detected: false, source: 'none', toolPrefix: '' };
+    setContextModeStatus(status) {
+        this.contextModeStatus = status;
+    }
+    record(call) {
+        this.calls.push(call);
+    }
+    /**
+     * Generate a session report.
+     */
+    report() {
+        const duration = formatDuration(Date.now() - this.sessionStart);
+        const totalReturned = this.calls.reduce((s, c) => s + c.tokensReturned, 0);
+        const totalWouldBe = this.calls.reduce((s, c) => s + c.tokensWouldBe, 0);
+        const saved = totalWouldBe > 0 ? Math.round((1 - totalReturned / totalWouldBe) * 100) : 0;
+        // Group by tool
+        const byTool = new Map();
+        for (const c of this.calls) {
+            const existing = byTool.get(c.tool) ?? { count: 0, tokens: 0, saved: 0 };
+            existing.count++;
+            existing.tokens += c.tokensReturned;
+            existing.saved += Math.max(0, c.tokensWouldBe - c.tokensReturned);
+            byTool.set(c.tool, existing);
+        }
+        const lines = [
+            `SESSION ANALYTICS (${duration})`,
+            '',
+            `Total tool calls: ${this.calls.length}`,
+            `Tokens returned: ~${totalReturned}`,
+            `Tokens saved: ~${totalWouldBe - totalReturned} (${saved}% reduction)`,
+            '',
+            'By tool:',
+        ];
+        for (const [tool, stats] of byTool) {
+            lines.push(`  ${tool}: ${stats.count} calls, ~${stats.tokens} tokens returned, ~${stats.saved} saved`);
+        }
+        // Top files by savings
+        const byFile = new Map();
+        for (const c of this.calls) {
+            if (c.path) {
+                const current = byFile.get(c.path) ?? 0;
+                byFile.set(c.path, current + Math.max(0, c.tokensWouldBe - c.tokensReturned));
+            }
+        }
+        const topFiles = Array.from(byFile.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5);
+        if (topFiles.length > 0) {
+            lines.push('');
+            lines.push('Top files by savings:');
+            for (const [file, saved] of topFiles) {
+                lines.push(`  ${file}: ~${saved} tokens saved`);
+            }
+        }
+        // Reminders served (compact reminders that avoided re-reads)
+        const reminders = this.calls.filter(c => c.tokensWouldBe > 0 && c.tokensReturned < c.tokensWouldBe * 0.1);
+        if (reminders.length > 0) {
+            lines.push('');
+            lines.push(`Compact reminders served: ${reminders.length} (avoided full re-reads)`);
+        }
+        // Delegation stats
+        const delegated = this.calls.filter(c => c.delegatedToContextMode);
+        if (delegated.length > 0) {
+            lines.push('');
+            lines.push(`Delegated to context-mode: ${delegated.length} calls`);
+        }
+        // Context-mode companion status
+        if (this.contextModeStatus.detected) {
+            lines.push('');
+            lines.push('--- Combined Architecture ---');
+            lines.push(`context-mode: active (detected via ${this.contextModeStatus.source})`);
+            lines.push('Token Pilot handles: code files (AST-level structural reading)');
+            lines.push('context-mode handles: shell output, logs, large data files (BM25-indexed)');
+            lines.push('TIP: Use /context-mode:stats for context-mode savings breakdown.');
+        }
+        return lines.join('\n');
+    }
+    reset() {
+        this.calls = [];
+        this.sessionStart = Date.now();
+    }
+}
+//# sourceMappingURL=session-analytics.js.map

package/dist/core/session-analytics.js.map

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

package/dist/core/symbol-resolver.d.ts

@@ -0,0 +1,21 @@
+import type { AstIndexClient } from '../ast-index/client.js';
+import type { ResolvedSymbol, FileStructure } from '../types.js';
+export declare class SymbolResolver {
+    private astIndex;
+    constructor(astIndex: AstIndexClient);
+    /**
+     * Resolve a symbol by qualified name.
+     * First tries ast-index, falls back to searching cached structure.
+     */
+    resolve(qualifiedName: string, structure?: FileStructure): Promise<ResolvedSymbol | null>;
+    /**
+     * Extract source code for a resolved symbol from file lines.
+     */
+    extractSource(resolved: ResolvedSymbol, lines: string[], options?: {
+        contextBefore?: number;
+        contextAfter?: number;
+    }): string;
+    private mapKind;
+    private findInStructure;
+}
+//# sourceMappingURL=symbol-resolver.d.ts.map

package/dist/core/symbol-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-resolver.d.ts","sourceRoot":"","sources":["../../src/core/symbol-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAc,aAAa,EAAc,MAAM,aAAa,CAAC;AAEzF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAiB;gBAErB,QAAQ,EAAE,cAAc;IAIpC;;;OAGG;IACG,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAoD/F;;OAEG;IACH,aAAa,CACX,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAO,GAC9D,MAAM;IAeT,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,eAAe;CAoBxB"}