[codex] Use non-reserved header guards

AGENTS.md

@@ -39,3 +39,14 @@ Additional policy:
 - Runtime test expectations use `TIME_SHIELD_TEST_CHECK(...)` from
   `tests/test_assert.hpp`; avoid `<cassert>` / `assert(...)` for tests because
   Release/NDEBUG builds can compile them out.
+
+Header guard rules:
+
+- For every project-owned C/C++ header, use `#pragma once` together with a
+  non-reserved include guard derived from the project prefix and header path:
+  `TIME_SHIELD_HEADER_<PATH>_<FILE>_<EXT>_INCLUDED`.
+- For MQL include files, use non-reserved guards derived from the project,
+  language, and path, for example
+  `TIME_SHIELD_MQL5_HEADER_<PATH>_<FILE>_<EXT>_INCLUDED`.
+- Do not use guard names that start with an underscore, start with an underscore
+  followed by an uppercase letter, or contain a double underscore.

MQL5/Include/time_shield/DateTime.mqh

@@ -4,8 +4,8 @@
 //|                                      Copyright 2025, NewYaroslav |
 //|                   https://github.com/NewYaroslav/time-shield-cpp |
 //+------------------------------------------------------------------+
-#ifndef __TIME_SHIELD_DATE_TIME_MQH__
-#define __TIME_SHIELD_DATE_TIME_MQH__
+#ifndef TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_DATETIME_MQH_INCLUDED
+#define TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_DATETIME_MQH_INCLUDED
 
 /// \file DateTime.mqh
 /// \ingroup mql5
@@ -149,4 +149,4 @@ namespace time_shield {
 
 } // namespace time_shield
 
-#endif // __TIME_SHIELD_DATE_TIME_MQH__
+#endif // TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_DATETIME_MQH_INCLUDED

MQL5/Include/time_shield/constants.mqh

@@ -4,8 +4,8 @@
 //|                                      Copyright 2025, NewYaroslav |
 //|                   https://github.com/NewYaroslav/time-shield-cpp |
 //+------------------------------------------------------------------+
-#ifndef __TIME_SHIELD_CONSTANTS_MQH__
-#define __TIME_SHIELD_CONSTANTS_MQH__
+#ifndef TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_CONSTANTS_MQH_INCLUDED
+#define TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_CONSTANTS_MQH_INCLUDED
 
 /// \file constants.mqh
 /// \ingroup mql5
@@ -169,4 +169,4 @@ namespace time_shield {
 
 }; // namespace time_shield
 
-#endif // __TIME_SHIELD_CONSTANTS_MQH__
+#endif // TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_CONSTANTS_MQH_INCLUDED

MQL5/Include/time_shield/date_struct.mqh

@@ -4,8 +4,8 @@
 //|                                      Copyright 2025, NewYaroslav |
 //|                   https://github.com/NewYaroslav/time-shield-cpp |
 //+------------------------------------------------------------------+
-#ifndef __TIME_SHIELD_DATE_STRUCT_MQH__
-#define __TIME_SHIELD_DATE_STRUCT_MQH__
+#ifndef TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_DATE_STRUCT_MQH_INCLUDED
+#define TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_DATE_STRUCT_MQH_INCLUDED
 
 /// \file date_struct.mqh
 /// \ingroup mql5
@@ -44,4 +44,4 @@ namespace time_shield {
 
 }; // namespace time_shield
 
-#endif // __TIME_SHIELD_DATE_STRUCT_MQH__
+#endif // TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_DATE_STRUCT_MQH_INCLUDED

MQL5/Include/time_shield/date_time_struct.mqh

@@ -4,8 +4,8 @@
 //|                                      Copyright 2025, NewYaroslav |
 //|                   https://github.com/NewYaroslav/time-shield-cpp |
 //+------------------------------------------------------------------+
-#ifndef __TIME_SHIELD_DATE_TIME_STRUCT_MQH__
-#define __TIME_SHIELD_DATE_TIME_STRUCT_MQH__
+#ifndef TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_DATE_TIME_STRUCT_MQH_INCLUDED
+#define TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_DATE_TIME_STRUCT_MQH_INCLUDED
 
 /// \file date_time_struct.mqh
 /// \ingroup mql5
@@ -64,4 +64,4 @@ namespace time_shield {
 
 }; // namespace time_shield
 
-#endif // __TIME_SHIELD_DATE_TIME_STRUCT_MQH__
+#endif // TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_DATE_TIME_STRUCT_MQH_INCLUDED

MQL5/Include/time_shield/enums.mqh

@@ -4,8 +4,8 @@
 //|                                      Copyright 2025, NewYaroslav |
 //|                   https://github.com/NewYaroslav/time-shield-cpp |
 //+------------------------------------------------------------------+
-#ifndef __TIME_SHIELD_ENUMS_MQH__
-#define __TIME_SHIELD_ENUMS_MQH__
+#ifndef TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_ENUMS_MQH_INCLUDED
+#define TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_ENUMS_MQH_INCLUDED
 
 /// \file enums.mqh
 /// \ingroup mql5
@@ -226,4 +226,4 @@ namespace time_shield {
 
 }; // namespace time_shield
 
-#endif // __TIME_SHIELD_ENUMS_MQH__
+#endif // TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_ENUMS_MQH_INCLUDED

MQL5/Include/time_shield/initialization.mqh

@@ -4,8 +4,8 @@
 //|                                      Copyright 2025, NewYaroslav |
 //|                   https://github.com/NewYaroslav/time-shield-cpp |
 //+------------------------------------------------------------------+
-#ifndef __TIME_SHIELD_INITIALIZATION_MQH__
-#define __TIME_SHIELD_INITIALIZATION_MQH__
+#ifndef TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_INITIALIZATION_MQH_INCLUDED
+#define TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_INITIALIZATION_MQH_INCLUDED
 
 /// \file initialization.mqh
 /// \ingroup mql5
@@ -35,4 +35,4 @@ namespace time_shield {
 
 }; // namespace time_shield
 
-#endif // __TIME_SHIELD_INITIALIZATION_MQH__
+#endif // TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_INITIALIZATION_MQH_INCLUDED

MQL5/Include/time_shield/time_conversions.mqh

@@ -4,8 +4,8 @@
 //|                                      Copyright 2025, NewYaroslav |
 //|                   https://github.com/NewYaroslav/time-shield-cpp |
 //+------------------------------------------------------------------+
-#ifndef __TIME_SHIELD_TIME_CONVERSIONS_MQH__
-#define __TIME_SHIELD_TIME_CONVERSIONS_MQH__
+#ifndef TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_CONVERSIONS_MQH_INCLUDED
+#define TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_CONVERSIONS_MQH_INCLUDED
 
 /// \file time_conversions.mqh
 /// \ingroup mql5
@@ -1559,4 +1559,4 @@ double sec_to_fhour(long sec) {
 
 }; // namespace time_shield
 
-#endif // __TIME_SHIELD_TIME_CONVERSIONS_MQH__
+#endif // TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_CONVERSIONS_MQH_INCLUDED

MQL5/Include/time_shield/time_formatting.mqh

@@ -4,8 +4,8 @@
 //|                                      Copyright 2025, NewYaroslav |
 //|                   https://github.com/NewYaroslav/time-shield-cpp |
 //+------------------------------------------------------------------+
-#ifndef __TIME_SHIELD_TIME_FORMATTING_MQH__
-#define __TIME_SHIELD_TIME_FORMATTING_MQH__
+#ifndef TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_FORMATTING_MQH_INCLUDED
+#define TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_FORMATTING_MQH_INCLUDED
 
 /// \file time_formatting.mqh
 /// \ingroup mql5
@@ -483,4 +483,4 @@ namespace time_shield {
 
 }; // namespace time_shield
 
-#endif // __TIME_SHIELD_TIME_FORMATTING_MQH__
+#endif // TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_FORMATTING_MQH_INCLUDED

MQL5/Include/time_shield/time_parser.mqh

@@ -4,8 +4,8 @@
 //|                                      Copyright 2025, NewYaroslav |
 //|                   https://github.com/NewYaroslav/time-shield-cpp |
 //+------------------------------------------------------------------+
-#ifndef __TIME_SHIELD_TIME_PARSER_MQH__
-#define __TIME_SHIELD_TIME_PARSER_MQH__
+#ifndef TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_PARSER_MQH_INCLUDED
+#define TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_PARSER_MQH_INCLUDED
 
 /// \file time_parser.mqh
 /// \ingroup mql5
@@ -690,4 +690,4 @@ namespace time_shield {
 
 }; // namespace time_shield
 
-#endif // __TIME_SHIELD_TIME_PARSER_MQH__
+#endif // TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_PARSER_MQH_INCLUDED

MQL5/Include/time_shield/time_struct.mqh

@@ -4,8 +4,8 @@
 //|                                      Copyright 2025, NewYaroslav |
 //|                   https://github.com/NewYaroslav/time-shield-cpp |
 //+------------------------------------------------------------------+
-#ifndef __TIME_SHIELD_TIME_STRUCT_MQH__
-#define __TIME_SHIELD_TIME_STRUCT_MQH__
+#ifndef TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_STRUCT_MQH_INCLUDED
+#define TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_STRUCT_MQH_INCLUDED
 
 /// \file time_struct.mqh
 /// \ingroup mql5
@@ -52,4 +52,4 @@ namespace time_shield {
 
 }; // namespace time_shield
 
-#endif // __TIME_SHIELD_TIME_STRUCT_MQH__
+#endif // TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_STRUCT_MQH_INCLUDED

MQL5/Include/time_shield/time_utils.mqh

@@ -4,8 +4,8 @@
 //|                                      Copyright 2025, NewYaroslav |
 //|                   https://github.com/NewYaroslav/time-shield-cpp |
 //+------------------------------------------------------------------+
-#ifndef __TIME_SHIELD_TIME_UTILS_MQH__
-#define __TIME_SHIELD_TIME_UTILS_MQH__
+#ifndef TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_UTILS_MQH_INCLUDED
+#define TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_UTILS_MQH_INCLUDED
 
 /// \file time_utils.mqh
 /// \ingroup mql5
@@ -112,4 +112,4 @@ namespace time_shield {
 
 }; // namespace time_shield
 
-#endif // __TIME_SHIELD_TIME_UTILS_MQH__
+#endif // TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_UTILS_MQH_INCLUDED

MQL5/Include/time_shield/time_zone_conversions.mqh

@@ -4,8 +4,8 @@
 //|                                      Copyright 2025, NewYaroslav |
 //|                   https://github.com/NewYaroslav/time-shield-cpp |
 //+------------------------------------------------------------------+
-#ifndef __TIME_SHIELD_TIME_ZONE_CONVERSIONS_MQH__
-#define __TIME_SHIELD_TIME_ZONE_CONVERSIONS_MQH__
+#ifndef TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_ZONE_CONVERSIONS_MQH_INCLUDED
+#define TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_ZONE_CONVERSIONS_MQH_INCLUDED
 
 /// \file time_zone_conversions.mqh
 /// \ingroup mql5
@@ -445,4 +445,4 @@ namespace time_shield {
 
 }; // namespace time_shield
 
-#endif // __TIME_SHIELD_TIME_ZONE_CONVERSIONS_MQH__
+#endif // TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_ZONE_CONVERSIONS_MQH_INCLUDED

MQL5/Include/time_shield/time_zone_struct.mqh

@@ -4,8 +4,8 @@
 //|                                      Copyright 2025, NewYaroslav |
 //|                   https://github.com/NewYaroslav/time-shield-cpp |
 //+------------------------------------------------------------------+
-#ifndef __TIME_SHIELD_TIME_ZONE_STRUCT_MQH__
-#define __TIME_SHIELD_TIME_ZONE_STRUCT_MQH__
+#ifndef TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_ZONE_STRUCT_MQH_INCLUDED
+#define TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_ZONE_STRUCT_MQH_INCLUDED
 
 /// \file time_zone_struct.mqh
 /// \ingroup mql5
@@ -138,4 +138,4 @@ namespace time_shield {
 
 }; // namespace time_shield
 
-#endif // __TIME_SHIELD_TIME_ZONE_STRUCT_MQH__
+#endif // TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_TIME_ZONE_STRUCT_MQH_INCLUDED

MQL5/Include/time_shield/validation.mqh

@@ -4,8 +4,8 @@
 //|                                      Copyright 2025, NewYaroslav |
 //|                   https://github.com/NewYaroslav/time-shield-cpp |
 //+------------------------------------------------------------------+
-#ifndef __TIME_SHIELD_VALIDATION_MQH__
-#define __TIME_SHIELD_VALIDATION_MQH__
+#ifndef TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_VALIDATION_MQH_INCLUDED
+#define TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_VALIDATION_MQH_INCLUDED
 
 /// \file validation.mqh
 /// \ingroup mql5
@@ -303,4 +303,4 @@ namespace time_shield {
 
 }; // namespace time_shield
 
-#endif // __TIME_SHIELD_VALIDATION_MQH__
+#endif // TIME_SHIELD_MQL5_HEADER_TIME_SHIELD_VALIDATION_MQH_INCLUDED

agents/cpp-development-guidelines.md

@@ -51,7 +51,14 @@
 - Keep opening braces on the same line for classes, methods, and namespaces.
 - Do not use `using namespace`; always qualify names (for example `std::`).
 - Keep project headers before system headers in include lists.
-- Header files must start with `#pragma once`; if an include guard is additionally used, prefer `_MGC_PLATFORM_*_HPP_INCLUDED`.
+- Header files must start with `#pragma once` and a non-reserved include guard
+  derived from the project prefix and header path:
+  `TIME_SHIELD_HEADER_<PATH>_<FILE>_<EXT>_INCLUDED`.
+- MQL include files use non-reserved guards derived from the project, language,
+  and path, for example
+  `TIME_SHIELD_MQL5_HEADER_<PATH>_<FILE>_<EXT>_INCLUDED`.
+- Do not use guard names that start with an underscore, start with an
+  underscore followed by an uppercase letter, or contain a double underscore.
 
 ## Header / Implementation ownership
 

include/time_shield.hpp

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: MIT
 #pragma once
-#ifndef _TIME_SHIELD_HPP_INCLUDED
-#define _TIME_SHIELD_HPP_INCLUDED
+#ifndef TIME_SHIELD_HEADER_TIME_SHIELD_HPP_INCLUDED
+#define TIME_SHIELD_HEADER_TIME_SHIELD_HPP_INCLUDED
 
 /// \file time_shield.hpp
 /// \brief Main header file for the Time Shield library.
@@ -62,4 +62,4 @@ namespace tshield = time_shield;
 /// - timers and scheduling utilities
 namespace time_shield {};
 
-#endif // _TIME_SHIELD_HPP_INCLUDED
+#endif // TIME_SHIELD_HEADER_TIME_SHIELD_HPP_INCLUDED

include/time_shield/CpuTickTimer.hpp

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: MIT
 #pragma once
-#ifndef _TIME_SHIELD_CPU_TICK_TIMER_HPP_INCLUDED
-#define _TIME_SHIELD_CPU_TICK_TIMER_HPP_INCLUDED
+#ifndef TIME_SHIELD_HEADER_TIME_SHIELD_CPUTICKTIMER_HPP_INCLUDED
+#define TIME_SHIELD_HEADER_TIME_SHIELD_CPUTICKTIMER_HPP_INCLUDED
 
 /// \file CpuTickTimer.hpp
 /// \brief Helper class for measuring CPU time using get_cpu_time().
@@ -134,4 +134,4 @@ namespace time_shield {
 
 } // namespace time_shield
 
-#endif // _TIME_SHIELD_CPU_TICK_TIMER_HPP_INCLUDED
+#endif // TIME_SHIELD_HEADER_TIME_SHIELD_CPUTICKTIMER_HPP_INCLUDED

include/time_shield/DateTime.hpp

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: MIT
 #pragma once
-#ifndef _TIME_SHIELD_DATE_TIME_HPP_INCLUDED
-#define _TIME_SHIELD_DATE_TIME_HPP_INCLUDED
+#ifndef TIME_SHIELD_HEADER_TIME_SHIELD_DATETIME_HPP_INCLUDED
+#define TIME_SHIELD_HEADER_TIME_SHIELD_DATETIME_HPP_INCLUDED
 
 /// \file DateTime.hpp
 /// \brief Value-type wrapper for timestamps with fixed UTC offset.
@@ -711,4 +711,4 @@ namespace time_shield {
 
 } // namespace time_shield
 
-#endif // _TIME_SHIELD_DATE_TIME_HPP_INCLUDED
+#endif // TIME_SHIELD_HEADER_TIME_SHIELD_DATETIME_HPP_INCLUDED

include/time_shield/DeadlineTimer.hpp

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: MIT
 #pragma once
-#ifndef _TIME_SHIELD_DEADLINE_TIMER_HPP_INCLUDED
-#define _TIME_SHIELD_DEADLINE_TIMER_HPP_INCLUDED
+#ifndef TIME_SHIELD_HEADER_TIME_SHIELD_DEADLINETIMER_HPP_INCLUDED
+#define TIME_SHIELD_HEADER_TIME_SHIELD_DEADLINETIMER_HPP_INCLUDED
 
 /// \file DeadlineTimer.hpp
 /// \brief Monotonic deadline timer utility similar to Qt's QDeadlineTimer.
@@ -241,4 +241,4 @@ namespace time_shield {
 
 } // namespace time_shield
 
-#endif // _TIME_SHIELD_DEADLINE_TIMER_HPP_INCLUDED
+#endif // TIME_SHIELD_HEADER_TIME_SHIELD_DEADLINETIMER_HPP_INCLUDED

include/time_shield/ElapsedTimer.hpp

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: MIT
 #pragma once
-#ifndef _TIME_SHIELD_ELAPSED_TIMER_HPP_INCLUDED
-#define _TIME_SHIELD_ELAPSED_TIMER_HPP_INCLUDED
+#ifndef TIME_SHIELD_HEADER_TIME_SHIELD_ELAPSEDTIMER_HPP_INCLUDED
+#define TIME_SHIELD_HEADER_TIME_SHIELD_ELAPSEDTIMER_HPP_INCLUDED
 
 /// \file ElapsedTimer.hpp
 /// \brief High-precision elapsed time measurement helper similar to Qt's QElapsedTimer.
@@ -185,4 +185,4 @@ namespace time_shield {
 
 } // namespace time_shield
 
-#endif // _TIME_SHIELD_ELAPSED_TIMER_HPP_INCLUDED
+#endif // TIME_SHIELD_HEADER_TIME_SHIELD_ELAPSEDTIMER_HPP_INCLUDED

include/time_shield/MoonPhase.hpp

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: MIT
 #pragma once
-#ifndef _TIME_SHIELD_MOON_PHASE_HPP_INCLUDED
-#define _TIME_SHIELD_MOON_PHASE_HPP_INCLUDED
+#ifndef TIME_SHIELD_HEADER_TIME_SHIELD_MOONPHASE_HPP_INCLUDED
+#define TIME_SHIELD_HEADER_TIME_SHIELD_MOONPHASE_HPP_INCLUDED
 
 /// \file MoonPhase.hpp
 /// \brief Geocentric Moon phase calculator and result helpers.
@@ -400,4 +400,4 @@ namespace astronomy {
 
 } // namespace time_shield
 
-#endif // _TIME_SHIELD_MOON_PHASE_HPP_INCLUDED
+#endif // TIME_SHIELD_HEADER_TIME_SHIELD_MOONPHASE_HPP_INCLUDED

include/time_shield/TimerScheduler.hpp

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: MIT
 #pragma once
-#ifndef _TIME_SHIELD_TIMER_SCHEDULER_HPP_INCLUDED
-#define _TIME_SHIELD_TIMER_SCHEDULER_HPP_INCLUDED
+#ifndef TIME_SHIELD_HEADER_TIME_SHIELD_TIMERSCHEDULER_HPP_INCLUDED
+#define TIME_SHIELD_HEADER_TIME_SHIELD_TIMERSCHEDULER_HPP_INCLUDED
 
 /// \file TimerScheduler.hpp
 /// \brief Timer scheduler that provides Qt-like timer functionality.
@@ -647,4 +647,4 @@ namespace time_shield {
 
 } // namespace time_shield
 
-#endif // _TIME_SHIELD_TIMER_SCHEDULER_HPP_INCLUDED
+#endif // TIME_SHIELD_HEADER_TIME_SHIELD_TIMERSCHEDULER_HPP_INCLUDED

include/time_shield/ZonedClock.hpp

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: MIT
 #pragma once
-#ifndef _TIME_SHIELD_ZONED_CLOCK_HPP_INCLUDED
-#define _TIME_SHIELD_ZONED_CLOCK_HPP_INCLUDED
+#ifndef TIME_SHIELD_HEADER_TIME_SHIELD_ZONEDCLOCK_HPP_INCLUDED
+#define TIME_SHIELD_HEADER_TIME_SHIELD_ZONEDCLOCK_HPP_INCLUDED
 
 /// \file ZonedClock.hpp
 /// \brief Header-only clock wrapper for named zones, fixed offsets, and optional NTP-backed UTC time.
@@ -369,4 +369,4 @@ namespace time_shield {
 
 } // namespace time_shield
 
-#endif // _TIME_SHIELD_ZONED_CLOCK_HPP_INCLUDED
+#endif // TIME_SHIELD_HEADER_TIME_SHIELD_ZONEDCLOCK_HPP_INCLUDED