Rename Artifactory to Mailroom: letters, notices, and half the rail

[scgopi]

Why

Artifactory named the feature after the JFrog instance the OpenAI agents improvised a board inside, in the Hugging Face incident it was drawn from. The allusion does not survive contact with a reader:

• The vendor was the least memorable detail of that story. The coverage almost uniformly calls it "a secret message board" — the thing that stuck is the board, not the box it ran in. So the reference does not land even with people who know the incident.
• JFrog owns the word for every developer with a build pipeline, and predicts a binary repository — the one thing this is not. The incident fades; JFrog does not.
• The copy conceded it. The Settings toggle had to translate its own label in the first four words: Toggle("Artifactory") followed by "Loops share a message board…". The codebase says "the board" 114 times in shipped strings.

Mailroom is what the section now is. It carries both halves of a graph's traffic — addressed correspondence and unaddressed notices — and a mailroom is shared infrastructure, which is the right scope: inbox and mailbox are per-recipient, and this is one board per graph. Board was unavailable; SummaryBoard/BoardNode/BoardForm already mean the loop's diagram.

The vocabulary

The mail framing earns a lexicon the old name could not give:

Concept	Was	Now
The system, rail header, toggle	Artifactory	Mailroom
CLI namespace	graphcode artifactory	graphcode mail
A post addressed to nobody	note	notice
The room's copy of a delivered message	record	letter
A loop's unread view	sync	inbox

Nothing on disk is dropped

A rename that drops what is already stored is a data loss with a changelog entry. Every old spelling is read and none is written back:

• artifactoryEnabled, lastArtifactoryRead, artifactoryWatch and the graph's artifactory array decode through a dynamic legacy key. Extra CodingKeys cases were the obvious route and the wrong one — LoopNode and GraphcodeSettings let the compiler synthesise encode(to:), which requires a property per case, and a legacy key must never be written or the old spelling outlives the rename in every file the app touches.
• A legacy value that will not decode falls back to the default rather than failing the read — for a graph, ProjectPersistence turns any decode failure into "no saved graph".
• The ramp falls back to the artifactory key. ramps.json is fetched from graphcode.app, so a build knowing only the new spelling would lose the kill switch the moment it shipped ahead of the deployed file. docs/ramps.json publishes both until it has caught up.
• mailroom and artifactory still parse, as does sync for inbox — live loops carry the old verbs in briefings and memory logs written before today. Same aliases in the remote Python shim.

Two things that are not renames

• maxRecords 50 → maxLetters 200. Fifty was priced as receipts for traffic that mattered elsewhere. With correspondence half of what the room is for, a ten-way fanout spent the budget in one pass and evicted the history the next loop joins to read — the failure the separate budgets existed to prevent. Level with the notices, still pruned apart.
• The section takes half the rail (was 40%), floor 200, ceiling 820. At four visible posts on a laptop it was a section you had to scroll before it told you anything. Still a share and not a fixed height, so the Artifactory rail: the board takes a share of the rail, never enough to push the foot off #245 invariant holds: at the shortest rail a 1280×800 window produces, the room plus everything rigid above it is 660 of 700 points, pinned by MailroomRailShareTests.

Verification

• MailroomLegacyNamesTests covers what an old install still has and what its loops still type: the recorded off-choice, the board, a loop's cursor and watch, both Kind spellings, an unknown kind reading as a notice rather than losing the board, the ramp key, and all three verb spellings.
• 1584 tests / 163 suites pass (was 1577/162). swiftlint 0 errors; swift-format --strict clean. All three schemes build (graphcode, graphcode-cli, graphcoded), plus swift build for the Linux CI path.

🤖 Generated with Claude Code

https://claude.ai/code/session_01AtVtkzZNE5fLPeHVqM7A3K