# I18N INVENTORY — every Hungarian string a household meets, counted (2026-09-17)

**Run class:** spike, Phase 0 of the localisation starter. **Operator:** Claude Code on DooPlex.
**Baselines:** felhom-controller `89dd3e94b1de` (v0.246.0) · felhom-agent `d9864a94bf62` (v0.132.0) ·
felhom.eu `851198af7ff0` (hub v0.117.0) · app-catalog-felhom.eu `94bc5febaca2`.
**Instrument:** `scripts/i18n_inventory.py`, sha256
`be69b48d4d98ac47c0cec531cae63bee8ef009cacbbe2b5c45725cfb2fd40f0c`. Raw output and per-string JSON:
`audits/i18n-2026-09-17/inventory.md`, `inventory.json`.
**What was counted:** the controller at its baseline commit (a clean worktree of `origin/main`, so the
spike's own conversion is NOT in these numbers), the other three repos at their baselines.
**Design this feeds:** `architecture/10-localisation.md`.

---

## 0. Claims in the starter prompt that live source disproved

Named first, as the prompt asked. Four were already named in its §1; these are further ones.

1. **„`fmtTime`, `fmtBytes`, `timeAgo` — none of these exist. The FuncMap has one size helper,
   `fmtMB`."** — **Wrong, and it is the claim that matters most for localisation.** All three exist
   (`internal/web/funcmap.go` `timeAgo` L265, `fmtTime` L318, `fmtBytes` L403), and so do **nine more
   helpers whose output is copy or locale-shaped**: `fmtGB`, `humanBytes`, `timeAgoStr`, `fmtTimeStr`,
   `fmtTimeShort`, `fmtDuration`, `nextRunLabel` („ma"/„holnap"), `pruneLabel` („vasárnap"/„naponta"),
   `nextPruneLabel`, `statusText`, and `stateLabel` (the app-state words). There are **four** size
   helpers (`fmtMB`, `fmtGB`, `fmtBytes`, `humanBytes`), not one. `timeAgo` builds Hungarian with `%d`
   („%d perce") — the plural problem lives there.
2. **„`fmtMB`, used 10× in templates"** — **8×** (`grep -c` over templates, and the script agrees).
3. **„~13 `.Format(` calls in `internal/web/*.go` (`2006-01-02` ×6, `2006-01-02 15:04` ×4, `15:04` ×2,
   `01-02 15:04` ×1)"** — at the baseline: `2006-01-02` **×4**, `2006-01-02 15:04` **×3**, `15:04` **×2**,
   `01-02 15:04` ×1 = **10** layout literals, plus **8** `time.RFC3339` (machine, locale-free). The two
   template layouts are as stated and do disagree (`2006. 01. 02. 15:04` vs `2006-01-02 15:04`).
4. **Template line count „1 613 (afternoon) / ~1 838 (morning)"** — **1 553**, by two independent methods
   (this script, and `grep -cP` on the concatenated templates under `LC_ALL=C.UTF-8`). Neither prompt
   figure was reproduced. Tried: adding typographic quotes „ ” (1 556), adding dashes and ellipsis
   – — … (1 751), counting `style.css` too (1 559). The afternoon figure is **+60 (3.9 %)** and its method
   is unknown; the morning figure is closest to the dash-inclusive variant. **Lines are the wrong unit
   anyway** — see §1: the string count is 1 867.
5. **Go literal count „1 234 in 99 files (afternoon) / ~1 971 in 125 (morning)"** — **1 141 literals in
   84 files** by a Go lexer (comments skipped), first-boot wizard excluded. A `grep` of quoted Hungarian
   on non-comment lines gives 1 106 lines in 85 files, so the two methods agree. Counting lines that
   hold an accented letter **including comments** gives 1 360 in 107 files; including the wizard and
   `cmd/`, 1 375 in 108. The prompt's figures sit between the comment-free and comment-inclusive
   counts; **comments explain most of the gap** (Hungarian quoted in Go comments is common here).
6. **Console banner „33 Hungarian lines"** — 33 by accented letter, **34** once ASCII-only Hungarian
   words are counted. Not an error; a method difference, stated.

Confirmed as the prompt states: 36 page templates + `style.css`; 33 carry Hungarian; the second
template set and its one helper (`internal/setup/handlers.go` L79 `timeNow`); 8 wizard pages, **86**
Hungarian lines; `customerMessages` in the hub; 53 catalog files with `first_steps` under `app_info`;
no i18n library, no `Accept-Language`, no bundle anywhere.

---

## 1. Controls — the counts below mean something

Hungarian is matched by accented letter (the letters written as `\u` escapes, so the script itself is
ASCII) **or** by one of 46 ASCII-only Hungarian words („Fut", „Nincs", „Hiba", „Csak", „Megszakadt"…),
case-insensitive. Every surface prints a positive control (an ASCII fragment of a Hungarian word known
to be there, whose lines the matcher must flag) and a negative control (a fragment known absent; an
English sentence that must not be flagged).

| surface | positive fragment | lines holding it | flagged | negative hits | English line flagged | verdict |
|---|---|---|---|---|---|---|
| controller templates | `pult` | 20 | 20 | 0 | no | ok |
| controller Go | `ment` | 832 | 278 | 0 | no | ok |
| hub customer Go | `ment` | 35 | 18 | 0 | no | ok |
| installer banner | `Felhom` | 10 | 5 | 0 | no | ok |
| catalog | `Alkalmaz` | 5 | 5 | 0 | no | ok |
| guide | `Felhom` | 14 | 13 | 0 | no | ok |

**Measured limit of the ASCII word list.** The spike's conversion tool first used a 40-word list and
**missed eight Hungarian strings on the three pages** („Megszakadt:", „Elavult", „Csak x86",
„Pi kompatibilis", „Rendszermonitor", „Most nem", „sikertelen", „ismeretlen"); a by-eye review of what
was left found them, and they were added. **An ASCII-only Hungarian word that is not on the list is
still invisible to every count here.** The counts below are therefore floors, not totals.

---

## 2. The tables

### 2.1 Controller page templates (`internal/web/templates/`, 36 files)

**1 867 strings: 1 161 text runs + 88 attribute values + 618 inline-JS string literals.** 1 553 lines
carry an accented letter. A *run* is text up to the next block tag or control action — the unit a
translator needs.

| template | HU lines | text | attr | JS |
|---|---|---|---|---|
| deploy.html | 156 | 87 | 8 | 77 |
| storage.html | 110 | 43 | 9 | 98 |
| debug.html | 92 | 41 | 16 | 79 |
| layout.html (on every page) | 88 | 35 | 1 | 70 |
| backups_remote.html | 77 | 87 | 0 | 10 |
| settings_system.html | 84 | 58 | 0 | 36 |
| backups_apps.html | 80 | 79 | 7 | 6 |
| … 26 more | | | | |

Full per-file table: `audits/i18n-2026-09-17/inventory.md`. **One third of all template copy (618) is
inside `<script>`** — modal bodies and confirm questions built as JS strings, often with HTML inside
and with the sentence split around a `+ name +` concatenation. Most repeated: „Mentés" 10×, „Jelszó"
7×, „← Vissza" 7×, „Törlés", „Hiba", „Beállítás", „Mégsem", „Újraindítás", „Betöltés...", „Frissítés"
6× each.

### 2.2 Controller Go (non-test, wizard excluded)

**1 141 literals in 84 files.** Classified by the statement they sit in:

| kind | count | meaning |
|---|---|---|
| shown | 947 | assigned to page data, flash, alert, event text, struct fields |
| error | 184 | `fmt.Errorf` / `errors.New` — **reaches a page** wherever a handler prints `err.Error()` |
| compared | 7 | matched, not shown — §3 |
| log only | 3 | logs are English by convention; three are not |

Word-order hazards (non-log): **237** format strings with parameters, **111** concatenations, **42**
with a numeric `%d` (English needs a plural form; Hungarian does not inflect after a numeral).
Heaviest files: `web/handlers.go` 115, `cloudflare/countries.go` 113 (country names for the geo
filter), `web/offbox_handlers.go` 70, `web/storage_handlers.go` 45, `web/handler_debug.go` 39,
`backup/offbox_reconstitute.go` 38, `notify/notifier.go` 31. Most repeated: „érvénytelen kérés" 13×,
„A távoli mentési cél nincs beállítva." 9×, „Rendszermonitor" 7×.

**A classification caveat, measured:** a flash message travels to the page **inside the redirect URL**
(`?flash=<Hungarian text>`, e.g. the launcher's `ShareFlash`), so it is rendered in whatever language
the handler that redirected spoke. Slice 2 has to move these to keys, not only translate them.

### 2.3 Hub → customer

**65 literals in 4 files**: `notify/templates.go` 57 (the 39-entry `customerMessages` map, the 4
`severityLabels`, the body wrapper, and the claim / re-enroll / reset / claimed / self-bind mails),
`notify/dispatcher.go` 4, `web/customer_reset.go` 2, `web/selfbind.go` 2 (plus the public bind page's
19 Hungarian lines). 8 are multi-line raw blocks. One message (`app_start_failed`) is in the formal
„ön" register. For scale and **out of scope** (operator pages): all hub Go 83 literals; operator
templates 64 strings.

### 2.4 Installer

Console banner `scripts/iso/felhom-bootstrap.sh`: **34** lines, printed with `printf` blocks to the
console device (pairing, bound, `/etc/issue`, no-network screens). The `/etc/issue` text must stay
byte-identical to `iso/pkg/debian/postinst` and avoid ő/ű (the console font) — a constraint English
does not share but a second language on the same screen does. Download page `website/letoltes.html`:
**32** strings.

### 2.5 Catalog

**835 strings, ~4 984 words, in all 53 `.felhom.yml`.** No multi-language structure exists.

| field | strings |
|---|---|
| `app_info.use_cases[]` | 262 |
| `app_info.first_steps[]` | 233 |
| `deploy_fields[].description` | 79 |
| `deploy_fields[].label` | 68 |
| `app_info.prerequisites[]` | 60 |
| `description` | 56 |
| `app_info.tagline` | 53 |
| other (`label`, `help_text`, `default_creds`, `note`, `group`) | 24 |

The controller parses these with a plain `yaml.Unmarshal` that ignores unknown keys
(`internal/stacks/metadata.go` L317), so a sibling key per language is additive.

### 2.6 Guide

`runbooks/VOLUNTEER-first-hour.md`: 182 lines, **44 paragraphs (42 Hungarian), ~1 579 words.**

### 2.7 First-boot wizard — reported separately, never merged

`internal/setup/templates/` (8 pages): 86 Hungarian lines; **95 strings** (81 text, 12 attr, 2 JS).
Go: 16 literals. **When a household can still see it** (read from source): the controller runs
`bootstrap.MaybeIngest` (`cmd/controller/main.go` L314) and then `setup.NeedsSetup(cfg)` (L322), which
is true when `customer.id` is still empty **or** a `.needs-setup` marker exists in the data dir
(`internal/setup/setup.go` L17-25). Ingestion leaves `customer.id` empty — and the wizard therefore
starts — when `bootstrap.json` is missing, unreadable, not JSON, not schema `felhom.bootstrap/v2`, or
lacks `customer.id` / `hub.url` / `hub.retrieval_password` / the `local_api` block; when the hub pull
fails (auth and not-found at once; unreachable after retries at 2/4/8 s); or when the merge, the
atomic write or the reload fails (`internal/bootstrap/bootstrap.go` L109-163). **Operator decision
2026-09-17: out of scope, obsolete — a separate row to delete it.**

### 2.8 Dates, numbers, sizes

| where | layout | sites |
|---|---|---|
| internal/web Go | `2006-01-02` | 4 |
| internal/web Go | `2006-01-02 15:04` | 3 |
| internal/web Go | `15:04` | 2 |
| internal/web Go | `01-02 15:04` | 1 |
| template | `2006. 01. 02. 15:04` (Hungarian) | 1 |
| template | `2006-01-02 15:04` (ISO) | 1 |

Plus 25 `.Format("` calls elsewhere in the controller, and the helpers in §0.1. Sizes print `GB`/`MB`
with a **decimal point** (`%.1f`) — Hungarian convention is a decimal comma, so the Hungarian pages are
already un-Hungarian here; that is not a localisation regression and the spike does not change it.

---

## 3. Compared, not shown — each is a latent bug

A string matched by its Hungarian wording breaks the moment the wording is translated **or reworded**.

| where | what is matched | consequence if the text changes |
|---|---|---|
| `internal/api/router.go:478` | a deploy error contains „kötelező" or „memória" | a validation failure becomes **500 instead of 400** |
| `internal/backup/offbox.go:186` | a restic error contains „tárhelykeretet" | the off-site **quota** failure is no longer classified as quota |
| `internal/web/alerts.go:208` | a health warning contains „meghajtón" / „adattároló" / „meghajtó" | a disk warning moves from its inline place to the **top banner of every page** |
| `internal/web/handlers.go:927` via `offboxStaleWarningMarker` („nincs mentésre jelölt alkalmazás") | a **persisted** warning string | the „selection changed" line is no longer substituted — and a warning written in one language is compared in another |
| `internal/web/offbox_handlers.go:132` | — | **false positive** of the detector (`!= ""` belongs to `stageErr`, not the literal) |

Templates: **0** compares against Hungarian (a detector decoy with `eq .State "Leállítva"` was flagged,
so the zero is measured). JS: no `===` / `indexOf` / `includes` against a Hungarian literal.

---

## 4. What this inventory does not see

- ASCII-only Hungarian words outside the 46-word list (§1).
- Hungarian arriving at run time from outside the repos: app containers' own UIs, agent error strings
  relayed verbatim, hub-pushed text.
- Whether a `shown` Go literal actually reaches a page (classification is by statement, not by data
  flow) and whether an `error` literal is printed or swallowed.
- The **formal „ön" register** inside Hungarian copy (R-516) — counted only on the converted pages, by
  the new `i18n_missing_gate.py` (6 occurrences).