test(@angular/cli): add CI validation for MCP example code

This commit introduces a new CI check to validate the correctness of code snippets and markdown structure within the `find_examples` markdown files.

To support this, the previous `validate_examples.js` and `example_db_generator.js` scripts have been refactored and consolidated into a single, unified, mode-driven script: `process_examples.mjs`. This improves maintainability and ensures consistent parsing and validation logic.

The new script provides two new validation modes for CI:
- `validate-structure`: Parses all examples to validate their front matter and ensure they adhere to the required markdown heading structure.
- `validate-code`: Uses a pre-built Angular application harness to perform a full `ng build` on all example code, ensuring compilation and template correctness.

This provides a strong guarantee of the quality and reliability of the code and structure of all examples served by the `find_examples` tool.

Author: clydin

.github/workflows/ci.yml

@@ -39,6 +39,10 @@ jobs:
         run: pnpm admin validate
       - name: Check tooling setup
         run: pnpm check-tooling-setup
+      - name: Validate Example Markdown Structure
+        run: pnpm bazel run //tools:validate_examples_structure
+      - name: Validate Example Code Compilation
+        run: pnpm bazel run //tools:validate_examples_code
 
   build:
     runs-on: ubuntu-latest

package.json

@@ -124,6 +124,7 @@
     "listr2": "9.0.3",
     "lodash": "^4.17.21",
     "magic-string": "0.30.19",
+    "marked": "^16.2.1",
     "npm": "^11.0.0",
     "prettier": "^3.0.0",
     "protractor": "~7.0.0",

pnpm-lock.yaml

@@ -34,8 +34,9 @@ js_binary(
 js_binary(
     name = "ng_example_db",
     data = [
-        "example_db_generator.js",
+        "process_examples.mjs",
+        "//:node_modules/marked",
         "//:node_modules/zod",
     ],
-    entry_point = "example_db_generator.js",
+    entry_point = "process_examples.mjs",
 )

tools/BUILD.bazel

@@ -8,5 +8,5 @@ def cli_example_db(name, srcs, path, out, data = []):
         tool = "//tools:ng_example_db",
         progress_message = "Generating code example database from %s" % path,
         mnemonic = "NgExampleSqliteDb",
-        args = [path, "$(rootpath %s)" % out],
+        args = ["--mode generate-db", "--output $(rootpath %s)" % out, path],
     )