Repository navigation
[docs] Update glossary - daily scan - #77124
Conversation
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
🟡 Changes recommended
The glossary definition still implies that persisted delivery evidence proves delivery, without stating that independent native readback is required and changed or unavailable resources remain unverified.
1 open issue
What changed in this PR
Adds a glossary definition for durable Work Queue Delivery Evidence, documenting its role in restart-safe delivery verification.
Changes:
- Adds the “Delivery Evidence (Work Queue)” glossary entry.
- Describes persistence, delivery barriers, bounded verification, terminal outcomes, and non-retry behavior for uncertain delivery.
| File | Description |
|---|---|
| docs/src/content/docs/reference/glossary.md | Adds the Delivery Evidence (Work Queue) glossary entry and documents its role in durable delivery verification. |
Review effort: Lite (auto)
|
|
||
| ### Delivery Evidence (Work Queue) | ||
|
|
||
| A ledger record of observed delivery for a [Claim](#claim-work-queue)'s effects, persisted in the `work-queue.jsonl` transaction log so verification survives restarts and checkpoints. Pending Delivery Evidence keeps the delivery barrier in place until bounded verification records a Result or a `DeliveryFailure`; uncertain delivery is never retried by rerunning effects. See [Work Queues](/gh-aw/reference/work-queue/). |
There was a problem hiding this comment.
@copilot Fix the code for all comments in this review comment.
When a review comment includes a suggested change, apply the suggestion exactly.
Do not make changes beyond what is described in the linked review comment.
There was a problem hiding this comment.
Clarified that persisted Delivery Evidence does not establish a Result: fresh independent native readback is required, and changed or unavailable resources remain unverified. Addressed in 660f91e.
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
|
🎉 This pull request is included in a new release. Release: |

Daily scan.
Added: Delivery Evidence (Work Queue), from #76718.
AI dictionary alignment: terms reviewed: delivery, claim, atomic; adopted: none; conflicts: none.