docs(glossary): add facilitator, mock mode, buyer/seller agent, quote-vs-settle drift#4
Merged
Merged
Conversation
added 2 commits
May 18, 2026 22:24
…-vs-settle drift Closes #2 Adds five missing terms referenced across README, protocols/x402.md, examples/, and agent-playbooks/ but not yet defined in the glossary: - Buyer agent / Seller agent — roles used across x402-buyer-loop, multi-agent-procurement, and the ACP/AP2/MCP integrations. - Facilitator — the x402 third-party verify-and-settle role (Coinbase, Stripe-on-Base, x402 Foundation). - Quote-vs-settle drift — variance concept that pricing-drift-and-requote bounds with TTL, bps threshold, and re-quote envelope. - Mock mode — MOCK_MODE=true safety default in /examples.
…ng style The Markdown Lint workflow added in 103b057 ran with no config and applied markdownlint's defaults. Three rules conflict with the repo's actual style and fail across many pre-existing files: MD013 line-length — the repo writes one long line per paragraph (glossary one-liners, prose-heavy playbooks). MD033 no-inline-html — _template.md uses <Playbook> as a placeholder. MD041 first-line-h1 — PULL_REQUEST_TEMPLATE.md opens with ## by GitHub's pull-request-template convention. Disable the three rules so existing files pass and new contributions aren't blocked by style choices the repo has already made.
simonlucalandi
force-pushed
the
worktree-glossary-expansion
branch
from
ef7f0fe to
ec228e7
Compare
added 2 commits
May 19, 2026 12:24
resources.md references the book 'When AI Shops' at https://www.amazon.com/dp/B0DH9F3HBG. Amazon serves a 404 to lychee's non-browser UA across consecutive CI runs, even though the page resolves in any real browser. Add amazon.com to the existing bot-hostile exclude group alongside openai.com, developer.americanexpress.com, etc.
README.md links to https://tempo.com which redirects browsers to tempo.xyz but returns 502 Bad Gateway to lychee's user-agent. Add to the bot-hostile exclude group alongside amazon.com, openai.com, etc.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Closes #2.
Adds five terms to
docs/glossary.mdthat are referenced across the repo but were not yet centrally defined:/agent-playbooks/x402-buyer-loop.md.protocols/x402.md.MOCK_MODE=truedefault in/examplesand the// MOCK:annotation convention./merchant-playbooks/pricing-drift-and-requote.mdfor the bounding pattern.Style matches existing entries: one-paragraph definition, links to maintaining organizations for factual claims, internal anchor cross-references, and a pointer to the relevant playbook for each.
Scope
Test plan