Add cross-language parity and example output contract checks

Author: lucasbellesi

CONTRIBUTING.md

@@ -45,6 +45,16 @@ Validate checkpoint completeness with:
 - `./scripts/check-checkpoint-completeness.ps1` (PowerShell)
 - `bash ./scripts/check-checkpoint-completeness.sh` (Bash)
 
+Validate cross-language parity with:
+
+- `./scripts/check-cross-language-parity.ps1` (PowerShell)
+- `bash ./scripts/check-cross-language-parity.sh` (Bash)
+
+Validate example output contracts with:
+
+- `./scripts/check-example-output-contracts.ps1` (PowerShell)
+- `bash ./scripts/check-example-output-contracts.sh` (Bash)
+
 Run full repository checks with:
 
 - `./scripts/verify-repo.ps1` (PowerShell)

README.md

@@ -155,6 +155,8 @@ Run checks locally:
 ./scripts/check-readme-structure.ps1
 ./scripts/check-module-completeness.ps1
 ./scripts/check-checkpoint-completeness.ps1
+./scripts/check-cross-language-parity.ps1
+./scripts/check-example-output-contracts.ps1
 ./scripts/audit-education-quality.ps1
 ./scripts/lint.ps1
 ./scripts/smoke-languages.ps1
@@ -167,6 +169,8 @@ bash ./scripts/check-links.sh
 bash ./scripts/check-readme-structure.sh
 bash ./scripts/check-module-completeness.sh
 bash ./scripts/check-checkpoint-completeness.sh
+bash ./scripts/check-cross-language-parity.sh
+bash ./scripts/check-example-output-contracts.sh
 bash ./scripts/audit-education-quality.sh
 bash ./scripts/lint.sh
 bash ./scripts/smoke-languages.sh
@@ -182,7 +186,7 @@ The multi-language smoke scripts also compile standalone C# exercises by generat
 
 Use [EDUCATIONAL_EXAMPLE_REVIEW_RUBRIC.md](EDUCATIONAL_EXAMPLE_REVIEW_RUBRIC.md) to keep entry examples pedagogically consistent during reviews. The education audit command is advisory and writes markdown/json findings without failing CI.
 
-Documentation sync also validates that [CONCEPT_INDEX.md](CONCEPT_INDEX.md) covers every implemented module and checkpoint path listed in the automation manifest.
+Documentation sync also validates that [CONCEPT_INDEX.md](CONCEPT_INDEX.md) covers every implemented module and checkpoint path listed in the automation manifest. Cross-language parity checks now validate module focus/teaching headers across tracks, and example output contracts validate stable learner-visible output for smoke-targeted examples.
 
 ## Contributing
 

languages/cpp/04-expert/smart-pointers-in-depth/example/main.cpp

@@ -1,6 +1,6 @@
-// Module focus: Smart pointers in depth.
-// Why it matters: practicing smart pointers in depth patterns makes exercises and checkpoints
-// easier to reason about.
+// Module focus: Tracking ownership and lifetime when multiple references can observe the same
+// value. Why it matters: practicing smart pointers in depth patterns makes exercises and
+// checkpoints easier to reason about.
 
 // This example shows tracking ownership and lifetime when multiple references can observe the same
 // value. In C++, the example keeps value flow, references, and explicit control visible.

languages/python/04-expert/smart-pointers-in-depth/example/main.py

@@ -1,4 +1,4 @@
-# Module focus: Smart pointers in depth.
+# Module focus: Tracking ownership and lifetime when multiple references can observe the same value.
 # Why it matters: practicing smart pointers in depth patterns makes exercises and checkpoints easier
 # to reason about.