refactor! rename `tooling` to `tools`

feat: BenchKit improvements and libMsg authorship refactors.

2 files changed, 199 insertions, 0 deletions

diff --git a/tools/libmkfs/hefs.h b/tools/libmkfs/hefs.h
new file mode 100644
index 00000000..52bb3086
--- /dev/null
+++ b/tools/libmkfs/hefs.h
@@ -0,0 +1,116 @@
+/* -------------------------------------------
+
+  Copyright (C) 2024-2025, Amlal El Mahrouss, all rights reserved.
+
+------------------------------------------- */
+
+#pragma once
+
+#include <cstdint>
+#include <cstring>
+
+#define kHeFSVersion (0x0101)
+#define kHeFSMagic "  HeFS"
+#define kHeFSMagicLen (8)
+
+#define kHeFSFileNameLen (256U)
+#define kHeFSPartNameLen (128U)
+
+#define kHeFSDefaultVolumeName u8"HeFS Volume"
+
+namespace mkfs::hefs {
+
+// Drive kinds
+enum {
+  kHeFSHardDrive         = 0xC0,  // Hard Drive
+  kHeFSSolidStateDrive   = 0xC1,  // Solid State Drive
+  kHeFSOpticalDrive      = 0x0C,  // Blu-Ray/DVD
+  kHeFSMassStorageDevice = 0xCC,  // USB
+  kHeFSScsiDrive         = 0xC4,  // SCSI Hard Drive
+  kHeFSFlashDrive        = 0xC6,
+  kHeFSUnknown           = 0xFF,  // Unknown device.
+  kHeFSDriveCount        = 8,
+};
+
+// Disk status
+enum {
+  kHeFSStatusUnlocked = 0x18,
+  kHeFSStatusLocked,
+  kHeFSStatusError,
+  kHeFSStatusInvalid,
+  kHeFSStatusCount,
+};
+
+// Encodings
+enum {
+  kHeFSEncodingFlagsUTF8 = 0x50,
+  kHeFSEncodingFlagsUTF16,
+  kHeFSEncodingFlagsUTF32,
+  kHeFSEncodingFlagsUTF16BE,
+  kHeFSEncodingFlagsUTF16LE,
+  kHeFSEncodingFlagsUTF32BE,
+  kHeFSEncodingFlagsUTF32LE,
+  kHeFSEncodingFlagsUTF8BE,
+  kHeFSEncodingFlagsUTF8LE,
+  kHeFSEncodingFlagsBinary,
+  kHeFSEncodingFlagsCount = 11,
+  kHeFSFlagsNone          = 0,
+  kHeFSFlagsReadOnly      = 0x100,
+  kHeFSFlagsHidden,
+  kHeFSFlagsSystem,
+  kHeFSFlagsArchive,
+  kHeFSFlagsDevice,
+  kHeFSFlagsCount = 7
+};
+
+// Time type
+using ATime = std::uint64_t;
+
+// File kinds
+inline constexpr uint16_t kHeFSFileKindRegular      = 0x00;
+inline constexpr uint16_t kHeFSFileKindDirectory    = 0x01;
+inline constexpr uint16_t kHeFSFileKindBlock        = 0x02;
+inline constexpr uint16_t kHeFSFileKindCharacter    = 0x03;
+inline constexpr uint16_t kHeFSFileKindFIFO         = 0x04;
+inline constexpr uint16_t kHeFSFileKindSocket       = 0x05;
+inline constexpr uint16_t kHeFSFileKindSymbolicLink = 0x06;
+inline constexpr uint16_t kHeFSFileKindUnknown      = 0x07;
+inline constexpr uint16_t kHeFSFileKindCount        = 0x08;
+
+// Red-black tree colors
+enum {
+  kHeFSInvalidColor = 0,
+  kHeFSRed          = 100,
+  kHeFSBlack,
+  kHeFSColorCount,
+};
+
+// Time constants
+inline constexpr ATime kHeFSTimeInvalid = 0x0000000000000000;
+inline constexpr ATime kHeFSTimeMax     = 0xFFFFFFFFFFFFFFFF - 1;
+
+// Boot Node
+struct __attribute__((packed)) BootNode {
+  char          magic[kHeFSMagicLen]{};
+  char8_t       volumeName[kHeFSPartNameLen]{};
+  std::uint32_t version{};
+  std::uint64_t badSectors{};
+  std::uint64_t sectorCount{};
+  std::uint64_t sectorSize{};
+  std::uint32_t checksum{};
+  std::uint8_t  diskKind{};
+  std::uint8_t  encoding{};
+  std::uint64_t startIND{};
+  std::uint64_t endIND{};
+  std::uint64_t indCount{};
+  std::uint64_t diskSize{};
+  std::uint16_t diskStatus{};
+  std::uint16_t diskFlags{};
+  std::uint16_t vid{};
+  std::uint64_t startIN{};
+  std::uint64_t endIN{};
+  std::uint64_t startBlock{};
+  std::uint64_t endBlock{};
+  char          pad[272]{};
+};
+}  // namespace mkfs::hefs
diff --git a/tools/libmkfs/mkfs.h b/tools/libmkfs/mkfs.h
new file mode 100644
index 00000000..e729c29b
--- /dev/null
+++ b/tools/libmkfs/mkfs.h
@@ -0,0 +1,83 @@
+/* -------------------------------------------
+
+  Copyright (C) 2025, Amlal El Mahrouss, all rights reserved.
+
+------------------------------------------- */
+
+#pragma once
+
+#include <tools/rang.h>
+#include <sstream>
+#include <iostream>
+#include <string>
+
+#define kMkFsSectorSz (512U)
+#define kMkFsMaxBadSectors (128U)
+
+/// @internal
+namespace mkfs {
+
+namespace detail {
+  /// @internal
+  /// @brief GB‐to‐byte conversion (use multiplication, not XOR).
+  inline constexpr size_t gib_cast(uint32_t gb) {
+    return static_cast<size_t>(gb) * 1024ULL * 1024ULL * 1024ULL;
+  }
+
+  inline bool parse_decimal(const std::string& opt, unsigned long long& out) {
+    if (opt.empty()) return false;
+    char*              endptr = nullptr;
+    unsigned long long val    = std::strtoull(opt.c_str(), &endptr, 10);
+    if (endptr == opt.c_str() || *endptr != '\0') return false;
+    out = val;
+    return true;
+  }
+
+  inline bool parse_signed(const std::string& opt, long& out, int base = 10) {
+    out = 0L;
+    
+    if (opt.empty()) return true;
+
+    char* endptr = nullptr;
+    long  val    = std::strtol(opt.c_str(), &endptr, base);
+    auto err = errno;
+    
+    if (err == ERANGE || err == EINVAL) return false;
+    if (endptr == opt.c_str() || *endptr != '\0') return false;
+
+    out = val;
+    return true;
+  }
+
+  inline std::string build_args(int argc, char** argv) {
+    std::string combined;
+    for (int i = 1; i < argc; ++i) {
+      combined += argv[i];
+      combined += ' ';
+    }
+    return combined;
+  }
+}  // namespace detail
+
+/// @brief Helper function to get the option value from command line arguments.
+template <typename CharType>
+inline std::basic_string<CharType> get_option(const std::basic_string<CharType>& args,
+                                              const std::basic_string<CharType>& option) {
+  size_t pos = args.find(option + CharType('='));
+
+  if (pos != std::string::npos) {
+    size_t start = pos + option.length() + 1;
+    size_t end   = args.find(' ', start);
+    return args.substr(start, end - start);
+  }
+
+  return std::basic_string<CharType>{};
+}
+
+inline auto console_out() -> std::ostream& {
+  std::ostream& conout = std::cout;
+  conout << rang::fg::red << "mkfs: " << rang::style::reset;
+
+  return conout;
+}
+}  // namespace mkfs
\ No newline at end of file