§7 — open doc edits ✓ landed 2026-07-05
Evergreen: catalog-naming-followups §7
(followup f-cnf-004). Done-when: all open doc edits applied & re-accepted; no LaTeX in any accepted
description.
Generate-level root-cause fix (the heart of §7)
The predecessor claimed "all 9 LaTeX descriptions now plain text" — false; they had regressed on catalog
re-import. A live-graph trace found the causal chain: the Greek-symbol normalizer's
_GREEK_WORD_RE = \b(phi|theta|rho)\b matched phi inside \phi (the
\b sits between the backslash and p), rewriting it to \φ and leaving the
$ delimiters; nothing stripped $, and no gate rejected LaTeX in the short
description field, so it re-entered on every sn import (which stored descriptions verbatim).
imas-codex 27f4c037 (26 new + 355 regression tests green) fixes it at the generator so
NEW names can never carry LaTeX descriptions:
normalize_description_notationnow converts\phi/\theta/\rho/\pi(and the stranded\φcorruption) to Unicode, strips$…$/$$…$$keeping inner content, flattens\mathbf{}and braced sub/superscripts. Idempotent; DD tokens (phi_tor) and thedocumentationfield (legitimate LaTeX) untouched.- Import normalizes descriptions at both boundaries (
catalog_import.py), so a stale YAML can't regress onsn import. - New critical
description_notation_checkquarantines any$/backslash in a description — a LaTeX description can never reachaccepted.
Applied to the live graph
| Item | Outcome |
|---|---|
| 9 LaTeX-in-description outliers | Normalized in-graph via the fixed normalizer (deterministic, wording preserved: $(R,\φ,Z)$→(R, φ, Z), $2\pi$→2π, W$^{1+}$→W1+, $|\mathbf{k}|$→|k|). description_notation_check = 0 over the full accepted corpus. |
E− 1/√2 formula | Real physics error found: right_hand_circularly_polarized_wave_electric_field documented E_- = E_x - i E_y with no normalization while its sibling E+ correctly carries /√2. Corrected to E_- = \frac{E_x - i E_y}{\sqrt{2}} via sn edit --docs --scope self; finalized accepted/applied (documentation LaTeX is legitimate). |
| 13 open edits cleared | The 9 descriptions + 2 doc-math (toroidal_flux_radius_at_plasma_boundary, vertical_current_density_due_to_ion_inertia — verified clean) + 2 moot superseded (normalized_internal_inductance, normalized_momentum_flux_…) marked edit_status=applied. |
x_image_up_unit_vector_of_camera | Reassigned to §4 (its orientation-vector family completion — it is name_stage=pending, mid-family, not an accepted doc to edit). |
Remaining → folded into §4
The 3 drafted axis re-locks (z_coordinate_of_{divertor_target,ferritic_element_centroid,sensor_attachment_point},
edit_status=open) promote the Cartesian z third axis and supersede the stranded
vertical_ counterpart. They are device-local Cartesian family completions — the same class as §4's
orientation-vector work — and are tracked there (they also clear the 2 residual
vector_family_consistency_check flags on sensor_attachment_point).