@sharc-code/mcp 0.2.0

package/dist/project-detector.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Project Detector
+ *
+ * Detects if a path contains a valid software project using common markers.
+ * Used for:
+ * - Validating paths before sync/indexing
+ * - Generating helpful messages in tool descriptions
+ */
+export type ProjectType = 'git' | 'npm' | 'python' | 'rust' | 'go' | 'dotnet' | 'java' | 'unknown';
+export interface ProjectInfo {
+    isValid: boolean;
+    type: ProjectType;
+    markers: string[];
+    path: string;
+}
+/**
+ * Detect if a directory contains a valid software project
+ *
+ * @param dirPath - Absolute path to the directory to check
+ * @returns ProjectInfo with detection results
+ */
+export declare function detectProject(dirPath: string): Promise<ProjectInfo>;
+/**
+ * Check if a path exists and is a directory
+ *
+ * @param dirPath - Path to check
+ * @returns true if path exists and is a directory
+ */
+export declare function isValidDirectory(dirPath: string): Promise<boolean>;
+/**
+ * Get a human-readable description of the project type
+ */
+export declare function getProjectTypeDescription(type: ProjectType): string;
+/**
+ * Check if CWD or any parent is inside an indexed codebase
+ *
+ * @param cwd - Current working directory
+ * @param indexedPaths - List of indexed codebase paths
+ * @returns The matching indexed path, or null if no match
+ */
+export declare function findMatchingIndexedPath(cwd: string, indexedPaths: string[]): string | null;
+//# sourceMappingURL=project-detector.d.ts.map

package/dist/project-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detector.d.ts","sourceRoot":"","sources":["../src/project-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAEnG,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CAChB;AAqBD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAuDzE;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOxE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAYnE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAqB1F"}

package/dist/project-detector.js

@@ -0,0 +1,135 @@
+/**
+ * Project Detector
+ *
+ * Detects if a path contains a valid software project using common markers.
+ * Used for:
+ * - Validating paths before sync/indexing
+ * - Generating helpful messages in tool descriptions
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+const PROJECT_MARKERS = [
+    // Language-specific markers (higher priority)
+    { type: 'npm', files: ['package.json'], priority: 10 },
+    { type: 'python', files: ['pyproject.toml', 'setup.py', 'requirements.txt', 'Pipfile'], priority: 10 },
+    { type: 'rust', files: ['Cargo.toml'], priority: 10 },
+    { type: 'go', files: ['go.mod'], priority: 10 },
+    { type: 'java', files: ['pom.xml', 'build.gradle', 'build.gradle.kts'], priority: 10 },
+    // .NET uses wildcards
+    { type: 'dotnet', files: ['*.csproj', '*.sln', '*.fsproj', '*.vbproj'], priority: 10 },
+    // Git is a fallback (lower priority)
+    { type: 'git', files: ['.git'], priority: 1 },
+];
+/**
+ * Detect if a directory contains a valid software project
+ *
+ * @param dirPath - Absolute path to the directory to check
+ * @returns ProjectInfo with detection results
+ */
+export async function detectProject(dirPath) {
+    const result = {
+        isValid: false,
+        type: 'unknown',
+        markers: [],
+        path: dirPath,
+    };
+    try {
+        const entries = await fs.readdir(dirPath);
+        const entriesSet = new Set(entries);
+        let bestMatch = null;
+        for (const marker of PROJECT_MARKERS) {
+            const foundMarkers = [];
+            for (const file of marker.files) {
+                // Handle wildcard patterns like *.csproj
+                if (file.startsWith('*')) {
+                    const ext = file.substring(1);
+                    const match = entries.find((e) => e.endsWith(ext));
+                    if (match) {
+                        foundMarkers.push(match);
+                    }
+                }
+                else {
+                    if (entriesSet.has(file)) {
+                        foundMarkers.push(file);
+                    }
+                }
+            }
+            if (foundMarkers.length > 0) {
+                // Keep the highest priority match
+                if (!bestMatch || marker.priority > bestMatch.priority) {
+                    bestMatch = {
+                        type: marker.type,
+                        markers: foundMarkers,
+                        priority: marker.priority,
+                    };
+                }
+            }
+        }
+        if (bestMatch) {
+            result.isValid = true;
+            result.type = bestMatch.type;
+            result.markers = bestMatch.markers;
+        }
+    }
+    catch {
+        // Directory doesn't exist or can't be read
+        result.isValid = false;
+    }
+    return result;
+}
+/**
+ * Check if a path exists and is a directory
+ *
+ * @param dirPath - Path to check
+ * @returns true if path exists and is a directory
+ */
+export async function isValidDirectory(dirPath) {
+    try {
+        const stat = await fs.stat(dirPath);
+        return stat.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get a human-readable description of the project type
+ */
+export function getProjectTypeDescription(type) {
+    const descriptions = {
+        npm: 'Node.js/npm',
+        python: 'Python',
+        rust: 'Rust',
+        go: 'Go',
+        java: 'Java/Gradle/Maven',
+        dotnet: '.NET',
+        git: 'Git repository',
+        unknown: 'Unknown',
+    };
+    return descriptions[type];
+}
+/**
+ * Check if CWD or any parent is inside an indexed codebase
+ *
+ * @param cwd - Current working directory
+ * @param indexedPaths - List of indexed codebase paths
+ * @returns The matching indexed path, or null if no match
+ */
+export function findMatchingIndexedPath(cwd, indexedPaths) {
+    const normalizedCwd = path.resolve(cwd).toLowerCase();
+    for (const indexedPath of indexedPaths) {
+        const normalizedIndexed = path.resolve(indexedPath).toLowerCase();
+        // Check if CWD is inside or equal to indexed path
+        if (normalizedCwd.startsWith(normalizedIndexed)) {
+            // Ensure it's a proper path boundary (not just prefix match)
+            // e.g., /home/user/project should match /home/user/project/src
+            // but /home/user/project2 should NOT match /home/user/project
+            if (normalizedCwd === normalizedIndexed ||
+                normalizedCwd.charAt(normalizedIndexed.length) === path.sep.toLowerCase()) {
+                return indexedPath;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=project-detector.js.map

package/dist/project-detector.js.map

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

package/dist/utils/env-manager.d.ts

@@ -0,0 +1,19 @@
+export declare class EnvManager {
+    private envFilePath;
+    constructor();
+    /**
+     * Get environment variable by name
+     * Priority: process.env > .env file > undefined
+     */
+    get(name: string): string | undefined;
+    /**
+     * Set environment variable to the .env file
+     */
+    set(name: string, value: string): void;
+    /**
+     * Get the path to the .env file
+     */
+    getEnvFilePath(): string;
+}
+export declare const envManager: EnvManager;
+//# sourceMappingURL=env-manager.d.ts.map

package/dist/utils/env-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-manager.d.ts","sourceRoot":"","sources":["../../src/utils/env-manager.ts"],"names":[],"mappings":"AASA,qBAAa,UAAU;IACnB,OAAO,CAAC,WAAW,CAAS;;IAO5B;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAgCrC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IA8CtC;;OAEG;IACH,cAAc,IAAI,MAAM;CAG3B;AAGD,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/utils/env-manager.js

@@ -0,0 +1,99 @@
+/**
+ * EnvManager - duplicated from @sharc/core to avoid circular dependencies.
+ * This allows @sharc/mcp to remain independent of @sharc/core.
+ * Changes should be kept in sync with packages/core/src/utils/env-manager.ts
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+export class EnvManager {
+    constructor() {
+        const homeDir = os.homedir();
+        this.envFilePath = path.join(homeDir, '.context', '.env');
+    }
+    /**
+     * Get environment variable by name
+     * Priority: process.env > .env file > undefined
+     */
+    get(name) {
+        // First try to get from process environment variables
+        if (process.env[name]) {
+            return process.env[name];
+        }
+        // If not found in process env, try to read from .env file
+        try {
+            if (fs.existsSync(this.envFilePath)) {
+                const content = fs.readFileSync(this.envFilePath, 'utf-8');
+                const lines = content.split('\n');
+                for (const line of lines) {
+                    const trimmedLine = line.trim();
+                    if (trimmedLine.startsWith(`${name}=`)) {
+                        let value = trimmedLine.substring(name.length + 1);
+                        // Remove surrounding quotes if present
+                        if ((value.startsWith('"') && value.endsWith('"')) ||
+                            (value.startsWith("'") && value.endsWith("'"))) {
+                            value = value.slice(1, -1);
+                        }
+                        return value;
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore file read errors
+        }
+        return undefined;
+    }
+    /**
+     * Set environment variable to the .env file
+     */
+    set(name, value) {
+        try {
+            // Ensure directory exists
+            const envDir = path.dirname(this.envFilePath);
+            if (!fs.existsSync(envDir)) {
+                fs.mkdirSync(envDir, { recursive: true });
+            }
+            let content = '';
+            let found = false;
+            // Read existing content if file exists
+            if (fs.existsSync(this.envFilePath)) {
+                content = fs.readFileSync(this.envFilePath, 'utf-8');
+                // Update existing variable
+                const lines = content.split('\n');
+                for (let i = 0; i < lines.length; i++) {
+                    if (lines[i].trim().startsWith(`${name}=`)) {
+                        // Replace the existing value
+                        lines[i] = `${name}=${value}`;
+                        found = true;
+                        console.log(`[EnvManager] Updated ${name} in ${this.envFilePath}`);
+                        break;
+                    }
+                }
+                content = lines.join('\n');
+            }
+            // If variable not found, append it
+            if (!found) {
+                if (content && !content.endsWith('\n')) {
+                    content += '\n';
+                }
+                content += `${name}=${value}\n`;
+                console.log(`[EnvManager] Added ${name} to ${this.envFilePath}`);
+            }
+            fs.writeFileSync(this.envFilePath, content, 'utf-8');
+        }
+        catch (error) {
+            console.error(`[EnvManager] Failed to write env file: ${error}`);
+            throw error;
+        }
+    }
+    /**
+     * Get the path to the .env file
+     */
+    getEnvFilePath() {
+        return this.envFilePath;
+    }
+}
+// Export a default instance for convenience
+export const envManager = new EnvManager();
+//# sourceMappingURL=env-manager.js.map

package/dist/utils/env-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-manager.js","sourceRoot":"","sources":["../../src/utils/env-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,MAAM,OAAO,UAAU;IAGnB;QACI,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,IAAY;QACZ,sDAAsD;QACtD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,0DAA0D;QAC1D,IAAI,CAAC;YACD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACvB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBAChC,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;wBACrC,IAAI,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;wBACnD,uCAAuC;wBACvC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;4BAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;4BACjD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;wBAC/B,CAAC;wBACD,OAAO,KAAK,CAAC;oBACjB,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,0BAA0B;QAC9B,CAAC;QAED,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY,EAAE,KAAa;QAC3B,IAAI,CAAC;YACD,0BAA0B;YAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzB,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,CAAC;YAED,IAAI,OAAO,GAAG,EAAE,CAAC;YACjB,IAAI,KAAK,GAAG,KAAK,CAAC;YAElB,uCAAuC;YACvC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClC,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBAErD,2BAA2B;gBAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACpC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;wBACzC,6BAA6B;wBAC7B,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;wBAC9B,KAAK,GAAG,IAAI,CAAC;wBACb,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;wBACnE,MAAM;oBACV,CAAC;gBACL,CAAC;gBACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;YAED,mCAAmC;YACnC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrC,OAAO,IAAI,IAAI,CAAC;gBACpB,CAAC;gBACD,OAAO,IAAI,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YACrE,CAAC;YAED,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAEzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,0CAA0C,KAAK,EAAE,CAAC,CAAC;YACjE,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED;;OAEG;IACH,cAAc;QACV,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;CACJ;AAED,4CAA4C;AAC5C,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Truncate content to specified length
+ */
+export declare function truncateContent(content: string, maxLength: number): string;
+/**
+ * Ensure path is absolute. If relative path is provided, resolve it properly.
+ */
+export declare function ensureAbsolutePath(inputPath: string): string;
+export declare function trackCodebasePath(codebasePath: string): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAS5D;AAED,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAG5D"}

package/dist/utils.js

@@ -0,0 +1,27 @@
+import * as path from "path";
+/**
+ * Truncate content to specified length
+ */
+export function truncateContent(content, maxLength) {
+    if (content.length <= maxLength) {
+        return content;
+    }
+    return content.substring(0, maxLength) + '...';
+}
+/**
+ * Ensure path is absolute. If relative path is provided, resolve it properly.
+ */
+export function ensureAbsolutePath(inputPath) {
+    // If already absolute, return as is
+    if (path.isAbsolute(inputPath)) {
+        return inputPath;
+    }
+    // For relative paths, resolve to absolute path
+    const resolved = path.resolve(inputPath);
+    return resolved;
+}
+export function trackCodebasePath(codebasePath) {
+    const absolutePath = ensureAbsolutePath(codebasePath);
+    console.log(`[TRACKING] Tracked codebase path: ${absolutePath} (not marked as indexed)`);
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,SAAiB;IAC9D,IAAI,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC;IACnB,CAAC;IACD,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAChD,oCAAoC;IACpC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,+CAA+C;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,YAAoB;IAClD,MAAM,YAAY,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,qCAAqC,YAAY,0BAA0B,CAAC,CAAC;AAC7F,CAAC"}

package/dist/watcher/file-watcher.d.ts

@@ -0,0 +1,64 @@
+/**
+ * File Watcher Service
+ *
+ * Uses chokidar to watch for file changes in codebases.
+ * Features:
+ * - Debounced batch processing (2 seconds after last change)
+ * - Per-codebase isolation
+ * - Configurable ignore patterns
+ * - Rename handling (delete + add)
+ */
+import { type FileChange, type ChangeProcessor } from './processing-queue.js';
+export declare const SUPPORTED_EXTENSIONS: Set<string>;
+export declare const DEFAULT_IGNORE_PATTERNS: string[];
+export interface WatcherConfig {
+    debounceMs?: number;
+    ignorePatterns?: string[];
+    verbose?: boolean;
+}
+export type BatchChangeHandler = (changes: FileChange[]) => Promise<void>;
+/**
+ * File Watcher Service
+ *
+ * Watches codebases for file changes and triggers incremental indexing.
+ * Each codebase has its own watcher instance with isolated state.
+ */
+export declare class FileWatcherService {
+    private watchedCodebases;
+    private restartAttempts;
+    private debounceMs;
+    private ignorePatterns;
+    private verbose;
+    private changeProcessor;
+    private static readonly MAX_RESTART_ATTEMPTS;
+    constructor(changeProcessor: ChangeProcessor, config?: WatcherConfig);
+    /**
+     * Start watching a codebase for file changes
+     */
+    watchCodebase(codebasePath: string, collectionName: string): void;
+    /**
+     * Stop watching a codebase
+     */
+    unwatchCodebase(codebasePath: string): Promise<void>;
+    /**
+     * Get list of watched codebase paths
+     */
+    getWatchedCodebases(): string[];
+    /**
+     * Check if a codebase is being watched
+     */
+    isWatching(codebasePath: string): boolean;
+    /**
+     * Handle a file event from chokidar
+     */
+    private handleFileEvent;
+    /**
+     * Process all batched changes for a codebase
+     */
+    private processBatchedChanges;
+    /**
+     * Graceful shutdown - stop all watchers
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/watcher/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../src/watcher/file-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAmB,KAAK,UAAU,EAAuB,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGpH,eAAO,MAAM,oBAAoB,aAiB/B,CAAC;AAGH,eAAO,MAAM,uBAAuB,UAqBnC,CAAC;AAEF,MAAM,WAAW,aAAa;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAYD,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1E;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,gBAAgB,CAA2C;IACnE,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAW;IACjC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,eAAe,CAAkB;IAEzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAK;gBAErC,eAAe,EAAE,eAAe,EAAE,MAAM,GAAE,aAAkB;IAOxE;;OAEG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;IA2EjE;;OAEG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0C1D;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAKzC;;OAEG;IACH,OAAO,CAAC,eAAe;IAqCvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyB7B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAqBlC"}