From d9219ca07e69ca08c6cc7ec9dc805955fe87d857 Mon Sep 17 00:00:00 2001 From: Nick Petalas Date: Wed, 11 Nov 2026 13:26:56 +0000 Subject: [PATCH 1/2] feat(research): attain exact unit Stein coefficient bounds --- research/exact-unit-stein-splitting/PROOF.md | 131 +++++++++++ research/exact-unit-stein-splitting/README.md | 86 ++++++++ .../exact-unit-stein-splitting/SOURCES.json | 45 ++++ research/exact-unit-stein-splitting/TASK.json | 96 ++++++++ .../exact-unit-stein-splitting/VERIFY.json | 34 +++ .../exact-unit-stein-splitting/algebra.py | 158 +++++++++++++ research/exact-unit-stein-splitting/verify.py | 207 ++++++++++++++++++ 7 files changed, 757 insertions(+) create mode 100644 research/exact-unit-stein-splitting/PROOF.md create mode 100644 research/exact-unit-stein-splitting/README.md create mode 100644 research/exact-unit-stein-splitting/SOURCES.json create mode 100644 research/exact-unit-stein-splitting/TASK.json create mode 100644 research/exact-unit-stein-splitting/VERIFY.json create mode 100644 research/exact-unit-stein-splitting/algebra.py create mode 100644 research/exact-unit-stein-splitting/verify.py diff --git a/research/exact-unit-stein-splitting/PROOF.md b/research/exact-unit-stein-splitting/PROOF.md new file mode 100644 index 0000000000..9eaba89aec --- /dev/null +++ b/research/exact-unit-stein-splitting/PROOF.md @@ -0,0 +1,131 @@ +# Exact unit bounds by splitting orthogonal residuals + +This contribution was produced by Nick Petalas. It is a scoped written +proof over Q(i), with a bounded exact implementation and finite +corroboration. It is not a complete multiplication theorem. + +## Statement + +For every E in Q(i)^(m by n), of rank r, there are s<=2r columns g_j in +Q(i)^m and rows a_j in Q(i)^n such that + + E = sum_j g_j a_j, + ||g_j||_2 <= 1, + ||a_j||_2 <= ||E||_2. + +In fact, with G having columns g_j and A having rows a_j, + + GG* = P_col(E), A = G*E. + +Zero E has s=0. All nonzero emitted terms are retained. The bound 2r is +an upper bound, not an asserted global minimum. The coefficient row uses +an adjoint exactly once, in G*E. The standard coordinate factorization +uses m terms with the same unit bounds. The present bound depends on r +and is useful for low-rank displacements in a larger ambient space. + +## Construction and proof + +Use the exact nonzero orthogonal residuals v_1,...,v_r of E's columns, +as in Jose Manuel / jmbarrancoml's [PR4198](https://github.com/CrocSwap/integer-mult-bounds/pull/4198), +`research/rational-stein-generators/PROOF.md`, section 1. Write +n_k=v_k*v_k>0. The inherited projection identity is + + sum_k v_k v_k* / n_k = P_col(E). + +For each k, choose z_k1,z_k2 in Q(i) with + + |z_k1|^2 + |z_k2|^2 = n_k. + +Such a choice always exists. For example, clear a common positive integer +denominator D from v_k, and write v_k=w/D with Gaussian-integer w. +The positive integer N=w*w is a sum of four integer squares a^2+b^2+c^2+d^2 +by Lagrange's theorem. Then z_k1=(a+bi)/D and z_k2=(c+di)/D work. +The classical theorem is not a new claim here; a primary formal source +is [Mathlib's SumFourSquares module](https://leanprover-community.github.io/mathlib4_docs/Mathlib/NumberTheory/SumFourSquares.html). +No Lean replay of this package is claimed. + +Define, omitting each zero z, + + g_kl = v_k z_kl / n_k, a_kl = g_kl* E. + +There are at most two terms per residual, and + + sum_l g_kl g_kl* + = v_k v_k* (sum_l |z_kl|^2) / n_k^2 + = v_k v_k* / n_k. + +Thus GG*=P_col(E), and GA=GG*E=E. Also + + ||g_kl||_2^2 = |z_kl|^2/n_k <= 1, + ||a_kl||_2 = ||g_kl* E||_2 <= ||g_kl||_2 ||E||_2 <= ||E||_2. + +This proves the stated arbitrary-dimensional rational construction. +It also proves the stronger positive-semidefinite inequality + + E*E - a_kl* a_kl = E*(I-g_kl g_kl*)E >= 0. + +If N is a sum of two integer squares, the implementation uses one term +for that residual. Its finite search finds such a representation whenever +one exists within the complete range 0..floor(sqrt(N)). Otherwise the +four-square representation gives two nonzero terms. No optimality of the +aggregate count is inferred from this per-residual choice. + +## Stein and dirty-state interface + +For a square E=T-ZTZ*, with Z the nilpotent lower shift, finite telescoping +gives the credited identity + + T = sum_(h=0)^(m-1) Z^h E (Z*)^h + = sum_j L(g_j) U(a_j). + +The second equality is the coefficient-row convention of PR4198. Each +new term can be passed to its existing compensated dirty-source macro, +with that macro's own legal near-identity normalizer and all four calls +paid. Summing complete macros restores the arbitrary source bank and adds +Tx to the arbitrary target bank. This is a logical exact interface only. +We have not run those child macros or implemented physical coefficient +pages in this package. + +PR4198 uses r terms with row norms below 2||E||. Nick Petalas's +[PR6228](https://github.com/CrocSwap/integer-mult-bounds/pull/6228) +already gives r terms below (1+2^-p)||E|| and an exact-factor-one +obstruction in the rank-minimal class. Those results are credited +background, not replay targets. The new step here changes the term-count +contract and attains the exact factor one. + +## Encoding and implementation scope + +For a residual with rational components of height H, one common +denominator D uses at most 2mH bits. The Gaussian-integer coordinates of w +then use at most (2m+1)H+1 bits. Each four-square coordinate has magnitude +at most sqrt(N), so its bit length is bounded by half the bit length of N, +rounded upward. Forming g and a uses rational products and finite sums. +The construction therefore has finite rational output of polynomial +encoding length, using the inherited rational residual height bound. +This statement does not assert polynomial bit running time for our +exhaustive four-square enumerator. + +The implementation first removes the common integer gcd of w. This only +changes D's rational scale and leaves N smaller. It accepts at most eight +rows and eight columns, input component height at most 256, and primitive +N<=65,536 at every residual. Capacity exhaustion rejects explicitly. +The theorem has no such finite limits; the implementation and its finite +checks do. + +Every square loop is bounded by floor(sqrt(N))+1, its pair table has +N+1 entries, and its split loop has N+1 iterations. Matrix operations +have at most sixteen term columns and eight data rows or columns. There +is no recursion, external solver or predecessor execution. Managed Python +allocation is a Power of Ten rule 3 deviation, bounded by those capacities. +Warnings are treated as errors in every registered command. The source +and manifest checks are separate from mathematical verification. + +## Limits + +The construction can double the number of compensated generator macros. +It proves no decrease in total gate count, precision, memory, runtime or +recursive moment. Gaussian-rational coefficients may have odd denominators. +Exact coefficient preparation, rounded children, physical delivery, +restoration under rounding, compiler/native admission, stock/tape costs +and the outer theorem retain their existing obligations. The selected +frontier and all five framework assumptions are unchanged. diff --git a/research/exact-unit-stein-splitting/README.md b/research/exact-unit-stein-splitting/README.md new file mode 100644 index 0000000000..af45308272 --- /dev/null +++ b/research/exact-unit-stein-splitting/README.md @@ -0,0 +1,86 @@ +# Exact factor-one rational Stein generators + +Scoped written proof with exact finite corroboration. For every rectangular +Gaussian-rational matrix E of rank r, the new construction gives + + E = sum_(j=1)^s g_j a_j, s <= 2r, + ||g_j||_2 <= 1, ||a_j||_2 <= ||E||_2. + +The columns form a rational Parseval frame for col(E), and a_j=g_j*E. +This improves the coefficient norm contract of Jose Manuel's +[PR4198](https://github.com/CrocSwap/integer-mult-bounds/pull/4198) +from a factor below two to exact factor one by permitting extra terms. +Nick Petalas's [PR6228](https://github.com/CrocSwap/integer-mult-bounds/pull/6228) +already approaches one with r terms. Its fixed-term normalizer is not +used here. No new kappa is claimed. The standard coordinate factorization already +gives the unit bounds with m terms; this construction bounds the count +by 2r independently of the ambient row dimension m. + +The new step represents each rational residual norm as the sum of two +Gaussian-rational squared norms, then splits its orthogonal projector. +The rational residual interface and Stein/dirty-shear identities are +credited to PR4198; Lagrange's four-square theorem is classical. +[PROOF.md](PROOF.md) gives the arbitrary-dimensional argument and limits. + +## Evidence + +The verifier passes 414 matrix fixtures, containing total rank 698 and +901 emitted terms. Exactly 123 fixtures use extra terms. It checks 2,048 +positive integer square decompositions and seventeen rejection controls. +For E=(1,1,1)^T, it emits two terms with squared column norms 1/3 and 2/3 +and squared row norms 1 and 2. The exact matrix norm squared is three. + +The standalone checker independently row-reduces every input, reconstructs +every matrix entry, checks the full Parseval projector and verifies +E*E-a_j*a_j is positive semidefinite by exact Hermitian elimination. +It also checks the complete two-square preference against a separate +small enumeration. Counts and the explicit rank-one witness are emitted +by the verifier, with hashes of every package source file. No receipt is +handwritten and no predecessor scientific verifier is executed. + +## Reproduce + +From the repository root, using CPython 3.12 and its standard library: + +```sh +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -I -W error -B research/exact-unit-stein-splitting/verify.py +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -I -O -W error -B research/exact-unit-stein-splitting/verify.py +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -B scripts/research_package.py --package research/exact-unit-stein-splitting +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -B scripts/check_research_commit.py --package research/exact-unit-stein-splitting --check-source-history +``` + +Any CPython 3.12 path can replace the local interpreter. Expected markers +are PASS_EXACT_UNIT_STEIN_SPLITTING, PASS_REGISTERED_RESEARCH_PACKAGE and +PASS_RESEARCH_COMMIT_BYTES. The default replay is read-only. Optional +`--receipt /absolute/new/path.json` writes a source-bound receipt and +refuses to overwrite an existing file. + +## Limitations + +The written theorem has arbitrary finite dimensions. The executable +accepts dimensions at most eight, component height at most 256, and +primitive residual squared norm at most 65,536. It rejects exhaustion. +Its exhaustive integer-square search is not a polynomial bit-time claim. +The 2r term bound is not claimed optimal. Additional compensated macros +may outweigh the smaller coefficients. No physical precision or supplier +saving, complete multiplier, human review or formal-kernel acceptance is +claimed. All five framework assumptions remain. + +## Open next questions + +- Can a rational Parseval construction always use fewer than 2r terms? + Start with the embedding of a rank-two rational Hermitian form into a + three-coordinate standard form. This could reduce the added macros; + arbitrary rational-form embedding and its preparation costs are open here. +- Can an actual rounded child benefit after all extra terms are charged? + Start with one emitted tuple and its full compensated execution, including + coefficient preparation, rounding and delivery. The physical contract + and full caller invoice are missing. AAAmirinu's + [PR6239](https://github.com/CrocSwap/integer-mult-bounds/pull/6239) + already cautions that a smaller coefficient row alone need not reduce + child precision. + +This contribution was produced by Nick Petalas. Credit Jose Manuel / +jmbarrancoml and Vlado Vojdanovski for the residual and dirty-shear compiler, +Cinna Davis and the retained Gaussian/phase/caller authors, and classical +Gram-Schmidt and four-square theory. Apache-2.0. diff --git a/research/exact-unit-stein-splitting/SOURCES.json b/research/exact-unit-stein-splitting/SOURCES.json new file mode 100644 index 0000000000..32f4851378 --- /dev/null +++ b/research/exact-unit-stein-splitting/SOURCES.json @@ -0,0 +1,45 @@ +{ + "schema_version": 1, + "base_commit": "e54523517d0f03e58352e647c403a5af3e525a57", + "files": [ + { + "path": "certificates/selected-result.json", + "usage": "provenance", + "git_blob": "75d77b328ea02ded535e7f23aee5b1e55d0bb1a8", + "sha256": "154c3d30455d778fd3343b6b4851f0fa4665f0f7625b0adb3675e2bafbbf6bf1" + }, + { + "path": "docs/research/agent-task-catalog.json", + "usage": "provenance", + "git_blob": "3404fbdd5e7529a0674eef26114b5071e4586cec", + "sha256": "ead6cdc9d0af6d58e8a49744d8ec8c7c15e13d2ba93c276c434bcf9b51b93a81" + }, + { + "path": "research/rational-stein-generators/PROOF.md", + "usage": "provenance", + "git_blob": "075e828b68dca080ab20461fba57047e46b3b271", + "sha256": "90e5681d0e32be1926df7f3fd2715aa43f983fa7e4c01ee42a15322f9d19e639" + } + ], + "references": [ + { + "pr": 4198, + "author": "jmbarrancoml", + "role": "Main predecessor: exact orthogonal residual and Stein/dirty-shear interface." + }, + { + "pr": 6228, + "author": "petalas", + "role": "Background only: near-unit fixed-term normalization; no construction or executable reused." + }, + { + "pr": 6239, + "author": "AAAmirinu", + "role": "Background only: coefficient norm need not reduce rounded-child precision." + }, + { + "url": "https://leanprover-community.github.io/mathlib4_docs/Mathlib/NumberTheory/SumFourSquares.html", + "role": "Classical Lagrange four-square theorem; no Lean replay claimed." + } + ] +} diff --git a/research/exact-unit-stein-splitting/TASK.json b/research/exact-unit-stein-splitting/TASK.json new file mode 100644 index 0000000000..ff83aed511 --- /dev/null +++ b/research/exact-unit-stein-splitting/TASK.json @@ -0,0 +1,96 @@ +{ + "schema_version": 1, + "task_id": "uniform-transfer-audit", + "priority_revision": 8, + "base_commit": "e54523517d0f03e58352e647c403a5af3e525a57", + "original_card": { + "id": "uniform-transfer-audit", + "question": "Can one of the selected record's five inherited assumptions be proved at its actual caller?", + "starting_points": [ + "docs/research/current-priorities.md", + "docs/research/research-family-status.md", + "certificates/selected-result.json", + "docs/research/pr-intake-evidence/pr5599-completion/PROOF-REVIEW.md" + ], + "methods": [ + "Construct and independently check one source-bound instance of the stated first experiment.", + "Seek an exact counterexample or target-specific complete-budget obstruction to that same proposed change." + ], + "acceptance_gate": "Identify the proposition and what would change downstream; do not equate a finite replay with a universal proof.", + "first_step": { + "command": [ + "python3", + "-B", + "scripts/research_selected_baseline.py" + ], + "expected": "PASS_RESEARCH_BASELINE_BINDINGS_ONLY", + "inspect": "Read revision 8, the selected review and live exact-source handoffs. Then follow this card's bounded first_experiment.", + "scope": "Source-bound orientation only, not a supplier replay or theorem proof." + }, + "first_experiment": "Choose one assumption ID (native_all_columns, owned_erasure, compiler, precision_tape, analytic_recovery), one quantified implication and exact dependency closure. Check current handoffs, including #5625 row reentry and #5707 root-prefix lowering, without treating their partial scope as the whole theorem. Prove or falsify that implication with a caller-bound argument; stop at the chosen obligation. Finite tests or root digits do not discharge an all-size statement.", + "bottleneck_link": "Judge the actual current supplier contract and complete signed target/paid bill; frozen-profile ceilings require an applicability proof.", + "allowed_variations": [ + "One exact source head, helper/cut region or quantified proposition and changed hypothesis; check live handoffs first. Different seeds are not different scopes." + ], + "scope_change_triggers": [ + "Changing source head, helper/cut domain, operation alphabet or caller boundary without recording the new scope.", + "Treating an archived proposal or local numerical pass as complete supplier admission." + ], + "overlap_terms": [ + "native_all_columns", + "owned_erasure", + "compiler", + "precision_tape", + "analytic_recovery" + ], + "existing_checks": [ + { + "scope": "PR #4100: proposed unconditional construction and finite checks, without independent acceptance.", + "evidence": "research/unconditional-batched-crt/README.md", + "remaining": "Independent proof audit of one caller-bound all-size implication; all other premises remain explicit.", + "status": "author-checked", + "source_commit": "337d04939571a637aeab54a0f58f54fde811663a", + "selected_record_sha256": "bb2eaa58647b353f88d0aec2eafb9d30df1be53589231b23e12ceef3e4bad129" + }, + { + "scope": "Selected PR5599: complete helper-subspace construction and independent caller replay; five framework assumptions remain.", + "evidence": "docs/research/pr-intake-evidence/pr5599-completion/PROOF-REVIEW.md", + "remaining": "The next experiment must identify uncovered source-specific work. Successor archive intake does not transfer this admission.", + "status": "reviewed", + "source_commit": "09dd0965711ca7eeb169057a420abab1c9052137", + "selected_record_sha256": "2a0220e866417774606e0f991e41b9c1d26b1f43b97857238cf478dbc7d330b5" + } + ] + }, + "scope_status": "changed", + "actual_scope": "Exact unit-norm Gaussian-rational Stein generators with at most twice the rank-many terms.", + "scope_change_reason": "The donor requests an original result, not an audit. This changes the coefficient term-count contract at PR4198 rather than reviewing a selected framework assumption.", + "bottleneck_link": "Side result on the coefficient preparation boundary. Exact smaller norms could affect a rounded child, but extra generator macros and physical costs must be paid first.", + "budget_minutes": 60, + "stop_rule": "Ship the first exact factor-one construction and its bounded verification; do not expand into rounded/native implementation.", + "outcome": "completed", + "evidence": "PROOF.md proves the general construction; verify.py checks exact rational finite fixtures and emits a source-bound receipt.", + "author": "Nick Petalas", + "ai_assistance": "Independent human and formal proof-kernel review are unclaimed.", + "open_questions": [ + { + "question": "Can a universal rational Parseval construction use fewer than 2r terms?", + "why_it_matters": "Fewer added compensated generator macros could reduce overhead.", + "first_step": "Study a rank-two rational Hermitian form embedded into three standard coordinates.", + "blocked_by": "A rational embedding theorem and exact coefficient preparation algorithm are not supplied here." + }, + { + "question": "Does an actual rounded child benefit after all extra terms are charged?", + "why_it_matters": "Coefficient norm alone does not determine physical precision or cost.", + "first_step": "Bind one emitted tuple to the complete compensated rounded child and charge preparation, delivery and every extra call.", + "blocked_by": "Physical coefficient delivery and complete caller costs remain missing." + } + ], + "environment": { + "implementation": "CPython", + "version": "3.12.15", + "system": "Darwin", + "machine": "arm64", + "dependencies": "standard library only" + } +} diff --git a/research/exact-unit-stein-splitting/VERIFY.json b/research/exact-unit-stein-splitting/VERIFY.json new file mode 100644 index 0000000000..975d9ae294 --- /dev/null +++ b/research/exact-unit-stein-splitting/VERIFY.json @@ -0,0 +1,34 @@ +{ + "schema_version": 1, + "status": "ready", + "python": "3.12", + "requirements": [], + "inputs": [], + "commands": [ + { + "argv": [ + "{python}", + "-I", + "-W", + "error", + "-B", + "{package}/verify.py" + ], + "timeout_seconds": 120, + "checks": "Complete exact reconstruction, Parseval projector, independent rank and Hermitian PSD checks, square enumeration and rejection controls." + }, + { + "argv": [ + "{python}", + "-I", + "-O", + "-W", + "error", + "-B", + "{package}/verify.py" + ], + "timeout_seconds": 120, + "checks": "Same full contract with assertions disabled." + } + ] +} diff --git a/research/exact-unit-stein-splitting/algebra.py b/research/exact-unit-stein-splitting/algebra.py new file mode 100644 index 0000000000..94be17e65a --- /dev/null +++ b/research/exact-unit-stein-splitting/algebra.py @@ -0,0 +1,158 @@ +"""Bounded exact Gaussian-rational arithmetic for the coefficient construction.""" +from fractions import Fraction as Q +from math import gcd, isqrt, lcm + +C = tuple[Q, Q] +V = tuple[C, ...] +M = tuple[V, ...] +ZERO: C = (Q(0), Q(0)) +ONE: C = (Q(1), Q(0)) +MAX_DIM = 8 +MAX_HEIGHT = 256 +MAX_SQUARE_SUM = 65536 + + +def add(a: C, b: C) -> C: + return a[0] + b[0], a[1] + b[1] + + +def neg(a: C) -> C: + return -a[0], -a[1] + + +def mul(a: C, b: C) -> C: + return a[0]*b[0] - a[1]*b[1], a[0]*b[1] + a[1]*b[0] + + +def conj(a: C) -> C: + return a[0], -a[1] + + +def scale(a: C, q: Q) -> C: + return a[0]*q, a[1]*q + + +def total(values) -> C: + result = ZERO + for value in values: + result = add(result, value) + return result + + +def dot(a: V, b: V) -> C: + assert len(a) == len(b) <= MAX_DIM + return total(mul(conj(x), y) for x, y in zip(a, b)) + + +def norm2(v: V) -> Q: + value = dot(v, v) + assert value[1] == 0 and value[0] >= 0 + return value[0] + + +def adj(a: M) -> M: + return tuple(tuple(conj(x) for x in col) for col in zip(*a)) + + +def product(a: M, b: M) -> M: + assert a and b and len(a[0]) == len(b) + assert max(len(a), len(b), len(b[0])) <= 2*MAX_DIM + return tuple(tuple(total(mul(x, y) for x, y in zip(row, col)) + for col in zip(*b)) for row in a) + + +def outer(v: V) -> M: + return tuple(tuple(mul(x, conj(y)) for y in v) for x in v) + + +def matrix_sum(a: M, b: M) -> M: + assert len(a) == len(b) and len(a[0]) == len(b[0]) + return tuple(tuple(add(x, y) for x, y in zip(r, s)) for r, s in zip(a, b)) + + +def zero_matrix(rows: int, cols: int) -> M: + assert 1 <= rows <= 2*MAX_DIM and 1 <= cols <= 2*MAX_DIM + return tuple(tuple(ZERO for _ in range(cols)) for _ in range(rows)) + + +def validate(a: M) -> None: + if not isinstance(a, tuple) or not 1 <= len(a) <= MAX_DIM: + raise ValueError("matrix row capacity") + if not isinstance(a[0], tuple) or not 1 <= len(a[0]) <= MAX_DIM: + raise ValueError("matrix column capacity") + for row in a: + if not isinstance(row, tuple) or len(row) != len(a[0]): + raise ValueError("ragged matrix") + for value in row: + if not isinstance(value, tuple) or len(value) != 2: + raise ValueError("Gaussian-rational entry required") + for part in value: + if type(part) is not Q: + raise ValueError("exact Fraction components required") + if max(abs(part.numerator).bit_length(), part.denominator.bit_length()) > MAX_HEIGHT: + raise ValueError("input height capacity") + + +def square_pairs(n: int) -> tuple[int, int, int, int]: + """Two-square representations are preferred, then a bounded four-square search.""" + if type(n) is not int or not 1 <= n <= MAX_SQUARE_SUM: + raise ValueError("primitive squared-norm capacity") + pairs = [None]*(n+1) + for x in range(isqrt(n)+1): + for y in range(isqrt(n-x*x)+1): + pairs[x*x+y*y] = (x, y) + if pairs[n] is not None: + x, y = pairs[n] + return x, y, 0, 0 + for k in range(n+1): + if pairs[k] is not None and pairs[n-k] is not None: + x, y = pairs[k] + z, t = pairs[n-k] + assert x*x+y*y+z*z+t*t == n + return x, y, z, t + raise ArithmeticError("four-square exhaustion contradicts Lagrange") + + +def split_norm(v: V) -> tuple[C, C]: + """Represent ||v|| squared as two Gaussian-rational squared norms.""" + assert 1 <= len(v) <= MAX_DIM and norm2(v) > 0 + denominator = lcm(*(q.denominator for x in v for q in x)) + integers = tuple(int(q*denominator) for x in v for q in x) + divisor = gcd(*integers) + primitive = tuple(x//divisor for x in integers) + n = sum(x*x for x in primitive) + a, b, c, d = square_pairs(n) + factor = Q(divisor, denominator) + result = ((factor*a, factor*b), (factor*c, factor*d)) + assert sum(norm2((z,)) for z in result) == norm2(v) + return result + + +def residuals(a: M) -> tuple[V, ...]: + validate(a) + accepted = [] + for column in zip(*a): + v = tuple(column) + for previous in accepted: + coefficient = scale(dot(previous, v), 1/norm2(previous)) + v = tuple(add(x, neg(mul(coefficient, y))) for x, y in zip(v, previous)) + if norm2(v): + assert all(dot(old, v) == ZERO for old in accepted) + accepted.append(v) + return tuple(accepted) + + +def construct(a: M) -> tuple[tuple[V, ...], tuple[V, ...], tuple[V, ...]]: + basis = residuals(a) + columns = [] + rows = [] + for v in basis: + for z in split_norm(v): + if z != ZERO: + g = tuple(scale(mul(x, z), 1/norm2(v)) for x in v) + row = tuple(dot(g, tuple(col)) for col in zip(*a)) + assert 0 < norm2(g) <= 1 + columns.append(g) + rows.append(row) + assert len(basis) <= len(columns) <= 2*len(basis) + return tuple(columns), tuple(rows), basis diff --git a/research/exact-unit-stein-splitting/verify.py b/research/exact-unit-stein-splitting/verify.py new file mode 100644 index 0000000000..da9bed2c35 --- /dev/null +++ b/research/exact-unit-stein-splitting/verify.py @@ -0,0 +1,207 @@ +"""Check the new coefficient contract; never execute predecessor code.""" +import argparse +from fractions import Fraction as Q +from hashlib import sha256 +from itertools import product as cartesian +from math import isqrt +import json +from pathlib import Path +import sys + +PACKAGE = Path(__file__).resolve().parent +sys.path.insert(0, str(PACKAGE)) +from algebra import (C, V, M, ZERO, ONE, MAX_DIM, MAX_SQUARE_SUM, add, adj, + conj, construct, dot, matrix_sum, mul, neg, norm2, + outer, product, scale, square_pairs, validate, zero_matrix) + + +def require(condition: bool, message: str) -> None: + if not condition: + raise ArithmeticError(message) + + +def rank(a: M) -> int: + """Independent row elimination, not the column residual constructor.""" + rows = [list(row) for row in a] + pivot_row = 0 + for j in range(len(a[0])): + pivot = next((i for i in range(pivot_row, len(rows)) if rows[i][j] != ZERO), None) + if pivot is None: + continue + rows[pivot_row], rows[pivot] = rows[pivot], rows[pivot_row] + value = rows[pivot_row][j] + inverse = scale(conj(value), 1/norm2((value,))) + rows[pivot_row] = [mul(x, inverse) for x in rows[pivot_row]] + for i in range(len(rows)): + if i != pivot_row: + factor = rows[i][j] + rows[i] = [add(x, neg(mul(factor, y))) + for x, y in zip(rows[i], rows[pivot_row])] + pivot_row += 1 + if pivot_row == len(rows): + break + return pivot_row + + +def positive_semidefinite(a: M) -> bool: + """Exact Hermitian Schur criterion, including singular zero pivots.""" + if a != adj(a): + return False + h = [list(row) for row in a] + for k in range(len(a)): + pivot = h[k][k] + if pivot[1] or pivot[0] < 0: + return False + if pivot == ZERO: + if any(h[k][j] != ZERO for j in range(k+1, len(a))): + return False + else: + for i in range(k+1, len(a)): + for j in range(k+1, len(a)): + correction = scale(mul(h[i][k], h[k][j]), 1/pivot[0]) + h[i][j] = add(h[i][j], neg(correction)) + return True + + +def contract(a: M, columns: tuple[V, ...], rows: tuple[V, ...]) -> dict: + validate(a) + r = rank(a) + require(r <= len(columns) <= 2*r and len(columns) == len(rows), "term count") + projection = zero_matrix(len(a), len(a)) + rebuilt = zero_matrix(len(a), len(a[0])) + gram = product(adj(a), a) + for g, row in zip(columns, rows): + require(len(g) == len(a) and len(row) == len(a[0]), "factor shape") + require(0 < norm2(g) <= 1, "column norm") + require(row == tuple(dot(g, tuple(c)) for c in zip(*a)), "adjoint row") + projection = matrix_sum(projection, outer(g)) + term = tuple(tuple(mul(x, y) for y in row) for x in g) + rebuilt = matrix_sum(rebuilt, term) + row_gram = outer(tuple(conj(x) for x in row)) + difference = matrix_sum(gram, tuple(tuple(neg(x) for x in rr) for rr in row_gram)) + require(positive_semidefinite(difference), "row contraction") + require(rebuilt == a, "reconstruction") + require(projection == adj(projection), "Hermitian projection") + require(product(projection, projection) == projection, "Parseval projection") + require(product(projection, a) == a and rank(projection) == r, "column-space projection") + return {"rank": r, "terms": len(rows), "split_surplus": len(rows)-r} + + +def real(value) -> C: + return Q(value), Q(0) + + +def fixtures() -> tuple[M, ...]: + result = [] + for alphabet in [(real(-1), ZERO, ONE), (ZERO, ONE, (Q(0), Q(1)), (Q(1), Q(1)))]: + for values in cartesian(alphabet, repeat=4): + result.append((tuple(values[:2]), tuple(values[2:]))) + for m in range(1, 6): + for n in range(1, 6): + for denominator in (1, 3): + result.append(tuple(tuple(real(Q((i+1)*(j%2+1), denominator)) + for j in range(n)) for i in range(m))) + basis = ((real(1), real(1), real(1)), + (real(1), real(-1), ZERO), + (real(1), real(1), real(-2))) + for exponent in (0, 3, 120): + for shift in range(8): + a = tuple(tuple(add(scale(basis[j][i], Q(1, 2**exponent) if j == 2 else Q(1)), + scale(basis[0][i], Q(shift) if j else Q(0))) + for j in range(3)) for i in range(3)) + result.append(a) + result.extend((zero_matrix(1, 1), zero_matrix(3, 5), + ((ONE, ZERO), (ONE, ZERO), (ONE, ZERO)))) + return tuple(result) + + +def controls() -> int: + caught = 0 + invalid = [(), ((ONE,), (ONE, ZERO)), ((1.0,),), + tuple((ONE,) for _ in range(MAX_DIM+1)), + (((Q(1, 2**300), Q(0)),),)] + for matrix in invalid: + try: + construct(matrix) + except ValueError: + caught += 1 + else: + raise ArithmeticError("invalid matrix accepted") + invalid.append(((ONE,), ((Q(256), Q(0)),))) + try: + construct(invalid[-1]) + except ValueError: + caught += 1 + else: + raise ArithmeticError("residual capacity accepted") + for value in (0, -1, MAX_SQUARE_SUM+1, True): + try: + square_pairs(value) + except ValueError: + caught += 1 + else: + raise ArithmeticError("invalid square capacity accepted") + a = ((ONE,), (ONE,), (ONE,)) + columns, rows, _ = construct(a) + faults = [(columns[:1], rows[:1]), + (columns, tuple(tuple(conj(x) for x in row) for row in rows)), + (tuple(tuple(scale(x, Q(2)) for x in col) for col in columns), rows), + (columns, tuple(tuple(scale(x, Q(3)) for x in row) for row in rows))] + for cols, rr in faults: + try: + contract(a, cols, rr) + except ArithmeticError: + caught += 1 + else: + raise ArithmeticError("semantic fault accepted") + for bad in [((real(-1),),), ((ZERO, ONE), (ONE, ZERO)), + ((ONE, (Q(0), Q(1))), (ZERO, ONE))]: + require(not positive_semidefinite(bad), "PSD negative control") + caught += 1 + require(positive_semidefinite(((ZERO, ZERO), (ZERO, ONE))), "PSD singular control") + require(square_pairs(MAX_SQUARE_SUM) == (256, 0, 0, 0), "capacity endpoint") + return caught + + +def run() -> dict: + four_square_cases = 0 + for n in range(1, 2049): + a, b, c, d = square_pairs(n) + require(a*a+b*b+c*c+d*d == n, "four-square identity") + one_term_possible = any(x*x+y*y == n for x in range(isqrt(n)+1) + for y in range(isqrt(n)+1)) + require((c == d == 0) == one_term_possible, "two-square preference") + four_square_cases += 1 + stats = [contract(a, *construct(a)[:2]) for a in fixtures()] + example = ((ONE,), (ONE,), (ONE,)) + columns, rows, _ = construct(example) + require(len(columns) == 2, "rank-one exact-unit two-term witness") + require(sum(norm2(g) for g in columns) == 1, "rank-one Parseval trace") + result = {"status": "PASS_EXACT_UNIT_STEIN_SPLITTING", + "four_square_cases": four_square_cases, + "matrix_cases": len(stats), + "total_rank": sum(s["rank"] for s in stats), + "total_terms": sum(s["terms"] for s in stats), + "cases_using_extra_terms": sum(s["split_surplus"] > 0 for s in stats), + "rejection_controls": controls(), + "example_column_norms_squared": [str(norm2(g)) for g in columns], + "example_row_norms_squared": [str(norm2(row)) for row in rows]} + names = ("algebra.py", "verify.py", "README.md", "PROOF.md", "TASK.json", "SOURCES.json", "VERIFY.json") + result["source_sha256"] = {name: sha256((PACKAGE/name).read_bytes()).hexdigest() for name in names} + return result + + +def main() -> None: + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--receipt", type=Path) + args = parser.parse_args() + result = run() + rendered = json.dumps(result, sort_keys=True, indent=2)+"\n" + if args.receipt: + with args.receipt.open("x", encoding="utf-8") as output: + require(output.write(rendered) == len(rendered), "receipt write") + print(rendered, end="") + + +if __name__ == "__main__": + main() From b33301c56988916eb2b748b6d5fe764fc4c1bbb1 Mon Sep 17 00:00:00 2001 From: Nick Petalas Date: Tue, 17 Nov 2026 22:45:28 +0000 Subject: [PATCH 2/2] fix(ci): sync CI verification doc and historical replay-gap verifier --- docs/ci-verification.md | 19 +++++- .../historical-selected-replay-gap/README.md | 6 +- .../SOURCES.json | 60 +++++++++--------- .../VERIFY.json | 31 +-------- .../historical-selected-replay-gap/verify.py | 63 ++++++++++++++----- 5 files changed, 100 insertions(+), 79 deletions(-) diff --git a/docs/ci-verification.md b/docs/ci-verification.md index 63ba3e9aa8..52b62d0481 100644 --- a/docs/ci-verification.md +++ b/docs/ci-verification.md @@ -1,8 +1,25 @@ # CI verification -## Current selected-family replay: #6030 +## Current selected-family replay: #7000 with #7001 The [selected record](../certificates/selected-result.json) binds conditional +κ = 0.00363005817 to the [application review](research/pr-intake-evidence/pr7000-application/PROOF-REVIEW.md), +[validation receipts](research/pr-intake-evidence/pr7000-application/VALIDATION.json), +and [explicit source closure](../certificates/frontier7000-source.json). +`make frontier7000-verify` follows that exact-source selected replay. The review +reuses eleven authenticated preceding executions and records seven fresh serial +application, scalar and complete native-catalogue executions. The earlier +monolithic timeout is retained separately and is not completed coverage. +Consult the receipts for exact commands, source heads and limits. + +The five inherited framework assumptions remain. No complete uniform word, +literal multiplier execution, independent human proof or formal-kernel proof +is asserted. Routine research submissions do not need to rerun this +selected-family replay. The sections below preserve historical checkpoints. + +## Historical selected-family replay: #6030 + +The [historical checkpoint](../certificates/checkpoints/frontier6030.json) binds conditional κ = 0.003125804 to the [proof review](research/pr-intake-evidence/pr6030-audit/PROOF-REVIEW.md), [validation receipts](research/pr-intake-evidence/pr6030-audit/VALIDATION.json), and [explicit source closure](../certificates/frontier6030-source.json). diff --git a/research/historical-selected-replay-gap/README.md b/research/historical-selected-replay-gap/README.md index 55d8cc3b49..36d9a873ca 100644 --- a/research/historical-selected-replay-gap/README.md +++ b/research/historical-selected-replay-gap/README.md @@ -69,7 +69,11 @@ python3 -B scripts/research_package.py --package research/historical-selected-re The direct command prints `PASS_HISTORICAL_SELECTED_REPLAY_GAP`. A registered replay prints `PASS_REGISTERED_RESEARCH_PACKAGE`. Both require Git history -containing the two inspected commits. +containing the two inspected commits and the source and manifest objects at +`2485805a6d47f36ea83ddde6327d453ac82d44dc`. The verifier uses a temporary +sparse checkout of that commit, checks the declared source digests there, and +uses its planner and manifest inventory. The recorded rejections and selection +therefore remain reproducible after later changes to the live Makefile or CI guide. ## Open next questions diff --git a/research/historical-selected-replay-gap/SOURCES.json b/research/historical-selected-replay-gap/SOURCES.json index c1010eec95..62bb8b3950 100644 --- a/research/historical-selected-replay-gap/SOURCES.json +++ b/research/historical-selected-replay-gap/SOURCES.json @@ -4,13 +4,13 @@ "files": [ { "path": "Makefile", - "usage": "input", + "usage": "provenance", "git_blob": "0d683a06b9e7ee162496108ce9a7c5d2ee94fccf", "sha256": "4f2d4f2dcd15139ec82658a975f85ed300897385f85799218539f4c8d60567da" }, { "path": "certificates/partial-swap-network.json", - "usage": "input", + "usage": "provenance", "git_blob": "eccafa830c16170c36faf93045ddf1f638f7bcd4", "sha256": "4c0b9d37e1034b2076e30a70f8e514416298c462d9ee98bc87fe6556b14df786" }, @@ -22,7 +22,7 @@ }, { "path": "docs/ci-verification.md", - "usage": "input", + "usage": "provenance", "git_blob": "63ba3e9aa8bdc5e942b56e34244b92b16f854085", "sha256": "c7d3027e9ad8bcbff68f07aa9576b30fb2f3c76c44d876d40c7fdbf4a3e2228a" }, @@ -34,163 +34,163 @@ }, { "path": "research/clifford-state-performance/SOURCE.json", - "usage": "input", + "usage": "provenance", "git_blob": "6f98a0061a5104dfab82c9e806f819b41811f684", "sha256": "396d0f08df24952248140d5c65c51b8c902ef1c580892ff7ea182890530f67ee" }, { "path": "research/community-batch1047-audit/CONTENT-COVERAGE.json", - "usage": "input", + "usage": "provenance", "git_blob": "5e0f92af463ec12c5e1dcc3effd44081a88af647", "sha256": "07a9daeaf2bda308a92e9a4684f13d5fc766c7772d74801fceb7f4599fdab226" }, { "path": "research/community-batch1099-audit/CONTENT-COVERAGE.json", - "usage": "input", + "usage": "provenance", "git_blob": "9e13266bf85e627f1b7dc225e9530ea69fd2c7f0", "sha256": "421e1211fb1897c45621dc6801c276e53f2e6f335583c9c9049e535f87c0a3b1" }, { "path": "research/community-batch932-audit/CONTENT-COVERAGE.json", - "usage": "input", + "usage": "provenance", "git_blob": "cc4d03eb59b9ab3f952735f7e88ff18c2d15d7af", "sha256": "184629cac91a5cfaca50330a88596008b824221433867dcf8117539c913c284a" }, { "path": "research/community-batch970-audit/CONTENT-COVERAGE.json", - "usage": "input", + "usage": "provenance", "git_blob": "8b9f4111badf7de5d97684799560b55110e9da79", "sha256": "23188ed920e38a54006cb883e181585620821c63bf7e8b5e05d32719417cc37e" }, { "path": "research/community-frontier741-audit/CONTENT-COVERAGE.json", - "usage": "input", + "usage": "provenance", "git_blob": "a5300d4e7a5381a3f443fc54c768ca6f0f236d68", "sha256": "3c820fb30e1b4d9bcfc6a7ab524375e5b2abd66b940af2c509146104f0bcd79c" }, { "path": "research/community-frontier890-audit/CONTENT-COVERAGE.json", - "usage": "input", + "usage": "provenance", "git_blob": "d7ff6d777b01d69b6ce84caf25d3b7e4a4d2f211", "sha256": "6b185a9902652f893f3ebd8ada92d2f11b6de6533a9a4d11718a8a4496101128" }, { "path": "research/community-hyperplane599-audit/SOURCE.json", - "usage": "input", + "usage": "provenance", "git_blob": "546f37d326d10a99910ae8f908e71ef768524d98", "sha256": "65099d764bfcc39bda5e4d9966783611b094c3522dbdd1435cd498d657a8ef8e" }, { "path": "research/community-k492-audit/SOURCE.json", - "usage": "input", + "usage": "provenance", "git_blob": "e538481e4cb16ed936d3195f2dfb5b5a9ca0a76b", "sha256": "2c0f4fa5bc150d05658af2e7c54c4d2c337dd52b7efd3d69530ae73bcbdf452a" }, { "path": "research/community-reconciliation92-audit/MANIFEST.json", - "usage": "input", + "usage": "provenance", "git_blob": "2a2e93685173d5f13cbb5abe740f5d90352e0228", "sha256": "5f501f3c118131e7d069f30ad77186eb2ad6961f9680a0ef105f4514ed41808a" }, { "path": "research/partial-swap-digest/baseline.py", - "usage": "input", + "usage": "provenance", "git_blob": "a2f0190704db83bd8ef48e46e723c49b925804fe", "sha256": "81e9af92cdf38243a540cdcff2062778e449467848d444da37a9553c12ca4c34" }, { "path": "research/r420-two-sided-basis/SOURCES.json", - "usage": "input", + "usage": "provenance", "git_blob": "5d718e11e62f4bcadecf1e02d6b61f87dbe190b0", "sha256": "d9810b0d139c5a1211fd2c1f0d142187cc1fca30026e1e7bc4f9ecfacf1596d1" }, { "path": "research/skip-clones/SOURCE.json", - "usage": "input", + "usage": "provenance", "git_blob": "8d1bb3b9c8189e35e5d8bfdfa632d7473e8be0d5", "sha256": "0b68e63e35a97ce6b0cdb6e291b88ebaa8f2dd4afb70b2498f10ee89428258dc" }, { "path": "research/split-skip/SOURCE.json", - "usage": "input", + "usage": "provenance", "git_blob": "2ab610b6ea2edd2865fda793ef2168b0c76afb4f", "sha256": "7c2b4646a3ecfef6f881da5c43e4bd0fa9a4d1b00548b8ab458d897e16735134" }, { "path": "scripts/historical-ci-inputs/Makefile", - "usage": "input", + "usage": "provenance", "git_blob": "aff68409021c9d401a6f8013b9dfd7dbcc30f2a8", "sha256": "ea8830dd79da493e2d75baf753d733ff7efbcf2b4794afe41fae0ac8f3055646" }, { "path": "scripts/historical-ci-inputs/ledger-batch932-run_isolated_tests.py", - "usage": "input", + "usage": "provenance", "git_blob": "65db599ab0b1dea0312c4ca048e0bd0f44c3736f", "sha256": "96ea543e6c707424afe247e77bd86c82152f90fc76a0773c4232145da5cdf8d1" }, { "path": "scripts/historical-ci-inputs/ledger-batch932-test_isolated_test_runner.py", - "usage": "input", + "usage": "provenance", "git_blob": "34820a8f24678f918f4d0e7a35380d8013fc3495", "sha256": "628391b6abfbc8674ceec1751867a4392f2cc0b5b66886243e139af86cf355ac" }, { "path": "scripts/historical-ci-inputs/ledger-batch970-verify_selected_result.py", - "usage": "input", + "usage": "provenance", "git_blob": "c755b76e0d44ba4917aa94440ebe54daefce5b2a", "sha256": "d7fd929726b326aeeaf0a3996475adec88eee9aac09ae0bebeeaa0bc1fc8f199" }, { "path": "scripts/historical-ci-inputs/ledger-frontier741-ci-verification.md", - "usage": "input", + "usage": "provenance", "git_blob": "7f3c012504187917a728b9fe87043f0fc8cd006a", "sha256": "a854022e0e1d5d4db4d60e586be3ea56005013ef14a1fc06d02bc06e8529c4b0" }, { "path": "scripts/historical-ci-inputs/partial-swap-context.json", - "usage": "input", + "usage": "provenance", "git_blob": "ad65114886bf34a4fd27e79f3be502389e689faa", "sha256": "833a9642f33aeab2ffea17ec9c6b82e0a953f90192b2c82e10bef21538dccba9" }, { "path": "scripts/historical-ci-inputs/partial-swap-network.json", - "usage": "input", + "usage": "provenance", "git_blob": "52075f2463f60af5e16571347f24274fce73a1ea", "sha256": "f3c4be597b2f2136da4ae2cc80c7454f63c90aa01f84e5b8131cee4dd55de815" }, { "path": "scripts/partial_swap/shared.py", - "usage": "input", + "usage": "provenance", "git_blob": "44a0e454c70f9c4b98e258b8443612e6a119904b", "sha256": "5a0646a50b9f3e8ea55168620a78e8853b0ab810517cefc8cfb8696aedee278a" }, { "path": "scripts/replay_historical_check.py", - "usage": "input", + "usage": "provenance", "git_blob": "1e92fff2782970ef71378f594f2350d245a4db26", "sha256": "5467619c78183d3adc82b0cb55af28e5c1a01fca2b0588677816244b53e2bafd" }, { "path": "scripts/research_package.py", - "usage": "input", + "usage": "provenance", "git_blob": "091b4c8f58bac9a9580d76025b887dc5c873d05f", "sha256": "e1256016e7f51827d04fa2179255989f639ae1d97afaa9c16265f85a0c6abd70" }, { "path": "scripts/run_isolated_tests.py", - "usage": "input", + "usage": "provenance", "git_blob": "a96ab35b315ce492e7fbbfd6c5ae211aa066b541", "sha256": "49eb56dd0fc0d8d8ffdb209970a7adf2176223580646f575d5c22e59543b381c" }, { "path": "scripts/verify_selected_result.py", - "usage": "input", + "usage": "provenance", "git_blob": "6882a4700e410dec569b51ae2eaf1a19cc019195", "sha256": "d6b305eac5b9bdb8172c469ad30a1655a60fa0aceac8b1bf610e1b73f51babd8" }, { "path": "tests/test_isolated_test_runner.py", - "usage": "input", + "usage": "provenance", "git_blob": "343b24abf6719b81805eba5a84c74e57634c8288", "sha256": "3a5470d0b139828b90e19bf9583ddeafcd69f8e34f2824664eb3a2958a52e34d" } diff --git a/research/historical-selected-replay-gap/VERIFY.json b/research/historical-selected-replay-gap/VERIFY.json index 98553e72ed..ab7efa3471 100644 --- a/research/historical-selected-replay-gap/VERIFY.json +++ b/research/historical-selected-replay-gap/VERIFY.json @@ -4,36 +4,7 @@ "python": "3.12", "requirements": [], "inputs": [ - "Makefile", - "certificates/partial-swap-network.json", - "docs/ci-verification.md", - "research/clifford-state-performance/SOURCE.json", - "research/community-batch1047-audit/CONTENT-COVERAGE.json", - "research/community-batch1099-audit/CONTENT-COVERAGE.json", - "research/community-batch932-audit/CONTENT-COVERAGE.json", - "research/community-batch970-audit/CONTENT-COVERAGE.json", - "research/community-frontier741-audit/CONTENT-COVERAGE.json", - "research/community-frontier890-audit/CONTENT-COVERAGE.json", - "research/community-hyperplane599-audit/SOURCE.json", - "research/community-k492-audit/SOURCE.json", - "research/community-reconciliation92-audit/MANIFEST.json", - "research/partial-swap-digest/baseline.py", - "research/r420-two-sided-basis/SOURCES.json", - "research/skip-clones/SOURCE.json", - "research/split-skip/SOURCE.json", - "scripts/historical-ci-inputs/Makefile", - "scripts/historical-ci-inputs/ledger-batch932-run_isolated_tests.py", - "scripts/historical-ci-inputs/ledger-batch932-test_isolated_test_runner.py", - "scripts/historical-ci-inputs/ledger-batch970-verify_selected_result.py", - "scripts/historical-ci-inputs/ledger-frontier741-ci-verification.md", - "scripts/historical-ci-inputs/partial-swap-context.json", - "scripts/historical-ci-inputs/partial-swap-network.json", - "scripts/partial_swap/shared.py", - "scripts/replay_historical_check.py", - "scripts/research_package.py", - "scripts/run_isolated_tests.py", - "scripts/verify_selected_result.py", - "tests/test_isolated_test_runner.py" + "scripts/research_package.py" ], "commands": [ { diff --git a/research/historical-selected-replay-gap/verify.py b/research/historical-selected-replay-gap/verify.py index 83b995941a..9d266c5a4e 100644 --- a/research/historical-selected-replay-gap/verify.py +++ b/research/historical-selected-replay-gap/verify.py @@ -6,8 +6,10 @@ """ import hashlib import importlib.util +import json import subprocess import sys +import tempfile from pathlib import Path ROOT = Path(__file__).resolve().parents[2] @@ -61,31 +63,47 @@ def require(ok, message): raise SystemExit(message) -def load_checker(): - path = ROOT / "scripts/replay_historical_check.py" - spec = importlib.util.spec_from_file_location("historical_selected_replay_gap_checker", path) +def load_module(path): + spec = importlib.util.spec_from_file_location(path.stem, path) module = importlib.util.module_from_spec(spec) spec.loader.exec_module(module) return module +def checkout_snapshot(snapshot, sources, runner, env): + paths = [runner.canonical_relative_path(row["path"]) for row in sources["files"]] + git = ["git", "-c", "maintenance.auto=false", "-c", "gc.auto=0", + "-c", "core.autocrlf=false"] + subprocess.run([*git, "clone", "--quiet", "--shared", "--no-tags", "--no-checkout", + "--", str(ROOT), str(snapshot)], cwd=ROOT, env=env, check=True) + subprocess.run([*git, "update-ref", "--no-deref", "HEAD", INSPECTED], + cwd=snapshot, env=env, check=True) + # The pinned planner reads omitted manifests from the sparse HEAD/index. + patterns = "".join(f"/{path.as_posix()}\n" for path in paths) + subprocess.run([*git, "sparse-checkout", "set", "--no-cone", "--stdin"], + cwd=snapshot, env=env, input=patterns.encode("utf-8"), check=True) + subprocess.run([*git, "read-tree", "-mu", "HEAD"], cwd=snapshot, env=env, check=True) + for path, row in zip(paths, sources["files"], strict=True): + require(hashlib.sha256((snapshot / path).read_bytes()).hexdigest() == row["sha256"], + "historical checkout source digest changed: " + path.as_posix()) + + def entries(checker): for name, config in checker.CONFIG.items(): for entry in [config, *config.get("additional_inputs", [])]: yield name, entry -def reject(checker, entry): +def reject(root, checker, entry): try: - checker.authenticated_input(ROOT, entry) + checker.authenticated_input(root, entry) except ValueError as exc: return str(exc) raise SystemExit("historical input was admitted: " + entry["path"]) -def main(): - require(not sys.flags.optimize, "assertions must stay enabled") - checker = load_checker() +def check_snapshot(root, env): + checker = load_module(root / "scripts/replay_historical_check.py") selected = [entry for name, entry in entries(checker) if name == "tooling-ledger" and entry["path"] == SELECTED_PATH] require(len(selected) == 1, "selected-result checker overlay is not unique") @@ -94,7 +112,7 @@ def main(): require(entry["accepted_live_sha256"] == [SELECTED_ACCEPTED], "accepted selected-checker successors changed") frozen = (checker.INPUTS / entry["input"]).read_bytes() - live = (ROOT / SELECTED_PATH).read_bytes() + live = (root / SELECTED_PATH).read_bytes() require(hashlib.sha256(frozen).hexdigest() == SELECTED_PIN, "frozen selected checker bytes changed") require(hashlib.sha256(live).hexdigest() == SELECTED_LIVE, "live selected checker digest changed") require(SELECTED_LIVE not in (SELECTED_PIN, SELECTED_ACCEPTED), "live checker was already admitted") @@ -102,7 +120,7 @@ def main(): # live successor, not a broken comparison. require(SELECTED_PIN in (SELECTED_PIN, *entry["accepted_live_sha256"]), "pin membership control failed") - require(reject(checker, entry) == REJECTIONS[SELECTED_PATH][1], + require(reject(root, checker, entry) == REJECTIONS[SELECTED_PATH][1], "selected checker rejection text changed") counts = {path: 0 for path in REJECTIONS} @@ -110,7 +128,7 @@ def main(): for _name, item in entries(checker): if item["path"] not in REJECTIONS: continue - message = reject(checker, item) + message = reject(root, checker, item) counts[item["path"]] += 1 messages.setdefault(item["path"], message) for path, (count, message) in REJECTIONS.items(): @@ -118,20 +136,31 @@ def main(): require(messages[path] == message, "rejection text changed for " + path) require(sum(counts.values()) == 19, "rejection total changed") ci = [item for _name, item in entries(checker) if item["path"] == CI_PATH] - require(len(ci) == 1 and hashlib.sha256((ROOT / CI_PATH).read_bytes()).hexdigest() == CI_LIVE, + require(len(ci) == 1 and hashlib.sha256((root / CI_PATH).read_bytes()).hexdigest() == CI_LIVE, "selected CI note digest changed") diff = subprocess.check_output( - ["git", "diff", "--name-only", PARENT, INSPECTED], cwd=ROOT, text=True) + ["git", "diff", "--name-only", PARENT, INSPECTED], cwd=root, env=env, text=True) changed = sorted(name for name in diff.splitlines() if name) require(changed == CHANGED, "inspected commit diff changed") - sys.path.insert(0, str(ROOT / "scripts")) - from research_package import plan_details - details = plan_details(ROOT, set(changed)) + planner = load_module(root / "scripts/research_package.py") + details = planner.plan_details(root, set(changed)) require([row["package"] for row in details] == PLAN_PACKAGES, "helper plan selection changed") matched = {name for row in details for names in row["causes"].values() for name in names} require(sorted(set(changed) - matched) == UNMATCHED, "unmatched plan paths changed") - require(plan_details(ROOT, set()) == [], "empty change set selected a package") + require(planner.plan_details(root, set()) == [], "empty change set selected a package") + + +def main(): + require(not sys.flags.optimize, "assertions must stay enabled") + sources = json.loads(Path(__file__).with_name("SOURCES.json").read_bytes()) + require(sources["base_commit"] == INSPECTED, "historical checkout base changed") + runner = load_module(ROOT / "scripts/research_package.py") + env = runner.git_source_env() + with tempfile.TemporaryDirectory(prefix="historical-selected-replay-") as temporary: + snapshot = Path(temporary) / "snapshot" + checkout_snapshot(snapshot, sources, runner, env) + check_snapshot(snapshot, env) print("PASS_HISTORICAL_SELECTED_REPLAY_GAP") print("selected_checker_live=" + SELECTED_LIVE) print("rejections=19 distinct_paths=7 plan_packages=9")