@elite-dangerous-almanac/core 0.2.6 → 0.2.8

package/PROVENANCE/equipment/SOURCES.md

@@ -1,33 +1,38 @@
 # Data sources — `data/equipment/`
 
+## Upstream snapshots this domain is pinned to
+
+Referred to throughout by source name; the pin is here, once.
+
+| Source                                            | Pin                                                                                                                                                            | Acquired       |
+| ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
+| Odyssey Materials Helper                          | commit `2e6d4c3e767d2b714ffddc5c9386831d66812916` (2026-08-09), the last revision before the project extracted its core data into a separately distributed dependency | 2026-08-13 UTC |
+| Frontier Elite Dangerous Gamestore                | no immutable revision; the displayed weapon names were read on the acquisition date                                                                            | 2026-08-13 UTC |
+| Elite Dangerous in-game observation               | no game version recorded; direct reading of the suit and weapon stats panels, the sight magnification they show, and the on-foot engineering options            | 2026-08-31 UTC |
+
+**Where a source and the game disagree, the in-game reading governs.** Odyssey Materials Helper
+supplies the identities, the slot and grade structure, the engineer availability and
+every material shopping list; the stat values are the ones the game itself shows.
+
 ## Personal suits, handheld weapons and engineering
 
 - **Files:** `suits.jsonc`, `weapons.jsonc`, `upgrade-costs.jsonc`,
   `modifications.jsonc`, `modification-costs.jsonc`,
   `modification-journal-names.jsonc`.
-- **Acquired:** 2026-08-13.
-- **Source:** Odyssey Materials Helper.
-- **Upstream revisions:**
-  - Odyssey Materials Helper commit `2e6d4c3e767d2b714ffddc5c9386831d66812916`
-    (2026-08-09), the last revision before the project extracted its core data into a
-    separately distributed dependency.
-  - Frontier Elite Dangerous Gamestore product pages have no immutable revision; their
-    displayed weapon names were read on the acquisition date above.
 - **Derivation:**
   - `Suit.java` supplies the four suit families, journal symbols, weapon-slot counts and
-    grade-dependent shield strength, shield regeneration, resistances and modification
-    slots. English suit display names come from
+    the grade-dependent modification slots, shield strength and shield regeneration.
+    English suit display names come from
     `application/src/main/resources/locale/loadout/equipment.csv`. `family` removes
     `_class{grade}` from the grade-specific Frontier `symbol`; the exact symbol remains
     on every grade. Shield strength is in shield points, shield regeneration in shield
-    points per second. The source's resistance percentage points are divided by 100 into
-    fractions, matching the resistance convention used by the ships domain (`0.5` means
-    50% resisted).
+    points per second.
   - `Weapon.java` supplies the eleven handheld weapons, their exact journal symbols,
-    class, slot, damage type, fire mode and combat stats. English weapon display names
-    come from `application/src/main/resources/locale/loadout/equipment.csv`. Damage is
-    per projectile or pellet, rate of fire is shots per second, effective range is
-    metres, and the source's headshot percentages are divided by 100 into multipliers.
+    class, slot, damage type, fire mode, magazine size, headshot multiplier and effective
+    range. English weapon display names come from
+    `application/src/main/resources/locale/loadout/equipment.csv`. Damage is per
+    projectile or pellet, rate of fire is shots per second, effective range is metres,
+    and the source's headshot percentages are divided by 100 into multipliers.
   - `OdysseyBlueprintConstants.java` supplies each one-step suit and manufacturer-family
     weapon upgrade recipe, all engineer-applied modification recipes, and the engineers
     who offer them. Enum names are joined to the lower-case Frontier micro-resource
@@ -36,17 +41,134 @@
     the source's `karma`, `takada` and `manticore` identities; `engineeringType` separately
     records the `kinetic`, `laser` or `plasma` suffix used by modification recipes.
   - `SuitModification.java` and `WeaponModification.java` supply the journal symbols.
-    English modification display names come from
-    `application/src/main/resources/locale/loadout/modification.csv`; English engineer
-    names come from `application/src/main/resources/locale/engineer/names.csv`. A recipe
-    is keyed by its symbol rather than by a derived library id. Greater Range, Headshot
-    Damage and Higher Accuracy retain their nine distinct Kinetic, Laser and Plasma
+    English engineer names come from
+    `application/src/main/resources/locale/engineer/names.csv`. A recipe is keyed by its
+    symbol rather than by a derived library id. Greater Range, Headshot Damage and
+    Improved Hip Fire Accuracy retain their nine distinct Kinetic, Laser and Plasma
     recipe symbols. The journal writes only three unsuffixed symbols, so
     `modification-journal-names.jsonc` records that collision once for resolution against
     the weapon. `modification-costs.jsonc` is split from recipe metadata so an identity
     lookup does not bundle every shopping list, matching the ships engineering boundary.
-- **Manual corrections:** Odyssey Materials Helper's English locale calls the four Karma
-  weapons “Kinematic” and expands the three TK weapon names to “Takada”. The Frontier
-  Elite Dangerous Gamestore confirms the in-game prefixes are `Karma` and `TK`, which are
-  stored here. Frontier's misspelled `surveilleancelogs` symbol is kept verbatim so it
-  joins to journal inventory data and the micro-resource catalogue.
+  - **In-game observation supplies every stat value** described in the three sections
+    below: the suit-wide component stats and the four resistances, the weapon combat
+    stats and damage, and the multipliers each modification applies.
+
+- **Manual corrections:**
+  - Odyssey Materials Helper's English locale calls the four Karma weapons “Kinematic”
+    and expands the three TK weapon names to “Takada”. The Frontier Elite Dangerous
+    Gamestore confirms the in-game prefixes are `Karma` and `TK`, which are stored here.
+  - Frontier's misspelled `surveilleancelogs` symbol is kept verbatim so it joins to
+    journal inventory data and the micro-resource catalogue.
+  - Three modification display names are the in-game text rather than the source's:
+    `Faster Shield Regeneration`→`Faster Shield Regen`,
+    `Higher Accuracy`→`Improved Hip Fire Accuracy`, and `Stowed Reloading`→
+    `Stowed reloading`. The last keeps Frontier's own lower-case second word; it reads
+    like a typo and is not one, so do not "fix" it back.
+
+### Suit stats read in-game
+
+The suit stats panel is read per suit family and per grade.
+
+- **Suit-wide, identical at all five grades**, so they are stored once per family rather
+  than per grade: `health` (30 on every suit), `mass` (100 kg on every suit),
+  `batteryCapacity` in energy units, `oxygenTime` in seconds of emergency air,
+  `boostAcceleration` for the jump assist, the three backpack capacities
+  (`goodsCapacity`, `assetsCapacity`, `dataCapacity`), `footstepAudibleRange` as a
+  multiplier of the base audible range (1 on every suit), `losAnalysisRange` in metres
+  (50 on every suit) and `losAnalysisTime` in seconds (1 on every suit). The constant
+  ones are stored anyway: a suit-stats view reads them like any other field, and a value
+  that is the same everywhere is still the value.
+- **Resistances are stored as fractions** (`0.5` means half the damage taken),
+  matching the ships domain. The panel's own figure is the same fraction as a
+  percentage, so a negative resistance is a weakness. Every resistance is now the
+  panel's, which corrects nine grade rows against Odyssey Materials Helper:
+
+  | Suit and grade      | Field → stored value                                                    |
+  | ------------------- | ------------------------------------------------------------------------- |
+  | Artemis 1           | `thermalResistance` 0.39→0.4                                            |
+  | Artemis 2           | `kineticResistance` -0.42→-0.43; `plasmaResistance` 0→-0.01             |
+  | Artemis 3           | `plasmaResistance` 0.14→0.15                                            |
+  | Artemis 5           | `kineticResistance` 0.14→0.15; `plasmaResistance` 0.39→0.4              |
+  | Flight Suit         | `thermalResistance` 0.39→0.4                                            |
+  | Dominator 4         | `kineticResistance` 0.19→0.11; `thermalResistance` 0.78→0.76; `plasmaResistance` 0.46→0.41; `explosiveResistance` 0.46→0.41 |
+  | Maverick 2          | `plasmaResistance` 0.07→0.08                                            |
+  | Maverick 3          | `kineticResistance` -0.13→-0.14                                         |
+  | Maverick 5          | `kineticResistance` 0.19→0.2                                            |
+
+- **Shield strength and shield regeneration are unchanged.** Every stored value already
+  matches the panel, which is also why the resistance disagreements are read as source
+  rounding rather than as a different snapshot of the game.
+- **A grade changes the armour, the shield generator, the modification slots and the
+  item symbol.** Nothing else on a suit moves with the grade, which is what makes the
+  suit-wide fields safe to store once per family.
+
+### Weapon stats read in-game
+
+- **Rate of fire** is the panel's, correcting `Karma AR-50` 9.5→9.52,
+  `TK Aphelion` 5.7→5.71, `Manticore Oppressor` 6.7→6.67, `Manticore Intimidator`
+  1.3→1.25, `Manticore Tormentor` 1.7→1.67, `Manticore Executioner` 0.8→0.833 and
+  `TK Zenith` 5.7→2.78. The Zenith is the one large disagreement and it is not a
+  rounding difference: it fires bursts, and 2.78 is the rate the panel shows.
+- **Reserve ammunition** is the panel's, correcting `Karma P-15` 120→240,
+  `Karma AR-50` 200→250, `TK Eclipse` 280→315 and `TK Zenith` 90→180. It is the reserve
+  a stock suit carries, before the Extra Ammo Capacity modification.
+- **Magazine size, effective range, class, slot, damage type and headshot multiplier**
+  are unchanged: every one already matches the panel.
+- **Damage** is the grade-1 figure read in-game, times the grade multiplier the game
+  applies to it — `1`, `1.31`, `1.73`, `2.27`, `2.98` for grades 1 to 5. Each product is
+  taken in double-precision floating point and rounded to three decimals, as
+  `Number(x.toFixed(3))` does it; that reproduces all 55 stored figures exactly. The
+  rounding rule has to be stated rather than assumed, because twelve products land on a
+  half and are therefore broken in both directions, and because scaling before rounding
+  (`Math.round(x * 1000) / 1000`) re-introduces error and misses eight of the 55.
+- **The multipliers are what Odyssey Materials Helper's own figures follow.** On the four
+  weapons whose grade-1 damage needed no correction — `Karma L-6`,
+  `Manticore Executioner`, `Manticore Tormentor` and `Manticore Oppressor` — its grades 2
+  to 5 sit within 0.05 of the same progression on 15 of those 16 rows, which is half of
+  one decimal — the most a figure rounded to one decimal can move. The exception is `Karma L-6` grade 4: 90.8 here, and
+  90 in that source alone.
+- **Every weapon's damage therefore changes**, and by more than rounding wherever the
+  grade-1 figure itself had been rounded: `Karma C-44` 0.6→0.65, `Karma AR-50` 1→0.95,
+  `TK Eclipse` 0.9→0.85, `Karma P-15` 1.4→1.38, `TK Aphelion` 1.6→1.572, `TK Zenith`
+  1.7→1.668 and `Manticore Intimidator` 1.8→1.75. Damage is stored at the precision the
+  game reports it, which is why two of those grade-1 figures carry three decimals where
+  the panel shows one.
+- **`scopeMagnification` is new**: the aim-down-sights magnification the panel shows with
+  the sight the weapon ships with, and with the sight the Scope modification fits, both
+  to two decimals. Scope stores no modifier of its own because its magnitude is this
+  pair, and it differs per weapon — `Manticore Executioner` gains 1.61x→3.75x where
+  `Manticore Intimidator` gains 1.08x→1.25x.
+
+### Modification magnitudes
+
+Each recipe carries `modifiers`, the stat multipliers it applies. A modification is
+applied in one step and has no grade or quality roll, so a modifier is a single factor
+rather than the `[min, max]` band a ship blueprint feature carries, and `1` — a factor
+that changes nothing — is never stored.
+
+- **Enhanced Tracking effectively removes the analysis delay** rather than shortening
+  it proportionally: its factor on `losAnalysisTime` is `0.001`, which takes the 1 second
+  every suit needs down to a thousandth of one. It is recorded as the factor it applies,
+  like every other modifier.
+- **A resistance factor multiplies the damage taken**, not the stored resistance
+  fraction. Damage Resistance is `×0.9` on damage taken, so a `0.5` resistance becomes
+  `0.55`. This is the same convention the ships domain uses for resistances.
+- **`roundUp` marks the one result the game rounds up**: Magazine Size multiplies by 1.5
+  and rounds the magazine up to a whole number, so 45 rounds become 68 rather than 67.5.
+- **Six recipes name a stat no catalogue field carries**, because the panel shows no
+  base for it: the melee damage, sprint duration and tool energy drain multipliers, the
+  reload speed, and the pressurised and unpressurised firing audible ranges. The factor
+  is recorded against the stat it moves; the base has to come from the panel.
+- **Ten recipes carry an empty modifier list**, for two different reasons, and both are
+  a statement rather than a gap:
+  - Night Vision, Scope, Stowed reloading and Combat Movement Speed apply no factor to
+    any stat. Night Vision and Stowed reloading switch a capability on, Scope's whole
+    numeric effect is the weapon's own `scopeMagnification`, and Combat Movement Speed
+    changes how a suit moves while aiming without moving a displayed stat.
+  - Faster Handling, Improved Hip Fire Accuracy, Stability and Improved Jump Assist do
+    change stats, but ones the panel puts no number on — weapon handling, hip-fire
+    jitter and recoil, and the jump assist's boost drain and recharge. Improved Jump
+    Assist notably leaves the panel's Jump Assist Boost Acceleration exactly where it
+    was, so recording it against that field would be wrong.
+- **Extra Ammo Capacity multiplies a weapon's `reserveAmmo`**, which is why the reserve
+  stored on a weapon is the stock figure and not an engineered one.

package/PROVENANCE/i18n/SOURCES.md

@@ -1,7 +1,9 @@
 # Localized game-name catalogues
 
-These catalogues keep the canonical English display names already published by the
-ships data domain and add only localized values carried explicitly by accepted sources.
+These catalogues keep the canonical English display names already published by the ships
+and equipment data domains and add only localized values carried explicitly by accepted
+sources. Where a catalogue holds display prose rather than a name, the owning domain
+publishes no English for it and all six values are the source's own.
 They are deliberately sparse: absence means that no accepted source carried a value, and
 the lookup API returns `null` for that locale rather than treating English as a
 translation.
@@ -23,24 +25,60 @@ tag follows the rule above, so `pt-PT` resolves to Brazilian Portuguese.
 
 ## `module-names.jsonc`
 
-- **Acquired:** 2026-08-14 UTC.
-- **EDDI revision:** commit `fdc1f47933bd930464610111fa11fc9dae264414`.
-- **EDSY revision:** commit `e446fbe6e4597dea7ab0bd3105b9a36642388040`;
-  database version `424009901`, last-modified marker `20260810`.
-- **Derivation:** all 1,199 current module symbols and English names come from the four
-  `data/ships/modules-*.jsonc` catalogues. EDDI's `ModuleDefinitions.cs` joins a symbol
-  to a resource key; `Properties/Modules.resx` and its localized siblings supply names.
-  An EDDI value is accepted only when its base English resource exactly equals the
-  Almanac's canonical English name. This prevents broad EDDI families such as
-  `CargoRack`, `MissileRack` and `PlanetaryApproachSuite` from erasing the distinct Mk II,
-  seeker and advanced names the Almanac carries. EDSY's module `fdname` and effective
-  `namekey` fill a missing `de`, `es`, `fr` or `ru` value only when EDSY's English
-  module name also exactly equals the canonical name. Values shared by modules with one
-  canonical name are retained only when they agree, then stored once under that name.
-- **Coverage:** English covers all 1,199 symbols. The explicit translations cover 1,120
-  in German, 1,090 in Spanish, 1,088 in French, 1,155 in Brazilian Portuguese and 1,153
-  in Russian. Portuguese comes from the same two joins, reading EDDI's
-  `Modules.pt-BR.resx` and EDSY's `lang-pt.json`.
+- **Acquired:** 2026-08-30 UTC.
+- **In-game localisation revision:** none published; the game ships no immutable
+  identifier for its localisation tables. The acquired table is the evidence.
+- **Derivation:** all 1,194 current module symbols and English names come from the four
+  `data/ships/modules-*.jsonc` catalogues, which stay authoritative for canonical
+  English. Each symbol joins case-insensitively to the in-game module localisation
+  identity, which carries a `name`, a `longname` and an `info` string per locale. The
+  join is exact and total: every one of the 1,194 resolves.
+  - **`longname` is the name taken.** It is the outfitting list's full name and equals
+    the canonical English on 1,041 of the symbols, where `name` — the abbreviated panel
+    form — equals it on 726. **Both totals were counted over the 1,199-symbol set that
+    preceded the removal of the five plain size-8 drives (§`data/ships/SOURCES.md`), and
+    are not re-derived here:** the in-game localisation table is not vendored, so whether
+    those five sat inside either total cannot be checked from this repository. Read them
+    as upper bounds over 1,194 symbols until the table is re-acquired. `name` is taken
+    only where a longname is a template rather than a name, which is the cargo racks,
+    fuel tanks and corrosion-resistant racks whose longname carries a capacity.
+  - **Aliasing is followed.** A localisation value may be a `$Other_Key;` pointer rather
+    than text; roughly three thousand of the keys are. Each is followed to the entry
+    holding real text before anything is stored, and a value still carrying a `$` token
+    after that is not a name and is rejected.
+  - **The `(Free)` vessel-hangar grants have no name of their own** — theirs is a
+    template wrapping the base hangar's. Their canonical English is already the base
+    module's, so they share its record.
+- **The in-game table is authoritative over the EDDI and EDSY joins.** It carries 349
+  values absent from those registries and differs from them in 3,135 cells across 324
+  distinct record-and-locale pairs: 73 differ only in letter case, 10 only in punctuation
+  or accents, and 241 in wording. Many of the last are the game being specific where the
+  registries are general — Russian `Двигатели` is `Маневровые двигатели`, Brazilian
+  Portuguese `Propulsores` becomes `Propulsores de desempenho melhorado`.
+- **The least abbreviated spelling is the one stored**, as it is in
+  `material-names.jsonc`. The outfitting panel shortens a label that will not fit, and
+  that is a rendering rather than a different translation, so where the panel abbreviates
+  the longest unabbreviated spelling available for that module and locale is taken
+  instead — the catalogue's own previous value where it had one, otherwise the source's
+  other field. French `Laser à impuls.` is stored as `Laser à impulsion`, Russian
+  `Разбрас-ль дип. отражателей` as `Разбрасыватель дипольных отражателей`. An
+  unabbreviated candidate is rejected when it is so much shorter that it is plainly a
+  different label rather than the same one spelled out: German `EGM` does not replace
+  `Elektr. Gegenmaßnahmen`. **Ten values remain abbreviated** because no source spells
+  them out — the Mk II gravity-optimised thrusters in four locales, the Advanced
+  Planetary Approach Suite in three, and three others — and there the alternative is a
+  bare `Schubdüsen` or `Propulseurs` that loses what distinguishes the module.
+- **A rendered capacity or grant marker is not a name.** A longname may carry a module's
+  own capacity or a `(Free)` marker — `Anti-Korrosions-Frachtgestell (KAP.: 1)` — which
+  describes one module rather than naming the family, so it is rejected and the source's
+  other field is read instead.
+- **One record per canonical English name.** Where the source distinguishes in another
+  locale what English spells the same way, the reading most symbols share is stored:
+  `Lightweight Alloy` and `Reinforced Alloy` are singular on 25 hulls and plural on the
+  rest, and the singular is kept, which is also the number the English carries.
+  `Hatch Breaker Limpet Controller` is specific on twenty symbols and generic on one, and
+  the specific is kept.
+- **Coverage:** complete. All 1,194 symbols carry all six locales.
 - **Manual corrections:** none.
 
 ## `blueprint-names.jsonc`
@@ -84,10 +122,9 @@ tag follows the rule above, so `pt-PT` resolves to Brazilian Portuguese.
 - **Derivation:** each of the 86 current keys and its English name comes from
   `data/ships/experimental-effects.jsonc`, which stays authoritative for canonical
   English. The Frontier symbol joins to the in-game experimental-effect name table,
-  which supplies every locale for all 86. The table replaces the EDSY join this
-  catalogue previously used: where the two disagree the in-game value is kept, as
-  everywhere else in this repository. It supplies six values EDSY did not carry — all
-  five non-English `special_super_penetrator` names and the German
+  which supplies every locale for all 86. Where it and EDSY disagree, the in-game value
+  is kept, as everywhere else in this repository. It supplies six values EDSY does not
+  carry — all five non-English `special_super_penetrator` names and the German
   `special_weapon_rateoffire` — and changes two EDSY already carried: German
   `special_regeneration_sequence` is "Regenerationssequenz" (EDSY
   "Regenerierungssequenz") and Brazilian Portuguese `special_lock_breaker` is "Quebra da
@@ -239,38 +276,212 @@ tag follows the rule above, so `pt-PT` resolves to Brazilian Portuguese.
   the in-game shop listing; no registry publishes them. The Brazilian Portuguese column
   was acquired 2026-08-30 UTC and agrees byte-for-byte with the five columns already
   stored, which it does not change.
-- **Coverage:** English covers every variant. Ordinary names inherit the explicit
-  localized values available for their base module, which includes Brazilian Portuguese
-  on 51 of the 76 variants; the Merc-shop names carry all six locales. Only the three
-  `Decorative_*` fixed reward names have no accepted translation source, in any locale.
+- **A tech-broker unlock may carry an unlock marker**, and 19 of them do — see
+  `data/ships/SOURCES.md`. Those names are not their base module's, so they do not reuse
+  its record. Where the marker is a manufacturer (`Sirius`, `Azimuth`) or a version
+  (`V1`) it is not a translatable word, so the localized value is that marker composed
+  with the base module's own localized name: German `Suchraketenrampe V1`, Spanish
+  `Sirius Lanzamisiles AX`. Composition can only reach as far as the base module does,
+  which is why `Frame Shift Drive (SCO) V1` has Brazilian Portuguese and Russian only and
+  `Azimuth Enhanced AX Multi-Cannon` lacks Spanish and French: those are the base
+  modules' own gaps, not new ones.
+- **Six records carry a translation composed in this repository rather than taken from a
+  source, and are the only values in `data/i18n/` that are.** They are marked here
+  because the rest of this directory is explicit source values, and a reader is entitled
+  to know which is which. The game does not publish either phrase in a form this
+  repository can join to:
+  - The three `Modified` Guardian weapons. Unlike `Sirius`, `Azimuth` and `V1`, `Modified`
+    is a translatable word, so it cannot simply be composed with the base module's
+    localized name. Each locale's adjective agrees with the base noun it qualifies —
+    German `Modifizierter Guardian-Plasmalader` against `Modifizierte Guardian-Gausskanone`,
+    Russian `Модифицированная пушка Гаусса` against `Модифицированное осколочное орудие`.
+  - The three `Decorative_*` festive launchers. The game does not translate their names,
+    so `Festive` and the colour are rendered in each locale and qualify the base module's
+    own localized name.
+
+  Replace any of the twelve with a source-backed value the moment one is published.
+- **Coverage:** English, Brazilian Portuguese and Russian cover every variant. Ordinary
+  names inherit the explicit localized values available for their base
+  module; the Merc-shop names carry all six locales. The German, Spanish and French gaps
+  that remain are their base modules' own — the SCO drive and the Enhanced AX
+  Multi-Cannon carry no value in those locales for composition to build on.
 - **Manual corrections:** none.
 
+## `suit-names.jsonc`
+
+- **Acquired:** 2026-09-01 UTC.
+- **In-game localisation revision:** none published; the game ships no immutable
+  identifier for its localisation tables. The acquired table is the evidence.
+- **Derivation:** the four suit families and their canonical English names come from
+  `data/equipment/suits.jsonc`, which stays authoritative for canonical English. Each
+  family's grade symbols join case-insensitively to the in-game suit localisation
+  identity, which carries a `name`, a `longname` and an `info` string per locale. The
+  join is exact and total: all 16 grade symbols resolve.
+  - **`name` is the value taken.** It is the suit's own name and equals the canonical
+    English on all four families.
+  - **The manufacturer is not part of the name.** `longname` prefixes one —
+    `Remlok Maverick Suit`, `Supratech Artemis Suit`, `Manticore Dominator Suit` — which
+    names a Pioneer Supplies listing rather than the suit, so it is rejected the way a
+    rendered capacity is in `module-names.jsonc`. The brand is a proper noun the game
+    leaves in English in every locale, so composing it back on costs nothing but the
+    name it would displace.
+- **A suit is named per family, not per grade.** Every grade of a family carries
+  byte-identical values in all six locales, so one record is stored per family and
+  `nameKeys` maps the family id and every grade symbol onto it. Both forms a consumer
+  holds therefore resolve: `Suit.family` and the `utilitysuit_class3` a journal line
+  writes. The flight suit has a single grade whose symbol *is* the family id, so the four
+  families and 16 grade symbols make 19 distinct identifiers rather than 20.
+- **Coverage:** complete. All 19 identifiers carry all six locales.
+- **Two suits are not stored**, because `data/equipment/suits.jsonc` does not carry them:
+  the five `specialistsuit_class{1..5}` grades, which the source does name
+  (`Specialist Suit`, listed as `Remlok Paragon Specialist Suit`), and `hyperspacesuit`,
+  which carries no text at all. Storing a name for equipment no catalogue owns would
+  leave a lookup answering for something the library cannot otherwise describe.
+- **Manual corrections:** none.
+
+## `suit-descriptions.jsonc`
+
+- **Acquired:** 2026-09-01 UTC.
+- **In-game localisation revision:** none published; the game ships no immutable
+  identifier for its localisation tables. The acquired table is the evidence.
+- **Derivation:** the same four families and the same identifier set as
+  `suit-names.jsonc`, joined to the `info` string of the in-game suit localisation
+  identity. All six values, English included, are the source's verbatim: the owning
+  catalogue publishes no description for a suit, so there is no canonical English here
+  to be authoritative for.
+- **This is display prose, not the suit's stats.** `data/equipment/suits.jsonc` answers
+  what a suit does — shield strength, battery capacity, the four resistances — and the
+  description answers what it is for, naming no figure at all. Neither is projected onto
+  the other.
+- **Coverage:** complete. All 19 identifiers carry all six locales, and every grade of a
+  family shares its record exactly as in `suit-names.jsonc`.
+- **The Specialist Suit grades carry no description at all**, which is a second reason
+  they are absent here beyond the owning catalogue not carrying them.
+- **Manual corrections:** none. The English keeps the source's own mixed apostrophes
+  (`Manticore's`, `a user’s`); they are the game's prose and are stored as published.
+
+## `personal-weapon-descriptions.jsonc`
+
+- **Acquired:** 2026-09-01 UTC.
+- **In-game localisation revision:** none published; the game ships no immutable
+  identifier for its localisation tables. The acquired table is the evidence.
+- **Derivation:** all 11 current weapon symbols come from `data/equipment/weapons.jsonc`.
+  Each joins case-insensitively to the in-game weapon localisation identity and takes its
+  `info` string; the join is exact and total. All six values, English included, are the
+  source's verbatim, because the owning catalogue publishes no weapon description.
+- **No sibling name catalogue exists**, and that is a decision rather than a gap — see
+  §Names this repository deliberately does not localize.
+- **Coverage:** complete. All 11 weapons carry all six locales.
+- **Two entries the source carries are not stored:** `wpn_h_launcher_rocket_sauto`
+  (`Karma HL-9`), the heavy rocket launcher no current catalogue owns, and
+  `wpn_m_submachinegun_kinetic_burst`, which the table lists with no text at all.
+- **Manual corrections:** none.
+
+## `personal-modification-names.jsonc`
+
+- **Acquired:** 2026-09-01 UTC.
+- **In-game localisation revision:** none published; the game ships no immutable
+  identifier for its localisation tables. The acquired table is the evidence.
+- **Derivation:** all 31 recipe symbols and their canonical English names come from
+  `data/equipment/modifications.jsonc`, which stays authoritative for canonical English.
+  A symbol joins case-insensitively to the in-game modification identity as
+  `humanoidmod_<symbol>`, which carries a `name` and a `description` per locale.
+- **The nine technology-specific recipes share the entry the game publishes.** Greater
+  Range, Headshot Damage and Improved Hip Fire Accuracy are one engineering option each
+  in game; this repository keys the Kinetic, Laser and Plasma recipes separately because
+  their material costs differ (§`data/equipment/SOURCES.md`). The `_kinetic`, `_laser`
+  and `_plasma` suffix is dropped before the join, so each of the three takes its generic
+  entry's locales — exactly as a shadowing blueprint id takes its generic's in
+  `blueprint-names.jsonc`. 25 distinct source entries therefore cover all 31 recipes, and
+  the catalogue stores them once each: `nameKeys` maps a recipe symbol onto the entry the
+  game publishes, as `module-names.jsonc` maps a module symbol onto a shared name.
+- **That shape is about visibility, not bytes.** Storing each shared entry three times
+  instead costs about the same, because the six duplicate name records weigh roughly what
+  the 31-entry `nameKeys` map does; the descriptions save about a fifteenth. What the
+  deduplicated form buys is that the sharing is stated in the data, rather than sitting in
+  six duplicate records a later edit could silently pull apart.
+- **`Headshot Damage` is the one English value the game spells differently.** The in-game
+  menu reads `Headshot damage`; the owning catalogue's canonical `Headshot Damage` is
+  kept, as canonical English is kept everywhere in this directory. The lower-case
+  `Stowed reloading` the owning catalogue already carries *is* the game's own spelling
+  and agrees with it.
+- **Coverage:** complete. All 31 recipes carry all six locales.
+- **One in-game modification is not stored:** `humanoidmod_suit_headshotresistance`
+  (`Increased Helmet Protection`), which `data/equipment/modifications.jsonc` does not
+  carry as a recipe.
+- **Manual corrections:** two German names are the engineering panel's own layout rather
+  than translations. `Kampf-Bewegungs-geschwindigkeit` and `Geräusch-unterdrückung` break
+  a compound word mid-noun, leaving a lower-case second half no German spelling has. The
+  whole word is kept in each, as it is for the wrapped consumables in
+  `micro-resource-names.jsonc`: `Kampfbewegungsgeschwindigkeit` and
+  `Geräuschunterdrückung`.
+
+## `personal-modification-descriptions.jsonc`
+
+- **Acquired:** 2026-09-01 UTC.
+- **In-game localisation revision:** none published; the game ships no immutable
+  identifier for its localisation tables. The acquired table is the evidence.
+- **Derivation:** the same 31 recipe symbols as `personal-modification-names.jsonc`,
+  joined the same way and sharing the generic entry across the nine technology-specific
+  recipes for the same reason. Each takes the identity's `description` string. All six
+  values, English included, are the source's verbatim.
+- **This is display prose, not the recipe's magnitudes.** The game says a modification
+  "allows more ammo to be carried for each weapon" and never how much more; the
+  `modifiers` list in `data/equipment/modifications.jsonc` is what states the multiplier,
+  and the two are deliberately different strings. It is also the only account of the ten
+  recipes whose `modifiers` list is empty — some switch a capability on, the rest move a
+  stat the panel puts no number on (§`data/equipment/SOURCES.md`).
+- **Coverage:** complete. All 31 recipes carry all six locales.
+- **Manual corrections:** none. The French
+  `weapon_backpackreloading` description keeps the non-breaking space the source sets
+  between a figure and its unit (`5 secondes`), which is French typography rather than
+  layout.
+
 ## Names this repository deliberately does not localize
 
-Three catalogues were removed rather than completed, because the game does not translate
-what they held and storing English under five more keys said otherwise.
+No catalogues are stored for the following names, either because the game does not
+translate them — storing English under five more keys would say otherwise — or because no
+record in this repository is keyed by them.
 
 - **Ship names and manufacturers.** Odyssey Materials Helper and EDSY each publish a
   per-locale ship column, and every value either one publishes is byte-for-byte the
   canonical English name: a hull name is a proper noun the game leaves alone, and so is
-  a manufacturer's. No source publishes a localized manufacturer label at all. A lookup
-  that can only ever answer in English is not a translation lookup, so `getShipName` and
-  `getShipManufacturer` are gone; `data/ships/ships.jsonc` carries both strings and stays
-  the one place to read them.
+  a manufacturer's. No source publishes a localized manufacturer label at all.
+  `data/ships/ships.jsonc` is the one place to read both strings.
 - **Engineering-group labels.** An engineering group is this repository's own partition
   of the modules that share one menu; the game heads that menu with the module's
-  outfitting family and publishes no group label of its own. The EDSY `mtype-*` values
-  previously stored here were outfitting labels reached by a name join, which is why they
-  disagreed with `module-family-names.jsonc` in 22 places on wording. A group therefore
+  outfitting family and publishes no group label of its own. EDSY's `mtype-*` values are
+  outfitting labels reached by a name join and disagree with
+  `module-family-names.jsonc` in 22 places on wording. A group therefore
   carries no name at all — see the header of `data/ships/engineering-options.jsonc` — and
   a consumer names one by joining a module's `familyId` to `module-family-names.jsonc`.
+- **Handheld personal-weapon names.** The in-game weapon localisation table publishes all
+  six locales for every one of the eleven weapons, and each of the 55 non-English values
+  is byte-for-byte the English: `Karma P-15`, `TK Aphelion` and `Manticore Executioner`
+  are product names the game leaves alone, exactly as it does a hull's. `PersonalWeapon`
+  in `data/equipment/weapons.jsonc` is the one place to read the name; the weapons'
+  *descriptions* are prose and are localized, in `personal-weapon-descriptions.jsonc`.
+- **Personal-equipment manufacturers.** `Supratech`, `Remlok`, `Manticore` and
+  `Kinematic Armaments` are byte-for-byte identical in all six locales wherever the game
+  names them, which is why `suit-names.jsonc` stores a suit's own name and not the
+  outfitting list's manufacturer-prefixed listing.
+- **Suit and weapon stat labels, the on-foot loadout panel's row labels, and engineer
+  dialogue.** These are the second reason rather than the first: the game does publish all
+  six locales for each, and none of them names a record in any catalogue here. A stat
+  label names a field of `Suit` or `PersonalWeapon`, a row label names a line of the
+  on-foot loadout panel, and an engineer's line is spoken flavour attached to an offer.
+  Storing them would mean inventing keys this repository does not otherwise own, so a
+  consumer that needs a field label supplies its own. **This is not the ship slot and
+  restriction gap of [#320](https://github.com/DarkSession/Elite-Dangerous-Almanac/issues/320)**,
+  which is about labels no source translates at all.
 
 ## Known gaps
 
 Localized coverage follows the accepted sources and is not complete for every catalogue or
-stored locale. A language absent from all eight catalogues is the locale decision
+stored locale. A language absent from all thirteen catalogues is the locale decision
 recorded above rather than a gap. The accepted sources carry only canonical English for
 19 of the 77 outfitting-family labels, slot and restriction labels, fixed reward names,
-and structured loadout, calculation, SLEF and edit messages. Missing source-backed
-translations remain tracked by
+and structured loadout, calculation, SLEF and edit messages. Personal equipment carries
+no gap: every suit, handheld weapon and modification the owning catalogues hold is
+complete in all six locales. Missing source-backed translations remain tracked by
 [#320](https://github.com/DarkSession/Elite-Dangerous-Almanac/issues/320).