# Delivered validation evidence

This report records finite tests and samples of Hearthwright, not a count or proof of its complete design space.

- **225 tests passed**, including intentional damage, public API constraints, deterministic bytes, semantic reloads, and independent client compositions. See `test-results.txt`.
- **832 generated builds passed validation**: thirteen clients at each seed from 0 through 63. No failures remain in `samples/audit.json`.
- **26 saved samples passed both generation and reload validation**: seeds 0 and 1 for every client. All 26 have different structural signatures and normalized placed-geometry signatures in this batch. See `samples/manifest.json`.
- **107 review images**: 103 labeled sample exteriors and occupied-floor cutaways, plus four views of the default output. See `previews/index.html` and `previews/default/`.
- All sixteen supplied reference source/image SHA-256 hashes still match `references/README.md`.
- Temporary test files and cutaway schematics were removed.

## Observed audit diversity

The last column counts only distinct normalized structural geometry observed in the 64 audited seeds for that client. It excludes furniture, vegetation and material texture noise. Plan signatures are recorded separately and are not substituted for placed-geometry evidence.

| Client | Seeds tested | Observed geometry signatures |
| --- | ---: | ---: |
| `mediterranean_villa` | 64 | 31 |
| `merchant_manor` | 64 | 45 |
| `red_roof_farmstead` | 64 | 16 |
| `root_house` | 64 | 38 |
| `sandstone_cottage` | 64 | 31 |
| `stilt_water_cabin` | 64 | 8 |
| `stilted_manor` | 64 | 31 |
| `stone_cottage` | 64 | 8 |
| `canal_apothecary` | 64 | 8 |
| `woodland_archive` | 64 | 31 |
| `orchard_house` | 64 | 24 |
| `hillside_studio` | 64 | 31 |
| `courtyard_house` | 64 | 16 |

## Targeted checks and visual review

Boundary cases include four occupied storeys, 25 by 23 footprints, seven-block storey spacing, two-block eaves, shallow and very steep roofs, hipped attics, maximum shallow-water depth, deep decks, and entrances on every cardinal wall of flat and sloping sites. The regular corpus covers joined unequal roofs, three-sided courts, irregular root interiors, buried floors, overhang supports, upper terraces and exterior stairs. Signed 64-bit seed endpoints are included in the test corpus.

Mutation tests remove or obstruct stair treads, headroom, door and bed halves, stilt segments, ladder backing, glazing, roofs, lights, furniture, inventory NBT and the final terrain connection. An isolated floor pocket is rejected even when the room's anchor remains reachable. Round-trip tests reject changed names, values and explicit property sets while accepting property reordering.

Exterior views and furnished cutaways were inspected across all eight reference interpretations and the five novel compositions. The review prompted shared fixes to roof closure, room-scale furnishings, root caps, lighting protection, and approaches that meet real terrain beyond a root mound or an uphill entrance. The saved images reflect the final geometry.

## Reproduce

```sh
/opt/venv/bin/python -m pytest -q
/opt/venv/bin/python -m scripts.audit --count 64
/opt/venv/bin/python -m scripts.sample_batch
/opt/venv/bin/python -m scripts.render_batch --all-seeds
/opt/venv/bin/python generate.py
xvfb-run -a /work/generator/MCRender/node_modules/.bin/vite-node --script render.mjs -- output.litematic previews/default
```

Default output seed: `20260925`.

Default schematic SHA-256: `92180be5b62a76fce932bc7e50369afaf2829fd46c278c4ebd9d5d3616ded647`.

The requested library, clients, saved samples, tests, documentation, default export and review images are delivered. Runtime Minecraft physics and exact light propagation are not simulated; supported domains and further limitations are documented in `GENERATOR.md`. No exhaustive validation of arbitrary future compositions is claimed.