boringbuilder 0.1.0.alpha.3 → 0.1.0.alpha.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 823ab9ebc22d049c27671d07ea1be44315dbdf3f63cdd29c46cd209e6e5fc279
-  data.tar.gz: 58c38219ef59ff3bf7515d10140be7500784bf276f5b0ea71edd965d7ae10b86
+  metadata.gz: 265bb7643d090142fc6a68cba78809ffabf6dd3d5436e8a605d1e5e69848984c
+  data.tar.gz: ac30aa3a7160d742ce7742c4c1f86720deb5061a8c8eb85a4a6c57c7e79c7b13
 SHA512:
-  metadata.gz: 7812ac305fa0015e0007049f6272a81fcf237db37304522323bad5a7a9947ac2f6e77d9e9788cf57490c31d680c17bda5aa3cc025cc19a4b310f9711b080d907
-  data.tar.gz: 67a48f5ce9298763f588c2e979a3bcca6b1a38a9c8f9350597f82876c69168c644b480affc62728d27ad1c8d114071267fbc7592a5703446441dc385b3459357
+  metadata.gz: 1774754066715572ee3d1946642e00e07baa3b5d5f97626e04eb76b45d4e5ec6a226627e8033ead3967591082b41b2cff71cb730320df1026333495e7048ec3f
+  data.tar.gz: 391c319a4fd5e8a8c8eb634efc31f45df7bc2ecf4b2357e8a90deae236785c34dc88cdce53d1b4f154bed96950b27b8453cf4bd4e7957ae9a76d6db523c42f86

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.1.0.alpha.5 - 2026-08-28
+
+- Record the exact local or BoringCache build result for deployment tools.
+- Finalize Rails runtime metadata without starting the application command.
+- Publish each release with the matching human changelog notes.
+
+## 0.1.0.alpha.4 - 2026-08-28
+
+- Expose the Rails build task as `boring:build`.
+- Run the Rails task through the same pretty, streaming CLI experience as
+  `boringbuilder build`.
+- Keep BoringCache Artifact receipt JSON out of streamed build logs.
+
 ## 0.1.0.alpha.3 - 2026-08-27
 
 - Remove Bundler cache metadata before compiling assets so cold and restored Rails builds stay identical.

data/README.md

@@ -70,7 +70,7 @@ boringbuilder build --runtime docker --platform linux/arm64
 Rails applications can also use the included task:
 
 ```sh
-bin/rails boringbuilder:build
+bin/rails boring:build
 ```
 
 ## Caching
@@ -85,7 +85,8 @@ See [Caching](docs/caching.md) for custom cached steps and restore-only builds.
 
 The default `tar.zst` output is intended for atomic filesystem deployers such as BoringDeploy. Without shared
 credentials it is written under `dist/`. With BoringCache save credentials it is published as a shared BoringCache
-Artifact instead; pass `--output` when a local copy is also wanted.
+Artifact instead; pass `--output` when a local copy is also wanted. Each successful export records its exact result in
+`tmp/builds/boringbuilder.json` so deployment tools can consume the same artifact without guessing.
 
 The same build can produce or publish a container image:
 

data/lib/boringbuilder/build_receipt.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "json"
+require "open3"
+require "pathname"
+require "tempfile"
+require "time"
+
+module BoringBuilder
+  class BuildReceipt
+    RELATIVE_PATH = "tmp/builds/boringbuilder.json"
+
+    def self.write(root:, result:, clock: Time, command_runner: Open3.method(:capture3))
+      return unless result.exported? || result.artifact_published? || result.published?
+
+      root = Pathname.new(root).expand_path
+      path = root.join(RELATIVE_PATH)
+      FileUtils.mkdir_p(path.dirname)
+      document = {
+        schema_version: 1,
+        created_at: clock.now.utc.iso8601,
+        source_revision: source_revision(root, command_runner),
+        result: result.to_h
+      }
+
+      Tempfile.create(["boringbuilder", ".json"], path.dirname) do |file|
+        file.write(JSON.pretty_generate(document))
+        file.write("\n")
+        file.flush
+        file.fsync
+        File.rename(file.path, path)
+      end
+
+      path
+    end
+
+    def self.source_revision(root, command_runner)
+      stdout, _stderr, status = command_runner.call("git", "-C", root.to_s, "rev-parse", "HEAD")
+      status.success? ? stdout.strip : nil
+    rescue Errno::ENOENT
+      nil
+    end
+
+    private_class_method :source_revision
+  end
+end

data/lib/boringbuilder/builder.rb

@@ -21,10 +21,12 @@ module BoringBuilder
         silent: configuration.progress.nil?
       )
 
-      DaggerRuby.connection(dagger_configuration) do |client|
+      result = DaggerRuby.connection(dagger_configuration) do |client|
         container = project.container(client, progress: progress)
         Exporter.new(project, client, container, runtime: resolved_runtime, progress: progress).call
       end
+      BuildReceipt.write(root: configuration.root, result: result)
+      result
     rescue DaggerRuby::DaggerError => e
       message = e.message.sub(/\s*\[traceparent:[^\]]+\]\s*\z/, "")
       raise BuildError, "Dagger build failed: #{message}"

data/lib/boringbuilder/exporters/boring_cache.rb

@@ -5,6 +5,8 @@ require "json"
 module BoringBuilder
   module Exporters
     class BoringCache
+      RECEIPT_PATH = "/tmp/boringbuilder-artifact.json"
+
       attr_reader :project, :client, :cache
 
       def initialize(project, client, environment: ENV)
@@ -31,7 +33,8 @@ module BoringBuilder
         publisher = client.container.from(cache.cli_image)
         publisher = cache.prepare_artifact_publisher(publisher)
         path, publisher = mount_asset(publisher, asset)
-        output = publisher.with_exec(publish_command(path, asset.kind)).stdout
+        publisher = publisher.with_exec(quiet_publish_command(path, asset.kind))
+        output = publisher.file(RECEIPT_PATH).contents
         artifact = JSON.parse(output).fetch("artifact")
         validate_artifact!(artifact)
         Receipt.new(artifact_id: artifact.fetch("id"), artifact_name: artifact.fetch("name"))
@@ -73,6 +76,10 @@ module BoringBuilder
         command
       end
 
+      def quiet_publish_command(path, kind)
+        ["sh", "-c", "exec \"$@\" > #{RECEIPT_PATH}", "boringbuilder-artifact", *publish_command(path, kind)]
+      end
+
       def validate_artifact!(artifact)
         return if artifact.fetch("id", "").start_with?("art_") && artifact.fetch("status", nil) == "ready"
 

data/lib/boringbuilder/railtie.rb

@@ -3,7 +3,7 @@
 module BoringBuilder
   class Railtie < Rails::Railtie
     rake_tasks do
-      load File.expand_path("tasks/boringbuilder.rake", __dir__)
+      load File.expand_path("tasks/boring.rake", __dir__)
     end
   end
 end

data/lib/boringbuilder/release_notes.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module BoringBuilder
+  class ReleaseNotes
+    def self.read(path:, version:)
+      sections = File.read(path).lines
+      heading = /^## #{Regexp.escape(version)} - \d{4}-\d{2}-\d{2}\s*$/
+      start = sections.index { |line| line.match?(heading) }
+      raise ArgumentError, "CHANGELOG.md has no release notes for #{version}" unless start
+
+      finish = sections.each_index.find { |index| index > start && sections[index].start_with?("## ") }
+      notes = sections[(start + 1)...finish].join.strip
+      raise ArgumentError, "CHANGELOG.md release notes for #{version} are empty" if notes.empty?
+
+      notes
+    end
+  end
+end

data/lib/boringbuilder/ruby_build.rb

@@ -173,8 +173,9 @@ module BoringBuilder
         name: "[runtime] RUN mise reshim",
         workdir: application_path
       )
-      container = runtime_metadata(container).with_user(project.application_user)
-      progress.step("[runtime] Configure image") { container.sync }
+      container = container.with_user(project.application_user)
+      container = progress.step("[runtime] Configure image") { container.sync }
+      runtime_metadata(container)
     end
 
     def install_packages(container, packages, stage:)

data/lib/boringbuilder/tasks/boring.rake

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+namespace :boring do
+  desc "Build the Rails application with Dagger"
+  task build: :environment do
+    command = ["build"]
+    {
+      "--runtime" => "BORINGBUILDER_RUNTIME",
+      "--platform" => "BORINGBUILDER_PLATFORM",
+      "--format" => "BORINGBUILDER_FORMAT",
+      "--output" => "BORINGBUILDER_OUTPUT",
+      "--push" => "BORINGBUILDER_PUSH",
+      "--load" => "BORINGBUILDER_LOAD",
+      "--progress" => "BORINGBUILDER_PROGRESS",
+      "--exporter" => "BORINGBUILDER_EXPORTER",
+      "--artifact-name" => "BORINGBUILDER_ARTIFACT_NAME"
+    }.each do |option, environment_name|
+      value = ENV.fetch(environment_name, nil)
+      command.push(option, value) if value && !value.empty?
+    end
+
+    {
+      "--path" => "BORINGBUILDER_PATHS",
+      "--file" => "BORINGBUILDER_FILES",
+      "--host-path" => "BORINGBUILDER_HOST_PATHS"
+    }.each do |option, environment_name|
+      values = ENV.fetch(environment_name, "").split(",").reject(&:empty?)
+      values.each { |value| command.push(option, value) }
+    end
+
+    command << Rails.root.to_s
+    status = BoringBuilder::CLI.start(command)
+    raise BoringBuilder::BuildError, "BoringBuilder exited unsuccessfully" unless status.zero?
+  end
+
+  desc "Check the configured container runtime"
+  task :doctor do
+    requested = ENV.fetch("BORINGBUILDER_RUNTIME", "auto")
+    runtime = BoringBuilder::Runtime.new(requested).resolve
+    puts "Dagger runtime ready: #{runtime}"
+  end
+end

data/lib/boringbuilder/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BoringBuilder
-  VERSION = "0.1.0.alpha.3"
+  VERSION = "0.1.0.alpha.5"
 end

data/lib/boringbuilder.rb

@@ -20,6 +20,7 @@ require_relative "boringbuilder/ruby_build"
 require_relative "boringbuilder/rails_build"
 require_relative "boringbuilder/exporter"
 require_relative "boringbuilder/result"
+require_relative "boringbuilder/build_receipt"
 require_relative "boringbuilder/builder"
 require_relative "boringbuilder/cli"
 require_relative "boringbuilder/railtie" if defined?(Rails::Railtie)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: boringbuilder
 version: !ruby/object:Gem::Version
-  version: 0.1.0.alpha.3
+  version: 0.1.0.alpha.5
 platform: ruby
 authors:
 - BoringCache
@@ -47,6 +47,7 @@ files:
 - lib/boringbuilder.rb
 - lib/boringbuilder/artifact.rb
 - lib/boringbuilder/boring_cache.rb
+- lib/boringbuilder/build_receipt.rb
 - lib/boringbuilder/builder.rb
 - lib/boringbuilder/cli.rb
 - lib/boringbuilder/config_file.rb
@@ -66,11 +67,12 @@ files:
 - lib/boringbuilder/project_plan.rb
 - lib/boringbuilder/rails_build.rb
 - lib/boringbuilder/railtie.rb
+- lib/boringbuilder/release_notes.rb
 - lib/boringbuilder/result.rb
 - lib/boringbuilder/ruby_application.rb
 - lib/boringbuilder/ruby_build.rb
 - lib/boringbuilder/runtime.rb
-- lib/boringbuilder/tasks/boringbuilder.rake
+- lib/boringbuilder/tasks/boring.rake
 - lib/boringbuilder/version.rb
 homepage: https://github.com/boringcache/builder
 licenses:
@@ -78,7 +80,7 @@ licenses:
 metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/boringcache/builder
-  source_code_uri: https://github.com/boringcache/builder/tree/v0.1.0.alpha.3
+  source_code_uri: https://github.com/boringcache/builder/tree/v0.1.0.alpha.5
   documentation_uri: https://github.com/boringcache/builder#readme
   changelog_uri: https://github.com/boringcache/builder/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/boringcache/builder/issues

data/lib/boringbuilder/tasks/boringbuilder.rake

@@ -1,40 +0,0 @@
-# frozen_string_literal: true
-
-namespace :boringbuilder do
-  desc "Build the Rails application with Dagger"
-  task build: :environment do
-    options = {}
-    {
-      runtime: "BORINGBUILDER_RUNTIME",
-      platform: "BORINGBUILDER_PLATFORM",
-      format: "BORINGBUILDER_FORMAT",
-      output: "BORINGBUILDER_OUTPUT",
-      publish: "BORINGBUILDER_PUSH",
-      load: "BORINGBUILDER_LOAD"
-    }.each do |option, environment_name|
-      value = ENV.fetch(environment_name, nil)
-      options[option] = value if value && !value.empty?
-    end
-
-    {
-      paths: "BORINGBUILDER_PATHS",
-      files: "BORINGBUILDER_FILES",
-      host_paths: "BORINGBUILDER_HOST_PATHS"
-    }.each do |option, environment_name|
-      values = ENV.fetch(environment_name, "").split(",").reject(&:empty?)
-      options[option] = values unless values.empty?
-    end
-
-    result = BoringBuilder.build(root: Rails.root, **options)
-    puts "Built with Dagger on #{result.runtime}"
-    puts "Exported #{result.format}: #{result.path}" if result.exported?
-    puts "Image: #{result.reference}" if result.published?
-  end
-
-  desc "Check the configured container runtime"
-  task :doctor do
-    requested = ENV.fetch("BORINGBUILDER_RUNTIME", "auto")
-    runtime = BoringBuilder::Runtime.new(requested).resolve
-    puts "Dagger runtime ready: #{runtime}"
-  end
-end