Class: Hecks::Runtime::BootGates

Inherits:
Object
  • Object
show all
Defined in:
lib/hecks/runtime/boot_gates.rb

Overview

A boot's own small set of phase-tagged, conditionally-present gates — ADR 0031. Registration is instance-scoped, ONE PER Loader.boot CALL, never a module-level singleton: a process that boots more than one registry in its lifetime (every spec suite does) must never let one boot's capability profile leak into the next boot's gate list.

A gate is anything .call(registry, directory)-able — an existing module method handed over as a Method object (EraCheck.method (:check_lineage!)) needs no wrapper; a bare block does. Phases run in the order run! is called, gates within a phase in registration order — today exactly one gate per phase, so ordering among same-phase gates has never been exercised.

This is deliberately NOT the same registry Hecks::Projector uses (ADR 0027) — that one is a process-wide, static IR-in/artifact-out registry with no bindings and no live-state mutation; this one is per-boot and gates real I/O (a Postgres mint, a saga-store read). Sharing a primitive between them is deferred until a third consumer actually wants it (0031's own Rejected Alternatives).

Instance Method Summary collapse

Constructor Details

#initialize ⇒ BootGates

Returns a new instance of BootGates.



23
24
25
 
# File 'lib/hecks/runtime/boot_gates.rb', line 23

def initialize
  @gates = Hash.new { |h, k| h[k] = [] }
end

Instance Method Details

#register(name, gate, phase:) ⇒ Object 



27
28
29
30
 
# File 'lib/hecks/runtime/boot_gates.rb', line 27

def register(name, gate, phase:)
  @gates[phase] << [name, gate]
  self
end

#registered?(name) ⇒ Boolean

Returns:

  • (Boolean) 


32
33
34
 
# File 'lib/hecks/runtime/boot_gates.rb', line 32

def registered?(name)
  @gates.values.flatten(1).any? { |registered_name, _gate| registered_name == name }
end

#run!(phase, registry, directory) ⇒ Object 



36
37
38
 
# File 'lib/hecks/runtime/boot_gates.rb', line 36

def run!(phase, registry, directory)
  @gates[phase].each { |pair| pair.last.call(registry, directory) }
end