codeseeker 1.4.0

package/dist/utils/config.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Configuration Manager for the Intelligent Code Auxiliary System
+ */
+import { ConfigManager } from '../core/interfaces';
+import { Logger } from './logger';
+export interface SystemConfig {
+    database: {
+        path: string;
+        maxConnections: number;
+        timeout: number;
+    };
+    analysis: {
+        maxBatchSize: number;
+        maxFileSize: number;
+        supportedExtensions: string[];
+        excludedDirectories: string[];
+        enableCaching: boolean;
+        cacheTTL: number;
+    };
+    initialization: {
+        defaultResumeTimeout: number;
+        maxRetries: number;
+        batchSize: number;
+    };
+    logging: {
+        level: 'debug' | 'info' | 'warn' | 'error';
+        enableFileLogging: boolean;
+        logDirectory: string;
+    };
+    mcp: {
+        port: number;
+        host: string;
+        enableCORS: boolean;
+        timeout: number;
+    };
+    performance: {
+        maxConcurrentOperations: number;
+        memoryLimit: number;
+        gcThreshold: number;
+    };
+}
+export declare class SystemConfigManager implements ConfigManager {
+    private config;
+    private logger;
+    private configPath?;
+    constructor(logger?: Logger);
+    get<T>(key: string, defaultValue?: T): T;
+    set(key: string, value: any): void;
+    load(configPath?: string): Promise<void>;
+    save(configPath?: string): Promise<void>;
+    getFullConfig(): Partial<SystemConfig>;
+    updateFromEnvironment(): void;
+    validate(): {
+        valid: boolean;
+        errors: string[];
+    };
+    private loadDefaults;
+    private mergeConfig;
+}
+export declare const systemConfig: SystemConfigManager;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,WAAW,YAAY;IAE3B,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAGF,QAAQ,EAAE;QACR,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,mBAAmB,EAAE,MAAM,EAAE,CAAC;QAC9B,mBAAmB,EAAE,MAAM,EAAE,CAAC;QAC9B,aAAa,EAAE,OAAO,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IAGF,cAAc,EAAE;QACd,oBAAoB,EAAE,MAAM,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAGF,OAAO,EAAE;QACP,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAC3C,iBAAiB,EAAE,OAAO,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IAGF,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,OAAO,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAGF,WAAW,EAAE;QACX,uBAAuB,EAAE,MAAM,CAAC;QAChC,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAC,CAAS;gBAEhB,MAAM,CAAC,EAAE,MAAM;IAK3B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC;IAexC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAqB5B,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BxC,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9C,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;IAItC,qBAAqB,IAAI,IAAI;IAmC7B,QAAQ,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAyChD,OAAO,CAAC,YAAY;IAgDpB,OAAO,CAAC,WAAW;CAsBpB;AAGD,eAAO,MAAM,YAAY,qBAA4B,CAAC"}

package/dist/utils/config.js

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * Configuration Manager for the Intelligent Code Auxiliary System
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.systemConfig = exports.SystemConfigManager = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const logger_1 = require("./logger");
+class SystemConfigManager {
+    config = {};
+    logger;
+    configPath;
+    constructor(logger) {
+        this.logger = logger || new logger_1.Logger();
+        this?.loadDefaults();
+    }
+    get(key, defaultValue) {
+        const keys = key?.split('.');
+        let current = this.config;
+        for (const k of keys) {
+            if (current && typeof current === 'object' && k in current) {
+                current = current[k];
+            }
+            else {
+                return defaultValue;
+            }
+        }
+        return current;
+    }
+    set(key, value) {
+        const keys = key?.split('.');
+        let current = this.config;
+        for (let i = 0; i < keys?.length - 1; i++) {
+            const k = keys[i];
+            if (!k)
+                continue;
+            if (!(k in current) || typeof current[k] !== 'object') {
+                current[k] = {};
+            }
+            current = current[k];
+        }
+        const lastKey = keys[keys?.length - 1];
+        if (lastKey) {
+            current[lastKey] = value;
+            this.logger.debug(`Config updated: ${key} = ${JSON.stringify(value)}`);
+        }
+    }
+    async load(configPath) {
+        if (configPath) {
+            this.configPath = (0, path_1.resolve)(configPath);
+        }
+        if (!this.configPath) {
+            this.logger.warn('No config path specified, using defaults');
+            return;
+        }
+        try {
+            const configContent = await fs_1.promises?.readFile(this.configPath, 'utf8');
+            const loadedConfig = JSON.parse(configContent);
+            // Merge with existing config (loaded config takes precedence)
+            this.config = this?.mergeConfig(this.config, loadedConfig);
+            this.logger.info(`Configuration loaded from: ${this.configPath}`);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                this.logger.info(`Config file not found at ${this.configPath}, creating with defaults`);
+                await this?.save();
+            }
+            else {
+                this.logger.error(`Failed to load config from ${this.configPath}`, error);
+                throw error;
+            }
+        }
+    }
+    async save(configPath) {
+        const targetPath = configPath ? (0, path_1.resolve)(configPath) : this.configPath;
+        if (!targetPath) {
+            throw new Error('No config path specified for saving');
+        }
+        try {
+            const configJson = JSON.stringify(this.config, null, 2);
+            await fs_1.promises?.writeFile(targetPath, configJson, 'utf8');
+            this.configPath = targetPath;
+            this.logger.info(`Configuration saved to: ${targetPath}`);
+        }
+        catch (error) {
+            this.logger.error(`Failed to save config to ${targetPath}`, error);
+            throw error;
+        }
+    }
+    getFullConfig() {
+        return { ...this.config };
+    }
+    updateFromEnvironment() {
+        const envMappings = {
+            'DB_PATH': 'database.path',
+            'DB_TIMEOUT': 'database.timeout',
+            'MAX_BATCH_SIZE': 'analysis.maxBatchSize',
+            'MAX_FILE_SIZE': 'analysis.maxFileSize',
+            'ENABLE_CACHING': 'analysis.enableCaching',
+            'CACHE_TTL': 'analysis.cacheTTL',
+            'LOG_LEVEL': 'logging.level',
+            'LOG_DIR': 'logging.logDirectory',
+            'MCP_PORT': 'mcp.port',
+            'MCP_HOST': 'mcp.host',
+            'MAX_MEMORY': 'performance.memoryLimit'
+        };
+        for (const [envVar, configKey] of Object.entries(envMappings)) {
+            const envValue = process.env[envVar];
+            if (envValue !== undefined) {
+                // Parse value based on type
+                let parsedValue = envValue;
+                if (envValue?.toLowerCase() === 'true') {
+                    parsedValue = true;
+                }
+                else if (envValue?.toLowerCase() === 'false') {
+                    parsedValue = false;
+                }
+                else if (!isNaN(Number(envValue))) {
+                    parsedValue = Number(envValue);
+                }
+                this?.set(configKey, parsedValue);
+                this.logger.debug(`Config updated from env: ${configKey} = ${parsedValue}`);
+            }
+        }
+    }
+    validate() {
+        const errors = [];
+        // Validate required configuration
+        const requiredPaths = [
+            'database.path',
+            'analysis.maxBatchSize',
+            'analysis.maxFileSize',
+            'mcp.port',
+            'logging.level'
+        ];
+        for (const path of requiredPaths) {
+            const value = this?.get(path);
+            if (value === undefined || value === null) {
+                errors?.push(`Missing required configuration: ${path}`);
+            }
+        }
+        // Validate specific values
+        const logLevel = this.get('logging.level');
+        if (logLevel && !['debug', 'info', 'warn', 'error'].includes(logLevel)) {
+            errors?.push(`Invalid logging level: ${logLevel}`);
+        }
+        const maxBatchSize = this.get('analysis.maxBatchSize');
+        if (maxBatchSize && (maxBatchSize <= 0 || maxBatchSize > 1000)) {
+            errors?.push(`Invalid maxBatchSize: ${maxBatchSize}. Must be between 1 and 1000`);
+        }
+        const mcpPort = this.get('mcp.port');
+        if (mcpPort && (mcpPort < 1 || mcpPort > 65535)) {
+            errors?.push(`Invalid MCP port: ${mcpPort}. Must be between 1 and 65535`);
+        }
+        return {
+            valid: errors?.length === 0,
+            errors
+        };
+    }
+    loadDefaults() {
+        const defaults = {
+            database: {
+                path: './data/auxiliary-system.db',
+                maxConnections: 10,
+                timeout: 30000
+            },
+            analysis: {
+                maxBatchSize: 100,
+                maxFileSize: 10, // 10MB
+                supportedExtensions: [
+                    '.ts', '.js', '.tsx', '.jsx',
+                    '.py', '.java', '.cpp', '.c', '.cs', '.go', '.rs',
+                    '.php', '.rb', '.swift', '.kt'
+                ],
+                excludedDirectories: [
+                    'node_modules', '.git', 'dist', 'build', '.next',
+                    '__pycache__', '.pytest_cache', 'vendor', 'target'
+                ],
+                enableCaching: true,
+                cacheTTL: 168 // 1 week in hours
+            },
+            initialization: {
+                defaultResumeTimeout: 24, // 24 hours
+                maxRetries: 3,
+                batchSize: 50
+            },
+            logging: {
+                level: process.env?.NODE_ENV === 'development' ? 'debug' : 'info',
+                enableFileLogging: false,
+                logDirectory: './logs'
+            },
+            mcp: {
+                port: 3000,
+                host: 'localhost',
+                enableCORS: true,
+                timeout: 30000
+            },
+            performance: {
+                maxConcurrentOperations: 5,
+                memoryLimit: 512, // 512MB
+                gcThreshold: 0.8
+            }
+        };
+        this.config = defaults;
+    }
+    mergeConfig(target, source) {
+        const result = { ...target };
+        for (const key in source) {
+            if (source?.hasOwnProperty(key)) {
+                if (source[key] &&
+                    typeof source[key] === 'object' &&
+                    !Array.isArray(source[key]) &&
+                    target[key] &&
+                    typeof target[key] === 'object' &&
+                    !Array.isArray(target[key])) {
+                    result[key] = this?.mergeConfig(target[key], source[key]);
+                }
+                else {
+                    result[key] = source[key];
+                }
+            }
+        }
+        return result;
+    }
+}
+exports.SystemConfigManager = SystemConfigManager;
+// Global config instance
+exports.systemConfig = new SystemConfigManager();
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/file-system.d.ts

@@ -0,0 +1,30 @@
+/**
+ * File System Helper utilities
+ */
+import { Stats } from 'fs';
+import { FileSystemHelper as IFileSystemHelper } from '../core/interfaces';
+import { Logger } from './logger';
+export declare class FileSystemHelper implements IFileSystemHelper {
+    private logger;
+    constructor(logger?: Logger);
+    getAllFiles(directory: string, extensions?: string[]): Promise<string[]>;
+    private collectFiles;
+    private shouldSkipDirectory;
+    getFileContent(filePath: string): Promise<string>;
+    getFileStats(filePath: string): Promise<Stats>;
+    fileExists(filePath: string): Promise<boolean>;
+    createDirectory(directoryPath: string): Promise<void>;
+    writeFile(filePath: string, content: string): Promise<void>;
+    getFileSize(filePath: string): Promise<number>;
+    isDirectory(path: string): Promise<boolean>;
+    isFile(path: string): Promise<boolean>;
+    getFileExtension(filePath: string): string;
+    getFileName(filePath: string): string;
+    getFileNameWithoutExtension(filePath: string): string;
+    joinPath(...paths: string[]): string;
+    resolvePath(...paths: string[]): string;
+    isTextFile(filePath: string): boolean;
+    getRelativePath(from: string, to: string): string;
+    isWithinDirectory(filePath: string, directory: string): boolean;
+}
+//# sourceMappingURL=file-system.d.ts.map

package/dist/utils/file-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../../src/utils/file-system.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAA6B,KAAK,EAAE,MAAM,IAAI,CAAC;AAEtD,OAAO,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IAIrB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAahE,YAAY;IA4C1B,OAAO,CAAC,mBAAmB;IAwBrB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUjD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAU9C,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU9C,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe3D,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK9C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS3C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS5C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI1C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAKrC,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAMrD,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAIpC,WAAW,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAKvC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAerC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM;IAMjD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;CAKhE"}

package/dist/utils/file-system.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * File System Helper utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemHelper = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const logger_1 = require("./logger");
+class FileSystemHelper {
+    logger;
+    constructor(logger) {
+        this.logger = logger || new logger_1.Logger();
+    }
+    async getAllFiles(directory, extensions) {
+        const files = [];
+        const resolvedDir = (0, path_1.resolve)(directory);
+        try {
+            await this?.collectFiles(resolvedDir, files, extensions);
+            return files?.sort(); // Return sorted for consistent ordering
+        }
+        catch (error) {
+            this.logger.error(`Failed to get files from directory: ${directory}`, error);
+            throw error;
+        }
+    }
+    async collectFiles(directory, files, extensions) {
+        let entries;
+        try {
+            entries = await fs_1.promises?.readdir(directory);
+        }
+        catch (error) {
+            this.logger.warn(`Cannot read directory: ${directory}`, { error });
+            return;
+        }
+        for (const entry of entries) {
+            const fullPath = (0, path_1.join)(directory, entry);
+            try {
+                const stats = await fs_1.promises?.stat(fullPath);
+                if (stats?.isDirectory()) {
+                    // Skip common excluded directories
+                    if (this?.shouldSkipDirectory(entry)) {
+                        continue;
+                    }
+                    await this?.collectFiles(fullPath, files, extensions);
+                }
+                else if (stats?.isFile()) {
+                    // Check file extension if specified
+                    if (extensions && extensions?.length > 0) {
+                        const ext = (0, path_1.extname)(entry).toLowerCase();
+                        if (extensions?.includes(ext) || extensions?.includes(ext?.slice(1))) {
+                            files?.push(fullPath);
+                        }
+                    }
+                    else {
+                        files?.push(fullPath);
+                    }
+                }
+            }
+            catch (error) {
+                this.logger.warn(`Cannot stat path: ${fullPath}`, { error });
+                continue;
+            }
+        }
+    }
+    shouldSkipDirectory(dirName) {
+        const excludedDirs = [
+            'node_modules',
+            '.git',
+            '.svn',
+            '.hg',
+            'dist',
+            'build',
+            'out',
+            '.next',
+            '.cache',
+            'coverage',
+            '.nyc_output',
+            '__pycache__',
+            '.pytest_cache',
+            'vendor',
+            'target',
+            'bin',
+            'obj'
+        ];
+        return excludedDirs?.includes(dirName) || dirName?.startsWith('.');
+    }
+    async getFileContent(filePath) {
+        try {
+            const resolvedPath = (0, path_1.resolve)(filePath);
+            return await fs_1.promises?.readFile(resolvedPath, 'utf8');
+        }
+        catch (error) {
+            this.logger.error(`Failed to read file: ${filePath}`, error);
+            throw error;
+        }
+    }
+    async getFileStats(filePath) {
+        try {
+            const resolvedPath = (0, path_1.resolve)(filePath);
+            return await fs_1.promises?.stat(resolvedPath);
+        }
+        catch (error) {
+            this.logger.error(`Failed to get file stats: ${filePath}`, error);
+            throw error;
+        }
+    }
+    async fileExists(filePath) {
+        try {
+            const resolvedPath = (0, path_1.resolve)(filePath);
+            await fs_1.promises?.access(resolvedPath, fs_1.constants.F_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async createDirectory(directoryPath) {
+        try {
+            const resolvedPath = (0, path_1.resolve)(directoryPath);
+            await fs_1.promises?.mkdir(resolvedPath, { recursive: true });
+        }
+        catch (error) {
+            this.logger.error(`Failed to create directory: ${directoryPath}`, error);
+            throw error;
+        }
+    }
+    async writeFile(filePath, content) {
+        try {
+            const resolvedPath = (0, path_1.resolve)(filePath);
+            // Ensure directory exists
+            const dir = (0, path_1.resolve)(resolvedPath, '..');
+            await this?.createDirectory(dir);
+            await fs_1.promises?.writeFile(resolvedPath, content, 'utf8');
+        }
+        catch (error) {
+            this.logger.error(`Failed to write file: ${filePath}`, error);
+            throw error;
+        }
+    }
+    async getFileSize(filePath) {
+        const stats = await this?.getFileStats(filePath);
+        return stats.size;
+    }
+    async isDirectory(path) {
+        try {
+            const stats = await this?.getFileStats(path);
+            return stats?.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    async isFile(path) {
+        try {
+            const stats = await this?.getFileStats(path);
+            return stats?.isFile();
+        }
+        catch {
+            return false;
+        }
+    }
+    getFileExtension(filePath) {
+        return (0, path_1.extname)(filePath).toLowerCase();
+    }
+    getFileName(filePath) {
+        const parts = filePath?.split(/[/\\]/);
+        return parts[parts?.length - 1] || '';
+    }
+    getFileNameWithoutExtension(filePath) {
+        const fileName = this?.getFileName(filePath);
+        const ext = (0, path_1.extname)(fileName);
+        return ext ? fileName?.slice(0, -ext?.length) : fileName;
+    }
+    joinPath(...paths) {
+        return (0, path_1.join)(...paths);
+    }
+    resolvePath(...paths) {
+        return (0, path_1.resolve)(...paths);
+    }
+    // Check if file is likely a text file based on extension
+    isTextFile(filePath) {
+        const textExtensions = [
+            '.txt', '.md', '.json', '.xml', '.yaml', '.yml', '.ini', '.cfg', '.conf',
+            '.js', '.ts', '.jsx', '.tsx', '.vue', '.svelte',
+            '.py', '.java', '.c', '.cpp', '.cs', '.go', '.rs', '.php', '.rb',
+            '.html', '.htm', '.css', '.scss', '.sass', '.less',
+            '.sql', '.sh', '.bash', '.bat', '.ps1',
+            '.log', '.csv', '.tsv'
+        ];
+        const ext = this?.getFileExtension(filePath);
+        return textExtensions?.includes(ext);
+    }
+    // Get relative path from base directory
+    getRelativePath(from, to) {
+        const { relative } = require('path');
+        return relative(from, to);
+    }
+    // Check if file is within directory
+    isWithinDirectory(filePath, directory) {
+        const resolvedFile = (0, path_1.resolve)(filePath);
+        const resolvedDir = (0, path_1.resolve)(directory);
+        return resolvedFile?.startsWith(resolvedDir);
+    }
+}
+exports.FileSystemHelper = FileSystemHelper;
+//# sourceMappingURL=file-system.js.map

package/dist/utils/file-system.js.map

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

package/dist/utils/hash.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Hash utilities for file content and data integrity
+ */
+export declare class HashUtils {
+    /**
+     * Generate SHA-256 hash of a string
+     */
+    static sha256(input: string): string;
+    /**
+     * Generate MD5 hash of a string (faster but less secure)
+     */
+    static md5(input: string): string;
+    /**
+     * Generate SHA-1 hash of a string
+     */
+    static sha1(input: string): string;
+    /**
+     * Generate hash of file contents
+     */
+    static hashFile(filePath: string, algorithm?: 'sha256' | 'md5' | 'sha1'): Promise<string>;
+    /**
+     * Generate hash using specified algorithm
+     */
+    static hash(input: string, algorithm?: 'sha256' | 'md5' | 'sha1'): string;
+    /**
+     * Generate HMAC with secret key
+     */
+    static hmac(input: string, secret: string, algorithm?: 'sha256' | 'sha1'): string;
+    /**
+     * Compare two hashes in a timing-safe manner
+     */
+    static compareHashes(hash1: string, hash2: string): boolean;
+    /**
+     * Generate a short hash for display purposes (first 8 characters)
+     */
+    static shortHash(input: string, length?: number): string;
+    /**
+     * Generate hash for object (converts to JSON first)
+     */
+    static hashObject(obj: any, algorithm?: 'sha256' | 'md5' | 'sha1'): string;
+    /**
+     * Generate content-based hash for code similarity
+     * Normalizes whitespace and removes comments for better similarity matching
+     */
+    static hashCodeContent(code: string): string;
+    /**
+     * Generate a deterministic hash for file metadata
+     */
+    static hashFileMetadata(filePath: string, size: number, lastModified: Date): string;
+    /**
+     * Validate hash format
+     */
+    static isValidHash(hash: string, algorithm?: 'sha256' | 'md5' | 'sha1'): boolean;
+    /**
+     * Generate UUID v4 (for resume tokens, etc.)
+     */
+    static generateUUID(): string;
+    /**
+     * Generate secure random token
+     */
+    static generateToken(length?: number): string;
+    /**
+     * Hash multiple inputs together
+     */
+    static hashMultiple(inputs: string[], algorithm?: 'sha256' | 'md5' | 'sha1'): string;
+    /**
+     * Generate content fingerprint for change detection
+     * Includes both content hash and structural information
+     */
+    static generateFingerprint(content: string, metadata?: Record<string, any>): string;
+}
+export declare const sha256: typeof HashUtils.sha256;
+export declare const md5: typeof HashUtils.md5;
+export declare const sha1: typeof HashUtils.sha1;
+export declare const hashFile: typeof HashUtils.hashFile;
+export declare const shortHash: typeof HashUtils.shortHash;
+export declare const generateUUID: typeof HashUtils.generateUUID;
+export declare const generateToken: typeof HashUtils.generateToken;
+//# sourceMappingURL=hash.d.ts.map

package/dist/utils/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,qBAAa,SAAS;IACpB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIpC;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIjC;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIlC;;OAEG;WACU,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,QAAQ,GAAG,KAAK,GAAG,MAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IASzG;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,QAAQ,GAAG,KAAK,GAAG,MAAiB,GAAG,MAAM;IAanF;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,QAAQ,GAAG,MAAiB,GAAG,MAAM;IAI3F;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAa3D;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM;IAK3D;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,GAAE,QAAQ,GAAG,KAAK,GAAG,MAAiB,GAAG,MAAM;IAKpF;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAY5C;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,GAAG,MAAM;IAUnF;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,QAAQ,GAAG,KAAK,GAAG,MAAiB,GAAG,OAAO;IAiB1F;;OAEG;IACH,MAAM,CAAC,YAAY,IAAI,MAAM;IAQ7B;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM;IAKjD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,QAAQ,GAAG,KAAK,GAAG,MAAiB,GAAG,MAAM;IAK9F;;;OAGG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;CAMpF;AAGD,eAAO,MAAM,MAAM,yBAAmB,CAAC;AACvC,eAAO,MAAM,GAAG,sBAAgB,CAAC;AACjC,eAAO,MAAM,IAAI,uBAAiB,CAAC;AACnC,eAAO,MAAM,QAAQ,2BAAqB,CAAC;AAC3C,eAAO,MAAM,SAAS,4BAAsB,CAAC;AAC7C,eAAO,MAAM,YAAY,+BAAyB,CAAC;AACnD,eAAO,MAAM,aAAa,gCAA0B,CAAC"}