@loxia-labs/loxia-autopilot-one 1.0.1 → 1.0.3

package/src/types/contextReference.js

@@ -1,972 +1 @@
-/**
- * Context Reference Data Model - Type definitions and validation for context references
- * 
- * Purpose:
- * - Define the structure and properties of context references
- * - Provide validation functions for context reference data
- * - Handle context reference resolution and management
- */
-
-import { CONTEXT_REFERENCE_TYPES, FILE_EXTENSIONS, CONTEXT_ICONS } from '../utilities/constants.js';
-
-/**
- * Context Reference data model
- * @typedef {Object} ContextReference
- * @property {string} id - Unique reference identifier
- * @property {string} type - Reference type (file, component, selection, directory)
- * @property {string} path - Path or identifier of referenced item
- * @property {string} name - Human-readable name
- * @property {string} [content] - Referenced content (if loaded)
- * @property {ReferenceMetadata} metadata - Reference metadata
- * @property {ReferenceScope} scope - Reference scope and boundaries
- * @property {string} createdAt - ISO timestamp of creation
- * @property {string} [lastAccessed] - ISO timestamp of last access
- * @property {string} [lastModified] - ISO timestamp of last modification
- * @property {boolean} isValid - Whether reference is still valid
- * @property {string} [invalidReason] - Reason for invalidity
- * @property {number} accessCount - Number of times accessed
- * @property {Object} tags - Reference tags and labels
- */
-
-/**
- * Reference metadata
- * @typedef {Object} ReferenceMetadata
- * @property {string} [language] - Programming language (for code files)
- * @property {string} [encoding] - File encoding
- * @property {number} [size] - Content size in bytes
- * @property {string} [mimeType] - MIME type
- * @property {string} [checksum] - Content checksum for integrity
- * @property {string[]} [keywords] - Extracted keywords
- * @property {string} [description] - Reference description
- * @property {Object} [customFields] - Custom metadata fields
- * @property {string} [icon] - Display icon identifier
- * @property {Object} [permissions] - Access permissions
- */
-
-/**
- * Reference scope and boundaries
- * @typedef {Object} ReferenceScope
- * @property {number} [startLine] - Start line number (for selections)
- * @property {number} [endLine] - End line number (for selections)
- * @property {number} [startColumn] - Start column number
- * @property {number} [endColumn] - End column number
- * @property {string} [functionName] - Function/method name (for code)
- * @property {string} [className] - Class name (for code)
- * @property {string} [namespace] - Namespace or module (for code)
- * @property {string[]} [includePaths] - Included sub-paths (for directories)
- * @property {string[]} [excludePaths] - Excluded sub-paths (for directories)
- * @property {number} [maxDepth] - Maximum directory depth
- */
-
-/**
- * File Reference (extends ContextReference)
- * @typedef {Object} FileReference
- * @property {string} absolutePath - Absolute file path
- * @property {string} relativePath - Relative file path from workspace
- * @property {string} extension - File extension
- * @property {boolean} exists - Whether file exists on filesystem
- * @property {FileStats} [stats] - File system statistics
- * @property {string} [gitStatus] - Git status of file
- * @property {DependencyInfo} [dependencies] - File dependencies
- */
-
-/**
- * Directory Reference (extends ContextReference)
- * @typedef {Object} DirectoryReference
- * @property {string} absolutePath - Absolute directory path
- * @property {string} relativePath - Relative directory path from workspace
- * @property {FileSystemTree} [tree] - Directory tree structure
- * @property {number} [fileCount] - Number of files in directory
- * @property {number} [totalSize] - Total size of directory contents
- * @property {string[]} [fileTypes] - File types present in directory
- */
-
-/**
- * Selection Reference (extends ContextReference)
- * @typedef {Object} SelectionReference
- * @property {string} sourceFile - Source file path
- * @property {string} selectedText - Selected text content
- * @property {SyntaxInfo} [syntax] - Syntax information
- * @property {ContextInfo} [context] - Surrounding context
- * @property {string} [purpose] - Purpose of selection
- */
-
-/**
- * Component Reference (extends ContextReference)
- * @typedef {Object} ComponentReference
- * @property {string} componentType - Type of component
- * @property {string} [sourceFile] - Source file containing component
- * @property {Object} [properties] - Component properties
- * @property {string[]} [dependencies] - Component dependencies
- * @property {string} [documentation] - Component documentation
- */
-
-/**
- * File system statistics
- * @typedef {Object} FileStats
- * @property {number} size - File size in bytes
- * @property {string} created - Creation timestamp
- * @property {string} modified - Last modification timestamp
- * @property {string} accessed - Last access timestamp
- * @property {boolean} isDirectory - Whether item is directory
- * @property {boolean} isFile - Whether item is file
- * @property {number} mode - File permissions mode
- */
-
-/**
- * File system tree structure
- * @typedef {Object} FileSystemTree
- * @property {string} name - Item name
- * @property {string} path - Item path
- * @property {string} type - Item type (file, directory)
- * @property {FileSystemTree[]} [children] - Child items (for directories)
- * @property {number} [size] - Item size
- * @property {string} [extension] - File extension
- */
-
-/**
- * Syntax information
- * @typedef {Object} SyntaxInfo
- * @property {string} language - Programming language
- * @property {string[]} [symbols] - Identified symbols
- * @property {string[]} [imports] - Import statements
- * @property {string[]} [functions] - Function definitions
- * @property {string[]} [classes] - Class definitions
- * @property {string[]} [variables] - Variable definitions
- */
-
-/**
- * Context information
- * @typedef {Object} ContextInfo
- * @property {string} [beforeText] - Text before selection
- * @property {string} [afterText] - Text after selection
- * @property {number} [indentLevel] - Indentation level
- * @property {string[]} [surroundingFunctions] - Surrounding function names
- * @property {string[]} [surroundingClasses] - Surrounding class names
- */
-
-/**
- * Dependency information
- * @typedef {Object} DependencyInfo
- * @property {string[]} imports - Imported modules/files
- * @property {string[]} exports - Exported items
- * @property {string[]} dependencies - External dependencies
- * @property {string[]} dependents - Files that depend on this file
- */
-
-/**
- * Context Reference validation functions
- */
-export class ContextReferenceValidator {
-  /**
-   * Validate context reference data structure
-   * @param {Object} reference - Context reference to validate
-   * @returns {Object} Validation result
-   */
-  static validate(reference) {
-    const errors = [];
-    const warnings = [];
-
-    // Required fields
-    if (!reference.id || typeof reference.id !== 'string') {
-      errors.push('Reference ID is required and must be a string');
-    }
-
-    if (!reference.type || typeof reference.type !== 'string') {
-      errors.push('Reference type is required and must be a string');
-    }
-
-    if (!reference.path || typeof reference.path !== 'string') {
-      errors.push('Reference path is required and must be a string');
-    }
-
-    if (!reference.name || typeof reference.name !== 'string') {
-      errors.push('Reference name is required and must be a string');
-    }
-
-    // Type validation
-    if (reference.type && !Object.values(CONTEXT_REFERENCE_TYPES).includes(reference.type)) {
-      errors.push(`Invalid reference type: ${reference.type}`);
-    }
-
-    // Content validation
-    if (reference.content && typeof reference.content !== 'string') {
-      errors.push('Reference content must be a string');
-    }
-
-    if (reference.content && reference.content.length > 1000000) { // 1MB
-      warnings.push('Reference content is very large (>1MB)');
-    }
-
-    // Metadata validation
-    if (reference.metadata) {
-      const metadataValidation = this.validateMetadata(reference.metadata);
-      errors.push(...metadataValidation.errors);
-      warnings.push(...metadataValidation.warnings);
-    }
-
-    // Scope validation
-    if (reference.scope) {
-      const scopeValidation = this.validateScope(reference.scope);
-      errors.push(...scopeValidation.errors);
-      warnings.push(...scopeValidation.warnings);
-    }
-
-    // Access count validation
-    if (reference.accessCount !== undefined && typeof reference.accessCount !== 'number') {
-      errors.push('Access count must be a number');
-    }
-
-    // Timestamp validation
-    const timestampFields = ['createdAt', 'lastAccessed', 'lastModified'];
-    timestampFields.forEach(field => {
-      if (reference[field] && !this.isValidTimestamp(reference[field])) {
-        errors.push(`Invalid timestamp for ${field}: ${reference[field]}`);
-      }
-    });
-
-    // Type-specific validation
-    switch (reference.type) {
-      case CONTEXT_REFERENCE_TYPES.FILE:
-        const fileValidation = this.validateFileReference(reference);
-        errors.push(...fileValidation.errors);
-        warnings.push(...fileValidation.warnings);
-        break;
-      case CONTEXT_REFERENCE_TYPES.SELECTION:
-        const selectionValidation = this.validateSelectionReference(reference);
-        errors.push(...selectionValidation.errors);
-        warnings.push(...selectionValidation.warnings);
-        break;
-      case CONTEXT_REFERENCE_TYPES.DIRECTORY:
-        const directoryValidation = this.validateDirectoryReference(reference);
-        errors.push(...directoryValidation.errors);
-        warnings.push(...directoryValidation.warnings);
-        break;
-    }
-
-    return {
-      isValid: errors.length === 0,
-      errors,
-      warnings
-    };
-  }
-
-  /**
-   * Validate reference metadata
-   * @param {Object} metadata - Metadata to validate
-   * @returns {Object} Validation result
-   */
-  static validateMetadata(metadata) {
-    const errors = [];
-    const warnings = [];
-
-    if (metadata.size !== undefined && (typeof metadata.size !== 'number' || metadata.size < 0)) {
-      errors.push('Metadata size must be a non-negative number');
-    }
-
-    if (metadata.language && typeof metadata.language !== 'string') {
-      errors.push('Metadata language must be a string');
-    }
-
-    if (metadata.encoding && typeof metadata.encoding !== 'string') {
-      errors.push('Metadata encoding must be a string');
-    }
-
-    if (metadata.keywords && !Array.isArray(metadata.keywords)) {
-      errors.push('Metadata keywords must be an array');
-    }
-
-    if (metadata.mimeType && typeof metadata.mimeType !== 'string') {
-      errors.push('Metadata MIME type must be a string');
-    }
-
-    return { errors, warnings };
-  }
-
-  /**
-   * Validate reference scope
-   * @param {Object} scope - Scope to validate
-   * @returns {Object} Validation result
-   */
-  static validateScope(scope) {
-    const errors = [];
-    const warnings = [];
-
-    const numericFields = ['startLine', 'endLine', 'startColumn', 'endColumn', 'maxDepth'];
-    numericFields.forEach(field => {
-      if (scope[field] !== undefined && (typeof scope[field] !== 'number' || scope[field] < 0)) {
-        errors.push(`Scope ${field} must be a non-negative number`);
-      }
-    });
-
-    // Line range validation
-    if (scope.startLine !== undefined && scope.endLine !== undefined) {
-      if (scope.startLine > scope.endLine) {
-        errors.push('Start line must be <= end line');
-      }
-    }
-
-    // Column range validation
-    if (scope.startColumn !== undefined && scope.endColumn !== undefined) {
-      if (scope.startColumn > scope.endColumn) {
-        errors.push('Start column must be <= end column');
-      }
-    }
-
-    const arrayFields = ['includePaths', 'excludePaths'];
-    arrayFields.forEach(field => {
-      if (scope[field] && !Array.isArray(scope[field])) {
-        errors.push(`Scope ${field} must be an array`);
-      }
-    });
-
-    return { errors, warnings };
-  }
-
-  /**
-   * Validate file reference specific fields
-   * @param {Object} reference - File reference to validate
-   * @returns {Object} Validation result
-   */
-  static validateFileReference(reference) {
-    const errors = [];
-    const warnings = [];
-
-    if (reference.absolutePath && typeof reference.absolutePath !== 'string') {
-      errors.push('Absolute path must be a string');
-    }
-
-    if (reference.relativePath && typeof reference.relativePath !== 'string') {
-      errors.push('Relative path must be a string');
-    }
-
-    if (reference.extension && typeof reference.extension !== 'string') {
-      errors.push('File extension must be a string');
-    }
-
-    if (reference.exists !== undefined && typeof reference.exists !== 'boolean') {
-      errors.push('File exists flag must be a boolean');
-    }
-
-    return { errors, warnings };
-  }
-
-  /**
-   * Validate selection reference specific fields
-   * @param {Object} reference - Selection reference to validate
-   * @returns {Object} Validation result
-   */
-  static validateSelectionReference(reference) {
-    const errors = [];
-    const warnings = [];
-
-    if (!reference.scope || (!reference.scope.startLine && !reference.scope.endLine)) {
-      warnings.push('Selection reference should have line scope defined');
-    }
-
-    if (reference.selectedText && typeof reference.selectedText !== 'string') {
-      errors.push('Selected text must be a string');
-    }
-
-    if (reference.sourceFile && typeof reference.sourceFile !== 'string') {
-      errors.push('Source file must be a string');
-    }
-
-    return { errors, warnings };
-  }
-
-  /**
-   * Validate directory reference specific fields
-   * @param {Object} reference - Directory reference to validate
-   * @returns {Object} Validation result
-   */
-  static validateDirectoryReference(reference) {
-    const errors = [];
-    const warnings = [];
-
-    if (reference.fileCount !== undefined && (typeof reference.fileCount !== 'number' || reference.fileCount < 0)) {
-      errors.push('File count must be a non-negative number');
-    }
-
-    if (reference.totalSize !== undefined && (typeof reference.totalSize !== 'number' || reference.totalSize < 0)) {
-      errors.push('Total size must be a non-negative number');
-    }
-
-    if (reference.fileTypes && !Array.isArray(reference.fileTypes)) {
-      errors.push('File types must be an array');
-    }
-
-    return { errors, warnings };
-  }
-
-  /**
-   * Check if a timestamp is valid ISO string
-   * @param {string} timestamp - Timestamp to validate
-   * @returns {boolean} True if valid
-   */
-  static isValidTimestamp(timestamp) {
-    if (typeof timestamp !== 'string') return false;
-    const date = new Date(timestamp);
-    return date instanceof Date && !isNaN(date.getTime());
-  }
-}
-
-/**
- * Context Reference factory functions
- */
-export class ContextReferenceFactory {
-  /**
-   * Create a new context reference
-   * @param {string} type - Reference type
-   * @param {string} path - Reference path
-   * @param {string} name - Reference name
-   * @param {Object} options - Additional options
-   * @returns {ContextReference} New context reference
-   */
-  static create(type, path, name, options = {}) {
-    const now = new Date().toISOString();
-    const referenceId = this.generateReferenceId();
-
-    return {
-      id: referenceId,
-      type,
-      path,
-      name,
-      content: options.content || null,
-      metadata: this.createDefaultMetadata(type, path, options.metadata),
-      scope: options.scope || {},
-      createdAt: now,
-      lastAccessed: null,
-      lastModified: options.lastModified || null,
-      isValid: true,
-      invalidReason: null,
-      accessCount: 0,
-      tags: options.tags || {}
-    };
-  }
-
-  /**
-   * Create a file reference
-   * @param {string} absolutePath - Absolute file path
-   * @param {string} relativePath - Relative file path
-   * @param {Object} options - Additional options
-   * @returns {FileReference} File reference
-   */
-  static createFileReference(absolutePath, relativePath, options = {}) {
-    const name = options.name || this.extractFileName(absolutePath);
-    const extension = this.extractFileExtension(absolutePath);
-    
-    const reference = this.create(CONTEXT_REFERENCE_TYPES.FILE, relativePath, name, options);
-    
-    return {
-      ...reference,
-      absolutePath,
-      relativePath,
-      extension,
-      exists: options.exists !== undefined ? options.exists : true,
-      stats: options.stats || null,
-      gitStatus: options.gitStatus || null,
-      dependencies: options.dependencies || null
-    };
-  }
-
-  /**
-   * Create a selection reference
-   * @param {string} sourceFile - Source file path
-   * @param {string} selectedText - Selected text
-   * @param {Object} scope - Selection scope
-   * @param {Object} options - Additional options
-   * @returns {SelectionReference} Selection reference
-   */
-  static createSelectionReference(sourceFile, selectedText, scope, options = {}) {
-    const name = options.name || this.generateSelectionName(sourceFile, scope);
-    
-    const reference = this.create(CONTEXT_REFERENCE_TYPES.SELECTION, sourceFile, name, {
-      ...options,
-      scope,
-      content: selectedText
-    });
-    
-    return {
-      ...reference,
-      sourceFile,
-      selectedText,
-      syntax: options.syntax || null,
-      context: options.context || null,
-      purpose: options.purpose || null
-    };
-  }
-
-  /**
-   * Create a directory reference
-   * @param {string} absolutePath - Absolute directory path
-   * @param {string} relativePath - Relative directory path
-   * @param {Object} options - Additional options
-   * @returns {DirectoryReference} Directory reference
-   */
-  static createDirectoryReference(absolutePath, relativePath, options = {}) {
-    const name = options.name || this.extractDirectoryName(absolutePath);
-    
-    const reference = this.create(CONTEXT_REFERENCE_TYPES.DIRECTORY, relativePath, name, options);
-    
-    return {
-      ...reference,
-      absolutePath,
-      relativePath,
-      tree: options.tree || null,
-      fileCount: options.fileCount || null,
-      totalSize: options.totalSize || null,
-      fileTypes: options.fileTypes || null
-    };
-  }
-
-  /**
-   * Create a component reference
-   * @param {string} componentType - Component type
-   * @param {string} path - Component path/identifier
-   * @param {string} name - Component name
-   * @param {Object} options - Additional options
-   * @returns {ComponentReference} Component reference
-   */
-  static createComponentReference(componentType, path, name, options = {}) {
-    const reference = this.create(CONTEXT_REFERENCE_TYPES.COMPONENT, path, name, options);
-    
-    return {
-      ...reference,
-      componentType,
-      sourceFile: options.sourceFile || null,
-      properties: options.properties || null,
-      dependencies: options.dependencies || null,
-      documentation: options.documentation || null
-    };
-  }
-
-  /**
-   * Create default metadata for reference type
-   * @param {string} type - Reference type
-   * @param {string} path - Reference path
-   * @param {Object} overrides - Metadata overrides
-   * @returns {ReferenceMetadata} Default metadata
-   */
-  static createDefaultMetadata(type, path, overrides = {}) {
-    const metadata = {
-      language: null,
-      encoding: 'utf-8',
-      size: null,
-      mimeType: null,
-      checksum: null,
-      keywords: [],
-      description: '',
-      customFields: {},
-      icon: this.getDefaultIcon(type, path),
-      permissions: {},
-      ...overrides
-    };
-
-    // Set language for file references
-    if (type === CONTEXT_REFERENCE_TYPES.FILE) {
-      const extension = this.extractFileExtension(path);
-      metadata.language = this.getLanguageFromExtension(extension);
-      metadata.mimeType = this.getMimeTypeFromExtension(extension);
-    }
-
-    return metadata;
-  }
-
-  /**
-   * Generate unique reference ID
-   * @returns {string} Unique reference ID
-   */
-  static generateReferenceId() {
-    const timestamp = Date.now().toString(36);
-    const random = Math.random().toString(36).substr(2, 9);
-    return `ref_${timestamp}_${random}`;
-  }
-
-  /**
-   * Extract file name from path
-   * @param {string} path - File path
-   * @returns {string} File name
-   */
-  static extractFileName(path) {
-    return path.split(/[/\\]/).pop() || path;
-  }
-
-  /**
-   * Extract directory name from path
-   * @param {string} path - Directory path
-   * @returns {string} Directory name
-   */
-  static extractDirectoryName(path) {
-    const parts = path.split(/[/\\]/).filter(Boolean);
-    return parts[parts.length - 1] || 'Root';
-  }
-
-  /**
-   * Extract file extension from path
-   * @param {string} path - File path
-   * @returns {string} File extension
-   */
-  static extractFileExtension(path) {
-    const fileName = this.extractFileName(path);
-    const lastDot = fileName.lastIndexOf('.');
-    return lastDot !== -1 ? fileName.substring(lastDot) : '';
-  }
-
-  /**
-   * Generate selection name from file and scope
-   * @param {string} sourceFile - Source file path
-   * @param {Object} scope - Selection scope
-   * @returns {string} Selection name
-   */
-  static generateSelectionName(sourceFile, scope) {
-    const fileName = this.extractFileName(sourceFile);
-    
-    if (scope.startLine && scope.endLine) {
-      if (scope.startLine === scope.endLine) {
-        return `${fileName}:${scope.startLine}`;
-      } else {
-        return `${fileName}:${scope.startLine}-${scope.endLine}`;
-      }
-    }
-    
-    if (scope.functionName) {
-      return `${fileName}:${scope.functionName}()`;
-    }
-    
-    if (scope.className) {
-      return `${fileName}:${scope.className}`;
-    }
-    
-    return `${fileName} (selection)`;
-  }
-
-  /**
-   * Get default icon for reference type and path
-   * @param {string} type - Reference type
-   * @param {string} path - Reference path
-   * @returns {string} Icon identifier
-   */
-  static getDefaultIcon(type, path) {
-    if (type === CONTEXT_REFERENCE_TYPES.FILE) {
-      const extension = this.extractFileExtension(path);
-      return FILE_ICONS[extension] || CONTEXT_ICONS.DEFAULT;
-    }
-    
-    return CONTEXT_ICONS[type] || CONTEXT_ICONS.DEFAULT;
-  }
-
-  /**
-   * Get programming language from file extension
-   * @param {string} extension - File extension
-   * @returns {string|null} Programming language
-   */
-  static getLanguageFromExtension(extension) {
-    const languageMap = {
-      '.js': 'javascript',
-      '.jsx': 'javascript',
-      '.ts': 'typescript',
-      '.tsx': 'typescript',
-      '.py': 'python',
-      '.java': 'java',
-      '.cpp': 'cpp',
-      '.c': 'c',
-      '.cs': 'csharp',
-      '.php': 'php',
-      '.rb': 'ruby',
-      '.go': 'go',
-      '.rs': 'rust',
-      '.html': 'html',
-      '.css': 'css',
-      '.scss': 'scss',
-      '.json': 'json',
-      '.yml': 'yaml',
-      '.yaml': 'yaml',
-      '.xml': 'xml',
-      '.sql': 'sql',
-      '.md': 'markdown'
-    };
-    
-    return languageMap[extension.toLowerCase()] || null;
-  }
-
-  /**
-   * Get MIME type from file extension
-   * @param {string} extension - File extension
-   * @returns {string|null} MIME type
-   */
-  static getMimeTypeFromExtension(extension) {
-    const mimeMap = {
-      '.js': 'application/javascript',
-      '.jsx': 'application/javascript',
-      '.ts': 'application/typescript',
-      '.tsx': 'application/typescript',
-      '.py': 'text/x-python',
-      '.java': 'text/x-java-source',
-      '.cpp': 'text/x-c++src',
-      '.c': 'text/x-csrc',
-      '.cs': 'text/x-csharp',
-      '.php': 'application/x-php',
-      '.rb': 'application/x-ruby',
-      '.go': 'text/x-go',
-      '.rs': 'text/x-rust',
-      '.html': 'text/html',
-      '.css': 'text/css',
-      '.scss': 'text/x-scss',
-      '.json': 'application/json',
-      '.yml': 'application/x-yaml',
-      '.yaml': 'application/x-yaml',
-      '.xml': 'application/xml',
-      '.sql': 'application/sql',
-      '.md': 'text/markdown',
-      '.txt': 'text/plain'
-    };
-    
-    return mimeMap[extension.toLowerCase()] || 'text/plain';
-  }
-}
-
-/**
- * Context Reference utility functions
- */
-export class ContextReferenceUtils {
-  /**
-   * Check if reference is still valid
-   * @param {ContextReference} reference - Reference to check
-   * @returns {boolean} True if valid
-   */
-  static isValid(reference) {
-    return reference.isValid && !reference.invalidReason;
-  }
-
-  /**
-   * Mark reference as accessed
-   * @param {ContextReference} reference - Reference to mark
-   * @returns {ContextReference} Updated reference
-   */
-  static markAccessed(reference) {
-    return {
-      ...reference,
-      lastAccessed: new Date().toISOString(),
-      accessCount: reference.accessCount + 1
-    };
-  }
-
-  /**
-   * Mark reference as invalid
-   * @param {ContextReference} reference - Reference to invalidate
-   * @param {string} reason - Reason for invalidation
-   * @returns {ContextReference} Updated reference
-   */
-  static markInvalid(reference, reason) {
-    return {
-      ...reference,
-      isValid: false,
-      invalidReason: reason
-    };
-  }
-
-  /**
-   * Get reference display name with context
-   * @param {ContextReference} reference - Reference to format
-   * @returns {string} Display name
-   */
-  static getDisplayName(reference) {
-    if (reference.type === CONTEXT_REFERENCE_TYPES.SELECTION && reference.scope) {
-      return ContextReferenceFactory.generateSelectionName(reference.path, reference.scope);
-    }
-    
-    return reference.name;
-  }
-
-  /**
-   * Get reference description
-   * @param {ContextReference} reference - Reference to describe
-   * @returns {string} Description
-   */
-  static getDescription(reference) {
-    if (reference.metadata?.description) {
-      return reference.metadata.description;
-    }
-
-    switch (reference.type) {
-      case CONTEXT_REFERENCE_TYPES.FILE:
-        return `File: ${reference.path}`;
-      case CONTEXT_REFERENCE_TYPES.DIRECTORY:
-        return `Directory: ${reference.path}`;
-      case CONTEXT_REFERENCE_TYPES.SELECTION:
-        return `Selection from ${reference.path}`;
-      case CONTEXT_REFERENCE_TYPES.COMPONENT:
-        return `Component: ${reference.name}`;
-      default:
-        return reference.path;
-    }
-  }
-
-  /**
-   * Calculate reference relevance score
-   * @param {ContextReference} reference - Reference to score
-   * @param {Object} context - Scoring context
-   * @returns {number} Relevance score (0-1)
-   */
-  static calculateRelevance(reference, context = {}) {
-    let score = 0.5; // Base score
-
-    // Recent access bonus
-    if (reference.lastAccessed) {
-      const daysSinceAccess = (Date.now() - new Date(reference.lastAccessed)) / (1000 * 60 * 60 * 24);
-      score += Math.max(0, 0.2 * (1 - daysSinceAccess / 30)); // Decay over 30 days
-    }
-
-    // Access frequency bonus
-    if (reference.accessCount > 0) {
-      score += Math.min(0.2, reference.accessCount * 0.01);
-    }
-
-    // Type-specific scoring
-    switch (reference.type) {
-      case CONTEXT_REFERENCE_TYPES.FILE:
-        if (context.fileTypes && reference.metadata?.language) {
-          if (context.fileTypes.includes(reference.metadata.language)) {
-            score += 0.2;
-          }
-        }
-        break;
-      case CONTEXT_REFERENCE_TYPES.SELECTION:
-        score += 0.1; // Selections are often more relevant
-        break;
-    }
-
-    // Keyword matching
-    if (context.keywords && reference.metadata?.keywords) {
-      const matches = context.keywords.filter(k => 
-        reference.metadata.keywords.includes(k)
-      ).length;
-      score += Math.min(0.3, matches * 0.1);
-    }
-
-    // Invalid references get heavy penalty
-    if (!reference.isValid) {
-      score *= 0.1;
-    }
-
-    return Math.min(1, Math.max(0, score));
-  }
-
-  /**
-   * Group references by type
-   * @param {ContextReference[]} references - References to group
-   * @returns {Object} Grouped references
-   */
-  static groupByType(references) {
-    return references.reduce((groups, reference) => {
-      const type = reference.type;
-      if (!groups[type]) {
-        groups[type] = [];
-      }
-      groups[type].push(reference);
-      return groups;
-    }, {});
-  }
-
-  /**
-   * Sort references by relevance
-   * @param {ContextReference[]} references - References to sort
-   * @param {Object} context - Sorting context
-   * @returns {ContextReference[]} Sorted references
-   */
-  static sortByRelevance(references, context = {}) {
-    return [...references].sort((a, b) => {
-      const scoreA = this.calculateRelevance(a, context);
-      const scoreB = this.calculateRelevance(b, context);
-      return scoreB - scoreA;
-    });
-  }
-
-  /**
-   * Filter references by criteria
-   * @param {ContextReference[]} references - References to filter
-   * @param {Object} criteria - Filter criteria
-   * @returns {ContextReference[]} Filtered references
-   */
-  static filter(references, criteria = {}) {
-    return references.filter(reference => {
-      // Type filter
-      if (criteria.types && !criteria.types.includes(reference.type)) {
-        return false;
-      }
-
-      // Valid filter
-      if (criteria.validOnly && !reference.isValid) {
-        return false;
-      }
-
-      // Language filter
-      if (criteria.languages && reference.metadata?.language) {
-        if (!criteria.languages.includes(reference.metadata.language)) {
-          return false;
-        }
-      }
-
-      // Path filter
-      if (criteria.pathPattern) {
-        const regex = new RegExp(criteria.pathPattern, 'i');
-        if (!regex.test(reference.path)) {
-          return false;
-        }
-      }
-
-      // Keyword filter
-      if (criteria.keywords && reference.metadata?.keywords) {
-        const hasKeyword = criteria.keywords.some(keyword =>
-          reference.metadata.keywords.includes(keyword)
-        );
-        if (!hasKeyword) {
-          return false;
-        }
-      }
-
-      // Date range filter
-      if (criteria.createdAfter) {
-        if (new Date(reference.createdAt) < new Date(criteria.createdAfter)) {
-          return false;
-        }
-      }
-
-      if (criteria.createdBefore) {
-        if (new Date(reference.createdAt) > new Date(criteria.createdBefore)) {
-          return false;
-        }
-      }
-
-      return true;
-    });
-  }
-
-  /**
-   * Format reference for display
-   * @param {ContextReference} reference - Reference to format
-   * @returns {Object} Formatted reference
-   */
-  static formatForDisplay(reference) {
-    return {
-      id: reference.id,
-      type: reference.type,
-      name: this.getDisplayName(reference),
-      description: this.getDescription(reference),
-      path: reference.path,
-      icon: reference.metadata?.icon || CONTEXT_ICONS[reference.type] || CONTEXT_ICONS.DEFAULT,
-      isValid: reference.isValid,
-      lastAccessed: reference.lastAccessed,
-      accessCount: reference.accessCount,
-      size: reference.metadata?.size || null,
-      language: reference.metadata?.language || null
-    };
-  }
-}
-
-export default {
-  ContextReferenceValidator,
-  ContextReferenceFactory,
-  ContextReferenceUtils
-};
+const a0_0x4dff8e=a0_0x465e;(function(_0x105b3e,_0x5cabbc){const _0x3c2eda=a0_0x465e,_0x5c7c94=_0x105b3e();while(!![]){try{const _0x113b25=-parseInt(_0x3c2eda(0x11e))/0x1*(parseInt(_0x3c2eda(0x107))/0x2)+-parseInt(_0x3c2eda(0x183))/0x3*(-parseInt(_0x3c2eda(0x159))/0x4)+-parseInt(_0x3c2eda(0x127))/0x5*(-parseInt(_0x3c2eda(0x10c))/0x6)+-parseInt(_0x3c2eda(0x141))/0x7+parseInt(_0x3c2eda(0x184))/0x8*(parseInt(_0x3c2eda(0x146))/0x9)+parseInt(_0x3c2eda(0x11b))/0xa*(-parseInt(_0x3c2eda(0x147))/0xb)+-parseInt(_0x3c2eda(0x156))/0xc*(-parseInt(_0x3c2eda(0x153))/0xd);if(_0x113b25===_0x5cabbc)break;else _0x5c7c94['push'](_0x5c7c94['shift']());}catch(_0x31c300){_0x5c7c94['push'](_0x5c7c94['shift']());}}}(a0_0x56f3,0xb9a7b));import{CONTEXT_REFERENCE_TYPES,FILE_EXTENSIONS,CONTEXT_ICONS}from'../utilities/constants.js';function a0_0x465e(_0x3886e0,_0x274be9){_0x3886e0=_0x3886e0-0xf4;const _0x56f3e6=a0_0x56f3();let _0x465e80=_0x56f3e6[_0x3886e0];if(a0_0x465e['oCAacS']===undefined){var _0x59a2d7=function(_0x335230){const _0x3517c8='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0x562c3d='',_0x2c9c93='';for(let _0x413afa=0x0,_0x52cd27,_0x8a89cd,_0x2cd667=0x0;_0x8a89cd=_0x335230['charAt'](_0x2cd667++);~_0x8a89cd&&(_0x52cd27=_0x413afa%0x4?_0x52cd27*0x40+_0x8a89cd:_0x8a89cd,_0x413afa++%0x4)?_0x562c3d+=String['fromCharCode'](0xff&_0x52cd27>>(-0x2*_0x413afa&0x6)):0x0){_0x8a89cd=_0x3517c8['indexOf'](_0x8a89cd);}for(let _0x504dfe=0x0,_0x135e4c=_0x562c3d['length'];_0x504dfe<_0x135e4c;_0x504dfe++){_0x2c9c93+='%'+('00'+_0x562c3d['charCodeAt'](_0x504dfe)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x2c9c93);};a0_0x465e['GcdKJb']=_0x59a2d7,a0_0x465e['OZWvBO']={},a0_0x465e['oCAacS']=!![];}const _0x1136bf=_0x56f3e6[0x0],_0x2b2f55=_0x3886e0+_0x1136bf,_0xe29659=a0_0x465e['OZWvBO'][_0x2b2f55];return!_0xe29659?(_0x465e80=a0_0x465e['GcdKJb'](_0x465e80),a0_0x465e['OZWvBO'][_0x2b2f55]=_0x465e80):_0x465e80=_0xe29659,_0x465e80;}function a0_0x56f3(){const _0x3cc464=['CNvIEq','revgqvvmva','ChvZAa','C2nZCW','DhLWzxm','C29Tzq','twv0ywrHDgeGC2L6zsbTDxn0igjLigeGBM9Ulw5Lz2f0AxzLig51BwjLCG','zxHJBhvKzvbHDgHZ','yxbWBgLJyxrPB24VC3fS','q09nue9oru5u','ig11C3qGyMuGysbUB24TBMvNyxrPDMuGBNvTyMvY','mJyZndKZEhnMse1l','nJG4rw9fyNzU','rKLmrq','AMf2yq','ChjVCgvYDgLLCW','Cgf0Aa','zg9JDw1LBNrHDgLVBG','Cgf0AfbHDhrLCM4','yxbWBgLJyxrPB24VEg1S','Dgv4Dc9JC3m','DxrMltG','zNvUy3rPB25oyw1L','DhLWzxnJCMLWDa','D2fYBMLUz3m','u2nVCguG','BwLU','u2vSzwn0zwqGDgv4DcbTDxn0igjLigeGC3rYAw5N','ywnJzxnZq291BNq','z2v0rgLZCgXHEu5HBwu','Dg9mB3DLCKnHC2u','AxnbCNjHEq','BgvUz3rO','mtu0mtm4ofHsufj1zW','zMLSDgvY','u291CMnLigzPBguGBxvZDcbIzsbHihn0CMLUzW','C3rHDhm','y29UDgvUDa','mJeWAvPUrKPT','CMfUzg9T','u0vmrunusu9o','C2nVCgu','CMvMxW','zw5Kq29SDw1U','z2v0twLTzvr5CgvgCM9TrxH0zw5ZAw9U','Dgv4Dc9TyxjRzg93BG','DgvZDa','BwfYA0fJy2vZC2vK','CgHW','C2L6zq','z2v0tgfUz3vHz2vgCM9TrxH0zw5ZAw9U','icHZzwXLy3rPB24P','y3jLyxrLzefMDgvY','mtK4otq2mfr0sNLNBa','Dgv4Dc94lwnZAgfYCa','zxH0CMfJDezPBgvoyw1L','mujmzwT4CG','y3jLyxrL','BMfTzq','DMfSAwrHDgvtzwXLy3rPB25szwzLCMvUy2u','zw5KtgLUzq','zMLSzunVDw50','yxbWBgLJyxrPB24VAMf2yxnJCMLWDa','C29YDa','twv0ywrHDgeGtuLnrsb0ExbLig11C3qGyMuGysbZDhjPBMC','mtuWnta1A3fxEvjL','DMfSAwrHDgvty29Wzq','z2vUzxjHDgvszwzLCMvUy2vjza','C3rHCNrdB2X1Bw4','BwfYA0LUDMfSAwq','zw5JB2rPBMC','zgvWzw5Kzw5JAwvZ','yxbWBgLJyxrPB24VANnVBG','zMLSzvr5CgvZ','BgfZDefJy2vZC2vK','ChvYCg9Zzq','reLsrunut1jz','BgfZDeLUzgv4t2y','zxH0CMfJDezPBgvfEhrLBNnPB24','Cg9W','Aw52ywXPzfjLyxnVBG','Dg90ywXtAxPL','A2v5D29Yzhm','Dgv4Dc94lwPHDMeTC291CMnL','C3rHCNrmAw5L','yxbWBgLJyxrPB24VDhLWzxnJCMLWDa','yxbWBgLJyxrPB24VEc15yw1S','Bwf4','z2v0rgvMyxvSDeLJB24','AxnwywXPza','sw52ywXPzcbYzwzLCMvUy2uGDhLWztOG','nZe0mdi0nvHIENnsra','y3jLyxrLrgvMyxvSDe1LDgfKyxrH','y3bW','C3rYAw5N','y3jLyxrLrMLSzvjLzMvYzw5Jzq','odaZnJfnDhPXs1i','mtfvvM51C2O','y2fSy3vSyxrLuMvSzxzHBMnL','rMLSzsbLEgLZDhmGzMXHzYbTDxn0igjLigeGyM9VBgvHBG','y3nOyxjW','C3LUDgf4','DMfSAwrHDgvnzxrHzgf0yq','DMfSAwrHDgu','CMvKDwnL','uMvMzxjLBMnLihbHDgGGAxmGCMvXDwLYzwqGyw5Kig11C3qGyMuGysbZDhjPBMC','z2vUzxjHDgvtzwXLy3rPB25oyw1L','z2v0rgvZy3jPChrPB24','ig11C3qGyMuGyw4GyxjYyxK','mtnbseftze0','Dgv4Dc9WBgfPBG','zxHPC3rZ','ndGYmdqZnK9kA2TNwa','C3vIC3rY','zM9YrwfJAa','mJrJwvvkv0S','zM9YBwf0rM9YrgLZCgXHEq','Dg9ju09tDhjPBMC','DMfSAwrpBMX5','qwjZB2X1DguGCgf0AcbTDxn0igjLigeGC3rYAw5N','z2v0vgLTzq','zxH0CMfJDerPCMvJDg9YEu5HBwu','BNvTyMvY','zxjYB3jZ','u2vSzwn0Aw9UigzYB20G','qwnJzxnZignVDw50ig11C3qGyMuGysbUDw1Izxi','BwLTzvr5Cgu','CNvZDa','AMf2yxnJCMLWDa','Aw5JBhvKzxm','y3jLyxrLzef0','Bwv0ywrHDge','yM9VBgvHBG','ywjZB2X1DgvqyxrO','DMfSAwrHDgveAxjLy3rVCNLszwzLCMvUy2u','Dgv4Dc9ODg1S','BgfUz3vHz2u','y3jLyxrLu2vSzwn0Aw9UuMvMzxjLBMnL','C2vSzwn0zwruzxH0','C291CMnLrMLSzq','C29YDej5uMvSzxzHBMnL','Dg9tDhjPBMC','y2XHC3noyw1L','BgfZDe1VzgLMAwvK','twv0ywrHDgeGBgfUz3vHz2uGBxvZDcbIzsbHihn0CMLUzW','DhLWzq'];a0_0x56f3=function(){return _0x3cc464;};return a0_0x56f3();}export class ContextReferenceValidator{static[a0_0x4dff8e(0x14d)](_0x562c3d){const _0x1c789f=a0_0x4dff8e,_0x2c9c93=[],_0x413afa=[];(!_0x562c3d['id']||typeof _0x562c3d['id']!==_0x1c789f(0x144))&&_0x2c9c93[_0x1c789f(0x17a)]('Reference\x20ID\x20is\x20required\x20and\x20must\x20be\x20a\x20string');(!_0x562c3d[_0x1c789f(0x177)]||typeof _0x562c3d[_0x1c789f(0x177)]!==_0x1c789f(0x144))&&_0x2c9c93[_0x1c789f(0x17a)]('Reference\x20type\x20is\x20required\x20and\x20must\x20be\x20a\x20string');(!_0x562c3d[_0x1c789f(0xf6)]||typeof _0x562c3d[_0x1c789f(0xf6)]!==_0x1c789f(0x144))&&_0x2c9c93[_0x1c789f(0x17a)](_0x1c789f(0x14f));(!_0x562c3d['name']||typeof _0x562c3d[_0x1c789f(0x120)]!==_0x1c789f(0x144))&&_0x2c9c93[_0x1c789f(0x17a)]('Reference\x20name\x20is\x20required\x20and\x20must\x20be\x20a\x20string');_0x562c3d['type']&&!Object['values'](CONTEXT_REFERENCE_TYPES)['includes'](_0x562c3d[_0x1c789f(0x177)])&&_0x2c9c93['push'](_0x1c789f(0x140)+_0x562c3d['type']);_0x562c3d[_0x1c789f(0x10b)]&&typeof _0x562c3d['content']!=='string'&&_0x2c9c93['push']('Reference\x20content\x20must\x20be\x20a\x20string');_0x562c3d['content']&&_0x562c3d[_0x1c789f(0x10b)]['length']>0xf4240&&_0x413afa['push']('Reference\x20content\x20is\x20very\x20large\x20(>1MB)');if(_0x562c3d['metadata']){const _0x8a89cd=this[_0x1c789f(0x14c)](_0x562c3d[_0x1c789f(0x169)]);_0x2c9c93[_0x1c789f(0x17a)](..._0x8a89cd['errors']),_0x413afa['push'](..._0x8a89cd[_0x1c789f(0xfe)]);}if(_0x562c3d[_0x1c789f(0x10f)]){const _0x2cd667=this[_0x1c789f(0x128)](_0x562c3d[_0x1c789f(0x10f)]);_0x2c9c93[_0x1c789f(0x17a)](..._0x2cd667[_0x1c789f(0x161)]),_0x413afa[_0x1c789f(0x17a)](..._0x2cd667[_0x1c789f(0xfe)]);}_0x562c3d[_0x1c789f(0x102)]!==undefined&&typeof _0x562c3d['accessCount']!=='number'&&_0x2c9c93[_0x1c789f(0x17a)](_0x1c789f(0x163));const _0x52cd27=[_0x1c789f(0x168),_0x1c789f(0x130),'lastModified'];_0x52cd27['forEach'](_0x504dfe=>{const _0x53ef98=_0x1c789f;_0x562c3d[_0x504dfe]&&!this['isValidTimestamp'](_0x562c3d[_0x504dfe])&&_0x2c9c93[_0x53ef98(0x17a)]('Invalid\x20timestamp\x20for\x20'+_0x504dfe+':\x20'+_0x562c3d[_0x504dfe]);});switch(_0x562c3d['type']){case CONTEXT_REFERENCE_TYPES[_0x1c789f(0x185)]:const _0x135e4c=this['validateFileReference'](_0x562c3d);_0x2c9c93[_0x1c789f(0x17a)](..._0x135e4c['errors']),_0x413afa[_0x1c789f(0x17a)](..._0x135e4c['warnings']);break;case CONTEXT_REFERENCE_TYPES['SELECTION']:const _0x1cf67d=this[_0x1c789f(0x121)](_0x562c3d);_0x2c9c93[_0x1c789f(0x17a)](..._0x1cf67d[_0x1c789f(0x161)]),_0x413afa['push'](..._0x1cf67d['warnings']);break;case CONTEXT_REFERENCE_TYPES[_0x1c789f(0x132)]:const _0x836edc=this['validateDirectoryReference'](_0x562c3d);_0x2c9c93['push'](..._0x836edc['errors']),_0x413afa['push'](..._0x836edc['warnings']);break;}return{'isValid':_0x2c9c93['length']===0x0,'errors':_0x2c9c93,'warnings':_0x413afa};}static[a0_0x4dff8e(0x14c)](_0xeca215){const _0xd7ca20=a0_0x4dff8e,_0x515bed=[],_0x437229=[];return _0xeca215[_0xd7ca20(0x117)]!==undefined&&(typeof _0xeca215['size']!=='number'||_0xeca215['size']<0x0)&&_0x515bed['push'](_0xd7ca20(0x17e)),_0xeca215['language']&&typeof _0xeca215['language']!==_0xd7ca20(0x144)&&_0x515bed['push'](_0xd7ca20(0x176)),_0xeca215['encoding']&&typeof _0xeca215[_0xd7ca20(0x12c)]!=='string'&&_0x515bed['push']('Metadata\x20encoding\x20must\x20be\x20a\x20string'),_0xeca215['keywords']&&!Array['isArray'](_0xeca215[_0xd7ca20(0x138)])&&_0x515bed[_0xd7ca20(0x17a)]('Metadata\x20keywords\x20must\x20be\x20an\x20array'),_0xeca215['mimeType']&&typeof _0xeca215[_0xd7ca20(0x164)]!==_0xd7ca20(0x144)&&_0x515bed[_0xd7ca20(0x17a)](_0xd7ca20(0x126)),{'errors':_0x515bed,'warnings':_0x437229};}static[a0_0x4dff8e(0x128)](_0x3b773f){const _0x41ed5d=a0_0x4dff8e,_0x166721=[],_0x491c09=[],_0x37e974=['startLine','endLine',_0x41ed5d(0x12a),'endColumn','maxDepth'];_0x37e974['forEach'](_0x4b83cb=>{const _0x874881=_0x41ed5d;_0x3b773f[_0x4b83cb]!==undefined&&(typeof _0x3b773f[_0x4b83cb]!==_0x874881(0x160)||_0x3b773f[_0x4b83cb]<0x0)&&_0x166721['push'](_0x874881(0xff)+_0x4b83cb+_0x874881(0x182));});_0x3b773f[_0x41ed5d(0x13a)]!==undefined&&_0x3b773f['endLine']!==undefined&&(_0x3b773f['startLine']>_0x3b773f['endLine']&&_0x166721['push']('Start\x20line\x20must\x20be\x20<=\x20end\x20line'));_0x3b773f['startColumn']!==undefined&&_0x3b773f['endColumn']!==undefined&&(_0x3b773f['startColumn']>_0x3b773f[_0x41ed5d(0x111)]&&_0x166721['push']('Start\x20column\x20must\x20be\x20<=\x20end\x20column'));const _0x2967db=['includePaths',_0x41ed5d(0x17f)];return _0x2967db[_0x41ed5d(0x158)](_0x2eda12=>{const _0x257b9d=_0x41ed5d;_0x3b773f[_0x2eda12]&&!Array[_0x257b9d(0x105)](_0x3b773f[_0x2eda12])&&_0x166721['push'](_0x257b9d(0xff)+_0x2eda12+_0x257b9d(0x152));}),{'errors':_0x166721,'warnings':_0x491c09};}static['validateFileReference'](_0xc76d99){const _0x47b3b6=a0_0x4dff8e,_0x372c8c=[],_0x3f5b82=[];return _0xc76d99[_0x47b3b6(0x16b)]&&typeof _0xc76d99[_0x47b3b6(0x16b)]!=='string'&&_0x372c8c['push'](_0x47b3b6(0x15d)),_0xc76d99['relativePath']&&typeof _0xc76d99['relativePath']!==_0x47b3b6(0x144)&&_0x372c8c[_0x47b3b6(0x17a)]('Relative\x20path\x20must\x20be\x20a\x20string'),_0xc76d99['extension']&&typeof _0xc76d99['extension']!=='string'&&_0x372c8c['push']('File\x20extension\x20must\x20be\x20a\x20string'),_0xc76d99[_0x47b3b6(0x155)]!==undefined&&typeof _0xc76d99['exists']!==_0x47b3b6(0x16a)&&_0x372c8c[_0x47b3b6(0x17a)](_0x47b3b6(0x149)),{'errors':_0x372c8c,'warnings':_0x3f5b82};}static[a0_0x4dff8e(0x121)](_0xd91fbb){const _0x432771=a0_0x4dff8e,_0x10c296=[],_0x26552f=[];return(!_0xd91fbb['scope']||!_0xd91fbb[_0x432771(0x10f)]['startLine']&&!_0xd91fbb[_0x432771(0x10f)][_0x432771(0x122)])&&_0x26552f[_0x432771(0x17a)]('Selection\x20reference\x20should\x20have\x20line\x20scope\x20defined'),_0xd91fbb[_0x432771(0x170)]&&typeof _0xd91fbb[_0x432771(0x170)]!=='string'&&_0x10c296[_0x432771(0x17a)](_0x432771(0x101)),_0xd91fbb[_0x432771(0x171)]&&typeof _0xd91fbb[_0x432771(0x171)]!=='string'&&_0x10c296['push'](_0x432771(0x109)),{'errors':_0x10c296,'warnings':_0x26552f};}static[a0_0x4dff8e(0x16c)](_0x3bf879){const _0x3ae068=a0_0x4dff8e,_0xae6ad9=[],_0x2ca55e=[];return _0x3bf879['fileCount']!==undefined&&(typeof _0x3bf879[_0x3ae068(0x123)]!==_0x3ae068(0x160)||_0x3bf879['fileCount']<0x0)&&_0xae6ad9['push']('File\x20count\x20must\x20be\x20a\x20non-negative\x20number'),_0x3bf879['totalSize']!==undefined&&(typeof _0x3bf879[_0x3ae068(0x137)]!==_0x3ae068(0x160)||_0x3bf879[_0x3ae068(0x137)]<0x0)&&_0xae6ad9['push']('Total\x20size\x20must\x20be\x20a\x20non-negative\x20number'),_0x3bf879['fileTypes']&&!Array[_0x3ae068(0x105)](_0x3bf879[_0x3ae068(0x12f)])&&_0xae6ad9['push']('File\x20types\x20must\x20be\x20an\x20array'),{'errors':_0xae6ad9,'warnings':_0x2ca55e};}static['isValidTimestamp'](_0x2fdb68){const _0x4762ce=a0_0x4dff8e;if(typeof _0x2fdb68!=='string')return![];const _0x56096a=new Date(_0x2fdb68);return _0x56096a instanceof Date&&!isNaN(_0x56096a[_0x4762ce(0x15e)]());}}export class ContextReferenceFactory{static['create'](_0x4e4987,_0x48edb4,_0x215017,_0x428331={}){const _0x440151=a0_0x4dff8e,_0x4c9784=new Date()[_0x440151(0x15b)](),_0xde4c0a=this['generateReferenceId']();return{'id':_0xde4c0a,'type':_0x4e4987,'path':_0x48edb4,'name':_0x215017,'content':_0x428331[_0x440151(0x10b)]||null,'metadata':this['createDefaultMetadata'](_0x4e4987,_0x48edb4,_0x428331[_0x440151(0x169)]),'scope':_0x428331[_0x440151(0x10f)]||{},'createdAt':_0x4c9784,'lastAccessed':null,'lastModified':_0x428331[_0x440151(0x175)]||null,'isValid':!![],'invalidReason':null,'accessCount':0x0,'tags':_0x428331['tags']||{}};}static[a0_0x4dff8e(0x145)](_0x2918f0,_0x36a5f2,_0x96c330={}){const _0x4e8cb7=a0_0x4dff8e,_0x6a838c=_0x96c330[_0x4e8cb7(0x120)]||this['extractFileName'](_0x2918f0),_0x517f14=this['extractFileExtension'](_0x2918f0),_0x5c4e3a=this[_0x4e8cb7(0x11f)](CONTEXT_REFERENCE_TYPES['FILE'],_0x36a5f2,_0x6a838c,_0x96c330);return{..._0x5c4e3a,'absolutePath':_0x2918f0,'relativePath':_0x36a5f2,'extension':_0x517f14,'exists':_0x96c330['exists']!==undefined?_0x96c330[_0x4e8cb7(0x155)]:!![],'stats':_0x96c330[_0x4e8cb7(0x10a)]||null,'gitStatus':_0x96c330['gitStatus']||null,'dependencies':_0x96c330[_0x4e8cb7(0x12d)]||null};}static[a0_0x4dff8e(0x16f)](_0x9ee6e3,_0x44f30d,_0x554445,_0x1adeeb={}){const _0x3aeace=a0_0x4dff8e,_0x4fb3b8=_0x1adeeb['name']||this['generateSelectionName'](_0x9ee6e3,_0x554445),_0x42e706=this['create'](CONTEXT_REFERENCE_TYPES[_0x3aeace(0x10e)],_0x9ee6e3,_0x4fb3b8,{..._0x1adeeb,'scope':_0x554445,'content':_0x44f30d});return{..._0x42e706,'sourceFile':_0x9ee6e3,'selectedText':_0x44f30d,'syntax':_0x1adeeb[_0x3aeace(0x14b)]||null,'context':_0x1adeeb['context']||null,'purpose':_0x1adeeb[_0x3aeace(0x131)]||null};}static['createDirectoryReference'](_0x3676b6,_0x164e6c,_0x54c409={}){const _0x2d2140=a0_0x4dff8e,_0x17ee6f=_0x54c409[_0x2d2140(0x120)]||this[_0x2d2140(0x15f)](_0x3676b6),_0x58f3b5=this[_0x2d2140(0x11f)](CONTEXT_REFERENCE_TYPES['DIRECTORY'],_0x164e6c,_0x17ee6f,_0x54c409);return{..._0x58f3b5,'absolutePath':_0x3676b6,'relativePath':_0x164e6c,'tree':_0x54c409['tree']||null,'fileCount':_0x54c409['fileCount']||null,'totalSize':_0x54c409[_0x2d2140(0x137)]||null,'fileTypes':_0x54c409[_0x2d2140(0x12f)]||null};}static['createComponentReference'](_0x4294ea,_0x17efbc,_0x16d36f,_0x3f1fa3={}){const _0x1c115c=a0_0x4dff8e,_0x1653f0=this['create'](CONTEXT_REFERENCE_TYPES[_0x1c115c(0x181)],_0x17efbc,_0x16d36f,_0x3f1fa3);return{..._0x1653f0,'componentType':_0x4294ea,'sourceFile':_0x3f1fa3[_0x1c115c(0x171)]||null,'properties':_0x3f1fa3[_0x1c115c(0xf5)]||null,'dependencies':_0x3f1fa3[_0x1c115c(0x12d)]||null,'documentation':_0x3f1fa3[_0x1c115c(0xf7)]||null};}static[a0_0x4dff8e(0x142)](_0xad236d,_0x5e8068,_0x2f3b2c={}){const _0x2643e2=a0_0x4dff8e,_0x49f17a={'language':null,'encoding':_0x2643e2(0xfb),'size':null,'mimeType':null,'checksum':null,'keywords':[],'description':'','customFields':{},'icon':this[_0x2643e2(0x13e)](_0xad236d,_0x5e8068),'permissions':{},..._0x2f3b2c};if(_0xad236d===CONTEXT_REFERENCE_TYPES[_0x2643e2(0x185)]){const _0x47d3d0=this['extractFileExtension'](_0x5e8068);_0x49f17a[_0x2643e2(0x16e)]=this[_0x2643e2(0x118)](_0x47d3d0),_0x49f17a['mimeType']=this[_0x2643e2(0x112)](_0x47d3d0);}return _0x49f17a;}static[a0_0x4dff8e(0x129)](){const _0x4ad66f=a0_0x4dff8e,_0x497a3d=Date['now']()['toString'](0x24),_0x17d81f=Math[_0x4ad66f(0x10d)]()[_0x4ad66f(0x173)](0x24)[_0x4ad66f(0x157)](0x2,0x9);return _0x4ad66f(0x110)+_0x497a3d+'_'+_0x17d81f;}static['extractFileName'](_0x165bde){const _0x1b053f=a0_0x4dff8e;return _0x165bde['split'](/[/\\]/)[_0x1b053f(0x135)]()||_0x165bde;}static[a0_0x4dff8e(0x15f)](_0x12d1a4){const _0x1c8690=a0_0x4dff8e,_0x26d7d0=_0x12d1a4['split'](/[/\\]/)['filter'](Boolean);return _0x26d7d0[_0x26d7d0[_0x1c8690(0x106)]-0x1]||'Root';}static[a0_0x4dff8e(0x134)](_0x43144c){const _0x593add=a0_0x4dff8e,_0x20135e=this['extractFileName'](_0x43144c),_0x1c5d21=_0x20135e[_0x593add(0x133)]('.');return _0x1c5d21!==-0x1?_0x20135e['substring'](_0x1c5d21):'';}static[a0_0x4dff8e(0x150)](_0x16a1ca,_0x454cf1){const _0x7651ef=a0_0x4dff8e,_0x3a8539=this[_0x7651ef(0x11d)](_0x16a1ca);if(_0x454cf1[_0x7651ef(0x13a)]&&_0x454cf1[_0x7651ef(0x122)])return _0x454cf1[_0x7651ef(0x13a)]===_0x454cf1['endLine']?_0x3a8539+':'+_0x454cf1['startLine']:_0x3a8539+':'+_0x454cf1['startLine']+'-'+_0x454cf1['endLine'];if(_0x454cf1[_0x7651ef(0xfc)])return _0x3a8539+':'+_0x454cf1[_0x7651ef(0xfc)]+'()';if(_0x454cf1[_0x7651ef(0x174)])return _0x3a8539+':'+_0x454cf1[_0x7651ef(0x174)];return _0x3a8539+_0x7651ef(0x119);}static[a0_0x4dff8e(0x13e)](_0x4d0bbf,_0x28540b){const _0x94223=a0_0x4dff8e;if(_0x4d0bbf===CONTEXT_REFERENCE_TYPES['FILE']){const _0x3cb83a=this[_0x94223(0x134)](_0x28540b);return FILE_ICONS[_0x3cb83a]||CONTEXT_ICONS['DEFAULT'];}return CONTEXT_ICONS[_0x4d0bbf]||CONTEXT_ICONS['DEFAULT'];}static[a0_0x4dff8e(0x118)](_0x556c39){const _0x2e927a=a0_0x4dff8e,_0x490509={'.js':'javascript','.jsx':_0x2e927a(0x166),'.ts':_0x2e927a(0xfd),'.tsx':'typescript','.py':'python','.java':_0x2e927a(0xf4),'.cpp':_0x2e927a(0x143),'.c':'c','.cs':_0x2e927a(0x14a),'.php':_0x2e927a(0x116),'.rb':_0x2e927a(0x178),'.go':'go','.rs':_0x2e927a(0x165),'.html':'html','.css':'css','.scss':_0x2e927a(0x17b),'.json':'json','.yml':'yaml','.yaml':'yaml','.xml':'xml','.sql':'sql','.md':'markdown'};return _0x490509[_0x556c39[_0x2e927a(0x104)]()]||null;}static['getMimeTypeFromExtension'](_0x41bcc7){const _0x1d676c=a0_0x4dff8e,_0x42e469={'.js':_0x1d676c(0x124),'.jsx':'application/javascript','.ts':'application/typescript','.tsx':_0x1d676c(0x13b),'.py':'text/x-python','.java':_0x1d676c(0x139),'.cpp':'text/x-c++src','.c':'text/x-csrc','.cs':_0x1d676c(0x11c),'.php':'application/x-php','.rb':'application/x-ruby','.go':'text/x-go','.rs':'text/x-rust','.html':_0x1d676c(0x16d),'.css':_0x1d676c(0xfa),'.scss':'text/x-scss','.json':_0x1d676c(0x12e),'.yml':_0x1d676c(0x13c),'.yaml':'application/x-yaml','.xml':_0x1d676c(0xf9),'.sql':_0x1d676c(0x180),'.md':_0x1d676c(0x113),'.txt':'text/plain'};return _0x42e469[_0x41bcc7[_0x1d676c(0x104)]()]||_0x1d676c(0x154);}}export class ContextReferenceUtils{static[a0_0x4dff8e(0x13f)](_0x18d431){const _0x49d4d9=a0_0x4dff8e;return _0x18d431[_0x49d4d9(0x13f)]&&!_0x18d431[_0x49d4d9(0x136)];}static[a0_0x4dff8e(0x115)](_0x426657){const _0x5549d4=a0_0x4dff8e;return{..._0x426657,'lastAccessed':new Date()[_0x5549d4(0x15b)](),'accessCount':_0x426657['accessCount']+0x1};}static[a0_0x4dff8e(0x12b)](_0x119a7a,_0x51e28e){return{..._0x119a7a,'isValid':![],'invalidReason':_0x51e28e};}static[a0_0x4dff8e(0x103)](_0x24d550){const _0x4bc27d=a0_0x4dff8e;if(_0x24d550['type']===CONTEXT_REFERENCE_TYPES['SELECTION']&&_0x24d550['scope'])return ContextReferenceFactory['generateSelectionName'](_0x24d550[_0x4bc27d(0xf6)],_0x24d550['scope']);return _0x24d550[_0x4bc27d(0x120)];}static[a0_0x4dff8e(0x151)](_0x422db0){const _0x41ca83=a0_0x4dff8e;if(_0x422db0[_0x41ca83(0x169)]?.['description'])return _0x422db0[_0x41ca83(0x169)]['description'];switch(_0x422db0[_0x41ca83(0x177)]){case CONTEXT_REFERENCE_TYPES[_0x41ca83(0x185)]:return'File:\x20'+_0x422db0[_0x41ca83(0xf6)];case CONTEXT_REFERENCE_TYPES['DIRECTORY']:return'Directory:\x20'+_0x422db0['path'];case CONTEXT_REFERENCE_TYPES['SELECTION']:return _0x41ca83(0x162)+_0x422db0[_0x41ca83(0xf6)];case CONTEXT_REFERENCE_TYPES[_0x41ca83(0x181)]:return'Component:\x20'+_0x422db0[_0x41ca83(0x120)];default:return _0x422db0[_0x41ca83(0xf6)];}}static[a0_0x4dff8e(0x148)](_0x57ed5f,_0x45cd4c={}){const _0x61e903=a0_0x4dff8e;let _0xd0a2cf=0.5;if(_0x57ed5f['lastAccessed']){const _0x39c1e6=(Date['now']()-new Date(_0x57ed5f['lastAccessed']))/(0x3e8*0x3c*0x3c*0x18);_0xd0a2cf+=Math[_0x61e903(0x13d)](0x0,0.2*(0x1-_0x39c1e6/0x1e));}_0x57ed5f['accessCount']>0x0&&(_0xd0a2cf+=Math[_0x61e903(0x100)](0.2,_0x57ed5f['accessCount']*0.01));switch(_0x57ed5f['type']){case CONTEXT_REFERENCE_TYPES['FILE']:_0x45cd4c['fileTypes']&&_0x57ed5f['metadata']?.['language']&&(_0x45cd4c[_0x61e903(0x12f)]['includes'](_0x57ed5f['metadata'][_0x61e903(0x16e)])&&(_0xd0a2cf+=0.2));break;case CONTEXT_REFERENCE_TYPES[_0x61e903(0x10e)]:_0xd0a2cf+=0.1;break;}if(_0x45cd4c[_0x61e903(0x138)]&&_0x57ed5f[_0x61e903(0x169)]?.['keywords']){const _0x239b81=_0x45cd4c['keywords'][_0x61e903(0x108)](_0x459f3e=>_0x57ed5f[_0x61e903(0x169)]['keywords']['includes'](_0x459f3e))[_0x61e903(0x106)];_0xd0a2cf+=Math['min'](0.3,_0x239b81*0.1);}return!_0x57ed5f['isValid']&&(_0xd0a2cf*=0.1),Math[_0x61e903(0x100)](0x1,Math['max'](0x0,_0xd0a2cf));}static['groupByType'](_0x1e67d2){const _0x2b9153=a0_0x4dff8e;return _0x1e67d2[_0x2b9153(0x14e)]((_0x426c67,_0x324f21)=>{const _0x4947dc=_0x2b9153,_0x382014=_0x324f21['type'];return!_0x426c67[_0x382014]&&(_0x426c67[_0x382014]=[]),_0x426c67[_0x382014][_0x4947dc(0x17a)](_0x324f21),_0x426c67;},{});}static[a0_0x4dff8e(0x172)](_0x23d909,_0x53e631={}){const _0x1ba231=a0_0x4dff8e;return[..._0x23d909][_0x1ba231(0x125)]((_0x34e2b5,_0x29e9c9)=>{const _0x61bd84=_0x1ba231,_0x5b89ff=this[_0x61bd84(0x148)](_0x34e2b5,_0x53e631),_0x496ed6=this['calculateRelevance'](_0x29e9c9,_0x53e631);return _0x496ed6-_0x5b89ff;});}static['filter'](_0x22fb4f,_0x1ff44b={}){return _0x22fb4f['filter'](_0x20725a=>{const _0x1883f3=a0_0x465e;if(_0x1ff44b['types']&&!_0x1ff44b[_0x1883f3(0x17c)][_0x1883f3(0x167)](_0x20725a['type']))return![];if(_0x1ff44b[_0x1883f3(0x15c)]&&!_0x20725a['isValid'])return![];if(_0x1ff44b['languages']&&_0x20725a['metadata']?.['language']){if(!_0x1ff44b['languages'][_0x1883f3(0x167)](_0x20725a['metadata']['language']))return![];}if(_0x1ff44b[_0x1883f3(0xf8)]){const _0x2fad33=new RegExp(_0x1ff44b[_0x1883f3(0xf8)],'i');if(!_0x2fad33[_0x1883f3(0x114)](_0x20725a[_0x1883f3(0xf6)]))return![];}if(_0x1ff44b[_0x1883f3(0x138)]&&_0x20725a[_0x1883f3(0x169)]?.[_0x1883f3(0x138)]){const _0x53b4f1=_0x1ff44b['keywords'][_0x1883f3(0x17d)](_0x39a4f4=>_0x20725a['metadata'][_0x1883f3(0x138)][_0x1883f3(0x167)](_0x39a4f4));if(!_0x53b4f1)return![];}if(_0x1ff44b[_0x1883f3(0x11a)]){if(new Date(_0x20725a['createdAt'])<new Date(_0x1ff44b[_0x1883f3(0x11a)]))return![];}if(_0x1ff44b['createdBefore']){if(new Date(_0x20725a['createdAt'])>new Date(_0x1ff44b['createdBefore']))return![];}return!![];});}static[a0_0x4dff8e(0x15a)](_0x277ab9){const _0x802c0b=a0_0x4dff8e;return{'id':_0x277ab9['id'],'type':_0x277ab9[_0x802c0b(0x177)],'name':this[_0x802c0b(0x103)](_0x277ab9),'description':this[_0x802c0b(0x151)](_0x277ab9),'path':_0x277ab9['path'],'icon':_0x277ab9[_0x802c0b(0x169)]?.['icon']||CONTEXT_ICONS[_0x277ab9['type']]||CONTEXT_ICONS[_0x802c0b(0x179)],'isValid':_0x277ab9['isValid'],'lastAccessed':_0x277ab9[_0x802c0b(0x130)],'accessCount':_0x277ab9[_0x802c0b(0x102)],'size':_0x277ab9['metadata']?.['size']||null,'language':_0x277ab9['metadata']?.[_0x802c0b(0x16e)]||null};}}export default{'ContextReferenceValidator':ContextReferenceValidator,'ContextReferenceFactory':ContextReferenceFactory,'ContextReferenceUtils':ContextReferenceUtils};