partially implemented separate manifest management

modules/build/include/metadata.hpp

@@ -0,0 +1,55 @@
+/**
+* @file metadata.hpp
+ * @brief Functions for handling DPM package stage metadata
+ *
+ * Defines functions for creating and manipulating metadata for DPM package stages.
+ *
+ * @copyright Copyright (c) 2025 SILO GROUP LLC
+ * @author Chris Punches <chris.punches@silogroup.org>
+ *
+ * Part of the Dark Horse Linux Package Manager (DPM)
+ */
+#pragma once
+
+#include <filesystem>
+#include <string>
+#include <fstream>
+#include <vector>
+#include <sys/stat.h>
+#include <pwd.h>
+#include <grp.h>
+
+#include <dpmdk/include/CommonModuleAPI.hpp>
+#include "checksums.hpp"
+
+/**
+ * @brief Updates the contents manifest file for a package stage
+ *
+ * Creates the CONTENTS_MANIFEST_DIGEST file by scanning the contents directory
+ * and generating a line for each file with control designation,
+ * checksum, permissions, ownership, and path information.
+ *
+ * @param package_dir Root directory of the package stage
+ * @return true if contents manifest generation was successful, false otherwise
+ */
+bool update_contents_manifest(const std::filesystem::path& package_dir);
+
+/**
+ * @brief Generates basic metadata files for a package stage
+ *
+ * Creates the necessary metadata files for a package stage with the provided information.
+ * Does not generate the CONTENTS_MANIFEST_DIGEST which requires a separate call
+ * to update_contents_manifest().
+ *
+ * @param package_dir Root directory of the package stage
+ * @param package_name Name of the package
+ * @param package_version Version of the package
+ * @param architecture Architecture of the package (e.g., x86_64, aarch64)
+ * @return true if metadata generation was successful, false otherwise
+ */
+bool metadata_generate_new(
+    const std::filesystem::path& package_dir,
+    const std::string& package_name,
+    const std::string& package_version,
+    const std::string& architecture
+);