Doug/laughing davinci stc796

.github/workflows/arduino-build.yml

@@ -87,6 +87,8 @@ jobs:
         example: ${{ fromJson(needs.discover.outputs.matrix) }}
     steps:
       - uses: actions/checkout@v7
+        with:
+          submodules: true # include/MMgr: src/ builds against it
       - uses: arduino/setup-arduino-cli@v2
       # Restore-only: the build job wraps the toolchain in place for ccache, so it must never
       # save ~/.arduino15 back (a wrapped/half-wrapped tree in the cache is what broke every

.github/workflows/codeql.yml

@@ -40,6 +40,8 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v7
+        with:
+          submodules: true # include/MMgr: src/ builds against it
 
       - name: Set up Python
         uses: actions/setup-python@v7

.github/workflows/esp-idf-build.yml

@@ -51,6 +51,8 @@ jobs:
         idf: [v5.5]
     steps:
       - uses: actions/checkout@v7
+        with:
+          submodules: true # include/MMgr: src/ builds against it
 
       # arduino-esp32 is fetched from the ESP Component Registry on first build (minutes), and
       # lands in the example's own managed_components/. Keyed on the manifest, which is what

.github/workflows/esp32-build.yml

@@ -69,6 +69,8 @@ jobs:
         example: ${{ fromJson(needs.discover.outputs.matrix) }}
     steps:
       - uses: actions/checkout@v7
+        with:
+          submodules: true # include/MMgr: src/ builds against it
       - uses: actions/setup-python@v7
         with:
           python-version: "3.x"

.github/workflows/pentest.yml

@@ -13,6 +13,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7
+        with:
+          submodules: true # include/MMgr: src/ builds against it
 
       - name: Set up Python
         uses: actions/setup-python@v7

.github/workflows/release.yml

@@ -15,6 +15,7 @@ jobs:
       - name: Checkout Code
         uses: actions/checkout@v7
         with:
+          submodules: true # include/MMgr: src/ builds against it
           path: "library-source"
           # Full history + tags so the release summary can diff against the previous tag.
           fetch-depth: 0
@@ -102,6 +103,8 @@ jobs:
     steps:
       - name: Checkout Code
         uses: actions/checkout@v7
+        with:
+          submodules: true # include/MMgr: src/ builds against it
 
       - name: Check for PlatformIO token
         id: token

.github/workflows/sonar.yml

@@ -36,6 +36,7 @@ jobs:
     steps:
       - uses: actions/checkout@v7
         with:
+          submodules: true # include/MMgr: src/ builds against it
           fetch-depth: 0 # full history: SonarCloud attributes findings to new code by commit date
 
       - uses: actions/setup-python@v7

.github/workflows/test-report.yml

@@ -52,6 +52,7 @@ jobs:
     steps:
       - uses: actions/checkout@v7
         with:
+          submodules: true # include/MMgr: src/ builds against it
           fetch-depth: 0 # full history: the diff base, the report commit, SonarCloud new-code attribution
           # Authenticate with the automatic-actions deploy key so the report commit pushes over SSH
           # (past the protected-main ruleset), which a GITHUB_TOKEN push cannot.

.gitmodules

@@ -2,3 +2,6 @@
 	path = include/MMgr
 	url = https://github.com/dstroy0/MMgr.git
 	branch = main
+[submodule "include/embedded_types"]
+	path = include/embedded_types
+	url = https://github.com/dstroy0/embedded_types.git

cspell.json

@@ -1668,6 +1668,7 @@
     "**/*.der",
     "**/*.gz",
     "test/dep_graph.json",
-    "test/compile_commands.json"
+    "test/compile_commands.json",
+    "docs/CHANGELOG.md"
   ]
 }

include/CMakeLists.txt

@@ -12,18 +12,52 @@ protocore_add_module(include
   HEADER_ONLY
 )
 
-# MMgr is a separate repository, vendored as a submodule, and brings its own build description. Its
-# ROOT is the entry, not its src/: that is where mmgr_add_module() is defined, and every directory
-# below it calls that. Entering src/ directly fails on the first module.
+# MMgr is a separate repository, vendored as a submodule. Its own build description is not entered:
+# it builds MMgr once per width environment for MMgr's suites, and it reaches its include root
+# through CMAKE_SOURCE_DIR, which names this tree's top rather than MMgr's once it is a
+# subdirectory. ProtoCore builds MMgr's sources as one more target under ProtoCore's own flags, as
+# the Arduino, PlatformIO and ESP-IDF builds do.
 #
-# ITS BINARY DIRECTORY IS ONE CHARACTER, and that is not tidiness. A Windows path is capped at 260
-# characters, and MMgr's own deepest suite spends 211 of them before the object file:
-# test/unit/confinium_exclusivum_infinitas/test_confinium_exclusivum_infinitas/CMakeFiles/
-# test_confinium_exclusivum_infinitas_host.dir - the module name three times over. Two of that
-# suite's sources live in test/support/ rather than beside it, so CMake namespaces them under a
-# 32-character hash of their directory, and gcc then cannot create the .d file beside the object.
-# Five targets failed to compile that way under `<build>/pc_include/mmgr`. Under `<build>/m` they
-# fit. Nested one directory deeper and they would not, so this is load bearing.
-if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/MMgr/CMakeLists.txt")
-  add_subdirectory(MMgr "${CMAKE_BINARY_DIR}/m")
+# The sources are the ones MMgr's src/CMakeLists.txt enters, module for module. A directory it does
+# not enter is not part of MMgr's build, and impensa_ancorae_acus compiles one profile of five, the
+# one MMGR_ANCORAE_FORMA names and generic when nothing does, since each defines the same table.
+#
+# The include roots are the three MMgr's mmgr_add_module() gives a module: include/ for mmgr.h,
+# src/ so a module header is reached as <module>/<module>.h, and embedded_types, which mmgr.h
+# includes. The capability switches are MMgr's defaults, stated so every translation unit that reads
+# them sees the same value.
+if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/MMgr/src")
+  if(DEFINED MMGR_ANCORAE_FORMA)
+    string(TOLOWER "${MMGR_ANCORAE_FORMA}" _pc_mmgr_forma)
+  else()
+    set(_pc_mmgr_forma generic)
+  endif()
+  set(_pc_mmgr_src "${CMAKE_CURRENT_SOURCE_DIR}/MMgr/src")
+  add_library(pc_mmgr OBJECT
+    "${_pc_mmgr_src}/clz/clz.c"
+    "${_pc_mmgr_src}/impensa_ancorae_acus/impensa_ancorae_acus_${_pc_mmgr_forma}.c"
+    "${_pc_mmgr_src}/ascii_persona_bitorum/ascii_persona_bitorum.c"
+    "${_pc_mmgr_src}/bitorum_introitus_exitus/bitorum_introitus_exitus.c"
+    "${_pc_mmgr_src}/endian/endian.c"
+    "${_pc_mmgr_src}/proximus_operor/proximus_operor.c"
+    "${_pc_mmgr_src}/verbum_scrutor/verbum_scrutor.c"
+    "${_pc_mmgr_src}/memoria_operor/memoria_operor.c"
+    "${_pc_mmgr_src}/cellularum_laboro/cellularum_laboro.c"
+    "${_pc_mmgr_src}/spatium/spatium.c"
+    "${_pc_mmgr_src}/octetus_introitus_exitus/octetus_introitus_exitus.c"
+    "${_pc_mmgr_src}/locus_carcerum/locus_carcerum.c"
+    "${_pc_mmgr_src}/memoria_anularis/memoria_anularis.c"
+    "${_pc_mmgr_src}/memoria_externa/memoria_externa.c"
+    "${_pc_mmgr_src}/transformo/transformo.c"
+    "${_pc_mmgr_src}/memoriam_praetereo/memoriam_praetereo.c"
+    "${_pc_mmgr_src}/memoriam_praetereo/praet_ordo.c"
+    "${_pc_mmgr_src}/memoriam_praetereo/praet_descriptor.c"
+    "${_pc_mmgr_src}/fractio/fractio.c"
+    "${_pc_mmgr_src}/verba_scribo/verba_scribo.c"
+    "${_pc_mmgr_src}/numeros_scribo/numeros_scribo.c")
+  target_include_directories(pc_mmgr PUBLIC
+    "${CMAKE_CURRENT_SOURCE_DIR}/MMgr/include"
+    "${CMAKE_CURRENT_SOURCE_DIR}/MMgr/src"
+    "${CMAKE_CURRENT_SOURCE_DIR}/embedded_types/include")
+  target_compile_definitions(pc_mmgr PUBLIC MMGR_ENABLE_DMA=0 MMGR_ENABLE_EXTRAM=0)
 endif()

include/protocore.h

@@ -127,12 +127,7 @@ typedef struct WebServerConfig
 // protocore.h is the one header an application includes, so every service the library offers is
 // reachable from it. A feature the build did not enable costs nothing: each service header carries
 // its own PROTOCORE_ENABLE_ guard, so a disabled one contributes no declarations and no code.
-#include "mmgr/arena/arena.h"
-#include "mmgr/dma/dma.h"
-#include "mmgr/plaintext/plaintext.h"
-#include "mmgr/psram_pool/psram_pool.h"
-#include "mmgr/secure/secure.h"
-#include "mmgr/span/span.h"
+#include "locus_carcerum/locus_carcerum.h"
 #include "network_drivers/application/file_serving/file_serving.h"
 #include "network_drivers/application/http_range/http_range.h"
 #include "network_drivers/application/mdns_adaptive/mdns_adaptive.h"