refactoring files

src/cli.hpp

@@ -1,7 +1,34 @@
-#ifndef CLI_HPP
-#define CLI_HPP
+/**
+ * @file cli.hpp
+ * @brief Interactive asynchronous Command Line Interface for FoxMesh
+ * @author OM Tom (OE3TKT)
+ *
+ * @license SPDX-License-Identifier: MIT
+ * @copyright Copyright (c) 2026 OM Tom (OE3TKT)
+ * For the full license terms, see the LICENSE file in the project root.
+ */
 
-// Starts the interactive Command Line Interface task
+#pragma once
+
+#include "i2c.hpp"
+#include "led.hpp"
+#include "display.hpp"
+
+/**
+ * @brief Store peripheral, display, and hardware tracking references for CLI access.
+ * @param bus_pointer Pointer to the active tracking system I2C master instance.
+ * @param led_pointer Pointer to the active tracking system status LED instance.
+ * @param display_pointer Pointer to the active tracking system OLED instance.
+ */
+void cli_init(i2c* bus_pointer, LedController* led_pointer, DisplayController* display_pointer);
+
+/**
+ * @brief Registers the background tasks and setup routines for core runtime execution.
+ */
 void start_cli_task(void);
 
-#endif // CLI_HPP
+/**
+ * @brief Tokenizes and evaluates incoming control frames from the hardware terminal.
+ * @param cmd Null-terminated character string containing the raw user command execution layer.
+ */
+void process_command(const char* cmd);