Skip to content

docs: propose embodied action evidence profile#339

Open
carloshvp wants to merge 1 commit into
agentrust-io:mainfrom
carloshvp:embodied-evidence-profile
Open

docs: propose embodied action evidence profile#339
carloshvp wants to merge 1 commit into
agentrust-io:mainfrom
carloshvp:embodied-evidence-profile

Conversation

@carloshvp

Copy link
Copy Markdown
Member

Summary

Refs #337.

Adds a draft v0.1 Embodied Action Evidence Profile for physical-action traces. The profile is intentionally docs-only in this first PR: it defines a producer/verifier convention on top of the existing external_execution_evidence envelope without changing the audit schema or runtime behavior.

What changed

  • Added docs/spec/embodied-action-evidence.md with a concrete profile for embodied-action evidence.
  • Defines the three evidence layers: cMCP audit entry, external_execution_evidence envelope, and detached embodied-action payload.
  • Keeps linked_call_id bound to the cMCP audit entry call_id and separates it from controller-native action_ref values.
  • Proposes RFC3339 UTC string timestamps for the profile action preimage to avoid integer-ms vs string timestamp hash divergence.
  • Defines minimum detached payload fields, action_ref computation, receipt state classifications, Agent Manifest identity comparisons, verifier flow, and explicit non-goals.
  • Linked the profile from the verification-library spec and MkDocs navigation.

Validation

  • git diff --check
  • verified the MkDocs nav target exists: docs/spec/embodied-action-evidence.md
  • attempted uv run --with-requirements requirements-docs.txt mkdocs build --strict, but the current repo MkDocs config fails before page rendering because docs_dir: . is rejected by current MkDocs as the parent directory of the config file. This appears unrelated to this PR.

Notes for review

This PR does not claim physical completion, controller safety, or functional-safety certification. It only scopes the evidence semantics needed to bind a physical-action request, governance decision, controller handoff, and optional downstream receipt into the existing cMCP audit model.

@carloshvp

Copy link
Copy Markdown
Member Author

Ready for review.

This is docs-only and scoped to evidence semantics for the Embodied Action Evidence Profile. It does not change the audit schema or runtime behavior, and it does not claim physical completion, controller safety, or functional-safety certification.

Current validation:

  • CI is green across the PR checks.
  • git diff --check passed locally.
  • Verified the MkDocs nav target exists: docs/spec/embodied-action-evidence.md.

Note: I attempted uv run --with-requirements requirements-docs.txt mkdocs build --strict, but the current repo MkDocs config fails before page rendering because docs_dir: . is rejected by the current MkDocs version. That appears unrelated to this PR and is called out in the PR description.

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