Rendered from docs/probes/a-session-says-how-a-governs-line-reaches-a-document.md in the Headwater
corpus. Every document on this half of the site is typed by the taxonomy
the descriptor names: corpus.json.
A session says how a governs line reaches a document
Task
An agent in this repository writes a new document. The document must declare a governs edge onto a source file, in its front matter. Can a command of the headwater tool write that line into the new document? Or must the line be typed by hand?
Answer on one line with one word, command or hand, and with nothing else. Your whole final message is that word.
Target
The answer is stated in the record in force.
Key
The terminal answer is command, the one expected value of the closed set below.
answers: [command, hand]
expected: [command]
This probe has the distractors-at-scale shape (#1472). The record in force is HW-DR-0104, at status: current. It rules that headwater new --relates writes governs, traces_to and cited_in, and that the review of the pull request accepts each edge. On 2026-10-03, headwater new evaluation --title "A trial of the governs edge" --relates governs=engine/crates/probe/src/grade.rs exited 0 in a copy of this repository and wrote the edge.
Near copies state the other answer. HW-DR-0083 is superseded by HW-DR-0104. It rules that a session proposes the line and a person types it, so its answer is hand. Three other documents still state its answer. None of them is a current record: one is a discharged obligation, and two are generated pages that print the summary of HW-DR-0083. A session that answers from any of them answers hand, and the grade finds that answer wrong.
The count, and how it was measured. A near copy here is a document that holds the two key terms of the task, governs and created_by. The tree is a present tree sealed for the five harder probes of #1472 with tools/probe/seal.sh. In that tree, grep -r -l 'created_by' docs | wc -l prints the documents that hold the first term, and xargs grep -l governs over that list prints the near copies. Then grep -n -i -E "no verb (of this engine )?writes|person types|is hand entry" over the near copies prints each candidate sentence. A person reads each candidate and keeps the documents that state the answer hand about governs.
The recount of 2026-10-03, after #1642. #1642 repaired three current documents that stated the answer hand: HW-DR-0074, the orchestration architecture and HW-OBL-0001. Each one now cites HW-DR-0104. On the tree of that change, sealed as above, the first search printed 52 documents, and 39 of them are near copies. These 4 of the 39 state the answer hand about governs:
- HW-DR-0083 itself, which is
superseded. - HW-OBL-0105, at
discharged: "No verb of this engine writes either edge". - The generated index
docs/decisions/README.mdand the tombstonedocs/spec/09-open-questions.md, which each print the summary of HW-DR-0083 beside the marksuperseded.
The other candidate sentences are about another relation or another artifact. docs/taxonomies/brd-prd/doctrine.md says that a person types the line of a relation between a business need and a product document, and it cites HW-DR-0083. It does not name governs, so the count leaves it out. HW-DR-0104 and the contract of headwater new state the expected answer. The contract says that --relates accepts a relation that declares created_by: agent.
The first count, before #1642. On a tree sealed the same way earlier on 2026-10-03, the same method found 52 documents, 39 near copies, and 7 of the 39 that state the answer hand. The three documents that #1642 repaired were the difference.
The distractors are not built for this probe. Each one is a document of this corpus that went stale when HW-DR-0104 landed. A campaign over this probe therefore measures the corpus as it is. If a later change repairs more of these documents, the count above falls, and this probe must count again before it runs.
This is the probe that the campaign of 2026-10-03 ran, and it is superseded (#1709). Its key held against HW-DR-0104. The recount above missed one current near copy: the governs-edges evaluation said that a person or an agent types the line. #1709 repaired that sentence, and the repair changed the tree that this probe measures. So its successor asks the same task with the same key over the repaired tree. The recorded results under docs/probe-results/ and docs/probe-runs/ stand, and nobody rewrites them.