feat: complete Faza 1 implementation (105 tests green)

All 12 modules built per reviewed plan:
- detector, state_machine (5-state phased FSM), canary, levels Phase B
- notifier fanout (Discord + Telegram, bounded queue, retry, dead-letter)
- audit (JSONL daily rotation), journal, report (weekly R-multiple PnL)
- calibrate + labeler (Tk, lazy-imported), dryrun with acceptance gate
- unified CLI: atm calibrate|label|dryrun|run|journal|report

README + Phase 2 prop-firm TOS audit checklist included.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

tests/test_canary.py

@@ -0,0 +1,152 @@
+"""Tests for src/atm/canary.py."""
+from __future__ import annotations
+
+import dataclasses
+from pathlib import Path
+
+import numpy as np
+import pytest
+
+from atm.canary import Canary, CanaryResult
+from atm.config import (
+    CanaryRegion,
+    ColorSpec,
+    Config,
+    DiscordCfg,
+    ROI,
+    TelegramCfg,
+    YAxisCalib,
+)
+from atm.vision import crop_roi, phash
+
+# ---------------------------------------------------------------------------
+# Fixtures / helpers
+# ---------------------------------------------------------------------------
+
+CANARY_ROI = ROI(x=0, y=0, w=50, h=50)
+
+
+def _make_base_cfg() -> Config:
+    colors = {
+        "turquoise":   ColorSpec(rgb=(0, 255, 255),   tolerance=30.0),
+        "yellow":      ColorSpec(rgb=(255, 255, 0),   tolerance=30.0),
+        "dark_green":  ColorSpec(rgb=(0, 100, 0),     tolerance=30.0),
+        "dark_red":    ColorSpec(rgb=(100, 0, 0),     tolerance=30.0),
+        "light_green": ColorSpec(rgb=(0, 255, 0),     tolerance=30.0),
+        "light_red":   ColorSpec(rgb=(255, 0, 0),     tolerance=30.0),
+        "gray":        ColorSpec(rgb=(128, 128, 128), tolerance=30.0),
+    }
+    # placeholder baseline_phash; tests replace canary via dataclasses.replace
+    return Config(
+        window_title="test",
+        dot_roi=ROI(x=0, y=0, w=100, h=50),
+        chart_roi=ROI(x=0, y=0, w=600, h=400),
+        colors=colors,
+        y_axis=YAxisCalib(p1_y=0, p1_price=100.0, p2_y=400, p2_price=80.0),
+        canary=CanaryRegion(roi=CANARY_ROI, baseline_phash="0" * 64, drift_threshold=8),
+        discord=DiscordCfg(webhook_url="http://example.com/hook"),
+        telegram=TelegramCfg(bot_token="tok", chat_id="123"),
+    )
+
+
+def _cfg_with_baseline(baseline_frame: np.ndarray) -> Config:
+    """Build a Config whose baseline_phash matches the given frame's canary ROI."""
+    roi_img = crop_roi(baseline_frame, CANARY_ROI)
+    h = phash(roi_img)
+    canary_region = CanaryRegion(roi=CANARY_ROI, baseline_phash=h, drift_threshold=8)
+    return dataclasses.replace(_make_base_cfg(), canary=canary_region)
+
+
+def _checkerboard(h: int, w: int, block: int = 8) -> np.ndarray:
+    """Return a checkerboard BGR image (high-frequency, distinct phash)."""
+    img = np.zeros((h, w, 3), dtype=np.uint8)
+    for y in range(0, h, block):
+        for x in range(0, w, block):
+            if (y // block + x // block) % 2 == 0:
+                img[y : y + block, x : x + block] = 255
+    return img
+
+
+# A purely black 100×100 frame as baseline
+BASELINE_FRAME = np.zeros((100, 100, 3), dtype=np.uint8)
+
+# A frame where the canary ROI is a checkerboard (visually very different)
+DRIFTED_FRAME = BASELINE_FRAME.copy()
+DRIFTED_FRAME[:50, :50] = _checkerboard(50, 50)
+
+
+# ---------------------------------------------------------------------------
+# Tests
+# ---------------------------------------------------------------------------
+
+def test_no_drift() -> None:
+    """Same image as baseline → distance ≤ threshold, not paused."""
+    cfg = _cfg_with_baseline(BASELINE_FRAME)
+    canary = Canary(cfg)
+
+    result = canary.check(BASELINE_FRAME)
+
+    assert result.drifted is False
+    assert result.paused is False
+    assert canary.is_paused is False
+
+
+def test_drift_triggers_pause() -> None:
+    """Drastically different canary ROI → drifted=True, paused=True."""
+    cfg = _cfg_with_baseline(BASELINE_FRAME)
+    canary = Canary(cfg)
+
+    result = canary.check(DRIFTED_FRAME)
+
+    assert result.drifted is True
+    assert result.paused is True
+    assert canary.is_paused is True
+
+
+def test_persists_paused() -> None:
+    """After drift, feeding back a clean frame keeps paused=True."""
+    cfg = _cfg_with_baseline(BASELINE_FRAME)
+    canary = Canary(cfg)
+
+    canary.check(DRIFTED_FRAME)       # trigger pause
+    result = canary.check(BASELINE_FRAME)  # clean frame, but still paused
+
+    assert result.paused is True
+    assert canary.is_paused is True
+
+
+def test_resume_clears() -> None:
+    """resume() clears the paused flag; subsequent clean frame stays unpaused."""
+    cfg = _cfg_with_baseline(BASELINE_FRAME)
+    canary = Canary(cfg)
+
+    canary.check(DRIFTED_FRAME)   # pause
+    canary.resume()
+
+    assert canary.is_paused is False
+
+    result = canary.check(BASELINE_FRAME)
+    assert result.paused is False
+
+
+def test_pause_file_written(tmp_path: Path) -> None:
+    """When pause_flag_path is provided, the file is created on drift."""
+    flag = tmp_path / "paused.flag"
+    cfg = _cfg_with_baseline(BASELINE_FRAME)
+    canary = Canary(cfg, pause_flag_path=flag)
+
+    assert not flag.exists()
+    canary.check(DRIFTED_FRAME)
+    assert flag.exists()
+
+
+def test_resume_deletes_pause_file(tmp_path: Path) -> None:
+    """resume() deletes the pause flag file."""
+    flag = tmp_path / "paused.flag"
+    cfg = _cfg_with_baseline(BASELINE_FRAME)
+    canary = Canary(cfg, pause_flag_path=flag)
+
+    canary.check(DRIFTED_FRAME)
+    assert flag.exists()
+    canary.resume()
+    assert not flag.exists()