examples/upgrade.json

The frame quill-upgrade as written. Every record made under it names its hash, 569c71692864ab0fcfbfcd41baaa0011ee213bc0b90ca9bcb95dd40b7f085679, and a changed file is a different frame.

Read it in words, or see the file on GitHub or download it.

1{2  "name": "quill-upgrade",3  "relation": "the decision to hold the upgrade rests on the changelog line that removes retry_after()",4  "locus": "the evidence a reviewer has on the pull request: our code, the library's changelog, the CI result",5  "role": "the reviewer of dependency upgrades",6  "grain": "one changelog line",7  "purpose": "merge an upgrade only when our code needs no change for it",8  "trajectory": "pull request, evidence, the reviewer's decision, the merge button",9  "crossing": "the decision posted on the pull request",10  "promise": "the reviewer holds the upgrade while the changelog removes a function our code calls; without that line they merge or say unclear, never hold for another reason",11  "baseline": "the pull request's evidence as it stands; nothing changed",12  "body": {13    "spans": [14      {"id": "use", "kind": "code", "text": "src/billing/retry.py calls quill.retry_after(response) to wait before retrying a 429 response."},15      {"id": "get", "kind": "code", "text": "src/billing/client.py calls quill.get(url, timeout=10) for every request."},16      {"id": "removed", "kind": "changelog", "text": "quill 3.0.0 changelog, Breaking: retry_after() is removed; use Response.backoff() instead."},17      {"id": "http3", "kind": "changelog", "text": "quill 3.0.0 changelog, Added: HTTP/3 support."},18      {"id": "leak", "kind": "changelog", "text": "quill 3.0.0 changelog, Fixed: a memory leak in the connection pool."},19      {"id": "typos", "kind": "changelog", "text": "quill 3.0.0 changelog, Docs: corrected typos in the README."},20      {"id": "ci", "kind": "ci", "text": "CI on this pull request: all 214 tests passed; no test exercises the retry path."}21    ]22  },23  "anchors": ["removed"],24  "inputs": [25    {"id": "pr", "text": "Dependabot opened pull request #212: bump quill from 2.4.1 to 3.0.0 in requirements.txt. Can it be merged as is?"}26  ],27  "observe": {28    "labels": ["merge", "hold", "unclear"],29    "instruction": "You review dependency upgrade pull requests for this repository. Use only the evidence given. Answer merge if the upgrade can be merged without changing our code, hold if our code must change before it can be merged, unclear if the evidence does not decide."30  },31  "interventions": {32    "repeat": true,33    "ablation": true,34    "sham": {"draws": 2},35    "presentation": {"quill": "heron", "retry_after": "wait_hint", "backoff": "pause"},36    "bypass": ["use"],37    "control": ["removed", "use"]38  },39  "allowed": {"ablation": ["merge", "unclear"]},40  "standing": {"quorum": 5, "agree": 4},41  "materialized": true,42  "battery": {"kind": "egemma"}43}