Skip to content

docs: check the shared platform-state caveat against trace-spec - #126

Merged
imran-siddique merged 1 commit into
mainfrom
docs/share-platform-state-caveat
Aug 21, 2026
Merged

docs: check the shared platform-state caveat against trace-spec#126
imran-siddique merged 1 commit into
mainfrom
docs/share-platform-state-caveat

Conversation

@imran-siddique

Copy link
Copy Markdown
Member

Follow-up to trace-spec#195, which is merged.

The SEV-SNP platform-state caveat in LIMITATIONS.md is verbatim with trace-spec and cmcp apart from one sentence. Nothing linked the three, so a change in one reaches the others only if someone remembers. agent-manifest shipping appraise_platform_info() on 2026-08-20 is exactly that kind of change.

What this does

  • Wraps the shared prose in <!-- shared:platform-state-appraisal begin/end --> markers and moves the cA2A-specific sentence below the end marker as an In cA2A paragraph, keeping the detail that neither the attested-peer nor the sealed-channel path calls the appraisal.
  • Adds limitations-parity.yml, which fetches trace-spec's copy and fails on drift, on push, on PR and daily at 06:41. Same shape as the schema-parity check on the apex site. Only the marked block is compared; the paragraph after it is this project's own and is free to differ.

The full text stays here rather than becoming a link to trace-spec. LIMITATIONS.md exists to state the bounds where a reader will actually meet them, so this keeps the copies honest instead of thinning them out.

Builds clean under mkdocs build --strict. Parity extraction was tested locally against trace-spec main, including a negative case that confirms drift is caught.

🤖 Generated with Claude Code

https://claude.ai/code/session_013EQx4N5BzTQbY8kvXUsdkY

The SEV-SNP platform-state caveat here is verbatim with trace-spec and
cmcp apart from one sentence. Nothing linked the three, so a change in
one, such as agent-manifest shipping appraise_platform_info() on
2026-08-20, reaches the others only if someone remembers.

- Wraps the shared prose in shared:platform-state-appraisal markers and
  moves the cA2A-specific sentence below the end marker, including the
  detail that neither the attested-peer nor the sealed-channel path
  calls the appraisal.
- Adds a limitations-parity workflow that fetches trace-spec's copy and
  fails on drift, on push, on PR and daily. Same shape as the
  schema-parity check on the apex site. Only the marked block is
  compared; the paragraph after it is this project's own.

The full text stays here rather than becoming a link. LIMITATIONS.md
exists to state the bounds where a reader meets them.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013EQx4N5BzTQbY8kvXUsdkY
@imran-siddique
imran-siddique requested a review from a team as a code owner August 21, 2026 02:20
@imran-siddique
imran-siddique merged commit 90d54cd into main Aug 21, 2026
13 checks passed
@imran-siddique
imran-siddique deleted the docs/share-platform-state-caveat branch August 21, 2026 02:24
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