half-arsed: 💩 half implement a proper parser engine class

lib/comfpile.rb

@@ -5,8 +5,3 @@ require_relative "comfpile/version"
 require_relative 'comfpile/core.rb'
 
 require_relative 'comfpile/engines/filesource_engine.rb'
-
-module Comfpile
-  class Error < StandardError; end
-  # Your code goes here...
-end

lib/comfpile/artefact.rb

@@ -11,7 +11,25 @@ module Comfpile
         attr_reader :exit_state
         attr_reader :stage, :target
 
-        attr_reader :linked_artefacts
+        
+        # @return [Array<Comfpile::Artefact>] List of all artefacts 
+        #  included in this artefact.
+        #  Included artefacts are also required, but will additionally
+        #  update this Artefact's age.
+        attr_reader :included_artefacts
+        # @return [Array<Comfpile::Artefact] List of all artefacts
+        #  required to build this artefact.
+        #  Required artefacts are needed to build this artefact, but
+        #  do not modify the artefact's age.
+        attr_reader :required_artefacts
+        # @return [Array<Comfpile::Artefact>] List of all artefacts
+        #  potentially referenced by this artefact.
+        #  Referenced artefacts are those that are potentially used
+        #  by this artefact through e.g. function calls, but are 
+        #  not directly needed to build this artefact. Example being
+        #  how sourcecode of a library is eventually needed for e.g. 
+        #  linking steps, but the objects can be built separately.
+        attr_reader :referenced_artefacts
 
         # ARTEFACT STATES
         # 
@@ -39,8 +57,8 @@ module Comfpile
 
             @parent_artefact = nil
 
-            @required_artefacts = nil
+            @required_artefacts = []
-            @linked_artefacts = nil
+            @included_artefacts = []
 
             @steps = []
             @step_additions = nil
@@ -132,7 +150,7 @@ module Comfpile
                 elsif item[:artefact].succeeded?
                     @waitlist.pop
                 else
-                    skip! skip! "Failed artefact dependency: #{item[:artefact]}"
+                    skip! "Failed artefact dependency: #{item[:artefact]}"
                     
                     return true
                 end

lib/comfpile/engines/parser_engine.rb

@@ -1,14 +1,8 @@
 
 module Compfile
     class ParserArtefact < Artefact
-        attr_reader :included_files
+        def initialize(*args, **opts)
-        attr_reader :required_files
+            super(*args, **opts)
-
-        def initialize(*args)
-            super(*args)
-
-            @included_files = []
-            @required_files = []
 
             parent_artefact :sourcefile, @target