sxn 0.2.0

data/sig/sxn/rules.rbs

@@ -0,0 +1,287 @@
+module Sxn
+  module Rules
+    # Abstract base class for all sxn rules with state machine and validation
+    class BaseRule
+      # Rule state constants
+      CREATED: String
+      VALIDATED: String
+      APPLYING: String
+      APPLIED: String
+      FAILED: String
+      SKIPPED: String
+
+      # Valid state transitions
+      VALID_TRANSITIONS: Hash[String, Array[String]]
+
+      type rule_config = Hash[String, untyped]
+      type change_record = Hash[Symbol, untyped]
+      type error_array = Array[StandardError]
+      type dependencies_array = Array[BaseRule]
+      type metadata_hash = Hash[Symbol, untyped]
+
+      attr_reader name: String
+      attr_reader state: String
+      attr_reader errors: error_array
+      attr_reader changes: Array[change_record]
+      attr_reader dependencies: dependencies_array
+      attr_reader metadata: metadata_hash
+      attr_reader created_at: Time
+      attr_reader updated_at: Time
+      attr_reader config: rule_config
+      attr_reader session_path: String
+      attr_reader project_path: String
+
+      def initialize: (String?, ?rule_config?, String?, String?, ?dependencies: dependencies_array) -> void
+
+      # State management methods
+      def state?: (String query_state) -> bool
+      def can_transition_to?: (String new_state) -> bool
+      def created?: () -> bool
+      def validated?: () -> bool
+      def applying?: () -> bool
+      def applied?: () -> bool
+      def failed?: () -> bool
+      def skipped?: () -> bool
+
+      # Public interface methods (abstract)
+      def validate: () -> void
+      def apply: () -> bool
+      def rollback: () -> void
+      def check: () -> bool
+      def preview: () -> Hash[Symbol, untyped]
+      def enabled?: () -> bool
+      def skip_if?: () -> bool
+
+      # Utility methods
+      def reset!: () -> void
+      def skip!: (?String reason) -> void
+      def to_h: () -> Hash[Symbol, untyped]
+      def summary: () -> Hash[Symbol, untyped]
+      def has_changes?: () -> bool
+      def error_messages: () -> Array[String]
+      def execution_duration: () -> Float?
+
+      def change_state!: (String new_state) -> void
+      def track_change: (Symbol action, String target, ?change_record details) -> void
+      def log: (Symbol level, String message, ?Hash[Symbol, untyped] context) -> void
+      def validate_rule_specific!: () -> void
+      def validate_paths!: () -> void
+      def validate_required_config!: (Array[String] required_keys) -> void
+
+      def initialize_with_legacy_args: (String? arg1, rule_config? arg2, String? arg3, String? arg4, dependencies: dependencies_array) -> void
+      def safe_pathname: (String? path) -> Pathname?
+      def validate_common_requirements!: () -> void
+      def record_execution_time: () -> void
+    end
+    
+    # CopyFilesRule handles secure file copying operations
+    class CopyFilesRule < BaseRule
+      type file_config = Hash[String, untyped]
+      type permission_mode = Integer
+      type copy_operation_result = Hash[Symbol, untyped]
+
+      def initialize: (String?, ?Hash[String, untyped]?, String?, String?, ?dependencies: Array[BaseRule]) -> void
+      def validate: () -> void
+      def apply: () -> bool
+      def validate_rule_specific!: () -> void
+      def validate_file_config!: (file_config config, Integer index) -> void
+      def apply_file_operation: (file_config file_config, Integer index) -> copy_operation_result
+      def create_destination_directory: (String destination_path) -> void
+      def determine_file_permissions: (String source_path, file_config config) -> permission_mode
+      def copy_file_securely: (String source_path, String destination_path, permission_mode permissions, file_config config) -> copy_operation_result
+      def detect_sensitive_file?: (String file_path) -> bool
+      def backup_existing_file: (String file_path) -> String?
+      def validate_file_operation: (String source, String destination) -> void
+    end
+    
+    # SetupCommandsRule executes shell commands during session setup with security controls
+    class SetupCommandsRule < BaseRule
+      type command_config = Hash[String, untyped]
+      type command_result = Hash[Symbol, untyped]
+      type environment_vars = Hash[String, String]
+
+      attr_reader command_executor: Sxn::Security::SecureCommandExecutor
+
+      def initialize: (String?, ?Hash[String, untyped]?, String?, String?, ?dependencies: Array[BaseRule]) -> void
+      def validate: () -> void
+      def apply: () -> bool
+      def preview: () -> Hash[Symbol, untyped]
+      def rollback: () -> void
+      def validate_rule_specific!: () -> void
+      def validate_command_config!: (command_config config, Integer index) -> void
+      def execute_command: (command_config config, Integer index) -> command_result
+      def build_command_array: (String | Array[String] command) -> Array[String]
+      def build_environment: (environment_vars? env_config) -> environment_vars
+      def should_ignore_failure?: (command_config config, command_result result) -> bool
+      def validate_command_security: (Array[String] command) -> void
+      def extract_command_info: (command_config config) -> Hash[Symbol, untyped]
+    end
+    
+    # TemplateRule processes and applies template files using the secure template processor
+    class TemplateRule < BaseRule
+      type template_config = Hash[String, untyped]
+      type template_variables = Hash[Symbol, untyped]
+
+      attr_reader template_processor: Sxn::Templates::TemplateProcessor
+      attr_reader template_variables: Sxn::Templates::TemplateVariables
+
+      def initialize: (String?, ?Hash[String, untyped]?, String?, String?, ?dependencies: Array[BaseRule]) -> void
+      def validate: () -> void
+      def apply: () -> bool
+      def validate_rule_specific!: () -> void
+      def validate_template_config!: (template_config config, Integer index) -> void
+      def apply_template: (template_config config, Integer index) -> void
+      def build_template_variables: (template_config config) -> template_variables
+      def deep_merge: (Hash[untyped, untyped] hash1, Hash[untyped, untyped] hash2) -> Hash[untyped, untyped]
+      def extract_used_variables: (String template_content) -> Array[String]
+    end
+    
+    # RulesEngine orchestrates rule execution with dependency resolution and parallel processing
+    class RulesEngine
+      type rule_instance = BaseRule
+      type execution_result = Hash[Symbol, untyped]
+      type rule_config = Hash[String, untyped]
+      type execution_stats = Hash[Symbol, untyped]
+      type dependency_graph = Hash[rule_instance, Array[rule_instance]]
+
+      attr_reader rules: Array[rule_instance]
+      attr_reader session_path: String
+      attr_reader project_path: String
+      attr_reader config: rule_config
+      attr_reader execution_history: Array[execution_result]
+      attr_reader stats: execution_stats
+
+      def initialize: (String session_path, String project_path, ?rule_config config) -> void
+
+      # Rule management
+      def add_rule: (rule_instance rule) -> void
+      def remove_rule: (String name) -> bool
+      def find_rule: (String name) -> rule_instance?
+      def clear_rules: () -> void
+      def rule_count: () -> Integer
+      def enabled_rules: () -> Array[rule_instance]
+
+      # Rule creation factory methods
+      def create_copy_files_rule: (String name, rule_config config) -> CopyFilesRule
+      def create_setup_commands_rule: (String name, rule_config config) -> SetupCommandsRule
+      def create_template_rule: (String name, rule_config config) -> TemplateRule
+
+      # Execution methods
+      def execute_all: (?validate_first: bool, ?parallel: bool, ?continue_on_error: bool) -> execution_result
+      def execute_rule: (String name) -> execution_result
+      def validate_all: () -> execution_result
+      def validate_rule: (String name) -> execution_result
+      def preview_changes: () -> Hash[String, untyped]
+      def rollback_all: () -> execution_result
+      def rollback_rule: (String name) -> execution_result
+
+      # Dependency management
+      def resolve_dependencies: () -> Array[rule_instance]
+      def build_dependency_graph: () -> dependency_graph
+      def detect_circular_dependencies: () -> Array[Array[rule_instance]]?
+      def topological_sort: () -> Array[rule_instance]
+
+      # State and status methods
+      def all_valid?: () -> bool
+      def any_failed?: () -> bool
+      def execution_summary: () -> execution_stats
+      def failed_rules: () -> Array[rule_instance]
+      def successful_rules: () -> Array[rule_instance]
+      def reset_all!: () -> void
+
+      # Configuration and discovery
+      def load_rules_from_config: (String config_path) -> Integer
+      def auto_discover_rules: () -> Integer
+      def suggest_rules: () -> Array[Hash[Symbol, untyped]]
+      def save_rules_config: (String config_path) -> bool
+
+      # Utility methods
+      def to_h: () -> Hash[Symbol, untyped]
+      def rule_names: () -> Array[String]
+      def rule_types: () -> Array[String]
+      def filter_rules: (String type) -> Array[rule_instance]
+
+      def execute_rules_sequentially: (Array[rule_instance] rules, bool validate_first, bool continue_on_error) -> execution_result
+      def execute_rules_in_parallel: (Array[rule_instance] rules, bool validate_first, bool continue_on_error) -> execution_result
+      def execute_single_rule: (rule_instance rule, bool validate_first) -> execution_result
+      def handle_rule_error: (rule_instance rule, StandardError error) -> execution_result
+      def update_stats: (rule_instance rule, execution_result result) -> void
+      def create_rule_instance: (String type, String name, rule_config config) -> rule_instance
+      def validate_rule_config: (String type, rule_config config) -> void
+      def log_execution: (Symbol level, String message, ?Hash[Symbol, untyped] context) -> void
+      def detect_project_type: () -> String
+      def suggest_rails_rules: () -> Array[Hash[Symbol, untyped]]
+      def suggest_js_rules: () -> Array[Hash[Symbol, untyped]]
+      def suggest_generic_rules: () -> Array[Hash[Symbol, untyped]]
+      def find_template_files: () -> Array[String]
+      def find_config_files: () -> Array[String]
+    end
+    
+    # ProjectDetector analyzes directories to identify project types and configurations
+    class ProjectDetector
+      # Project type detection patterns
+      PROJECT_PATTERNS: Hash[String, Array[Hash[Symbol, untyped]]]
+
+      # Framework-specific detection
+      FRAMEWORK_PATTERNS: Hash[String, Hash[Symbol, untyped]]
+
+      # Language version detection
+      VERSION_PATTERNS: Hash[String, Array[Hash[Symbol, untyped]]]
+
+      type detection_result = Hash[Symbol, untyped]
+      type project_info = Hash[Symbol, untyped]
+
+      attr_reader path: Pathname
+      attr_reader cache: Hash[String, untyped]
+
+      def initialize: (String | Pathname path) -> void
+
+      def detect: () -> detection_result
+      def detect_project_type: () -> String
+      def detect_framework: () -> String?
+      def detect_language_version: () -> String?
+      def detect_build_tools: () -> Array[String]
+      def detect_dependencies: () -> Hash[String, Array[String]]
+      def confidence_score: () -> Float
+      def suggested_rules: () -> Array[String]
+
+      def self.detect_projects: (String | Pathname base_path, ?recursive: bool, ?max_depth: Integer) -> Array[project_info]
+      def self.quick_detect: (String | Pathname path) -> String
+
+      def analyze_file_patterns: () -> Hash[String, Integer]
+      def check_configuration_files: () -> Hash[String, untyped]
+      def analyze_package_managers: () -> Array[String]
+      def detect_rails_project: () -> Hash[Symbol, untyped]?
+      def detect_node_project: () -> Hash[Symbol, untyped]?
+      def detect_ruby_gem: () -> Hash[Symbol, untyped]?
+      def detect_python_project: () -> Hash[Symbol, untyped]?
+      def detect_go_project: () -> Hash[Symbol, untyped]?
+      def detect_rust_project: () -> Hash[Symbol, untyped]?
+      def parse_package_json: () -> Hash[String, untyped]?
+      def parse_gemspec: () -> Hash[String, untyped]?
+      def parse_cargo_toml: () -> Hash[String, untyped]?
+      def calculate_confidence: (Hash[String, Integer] scores) -> Float
+      def find_files: (String pattern, ?max_depth: Integer) -> Array[Pathname]
+      def file_exists?: (String relative_path) -> bool
+    end
+    
+    # Rules errors (base class only - specific errors defined in sig/sxn/rules/errors.rbs)
+    class RuleError < Sxn::Error
+    end
+    
+    class InvalidStateTransitionError < RuleError
+    end
+    
+    class ConfigurationError < RuleError
+    end
+    
+    class ExecutionTimeoutError < RuleError
+    end
+    
+    class RollbackNotSupportedError < RuleError
+    end
+    
+    class ExecutionCancelledError < RuleError
+    end
+  end
+end

data/sig/sxn/runtime_validations.rbs

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Sxn
+  # Runtime validation helpers for Thor commands and type safety
+  module RuntimeValidations
+    def self.validate_thor_arguments: (String command_name, Array[untyped] args, Hash[Symbol, untyped] options, Hash[Symbol, untyped] validations) -> true
+
+    def self.validate_and_coerce_type: (untyped value, Class target_type, ?String? context) -> untyped
+
+    def self.validate_template_variables: (Hash[Symbol, untyped] variables) -> Hash[Symbol, Hash[Symbol, untyped]]
+
+    private
+
+    def self.validate_option_type: (String command_name, Symbol key, untyped value, Symbol expected_type) -> void
+  end
+end

data/sig/sxn/security/secure_command_executor.rbs

@@ -0,0 +1,63 @@
+# TypeProf 0.21.3
+
+module Sxn
+  module Security
+    class SecureCommandExecutor
+      # Command execution result
+      class CommandResult
+        attr_reader exit_status: Integer
+        attr_reader stdout: String
+        attr_reader stderr: String
+        attr_reader command: Array[String]
+        attr_reader duration: Float
+
+        def initialize: (Integer exit_status, String? stdout, String? stderr, Array[String] command, Float duration) -> void
+
+        def success?: () -> bool
+
+        def failure?: () -> bool
+
+        def to_h: () -> Hash[Symbol, untyped]
+      end
+
+      # Whitelist of allowed commands with their expected paths
+      ALLOWED_COMMANDS: Hash[String, String | Array[String] | Symbol]
+
+      # Environment variables that are safe to preserve
+      SAFE_ENV_VARS: Array[String]
+
+      # Maximum command execution timeout (in seconds)
+      MAX_TIMEOUT: Integer
+
+      @project_root: String
+      @logger: untyped
+      @command_whitelist: Hash[String, String]
+
+      def initialize: (String project_root, ?logger: untyped) -> void
+
+      def execute: (Array[String] command, ?env: Hash[String | Symbol, String], ?timeout: Integer, ?chdir: String?) -> CommandResult
+
+      def command_allowed?: (Array[String] command) -> bool
+
+      def allowed_commands: () -> Array[String]
+
+      private
+
+      def validate_and_resolve_command: (Array[String] command) -> Array[String]
+
+      def build_command_whitelist: () -> Hash[String, String]
+
+      def resolve_rails_command: () -> String?
+
+      def resolve_project_executable: (String cmd_name) -> String?
+
+      def build_safe_environment: (Hash[String | Symbol, String] user_env) -> Hash[String, String]
+
+      def validate_work_directory: (String chdir) -> String
+
+      def execute_with_timeout: (Array[String] command, Hash[String, String] env, String chdir, Integer timeout) -> untyped
+
+      def audit_log: (String event, Array[String] command, String chdir, ?Hash[untyped, untyped] details) -> void
+    end
+  end
+end

data/sig/sxn/security/secure_file_copier.rbs

@@ -0,0 +1,79 @@
+# TypeProf 0.21.3
+
+module Sxn
+  module Security
+    class SecureFileCopier
+      # File operation result
+      class CopyResult
+        attr_reader source_path: String
+        attr_reader destination_path: String
+        attr_reader operation: Symbol
+        attr_reader encrypted: bool
+        attr_reader checksum: String?
+        attr_reader duration: Float
+
+        def initialize: (String source_path, String destination_path, Symbol operation, ?encrypted: bool, ?checksum: String?, ?duration: Float) -> void
+
+        def to_h: () -> Hash[Symbol, untyped]
+      end
+
+      # Patterns that identify sensitive files requiring special handling
+      SENSITIVE_FILE_PATTERNS: Array[Regexp]
+
+      # Default secure permissions for different file types
+      DEFAULT_PERMISSIONS: Hash[Symbol, Integer]
+
+      # Maximum file size for operations (100MB)
+      MAX_FILE_SIZE: Integer
+
+      @project_root: String
+      @path_validator: SecurePathValidator
+      @logger: untyped
+      @encryption_key: String?
+
+      def initialize: (String project_root, ?logger: untyped) -> void
+
+      def copy_file: (String source, String destination, ?permissions: Integer?, ?encrypt: bool, ?preserve_permissions: bool, ?create_directories: bool) -> CopyResult
+
+      def create_symlink: (String source, String destination, ?force: bool) -> CopyResult
+
+      def encrypt_file: (String file_path, ?key: String?) -> String
+
+      def decrypt_file: (String file_path, String key) -> bool
+
+      def sensitive_file?: (String file_path) -> bool
+
+      def secure_permissions?: (String file_path) -> bool
+
+      private
+
+      def normalize_path_for_result: (String path) -> String
+
+      def denormalize_path_for_operations: (String path) -> String
+
+      def validate_file_operation!: (String source_path, String destination_path) -> void
+
+      def determine_permissions: (String source_path, Integer? explicit_permissions, bool preserve_permissions) -> Integer
+
+      def create_destination_directory: (String destination_path) -> void
+
+      def copy_without_encryption: (String source_path, String destination_path, Integer permissions) -> void
+
+      def copy_with_encryption: (String source_path, String destination_path, Integer permissions) -> void
+
+      def encrypt_content: (String content, String key) -> String
+
+      def decrypt_content: (String encrypted_content, String key) -> String
+
+      def generate_encryption_key: () -> String
+
+      def generate_checksum: (String file_path) -> String?
+
+      def validate_file_exists!: (String file_path) -> void
+
+      def validate_file_readable!: (String file_path) -> void
+
+      def audit_log: (String event, untyped details) -> void
+    end
+  end
+end

data/sig/sxn/security/secure_path_validator.rbs

@@ -0,0 +1,30 @@
+# TypeProf 0.21.3
+
+module Sxn
+  module Security
+    class SecurePathValidator
+      @project_root: String
+      @project_root_pathname: Pathname
+
+      def initialize: (String project_root) -> void
+
+      def validate_path: (String path, ?allow_creation: bool) -> String
+
+      def validate_file_operation: (String source, String destination, ?allow_creation: bool) -> [String, String]
+
+      def within_boundaries?: (String path) -> bool
+
+      attr_reader project_root: String
+
+      private
+
+      def validate_path_components!: (String path) -> void
+
+      def validate_within_boundaries!: (String absolute_path) -> void
+
+      def validate_symlink_safety!: (String path) -> void
+
+      def normalize_path_manually: (String path) -> String
+    end
+  end
+end

data/sig/sxn/security.rbs

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+module Sxn
+  module Security
+    # SecureCommandExecutor provides secure command execution with strict controls
+    class SecureCommandExecutor
+      # Command execution result
+      class CommandResult
+        attr_reader exit_status: Integer
+        attr_reader stdout: String
+        attr_reader stderr: String
+        attr_reader command: Array[String]
+        attr_reader duration: Float
+
+        def initialize: (Integer exit_status, String? stdout, String? stderr, Array[String] command, Float duration) -> void
+        def success?: () -> bool
+        def failure?: () -> bool
+        def to_h: () -> Hash[Symbol, untyped]
+      end
+
+      attr_reader project_root: String
+      attr_reader logger: Logger?
+      attr_reader command_whitelist: Hash[String, String]
+
+      def initialize: (String project_root, ?logger: Logger?) -> void
+
+      def execute: (Array[String] command, ?env: Hash[String | Symbol, String], ?timeout: Integer, ?chdir: String?) -> CommandResult
+      def command_allowed?: (Array[String] command) -> bool
+      def allowed_commands: () -> Array[String]
+
+      def validate_and_resolve_command: (Array[String] command) -> Array[String]
+      def build_command_whitelist: () -> Hash[String, String]
+      def resolve_rails_command: () -> String?
+      def resolve_project_executable: (String cmd_name) -> String?
+      def build_safe_environment: (Hash[String | Symbol, String] user_env) -> Hash[String, String]
+      def validate_work_directory: (String chdir) -> String
+      def execute_with_timeout: (Array[String] command, Hash[String, String] env, String chdir, Integer timeout) -> OpenStruct
+      def audit_log: (String event, Array[String] command, String chdir, ?Hash[Symbol, untyped] details) -> void
+    end
+
+    # SecureFileCopier provides secure file copying operations with strict security controls
+    class SecureFileCopier
+      # File operation result
+      class CopyResult
+        attr_reader source_path: String
+        attr_reader destination_path: String
+        attr_reader operation: Symbol
+        attr_reader encrypted: bool
+        attr_reader checksum: String?
+        attr_reader duration: Float
+
+        def initialize: (String source_path, String destination_path, Symbol operation, ?encrypted: bool, ?checksum: String?, ?duration: Float) -> void
+        def to_h: () -> Hash[Symbol, untyped]
+      end
+
+      attr_reader project_root: String
+      attr_reader path_validator: SecurePathValidator
+      attr_reader logger: Logger?
+      attr_reader encryption_key: String?
+
+      def initialize: (String project_root, ?logger: Logger?) -> void
+
+      def copy_file: (String source, String destination, ?permissions: Integer?, ?encrypt: bool, ?preserve_permissions: bool, ?create_directories: bool) -> CopyResult
+      def create_symlink: (String source, String destination, ?force: bool) -> CopyResult
+      def encrypt_file: (String file_path, ?key: String?) -> String
+      def decrypt_file: (String file_path, String key) -> bool
+      def sensitive_file?: (String file_path) -> bool
+      def secure_permissions?: (String file_path) -> bool
+
+      def normalize_path_for_result: (String path) -> String
+      def denormalize_path_for_operations: (String path) -> String
+      def validate_file_operation!: (String source_path, String destination_path) -> void
+      def determine_permissions: (String source_path, Integer? explicit_permissions, bool preserve_permissions) -> Integer
+      def create_destination_directory: (String destination_path) -> void
+      def copy_without_encryption: (String source_path, String destination_path, Integer permissions) -> void
+      def copy_with_encryption: (String source_path, String destination_path, Integer permissions) -> void
+      def encrypt_content: (String content, String key) -> String
+      def decrypt_content: (String encrypted_content, String key) -> String
+      def generate_encryption_key: () -> String
+      def generate_checksum: (String file_path) -> String?
+      def validate_file_exists!: (String file_path) -> void
+      def validate_file_readable!: (String file_path) -> void
+      def audit_log: (String event, CopyResult | Hash[Symbol, untyped] details) -> void
+    end
+
+    # SecurePathValidator provides security controls for file system path operations
+    class SecurePathValidator
+      attr_reader project_root: String
+      attr_reader project_root_pathname: Pathname
+
+      def initialize: (String project_root) -> void
+
+      def validate_path: (String path, ?allow_creation: bool) -> String
+      def validate_file_operation: (String source, String destination, ?allow_creation: bool) -> [String, String]
+      def within_boundaries?: (String path) -> bool
+
+      def validate_path_components!: (String path) -> void
+      def validate_within_boundaries!: (String absolute_path) -> void
+      def validate_symlink_safety!: (String path) -> void
+      def normalize_path_manually: (String path) -> String
+    end
+
+    # Security error classes
+    class Error < Sxn::Error
+    end
+
+    class PathValidationError < Error
+    end
+
+    class CommandExecutionError < Error
+    end
+
+    class SecurityError < Error
+    end
+
+    class PathTraversalError < Error
+    end
+
+    class CommandInjectionError < Error
+    end
+
+    class FileSecurityError < Error
+    end
+
+    class ValidationError < Error
+    end
+  end
+end

data/sig/sxn/templates/errors.rbs

@@ -0,0 +1,43 @@
+# TypeProf 0.21.3
+
+module Sxn
+  module Templates
+    module Errors
+      # Base class for template-related errors
+      class TemplateError < Sxn::Error
+      end
+
+      # Raised when template syntax is invalid
+      class TemplateSyntaxError < TemplateError
+      end
+
+      # Raised when template processing fails
+      class TemplateProcessingError < TemplateError
+      end
+
+      # Raised when template file is not found
+      class TemplateNotFoundError < TemplateError
+      end
+
+      # Raised when template exceeds size limits
+      class TemplateTooLargeError < TemplateError
+      end
+
+      # Raised when template processing times out
+      class TemplateTimeoutError < TemplateError
+      end
+
+      # Raised when template contains security violations
+      class TemplateSecurityError < TemplateError
+      end
+
+      # Raised when template rendering encounters errors
+      class TemplateRenderError < TemplateError
+      end
+
+      # Raised when template variable collection fails
+      class TemplateVariableError < TemplateError
+      end
+    end
+  end
+end