Skip to content
Pauta4.0.2

Code quality gates

  • QUAL-01 MUST NullAway is an error, not a warning. A new package starts with its own package-info.java carrying @NullMarked.
    • Check (code): the compiler arguments say -Xep:NullAway:ERROR; every source package has a package-info.java with @NullMarked.
    • Reference: Editora pom.xml, docs/conventions.md (Null annotations).
  • QUAL-02 SHOULD A NullAway report is fixed, not suppressed: put @Nullable on what may be null.
    • Check (code): grep -rn '@SuppressWarnings("NullAway")' src/main finds nothing.
    • Reference: Editora; one suppression is left, in recovery/RecoveryCodec.java.
  • QUAL-03 SHOULD Coverage floors are a regression net, not a target. Beyond the build-wide floor of 0.90 lines and methods, each package of 300+ lines gets its own floor about three points below its measured level; when a package’s coverage rises, its floor is ratcheted up.
    • Check (code): the jacoco-check rules in pom.xml carry a PACKAGE line floor for each large package.
    • Reference: Editora pom.xml jacoco-check.
  • QUAL-04 SHOULD When a guide quotes the coverage floors, a test fails when the quoted table and the pom disagree.
  • QUAL-05 MUST Extract the decision, then test it (principle 12). Prefer a pure decision helper plus unit tests; use the headless FX harness only when controller or toolkit behavior is the point.
  • QUAL-06 MUST FX tests are tagged @Tag("fx"), so the pure suite runs alone with -DexcludedGroups=fx.
    • Check (code): every test class that boots the toolkit (FxTestSupport, FxToolkit) carries @Tag("fx").
    • Reference: Editora docs/testing.md. Editora does not hold it fully yet: about twenty *FxTest classes, most of them ProjectMap*FxTest, carry no tag.
  • QUAL-07 SHOULD Tests do not sleep. Workers and FX callbacks are owned by a scope (AsyncTestScope), and tests wait on latches.
    • Check (code): grep -rn 'Thread.sleep' src/test finds nothing.
    • Reference: Editora AsyncTestScope, docs/testing.md. Many older Editora tests still poll with Thread.sleep.
  • QUAL-08 SHOULD A test window writes only inside its temp folders, never in the real home directory.
  • QUAL-09 MUST UI work is verified in the running app (principle 13): a capture hook or headless screenshot of the real window, with real key and mouse events, before a UI change is called done.
    • Check (code): the app has a capture hook (DevCapture) or a headless fixture that builds the real window.
    • Reference: Editora FxWindowFixture (the real MainController window, headless); Torrenta and Termina DevCapture.java.
  • QUAL-10 SHOULD A guard that cannot fail is decoration. When you add a drift or parity test, break the thing it guards once and watch it fail.
    • Check (by hand): break what the new test guards, run it, and see it fail.
    • Reference: Modula’s DependenciesTest.

Guard tests that pay for themselves across the family:

  • QUAL-11 SHOULD A command sweep runs every registered command in a real headless window.
    • Check (test): one FX test iterates the registry and runs each command.
    • Reference: Editora CommandSweepFxTest.
  • QUAL-12 MUST A message parity test holds that every locale has every key and every command.<id> has a .desc.
    • Check (test): the test fails on a key missing from a locale or a command title without .desc.
    • Reference: Editora MessagesTest.
  • QUAL-13 SHOULD A settings round trip shows that every switch, number and choice survives a restart.
    • Check (test): one FX test sets every control, reloads the settings and reads each back.
    • Reference: Editora SettingsRoundTripFxTest.
  • QUAL-14 SHOULD A contrast test holds that text tokens keep their ratios in every theme.
    • Check (test): a pure test reads the stylesheets and does the WCAG arithmetic.
    • Reference: Editora StyleContrastTest.
  • QUAL-15 SHOULD A release supply-chain test keeps the signing and attestation steps where they are.
    • Check (test): a test reads the workflows and fails when a signing, notarization or attestation step moves or goes.
    • Reference: Editora ReleaseSupplyChainTest.

Pauta 4.0.2 · · Changelog · This page in the latest edition