detectkit 0.32.0__tar.gz → 0.34.0__tar.gz

{detectkit-0.32.0/detectkit.egg-info → detectkit-0.34.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: detectkit
-Version: 0.32.0
+Version: 0.34.0
 Summary: Metric monitoring with automatic anomaly detection
 Author: detectkit team
 License: MIT

{detectkit-0.32.0 → detectkit-0.34.0}/detectkit/__init__.py

@@ -4,7 +4,7 @@ detectk - Anomaly Detection for Time-Series Metrics
 A Python library for data analysts and engineers to monitor metrics with automatic anomaly detection.
 """
 
-__version__ = "0.32.0"
+__version__ = "0.34.0"
 
 from detectkit.core.interval import Interval
 from detectkit.core.models import ColumnDefinition, TableModel

{detectkit-0.32.0 → detectkit-0.34.0}/detectkit/autotune/grid_search.py

@@ -21,6 +21,7 @@ from detectkit.autotune.window_select import (
     detect_level_shift,
     half_life_grid,
     min_samples_for,
+    seasonal_fill_window,
     select_window,
     trend_present,
 )
@@ -45,6 +46,21 @@ def grid_search(
     base: dict[str, Any] = {}
     if seasonality:
         base["seasonality_components"] = seasonality
+        # Per-group stats engage only when the window holds min_samples_per_group
+        # points of the current seasonal key (~min_samples_per_group * cardinality
+        # points). If even the largest fold-feasible window can't reach that, the
+        # chosen seasonality will silently fall back to global at runtime — flag it
+        # in the decision log so the tuned config isn't trusted to be seasonal.
+        fill = seasonal_fill_window(tuner)
+        if fill and grid and max(grid) < fill:
+            tuner.log(
+                "window",
+                f"seasonality {seasonality} needs window_size >= {fill} to engage per-group "
+                f"stats, but the fold budget caps the window at {max(grid)} on this history "
+                "— the band will use global statistics (seasonality has no effect). Tune on "
+                "more history, or use `dtk tune` to set a larger window manually.",
+                seasonal_fill_window=fill,
+            )
 
     has_trend = trend_present(tuner)
     if not has_trend:

{detectkit-0.32.0 → detectkit-0.34.0}/detectkit/autotune/label_server.py

@@ -10,12 +10,10 @@ off the machine, and nothing is written until the user explicitly saves.
 from __future__ import annotations
 
 import json
-import re
 import secrets
 import threading
 import webbrowser
 from collections.abc import Callable
-from datetime import datetime, timezone
 from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
 from pathlib import Path
 from typing import Any, cast
@@ -24,23 +22,12 @@ from urllib.parse import parse_qs, urlparse
 import numpy as np
 
 from detectkit.autotune.html_labeler import render_labeler_html
-from detectkit.autotune.labels import parse_incident_labels
-
-_NAME_RE = re.compile(r"[^a-z0-9_-]+")
-_MAX_BODY = 5_000_000  # generous cap on the posted labels payload
+from detectkit.autotune.labels import parse_incident_labels, versioned_labels_path
 
+# Re-exported under the historical name for the labeler-server tests.
+from detectkit.autotune.labels import sanitize_label_set_name as _sanitize  # noqa: F401
 
-def _sanitize(name: str) -> str:
-    """Filesystem-safe slug for a label-set name; ``""`` when blank.
-
-    Used as an optional *suffix* appended to the metric-named filename, so a blank
-    name simply yields no suffix (the file is named after the metric alone).
-    """
-    return _NAME_RE.sub("-", name.strip().lower()).strip("-")
-
-
-def _stamp() -> str:
-    return datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ")
+_MAX_BODY = 5_000_000  # generous cap on the posted labels payload
 
 
 class _LabelServer(ThreadingHTTPServer):
@@ -90,16 +77,14 @@ class _Handler(BaseHTTPRequestHandler):
 
             payload = json.loads(self.rfile.read(length).decode("utf-8"))
             yaml_text = str(payload.get("yaml", ""))
-            suffix = _sanitize(str(payload.get("name", "")))
             raw = _yaml.safe_load(yaml_text)
             # validate against the canonical schema before writing anything
             parse_incident_labels(
                 raw, interval_seconds=srv.interval_seconds, metric_name=srv.metric
             )
             srv.incidents_dir.mkdir(parents=True, exist_ok=True)
-            # Always name the file after the metric; the optional set name is a suffix.
-            stem = f"{srv.metric}-{suffix}" if suffix else srv.metric
-            out = srv.incidents_dir / f"{stem}-{_stamp()}.yml"
+            # Versioned, metric-named file (the optional set name is a suffix).
+            out = versioned_labels_path(srv.incidents_dir, srv.metric, str(payload.get("name", "")))
             out.write_text(yaml_text, encoding="utf-8")
             srv.saved_path = out
         except Exception as exc:

{detectkit-0.32.0 → detectkit-0.34.0}/detectkit/autotune/labels.py

@@ -14,6 +14,7 @@ When no labels are supplied the tuner falls back to unsupervised mode.
 
 from __future__ import annotations
 
+import re
 from dataclasses import dataclass, field
 from datetime import datetime, timezone
 from pathlib import Path
@@ -279,3 +280,43 @@ def load_capture_windows(
     """Load a labels file and render its capture windows as labeler display dicts."""
     labels = parse_labels_file(path, interval_seconds=interval_seconds, metric_name=metric_name)
     return capture_windows_to_display(labels)
+
+
+# Versioned labels store helpers (shared by the autotune labeler server and the
+# `dtk tune` labeler so both name + discover files the same way).
+_LABELS_GLOBS = ("*.yml", "*.yaml", "*.json")
+_NAME_RE = re.compile(r"[^a-z0-9_-]+")
+
+
+def newest_labels_file(directory: str | Path) -> Path | None:
+    """Newest versioned labels file in *directory* (``None`` if empty/absent).
+
+    Versioned names (``<metric>[-<set>]-<UTCstamp>.yml``) sort chronologically by
+    name; mtime tie-breaks.
+    """
+    d = Path(directory)
+    if not d.is_dir():
+        return None
+    files: list[Path] = []
+    for pattern in _LABELS_GLOBS:
+        files.extend(d.glob(pattern))
+    if not files:
+        return None
+    return sorted(files, key=lambda p: (p.name, p.stat().st_mtime))[-1]
+
+
+def sanitize_label_set_name(name: str) -> str:
+    """Filesystem-safe slug for an optional label-set name (``""`` when blank)."""
+    return _NAME_RE.sub("-", name.strip().lower()).strip("-")
+
+
+def versioned_labels_path(incidents_dir: str | Path, metric: str, name: str = "") -> Path:
+    """Versioned labels path ``<metric>[-<slug>]-<UTCstamp>.yml`` in *incidents_dir*.
+
+    The single source of the labels filename convention: the optional set *name*
+    is sanitized to a suffix, blank → just the metric name.
+    """
+    stamp = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ")
+    slug = sanitize_label_set_name(name)
+    stem = f"{metric}-{slug}" if slug else metric
+    return Path(incidents_dir) / f"{stem}-{stamp}.yml"

{detectkit-0.32.0 → detectkit-0.34.0}/detectkit/autotune/window_select.py

@@ -16,6 +16,15 @@ import numpy as np
 from detectkit.autotune._base import _AutoTuneBase
 from detectkit.autotune._types import CandidateEval
 from detectkit.detectors.factory import DetectorFactory
+from detectkit.detectors.seasonality import parse_seasonality_data
+from detectkit.detectors.statistical._windowed import WindowedStatDetector
+
+# Reference per-group floor used to size a seasonality-fill window candidate. The
+# windowed detectors share this default (MAD 10 is the largest); using it makes
+# the fill window cover every windowed type so cross-validation can actually
+# discover whether conditioning on a seasonal key helps. See
+# ``seasonal_fill_window``.
+_MSPG_REF = int(WindowedStatDetector.MIN_SAMPLES_PER_GROUP_DEFAULT)
 
 
 def min_samples_for(window_size: int, floor: int) -> int:
@@ -23,8 +32,54 @@ def min_samples_for(window_size: int, floor: int) -> int:
     return min(window_size, max(floor, round(window_size / 4)))
 
 
+def max_seasonal_cardinality(tuner: _AutoTuneBase) -> int:
+    """Largest distinct-key count among the available single seasonality columns.
+
+    Per-group statistics only engage once the window holds
+    ``min_samples_per_group`` points sharing the current point's key, and same-key
+    points recur every *cardinality* grid positions — so this is the recurrence
+    period the window must cover. We use the most granular single column (e.g.
+    ``hour_of_day`` → 24) as the representative key; conjunctive groupings are
+    rarer and are backstopped by the detector's runtime under-fill warning.
+    Returns 0 when no seasonality columns are present.
+    """
+    columns = [c for c in tuner.data.get("seasonality_columns", []) if c != "is_holiday"]
+    if not columns:
+        return 0
+    season = parse_seasonality_data(tuner.data.get("seasonality_data", np.array([])), columns)
+    card = 0
+    for col in columns:
+        vals = season.get(col)
+        if vals is None or len(vals) == 0:
+            continue
+        distinct = {v for v in vals.tolist() if v is not None}
+        card = max(card, len(distinct))
+    return card
+
+
+def seasonal_fill_window(tuner: _AutoTuneBase) -> int:
+    """Smallest window that can fill a single-column seasonal group, else 0.
+
+    ``min_samples_per_group * cardinality``. None of the natural-unit candidates
+    (≈1 day, ≈1 week) reach this for hourly ``hour_of_day`` data (24 keys → 240),
+    so without this the chosen seasonality silently never engages at the tuned
+    window. Returns 0 when there is no seasonality to fill.
+    """
+    card = max_seasonal_cardinality(tuner)
+    return _MSPG_REF * card if card > 0 else 0
+
+
 def window_grid(tuner: _AutoTuneBase) -> list[int]:
-    """Candidate window sizes (≈1 day, ≈1 week, default 100), clamped to fit folds."""
+    """Candidate window sizes (≈1 day, ≈1 week, default 100), clamped to fit folds.
+
+    When the data carries seasonality columns, also offer a window large enough to
+    fill the most granular seasonal group (``min_samples_per_group * cardinality``)
+    so that — if seasonality is chosen downstream — cross-validation can evaluate a
+    window where the per-group band actually engages instead of silently falling
+    back to global statistics. Capped (like the other candidates) so it never
+    exceeds the fold budget; if it doesn't fit, seasonality simply can't fill on
+    this much history and the detector's runtime warning will say so.
+    """
     fixed = tuner.settings.fixed_params.get("window_size")
     if isinstance(fixed, int):
         return [fixed]
@@ -34,6 +89,9 @@ def window_grid(tuner: _AutoTuneBase) -> list[int]:
     cap = max(20, n // (fold_count + 1))
     pts_per_day = max(1, round(86400 / tuner.interval_seconds))
     candidates = {100, pts_per_day, 7 * pts_per_day}
+    fill = seasonal_fill_window(tuner)
+    if fill:
+        candidates.add(fill)
     grid = sorted({w for w in candidates if 20 <= w <= cap})
     if not grid:
         grid = [max(2, min(cap, 100))]

{detectkit-0.32.0 → detectkit-0.34.0}/detectkit/cli/assets/claude/rules/cli.md

@@ -88,13 +88,24 @@ config back into the metric YAML **in place** (autotune, by contrast, writes a n
 datapoints (run `dtk run --steps load` first if empty); the selector must resolve
 to a single metric.
 
+**Mark incidents + see alert quality live.** A second, **synced** chart beneath
+the detector view lets you **mark the real incidents** (drag to create a span,
+drag its edges/middle to adjust, ✕ or Delete to remove). As you tune, a metrics
+bar shows two operator numbers: **incident catch rate (recall)** — how many marked
+incidents your config catches — and **false-alert rate** — what share of alerts
+fall outside any real incident ("≈1 in N false"). **Save incidents** writes a
+versioned `incidents/<metric>/*.yml` — the same store `dtk autotune` reads, so the
+same labels feed the next supervised tune (it seeds from the newest file on open).
+Saving incidents does not end the session; only **Apply** does. A **y = 0 line**
+toggle (shared with `dtk run --report`) shows the metric relative to zero.
+
 Safe write-back: the config is validated before anything is written, the previous
 YAML is archived under `metrics/.history/<metric>/`, and only then is the metric
 overwritten. Takes **no pipeline lock** (it only edits a config file); re-run
 `dtk run` afterward to recompute detections under the new config.
-`--no-serve` writes a static read-only preview HTML instead (no write-back);
-`--from` / `--to` bound the window; `--no-open` prints the URL without opening a
-browser.
+`--no-serve` writes a static read-only preview HTML instead (no write-back —
+**Save incidents** downloads the labels file); `--from` / `--to` bound the window;
+`--no-open` prints the URL without opening a browser.
 
 ## `dtk test-alert <metric>`
 

{detectkit-0.32.0 → detectkit-0.34.0}/detectkit/cli/assets/claude/rules/detectors.md

@@ -101,7 +101,15 @@ seasonality_components:
 - `["hour", "day_of_week"]` — two *separate* adjustments.
 - `[["hour", "day_of_week"]]` — one *combined* group per pair.
 
-`min_samples_per_group` is the floor of points required per bucket.
+`min_samples_per_group` is the floor of points required per bucket. **Size the
+window to fill a bucket:** a group engages only when the window holds
+`min_samples_per_group` points of the current key, and same-key points recur once
+per *cardinality*, so `window_size ≳ min_samples_per_group × distinct_keys`. With
+hourly `["hour"]` (24 keys, mad default 10) that's `≳ 240` — the default
+`window_size = 100` fills no bucket, so seasonality silently falls back to the
+global band (the detector logs a one-time warning). Raise `window_size`, lower
+`min_samples_per_group`, or use a coarser grouping. `dtk autotune` now offers a
+fill-sized window candidate automatically.
 
 ## Preprocessing — `input_type`
 

{detectkit-0.32.0 → detectkit-0.34.0}/detectkit/cli/commands/tune.py

@@ -15,6 +15,7 @@ from __future__ import annotations
 
 import click
 
+from detectkit.autotune.labels import load_incidents_for_display, newest_labels_file
 from detectkit.cli._output import echo_done, echo_error, echo_noop
 from detectkit.cli.commands.autotune import _load_project
 from detectkit.cli.commands.run import parse_date, select_metrics
@@ -56,6 +57,26 @@ def run_tune(
 
     metric_path, config = metrics[0]
     name = config.name
+    interval_seconds = config.get_interval().seconds
+
+    # Seed the synced labeler with the newest already-marked incidents from the
+    # shared store incidents/<metric>/ (the same files dtk autotune reads), so
+    # labeling round-trips across both tools. Best-effort — a missing/bad file
+    # just yields no seed.
+    incidents_dir = project_root / "incidents" / name
+    preload_incidents: list[dict[str, str]] = []
+    newest = newest_labels_file(incidents_dir)
+    if newest is not None:
+        try:
+            preload_incidents = load_incidents_for_display(
+                newest, interval_seconds=interval_seconds, metric_name=name
+            )
+            click.echo(
+                f"  Seeded {len(preload_incidents)} incident(s) from "
+                f"{newest.relative_to(project_root)}"
+            )
+        except Exception as exc:  # noqa: BLE001 — preload is a best-effort convenience
+            click.echo(click.style(f"  Could not preload {newest}: {exc}", fg="yellow"))
 
     from_dt = parse_date(from_date) if from_date else None
     to_dt = parse_date(to_date) if to_date else None
@@ -68,6 +89,7 @@ def run_tune(
         start=from_dt,
         end=to_dt,
         project_name=project_name,
+        incidents=preload_incidents,
     )
     n_points = len(payload["points"])
     if n_points == 0:
@@ -97,6 +119,9 @@ def run_tune(
         project_root=project_root,
         open_browser=not no_open,
         echo=click.echo,
+        metric_name=name,
+        incidents_dir=incidents_dir,
+        interval_seconds=interval_seconds,
     )
     if applied is None:
         echo_noop(name, "tuning cancelled — metric unchanged")

{detectkit-0.32.0 → detectkit-0.34.0}/detectkit/detectors/statistical/_windowed.py

@@ -26,6 +26,7 @@ Subclasses define:
 
 from __future__ import annotations
 
+import logging
 import math
 from abc import abstractmethod
 from typing import Any
@@ -40,6 +41,8 @@ from detectkit.detectors.seasonality import (
 )
 from detectkit.utils.stats import effective_sample_size, weighted_median
 
+logger = logging.getLogger(__name__)
+
 _INPUT_TYPES = {"values", "changes", "absolute_changes", "log_changes"}
 _CHANGE_INPUT_TYPES = {"changes", "absolute_changes", "log_changes"}
 _SMOOTHING_METHODS = {None, "ema", "sma"}
@@ -141,6 +144,10 @@ class WindowedStatDetector(BaseDetector):
             weight_decay=weight_decay,
             detrend=detrend,
         )
+        # Whether the one-time "seasonality groups can't fill this window" check
+        # has run for this instance (so the warning fires at most once per run,
+        # not once per detect() batch).
+        self._underfill_checked: bool = False
 
     # ------------------------------------------------------------------
     # Subclass hooks
@@ -386,6 +393,56 @@ class WindowedStatDetector(BaseDetector):
         # (age 0) is values + slope * age
         return (med_new - med_old) / (age_old - age_new)
 
+    def _warn_if_groups_cannot_fill(
+        self,
+        seasonality_components: list[str | list[str]],
+        seasonality_dict: dict[str, np.ndarray],
+        window_size: int,
+        min_samples_per_group: int,
+    ) -> None:
+        """Warn once if the window is too small to ever fill a seasonality group.
+
+        Per-group statistics only engage when the trailing window holds at least
+        ``min_samples_per_group`` points sharing the current point's seasonal key.
+        Same-key points recur every *cardinality* positions on the grid, so the
+        window must hold roughly ``min_samples_per_group * cardinality`` points
+        before any group fills — otherwise EVERY point silently falls back to the
+        global (un-conditioned) band and the configured seasonality has no effect.
+        This is easy to hit by accident (e.g. the default ``window_size=100`` with
+        24-key hourly seasonality needs ``>= 240``), so surface it loudly once.
+        """
+        if self._underfill_checked:
+            return
+        self._underfill_checked = True
+
+        for group in seasonality_components:
+            cols = [group] if isinstance(group, str) else list(group)
+            present = [c for c in cols if c in seasonality_dict]
+            if not present:
+                continue
+            # Distinct seasonal keys actually present in the data (conjunction of
+            # the group's columns) — the per-key recurrence period on the grid.
+            keys = set(zip(*[seasonality_dict[c].tolist() for c in present], strict=False))
+            cardinality = len(keys)
+            if cardinality <= 0:
+                continue
+            needed = min_samples_per_group * cardinality
+            if window_size < needed:
+                logger.warning(
+                    "%s: seasonality group %s has %d distinct key(s) but window_size=%d "
+                    "holds only ~%d same-key point(s) (< min_samples_per_group=%d), so this "
+                    "group falls back to global statistics and the seasonality has no effect. "
+                    "Increase window_size to >= %d (min_samples_per_group * distinct keys), "
+                    "lower min_samples_per_group, or use a coarser grouping.",
+                    self.__class__.__name__,
+                    cols,
+                    cardinality,
+                    window_size,
+                    window_size // cardinality,
+                    min_samples_per_group,
+                    needed,
+                )
+
     # ------------------------------------------------------------------
     # Detection pipeline
     # ------------------------------------------------------------------
@@ -415,6 +472,9 @@ class WindowedStatDetector(BaseDetector):
         seasonality_dict = {}
         if seasonality_components and len(seasonality_data) > 0 and seasonality_columns:
             seasonality_dict = parse_seasonality_data(seasonality_data, seasonality_columns)
+            self._warn_if_groups_cannot_fill(
+                seasonality_components, seasonality_dict, window_size, min_samples_per_group
+            )
 
         weight_lut = self._build_weight_lut(timestamps)
 

detectkit-0.34.0/detectkit/reporting/assets/report.js

@@ -0,0 +1,80 @@
+"use strict";(()=>{var ye={"--term-bg":"#211e1a","--clay":"#d15b36","--st-anomaly":"#d63232","--st-recovery":"#36a64f","--st-nodata":"#f0ad4e","--st-error":"#5a7a8c","--faint":"#9a9384","--muted":"#6e675b","--border":"#332f29","--term-border":"#332f29"};function L(e){return getComputedStyle(document.documentElement).getPropertyValue(e).trim()||ye[e]||"#888"}function we(e){let t=e.replace("#","").trim();t.length===3&&(t=t[0]+t[0]+t[1]+t[1]+t[2]+t[2]);let n=parseInt(t,16);return t.length!==6||Number.isNaN(n)?[209,91,54]:[n>>16&255,n>>8&255,n&255]}function N(e,t){let[n,i,a]=we(e);return`rgba(${n},${i},${a},${t})`}function ee(e){let t=Math.max(1,window.devicePixelRatio||1),n=e.clientWidth||e.offsetWidth||0,i=e.clientHeight||e.offsetHeight||0;return e.width=Math.round(n*t),e.height=Math.round(i*t),t}function te(e,t,n,i){let a=()=>e.width-(t.l+t.r)*i,h=()=>e.height-(t.t+t.b)*i,r=()=>n.tmax-n.tmin||1,l=()=>n.vmax-n.vmin||1;return{px:m=>t.l*i+(m-n.tmin)/r()*a(),py:m=>e.height-t.b*i-(m-n.vmin)/l()*h(),tAt:m=>n.tmin+(m-t.l*i)/(a()||1)*r(),vAt:m=>n.vmin+(e.height-t.b*i-m)/(h()||1)*l(),plotW:a,plotH:h,tspan:r}}var F=Number.isFinite;function ne(e,t,n,i,a,h,r,l,p,f,b,u){let m=t.length,$=Math.max(1,Math.round(r)),C=a-i||1,T=0;for(let y=0;y<m;y++){let s=n[y];!F(s)||t[y]<i||t[y]>a||T++}if(e.strokeStyle=f,e.lineWidth=b*u,e.lineJoin="round",e.beginPath(),T<=$){let y=!1;for(let s=0;s<m;s++){let S=n[s],M=t[s];if(!F(S)||M<i||M>a){y=!1;continue}let E=l(M),R=p(S);y?e.lineTo(E,R):(e.moveTo(E,R),y=!0)}}else{let y=new Array($).fill(null),s=new Array($).fill(null);for(let M=0;M<m;M++){let E=n[M],R=t[M];if(!F(E)||R<i||R>a)continue;let A=Math.floor((R-i)/C*($-1));A=A<0?0:A>$-1?$-1:A,(y[A]===null||E<y[A])&&(y[A]=E),(s[A]===null||E>s[A])&&(s[A]=E)}let S=!1;for(let M=0;M<$;M++){if(s[M]===null){S=!1;continue}let E=h+M,R=p(s[M]),A=p(y[M]);S?e.lineTo(E,R):(e.moveTo(E,R),S=!0),e.lineTo(E,A)}}e.stroke()}function re(e){let t=[],n=-1;for(let i=0;i<e.length;i++){let a=e[i];a.lo!==null&&a.hi!==null&&F(a.lo)&&F(a.hi)?n===-1&&(n=i):n!==-1&&(t.push([n,i-1]),n=-1)}return n!==-1&&t.push([n,e.length-1]),t}function oe(e,t,n,i,a,h,r,l,p){e.fillStyle=N(h,r);for(let[f,b]of n){e.beginPath(),e.moveTo(i(t[f].t),a(t[f].hi));for(let u=f+1;u<=b;u++)e.lineTo(i(t[u].t),a(t[u].hi));for(let u=b;u>=f;u--)e.lineTo(i(t[u].t),a(t[u].lo));e.closePath(),e.fill()}e.strokeStyle=N(h,l),e.lineWidth=1*p;for(let[f,b]of n)for(let u of["hi","lo"]){e.beginPath();for(let m=f;m<=b;m++){let $=i(t[m].t),C=a(t[m][u]);m===f?e.moveTo($,C):e.lineTo($,C)}e.stroke()}}function ie(e,t,n,i,a,h,r,l){for(let p=0;p<t.length;p++){let f=t[p];if(!F(f.v)||f.t<n||f.t>i)continue;let b=a(f.t),u=h(f.v);e.fillStyle=N(r,.18),e.beginPath(),e.arc(b,u,6*l,0,Math.PI*2),e.fill(),e.fillStyle=r,e.beginPath(),e.arc(b,u,3*l,0,Math.PI*2),e.fill()}}function se(e,t,n,i,a,h,r,l,p,f,b){e.font=`${11*b}px ui-monospace, 'JetBrains Mono', monospace`,e.textBaseline="middle";for(let m=0;m<=4;m++){let $=i.vmin+(i.vmax-i.vmin)*m/4,C=h($);e.strokeStyle=N(p,.1),e.lineWidth=1*b,e.beginPath(),e.moveTo(n.l*b,C),e.lineTo(t.width-n.r*b,C),e.stroke(),e.fillStyle=f,e.textAlign="right",e.fillText(W($),(n.l-8)*b,C)}e.textBaseline="top";let u=l-r||1;for(let m=0;m<=5;m++){let $=r+u*m/5,C=a($);e.fillStyle=f,e.textAlign=m===0?"left":m===5?"right":"center",e.fillText($e($,u),C,(t.height-n.b+7)*b)}}function W(e){let t=Math.abs(e);return t>=1e3?e.toFixed(0):t>=10?e.toFixed(1):t>=1?e.toFixed(2):e.toFixed(3)}function $e(e,t){let n=new Date(e).toISOString();return t<2*864e5?n.slice(5,16).replace("T"," "):n.slice(5,10)}function X(e){return new Date(e).toISOString().slice(0,19).replace("T"," ")}function ae(e){let t=Math.round(e/6e4);if(t<60)return t+"m";let n=Math.floor(t/60),i=t%60;if(n<24)return n+"h"+(i?" "+i+"m":"");let a=Math.floor(n/24),h=n%24;return a+"d"+(h?" "+h+"h":"")}function le(e,t,n){return{left:t.l*n,top:t.t*n,right:e.width-t.r*n,bottom:e.height-t.b*n}}function ce(e,t,n,i,a,h,r){let l=le(t,n,i),p=Math.max(l.left,Math.min(a(h),l.right));p<=l.left+.5||(e.save(),e.fillStyle="rgba(17,15,13,0.42)",e.fillRect(l.left,l.top,p-l.left,l.bottom-l.top),e.strokeStyle=N(L("--faint"),.7),e.lineWidth=1*i,e.setLineDash([4*i,4*i]),e.beginPath(),e.moveTo(p,l.top),e.lineTo(p,l.bottom),e.stroke(),e.setLineDash([]),e.fillStyle=N(L("--faint"),.95),e.font=`${10*i}px ui-monospace, monospace`,e.textAlign="left",e.textBaseline="top",e.fillText(r,p+6*i,l.top+5*i),e.restore())}function de(e,t,n,i,a,h,r){let l=le(t,n,i),p=5*i;e.save();for(let f=0;f<h.length;f++){let b=h[f],u=a(b.t);if(u<l.left-1||u>l.right+1)continue;let m=r(b.kind);e.strokeStyle=N(m,.45),e.lineWidth=1*i,e.beginPath(),e.moveTo(u,l.top),e.lineTo(u,l.bottom),e.stroke(),e.fillStyle=m,e.beginPath(),e.moveTo(u-p,l.top),e.lineTo(u+p,l.top),e.lineTo(u,l.top+p*1.4),e.closePath(),e.fill()}e.restore()}var P={l:56,r:16,t:14,b:28},Me=300*1e3,d="dtk-report";function G(e){return e==="recovery"?L("--st-recovery"):e==="no_data"?L("--st-nodata"):L("--st-anomaly")}function Ae(e){return e==="recovery"?"recovery":e==="no_data"?"no-data":"anomaly"}var w=e=>String(e).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;"),K=(e,t,n)=>Math.max(t,Math.min(n,e)),ue=["--clay","--st-error","--st-recovery","--st-nodata"];function Te(e,t){Re(),t.classList.add(d),t.innerHTML="";let n=document.createElement("div");n.className="dtk-report-root",t.appendChild(n);let i=new Map;for(let s of e.points)s.v!==null&&i.set(s.t,s.v);let a=e.detectors.map((s,S)=>{let M=s.effective_start,E=s.points.map(A=>M!==null&&A.t<M?{t:A.t,lo:null,hi:null}:{t:A.t,lo:A.lo,hi:A.hi}),R=[];for(let A of s.points)if(A.a===1&&(M===null||A.t>=M)){let I=i.get(A.t);I!==void 0&&R.push({t:A.t,v:I})}return{det:s,band:E,anomalies:R,effectiveStart:M,color:L(ue[S%ue.length]),shown:S===0}});a.length===1&&(a[0].shown=!0),n.appendChild(Se(e));let h=null;a.length>1&&(h=Ce(a,()=>u.repaint()),n.appendChild(h));let r=document.createElement("div");r.className="dtk-bar",n.appendChild(r);let l=document.createElement("div");l.className="dtk-presets",r.appendChild(l);let p=document.createElement("div");p.className="dtk-readout",p.textContent="hover the chart for a point readout",r.appendChild(p);let f=document.createElement("div");f.className="dtk-chart";let b=document.createElement("canvas");f.appendChild(b),n.appendChild(f);let u=Pe(b,e,a,i,s=>{p.innerHTML=s}),m=[{label:"24h",ms:24*3600*1e3},{label:"7d",ms:7*86400*1e3},{label:"30d",ms:30*86400*1e3},{label:"All",ms:null}];for(let s of m){let S=document.createElement("button");S.className="dtk-preset",S.textContent=s.label,S.onclick=()=>{s.ms===null?u.resetView():u.setView(e.period.end-s.ms,e.period.end),Le(l,S)},l.appendChild(S)}let $=document.createElement("label");$.className="dtk-zero",$.title="Draw a horizontal line at y = 0 and scale the chart to include zero.";let C=document.createElement("input");C.type="checkbox",C.onchange=()=>u.setZeroLine(C.checked),$.appendChild(C),$.appendChild(document.createTextNode(" y = 0")),l.appendChild($),n.appendChild(Ee(e,s=>u.focusAlert(s))),u.resize();let T=0,y=()=>{T||(T=requestAnimationFrame(()=>{T=0,u.resize()}))};window.addEventListener("resize",y)}function Se(e){let t=document.createElement("div");t.className="dtk-header";let n=e.interval_seconds/60,i=e.interval_seconds>=86400?e.interval_seconds/86400+"d":e.interval_seconds>=3600?e.interval_seconds/3600+"h":n>=1?n+"min":e.interval_seconds+"s",a=e.project?`${w(e.project)} \xB7 ${w(e.metric)}`:w(e.metric),h=e.summary;return t.innerHTML=`<div class="dtk-h-top"><h1 class="dtk-title">${a}</h1><div class="dtk-meta">${w(X(e.period.start))} \u2013 ${w(X(e.period.end))} \xB7 interval ${w(i)}${e.generated_at?` \xB7 generated ${w(e.generated_at)}`:""}</div></div>`+(e.description?`<p class="dtk-desc">${w(e.description)}</p>`:"")+'<div class="dtk-chips">'+Y("anomalies",h.anomalies,"--st-anomaly")+Y("alerts",h.alerts,"--clay")+Y("recoveries",h.recoveries,"--st-recovery")+Y("no-data",h.no_data,"--st-nodata")+"</div>",t}function Y(e,t,n){let i=L(n);return`<span class="dtk-chip"><span class="dtk-dot" style="background:${w(i)}"></span><span class="dtk-chip-n">${t}</span><span class="dtk-chip-l">${w(e)}</span></span>`}function Ce(e,t){let n=document.createElement("div");return n.className="dtk-legend",e.forEach(i=>{let a=document.createElement("button");a.className="dtk-legend-item"+(i.shown?"":" off"),a.innerHTML=`<span class="dtk-swatch" style="background:${w(i.color)}"></span><span class="dtk-legend-name">${w(i.det.name)}</span><span class="dtk-legend-id">${w(i.det.id.slice(0,8))}</span><span class="dtk-legend-n">${i.det.anomaly_count}</span>`,a.onclick=()=>{i.shown=!i.shown,a.classList.toggle("off",!i.shown),t()},n.appendChild(a)}),n}function Ee(e,t){let n=document.createElement("div");n.className="dtk-alerts";let i=document.createElement("div");if(i.className="dtk-alerts-head",i.textContent=`Alerts (${e.alerts.length})`,n.appendChild(i),e.alerts.length===0){let r=document.createElement("div");return r.className="dtk-alerts-empty",r.textContent="No alerts fired in this period.",n.appendChild(r),n}let a=document.createElement("div");a.className="dtk-alerts-list";let h=[...e.alerts].sort((r,l)=>l.t-r.t);for(let r of h){let l=document.createElement("button");l.className="dtk-alert-row";let p=G(r.kind),f=r.direction!=="none"?` \xB7 ${w(r.direction)}`:"",b=r.severity>0?` \xB7 sev ${r.severity.toFixed(2)}`:"",u=r.value!==null?` \xB7 value ${W(r.value)}`:"",m=r.onset!==null&&r.kind!=="no_data"?` \xB7 ${ae(Math.max(0,r.t-r.onset))} (${r.consecutive} pts)`:"";l.innerHTML=`<span class="dtk-alert-time">${w(X(r.t))}</span><span class="dtk-badge" style="background:${w(N(p,.18))};color:${w(p)};border-color:${w(N(p,.5))}">${w(Ae(r.kind))}</span><span class="dtk-alert-body"><span class="dtk-alert-rule">${w(r.rule)}</span><span class="dtk-alert-sub">${w(r.detector)}${f}${b}${u}${w(m)}</span></span>`,l.onclick=()=>t(r),a.appendChild(l)}return n.appendChild(a),n}function Le(e,t){e.querySelectorAll(".dtk-preset").forEach(n=>n.classList.remove("active")),t.classList.add("active")}function Pe(e,t,n,i,a){let h=e.getContext("2d");if(!h)throw new Error("report: 2D context unavailable");let r=h,l=t.points.map(o=>o.t),p=t.points.map(o=>o.v===null?NaN:o.v),f=t.period.start,b=t.period.end,u=b-f||1,m=Math.min(Me,u),$=0,C=1;E();let T=f,y=b,s=1,S=null,M=!1;function E(){let o=1/0,c=-1/0;for(let k of p)Number.isFinite(k)&&(k<o&&(o=k),k>c&&(c=k));for(let k of n)for(let x of k.band)x.lo!==null&&Number.isFinite(x.lo)&&x.lo<o&&(o=x.lo),x.hi!==null&&Number.isFinite(x.hi)&&x.hi>c&&(c=x.hi);(!Number.isFinite(o)||!Number.isFinite(c))&&(o=0,c=1),M&&(o>0&&(o=0),c<0&&(c=0)),c<=o&&(c=o+1);let v=(c-o)*.06;$=o-v,C=c+v}function R(o){M!==o&&(M=o,E(),V())}function A(){for(let o of n)if(o.shown&&o.effectiveStart!==null)return o.effectiveStart;for(let o of n)if(o.effectiveStart!==null)return o.effectiveStart;return null}function I(){return{tmin:T,tmax:y,vmin:$,vmax:C}}function fe(){return te(e,P,I(),s)}function O(o,c){let v=c-o;if(v<m){let k=(o+c)/2;o=k-m/2,c=k+m/2,v=m}v>=u&&(o=f,c=b),o<f&&(c+=f-o,o=f),c>b&&(o-=c-b,c=b),T=K(o,f,b),y=K(c,f,b),V()}function Z(){T=f,y=b,V()}function pe(o){let c=o.onset!==null?Math.min(o.onset,o.t):o.t,v=o.t,x=Math.max(v-c,m)*1.5+m;O(c-x,v+x)}let j=0;function q(){j===0&&(j=requestAnimationFrame(V))}function V(){if(j=0,e.width===0||e.height===0)return;let o=fe(),c=L("--faint"),v=L("--muted"),k=L("--clay");if(r.fillStyle=L("--term-bg"),r.fillRect(0,0,e.width,e.height),l.length===0)return;if(se(r,e,P,I(),o.px,o.py,T,y,c,v,s),M&&$<=0&&C>=0){let g=o.py(0);r.strokeStyle=N(v,.6),r.lineWidth=1.25*s,r.beginPath(),r.moveTo(P.l*s,g),r.lineTo(e.width-P.r*s,g),r.stroke(),r.fillStyle=v,r.textAlign="right",r.textBaseline="middle",r.fillText("0",(P.l-8)*s,g)}r.save(),r.beginPath(),r.rect(P.l*s,P.t*s,o.plotW(),o.plotH()),r.clip();let x=P.t*s,z=o.plotH();for(let g of t.alerts){if(g.onset===null||g.kind==="no_data")continue;let B=Math.min(g.onset,g.t),U=Math.max(g.onset,g.t);if(U<T||B>y)continue;let ke=G(g.kind),Q=o.px(B),ge=o.px(U);r.fillStyle=N(ke,.08),r.fillRect(Q,x,Math.max(ge-Q,1*s),z)}for(let g of n){if(!g.shown)continue;let B=re(g.band);oe(r,g.band,B,o.px,o.py,g.color,.13,.4,s)}ne(r,l,p,T,y,P.l*s,o.plotW(),o.px,o.py,k,1.5,s);for(let g of n)g.shown&&ie(r,g.anomalies,T,y,o.px,o.py,L("--st-anomaly"),s);let D=A();D!==null&&D>T&&ce(r,e,P,s,o.px,D,"detection at full power \u2192");let H=t.alerts.map(g=>({t:g.t,kind:g.kind}));de(r,e,P,s,o.px,H,g=>G(g)),S!==null&&he(o,x,z,c),r.restore()}function be(o){let c=l;if(c.length===0)return-1;let v=0,k=c.length-1;for(;v<k;){let x=v+k>>1;c[x]<o?v=x+1:k=x}return v>0&&o-c[v-1]<c[v]-o&&(v-=1),v}function he(o,c,v,k){let x=be(S);if(x<0)return;let z=l[x];if(z<T||z>y){a("hover the chart for a point readout");return}let D=o.px(z);r.strokeStyle=N(k,.45),r.lineWidth=1*s,r.setLineDash([2*s,2*s]),r.beginPath(),r.moveTo(D,c),r.lineTo(D,c+v),r.stroke(),r.setLineDash([]);let H=p[x];if(Number.isFinite(H)){let g=o.py(H);r.fillStyle=L("--term-bg"),r.beginPath(),r.arc(D,g,4*s,0,Math.PI*2),r.fill(),r.strokeStyle=L("--clay"),r.lineWidth=2*s,r.beginPath(),r.arc(D,g,4*s,0,Math.PI*2),r.stroke()}ve(x)}function ve(o){let c=l[o],v=p[o],k=`<span class="dtk-ro-t">${w(X(c))}</span>`;k+=`<span class="dtk-ro-v">value ${Number.isFinite(v)?W(v):"\u2014"}</span>`;for(let x of n){if(!x.shown)continue;let z=x.band[o],D=x.det.points[o];if(z&&z.lo!==null&&z.hi!==null){let H=D&&D.a===1,g=H&&D.sev!==null?` sev ${D.sev.toFixed(2)}`:"",B=H?`<span class="dtk-ro-anom" style="color:${w(L("--st-anomaly"))}">anomaly${w(g)}</span>`:'<span class="dtk-ro-ok">ok</span>';k+=`<span class="dtk-ro-det"><span class="dtk-swatch" style="background:${w(x.color)}"></span>${w(x.det.name)}: [${W(z.lo)}, ${W(z.hi)}] ${B}</span>`}}a(k)}function J(o){let c=e.getBoundingClientRect(),v=(o-c.left-P.l)/(c.width-(P.l+P.r)||1);return T+K(v,0,1)*(y-T)}e.addEventListener("wheel",o=>{o.preventDefault();let c=J(o.clientX),v=y-T,k=K(v*Math.pow(1.0015,o.deltaY),m,u),x=(c-T)/(v||1);O(c-x*k,c-x*k+k)},{passive:!1});let _=null;e.addEventListener("mousedown",o=>{_={x:o.clientX,vMin:T,vMax:y},e.style.cursor="grabbing"}),window.addEventListener("mousemove",o=>{if(!_)return;let c=e.getBoundingClientRect(),v=(_.vMax-_.vMin)/(c.width-(P.l+P.r)||1),k=(o.clientX-_.x)*v;O(_.vMin-k,_.vMax-k)}),window.addEventListener("mouseup",()=>{_&&(_=null,e.style.cursor="crosshair")}),e.addEventListener("mousemove",o=>{_||(S=J(o.clientX),q())}),e.addEventListener("mouseleave",()=>{S!==null&&(S=null,a("hover the chart for a point readout"),q())}),e.addEventListener("dblclick",()=>Z()),e.style.cursor="crosshair";function xe(){s=ee(e),V()}return{repaint:()=>q(),resize:xe,setView:O,resetView:Z,focusAlert:pe,setZeroLine:R}}var me=!1;function Re(){if(me)return;me=!0;let e=`
+.${d}{--term-bg:#211e1a;--term-border:#332f29;--term-text:#c9c2b4;
+  --clay:#d15b36;--clay-700:#b4471f;--ink:#1b1916;--paper:#f5f1e8;--surface:#fbf9f3;
+  --border:#e6e0d4;--muted:#6e675b;--faint:#9a9384;
+  --anom:#d63232;--rec:#36a64f;--nod:#f0ad4e;
+  --sans:'Schibsted Grotesk',ui-sans-serif,system-ui,-apple-system,'Segoe UI',Roboto,sans-serif;
+  --mono:'JetBrains Mono',ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;
+  font-family:var(--sans);color:var(--ink);}
+.${d} *{box-sizing:border-box;}
+.${d} .dtk-report-root{max-width:1100px;margin:0 auto;padding:20px 18px 40px;}
+/* --- header row ----------------------------------------------------------- */
+.${d} .dtk-header{margin-bottom:16px;padding-left:12px;
+  border-left:3px solid var(--clay);}
+.${d} .dtk-h-top{display:flex;flex-wrap:wrap;align-items:baseline;gap:4px 14px;}
+.${d} .dtk-title{font-size:21px;font-weight:700;margin:0;color:var(--ink);
+  font-family:var(--sans);letter-spacing:-0.01em;}
+.${d} .dtk-meta{font-size:12px;color:var(--muted);font-family:var(--mono);}
+.${d} .dtk-desc{margin:8px 0 0;font-size:13px;color:var(--muted);max-width:760px;
+  line-height:1.5;}
+/* --- summary chips (surface cards) ---------------------------------------- */
+.${d} .dtk-chips{display:flex;flex-wrap:wrap;gap:8px;margin-top:12px;}
+.${d} .dtk-chip{display:inline-flex;align-items:center;gap:7px;padding:5px 11px;
+  background:var(--surface);border:1px solid var(--border);border-radius:10px;font-size:12px;}
+.${d} .dtk-dot{width:8px;height:8px;border-radius:50%;display:inline-block;}
+.${d} .dtk-chip-n{font-weight:700;font-family:var(--mono);color:var(--ink);}
+.${d} .dtk-chip-l{color:var(--faint);font-family:var(--mono);font-size:11px;
+  text-transform:uppercase;letter-spacing:0.05em;}
+/* --- detector legend ------------------------------------------------------ */
+.${d} .dtk-legend{display:flex;flex-wrap:wrap;gap:8px;margin-bottom:10px;}
+.${d} .dtk-legend-item{display:inline-flex;align-items:center;gap:7px;padding:5px 11px;
+  background:var(--surface);border:1px solid var(--border);border-radius:8px;cursor:pointer;
+  color:var(--ink);font-size:12px;font-family:var(--sans);transition:border-color .12s ease;}
+.${d} .dtk-legend-item:hover{border-color:var(--clay);}
+.${d} .dtk-legend-item.off{opacity:0.45;}
+.${d} .dtk-legend-id{color:var(--faint);font-family:var(--mono);font-size:11px;}
+.${d} .dtk-legend-n{color:var(--anom);font-weight:700;font-family:var(--mono);}
+.${d} .dtk-swatch{width:10px;height:10px;border-radius:2px;display:inline-block;}
+/* --- toolbar (presets + readout) ------------------------------------------ */
+.${d} .dtk-bar{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between;
+  gap:8px;margin-bottom:8px;}
+.${d} .dtk-presets{display:flex;gap:5px;}
+.${d} .dtk-preset{padding:5px 13px;background:var(--surface);
+  border:1px solid var(--border);border-radius:8px;color:var(--muted);cursor:pointer;
+  font-size:12px;font-family:var(--sans);transition:border-color .12s ease,color .12s ease;}
+.${d} .dtk-preset:hover{border-color:var(--clay);color:var(--ink);}
+.${d} .dtk-preset.active{background:var(--clay);color:#fff;border-color:var(--clay);}
+.${d} .dtk-zero{display:inline-flex;align-items:center;gap:5px;margin-left:6px;
+  font-size:12px;color:var(--muted);font-family:var(--sans);cursor:pointer;user-select:none;}
+.${d} .dtk-zero input{accent-color:var(--clay);cursor:pointer;}
+.${d} .dtk-readout{font-size:11px;color:var(--muted);
+  font-family:var(--mono);display:flex;flex-wrap:wrap;gap:4px 12px;align-items:center;}
+.${d} .dtk-readout .dtk-swatch{margin-right:4px;}
+.${d} .dtk-ro-t{font-weight:700;color:var(--ink);}
+/* --- chart panel (dark terminal surface) ---------------------------------- */
+.${d} .dtk-chart{position:relative;width:100%;height:360px;background:var(--term-bg);
+  border:1px solid var(--term-border);border-radius:12px;overflow:hidden;
+  box-shadow:0 24px 60px -30px rgba(27,25,22,.45);}
+.${d} .dtk-chart canvas{width:100%;height:100%;display:block;}
+/* --- alerts list (surface cards) ------------------------------------------ */
+.${d} .dtk-alerts{margin-top:18px;}
+.${d} .dtk-alerts-head{font-size:12px;font-weight:600;color:var(--faint);
+  margin-bottom:9px;font-family:var(--mono);text-transform:uppercase;letter-spacing:0.06em;}
+.${d} .dtk-alerts-empty{font-size:13px;color:var(--muted);padding:8px 0;}
+.${d} .dtk-alerts-list{display:flex;flex-direction:column;gap:5px;
+  max-height:340px;overflow:auto;}
+.${d} .dtk-alert-row{display:flex;align-items:center;gap:10px;width:100%;text-align:left;
+  padding:8px 11px;background:var(--surface);border:1px solid var(--border);
+  border-radius:8px;cursor:pointer;color:var(--ink);font-family:var(--sans);
+  transition:border-color .12s ease,box-shadow .12s ease;}
+.${d} .dtk-alert-row:hover{border-color:var(--clay);
+  box-shadow:0 4px 14px -8px rgba(27,25,22,.35);}
+.${d} .dtk-alert-time{font-size:11px;color:var(--muted);
+  font-family:var(--mono);white-space:nowrap;min-width:142px;}
+.${d} .dtk-badge{display:inline-block;padding:1px 8px;border-radius:10px;font-size:11px;
+  font-weight:700;border:1px solid;text-transform:uppercase;letter-spacing:0.03em;white-space:nowrap;}
+.${d} .dtk-alert-body{display:flex;flex-direction:column;gap:2px;min-width:0;}
+.${d} .dtk-alert-rule{font-size:12px;color:var(--ink);
+  font-family:var(--mono);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}
+.${d} .dtk-alert-sub{font-size:11px;color:var(--muted);}
+`,t=document.createElement("style");t.setAttribute("data-dtk-report",""),t.textContent=e,document.head.appendChild(t)}window.__DTK_REPORT__={render:Te};})();