From b80abf6285a93faee360a792942f06834f04c27a Mon Sep 17 00:00:00 2001 From: Nick Petalas Date: Wed, 11 Nov 2026 12:50:21 +0000 Subject: [PATCH 1/2] feat(research): classify square-zero tensor determinant images --- .../squarezero-tensor-characters/PROOF.md | 167 ++++++++++++++++ .../squarezero-tensor-characters/README.md | 140 ++++++++++++++ .../squarezero-tensor-characters/SOURCES.json | 24 +++ .../squarezero-tensor-characters/TASK.json | 102 ++++++++++ .../squarezero-tensor-characters/VERIFY.json | 32 ++++ .../squarezero-tensor-characters/algebra.py | 173 +++++++++++++++++ .../squarezero-tensor-characters/verify.py | 179 ++++++++++++++++++ 7 files changed, 817 insertions(+) create mode 100644 research/squarezero-tensor-characters/PROOF.md create mode 100644 research/squarezero-tensor-characters/README.md create mode 100644 research/squarezero-tensor-characters/SOURCES.json create mode 100644 research/squarezero-tensor-characters/TASK.json create mode 100644 research/squarezero-tensor-characters/VERIFY.json create mode 100644 research/squarezero-tensor-characters/algebra.py create mode 100644 research/squarezero-tensor-characters/verify.py diff --git a/research/squarezero-tensor-characters/PROOF.md b/research/squarezero-tensor-characters/PROOF.md new file mode 100644 index 0000000000..1113bd8960 --- /dev/null +++ b/research/squarezero-tensor-characters/PROOF.md @@ -0,0 +1,167 @@ +# Square-zero local multiplication tensors + +This contribution was produced by Nick Petalas. Apache-2.0. + +## Statement and conventions + +Let K=F_q, let V be a K-vector space of dimension d>=2, and set n=d+1. +Give A=K plus V the multiplication + +```text +(a,x)(b,y) = (ab, ay+bx). +``` + +Thus A is a commutative unital local algebra, its radical is J=V, and +J squared is zero. Conversely every commutative unital local K-algebra +with residue K and square-zero radical has this form: its given scalar +copy of K complements J, and all radical products vanish. Its socle is J, +of dimension d, so the d>=2 class is non-Gorenstein. + +Let t be the multiplication tensor in A* tensor A* tensor A. We use the +ordinary covariant action of GL(A*) times GL(A*) times GL(A). In chosen +dual/input and output bases these are three independent GL_n(K) factors. +Write Delta(t) for the ordered determinant image of its stabilizer, and +H_n={c^n:c in K*}. Then + +```text +Delta(t) = {(u,v,w) in (K*)^3 : uw in H_n and vw in H_n}. +``` + +If g=gcd(n,q-1), the same subgroup is defined by the two equations + +```text +(uw)^((q-1)/g) = (vw)^((q-1)/g) = 1. +``` + +It has (q-1)^3/g^2 elements. The GL_n(K)^3 orbit of t contains exactly +g^2 orbits under SL_n(K)^3. These statements hold after three independent +basis changes, because stabilizers conjugate factor by factor and +determinants are invariant under conjugation. + +This is a scoped algebraic proof. The finite verification below only +corroborates its constructions on explicitly bounded domains. + +## 1. Unit and automorphism determinants + +Use a basis (1,e_1,...,e_d) with e_i in J. Multiplication L_a by +a=(a_0,x) has matrix + +```text + [a_0 0 ] +L_a = [x a_0 I_d ]. +``` + +Therefore det(L_a)=a_0^n. The element a is a unit exactly when a_0 is +nonzero; its inverse is (a_0^-1,-a_0^-2 x). The unit determinant image is +precisely H_n. Nilpotent coordinates change no determinant. + +Every unital K-algebra automorphism fixes the scalar copy of K and +preserves the radical, since nilpotence and units are intrinsic. It is +therefore (a,x) -> (a,Px) for P in GL_d(K). Conversely every such P +preserves multiplication. Consequently Aut_K(A)=GL_d(K), with determinant +det(P) on the whole n-dimensional algebra. Its determinant map is onto +K*: the diagonal map with radical entries delta,1,...,1 attains delta. + +## 2. Normalize every autotopism + +Let F,G,H be invertible K-linear maps satisfying + +```text +F(x)G(y)=H(xy) for all x,y in A. +``` + +Put a=F(1), b=G(1). Setting one input to 1 gives H=L_b F=L_a G. +Thus L_a and L_b are invertible, and a,b are units. Define +sigma=L_(ab)^-1 H. The preceding identities give + +```text +F=L_a sigma, G=L_b sigma, H=L_(ab) sigma. +``` + +Substituting into the autotopism equation and cancelling the unit ab +shows sigma(x)sigma(y)=sigma(xy). Also sigma(1)=1, and sigma is invertible. +It is an algebra automorphism. Conversely every pair of units a,b and +every algebra automorphism sigma give an autotopism by these formulas. +This normalization is classical unital isotopy; it is included to fix the +action convention and does not rely on a predecessor's computation. + +## 3. Pass to the covariant tensor action and prove exactness + +The stabilizer triple associated to this autotopism is +(F^-T,G^-T,H). In fact its transformed bilinear map is + +```text +(x,y) -> H(F^-1(x) G^-1(y)) = xy. +``` + +Let alpha=a_0^n, beta=b_0^n, delta=det(sigma). Its ordered determinants are + +```text +u=alpha^-1 delta^-1, +v=beta^-1 delta^-1, +w=alpha beta delta. +``` + +In particular vw=alpha and uw=beta. Section 1 proves the necessity of +both nth-power restrictions. + +Conversely suppose (u,v,w) satisfies them. Choose a_0,b_0 in K* with +a_0^n=vw and b_0^n=uw. Take any radical coordinates for a,b, and choose +sigma with determinant delta=(uvw)^-1 using section 1. The displayed +formulas now give exactly u,v,w. Thus every allowed triple has an explicit +stabilizer, including nonzero radical coordinates in both unit factors. +This proves equality of the images, rather than just an upper bound. + +There is no additional restriction on uvw. For example, at q=5 and n=4, +the image is {(c,c,c^-1):c in F5*}. Its products c can be arbitrary. +Conversely a product-one triple can fail both nth-power restrictions: +(2,3,1) over F5 has product one but is excluded when n=4. + +## 4. Equations, size and special-linear orbit count + +The multiplicative group K* is cyclic of order m=q-1. Hence its nth-power +subgroup has size m/g and consists exactly of the roots of z^(m/g)=1, +where g=gcd(n,m). This proves the two equations in the statement. + +The map + +```text +(u,v,w) -> (uw,vw) +``` + +from (K*)^3 to (K*)^2 is onto and each fiber has m elements: choose w +freely and then u,v are forced. The preimage of H_n times H_n therefore +has m*(m/g)^2=m^3/g^2 elements. + +For completeness let G=GL_n(K)^3 and N=SL_n(K)^3. The componentwise +determinant map G -> (K*)^3 is surjective with kernel N, so N is normal. +The N-orbits on G/Stab(t) correspond to the cosets of +det(Stab(t)) in (K*)^3. Indeed two elements of G differ by a left element +of N and a right stabilizer precisely when their determinants differ by +an element of Delta(t). Their number is m^3/|Delta(t)|=g^2. + +This orbit count refers to ordinary linear tensor equivalence over K. +It asserts no semilinear count, physical implementation or computational +recognition algorithm for arbitrary tensors. + +## Interface, credit and scope + +Ali Romman's #5540 reconstructs commutative multiplication from arbitrary +square tensors over prime fields and leaves the recovered-algebra and +determinant-character interfaces open. It is a cited predecessor, not +replayed here. For its recovered square-zero local class, the above proof +gives the exact determinant subgroup. Given a multiplication chart, +membership of its determinant triple in Delta(t) decides whether a +general-linear equivalence can be adjusted to a special-linear one. +No extractor or transporter from an arbitrary uncharted tensor is supplied. + +Finite-field cyclicity, unital isotopy, radical invariance and the normal- +subgroup orbit argument are classical. The new contribution is their exact +assembly for this non-Gorenstein class, the two equations, attaining maps +and explicit replay. Related etale and rectangular truncated-polynomial +packages cover different algebras. Their verifiers, inventories and numerical +results are not used as steps of this proof. + +Independent human and formal proof-kernel review are unclaimed. This is no +new kappa, native caller, paid supplier, selected-frontier update or complete +multiplication theorem. diff --git a/research/squarezero-tensor-characters/README.md b/research/squarezero-tensor-characters/README.md new file mode 100644 index 0000000000..1add0991c2 --- /dev/null +++ b/research/squarezero-tensor-characters/README.md @@ -0,0 +1,140 @@ +# Exact determinant images for square-zero local tensors + +This contribution was produced by Nick Petalas. Apache-2.0. + +Scoped written algebraic proof with exact finite corroboration. Let K=F_q +and let A=K plus J be a commutative unital local K-algebra with residue K, +J squared zero, and d=dim_K J>=2. Put n=d+1 and g=gcd(n,q-1). For its +multiplication tensor in A* tensor A* tensor A, with the ordinary covariant +three-factor action, the exact stabilizer determinant image is + +```text +Delta = {(u,v,w) in (K*)^3 : uw and vw are nth powers in K*}. +``` + +Equivalently, `(uw)^((q-1)/g)=(vw)^((q-1)/g)=1`. Its order is +`(q-1)^3/g^2`, and its general-linear orbit splits into exactly `g^2` +special-linear orbits. Every allowed determinant triple has an explicit +attaining stabilizer, with arbitrary radical coordinates in its two units. + +At q=5 and n=4 the image is `{(c,c,c^-1):c in F5*}` and there are 16 +special-linear orbits. A product-one condition alone gives the wrong image. +[PROOF.md](PROOF.md) proves the statements over every finite field and all +d>=2, including characteristic two and extension fields. + +## What this adds + +Ali Romman's [PR #5540](https://github.com/CrocSwap/integer-mult-bounds/pull/5540) +reconstructs commutative multiplication from tensors over prime fields. It +leaves recovered-algebra comparison and determinant-character interfaces +open. This supplies the exact character subgroup for its non-Gorenstein +square-zero local class. The reconstruction theorem is cited, not audited. + +The etale, Frobenius-truncated and equal-cutoff rectangular determinant +packages concern different algebra classes. No scientific executable, +inventory, count or new theorem from those packages is a step of this proof. +Unital isotopy normalization, cyclicity of finite-field unit groups and the +normal-subgroup orbit argument are classical. The contribution is this exact +assembly, its two equations, constructive witnesses and bounded verifier. +Global literature priority is unclaimed. + +This changes the formal-interface-lemma card to an algebraic side result. +It does not meet that card's proof-assistant gate or discharge a selected +supplier assumption. The canonical base is +`e54523517d0f03e58352e647c403a5af3e525a57`, priority revision 8, selected +#7000 with conditional kappa .00363005817. The baseline binding check passed. +The [advance claim](https://github.com/CrocSwap/integer-mult-bounds/discussions/1166#discussioncomment-19541747) +and SOURCES.json record the source interface and provenance. + +## Exact finite evidence + +The new verifier uses only its own arithmetic and Python's standard library. +It writes no files and emits a generated JSON receipt with SHA256 hashes of +all seven package files. Checks remain active under optimized Python. + +- All 42 contexts with q in {2,3,4,5,7,8,11} and n=3,...,8. Every allowed + determinant triple has a literal full tensor-action witness: 5,448 total. + All 4,506 excluded triples reject. Independently enumerated cosets of the + attained subgroup give the claimed special-linear orbit count. +- Complete raw automorphism domains of 512, 65,536 and 19,683 matrices at + (q,n)=(2,3),(2,4),(3,3), accepting 6, 168 and 48 automorphisms. These tests + check invertibility, the unit and every basis product directly. +- A separate complete GL3(F2)^2 domain contains 28,224 input-map pairs. + The unit forces the only possible output map; exactly 96 pairs give + invertible autotopisms. Their full covariant tensor action also passes. +- All 833 elements of seven specified small algebras check the literal + multiplication determinant; 680 are units. Field checks cover 2,410 + triples. Fifteen controls reject changed tensor factors, the wrong input + action convention, omitted subgroup restrictions and invalid domains. + +The exhaustive claims apply only to these named finite domains. The +all-field and all-dimension conclusions rely on the written proof. + +## Reproduce + +From the repository root with CPython 3.12: + +```sh +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -W error -B research/squarezero-tensor-characters/verify.py +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -W error -O -B research/squarezero-tensor-characters/verify.py +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -B scripts/research_package.py --package research/squarezero-tensor-characters +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -B scripts/check_research_commit.py --package research/squarezero-tensor-characters --check-source-history --check-modes +``` + +Another machine may substitute its CPython 3.12 path. The direct marker is +`PASS_SQUAREZERO_TENSOR_CHARACTERS`; registered replay also returns +`PASS_REGISTERED_RESEARCH_PACKAGE`. The direct commands need no Git or +predecessor files. Provenance checks require the recorded repository history. + +## Limits and engineering + +There is no arbitrary-tensor recognizer, supplied-table radical extractor or +special-linear transporter implementation here. The witness builder accepts +canonical multiplication charts on the bounded field/dimension domain of +the verifier. The proof gives the image on the promised general-linear +orbit; the group-theoretic orbit count does not supply an algorithm to find +that chart. Nonsplit residue fields, higher radical products and semilinear +equivalence are outside the result. + +The code has no recursion or external processes. Matrix loops have dimension +at most eight, field loops have order at most eleven, exponentiation has at +most 64 steps, and raw matrix enumeration rejects domains larger than 70,000. +Each function is below 60 physical lines. Explicit ValueError checks cover +all mathematical verification conditions, including optimized execution. +Internal matrix helpers receive only constructed bounded fixtures. + +Power-of-Ten rule 3 has a bounded managed-runtime deviation: Python allocates +matrix rows, integers and sets during verification. The largest determinant +ambient group has 1,000 triples. Cosets partition that group; at most 1,000 +triples persist across the distinct stored cosets, with one further transient +coset of at most 1,000 entries. The full GL3(F2) list stores 168 matrices; +larger raw domains stream one matrix at a time. The lifetime ends at each +finite check. No external input can enlarge these fixtures. A future general +API must set its own resource contract. Rule 9's exception is the fixed list +of local rejection callbacks; none escapes its immediate check. Warning-strict +normal/optimized execution and AST compilation provide the available Python +diagnostics; no claim of exhaustive static analysis is made. + +There is no physical coefficient preparation, native program, dirty-state +restoration tariff, precision/tape implementation, complete paid supplier, +new kappa or selected-frontier change. No selected cold replay, Lean or Docker +run is needed for this isolated algebraic statement. Independent human and +formal proof-kernel review are unclaimed. + +## Open next questions + +1. Build a bounded supplied-table extractor for this exact class, then compose + it with #5540's recovered-table interface and an explicit special-linear + transporter. Begin with the radical and scalar-residue checks. No such + program is supplied here. +2. Determine the determinant image for square-zero local algebras with a + nonsplit residue field. Start with the determinant of the induced + semilinear radical map; the present scalar-residue calculation does not + justify dropping that contribution. +3. Find a named native producer/consumer that uses one of these equivalences, + then charge coefficient preparation, movement, precision and restoration. + An abstract special-linear orbit count supplies none of those costs. + +Credit Ali Romman for #5540 and its retained apoursh, Nick Petalas, David Ganz +and tensor/algebra reconstruction lineage. Classical algebra and finite-field +facts retain their usual credit. Predecessor source files are unchanged. diff --git a/research/squarezero-tensor-characters/SOURCES.json b/research/squarezero-tensor-characters/SOURCES.json new file mode 100644 index 0000000000..0a09b4dc6f --- /dev/null +++ b/research/squarezero-tensor-characters/SOURCES.json @@ -0,0 +1,24 @@ +{ + "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/nonreduced-tensor-recognition/README.md", + "usage": "provenance", + "git_blob": "826c6b010725d98b6ca6599a748c4179264140e9", + "sha256": "2eaed94a9f12ad7b6bb7253b14bff95b86549b3e320f0e91fa4e35c0025536de" + } + ] +} diff --git a/research/squarezero-tensor-characters/TASK.json b/research/squarezero-tensor-characters/TASK.json new file mode 100644 index 0000000000..6a90805eb7 --- /dev/null +++ b/research/squarezero-tensor-characters/TASK.json @@ -0,0 +1,102 @@ +{ + "schema_version": 1, + "task_id": "formal-interface-lemma", + "priority_revision": 8, + "base_commit": "e54523517d0f03e58352e647c403a5af3e525a57", + "original_card": { + "id": "formal-interface-lemma", + "question": "Can one uncovered interface implication be formalized with exact caller and certificate bindings?", + "starting_points": [ + "docs/research/research-family-status.md", + "certificates/selected-result.json", + "research/gate-operand-parity-lean/README.md", + "research/staged544-certified-endpoint/README.md", + "research/unconditional-batched-crt/README.md" + ], + "methods": [ + "Formalize a missing boundary lemma identified by the selected review.", + "Audit a formal theorem-to-certificate binding independently." + ], + "acceptance_gate": "State the exact formalized proposition and remaining assumptions; avoid duplicate arithmetic formalizations already present.", + "first_step": { + "command": [ + "python3", + "-B", + "scripts/research_selected_baseline.py" + ], + "expected": "PASS_RESEARCH_BASELINE_BINDINGS_ONLY", + "inspect": "Resolve the current selected review, separate complex/ordinary BIT/admitted BIT/outer budgets, and compare the card against live handoffs before starting. Historical ceilings require exact source/model equivalence.", + "scope": "Source-binding orientation only; not a scientific replay or all-size proof. Materialize selected inputs if this checkout is sparse." + }, + "first_experiment": "Write one missing statement with quantified hypotheses, actual caller and existing coverage. A compact-switch lemma is a candidate only after its mathematical contract is reviewed. Establish a bounded proof plan before a separately budgeted proof-assistant build; do not rerun large Lean jobs as orientation.", + "bottleneck_link": "A missing interface proof can reduce the conditional gap even if it does not change kappa.", + "allowed_variations": [ + "Narrow to one formal lemma or one theorem-to-certificate binding." + ], + "scope_change_triggers": [ + "Formalizing already-covered arithmetic and claiming the full multiplication theorem." + ], + "overlap_terms": [ + "hyperplane end", + "formal interface", + "Lean binding", + "3807", + "3857", + "4100", + "gate-operand-parity-lean", + "staged544-certified-endpoint", + "unconditional-batched-crt" + ], + "existing_checks": [ + { + "scope": "PR #3807: scoped gate-operand parity formalization.", + "evidence": "research/gate-operand-parity-lean/README.md", + "remaining": "Exact theorem-to-caller binding and genuinely uncovered interface lemmas.", + "status": "author-checked", + "source_commit": "4c3530f42a6abcc48e7a6bcffd6c901911dc8269", + "selected_record_sha256": "bb2eaa58647b353f88d0aec2eafb9d30df1be53589231b23e12ceef3e4bad129" + }, + { + "scope": "PR #3857: certified real-power moment/endpoint arithmetic.", + "evidence": "research/staged544-certified-endpoint/README.md", + "remaining": "Uniform algorithmic implications, not another endpoint digit.", + "status": "author-checked", + "source_commit": "ef4315b8caa605e47a2515004845eb2d2ed71a86", + "selected_record_sha256": "bb2eaa58647b353f88d0aec2eafb9d30df1be53589231b23e12ceef3e4bad129" + }, + { + "scope": "PR #4100: compact-switch formalization proposed as future validation.", + "evidence": "research/unconditional-batched-crt/README.md", + "remaining": "Audit the statement and assumptions before a formal proof campaign.", + "status": "author-checked", + "source_commit": "337d04939571a637aeab54a0f58f54fde811663a", + "selected_record_sha256": "bb2eaa58647b353f88d0aec2eafb9d30df1be53589231b23e12ceef3e4bad129" + } + ] + }, + "scope_status": "changed", + "actual_scope": "Exact covariant stabilizer determinant image and special-linear orbit count for split local multiplication tensors with radical squared zero and radical dimension at least two, over every finite field.", + "scope_change_reason": "A written algebraic side result at the recovered-table interface of Ali Romman PR5540 replaces proof-assistant work. The non-Gorenstein square-zero class is outside the etale and rectangular truncated-polynomial character results; no selected-supplier assumption is discharged.", + "bottleneck_link": "Algebraic side result: character obstructions distinguish general-linear equivalence from special-linear implementability. No native caller or complete paid saving follows.", + "budget_minutes": 60, + "stop_rule": "Stop after the exact image, explicit attaining maps and bounded finite corroboration; do not expand to higher nilpotency or physical implementation.", + "outcome": "completed", + "evidence": "PROOF.md; verify.py generates hash-bound receipts. All 42 field/dimension images, 5448 attaining maps, 4506 exclusions, three raw automorphism domains and the complete 28224-pair binary stabilizer census pass.", + "author": "Nick Petalas", + "ai_assistance": "Independent human and formal proof-kernel review are unclaimed.", + "open_questions": [ + { + "question": "Construct an exact supplied-table extractor and special-linear transporter for this class.", + "why_it_matters": "Makes the character theorem executable at the recovered-table interface.", + "first_step": "Recover the radical and scalar residue and bind one multiplication chart.", + "blocked_by": "No arbitrary-table extractor or transporter is included." + }, + { + "question": "Determine the image for nonsplit residue fields.", + "why_it_matters": "Separates the residue norm and semilinear radical determinants.", + "first_step": "Classify the determinant of the induced semilinear radical map.", + "blocked_by": "The scalar-residue proof does not cover that contribution." + } + ], + "claim_type": "scoped written algebraic proof with exact finite corroboration" +} diff --git a/research/squarezero-tensor-characters/VERIFY.json b/research/squarezero-tensor-characters/VERIFY.json new file mode 100644 index 0000000000..f38b82c8ad --- /dev/null +++ b/research/squarezero-tensor-characters/VERIFY.json @@ -0,0 +1,32 @@ +{ + "schema_version": 1, + "status": "ready", + "python": "3.12", + "requirements": [], + "inputs": [], + "commands": [ + { + "argv": [ + "{python}", + "-W", + "error", + "-B", + "{package}/verify.py" + ], + "timeout_seconds": 120, + "checks": "All-field theorem finite fixtures, exact tensor action, full small raw censuses, cosets and rejecting controls." + }, + { + "argv": [ + "{python}", + "-W", + "error", + "-O", + "-B", + "{package}/verify.py" + ], + "timeout_seconds": 120, + "checks": "Identical finite verification with optimization; explicit checks remain active." + } + ] +} diff --git a/research/squarezero-tensor-characters/algebra.py b/research/squarezero-tensor-characters/algebra.py new file mode 100644 index 0000000000..b3e6563756 --- /dev/null +++ b/research/squarezero-tensor-characters/algebra.py @@ -0,0 +1,173 @@ +"""Exact bounded arithmetic for the split radical-square-zero fixtures.""" + +from itertools import product + +FIELDS = (2, 3, 4, 5, 7, 8, 11) +MAX_DIMENSION = 8 +MAX_MATRIX_DOMAIN = 70_000 + + +def require(condition, message): + if not condition: + raise ValueError(message) + + +class Field: + """Prime fields and the fixed polynomial presentations F4 and F8.""" + + def __init__(self, order): + require(type(order) is int and order in FIELDS, "unsupported field") + self.q = order + self.modulus = {4: 0b111, 8: 0b1011}.get(order) + + def add(self, a, b): + return a ^ b if self.modulus else (a + b) % self.q + + def neg(self, a): + return a if self.modulus else -a % self.q + + def sub(self, a, b): + return self.add(a, self.neg(b)) + + def mul(self, a, b): + if not self.modulus: + return a * b % self.q + result = 0 + for _ in range(self.q.bit_length() - 1): + if b & 1: + result ^= a + b >>= 1 + a <<= 1 + if a & self.q: + a ^= self.modulus + return result + + def power(self, a, exponent): + require(0 <= exponent <= 64, "exponent exceeds fixture bound") + result = 1 + for _ in range(exponent): + result = self.mul(result, a) + return result + + def inverse(self, a): + require(a != 0, "zero has no inverse") + return self.power(a, self.q - 2) + + +def identity(n): + return [[int(i == j) for j in range(n)] for i in range(n)] + + +def determinant(matrix, field): + rows = [row[:] for row in matrix] + n = len(rows) + value = 1 + for column in range(n): + pivot = next((j for j in range(column, n) if rows[j][column]), None) + if pivot is None: + return 0 + if pivot != column: + rows[column], rows[pivot] = rows[pivot], rows[column] + value = field.neg(value) + entry = rows[column][column] + value = field.mul(value, entry) + reciprocal = field.inverse(entry) + for j in range(column + 1, n): + scale = field.mul(rows[j][column], reciprocal) + for k in range(column + 1, n): + rows[j][k] = field.sub(rows[j][k], field.mul(scale, rows[column][k])) + return value + + +def inverse(matrix, field): + n = len(matrix) + rows = [matrix[i][:] + identity(n)[i] for i in range(n)] + for column in range(n): + pivot = next((j for j in range(column, n) if rows[j][column]), None) + require(pivot is not None, "singular matrix") + rows[column], rows[pivot] = rows[pivot], rows[column] + scale = field.inverse(rows[column][column]) + rows[column] = [field.mul(scale, x) for x in rows[column]] + for j in range(n): + if j != column: + scale = rows[j][column] + rows[j] = [field.sub(x, field.mul(scale, y)) + for x, y in zip(rows[j], rows[column])] + return [row[n:] for row in rows] + + +def transpose(matrix): + return [list(row) for row in zip(*matrix)] + + +def matvec(matrix, vector, field): + result = [] + for row in matrix: + value = 0 + for a, b in zip(row, vector): + value = field.add(value, field.mul(a, b)) + result.append(value) + return result + + +def matmul(left, right, field): + return transpose([matvec(left, column, field) for column in transpose(right)]) + + +def multiply(left, right, field): + """Multiplication in F plus J, with J squared zero and e0 the unit.""" + return [field.mul(left[0], right[0])] + [ + field.add(field.mul(left[0], right[j]), field.mul(right[0], left[j])) + for j in range(1, len(left))] + + +def unit_matrix(unit, field): + return transpose([multiply(unit, column, field) for column in identity(len(unit))]) + + +def preserves_product(first, second, output, field): + n = len(first) + columns_f, columns_g = transpose(first), transpose(second) + basis = identity(n) + for i, j in product(range(n), repeat=2): + left = multiply(columns_f[i], columns_g[j], field) + if left != matvec(output, multiply(basis[i], basis[j], field), field): + return False + return True + + +def fixes_tensor(first, second, output, field): + """Literal covariant action on every coefficient of the multiplication tensor.""" + n = len(first) + basis = identity(n) + for i, j in product(range(n), repeat=2): + # The first two tensor factors act on covectors, hence these rows. + transformed = matvec(output, multiply(first[i], second[j], field), field) + if transformed != multiply(basis[i], basis[j], field): + return False + return True + + +def witness(triple, n, field): + """Construct a stabilizer with the requested allowed determinant triple.""" + require(3 <= n <= MAX_DIMENSION, "radical dimension must be at least two") + require(len(triple) == 3 and all(type(x) is int and 0 < x < field.q + for x in triple), "invalid determinant triple") + u, v, w = triple + roots = {field.power(a, n): a for a in range(1, field.q)} + aw, bw = field.mul(v, w), field.mul(u, w) + require(aw in roots and bw in roots, "outside determinant image") + a = [roots[aw]] + [(i + u) % field.q for i in range(1, n)] + b = [roots[bw]] + [(i + v + 1) % field.q for i in range(1, n)] + sigma = identity(n) + sigma[1][1] = field.inverse(field.mul(field.mul(u, v), w)) + first = matmul(unit_matrix(a, field), sigma, field) + second = matmul(unit_matrix(b, field), sigma, field) + output = matmul(unit_matrix(multiply(a, b, field), field), sigma, field) + return transpose(inverse(first, field)), transpose(inverse(second, field)), output + + +def all_matrices(n, field): + require(field.q ** (n * n) <= MAX_MATRIX_DOMAIN, "matrix census exceeds cap") + for entries in product(range(field.q), repeat=n * n): + yield [list(entries[n * i:n * (i + 1)]) for i in range(n)] diff --git a/research/squarezero-tensor-characters/verify.py b/research/squarezero-tensor-characters/verify.py new file mode 100644 index 0000000000..ecc2ac91a0 --- /dev/null +++ b/research/squarezero-tensor-characters/verify.py @@ -0,0 +1,179 @@ +"""Finite corroboration of the new square-zero tensor determinant theorem.""" + +import hashlib +from itertools import product +import json +from math import gcd +from pathlib import Path +import platform + +from algebra import (FIELDS, Field, all_matrices, determinant, fixes_tensor, + identity, inverse, matmul, preserves_product, require, + transpose, unit_matrix, witness) + + +def field_checks(): + cases = 0 + for q in FIELDS: + f = Field(q) + for a, b, c in product(range(q), repeat=3): + require(f.mul(a, f.add(b, c)) == f.add(f.mul(a, b), f.mul(a, c)), + "distributivity") + require(f.mul(f.mul(a, b), c) == f.mul(a, f.mul(b, c)), "associativity") + cases += 1 + for a in range(1, q): + require(f.mul(a, f.inverse(a)) == 1, "inverse law") + return cases + + +def rejects(operation): + try: + operation() + except ValueError: + return 1 + raise ValueError("invalid operation was accepted") + + +def image_checks(): + reports = [] + for q, n in product(FIELDS, range(3, 9)): + f = Field(q) + powers = {f.power(a, n) for a in range(1, q)} + actual, equations = set(), set() + rejected = 0 + exponent = (q - 1) // gcd(n, q - 1) + for triple in product(range(1, q), repeat=3): + u, v, w = triple + allowed = f.mul(v, w) in powers and f.mul(u, w) in powers + if (f.power(f.mul(v, w), exponent) == 1 + and f.power(f.mul(u, w), exponent) == 1): + equations.add(triple) + if not allowed: + rejected += rejects(lambda: witness(triple, n, f)) + continue + matrices = witness(triple, n, f) + require(tuple(determinant(m, f) for m in matrices) == triple, + "wrong attaining determinant") + require(fixes_tensor(*matrices, f), "literal tensor action failed") + actual.add(triple) + require(actual == equations, "equations disagree with constructed image") + require(len(actual) * gcd(n, q - 1) ** 2 == (q - 1) ** 3, "image order") + ambient = set(product(range(1, q), repeat=3)) + orbits = set() + for c in ambient: + coset = frozenset(tuple(f.mul(a, b) for a, b in zip(c, d)) for d in actual) + orbits.add(coset) + require(len(orbits) == gcd(n, q - 1) ** 2, "SL orbit index") + reports.append(dict(q=q, dimension=n, attained=len(actual), rejected=rejected, + special_linear_orbits=len(orbits))) + return reports + + +def automorphism_census(q, n): + """All raw square matrices, tested by unit, inverse and basis products.""" + f = Field(q) + tested = invertible = accepted = 0 + determinants = set() + for matrix in all_matrices(n, f): + tested += 1 + det = determinant(matrix, f) + if not det: + continue + invertible += 1 + if transpose(matrix)[0] != identity(n)[0]: + continue + if preserves_product(matrix, matrix, matrix, f): + accepted += 1 + determinants.add(det) + expected = 1 + d = n - 1 + for i in range(d): + expected *= q ** d - q ** i + require(accepted == expected, "raw automorphism census order") + require(determinants == set(range(1, q)), "automorphism determinant image") + return dict(q=q, dimension=n, raw_matrices=tested, invertible=invertible, + automorphisms=accepted) + + +def stabilizer_census(): + """Full GL3(F2)^2 search; the output map is forced by the unit.""" + f, n = Field(2), 3 + invertibles = [m for m in all_matrices(n, f) if determinant(m, f)] + tested = accepted = 0 + determinants = set() + for first, second in product(invertibles, repeat=2): + tested += 1 + b = transpose(second)[0] + output = matmul(unit_matrix(b, f), first, f) + if not determinant(output, f) or not preserves_product(first, second, output, f): + continue + accepted += 1 + covariant = (transpose(inverse(first, f)), transpose(inverse(second, f)), output) + require(fixes_tensor(*covariant, f), "raw isotopy/covariant conversion") + determinants.add(tuple(determinant(m, f) for m in covariant)) + require(accepted == 96 and determinants == {(1, 1, 1)}, "full stabilizer census") + return dict(q=2, dimension=3, input_map_pairs=tested, stabilizers=accepted) + + +def norm_census(): + reports = [] + for q, n in ((2, 3), (2, 4), (3, 3), (3, 4), (4, 3), (5, 3), (8, 3)): + f = Field(q) + units = 0 + image = set() + for a in product(range(q), repeat=n): + det = determinant(unit_matrix(a, f), f) + require(det == f.power(a[0], n), "literal unit multiplication determinant") + if a[0]: + units += 1 + image.add(det) + require(image == {f.power(a, n) for a in range(1, q)}, "norm image") + reports.append(dict(q=q, dimension=n, elements=q ** n, units=units, + norm_image=sorted(image))) + return reports + + +def controls(): + f, n = Field(5), 4 + base = witness((2, 2, 3), n, f) + require(fixes_tensor(*base, f), "control fixture invalid") + detected = 0 + for factor in range(3): + changed = [[row[:] for row in matrix] for matrix in base] + changed[factor][0][0] = f.add(changed[factor][0][0], 1) + require(not fixes_tensor(*changed, f), "factor mutation was undetected") + detected += 1 + raw_inputs = (transpose(inverse(base[0], f)), transpose(inverse(base[1], f)), base[2]) + require(not fixes_tensor(*raw_inputs, f), "raw autotopism input convention accepted") + detected += 1 + for operation in (lambda: Field(6), lambda: Field(True), + lambda: witness((0, 1, 1), n, f), + lambda: witness((1, 1, 1), 2, f), + lambda: witness((1, 2, 1), n, f), + lambda: inverse([[1, 0], [0, 0]], f), + lambda: list(all_matrices(5, Field(2))), + lambda: f.power(1, 65)): + detected += rejects(operation) + # Both restrictions are needed; product-one alone is insufficient. + for triple in ((1, 2, 1), (2, 1, 1), (2, 3, 1)): + detected += rejects(lambda: witness(triple, n, f)) + return detected + + +def main(): + result = dict(status="PASS_SQUAREZERO_TENSOR_CHARACTERS", + python=platform.python_version(), field_triples=field_checks(), + images=image_checks(), norms=norm_census(), + automorphisms=[automorphism_census(q, n) + for q, n in ((2, 3), (2, 4), (3, 3))], + stabilizer=stabilizer_census(), controls=controls()) + root = Path(__file__).resolve().parent + names = ("README.md", "PROOF.md", "TASK.json", "SOURCES.json", "VERIFY.json", + "algebra.py", "verify.py") + result["sha256"] = {name: hashlib.sha256((root / name).read_bytes()).hexdigest() + for name in names} + print(json.dumps(result, sort_keys=True)) + + +if __name__ == "__main__": + main() From d9407ed33a9551a7c9d73e8a72188c88078fe360 Mon Sep 17 00:00:00 2001 From: Nick Petalas Date: Tue, 17 Nov 2026 22:36:07 +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")