detectkit 0.24.1__tar.gz → 0.24.2__tar.gz

{detectkit-0.24.1/detectkit.egg-info → detectkit-0.24.2}/PKG-INFO

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

{detectkit-0.24.1 → detectkit-0.24.2}/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.24.1"
+__version__ = "0.24.2"
 
 from detectkit.core.interval import Interval
 from detectkit.core.models import ColumnDefinition, TableModel

{detectkit-0.24.1 → detectkit-0.24.2}/detectkit/autotune/config_emitter.py

@@ -103,9 +103,17 @@ def _build_body(original: MetricConfig, result: AutoTuneResult, new_name: str) -
         elif original.seasonality_columns:
             body["seasonality_columns"] = original.seasonality_columns
 
-    body["detectors"] = [
-        {"type": result.chosen_detector_type, "params": result.chosen_detector_params}
-    ]
+    # Pin the detector's detection start to the load start so the first
+    # `dtk run` on the generated config detects across all loaded history. A
+    # fresh detector that omits `start_time` has no lower bound (no prior
+    # detections, no --from); DETECT falls back to loading_start_time, but
+    # emitting it keeps the generated config explicit and self-sufficient on
+    # older detectkit. `start_time` is execution-level and excluded from the
+    # detector_id hash, so it never changes detector identity.
+    detector_params = dict(result.chosen_detector_params)
+    if "start_time" not in detector_params and body.get("loading_start_time"):
+        detector_params["start_time"] = body["loading_start_time"]
+    body["detectors"] = [{"type": result.chosen_detector_type, "params": detector_params}]
     alerting = _build_alerting(original, result)
     if alerting is not None:
         body["alerting"] = alerting

{detectkit-0.24.1 → detectkit-0.24.2}/detectkit/cli/assets/claude/rules/autotune.md

@@ -32,7 +32,8 @@ same windowed detectors and `detector_id` identity). The fastest path is the
 4. **History window** — on near-ties uses a trend-gated tie-break: a stationary
    series prefers the **larger** `window_size` ("more history is better"), a
    trending / regime-shifting one the **smaller**; sets `loading_start_time` to
-   cover the lead-in.
+   cover the lead-in (and pins the detector's `start_time` to it, so the first
+   `dtk run` detects across all loaded history).
 5. **Alert window** (supervised only) — sweeps `consecutive_anomalies` on the
    labeled incidents.
 

{detectkit-0.24.1 → detectkit-0.24.2}/detectkit/cli/assets/claude/rules/detectors.md

@@ -67,7 +67,7 @@ expected interval for the current point.
     half_life: null          # exponential half-life: int points or "3d"/"12h"
     detrend: null            # null | linear
     # --- execution (NOT hashed) ---
-    start_time: "2024-01-01 00:00:00"   # when detection begins
+    start_time: "2024-01-01 00:00:00"   # optional; when detection begins (default: loading_start_time)
     batch_size: 500
 ```
 

{detectkit-0.24.1 → detectkit-0.24.2}/detectkit/database/internal_tables/_datapoints.py

@@ -40,6 +40,21 @@ class _DatapointsMixin(_InternalTablesBase):
         last_ts = self._manager.get_last_timestamp(full_table_name, metric_name)
         return self._normalize_max_timestamp(last_ts)
 
+    def get_first_datapoint_timestamp(self, metric_name: str) -> datetime | None:
+        """Return the earliest timestamp stored for *metric_name*, if any."""
+        full_table_name = self._manager.get_full_table_name(TABLE_DATAPOINTS, use_internal=True)
+        query = f"""
+        SELECT min(timestamp) AS first_ts
+        FROM {full_table_name}
+        WHERE metric_name = %(metric_name)s
+        """
+        result = self._manager.execute_query(query, {"metric_name": metric_name})
+        if not result:
+            return None
+        # ClickHouse min() over an empty selection yields the epoch sentinel
+        # rather than NULL; _normalize_max_timestamp maps that back to None.
+        return self._normalize_max_timestamp(result[0].get("first_ts"))
+
     def get_value_at(self, metric_name: str, timestamp: datetime) -> float | None:
         """Return the stored ``value`` for an exact timestamp.
 

{detectkit-0.24.1 → detectkit-0.24.2}/detectkit/orchestration/task_manager/_detect_step.py

@@ -78,6 +78,16 @@ class _DetectStepMixin(_TaskManagerBase):
                 actual_from = max(actual_from, start_time) if actual_from else start_time
 
             actual_from = to_naive_utc(actual_from)
+
+            # No lower bound from --from, the resume point, or the detector's
+            # `start_time`: a first-ever detect for a detector that omits
+            # `start_time` (every `dtk autotune` config does). Fall back to the
+            # metric's load start so the run detects across all loaded history,
+            # instead of mistaking "no lower bound" for "nothing to do" and
+            # silently reporting "already up to date" without ever detecting.
+            if actual_from is None:
+                actual_from = self._detect_fallback_start(config)
+
             if not actual_from or actual_from >= actual_to:
                 click.echo("  │   Nothing to detect (already up to date)")
                 continue
@@ -200,3 +210,17 @@ class _DetectStepMixin(_TaskManagerBase):
             )
         )
         return {"anomalies_count": anomalies_count}
+
+    def _detect_fallback_start(self, config: MetricConfig) -> datetime | None:
+        """Lower bound for a first-ever detect when nothing else pins it.
+
+        Mirrors the LOAD step: prefer the configured ``loading_start_time``,
+        else the metric's earliest stored datapoint. Returns ``None`` only when
+        the metric has no configured start and no data at all (genuinely nothing
+        to detect).
+        """
+        if config.loading_start_time:
+            return to_naive_utc(
+                datetime.fromisoformat(config.loading_start_time.replace("Z", "+00:00"))
+            )
+        return to_naive_utc(self.internal.get_first_datapoint_timestamp(config.name))

{detectkit-0.24.1 → detectkit-0.24.2/detectkit.egg-info}/PKG-INFO

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