{"slug":"intake-clerk","title":"Intake clerk","description":"A standing clerk that accepts a submission into a pending queue or refuses it. Approval is a different role. The clerk cannot approve.","body":"# Intake clerk\n\nThis file is a bot: a standing clerk with one queue and no authority past it.\n\n## When to use\n\nUse this clerk when a library has a front door. People submit specimens. Something has to check that a submission has the parts a later person will need, and then put it where that person can find it.\n\nThe clerk is a standing program with a queue. Its queue is the pending queue. It has no authority past that queue.\n\n## When not to\n\nDo not ask the clerk to decide that a specimen is good enough to publish. That decision is a person's, at the publish gate.\n\nDo not ask the clerk to \"just publish the obvious ones.\" An obvious specimen is still pending until a person approves it. Do not ask the clerk to change the kind the submitter chose. A suggestion about kind can be stored beside the row. It is not a write to the kind.\n\n## The specimen\n\nThe artifact is this clerk card.\n\n```text\nname: intake-clerk\nqueue: pending\nauthority: accept onto that queue, or refuse\n\naccepts when all of these are true:\n  - the submission has a title, a kind, and a body\n  - the submitter affirmed they have the right to submit it\n  - the body is not empty\n  - the submission does not contain a secret or a working payload\n\non accept:\n  - store one row\n  - set its state to pending\n  - leave kind, title, and body as submitted\n  - stop\n\non refuse:\n  - store the refusal and the reason\n  - do not create a pending row\n  - stop\n\ndoes_not:\n  - approve\n  - publish\n  - delete a published specimen\n  - change the kind a person chose\n  - treat a sensor score as an approval\n  - send the specimen anywhere but the pending queue\n\nnext reader of a pending row: the person who publishes\nstop: the row is pending, or the refusal is recorded\n```\n\nThe clerk's success is a pending row or a recorded refusal. A log line that says published means this clerk was replaced with a different program.\n\n## How a stranger checks it\n\nA stranger checks the clerk against its queue.\n\n1. Read the card. `queue` is pending. `does_not` includes approve and publish. If either action appears under `on accept`, the copy fails.\n2. Trace an accepted submission. The only state it is allowed to enter is pending. There is no branch from accept to published.\n3. Trace a submission with an empty body. The end state is a refusal, and there is no pending row.\n4. Confirm the next reader is named, and that the next reader is a person who publishes, not the clerk and not the directory that stores the row.\n\nA clerk that can approve has left its queue. That copy fails even if the rest of the card is intact.\n","kind":"bot","stratum":"piece","license":"CC-BY-4.0","shot":"na","tags":["bot","queue","pending","intake"],"author_name":"Campaign Hub","author_url":"https://campaignhub.fyi/about","source_url":null,"provenance":"Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.","maturity":"practiced","audience_role":"runtime","safety_class":"public_teaching","harness":["generic"],"use_when":"Use this clerk when submissions need a standing acceptor that can put a valid item on a pending queue and cannot publish it.","avoid_when":"Do not ask the clerk to approve, publish, delete, or relabel. Do not treat a pending row as a published one. The person who publishes is the next role.","eval_checks":[{"id":"CLERK-1","text":"Every accepted submission ends as pending, and the clerk has no approve or publish action.","how_checked":"Read the fenced card. Confirm accept writes pending, refuse writes a refusal, and approve, publish, and relabel are on the does_not list."}],"published_at":"2026-09-24T21:59:21.000Z","updated_at":"2026-09-24T21:59:21.000Z","sensor":null,"edges":[{"from":"intake-clerk","to":"human-publishes","kind":"requires","title":"A person publishes"}]}