bootprint 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ae8e01ef715b2bb8a62bedb57882a0cf2af5a783ff72c15673b46ecabbff4ea
-  data.tar.gz: a5c4b0fbf1d54ff4c65b0e338d1e117f6eaaf2d1f5c2f1a558824441af5cdca8
+  metadata.gz: 84278443cdd38e08c4b03bdd0776b8a9b7fd32a623b5ebf2f2c3e1ddc29901c2
+  data.tar.gz: e51b0d1b314473e6acb15544ab81a9fbd09de46994f929eff9b5751769db3f80
 SHA512:
-  metadata.gz: d536be2a2d5cd4059b6572736b555b2c2d4ddeaea2245f229dcca4d3d1e1d1726d7e35f4cc04a2b012c19212c8f32b31bb6fccbcc0a249ad152cccd475078123
-  data.tar.gz: 9d973eb86bcb2c82451af1799e80426fe17174b7b269d7bc75fb228e10027cd1d80f76866724935491a573f40d2d2cfeeac121e80f93d69fc06853ca4beb699c
+  metadata.gz: e3be35d8bc8b7d970b4239b987fef35361677e8347fc24c200db57118515ebc2be83691c371f892b1d47a4fcf05cfd6b408c453282f117b5d3cec28ee1702c76
+  data.tar.gz: 1a99662465a2ef9d867b4e81016d4ce92c0c02ca949d2a6425e30c26ee223739a976f941e12162c432e53dca052f79be668f0ce29ca67a57abf329dba1d5a473

data/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to Bootprint are documented here. The project follows Semant
 
 ## Unreleased
 
+## 0.5.0 - 2026-08-14
+
+### Added
+
+- Capture timezone, default encodings, and locale metadata on the operating-system fingerprint.
+- Built-in rules `timezone-drift`, `encoding-drift`, and `locale-drift` for those fields.
+
 ## 0.4.0 - 2026-08-11
 
 ### Added

data/README.md

@@ -56,7 +56,7 @@ Bootprint 0.2 combines a dependency compatibility analyzer, Rails boot inspector
 
 `Gemfile.lock` captures dependency resolution, but not the complete runtime contract. Ruby engine and patch level, native clients, libc, CPU architecture, Rails adapters, required configuration, filesystem behavior, and initializer ordering can all change application behavior.
 
-Bootprint records those facts as deterministic schema-v2 JSON and evaluates them with 39 independently testable built-in rules. A finding answers four questions that a plain diff cannot:
+Bootprint records those facts as deterministic schema-v2 JSON and evaluates them with 42 independently testable built-in rules. A finding answers four questions that a plain diff cannot:
 
 1. What changed?
 2. How dangerous is it?
@@ -79,7 +79,7 @@ ERROR      Required environment variable is missing
 
 | Capability | Bootprint 0.2 |
 |---|---|
-| Diagnostic knowledge | 39 built-in rules across runtime, dependencies, native libraries, configuration, filesystem, and Rails boot |
+| Diagnostic knowledge | 42 built-in rules across runtime, dependencies, native libraries, configuration, filesystem, locale, and Rails boot |
 | Severity model | `info`, `warning`, `error`, `critical` |
 | Report formats | Human terminal output, JSON, SARIF 2.1, Markdown |
 | Snapshot contract | Deterministic schema v2 with in-memory v1 migration |
@@ -97,6 +97,7 @@ ERROR      Required environment variable is missing
 | Native libraries | OpenSSL, libyaml, SQLite, PostgreSQL, MySQL, libc, compiler and header availability when detectable |
 | Configuration | Environment-variable names and presence, Rails environment, adapters, framework settings |
 | Filesystem | Temporary/log path availability, writability, path separators, case sensitivity, symlink behavior |
+| Locale | Timezone name and UTC offset, default internal/external encodings, LANG / LC_ALL / charmap |
 | Rails boot | Framework configuration, autoload/eager-load paths, initializers, and opt-in initializer timings |
 | Docker | Image runtime, platforms, installed package metadata when available, workdir, entrypoint, command, permissions |
 

data/lib/bootprint/cli.rb

@@ -436,7 +436,7 @@ module Bootprint
       raise OptionParser::InvalidArgument, "NAME may contain only letters, numbers, dots, underscores, and hyphens" unless valid
     end
 
-    def safe_name(value) = value.to_s.gsub(/[^a-zA-Z0-9_.-]+/, "-").gsub(/\A-+|-+\z/, "")
+    def safe_name(value) = value.to_s.gsub(/[^a-zA-Z0-9_.-]+/, "-").gsub(/\A-++|-++\z/, "")
 
     def reject_extra_arguments!
       raise OptionParser::ParseError, "unexpected arguments: #{@argv.join(' ')}" unless @argv.empty?

data/lib/bootprint/collectors/operating_system.rb

@@ -19,7 +19,10 @@ module Bootprint
           "processors" => Etc.nprocessors,
           "capabilities" => TOOLS.to_h { |tool| [tool, executable?(tool)] },
           "ruby_headers" => header_state,
-          "ci" => ci_provider
+          "ci" => ci_provider,
+          "timezone" => timezone_state,
+          "encoding" => encoding_state,
+          "locale" => locale_state
         }
       end
 
@@ -45,6 +48,30 @@ module Bootprint
 
         nil
       end
+
+      def timezone_state
+        now = Time.now
+        {
+          "name" => now.zone,
+          "utc_offset" => now.utc_offset,
+          "tz" => ENV.fetch("TZ", nil)
+        }
+      end
+
+      def encoding_state
+        {
+          "external" => Encoding.default_external.name,
+          "internal" => Encoding.default_internal&.name
+        }
+      end
+
+      def locale_state
+        {
+          "lang" => ENV.fetch("LANG", nil),
+          "lc_all" => ENV.fetch("LC_ALL", nil),
+          "charmap" => Encoding.locale_charmap
+        }
+      end
     end
   end
 end

data/lib/bootprint/rules/builtin.rb

@@ -58,6 +58,24 @@ module Bootprint
              fix: "Use a standard release build for production.") do |_source, target|
           dig(target, "runtime.debug_build") == true && { "description" => dig(target, "runtime.description") }
         end
+        rule("timezone-drift", "Timezone mismatch", :runtime, :warning,
+             cause: "The environments select different timezones.",
+             impact: "Time.now, cron, and timestamp formatting can disagree across machines.",
+             fix: "Set TZ consistently in local, container, and CI environments.") do |source, target|
+          difference(source, target, "operating_system.timezone")
+        end
+        rule("encoding-drift", "Default encoding mismatch", :runtime, :warning,
+             cause: "Ruby default encodings differ between environments.",
+             impact: "String transcoding, file IO, and JSON payloads can fail only in one environment.",
+             fix: "Align Encoding.default_external (and LANG/LC_ALL) with the deployment runtime.") do |source, target|
+          difference(source, target, "operating_system.encoding")
+        end
+        rule("locale-drift", "Locale mismatch", :runtime, :info,
+             cause: "LANG / LC_ALL / locale charmap differ between environments.",
+             impact: "Sort order, number formatting, and encoding defaults can change.",
+             fix: "Export the same LANG and LC_ALL in every environment.") do |source, target|
+          difference(source, target, "operating_system.locale")
+        end
       end
 
       def dependency_rules

data/lib/bootprint/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Bootprint
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bootprint
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Magnexis