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

src/bundled-modules/info/include/commands.hpp

@@ -0,0 +1,86 @@
+/**
+ * @file commands.hpp
+ * @brief Command handlers for the info module
+ *
+ * @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>
+
+/**
+ * @enum Command
+ * @brief Commands supported by the info module
+ */
+enum Command {
+    CMD_UNKNOWN,  /**< Unknown or unsupported command   */
+    CMD_HELP,     /**< Display help information         */
+    CMD_VERSION,  /**< Display core and module versions */
+    CMD_SYSTEM,   /**< Display system information       */
+    CMD_CONFIG,   /**< Display configuration information */
+};
+
+/**
+ * @brief Parses a command string into a Command enum value
+ *
+ * @param cmd_str The command string to parse (NULL/empty means help)
+ * @return The corresponding Command enum value
+ */
+Command parse_command(const char* cmd_str);
+
+/**
+ * @brief Displays the info module's help text
+ *
+ * @param ctx Host core context
+ * @return 0 on success
+ */
+int cmd_help(dpm_ctx* ctx);
+
+/**
+ * @brief Reports the running core version and the info module version
+ *
+ * @param ctx Host core context
+ * @return 0 on success
+ */
+int cmd_version(dpm_ctx* ctx);
+
+/**
+ * @brief Reports operating system and architecture information
+ *
+ * @param ctx Host core context
+ * @return 0 on success
+ */
+int cmd_system(dpm_ctx* ctx);
+
+/**
+ * @brief Reports core configuration as resolved by the running context
+ *
+ * @param ctx Host core context
+ * @return 0 on success
+ */
+int cmd_config(dpm_ctx* ctx);
+
+/**
+ * @brief Reports an unrecognized command
+ *
+ * @param ctx Host core context
+ * @param command The unrecognized command string
+ * @return 1 to indicate failure
+ */
+int cmd_unknown(dpm_ctx* ctx, const char* command);