# Phase 1.5 owner-review workflow

Open `evaluation/owner-review/index.html` and choose one of the 14 pages. Each
page keeps the authoritative image beside the raw OCR, model candidate,
agent-reviewed diagnostic, deterministic reading and diplomatic renderings,
candidate-to-diagnostic diffs, editorial notes, and extracted uncertainties.

The bundle is a static inspection aid. Opening it, rebuilding it, validating a
page, or running a summary never changes review authority. Once an explicit
approval exists, the page view renders the owner edition as current while still
showing the candidate, diagnostic, and diagnostic-to-owner diff.

## Rebuild the inspection bundle

```sh
uv run diary owner-review build \
  --source-root /path/to/diary_ocr_package
```

This refreshes the checklist and copied inspection artifacts. It creates no
owner decision and no file under `edition/owner-approved/`.

## Explicit owner actions

Approve the agent diagnostic without textual changes:

```sh
uv run diary owner-review approve-as-is \
  --page 110 \
  --owner "OWNER NAME" \
  --source-root /path/to/diary_ocr_package
```

To correct a page, download or copy its diagnostic JSON, edit that copy, and keep
the trusted `page_id`, `source`, and `segment` fields unchanged. Then explicitly
approve the corrected file:

```sh
uv run diary owner-review approve-corrected \
  --page 110 \
  --owner "OWNER NAME" \
  --corrected-json /path/to/corrected-page-110.json \
  --source-root /path/to/diary_ocr_package
```

The command validates the correction before approval, preserves the submitted
file under `evaluation/owner-review/submissions/`, records hashes and change
categories, and writes the derived edition to `edition/owner-approved/`. It does
not overwrite the candidate or diagnostic.

Leave a page unapproved with a needs-work reason:

```sh
uv run diary owner-review needs-work \
  --page 110 \
  --owner "OWNER NAME" \
  --reason "Describe the unresolved issue"
```

Only the two `approve-*` commands can set `review.status: "owner_approved"` and
`review.authority: "owner_approved_edition"`.

## Summary

```sh
uv run diary owner-review summary
```

The JSON report counts approved-as-is, owner-corrected, needs-work/deferred, and
unapproved pages. For owner corrections it lists change categories and pages
whose deterministic text changed. It does not treat diagnostics as truth and
does not calculate accuracy against them.

The current 14-page regression set has 12 as-is approvals and two corrected
approvals. Page 181 corrects the agent's 1896 misreading to the visible 1898;
page 232 corrects the handwritten initial word from `Keep` to `Sleep`.
