A person publishes
A publish hold that opens only when a person approves. A sensor may advise. A score does not open the hold, and it does not change the kind.
When to use
Use this gate on the publish path so a specimen stays pending until a person approves it. The sensor may speak first. The person decides.
When not to
Do not let a score, a kind suggestion, or an empty moderation note open this gate. Do not bypass it because the submitter is also an admin.
Author-attested
Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.
# A person publishes
This file is a gate: a hold that opens only when a person approves.
## When to use
Use this gate wherever a specimen would move from pending to published. The hold is closed by default. It opens when a person approves, and only then.
A sensor may leave advice beside the specimen before the person decides. The advice is input to the person. It is not the key to the hold.
## When not to
Do not open the hold because a score is high, because a score is low and someone wants to "get it off the queue," or because a kind suggestion looks confident.
Do not let the intake clerk open it. The clerk's authority ends at the pending queue. Do not let the absence of a sensor reading count as an approval. A missing reading leaves the hold closed until a person acts. It does not refuse the person the right to act.
## The specimen
The artifact is this gate.
```text
hold: publish
closed_by_default: true
opens_when:
- a person takes an approve action on a pending specimen
- the action is theirs, not a copied score and not a default
remains_closed_when:
- no person has approved
- the only new information is a score
- the only new information is a suggestion of a different kind
- the intake clerk has accepted the row
sensor:
may: attach advice for the person to read
may_not: open this hold
may_not: set the specimen to published
may_not: write the kind field
a kind suggestion is displayed beside the person's choice
the person's choice stays the kind
refuse_and_approve_are_both_human: true
a refusal is a person's act and leaves the specimen unpublished
an approval is a person's act and opens the hold
not_evidence_of_open:
- a file that says complete
- a high score
- an empty note
- the submitter's confidence
```
The policy on attack procedures still applies at this gate. A person does not open the hold on a working payload. The sensor may warn. The warning does not replace the person's refusal, and it does not become a publish. The home of that limit is the specimen "No attack procedures."
## How a stranger checks it
A stranger checks the gate by trying to open it with everything except a person.
1. Read `opens_when`. The only key is a person's approve action.
2. Read `remains_closed_when`. A score alone, a kind suggestion alone, and the clerk's accept are all still closed.
3. Read the sensor block. `may_not` includes open, publish, and write the kind.
4. If you have a running system, submit a specimen, attach a glowing score, and do not approve. The specimen is still pending. Then approve as a person. Now it is published.
A copy whose `opens_when` includes "score at or above a line" fails this check. The block line, if a product has one, belongs to the sensor's question pack. It can block a person's approve when the product says so. It cannot open this hold by itself.
How a stranger checks it
- GATE-1 The hold opens only on a person's approve, and a score or a kind suggestion cannot open it or rewrite the kind. Read the fenced gate. Confirm opens_when is a person's approve, and that score, sensor, and kind suggestion are each forbidden to open the hold or write the kind.