sxn 0.2.0

data/sig/sxn/templates/template_engine.rbs

@@ -0,0 +1,50 @@
+# TypeProf 0.21.3
+
+module Sxn
+  module Templates
+    class TemplateEngine
+      # Built-in template directory
+      TEMPLATES_DIR: String
+
+      @session: untyped
+      @project: untyped
+      @config: untyped
+      @processor: TemplateProcessor
+      @variables_collector: TemplateVariables
+      @security: TemplateSecurity
+      @template_cache: Hash[untyped, untyped]
+
+      def initialize: (?session: untyped, ?project: untyped, ?config: untyped) -> void
+
+      def process_template: (String template_name, String destination_path, ?Hash[untyped, untyped] custom_variables, ?Hash[Symbol, untyped] options) -> String
+
+      def list_templates: (?String? category) -> Array[String]
+
+      def template_categories: () -> Array[String]
+
+      def template_exists?: (String template_name, ?String? template_dir) -> bool
+
+      def template_info: (String template_name, ?String? template_dir) -> Hash[Symbol, untyped]
+
+      def validate_template_syntax: (String template_name, ?String? template_dir) -> bool
+
+      def available_variables: (?Hash[untyped, untyped] custom_variables) -> Hash[untyped, untyped]
+
+      def refresh_variables!: () -> Hash[untyped, untyped]
+
+      def clear_cache!: () -> void
+
+      def process_string: (String template_content, ?Hash[untyped, untyped] custom_variables, ?Hash[Symbol, untyped] options) -> String
+
+      def render_template: (String template_name, ?Hash[untyped, untyped] variables, ?Hash[Symbol, untyped] options) -> String
+
+      def apply_template_set: (String template_set, String destination_dir, ?Hash[untyped, untyped] custom_variables, ?Hash[Symbol, untyped] options) -> Array[String]
+
+      private
+
+      def find_template: (String template_name, ?String? custom_template_dir) -> String
+
+      def collect_variables: (?Hash[untyped, untyped] custom_variables) -> Hash[untyped, untyped]
+    end
+  end
+end

data/sig/sxn/templates/template_processor.rbs

@@ -0,0 +1,44 @@
+# TypeProf 0.21.3
+
+module Sxn
+  module Templates
+    class TemplateProcessor
+      # Maximum template size in bytes to prevent memory exhaustion
+      MAX_TEMPLATE_SIZE: Integer
+
+      # Maximum rendering time in seconds to prevent infinite loops
+      MAX_RENDER_TIME: Integer
+
+      # Allowed Liquid filters for security
+      ALLOWED_FILTERS: Array[String]
+
+      def initialize: () -> void
+
+      def process: (String template_content, ?Hash[untyped, untyped] variables, ?Hash[Symbol, untyped] options) -> String
+
+      def process_file: (String | Pathname template_path, ?Hash[untyped, untyped] variables, ?Hash[Symbol, untyped] options) -> String
+
+      def validate_syntax: (String template_content) -> bool
+
+      def extract_variables: (String template_content) -> Array[String]
+
+      private
+
+      def create_secure_liquid_environment: () -> bool
+
+      def validate_template_size!: (String template_content) -> void
+
+      def parse_template: (String template_content, ?validate: bool) -> untyped
+
+      def sanitize_variables: (Hash[untyped, untyped] variables) -> Hash[String, untyped]
+
+      def sanitize_key: (untyped key) -> String
+
+      def sanitize_value: (untyped value) -> untyped
+
+      def render_with_timeout: (untyped template, Hash[String, untyped] variables, Hash[Symbol, untyped] options) -> String
+
+      alias validate_template validate_syntax
+    end
+  end
+end

data/sig/sxn/templates/template_security.rbs

@@ -0,0 +1,62 @@
+# TypeProf 0.21.3
+
+module Sxn
+  module Templates
+    class TemplateSecurity
+      # Maximum allowed template complexity (nested structures)
+      MAX_TEMPLATE_DEPTH: Integer
+
+      # Maximum number of variables allowed in a template
+      MAX_VARIABLE_COUNT: Integer
+
+      # Dangerous patterns that should not appear in templates
+      DANGEROUS_PATTERNS: Array[Regexp]
+
+      # Whitelisted variable namespaces
+      ALLOWED_VARIABLE_NAMESPACES: Array[String]
+
+      # Whitelisted filters (subset of Liquid's standard filters)
+      SAFE_FILTERS: Array[String]
+
+      @validation_cache: Hash[String, untyped]
+
+      def initialize: () -> void
+
+      def validate_template: (String template_content, ?Hash[untyped, untyped] variables) -> bool
+
+      def sanitize_variables: (Hash[untyped, untyped] variables) -> Hash[String, untyped]
+
+      def safe_filter?: (String filter_name) -> bool
+
+      def clear_cache!: () -> void
+
+      def validate_template_content: (String template_content) -> bool
+
+      def validate_template_path: (String | Pathname template_path) -> bool
+
+      private
+
+      def validate_template_variables: (Hash[untyped, untyped] variables) -> bool
+
+      def validate_template_complexity: (String template_content) -> bool
+
+      def validate_variable_key: (untyped key) -> bool
+
+      def validate_variable_value: (untyped value, ?depth: Integer) -> bool
+
+      def validate_string_value: (String str) -> bool
+
+      def sanitize_variable_key: (untyped key) -> String
+
+      def valid_variable_namespace?: (String key) -> bool
+
+      def sanitize_variable_value: (untyped value, ?depth: Integer) -> untyped
+
+      def sanitize_string_value: (String str) -> String
+
+      def count_total_variables: (Hash[untyped, untyped] variables, ?Integer count) -> Integer
+
+      def generate_cache_key: (String template_content, Hash[untyped, untyped] variables) -> String
+    end
+  end
+end

data/sig/sxn/templates/template_variables.rbs

@@ -0,0 +1,103 @@
+# TypeProf 0.21.3
+
+module Sxn
+  module Templates
+    class TemplateVariables
+      # Git command timeout in seconds
+      GIT_TIMEOUT: Integer
+
+      @session: untyped
+      @project: untyped
+      @config: untyped
+      @cached_variables: Hash[Symbol, untyped]
+
+      def initialize: (?untyped session, ?untyped project, ?untyped config) -> void
+
+      def collect: () -> Hash[Symbol, untyped]
+
+      alias build_variables collect
+
+      def refresh!: () -> Hash[Symbol, untyped]
+
+      def get_category: (Symbol category) -> Hash[untyped, untyped]
+
+      def add_custom_variables: (Hash[untyped, untyped] custom_vars) -> void
+
+      def collect_session_variables: () -> Hash[untyped, untyped]
+
+      def collect_project_variables: () -> Hash[untyped, untyped]
+
+      def collect_git_variables: () -> Hash[untyped, untyped]
+
+      def collect_environment_variables: () -> Hash[untyped, untyped]
+
+      def collect_user_variables: () -> Hash[untyped, untyped]
+
+      def collect_timestamp_variables: () -> Hash[untyped, untyped]
+
+      def detect_ruby_version: () -> String
+
+      def detect_rails_version: () -> String?
+
+      def detect_node_version: () -> String?
+
+      private
+
+      def validate_collected_variables: (Hash[Symbol, untyped] variables) -> Hash[Symbol, untyped]
+
+      def _collect_session_variables: () -> Hash[Symbol, untyped]
+
+      def _collect_git_variables: () -> Hash[Symbol, untyped]
+
+      def _collect_project_variables: () -> Hash[Symbol, untyped]
+
+      def _collect_environment_variables: () -> Hash[Symbol, untyped]
+
+      def _collect_user_variables: () -> Hash[Symbol, untyped]
+
+      def _collect_timestamp_variables: () -> Hash[Symbol, untyped]
+
+      def format_timestamp: (untyped timestamp) -> String?
+
+      def find_git_directory: () -> untyped
+
+      def git_repository?: (untyped path) -> bool
+
+      def collect_git_branch_info: (untyped git_dir) -> Hash[Symbol, untyped]
+
+      def collect_git_author_info: (untyped git_dir) -> Hash[Symbol, untyped]
+
+      def collect_git_commit_info: (untyped git_dir) -> Hash[Symbol, untyped]
+
+      def collect_git_remote_info: (untyped git_dir) -> Hash[Symbol, untyped]
+
+      def collect_git_status_info: (untyped git_dir) -> Hash[Symbol, untyped]
+
+      def collect_git_user_config: () -> Hash[Symbol, untyped]
+
+      def execute_git_command: (untyped directory, *String args) { (String) -> void } -> String?
+
+      def detect_project_type: (untyped project_path) -> String
+
+      def collect_rails_project_info: () -> Hash[Symbol, untyped]
+
+      def collect_js_project_info: () -> Hash[Symbol, untyped]
+
+      def collect_ruby_project_info: () -> Hash[Symbol, untyped]
+
+      def detect_package_manager: () -> String
+
+      def rails_available?: () -> bool
+
+      def collect_rails_version: () -> Hash[Symbol, untyped]
+
+      def node_available?: () -> bool
+
+      def collect_node_version: () -> Hash[Symbol, untyped]
+
+      def collect_database_info: () -> Hash[Symbol, untyped]
+
+      alias collect_all_variables collect
+    end
+  end
+end

data/sig/sxn/templates.rbs

@@ -0,0 +1,104 @@
+module Sxn
+  module Templates
+    # Template engine for processing Liquid templates
+    class TemplateEngine
+      @templates_dir: Pathname
+      @cache: Hash[String, Liquid::Template]
+      
+      def initialize: (?templates_dir: String?) -> void
+      def render: (String template_name, ?Hash[String, untyped] variables) -> String
+      def template_exists?: (String template_name) -> bool
+      def list_templates: () -> Array[String]
+      def clear_cache: () -> void
+      
+      private
+      def find_template: (String name) -> Pathname?
+      def load_template: (String path) -> Liquid::Template
+      def search_paths: (String name) -> Array[Pathname]
+    end
+    
+    # Template processor that handles template rendering with variables
+    class TemplateProcessor
+      @engine: TemplateEngine
+      @security: TemplateSecurity
+      @variables: TemplateVariables
+      
+      def initialize: (?engine: TemplateEngine?, ?security: TemplateSecurity?, ?variables: TemplateVariables?) -> void
+      def process: (String template_name, ?Hash[String, untyped] additional_vars) -> String
+      def process_directory: (String template_dir, String output_dir, ?Hash[String, untyped] variables) -> void
+      def available_templates: () -> Array[String]
+      
+      private
+      def safe_variables: (Hash[String, untyped] vars) -> Hash[String, untyped]
+      def merge_variables: (Hash[String, untyped] base, Hash[String, untyped] additional) -> Hash[String, untyped]
+    end
+    
+    # Template security for validating template operations
+    class TemplateSecurity
+      MAX_TEMPLATE_SIZE: Integer
+      MAX_RENDER_TIME: Integer
+      SAFE_LIQUID_TAGS: Array[String]
+      
+      def validate_template: (String content) -> void
+      def validate_path: (String path) -> void
+      def validate_variables: (Hash[String, untyped] variables) -> void
+      def sanitize_output: (String output) -> String
+      
+      private
+      def check_template_size: (String content) -> void
+      def check_dangerous_tags: (String content) -> void
+      def check_path_traversal: (String path) -> void
+    end
+    
+    # Template variables collector
+    class TemplateVariables
+      @session: untyped
+      @project: untyped
+      @config: untyped
+      @cached_variables: Hash[String, untyped]
+      
+      def initialize: (?untyped session, ?untyped project, ?untyped config) -> void
+      def collect: () -> Hash[String, untyped]
+      def clear_cache: () -> void
+      
+      private
+      def collect_session_variables: () -> Hash[String, untyped]
+      def _collect_session_variables: () -> Hash[String, untyped]
+      def collect_git_variables: () -> Hash[String, untyped]
+      def _collect_git_variables: () -> Hash[String, untyped]
+      def find_git_directory: () -> Pathname?
+      def git_repository?: (untyped path) -> bool
+      def collect_git_branch_info: (Pathname git_dir) -> Hash[String, untyped]
+      def collect_git_commit_info: (Pathname git_dir) -> Hash[String, untyped]
+      def collect_git_author_info: (Pathname git_dir) -> Hash[String, untyped]
+      def execute_git_command: (Pathname? directory, *String args) ?{ (String) -> void } -> String?
+      def collect_project_variables: () -> Hash[String, untyped]
+      def _collect_project_variables: () -> Hash[String, untyped]
+      def collect_environment_variables: () -> Hash[String, untyped]
+      def _collect_environment_variables: () -> Hash[String, untyped]
+      def collect_ruby_version: () -> Hash[String, untyped]
+      def collect_rails_version: () -> Hash[String, untyped]
+      def node_available?: () -> bool
+      def collect_node_version: () -> Hash[String, untyped]
+      def collect_user_variables: () -> Hash[String, untyped]
+      def _collect_user_variables: () -> Hash[String, untyped]
+      def get_git_config: (String key) -> String?
+    end
+    
+    # Module errors
+    class Error < ::StandardError
+    end
+    
+    class TemplateNotFoundError < Error
+    end
+    
+    class TemplateRenderError < Error
+    end
+    
+    class TemplateSecurityError < Error
+    end
+    
+    class TemplateVariableError < Error
+    end
+  end
+end

data/sig/sxn/ui/output.rbs

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Sxn
+  module UI
+    # Formatted output with colors and status indicators
+    class Output
+      @pastel: untyped
+
+      def initialize: () -> void
+
+      def success: (String message) -> void
+
+      def error: (String message) -> void
+
+      def warning: (String message) -> void
+
+      def info: (String message) -> void
+
+      def debug: (String message) -> void
+
+      def status: (String | Symbol label, String message, ?Symbol color) -> void
+
+      def section: (String title) -> void
+
+      def subsection: (String | Symbol title) -> void
+
+      def list_item: (String item, ?String? description) -> void
+
+      def empty_state: (String message) -> void
+
+      def key_value: (String key, String value, ?indent: Integer) -> void
+
+      def progress_start: (String message) -> void
+
+      def progress_done: () -> void
+
+      def progress_failed: () -> void
+
+      def newline: () -> void
+
+      def recovery_suggestion: (String message) -> void
+
+      def command_example: (String command, ?String? description) -> void
+
+      private
+
+      def debug_mode?: () -> bool
+    end
+  end
+end

data/sig/sxn/ui/progress_bar.rbs

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Sxn
+  module UI
+    # Progress bars for long-running operations
+    class ProgressBar
+      @bar: untyped
+
+      def initialize: (String title, ?total: Integer, ?format: Symbol) -> void
+
+      def advance: (?Integer step) -> void
+
+      def finish: () -> void
+
+      def current: () -> Integer
+
+      def total: () -> Integer
+
+      def percent: () -> Integer
+
+      def log: (String message) -> void
+
+      def self.with_progress: [T] (String title, Array[T] items, ?format: Symbol) { (T item, ProgressBar progress) -> untyped } -> Array[untyped]
+
+      def self.for_operation: [T] (String title, ?total_steps: Integer) { (Stepper stepper) -> T } -> T
+
+      # Helper class for step-by-step operations
+      class Stepper
+        @progress: ProgressBar
+
+        def initialize: (ProgressBar progress_bar) -> void
+
+        def step: (?String? message) -> void
+
+        def log: (String message) -> void
+      end
+    end
+  end
+end

data/sig/sxn/ui/prompt.rbs

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Sxn
+  module UI
+    # Interactive prompts with validation
+    class Prompt
+      @prompt: untyped
+
+      def initialize: () -> void
+
+      def ask: [T] (String message, ?Hash[Symbol, untyped] options) ?{ (untyped) -> void } -> T
+
+      def ask_yes_no: (String message, ?default: bool) -> bool
+
+      def select: [T] (String message, Array[T] | Hash[String, T] choices, ?Hash[Symbol, untyped] options) -> T
+
+      def multi_select: [T] (String message, Array[T] | Hash[String, T] choices, ?Hash[Symbol, untyped] options) -> Array[T]
+
+      def folder_name: (?String message, ?default: String?) -> String
+
+      def session_name: (?String message, ?existing_sessions: Array[String]) -> String
+
+      def project_name: (?String message) -> String
+
+      def project_path: (?String message) -> String
+
+      def branch_name: (?String message, ?default: String?) -> String
+
+      def confirm_deletion: (String item_name, ?String item_type) -> bool
+
+      def rule_type: () -> String
+
+      def sessions_folder_setup: () -> String
+
+      def project_detection_confirm: (Array[Hash[Symbol, String]] detected_projects) -> bool
+    end
+  end
+end

data/sig/sxn/ui/table.rbs

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Sxn
+  module UI
+    # Table formatting for lists and data display
+    class Table
+      @pastel: untyped
+
+      def initialize: () -> void
+
+      def sessions: (Array[Hash[Symbol, untyped]] sessions) -> void
+
+      def projects: (Array[Hash[Symbol, untyped]] projects) -> void
+
+      def worktrees: (Array[Hash[Symbol, untyped]] worktrees) -> void
+
+      def rules: (Array[Hash[Symbol, untyped]] rules, ?String? project_filter) -> void
+
+      def config_summary: (Hash[Symbol, untyped] config) -> void
+
+      # Add a header to the table output
+      def header: (String title) -> void
+
+      private
+
+      def render_table: (Array[String] headers, Array[Array[String]] rows) -> void
+
+      def empty_table: (String message) -> void
+
+      def status_indicator: (String status) -> String
+
+      def worktree_status: (Hash[Symbol, untyped] worktree) -> String
+
+      def git_clean?: (String path) -> bool
+
+      def format_date: (String? date_string) -> String
+
+      def truncate_path: (String? path, ?max_length: Integer) -> String
+
+      def truncate_config: (untyped config, ?max_length: Integer) -> String
+    end
+  end
+end

data/sig/sxn/ui.rbs

@@ -0,0 +1,63 @@
+module Sxn
+  module UI
+    class Output
+      @pastel: untyped  # Pastel instance
+      @quiet: bool
+      @verbose: bool
+      
+      def initialize: (?quiet: bool, ?verbose: bool) -> void
+      def say: (String message, ?color: Symbol?) -> void
+      def success: (String message) -> void
+      def error: (String message) -> void
+      def warning: (String message) -> void
+      def info: (String message) -> void
+      def debug: (String message) -> void
+      def newline: () -> void
+      def print: (String message) -> void
+      def puts: (String message) -> void
+      
+      private
+      def format_message: (String message, ?Symbol? color) -> String
+      def should_output?: (?Symbol? level) -> bool
+    end
+    
+    class Prompt
+      @prompt: untyped  # TTY::Prompt instance
+      
+      def initialize: () -> void
+      def ask: (String question, ?Hash[Symbol, untyped] options) -> String
+      def yes?: (String question) -> bool
+      def no?: (String question) -> bool
+      def select: (String question, Array[untyped] choices, ?Hash[Symbol, untyped] options) -> untyped
+      def multi_select: (String question, Array[untyped] choices, ?Hash[Symbol, untyped] options) -> Array[untyped]
+      def mask: (String question) -> String
+      def keypress: (String message, ?Hash[Symbol, untyped] options) -> String
+    end
+    
+    class Table
+      @table: untyped  # TTY::Table instance
+      
+      def initialize: (Array[Array[untyped]] data, ?Array[String]? headers) -> void
+      def render: (?Hash[Symbol, untyped] options) -> String
+      def add_row: (Array[untyped] row) -> void
+      def clear: () -> void
+      
+      private
+      def format_table: () -> untyped
+    end
+    
+    class ProgressBar
+      @bar: untyped  # TTY::ProgressBar instance
+      
+      def initialize: (String format, ?Hash[Symbol, untyped] options) -> void
+      def advance: (?Integer step) -> void
+      def update: (Hash[Symbol, untyped] tokens) -> void
+      def finish: () -> void
+      def reset: () -> void
+      def complete?: () -> bool
+      def current: () -> Integer
+      def total: () -> Integer
+      def total=: (Integer value) -> void
+    end
+  end
+end

data/sig/sxn/version.rbs

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Sxn
+  VERSION: String
+end

data/sig/sxn.rbs

@@ -0,0 +1,29 @@
+# Main Sxn module providing session management for multi-repository development
+module Sxn
+  # VERSION is defined in sig/sxn/version.rbs
+  
+  # Type aliases for common patterns
+  type config_hash = Hash[String, untyped]
+  type logger_level = :debug | :info | :warn | :error | Symbol
+  
+  # Module singleton methods
+  def self.logger: () -> ::Logger?
+  def self.logger=: (::Logger new_logger) -> ::Logger
+  
+  def self.config: () -> config_hash?
+  def self.config=: (config_hash new_config) -> config_hash
+  
+  def self.root: () -> String
+  def self.lib_root: () -> String
+  def self.version: () -> String
+  
+  def self.load_config: () -> config_hash?
+  def self.setup_logger: (?level: logger_level) -> ::Logger
+  
+  # Module instance variables
+  @logger: ::Logger?
+  @config: config_hash?
+end
+
+# Global variable declarations
+$CHILD_STATUS: Process::Status