Skip to content

docs: add registry anchoring and audit chain verification tutorials#62

Merged
imran-siddique merged 1 commit into
mainfrom
docs/new-tutorials
Jun 22, 2026
Merged

docs: add registry anchoring and audit chain verification tutorials#62
imran-siddique merged 1 commit into
mainfrom
docs/new-tutorials

Conversation

@imran-siddique

Copy link
Copy Markdown
Contributor

Summary

  • anchoring-to-the-registry.md: covers the transparency field end-to-end — dev placeholder pattern, SCITT HTTP submission (no SDK client yet, noted explicitly), re-signing with the real receipt URI, and what verification step 6 checks
  • verifying-the-audit-chain.md: covers tool_transcript hash verification against raw transcript bytes, call count cross-check, and external execution receipts per spec §3.3.1
  • mkdocs.yml: adds both tutorials to the Tutorials nav

Both tutorials are grounded in the actual TrustRecord and ToolTranscript models — no invented SDK APIs.

Test plan

  • mkdocs serve renders both tutorials under Tutorials nav without errors
  • Code samples use only real imports (agentrust_trace.sign, hashlib, json, requests)
  • Hash algorithm parsing handles sha256: and sha384: prefixes
  • Dev placeholder pattern ("pending") documented with production warning

🤖 Generated with Claude Code

Two new tutorials filling gaps identified in the tutorial coverage audit:

- anchoring-to-the-registry.md: how to set the transparency field via
  direct SCITT HTTP submission (no SDK registry client exists yet);
  explains the pending-placeholder pattern for dev, re-sign after anchoring,
  and what verification step 6 requires of a verifier

- verifying-the-audit-chain.md: how to verify tool_transcript.hash against
  the external transcript bytes, validate call count, and understand external
  execution receipts per spec §3.3.1

mkdocs.yml: adds both tutorials to the Tutorials nav

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@imran-siddique imran-siddique merged commit 30aa65a into main Jun 22, 2026
4 checks passed
@imran-siddique imran-siddique deleted the docs/new-tutorials branch June 22, 2026 20:13
@imran-siddique imran-siddique restored the docs/new-tutorials branch June 22, 2026 20:55
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