boringbuilder 0.1.0.alpha.4 → 0.1.0.alpha.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e9749414b7c380d6f22d64e9fbf42e16399553dfa0274cd85209becabf2ecb46
-  data.tar.gz: 2a2b30435de56a0be063cd3b6c73737810005546b51e0bb380884ac3edf76cdf
+  metadata.gz: 265bb7643d090142fc6a68cba78809ffabf6dd3d5436e8a605d1e5e69848984c
+  data.tar.gz: ac30aa3a7160d742ce7742c4c1f86720deb5061a8c8eb85a4a6c57c7e79c7b13
 SHA512:
-  metadata.gz: 8f7692b32065fa078b63d5a6f76e2c6c0c2d99c6dd7fc95513572e45be6d1ed182436cc8fc5a37e7ffff83cf589bca84d75be4d1182a59b66e3f587d5296d1c7
-  data.tar.gz: 6e0480ec13fb058600d8fdf7b7b8ab50c1c041c8f68d365be65d7273f7089f716c21a3247a96b405d2665eed3a2a7c3f49a8a9b49af7c0ef0e1be523202972dd
+  metadata.gz: 1774754066715572ee3d1946642e00e07baa3b5d5f97626e04eb76b45d4e5ec6a226627e8033ead3967591082b41b2cff71cb730320df1026333495e7048ec3f
+  data.tar.gz: 391c319a4fd5e8a8c8eb634efc31f45df7bc2ecf4b2357e8a90deae236785c34dc88cdce53d1b4f154bed96950b27b8453cf4bd4e7957ae9a76d6db523c42f86

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # 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`.

data/README.md

@@ -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/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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BoringBuilder
-  VERSION = "0.1.0.alpha.4"
+  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.4
+  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,6 +67,7 @@ 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
@@ -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.4
+  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