pairing-core 0.4.1__tar.gz

pairing_core-0.4.1/CHANGELOG.md

@@ -0,0 +1,181 @@
+# Changelog
+
+All notable changes to this project are recorded here. Versioning follows
+the five-axis model in `docs/spec/VERSIONING.md`; the library version below
+is the `pyproject.toml` version. Dates are commit dates (UTC).
+
+## [Unreleased]
+
+- New `examples/custom_provider.py`: worked third-party provider guide
+  (implement `EngineProvider`, declare `Capability`, register, select via
+  `pair_via`); runs from repo checkout and clean install; pinned by
+  `tests/test_release.py::test_examples_run_on_public_api`.
+- `tests/test_release.py` now also requires `examples/custom_provider.py`.
+
+## [0.4.1] — 2026-10-03 (release candidate: committed on main, not yet tagged or published)
+
+Product-hardening wave (patch: no public API or pairing-behavior change —
+v0.1.0 goldens and 0.4.0 outputs byte-identical):
+
+- Packaging: SPDX `license = "MIT"` (fixes setuptools>=77 deprecation
+  warning; build requires 68→77), PyPI classifiers/keywords, `MANIFEST.in`
+  pruning caches/build outputs from the sdist; verified warning-free build,
+  reproducible artifact file list, clean-environment wheel install + smoke.
+- Test hygiene: benchmark baseline refresh is now opt-in
+  (`PAIRING_UPDATE_BASELINES=1`) so plain suite runs leave the tree clean;
+  `test_canonical.py` / `test_import_api.py` no longer assume an absolute
+  checkout path (location-independent, 3.10-compatible); new
+  `tests/test_release.py` pins product files, README topics +
+  no-certification-claims, changelog coverage, and the no-absolute-paths
+  rule; new `examples/basic_swiss.py` (verified against repo checkout and
+  installed wheel).
+- Documentation reconciliation: `docs/CAPABILITY.md` rewritten as the
+  current (v0.4.1) product authority (2026 systems implemented, not
+  blocked); `README.md` rewritten as a product entry point; historical
+  Stage-1 snapshots (`docs/audit/CURRENT_CAPABILITIES.md`,
+  `CURRENT_LIMITATIONS.md`) and research-phase detail in
+  `docs/rules/fide/CURRENT_STATUS.md` marked superseded-but-preserved;
+  `MASTER_SPECIFICATION.md` §§4/10/11, `ROADMAP.md` statuses, and
+  `OPEN_QUESTIONS.md` updated to post-closure reality.
+- OSS hygiene: `CONTRIBUTING.md`, `SECURITY.md`, `CODE_OF_CONDUCT.md`,
+  issue templates, PR template, CI gate (`.github/workflows/ci.yml`),
+  `docs/RELEASING.md`, `docs/PERFORMANCE.md` (measured baseline + L1
+  ceiling characterization).
+- Verified unchanged (no code change): external-adapter security posture
+  (argv-only, timeouts, caps, cleanup), execution controls (typed
+  timeout/cancel, no partials), determinism (hash-seed sweeps),
+  `versions()` report semantics (adapter edge stays a submodule surface
+  per `API_TIERS.md`).
+
+## [0.4.0] — 2026-10-03
+
+Closure wave (minor: additive API + conformance corrections; ruleset
+identities unchanged — same FIDE effective dates; no deprecations/breaks):
+
+- New optional `P26Request.cancel_token` (cooperative cancellation, typed
+  `CancelledError`, never partial; entry-point + per-tick checkpoints).
+- Dutch PAB unified with generation order + 3.8.1 (invented enumeration and
+  largest-TPN tiebreak removed); fixed C12/C13 white-holder accounting.
+- Olympiad rewritten from retrieved Handbook chapter text (4.1 bye rank,
+  3.1 seeding helper, 7.2 R1 lot, 8.x designated/completion/skip/re-float
+  chains, 9.4 played-all floaters, subgroup-relative 9.3 search, 11.1
+  rating-key publication order).
+- Lim refinements (3.3/3.4 exclusion claims, mandatory 3.8 target,
+  sequential-scrutiny 4.4 culprit, round-parity 5.5/5.6 + 5.4 even clause).
+- Forfeit/match caller contracts formalized (`RESULT_CONTRACTS.md`);
+  exact-search ceiling policy (`SEARCH_CEILING_POLICY.md`).
+- 14 more discriminating regression tests (all old/new divergent cases
+  pinned). Full suite green; legacy byte-identical.
+
+## [0.3.1] — 2026-10-03
+
+Hostile FIDE conformance audit of the 0.3.0 2026 engines (authoritative
+reference: Council bundle CM3-202517 FULL_TEXT + Annotated Dutch V2026).
+No public API change; frozen v0.1.0/v0.2.0 behavior byte-identical:
+
+- 20 conformance defects fixed across Dutch (BSN order, MDP-set order,
+  M1/MDP ordering), Dubov (G1 extremes, 3.2.4.1 shift, real-pairing C7),
+  Burstein (C6 sign, C7 scope, incoming loop, enumeration), Double/Team
+  (C5 construction, TPN identifier space, Team 4.3.7 + secondary),
+  Olympiad (floater routing), Lim (scrutiny, columns, even-making, 2.6,
+  3.x, 4.4, 5.4, Art.6), and all colour walkbacks (round-aligned).
+- Budgets made effective (ticks + count guards + every-tick wall checks;
+  deferred Dutch alterations; exact lex-first fast paths); 2026 performance
+  gates measured (R1 + realistic sizes succeed; factorial ceilings terminate
+  typed — no heuristic pruning).
+- 30-test adversarial corpus, 2026 randomized property suite (7 rulesets),
+  2026 benchmark record; version-scoped differential oracles pass
+  (BBP 2025-era vs legacy; no meaningless cross-version comparisons).
+- Rule-level conformance matrix (`docs/audit/FIDE_CONFORMANCE_MATRIX.md`)
+  with explicit interpretation register; final report
+  (`docs/audit/FIDE_CONFORMANCE_FINAL_REPORT.md`). No FIDE endorsement
+  claimed; full conformance claimed nowhere interpretations remain.
+
+## [0.3.0] — 2026-10-03
+
+New additive `pairing_core.fide2026` namespace (no v0.1.0/v0.2.0 behavior
+change — frozen kernel, KNOWN_RULESETS, KNOWN_SYSTEMS, resolve_ruleset all
+untouched and pinned):
+
+- Seven new rulesets from FULL_TEXT Council-bundle evidence (CM3-202517):
+  `dutch-2026` (C1–C21 search), `dubov-2026` (ARO/MaxT/G1–G2), `burstein-2026`
+  (Index/BSN enumeration), `lim-2026` (median routing), `double-2026`,
+  `team-2026` (lexicographic machinery), `olympiad-2022` (median + 9.x),
+  plus the `baku` accelerated modifier and C.04.2 board-order sorting.
+- Entry point `pair_2026()` with exact-match `P26RulesetId` resolution (no
+  fallback); typed errors; budget/cancel/step discipline throughout.
+- Evidence package (`docs/rules/fide/evidence/`), extracted rules
+  (`docs/rules/fide/extracted/`), official corpus
+  (`tests/corpus/fide_official/`, provenance-labelled), rule→source→code→test
+  traceability (`RULE_SOURCE_MATRIX.md`), upgraded source validator (wired
+  into the suite).
+- Conformance: Berger FULLY_IMPLEMENTED_AND_EVIDENCED (unchanged); six 2026
+  systems + Olympiad IMPLEMENTED_WITH_EXPLICIT_EVIDENCE_GAPS (documented
+  readings listed in the matrix; no silent guessing); KO/match
+  OUT_OF_SCOPE_WITH_REASON. No FIDE endorsement claimed.
+- v0.1.0/v0.2.0 compatibility: 41/41 goldens + full legacy suite green,
+  kernel outputs byte-identical.
+
+## [0.2.0] — 2026-10-03
+
+Additive canonical consumer contract (no v0.1.0 behavior change):
+
+- `CanonicalPlayer` / `CanonicalRequest` / `pair_canonical()` — stable,
+  implementation-independent pairing contract (system + mandatory ruleset +
+  schema version + provider hint + deterministic flag), with legacy
+  converters, canonical JSON serialization, and module-isolation tests.
+- Migration guide `v0.1.0 → canonical`
+  (`docs/MIGRATION_V010_TO_CANONICAL.md`); O08 two-minor support window
+  restated, nothing deprecated yet.
+- Determinism contract (`docs/spec/DETERMINISM_CONTRACT.md`), API tiers
+  (`docs/spec/API_TIERS.md`), canonical contract spec, forensic baseline.
+- Import-boundary tests (`__all__` allow-list, version consistency).
+- Version-reporting tests now track the package version instead of pinning
+  `0.1.0` (historical goldens/records unchanged).
+- v0.1.0 compatibility: 41/41 goldens + 15/15 contract tests green,
+  kernel outputs byte-identical.
+
+## [Archived] post-0.1.0 development record (main branch, pre-0.2.0 wave)
+
+> HISTORICAL: preserved unmodified below. These foundation items shipped
+> across 0.2.0–0.4.0 (see entries above); this section is no longer the
+> live "Unreleased" list.
+
+### Added (all additive; v0.1.0 behavior preserved)
+
+- Typed error taxonomy (`PairingError` family, `ValueError`-compatible).
+- Dated rulesets (`RulesetId`, `ConstraintSet`, `dutch-till2026-compat`).
+- Strict validation boundary + validated compat wrapper (`EngineRequest`,
+  `pair`, `validate_request`, `versions()`).
+- Reproducibility envelope (`Pairing`, `RoundPairing`, digests, budgets).
+- Engine provider abstraction + native provider + explicit registry
+  (`pair_via`; no silent fallback by construction).
+- Execution budgets (step primary, wall-clock secondary) + cancellation.
+- Forbidden-pair enforcement (rematch-equivalent) + `FORBID-01` check.
+- C9 bye ordering (fewer unplayed games first; BBP-verified).
+- Berger round-robin schedules incl. double cycle.
+- Structured explanations (`explain`) + request serialization.
+- TRF interchange subset (fixed-width, BBP-verified) + BBP/JaVaFo adapters
+  (bring-your-own binaries, stub-tested failure paths).
+- Differential/conformance harness (11-class taxonomy, 23-case corpus).
+- Env-gated live oracle suites (BBP_EXE, JAVAFO_JAR).
+- Seeded property tests, hash-seed sweeps, benchmark suite + baselines.
+- `LICENSE` (MIT, per O06), capability maturity model (`docs/CAPABILITY.md`).
+
+### Fixed (measured, behavior-preserving except where noted)
+
+- Lazy exchange enumeration (unbounded memory growth on huge brackets).
+- Step-counted legality-matrix work (pathological single-80: >400s hang →
+  ~8.5s typed timeout). Small-case outputs byte-identical (goldens green).
+
+### Known deviations under investigation (frozen per O08)
+
+- E.5 round-1 parity colours (live BBP + JaVaFo agreement vs S1-white).
+- Absolute 3rd-float bar (live oracle divergence; BBP minimizes only).
+- See `docs/research/DUTCH_CONFORMANCE_STATUS.md`.
+
+## [0.1.0] — 2026-09-30
+
+- Initial extraction: standalone FIDE Dutch Swiss engine from
+  `20kevit/chess-manager` (`domain/pairing/`), behavior-preserving.
+- 15 contract tests; zero runtime dependencies.

pairing_core-0.4.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 20kevit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pairing_core-0.4.1/MANIFEST.in

@@ -0,0 +1,8 @@
+# Keep regenerable build artifacts out of the sdist.
+global-exclude *.pyc *.pyo __pycache__/* .pytest_cache/*
+prune src/*.egg-info
+prune **/*.egg-info
+prune dist
+prune build
+# Release record ships in the sdist (README/LICENSE come via metadata).
+include CHANGELOG.md