Files
aimsight-detectors/CLAUDE.md
T
2026-11-13 12:31:22 +01:00

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), in scripts/: visibility.py, obstruction.py, target_issue.py, thermal_displacement.py, no_data.py, displacement.py. categories.py loads every scripts/*.py that has detect: never put another script with a detect function, or one with side effects at import, directly in scripts/ (tools go in skills/wf-improve/scripts/).
  • detect(measurements) returns episodes with the keys start, end, kind (the family), label (the variety), text, ignore, sensors. A detector may also declare temperature, camera, metrics (categories.CONTEXT) or end; categories.events passes them by introspection.
  • Diagnostic-app reads this repository as it is: categories.events, categories.CATEGORIES (process: images, none, check), the --from/--to CLIs, /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; likewise demande.json (STATION, début, fin).

Rules

  • A constant added or changed updates thresholds.md in the same change; check with grep -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 to data/ and labeling/: python3 detectors/skills/wf-improve/scripts/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.