error handling layer implemented, header boilerplated for licensing info

src/dpm.cpp

@@ -1,8 +1,40 @@
+/**
+* @file dpm.cpp
+ * @brief Main entry point for the Dark Horse Package Manager (DPM)
+ *
+ * Implements the core command-line interface and module routing functionality
+ * for the DPM utility, handling argument parsing, module loading, and execution.
+ *
+ * @copyright Copyright (c) 2025 SILO GROUP LLC
+ * @author Chris Punches <chris.punches@silogroup.org>
+ *
+ * Part of the Dark Horse Linux Package Manager (DPM)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * For bug reports or contributions, please contact the dhlp-contributors
+ * mailing list at: https://lists.darkhorselinux.org/mailman/listinfo/dhlp-contributors
+ */
+
 #include <iostream>
+#include <handlers.hpp>
 #include <dlfcn.h>
 
 #include "ModuleLoader.hpp"
 #include "dpm_interface.hpp"
+#include "dpm_interface_helpers.hpp"
+#include "error.hpp"
 
 /*
  *   DPM serves three functions:
@@ -17,7 +49,16 @@ int default_behavior(const ModuleLoader& loader)
     return main_list_modules(loader);
 }
 
-// entry point for the DPM utility
+/**
+ * @brief Entry point for the DPM utility
+ *
+ * Processes command-line arguments, loads and executes the appropriate module,
+ * and handles any errors that occur during execution.
+ *
+ * @param argc Number of command-line arguments
+ * @param argv Array of C-style strings containing the arguments
+ * @return Exit code indicating success (0) or failure (non-zero)
+ */
 int main( int argc, char* argv[] )
 {
     // process the arguments suppplied to DPM and provide
@@ -43,8 +84,15 @@ int main( int argc, char* argv[] )
     }
 
     // execute the module
-    DPMError execute_error = loader.execute_module(args.module_name, args.command);
+    DPMErrorCategory execute_error = loader.execute_module(args.module_name, args.command);
+
+    std::string extracted_path;
+    loader.get_module_path(extracted_path);
+
+    FlexDPMError result = make_error(execute_error);
+    result.module_name = args.module_name.c_str();
+    result.module_path = extracted_path.c_str();
 
     // pair result with a message and exit with the appropriate error code
-    return print_error( execute_error, args.module_name, args.module_path );
+    return handle_error( result );
 }