Files
aimsight-detectors/CLAUDE.md
T
maximeandClaude Opus 5.5 b9595d6011 Learner plugin in English: upgrader (with the critic merged in) and validator
- skill detector-learner -> learner; agents detectors-upgrader -> upgrader,
  detectors-control -> validator; detectors-critic merged into the upgrader
- releveur and ameliorations-processus.md removed; history.csv removed
- archive/visibilite_simple.py removed (kept in the history of Support-Agent)
- seuils-du-journal.md -> thresholds.md, in English, constants renamed
- "journal du matin" dropped; README, plugin.json in English; CLAUDE.md added

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-13 12:22:44 +01:00

18 lines
2.0 KiB
Markdown

# detectors
AIMsight anomaly detectors (Python 3, standard library only) and the Claude Code plugin that improves them (`/detectors:learner`). 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 `scripts/learner/`).
- `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:learner`, `learner/<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/scripts/learner/regression.py`. A refactoring must leave every figure unchanged.
- History references in docstrings ("learner 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.