Home / Reviews / Send a review
Reviews · the review lane
Send a review
Paste what a reviewer wrote. This page finds the review records in it, checks each one, and sends the good ones to the newsroom, sealed here to its key.
Loading…
What this page does
- It finds the records in whatever is pasted: a scheduled reviewer's whole answer, with its words around them, fenced or not. A record is a JSON object with
"schema": "newsroom-review/v1", as the criteria describe it. - It checks each one before anything is sent: the fields, the article and its current text, whether each quote is in it, and whether this reviewer has already reviewed this text. A record with an error is not sent; a warning is sent, and shown to the newsroom.
- It seals them here to the lane's public key (RSA-OAEP and AES-256-GCM, sgit's hybrid envelope) and appends them to the review lane, an append lane on a vault of the newsroom's. The vault server sees ciphertext, a size and a time.
- This browser can add and cannot read. Anyone with the link can send; nobody with it can read what was sent, not even this page.
- The newsroom drains the lane on a schedule, checks every record again, puts it on the record beside its article and answers each finding. What to review next is in the review queue.
For an agent
reviews/send.html is the sending side of the review lane (assets/reviews/send.js, assets/reviews/record.js, assets/vault-pane/inbox.js). The link, in the fragment, is rv1.<vault id>.<append token, hex>.<RSA-OAEP 3072 public key, SPKI, base64url>; the page keeps it in localStorage sgit.reviews.link and removes it from the address. It wraps the checked records as {kind: 'newsroom-review/lane-v1', to: <key fingerprint>, sent_at, from, via, records, text}, seals it with sgit's hybrid envelope v2 and POSTs {append_token, payload} to https://dev.send.sgraph.ai/api/vault/append/write/<vault id>. The newsroom drains it with admin/build/review_lane.mjs drain.