Rewrites every British spelling found in the codebase to American: neighbour, colour, catalogue, behaviour, honour, flavour, grey, judgement, acknowledgement, licence, defence, organise/optimise/initialise/recognise/ analyse, artefact, cancelled/cancelling, labelled/labelling, modelled/ modelling, and centre/centred/centring all become their American forms — consistently in prose (docs, ADRs, comments) and in identifiers, including the FFI-shared CatalogueSync/Cancelled enum variants and catalogue_* fields that cross the Rust/Kotlin boundary. Left untouched: external API names that only look like a spelling variant (kotlinx.coroutines.CancellationException/NonCancellable, Compose Material3's labelLarge) and the EFF diceware wordlist used for key derivation. Adds a Code Style rule to AGENTS.md/CLAUDE.md requiring American spelling in user-facing copy and documentation going forward, with that same carve-out. Verified: cargo build --workspace, all 1410 Rust tests, Kotlin compile, fmt-rust/fmt-kotlin, lint-kotlin-fast (detekt), and the lint-gui-layout/ lint-sql-params/lint-p2p-admission custom checks all pass clean. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017fHWzCF6oNiCV4ue1bBf1t
Availability-marker specimen
Builds a single self-contained HTML page comparing candidate markers for
DocumentAvailability — the
thing Cloud/CloudOff does today — on the real theme.rs palette with the
real dimming, in the three places the app has to draw them.
The page treats those three places as three different problems rather than one, because they are: a grid card has no spare pixel that isn't artwork, a list row has an entire empty trailing column, and a 260px sidebar rail has room for an 8px mark and nothing else. Marks are drawn at their real pixel sizes; the cards around them are at half scale.
This is the tool that produced the decision behind ADR 0033. Reach for it when reconsidering that marker, not for anything the app ships.
Running it
No dependencies beyond a stock Python 3; the two icon packages are downloaded on first run.
cd design/availability-marker
python3 gen_page.py
Downloads and the page land in .work/ (gitignored). Set MARKER_WORK to
point somewhere else.
Why it reads the upstream packages
Both candidate icon sets are extracted from the exact upstream artifacts the
app builds against — lucide-static at the version
rust/gui-app/scripts/vendor-icons.sh pins, and @material-design-icons/svg,
the SVG mirror of androidx.compose.material:material-icons-extended. A name
that does not exist raises at generation time rather than rendering a blank.
That is not incidental. The TODO entry this exploration answers had recorded
three candidate pairs from memory, and two of them were wrong: Lucide has no
link-off (it is link-2 / link-2-off) and no devices at all. Anything
typed into CANDIDATES is checked against the real package before it can be
argued about.
Adding a candidate
Add a panel(..) to whichever of grid_panels / list_panel /
sidebar_panel it belongs in. A grid treatment is a function
(theme, state, index) -> card(..), where card takes one keyword per place a
mark can live: badge (over the art — what is being replaced), frame,
ring_outside, under_rule, trailing_word, below_dot. Marks themselves come
from dot(..) (the app's presence primitive, at four completenesses),
word(..), or rule(..).
card(.., hovered=True) paints the cover border theme.accent the way
media_library.rs does for hover and the keyboard cursor — use it on any
treatment that wants to put state on that border, to see what the cursor does
to it.
The three states
Worth keeping in view while looking, because the shipped pair obscures it:
| State | Means | Today |
|---|---|---|
Local |
everything known is here | no marker |
Remote |
something is missing, every missing piece has a known holder — the ordinary condition in an ensemble | Cloud, secondary |
Unavailable |
nothing has claimed it. Advisory, not proof: a node that holds the bytes but never said so is indistinguishable from one that does not | CloudOff, warning |
What it settled
- The cover's frame is not available to carry state:
media_library.rsalready repaintsborder_1()withtheme.accentfor hover and the keyboard cursor, so a card under the cursor would show no availability at all. gpui-cedoes have.border_dashed(), so a broken outline is drawable on the desktop; Compose needs adrawBehind+PathEffect.dashPathEffectmodifier for the same thing.- A hollow ring reads as "the shape is known, the substance is elsewhere" only
when a filled one is on screen meaning "the substance is here".
Localdraws no marker, so that contrast never appears — which is why the ring alone feels unanchored.