Consolidate numerical research and preserve a reproducible handoff

Document the baseline, hypotheses, measured results, failed approaches,
current policy defaults, and remaining rotating n=3 and virial limitations.
Include the authoritative LaTeX report, Pandoc-generated Markdown, compiled
PDF, source provenance, branch decisions, and consolidation validation.

Organize raw results and miscellaneous artifacts under working/ without
deleting them; version the directory guide, relocation hashes, archive
verifier, and report build/conversion checks. Keep build caches at their
original paths and clearly distinguish retained binaries from the validated
research build. Preserve experimental policies without promoting failed
trials to defaults.

reports/validation/archive_verification.json

@@ -0,0 +1,6 @@
+{
+  "files": 6228,
+  "bytes": 12468217917,
+  "failed_paths": [],
+  "all_preserved": true
+}

reports/validation/binary_inventory.json

@@ -0,0 +1,44 @@
+[
+  {
+    "target": "tests",
+    "source_path": "/Users/tboudreaux/.codex/.chatgpt-projects/g-p-6a6b3f2194ec8191bebcd59075897f1d/worktrees/preconditioner-improvement/cmake-build-release-homebrew/tests",
+    "sha256": "5046f9436a4610321721b025438723619e9a2814907f9f86f7d373021a7f5819",
+    "bytes": 35593464
+  },
+  {
+    "target": "sandbox",
+    "source_path": "/Users/tboudreaux/.codex/.chatgpt-projects/g-p-6a6b3f2194ec8191bebcd59075897f1d/worktrees/preconditioner-improvement/cmake-build-release-homebrew/sandbox",
+    "sha256": "a9fb62fe13b0a35f652ad89f4beb90472c1235768cda2ba8ad8d8fc1654a568f",
+    "bytes": 18955752
+  },
+  {
+    "target": "plateau_diagnostic",
+    "source_path": "/Users/tboudreaux/.codex/.chatgpt-projects/g-p-6a6b3f2194ec8191bebcd59075897f1d/worktrees/preconditioner-improvement/cmake-build-release-homebrew/plateau_diagnostic",
+    "sha256": "dd253e6b6714108ba9edfb4dd940b433f0b439689ac0d17b21b3c3b1b133f6e6",
+    "bytes": 46059376
+  },
+  {
+    "target": "density_order_contract_tests",
+    "source_path": "/Users/tboudreaux/.codex/.chatgpt-projects/g-p-6a6b3f2194ec8191bebcd59075897f1d/worktrees/preconditioner-improvement/cmake-build-release-homebrew/density_order_contract_tests",
+    "sha256": "eddd993c0dd5d3db8b03de37aaf63dee217efee6c443d69d93b3ba288093fd54",
+    "bytes": 23341376
+  },
+  {
+    "target": "continuation_contract_tests",
+    "source_path": "/Users/tboudreaux/.codex/.chatgpt-projects/g-p-6a6b3f2194ec8191bebcd59075897f1d/worktrees/preconditioner-improvement/cmake-build-release-homebrew/continuation_contract_tests",
+    "sha256": "be55b8c29f2812d668c7bf2a8737fe1397dc5e93a825e94f1946987aa79c0b95",
+    "bytes": 24261896
+  },
+  {
+    "target": "surface_border_schur_contract_tests",
+    "source_path": "/Users/tboudreaux/.codex/.chatgpt-projects/g-p-6a6b3f2194ec8191bebcd59075897f1d/worktrees/preconditioner-improvement/cmake-build-release-homebrew/surface_border_schur_contract_tests",
+    "sha256": "073072ce770fdbb4582324ce0d0722f05087387160dfc7b70ef97d9528685d5b",
+    "bytes": 4078128
+  },
+  {
+    "target": "mpi_tests",
+    "source_path": "/Users/tboudreaux/.codex/.chatgpt-projects/g-p-6a6b3f2194ec8191bebcd59075897f1d/worktrees/preconditioner-improvement/cmake-build-release-homebrew/mpi_tests",
+    "sha256": "5a20e0d39f275b1c613ad6986ee0051da72e9ab84a711ad9771c57b8a935c0bd",
+    "bytes": 21886648
+  }
+]

reports/validation/build_manifest.json

@@ -0,0 +1,57 @@
+{
+  "source_sha256": "c1ae24fcb31de984df425ffd43dd35b708a1f4d237aeba47a5abe9c8c1f14944",
+  "commands": [
+    {
+      "command": [
+        "/opt/homebrew/bin/pandoc",
+        "--from=latex",
+        "--to=gfm-tex_math_gfm+tex_math_dollars",
+        "--standalone",
+        "--toc",
+        "--toc-depth=2",
+        "--lua-filter=pandoc_tables.lua",
+        "--wrap=none",
+        "--output=MeanField_research_handoff_2026-09-20.md",
+        "MeanField_research_handoff_2026-09-20.tex"
+      ],
+      "returncode": 0,
+      "seconds": 0.22621400002390146
+    },
+    {
+      "command": [
+        "/opt/homebrew/opt/python@3.14/bin/python3.14",
+        "check_report_conversion.py",
+        "--output",
+        "/Users/tboudreaux/.codex/.chatgpt-projects/g-p-6a6b3f2194ec8191bebcd59075897f1d/worktrees/preconditioner-improvement/working/report_builds/research_handoff/conversion_audit.json"
+      ],
+      "returncode": 0,
+      "seconds": 1.092888499959372
+    },
+    {
+      "command": [
+        "/Library/TeX/texbin/latexmk",
+        "-pdf",
+        "-interaction=nonstopmode",
+        "-halt-on-error",
+        "-outdir=/Users/tboudreaux/.codex/.chatgpt-projects/g-p-6a6b3f2194ec8191bebcd59075897f1d/worktrees/preconditioner-improvement/working/report_builds/research_handoff",
+        "MeanField_research_handoff_2026-09-20.tex"
+      ],
+      "returncode": 0,
+      "seconds": 2.525557457935065
+    }
+  ],
+  "outputs": {
+    "MeanField_research_handoff_2026-09-20.tex": {
+      "sha256": "c1ae24fcb31de984df425ffd43dd35b708a1f4d237aeba47a5abe9c8c1f14944",
+      "bytes": 195299
+    },
+    "MeanField_research_handoff_2026-09-20.md": {
+      "sha256": "437df6b7c636ebf0f59c17d350e94e0d7c825a5118310f25151637430c3f2f74",
+      "bytes": 195388
+    },
+    "MeanField_research_handoff_2026-09-20.pdf": {
+      "sha256": "76aa581492d4d4a135de0c6294621c8c08ff7dbde54038f56bf0269293b795aa",
+      "bytes": 1513961
+    }
+  }
+}

reports/validation/document_qa.json

@@ -0,0 +1,12 @@
+{
+  "pdf_pages": 57,
+  "rendered_pages": 57,
+  "visually_reviewed_pages": 57,
+  "inspection": "Contact sheets for all pages, with individual-page checks of the final validation section; earlier individual checks of dense figures/tables retained in the build archive.",
+  "clipping_or_overlap_found": false,
+  "overfull_boxes_or_undefined_references": false,
+  "pdf_sha256": "76aa581492d4d4a135de0c6294621c8c08ff7dbde54038f56bf0269293b795aa",
+  "conversion_audit": "conversion_audit.json",
+  "build_manifest": "build_manifest.json",
+  "preview_archive": "working/report_builds/research_handoff/qa_final/"
+}

reports/validation/release_build.json

@@ -0,0 +1,21 @@
+{
+  "command": [
+    "/opt/homebrew/bin/cmake",
+    "--build",
+    "cmake-build-release-homebrew",
+    "--parallel",
+    "2",
+    "--target",
+    "tests",
+    "sandbox",
+    "plateau_diagnostic",
+    "density_order_contract_tests",
+    "continuation_contract_tests",
+    "surface_border_schur_contract_tests",
+    "mpi_tests"
+  ],
+  "cwd": "/Users/tboudreaux/.codex/.chatgpt-projects/g-p-6a6b3f2194ec8191bebcd59075897f1d/worktrees/preconditioner-improvement",
+  "source_commit": "b1fe3597607d70714e4f575fa14fe848532d8d4b",
+  "returncode": 0,
+  "seconds": 1324.310720375
+}

reports/validation/summary.json

@@ -0,0 +1,76 @@
+{
+  "cpp_case_executions": 337,
+  "cpp_assertions": 9316741,
+  "python_tests": 157,
+  "python_initial_skips_subsequently_run": 2,
+  "smoke_final_F": 1.527145159591774e-12,
+  "smoke_accepted_updates": 5,
+  "smoke_q18_virials": {
+    "enthalpy_virial_error": 3.8703561072645173e-07,
+    "enthalpy_force_virial_error": 2.659381864724186e-07,
+    "virial_error": 4.269936529762888e-07,
+    "force_virial_error": 3.058962287222557e-07
+  },
+  "checks": [
+    [
+      "mapping_surface_normalization",
+      "150 cases; 7,224,720 assertions",
+      794.1818723329343
+    ],
+    [
+      "coupled_solver_preconditioner",
+      "118 cases; 1,369,031 assertions",
+      1432.0412241660524
+    ],
+    [
+      "density_order_contract_tests",
+      "52 cases; 722,405 assertions",
+      199.69777812506072
+    ],
+    [
+      "continuation_contract_tests",
+      "8 cases; 515 assertions",
+      610.431635707966
+    ],
+    [
+      "surface_border_schur_contract_tests",
+      "9 cases; 70 assertions",
+      0.4409960419870913
+    ],
+    [
+      "python_regressions",
+      "146 tests; 2 initially skipped",
+      12.31967287498992
+    ],
+    [
+      "coupled_artifact_auditor_selftests",
+      "11 tests",
+      0.08722191606648266
+    ],
+    [
+      "slice_geometry_build",
+      "completed",
+      0.875526332994923
+    ],
+    [
+      "slice_geometry",
+      "completed",
+      0.2547087500570342
+    ],
+    [
+      "n3_mass_compatibility",
+      "completed",
+      0.9261317920172587
+    ],
+    [
+      "n1_harmonic_smoke",
+      "completed",
+      210.07539662509225
+    ],
+    [
+      "plot_render_contracts",
+      "2 tests",
+      11.042002792004496
+    ]
+  ]
+}