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/height-one-shear-bicliques/PROOF.md b/research/height-one-shear-bicliques/PROOF.md new file mode 100644 index 0000000000..e45d05a291 --- /dev/null +++ b/research/height-one-shear-bicliques/PROOF.md @@ -0,0 +1,117 @@ +# Exact balanced optimum at coefficient height one + +All ranks in this note are over the rationals. Let + +```text +D = {M in Mat_2(Z) : every entry belongs to {-1,0,1}}. +``` + +A balanced rank-distance biclique of order r consists of two r-element +subsets E and O of D. Distinct matrices in the same part have difference +rank two; every cross-part difference has rank one. + +**Result.** The maximum r is exactly six. The lower bound has a written +construction. The upper bound is an exact finite enumeration with two +implementations and the coverage argument below. No formal-kernel acceptance +of that finite computation is claimed. + +## Six-by-six construction + +Write q(a,b)=a^2+ab+b^2 and take + +```text +S = {(-1,0), (-1,1), (0,-1), (0,1), (1,-1), (1,0)}. +E(a,b) = [[a,b],[-a-b,a]] +O(a,b) = [[a,b],[b,-a-b]] for (a,b) in S. +``` + +Every point in S satisfies q=1 and every displayed entry is in {-1,0,1}. +The determinant identities are + +```text +det(E(a,b)-E(u,v)) = q(a-u,b-v) +det(O(a,b)-O(u,v)) = -q(a-u,b-v) +det(E(a,b)-O(u,v)) = q(a,b)-q(u,v) = 0. +``` + +The identity `4q(a,b)=(2a+b)^2+3b^2` proves strict positivity away from +zero over Q. Thus distinct same-part differences have rank two. The parts +are disjoint because E has determinant one and O has determinant minus one. +Consequently every cross difference is nonzero and singular, with rank one. + +For the actual shear frames + +```text +Phi(M) = [[I_2,M],[0,I_2]], +``` + +we have `Phi(M)Phi(N)=Phi(M+N)` and +`rank(Phi(M)-Phi(N))=rank(M-N)`. Hence these twelve commuting integral +four-by-four frames have the rank-distance metric K_(6,6). + +## Upper bound by a complete finite certificate + +For every unordered triple {A,B,C} of distinct matrices in D whose three +pairwise differences have rank two, count + +```text +N(A,B,C) = #{X in D : rank(X-A)=rank(X-B)=rank(X-C)=1}. +``` + +The enumeration gives the following complete distribution. + +| N(A,B,C) | Number of triples | +|---:|---:| +| 0 | 1,480 | +| 1 | 4,368 | +| 2 | 9,624 | +| 3 | 5,760 | +| 4 | 2,096 | +| 6 | 160 | + +There are 23,488 such triples. In particular each has at most six common +rank-one contacts. A purported K_(7,7) contains three matrices in its first +part, while all seven matrices of its second part would be contacts of that +triple. This contradicts the certified ceiling six. Any larger balanced +biclique contains a K_(7,7), so it is excluded as well. + +This upper certificate does not assume that the contacts themselves have +pairwise rank-two differences. Its relaxation is sufficient for the ceiling. + +## Why both enumerations cover the domain + +`verify.py` creates exactly the 3^4=81 lexicographically ordered matrices. +For every ordered matrix pair, it computes rank from its determinant and +whether the difference is zero. It visits each of the binomial(81,3)=85,320 +unordered triples once. Rank-two adjacency selects the admissible triples; +intersection of three 81-bit rank-one neighbor sets counts their contacts. +It checks the complete histogram and emits a hash of every retained triple +and its full contact bitset, in order. + +`ceiling.py` imports no scientific code from the first verifier. It derives +all pair ranks by exact Fraction Gaussian elimination. Two matrices with +the same first row cannot have rank-two difference. An admissible triple +therefore uses three distinct first rows among the nine possible rows. +For each of the binomial(9,3) choices, it tries all 9^3 second-row choices, +giving 61,236 candidates. Sorting first rows gives every admissible triple +exactly once, even though this ordering differs from the first enumeration. +For each accepted triple it scans all 81 matrices and tests the three +contact ranks individually. It recovers the same complete histogram. +It also checks all 144 ordered differences of the twelve four-by-four +shear frames by Fraction elimination, covering attainment directly. + +The first verifier rejects a missing witness matrix, duplicates, a height +violation, Boolean or noninteger entries, a malformed shape, overlapping +parts, a same-part rank-one change, and missing/repeated domain vertices. +The second verifier checks elimination on zero, singular, nonsingular, +pivot-swap and rational fixtures. All acceptance checks remain enabled under +optimized Python. + +## Scope + +This is an exact finite result for D, with a rational construction proof. +It does not bound larger coefficient heights, rational entries of bounded +denominator, different matrix orders, or other fields. The elementary +determinant and rank arguments are classical. No literature-priority claim +is made for them. The new claim is the specified height-one optimum and +its twelve-matrix attaining configuration. diff --git a/research/height-one-shear-bicliques/README.md b/research/height-one-shear-bicliques/README.md new file mode 100644 index 0000000000..a54e81528b --- /dev/null +++ b/research/height-one-shear-bicliques/README.md @@ -0,0 +1,108 @@ +# Height-one integral shear bicliques have exact balanced optimum six + +The largest balanced rank-distance biclique among the 81 two-by-two integer +matrices with entries in {-1,0,1} is exactly **K_(6,6)**. Distinct matrices +within each part have rank-two difference; every cross-part difference has +rank one. The twelve associated integral four-by-four shear frames commute. + +Claim type: **exact finite certificate**, with a written construction and +a proof reducing the ceiling to a complete finite enumeration. +This contribution was produced by Nick Petalas. No new kappa is claimed. + +## Construction and ceiling + +For the six integer solutions used here of `a^2+ab+b^2=1`, take + +```text +E(a,b) = [[a,b],[-a-b,a]], O(a,b) = [[a,b],[b,-a-b]]. +``` + +Their determinant identities prove attainment. For the ceiling, every +pairwise rank-two triple in the complete 81-matrix inventory has at most +six common rank-one contacts. Thus a K_(7,7) is impossible. Two separate +enumerations agree on all 23,488 admissible triples and their complete +contact-count histogram. [PROOF.md](PROOF.md) gives the identities, histogram +and coverage arguments. + +Nick Petalas / petalas [#6174](https://github.com/CrocSwap/integer-mult-bounds/pull/6174) +asks how coefficient height limits integral bicliques. Its all-size construction +gives a quadratic-height upper bound and no exact height-one ceiling. +This settles that first bounded inventory. Jerry Chen / CubeJerry +[#907](https://github.com/CrocSwap/integer-mult-bounds/pull/907) supplies the +earlier eight-frame example and the abstract distortion formula +`c_1(K_(r,r))=2(r-1)/r`. Applying that cited theorem gives distortion 5/3 +for this new twelve-frame configuration; its cut proof is not replayed here. +The rational shear model originates in eumemic +[#288](https://github.com/CrocSwap/integer-mult-bounds/pull/288). +The separate common-flag and signed-rank obstructions of navinor #825 and +Jeremy Diviney #836 remain relevant. All predecessor attribution is retained +in the unchanged source packages. Apache-2.0. + +Base main is `e54523517d0f03e58352e647c403a5af3e525a57`. The full original +`complex-rank-shape-decoder` card is pinned in TASK.json. Its scope changes +to a coefficient-inventory side result. Rank geometry and distortion alone +do not supply a decoder, productive credit or a favorable complete invoice. +The contextual picker reports its historical #5599 assessment differs from +the selected #7000 record. Selected kappa `363005817/100000000000` is unchanged. +The [advance claim](https://github.com/CrocSwap/integer-mult-bounds/discussions/1166#discussioncomment-19572817) +reserves this exact height-one question. + +## Reproduce + +From the repository root, with CPython 3.12 and only its standard library: + +```sh +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -I -W error -B research/height-one-shear-bicliques/verify.py +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -I -W error -B research/height-one-shear-bicliques/ceiling.py +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -B scripts/research_package.py --package research/height-one-shear-bicliques +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -B scripts/check_research_commit.py --package research/height-one-shear-bicliques --check-source-history --check-modes +``` + +A CPython 3.12 executable at another path can replace the local interpreter. +VERIFY.json registers warning-strict normal and optimized runs of both +verifiers, each with a 60-second timeout. Both commands are read-only and +work without Git or predecessor files. The source pins are provenance only. +No predecessor scientific executable is imported or replayed. + +The expected direct markers are `PASS_HEIGHT_ONE_SHEAR_BICLIQUES` and +`PASS_FIRST_ROW_SHEAR_CEILING`. The primary JSON receipt includes the complete +witness, histogram, ordered triple-trace hash and SHA256 of all seven package +files. It is generated on every run. The separate checker uses Fraction +elimination, a first-row enumeration and the actual four-by-four shear ranks. +Ten rejection controls and five elimination fixtures test the stated boundary. + +## Limits + +Only the height-one integral two-by-two inventory is optimized. There is no +physical native implementation, complete caller, dirty restoration, paid +supplier invoice, compiler closure, tape/precision realization, complete +multiplication theorem or discharge of any selected framework assumption. +No selected cold replay, Lean or Docker run is relevant to this certificate. +Independent human and formal proof-kernel review are unclaimed. + +## Open next questions + +1. What is the balanced optimum at height two? Start by reducing the contact + equations for its 625 matrices; a larger exact enumeration or a general + coefficient-height theorem is missing. +2. Can these twelve frames participate in a favorable completed interface? + First specify legal gates, targets, arbitrary dirty inputs and paid cleanup, + and identify a hypothesis escaping the common-flag obstruction. None is + supplied here; the metric example alone does not imply a coding gain. + +## Verification-code bounds + +Both scripts use bounded loops and no recursion or subprocesses. The primary +stores two 81-entry bitset graphs; the other stores an 81-by-81 rank table. +No triple list is retained. Every function is below sixty physical lines. +Errors propagate as exceptions, and checks do not depend on assertions. + +Power-of-Ten rule 3 has a managed-runtime deviation in both scripts. Python +and Fraction allocate during enumeration. Input domains are fixed to 81 +four-entry integer matrices, matrices of order at most four for elimination, +85,320 primary triple visits and 61,236 secondary candidates. Only the fixed +graphs, one matrix/triple at a time and a histogram of at most 82 bins remain +live. Normal and optimized replays verify those enforced domains. A port to +fixed-capacity arithmetic would be needed for allocation-free execution. +Python's dynamic dispatch is a runtime constraint; all scientific calls have +fixed, direct targets and no callbacks, plugins or dynamic evaluation. diff --git a/research/height-one-shear-bicliques/SOURCES.json b/research/height-one-shear-bicliques/SOURCES.json new file mode 100644 index 0000000000..c78fc55833 --- /dev/null +++ b/research/height-one-shear-bicliques/SOURCES.json @@ -0,0 +1,30 @@ +{ + "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/abelian-cayley-metric-scope/README.md", + "usage": "provenance", + "git_blob": "bb598f97cadc32f5da271a1f2da6bb2dc17c469c", + "sha256": "4e74affa1e0239b84da1c8fef25b88aabef8a655047854e04d14d35c981dfac2" + }, + { + "path": "research/unbounded-shear-bicliques/README.md", + "usage": "provenance", + "git_blob": "6fd50ccfce6ab1ec54ed29685fb57d81639886e0", + "sha256": "ca992f0f87ab78f2572566c202ff25b59aee30fcf528ffba28631a83ff5f861d" + } + ] +} diff --git a/research/height-one-shear-bicliques/TASK.json b/research/height-one-shear-bicliques/TASK.json new file mode 100644 index 0000000000..4d8f1e30df --- /dev/null +++ b/research/height-one-shear-bicliques/TASK.json @@ -0,0 +1,89 @@ +{ + "schema_version": 1, + "task_id": "complex-rank-shape-decoder", + "priority_revision": 8, + "base_commit": "e54523517d0f03e58352e647c403a5af3e525a57", + "original_card": { + "id": "complex-rank-shape-decoder", + "question": "Can a legal decoder or coframe change improve the full signed moment, including changed helper targets?", + "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", + "docs/research/recursive-invoice-preflight.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": "Price one complete changed itinerary with both paid and productive histograms. Check #5693/#5698 for overlap and their exact hypotheses before another coframe search. Use the signed invoice preflight where its boundary contract agrees; an inconclusive concave comparison is not a power crossing. Stop if an optimistic complete budget fails at the chosen target or native delivery remains unspecified.", + "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": [ + "coframe", + "signed moment", + "5693", + "5698" + ], + "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": "Determine the exact largest balanced rank-distance biclique in the height-one integral two-by-two matrix inventory.", + "scope_change_reason": "This answers the first coefficient-height case of PR6174 Open next question 2. It is a frame-alphabet side result, not a decoder or complete signed-moment improvement.", + "bottleneck_link": "A changed frame alphabet must have explicit coefficient and rank costs. This settles its smallest nontrivial bounded inventory; non-L1 geometry alone does not escape the common-flag obstruction or earn productive credit.", + "budget_minutes": 60, + "stop_rule": "Stop at the first exact height-one optimum with an attaining configuration and independent finite ceiling; leave larger heights and physical realization open.", + "outcome": "completed", + "evidence": "PROOF.md gives the six-by-six construction and finite ceiling reduction. verify.py enumerates every matrix triple; ceiling.py separately uses rational elimination and first-row buckets.", + "author": "Nick Petalas", + "ai_assistance": "Independent human and formal proof-kernel review are unclaimed.", + "open_questions": [ + { + "question": "What is the balanced optimum at coefficient height two?", + "why_it_matters": "The height-one ceiling does not quantify how the inventory grows with coefficient storage.", + "first_step": "Use rank-one contact equations to reduce the 625-matrix inventory before a bounded exact search.", + "blocked_by": "No larger-height enumeration or general height theorem is supplied." + }, + { + "question": "Can the twelve-frame configuration participate in a favorable completed interface?", + "why_it_matters": "The charged metric and its distortion do not imply a coding or multiplication gain.", + "first_step": "Specify legal gates, target jobs, arbitrary dirty inputs and all cleanup costs, identifying a hypothesis outside the existing common-flag obstruction.", + "blocked_by": "No physical caller, native realization or complete supplier invoice is supplied." + } + ], + "environment": { + "python": "3.12.15", + "implementation": "CPython", + "system": "Darwin", + "release": "27.0.0", + "machine": "arm64", + "dependencies": "standard library only" + } +} diff --git a/research/height-one-shear-bicliques/VERIFY.json b/research/height-one-shear-bicliques/VERIFY.json new file mode 100644 index 0000000000..f75062f705 --- /dev/null +++ b/research/height-one-shear-bicliques/VERIFY.json @@ -0,0 +1,59 @@ +{ + "schema_version": 1, + "status": "ready", + "python": "3.12", + "requirements": [], + "inputs": [], + "commands": [ + { + "argv": [ + "{python}", + "-I", + "-W", + "error", + "-B", + "{package}/verify.py" + ], + "timeout_seconds": 60, + "checks": "Complete determinant rank graph, all triples, attaining witness and ten rejection controls." + }, + { + "argv": [ + "{python}", + "-I", + "-W", + "error", + "-O", + "-B", + "{package}/verify.py" + ], + "timeout_seconds": 60, + "checks": "Complete determinant rank graph, all triples, attaining witness and ten rejection controls. Assertions disabled." + }, + { + "argv": [ + "{python}", + "-I", + "-W", + "error", + "-B", + "{package}/ceiling.py" + ], + "timeout_seconds": 60, + "checks": "Separate rational-elimination rank table, complete first-row triple enumeration, actual shear ranks and elimination controls." + }, + { + "argv": [ + "{python}", + "-I", + "-W", + "error", + "-O", + "-B", + "{package}/ceiling.py" + ], + "timeout_seconds": 60, + "checks": "Separate rational-elimination rank table, complete first-row triple enumeration, actual shear ranks and elimination controls. Assertions disabled." + } + ] +} diff --git a/research/height-one-shear-bicliques/ceiling.py b/research/height-one-shear-bicliques/ceiling.py new file mode 100644 index 0000000000..ae100b5444 --- /dev/null +++ b/research/height-one-shear-bicliques/ceiling.py @@ -0,0 +1,118 @@ +"""Separate rational-elimination and first-row enumeration. Apache-2.0.""" + +from collections import Counter +from fractions import Fraction +from hashlib import sha256 +from itertools import combinations, product +import json +from pathlib import Path +import sys + + +def require(condition: bool, message: str) -> None: + if not condition: + raise ValueError(message) + + +def rank(rows: list) -> int: + size = len(rows) + require(size in (2, 4) and all(len(row) == size for row in rows), + "only square matrices of order two or four are supported") + matrix = [[Fraction(x) for x in row] for row in rows] + pivot_row = 0 + for col in range(size): + candidates = [r for r in range(pivot_row, size) if matrix[r][col]] + if not candidates: + continue + chosen = candidates[0] + matrix[pivot_row], matrix[chosen] = matrix[chosen], matrix[pivot_row] + scale = matrix[pivot_row][col] + matrix[pivot_row] = [x / scale for x in matrix[pivot_row]] + for r in range(pivot_row + 1, size): + factor = matrix[r][col] + matrix[r] = [x - factor * y + for x, y in zip(matrix[r], matrix[pivot_row])] + pivot_row += 1 + return pivot_row + + +def rank_table(matrices: tuple) -> list: + table = [[0] * 81 for _ in range(81)] + for i, a in enumerate(matrices): + for j, b in enumerate(matrices): + delta = [x - y for x, y in zip(a, b)] + table[i][j] = rank([delta[:2], delta[2:]]) + return table + + +def first_row_ceiling(table: list) -> tuple: + histogram = Counter() + inspected = 0 + for first_rows in combinations(range(9), 3): + for second_rows in product(range(9), repeat=3): + a, b, c = tuple(9 * u + v for u, v in zip(first_rows, second_rows)) + inspected += 1 + if table[a][b] == table[a][c] == table[b][c] == 2: + common = sum(table[a][j] == table[b][j] == table[c][j] == 1 + for j in range(81)) + require(common <= 6, "seven common contacts found") + histogram[common] += 1 + require(inspected == 61236, "first-row enumeration is incomplete") + return dict(sorted(histogram.items())), inspected + + +def shear(matrix: tuple) -> list: + a, b, c, d = matrix + return [[1, 0, a, b], [0, 1, c, d], [0, 0, 1, 0], [0, 0, 0, 1]] + + +def check_attainment() -> int: + roots = ((-1, 0), (-1, 1), (0, -1), (0, 1), (1, -1), (1, 0)) + left = tuple((a, b, -a - b, a) for a, b in roots) + right = tuple((a, b, b, -a - b) for a, b in roots) + pairs = 0 + for side_a, side_b in product(range(2), repeat=2): + for i, j in product(range(6), repeat=2): + a, b = (left, right)[side_a][i], (left, right)[side_b][j] + sa, sb = shear(a), shear(b) + delta = [[x - y for x, y in zip(row_a, row_b)] + for row_a, row_b in zip(sa, sb)] + expected = 1 if side_a != side_b else (0 if i == j else 2) + require(rank(delta) == expected, "shear witness rank differs") + pairs += 1 + return pairs + + +def rank_controls() -> int: + controls = ( + ([[0, 0], [0, 0]], 0), + ([[1, 2], [2, 4]], 1), + ([[0, 1], [1, 0]], 2), + ([[1, 1], [1, 2]], 2), + ([[Fraction(1, 2), 1], [1, 2]], 1), + ) + for matrix, expected in controls: + require(rank(matrix) == expected, "elimination control failed") + return len(controls) + + +def main() -> None: + require(len(sys.argv) == 1, "this verifier accepts no arguments") + matrices = tuple(product((-1, 0, 1), repeat=4)) + histogram, inspected = first_row_ceiling(rank_table(matrices)) + require(sum(histogram.values()) == 23488, "rank-two triple census differs") + root = Path(__file__).resolve().parent + print(json.dumps({ + "status": "PASS_FIRST_ROW_SHEAR_CEILING", + "balanced_optimum": 6, + "first_row_candidates": inspected, + "rank_two_triples": sum(histogram.values()), + "common_rank_one_histogram": histogram, + "ordered_shear_pairs": check_attainment(), + "elimination_controls": rank_controls(), + "source_sha256": sha256((root / "ceiling.py").read_bytes()).hexdigest(), + }, sort_keys=True)) + + +if __name__ == "__main__": + main() diff --git a/research/height-one-shear-bicliques/verify.py b/research/height-one-shear-bicliques/verify.py new file mode 100644 index 0000000000..6b6090faa0 --- /dev/null +++ b/research/height-one-shear-bicliques/verify.py @@ -0,0 +1,137 @@ +"""Exact height-one construction and complete rank-graph ceiling. Apache-2.0.""" + +from collections import Counter +from hashlib import sha256 +from itertools import combinations, product +import json +from pathlib import Path +import sys + + +ROOTS = ((-1, 0), (-1, 1), (0, -1), (0, 1), (1, -1), (1, 0)) +FILES = ("README.md", "PROOF.md", "TASK.json", "SOURCES.json", "VERIFY.json", + "verify.py", "ceiling.py") +EXPECTED = {0: 1480, 1: 4368, 2: 9624, 3: 5760, 4: 2096, 6: 160} + + +def require(condition: bool, message: str) -> None: + if not condition: + raise ValueError(message) + + +def difference_rank(left: tuple, right: tuple) -> int: + a, b, c, d = (x - y for x, y in zip(left, right)) + return 2 if a * d != b * c else int(any((a, b, c, d))) + + +def witness() -> tuple: + even = tuple((a, b, -a - b, a) for a, b in ROOTS) + odd = tuple((a, b, b, -a - b) for a, b in ROOTS) + return even, odd + + +def validate_witness(parts: tuple) -> None: + require(len(parts) == 2, "two parts required") + for part in parts: + require(len(part) == 6, "each part must contain six matrices") + for matrix in part: + require(len(matrix) == 4, "matrix must have four entries") + require(all(type(x) is int and -1 <= x <= 1 for x in matrix), + "entries must be height-one integers") + for a, b in combinations(part, 2): + require(difference_rank(a, b) == 2, "within-part rank must be two") + for a, b in product(*parts): + require(difference_rank(a, b) == 1, "cross-part rank must be one") + + +def rank_graph(matrices: tuple) -> tuple: + require(matrices == tuple(product((-1, 0, 1), repeat=4)), + "complete lexicographic height-one inventory required") + near, far = [0] * 81, [0] * 81 + for i, a in enumerate(matrices): + for j, b in enumerate(matrices): + rank = difference_rank(a, b) + if rank == 1: + near[i] |= 1 << j + elif rank == 2: + far[i] |= 1 << j + return near, far + + +def triple_ceiling(near: list, far: list) -> tuple: + histogram = Counter() + digest = sha256() + candidates = 0 + for a, b, c in combinations(range(81), 3): + candidates += 1 + if (far[a] >> b & 1) and (far[a] >> c & 1) and (far[b] >> c & 1): + common = near[a] & near[b] & near[c] + count = common.bit_count() + require(count <= 6, "rank-two triple has more than six contacts") + histogram[count] += 1 + digest.update(f"{a},{b},{c}:{common:x}\n".encode("ascii")) + require(dict(histogram) == EXPECTED, "complete triple histogram differs") + require(candidates == 85320, "complete triple inventory differs") + return dict(sorted(histogram.items())), digest.hexdigest(), candidates + + +def rejection_controls() -> list: + even, odd = witness() + cases = ( + ("missing_matrix", (even[:-1], odd)), + ("duplicate_matrix", (even[:-1] + even[:1], odd)), + ("wrong_height", (((2, 0, 1, -1),) + even[1:], odd)), + ("boolean_entry", (((True, 0, 1, -1),) + even[1:], odd)), + ("noninteger_entry", (((-1.0, 0, 1, -1),) + even[1:], odd)), + ("wrong_shape", (((-1, 0, 1),) + even[1:], odd)), + ("overlapping_parts", (even, even)), + ("rank_one_inside", (((0, 0, 1, -1),) + even[1:], odd)), + ) + passed = [] + for name, bad in cases: + try: + validate_witness(bad) + except ValueError: + passed.append(name) + else: + raise ValueError(f"control accepted: {name}") + domain = tuple(product((-1, 0, 1), repeat=4)) + for name, bad in (("missing_vertex", domain[:-1]), + ("repeated_vertex", domain[:-1] + domain[:1])): + try: + rank_graph(bad) + except ValueError: + passed.append(name) + else: + raise ValueError(f"control accepted: {name}") + return passed + + +def main() -> None: + require(len(sys.argv) == 1, "this verifier accepts no arguments") + matrices = tuple(product((-1, 0, 1), repeat=4)) + parts = witness() + validate_witness(parts) + near, far = rank_graph(matrices) + histogram, digest, candidates = triple_ceiling(near, far) + root = Path(__file__).resolve().parent + result = { + "status": "PASS_HEIGHT_ONE_SHEAR_BICLIQUES", + "claim_type": "exact finite certificate", + "balanced_optimum": 6, + "matrices": len(matrices), + "ordered_rank_pairs": len(matrices) ** 2, + "candidate_triples": candidates, + "rank_two_triples": sum(histogram.values()), + "common_rank_one_histogram": histogram, + "triple_trace_sha256": digest, + "witness": parts, + "rejection_controls": rejection_controls(), + "sources_sha256": {name: sha256((root / name).read_bytes()).hexdigest() + for name in FILES}, + } + print(json.dumps(result, sort_keys=True)) + + +if __name__ == "__main__": + main() 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")