# MeanField research reports

The complete local delivery is identified by Git tag `research-handoff-2026-09-20`.

The comprehensive handoff is
[MeanField_research_handoff_2026-09-20.md](MeanField_research_handoff_2026-09-20.md).
The matching [LaTeX source](MeanField_research_handoff_2026-09-20.tex) is authoritative;
the [PDF](MeanField_research_handoff_2026-09-20.pdf) is the print version. Markdown
is generated directly from LaTeX by Pandoc, not maintained as a separate report.
A small Pandoc filter removes repeated PDF table headings from Markdown and
preserves section anchors; math uses explicit absolute-value and norm delimiters
so table separators stay intact. The builder also checks that conversion retained
table cells, equations, paths, figures, captions and working contents links.

From the repository root, run:

```sh
python3 reports/build_report.py
```

This requires Pandoc, `latexmk`, and a LaTeX installation with the packages named
in the source preamble. To regenerate Markdown alone:

```sh
python3 reports/build_report.py --markdown-only
```

Build logs and LaTeX auxiliary files go to
`working/report_builds/research_handoff/`. Selected scientific figures are
versioned under `figures/`; their original paths and hashes are in
`archive/figure_sources.json`.

- [Branch consolidation](branch_consolidation.md) explains each retained,
  incorporated or intentionally excluded hypothesis.
- `archive/` preserves the pre-consolidation Git inventory, exact local edit,
  file relocation/hash manifest, and unsuccessful one-way gravity experiment.
- `sources/original_audits/` holds the original formulation, solver and
  preconditioner audits as unmodified reference copies.
- `prior/` preserves earlier project documentation and the optimization report.
- `validation/` records the consolidation checks, tested source and executable
  hashes, physical smoke results, and document conversion audit.
- `../experiments/` contains the original study reports, experiment recipes,
  diagnostics and evidence checkers.
- [The working-directory guide](../working/README.md) locates the complete raw
  evidence archive, which is local and not committed to Git.

The report distinguishes code correctness checks, artifact audits, algebraic
convergence and physical validation. None should be read as a substitute for
the others. In particular, the moderately rotating n=3 and ESTER-validation
milestones remain open.

To verify the local raw archive against every recorded content hash, run:

```sh
python3 reports/verify_archive.py
```

Supply `--repository /path/to/MeanField` when checking a relocated archive.