[christophersesugh]

Motivation

The Throughline landing page currently showcases a counter, which does not demonstrate the multi-system flows the tool is intended to explain. TL-I11 calls for sophisticated traces as the entry-point showcase.

Changes

• Lead the overview with a distributed checkout timeout/retry/recovery trace, including persistent pending/paid states and provider idempotency semantics.
• Keep the existing counter, references and binary demos available in introductory guides.
• Assert the intermediate unknown outcome and final recovered state using the published @0xbuff/throughline@0.0.2 compiler.
• Follow-up: model real directed send events for storage, queue, payment attempt, idempotent retry, receipt and customer notification, keeping every actual state transition as an explicit set.
• Add regression coverage for exact transfer relation IDs, valid link endpoints and the absence of premature provider, order or customer persistence; clarify this distinction in the overview.
• Clarify that the official Remark/MDX integration is not shipped by the currently published v0.0.2 package.

Compatibility and release boundary

This is the release-independent documentation portion of TL-I11. It does not install an unpublished Remark subpath, change package dependencies, modify routing, or deploy documentation. The remaining official Remark/Fumadocs integration must be a separate PR after a reviewed new package release candidate is available.

Verification

• GitHub Actions run #42993916785 passed on code/test head 067ce5f: install, TypeScript, node tests, production build and R2 binding checks, bundle report, staging build and binding checks. A subsequent MDX prose-only commit 1a26de4 is the current branch head and has not had a separate workflow run.
• Browser visual/keyboard review of expanded checkout diagram
• Maintainer review, signing and merge

Local install/tests were not run; GitHub Actions is the verification environment for these commits. No package release or documentation deployment is claimed.