ci: claim the Context7 library and refresh it

Context7 indexed this repository on October 8, 2026. A claimed library
has an admin panel and higher refresh limits, and Context7 verifies
the claim through the url and public_key in context7.json. The
public_key is the maintainer's public account key, which Context7
designs to be committed.

Add a workflow that asks Context7 to refresh the index after each push
to main that changes the README, context7.json, docs/, or examples/.
The release docs no longer ask for a manual refresh. The workflow's
request was run locally against the API and returned "Refresh started
successfully". It reads the CONTEXT7_API_KEY repository secret, which
is set.

Author: cardmagic

.github/workflows/context7-refresh.yml

@@ -0,0 +1,30 @@
+name: Context7 refresh
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "README.md"
+      - "context7.json"
+      - "docs/**"
+      - "examples/**"
+
+permissions:
+  contents: read
+
+jobs:
+  refresh:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Trigger a Context7 refresh
+        env:
+          CONTEXT7_API_KEY: ${{ secrets.CONTEXT7_API_KEY }}
+          LIBRARY_NAME: /${{ github.repository }}
+        run: |
+          curl --fail --silent --show-error --max-time 60 \
+            -X POST https://context7.com/api/v1/refresh \
+            -H "Content-Type: application/json" \
+            -H "Authorization: Bearer $CONTEXT7_API_KEY" \
+            -d "{\"libraryName\": \"$LIBRARY_NAME\"}"

AGENTS.md

@@ -57,8 +57,9 @@ Before you tag, read `docs/virtual-actors.md` and `docs/agents.md` against the
 release and correct any requirement, compatibility, or guarantee statement that
 changed. After the tag publishes, refresh the solidobjects.dev documentation
 snapshot from the tag and redeploy the site; its `check:release` step refuses a
-snapshot that is not the latest published tag. Then trigger a Context7 refresh
-for this repository.
+snapshot that is not the latest published tag. The Context7 refresh workflow
+refreshes the index after each push to `main` that changes the documentation.
+Confirm that its run succeeded.
 
 ## Security & Configuration
 

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## Unreleased
+
+- Claim the Context7 library: `context7.json` now carries the library `url` and
+  the maintainer `public_key`.
+- Add the Context7 refresh workflow. A push to `main` that changes the README,
+  `context7.json`, `docs/`, or `examples/` asks Context7 to refresh the index.
+  It uses the `CONTEXT7_API_KEY` repository secret.
+
 ## 0.17.1 - 2026-10-08
 
 - Name the category in the gem metadata and the README: Solid Objects is a

context7.json

@@ -1,5 +1,7 @@
 {
   "$schema": "https://context7.com/schema/context7.json",
+  "url": "https://context7.com/cardmagic/solid-objects-ruby",
+  "public_key": "pk_veEo2smPvGYMwP1MncN1A",
   "projectTitle": "Solid Objects for Rails (solid_objects)",
   "description": "SQL-backed virtual actor library for Ruby on Rails. Actors have stable identities, durable JSON state in SQLite, PostgreSQL, or MySQL, ordered per-identity mailboxes, fenced activation, durable reminders, and transactional effects. Requires Ruby 3.3+ and Rails 7.1+.",
   "folders": [