rakit 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f6c23b7ddfc9bc502482e836f739cf44d6c5259d5f4b33f38bde0583572bc870
-  data.tar.gz: 9c5266364d1f0e1a5e6c0674c1d33f24e2848698d095e7dc30274b0a25fcd91c
+  metadata.gz: d44a8bebc79f4a4234f06fc398f870786dee8bc9b6eb290ad217c69fadc4da4f
+  data.tar.gz: b36d1f72c8e9378ce5cb45c6876aad1deb7e2896c90e58a959692c3b0e5557d5
 SHA512:
-  metadata.gz: 86944bd681c3fdcde105dca0b09be9b0bce798af6ebd2fcd965be12951c024c882899d220f5c7fec3fa343363237c570e52a6be2325e5726f0f057d96f615e0d
-  data.tar.gz: 300ffd474942c4f366c48532a11414230ed86c91c825473b89c8385695100c5132807508ef60111d78bc5796c3207b511f2cff22299fbc7ebfd1e1f2bd1a1e34
+  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

@@ -0,0 +1,417 @@
+# frozen_string_literal: true
+
+# Azure DevOps Pipelines API: pipeline status.
+# Requires: AZURE_DEVOPS_ORG, AZURE_DEVOPS_PROJECT, AZURE_DEVOPS_PIPELINE_ID, AZURE_DEVOPS_TOKEN (PAT with Build Read).
+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
+      # 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 (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 _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
+          unless run
+            return _pipeline_status_new(success: false, errors: ["No pipeline run found"], warnings: [])
+          end
+
+          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?)
+
+          _pipeline_status_new(success: success, errors: errors_list, warnings: warnings_list)
+        rescue StandardError => e
+          _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)
+          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)
+          uri = _base_uri(org, project, path)
+          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 _list_runs(org, project, pipeline_id, token, top: 10)
+          data = _get(org, project, token, "pipelines/#{pipeline_id}/runs")
+          (data["value"] || []).first(top)
+        end
+
+        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")
+
+          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)
+
+          timeline["records"]
+            .select { |r| r["result"]&.downcase == "failed" }
+            .map do |r|
+              {
+                "name" => r["name"] || r["identifier"] || "Unknown",
+                "type" => r["type"],
+                "result" => r["result"],
+                "issues" => (r["issues"] || []).map { |i| { "type" => i["type"], "message" => i["message"] } }
+              }
+            end
+        end
+
+        def _format_failed_steps(failures)
+          return "" if failures.nil? || failures.empty?
+
+          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)
+          return [] unless timeline && timeline["records"].is_a?(Array)
+
+          timeline["records"].each_with_object([]) do |r, out|
+            next unless r["issues"].is_a?(Array)
+
+            warn_issues = r["issues"].select { |i| i["type"]&.downcase&.include?("warning") }
+            next if warn_issues.empty?
+
+            out << {
+              "name" => r["name"] || r["identifier"] || "Unknown",
+              "issues" => warn_issues.map { |i| { "type" => i["type"], "message" => i["message"] } }
+            }
+          end
+        end
+
+        def _format_warnings(warnings)
+          return "" if warnings.nil? || warnings.empty?
+
+          warnings.flat_map do |w|
+            (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
+end

data/lib/rakit/ruby_gems.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Rakit
+  module RubyGems
+    # Bump the last digit of the version in the gemspec file (e.g. "0.1.0" -> "0.1.1").
+    # Writes the file in place. Returns the new version string.
+    def self.bump(gemspec_path)
+      content = File.read(gemspec_path)
+      content.sub!(/^(\s*s\.version\s*=\s*["'])([\d.]+)(["'])/) do
+        segs = Regexp.last_match(2).split(".")
+        segs[-1] = (segs[-1].to_i + 1).to_s
+        "#{Regexp.last_match(1)}#{segs.join('.')}#{Regexp.last_match(3)}"
+      end or raise "No s.version line found in #{gemspec_path}"
+      File.write(gemspec_path, content)
+      content[/s\.version\s*=\s*["']([^"']+)["']/, 1]
+    end
+
+    def self.version_published?(name, version)
+      require "net/http"
+      require "uri"
+      uri = URI("https://rubygems.org/api/v2/rubygems/#{URI::DEFAULT_PARSER.escape(name)}/versions/#{URI::DEFAULT_PARSER.escape(version)}.json")
+      response = Net::HTTP.get_response(uri)
+      response.is_a?(Net::HTTPSuccess)
+    rescue StandardError
+      false
+    end
+
+    # Publish the .gem at gem_path to rubygems.org. If that version is already
+    # published, warns and returns without pushing. Raises if the file is missing
+    # or if gem push fails.
+    def self.publish(gem_path)
+      raise "Gem not found: #{gem_path}. Run rake package first." unless File.file?(gem_path)
+
+      base = File.basename(gem_path, ".gem")
+      parts = base.split("-")
+      version = parts.pop
+      name = parts.join("-")
+
+      if version_published?(name, version)
+        warn "publish: Version #{version} of #{name} is already published on rubygems.org. Skipping push. Bump the version in the gemspec to publish again."
+        return
+      end
+
+      success = system("gem", "push", gem_path)
+      raise "gem push failed" unless success
+    end
+  end
+end

data/lib/rakit.rb

@@ -1,8 +1,13 @@
 # frozen_string_literal: true
 
+require "json"
+
 # rakit: common development tasks for a Rakefile
 module Rakit
   def self.hello
     "Rakit hello"
   end
 end
+
+require_relative "rakit/ruby_gems"
+require_relative "rakit/azure/dev_ops"

metadata

@@ -1,20 +1,81 @@
 --- !ruby/object:Gem::Specification
 name: rakit
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - rakit
 bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
-dependencies: []
+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
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.25'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.25'
+- !ruby/object:Gem::Dependency
+  name: grpc-tools
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.72'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.72'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13'
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- lib/generated/azure.devops_pb.rb
+- lib/generated/example_pb.rb
 - lib/rakit.rb
-licenses: []
+- lib/rakit/azure/dev_ops.rb
+- lib/rakit/ruby_gems.rb
+licenses:
+- MIT
 metadata: {}
 rdoc_options: []
 require_paths: