Skip to content

docs: link runcycles.io blog + AP2 Discussion from README#3

Merged
amavashev merged 1 commit into
mainfrom
docs/blog-cross-link
May 13, 2026
Merged

docs: link runcycles.io blog + AP2 Discussion from README#3
amavashev merged 1 commit into
mainfrom
docs/blog-cross-link

Conversation

@amavashev
Copy link
Copy Markdown
Contributor

@amavashev amavashev commented May 13, 2026

Summary

Adds a Background section above the existing Documentation list in the README with two cross-links:

  • Blog postPreventing AP2 Open-Mandate Overuse with Runtime Idempotency — engineering write-up of the keying decision (open_mandate_hash vs transaction_id), post-PSP commit uncertainty, and the AP2 §6 consume-once defense.
  • AP2 GitHub Discussion #262 — the Show-and-tell thread on the upstream AP2 repo, with two spec-level open questions (hash canonicalization, adapter shape outside the SDK).

Merge order

The blog URL above goes live when runcycles/docs#638 merges and deploys.

Recommended: merge docs#638 first, then this PR. If merged in the other order, the README link will 404 for the short window between this PR landing and the blog deploying.

Test plan

  • README diff verified — single 5-line addition, no other changes
  • Both target URLs verified (blog canonical from frontmatter; AP2 Discussion #262 is live)
  • CI green on this PR
  • Merge order respected: runcycles/docs#638 before this

Adds a Background section above the existing Documentation list with
two cross-links:

- Blog post: "Preventing AP2 Open-Mandate Overuse with Runtime
  Idempotency" — engineering write-up of the keying decision
  (open_mandate_hash vs transaction_id), post-PSP commit
  uncertainty, and the AP2 §6 consume-once defense. URL is the
  canonical we set in the post's frontmatter
  (/blog/ap2-open-mandate-consume-once-runtime-idempotency).
- AP2 GitHub Discussion #262 — the Show-and-tell thread on the
  upstream AP2 repo, with two spec-level open questions (hash
  canonicalization, adapter shape outside the SDK).

Note: the blog URL goes live when runcycles/cycles-docs#638 merges and
deploys. Merge order should be: docs #638 first, then this PR.
@amavashev amavashev merged commit 3b1e35f into main May 13, 2026
6 checks passed
@amavashev amavashev deleted the docs/blog-cross-link branch May 13, 2026 19:12
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