foundries 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9bda37a762c9a055ca42c5faa685e30a6201fbeccaa5bbb7adffa0ccaef3386
-  data.tar.gz: 4fe49113055d53bb2e61df790fa037c849cff8d7b380011e6fd298fab0ec68af
+  metadata.gz: c8245b09fe2227ef4a25d5751c30f4a94a1d2d80519ef5fb97b8ba2b9dc527ef
+  data.tar.gz: 24162154115e9f413117fb88d71aa0cbc19374cbbf9b6fa059f23e36535511e5
 SHA512:
-  metadata.gz: 6e2b1f8a7fbc9107f684883ae9435c8c6cfc004698f7a5316ec47fb3531b9d100be9b12b55a4c097cefbb48e871c653717dbdf4ed5733dcbaf1032f5fed6a8e0
-  data.tar.gz: f25ae1307f8f675d4b6d617b13b9102639e49f29bd6f80f90145cc68023725a36eb3169207107c9af6cb1078188f8a0d104c6e591959fc1ee48d992563b9e827
+  metadata.gz: f0b22d20d6edc795ef1c7a2f3403b1a7e5cbbbc0d3ca4bd19fc82c25992bcea6d460175df202d8cd0465dd328a8bc189672171423ed283aa7879390450261318
+  data.tar.gz: 1ece80e18cdc964013db346ec665e2919f146bda411ddaf4254abb4c714c712a4a692cb30241a051da98029c164fbbc77b1e4fc44c2dac0cadda396c0fbccadf

data/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.1.3] - 2026-03-13
+
+### Added
+
+- ancestor DSL and ancestors_for for path-based hierarchy building (7027e06)
+
 ## [0.1.2] - 2026-03-12
 
 ### Added
@@ -18,21 +24,3 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 - Collections initialize before blueprints (377632f)
 - Fix find parent scoping and collection_find_by kwargs handling (3ebfc3e)
-
-## [0.1.1] - 2026-03-06
-
-### Added
-
-- Blueprint base class with collection tracking, parent scoping, and factory_bot integration (0002336)
-- Snapshot caching system with Postgres and SQLite adapters for test suite acceleration (0002336)
-- Source file content hashing in snapshot fingerprint for automatic cache invalidation (cfb348d)
-
-### Changed
-
-- Snapshot caching is opt-in via ARMATURE_CACHE=1 environment variable (0002336)
-- Similarity detection only warns on identical structure, not containment (a5bdf25)
-
-### Fixed
-
-- Parentless blueprints no longer raise NameError when find calls same_parent? (cfb348d)
-- Snapshot-cached presets no longer produce false similarity warnings (a5bdf25)

data/lib/foundries/base.rb

@@ -200,6 +200,31 @@ module Foundries
     end
     alias_method :update_current, :load_state
 
+    # Build a hierarchy from a path string or array.
+    # Finds the blueprint that handles `type` and calls
+    # `ancestors` on it to recursively create the chain.
+    #
+    #   ancestors_for :task, "org/block/template/phase/mod/event" do
+    #     task "my_task"
+    #   end
+    #
+    def ancestors_for(type, path = nil, path_arr: nil, &block)
+      path_arr ||= path.split("/")
+      blueprint_for(type).ancestors(path_arr, &block)
+    end
+
+    # Find the blueprint instance that handles a given method.
+    def blueprint_for(method_name)
+      resolved = self.class.aliases[method_name] || method_name
+      self.class.delegations.each do |klass, methods|
+        if methods.include?(resolved)
+          ivar = :"@#{ivar_name_for(klass)}"
+          return instance_variable_get(ivar)
+        end
+      end
+      raise "No blueprint handles :#{method_name}"
+    end
+
     private
 
     # Override in subclasses for post-initialize hooks (e.g. pending phase rules).

data/lib/foundries/blueprint.rb

@@ -116,6 +116,23 @@ module Foundries
         @lookup_order = ancestors
       end
 
+      # Declare the ancestor type for path-based hierarchy
+      # creation via `ancestors_for`.
+      #
+      #   ancestor :event
+      #
+      # Generates an `ancestors(path, &block)` method that
+      # pops the last path segment and either:
+      # - calls `foundry.send(type, name, &block)` if the
+      #   path is empty (terminal)
+      # - calls `foundry.ancestors_for(type, ...)` to
+      #   continue recursion otherwise
+      def ancestor(type = nil)
+        return @ancestor_type unless type
+
+        @ancestor_type = type
+      end
+
       # Declare which attributes are allowed through to factory_bot.
       def permitted_attrs(attr_list)
         define_method(:permitted_attrs) do |attrs|
@@ -208,6 +225,26 @@ module Foundries
       end
     end
 
+    # Walk a path array to build ancestor hierarchy, then
+    # yield the block in the innermost context. Requires
+    # the `ancestor` class DSL to be declared.
+    #
+    #   ancestors(["org", "block", "template"], &block)
+    #
+    def ancestors(path, &block)
+      type = self.class.ancestor
+      raise "No ancestor declared for #{self.class}" unless type
+
+      name = path.pop
+      if path.empty?
+        foundry.send(type, name, &block)
+      else
+        foundry.ancestors_for(type, path_arr: path) do
+          foundry.send(type, name, &block)
+        end
+      end
+    end
+
     # Find or create: when no parent is present, walks ancestors
     # via lookup_order; otherwise finds from parent or creates.
     def find_or_create(name, attrs = {})

data/lib/foundries/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Foundries
-  VERSION = "0.1.2"
-  RELEASE_DATE = "2026-03-12"
+  VERSION = "0.1.3"
+  RELEASE_DATE = "2026-03-13"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: foundries
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - John Dowd