taski 0.4.1 → 0.5.0

data/lib/taski/execution/tree_progress_display.rb

@@ -0,0 +1,506 @@
+# frozen_string_literal: true
+
+require "monitor"
+require "stringio"
+
+module Taski
+  module Execution
+    # Tree-based progress display that shows task execution in a tree structure
+    # similar to Task.tree, with real-time status updates and stdout capture.
+    class TreeProgressDisplay
+      SPINNER_FRAMES = %w[⠋ ⠙ ⠹ ⠸ ⠼ ⠴ ⠦ ⠧ ⠇ ⠏].freeze
+
+      # ANSI color codes (matching Task.tree)
+      COLORS = {
+        reset: "\e[0m",
+        task: "\e[32m",      # green
+        section: "\e[34m",   # blue
+        impl: "\e[33m",      # yellow
+        tree: "\e[90m",      # gray
+        name: "\e[1m",       # bold
+        success: "\e[32m",   # green
+        error: "\e[31m",     # red
+        running: "\e[36m",   # cyan
+        pending: "\e[90m",   # gray
+        dim: "\e[2m"         # dim
+      }.freeze
+
+      # Status icons
+      ICONS = {
+        pending: "⏸",        # Pause for waiting
+        running_prefix: "",  # Will use spinner
+        completed: "✓",
+        failed: "✗",
+        skipped: "⊘"         # Prohibition sign for unselected impl candidates
+      }.freeze
+
+      # Shared helper methods
+      def self.section_class?(klass)
+        defined?(Taski::Section) && klass < Taski::Section
+      end
+
+      def self.nested_class?(child_class, parent_class)
+        child_name = child_class.name.to_s
+        parent_name = parent_class.name.to_s
+        child_name.start_with?("#{parent_name}::")
+      end
+
+      # Render a static tree structure for a task class (used by Task.tree)
+      # @param root_task_class [Class] The root task class
+      # @return [String] The rendered tree string
+      def self.render_static_tree(root_task_class)
+        renderer = StaticTreeRenderer.new
+        renderer.render(root_task_class)
+      end
+
+      # Internal renderer for static tree display (no progress tracking)
+      class StaticTreeRenderer
+        def render(root_task_class)
+          @task_index_map = {}
+          build_tree(root_task_class, "", false, Set.new)
+        end
+
+        private
+
+        def build_tree(task_class, prefix, is_impl, ancestors)
+          type_label = colored_type_label(task_class)
+          impl_prefix = is_impl ? "#{COLORS[:impl]}[impl]#{COLORS[:reset]} " : ""
+          task_number = get_task_number(task_class)
+          name = "#{COLORS[:name]}#{task_class.name}#{COLORS[:reset]}"
+
+          # Detect circular reference
+          if ancestors.include?(task_class)
+            circular_marker = "#{COLORS[:impl]}(circular)#{COLORS[:reset]}"
+            return "#{impl_prefix}#{task_number} #{name} #{type_label} #{circular_marker}\n"
+          end
+
+          result = "#{impl_prefix}#{task_number} #{name} #{type_label}\n"
+
+          # Register task number if not already registered
+          @task_index_map[task_class] = @task_index_map.size + 1 unless @task_index_map.key?(task_class)
+
+          new_ancestors = ancestors + [task_class]
+          dependencies = StaticAnalysis::Analyzer.analyze(task_class).to_a
+          is_section = TreeProgressDisplay.section_class?(task_class)
+
+          dependencies.each_with_index do |dep, index|
+            is_last = (index == dependencies.size - 1)
+            is_impl_candidate = is_section && TreeProgressDisplay.nested_class?(dep, task_class)
+            result += render_dependency_branch(dep, prefix, is_last, is_impl_candidate, new_ancestors)
+          end
+
+          result
+        end
+
+        def render_dependency_branch(dep, prefix, is_last, is_impl, ancestors)
+          connector = is_last ? "└── " : "├── "
+          extension = is_last ? "    " : "│   "
+          dep_tree = build_tree(dep, "#{prefix}#{extension}", is_impl, ancestors)
+
+          result = "#{prefix}#{COLORS[:tree]}#{connector}#{COLORS[:reset]}"
+          lines = dep_tree.lines
+          result += lines.first
+          lines.drop(1).each { |line| result += line }
+          result
+        end
+
+        def get_task_number(task_class)
+          number = @task_index_map[task_class] || (@task_index_map.size + 1)
+          "#{COLORS[:tree]}[#{number}]#{COLORS[:reset]}"
+        end
+
+        def colored_type_label(klass)
+          if TreeProgressDisplay.section_class?(klass)
+            "#{COLORS[:section]}(Section)#{COLORS[:reset]}"
+          else
+            "#{COLORS[:task]}(Task)#{COLORS[:reset]}"
+          end
+        end
+      end
+
+      class TaskProgress
+        attr_accessor :state, :start_time, :end_time, :error, :duration
+        attr_accessor :is_impl_candidate
+
+        def initialize
+          @state = :pending
+          @start_time = nil
+          @end_time = nil
+          @error = nil
+          @duration = nil
+          @is_impl_candidate = false
+        end
+      end
+
+      def initialize(output: $stdout)
+        @output = output
+        @tasks = {}
+        @monitor = Monitor.new
+        @spinner_index = 0
+        @renderer_thread = nil
+        @running = false
+        @nest_level = 0 # Track nested executor calls
+        @root_task_class = nil
+        @tree_structure = nil
+        @section_impl_map = {}  # Section -> selected impl class
+        @last_line_count = 0
+      end
+
+      # Set the root task to build tree structure
+      # Only sets root task if not already set (prevents nested executor overwrite)
+      # @param root_task_class [Class] The root task class
+      def set_root_task(root_task_class)
+        @monitor.synchronize do
+          return if @root_task_class # Don't overwrite existing root task
+          @root_task_class = root_task_class
+          build_tree_structure
+        end
+      end
+
+      # Register which impl was selected for a section
+      # @param section_class [Class] The section class
+      # @param impl_class [Class] The selected implementation class
+      def register_section_impl(section_class, impl_class)
+        @monitor.synchronize do
+          @section_impl_map[section_class] = impl_class
+        end
+      end
+
+      # @param task_class [Class] The task class to register
+      def register_task(task_class)
+        @monitor.synchronize do
+          return if @tasks.key?(task_class)
+          @tasks[task_class] = TaskProgress.new
+        end
+      end
+
+      # @param task_class [Class] The task class to check
+      # @return [Boolean] true if the task is registered
+      def task_registered?(task_class)
+        @monitor.synchronize do
+          @tasks.key?(task_class)
+        end
+      end
+
+      # @param task_class [Class] The task class to update
+      # @param state [Symbol] The new state (:pending, :running, :completed, :failed)
+      # @param duration [Float] Duration in milliseconds (for completed tasks)
+      # @param error [Exception] Error object (for failed tasks)
+      def update_task(task_class, state:, duration: nil, error: nil)
+        @monitor.synchronize do
+          progress = @tasks[task_class]
+          return unless progress
+
+          progress.state = state
+          progress.duration = duration if duration
+          progress.error = error if error
+
+          case state
+          when :running
+            progress.start_time = Time.now
+          when :completed, :failed
+            progress.end_time = Time.now
+          end
+        end
+      end
+
+      # @param task_class [Class] The task class
+      # @return [Symbol] The task state
+      def task_state(task_class)
+        @monitor.synchronize do
+          @tasks[task_class]&.state
+        end
+      end
+
+      def start
+        should_start = false
+        @monitor.synchronize do
+          @nest_level += 1
+          return if @nest_level > 1 # Already running from outer executor
+          return if @running
+          return unless @output.tty?
+
+          @running = true
+          should_start = true
+        end
+
+        return unless should_start
+
+        # Hide cursor (outside monitor to avoid holding lock during I/O)
+        @output.print "\e[?25l"
+        @renderer_thread = Thread.new do
+          loop do
+            break unless @running
+            render_live
+            sleep 0.1
+          end
+        end
+      end
+
+      def stop
+        should_stop = false
+        @monitor.synchronize do
+          @nest_level -= 1 if @nest_level > 0
+          return unless @nest_level == 0
+          return unless @running
+
+          @running = false
+          should_stop = true
+        end
+
+        return unless should_stop
+
+        @renderer_thread&.join
+        # Show cursor
+        @output.print "\e[?25h"
+        render_final
+      end
+
+      private
+
+      # Build tree structure from root task for display
+      def build_tree_structure
+        return unless @root_task_class
+
+        @tree_structure = build_tree_node(@root_task_class, Set.new)
+        register_tasks_from_tree(@tree_structure)
+      end
+
+      # Build a single tree node
+      def build_tree_node(task_class, ancestors)
+        return nil if ancestors.include?(task_class)
+
+        node = {
+          task_class: task_class,
+          is_section: section_class?(task_class),
+          children: [],
+          is_impl_candidate: false
+        }
+
+        new_ancestors = ancestors + [task_class]
+        dependencies = StaticAnalysis::Analyzer.analyze(task_class).to_a
+        is_section = section_class?(task_class)
+
+        dependencies.each do |dep|
+          child_node = build_tree_node(dep, new_ancestors)
+          if child_node
+            # Only mark as impl candidate if parent is Section AND
+            # the dependency is a nested class of that Section
+            child_node[:is_impl_candidate] = is_section && nested_class?(dep, task_class)
+            node[:children] << child_node
+          end
+        end
+
+        node
+      end
+
+      # Register all tasks from tree structure
+      def register_tasks_from_tree(node)
+        return unless node
+
+        task_class = node[:task_class]
+        register_task(task_class)
+
+        # Mark as impl candidate if applicable
+        if node[:is_impl_candidate]
+          @tasks[task_class].is_impl_candidate = true
+        end
+
+        node[:children].each { |child| register_tasks_from_tree(child) }
+      end
+
+      def render_live
+        lines = nil
+        line_count = nil
+
+        @monitor.synchronize do
+          @spinner_index += 1
+          lines = build_tree_display
+          line_count = @last_line_count
+        end
+
+        return if lines.nil? || lines.empty?
+
+        # Move cursor up to beginning of display area
+        if line_count && line_count > 0
+          @output.print "\e[#{line_count}A\r"
+        end
+
+        # Redraw all lines
+        lines.each do |line|
+          @output.print "\e[K#{line}\n"
+        end
+
+        @monitor.synchronize do
+          @last_line_count = lines.length
+        end
+
+        @output.flush
+      end
+
+      def render_final
+        @monitor.synchronize do
+          lines = build_tree_display
+          return if lines.empty?
+
+          # Clear previous animated output
+          if @last_line_count && @last_line_count > 0
+            @last_line_count.times do
+              @output.print "\e[1A\e[K"
+            end
+          end
+
+          # Print final state
+          lines.each { |line| @output.puts line }
+        end
+      end
+
+      # Build display lines from tree structure
+      def build_tree_display
+        return [] unless @tree_structure
+
+        lines = []
+        build_root_tree_lines(@tree_structure, "", lines)
+        lines
+      end
+
+      # Build tree lines starting from root node
+      # @param node [Hash] Tree node (root)
+      # @param prefix [String] Line prefix for tree drawing
+      # @param lines [Array<String>] Accumulated output lines
+      def build_root_tree_lines(node, prefix, lines)
+        task_class = node[:task_class]
+        progress = @tasks[task_class]
+
+        # Root node is never an impl candidate and is always selected
+        line = format_tree_line(task_class, progress, false, true)
+        lines << "#{prefix}#{line}"
+
+        render_children(node, prefix, lines, task_class, true)
+      end
+
+      # Render all children of a node recursively
+      # @param node [Hash] Tree node
+      # @param prefix [String] Line prefix for tree drawing
+      # @param lines [Array<String>] Accumulated output lines
+      # @param parent_task_class [Class] Parent task class (for impl selection lookup)
+      # @param ancestor_selected [Boolean] Whether all ancestor impl candidates were selected
+      def render_children(node, prefix, lines, parent_task_class, ancestor_selected)
+        children = node[:children]
+        children.each_with_index do |child, index|
+          is_last = (index == children.size - 1)
+          connector = is_last ? "└── " : "├── "
+          extension = is_last ? "    " : "│   "
+
+          child_progress = @tasks[child[:task_class]]
+
+          # Determine child's selection status
+          child_is_selected = true
+          if child[:is_impl_candidate]
+            selected_impl = @section_impl_map[parent_task_class]
+            child_is_selected = (selected_impl == child[:task_class])
+          end
+          # Propagate ancestor selection state
+          child_effective_selected = ancestor_selected && child_is_selected
+
+          child_line = format_tree_line(
+            child[:task_class],
+            child_progress,
+            child[:is_impl_candidate],
+            child_effective_selected
+          )
+          lines << "#{prefix}#{COLORS[:tree]}#{connector}#{COLORS[:reset]}#{child_line}"
+
+          if child[:children].any?
+            render_children(child, "#{prefix}#{COLORS[:tree]}#{extension}#{COLORS[:reset]}", lines, child[:task_class], child_effective_selected)
+          end
+        end
+      end
+
+      def format_tree_line(task_class, progress, is_impl, is_selected)
+        return format_unknown_task(task_class, is_selected) unless progress
+
+        type_label = type_label_for(task_class, is_selected)
+        impl_prefix = is_impl ? "#{COLORS[:impl]}[impl]#{COLORS[:reset]} " : ""
+
+        # Handle unselected nodes (either impl candidates or children of unselected impl)
+        # Show dimmed regardless of task state since they belong to unselected branch
+        unless is_selected
+          name = "#{COLORS[:dim]}#{task_class.name}#{COLORS[:reset]}"
+          suffix = is_impl ? " #{COLORS[:dim]}(not selected)#{COLORS[:reset]}" : ""
+          return "#{COLORS[:dim]}#{ICONS[:skipped]}#{COLORS[:reset]} #{impl_prefix}#{name} #{type_label}#{suffix}"
+        end
+
+        status_icon = task_status_icon(progress.state, is_selected)
+        name = "#{COLORS[:name]}#{task_class.name}#{COLORS[:reset]}"
+        details = task_details(progress)
+
+        "#{status_icon} #{impl_prefix}#{name} #{type_label}#{details}"
+      end
+
+      def format_unknown_task(task_class, is_selected = true)
+        if is_selected
+          name = "#{COLORS[:name]}#{task_class.name}#{COLORS[:reset]}"
+          type_label = type_label_for(task_class, true)
+          "#{COLORS[:pending]}#{ICONS[:pending]}#{COLORS[:reset]} #{name} #{type_label}"
+        else
+          name = "#{COLORS[:dim]}#{task_class.name}#{COLORS[:reset]}"
+          type_label = type_label_for(task_class, false)
+          "#{COLORS[:dim]}#{ICONS[:skipped]}#{COLORS[:reset]} #{name} #{type_label}"
+        end
+      end
+
+      def task_status_icon(state, is_selected)
+        # If not selected (either direct impl candidate or child of unselected), show skipped
+        unless is_selected
+          return "#{COLORS[:dim]}#{ICONS[:skipped]}#{COLORS[:reset]}"
+        end
+
+        case state
+        when :completed
+          "#{COLORS[:success]}#{ICONS[:completed]}#{COLORS[:reset]}"
+        when :failed
+          "#{COLORS[:error]}#{ICONS[:failed]}#{COLORS[:reset]}"
+        when :running
+          "#{COLORS[:running]}#{spinner_char}#{COLORS[:reset]}"
+        else
+          "#{COLORS[:pending]}#{ICONS[:pending]}#{COLORS[:reset]}"
+        end
+      end
+
+      def spinner_char
+        SPINNER_FRAMES[@spinner_index % SPINNER_FRAMES.length]
+      end
+
+      def type_label_for(task_class, is_selected = true)
+        if section_class?(task_class)
+          is_selected ? "#{COLORS[:section]}(Section)#{COLORS[:reset]}" : "#{COLORS[:dim]}(Section)#{COLORS[:reset]}"
+        else
+          is_selected ? "#{COLORS[:task]}(Task)#{COLORS[:reset]}" : "#{COLORS[:dim]}(Task)#{COLORS[:reset]}"
+        end
+      end
+
+      def task_details(progress)
+        case progress.state
+        when :completed
+          " #{COLORS[:success]}(#{progress.duration}ms)#{COLORS[:reset]}"
+        when :failed
+          " #{COLORS[:error]}(failed)#{COLORS[:reset]}"
+        when :running
+          elapsed = ((Time.now - progress.start_time) * 1000).round(0)
+          " #{COLORS[:running]}(#{elapsed}ms)#{COLORS[:reset]}"
+        else
+          ""
+        end
+      end
+
+      def section_class?(klass)
+        self.class.section_class?(klass)
+      end
+
+      def nested_class?(child_class, parent_class)
+        self.class.nested_class?(child_class, parent_class)
+      end
+    end
+  end
+end

data/lib/taski/section.rb

@@ -9,6 +9,13 @@ module Taski
       def interfaces(*interface_methods)
         exports(*interface_methods)
       end
+
+      # Section does not have static dependencies for execution.
+      # The impl method is called at runtime to determine the actual implementation.
+      # Static dependencies (impl candidates) are only used for tree display and circular detection.
+      def cached_dependencies
+        Set.new
+      end
     end
 
     def run
@@ -17,6 +24,9 @@ module Taski
         raise "Section #{self.class} does not have an implementation. Override 'impl' method."
       end
 
+      # Register selected impl for progress display
+      register_impl_selection(implementation_class)
+
       apply_interface_to_implementation(implementation_class)
 
       self.class.exported_methods.each do |method|
@@ -33,6 +43,13 @@ module Taski
 
     private
 
+    def register_impl_selection(implementation_class)
+      progress = Taski.progress_display
+      return unless progress.is_a?(Execution::TreeProgressDisplay)
+
+      progress.register_section_impl(self.class, implementation_class)
+    end
+
     # @param implementation_class [Class] The implementation task class
     def apply_interface_to_implementation(implementation_class)
       interface_methods = self.class.exported_methods

data/lib/taski/static_analysis/analyzer.rb

@@ -6,8 +6,17 @@ require_relative "visitor"
 module Taski
   module StaticAnalysis
     class Analyzer
+      # Analyzes a task class and returns its static dependencies.
+      # For Task: dependencies detected from run method and called methods (SomeTask.method calls)
+      # For Section: impl candidates detected from impl method and called methods (constants returned)
+      #
+      # Static dependencies are used for:
+      # - Tree display visualization
+      # - Circular dependency detection
+      # - Task execution (for Task only; Section resolves impl at runtime)
+      #
       # @param task_class [Class] The task class to analyze
-      # @return [Set<Class>] Set of task classes that are dependencies
+      # @return [Set<Class>] Set of task classes that are static dependencies
       def self.analyze(task_class)
         target_method = target_method_for(task_class)
         source_location = extract_method_location(task_class, target_method)
@@ -18,6 +27,8 @@ module Taski
 
         visitor = Visitor.new(task_class, target_method)
         visitor.visit(parse_result.value)
+        # Follow method calls to analyze dependencies in called methods
+        visitor.follow_method_calls
         visitor.dependencies
       end