glancey 2.0.0

package/dist/dashboard/state.d.ts

@@ -0,0 +1,172 @@
+import { EventEmitter } from 'events';
+import type { CodeIndexer, IndexStatus, IndexProgress } from '../search/indexer.js';
+import type { GlanceyConfig } from '../config.js';
+import type { BackendFallbackInfo } from '../embeddings/types.js';
+import { type TokenSavingsStats } from './token-tracking.js';
+/**
+ * Command names that can be tracked
+ */
+export type CommandName = 'index_codebase' | 'search_code' | 'search_similar' | 'get_index_status' | 'clear_index' | 'get_project_instructions' | 'commit' | 'get_symbols_overview' | 'find_symbol' | 'find_referencing_symbols' | 'search_for_pattern' | 'replace_symbol_body' | 'insert_before_symbol' | 'insert_after_symbol' | 'rename_symbol' | 'write_memory' | 'read_memory' | 'list_memories' | 'delete_memory' | 'edit_memory' | 'create_worktree' | 'list_worktrees' | 'remove_worktree' | 'worktree_status' | 'list_concepts' | 'search_by_concept' | 'summarize_codebase' | 'open_dashboard';
+/**
+ * Command usage statistics
+ */
+export interface CommandUsage {
+    command: CommandName;
+    count: number;
+    label: string;
+}
+/**
+ * Events emitted by the DashboardStateManager
+ */
+export interface DashboardStateEvents {
+    progress: (progress: IndexProgress) => void;
+    'indexing:start': () => void;
+    'indexing:complete': (result: {
+        filesIndexed: number;
+        chunksCreated: number;
+    }) => void;
+    'status:change': (status: IndexStatus) => void;
+    'usage:update': (usage: CommandUsage[]) => void;
+}
+export declare class DashboardStateManager extends EventEmitter {
+    private indexer;
+    private config;
+    private projectPath;
+    private version;
+    private isIndexing;
+    private lastProgress;
+    private commandUsage;
+    private backendFallback;
+    constructor();
+    /**
+     * Get the path to the usage file
+     */
+    private getUsageFilePath;
+    /**
+     * Load command usage from disk
+     */
+    private loadUsageFromDisk;
+    /**
+     * Save command usage to disk
+     */
+    private saveUsageToDisk;
+    /**
+     * Set the indexer instance for the dashboard to use
+     */
+    setIndexer(indexer: CodeIndexer): void;
+    /**
+     * Set the configuration for the dashboard to display
+     */
+    setConfig(config: GlanceyConfig): void;
+    /**
+     * Set the project path
+     */
+    setProjectPath(projectPath: string): void;
+    /**
+     * Set the package version
+     */
+    setVersion(version: string): void;
+    /**
+     * Get the package version
+     */
+    getVersion(): string | null;
+    /**
+     * Set backend fallback info when a fallback occurred during initialization
+     */
+    setBackendFallback(fallback: BackendFallbackInfo): void;
+    /**
+     * Clear backend fallback info (when backend is successfully reinitialized)
+     */
+    clearBackendFallback(): void;
+    /**
+     * Get backend fallback info if a fallback occurred
+     */
+    getBackendFallback(): BackendFallbackInfo | null;
+    /**
+     * Get the current index status
+     */
+    getStatus(): Promise<IndexStatus | null>;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): GlanceyConfig | null;
+    /**
+     * Get the project path
+     */
+    getProjectPath(): string | null;
+    /**
+     * Check if indexing is in progress
+     */
+    isIndexingInProgress(): boolean;
+    /**
+     * Get the last progress update
+     */
+    getLastProgress(): IndexProgress | null;
+    /**
+     * Called when indexing starts
+     */
+    onIndexingStart(): void;
+    /**
+     * Called with progress updates during indexing
+     */
+    onProgress(progress: IndexProgress): void;
+    /**
+     * Update just the message portion of the current progress.
+     * Useful for sub-progress updates (e.g., Ollama batch progress).
+     */
+    updateProgressMessage(message: string): void;
+    /**
+     * Update sub-progress within the current phase.
+     * Allows embedding backends to report their own progress with percentage.
+     * The current/total values represent sub-progress within the phase.
+     */
+    updateSubProgress(current: number, total: number, message: string): void;
+    /**
+     * Called when indexing completes
+     */
+    onIndexingComplete(result: {
+        filesIndexed: number;
+        chunksCreated: number;
+    }): void;
+    /**
+     * Called when status changes
+     */
+    onStatusChange(status: IndexStatus): void;
+    /**
+     * Trigger a reindex of the codebase.
+     * Returns a promise that resolves when indexing completes.
+     */
+    triggerReindex(forceReindex?: boolean): Promise<{
+        filesIndexed: number;
+        chunksCreated: number;
+    } | null>;
+    /**
+     * Record a command usage
+     */
+    recordCommandUsage(command: CommandName): void;
+    /**
+     * Get command usage statistics
+     */
+    getCommandUsage(): CommandUsage[];
+    /**
+     * Get total command count for percentage calculations
+     */
+    getTotalCommandCount(): number;
+    /**
+     * Get token savings statistics
+     */
+    getTokenSavings(): TokenSavingsStats;
+    /**
+     * Get the token tracker for recording savings
+     */
+    getTokenTracker(): import("./token-tracking.js").TokenSavingsTracker;
+    /**
+     * Emit token savings update event for real-time dashboard updates
+     */
+    emitTokenSavingsUpdate(): void;
+}
+/**
+ * Singleton instance of the dashboard state manager
+ */
+export declare const dashboardState: DashboardStateManager;
+//# sourceMappingURL=state.d.ts.map

package/dist/dashboard/state.d.ts.map

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

package/dist/dashboard/state.js

@@ -0,0 +1,362 @@
+import { EventEmitter } from 'events';
+import * as fs from 'fs';
+import * as path from 'path';
+import { tokenTracker } from './token-tracking.js';
+/**
+ * Manages the shared state for the dashboard.
+ * Acts as a bridge between the indexer and the dashboard.
+ */
+/**
+ * Human-readable labels for commands
+ */
+const COMMAND_LABELS = {
+    index_codebase: 'Index Codebase',
+    search_code: 'Search Code',
+    search_similar: 'Search Similar',
+    get_index_status: 'Get Status',
+    clear_index: 'Clear Index',
+    get_project_instructions: 'Get Instructions',
+    commit: 'Commit',
+    // Symbolic analysis tools
+    get_symbols_overview: 'Symbols Overview',
+    find_symbol: 'Find Symbol',
+    find_referencing_symbols: 'Find References',
+    search_for_pattern: 'Pattern Search',
+    replace_symbol_body: 'Replace Symbol',
+    insert_before_symbol: 'Insert Before',
+    insert_after_symbol: 'Insert After',
+    rename_symbol: 'Rename Symbol',
+    // Memory tools
+    write_memory: 'Write Memory',
+    read_memory: 'Read Memory',
+    list_memories: 'List Memories',
+    delete_memory: 'Delete Memory',
+    edit_memory: 'Edit Memory',
+    // Worktree tools
+    create_worktree: 'Create Worktree',
+    list_worktrees: 'List Worktrees',
+    remove_worktree: 'Remove Worktree',
+    worktree_status: 'Worktree Status',
+    // Clustering tools
+    list_concepts: 'List Concepts',
+    search_by_concept: 'Search by Concept',
+    summarize_codebase: 'Summarize Codebase',
+    // Dashboard tools
+    open_dashboard: 'Open Dashboard',
+};
+/** Maximum number of event listeners to prevent memory leaks */
+const MAX_LISTENERS = 20;
+export class DashboardStateManager extends EventEmitter {
+    indexer = null;
+    config = null;
+    projectPath = null;
+    version = null;
+    isIndexing = false;
+    lastProgress = null;
+    commandUsage = new Map();
+    backendFallback = null;
+    constructor() {
+        super();
+        // Set max listeners to prevent memory leak warnings and enforce bounds
+        this.setMaxListeners(MAX_LISTENERS);
+    }
+    /**
+     * Get the path to the usage file
+     */
+    getUsageFilePath() {
+        if (!this.projectPath)
+            return null;
+        return path.join(this.projectPath, '.glancey', 'usage.json');
+    }
+    /**
+     * Load command usage from disk
+     */
+    loadUsageFromDisk() {
+        const filePath = this.getUsageFilePath();
+        if (!filePath)
+            return;
+        try {
+            if (fs.existsSync(filePath)) {
+                const data = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+                this.commandUsage.clear();
+                for (const [cmd, count] of Object.entries(data)) {
+                    if (typeof count === 'number') {
+                        this.commandUsage.set(cmd, count);
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore errors, start with empty usage
+        }
+    }
+    /**
+     * Save command usage to disk
+     */
+    saveUsageToDisk() {
+        const filePath = this.getUsageFilePath();
+        if (!filePath)
+            return;
+        try {
+            const data = {};
+            for (const [cmd, count] of this.commandUsage) {
+                data[cmd] = count;
+            }
+            fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
+        }
+        catch {
+            // Ignore errors
+        }
+    }
+    /**
+     * Set the indexer instance for the dashboard to use
+     */
+    setIndexer(indexer) {
+        this.indexer = indexer;
+    }
+    /**
+     * Set the configuration for the dashboard to display
+     */
+    setConfig(config) {
+        this.config = config;
+    }
+    /**
+     * Set the project path
+     */
+    setProjectPath(projectPath) {
+        this.projectPath = projectPath;
+        this.loadUsageFromDisk();
+        tokenTracker.setProjectPath(projectPath);
+    }
+    /**
+     * Set the package version
+     */
+    setVersion(version) {
+        this.version = version;
+    }
+    /**
+     * Get the package version
+     */
+    getVersion() {
+        return this.version;
+    }
+    /**
+     * Set backend fallback info when a fallback occurred during initialization
+     */
+    setBackendFallback(fallback) {
+        this.backendFallback = fallback;
+    }
+    /**
+     * Clear backend fallback info (when backend is successfully reinitialized)
+     */
+    clearBackendFallback() {
+        this.backendFallback = null;
+    }
+    /**
+     * Get backend fallback info if a fallback occurred
+     */
+    getBackendFallback() {
+        return this.backendFallback;
+    }
+    /**
+     * Get the current index status
+     */
+    async getStatus() {
+        if (!this.indexer) {
+            return null;
+        }
+        return this.indexer.getStatus();
+    }
+    /**
+     * Get the current configuration
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Get the project path
+     */
+    getProjectPath() {
+        return this.projectPath;
+    }
+    /**
+     * Check if indexing is in progress
+     */
+    isIndexingInProgress() {
+        return this.isIndexing;
+    }
+    /**
+     * Get the last progress update
+     */
+    getLastProgress() {
+        return this.lastProgress;
+    }
+    /**
+     * Called when indexing starts
+     */
+    onIndexingStart() {
+        this.isIndexing = true;
+        this.lastProgress = null;
+        this.emit('indexing:start');
+    }
+    /**
+     * Called with progress updates during indexing
+     */
+    onProgress(progress) {
+        this.lastProgress = progress;
+        this.emit('progress', progress);
+    }
+    /**
+     * Update just the message portion of the current progress.
+     * Useful for sub-progress updates (e.g., Ollama batch progress).
+     */
+    updateProgressMessage(message) {
+        if (this.lastProgress) {
+            this.lastProgress = { ...this.lastProgress, message };
+            this.emit('progress', this.lastProgress);
+        }
+    }
+    /**
+     * Update sub-progress within the current phase.
+     * Allows embedding backends to report their own progress with percentage.
+     * The current/total values represent sub-progress within the phase.
+     */
+    updateSubProgress(current, total, message) {
+        if (this.lastProgress) {
+            this.lastProgress = { ...this.lastProgress, current, total, message };
+            this.emit('progress', this.lastProgress);
+        }
+    }
+    /**
+     * Called when indexing completes
+     */
+    onIndexingComplete(result) {
+        this.isIndexing = false;
+        this.lastProgress = null;
+        this.emit('indexing:complete', result);
+    }
+    /**
+     * Called when status changes
+     */
+    onStatusChange(status) {
+        this.emit('status:change', status);
+    }
+    /**
+     * Trigger a reindex of the codebase.
+     * Returns a promise that resolves when indexing completes.
+     */
+    async triggerReindex(forceReindex = false) {
+        if (!this.indexer || !this.config) {
+            return null;
+        }
+        if (this.isIndexing) {
+            throw new Error('Indexing is already in progress');
+        }
+        this.onIndexingStart();
+        try {
+            const result = await this.indexer.indexCodebase(this.config.patterns, this.config.excludePatterns, forceReindex, (progress) => this.onProgress(progress));
+            this.onIndexingComplete(result);
+            return result;
+        }
+        catch (error) {
+            this.isIndexing = false;
+            this.lastProgress = null;
+            throw error;
+        }
+    }
+    /**
+     * Record a command usage
+     */
+    recordCommandUsage(command) {
+        // Reload from disk to get latest counts (in case another process updated)
+        this.loadUsageFromDisk();
+        const current = this.commandUsage.get(command) || 0;
+        this.commandUsage.set(command, current + 1);
+        this.saveUsageToDisk();
+        this.emit('usage:update', this.getCommandUsage());
+    }
+    /**
+     * Get command usage statistics
+     */
+    getCommandUsage() {
+        // Reload from disk to get latest counts (in case another process updated)
+        this.loadUsageFromDisk();
+        const allCommands = [
+            'search_code',
+            'search_similar',
+            'index_codebase',
+            'get_index_status',
+            'clear_index',
+            'get_project_instructions',
+            'commit',
+            // Symbolic analysis
+            'get_symbols_overview',
+            'find_symbol',
+            'find_referencing_symbols',
+            'search_for_pattern',
+            'replace_symbol_body',
+            'insert_before_symbol',
+            'insert_after_symbol',
+            'rename_symbol',
+            // Memory
+            'write_memory',
+            'read_memory',
+            'list_memories',
+            'delete_memory',
+            'edit_memory',
+            // Worktree
+            'create_worktree',
+            'list_worktrees',
+            'remove_worktree',
+            'worktree_status',
+            // Clustering
+            'list_concepts',
+            'search_by_concept',
+            'summarize_codebase',
+            // Dashboard
+            'open_dashboard',
+        ];
+        return allCommands.map((command) => ({
+            command,
+            count: this.commandUsage.get(command) || 0,
+            label: COMMAND_LABELS[command],
+        }));
+    }
+    /**
+     * Get total command count for percentage calculations
+     */
+    getTotalCommandCount() {
+        let total = 0;
+        for (const count of this.commandUsage.values()) {
+            total += count;
+        }
+        return total;
+    }
+    /**
+     * Get token savings statistics
+     */
+    getTokenSavings() {
+        return tokenTracker.getStats();
+    }
+    /**
+     * Get the token tracker for recording savings
+     */
+    getTokenTracker() {
+        return tokenTracker;
+    }
+    /**
+     * Emit token savings update event for real-time dashboard updates
+     */
+    emitTokenSavingsUpdate() {
+        this.emit('tokenSavings:update', tokenTracker.getStats());
+    }
+}
+/**
+ * Singleton instance of the dashboard state manager
+ */
+export const dashboardState = new DashboardStateManager();
+// Wire up token savings updates to emit SSE events
+tokenTracker.setOnUpdate(() => {
+    dashboardState.emitTokenSavingsUpdate();
+});
+//# sourceMappingURL=state.js.map

package/dist/dashboard/state.js.map

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

package/dist/dashboard/token-tracking.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Token tracking module for estimating tokens saved by lance-context operations.
+ *
+ * Token estimation is based on the common approximation that 1 token ≈ 4 characters.
+ * This provides a rough estimate for understanding the efficiency gains from using
+ * semantic search vs. reading entire files.
+ */
+/**
+ * Token savings event types
+ */
+export type TokenSavingsEventType = 'search_code' | 'search_similar' | 'get_symbols_overview' | 'find_symbol' | 'summarize_codebase' | 'list_concepts' | 'search_by_concept';
+/**
+ * Record of a single token savings event
+ */
+export interface TokenSavingsEvent {
+    type: TokenSavingsEventType;
+    timestamp: number;
+    /** Characters returned to the agent */
+    charsReturned: number;
+    /** Estimated characters that would have been read without lance-context */
+    charsAvoided: number;
+    /** Number of files that would have been read */
+    filesAvoided: number;
+    /** Additional context about the operation */
+    context?: string;
+}
+/**
+ * Aggregated token savings statistics
+ */
+export interface TokenSavingsStats {
+    /** Total estimated tokens saved */
+    tokensSaved: number;
+    /** Total characters returned */
+    charsReturned: number;
+    /** Total characters avoided (not sent to agent) */
+    charsAvoided: number;
+    /** Total files avoided reading */
+    filesAvoided: number;
+    /** Number of operations tracked */
+    operationCount: number;
+    /** Savings breakdown by operation type */
+    byType: Record<TokenSavingsEventType, {
+        count: number;
+        tokensSaved: number;
+        charsReturned: number;
+        charsAvoided: number;
+    }>;
+    /** Efficiency percentage (chars avoided / total chars) */
+    efficiencyPercent: number;
+    /** Session start time */
+    sessionStart: number;
+}
+/**
+ * Token savings tracker for a session
+ */
+export declare class TokenSavingsTracker {
+    private events;
+    private sessionStart;
+    private onUpdate;
+    private projectPath;
+    private saveTimer;
+    private pendingSave;
+    /**
+     * Set the project path and load persisted data
+     */
+    setProjectPath(projectPath: string): void;
+    /**
+     * Get the path to the token savings file
+     */
+    private getFilePath;
+    /**
+     * Load token savings from disk with validation
+     */
+    private loadFromDisk;
+    /**
+     * Save token savings to disk (debounced to avoid blocking on every event)
+     */
+    private saveToDisk;
+    /**
+     * Set callback to be called when token savings are updated
+     */
+    setOnUpdate(callback: () => void): void;
+    /**
+     * Notify that token savings have been updated
+     */
+    private notifyUpdate;
+    /**
+     * Record a search_code operation
+     * @param charsReturned Characters in the search results
+     * @param matchedFiles Number of files that matched
+     * @param totalFilesSearched Total files in the index
+     */
+    recordSearchCode(charsReturned: number, matchedFiles: number, totalFilesSearched: number): void;
+    /**
+     * Record a search_similar operation
+     * @param charsReturned Characters in the similar code results
+     * @param matchedChunks Number of similar chunks found
+     */
+    recordSearchSimilar(charsReturned: number, matchedChunks: number): void;
+    /**
+     * Record a get_symbols_overview operation
+     * @param charsReturned Characters in the symbols overview
+     * @param fileLines Total lines in the file
+     */
+    recordSymbolsOverview(charsReturned: number, fileLines: number): void;
+    /**
+     * Record a find_symbol operation
+     * @param charsReturned Characters in the symbol results
+     * @param filesSearched Number of files searched
+     */
+    recordFindSymbol(charsReturned: number, filesSearched: number): void;
+    /**
+     * Record a summarize_codebase operation
+     * @param charsReturned Characters in the summary
+     * @param totalFiles Total files in codebase
+     */
+    recordSummarizeCodebase(charsReturned: number, totalFiles: number): void;
+    /**
+     * Record a list_concepts operation
+     * @param charsReturned Characters in the concepts list
+     * @param clusterCount Number of concept clusters
+     */
+    recordListConcepts(charsReturned: number, clusterCount: number): void;
+    /**
+     * Record a search_by_concept operation
+     * @param charsReturned Characters in the concept search results
+     * @param matchedChunks Number of chunks in the concept
+     */
+    recordSearchByConcept(charsReturned: number, matchedChunks: number): void;
+    /**
+     * Get aggregated statistics
+     */
+    getStats(): TokenSavingsStats;
+    /**
+     * Get recent events (for debugging/display)
+     */
+    getRecentEvents(limit?: number): TokenSavingsEvent[];
+}
+/**
+ * Global token savings tracker instance
+ */
+export declare const tokenTracker: TokenSavingsTracker;
+//# sourceMappingURL=token-tracking.d.ts.map