From 0a49cfa436fc2ad9cd8fffa84ebb35fb376b06a1 Mon Sep 17 00:00:00 2001 From: Nick Petalas Date: Thu, 12 Nov 2026 18:27:45 +0000 Subject: [PATCH 1/2] feat(research): prove robust coordinate-pairing capacity --- research/robust-coordinate-pairing/PROOF.md | 128 +++++++ research/robust-coordinate-pairing/README.md | 146 ++++++++ .../robust-coordinate-pairing/SOURCES.json | 18 + research/robust-coordinate-pairing/TASK.json | 104 ++++++ .../robust-coordinate-pairing/VERIFY.json | 34 ++ research/robust-coordinate-pairing/verify.py | 313 ++++++++++++++++++ 6 files changed, 743 insertions(+) create mode 100644 research/robust-coordinate-pairing/PROOF.md create mode 100644 research/robust-coordinate-pairing/README.md create mode 100644 research/robust-coordinate-pairing/SOURCES.json create mode 100644 research/robust-coordinate-pairing/TASK.json create mode 100644 research/robust-coordinate-pairing/VERIFY.json create mode 100644 research/robust-coordinate-pairing/verify.py diff --git a/research/robust-coordinate-pairing/PROOF.md b/research/robust-coordinate-pairing/PROOF.md new file mode 100644 index 0000000000..b9d112078c --- /dev/null +++ b/research/robust-coordinate-pairing/PROOF.md @@ -0,0 +1,128 @@ +# Exact common pairings under coordinate uncertainty + +This contribution was produced by Nick Petalas. Apache-2.0. + +Claim type: scoped written algebraic proof with exact finite corroboration. +The argument uses classical matrix rank, rank factorization and outer products. +No claim of general literature priority is made for those tools. + +## 1. Contract and theorem + +Let F be any field, B an m by n matrix over F, and E a subset of +{1,...,m} times {1,...,n}. The uncertainty family is + + B(t) = B + sum_{(i,j) in E} t_ij e_i e_j^T, t_ij in F. + +For r >= 0, a common identity pairing consists of fixed matrices X of size +r by m and Y of size n by r such that + + X B(t) Y = I_r (1) + +for every parameter choice. X and Y cannot depend on t. Empty matrices give +the r=0 convention. Write B[A,C] for the submatrix with row set A and column +set C. A rectangle A times C is clean when it is disjoint from E. + +**Theorem.** The largest r satisfying (1) is exactly + + c(B,E) = max_{A,C: (A times C) intersect E = empty} rank B[A,C]. (2) + +Empty rectangles have rank zero. The same answer holds if (1) is requested +only for the nominal B and the single-entry alternatives B+e_i e_j^T, one +for each (i,j) in E. No large or infinite field hypothesis is needed. + +**Upper bound.** Subtract the nominal equation from each single-entry +alternative. For every (i,j) in E this gives + + (X e_i)(e_j^T Y) = 0. (3) + +An outer product over a field is zero only if one factor is zero. Let A be +the indices of nonzero columns of X and C the indices of nonzero rows of Y. +Equation (3) says that A times C is clean. Consequently + + r = rank(X B Y) = rank(X[:,A] B[A,C] Y[C,:]) + <= rank B[A,C] <= c(B,E). + +**Attainment.** A rank-d clean submatrix has a nonsingular d by d minor +B[A',C']=M. Let S select rows A' and let T embed into coordinates C', in the +corresponding orders. Then X=M^{-1}S and Y=T satisfy XBY=I_d. For every +(i,j) in E, either i is outside A' or j is outside C'. Thus Xe_i e_j^T Y=0, +so the same X,Y satisfy (1). Restricting this identity pairing attains every +r<=d. For d=0 use empty matrices. This proves (2). + +Necessity used only the nominal and single-entry alternatives. Sufficiency +uses linearity. This proves the assertion for the smaller finite family too. +The finite oracle directly enumerates the single-entry alternatives; it does +not assume the outer-product factorization when computing its answer. + +## 2. Identity nominal pairing and its error graph + +For B=I_n, construct a graph on n coordinates. An error (i,j) forbids an +independent set from containing both i and j. A loop (i,i) forbids i itself. +Direction has no effect on independence; one directed edge suffices. + +**Corollary.** c(I_n,E) equals the independence number alpha(E), with this +loop convention. Arbitrary dense X,Y cannot improve on coordinate selection. + +Indeed rank I_n[A,C]=|A intersect C|. If A times C is clean, A intersect C is +independent, so (2) is at most alpha(E). Conversely an independent set S gives +the clean rectangle S times S, with submatrix I_|S|. Coordinate selection +therefore attains alpha(E) over every field. + +For the directed cycle E={(1,2),(2,3),...,(n-1,n),(n,1)}, n>=3, the sharp +value is floor(n/2). Summing the n inequalities +1_S(i)+1_S(i+1)<=1 gives 2|S|<=n, and alternating vertices attain the bound. +In particular the five-cycle admits exactly two common channels. Yet each +individual alternative I_n+e_i e_j^T in this cycle is invertible, with inverse +I_n-e_i e_j^T since i!=j. Thus the loss already occurs for a finite family of +n+1 entirely invertible maps. It is not caused by including a singular +simultaneous perturbation. + +Replacing each single-entry alternative by B+a_ij e_i e_j^T, for any nonzero +fixed a_ij, leaves the answer unchanged. Divide (3) by a_ij for necessity. +Arbitrarily small nonzero errors over R or C therefore have the same exact +obstruction. Approximate output contracts require a different theorem. + +## 3. Boundary witnesses + +Independent coordinate uncertainty cannot be replaced by support alone when +coefficients are correlated. Over Q, put + + B = I_3, + D = [[0,1,1],[-1,0,1],[-1,-1,0]], + Y = [[1,1],[-1,0],[1,0]], + X = [[0,-1/2,1/2],[1,1/2,-1/2]]. + +Direct multiplication gives XY=I_2 and XDY=0, hence X(I_3+tD)Y=I_2 for +every t. The nonzero-entry support of D is the complete loopless graph, +whose independent-coordinate capacity is only one. Correlation changes the +uncertainty space and escapes the theorem. This is a boundary witness. + +The identity-graph corollary also cannot replace (2) for arbitrary B. For +B=[[0,1],[1,0]] with uncertain diagonal entries, the graph has a loop on +every vertex. Nevertheless X=[1,0] and Y=[0,1]^T give one common channel. +Formula (2) finds the clean off-diagonal minor and gives exactly one. + +## 4. Helper relevance and limitations + +The new premise requires a proposed helper interface to use the same two +linear maps for the nominal pairing and specified coordinate alternatives. +Equation (1) is necessary for every stronger interface requiring that +identity block. Formula (2) exactly solves this optimistic algebraic +relaxation. A failed capacity test excludes that common-pairing contract. +No selected supplier is asserted to have this uncertainty family. + +For square B, every solution of positive size has full row rank X and full +column rank Y, since XBY=I_r. They extend to separate invertible output and +input bases over F. This does not force either off-diagonal block of the +transformed B(t) to vanish. Arbitrary dirty spectator independence, +restoration, chronological delivery and invertible dyadic completion require +additional conditions. Extra workspace, adaptive bases, correlated errors, +nonlinear decoders, approximate recovery and coefficients in rings with zero +divisors are outside this statement. Over rings, (3) need not kill a factor. + +No producer, native word, scalar schedule, paid/target histogram, precision +policy, physical hosting, storage or tape implementation is supplied. Their +costs are unknown and are not zero. This side result changes no selected +frontier and proves no complete multiplication theorem. All five selected +framework assumptions remain. The universal statement rests on the written +proof. Independent human and formal proof-kernel review are unclaimed. diff --git a/research/robust-coordinate-pairing/README.md b/research/robust-coordinate-pairing/README.md new file mode 100644 index 0000000000..d35f9f3cd0 --- /dev/null +++ b/research/robust-coordinate-pairing/README.md @@ -0,0 +1,146 @@ +# Exact helper-pairing capacity under coordinate uncertainty + +This contribution was produced by Nick Petalas. Apache-2.0. +Claim type: scoped written algebraic proof with exact finite corroboration. +No new kappa is claimed. + +For any field, nominal matrix B and set E of independently uncertain entries, +the largest identity block recoverable by one fixed left/right pairing is + +```text +max { r : X (B + sum_E t_ij E_ij) Y = I_r for every t } + = max { rank B[A,C] : the rectangle A times C contains no entry of E }. +``` + +The theorem grants arbitrary dense field-valued X,Y. It supplies attaining +maps from a clean nonsingular minor. Testing just the nominal map and each +single-entry alternative gives the same capacity as the entire uncertainty +family. The proof works over small fields as well as R or C. + +For B=I, the capacity is exactly the independence number of the directed +error-support graph; loops forbid their vertices. Dense mixing gives no gain +over selecting independent coordinates. A directed n-cycle has sharp capacity +floor(n/2), even though the nominal and every single-entry alternative are +invertible. Five such uncertain entries therefore reduce five pointwise +recoverable channels to exactly two common channels. [PROOF.md](PROOF.md) +gives the quantified statements, proof and explicit boundary witnesses. + +This is an original contract obstruction for the optimistic identity-pairing +relaxation. It can reject a common helper contract when its uncertain pairing +has too little capacity. No selected supplier is asserted to have that +uncertainty model, and passing this test supplies no physical implementation. + +## Reproduce + +From the repository root with CPython 3.12 and the standard library: + +```sh +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -I -W error -B research/robust-coordinate-pairing/verify.py +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -I -O -W error -B research/robust-coordinate-pairing/verify.py +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -B scripts/research_package.py --package research/robust-coordinate-pairing +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -B scripts/check_research_commit.py --package research/robust-coordinate-pairing --check-source-history +``` + +Substitute another absolute CPython 3.12 path elsewhere. Direct replay prints +`PASS_ROBUST_COORDINATE_PAIRING` in a generated JSON receipt bound to the six +package files by SHA256. It writes nothing and needs no Git, network, solver +or predecessor executable. Normal and optimized modes enforce the same checks. + +The exhaustive oracle considers every left/right matrix, not just coordinate +selectors. It compares the exact maximum against the clean-rectangle formula +on 10,266 support cases from 231 nominal matrices, examining 943,861 sandwiches +and finding 7,869 nominal identity sandwiches. The nominal domains are all +1-by-1 and 2-by-2 matrices over F2 and F3, all 2-by-3 and 3-by-2 matrices over +F2, and I3 over F2. Every possible uncertainty support is included in each +case. All 8,400 positive-capacity cases also receive a constructed attaining +pairing, checked against the nominal and every permitted single-entry change. + +Additional checks cover all 530 directed graphs with loops on one through +three vertices; fifteen cycle instances of lengths three through five over +Q, F2, F3, F5 and F7; and 112 rational nominal/support cases. Eight boundary +equalities and four rejecting omitted-error controls distinguish independent +uncertainty, correlated uncertainty, the identity nominal assumption, empty +and full uncertainty, singular nominal matrices and exact recovery. + +These are finite corroborations of the written theorem. They do not exhaust +all fields or dimensions and are not a proof-kernel certificate. + +## Scope, provenance and credit + +The complex-new-helper-inventory card changes scope to a common-pairing +interface lemma. This settles an explicitly changed algebraic premise rather +than delivering the card's physical supplier or complete signed moment. Work +stopped at the first proved result. The [advance CLAIM](https://github.com/CrocSwap/integer-mult-bounds/discussions/1166#discussioncomment-19571898) +records the question before the proof and exhaustive computation. + +The base is canonical main e54523517d0f03e58352e647c403a5af3e525a57, priority +revision 8. The selected record gives conditional kappa 0.00363005817 and +`make frontier7000-verify`; the older priority prose describes an earlier +checkpoint. The selected binding-only orientation passed. The selected +scientific construction was not replayed. SOURCES pins the selected record +and original card as historical provenance; there are no live source inputs. + +The proof builds on classical rank inequalities, nonsingular minors and the +zero-outer-product property over fields. No contributor construction, word, +identity, invoice or numerical result is used as a premise. Ali Romman's +[#5615](https://github.com/CrocSwap/integer-mult-bounds/pull/5615) supplies the +surrounding dyadic helper-pairing context. Nick Petalas's +[#7269](https://github.com/CrocSwap/integer-mult-bounds/pull/7269) concerns odd +denominator budgets for a fixed pairing; his +[#6585](https://github.com/CrocSwap/integer-mult-bounds/pull/6585) requires +common-chart isolation with both cross blocks zero. Those results are +background and are neither extended nor audited here. No general literature +priority is claimed for elementary rank-factorization methods. + +Live open/account PR lists, recent handoff comments, active Discussions, +local reservations, the cached card search, targeted merged/open PR searches +and direct main-tree formula/object searches were inspected. Their text +coverage does not prove novelty or cover all diffs and unpublished work. + +## Limitations + +Only the retained identity block is constrained. Both spectator cross blocks, +arbitrary dirty restoration, chronology, extra workspace, adaptive charts, +correlated errors, approximation and coefficients in rings with zero divisors +require different arguments. Field-valued attaining maps need not be dyadic. +No actual cut, producer, consumer, scalar schedule, native realization, +precision/storage policy, physical hosting, paid/target invoice or complete +multiplication theorem is supplied. All five selected framework assumptions +remain. Independent human and formal proof-kernel review are unclaimed. +Lean, Docker and the selected scientific cold replay are unrun. + +## Open next questions + +- Does one actual helper cut require common pairings across a specified + independently varying coordinate family? Bind the producer's alternatives + and permitted charts first. Without that contract, this theorem does not + exclude the cut or imply a new supplier cost. +- What is the capacity for a supplied correlated error space? Begin with two + specified error generators. The skew-symmetric boundary witness shows why + replacing the space by the union of its entry supports can lose channels. + Physical delivery and complete invoices remain separate obligations. + +## Implementation bounds + +Build the Lever led to the rerunnable verifier. Prove It Works led to the +complete small-field sandwich oracle and explicit attaining maps. The +engineering playbook is autonomous local run, with a stop at the first proved +result. No shared code or frozen predecessor package is changed. + +All functions are below 60 physical lines. There is no recursion, subprocess, +network or dynamic code execution. The verifier has no external mathematical +input. Matrix dimensions are at most five; field enumerations store at most +512 matrices with nine entries each, and support tables have at most 512 +entries. Each exhaustive loop is bounded by these fixed finite domains. +The five-dimensional cycle check considers at most 1,024 rectangles. Explicit +exceptions retain mathematical checks under optimized execution. + +Power of Ten rule 3 has a managed-runtime deviation in verify.py: CPython +allocates bounded tuples, lists, integers and Fractions during this offline +calculation. The finite domains above bound live state; no fixed-pool or +steady-service claim is made. A fixed-storage implementation would need a +separate port. Rule 9 uses one fixed local sorting key for a finite rectangle +list and ordinary standard-library iterators; there is no user-supplied call +target. Warning-strict normal/optimized replay and in-memory compilation are +the available interpreter diagnostics. No separate static type analysis is +claimed. No production implementation is admitted by these checks. diff --git a/research/robust-coordinate-pairing/SOURCES.json b/research/robust-coordinate-pairing/SOURCES.json new file mode 100644 index 0000000000..5335fa97d9 --- /dev/null +++ b/research/robust-coordinate-pairing/SOURCES.json @@ -0,0 +1,18 @@ +{ + "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" + } + ] +} diff --git a/research/robust-coordinate-pairing/TASK.json b/research/robust-coordinate-pairing/TASK.json new file mode 100644 index 0000000000..bcdaa9aeeb --- /dev/null +++ b/research/robust-coordinate-pairing/TASK.json @@ -0,0 +1,104 @@ +{ + "schema_version": 1, + "task_id": "complex-new-helper-inventory", + "priority_revision": 8, + "base_commit": "e54523517d0f03e58352e647c403a5af3e525a57", + "original_card": { + "id": "complex-new-helper-inventory", + "question": "Can a changed helper inventory earn productive credit that survives completion, compilation and the 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": "A source-bound arbitrary-input identity and legal producer/consumer boundary with the complete paid and productive target invoice, including restoration, ownership, native alignment and extra charges. Price under the actual current model; historical ceiling.py assumptions must be established before use. A favorable optimistic relaxation keeps a route open but is not a completed supplier. A scoped local result remains useful; expansion requires the family-level budget gate.", + "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": "Specify all arbitrary inputs, owned fields, restored outputs and a physically legal consumer. Compare complete P and T, including target debits and precision/stock costs. #5599 is a positive control for target refinement, not permission to split every helper for free. #5614 is a hypothetical compiler budget, not an emitted 145-split word. Stop at the first unpaid boundary or a failing optimistic full bill.", + "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": [ + "productive helper", + "target refinement", + "5599", + "5614" + ], + "existing_checks": [ + { + "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 all-field common identity-pairing capacity under independent coordinate uncertainty, with sharp clean-submatrix and identity-graph formulas.", + "scope_change_reason": "Replace a physical helper inventory search by an original algebraic obstruction for one explicit changed common-pairing contract. No supplier or full signed invoice is delivered.", + "bottleneck_link": "Side result: a necessary identity-block capacity test for a proposed robust common helper interface. No selected supplier is asserted to require this uncertainty model; physical realization and complete costs remain unknown.", + "budget_minutes": 60, + "stop_rule": "Stop at the first proved exact capacity theorem with finite independent-algorithm corroboration; package it without extending to correlated errors or actual supplier searches.", + "outcome": "completed", + "evidence": "PROOF.md; verify.py: 10266 exhaustive nominal/support cases, 943861 sandwiches, 8400 attaining pairings, 530 graph cases, 15 cycle instances, 112 rational cases and four rejecting controls.", + "author": "Nick Petalas", + "ai_assistance": "Independent human and formal proof-kernel review are unclaimed.", + "open_questions": [ + { + "question": "Does an actual helper cut require this independent-coordinate common-pairing contract?", + "why_it_matters": "Only a source-bound contract allows applying the obstruction to a physical supplier.", + "first_step": "Pin its nominal matrix, exact alternatives and permitted charts.", + "blocked_by": "No actual producer or consumer has been assigned this uncertainty law." + }, + { + "question": "What is the capacity for two specified correlated error generators?", + "why_it_matters": "The skew example proves a union-of-supports replacement can undercount channels.", + "first_step": "Specify two matrices and solve their common sandwich equations.", + "blocked_by": "Independent-entry factorization does not apply; physical cost remains separate." + } + ], + "claim_type": "scoped written algebraic proof with exact finite corroboration", + "claim_url": "https://github.com/CrocSwap/integer-mult-bounds/discussions/1166#discussioncomment-19571898", + "selected_orientation": "PASS_RESEARCH_BASELINE_BINDINGS_ONLY; selected kappa 0.00363005817; no selected scientific replay", + "engineering_playbook": "autonomous-run", + "environment": { + "interpreter": "/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12", + "version": "3.12.15 (main, Oct 14 2026, 00:55:37) [Clang 23.1.3 ]", + "platform": "macOS-27.0.1-arm64-arm-64bit", + "dependencies": "standard library only" + }, + "overlap": { + "open_pr_bodies": 760, + "discussion_records": 7345, + "remote_pagination_complete": true, + "open_pr_timestamp": "2026-11-12T18:19:39.779475+00:00", + "discussion_timestamp": "2026-11-12T18:21:50.339330+00:00", + "supplements": "Live handoffs and claims, main-tree distinctive formula/object terms, targeted all-state and merged PR searches; refreshed before commit. No exhaustive diff or unpublished-work coverage." + }, + "upstream_checkpoint": { + "commit": "e54523517d0f03e58352e647c403a5af3e525a57", + "priority_revision": 8, + "checked_utc": "2026-11-12T18:27:22.867837+00:00", + "changed_since_start": false + } +} diff --git a/research/robust-coordinate-pairing/VERIFY.json b/research/robust-coordinate-pairing/VERIFY.json new file mode 100644 index 0000000000..f9611a2bdb --- /dev/null +++ b/research/robust-coordinate-pairing/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": "Exhaustive literal sandwiches against clean-rectangle capacity, attaining maps, graph and rational cases, and hypothesis controls." + }, + { + "argv": [ + "{python}", + "-I", + "-O", + "-W", + "error", + "-B", + "{package}/verify.py" + ], + "timeout_seconds": 120, + "checks": "The same exact mathematical checks with optimized execution; exceptions remain active." + } + ] +} diff --git a/research/robust-coordinate-pairing/verify.py b/research/robust-coordinate-pairing/verify.py new file mode 100644 index 0000000000..962ad62bbb --- /dev/null +++ b/research/robust-coordinate-pairing/verify.py @@ -0,0 +1,313 @@ +#!/usr/bin/env python3 +"""Exact clean-rectangle predictions versus complete small-field sandwiches.""" + +from fractions import Fraction +from hashlib import sha256 +from itertools import combinations, product +import json +from pathlib import Path + + +def need(condition, message): + if not condition: + raise ValueError(message) + + +def norm(value, prime): + return value % prime if prime else Fraction(value) + + +def eye(size): + return tuple(tuple(int(i == j) for j in range(size)) for i in range(size)) + + +def matrices(rows, columns, prime): + need(1 <= rows <= 3 and 1 <= columns <= 3, "enumeration shape") + need(prime in (2, 3) and prime ** (rows * columns) <= 512, "enumeration cap") + return tuple(tuple(tuple(flat[i * columns:(i + 1) * columns]) + for i in range(rows)) + for flat in product(range(prime), repeat=rows * columns)) + + +def multiply(left, right, prime): + need(left and right and len(left[0]) == len(right), "product shape") + need(max(len(left), len(right), len(right[0])) <= 5, "matrix cap") + return tuple(tuple(norm(sum(left[i][k] * right[k][j] + for k in range(len(right))), prime) + for j in range(len(right[0]))) + for i in range(len(left))) + + +def rank(matrix, prime): + if not matrix or not matrix[0]: + return 0 + work = [list(row) for row in matrix] + rows, columns = len(work), len(work[0]) + need(rows <= 5 and columns <= 5, "rank shape cap") + pivot = 0 + for column in range(columns): + candidates = [i for i in range(pivot, rows) if work[i][column]] + if not candidates: + continue + chosen = candidates[0] + work[pivot], work[chosen] = work[chosen], work[pivot] + value = work[pivot][column] + reciprocal = pow(value, -1, prime) if prime else 1 / Fraction(value) + work[pivot] = [norm(x * reciprocal, prime) for x in work[pivot]] + for i in range(rows): + if i != pivot: + factor = work[i][column] + work[i] = [norm(a - factor * b, prime) + for a, b in zip(work[i], work[pivot], strict=True)] + pivot += 1 + if pivot == rows: + break + return pivot + + +def inverse(matrix, prime): + size = len(matrix) + need(1 <= size <= 5 and all(len(row) == size for row in matrix), "inverse shape") + work = [list(row) + list(unit) + for row, unit in zip(matrix, eye(size), strict=True)] + for column in range(size): + candidates = [i for i in range(column, size) if work[i][column]] + need(candidates, "singular minor") + chosen = candidates[0] + work[column], work[chosen] = work[chosen], work[column] + value = work[column][column] + reciprocal = pow(value, -1, prime) if prime else 1 / Fraction(value) + work[column] = [norm(x * reciprocal, prime) for x in work[column]] + for i in range(size): + if i != column: + factor = work[i][column] + work[i] = [norm(a - factor * b, prime) + for a, b in zip(work[i], work[column], strict=True)] + result = tuple(tuple(row[size:]) for row in work) + need(multiply(matrix, result, prime) == eye(size), "inverse endpoint") + return result + + +def submatrix(matrix, rows, columns): + return tuple(tuple(matrix[i][j] for j in columns) for i in rows) + + +def rectangles(matrix, prime): + rows, columns = len(matrix), len(matrix[0]) + need(1 <= rows <= 5 and 1 <= columns <= 5, "rectangle cap") + records = [] + for row_mask in range(1 << rows): + chosen_rows = tuple(i for i in range(rows) if row_mask >> i & 1) + for column_mask in range(1 << columns): + chosen_columns = tuple(j for j in range(columns) if column_mask >> j & 1) + mask = sum(1 << (i * columns + j) + for i in chosen_rows for j in chosen_columns) + dimension = rank(submatrix(matrix, chosen_rows, chosen_columns), prime) + records.append((dimension, mask, chosen_rows, chosen_columns)) + return tuple(records) + + +def prediction(records, errors): + return max((row for row in records if not row[1] & errors), key=lambda row: row[0]) + + +def witness(matrix, record, prime): + dimension, _, rows, columns = record + if dimension == 0: + return (), tuple(() for _ in matrix[0]) + for chosen_rows in combinations(rows, dimension): + for chosen_columns in combinations(columns, dimension): + minor = submatrix(matrix, chosen_rows, chosen_columns) + if rank(minor, prime) != dimension: + continue + inv = inverse(minor, prime) + left = tuple(tuple(inv[a][chosen_rows.index(i)] if i in chosen_rows else 0 + for i in range(len(matrix))) + for a in range(dimension)) + right = tuple(tuple(int(j == chosen_columns[b]) for b in range(dimension)) + for j in range(len(matrix[0]))) + return left, right + raise ValueError("missing full-rank minor") + + +def changed(matrix, index, prime): + columns = len(matrix[0]) + return tuple(tuple(norm(value + int(i * columns + j == index), prime) + for j, value in enumerate(row)) + for i, row in enumerate(matrix)) + + +def check_pairing(matrix, left, right, errors, prime): + if not left: + return + dimension = len(left) + need(multiply(multiply(left, matrix, prime), right, prime) == eye(dimension), + "nominal pairing") + for index in range(len(matrix) * len(matrix[0])): + if errors >> index & 1: + alternative = changed(matrix, index, prime) + need(multiply(multiply(left, alternative, prime), right, prime) == eye(dimension), + "single-entry pairing") + + +def literal_sandwich(left, middle_right, prime): + """Separate oracle arithmetic: reject at the first nonidentity entry.""" + size = len(left) + for a in range(size): + for b in range(size): + value = 0 + for k in range(len(middle_right)): + value += left[a][k] * middle_right[k][b] + if value % prime != int(a == b): + return False + return True + + +def oracle(matrix, prime): + """Enumerate every X,Y; directly test every single-entry alternative.""" + rows, columns = len(matrix), len(matrix[0]) + capacities = [0] * (1 << (rows * columns)) + accepted, examined = 0, 0 + alternatives = tuple(changed(matrix, index, prime) for index in range(rows * columns)) + for dimension in range(1, min(rows, columns) + 1): + all_right = matrices(columns, dimension, prime) + right_products = tuple(multiply(matrix, right, prime) for right in all_right) + for left in matrices(dimension, rows, prime): + for right, middle_right in zip(all_right, right_products, strict=True): + examined += 1 + if not literal_sandwich(left, middle_right, prime): + continue + accepted += 1 + legal = 0 + for index, alternative in enumerate(alternatives): + alt_product = multiply(alternative, right, prime) + if literal_sandwich(left, alt_product, prime): + legal |= 1 << index + for errors in range(1 << (rows * columns)): + if not errors & ~legal: + capacities[errors] = max(capacities[errors], dimension) + return capacities, accepted, examined + + +def exhaustive_families(): + digest = sha256() + counts = {"nominal_matrices": 0, "support_cases": 0, "sandwiches_examined": 0, + "nominal_identity_sandwiches": 0, "attaining_pairings": 0} + domains = ((1, 1, 2), (1, 1, 3), (2, 2, 2), (2, 2, 3), + (2, 3, 2), (3, 2, 2), (3, 3, 2)) + for rows, columns, prime in domains: + samples = (eye(3),) if rows == columns == 3 else matrices(rows, columns, prime) + for matrix in samples: + capacities, accepted, examined = oracle(matrix, prime) + records = rectangles(matrix, prime) + counts["nominal_matrices"] += 1 + counts["sandwiches_examined"] += examined + counts["nominal_identity_sandwiches"] += accepted + for errors, capacity in enumerate(capacities): + record = prediction(records, errors) + need(record[0] == capacity, "rectangle/oracle disagreement") + left, right = witness(matrix, record, prime) + check_pairing(matrix, left, right, errors, prime) + counts["attaining_pairings"] += int(capacity > 0) + counts["support_cases"] += 1 + digest.update(json.dumps([prime, matrix, errors, capacity], separators=(",", ":")).encode()) + counts["capacity_table_sha256"] = digest.hexdigest() + return counts + + +def independent_set_size(size, errors): + maximum = 0 + for subset in range(1 << size): + valid = True + for i in range(size): + for j in range(size): + if subset >> i & 1 and subset >> j & 1 and errors >> (i * size + j) & 1: + valid = False + if valid: + maximum = max(maximum, subset.bit_count()) + return maximum + + +def graph_cases(): + counts = {"graphs": 0, "cycle_instances": 0} + for size in range(1, 4): + records = rectangles(eye(size), 2) + for errors in range(1 << (size * size)): + need(prediction(records, errors)[0] == independent_set_size(size, errors), + "graph capacity") + counts["graphs"] += 1 + for size in range(3, 6): + errors = sum(1 << (i * size + (i + 1) % size) for i in range(size)) + for prime in (0, 2, 3, 5, 7): + record = prediction(rectangles(eye(size), prime), errors) + need(record[0] == size // 2, "cycle floor") + check_pairing(eye(size), *witness(eye(size), record, prime), errors, prime) + for i in range(size): + alternative = changed(eye(size), i * size + (i + 1) % size, prime) + need(rank(alternative, prime) == size, "invertible cycle alternative") + counts["cycle_instances"] += 1 + return counts + + +def rational_cases(): + fixtures = (((Fraction(3, 2), 0), (0, Fraction(5, 8))), + ((0, 1), (1, 0)), ((1, 1), (1, 1)), + ((1, Fraction(1, 2), 0), (0, 1, Fraction(-3, 4)))) + checked = 0 + for matrix in fixtures: + records = rectangles(matrix, 0) + for errors in range(1 << (len(matrix) * len(matrix[0]))): + record = prediction(records, errors) + check_pairing(matrix, *witness(matrix, record, 0), errors, 0) + checked += 1 + return {"rational_support_cases": checked} + + +def controls(): + left = ((0, Fraction(-1, 2), Fraction(1, 2)), + (1, Fraction(1, 2), Fraction(-1, 2))) + right = ((1, 1), (-1, 0), (1, 0)) + skew = ((0, 1, 1), (-1, 0, 1), (-1, -1, 0)) + need(multiply(left, right, 0) == eye(2), "correlated nominal") + need(multiply(multiply(left, skew, 0), right, 0) == ((0, 0), (0, 0)), "correlated error") + complete = sum(1 << (i * 3 + j) for i in range(3) for j in range(3) if i != j) + need(prediction(rectangles(eye(3), 0), complete)[0] == 1, "independent/correlated gap") + swap = ((0, 1), (1, 0)) + need(prediction(rectangles(swap, 0), 9)[0] == 1, "nonidentity nominal") + need(independent_set_size(2, 9) == 0, "graph corollary nominal boundary") + rejected = 0 + for errors in (1, 2, 4, 8): + try: + check_pairing(eye(2), eye(2), eye(2), errors, 2) + except ValueError as error: + need(str(error) == "single-entry pairing", "wrong rejection") + rejected += 1 + else: + raise ValueError("omitted-error mutation accepted") + need(rank(((1, 0), (0, 0)), 2) == 1, "singular baseline rank") + need(prediction(rectangles(eye(2), 2), 0)[0] == 2, "empty uncertainty") + need(prediction(rectangles(eye(2), 2), 15)[0] == 0, "full uncertainty") + return {"boundary_equalities": 8, "omitted_error_rejections": rejected} + + +def source_hashes(): + root = Path(__file__).resolve().parent + names = ("PROOF.md", "README.md", "SOURCES.json", "TASK.json", "VERIFY.json", "verify.py") + result = {} + for name in names: + data = (root / name).read_bytes() + need(len(data) <= 256 * 1024, "package-file size cap") + result[name] = sha256(data).hexdigest() + return result + + +def main(): + result = {"status": "PASS_ROBUST_COORDINATE_PAIRING", "claim_type": "scoped written proof", + "exhaustive": exhaustive_families(), "graph": graph_cases(), + "rational": rational_cases(), "controls": controls(), + "source_sha256": source_hashes()} + print(json.dumps(result, sort_keys=True, indent=2)) + + +if __name__ == "__main__": + main() From 29521b7fd88e74a794770ddb3c0fab7bc00dd303 Mon Sep 17 00:00:00 2001 From: Nick Petalas Date: Tue, 17 Nov 2026 22:43:40 +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")