Skip to content

docs(spec): correct implementation status that drifted behind the code - #65

Merged
imran-siddique merged 1 commit into
fix/tdx-nested-qe-certification-datafrom
docs/spec-status-accuracy
Jul 27, 2026
Merged

docs(spec): correct implementation status that drifted behind the code#65
imran-siddique merged 1 commit into
fix/tdx-nested-qe-certification-datafrom
docs/spec-status-accuracy

Conversation

@imran-siddique

Copy link
Copy Markdown
Contributor

Stacked on #61 (base is fix/tdx-nested-qe-certification-data) because it cross-references docs/hardware-validation.md, which lands there. Merge #61 first and this retargets to main cleanly.

What drifted

Three spec pages still described the repo as it stood around 0.1.0a1, and in places said the opposite of what ships.

call-graph.md claimed "TDX/TPM backends are not implemented" and that peer attestation is "not yet wired into this call path". All three verifiers are implemented and fail-closed, and ca2a_runtime.attestation gates the seal on an appraised channel key. It also still listed the Cedar engine binding as pending (#10, merged).

component-model.md was the worst of it: the sealed channel described as "a placeholder that fails closed", the TEE layer as "interface only, hardware backends pending", no entry at all for peer, policy, cedar, transport, node, attestation or trace_binding, an error list three codes short, and two CLI subcommands where there are now three.

attestation.md said real-hardware validation "remains open" for SEV-SNP and TDX, which the runs in docs/hardware-validation.md have closed.

Corrections go both ways

Most of this understated what is built. Two places now state limits more sharply than before:

  • TPM is called out explicitly as the one backend with no real quote behind it, rather than sitting in a list that makes it look equivalent to SEV-SNP and TDX.
  • Step 2 says plainly that a completed software-mode call is not an attested one, and that off hardware the appraisal records assurance="none".

Style

No bold emphasis added, matching the house-style cleanup in #59. The first pass reintroduced it; caught and stripped.

Test plan

Docs only, no code touched. pytest tests/conformance — 30 passed.

🤖 Generated with Claude Code

Three spec pages still described the repo as it stood around 0.1.0a1, and in
places said the opposite of what ships.

call-graph said the TDX and TPM backends are not implemented and that peer
attestation is not wired into the call path. All three verifiers are
implemented, and the handshake gates the seal on an appraised channel key. It
also still listed the Cedar engine binding as pending.

component-model said the sealed channel is a placeholder that fails closed and
the TEE layer is interface-only, and had no entry at all for peer, policy,
cedar, transport, node, attestation or trace_binding. Its error list was three
codes short and the CLI had grown a third subcommand.

attestation said real-hardware validation of the SEV-SNP and TDX paths remains
open, which the runs recorded in docs/hardware-validation.md have now closed.
TPM is called out explicitly as the one backend with no real quote behind it,
rather than being left to look equivalent.

The corrections go both ways: several understated what is built, and the TPM and
live-call caveats are stated more sharply than before. No bold emphasis, per the
house-style cleanup in #59.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@imran-siddique
imran-siddique merged commit d6994e4 into fix/tdx-nested-qe-certification-data Jul 27, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant