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") diff --git a/research/rounded-program-affine-hull/PROOF.md b/research/rounded-program-affine-hull/PROOF.md new file mode 100644 index 0000000000..28f93a306f --- /dev/null +++ b/research/rounded-program-affine-hull/PROOF.md @@ -0,0 +1,172 @@ +# Exact images and affine-lattice hulls of rounded-linear programs + +## 1. Contract + +Let the independent parameters be `z in Z^k`, with finite `k >= 1`. +A program has finitely many scalar registers. Its initial registers and +every unrounded assignment are rational affine combinations of `z` and +previous registers. A rounded assignment applies + + R(t) = floor(t + 1/2) + +to such a rational affine combination. Outputs are any fixed list of +registers. Write the resulting map as `F: Z^k -> Q^m`. + +This includes a rational affine entrance `x=x0+Bz`, correlated or redundant +parameters, separately rounded shears and rational rescaling. A fixed +rational-grid rounder is a composition of rational scaling, R and scaling +back. No variable products, data-dependent branches, unbounded iteration, +overflow or saturation are included. A finite unrolled sequence is allowed. + +An affine lattice means `y+Lambda`, where Lambda is a finitely generated +additive subgroup of `Q^m`. Its rank may be less than m. These groups are +discrete in their real linear spans because their generators are rational. +All integer combinations use signed, unbounded integer coefficients. + +## 2. A computable translation lattice + +Replace each occurrence of R by the identity map. Propagate the linear +coefficient row of each register with respect to z through this idealized +program. Let `d_j in Q^(1 x k)` be the idealized coefficient row of the +argument of rounded assignment j, and let `M in Q^(m x k)` be the final +output coefficient matrix. Affine constants do not enter these rows. + +Choose any finite-index subgroup `H <= Z^k` such that + + d_j h is an integer for every rounded assignment j and every h in H. (1) + +Such a subgroup always exists. If q is the least common multiple of all +denominators in all d_j, with q=1 when there are no rounded assignments, +then `q Z^k` satisfies (1). Alternatively, the kernel of the finite-image +map `h -> (d_j h mod Z)_j` gives a possibly larger H. Neither choice is +asserted to be the maximal translation subgroup of F. + +**Translation lemma.** For every z in `Z^k` and h in H, + + F(z+h) = F(z) + M h. (2) + +Proof. Induct through the actual program. Initially each register has +exactly its idealized linear drift on replacing z by z+h. Rational affine +combinations preserve this property. At rounded assignment j, the induction +hypothesis makes the actual argument drift exactly `d_j h`. This is an +integer by (1), and `R(t+n)=R(t)+n` for every real t and integer n, including +negative t and half-integer ties. Thus the rounded register has the same +drift as its idealized counterpart. The output rows give (2). No linearity +of the rounded program has been assumed. + +## 3. Exact output set and its smallest affine lattice + +Let C be any complete set of representatives of `Z^k/H`, containing 0, +and let `h_1,...,h_k` be an integer basis of H. Define + + L0 = M H = sum_i Z (M h_i), + G = L0 + sum_(c in C) Z (F(c)-F(0)). + +**Theorem.** The complete, unbounded output set and its smallest containing +affine lattice are exactly + + F(Z^k) = union_(c in C) (F(c) + L0), (3) + hull_Z(F(Z^k)) = F(0) + G. (4) + +Proof of (3). Every z is uniquely c+h with c in C and h in H. Equation +(2) gives `F(z)=F(c)+Mh`. Conversely every element of `F(c)+MH` equals +`F(c+h)` for some h in H. Both inclusions therefore hold, even when M +has a kernel or L0 has smaller rank than the output space. + +Proof of (4). Formula (3) places every output in `F(0)+G`. Conversely, +suppose an affine lattice contains all outputs. Since it contains F(0), +write it as `F(0)+Lambda`. It contains each difference `F(c)-F(0)`. +It also contains `F(h_i)-F(0)=M h_i`. Therefore `G <= Lambda`. +This proves minimality among all affine lattices, including skew lattices +and lattices with lower rank. It proves independence from C, its basis and +the permissible H used to compute the answer. + +For the rectangular choice `H=q Z^k`, (4) gives an explicit finite +generating list with at most `q^k - 1 + k` vectors: + + F(c)-F(0) for c in {0,...,q-1}^k except 0, + q M e_i for i=1,...,k. (5) + +This is an exact finite reduction, not a polynomial-time bound. The +denominator product or the number of input parameters can make q^k large. +No optimality of this generating-list length or period is claimed. + +## 4. Necessary and sufficient closure test + +For a proposed rational target affine lattice `y0+Lambda`, the following +three finite conditions are jointly necessary and sufficient: + + F(0)-y0 belongs to Lambda; + M h_i belongs to Lambda for every basis vector h_i of H; + F(c)-F(0) belongs to Lambda for every c in C. (6) + +This follows directly from (4), or from both inclusions of (3). Membership +in a rational finitely generated lattice is an exact integer-module +problem after clearing denominators. Thus (6) is a decision procedure, +with no numerical tolerance and no bounded-reachability assumption. + +For a sequence of separately specified input and target lattices, applying +(6) at every boundary proves preservation by induction from an admitted +entrance. This is a conditional interface implication. It neither proves +that the chosen entrance describes an actual selected caller nor states +that replacing a nonlinear reachable set by its hull preserves all its +nonlattice information. The lattice hull is the strongest *affine-lattice* +consequence of the given complete parameter domain. + +## 5. Why residue outputs alone are insufficient + +Consider the separately rounded shear on a new input domain + + x=3n, y=2m, + F(n,m) = (3n, 2m + R(3n/2)). + +Here q=2 is a valid rectangular period and + + M = [[3,0],[3/2,2]], + F(0,0) = (0,0), + q M e_1 = (6,3), q M e_2 = (0,4). + +All four residue outputs for `n,m in {0,1}` have even second coordinate. +Checking only these outputs would incorrectly admit target `3Z x 2Z`. +The actual output `F(2,0)=(6,3)` rejects it. The missing obligation is the +drift generator, not another residue representative. + +The residue difference `(3,2)`, the generator `(6,3)` and the residue +difference `(0,2)` generate precisely `3Z x Z`: subtract twice `(3,2)` +from `(6,3)` to obtain `(0,-1)`, then obtain `(3,0)`. Every output has +first coordinate divisible by 3, proving the reverse containment. +Consequently the exact hull is `3Z x Z`, while `(0,1)` belongs to this +hull and is not an output. This distinguishes the hull from the output set. +The idealized output lattice contains `(3,3/2)`, so it would incorrectly +reject the actually valid target `3Z x Z`. Thus ideal-image-only testing +can also give a false closure verdict, in the other direction. + +For this example the larger H with basis `(2,0),(0,1)` uses just two +residue representatives, with drift generators `(6,3),(0,2)`. It yields +the same hull. The proof does not require the rectangular period to be +minimal. + +## 6. Evidence and scope + +The written induction and subgroup argument prove the quantified result. +The companion verifier corroborates it on nested and two-input rational +programs. Its second route computes the integer lattice generated by +literal outputs in a larger signed parameter box, without idealizing any +rounding node. It also checks actual translation identities and explicit +failures of residue-only and ideal-image-only shortcuts. + +woklerx #1848 supplies the source question about closure under intervening +updates and the separate mixed-precision cancellation interface. Adam Gall +#1908 already shows that ideal closure does not imply actual rounded-leaf +closure. Nick Petalas #6446 classifies common invariant planar lattices for +opposite rounded shears. Their results are cited rather than replayed, and +the theorem here does not depend on any of their numerical certificates. +Integer-translation equivariance, lattice normal forms and finite-coset +reasoning are classical. No literature-wide priority is claimed for those +ingredients. The new contribution is this exact output-set/hull formula +and finite closure criterion for the stated rounded-program interface. + +No particular selected native program is admitted. Actual reachable input +domains, physical owners, restoration, movement/storage/precision charges, +the full recursive invoice and the selected five framework assumptions +remain separate. There is no new kappa or complete multiplication theorem. diff --git a/research/rounded-program-affine-hull/README.md b/research/rounded-program-affine-hull/README.md new file mode 100644 index 0000000000..9571157e2a --- /dev/null +++ b/research/rounded-program-affine-hull/README.md @@ -0,0 +1,140 @@ +# Exact affine-lattice output hulls for rounded-linear programs + +This contribution was produced by Nick Petalas. Apache-2.0. +Claim type: scoped written proof with exact finite corroboration. + +For every finite rational rounded-linear program on integer parameters, +the complete output set is a computable finite union of translates of one +lattice. Its smallest containing affine lattice has an explicit finite +generating set. This gives a necessary and sufficient test for closure in +any proposed rational affine target lattice, including changing domains +and internally nested rounding nodes. + +For `R(t)=floor(t+1/2)`, replace each rounding node by the identity and +propagate its argument's rational linear row. Let q clear every denominator +in these rows, M be the idealized output matrix and `C={0,...,q-1}^k`. +Then the new exact formulas are + +```text +F(Z^k) = union_(c in C) (F(c) + q M Z^k) +hull_Z(F(Z^k)) = F(0) + span_Z({q M e_i}_i, {F(c)-F(0)}_c) +``` + +[PROOF.md](PROOF.md) proves translation equivariance by induction through +the actual rounded program and proves both equalities and minimality. +A larger permissible translation lattice may reduce the residue set. +The rectangular formula uses at most `q^k-1+k` generators; it makes no +polynomial-time or minimal-period claim. + +The distinction between residues and drift matters. On the entrance +`x=3n, y=2m`, the shear `(x,y) -> (x,y+R(x/2))` has even second coordinates +on all four q=2 residue representatives. Nevertheless `F(2,0)=(6,3)`. +Its exact affine-lattice hull is `3Z x Z`, while the proposed target +`3Z x 2Z` fails. Ideal-image and residue-only closure tests both miss +information supplied by the formula. The output set itself is smaller +than its hull. + +## Evidence and reproduction + +From the repository root with standard-library CPython 3.12: + +```sh +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -I -W error -B research/rounded-program-affine-hull/verify.py +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -I -O -W error -B research/rounded-program-affine-hull/verify.py +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -B scripts/research_package.py --package research/rounded-program-affine-hull +/Users/nick/git/integer-mult-bounds/.venv/bin/python3.12 -B scripts/check_research_commit.py --package research/rounded-program-affine-hull --check-source-history +``` + +Another CPython 3.12 path may substitute. The last command requires the +committed package. Direct verification is read-only and Git-free. It prints +a generated JSON receipt bound to all six package source hashes, followed +by `PASS_ROUNDED_PROGRAM_AFFINE_HULL`. Both direct modes are registered in +[VERIFY.json](VERIFY.json); the runner reports `PASS_REGISTERED_RESEARCH_PACKAGE`. + +The finite census contains 80 one-parameter nested-rounding programs and +256 two-parameter rounded-shear programs with rational affine entrances. +Across these 336 programs it checks 3,904 residue outputs, 33,696 literal +outputs in signed parameter boxes and 6,336 affine target-closure comparisons. +The literal-output route generates its lattice without idealizing the +rounding nodes. All translation identities and hull comparisons agree. +These are enumerated fixtures, not a count of distinct functions. + +An independent determinantal-minor check and rank-one content check cover +all 729 ordered triples of planar vectors with coordinates in `{-1,0,1}`. +Fourteen named semantic controls cover the drift counterexample, ideal +image, nested denominators, signed ties, a smaller nonrectangular period, +rank-zero and unrounded rational maps. Five malformed-program cases reject. +The universal statements rest on the written proof, rather than this census. + +## Source, credit and scope + +Credit woklerx [#1848](https://github.com/CrocSwap/integer-mult-bounds/pull/1848), +head `d975e19e7e931fc2b45792a4f7140ac13759a7da`, for the explicit question +about closure under intervening rounded updates and the affine-domain +mixed-precision interface. Its cancellation theorem is a cited result. +Retain Gareth Davidson, Chafik Boukhalfa and Ali Romman's precision and +dirty-restoration lineage credited there. + +Adam Gall [#1908](https://github.com/CrocSwap/integer-mult-bounds/pull/1908) +already gives a source-specific internally rounded-leaf counterexample. +Nick Petalas [#6446](https://github.com/CrocSwap/integer-mult-bounds/pull/6446) +classifies a common invariant integer lattice for opposite planar rounded +shears. Those contracts are related context; neither result nor executable +is used as a step in this proof. Their numerical certificates are not +replayed. The new formula and general closure criterion above are the +contribution. The elementary translation, coset and integer-lattice +methods are classical, with no literature-wide priority claim. + +[TASK.json](TASK.json) records a change from the caller-specific +`uniform-transfer-audit` card to this general precision-interface lemma. +The [advance CLAIM](https://github.com/CrocSwap/integer-mult-bounds/discussions/1166#discussioncomment-19572796) +states the same mathematical scope. Canonical base is +`e54523517d0f03e58352e647c403a5af3e525a57`, priority revision 8 and selected +#7000. [SOURCES.json](SOURCES.json) binds the source question and related +packages as historical provenance. There are no external runtime inputs. + +Live open PRs, this account's recent work, the latest handoff posts, +active discussions, local reservations, main-tree README terms and merged +PR searches were checked. The cached card scan covered 768 open PRs, +7,355 Discussion records and 10,178 local note records, with separately +reported freshness. A dedicated author/date scan of 768 open and 6,175 +closed PRs found no recent account PR referencing #1848. Searches cover +titles, bodies and notes, not every code diff or unpublished result. + +## Limits and verification design + +The contract has fixed rational affine arithmetic and half-up rounding, +with finitely many nodes and unrestricted integer parameters. Variable +products, data-dependent branches, overflow and saturation are excluded. +The output lattice need not equal the actual reachable set. Replacing +a reachable set by its hull discards nonlattice information. + +No actual selected caller, entrance contract or useful precision policy +is established. Complete native implementation, owners and restoration, +movement/storage/precision charges, recursive invoice and all five selected +framework assumptions remain open. No new kappa, supplier admission, +selected-frontier change or complete multiplication theorem is claimed. +Independent human and formal proof-kernel review are unclaimed. No +predecessor scientific replay, selected cold replay, Lean or Docker run +was performed. + +The verifier has no recursion, subprocesses, external libraries or writes. +Its fixture contract limits inputs to two parameters, eight nodes and +period at most 12. Each literal parameter box therefore has at most 1,296 +points; only one program's vectors are live. Package source reads are +capped at 128 KiB each. All checks remain active under optimized Python. +Functions fit within 60 physical lines. Python's dynamic allocation is +a managed-runtime deviation from fixed memory; these bounds constrain +live collections, while no allocation-free or static-analyzer claim is +made. Warning-strict normal and optimized execution provide the available +interpreter diagnostics. + +## Open next questions + +Apply the criterion to one literal selected rounded caller with an admitted +rational affine entrance. First extract its fixed rounded-linear fragment +and compute the residue outputs and drift vectors, then test the next +required source domain. The caller's exact entrance and reachability, +later inverse compatibility and complete precision, movement, storage and +restoration bill remain blockers. No continuation is part of this result; +the structured question is in [TASK.json](TASK.json). diff --git a/research/rounded-program-affine-hull/SOURCES.json b/research/rounded-program-affine-hull/SOURCES.json new file mode 100644 index 0000000000..6120962875 --- /dev/null +++ b/research/rounded-program-affine-hull/SOURCES.json @@ -0,0 +1,36 @@ +{ + "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/affine-lattice-inverse-precision/README.md", + "usage": "provenance", + "git_blob": "01d4a83e39092d609b16f81772b8bd057522abd7", + "sha256": "e28d3637dcb322c12205f5754656393f7d066f715a9653a794b879f2e8707373" + }, + { + "path": "research/rounded-leaf-lattice-closure/README.md", + "usage": "provenance", + "git_blob": "505a6b7d6e833b32cb3b6893522dab64a174311f", + "sha256": "8346e7579c265c5c4d96bd61f25c954422ccd74394eca63f41f564085e4f75b8" + }, + { + "path": "research/rounded-shear-lattice-closure/README.md", + "usage": "provenance", + "git_blob": "5d1c98c8cfb62ad29531472000a8385a9571cda3", + "sha256": "dd69ded761a095392f97a620df89227f552991fcb530282d62a2a96daa39095c" + } + ] +} diff --git a/research/rounded-program-affine-hull/TASK.json b/research/rounded-program-affine-hull/TASK.json new file mode 100644 index 0000000000..e235977c6b --- /dev/null +++ b/research/rounded-program-affine-hull/TASK.json @@ -0,0 +1,105 @@ +{ + "schema_version": 1, + "task_id": "uniform-transfer-audit", + "priority_revision": 8, + "base_commit": "e54523517d0f03e58352e647c403a5af3e525a57", + "original_card": { + "id": "uniform-transfer-audit", + "question": "Can one of the selected record's five inherited assumptions be proved at its actual caller?", + "starting_points": [ + "docs/research/current-priorities.md", + "docs/research/research-family-status.md", + "certificates/selected-result.json", + "docs/research/pr-intake-evidence/pr5599-completion/PROOF-REVIEW.md" + ], + "methods": [ + "Construct and independently check one source-bound instance of the stated first experiment.", + "Seek an exact counterexample or target-specific complete-budget obstruction to that same proposed change." + ], + "acceptance_gate": "Identify the proposition and what would change downstream; do not equate a finite replay with a universal proof.", + "first_step": { + "command": [ + "python3", + "-B", + "scripts/research_selected_baseline.py" + ], + "expected": "PASS_RESEARCH_BASELINE_BINDINGS_ONLY", + "inspect": "Read revision 8, the selected review and live exact-source handoffs. Then follow this card's bounded first_experiment.", + "scope": "Source-bound orientation only, not a supplier replay or theorem proof." + }, + "first_experiment": "Choose one assumption ID (native_all_columns, owned_erasure, compiler, precision_tape, analytic_recovery), one quantified implication and exact dependency closure. Check current handoffs, including #5625 row reentry and #5707 root-prefix lowering, without treating their partial scope as the whole theorem. Prove or falsify that implication with a caller-bound argument; stop at the chosen obligation. Finite tests or root digits do not discharge an all-size statement.", + "bottleneck_link": "Judge the actual current supplier contract and complete signed target/paid bill; frozen-profile ceilings require an applicability proof.", + "allowed_variations": [ + "One exact source head, helper/cut region or quantified proposition and changed hypothesis; check live handoffs first. Different seeds are not different scopes." + ], + "scope_change_triggers": [ + "Changing source head, helper/cut domain, operation alphabet or caller boundary without recording the new scope.", + "Treating an archived proposal or local numerical pass as complete supplier admission." + ], + "overlap_terms": [ + "native_all_columns", + "owned_erasure", + "compiler", + "precision_tape", + "analytic_recovery" + ], + "existing_checks": [ + { + "scope": "PR #4100: proposed unconditional construction and finite checks, without independent acceptance.", + "evidence": "research/unconditional-batched-crt/README.md", + "remaining": "Independent proof audit of one caller-bound all-size implication; all other premises remain explicit.", + "status": "author-checked", + "source_commit": "337d04939571a637aeab54a0f58f54fde811663a", + "selected_record_sha256": "bb2eaa58647b353f88d0aec2eafb9d30df1be53589231b23e12ceef3e4bad129" + }, + { + "scope": "Selected PR5599: complete helper-subspace construction and independent caller replay; five framework assumptions remain.", + "evidence": "docs/research/pr-intake-evidence/pr5599-completion/PROOF-REVIEW.md", + "remaining": "The next experiment must identify uncovered source-specific work. Successor archive intake does not transfer this admission.", + "status": "reviewed", + "source_commit": "09dd0965711ca7eeb169057a420abab1c9052137", + "selected_record_sha256": "2a0220e866417774606e0f991e41b9c1d26b1f43b97857238cf478dbc7d330b5" + } + ] + }, + "scope_status": "changed", + "actual_scope": "Prove exact finite-coset output images, smallest affine-lattice hulls and a necessary-and-sufficient target-lattice closure test for finite rational rounded-linear programs on integer parameters.", + "scope_change_reason": "The card asks about a selected caller. This contribution supplies a new general interface lemma motivated by PR1848, with no selected-caller application or discharge of a framework assumption.", + "bottleneck_link": "Correlated precision policies need preservation through actual rounded updates. The finite closure criterion retains both residue outputs and drift generators, avoiding ideal-map and residue-only shortcuts.", + "budget_minutes": 60, + "stop_rule": "Stop at the first proved output-hull and closure theorem. Do not extend to an actual selected program or optimize the finite residue enumeration.", + "outcome": "completed", + "evidence": "PROOF.md supplies the quantified proof; verify.py corroborates 336 rational programs with 33,696 literal signed-box outputs, 3,904 residue outputs and 6,336 target affine-lattice closure comparisons.", + "author": "Nick Petalas", + "ai_assistance": "Independent human and formal proof-kernel review are unclaimed.", + "open_questions": [ + { + "question": "Can one literal selected rounded caller preserve a useful affine source domain under this criterion?", + "why_it_matters": "A safe source lattice can support a precision policy only after every reached boundary is proved compatible.", + "first_step": "Extract one fixed rounded-linear fragment and its admitted rational affine entrance; generate its residue outputs and drift vectors, then test the required next source domain.", + "blocked_by": "The exact entrance/reachability contract and complete precision, movement, storage and restoration costs remain unproved." + } + ], + "claim_type": "scoped written proof with exact finite corroboration", + "claim_url": "https://github.com/CrocSwap/integer-mult-bounds/discussions/1166#discussioncomment-19572796", + "source_question": { + "pr": 1848, + "author": "woklerx", + "head": "d975e19e7e931fc2b45792a4f7140ac13759a7da", + "path": "research/affine-lattice-inverse-precision/README.md", + "section": "Open next questions" + }, + "environment": { + "python": "3.12.15", + "implementation": "CPython", + "platform": "macOS-27.0.1-arm64-arm-64bit", + "dependencies": "standard library only" + }, + "upstream_checkpoint": { + "canonical_main": "e54523517d0f03e58352e647c403a5af3e525a57", + "checked_at": "2026-11-12T19:23:26Z", + "priority_revision": 8, + "selected_pr": 7000, + "selected_kappa": "363005817/100000000000" + } +} diff --git a/research/rounded-program-affine-hull/VERIFY.json b/research/rounded-program-affine-hull/VERIFY.json new file mode 100644 index 0000000000..402788940f --- /dev/null +++ b/research/rounded-program-affine-hull/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": "Exact translation and output-lattice identities, target closure comparisons, independently checked planar normal forms and rejecting boundary controls; generated hash-bound stdout receipt." + }, + { + "argv": [ + "{python}", + "-I", + "-O", + "-W", + "error", + "-B", + "{package}/verify.py" + ], + "timeout_seconds": 120, + "checks": "Exact translation and output-lattice identities, target closure comparisons, independently checked planar normal forms and rejecting boundary controls; generated hash-bound stdout receipt." + } + ] +} diff --git a/research/rounded-program-affine-hull/verify.py b/research/rounded-program-affine-hull/verify.py new file mode 100644 index 0000000000..71abb81a10 --- /dev/null +++ b/research/rounded-program-affine-hull/verify.py @@ -0,0 +1,302 @@ +#!/usr/bin/env python3 +"""Exact bounded corroboration of PROOF.md; standard library, no writes.""" + +from fractions import Fraction as Q +from hashlib import sha256 +from itertools import product +from math import gcd, lcm +from pathlib import Path +import json + +type Step = tuple[bool, tuple[tuple[int, Q], ...], Q] +type Program = tuple[int, tuple[Step, ...], tuple[int, int]] +type Vector = tuple[Q, Q] + +MAX_STEPS = 8 +MAX_PERIOD = 12 +PACKAGE_FILES = ( + "PROOF.md", "README.md", "SOURCES.json", "TASK.json", "VERIFY.json", "verify.py" +) + + +def require(condition: bool, message: str) -> None: + if not condition: + raise ValueError(message) + + +def round_half_up(value: Q) -> Q: + shifted = value + Q(1, 2) + return Q(shifted.numerator // shifted.denominator) + + +def program(k: int, steps: tuple[Step, ...], outputs: tuple[int, int]) -> Program: + require(type(k) is int and 1 <= k <= 2, "parameter count") + require(1 <= len(steps) <= MAX_STEPS, "step count") + for position, (rounded, terms, offset) in enumerate(steps): + require(type(rounded) is bool and isinstance(offset, Q), "step fields") + require(len(terms) <= MAX_STEPS + 2, "term count") + for index, coefficient in terms: + require(type(index) is int and 0 <= index < k + position, "reference") + require(isinstance(coefficient, Q), "coefficient") + require(abs(coefficient) <= 12 and coefficient.denominator <= 12, + "coefficient bound") + require(abs(offset) <= 12 and offset.denominator <= 12, "offset bound") + require(len(outputs) == 2 and all(type(i) is int and 0 <= i < k + len(steps) + for i in outputs), "outputs") + return k, steps, outputs + + +def evaluate(p: Program, z: tuple[int, ...]) -> Vector: + k, steps, outputs = p + require(len(z) == k and all(type(x) is int for x in z), "parameter tuple") + values = [Q(x) for x in z] + for rounded, terms, offset in steps: + value = offset + sum((c * values[i] for i, c in terms), Q(0)) + values.append(round_half_up(value) if rounded else value) + return values[outputs[0]], values[outputs[1]] + + +def linear_data(p: Program) -> tuple[int, tuple[tuple[Q, ...], ...]]: + k, steps, outputs = p + rows = [tuple(Q(i == j) for j in range(k)) for i in range(k)] + period = 1 + for rounded, terms, _offset in steps: + row = tuple(sum((c * rows[i][j] for i, c in terms), Q(0)) + for j in range(k)) + if rounded: + period = lcm(period, *(x.denominator for x in row)) + rows.append(row) + require(period <= MAX_PERIOD, "period capacity") + return period, tuple(rows[i] for i in outputs) + + +def subtract(left: Vector, right: Vector) -> Vector: + return left[0] - right[0], left[1] - right[1] + + +def integer_basis(vectors: list[tuple[int, int]]) -> tuple[tuple[int, int], ...]: + """Column Hermite basis using Bezout on the first coordinate.""" + first, second = 0, 0 + for x, y in vectors: + if x == 0: + continue + if first == 0: + first, second = abs(x), y if x > 0 else -y + continue + divisor = gcd(first, x) + modulus = abs(x) // divisor + a = pow(first // divisor, -1, modulus) if modulus > 1 else 0 + b = (divisor - a * first) // x + require(a * first + b * x == divisor, "Bezout identity") + first, second = divisor, a * second + b * y + if first == 0: + vertical = gcd(*(y for _x, y in vectors)) + return ((0, vertical),) if vertical else () + vertical = gcd(*(y - (x // first) * second for x, y in vectors)) + if vertical: + return (first, second % vertical), (0, vertical) + return ((first, second),) + + +def rational_basis(vectors: list[Vector]) -> tuple[int, tuple[tuple[int, int], ...]]: + denominator = lcm(*(v.denominator for row in vectors for v in row)) + scaled = [(int(x * denominator), int(y * denominator)) for x, y in vectors] + return denominator, integer_basis(scaled) + + +def same_lattice(left: list[Vector], right: list[Vector]) -> bool: + denominator = lcm(*(v.denominator for row in left + right for v in row)) + a = [(int(x * denominator), int(y * denominator)) for x, y in left] + b = [(int(x * denominator), int(y * denominator)) for x, y in right] + return integer_basis(a) == integer_basis(b) + + +def in_hermite(v: Vector, h: int, r: int, k: int) -> bool: + first = v[0] / h + return first.denominator == 1 and ((v[1] - r * first) / k).denominator == 1 + + +def certificate(p: Program) -> tuple[int, Vector, list[Vector], dict]: + k = p[0] + q, matrix = linear_data(p) + base = evaluate(p, (0,) * k) + residues = {c: evaluate(p, c) for c in product(range(q), repeat=k)} + drift = [tuple(q * matrix[j][i] for j in range(2)) for i in range(k)] + generators = drift + [subtract(v, base) for v in residues.values()] + return q, base, generators, residues + + +def check_program(p: Program) -> dict[str, int]: + q, base, generators, residues = certificate(p) + k = p[0] + _q, matrix = linear_data(p) + literal = [] + for z in product(range(-q, 2 * q), repeat=k): + value = evaluate(p, z) + residue = tuple(x % q for x in z) + displacement = tuple(x - r for x, r in zip(z, residue, strict=True)) + expected = tuple(residues[residue][j] + sum( + (matrix[j][i] * displacement[i] for i in range(k)), Q(0)) + for j in range(2)) + require(value == expected, "actual translation identity") + literal.append(subtract(value, base)) + require(same_lattice(generators, literal), "literal output hull") + closure_checks = 0 + if q <= 2: + for h, k2 in product(range(1, 4), repeat=2): + for r in range(k2): + for offset in (Q(0), Q(1, 2)): + anchor = subtract(base, (offset, Q(0))) + claimed = all(in_hermite(v, h, r, k2) + for v in [anchor] + generators) + observed = all(in_hermite(v, h, r, k2) + for v in [anchor] + literal) + require(claimed == observed, "target affine closure") + closure_checks += 1 + return {"programs": 1, "literal_outputs": len(literal), + "residue_outputs": len(residues), "closure_checks": closure_checks} + + +def nested_program(a: Q, b: Q, alpha: Q, beta: Q) -> Program: + return program(1, ( + (True, ((0, a),), alpha), + (True, ((1, b),), beta), + (False, ((2, Q(1, 3)),), Q(0)), + ), (0, 3)) + + +def shear_program(h: int, r: int, k: int, a: Q, b: Q, + alpha: Q, beta: Q) -> Program: + return program(2, ( + (False, ((0, Q(h)),), Q(1, 3)), + (False, ((0, Q(r)), (1, Q(k))), Q(-1, 4)), + (True, ((2, a),), alpha), + (False, ((3, Q(1)), (4, Q(1))), Q(0)), + (True, ((5, b),), beta), + (False, ((2, Q(1)), (6, Q(1))), Q(0)), + ), (7, 5)) + + +def census() -> dict[str, int]: + totals = dict(programs=0, literal_outputs=0, residue_outputs=0, closure_checks=0) + slopes_a = tuple(Q(x, 2) for x in (-3, -1, 0, 1, 3)) + slopes_b = (Q(-2, 3), Q(0), Q(2, 3), Q(3, 2)) + for a, b, alpha, beta in product(slopes_a, slopes_b, (Q(0), Q(1, 2)), + (Q(0), Q(1, 2))): + result = check_program(nested_program(a, b, alpha, beta)) + totals = {key: totals[key] + result[key] for key in totals} + slopes = (Q(-1, 2), Q(0), Q(1, 2), Q(2, 3)) + for h, r, k in ((1, 0, 1), (2, 0, 1), (3, 0, 2), (2, 1, 3)): + for a, b, alpha, beta in product(slopes, slopes, (Q(0), Q(1, 2)), + (Q(0), Q(1, 2))): + result = check_program(shear_program(h, r, k, a, b, alpha, beta)) + totals = {key: totals[key] + result[key] for key in totals} + require(totals["programs"] == 336, "complete program inventory") + return totals + + +def basis_controls() -> int: + """Compare full-rank normal-form indices with every two-column minor.""" + vectors = tuple(product(range(-1, 2), repeat=2)) + for rows in product(vectors, repeat=3): + basis = integer_basis(list(rows)) + minors = gcd(*(a * d - b * c for a, b in rows for c, d in rows)) + if minors: + require(len(basis) == 2, "full-rank normal form") + require(basis[0][0] * basis[1][1] == minors, "index from minors") + else: + require(len(basis) <= 1, "rank-deficient normal form") + nonzero = [v for v in rows if v != (0, 0)] + if nonzero: + x, y = nonzero[0] + content = gcd(x, y) + sign = 1 if x > 0 or (x == 0 and y > 0) else -1 + unit = (sign * x // content, sign * y // content) + scale = gcd(*(coordinate for v in rows for coordinate in v)) + require(basis == ((scale * unit[0], scale * unit[1]),), + "rank-one normal form") + else: + require(basis == (), "zero normal form") + for x, y in rows: + if len(basis) == 2: + h, r = basis[0] + require(in_hermite((Q(x), Q(y)), h, r, basis[1][1]), "basis spans") + return len(vectors) ** 3 + + +def semantic_controls() -> dict: + p = program(2, ( + (False, ((0, Q(3)),), Q(0)), + (False, ((1, Q(2)),), Q(0)), + (True, ((2, Q(1, 2)),), Q(0)), + (False, ((3, Q(1)), (4, Q(1))), Q(0)), + ), (2, 5)) + q, base, generators, residues = certificate(p) + reduced_h = [(Q(6), Q(3)), (Q(0), Q(2)), (Q(3), Q(2))] + nested = nested_program(Q(1, 2), Q(1, 2), Q(0), Q(0)) + zero = program(1, ((True, ((0, Q(0)),), Q(1, 3)),), (1, 1)) + linear = program(1, ((False, ((0, Q(2, 3)),), Q(1, 4)),), (0, 1)) + checks = { + "example period and origin": q == 2 and base == (0, 0), + "residue screen passes": all(in_hermite(v, 3, 0, 2) for v in residues.values()), + "literal drift witness": evaluate(p, (2, 0)) == (6, 3), + "omit-drift rejects": not all(in_hermite(v, 3, 0, 2) for v in generators), + "exact hull": same_lattice(generators, [(Q(3), Q(0)), (Q(0), Q(1))]), + "ideal-image rejects": not in_hermite((Q(3), Q(3, 2)), 3, 0, 1) + and all(in_hermite(v, 3, 0, 1) for v in generators) + and not same_lattice(generators, [(Q(3), Q(3, 2)), (Q(0), Q(2))]), + "nonrectangular period": same_lattice(generators, reduced_h), + "hull not image finite control": all( + evaluate(p, (0, m)) != (0, 1) for m in range(-3, 4)), + "nested denominator": linear_data(nested)[0] == 4, + "actual inner rounding": evaluate(nested, (1,))[1] == Q(1, 3), + "invalid period two rejects": evaluate(nested, (2,))[1] != Q(1, 6), + "signed ties": round_half_up(Q(-1, 2)) == 0 and round_half_up(Q(1, 2)) == 1, + "rank-zero image": rational_basis(certificate(zero)[2]) == (1, ()), + "unrounded rational map": linear_data(linear)[0] == 1, + } + for name, condition in checks.items(): + require(condition, name) + check_program(zero) + check_program(linear) + return {"example_hull": "3Z x Z", "example_rejected_target": "3Z x 2Z", + "example_drift_witness": [6, 3], "semantic_controls": list(checks)} + + +def invalid_controls() -> int: + invalid = ( + (0, ((False, ((0, Q(1)),), Q(0)),), (0, 0)), + (1, ((False, ((1, Q(1)),), Q(0)),), (0, 0)), + (1, ((False, ((0, 1),), Q(0)),), (0, 0)), + (1, ((False, ((0, Q(1, 13)),), Q(0)),), (0, 0)), + (1, ((False, ((0, Q(1)),), Q(0)),), (0, 2)), + ) + rejected = 0 + for args in invalid: + try: + program(*args) + except ValueError: + rejected += 1 + require(rejected == len(invalid), "invalid inputs must reject") + return rejected + + +def main() -> None: + result = census() + result["basis_controls"] = basis_controls() + result.update(semantic_controls()) + result["invalid_controls"] = invalid_controls() + directory = Path(__file__).resolve().parent + hashes = {} + for name in PACKAGE_FILES: + source = directory / name + require(source.stat().st_size <= 128 * 1024, "package source capacity") + data = source.read_bytes() + require(len(data) <= 128 * 1024, "package source capacity") + hashes[name] = sha256(data).hexdigest() + print(json.dumps({"result": result, "sha256": hashes}, sort_keys=True)) + print("PASS_ROUNDED_PROGRAM_AFFINE_HULL") + + +if __name__ == "__main__": + main()