Skip to content
Sarj Repo Standards

local-residue

Review tracked caches and bytecode.

warning Enable rule repository/artifacts/local-residue Rule source Rule JSON

Examples

Retain Python source and untrack its local cache

Before — rejected · warning 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n","tracked":["src/package/client.py","src/package/__pycache__/client.cpython-315.pyc"]}
After — preferred 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n","tracked":["src/package/client.py"]}
More cases 4

Retain build settings and untrack incremental state

Before — rejected · warning 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n","tracked":["tsconfig.json","tsconfig.tsbuildinfo"]}
After — preferred 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n","tracked":["tsconfig.json"]}

Retain the asset and untrack desktop thumbnail metadata

Before — rejected · warning 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n","tracked":["assets/theme.css","assets/Thumbs.db"]}
After — preferred 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n","tracked":["assets/theme.css"]}

Retain lint settings and untrack local lint state

Before — rejected · warning 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n","tracked":["eslint.config.ts",".eslintcache"]}
After — preferred 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n","tracked":["eslint.config.ts"]}

Retain coverage settings and untrack measured state

Before — rejected · warning 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n","tracked":[".coveragerc",".coverage"]}
After — preferred 
{"manifest":"repository_id = \"example-repository\"\ncomponents = []\n","tracked":[".coveragerc"]}

Enable this rule

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

enabled_rules = ["repository/artifacts/local-residue"]

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