rakit 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee82c70e32276dc9332649c9932aa9212e358a3dcefacec587070521982d5cae
-  data.tar.gz: d22e913a279a3ea5f4b51adc280aab7c1d303e4fd921a9c44ade41b4993471f3
+  metadata.gz: d44a8bebc79f4a4234f06fc398f870786dee8bc9b6eb290ad217c69fadc4da4f
+  data.tar.gz: b36d1f72c8e9378ce5cb45c6876aad1deb7e2896c90e58a959692c3b0e5557d5
 SHA512:
-  metadata.gz: e428b21575d78b7205df71fead16f344ab8c3316b6d6a83a2ec238d367940bfc854be84fa14400759c9c235bbdb061f3ed9e820def62be1515db909484882c79
-  data.tar.gz: 600283a6b6f4269af6e0b93a6ccd521786f65bd5c7347c17080fe1aafa8c92e86387362e9ee209995be762343fc23efc35e254a4827a1043cfd7b89cd380af3c
+  metadata.gz: 29d7c4732c1107dcc831edd0168633c47a65a128f34825875f41fc22694c9591ba6df15a53273c3bf98361bd60133cd6b8e78fc21bb0aa608acda513f02f0a6b
+  data.tar.gz: 274fffdf4ccfdeb4b9fb2774d05f6205c3dff94e9839e0d46ac28c71ffd8a0f7e30c236dc600ce88651e2551068ab4e49003b1b4bf3597c9357d0674d1249f48

data/lib/generated/azure.devops_pb.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: azure.devops.proto
+
+require 'google/protobuf'
+
+
+descriptor_data = "\n\x12\x61zure.devops.proto\x12\x0brakit.azure\"=\n\x08Pipeline\x12\x0b\n\x03org\x18\x01 \x01(\t\x12\x0f\n\x07project\x18\x02 \x01(\t\x12\x13\n\x0bpipeline_id\x18\x03 \x01(\x05\"R\n\x18GetPipelineResultRequest\x12\'\n\x08pipeline\x18\x01 \x01(\x0b\x32\x15.rakit.azure.Pipeline\x12\r\n\x05token\x18\x02 \x01(\t\"C\n\x0ePipelineStatus\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x0e\n\x06\x65rrors\x18\x02 \x03(\t\x12\x10\n\x08warnings\x18\x03 \x03(\t\"8\n\x0ePipelineResult\x12&\n\x04runs\x18\x01 \x03(\x0b\x32\x18.rakit.azure.PipelineRun\"\x97\x01\n\x0bPipelineRun\x12\n\n\x02id\x18\x01 \x01(\x05\x12\x0c\n\x04name\x18\x02 \x01(\t\x12\r\n\x05state\x18\x03 \x01(\t\x12\x0e\n\x06result\x18\x04 \x01(\t\x12\x14\n\x0c\x63reated_date\x18\x05 \x01(\t\x12\x15\n\rfinished_date\x18\x06 \x01(\t\x12\"\n\x06stages\x18\x07 \x03(\x0b\x32\x12.rakit.azure.Stage\"&\n\x05Issue\x12\x0c\n\x04type\x18\x01 \x01(\t\x12\x0f\n\x07message\x18\x02 \x01(\t\"G\n\x03Job\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0e\n\x06result\x18\x02 \x01(\t\x12\"\n\x06issues\x18\x03 \x03(\x0b\x32\x12.rakit.azure.Issue\"i\n\x05Stage\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0e\n\x06result\x18\x02 \x01(\t\x12\x1e\n\x04jobs\x18\x03 \x03(\x0b\x32\x10.rakit.azure.Job\x12\"\n\x06issues\x18\x04 \x03(\x0b\x32\x12.rakit.azure.Issue\"`\n\x0eTimelineRecord\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0c\n\x04type\x18\x02 \x01(\t\x12\x0e\n\x06result\x18\x03 \x01(\t\x12\"\n\x06issues\x18\x04 \x03(\x0b\x32\x12.rakit.azure.Issue\"\xa8\x01\n\x14PipelineResultDetail\x12\x12\n\nsuccessful\x18\x01 \x01(\x08\x12\x0e\n\x06\x65rrors\x18\x02 \x01(\t\x12\x10\n\x08warnings\x18\x03 \x01(\t\x12%\n\x03run\x18\x04 \x01(\x0b\x32\x18.rakit.azure.PipelineRun\x12\x33\n\x0e\x66\x61iled_records\x18\x05 \x03(\x0b\x32\x1b.rakit.azure.TimelineRecord2i\n\x0ePipelineServer\x12W\n\x11GetPipelineResult\x12%.rakit.azure.GetPipelineResultRequest\x1a\x1b.rakit.azure.PipelineResultB\x1a\xea\x02\x17Rakit::Azure::Generatedb\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module Rakit
+  module Azure
+    module Generated
+      Pipeline = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("rakit.azure.Pipeline").msgclass
+      GetPipelineResultRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("rakit.azure.GetPipelineResultRequest").msgclass
+      PipelineStatus = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("rakit.azure.PipelineStatus").msgclass
+      PipelineResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("rakit.azure.PipelineResult").msgclass
+      PipelineRun = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("rakit.azure.PipelineRun").msgclass
+      Issue = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("rakit.azure.Issue").msgclass
+      Job = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("rakit.azure.Job").msgclass
+      Stage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("rakit.azure.Stage").msgclass
+      TimelineRecord = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("rakit.azure.TimelineRecord").msgclass
+      PipelineResultDetail = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("rakit.azure.PipelineResultDetail").msgclass
+    end
+  end
+end

data/lib/generated/example_pb.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: example.proto
+
+require 'google/protobuf'
+
+
+descriptor_data = "\n\rexample.proto\x12\rrakit.example\"\x1c\n\x0cHelloRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\" \n\rHelloResponse\x12\x0f\n\x07message\x18\x01 \x01(\tB\x13\xea\x02\x10Rakit::Generatedb\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module Rakit
+  module Generated
+    HelloRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("rakit.example.HelloRequest").msgclass
+    HelloResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("rakit.example.HelloResponse").msgclass
+  end
+end

data/lib/rakit/azure/dev_ops.rb

@@ -6,54 +6,199 @@ require "json"
 require "net/http"
 require "uri"
 
+begin
+  require "generated/azure.devops_pb"
+rescue StandardError
+  # google-protobuf not available or version conflict (e.g. running without bundle exec)
+end
+
 module Rakit
   module Azure
     module DevOps
-      PipelineStatus = Struct.new(:successful, :errors, :warnings, keyword_init: true) do
-        def self.empty_failure(errors_message)
-          new(successful: false, errors: errors_message.to_s, warnings: "")
-        end
-      end
+      # Use generated proto PipelineStatus when available; otherwise fallback with same interface (success, errors, warnings).
+      Generated = defined?(Rakit::Azure::Generated) ? Rakit::Azure::Generated : nil
+      # Pipeline at Rakit::Azure::Pipeline: proto when generated code loaded, else Struct (org, project, pipeline_id, token).
+      Rakit::Azure.const_set(:Pipeline, Generated && Generated.const_defined?(:Pipeline) ? Generated::Pipeline : Struct.new(:org, :project, :pipeline_id, :token, keyword_init: true)) unless Rakit::Azure.const_defined?(:Pipeline)
+      PipelineStatusFallback = Struct.new(:success, :errors, :warnings, keyword_init: true)
+
+      # Value types matching proto/azure.devops.proto (for get_pipeline_result; PipelineStatus uses generated proto when loaded).
+      Issue = Struct.new(:type, :message, keyword_init: true)
+      Job = Struct.new(:name, :result, :issues, keyword_init: true)
+      Stage = Struct.new(:name, :result, :jobs, :issues, keyword_init: true)
+      PipelineRun = Struct.new(:id, :name, :state, :result, :created_date, :finished_date, :stages, keyword_init: true)
+      # Matches proto PipelineResult: runs + optional warnings (e.g. token not set).
+      PipelineResult = Struct.new(:runs, :warnings, keyword_init: true)
 
       API_VERSION = "7.1"
       BASE_URL = "https://dev.azure.com"
 
       class << self
-        # Returns the latest pipeline status.
-        # Uses ENV: AZURE_DEVOPS_ORG, AZURE_DEVOPS_PROJECT, AZURE_DEVOPS_PIPELINE_ID, AZURE_DEVOPS_TOKEN.
-        def get_pipeline_status
-          org = ENV["AZURE_DEVOPS_ORG"]
-          project = ENV["AZURE_DEVOPS_PROJECT"]
-          pipeline_id = ENV["AZURE_DEVOPS_PIPELINE_ID"]
-          token = ENV["AZURE_DEVOPS_TOKEN"]
+        # Returns the latest pipeline status (proto message PipelineStatus: success, errors, warnings).
+        # When pipeline is given, uses its org, project, pipeline_id, token (token may be an ENV var name).
+        # When pipeline is nil, uses ENV: AZURE_DEVOPS_ORG, AZURE_DEVOPS_PROJECT, AZURE_DEVOPS_PIPELINE_ID, AZURE_DEVOPS_TOKEN.
+        #
+        # @param pipeline [Object, nil] Pipeline message value (org, project, pipeline_id, token) or nil for ENV
+        # @return [PipelineStatus] success (bool), errors (repeated string), warnings (repeated string)
+        #
+        # @example
+        #   status = Rakit::Azure::DevOps.get_pipeline_status(pipeline: my_pipeline)
+        #   if status.success
+        #     puts "Pipeline passed"
+        #   else
+        #     warn "Pipeline failed: #{status.errors.join("\n")}"
+        #   end
+        def get_pipeline_status(pipeline: nil)
+          org, project, pipeline_id, token = _resolve_pipeline_config(pipeline)
 
           if [org, project, pipeline_id, token].any?(&:nil?) || [org, project, pipeline_id, token].any?(&:empty?)
-            return PipelineStatus.empty_failure(
-              "Missing config: set AZURE_DEVOPS_ORG, AZURE_DEVOPS_PROJECT, AZURE_DEVOPS_PIPELINE_ID, AZURE_DEVOPS_TOKEN"
+            return _pipeline_status_new(
+              success: false,
+              errors: [],
+              warnings: [_token_not_set_message(pipeline)]
             )
           end
 
+          if _token_unresolved?(pipeline, token)
+            return _pipeline_status_new(success: false, errors: [], warnings: [_token_not_set_message(pipeline)])
+          end
+
           run = _list_runs(org, project, pipeline_id.to_s, token).first
-          return PipelineStatus.empty_failure("No pipeline run found") unless run
+          unless run
+            return _pipeline_status_new(success: false, errors: ["No pipeline run found"], warnings: [])
+          end
 
-          timeline = _get_timeline(org, project, pipeline_id.to_s, token, run["id"])
-          successful = _run_passed?(run)
-          errors = _format_failed_steps(_failed_steps_details(timeline))
-          warnings = _format_warnings(_warning_details(timeline))
+          timeline = _get_timeline_for_run(org, project, pipeline_id.to_s, token, run)
+          success = _run_passed?(run)
+          errors_str = _format_failed_steps(_failed_steps_details(timeline))
+          errors_str = _run_result_summary(run) if errors_str.to_s.strip.empty? && !success
+          warnings_str = _format_warnings(_warning_details(timeline))
+          errors_list = errors_str.to_s.strip.empty? ? [] : errors_str.to_s.split("\n").map(&:strip).reject(&:empty?)
+          errors_list = ["(no details)"] if errors_list.empty? && !success
+          warnings_list = warnings_str.to_s.strip.empty? ? [] : warnings_str.to_s.split("\n").map(&:strip).reject(&:empty?)
 
-          PipelineStatus.new(
-            successful: successful,
-            errors: errors.to_s,
-            warnings: warnings.to_s
-          )
+          _pipeline_status_new(success: success, errors: errors_list, warnings: warnings_list)
         rescue StandardError => e
-          PipelineStatus.empty_failure("Pipeline status error: #{e.message}")
+          _pipeline_status_new(success: false, errors: ["Pipeline status error: #{e.message}"], warnings: [])
+        end
+
+        # Returns a PipelineResult (proto: only runs) for the given pipeline.
+        # For success/errors/warnings summary use get_pipeline_status.
+        # When pipeline is given, uses its org, project, pipeline_id, token (token may be an ENV var name).
+        # When pipeline is nil, uses ENV.
+        #
+        # @param pipeline [Object, nil] Pipeline message value (org, project, pipeline_id, token) or nil for ENV
+        # @return [PipelineResult] .runs (array of PipelineRun)
+        def get_pipeline_result(pipeline: nil)
+          org, project, pipeline_id, token = _resolve_pipeline_config(pipeline)
+
+          if [org, project, pipeline_id, token].any?(&:nil?) || [org, project, pipeline_id, token].any?(&:empty?)
+            return PipelineResult.new(runs: [], warnings: [_token_not_set_message(pipeline)])
+          end
+
+          if _token_unresolved?(pipeline, token)
+            return PipelineResult.new(runs: [], warnings: [_token_not_set_message(pipeline)])
+          end
+
+          run = _list_runs(org, project, pipeline_id, token).first
+          unless run
+            return PipelineResult.new(runs: [], warnings: [])
+          end
+
+          timeline = _get_timeline_for_run(org, project, pipeline_id, token, run)
+          runs = [_run_to_pipeline_run(run, timeline)]
+          PipelineResult.new(runs: runs, warnings: [])
+        rescue StandardError => _e
+          PipelineResult.new(runs: [], warnings: [])
+        end
+
+        # Converts a PipelineResult (Struct or proto) to a hash recursively for JSON.
+        # @param result [PipelineResult]
+        # @return [Hash]
+        def pipeline_result_to_h(result)
+          _to_h_deep(result)
+        end
+
+        # Returns pretty-printed JSON for a PipelineResult.
+        # @param result [PipelineResult]
+        # @return [String]
+        def pipeline_result_pretty_json(result)
+          JSON.pretty_generate(pipeline_result_to_h(result))
+        end
+
+        # Converts a PipelineStatus (Struct or proto) to a hash for JSON.
+        # @param status [PipelineStatus]
+        # @return [Hash]
+        def pipeline_status_to_h(status)
+          _to_h_deep(status)
+        end
+
+        # Returns pretty-printed JSON for a PipelineStatus.
+        # @param status [PipelineStatus]
+        # @return [String]
+        def pipeline_status_pretty_json(status)
+          JSON.pretty_generate(pipeline_status_to_h(status))
         end
 
         private
 
+        def _to_h_deep(obj)
+          case obj
+          when Struct
+            obj.to_h.transform_values { |v| _to_h_deep(v) }
+          when Array
+            obj.map { |e| _to_h_deep(e) }
+          when Hash
+            obj.transform_values { |v| _to_h_deep(v) }
+          else
+            obj.respond_to?(:to_h) ? obj.to_h.transform_values { |v| _to_h_deep(v) } : obj
+          end
+        end
+
+        def _resolve_pipeline_config(pipeline)
+          if pipeline
+            org = _attr(pipeline, :org)
+            project = _attr(pipeline, :project)
+            pipeline_id = _attr(pipeline, :pipeline_id)&.to_s
+            token_raw = _attr(pipeline, :token).to_s
+            token = token_raw.empty? ? "" : (ENV[token_raw].to_s.empty? ? token_raw : ENV[token_raw].to_s)
+            [org, project, pipeline_id, token]
+          else
+            [
+              ENV["AZURE_DEVOPS_ORG"],
+              ENV["AZURE_DEVOPS_PROJECT"],
+              ENV["AZURE_DEVOPS_PIPELINE_ID"]&.to_s,
+              ENV["AZURE_DEVOPS_TOKEN"]
+            ]
+          end
+        end
+
+        def _attr(obj, key)
+          obj.respond_to?(key) ? obj.public_send(key) : obj[key]
+        end
+
+        def _token_unresolved?(pipeline, token)
+          return true if token.to_s.strip.empty?
+          return false unless pipeline
+          token_raw = _attr(pipeline, :token).to_s
+          token_raw == token.to_s && ENV[token_raw].to_s.strip.empty?
+        end
+
+        def _token_not_set_message(pipeline)
+          name = pipeline && !_attr(pipeline, :token).to_s.empty? ? _attr(pipeline, :token).to_s : "AZURE_DEVOPS_TOKEN"
+          "Token not set (e.g. set #{name}); skipping pipeline check"
+        end
+
+        def _pipeline_status_new(success:, errors:, warnings:)
+          if Generated && Generated.const_defined?(:PipelineStatus)
+            Generated::PipelineStatus.new(success: success, errors: errors, warnings: warnings)
+          else
+            PipelineStatusFallback.new(success: success, errors: errors, warnings: warnings)
+          end
+        end
+
         def _base_uri(org, project, path)
-          URI("#{BASE_URL}/#{URI.encode_www_form_component(org)}/#{URI.encode_www_form_component(project)}/_apis/#{path}?api-version=#{API_VERSION}")
+          sep = path.include?("?") ? "&" : "?"
+          URI("#{BASE_URL}/#{URI.encode_www_form_component(org)}/#{URI.encode_www_form_component(project)}/_apis/#{path}#{sep}api-version=#{API_VERSION}")
         end
 
         def _get(org, project, token, path)
@@ -73,7 +218,46 @@ module Rakit
           (data["value"] || []).first(top)
         end
 
-        def _get_timeline(org, project, pipeline_id, token, build_id)
+        def _get_build(org, project, token, build_id)
+          _get(org, project, token, "build/builds/#{build_id}")
+        rescue StandardError => e
+          return nil if e.message.include?("404")
+
+          raise
+        end
+
+        def _resolve_build_id(org, project, token, pipeline_id, run)
+          build_id = run["id"]
+          build = _get_build(org, project, token, build_id)
+          return build_id, build if build
+
+          build_number = run["name"].to_s
+          return build_id, nil if build_number.empty?
+
+          data = _get(org, project, token, "build/builds?definitions=#{pipeline_id}&buildNumber=#{URI.encode_www_form_component(build_number)}&$top=1")
+          builds = data["value"] || []
+          first = builds.first
+          return build_id, nil unless first
+
+          resolved_id = first["id"]
+          [resolved_id, _get_build(org, project, token, resolved_id)]
+        end
+
+        def _get_timeline_for_run(org, project, pipeline_id, token, run)
+          build_id, build = _resolve_build_id(org, project, token, pipeline_id, run)
+          build ||= _get_build(org, project, token, build_id)
+          return nil unless build
+
+          timeline_url = build.dig("_links", "timeline", "href")
+          if timeline_url
+            return _get_url(URI(timeline_url), token)
+          end
+
+          plan_id = build.dig("orchestrationPlan", "planId") || build.dig("plans", 0, "planId")
+          if plan_id
+            return _get(org, project, token, "build/builds/#{build_id}/timeline/#{plan_id}")
+          end
+
           _get(org, project, token, "build/builds/#{build_id}/timeline")
         rescue StandardError => e
           return nil if e.message.include?("404")
@@ -81,10 +265,35 @@ module Rakit
           raise
         end
 
+        def _get_url(uri, token)
+          req = Net::HTTP::Get.new(uri)
+          req.basic_auth("", token)
+          req["Accept"] = "application/json"
+          resp = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
+          raise "HTTP #{resp.code}: #{resp.body}" unless resp.is_a?(Net::HTTPSuccess)
+
+          body = resp.body.to_s.strip
+          body.empty? ? {} : JSON.parse(body)
+        end
+
         def _run_passed?(run)
           run && %w[succeeded succeededwithissues].include?(run["result"]&.downcase)
         end
 
+        def _run_result_summary(run)
+          return "Pipeline run failed (no details)" unless run.is_a?(Hash)
+
+          state = run["state"].to_s
+          result = run["result"].to_s
+          name = run["name"].to_s
+          id = run["id"].to_s
+          parts = []
+          parts << "Run: #{name} (id=#{id})" if name != "" || id != ""
+          parts << "State: #{state}" if state != ""
+          parts << "Result: #{result}" if result != ""
+          parts.empty? ? "Pipeline run failed (no details)" : parts.join(", ")
+        end
+
         def _failed_steps_details(timeline)
           return [] unless timeline && timeline["records"].is_a?(Array)
 
@@ -103,11 +312,13 @@ module Rakit
         def _format_failed_steps(failures)
           return "" if failures.nil? || failures.empty?
 
-          failures.map do |f|
-            lines = ["--- #{f['name']} (#{f['type']}) ---", "  Result: #{f['result']}"]
-            (f["issues"] || []).each { |iss| lines << "  [#{iss['type']}] #{iss['message']}" }
-            lines.join("\n")
-          end.join("\n\n")
+          job_or_task = failures.select { |f| %w[job task].include?((f["type"] || "").to_s.downcase) }
+          job_or_task.map do |f|
+            type_label = (f["type"] || "").to_s.capitalize
+            lines = ["#{type_label}: #{f['name']}"]
+            (f["issues"] || []).each { |iss| lines << iss["message"].to_s.strip }
+            lines.reject(&:empty?).join("\n")
+          end.reject(&:empty?).join("\n\n")
         end
 
         def _warning_details(timeline)
@@ -133,6 +344,73 @@ module Rakit
             (w["issues"] || []).map { |iss| "  [#{w['name']}] #{iss['message']}" }
           end.join("\n")
         end
+
+        def _run_to_pipeline_run(run, timeline)
+          stages = _timeline_to_stages(timeline)
+          PipelineRun.new(
+            id: run["id"],
+            name: run["name"].to_s,
+            state: run["state"].to_s,
+            result: run["result"].to_s,
+            created_date: run["createdDate"].to_s,
+            finished_date: run["finishedDate"].to_s,
+            stages: stages
+          )
+        end
+
+        def _timeline_to_stages(timeline)
+          return [] unless timeline && timeline["records"].is_a?(Array)
+
+          records = timeline["records"]
+          # Stage or Phase: top-level container; Job (or Task): child of stage/phase
+          stage_records = records.select { |r| %w[stage phase].include?(r["type"].to_s.downcase) }
+          job_records = records.select { |r| r["type"].to_s.casecmp("job").zero? }
+          task_records = records.select { |r| r["type"].to_s.casecmp("task").zero? }
+          # Group by parent id (and parentIdentifier) so lookup works whether API uses id or identifier
+          child_by_parent = proc { |list|
+            list.each_with_object(Hash.new { |h, k| h[k] = [] }) do |r, h|
+              key = (r["parentId"] || r["parent_id"]).to_s
+              h[key] << r
+              key2 = (r["parentIdentifier"] || r["parent_identifier"]).to_s
+              h[key2] << r if key2 != key && !key2.empty?
+            end
+          }
+          jobs_by_parent = child_by_parent.call(job_records)
+          tasks_by_parent = child_by_parent.call(task_records)
+
+          stage_records.map do |sr|
+            parent_key = sr["id"].to_s
+            parent_key_alt = sr["identifier"].to_s
+            job_list = (jobs_by_parent[parent_key] || []) + (jobs_by_parent[parent_key_alt] || [])
+            # If no Job records (e.g. API uses different type or flat structure), treat Task records as jobs
+            if job_list.empty?
+              task_list = (tasks_by_parent[parent_key] || []) + (tasks_by_parent[parent_key_alt] || [])
+              job_list = task_list.uniq
+            end
+            jobs = job_list.uniq.map do |jr|
+              job_issues = _issues_from_record(jr)
+              jr_id = jr["id"].to_s
+              jr_ident = jr["identifier"].to_s
+              child_tasks = (tasks_by_parent[jr_id] || []) + (tasks_by_parent[jr_ident] || [])
+              task_issues = child_tasks.uniq.flat_map { |t| _issues_from_record(t) }
+              Job.new(
+                name: jr["name"].to_s,
+                result: jr["result"].to_s,
+                issues: job_issues + task_issues
+              )
+            end
+            Stage.new(
+              name: sr["name"].to_s,
+              result: sr["result"].to_s,
+              jobs: jobs,
+              issues: _issues_from_record(sr)
+            )
+          end
+        end
+
+        def _issues_from_record(record)
+          (record["issues"] || []).map { |i| Issue.new(type: i["type"].to_s, message: i["message"].to_s) }
+        end
       end
     end
   end

data/lib/rakit.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "json"
+
 # rakit: common development tasks for a Rakefile
 module Rakit
   def self.hello

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rakit
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - rakit
@@ -9,6 +9,20 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: google-protobuf
   requirement: !ruby/object:Gem::Requirement
@@ -55,6 +69,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- lib/generated/azure.devops_pb.rb
+- lib/generated/example_pb.rb
 - lib/rakit.rb
 - lib/rakit/azure/dev_ops.rb
 - lib/rakit/ruby_gems.rb