Consumer Examples¶
Start with the published CLI consumer and its
first-result guide for inputs obtainable without a
source checkout. Its public producer generates synthetic data and the expected
offline incomplete JSON/JUnit result using the published pair.
Source document examples¶
These documents form a product-independent, single-domain ROS 2 simulation exchange. They show how a consumer can declare a scenario, describe the observed runtime, establish one run context, report one domain result, index evidence, and aggregate the result.
Every YAML document declares its own schema_version. CI validates these
documents with the public Python API from the current editable checkout:
uv run --directory packages/contracts pytest tests/test_consumer_examples.py
Run that command from the workspace root. These examples use the package catalog, shared with the compatible harness. Versioned fixtures retain their original bytes and historical release identities. These examples validate document links and original file-byte digests, not a live ROS execution or arbitrary infra image. Published package checks and consumer integration have separate evidence scopes; see compatibility.
Consumers should copy only the document types they produce or consume.
Identifiers, image references, timestamps, and ROS graph observations are
examples and must be replaced with observed data. The SHA-256 fields that link
files in minimal-simulation/ are the actual digests of those files, and CI
recomputes the complete acyclic chain. A successful result contains evaluated
assertions and evidence; observation digests identify the corresponding item in
both the result and the evidence index.
New product artifact examples¶
execution-trust-policy/trust-policy.json matches the allowlist consumed by
infrastructure’s execution policy. Its target hash covers the exact bytes of
execution-trust-policy/target-identity.txt, including the final LF. The identity
is synthetic; this example is not a physical-execution permit or authorization.
robot-description/ is a portable product root with cad/, ros/, and sim/.
sim/robot-description.json records a ready URDF and
sim/robot-description-sdf.json records the alternative SDF for the same neutral
1 kg, 0.1 m cube. Both bind actual CAD source and description file bytes; the
URDF also binds its external mesh. The SDF uses analytic box geometry.
The mesh is expressed in metres, while the OpenSCAD source is in millimetres.
The ROS package contains static description assets, not a CAD exporter or launch
integration. These example artifacts are authored to agree; no CAD tool was run
as part of contract validation.
From this directory, validate the examples with the existing CLI:
robotics-contracts validate execution-trust-policy/trust-policy.json \
robot-description/sim/robot-description.json \
robot-description/sim/robot-description-sdf.json
See product artifact roles for locator rules, units, producer-reported checks, and the boundary with later consumer integration.
The flight controller profile adds six interface
requirements using the existing extensible flight_controller provider kind.
Controller selection and live conformance belong to the infrastructure stages.