rosett-ai 1.3.3

data/lib/rosett_ai/ui/accessible_tui.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: GPL-3.0-only
+# Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
+
+module RosettAi
+  # User interface adapters.
+  module Ui
+    # Accessible TUI adapter for screen-reader-friendly output.
+    #
+    # Produces linear, sequential text without box-drawing characters or
+    # ANSI escape sequences. Auto-selected when assistive technology is
+    # detected (ORCA_RUNNING, BRLTTY_TTY).
+    class AccessibleTui < Tui
+      def render(content)
+        $stdout.puts(RosettAi::TextSanitizer.strip_ansi(String(content)))
+      end
+
+      def display_table(headers, rows)
+        widths = compute_column_widths(headers, rows)
+
+        header_line = format_row(headers, widths)
+        separator = widths.map { |w| '-' * w }.join('  ')
+
+        $stdout.puts(header_line)
+        $stdout.puts(separator)
+        rows.each { |row| $stdout.puts(format_row(row, widths)) }
+      end
+
+      def show_spinner(message)
+        $stdout.puts("Processing: #{message}...")
+        result = yield
+        $stdout.puts('Done.')
+        result
+      rescue StandardError => e
+        $stdout.puts('Failed.')
+        raise e
+      end
+
+      def announce(message, priority: :polite)
+        prefix = priority == :assertive ? '[ASSERTIVE]' : '[POLITE]'
+        warn("#{prefix} #{message}")
+      end
+
+      private
+
+      def compute_column_widths(headers, rows)
+        all_rows = [headers] + rows
+        (0...headers.size).map do |col|
+          all_rows.map { |row| String(row[col]).length }.max
+        end
+      end
+
+      def format_row(row, widths)
+        row.each_with_index.map { |cell, idx| String(cell).ljust(widths[idx]) }.join('  ')
+      end
+    end
+
+    Registry.register(:accessible_tui, AccessibleTui)
+  end
+end

data/lib/rosett_ai/ui/base.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: GPL-3.0-only
+# Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
+
+module RosettAi
+  module Ui
+    # Abstract interface for UI implementations.
+    #
+    # All UI adapters (TUI, GTK4, Qt6) must inherit from this class and
+    # implement the required methods. The shared example
+    # 'a UI implementation' verifies conformance.
+    class Base
+      RTL_LOCALES = ['ar', 'he', 'fa', 'ur'].freeze
+
+      def render(content)
+        raise NotImplementedError, "#{self.class}#render not implemented"
+      end
+
+      def display_table(headers, rows)
+        raise NotImplementedError, "#{self.class}#display_table not implemented"
+      end
+
+      def prompt_user(question, choices: nil)
+        raise NotImplementedError, "#{self.class}#prompt_user not implemented"
+      end
+
+      def show_spinner(message, &)
+        raise NotImplementedError, "#{self.class}#show_spinner not implemented"
+      end
+
+      def announce(message)
+        raise NotImplementedError, "#{self.class}#announce not implemented"
+      end
+
+      def accessible?
+        ENV.key?('ORCA_RUNNING') || ENV.key?('BRLTTY_TTY')
+      end
+
+      def text_direction(locale = nil)
+        lang = locale || ENV.fetch('LANG', 'en')[0, 2]
+        RTL_LOCALES.include?(lang) ? :rtl : :ltr
+      end
+    end
+  end
+end

data/lib/rosett_ai/ui/gtk4.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: GPL-3.0-only
+# Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
+
+module RosettAi
+  # User interface adapters.
+  module Ui
+    # GTK4 adapter using ruby-gnome gtk4 gem.
+    #
+    # Implements all Base methods using native GTK4 widgets.
+    # Installed as part of the rosett-ai-gtk4 Debian package.
+    # Requires libgtk-4-dev and the gtk4 gem on the host system.
+    #
+    # Methods raise RosettAi::Error with install instructions if the gem
+    # is not available at runtime.
+    class Gtk4 < Base
+      UNAVAILABLE_MESSAGE = 'GTK4 adapter requires the gtk4 gem. Install: gem install gtk4'
+
+      def self.available?
+        require 'gtk4'
+        true
+      rescue LoadError
+        false
+      end
+
+      def render(content)
+        require_gtk4!
+        text_view = ::Gtk::TextView.new
+        text_view.buffer.text = String(content)
+        text_view.editable = false
+        text_view
+      end
+
+      def display_table(headers, rows)
+        require_gtk4!
+        store = build_list_store(headers.length)
+        populate_store(store, rows)
+        build_tree_view(store, headers)
+      end
+
+      def prompt_user(question, choices: nil) # rubocop:disable Lint/UnusedMethodArgument -- keyword name is part of public API
+        require_gtk4!
+        dialog = ::Gtk::MessageDialog.new(
+          message: question,
+          buttons: :ok_cancel
+        )
+        dialog.accessible_role = :dialog if dialog.respond_to?(:accessible_role=)
+        dialog
+      end
+
+      def show_spinner(_message)
+        require_gtk4!
+        spinner = ::Gtk::Spinner.new
+        spinner.start
+        result = yield
+        spinner.stop
+        result
+      end
+
+      def announce(message, priority: :polite)
+        warn("[GTK4:#{priority}] #{message}")
+      end
+
+      private
+
+      def require_gtk4!
+        require 'gtk4'
+      rescue LoadError
+        raise RosettAi::Error, UNAVAILABLE_MESSAGE
+      end
+
+      def build_list_store(column_count)
+        types = Array.new(column_count, String)
+        ::Gtk::ListStore.new(*types)
+      end
+
+      def populate_store(store, rows)
+        rows.each do |row|
+          iter = store.append
+          row.each_with_index { |cell, idx| iter[idx] = String(cell) }
+        end
+      end
+
+      def build_tree_view(store, headers)
+        view = ::Gtk::TreeView.new(store)
+        headers.each_with_index do |header, idx|
+          renderer = ::Gtk::CellRendererText.new
+          column = ::Gtk::TreeViewColumn.new(header, renderer, text: idx)
+          view.append_column(column)
+        end
+        view
+      end
+    end
+
+    Registry.register(:gtk4, Gtk4)
+  end
+end

data/lib/rosett_ai/ui/kde.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: GPL-3.0-only
+# Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
+
+module RosettAi
+  # User interface adapters.
+  module Ui
+    # KDE skeleton adapter.
+    #
+    # Registers as :kde in the UI registry but raises on any method call.
+    # KDE integration requires Qt6 bindings which do not exist for Ruby.
+    # This adapter serves as a placeholder for the rosett-ai-kde package concept.
+    class Kde < Base
+      UNAVAILABLE_MESSAGE = 'KDE adapter not available — Ruby Qt6/KDE bindings do not exist. Use GTK4 or TUI.'
+
+      def render(_content)
+        raise RosettAi::Error, UNAVAILABLE_MESSAGE
+      end
+
+      def display_table(_headers, _rows)
+        raise RosettAi::Error, UNAVAILABLE_MESSAGE
+      end
+
+      def prompt_user(_question, choices: nil) # rubocop:disable Lint/UnusedMethodArgument -- skeleton raises unconditionally
+        raise RosettAi::Error, UNAVAILABLE_MESSAGE
+      end
+
+      def show_spinner(_message)
+        raise RosettAi::Error, UNAVAILABLE_MESSAGE
+      end
+
+      def announce(_message)
+        raise RosettAi::Error, UNAVAILABLE_MESSAGE
+      end
+    end
+
+    Registry.register(:kde, Kde)
+  end
+end

data/lib/rosett_ai/ui/qt6.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: GPL-3.0-only
+# Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
+
+module RosettAi
+  # User interface adapters.
+  module Ui
+    # Qt6 skeleton adapter.
+    #
+    # Registers as :qt6 in the UI registry but raises on any method call.
+    # Ruby Qt6 bindings do not exist (qtbindings is unmaintained, Qt4-only).
+    # This adapter serves as a placeholder for the rosett-ai-qt6 package concept.
+    class Qt6 < Base
+      UNAVAILABLE_MESSAGE = 'Qt6 adapter not available — Ruby Qt6 bindings do not exist. Use GTK4 or TUI.'
+
+      def render(_content)
+        raise RosettAi::Error, UNAVAILABLE_MESSAGE
+      end
+
+      def display_table(_headers, _rows)
+        raise RosettAi::Error, UNAVAILABLE_MESSAGE
+      end
+
+      def prompt_user(_question, choices: nil) # rubocop:disable Lint/UnusedMethodArgument -- keyword name is part of public API
+        raise RosettAi::Error, UNAVAILABLE_MESSAGE
+      end
+
+      def show_spinner(_message)
+        raise RosettAi::Error, UNAVAILABLE_MESSAGE
+      end
+
+      def announce(_message)
+        raise RosettAi::Error, UNAVAILABLE_MESSAGE
+      end
+    end
+
+    Registry.register(:qt6, Qt6)
+  end
+end

data/lib/rosett_ai/ui/registry.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: GPL-3.0-only
+# Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
+
+module RosettAi
+  module Ui
+    # Discovers and manages installed UI plugins.
+    #
+    # Plugins register themselves via RosettAi::Ui::Registry.register.
+    # The registry selects the appropriate adapter at runtime based
+    # on user preference or available plugins.
+    class Registry
+      @adapters = {}
+
+      class << self
+        def register(name, adapter_class)
+          @adapters[name.to_sym] = adapter_class
+        end
+
+        def resolve(name = nil)
+          key = name&.to_sym || default_adapter
+          adapter_class = @adapters[key]
+
+          unless adapter_class
+            available = @adapters.keys.join(', ')
+            raise RosettAi::Error, "Unknown UI adapter '#{key}'. Available: #{available}"
+          end
+
+          adapter_class.new
+        end
+
+        def available
+          @adapters.keys
+        end
+
+        def registered?(name)
+          @adapters.key?(name.to_sym)
+        end
+
+        def reset!
+          @adapters = {}
+        end
+
+        private
+
+        def default_adapter
+          return :accessible_tui if @adapters.key?(:accessible_tui) && accessible_environment?
+          return :tui if @adapters.key?(:tui)
+
+          @adapters.keys.first || raise(RosettAi::Error, 'No UI adapters registered')
+        end
+
+        def accessible_environment?
+          Base.new.accessible?
+        end
+      end
+    end
+  end
+end

data/lib/rosett_ai/ui/tty_helper.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: GPL-3.0-only
+# Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
+
+require 'rainbow'
+
+module RosettAi
+  module Ui
+    # TTY detection and safe interactive helpers for CLI commands.
+    #
+    # Provides guards for interactive prompts and spinners that degrade
+    # gracefully when stdout/stdin are not terminals (e.g., piped or
+    # redirected). Commands should use these helpers instead of calling
+    # TTY::Prompt or TTY::Spinner directly.
+    module TtyHelper
+      module_function
+
+      # Whether stdout and stdin are both connected to a terminal.
+      # @return [Boolean]
+      def interactive?
+        $stdout.tty? && $stdin.tty?
+      end
+
+      # Ask a yes/no confirmation question.
+      #
+      # Returns true immediately when +force+ is true. In non-interactive
+      # mode (piped stdin/stdout), raises a Thor::Error with a hint to
+      # use --force.
+      #
+      # @param question [String] the confirmation question
+      # @param force [Boolean] skip the prompt entirely
+      # @return [Boolean]
+      # @raise [Thor::Error] when non-interactive and not forced
+      def confirm?(question, force: false)
+        return true if force
+
+        require_interactive!('Use --force to skip confirmation.')
+
+        require 'tty-prompt'
+        TTY::Prompt.new.yes?(question)
+      end
+
+      # Ask for free-text input.
+      #
+      # In non-interactive mode, raises a Thor::Error with a hint about
+      # the equivalent CLI option.
+      #
+      # @param question [String] the prompt text
+      # @param option_hint [String, nil] CLI option name (e.g. 'description')
+      # @return [String]
+      # @raise [Thor::Error] when non-interactive
+      def ask(question, option_hint: nil)
+        hint = option_hint ? "Use --#{option_hint} to provide the value." : nil
+        require_interactive!(hint)
+
+        require 'tty-prompt'
+        TTY::Prompt.new.ask(question, required: true)
+      end
+
+      # Guard that raises if the terminal is not interactive.
+      #
+      # @param hint [String, nil] additional guidance for the user
+      # @raise [Thor::Error]
+      def require_interactive!(hint = nil)
+        return if interactive?
+
+        message = 'Interactive input required but terminal is not available.'
+        message = "#{message} #{hint}" if hint
+        raise ::Thor::Error, message
+      end
+    end
+  end
+end

data/lib/rosett_ai/ui/tui.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: GPL-3.0-only
+# Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
+
+require 'rainbow'
+require 'terminal-table'
+require 'tty-prompt'
+require 'tty-spinner'
+
+module RosettAi
+  # User interface adapters.
+  module Ui
+    # Terminal UI adapter using TTY gems.
+    #
+    # Default adapter for headless and terminal environments.
+    class Tui < Base
+      def initialize
+        super
+        Rainbow.enabled = false if ENV.key?('NO_COLOR')
+      end
+
+      def render(content)
+        $stdout.puts(content)
+      end
+
+      def display_table(headers, rows)
+        table = ::Terminal::Table.new(headings: headers, rows: rows)
+        $stdout.puts(table)
+      end
+
+      def prompt_user(question, choices: nil)
+        prompt = TTY::Prompt.new
+        if choices
+          prompt.select(question, choices)
+        else
+          prompt.ask(question)
+        end
+      end
+
+      def show_spinner(message)
+        spinner = TTY::Spinner.new("[:spinner] #{message}", format: :dots)
+        spinner.auto_spin
+        result = yield
+        spinner.success(Rainbow(' done').green)
+        result
+      rescue StandardError => e
+        spinner.error(Rainbow(' failed').red)
+        raise e
+      end
+
+      def announce(message)
+        warn(message)
+      end
+    end
+
+    Registry.register(:tui, Tui)
+  end
+end

data/lib/rosett_ai/validators/behaviour_validator.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: GPL-3.0-only
+# Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
+
+module RosettAi
+  module Validators
+    # Validates behaviour configuration files against the behaviour JSON Schema.
+    #
+    # Thin wrapper around SchemaValidator. The SCHEMA_PATH constant is preserved
+    # for backward compatibility with existing specs and code that references it.
+    class BehaviourValidator < SchemaValidator
+      SCHEMA_PATH = 'conf/schemas/behaviour_schema.json'
+
+      def initialize
+        super(schema: 'behaviour_schema.json')
+      end
+    end
+  end
+end

data/lib/rosett_ai/validators/design_validator.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: GPL-3.0-only
+# Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
+
+module RosettAi
+  module Validators
+    # Validates design documents against the design JSON Schema.
+    class DesignValidator < SchemaValidator
+      SCHEMA_PATH = 'conf/schemas/design_schema.json'
+
+      def initialize
+        super(schema: 'design_schema.json')
+      end
+    end
+  end
+end

data/lib/rosett_ai/validators/schema_validator.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: GPL-3.0-only
+# Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
+
+require 'yaml'
+require 'json'
+require 'json_schemer'
+
+module RosettAi
+  module Validators
+    # Generic JSON Schema validator for YAML configuration files.
+    #
+    # Subclasses specify which schema to use by passing the schema filename
+    # to the constructor. The schema is loaded from conf/schemas/ relative to
+    # the project root.
+    #
+    # API: valid?(file_path), validate(file_path), errors
+    class SchemaValidator
+      attr_reader :errors
+
+      def initialize(schema:)
+        @schema_filename = schema
+        @errors = []
+        @schemer = JSONSchemer.schema(load_schema)
+      end
+
+      def valid?(file_path)
+        @errors = []
+        content = load_file(file_path)
+        return false unless content
+
+        validate_schema(content)
+        @errors.empty?
+      end
+
+      def validate(file_path)
+        valid?(file_path)
+        @errors
+      end
+
+      private
+
+      def schema_path
+        RosettAi.root.join('conf', 'schemas', @schema_filename)
+      end
+
+      def load_schema
+        JSON.parse(schema_path.read)
+      rescue Errno::ENOENT
+        raise RosettAi::ConfigurationError,
+              "JSON schema not found: #{schema_path}. " \
+              "Ensure conf/schemas/#{@schema_filename} exists."
+      rescue JSON::ParserError => e
+        raise RosettAi::ConfigurationError,
+              "Invalid JSON in schema #{@schema_filename}: #{e.message}"
+      end
+
+      def load_file(file_path)
+        RosettAi::YamlLoader.load_file(file_path)
+      rescue Errno::ENOENT
+        @errors << "File not found: #{file_path}"
+        nil
+      rescue Psych::SyntaxError => e
+        @errors << "YAML syntax error: #{e.message}"
+        nil
+      rescue RosettAi::ValidationError => e
+        @errors << e.message
+        nil
+      end
+
+      def validate_schema(content)
+        @schemer.validate(content).each do |error|
+          @errors << format_error(error)
+        end
+      end
+
+      def format_error(error)
+        path = error['data_pointer'].empty? ? 'root' : error['data_pointer']
+        "#{path}: #{error['type']}"
+      end
+    end
+  end
+end

data/lib/rosett_ai/validators/tooling_validator.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: GPL-3.0-only
+# Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
+
+module RosettAi
+  module Validators
+    # Validates tooling configuration files against the tooling JSON Schema.
+    class ToolingValidator < SchemaValidator
+      SCHEMA_PATH = 'conf/schemas/tooling_schema.json'
+
+      def initialize
+        super(schema: 'tooling_schema.json')
+      end
+    end
+  end
+end

data/lib/rosett_ai/version.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+# SPDX-License-Identifier: GPL-3.0-only
+# Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
+
+module RosettAi
+  VERSION = '1.3.3'
+end