# HTML Quality Probe

These checks are diagnostic and non-gating. A `needs-review` status means the generated artifacts found a likely conversion-quality issue, not that artifact generation failed.

- Status: `needs-review`
- Source PDF: [../source.pdf](../source.pdf)
- Generated HTML: [../semantic-continuous/index.html](../semantic-continuous/index.html)
- Sample notes: Long formula-heavy paper with figures, dense vector content, and many citation links. Categories: math-focused, formulas, figures, links. Canonical source: https://arxiv.org/abs/0810.3286
- Text reference: `pdfbox-net-run-fallback`
- Pages analyzed: 2

## Page Summary

| Page | Status | Source words | HTML words | Token coverage | Long HTML tokens | Foreground delta | Severe color delta | Text/object overlaps |
| --- | --- | ---: | ---: | ---: | ---: | ---: | ---: | ---: |
| 1 | `needs-review` | 429 | 417 | 0.963 | 0 | 0.125 |  | 0 |
| 2 | `needs-review` | 588 | 558 | 0.935 | 0 | 0.029 |  | 0 |

## Issue Categories

| Category | Status | Evidence |
| --- | --- | --- |
| Text reconstruction and word boundaries | `passed` | All analyzed pages passed; lowest token coverage is 0.935 on page 2. |
| Page geometry and text-run structure | `passed` | Page dimensions passed where measured; 2 continuous semantic-flow run-count check(s) were skipped because source runs are intentionally grouped. |
| Text wrapping around images and vector objects | `passed` | No text overlaps with image boxes or large vector boxes were found on analyzed pages. |
| Visual foreground parity | `needs-review` | Max foreground delta is 0.125; max source-only foreground ratio is 0.487; max HTML-only foreground ratio is 0.357. |
| Visual color parity | `skipped` | No stable shared-foreground interior pixels were available for perceptual color comparison. |
| Source fixture expectations (manual review) | `skipped` | The source PDF does not contain recognizable self-describing fixture expectations. |
| Probe setup and tool availability | `passed` | The browser probe and available renderers ran. |

## Current Limitations

- Mathematical expressions are reconstructed from positioned PDF glyphs; complex fractions, roots, and grouped formula runs may require manual visual review.
- The visual probe compared at least one page using only the overlapping crop because renderer/browser pixel dimensions differed beyond the probe tolerance.
- The HTML contains additional foreground pixels compared with the PDF render on at least one page, which often means duplicated glyphs, fallback text, or unmodeled object masks.

## Findings

- Page 1, `visual-foreground-mask`: PDF render and browser page screenshot have different pixel dimensions; foreground masks were compared across the overlapping region only.
- Page 2, `visual-foreground-mask`: PDF render and browser page screenshot have different pixel dimensions; foreground masks were compared across the overlapping region only.

## Artifacts

- [page-1-html.png](page-1-html.png)
- [page-1-source.png](page-1-source.png)
- [page-1-diff.png](page-1-diff.png)
- [page-1-visual-report.html](page-1-visual-report.html)
- [page-2-html.png](page-2-html.png)
- [page-2-source.png](page-2-source.png)
- [page-2-diff.png](page-2-diff.png)
- [page-2-visual-report.html](page-2-visual-report.html)