From 66e05cf6c6058cff8a41a9b3ebe5945f5e36e9be Mon Sep 17 00:00:00 2001 From: Nick Petalas Date: Fri, 13 Nov 2026 22:51:17 +0000 Subject: [PATCH 1/2] feat(research): prove restored four-cycle cost ten --- .../restored-unsigned-four-cycle/README.md | 215 +++++++++++++++ .../restored-unsigned-four-cycle/SOURCES.json | 42 +++ .../restored-unsigned-four-cycle/TASK.json | 77 ++++++ .../restored-unsigned-four-cycle/VERIFY.json | 39 +++ .../restored-unsigned-four-cycle/verify.py | 250 ++++++++++++++++++ 5 files changed, 623 insertions(+) create mode 100644 research/restored-unsigned-four-cycle/README.md create mode 100644 research/restored-unsigned-four-cycle/SOURCES.json create mode 100644 research/restored-unsigned-four-cycle/TASK.json create mode 100644 research/restored-unsigned-four-cycle/VERIFY.json create mode 100644 research/restored-unsigned-four-cycle/verify.py diff --git a/research/restored-unsigned-four-cycle/README.md b/research/restored-unsigned-four-cycle/README.md new file mode 100644 index 0000000000..11170f6e12 --- /dev/null +++ b/research/restored-unsigned-four-cycle/README.md @@ -0,0 +1,215 @@ +# An ordinary four-cycle costs exactly ten with restored dirty donors + +This contribution was produced by Nick Petalas. Apache-2.0. + +Claim type: scoped written proof with an exact finite exclusion certificate. +The minimum scalar arithmetic cost of + +```text +(x0,x1,x2,x3) -> (x1,x2,x3,x0) +``` + +is **ten primitives**, even with any finite number of additional arbitrary +dirty registers that must each finish with their own initial value. The +target is the ordinary four-cycle, with no output sign changes. The result +also applies to its inverse and coordinate relabellings. + +This answers one new instance of Philipp / mightyOil's +[PR #1303](https://github.com/CrocSwap/integer-mult-bounds/pull/1303), second +Open next question, about further restored-permutation gaps. That package's +disjoint two-plus-three-cycle theorem and signed-four-cycle control are cited +predecessors, not results replayed here. We use its two unchanged, credited +metric-ball engines on the new ordinary-four-cycle endpoint only, apart from +small implementation controls. The new contribution is the endpoint +exclusion, its unbounded-donor application and the resulting exact price. + +## Exact interface + +Each register initially contains an arbitrary independent real scalar. One +paid primitive is a distinct-register ADD or SUB, unary NEG, DOUBLE or HALVE, +COPY, or CLEAR. There are no free signs, renamings, initialized cells or +discarded coordinates. Every donor is restored individually. Intermediate +rows may be arbitrary dyadic linear combinations. The model and read-only +specialization originate in Ross Richardson's +[#1216](https://github.com/CrocSwap/integer-mult-bounds/pull/1216) and +[#1145](https://github.com/CrocSwap/integer-mult-bounds/pull/1145). + +## Reduction to a finite six-register question + +The complete required map is invertible, so a distinct-register COPY or +CLEAR cannot occur: it loses matrix rank permanently. Delete self-COPY. +Every remaining prefix is invertible over the dyadic rationals. + +The cycle-write lemma of #1303 implies that at least five writes target the +four moved coordinates. For completeness, if all four were written just +once, consider the first such write, to coordinate i. Its only write would +have to produce its final row e_p(i). Coordinate p(i) is still untouched and +has that same row, contradicting prefix invertibility. + +A written restored donor needs at least two writes, as in #1216. Before its +first write it has its original basis row. A nonidentity unary scale changes +it, and an ADD or SUB changes it by a nonzero source row. A single write +therefore cannot restore it. A putative word of length at most nine can write +to at most `floor((9-5)/2)=2` donors. + +All other donors are read-only. Specialize their independent inputs to zero +and remove their zero-source additions. The universal endpoint identity +still holds on the retained coordinates, and the reduced arithmetic word +has no greater length. This is a lower-bound existence reduction, not a +permission to initialize actual workspace for free. Embed the resulting +word in six registers by leaving missing donors idle. + +Reduce `Z[1/2]` modulo three. ADD and SUB remain elementary row additions; +NEG, DOUBLE and HALVE all reduce to row negation. The inverse-closed +six-register generating set has `6+2*6*5=66` elements. Thus it suffices to +exclude the modular endpoint with rows + +```text +P = (e1,e2,e3,e0,e4,e5), encoded as 123045. +``` + +## Complete new endpoint exclusion + +Let B be the entire radius-four ball about identity in that metric, with +minimum distances. A word through length eight exists exactly when `AP` +belongs to B for some A in B. A word through length nine exists exactly when +that direct meet succeeds or `gAP` belongs to B for some A in B and generator g. +Indeed write `P=UhV`, where U and V have length at most four and h is one +generator, then take `A=U^-1` and `g=h^-1`. The converse constructs the word +from such a hit. Shorter words are covered by the direct meet. No determinant, +write-order, symmetry or sampling pruning enters the scan. + +Both native representations independently enumerate the complete ball and +scan this new endpoint. Each obtains + +```text +radius layers 1, 66, 2655, 83270, 2213925 +states 2299917 +generators 66 +middle transitions 151794522 = 2299917 * 66 +direct hits 0 +middle hits 0 +``` + +The verifier compares the full sorted matrix/distance streams byte for byte, +then hashes that common stream. One engine uses base-three row tables in a +64-bit matrix key; the other uses two-bit entries in a 128-bit key and literal +coordinate updates. Their generation and multiplication implementations +remain the credited source bytes. The repeated ball cardinality is a +prerequisite of the new endpoint query, not a new claim about that ball. +All nine-step modular words are excluded. The preceding reduction transfers +that finite exclusion to every finite number of restored dirty donors. + +## Matching exact rational upper word + +The first four operations swap coordinates zero and one. The remaining six +cycle coordinates one, two and three, using the predecessor's elementary +swap and three-cycle templates. Their overlapping composition gives the +new endpoint without a temporary register: + +```text +x0 += x1 +x1 -= x0 +x0 += x1 +x1 = -x1 +x3 -= x2 +x1 -= x3 +x2 += x3 +x3 += x1 +x1 -= x3 +x1 += x2 +``` + +The checker multiplies the literal rational row operations on every one of +six independent input columns, verifies both donors are unchanged, checks +the inverse word, and rejects all ten single-operation omissions. This upper +witness together with the exclusion proves the exact minimum ten. + +## Reproduce and evidence boundary + +From the repository root, with CPython 3.12 and a C++17 compiler named `c++` +supporting `unsigned __int128`: + +```sh +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -B scripts/research_package.py --package research/restored-unsigned-four-cycle +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -B scripts/check_research_commit.py --package research/restored-unsigned-four-cycle --check-source-history +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -I -W error -B research/restored-unsigned-four-cycle/verify.py +``` + +The registered normal and optimized commands both run the complete new +endpoint exclusion, with no quick mode. Expected status is +`PASS_RESTORED_UNSIGNED_FOUR_CYCLE`, `scalar_minimum=10`. A standalone export +needs this directory and the four declared live source files; its verifier +uses no Git or network. `SOURCES.json` authenticates those source bytes before +compilation. The normal metadata launcher separately authenticates their Git +pins and the originating catalogue. Historical provenance is not scientific +acceptance. + +An independently represented dense Python radius-four ball supplies small +implementation controls. Both native engines must match every one of its +matrix/distance pairs for the identity and one-/two-negation endpoints. They +must reject invalid dimension and repeated-column domains. Six damaged +endpoint reports are rejected, including missing middle transitions, an +alleged hit, wrong target and a boolean substituted for a dimension. Explicit +exceptions retain all checks under optimized Python. + +Replay prints a generated receipt bound to the hashes of every package file +and every live source. `--emit /absolute/path/outside/repository/receipt.json` +also writes it to a new file. Temporary binaries, metric balls and reports +are removed on exit; no receipt or transient output is written in the checkout. +The source code, metadata and full finite query are the reproducible evidence. + +This is an exact scalar boundary result. It does not bind a current native +four-cycle caller, remove a paid recursive child, supply a physical frame or +tape layout, or improve kappa. A changed composite boundary, promised inputs, +clean/disposable workspace, free monomial maps, arbitrary scalar multipliers, +joint complex-component arithmetic or nonlinear gates are different models. +Selected #7000 is unchanged. Full supplier, precision, hosting, compiler and +outer-theorem obligations are unrun. Independent human and formal proof-kernel +review are unclaimed. Hosted CI status belongs in the PR body. + +## Open next questions + +1. Can an actual four-cycle boundary and an adjacent scalar run be synthesized + below the isolated price ten? First pin that complete caller map and its + physical frame and ownership ledger. No such caller is supplied here. +2. Can a write-pattern or support invariant replace the large finite ball for + this exclusion? Start with this fixed endpoint and allow mixed intermediate + rows. A complete symbolic certificate is missing. This package authorizes + no larger permutation search and stops at the first exact new price. + +The motivations, first steps and blockers are also in `TASK.json`. + +## Credit and implementation constraints + +Philipp / mightyOil #1303 supplied the cycle-sensitive reduction and ternary +engine, and extended Ross Richardson's #1216 packed engine with the middle +scan. Ross Richardson #1216/#1145 supplied the restored-donor model, +read-only specialization, modular method and elementary upper templates. +ToikY's historical #969 and the credited Sagar Thakrar, faw01, Jeremy Kothe, +Chafik Boukhalfa, icekylinx and supplier lineage retain their predecessor credit. +No predecessor file or notice is modified. The finite-group metric and +matrix identities use elementary classical methods; no literature-wide +priority claim is made. + +The new Python wrapper has no recursion, dynamic code evaluation or external +callbacks. Its loops have fixed finite domains or explicit byte bounds. The +native domain is fixed to six registers/radius four for the scientific query +and two registers for controls, with 60-second compilation and 180-second +execution limits. At most two six-register metric-ball files coexist. Native compilation +uses `-Wall -Wextra -Werror`; Python runs warning-strict in normal and optimized +modes. Separate static type analysis is not claimed. + +Power of Ten deviations are restricted to the managed Python runtime and +unchanged frozen source engines. Rule 3: dynamic integers, containers and +native hash tables remain, bounded here by the fixed domain and the explicit +`sum(66^k,k=0..4)` state bound, 1 MiB source-file limits and bounded report/ball +reads. Runtime allocator overhead is not measured. A future physical lowering +needs a fixed-storage representation. Rule 4: the inherited native `main` +functions exceed sixty lines. Editing frozen source for a refactor would expand +this result's scope; the wrapper keeps their byte pins and independent complete +stream comparison. A separately authorized engine refactor can address that. +Rule 10: the packed engine's existing 128-bit extension prevents portable +pedantic ISO-only compilation; the warning-strict C++17 builds and explicit +compiler requirement are retained. No warning is suppressed and no native +source change is made here. diff --git a/research/restored-unsigned-four-cycle/SOURCES.json b/research/restored-unsigned-four-cycle/SOURCES.json new file mode 100644 index 0000000000..03c88aa3f7 --- /dev/null +++ b/research/restored-unsigned-four-cycle/SOURCES.json @@ -0,0 +1,42 @@ +{ + "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/complex-restored-borrowed-boundaries/PROOF.md", + "usage": "input", + "git_blob": "a78b1f09f31f5d2d29652ddde795598e41789b72", + "sha256": "7808f30e28508e327f68fafdc0a1be58c779d892482d3713c767fd7c0d21e4b0" + }, + { + "path": "research/restored-cycle-gap/README.md", + "usage": "input", + "git_blob": "332a5de8a5130cc9f854cf8900cda178780adc44", + "sha256": "583bb8453cdd1aaf78307dd9db20d2e16f11db7638109464bcc94f6792327ccd" + }, + { + "path": "research/restored-cycle-gap/packed.cpp", + "usage": "input", + "git_blob": "c61013136cccb4e79d593f730c32d957a55613f3", + "sha256": "8ca8361756b87eabbe79bb438324ab20941b8c4ff2967be4f7a444feb9ea9232" + }, + { + "path": "research/restored-cycle-gap/ternary.cpp", + "usage": "input", + "git_blob": "97757bcc42940fe3c3399e14afb16fec75b033fe", + "sha256": "f6f64206c2269a21f571cc2de64c64fb73b5cee9af89de9347d5e38b0dcaa41f" + } + ] +} diff --git a/research/restored-unsigned-four-cycle/TASK.json b/research/restored-unsigned-four-cycle/TASK.json new file mode 100644 index 0000000000..4e1c27d9f9 --- /dev/null +++ b/research/restored-unsigned-four-cycle/TASK.json @@ -0,0 +1,77 @@ +{ + "schema_version": 1, + "task_id": "connector-alphabet-change", + "priority_revision": 8, + "base_commit": "e54523517d0f03e58352e647c403a5af3e525a57", + "original_card": { + "id": "connector-alphabet-change", + "question": "Does one explicit extension of the connector alphabet offer a favorable completed budget?", + "starting_points": [ + "docs/research/research-family-status.md", + "research/universal-connector-boundary/README.md", + "certificates/selected-result.json" + ], + "methods": [ + "Construct and charge a legal extra operation on a minimal instance.", + "Prove a target-specific bound after adding one specified operation family." + ], + "acceptance_gate": "State which fixed-alphabet premise changes and charge its implementation; do not declare it free. A scoped local result may be retained without a complete supplier. Expanding it into further construction rounds requires the family-level budget and obligation gate in research-family-status.md; an optimistic passing relaxation alone is not acceptance.", + "first_step": { + "command": [ + "python3", + "-B", + "research/universal-connector-boundary/verify.py" + ], + "expected": "PASS_UNIVERSAL_CONNECTOR_BOUNDARY", + "inspect": "Reproduce the 945-pairing control, then read Exact interface to list the allowed calls.", + "scope": "Positive control / source-bound orientation only; this is not a new construction or full cold replay." + }, + "first_experiment": "Add exactly one legally priced operation and test a tiny dirty-input instance before enumerating larger cases.", + "bottleneck_link": "A new legal connector operation could change recursive interface cost; a larger census in the same alphabet is a separate side result.", + "allowed_variations": [ + "Choose one additional operation and a small source count for its first counterexample." + ], + "scope_change_triggers": [ + "Keeping the alphabet and only increasing the source count; record this as a changed assignment.", + "Extending a source-count census without naming a supplier/interface decision it could change; audit #2973 pruning concerns before relying on the affected predecessor exclusions." + ], + "overlap_terms": [ + "universal connector", + "source-toggle", + "connector alphabet" + ] + }, + "scope_status": "changed", + "actual_scope": "Determine the exact ordinary four-cycle arithmetic cost with any finite number of restored arbitrary-dirty donors.", + "scope_change_reason": "The source handoff asks for another restored-permutation gap. This retains its arithmetic alphabet and changes the connector card to an exact scalar boundary-price side result, rather than an alphabet extension.", + "bottleneck_link": "Restored workspace can change a recursive boundary price. This exact scalar price constrains that boundary contract only; no current supplier or paid recursive saving is asserted.", + "budget_minutes": 60, + "stop_rule": "Stop at the first exact new endpoint price, or publish the precise remaining obstruction. Do not extend to other permutation targets.", + "outcome": "completed", + "evidence": "Two source-credited native representations exclude all six-register F3 words through length nine for 123045; exact rational ten-step word, independent dense controls and generated hash-bound receipts.", + "author": "Nick Petalas", + "ai_assistance": "Independent human and formal proof-kernel review are unclaimed.", + "open_questions": [ + { + "question": "Can an actual four-cycle boundary be synthesized jointly with its adjacent scalar run below the isolated price ten?", + "why_it_matters": "The isolated optimum does not price a changed composite boundary.", + "first_step": "Pin a literal caller requiring this ordinary four-cycle, extract the adjacent complete linear map and compare fully restored words.", + "blocked_by": "No current source-bound four-cycle caller or physical frame/ownership ledger is supplied here." + }, + { + "question": "What structural invariant can exclude short restored permutation words without rebuilding a large finite metric ball?", + "why_it_matters": "The present donor reduction is finite but can become expensive for larger endpoints.", + "first_step": "Use the ordinary four-cycle exclusion as a fixed test case for a stronger write-pattern or support invariant, preserving mixed intermediate rows.", + "blocked_by": "A complete symbolic classification or independently checkable shorter certificate is missing; no larger search is part of this result." + } + ], + "coordination": { + "claim_url": "https://github.com/CrocSwap/integer-mult-bounds/discussions/1166#discussioncomment-19601570", + "source_pr": 1303, + "source_author": "mightyOil", + "predecessor_author": "mightyOil", + "upstream_commit": "e54523517d0f03e58352e647c403a5af3e525a57", + "selected_record": "7000", + "scope": "Exact scalar arithmetic boundary only; selected frontier unchanged." + } +} diff --git a/research/restored-unsigned-four-cycle/VERIFY.json b/research/restored-unsigned-four-cycle/VERIFY.json new file mode 100644 index 0000000000..e6900b6587 --- /dev/null +++ b/research/restored-unsigned-four-cycle/VERIFY.json @@ -0,0 +1,39 @@ +{ + "schema_version": 1, + "status": "ready", + "python": "3.12", + "requirements": [], + "inputs": [ + "research/complex-restored-borrowed-boundaries/PROOF.md", + "research/restored-cycle-gap/README.md", + "research/restored-cycle-gap/packed.cpp", + "research/restored-cycle-gap/ternary.cpp" + ], + "commands": [ + { + "argv": [ + "{python}", + "-I", + "-W", + "error", + "-B", + "{package}/verify.py" + ], + "timeout_seconds": 540, + "checks": "Complete new four-cycle endpoint exclusion with both native encodings, bytewise metric-ball equality, rational upper word/inverse/omissions, dense controls and rejection controls." + }, + { + "argv": [ + "{python}", + "-I", + "-O", + "-W", + "error", + "-B", + "{package}/verify.py" + ], + "timeout_seconds": 540, + "checks": "The same complete new-endpoint certificate with optimization enabled; all checks use explicit exceptions." + } + ] +} diff --git a/research/restored-unsigned-four-cycle/verify.py b/research/restored-unsigned-four-cycle/verify.py new file mode 100644 index 0000000000..c234f6a5e8 --- /dev/null +++ b/research/restored-unsigned-four-cycle/verify.py @@ -0,0 +1,250 @@ +#!/usr/bin/env python3 +"""Check the new four-cycle endpoint; write only to temporary storage.""" + +import argparse +from collections import deque +from fractions import Fraction +import hashlib +import json +from pathlib import Path +import shutil +import struct +import subprocess +import tempfile + + +PACKAGE = Path(__file__).resolve().parent +ROOT = PACKAGE.parents[1] +SOURCE = "research/restored-cycle-gap/" +MAX_BALL_BYTES = 9 * sum(66**depth for depth in range(5)) +WORD = ( + (0, 1, 1), (1, 0, -1), (0, 1, 1), (1, 1, -1), + (3, 2, -1), (1, 3, -1), (2, 3, 1), + (3, 1, 1), (1, 3, -1), (1, 2, 1), +) + + +def require(condition, message): + if not condition: + raise ValueError(message) + + +def sha256(path): + require(path.is_file() and not path.is_symlink(), "regular file required") + require(path.stat().st_size <= 1024 * 1024, "source exceeds 1 MiB") + return hashlib.sha256(path.read_bytes()).hexdigest() + + +def authenticate_sources(): + sources = json.loads((PACKAGE / "SOURCES.json").read_text()) + expected = { + SOURCE + "README.md", SOURCE + "ternary.cpp", SOURCE + "packed.cpp", + "research/complex-restored-borrowed-boundaries/PROOF.md", + } + rows = [row for row in sources["files"] if row["usage"] == "input"] + require(len(rows) == len(expected), "unexpected source inventory") + require({row["path"] for row in rows} == expected, "source paths differ") + hashes = {} + for row in rows: + digest = sha256(ROOT / row["path"]) + require(digest == row["sha256"], "source hash mismatch: " + row["path"]) + hashes[row["path"]] = digest + return hashes + + +def dense_change(matrix, n, target, source, sign): + result = list(matrix) + for column in range(n): + offset = target * n + column + value = matrix[offset] + result[offset] = ((-value) if target == source else + value + sign * matrix[source * n + column]) % 3 + return tuple(result) + + +def dense_control_ball(): + n = 2 + identity = (1, 0, 0, 1) + distance = {identity: 0} + queue = deque([identity]) + # At most 3^4 matrices, with six generators and radius four. + for _ in range(3**4): + if not queue: + break + matrix = queue.popleft() + if distance[matrix] == 4: + continue + for target in range(n): + for source in range(n): + for sign in (-1, 1): + if target == source and sign == 1: + continue + next_matrix = dense_change(matrix, n, target, source, sign) + if next_matrix not in distance: + distance[next_matrix] = distance[matrix] + 1 + queue.append(next_matrix) + require(not queue, "control worklist exhausted") + encoded = {} + for matrix, depth in distance.items(): + key = sum(value * 3**index for index, value in enumerate(matrix)) + encoded[key] = depth + return encoded + + +def rational_map(word): + rows = [[Fraction(int(i == j)) for j in range(6)] for i in range(6)] + for target, source, sign in word: + if target == source: + rows[target] = [-entry for entry in rows[target]] + else: + rows[target] = [left + sign * right + for left, right in zip(rows[target], rows[source])] + return rows + + +def check_upper_word(): + permutation = (1, 2, 3, 0, 4, 5) + target = [[Fraction(int(j == permutation[i])) for j in range(6)] + for i in range(6)] + require(rational_map(WORD) == target, "ten-step rational endpoint failed") + for omitted in range(len(WORD)): + shorter = WORD[:omitted] + WORD[omitted + 1:] + require(rational_map(shorter) != target, "omission was not detected") + inverse = tuple((t, s, sign if t == s else -sign) + for t, s, sign in reversed(WORD)) + require(rational_map(WORD + inverse) == rational_map(()), "inverse failed") + return {"length": len(WORD), "independent_input_columns": 6, + "omissions_rejected": len(WORD), "inverse_checked": True} + + +def compile_engine(name, directory, compiler): + executable = directory / name + command = [compiler, "-std=c++17", "-O3", "-Wall", "-Wextra", "-Werror", + str(ROOT / (SOURCE + name + ".cpp")), "-o", str(executable)] + subprocess.run(command, check=True, capture_output=True, text=True, timeout=60) + return executable + + +def run_engine(executable, n, permutation, directory, label): + ball = directory / (label + ".bin") + report = directory / (label + ".json") + completed = subprocess.run( + [str(executable), str(n), permutation, str(ball), str(report)], + check=True, capture_output=True, text=True, timeout=180, + ) + require(completed.stdout.startswith("PASS_"), "missing native completion") + require(report.stat().st_size <= 4096, "oversize native report") + require(ball.stat().st_size <= MAX_BALL_BYTES, "oversize metric ball") + return json.loads(report.read_text()), ball + + +def compare_balls(left, right): + require(left.stat().st_size == right.stat().st_size, "ball lengths differ") + digest = hashlib.sha256() + with left.open("rb") as a, right.open("rb") as b: + for _ in range(MAX_BALL_BYTES // 65536 + 2): + first, second = a.read(65536), b.read(65536) + require(first == second, "native metric balls differ") + if not first: + return digest.hexdigest() + digest.update(first) + raise ValueError("ball comparison exceeded bound") + + +def control_runs(executable, directory, oracle): + for number, (permutation, minimum) in enumerate((('01', 0), ('a1', 1), ('ab', 2))): + report, ball = run_engine(executable, 2, permutation, directory, "small" + str(number)) + require(report["minimum_through_nine"] == minimum, "control distance differs") + payload = ball.read_bytes() + require(len(payload) == 9 * len(oracle), "control cardinality differs") + entries = list(struct.iter_unpack(" Date: Tue, 17 Nov 2026 22:47:19 +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")