add build_late, update docs

Signed-off-by: Zen <[email protected]>

Author: desultory

docs/dev_manual.md

@@ -6,6 +6,8 @@ Modules only require a toml definition, and can import other modules to act as m
 
 Python functions can be added imported into `init` and `build` runlevels to execute build tasks or output init lines.
 
+> `build` functions are allowed to mutate config, init functions are not. Init is the final build task where bash files are generated.
+
 Within modules, all config values are imported, then processed according to the order of the `custom_parameters` list.
 
 `_module_name` can be set within a module for logging purposes, it is verified to be accurate when imported but optional.
@@ -49,11 +51,19 @@ Build imports are used to mutate config and build the base structure of the init
 
 ### build_tasks
 
-`build_tasks` are functions which will be executed after `build_pre`, such as dependency pulling.
+`build_tasks` are functions which will be executed after `build_pre`, which make up the majority of the build process.
 
 ### build_late
 
-`build_late` functions are executed after the init has been generated.
+`build_late` are finalizing build functions, immediately before files are deployed
+
+### build_deploy
+
+`build_deploy` is mostly for builtin functions and is where components are actually copied into the build directory.
+
+### build_final
+
+`build_final` is the last build hook, where finalizing tasks take place.
 
 ## Init imports
 

src/ugrd/initramfs_generator.py

@@ -16,7 +16,7 @@ def __init__(self, config='/etc/ugrd/config.toml', *args, **kwargs):
         self.included_functions = {}
 
         # Used for functions that are run as part of the build process
-        self.build_tasks = ['build_pre', 'build_tasks', 'build_deploy', 'build_final']
+        self.build_tasks = ['build_pre', 'build_tasks', 'build_late', 'build_deploy', 'build_final']
 
         # init_pre and init_final are run as part of generate_initramfs_main
         self.init_types = ['init_debug', 'init_early', 'init_main', 'init_late', 'init_premount', 'init_mount', 'init_mount_late', 'init_cleanup']

src/ugrd/kmod/kmod.toml

@@ -26,7 +26,7 @@ no_kmod = "bool" # Disables kernel modules entirely
 [imports.build_pre]
 "ugrd.kmod.kmod" = [ "get_kernel_metadata", "autodetect_modules" ]
 
-[imports.build_tasks]
+[imports.build_late]
 "ugrd.kmod.kmod" = [ "process_modules", "process_ignored_modules", "process_module_metadata" ]
 
 [imports.build_final]