Skip to content
Sarj Repo Standards

undeclared-images

Declare each tracked image’s purpose.

error Enable rule repository/artifacts/undeclared-images Rule source Rule JSON

Examples

Attach review screenshots instead of tracking them

Before — rejected · error 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n","tracked":["docs/review/before.png"]}
After — preferred 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n","tracked":[]}
More cases 2

Declare an application image without deleting it

Before — rejected · error 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n","tracked":["public/logo.svg"]}
After — preferred 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n[[images.artifacts]]\npath = \"public/logo.svg\"\nkind = \"application\"\nreason = \"Application brand mark.\"\n","tracked":["public/logo.svg"]}

Retain image bytes required by a real test

Before — rejected · error 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n","tracked":["tests/fixtures/input.png"]}
After — preferred 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n[[images.artifacts]]\npath = \"tests/fixtures/input.png\"\nkind = \"fixture\"\nreason = \"Decoder regression input.\"\n","tracked":["tests/fixtures/input.png"]}

Enable this rule

Add the stable ID to enabled_rules in your tracked .repo-standards/repository.toml:

enabled_rules = ["repository/artifacts/undeclared-images"]

This selects only this rule. To retain the defaults, also include repository/artifacts/untyped-javascript and repository/artifacts/bespoke-iac-verifiers, along with any existing IDs. Omitted or empty selections use the defaults. Setup and staged checks