language-operator 0.1.31 → 0.1.36

data/lib/language_operator/dsl/workflow_definition.rb

@@ -1,259 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../logger'
-require_relative '../loggable'
-
-module LanguageOperator
-  module Dsl
-    # Workflow definition for agent execution
-    #
-    # Defines a series of steps that an agent executes to achieve objectives.
-    # Steps can depend on other steps, call tools, or perform LLM processing.
-    #
-    # @example Define a workflow
-    #   workflow do
-    #     step :search do
-    #       tool "web_search"
-    #       params query: "latest news"
-    #     end
-    #
-    #     step :summarize do
-    #       depends_on :search
-    #       prompt "Summarize: {search.output}"
-    #     end
-    #   end
-    class WorkflowDefinition
-      include LanguageOperator::Loggable
-
-      attr_reader :steps, :step_order
-
-      def initialize
-        @steps = {}
-        @step_order = []
-      end
-
-      # Define a workflow step
-      #
-      # @param name [Symbol] Step name
-      # @param tool [String, nil] Tool to use (optional)
-      # @param params [Hash] Tool parameters (optional)
-      # @param depends_on [Symbol, Array<Symbol>] Dependencies (optional)
-      # @yield Step definition block
-      # @return [void]
-      def step(name, tool: nil, params: {}, depends_on: nil, &block)
-        step_def = StepDefinition.new(name, logger: @logger)
-
-        if tool
-          step_def.tool(tool)
-          step_def.params(params) unless params.empty?
-        end
-
-        step_def.depends_on(depends_on) if depends_on
-
-        step_def.instance_eval(&block) if block
-        @steps[name] = step_def
-        @step_order << name
-      end
-
-      # Execute the workflow
-      #
-      # @param context [Object] Execution context
-      # @return [Hash] Results from each step
-      def execute(context = nil)
-        results = {}
-
-        logger.info('Executing workflow', step_count: @steps.size)
-
-        @step_order.each do |step_name|
-          step_def = @steps[step_name]
-
-          # Check dependencies
-          if step_def.dependencies.any?
-            logger.debug('Checking dependencies',
-                         step: step_name,
-                         dependencies: step_def.dependencies)
-            step_def.dependencies.each do |dep|
-              next if results.key?(dep)
-
-              logger.error('Dependency not satisfied',
-                           step: step_name,
-                           missing_dependency: dep)
-              raise "Step #{step_name} depends on #{dep}, but #{dep} has not been executed"
-            end
-          end
-
-          # Execute step
-          logger.info('Executing step',
-                      step: step_name,
-                      tool: step_def.tool_name,
-                      has_prompt: !step_def.prompt_template.nil?)
-
-          result = logger.timed('Step execution') do
-            step_def.execute(results, context)
-          end
-
-          results[step_name] = result
-          logger.info('Step completed', step: step_name)
-        end
-
-        logger.info('Workflow execution completed', total_steps: @steps.size)
-        results
-      end
-
-      private
-
-      def logger_component
-        'Workflow'
-      end
-    end
-
-    # Individual step definition
-    class StepDefinition
-      include LanguageOperator::Loggable
-
-      attr_reader :name, :dependencies, :tool_name, :tool_params, :prompt_template
-
-      def initialize(name, logger: nil)
-        @name = name
-        @tool_name = nil
-        @tool_params = {}
-        @prompt_template = nil
-        @dependencies = []
-        @execute_block = nil
-        @parent_logger = logger
-      end
-
-      # Set the tool to use
-      #
-      # @param name [String] Tool name
-      # @return [void]
-      def tool(name = nil)
-        return @tool_name if name.nil?
-
-        @tool_name = name
-      end
-
-      # Set tool parameters
-      #
-      # @param hash [Hash] Parameters
-      # @return [Hash] Current parameters
-      def params(hash = nil)
-        return @tool_params if hash.nil?
-
-        @tool_params = hash
-      end
-
-      # Set prompt template (for LLM processing)
-      #
-      # @param template [String] Prompt template
-      # @return [String] Current prompt
-      def prompt(template = nil)
-        return @prompt_template if template.nil?
-
-        @prompt_template = template
-      end
-
-      # Declare dependencies on other steps
-      #
-      # @param steps [Symbol, Array<Symbol>] Step names this depends on
-      # @return [Array<Symbol>] Current dependencies
-      def depends_on(*steps)
-        return @dependencies if steps.empty?
-
-        @dependencies = steps.flatten
-      end
-
-      # Define custom execution logic
-      #
-      # @yield Execution block
-      # @return [void]
-      def execute(&block)
-        @execute_block = block if block
-      end
-
-      # Execute this step
-      #
-      # @param results [Hash] Results from previous steps
-      # @param context [Object] Execution context
-      # @return [Object] Step result
-      def execute_step(results, context)
-        if @execute_block
-          # Custom execution logic
-          logger.debug('Executing custom logic', step: @name)
-          @execute_block.call(results, context)
-        elsif @tool_name
-          # Tool execution
-          params = interpolate_params(@tool_params, results)
-          logger.info('Calling tool',
-                      step: @name,
-                      tool: @tool_name,
-                      params: params)
-          # In real implementation, this would call the actual tool
-          "Tool #{@tool_name} executed with #{params.inspect}"
-        elsif @prompt_template
-          # LLM processing
-          prompt = interpolate_template(@prompt_template, results)
-          logger.debug('LLM prompt',
-                       step: @name,
-                       prompt: prompt[0..200])
-          # In real implementation, this would call the LLM
-          "LLM processed: #{prompt}"
-        else
-          # No-op step
-          logger.debug('No execution logic defined', step: @name)
-          nil
-        end
-      end
-
-      alias execute execute_step
-
-      private
-
-      def logger
-        @parent_logger || super
-      end
-
-      def logger_component
-        "Step:#{@name}"
-      end
-
-      # Interpolate parameters with results from previous steps
-      #
-      # @param params [Hash] Parameter template
-      # @param results [Hash] Previous results
-      # @return [Hash] Interpolated parameters
-      def interpolate_params(params, results)
-        params.transform_values do |value|
-          if value.is_a?(String) && value.match?(/\{(\w+)\.(\w+)\}/)
-            # Replace {step.field} with actual value
-            value.gsub(/\{(\w+)\.(\w+)\}/) do
-              step_name = Regexp.last_match(1).to_sym
-              field = Regexp.last_match(2)
-              results.dig(step_name, field) || value
-            end
-          else
-            value
-          end
-        end
-      end
-
-      # Interpolate template string with results
-      #
-      # @param template [String] Template string
-      # @param results [Hash] Previous results
-      # @return [String] Interpolated string
-      def interpolate_template(template, results)
-        template.gsub(/\{(\w+)(?:\.(\w+))?\}/) do
-          step_name = Regexp.last_match(1).to_sym
-          field = Regexp.last_match(2)
-
-          if field
-            results.dig(step_name, field)&.to_s || "{#{step_name}.#{field}}"
-          else
-            results[step_name]&.to_s || "{#{step_name}}"
-          end
-        end
-      end
-    end
-  end
-end

data/requirements/tasks/challenge.md

@@ -1,9 +0,0 @@
-You are the public face, the user interface, of an extremely ambitious project called the Language Operator.
-
-It synthesizes code *in production* securely from any arbitrary instructions written in plain text.
-
-Read ../language-operator/README.md to understand your significance.
-
-In that light, I challenge you to ensure that we're matching that vision in quality and supporting the full power of its CRDs.
-
-Dive into this code, maybe into the language-operator itself.  What can **this gem** do better at?

data/requirements/tasks/iterate.md

@@ -1,36 +0,0 @@
-# Task
-
-## Persona
-
-Adopt the [ruby-engineer](../../../requirements/personas/ruby-engineer.md) persona while executing these instructions, please.
-
-## Inputs
-
-- id int -- A GitHub issue index ID.
-
-## Background
-
-This is a early-phase project that works exclusively in main.
-Issues are found using the `gh` command for this project:
-- Owner: language-operator
-- Repository: language-operator-gem
-
-## Instructions
-
-Follow these directions closely:
-
-1. Use the ForgeJo tool to find the top issue for this repository.
-2. Investigate if it's valid, or a mis-use of the intended feature.
-3. **CRITICAL:** Switch to plan mode, and propose an implementation plan.  Await my feedback.
-4. Add your implementation plan as a comment on the issue.
-5. Implement the changes.
-6. Run existing tests, and add new ones if necessary.  Remember to include CI. Remember the linter and that bundler will fail if it's out of sync with its lockfile.
-7. **CRITICAL:** Test the actual functionality manually before committing. If it's a CLI command, run it. If it's library code, test it in the appropriate context. Never commit untested code.
-8. Commit the change and push to origin.
-9. **CRITICAL:** Halt while CI runs and await my feedback.
-10. Comment on your solution in the ForgeJo issue.
-11. Resolve the issue.
-
-## Output
-
-An implementation, test coverage, updated CI, and a closed ticket.

data/requirements/tasks/optimize.md

@@ -1,21 +0,0 @@
-
-# Task
-
-## Name
-
-Optimize
-
-## Persona
-
-Adopt the [ruby-engineer](../requirements/personas/ruby-engineer.md) persona while executing these instructions, please.
-
-## Instructions
-
-Suggest an improvement that could improve the quality of the codebase or developer experience.  Things like opportunities to reduce lines of code, DRYing up code, or eliminating dead code paths.
-
-An important thing to consider is that this code has been written by different agents with different contexts, who may not have been aware of overall patterns.  These kinds of optimizations are high priority.
-
-## Output
-
-Switch to Plan mode.
-A proposed list of three concrete optimizations.

data/requirements/tasks/tag.md

@@ -1,5 +0,0 @@
-Time to release a new version!
-
-1. Update the patch version in lib/language_operator/version.rb and re-run bundler to update the lockfile.
-2. Commit the version with the message "vX.Y.Z" and push to origin.
-3. Tag the new version and push to origin with the --tags argument.

data/test_agent_dsl.rb

@@ -1,108 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-# Quick test of the agent DSL without requiring full langop gem dependencies
-
-require_relative 'lib/langop/dsl/agent_definition'
-require_relative 'lib/langop/dsl/agent_context'
-require_relative 'lib/langop/dsl/workflow_definition'
-
-puts '=' * 70
-puts 'Agent DSL Test'
-puts '=' * 70
-puts
-
-# Create registry and context
-registry = Langop::Dsl::AgentRegistry.new
-context = Langop::Dsl::AgentContext.new(registry)
-
-# Define an agent using the DSL (this is what the operator will synthesize)
-context.agent 'kubernetes-news' do
-  description 'Daily Kubernetes news summarization agent'
-
-  # Persona (distilled by operator from LanguagePersona)
-  persona <<~PERSONA
-    You are a technical writer specializing in Kubernetes. When researching and
-    summarizing news, maintain a clear and precise tone, always cite your sources,
-    use proper technical terminology, and make complex topics accessible without
-    unnecessary jargon. Your summaries should be educational and well-structured.
-  PERSONA
-
-  # Schedule (extracted from: "once a day, preferably around lunchtime")
-  schedule '0 12 * * *'
-
-  # Objectives (extracted from instructions)
-  objectives [
-    'Search for recent Kubernetes news using web_search tool',
-    'Provide a concise summary of findings'
-  ]
-
-  # Workflow (synthesized by operator)
-  workflow do
-    step :search do
-      tool 'web_search'
-      params query: 'Kubernetes news latest'
-    end
-
-    step :summarize do
-      depends_on :search
-      prompt 'Provide a concise summary of these Kubernetes news items: {search.output}'
-    end
-  end
-
-  # Constraints (inferred by operator)
-  constraints do
-    max_iterations 20
-    timeout '5m'
-  end
-
-  # Output (inferred from workspace settings)
-  output do
-    workspace 'summaries/kubernetes-{date}.md'
-  end
-end
-
-# Retrieve and display the agent
-agent = registry.get('kubernetes-news')
-
-if agent
-  puts '✅ Agent Definition Loaded'
-  puts
-  puts "Name:         #{agent.name}"
-  puts "Description:  #{agent.description}"
-  puts "Mode:         #{agent.execution_mode}"
-  puts "Schedule:     #{agent.schedule}"
-  puts
-  puts '📋 Persona:'
-  puts agent.persona.lines.map { |l| "  #{l}" }.join
-  puts
-  puts "🎯 Objectives (#{agent.objectives.size}):"
-  agent.objectives.each_with_index do |obj, i|
-    puts "  #{i + 1}. #{obj}"
-  end
-  puts
-  puts "⚙️  Workflow Steps (#{agent.workflow.steps.size}):"
-  agent.workflow.steps.each do |name, step|
-    deps = step.dependencies.empty? ? '' : " [depends on: #{step.dependencies.join(', ')}]"
-    tool_info = step.tool ? " (tool: #{step.tool})" : ''
-    prompt_info = step.prompt ? " (prompt: #{step.prompt[0..50]}...)" : ''
-    puts "  - #{name}#{deps}#{tool_info}#{prompt_info}"
-  end
-  puts
-  puts '📊 Constraints:'
-  agent.constraints.each do |key, value|
-    puts "  #{key}: #{value}"
-  end
-  puts
-  puts '📤 Output:'
-  agent.output_config.each do |key, value|
-    puts "  #{key}: #{value}"
-  end
-  puts
-  puts '=' * 70
-  puts '✅ DSL Test Complete - Agent ready for execution!'
-  puts '=' * 70
-else
-  puts '❌ Failed to load agent'
-  exit 1
-end