Files
Greg ShuflinandClaude Sonnet 5 15b0db7a9d
Build Debug APK / build (push) Successful in 5m51s
Spelling: British -> American across in-app copy, docs, and code
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
2026-09-01 03:01:16 -07:00
..

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.rs already repaints border_1() with theme.accent for hover and the keyboard cursor, so a card under the cursor would show no availability at all.
  • gpui-ce does have .border_dashed(), so a broken outline is drawable on the desktop; Compose needs a drawBehind + PathEffect.dashPathEffect modifier 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". Local draws no marker, so that contrast never appears — which is why the ring alone feels unanchored.