diff --git a/README.md b/README.md index daadb80..3eb7066 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ # TRACE Conformance Test Suite -### Verify your TRACE implementation before shipping +### Check a TRACE record and see which conformance level it reaches

@@ -25,7 +25,7 @@ [![CI](https://github.com/agentrust-io/trace-tests/actions/workflows/ci.yml/badge.svg)](https://github.com/agentrust-io/trace-tests/actions/workflows/ci.yml) [![Discord](https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&logoColor=white&style=flat)](https://discord.gg/grgzFEHgkj) -> **Test suite v0.2.** Tracks [TRACE Spec v0.2](https://github.com/agentrust-io/trace-spec). +> Tracks [TRACE Spec v0.2](https://github.com/agentrust-io/trace-spec). Check a TRACE record, inspect the findings, and produce a reproducible conformance report. The suite checks the record and supplied evidence; a passing report does not establish that an entire implementation meets every specification requirement. diff --git a/SPONSORS.md b/SPONSORS.md index c8b5788..594c2c7 100644 --- a/SPONSORS.md +++ b/SPONSORS.md @@ -1,9 +1,9 @@ # Sponsors -TRACE Tests is an open-source AgenTrust project. Sponsors provide funding, -engineering time, infrastructure, or other in-kind support. Sponsorship does -not confer project ownership, governance authority, or control over technical -decisions or conformance results. +TRACE Tests is an open-source AgenTrust project. It is sponsored by OPAQUE +Systems, which funds the engineering, infrastructure and confidential-computing +work behind it. Organisations that want to support the project are welcome to +join as sponsors. ## Current sponsors diff --git a/docs/levels.md b/docs/levels.md index 4c2fd08..7f93efd 100644 --- a/docs/levels.md +++ b/docs/levels.md @@ -5,7 +5,7 @@ TRACE defines three conformance levels. Higher levels require all lower-level mo | Level | Required Modules | Use Case | |-------|-----------------|----------| | **0** | TR-ENV, TR-SIG, TR-POL, TR-APR | Software-only development and staging | -| **1** | Level 0 + TR-RTE, TR-SCA | Production TEE-attested records | +| **1** | Level 0 + TR-RTE, TR-SCA | Records that declare a TEE platform and measurement | | **2** | Level 1 + TR-TXN, TR-ANC | Full records with transparency anchoring | ## Level 0 — Software-only @@ -20,8 +20,8 @@ Level 0 records are signed with a software key. The `runtime.platform` must be ` "iat": 1750000000, "subject": "spiffe://trust.example.org/agent/my-agent", "model": { - "provider": "anthropic", - "model_id": "claude-sonnet-4-6", + "provider": "example-provider", + "model_id": "example-model-1", "version": "20251001" }, "runtime": { @@ -82,8 +82,8 @@ Level 1 adds hardware attestation. `runtime.platform` must be a value from the ` "iat": 1750000000, "subject": "spiffe://trust.example.org/agent/my-agent", "model": { - "provider": "anthropic", - "model_id": "claude-sonnet-4-6", + "provider": "example-provider", + "model_id": "example-model-1", "version": "20251001" }, "runtime": { diff --git a/docs/quickstart.md b/docs/quickstart.md index 9aaedd2..6b96409 100644 --- a/docs/quickstart.md +++ b/docs/quickstart.md @@ -29,8 +29,8 @@ record = { "iat": int(time.time()), "subject": "spiffe://trust.example.org/agent/sample", "model": { - "provider": "anthropic", - "model_id": "claude-sonnet-4-6", + "provider": "example-provider", + "model_id": "example-model-1", "version": "20251001", }, "runtime": { diff --git a/docs/tutorials/writing-conformance-tests.md b/docs/tutorials/writing-conformance-tests.md index 91159c3..652b0ad 100644 --- a/docs/tutorials/writing-conformance-tests.md +++ b/docs/tutorials/writing-conformance-tests.md @@ -23,7 +23,7 @@ TRACE defines three levels. Each level activates a cumulative set of modules: | Level | Required modules | Typical use | |-------|-----------------|-------------| | 0 | TR-ENV, TR-SIG, TR-POL | Software-only development and staging | -| 1 | Level 0 + TR-RTE, TR-SCA | Production TEE-attested records | +| 1 | Level 0 + TR-RTE, TR-SCA | Records that declare a TEE platform and measurement | | 2 | Level 1 + TR-TXN, TR-ANC | Full records with SCITT transparency anchoring | At Level 0 you can set `runtime.platform` to `"software-only"` and skip hardware attestation entirely. At Level 1 you must supply a real TEE measurement from AMD SEV-SNP, Intel TDX, NVIDIA H100, or similar. Level 2 adds a SCITT receipt URI and a bound tool-call transcript hash. diff --git a/index.md b/index.md index 4757b23..61bf00a 100644 --- a/index.md +++ b/index.md @@ -1,6 +1,6 @@ --- title: Verify your TRACE implementation -description: Run this suite against your implementation to find out which TRACE conformance level it actually reaches, and produce a report you can hand to an auditor, a counterparty, or an acquirer. +description: Run this suite against a TRACE record to see which conformance level it reaches, and produce a report anyone can reproduce from the record and the suite version. --- # TRACE Test Suite @@ -84,6 +84,7 @@ A conformance report that looks authoritative and cannot be checked is the same | Signature | `TR-SIG` | ES256/ES384/EdDSA, key binding, chain | | Runtime | `TR-RTE` | TEE platform, measurement format, RIM URI | | Policy | `TR-POL` | Bundle hash, enforcement mode, TEE binding | +| Appraisal | `TR-APR` | Appraisal status, verifier URI, policy reference, timestamp | | Transcript | `TR-TXN` | Tool-call transcript hash binding (Phase 2+) | | Transparency | `TR-ANC` | SCITT receipt URI, inclusion proof | | Provenance | `TR-SCA` | SLSA level, builder URI, digest format | diff --git a/mkdocs.yml b/mkdocs.yml index 77be81e..cd99eda 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,11 +1,11 @@ site_name: TRACE Tests -site_description: Conformance test suite for TRACE — Trust Runtime Attestation and Compliance Evidence +site_description: "Conformance test suite for TRACE: Trust Runtime Attestation and Compliance Evidence" site_url: https://tests.agentrust-io.com repo_url: https://github.com/agentrust-io/trace-tests repo_name: agentrust-io/trace-tests edit_uri: edit/main/ docs_dir: . -copyright: "© 2026 AgenTrust — Apache 2.0" +copyright: "© 2026 AgenTrust contributors. Apache 2.0" exclude_docs: | .github/ @@ -66,10 +66,11 @@ plugins: full_output: llms-full.txt markdown_description: >- TRACE Tests is the conformance suite for TRACE (Trust Runtime - Attestation and Compliance Evidence), the AgenTrust open standard for - signed, hardware-attested AI agent governance records. Use it to check - that your attestation receipts satisfy the specification, at each - conformance level, before shipping them to production. + Attestation and Compliance Evidence), an open specification for + portable, signed runtime evidence about AI agent runs. Use it to see + which conformance level a TRACE record reaches and to produce a report + anyone can reproduce. It checks the shape of attestation fields, not + the attestation itself. sections: Getting started: - index.md diff --git a/overrides/main.html b/overrides/main.html index 67c98a4..718f634 100644 --- a/overrides/main.html +++ b/overrides/main.html @@ -51,7 +51,7 @@ "@type": "SoftwareApplication", "name": "TRACE Tests", "applicationCategory": "DeveloperApplication", - "description": "Conformance tests and an integration harness for TRACE implementations. Verify that attestation receipts meet the specification before shipping to production.", + "description": "Conformance tests and an integration harness for TRACE records. It reports which conformance level a record reaches and checks the shape of attestation fields, not the attestation itself.", "url": "{{ config.site_url }}", "offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD" }, "author": { "@type": "Organization", "name": "AgenTrust", "url": "https://agentrust-io.com" },