Integration

This directory is the boundary for end-to-end and contract-style integration tests. It now provides both a stable runtime staging target and a first TeamServer smoke test that exercises the staged runtime through real gRPC.

Current Contract

• Source of truth for the test runtime: build/integration-staging/runtime/Release
• Preparation target: cmake --build <build-dir> --target stage_integration_runtime
• First integration test: testsTeamServerRuntimeIntegration
• Inputs:
  • stage_release_bundle
  • TeamServer binary and runtime config
  • TeamServer modules
  • Python client sources
  • generated c2client_protocol package

Current Coverage

testsTeamServerRuntimeIntegration copies the staged runtime to a temporary directory, rewrites the gRPC port, starts the real TeamServer binary, performs an authenticated gRPC round-trip, and verifies stable empty-state RPCs:

• Authenticate
• ListListeners
• ListSessions

Next Step

The next integration-test phase should extend integration/tests/ around:

• client transport/auth handshake through the Python client package
• a small gRPC contract smoke test beyond the empty-state RPCs
• one release-bundle smoke test to validate the packaged layout

The goal is to make integration tests run against the same staged runtime that the release pipeline assembles, so packaging regressions and protocol drift are caught before release.