Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
ec535bc
feat(cpu): add opt-in accepted liquid pressure initialization
Oct 13, 2026
3569d3b
fix(cpu): preserve seeded conjugacy on gauge-only rejection
Oct 13, 2026
7f1733f
test(cpu): qualify accepted pressure warm starts
Oct 13, 2026
0b3e3fc
fix(perf): integrate warm starts behind explicit liquid feature
Oct 21, 2026
a5701ca
docs(perf): retain exact warm-start integration review
Oct 21, 2026
6956499
docs(perf): preserve preliminary regressions and artifact correction
Oct 21, 2026
4c8c890
docs(perf): state supported warm-start scope and pending gates
Oct 21, 2026
2cd25ae
docs(perf): freeze equal-path controls before final timing
Oct 21, 2026
33f1ecf
docs(perf): retain completed preliminary CI outcomes
Oct 21, 2026
d0452c7
docs(perf): clarify warm publication recording refusal
Oct 21, 2026
ca9e640
fix(pressure): compose warm history with immutable native projection
Oct 21, 2026
e9e85c2
docs(pressure): bind preliminary composition review and controls rule
Oct 21, 2026
540e8a6
docs(pressure): retain composed recording contract results
Oct 21, 2026
d36a97d
docs(pressure): retain desktop and warm feature compatibility check
Oct 21, 2026
cd3b25b
docs(pressure): state immutable projection and admission boundaries
Oct 21, 2026
6975421
docs(pressure): freeze independently reviewed default control analyzer
Oct 21, 2026
c33f029
fix(pressure): retain reviewed reference dependencies in warm composi…
MrScripty Oct 22, 2026
4d93d68
perf(pressure): admit optional warm-start source on ordered main
MrScripty Oct 22, 2026
fe4fdca
Merge PR #59 (accepted pressure warm start, opt-in) into main
MrScripty Nov 19, 2026
7067856
Merge main (water/air, VTK 9.7.2, hash gate removal) into PR #59
MrScripty Nov 19, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .github/workflows/rust-rheon.yml
Original file line number Diff line number Diff line change
Expand Up @@ -87,6 +87,8 @@ jobs:
flags: --no-default-features
- mode: desktop
flags: --features desktop
- mode: accepted-pressure-warm-start
flags: --features accepted-pressure-warm-start
steps:
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683
with:
Expand Down
6 changes: 6 additions & 0 deletions Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,8 @@ eframe = { version = "=0.33.3", optional = true, default-features = false, featu

[features]
default = ["png-export"]
# Only qualified sealed liquid CPU consumers should enable this optimization.
accepted-pressure-warm-start = []
png-export = ["dep:png"]
force-serde = ["dep:serde", "dep:serde_json"]
parallel = ["dep:rayon"]
Expand Down Expand Up @@ -88,6 +90,10 @@ name = "rheon-ai-compare"
path = "src/bin/rheon-ai-compare.rs"
required-features = ["desktop"]

[[example]]
name = "accepted_pressure_lab"
required-features = ["accepted-pressure-warm-start"]

[dev-dependencies]
# Private Q2 reference: exact represented-source predicates/constructions only.
num-rational = "=0.4.2"
Expand Down
145 changes: 145 additions & 0 deletions docs/plans/accepted-pressure-warm-start/analyze_matrix.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,145 @@
#!/usr/bin/env python3
"""Summarize complete triplets; reject cold numerical differences and lost horizons."""
import argparse
import itertools
import re
import json
import math
from pathlib import Path
import statistics
import sys

from measurement_checks import validate_receipt

parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument('directory', type=Path)
parser.add_argument('--progress', action='store_true', help='incomplete/rejected evidence; never qualifies final coverage')
args = parser.parse_args()
root = args.directory
(root / "summary.json").unlink(missing_ok=True)
orders = {}
repeats = {}
small = [(16,16,16), (32,32,32), (48,24,12)]
expected = {
'primary-small': itertools.product(small, [1,2,4], ['steady','localized'], ['jacobi']),
'primary-64': itertools.product([(64,64,64)], [1,2,4], ['steady','localized'], ['jacobi']),
'controls': itertools.product(small+[(64,64,64)], [1], ['switch','rest','saturated'], ['jacobi']),
'sgs': itertools.product(small[:2], [1], ['steady','localized'], ['sgs']),
}
expected = {group:{'-'.join(map(str,n))+f'-w{w}-{mode}-{method}' for n,w,mode,method in cases} for group,cases in expected.items()}
manifest_files = list(root.glob('*-manifest*.json'))
manifests = [json.loads(path.read_text()) for path in manifest_files]
reference_manifest = manifests[0] if manifests else None
groups = {}
violations = []
replay = {}
ignored = {'startup_s', 'step_s', 'pressure_s', 'capture_s'}
for receipt in sorted(root.glob('*-receipt.json')):
name = receipt.name.removesuffix('-receipt.json')
case = name.rsplit('-r', 1)[0]
try:
match = re.fullmatch(r'(\d+)-(\d+)-(\d+)-w([124])-(steady|localized|switch|rest|saturated)-(jacobi|sgs)-r(\d+)', name)
if match is None:
raise ValueError('unrecognized case name')
nx,ny,nz,workers,mode,method,repeat = match.groups()
records = json.loads(receipt.read_text())
rows = validate_receipt(root, name, records, (nx,ny,nz), workers, mode, method,
reference_manifest['baseline'] if reference_manifest else None,
reference_manifest['candidate'] if reference_manifest else None)
orders.setdefault(case, []).append(tuple(r['variant'] for r in records))
repeats.setdefault(case, []).append(int(repeat))
except (ValueError, KeyError, TypeError, OSError) as error:
violations.append(name + ': invalid receipt/data: ' + str(error))
continue
reference = [{k:v for k,v in r.items() if k not in ignored} for r in rows['base']]
cold = [{k:v for k,v in r.items() if k not in ignored} for r in rows['cold']]
if reference != cold:
violations.append(name + ': candidate cold differs from baseline')
accepted = {variant: sum(r['accepted'] == 'true' for r in values) for variant,values in rows.items()}
if mode != 'saturated' and any(n != 16 for n in accepted.values()):
violations.append(name + ': required full horizon incomplete')
if len(set(accepted.values())) != 1:
violations.append(name + ': acceptance differs ' + str(accepted))
for variant, values in rows.items():
numeric = [{k:v for k,v in r.items() if k not in ignored} for r in values]
replay_key = (case, variant)
if replay_key in replay and replay[replay_key] != numeric:
violations.append(name + ': same-policy replay differs ' + variant)
replay[replay_key] = numeric
if any(r['bytes'] != rows['base'][0]['bytes'] for r in values):
violations.append(name + ': managed memory differs ' + variant)
for r in values:
if r['accepted'] != 'true':
continue
for metric in ['residual_l2','residual_max','divergence','mass_error','energy','max_speed']:
if not math.isfinite(float(r[metric])):
violations.append(name + ': nonfinite ' + variant + ' ' + metric)
if float(r['divergence']) > 1e-5 or float(r['energy']) < 0:
violations.append(name + ': physical gate ' + variant)
if abs(float(r['mass_error'])) > 64*sys.float_info.epsilon*0.5:
violations.append(name + ': mass balance ' + variant)
if 'localized' not in name:
if not math.isfinite(float(r['pressure_error'])) or float(r['pressure_error']) > 1e-6 or float(r['max_speed']) > 1e-7:
violations.append(name + ': independent hydrostatic oracle ' + variant)
warm_first = {k:v for k,v in rows['warm'][0].items() if k not in ignored}
if warm_first != cold[0]:
violations.append(name + ': first warm step differs from cold')
if accepted['base'] == 16:
for variant,values in rows.items():
if values[-1]['time'] != rows['base'][-1]['time'] or [r['dt'] for r in values] != [r['dt'] for r in rows['base']]:
violations.append(name + ': horizon differs ' + variant)
sums = {v: sum(float(r['step_s']) + float(r['capture_s']) for r in rs) for v,rs in rows.items()}
sustained = {v: sum(float(r['step_s']) + float(r['capture_s']) for r in rs[1:]) for v,rs in rows.items()}
item = {'repeat':name, 'accepted':accepted, 'full_s':sums,
'warm_vs_base_pct':100*(sums['warm']/sums['base']-1) if all(n == 16 for n in accepted.values()) else None,
'cold_vs_base_pct':100*(sums['cold']/sums['base']-1) if all(n == 16 for n in accepted.values()) else None,
'warm_vs_cold_pct':100*(sums['warm']/sums['cold']-1) if all(n == 16 for n in accepted.values()) else None,
'sustained_s':sustained,
'startup_s':{v:float(rs[0]['startup_s']) for v,rs in rows.items()},
'step0_s':{v:float(rs[0]['step_s'])+float(rs[0]['capture_s']) for v,rs in rows.items()},
'pressure_phase_s':{v:sum(float(r['pressure_s']) for r in rs) for v,rs in rows.items()},
'capture_s':{v:sum(float(r['capture_s']) for r in rs) for v,rs in rows.items()},
'managed_bytes':{v:int(rs[0]['bytes']) for v,rs in rows.items()},
'iterations':{v:sum(int(r['iterations']) for r in rs if r['accepted'] == 'true') for v,rs in rows.items()},
'rss_kib':{v:int((root/f'{name}-{v}.rss').read_text()) for v in rows}}
groups.setdefault(case,[]).append(item)
if not reference_manifest:
violations.append('missing measurement manifest')
for manifest in manifests:
if manifest.get('group') not in expected or manifest.get('steps') != 16:
violations.append('invalid manifest group or horizon')
if reference_manifest and any(manifest.get(k) != reference_manifest.get(k) for k in ['baseline_sha256','candidate_sha256','baseline','candidate','seed']):
violations.append('inconsistent frozen binaries/protocol across manifests')
all_expected = set.union(*expected.values())
if set(groups) - all_expected:
violations.append('unexpected case set')
for case in groups:
if len(set(orders[case])) != len(orders[case]) or len(orders[case]) > 6:
violations.append(case + ': repeated or excessive orderings')
if sorted(repeats[case]) != list(range(len(repeats[case]))):
violations.append(case + ': repeat gaps')
if not args.progress and (len(orders[case]) != 6 or set(orders[case]) != set(itertools.permutations(['base','cold','warm']))):
violations.append(case + ': incomplete six-permutation coverage')
if not args.progress:
if set(groups) != all_expected:
violations.append('incomplete final case coverage: ' + str(sorted(all_expected-set(groups))))
if {m.get('group') for m in manifests} != set(expected):
violations.append('incomplete final manifest coverage')
if any(m.get('repetitions') != 6 for m in manifests):
violations.append('final manifest is not six-repetition protocol')
prefixes = {p.name.removesuffix('-receipt.json') for p in root.glob('*-receipt.json')}
for path in root.glob('*-r*-*.csv'):
if path.name.rsplit('-',1)[0] not in prefixes:
violations.append('unreceipted raw attempt: ' + path.name)
summary = {}
for case,items in sorted(groups.items()):
metrics = ['warm_vs_base_pct','cold_vs_base_pct','warm_vs_cold_pct']
complete = all(all(n == 16 for n in i['accepted'].values()) for i in items)
values = {m:[i[m] for i in items if i[m] is not None] if complete else [] for m in metrics}
summary[case] = {'repetitions':len(items), **{m:{'median':statistics.median(v),'min':min(v),'max':max(v)} for m,v in values.items() if v}, 'trials':items}
print(case, 'n='+str(len(items)), ' '.join(f'{m}={statistics.median(v):+.2f}% [{min(v):+.2f},{max(v):+.2f}]' for m,v in values.items() if v))
print('VIOLATIONS', json.dumps(violations))
(root/'summary.json').write_text(json.dumps({'final_coverage_requested':not args.progress,'qualified':not args.progress and not violations,'cases':summary,'violations':violations},indent=2)+'\n')

if violations:
raise SystemExit(1)
41 changes: 41 additions & 0 deletions docs/plans/accepted-pressure-warm-start/archive_measurements.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
#!/usr/bin/env python3
"""Lossless text archive for reproducible measurements, without hundreds of files.
Usage: archive_measurements.py pack directory archive.jsonl
archive_measurements.py unpack archive.jsonl empty_directory
"""
import hashlib
import json
from pathlib import Path, PurePosixPath
import sys

operation, source, destination = sys.argv[1:]
if operation == 'pack':
root = Path(source)
if Path(destination).resolve().is_relative_to(root.resolve()):
raise SystemExit('archive destination must be outside source directory')
if any(not path.is_file() for path in root.iterdir()):
raise SystemExit('archive input contains unexpected nested/non-file content')
with Path(destination).open('x') as output:
for path in sorted(root.iterdir()):
if path.is_file() and path.name != 'summary.json':
raw = path.read_bytes()
record = {'name': path.name, 'sha256': hashlib.sha256(raw).hexdigest(),
'content': raw.decode('utf-8')}
output.write(json.dumps(record, separators=(',', ':')) + '\n')
elif operation == 'unpack':
root = Path(destination)
root.mkdir(parents=True, exist_ok=True)
if any(root.iterdir()):
raise SystemExit('refusing to overwrite nonempty directory')
for line in Path(source).read_text().splitlines():
record = json.loads(line)
name = PurePosixPath(record['name'])
if name.is_absolute() or len(name.parts) != 1 or name.name in ('.', '..'):
raise SystemExit('invalid archive member')
raw = record['content'].encode('utf-8')
if hashlib.sha256(raw).hexdigest() != record['sha256']:
raise SystemExit('archive content hash mismatch')
with (root / name.name).open('xb') as output:
output.write(raw)
else:
raise SystemExit('expected pack or unpack')
64 changes: 64 additions & 0 deletions docs/plans/accepted-pressure-warm-start/baseline-harness.diff
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
--- frozen-baseline-harness
+++ candidate-harness
@@ -2 +2,3 @@
-//! steady|localized|switch|rest|saturated jacobi|sgs. CSV includes all attempts.
+//! steady|localized|switch|rest|saturated jacobi|sgs [normal|tight field-dump].
+//! Tight mode is an explicit reference oracle, never a performance comparison.
+//! CSV includes all attempts; failed-row iterations are unavailable (0 sentinel).
@@ -14 +16,5 @@
- sim.step(inputs, callback)
+ sim.step_with_initialization(
+ inputs,
+ PressureInitializationPolicy::AcceptedPreviousV1,
+ callback,
+ )
@@ -36,0 +43,5 @@
+ let tight = match args.get(8).map(String::as_str) {
+ None | Some("normal") => false,
+ Some("tight") => true,
+ _ => return Err("invalid reference mode".into()),
+ };
@@ -44,3 +55,3 @@
- relative_residual: 1e-8,
- absolute_residual: 1e-12,
- divergence_limit: 1e-7,
+ relative_residual: if tight { 1e-12 } else { 1e-8 },
+ absolute_residual: if tight { 1e-14 } else { 1e-12 },
+ divergence_limit: if tight { 1e-10 } else { 1e-7 },
@@ -182,0 +194,28 @@
+ if let Some(path) = args.get(9) {
+ use std::io::Write;
+ let mut out = std::io::BufWriter::new(std::fs::File::create(path)?);
+ let state = sim.state();
+ for n in counts {
+ out.write_all(&n.to_le_bytes())?;
+ }
+ out.write_all(&state.carrier.time.to_le_bytes())?;
+ out.write_all(&state.carrier.generation.to_le_bytes())?;
+ for values in [
+ state.carrier.x,
+ state.carrier.y,
+ state.carrier.z,
+ state.carrier.tracer,
+ ] {
+ out.write_all(&(values.len() as u64).to_le_bytes())?;
+ for value in values {
+ out.write_all(&value.to_le_bytes())?;
+ }
+ }
+ for values in [state.pressure, state.liquid.fraction] {
+ out.write_all(&(values.len() as u64).to_le_bytes())?;
+ for value in values {
+ out.write_all(&value.to_le_bytes())?;
+ }
+ }
+ out.flush()?;
+ }
@@ -187,2 +226,5 @@
- if args.len() != 8 {
- return Err("expected nx ny nz workers steps policy scenario method".into());
+ if args.len() != 8 && args.len() != 10 {
+ return Err(
+ "expected nx ny nz workers steps policy scenario method [normal|tight field-dump]"
+ .into(),
+ );
Loading
Loading