textus 0.14.0 → 0.14.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24eda2a2cfec1884eb3c675189493827b6c0f43d5765922dbee06b70fbdc9685
-  data.tar.gz: 84e3850666541900f4c3b99f71c59b73dd142c7001f80fa9e8233d38f984719e
+  metadata.gz: 7f46590895cb1b7dccf71efbb6cc7632ac1054e545323478e831875c7b7bf621
+  data.tar.gz: e84857018c0bf4e61e6e60a476191e04dd2fe470f476b27860deaf59611993ab
 SHA512:
-  metadata.gz: d68ad56bc7891aefda10e47234f1bbd1efbfd75b576f7981c3374641efbd306dc66947b382b74c70da24bc58122090c3e0789c33b1a8291aa1005b9e6c952e2e
-  data.tar.gz: fd1c1cefad648636b4fb5aeba100d81c66472f8e1b50d07ba2239607c19179842902abf0b76925786c66868049acfd507a9a76bd07e39026dd2aa0d261ebfdad
+  metadata.gz: e21ff9e7d9a9cfe93ab3865646b53bbea4647f0c7ace9d329e7ccec13a2ce7343568df836bd25fccfa19c39d4384a2d522d827e5d01b7ebbdd0b2ab3098978be
+  data.tar.gz: 700e831af5ba5c13a9e66984e59ee4774def27e1c098b7dfd2d6e942b6cd064b7e3e3d1480faa110417ede67aa229d0b7bfea063f8f5f59e91bcaa0dce282355

data/CHANGELOG.md

@@ -9,6 +9,23 @@ The **gem version** (`0.x.y`) is distinct from the **protocol version**
 bump is a breaking change that requires a store migration; the gem version
 tracks both additive improvements and breaking protocol bumps independently.
 
+## 0.14.1 — 2026-05-26
+
+### Changed
+
+- Build pipeline now skips rewriting a built artifact when the only
+  difference from the existing file on disk would be the freshly-stamped
+  `generated_at` (markdown: `generated.at`) timestamp. Stores under git
+  versioning no longer churn on every `textus build` (#52).
+- Strict policy: any other byte difference — changed `from`,
+  `template`, `reduce`, body content — still triggers a write. Text
+  format falls back to plain byte-equality (no timestamp to normalize).
+
+### Internal
+
+- Extracted `Manifest.check_version!` to dedupe the parse/load version
+  guard (#51).
+
 ## 0.14.0 — 2026-05-26
 
 ### Breaking (Ruby API only — CLI JSON output unchanged)

data/lib/textus/builder/pipeline.rb

@@ -19,6 +19,35 @@ module Textus
       end
     end
 
+    # Replaces the freshly-stamped timestamp inside `new_bytes` with the
+    # timestamp pulled from `old_bytes` (same format). Returns the rewritten
+    # bytes, or nil if either side lacks a parseable timestamp.
+    module IdempotentWrite
+      def self.rewrite_with_prior_timestamp(new_bytes:, old_bytes:, format:)
+        prior = extract_timestamp(old_bytes, format)
+        fresh = extract_timestamp(new_bytes, format)
+        return nil unless prior && fresh
+        return new_bytes if prior == fresh
+
+        new_bytes.sub(fresh, prior)
+      end
+
+      def self.extract_timestamp(bytes, format)
+        case format
+        when "markdown"
+          parsed = Entry.for_format("markdown").parse(bytes)
+          parsed.dig("_meta", "generated", "at")
+        when "json", "yaml"
+          parsed = Entry.for_format(format).parse(bytes)
+          parsed.dig("_meta", "generated_at")
+        else # rubocop:disable Style/EmptyElse
+          nil
+        end
+      rescue Textus::BadFrontmatter
+        nil
+      end
+    end
+
     module Pipeline
       def self.renderers
         @renderers ||= {
@@ -44,13 +73,28 @@ module Textus
           raise UsageError.new("builder: unsupported format #{mentry.format.inspect} for '#{mentry.key}'")
         bytes = klass.new(template_loader: template_loader).call(mentry: mentry, data: data)
 
-        # 3. Write
+        # 3. Write (idempotent: skip if only generated_at would differ)
         target_path = Key::Path.resolve(store.manifest, mentry)
         FileUtils.mkdir_p(File.dirname(target_path))
-        File.binwrite(target_path, bytes)
+        write_if_changed(target_path, bytes, mentry.format)
 
         target_path
       end
+
+      def self.write_if_changed(target_path, bytes, format)
+        if File.exist?(target_path)
+          old_bytes = File.binread(target_path)
+          if format == "text"
+            return if old_bytes == bytes
+          else
+            rewritten = IdempotentWrite.rewrite_with_prior_timestamp(
+              new_bytes: bytes, old_bytes: old_bytes, format: format,
+            )
+            return if rewritten && rewritten == old_bytes
+          end
+        end
+        File.binwrite(target_path, bytes)
+      end
     end
   end
 end

data/lib/textus/manifest.rb

@@ -39,14 +39,7 @@ module Textus
 
     def self.parse(yaml_text, root: ".")
       raw = YAML.safe_load(yaml_text, aliases: false)
-      unless raw["version"] == PROTOCOL
-        raise BadFrontmatter.new(
-          "<string>",
-          "unsupported manifest version #{raw["version"].inspect}; expected #{PROTOCOL.inspect}",
-          hint: version_hint_for(raw["version"]),
-        )
-      end
-
+      check_version!(raw, "<string>")
       new(root, raw)
     end
 
@@ -55,17 +48,21 @@ module Textus
       raise IoError.new("manifest not found: #{manifest_path}") unless File.exist?(manifest_path)
 
       raw = YAML.safe_load_file(manifest_path, aliases: false)
-      unless raw["version"] == PROTOCOL
-        raise BadFrontmatter.new(
-          manifest_path,
-          "unsupported manifest version #{raw["version"].inspect}; expected #{PROTOCOL.inspect}",
-          hint: version_hint_for(raw["version"]),
-        )
-      end
-
+      check_version!(raw, manifest_path)
       new(root, raw)
     end
 
+    def self.check_version!(raw, source)
+      return if raw["version"] == PROTOCOL
+
+      raise BadFrontmatter.new(
+        source,
+        "unsupported manifest version #{raw["version"].inspect}; expected #{PROTOCOL.inspect}",
+        hint: version_hint_for(raw["version"]),
+      )
+    end
+    private_class_method :check_version!
+
     def initialize(root, raw)
       @root = root
       @raw = raw

data/lib/textus/version.rb

@@ -1,4 +1,4 @@
 module Textus
-  VERSION = "0.14.0"
+  VERSION = "0.14.1"
   PROTOCOL = "textus/3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: textus
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.14.1
 platform: ruby
 authors:
 - Patrick