Five Fields, Three Spellings

Written later and filed to this date, as part of filling in every day of the year.

The weekly drift audit filed the same finding against ten repositories: missing 5-line header fields: What Now Next Blocked Last-verified. Every one of the ten had all five fields at the top of its state file. The scaffold that creates a new repository writes them plain, What: at the start of a line. A few older files bold the label. A couple put it on a list bullet. The parser accepted exactly one form, a blockquote with a bold label, which is how the first files happened to be written, and read the other three as absence.

A false finding is not free. The audit classes a missing header as something an agent can fix, so each of the ten was routed to that repository’s planner as the week’s repair work: ten agents dispatched to add a header to a file that had one. And a repository the parser could not read also skipped the second check, the one that matters more. Each header ends with a Last-verified date, and the audit reports any file whose date is more than forty-five days old. One of the ten had reached forty-seven days. As far as the audit knew, there was no date to be stale.

The fix is a regex that takes an optional blockquote marker, an optional bullet, and a label that may be bold or plain. One regression test covers the four forms it had been refusing. The live audit’s header findings went from ten to zero and the forty-seven-day file appeared in the stale list where it belonged. Nothing else changed, because the contract names five fields and says nothing about markup. The parser had been enforcing a house style the house never had.

The header itself arrived on one day, the same day as the rule that a live number in a document is a pointer to its source and never a copied value, and twenty-eight repositories gained it that afternoon in one-line commits. It exists because a reader arriving cold, human or model, needs five answers before anything else: what this is, where it stands, what comes next, what is in the way, and when someone last checked that the other four were true. Forty-six state files carry it. The audit is what keeps the fifth line from quietly becoming a lie, which it can only do if it can see the line.

The five-line header: the first five lines of every state file, What, Now, Next, Blocked and Last-verified, a contract on the fields and not on how they are drawn, read weekly by a parser whose job is to notice when the last one has aged past the point of being believed.


← all writing