mkdocs.yml

site_name: TRACE
site_description: "Trust Runtime Attestation and Compliance Evidence: open attestation standard for agentic AI governance"
site_url: https://trace.agentrust-io.com
repo_url: https://github.com/agentrust-io/trace-spec
repo_name: agentrust-io/trace-spec
edit_uri: edit/main/
docs_dir: .
copyright: "© 2026 TRACE Specification contributors: CC BY 4.0"

exclude_docs: |
  .github/
  overrides/
  node_modules/
  src/
  tests/
  # schema/ is published, not excluded, but only the file whose $id points at
  # this host. The others declare an agentrust-io.com $id and are served there;
  # serving a second copy here would give the same document two URLs.
  schema/trace-claim.json
  schema/trace-revocation.json
  schema/trace-revocation-bundle.json
  LICENSE
  NOTICE
  README.md
  ANTITRUST.md
  ADOPTERS.md
  SECURITY.md
  pyproject.toml

theme:
  name: material
  custom_dir: overrides
  font: false
  logo: docs/assets/icon.svg
  favicon: docs/assets/icon.svg
  palette:
    - scheme: default
      primary: custom
      accent: custom
      toggle:
        icon: material/brightness-4
        name: Switch to dark mode
    - scheme: slate
      primary: custom
      accent: custom
      toggle:
        icon: material/brightness-7
        name: Switch to light mode
  features:
    - navigation.instant
    - navigation.instant.progress
    - navigation.tracking
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.sections
    - navigation.expand
    - navigation.top
    - navigation.path
    - navigation.footer
    - search.suggest
    - search.highlight
    - search.share
    - content.code.copy
    - content.code.annotate
    - content.tabs.link
    - content.tooltips
    - toc.follow
    - announce.dismiss
  icon:
    repo: fontawesome/brands/github

plugins:
  - search:
      lang: en
  - llmstxt:
      full_output: llms-full.txt
      markdown_description: >-
        TRACE (Trust Runtime Attestation and Compliance Evidence) is an open
        specification for signed AI agent runtime evidence. A TRACE Trust Record
        connects workload identity, policy, data classification, and transcript
        commitments. Software signing, hardware attestation, and transparency
        inclusion establish different properties and require separate checks.
        Start with a local signed record and tamper detection, then choose the
        evidence required by your verifier. It builds on RFC 9711 (CWT/EAT), RFC 9334
        (RATS), and SCITT, and ships a Python library, agentrust-trace, with a
        conformance suite.
      sections:
        Getting started:
          - index.md
          - docs/quickstart.md
          - docs/trust-levels.md
          - docs/verification.md
          - docs/glossary.md
        Specification:
          - spec/trace-v0.2.md
          - docs/schema.md
        Integration:
          - docs/integration/agt.md
          - docs/integration/openshell.md
          - docs/integration/cmcp.md
          - docs/integration/sandbox-runtime.md
        Platforms:
          - docs/platforms/index.md
  - minify:
      minify_html: true
  - mkdocstrings:
      default_handler: python
      handlers:
        python:
          paths: [src]
          options:
            docstring_style: google
            show_source: false
            show_root_heading: true
            show_root_full_path: false
            show_symbol_type_heading: true
            show_symbol_type_toc: true
            members_order: source
            separate_signature: true
            show_signature_annotations: true
            unwrap_annotated: true

markdown_extensions:
  - admonition
  - pymdownx.details
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed:
      alternate_style: true
  - pymdownx.highlight:
      anchor_linenums: true
      use_pygments: true
      linenums_style: pymdownx-inline
  - pymdownx.inlinehilite
  - pymdownx.snippets
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.tasklist:
      custom_checkbox: true
  - pymdownx.keys
  - attr_list
  - md_in_html
  - tables
  - footnotes
  - toc:
      permalink: true
      toc_depth: 3

extra:
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/agentrust-io/trace-spec
      name: trace-spec on GitHub
    - icon: fontawesome/brands/python
      link: https://pypi.org/project/agentrust-trace/
      name: agentrust-trace on PyPI
    - icon: fontawesome/brands/discord
      link: https://discord.gg/grgzFEHgkj
      name: Join the Discord
  generator: false
  analytics:
    feedback:
      title: Was this page helpful?
      ratings:
        - icon: material/emoticon-happy-outline
          name: This page was helpful
          data: 1
          note: Thanks for your feedback!
        - icon: material/emoticon-sad-outline
          name: This page could be improved
          data: 0
          note: "Thanks for your feedback: open an issue to let us know."

extra_css:
  # Shared AgenTrust editorial design system. Deliberately the only stylesheet:
  # a local override here is how this site drifted to the Material default
  # violet last time. Change the shared file instead.
  - https://agentrust-io.com/design-system.css

nav:
  - Home: index.md
  - Getting Started:
      - Quickstart: docs/quickstart.md
      - Trust Levels: docs/trust-levels.md
      - Verification: docs/verification.md
      - Build Provenance Depth: docs/build-provenance-depth.md
      - Verification Outcome Statements: docs/verification-outcome-statements.md
      - Schema Reference: docs/schema.md
      - Glossary: docs/glossary.md
  - Tutorials:
      - Sign your first trust record: docs/tutorials/signing-your-first-trust-record.md
      - Verify a trust record: docs/tutorials/verifying-a-trust-record.md
      - Hardware attestation platforms: docs/tutorials/hardware-attestation-platforms.md
      - Integration with cMCP: docs/tutorials/integrating-with-cmcp.md
      - Anchor to the registry: docs/tutorials/anchoring-to-the-registry.md
      - Verify the tool transcript: docs/tutorials/verifying-the-audit-chain.md
      - AGT adapter: docs/tutorials/agt-adapter.md
  - Specification:
      - TRACE v0.2: spec/trace-v0.2.md
      - Registry Anchor Format v1: spec/registry-anchor-v1.md
      - MCP Server Provenance v1: spec/server-provenance-v1.md
      - Content Marking v1: spec/content-marking-v1.md
      - TRACE v0.1 (superseded): spec/trace-v0.1.md
  - Integration:
      - AGT: docs/integration/agt.md
      - NVIDIA OpenShell: docs/integration/openshell.md
      - cMCP: docs/integration/cmcp.md
      - Sandboxed agent runtimes: docs/integration/sandbox-runtime.md
      - PIC/TRACE authorization bridge: docs/integration/pic-trace-bridge-v1.md
  - Platforms:
      - Overview: docs/platforms/index.md
      - AMD SEV-SNP: docs/platforms/amd-sev-snp.md
      - Intel TDX: docs/platforms/intel-tdx.md
      - NVIDIA H100: docs/platforms/nvidia-h100.md
  - Crosswalks:
      - OWASP Agentic Top 10: docs/crosswalks/owasp-agentic-top-10.md
      - Acta Decision Receipts: docs/crosswalks/acta-decision-receipts.md
      - N'KEMBA Institutional Reconstruction: docs/crosswalks/nkemba-institutional-reconstruction.md
  - Test Suite: https://tests.agentrust-io.com
  - Method:
      - How the conformance vectors are built: docs/conformance-method.md
  - RFCs:
      - Composable zero-knowledge proofs: docs/rfcs/composable-zk-assurance.md
      - A2A delegation-link verification profile: docs/rfcs/a2a-delegation-profile.md
      - Runtime evidence and verifier grades: docs/rfcs/runtime-evidence-profile.md
  - Project:
      - Limitations: LIMITATIONS.md
      - Changelog: CHANGELOG.md
      - Contributing: CONTRIBUTING.md
      - Governance: GOVERNANCE.md
      - Technical Charter: CHARTER.md
      - Code of Conduct: CODE_OF_CONDUCT.md
      - Maintainers: MAINTAINERS.md
      - Sponsors: SPONSORS.md
      - Roadmap: ROADMAP.md
      - Privacy: PRIVACY.md
      - Scope: Governance/Scope.md
      - Contributor License Agreement: Governance/CLA.md
      - Licenses: Governance/License.md
      - Community Specification License: Governance/COMMUNITY-SPECIFICATION-LICENSE.md
      - Notices: Governance/Notices.md

extra_javascript:
  # Shared cross-project top navigation (TRACE / Manifest / cMCP / cA2A / ...)
  - https://agentrust-io.com/supernav.js