chore(libpath): gold helpers, modular CI, and Phase 8 docs

Bring libpath to the Synesis C/C++ gold bar on boilerplate:
- Copy examples/scratch runners from cmake-helpers @dfa6add; keep
  prepare_cmake.sh SimulateWindowsOnUnix and --stlsoft-root-dir;
- Set test.scratch.versions PROGRAM_NAME; drop dead PRIVATE STLSoft link
  from core; absorb MSVC_USE_MT; register unit tests via add_test; fix
  test.unit.parse.c Windows offsets / UNC compile;
- Add install-sis-deps, ci.yml + ci-cell (STLSoft xTests), Windows .cmd
  dogfood, execute-bit restore, install-smoke; README CI badge;
- Create CHANGES.md from HISTORY, upgrade NEWS to three-column Details,
  remove subsumed HISTORY.md; list example.cpp.parse.1 as allowed-to-fail;

Author: synesissoftware

cmake/TargetMacros.cmake

@@ -54,6 +54,11 @@ function(define_automated_test_program program_name entry_point_source_name)
 			${X_MSVC_CUSTOM_WARNINGS_}
 		>
 	)
+
+	add_test(
+		NAME ${program_name}
+		COMMAND ${program_name}
+	)
 endfunction(define_automated_test_program)
 
 

test/unit/test.unit.parse.c/test.unit.parse.c.c

@@ -4,7 +4,7 @@
  * Purpose: Implementation file for the test.unit.parse.c project.
  *
  * Created: 9th November 2012
- * Updated: 15th March 2025
+ * Updated: 13th October 2026
  *
  * ////////////////////////////////////////////////////////////////////// */
 
@@ -1708,7 +1708,7 @@ static void test_Windows_bad_characters(void)
 
     XTESTS_TEST_ENUM_EQUAL(libpath_ResultCode_BadPathCharacter, rc);
     XTESTS_TEST_INTEGER_EQUAL(15u, r.input.len);
-    XTESTS_TEST_INTEGER_EQUAL(0u, &firstBadCharOffset);
+    XTESTS_TEST_INTEGER_EQUAL(0u, firstBadCharOffset);
 
 
     rc = libpath_Parse_ParsePathFromCStyleString("C:\\dir\\file.ext", 0, &r, 0, LIBPATH_LF_nullptr, &firstBadCharOffset);
@@ -1721,36 +1721,36 @@ static void test_Windows_bad_characters(void)
 
     XTESTS_TEST_ENUM_EQUAL(libpath_ResultCode_BadPathCharacter, rc);
     XTESTS_TEST_INTEGER_EQUAL(15u, r.input.len);
-    XTESTS_TEST_INTEGER_EQUAL(2u, &firstBadCharOffset);
+    XTESTS_TEST_INTEGER_EQUAL(2u, firstBadCharOffset);
 
 
     rc = libpath_Parse_ParsePathFromCStyleString("C\\d:ir\\file.ext", 0, &r, 0, LIBPATH_LF_nullptr, &firstBadCharOffset);
 
     XTESTS_TEST_ENUM_EQUAL(libpath_ResultCode_BadPathCharacter, rc);
     XTESTS_TEST_INTEGER_EQUAL(15u, r.input.len);
-    XTESTS_TEST_INTEGER_EQUAL(3u, &firstBadCharOffset);
+    XTESTS_TEST_INTEGER_EQUAL(3u, firstBadCharOffset);
 
 
     rc = libpath_Parse_ParsePathFromCStyleString("C\\di:r\\file.ext", 0, &r, 0, LIBPATH_LF_nullptr, &firstBadCharOffset);
 
     XTESTS_TEST_ENUM_EQUAL(libpath_ResultCode_BadPathCharacter, rc);
     XTESTS_TEST_INTEGER_EQUAL(15u, r.input.len);
-    XTESTS_TEST_INTEGER_EQUAL(4u, &firstBadCharOffset);
+    XTESTS_TEST_INTEGER_EQUAL(4u, firstBadCharOffset);
 
 
     rc = libpath_Parse_ParsePathFromCStyleString("C\\dir:\\file.ext", 0, &r, 0, LIBPATH_LF_nullptr, &firstBadCharOffset);
 
     XTESTS_TEST_ENUM_EQUAL(libpath_ResultCode_BadPathCharacter, rc);
     XTESTS_TEST_INTEGER_EQUAL(15u, r.input.len);
-    XTESTS_TEST_INTEGER_EQUAL(5u, &firstBadCharOffset);
+    XTESTS_TEST_INTEGER_EQUAL(5u, firstBadCharOffset);
 
 
 
     rc = libpath_Parse_ParsePathFromCStyleString("\\:Cdir\\file.ext", 0, &r, 0, LIBPATH_LF_nullptr, &firstBadCharOffset);
 
     XTESTS_TEST_ENUM_EQUAL(libpath_ResultCode_BadPathCharacter, rc);
     XTESTS_TEST_INTEGER_EQUAL(15u, r.input.len);
-    XTESTS_TEST_INTEGER_EQUAL(1u, &firstBadCharOffset);
+    XTESTS_TEST_INTEGER_EQUAL(1u, firstBadCharOffset);
 #endif
 }
 
@@ -2109,7 +2109,7 @@ static void test_Windows_UNC_share_with_charwise_steps(void)
     { libpath_size_t i; for (i = 0; i <= cch; ++i)
     {
         libpath_ParseResult_t   r;
-        LIBPATH_RC const        rc = libpath_Parse_ParsePathFromStringPtrAndLen(input, i, 0, &r, 0, LIBPATH_LF_nullptr, &firstBadCharOffset);
+        LIBPATH_RC const        rc = libpath_Parse_ParsePathFromStringPtrAndLen(input, i, 0, &r, 0, LIBPATH_LF_nullptr, LIBPATH_LF_nullptr);
 
         if (1 == i ||
             cch == i)