2.0 KiB
2.0 KiB
detectors
AIMsight anomaly detectors (Python 3, standard library only) and the Claude Code plugin that improves them (/detectors:wf-improve). Everything is in English: code, identifiers, docs, outputs. Layout and usage: README.md.
Contract (do not break)
- One detector per family of
labeling/familles.md(D-119), inscripts/:visibility.py,obstruction.py,target_issue.py,thermal_displacement.py,no_data.py,displacement.py.categories.pyloads everyscripts/*.pythat hasdetect: never put another script with adetectfunction, or one with side effects at import, directly inscripts/(tools go inscripts/wf-improve/). detect(measurements)returns episodes with the keysstart,end,kind(the family),label(the variety),text,ignore,sensors. A detector may also declaretemperature,camera,metrics(categories.CONTEXT) orend;categories.eventspasses them by introspection.- Diagnostic-app reads this repository as it is:
categories.events,categories.CATEGORIES(process:images,none,check), the--from/--toCLIs,/detectors:wf-improve,wf-improve/<session>/summary.md. A rename here needs the matching change there. - Label fields come from Diagnostic-app and stay French:
debut,fin,categorie,description; likewisedemande.json(STATION,début,fin).
Rules
- A constant added or changed updates
thresholds.mdin the same change; check withgrep -nE "^[A-Z_0-9]+ = " scripts/*.py. - No rule specific to a station, a sensor or a date.
- A change to a detector is checked with the benchmark, from a working repository where this repository is mounted (or copied, not symlinked) as
detectors/next todata/andlabeling/:python3 detectors/scripts/wf-improve/regression.py. A refactoring must leave every figure unchanged. - History references in docstrings ("wf-improve X, mod. 1, S2", "X, batch 01", D-xxx, E-xxx) point to past sessions and to decisions recorded in Diagnostic-app/Support-Agent; keep them when editing a rule.