Feat/examples sandbox tests

[KevinMB0220]

Pull Request: Align Canonical Examples with Quality Standards & Implement GameHarness Sandbox Tests

Description

This PR brings the canonical 1.1.0 reference examples to full compliance with EXAMPLE_STANDARD.md (Issue #217) and integrates GameHarness and Scenario-based multi-turn integration testing across key onboarding examples (Issue #222).

Key Changes

1. Dependency Modernization:

   • Swapped all local path references to published versions of cougr-core = "1.1.0" in target examples dependencies.
   • Configured cougr-core = { version = "1.1.0", features = ["testutils"] } in dev-dependencies.
   • Standardized soroban-sdk = "25.1.0".

2. GameHarness Scenario Tests:

   • Created sandbox_tests.rs modules containing multi-step scenario tests (at least 3 actions with intermediate state assertions) for spawn_and_move, tic_tac_toe, snake, and battleship.
   • Derived Clone on game contracts (TicTacToeContract, SnakeContract, BattleshipContract) to support testing registry constraints in the harness.

3. Standard-Compliant Documentation:

   • Authored new README.md files for tic_tac_toe, session_arena, hidden_hand, fog_explorer, dice_duel, and blind_auction covering all required sections of §4 (API tables, storage model, gameplay flow, architecture).
   • Updated existing READMEs for spawn_and_move, snake, and battleship to recommend GameHarness and Scenario as the primary testing tools.
   • Added ZK reference architectures to the canonical catalog list in examples/README.md.

4. CI Pipelines:

   • Added CI workflows for spawn_and_move and session_arena using the reusable workflow runner.
   • Extended .github/workflows/circuit_examples.yml ZK check matrices to execute stellar contract build (WASM target build checks) in addition to tests.

Verification

Verified all targets locally with:

• cargo test -> Passed successfully.
• stellar contract build -> WASM compilation succeeded.

Related Issues

• Closes feat(examples): align canonical 1.1.0 reference examples with EXAMPLE_STANDARD #217
• Closes feat(examples): adopt GameHarness for scenario-based testing in reference examples #222

[drips-wave]

@KevinMB0220 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits