Skip to content

docs: package ProofPath Agent Payment Guard story (closes #153)#154

Merged
safal207 merged 2 commits into
mainfrom
docs/package-agent-payment-guard-story
May 27, 2026
Merged

docs: package ProofPath Agent Payment Guard story (closes #153)#154
safal207 merged 2 commits into
mainfrom
docs/package-agent-payment-guard-story

Conversation

@safal207

Copy link
Copy Markdown
Owner

Closes #153

What this PR does

Packages the ProofPath Agent Payment Guard story so any reviewer understands the value in under 60 seconds.

No new payment functionality is added. This is a docs/demo-flow PR only.


Changes

README.md

New ## Agent Payment Guard hero section at the top:

  • Positioning formula: AI agents will need payment rails. Payment rails need authorization. Authorization needs evidence. ProofPath provides that evidence.
  • Core principle: Model output is a proposal, not authorization.
  • Feature bullet list (what it does / what it does not)
  • Mermaid architecture diagram inline
  • Quickstart block with expected output
  • Updated product surfaces table (3 surfaces: Payment Guard, CI gate, Personal Agent Guard)
  • Updated reviewer links

docs/architecture.md (new)

Full Mermaid diagrams:

  • System diagram: AI Agent → Guard Service → Policy → Intent Verifier → Replay Store → Audit Log → Evidence Bundle
  • Decision flow: step-by-step ACCEPT / BLOCK / HOLD path
  • Evidence layer: export pipeline diagram

examples/agent-payment-guard/run_e2e_evidence_demo.sh (new)

Copy-paste runnable E2E demo from repo root:

  1. Starts guard service (enforce mode)
  2. Sends valid signed-intent proposal → asserts ACCEPT
  3. Replays same envelope → asserts BLOCK / INTENT_REPLAYED
  4. Stops service, runs export_payment_guard_evidence.py
  5. Verifies bundled audit log hash chain inline (pure Python, no deps)
  6. Prints summary with bundle contents

docs/demo-transcript-payment-guard.md (new)

Expected output of run_e2e_evidence_demo.sh, decisions table, and explanation of what the demo proves.


Acceptance criteria

  • README has clear product hero positioning
  • README includes Model output is a proposal, not authorization.
  • Architecture diagram exists (docs/architecture.md + inline Mermaid in README)
  • E2E demo script exists and runs from repo root
  • Demo covers ACCEPT, replay BLOCK / INTENT_REPLAYED, evidence export, bundled audit verification
  • No real wallets / SDK / RPC / JWS / EIP-712

Validation

bash examples/agent-payment-guard/run_demo_check.sh
bash examples/agent-payment-guard/run_service_check.sh
bash examples/agent-payment-guard/run_evidence_export_check.sh
bash examples/agent-payment-guard/run_e2e_evidence_demo.sh

safal207 added 2 commits May 27, 2026 16:54
- README: add Agent Payment Guard hero section with positioning formula,
  architecture Mermaid diagram, and quickstart block
- docs/architecture.md: full Mermaid system diagram with all layers
- examples/agent-payment-guard/run_e2e_evidence_demo.sh: copy-paste
  runnable E2E demo covering ACCEPT -> replay BLOCK -> export -> verify
- docs/demo-transcript-payment-guard.md: expected output + story

Core principle added to README:
  Model output is a proposal, not authorization.
@safal207 safal207 merged commit 71496cc into main May 27, 2026
1 check passed
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.

Package ProofPath with README hero, architecture diagram, and end-to-end evidence demo

1 participant