# Style checks

A style check measures each image delivered for a request that names a [style guide](/docs/style-guides), and compares it with that style's own references and samples. When an image sits outside the style, review shows a warning beside the spec warnings. The style's page in the Library lists accepted images that sit outside it, so a library that drifted, with some portraits bold and flat and others soft and painted, shows up in one place. Style checks come with the **Pro**, **Team** and **Enterprise** plans.

A style check is a warning, never a block. A reviewer can still accept the image.

## What it measures

No AI is involved, so the same file and the same style version always give the same result. Asset Goes Here scales each image down to 256 pixels on its long side and leaves out transparent pixels, so a cut-out character is measured and its empty background isn't. Then it measures:

| Measurement | What it is |
| --- | --- |
| Ink coverage | The share of near-black pixels, such as inked contours and crosshatching |
| Edge density | The share of pixels on a sharp edge |
| Flat vs gradient | The share of flat fills, against soft gradients and painted light |
| Colour count | How many colours carry the image, leaving out speckle and anti-aliasing |
| Saturation | How vivid the colours are, on average |
| Brightness | How light the image is, on average |
| Warmth | How far the colours lean to red rather than blue |
| Texture fingerprint | Local brightness patterns and edge directions together, which separate inked hatching from brushwork |

[How style measurements work](/docs/style-measurements) gives the exact calculation behind each one, and what to change in an image to move it.

## How it compares

Each style defines its own range, without fixed thresholds. Asset Goes Here measures the style's image references and sample images, and takes the range they span on each measurement, widened a little so that three similar references don't flag every small difference. For the texture fingerprint, it takes how far the references sit from their own average. An image is outside the style when **two or more** measurements fall outside the range, and review lists each one with the image's value, the range and a bar that shows both.

- **Roles.** When an image has a `role` tag, such as `role=portrait`, and at least three references share it, only those references set the range. Portraits and backgrounds then each have their own range, so the subject doesn't decide the result. Sample images always count.
- **Enough references.** A style needs at least three image references and samples before images are checked. With fewer, review says the image wasn't checked and links to the style so you can add some.
- **Versions.** A check uses the style as it is when the file is delivered. When the style changes, the Library's list is worked out again against the new references.

## In the Library

On **Style guides**, each style with an images section lists **Outside the style**: its accepted images that sit outside it now, each with the measurement furthest out of range. **Request revision** asks for a new version of one, and **Request revisions for all** asks for all of them. Each current file stays until a new one is accepted.

Images accepted before style checks are measured the first time the list is opened, 40 at a time. A large library fills in over a few visits, and the list says how many have been measured so far.

## Compare an image with every style

Open an image in the Library and **Compare with styles** measures it against each of the project's styles with an images section. The style it names comes first, marked **attached** or **its style**, then the closest fits. Each row says **Within the style**, **Outside** with how many readings are out of range, or that the style doesn't have enough references yet, and opens to show each reading against the style's range, as in review.

Admins and developers can **Attach this style** from a row, which [attaches it](/docs/style-guides#attach-a-style-to-an-existing-asset) without a new version, or **Request revision in this style** from a row the image sits outside. The image measured is the accepted file, or the delivery under review when there is none. SVG images aren't measured.

```text
agh style compare location.aberlis_hall.night
agh style compare location.aberlis_hall.night --pending   # the delivery waiting for review
```

Coding agents call `compare_styles`, with `file: "pending"` for the delivery under review.

### On Review

A delivered image under **Review** has the same **Compare with styles** section below its style check, measuring the new delivery rather than the published file it replaces. Its closed line already names the closest fit, so a revision that drifted toward another style shows at a glance. The request's own style comes first, marked **this request**, and the best match is marked **closest fit**. From another style's row:

- **Use this style for the request** changes the request's style without rejecting the delivery. Accepted, the file counts as attached to that style.
- **Reject and ask for it in this style**, on a style the delivery sits outside, sends it back with a note and the request moved to that style, so the next version is made from its words and references.

## For agents and the CLI

An image delivered in a style carries the check as `styleCheck` on its pending file: in `get_asset`, `get_file_link` and `review_delivery` results, and in the API. It holds `state`, `outside`, a one-line `summary`, every reading's `value`, `low`, `high` and `outside`, and what the image was compared with. The `list_outside_style` tool lists a style's accepted images that sit outside it.

```text
agh show character.maren.bust_portrait   # the pending file's style check, with its out-of-range readings
agh style outside living_comic           # accepted images outside the style
```

## API

| Route | Who | What |
| --- | --- | --- |
| `GET /projects/{id}/assets/{asset}/styles` | members | The image measured against every style with an images section: each style's `check`, with `named` for the asset's own. `?file=pending` measures the delivery under review; `current` the accepted or published file, the default when there is one. Free and Supporter plans get 402 with a link here. |
| `GET /projects/{id}/styles/{style}/outside` | members | Accepted images outside the style, with `measured` and `total` while older images are still being measured. Free and Supporter plans get 402 with a link here. |

## Plans

Style checks measure every file, so they come with the plans that cover running costs: **Pro**, **Team** and **Enterprise**. On Free and Supporter, review says that the image wasn't checked and links here and to the upgrade. An org admin can upgrade under **Admins & projects › Plan & billing**.
