INFORMATIVEDRAFT
Truth Source: Repository schemas and tests are authoritative.
Golden Test Suite Overview
1. Philosophy
The Golden Test Suite serves as a reference evidence artifact for the MPLP v1.0 Protocol. It provides a standardized set of input/output pairs that demonstrate the expected behavior of a conformant runtime.
It is not a certification tool or a compliance enforcement mechanism. It is a collection of data fixtures that implementers can use to verify their own alignment with the protocol.
2. Evidence Scope
The suite provides evidence for the following protocol areas:
| Flow ID | Name | Evidence Focus |
|---|---|---|
| Flow-01 | Intent to Plan Transition | L1 Core (Context/Plan) Schema Alignment |
| Flow-02 | Governed Execution | L1 Core (Trace/Constraints) Invariant Adherence |
| Flow-03 | Multi-Agent Coordination Loop | L2 Coordination (Collab/Role) Interaction Patterns |
| Flow-04 | Drift Detection & Recovery | L3 Runtime (Drift/Recovery) Event Emission |
| Flow-05 | Runtime Integration & External I/O | L4 Integration (Extension/Network) Sandbox Boundaries |
3. Artifact Structure
The suite consists of:
- Fixtures: JSON files defining inputs (Context, Plan) and expected outputs (Trace, Events).
- Registry: A catalog of defined test scenarios (see Golden Flow Registry).
- Format Specification: Definitions of the fixture directory structure (see Golden Fixture Format).
4. Intended Audience
This documentation is intended for:
- Protocol Implementers: To understand the expected data shapes for specific scenarios.
- SDK Maintainers: To verify SDK output against standardized fixtures.
- CI Integrators: To understand the structure of the test artifacts.