@sharc-code/mcp 0.2.0

package/dist/backend-handlers.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Backend-aware Tool Handlers
+ * These handlers use the SHARC backend for embedding, search, and sync operations.
+ * File scanning and chunking still happen locally.
+ * Snapshot/status data is persisted in the backend database.
+ */
+import type { ContextMcpConfig } from "./config.js";
+interface ChunkTier {
+    name: string;
+    extensions: string[];
+    maxSize: number;
+    overlap: number;
+    useAst: boolean;
+}
+declare const CHUNK_TIERS: ChunkTier[];
+declare function getTierForExtension(ext: string): ChunkTier;
+declare const DEFAULT_FILE_EXTENSIONS: string[];
+export { CHUNK_TIERS, DEFAULT_FILE_EXTENSIONS, ChunkTier, getTierForExtension };
+export declare class BackendToolHandlers {
+    private backendClient;
+    private currentWorkspace;
+    private config;
+    private cachedSnapshot;
+    private cacheTimestamp;
+    private fileWatcherService;
+    private incrementalIndexers;
+    private syntaxGuard;
+    private splitterCache;
+    constructor(config: ContextMcpConfig);
+    /**
+     * Load snapshot from backend with caching
+     */
+    private getSnapshot;
+    /**
+     * Invalidate local cache to force refresh on next access
+     */
+    private invalidateCache;
+    /**
+     * Get list of indexed codebases
+     */
+    private getIndexedCodebases;
+    /**
+     * Get list of codebases currently being indexed
+     */
+    private getIndexingCodebases;
+    /**
+     * Get codebase status
+     */
+    private getCodebaseStatus;
+    /**
+     * Get complete codebase info
+     */
+    private getCodebaseInfo;
+    /**
+     * Get indexing progress for a codebase
+     */
+    private getIndexingProgress;
+    /**
+     * Set codebase to indexing status
+     */
+    private setCodebaseIndexing;
+    /**
+     * Set codebase to indexed status
+     */
+    private setCodebaseIndexed;
+    /**
+     * Set codebase to failed status
+     */
+    private setCodebaseIndexFailed;
+    /**
+     * Remove codebase from snapshot completely
+     */
+    private removeCodebaseFromSnapshot;
+    /**
+     * Generate a collection name from a codebase path
+     * Must match the backend's expectation (URL-safe, unique per path)
+     * Uses SHA-256 for better collision resistance
+     */
+    private generateCollectionName;
+    /**
+     * Sync indexed codebases from backend collections
+     * Compares snapshot data with actual vector collections and removes stale entries
+     */
+    private syncIndexedCodebasesFromBackend;
+    /**
+     * Initialize the file watcher service (lazy initialization)
+     */
+    private initializeFileWatcher;
+    /**
+     * Process a single file change (used by FileWatcherService)
+     */
+    private processFileChange;
+    /**
+     * Create an incremental indexer for a codebase
+     */
+    private createIncrementalIndexer;
+    /**
+     * Start watching a codebase for file changes
+     */
+    private startWatching;
+    /**
+     * Stop watching a codebase
+     */
+    private stopWatching;
+    /**
+     * Get list of watched codebases
+     */
+    getWatchedCodebases(): string[];
+    /**
+     * Check if a codebase is being watched
+     */
+    isWatching(codebasePath: string): boolean;
+    /**
+     * Graceful shutdown of all watchers and cleanup resources
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Get a splitter for a given tier (cached for reuse)
+     */
+    private getSplitterForTier;
+    /**
+     * Check if a path exists (async replacement for fs.existsSync)
+     */
+    private pathExists;
+    /**
+     * Scan and chunk files from a codebase directory
+     * Uses async file I/O to avoid blocking the event loop
+     */
+    private scanAndChunkFiles;
+    private shouldIgnore;
+    private static readonly MAX_FILE_SIZE;
+    /**
+     * Generate SHA-256 hashes for all supported files in the codebase
+     */
+    private generateFileHashes;
+    /**
+     * Compare old and new file hashes to detect changes
+     */
+    private compareFileHashes;
+    /**
+     * Apply incremental changes to the index (Merkle diff)
+     * Only indexes added/modified files, deletes removed file vectors
+     */
+    private applyIncrementalChanges;
+    /**
+     * Chunk a single file using the tier strategy (helper for incremental indexing)
+     */
+    private chunkFileWithTier;
+    private getLanguageFromExtension;
+    handleIndexCodebase(args: any): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    }>;
+    private startBackgroundIndexing;
+    handleSearchCode(args: any): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    }>;
+    handleClearIndex(args: any): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+    handleGetIndexingStatus(args: any): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    }>;
+    handleStartWatch(args: any): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    }>;
+    handleStopWatch(args: any): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+    handleGetWatchStatus(_args: any): Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+}
+//# sourceMappingURL=backend-handlers.d.ts.map

package/dist/backend-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-handlers.d.ts","sourceRoot":"","sources":["../src/backend-handlers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6BH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAWpD,UAAU,SAAS;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,QAAA,MAAM,WAAW,EAAE,SAAS,EAiC3B,CAAC;AAmBF,iBAAS,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAEnD;AAGD,QAAA,MAAM,uBAAuB,UAA+C,CAAC;AAG7E,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC;AAKhF,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,MAAM,CAAmB;IAGjC,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,cAAc,CAAa;IAGnC,OAAO,CAAC,kBAAkB,CAAmC;IAC7D,OAAO,CAAC,mBAAmB,CAA8C;IACzE,OAAO,CAAC,WAAW,CAAc;IAGjC,OAAO,CAAC,aAAa,CAAmE;gBAE5E,MAAM,EAAE,gBAAgB;IAcpC;;OAEG;YACW,WAAW;IAqBzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;YACW,mBAAmB;IAOjC;;OAEG;YACW,oBAAoB;IAOlC;;OAEG;YACW,iBAAiB;IAO/B;;OAEG;YACW,eAAe;IAK7B;;OAEG;YACW,mBAAmB;IASjC;;OAEG;YACW,mBAAmB;IAUjC;;OAEG;YACW,kBAAkB;IAehC;;OAEG;YACW,sBAAsB;IAepC;;OAEG;YACW,0BAA0B;IAKxC;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAM9B;;;OAGG;YACW,+BAA+B;IAgC7C;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;YACW,iBAAiB;IAgB/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA+DhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;YACW,YAAY;IAW1B;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAO/B;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAOzC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAe/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;YACW,UAAU;IASxB;;;OAGG;YACW,iBAAiB;IAgJ/B,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAa;IAElD;;OAEG;YACW,kBAAkB;IAkDhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;;OAGG;YACW,uBAAuB;IAwFrC;;OAEG;YACW,iBAAiB;IA6B/B,OAAO,CAAC,wBAAwB;IAoCnB,mBAAmB,CAAC,IAAI,EAAE,GAAG;;;;;;;;;;;;;YAmL5B,uBAAuB;IAwHxB,gBAAgB,CAAC,IAAI,EAAE,GAAG;;;;;;;;;;;;;IAuH1B,gBAAgB,CAAC,IAAI,EAAE,GAAG;;;;;;;;;;;;;IAoG1B,uBAAuB,CAAC,IAAI,EAAE,GAAG;;;;;;;;;;;;;IA0GjC,gBAAgB,CAAC,IAAI,EAAE,GAAG;;;;;;;;;;;;;IA2E1B,eAAe,CAAC,IAAI,EAAE,GAAG;;;;;;;;;;;;;IAuCzB,oBAAoB,CAAC,KAAK,EAAE,GAAG;;;;;;;;;;;;;CAgC/C"}