v1.1.0

[1.1.0] — 2026-05-09

v1.1 is a SemVer-minor addition over v1.0; the v1.0 public surface
is unchanged. See docs/migration-1.0-to-1.1.md
for usage examples of each new method.

Added

• ReadQuery.where(Predicate<? super TableEntry>) (commit
  6277b18) — client-side filtering on the read result. Each call
  appends a predicate; entries that fail any predicate are excluded
  from the terminal call (.all() / .one() / .stream() and async
  variants). The method is a default on the ReadQuery interface
  that throws UnsupportedOperationException, naming 1.1.0 and
  directing the caller to update; the built-in implementation
  returned by P4Switch.read(...) overrides it. SemVer-safe for any
  external implementer of ReadQuery.
• Connector.preserveRoleOnReconnect(boolean) (commit
  53e4e8e) — opts a .asPrimary() connector into fail-fast on
  reconnect role downgrade. When enabled and a reconnect yields a
  non-Primary role (because another client arbitrated higher during
  the disconnect window), the switch closes itself and stores the
  resulting P4ArbitrationLost as the close cause; subsequent user
  calls throw that cause via the existing writability and readability
  gates instead of the generic "switch is closed". Default false
  preserves the v1.0 silent-Secondary behaviour.
• Mac.ZERO (commit d1bf319) — public static final Mac
  constant for the all-zero MAC address (00:00:00:00:00:00),
  useful as a sentinel for invalid or default-initialised source
  addresses.

Documentation

• AI-tool and bot attribution rules in CONTRIBUTING.md
  (commit 3fb8354) — the commit-message section now enumerates the
  rejected forms (AI-naming Co-Authored-By: trailers, footer
  banners citing automated assistance, bot emails matching
  noreply@*, robot or AI-tool emoji), and preserves the existing
  carve-out for Co-Authored-By: lines naming real human
  collaborators.
• Post-1.0 source-reference cleanup (commit fc70d0d) — the
  build version was bumped from 1.0.0 to 1.1.0-SNAPSHOT,
  opening the v1.1 development cycle, and 17 production / docs /
  example references to v0.1 and v0.2 were updated to reflect
  post-1.0 reality (descriptive comments naming v0.1 ship-set
  updated to v1.0; forward-looking v0.2 will... notes updated to
  v1.x will...).