# Image::Reference::Audit

`Image::Reference::Audit` is a small dependency-free Raku module for checking multi-reference image briefs before generation. It keeps the subject, aspect ratio, reference roles, and constraints in named fields so a workflow can detect missing information without parsing an unstructured prompt.

## Why reference roles matter

A folder of images does not explain how each file should influence the result. One image may anchor the product, another may define composition, and a third may provide only a palette. Assigning those roles explicitly reduces ambiguity and makes conflicting instructions visible before a draft is generated.

The module performs deterministic checks for:

- a meaningful subject description;
- a specified aspect ratio;
- at least one reference with an assigned role;
- empty role labels that would otherwise pass unnoticed.

## Example

```raku
use Image::Reference::Audit;

my $audit = Image::Reference::Audit.new(
    subject => 'A product bottle on a clean studio surface',
    aspect-ratio => '4:5',
    reference-roles => {
        product => 'subject anchor',
        sketch => 'layout guide',
        moodboard => 'palette reference'
    },
    constraints => {
        label => 'preserve exact wording',
        background => 'neutral gray'
    }
);

say $audit.issues;
say $audit.summary;
```

The output can be stored with a creative request, compared across revisions, or passed to a separate renderer only after `is-valid` returns true.

## Workflow context

The checks are deliberately tool-independent. They help teams review multi-reference work for product images, posters, layouts, and campaign variants without claiming that validation guarantees a particular visual result. A browser workspace such as [Muse Image](https://muse-image.co/) can then be used for prompt-led creation and reference-based editing after the brief has been reviewed.

Review current product information before relying on changing capabilities, and treat generated outputs as drafts that still require visual inspection.
