language-operator 0.1.65 → 0.1.66

data/lib/language_operator/cli/commands/agent/code_operations.rb

@@ -4,42 +4,57 @@ module LanguageOperator
   module CLI
     module Commands
       module Agent
-        # Code viewing and editing for agents
+        # Code viewing and editing for agents using LanguageAgentVersion CRD
         module CodeOperations
           def self.included(base)
             base.class_eval do
-              desc 'code NAME', 'Display synthesized agent code'
+              desc 'code NAME', 'Display agent code from LanguageAgentVersion'
               option :cluster, type: :string, desc: 'Override current cluster context'
               option :raw, type: :boolean, default: false, desc: 'Output raw code without formatting'
+              option :version, type: :string, desc: 'Display specific version (e.g., --version=2)'
               def code(name)
                 handle_command_error('get code') do
                   require_relative '../../formatters/code_formatter'
 
                   ctx = CLI::Helpers::ClusterContext.from_options(options)
 
-                  # Get the code ConfigMap for this agent
-                  configmap_name = "#{name}-code"
-                  begin
-                    configmap = ctx.client.get_resource('ConfigMap', configmap_name, ctx.namespace)
-                  rescue K8s::Error::NotFound
-                    Formatters::ProgressFormatter.error("Synthesized code not found for agent '#{name}'")
+                  # Get the LanguageAgentVersion resource
+                  version_resource = get_agent_version_resource(ctx, name, options[:version])
+
+                  unless version_resource
+                    Formatters::ProgressFormatter.error("No code versions found for agent '#{name}'")
                     puts
-                    puts 'Possible reasons:'
-                    puts '  - Agent synthesis not yet complete'
+                    puts 'This may indicate:'
+                    puts '  - Agent has not been synthesized yet'
                     puts '  - Agent synthesis failed'
                     puts
-                    puts 'Check synthesis status with:'
+                    puts 'Check agent status with:'
                     puts "  aictl agent inspect #{name}"
                     exit 1
                   end
 
-                  # Get the agent.rb code from the ConfigMap
-                  code_content = configmap.dig('data', 'agent.rb')
+                  # Get code from LanguageAgentVersion spec
+                  code_content = version_resource.dig('spec', 'code')
                   unless code_content
-                    Formatters::ProgressFormatter.error('Code content not found in ConfigMap')
+                    Formatters::ProgressFormatter.error('Code content not found in LanguageAgentVersion')
                     exit 1
                   end
 
+                  # Determine version info for title
+                  version_num = version_resource.dig('spec', 'version')
+                  source_type = version_resource.dig('spec', 'sourceType') || 'manual'
+                  
+                  title = if options[:version]
+                            "Code for Agent: #{name} (Version #{version_num})"
+                          else
+                            active_version = get_active_version(ctx, name)
+                            if version_num.to_s == active_version
+                              "Current Code for Agent: #{name} (Version #{version_num} - #{source_type})"
+                            else
+                              "Code for Agent: #{name} (Version #{version_num} - #{source_type})"
+                            end
+                          end
+
                   # Raw output mode - just print the code
                   if options[:raw]
                     puts code_content
@@ -49,11 +64,137 @@ module LanguageOperator
                   # Display with syntax highlighting
                   Formatters::CodeFormatter.display_ruby_code(
                     code_content,
-                    title: "Synthesized Code for Agent: #{name}"
+                    title: title
                   )
                 end
               end
 
+              desc 'versions NAME', 'List available LanguageAgentVersion resources'
+              option :cluster, type: :string, desc: 'Override current cluster context'
+              def versions(name)
+                handle_command_error('list versions') do
+                  ctx = CLI::Helpers::ClusterContext.from_options(options)
+
+                  # Get agent to verify it exists
+                  get_resource_or_exit(Constants::RESOURCE_AGENT, name)
+
+                  # Find all LanguageAgentVersion resources for this agent
+                  versions = ctx.client.list_resources(Constants::RESOURCE_AGENT_VERSION, namespace: ctx.namespace)
+                                      .select { |v| v.dig('spec', 'agentRef', 'name') == name }
+                                      .sort_by { |v| v.dig('spec', 'version').to_i }
+
+                  if versions.empty?
+                    puts
+                    puts "No LanguageAgentVersion resources found for agent: #{pastel.bold(name)}"
+                    puts
+                    puts pastel.yellow('No versions have been created yet.')
+                    puts
+                    puts 'Versions are created automatically during agent synthesis.'
+                    puts "Check agent status: #{pastel.dim("aictl agent inspect #{name}")}"
+                    return
+                  end
+
+                  # Get current active version
+                  active_version = get_active_version(ctx, name)
+
+                  # Build table data
+                  table_data = versions.map do |version_resource|
+                    version_num = version_resource.dig('spec', 'version').to_s
+                    status = version_num == active_version ? 'current' : 'available'
+                    source_type = version_resource.dig('spec', 'sourceType') || 'manual'
+                    created = version_resource.dig('metadata', 'creationTimestamp')
+                    created = created ? Time.parse(created).strftime('%Y-%m-%d %H:%M') : 'Unknown'
+
+                    {
+                      version: "v#{version_num}",
+                      status: status,
+                      type: source_type.capitalize,
+                      created: created
+                    }
+                  end
+
+                  # Display table
+                  headers = %w[VERSION STATUS TYPE CREATED]
+                  rows = table_data.map do |row|
+                    status_indicator = row[:status] == 'current' ? pastel.green('●') : pastel.dim('○')
+                    status_text = row[:status] == 'current' ? pastel.green('current') : 'available'
+
+                    [
+                      row[:version],
+                      "#{status_indicator} #{status_text}",
+                      row[:type],
+                      row[:created]
+                    ]
+                  end
+
+                  puts
+                  puts "Code versions for agent: #{pastel.bold(name)}"
+                  puts
+                  puts table(headers, rows)
+                  puts
+                  puts 'Usage:'
+                  puts "  #{pastel.dim("aictl agent code #{name}")}"
+                  puts "  #{pastel.dim("aictl agent code #{name} --version=X")}"
+                end
+              end
+
+              private
+
+              def get_active_version(ctx, agent_name)
+                begin
+                  agent = ctx.client.get_resource(Constants::RESOURCE_AGENT, agent_name, ctx.namespace)
+                  version_ref = agent.dig('spec', 'agentVersionRef', 'name')
+                  return nil unless version_ref
+
+                  # Extract version number from "agent-name-vX" format
+                  version_ref.split('-v').last
+                rescue K8s::Error::NotFound
+                  nil
+                end
+              end
+
+              def get_agent_version_resource(ctx, agent_name, requested_version = nil)
+                # Query LanguageAgentVersion resources for this agent
+                versions = ctx.client.list_resources(Constants::RESOURCE_AGENT_VERSION, namespace: ctx.namespace)
+                                    .select { |v| v.dig('spec', 'agentRef', 'name') == agent_name }
+
+                if versions.empty?
+                  return nil
+                end
+
+                if requested_version
+                  # Find specific version
+                  target_version = versions.find { |v| v.dig('spec', 'version').to_s == requested_version }
+                  
+                  unless target_version
+                    Formatters::ProgressFormatter.error("Version #{requested_version} not found for agent '#{agent_name}'")
+                    puts
+                    puts 'Available versions:'
+                    versions.each do |v|
+                      version_num = v.dig('spec', 'version')
+                      puts "  v#{version_num}"
+                    end
+                    puts
+                    puts "Use 'aictl agent versions #{agent_name}' to see all available versions"
+                    exit 1
+                  end
+
+                  return target_version
+                else
+                  # Get currently active version
+                  active_version = get_active_version(ctx, agent_name)
+                  
+                  if active_version
+                    # Find the currently active version resource
+                    active_version_resource = versions.find { |v| v.dig('spec', 'version').to_s == active_version }
+                    return active_version_resource if active_version_resource
+                  end
+
+                  # Fall back to latest version if no active version or active version not found
+                  return versions.max_by { |v| v.dig('spec', 'version').to_i }
+                end
+              end
+
               desc 'edit NAME', 'Edit agent instructions'
               option :cluster, type: :string, desc: 'Override current cluster context'
               def edit(name)
@@ -99,4 +240,4 @@ module LanguageOperator
       end
     end
   end
-end
+end

data/lib/language_operator/cli/errors/suggestions.rb

@@ -51,7 +51,7 @@ module LanguageOperator
           def agent_not_found_suggestions(context)
             suggestions = []
             suggestions << "List all agents: #{pastel.dim('aictl agent list')}"
-            suggestions << "Create a new agent: #{pastel.dim('aictl agent create \"description\"')}"
+            suggestions << "Create a new agent: #{pastel.dim('aictl agent create "description"')}"
             suggestions << "Use the wizard: #{pastel.dim('aictl agent create --wizard')}" if context[:suggest_wizard]
             suggestions
           end

data/lib/language_operator/constants.rb

@@ -60,6 +60,7 @@ module LanguageOperator
     # Kubernetes Custom Resource Definitions (CRD) kinds
     # These replace magic strings scattered across CLI commands
     RESOURCE_AGENT = 'LanguageAgent'
+    RESOURCE_AGENT_VERSION = 'LanguageAgentVersion'
     RESOURCE_MODEL = 'LanguageModel'
     RESOURCE_TOOL = 'LanguageTool'
     RESOURCE_PERSONA = 'LanguagePersona'

data/lib/language_operator/kubernetes/client.rb

@@ -385,7 +385,7 @@ module LanguageOperator
 
       def default_api_version(kind)
         case kind.downcase
-        when 'languagecluster', 'languageagent', 'languagetool', 'languagemodel', 'languageclient', 'languagepersona'
+        when 'languagecluster', 'languageagent', 'languageagentversion', 'languagetool', 'languagemodel', 'languageclient', 'languagepersona'
           'langop.io/v1alpha1'
         when 'namespace', 'configmap', 'secret', 'service'
           'v1'

data/lib/language_operator/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LanguageOperator
-  VERSION = '0.1.65'
+  VERSION = '0.1.66'
 end

data/synth/003/Makefile

@@ -10,24 +10,34 @@ create:
 run:
 	@JOB_NAME=$(AGENT)-$(shell date +%s); \
 	kubectl create job --from=cronjob/$(AGENT) $$JOB_NAME && \
-	trap "kubectl delete job $$JOB_NAME" EXIT; \
 	kubectl wait --for=condition=ready pod -l job-name=$$JOB_NAME --timeout=60s && \
-	kubectl logs -f job/$$JOB_NAME
+	kubectl logs -f job/$$JOB_NAME && \
+	sleep 15 && \
+	kubectl delete job $$JOB_NAME
 
 code:
 	$(AICTL) code $(AGENT)
 
+versions:
+	$(AICTL) versions $(AGENT)
+
 inspect:
 	$(AICTL) inspect $(AGENT)
 
 learning-status:
 	$(AICTL) learning status $(AGENT)
 
+learn:
+	kubectl patch languageagent $(AGENT) --type='merge' -p='{"status":{"runsPendingLearning":10}}'
+
+
 logs:
 	$(AICTL) logs $(AGENT)
 
 clean:
 	$(AICTL) delete $(AGENT) --force
+	kubectl delete configmaps -l app.kubernetes.io/name=$(AGENT) --ignore-not-found=true
+	kubectl delete configmaps --field-selector metadata.name~=$(AGENT)-v --ignore-not-found=true
 
 save:
 	$(AICTL) code $(AGENT) --raw > agent.rb

data/synth/003/agent.txt

@@ -1 +1 @@
-Write a story one sentence at a time, with one new sentence every hour.
+Write a story one sentence at a time, with one new sentence every 10 minutes.

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: language-operator
 version: !ruby/object:Gem::Version
-  version: 0.1.65
+  version: 0.1.66
 platform: ruby
 authors:
 - James Ryan
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-12-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mcp
@@ -502,6 +502,7 @@ files:
 - docs/constraints.md
 - docs/how-agents-work.md
 - docs/installation.md
+- docs/observability.md
 - docs/quickstart.md
 - docs/schema-versioning.md
 - docs/understanding-generated-code.md
@@ -533,7 +534,6 @@ files:
 - lib/language_operator/cli/commands/agent/helpers/cluster_llm_client.rb
 - lib/language_operator/cli/commands/agent/helpers/code_parser.rb
 - lib/language_operator/cli/commands/agent/helpers/synthesis_watcher.rb
-- lib/language_operator/cli/commands/agent/learning.rb
 - lib/language_operator/cli/commands/agent/lifecycle.rb
 - lib/language_operator/cli/commands/agent/logs.rb
 - lib/language_operator/cli/commands/agent/workspace.rb
@@ -649,8 +649,6 @@ files:
 - synth/002/output.log
 - synth/003/Makefile
 - synth/003/README.md
-- synth/003/agent.optimized.rb
-- synth/003/agent.synthesized.rb
 - synth/003/agent.txt
 - synth/004/Makefile
 - synth/004/README.md
@@ -678,7 +676,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.6.6
 specification_version: 4
 summary: Ruby SDK for Language Operator
 test_files: []