viberag 0.3.2 → 0.4.0

package/dist/daemon/owner.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Daemon Resource Owner
+ *
+ * Single owner of all mutable project state. The daemon owns:
+ * - LanceDB connection (via Storage)
+ * - FileWatcher (auto-indexing on file changes)
+ * - SearchEngine (singleton, shared across requests)
+ * - IndexingService (on-demand, exclusive access via mutex)
+ *
+ * Uses event-based services instead of Redux.
+ * CLI and MCP clients access these resources via IPC.
+ */
+import { type Logger } from './lib/logger.js';
+import type { SearchResults } from './services/search/types.js';
+import { type IndexStats } from './services/indexing.js';
+import { FileWatcher, type WatcherStatus } from './services/watcher.js';
+/**
+ * Search options passed from client.
+ */
+export interface DaemonSearchOptions {
+    mode?: 'semantic' | 'exact' | 'hybrid' | 'definition' | 'similar';
+    limit?: number;
+    bm25Weight?: number;
+    minScore?: number;
+    filters?: Record<string, unknown>;
+    codeSnippet?: string;
+    symbolName?: string;
+    autoBoost?: boolean;
+    autoBoostThreshold?: number;
+    returnDebug?: boolean;
+}
+/**
+ * Index options passed from client.
+ */
+export interface DaemonIndexOptions {
+    force?: boolean;
+}
+/**
+ * Slot state for concurrent embedding tracking.
+ */
+export interface SlotState {
+    state: 'idle' | 'processing' | 'rate-limited';
+    batchInfo: string | null;
+    retryInfo: string | null;
+}
+/**
+ * Failed chunk info.
+ */
+export interface FailedChunk {
+    batchInfo: string;
+    error: string;
+    timestamp: string;
+}
+/**
+ * Status response for clients.
+ * Enhanced to support polling-based state synchronization.
+ */
+export interface DaemonStatus {
+    initialized: boolean;
+    indexed: boolean;
+    version?: number;
+    createdAt?: string;
+    updatedAt?: string;
+    totalFiles?: number;
+    totalChunks?: number;
+    embeddingProvider?: string;
+    embeddingModel?: string;
+    warmupStatus: string;
+    warmupElapsedMs?: number;
+    watcherStatus: WatcherStatus;
+    indexing: {
+        status: 'idle' | 'initializing' | 'indexing' | 'complete' | 'error';
+        current: number;
+        total: number;
+        stage: string;
+        chunksProcessed: number;
+        throttleMessage: string | null;
+        error: string | null;
+        lastCompleted: string | null;
+        lastStats: IndexStats | null;
+        percent: number;
+    };
+    slots: SlotState[];
+    failures: FailedChunk[];
+}
+/**
+ * Owns and manages all daemon resources.
+ * Uses event-based services wired to daemon state.
+ */
+export declare class DaemonOwner {
+    private readonly projectRoot;
+    private config;
+    private logger;
+    private watcher;
+    private storage;
+    private searchEngine;
+    private warmupPromise;
+    private warmupStartTime;
+    constructor(projectRoot: string);
+    /**
+     * Initialize the daemon owner.
+     * Loads config, starts watcher, begins warmup.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Shutdown the daemon owner.
+     * Stops watcher, closes search engine and storage.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Wire watcher events to daemon state.
+     */
+    private wireWatcherEvents;
+    /**
+     * Wire indexing service events to daemon state.
+     */
+    private wireIndexingEvents;
+    /**
+     * Start warmup in background.
+     */
+    private startWarmup;
+    /**
+     * Perform warmup - initialize SearchEngine with embedding provider.
+     */
+    private doWarmup;
+    /**
+     * Get the initialized SearchEngine.
+     */
+    private getSearchEngine;
+    /**
+     * Search the codebase.
+     */
+    search(query: string, options?: DaemonSearchOptions): Promise<SearchResults>;
+    /**
+     * Index the codebase.
+     */
+    index(options?: DaemonIndexOptions): Promise<IndexStats>;
+    /**
+     * Get daemon status.
+     * Enhanced to support polling-based state synchronization.
+     */
+    getStatus(): Promise<DaemonStatus>;
+    /**
+     * Map internal indexing status to client-facing status.
+     */
+    private mapIndexingStatus;
+    /**
+     * Get watcher status.
+     */
+    getWatcherStatus(): WatcherStatus;
+    /**
+     * Get the file watcher (for direct access if needed).
+     */
+    getWatcher(): FileWatcher | null;
+    /**
+     * Get the project root.
+     */
+    getProjectRoot(): string;
+    /**
+     * Get the socket path for this project.
+     */
+    getSocketPath(): string;
+    /**
+     * Get the PID file path for this project.
+     */
+    getPidPath(): string;
+    /**
+     * Get the logger instance (for centralized error logging).
+     */
+    getLogger(): Logger | null;
+    /**
+     * Log a message.
+     */
+    private log;
+}