perf(cpu): gate accepted pressure warm starts behind an opt-in feature

.github/workflows/rust-rheon.yml

@@ -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:

Cargo.toml

@@ -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"]
@@ -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"

docs/education/NATIVE_ADMISSION_INTEGRATION_REVIEW.md

@@ -1751,3 +1751,82 @@ requires verified PR142 merged-main identity, any necessary exact-source
 revalidation, independent final review and the sole lead's normal merge.
 No general cut/free-surface PDE, physical/production-water, graphical hardware,
 learned/GPU or performance acceptance is granted by this reference/build stage.
+
+## PR59 optional accepted-pressure warm start, actual ordered main, 2026-10-22
+
+Actual ordered normal merges are PR142 `b70dbae515d01ced3762e0fff030df7f8b13363e`,
+PR138 `7befee45270280d07693b91f4afa934ec1780b66`, and PR143
+`20a0e1e20538b859193c08eaf25a3b8cd26135a5`. The actual PR143 merge has ordered
+parents `[7befee45270280d07693b91f4afa934ec1780b66,
+159fa74bd271f8fcc07f3837d66e4738925c820c]` and full tree
+`d66c930d091f8e84cf445f0920922d65afed8f8e`, exactly the independently reviewed
+PR143 tree. GitHub merged state, fetched live main, graph and full tree were
+verified. Its new main CI remains a separate gate, not a source-admission result.
+
+This explicit proposed v3 admission retains every byte of the prior 118,614-byte
+review above (SHA256 `b4e7fcaf0c33b9e220fc7626d04969a95b31767897e9779eee850a9cfd71d0f9`).
+The unchanged conservative selector now covers **153 regular inputs: 1 added,
+7 changed, 145 unchanged, 0 removed** against actual PR143 main. The complete
+[review input](../plans/accepted-pressure-warm-start/integration-20261021/final-source/source-map.json)
+records every proposed identity, with canonical sorted compact source-map SHA256
+`8055a53c319ddec6aade4bed35fdc642c7ab07839e4e0bb2866a00a4a03d3688` (no newline).
+Actual main's predecessor map remains
+`9a10497158827e189fe505f65e1aa203cd8a28fe894c469408977071b055375f`.
+These are the exact independently assessed preliminary153 identities, now
+explicitly proposed after actual ordered composition; no hash is refreshed to
+make an unknown change pass. Final independent source/admission/protocol approval
+must precede clean committed-source execution.
+
+The added path is `src/pressure_initialization.rs`. Changed paths are Cargo.toml,
+src/lib.rs, src/liquid_step.rs, src/pressure.rs, src/session.rs,
+src/session/projection_tests.rs and src/simulation.rs. The
+[complete preliminary per-path assessment](../plans/accepted-pressure-warm-start/integration-20261021/preview/dependency-source-map.json)
+and final source review distinguish unchanged inputs and exact reviewed changes.
+Cargo.toml SHA256 is
+`40f59222652c9d6b9236dd85b2beab83e8e7e9a8fdd8418bf3bd617801724487`;
+Cargo.lock stays `e64beca355b3963812b80d49ac5b17d0b1626f03f5d651b50e4dd25823dce96f`.
+The exact PR138 development dependencies remain; no new dependency/build script,
+toolchain, selector, qualifier, oracle, numerical formula or acceptance tolerance
+is introduced by this warm-start integration.
+
+Cargo feature `accepted-pressure-warm-start` is explicit and nondefault. Default,
+parallel and desktop builds do not implicitly enable it. Without it, warm solver
+branches, history/owner identity allocation, warm reports and entry points are
+excluded; Session API version3 explicitly reports warm capability false. Enabled
+consumers still opt in per step. Standalone Simulation and configured/provider,
+boundary, viscosity, surface, column and immutable native projection paths stay
+cold. This is a deliberately limited optional CPU capability, not a universal
+performance promise or a pending runtime toggle.
+
+The unique accepted-owner pressure borrow and process-local history are retained,
+without another retained pressure array. Full RHS compatibility, pressure gauge,
+residual, divergence, transport and acceptance checks remain. No timestep rescale,
+hidden retry, iteration-budget or tolerance change is admitted. Initialized Session
+uses the actual interval start and clears stale configured/provider receipts and
+separate configured pressure history only after successful acceptance. Failed
+publication preserves accepted state/history. Native projection stays cold, and
+legacy initialized entries reject immutable projection intent before callbacks,
+quota, clock or mutation. History staging respects PR142's prospective publication
+seal and assigns only after infallible accepted owner swaps. Dense3D/frame export
+does not turn process-local warm history into restart provenance.
+
+All original source branches, receipt identities, failed/cancelled attempts and
+the historical default1000-particle +1.83% screening/+2.20% confirmation remain.
+The previous qualified-source refusal is not a failed numerical comparison and
+cannot be erased or cleared by copying receipts. Frozen v1/v2 bytes/digests,
+immutable primary/base ancestry, complete v3 schema/base, old review prefix,
+private PR138/143 source/seal records and checker/oracle refusal gates are preserved.
+
+Follow the [prospective protocol](../plans/accepted-pressure-warm-start/integration-20261021/protocol.md).
+After exact-source independent approval and normal source publication, run fresh
+clean ordinary native/rational qualification (unchanged18-command route), a fresh
+real packet with26 normal and26 optimized tests/no skips, source-only strict CI
+contracts, required ordinary feature CI and one fixed prospective default-control
+cohort. That cohort is twelve balanced pairs each at1000/4096, not a rerun of any
+sealed numerical campaign. Positive median or positive upper endpoint of the
+predeclared [3rd,10th] interval blocks independently per case; no tolerance,
+extension, pooling or construction waiver is admitted. Historical warm gains bind
+their original workloads/binaries only. Source admission permits attempting fresh
+qualification; results, final review, full CI and sole-lead normal merge remain
+separate gates. No numerical/physical/PDE, native-window, learned/GPU, universal
+speedup or whole-application production acceptance is granted here.

docs/education/aligned-strain-native-sources-integration-20261014.json

@@ -1,16 +1,16 @@
 {
   "schema": "rheon-reviewed-aligned-strain-native-sources-v3",
   "reviewed_base": "21d4122c3d0edb2ca5c3ce089175c70035d737a3",
-  "scope": "Explicit PR138 reference/dev-dependency composition with reviewed PR142 dbd49d3: complete152-path closure,0added/2Cargochanged/150same/0removed. Fresh clean preliminary native/rational/real-packet and affected ordinary qualification required; final merged-main verification and lead merge remain gated. Historical scientific/physical/GUI/performance limits preserved.",
+  "scope": "Explicit PR59 optional accepted-pressure-warm-start composition after verified actual ordered142/138/143 main20a0e1e: complete153-path closure,1added/7changed/145same/0removed. Independent exact-source/admission/protocol approval then fresh clean ordinary native/rational/real-packet qualification, required full feature CI and fixed default performance controls required. Source admission is not qualification, performance or production acceptance; all predecessor reviews/receipts remain.",
   "preserved_inventory_sha256": {
     "docs/education/aligned-strain-native-sources.json": "84c036618b32de66623d8ded24ae8cf95194457e36b9a130087a9c2bf3bd3f6a",
     "docs/education/aligned-strain-native-sources-runtime-20261013.json": "6ada2133501aab449ed7ee73f802d8a4593db50c857f0a8f8ce2af4507721d6d"
   },
   "review_record": "docs/education/NATIVE_ADMISSION_INTEGRATION_REVIEW.md",
-  "review_sha256": "b4e7fcaf0c33b9e220fc7626d04969a95b31767897e9779eee850a9cfd71d0f9",
+  "review_sha256": "ef782b27b6f90b4a9b77a9137cb0520f38ff8f57703253cdc2548fecef1029e1",
   "source_sha256": {
     "Cargo.lock": "e64beca355b3963812b80d49ac5b17d0b1626f03f5d651b50e4dd25823dce96f",
-    "Cargo.toml": "997fb098f13c60e4f85ead3f5f7f2527f87ad1cba04fdac82d0bfb24959fca3a",
+    "Cargo.toml": "40f59222652c9d6b9236dd85b2beab83e8e7e9a8fdd8418bf3bd617801724487",
     "examples/aligned_strain.rs": "11910f4536bbb0057bd7462864f4d2af07d37dcd02103f41d1b93674dcca4547",
     "rust-toolchain.toml": "09ff66fa19e0cb8bbad00b6032e28f1cf77b0a37a73013648177b35297f98800",
     "src/advection.rs": "0163a872c314b2b3bb7f732348aafdbfa7b162dceea74807b7e7e3eb60ab0849",
@@ -99,8 +99,8 @@
     "src/forces.rs": "7b3b48c0813c995a937a44ca1b624411c59dde6419b62041b67456cde2d692d9",
     "src/free_surface.rs": "f43fd9a71da6aac985dfcfb6cc471318227c1727d6e0dad8e2a5feb5b3728a8e",
     "src/geometry.rs": "712d04f27d55d7e77f17effefbf2660ca3b8a000de5b7aa51b42b89fe5d3b634",
-    "src/lib.rs": "6a9f704b00321be1cb9699e4d81d953030a42e3794f5b5d03ce548490f51f7b5",
-    "src/liquid_step.rs": "d78dc80351771ac257f2643017c138709ea174d0e6dc4c4f7e1b92911babb41d",
+    "src/lib.rs": "c05e7887e95a97d1db1e5407a9b6d76d4cc94b419b1fb0265d42d4120ab38c3c",
+    "src/liquid_step.rs": "c3c64645e0af3b11bf279c0ba4fb2740db1b785f046f115d084d136f436d43f5",
     "src/liquid_volume.rs": "7f98c25b5e0990a0a9097aa1d3d656f4441123271e5ee1801ee2055de9eed650",
     "src/material.rs": "49874ff972f16a972d706236b34e62f83e994c57e39b642c6d94a1a6f4b7fb66",
     "src/material_session.rs": "4e18e446ad82f10523f72bae1b7cc6007f2ecf5ad05407bb666be3e2ae9be960",
@@ -115,7 +115,8 @@
     "src/operator.rs": "cd98684d5204908e5344b2628a8f93ea2a55a90c6678e03a71f2d75ab1f2be38",
     "src/parallel.rs": "ee5420673a59ae4fb247b3542878e74902f7a87056744d4303fb400be074677e",
     "src/particle_fluid.rs": "538c498122bbc1045ae59d7363ff87e1dd9a40003fb48eeae835228ad4c65893",
-    "src/pressure.rs": "39ddb79dd3de196e83545679e556c0cd8ce9afae9db9282161f54b8f22f713a5",
+    "src/pressure.rs": "fb70a35516764666acbedffb3c8cb2fbdc9c63690cfe87701085a9a5bf4c8827",
+    "src/pressure_initialization.rs": "dc81cb8c5b9dd1719a8e513e87d655098688b18e32bbea576b72746cadd1a233",
     "src/pressure_session.rs": "ae687a8822dd6cfeadf5dc6e13e7983d8d1afcdf9e5db1857d4dce64cd0e3fb8",
     "src/projection_step.rs": "51fe13c95772d1e3b68f2c261b50d5e2ec49bbc7adf8ff2573e3f36c2c34df1c",
     "src/provider_step.rs": "20cb23abcb30802dbebd6a32f599d20986982bf7aaa9e69e5287e4e448bac54b",
@@ -133,12 +134,12 @@
     "src/recording/workflow.rs": "020b8cd9d63dc5afedfb1b99b316fe584a5f226241abe4be159af960b13d2cc1",
     "src/sampling.rs": "6bf158f71f795078b5a88a5662ec2169693508e555f0f98d539657873aaabbcf",
     "src/scheduling.rs": "21fa031c06eeff8c2f722beb5553af9ba86d0afab479f4036916480338dc1411",
-    "src/session.rs": "fffdcf8728bcc959db384c4567ad8200ec59be800fcb343a7324e208a776088b",
+    "src/session.rs": "69a152d5b2b8dfe36888b2dd243b4069fdc2cd17268a201f06027d5c1bd4bb8f",
     "src/session/configured.rs": "25a3478d1408ee98f55fc072fcef97631df5283bd01f13e3ac81d947450e5ce4",
     "src/session/projection.rs": "b94b144d441730a50f641656dbfd069e7182b8471a73e8aba8b4df17c53cf0a4",
-    "src/session/projection_tests.rs": "58fb6694b80e8b87d7fff889c5e3a5adf801f1a2b3e671d37e352c01bbf8053d",
+    "src/session/projection_tests.rs": "360e7feb3f4955903510c82d0711820ad4aa922ffea075fd7084028d07f57619",
     "src/sgs.rs": "0b4140af63144df8ff1839782b3c70295c18b96decc67aba348a37a33e9f996d",
-    "src/simulation.rs": "0abf525a7535e48f04acd3ef408c15c7d93242906195f778fb0e1e8646dff254",
+    "src/simulation.rs": "509c853d7232d22fecbd14066178befb3174b34e0aedaf4bdc27e0b8263d86fe",
     "src/solver_provider.rs": "204682fc6540cb812d7d9200dd61085e5dcb827a6c77981e081046ef353c0838",
     "src/solver_provider/composition.rs": "f8cceb5a953e45627c2297b9393e557519b3099c4533b5aa1045b0dd0c6a96ef",
     "src/solver_provider/composition/projection.rs": "c122744dfc3b4fccd4c5755df10fef1c12033e51d87c191d73efdb0cdaab28a3",