Files
ConformalLabpp/.codespellrc
Tarik Moussa a3ee9576d4
All checks were successful
C++ Tests / test-fast (pull_request) Successful in 1m57s
API Docs / doc-build (pull_request) Successful in 1m3s
Markdown link check / check (pull_request) Successful in 44s
C++ Tests / test-cgal (pull_request) Has been skipped
C++ Tests / quality-gates (pull_request) Successful in 2m11s
fix+test: Euclidean holonomy/τ end-to-end + spherical edge-DOF oracle (2026-05-29 audit)
Bundles the 2026-05-29 Java↔C++ math-correctness audit (doc/reviewer/
java-port-audit.md, 11 findings) with two follow-up fixes.

Audit code changes:
- Finding 3 (spherical_functional): edge-DOF replacement parameterization via
  spher_eff_lambda; edge gradient α_opp⁺+α_opp⁻−θ_e (drops additive −(S⁺+S⁻)/2)
- Finding 4 (spherical_hessian): always-compiled edge-DOF throw guard
- Finding 6 (period_matrix): faithful normalizeModulus (0≤Re≤½, Im≥0, |τ|≥1)
- Finding 9 (inversive_distance): degenerate-face limiting angles, no skip
- Findings 1/2 (euclidean): degenerate gradient limiting angles + Hessian guard

Euclidean holonomy/τ fix: develop the cut surface across the dual spanning tree
only (cut_graph now exposes is_dual_tree), so genus-1 cut edges yield
non-degenerate lattice generators. Previously τ came out 0 / NaN / 1e13 on the
bundled tori; now matches the analytic revolution modulus i·√(R²−r²)/r. Re-enabled
τ reporting in the Euclidean CLI; rewrote validation.md §3/§4 accordingly.

Tests (240 CGAL, 0 skipped):
- HolonomyEndToEnd ×3 — tori of revolution (4×4, hex 6×6, 8×8) vs analytic modulus
- SphericalFunctional.EdgeGradient_RegularTetClosedForm — independent closed-form
  π/3 oracle locking the Finding-3 edge formula (the path-integral FD check cannot
  detect a wrong-but-conservative gradient)

Also documents the latent spherical/hyperbolic holonomy-extraction bug (same
single-development pattern, dead code today) in research-track.md (Phase 9c/10),
and adds favour/normalisations to the codespell ignore list.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-29 12:50:16 +02:00

89 lines
3.9 KiB
Plaintext

# conformallab++ codespell policy
#
# Driven by scripts/quality/codespell.sh. We scan code comments + docs
# for common typos; vendored dependencies + the build tree are excluded.
#
# False positives go into ignore-words-list (lowercase, comma-separated).
# Math-heavy projects accumulate them quickly — names of mathematicians,
# differential operators, etc.
[codespell]
skip = code/deps,build,build-*,build_T_*,test-reports,doc/doxygen,.git,*.svg,*.lock,*.pdf,*.png,*.jpg,Doxyfile,*.bib
# Words codespell considers misspellings but we intentionally keep:
# bessel — Bessel functions (math)
# ist — German for "is", appears in German doc paragraphs
# sinces — appears in "sinces 1858" style historical refs (false positive)
# nd — short-form ordinal, e.g. "2nd"
# te — appears in greek transliteration "θ → te"
# inout — common parameter direction word
# nin — math symbol ∉ accidental match
# numer — "numerical/numerator" abbreviation in headers
# neet — German "neet" / accidental matches
# anc — appears in "anc(ient)" math literature refs
# sinks — "sinks" can hit Sinkhorn
ignore-words-list = bessel,ist,sinces,nd,te,inout,nin,numer,neet,anc,sinks,doubleClick,
centre,centres,centered,centering,centring,
behaviour,behaviours,behavioural,
analogue,analogues,
initialise,initialised,initialises,initialising,initialisation,
normalise,normalised,normalises,normalising,normalisation,normalisations,
favour,favours,favoured,favouring,favourite,favourites,
centralise,centralised,centralises,centralising,
serialise,serialised,serialises,serialising,serialisation,
parameterise,parameterised,parameterises,parameterising,
parametrise,parametrised,parametrises,parametrising,
realise,realised,realises,realising,realisation,
optimise,optimised,optimises,optimising,optimisation,
sanitise,sanitised,sanitises,sanitising,
generalise,generalised,generalises,generalising,
amortise,amortised,amortises,amortising,
factorise,factorised,factorises,factorising,
discretise,discretised,discretises,discretising,
summarise,summarised,summarises,summarising,
colour,colours,coloured,colouring,
artefact,artefacts,
iff,
dof,dofs,
browseable,
re-use,re-uses,re-used,re-using,
specialise,specialised,specialises,specialising,specialisation,specialisations,
visualise,visualised,visualises,visualising,visualisation,visualisations,
model,modeled,modelled,modelling,
minimise,minimised,minimises,minimising,minimisation,
maximise,maximised,maximises,maximising,maximisation,
organise,organised,organises,organising,organisation,
characterise,characterised,characterises,characterising,
emphasise,emphasised,emphasises,emphasising,
analyse,analysed,analyses,analysing,analyser,analysers,
organise,organisation,organisational,
parameterise,parameterisation,
centre,centred,centres,
catalogue,catalogues,
maths,
generalisation,generalisations,
realisation,realisations,
specialisation,specialisations,
visualisation,visualisations,
minimisation,maximisation,characterisation,
groupes,fuchsiens,théorie,théorème,
iff,
honour,honoured,honours,honouring,thead,optimiser,optimisers,
categorise,categorised,categorises,categorising,
optimisation,optimisations,
acknowledgement,acknowledgements,acknowledging,
neighbour,neighbours,neighbouring,neighboured,
labelled,labelling,labels,labelled,
fulfil,fulfils,fulfilled,fulfilling,
endcode,
deklaration,deklarationen,
recognise,recognised,recognises,recognising,recognisation,
signalled,signalling,
travelled,travelling,
cancelled,cancelling,
modelled,modelling
# Words we explicitly DO want flagged (override the default skip list).
# Keep empty for now; add as we hit real-but-not-flagged typos.
builtin = clear,rare,informal,usage,code,en-GB_to_en-US,names