Devshard E2E Test Automation Proposal

[aikuznetsov]

Summary

Adds a Devshard E2E test automation proposal describing a Go-based, Docker-backed integration test strategy.

The proposal defines the intended test environment, tools, runtime containers, scenario coverage, settlement validation contract, and CI tiers for validating devshard across real process and network boundaries.

What’s Included

• Defines Go testing + testcontainers-go as the primary E2E framework.
• Documents the default Docker test environment:
  • mock-chain
  • devshard-host-0..2
  • devshardctl
  • postgres
• Adds a Mermaid block diagram for the E2E runtime topology.
• Specifies mock-chain should match the current REST bridge shape.
• Clarifies devshardd starts as an E2E-only command, not a production binary.
• Defines smoke, protocol, recovery, versioning, chain metadata, and fault scenarios.
• Establishes the baseline settlement contract as a protocol commitment contract.
• Documents CI expectations, including prebuilt Docker images via make devshard-e2e-images.

Testing

Docs-only change. No runtime tests were run.