Centralize and document TRACE tags using X-macros (#7657)

* Introduce X-macro-based trace tag definition
- Created trace_tags.def to centralize TRACE tag definitions
- Each tag includes a symbolic name and description
- Set up enum class TraceTag for type-safe usage in TRACE macros

* Add script to generate Markdown documentation from trace_tags.def
- Python script parses trace_tags.def and outputs trace_tags.md

* Refactor TRACE_NEW to prepend TraceTag and pass enum to is_trace_enabled

* trace: improve trace tag handling system with hierarchical tagging

- Introduce hierarchical tag-class structure: enabling a tag class activates all child tags
- Unify TRACE, STRACE, SCTRACE, and CTRACE under enum TraceTag
- Implement initial version of trace_tag.def using X(tag, tag_class, description)
  (class names and descriptions to be refined in a future update)

* trace: replace all string-based TRACE tags with enum TraceTag
- Migrated all TRACE, STRACE, SCTRACE, and CTRACE macros to use enum TraceTag values instead of raw string literals

* trace : add cstring header

* trace : Add Markdown documentation generation from trace_tags.def via mk_api_doc.py

* trace : rename macro parameter 'class' to 'tag_class' and remove Unicode comment in trace_tags.h.

* trace : Add TODO comment for future implementation of tag_class activation

* trace : Disable code related to tag_class until implementation is ready (#7663).

src/math/lp/nla_common.cpp

@@ -99,11 +99,11 @@ nex * common::nexvar(const rational & coeff, lpvar j, nex_creator& cn, u_depende
         else {
             c().insert_to_active_var_set(k);
             mf *= cn.mk_var(k);
-            CTRACE("nla_grobner", c().is_monic_var(k), c().print_var(k, tout) << "\n";);
+            CTRACE(nla_grobner, c().is_monic_var(k), c().print_var(k, tout) << "\n";);
         }
     }
     nex* e = mf.mk();
-    TRACE("nla_grobner", tout << *e;);
+    TRACE(nla_grobner, tout << *e;);
     return e;
 }
 
@@ -113,7 +113,7 @@ template <typename T> void common::create_sum_from_row(const T& row,
                                                        nex_creator::sum_factory& sum,
                                                        u_dependency*& dep) {
 
-    TRACE("nla_horner", tout << "row="; m_core.print_row(row, tout) << "\n";);
+    TRACE(nla_horner, tout << "row="; m_core.print_row(row, tout) << "\n";);
     SASSERT(row.size() > 1);
     sum.reset();
     for (const auto &p : row) {