# GRIME3 0.1.0 RC8.4 Release Notes

GRIME3 0.1.0 RC8.4 is a distribution-provenance maintenance release that
supersedes RC8.3.

## RC8.4 Docker provenance correction

RC8.3 contained an inconsistency between its Docker documentation, Compose
defaults, and embedded build provenance:

- the default Compose image name still identified RC8.1;
- default Docker build arguments correctly described an unqualified build as
  development and dirty;
- the documented RC8.3 release-build command did not override those defaults
  with the immutable release identity.

Consequently, an image externally tagged as RC8.3 could contain
`BUILD_INFO.json` values identifying it as a development build.

RC8.4 corrects that distribution defect:

- generic Compose builds now use the honest default image name
  `grime3:development`;
- official Docker build instructions pass the exact Git commit, short commit,
  clean-state flag, immutable tag, build identifier, and UTC build timestamp;
- official Compose instructions export the same complete provenance set;
- the RC8.4 Docker packaging tests enforce these requirements.

## Scientific behavior

RC8.4 makes no change to water-level algorithms, calibration mathematics,
octagon selection, ROI projection, browser behavior, command-line
measurement, CSV content, or JSON scientific records.

It retains the RC8.3 calibration-projection and octagon-candidate corrections.
Results produced by equivalent RC8.3 and RC8.4 application code should be
scientifically identical. RC8.4 exists so all published distribution
artifacts carry internally consistent release provenance.

The deterministic measurement remains the official result. PyTorch, SAM2,
the RC7 internal comparison model, and the future SDF model are not included.

## Release identity

Immutable source tag:

```text
grime3-0.1.0-rc8.4
```

Build identifiers use:

```text
0.1.0-rc8.4-<seven-character-commit>
```

The Conda build is:

```text
grime3-0.1.0-py_4.conda
```

The versioned Conda channel is:

```text
https://coffeesig.com/gaugecam/conda/rc8.4
```

## Evaluated distribution paths

RC8.4 retains the four RC8 distribution paths:

1. Windows x64 PyInstaller one-folder ZIP;
2. Linux x86-64 PyInstaller one-folder archive;
3. noarch Conda package with platform-resolved runtime dependencies;
4. deterministic Linux/amd64 Docker/OCI image.

All distributions must be built from the same immutable RC8.4 tag and record
that tag and commit in their packaged build information.

## Dependency and licensing scope

RC8.4 retains the RC8 commercial-friendly dependency policy:

- no Qt runtime;
- no PyTorch, torchvision, torchaudio, or SAM2 runtime;
- GNU Readline excluded from supported standalone and Docker runtimes;
- Apache-2.0 GRIME3 licensing;
- third-party Python and native-runtime notices included with packaged
  distributions.

## Supersession

RC8.3 remains immutable for scientific and software provenance. RC8.4
supersedes it for publication and installation because RC8.4 corrects the
Docker release-identity defect while retaining the same scientific behavior.