Initial commit: DPM core library, CLI, bundled info module, and tests

include/internal/context.hpp

@@ -0,0 +1,74 @@
+/**
+ * @file context.hpp
+ * @brief The core context: configuration, logging, module registry
+ *
+ * @copyright Copyright (c) 2026 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/>.
+ */
+#pragma once
+
+#include <dpm/core.h>
+
+#include <map>
+#include <memory>
+#include <string>
+
+#include "internal/modules.hpp"
+
+/** @brief A core context: configuration, logging, and the module registry */
+struct dpm_ctx {
+    std::string config_dir;
+    std::string module_path;
+    std::string root;
+
+    int         log_level    = DPM_LOG_INFO;
+    bool        write_to_log = false;
+    std::string log_file;
+
+    /* config[module][section][key] = value */
+    std::map<std::string,
+             std::map<std::string,
+                      std::map<std::string, std::string>>> config;
+
+    /* validated modules, keyed by name; loaded at most once per ctx */
+    std::map<std::string, std::unique_ptr<dpm_module>> modules;
+
+    std::string last_error;
+};
+
+namespace dpmcore {
+
+/**
+ * @brief Records a failure reason on the context
+ *
+ * @param ctx The core context; NULL is a no-op
+ * @param msg The failure description
+ */
+void set_error(dpm_ctx* ctx, const std::string& msg);
+
+/**
+ * @brief Loads all configuration files into the context
+ *
+ * Parses every .conf file in the context's configuration directory
+ * into the context's configuration store.
+ *
+ * @param ctx The core context
+ */
+void load_config_dir(dpm_ctx* ctx);
+
+} // namespace dpmcore

include/internal/modules.hpp

@@ -0,0 +1,74 @@
+/**
+ * @file modules.hpp
+ * @brief Module handle, cursor, and loader declarations
+ *
+ * @copyright Copyright (c) 2026 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/>.
+ */
+#pragma once
+
+#include <dpm/core.h>
+
+#include <memory>
+#include <string>
+#include <vector>
+
+/** @brief A loaded, fully validated module */
+struct dpm_module {
+    std::string name;
+    void*       handle = nullptr;
+    std::string version;
+    std::string description;
+    std::string core_min;
+    const dpm_manifest* manifest = nullptr;
+    int (*execute)(dpm_ctx*, const char*, int, char**) = nullptr;
+};
+
+/** @brief Enumeration cursor over validated modules */
+struct dpm_cursor {
+    std::vector<dpm_module_info> infos;
+    size_t idx = 0;
+};
+
+/**
+ * @brief Closes a dlopen handle
+ *
+ * Keeps handle release beside the loader in one translation unit.
+ *
+ * @param handle The handle to close; NULL is a no-op
+ */
+void dpm_internal_unload(void* handle);
+
+namespace dpmcore {
+
+/**
+ * @brief Runs the full load-time validation sequence against a module
+ *
+ * Loads the named module's .so from the context's module path and
+ * verifies the complete contract.
+ *
+ * @param ctx The core context
+ * @param name The module name
+ * @param reason Receives the refusal reason on failure
+ * @return The validated module (caller owns), or nullptr on failure
+ */
+std::unique_ptr<dpm_module> validate_and_load(dpm_ctx* ctx,
+                                              const std::string& name,
+                                              std::string& reason);
+
+} // namespace dpmcore

include/internal/version.hpp

@@ -0,0 +1,45 @@
+/**
+ * @file version.hpp
+ * @brief X.Y.Z version parsing and comparison
+ *
+ * @copyright Copyright (c) 2026 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/>.
+ */
+#pragma once
+
+namespace dpmcore {
+
+/**
+ * @brief Parses a strict X.Y.Z version string
+ *
+ * @param s The version string
+ * @param out Receives the three parsed components
+ * @return true on success; false on any malformation
+ */
+bool parse_version(const char* s, long out[3]);
+
+/**
+ * @brief Compares two valid X.Y.Z version strings
+ *
+ * @param a First version
+ * @param b Second version
+ * @return -1 if a < b, 0 if equal, 1 if a > b
+ */
+int compare_versions(const char* a, const char* b);
+
+} // namespace dpmcore