Add x402-to-CLAS paid-action receipt integration design doc

[GsCommand]

Motivation

• Define a protocol-grade, documentation-only design for how x402 paid HTTP/API actions map to CommandLayer-signed CLAS action receipts and how those artifacts enable public verification.
• Clarify the trust boundary between payment settlement (x402 provider domain) and execution attestation (CommandLayer runtime receipts) so payment signals are not conflated with execution proof.
• Provide a canonical paid-action lifecycle, CLAS receipt shape, metadata.trace guidance, and proof.signature role semantics (single- and multi-signature) for predictable downstream verification and auditing.
• Surface failure modes, idempotency patterns, settlement-vs-execution semantics, and non-goals to guide future integrations (including optional Coinbase AgentKit / Agentic Wallet adapters) without shipping production payment code.

Description

• Add docs/integrations/x402-commandlayer-receipts.md containing the full design doc and required sections (Overview, Why x402 matters, Trust boundary, Paid-action lifecycle, CLAS receipt shape, metadata.trace usage, proof.signature roles, examples, failure modes, idempotency, settlement vs execution proof, future integration, and non-goals).
• Include compact JSON examples for a paid action request, a payment.accepted event, a CLAS receipt emitted after execution, and a paid verification call example aligned to VerifyAgent usage.
• Specify recommended identifier usage (request_id, payment_id, receipt_id), guidance for trace fields, and explicit role semantics for user, payer, agent, runtime, and verifier within proof.signature entries.
• This is a documentation-only change and does not modify site layout, navigation, CSS, or introduce any production x402 runtime code.

Testing

• Ran npm test in the repository and all automated tests passed (44 passing, 0 failing).

---

Codex Task

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
commandlayer-commandlayer-org	Ready	Preview, Comment	May 22, 2026 8:27pm
commandlayer-org	Ready	Preview, Comment	May 22, 2026 8:27pm
commandlayer-org111	Ready	Preview, Comment	May 22, 2026 8:27pm