npm - @misterhuydo/sentinel - Versions diffs - 1.0.6 → 1.0.10 - Mend

@misterhuydo/sentinel 1.0.6 → 1.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/bin/sentinel.js +42 -39
package/lib/add.js +415 -57
package/lib/generate.js +14 -23
package/lib/init.js +21 -7
package/package.json +1 -1
package/python/sentinel/__pycache__/issue_watcher.cpython-313.pyc +0 -0
package/python/sentinel/config_loader.py +15 -3
package/python/sentinel/fix_engine.py +49 -14
package/python/sentinel/issue_watcher.py +146 -131
package/python/sentinel/log_parser.py +175 -149
package/python/sentinel/main.py +110 -32
package/python/sentinel/reporter.py +159 -0
package/python/sentinel/state_store.py +275 -164
package/templates/sentinel.properties +20 -32
package/templates/workspace-sentinel.properties +20 -0

package/python/sentinel/reporter.py CHANGED Viewed

@@ -186,3 +186,162 @@ def send_failure_notification(cfg: SentinelConfig, details: dict):
     _send_email(cfg, subject, html)
     logger.info('Failure notification sent for %s', source)
+# ---- Confirmed fix notification ----------------------------------------------
+def send_confirmed_notification(cfg: SentinelConfig, fix: dict):
+    """Notify admins that a fix has been confirmed running in production."""
+    if not cfg.mails:
+        return
+    repo_name = fix.get('repo_name', 'unknown')
+    fingerprint = fix.get('fingerprint', '')
+    marker = fix.get('sentinel_marker', '')
+    ts = datetime.now(timezone.utc).strftime('%Y-%m-%d %H:%M UTC')
+    subject = f'[Sentinel] ✅ Fix confirmed in production: {repo_name} ({fingerprint[:8]})'
+    html = (
+        '<!DOCTYPE html><html><head><meta charset="utf-8">'
+        '<style>'
+        'body{font-family:Arial,sans-serif;font-size:14px;color:#222}'
+        'h2{color:#2e7d32}'
+        'table{border-collapse:collapse;width:100%;margin-bottom:16px}'
+        'th{background:#f1f3f4;text-align:left;padding:6px 10px}'
+        'td{padding:5px 10px;border-bottom:1px solid #eee;vertical-align:top}'
+        '.label{font-weight:bold;width:160px}'
+        '.mono{font-family:monospace;font-size:12px}'
+        '</style></head><body>'
+        '<h2>✅ Fix confirmed running in production</h2>'
+        f'<p><strong>{repo_name}</strong> &middot; {ts}</p>'
+        '<table>'
+        f'<tr><td class="label">Fingerprint</td><td class="mono">{fingerprint}</td></tr>'
+        f'<tr><td class="label">Sentinel marker</td><td class="mono">{marker}</td></tr>'
+        f'<tr><td class="label">Commit</td><td class="mono">{fix.get("commit_hash", "")}</td></tr>'
+        f'<tr><td class="label">Branch</td><td class="mono">{fix.get("branch", "")}</td></tr>'
+        f'<tr><td class="label">Confirmed at</td><td>{fix.get("confirmed_at", ts)}</td></tr>'
+        '</table>'
+        '<p>The marker log line was detected in production logs, confirming the fix is live and the fixed code path executed.</p>'
+        '<hr><small>Sentinel &mdash; Autonomous DevOps Agent</small>'
+        '</body></html>'
+    )
+    _send_email(cfg, subject, html)
+    logger.info('Confirmed notification sent for %s', fingerprint)
+# ---- Regression notification ------------------------------------------------
+def send_regression_notification(cfg: SentinelConfig, fix: dict, event: dict):
+    """Notify admins that a confirmed fix did not resolve the issue."""
+    if not cfg.mails:
+        return
+    repo_name = fix.get('repo_name', 'unknown')
+    fingerprint = fix.get('fingerprint', '')
+    ts = datetime.now(timezone.utc).strftime('%Y-%m-%d %H:%M UTC')
+    subject = f'[Sentinel] ⚠ Regression: fix did not resolve issue in {repo_name}'
+    html = (
+        '<!DOCTYPE html><html><head><meta charset="utf-8">'
+        '<style>'
+        'body{font-family:Arial,sans-serif;font-size:14px;color:#222}'
+        'h2{color:#c62828}'
+        'h3{color:#444;border-bottom:1px solid #ddd;padding-bottom:4px}'
+        'table{border-collapse:collapse;width:100%;margin-bottom:16px}'
+        'th{background:#f1f3f4;text-align:left;padding:6px 10px}'
+        'td{padding:5px 10px;border-bottom:1px solid #eee;vertical-align:top}'
+        '.label{font-weight:bold;width:160px}'
+        '.mono{font-family:monospace;font-size:12px}'
+        'pre{background:#f8f8f8;border:1px solid #ddd;padding:10px;font-size:12px;white-space:pre-wrap}'
+        '</style></head><body>'
+        '<h2>⚠ Regression detected &mdash; fix did not resolve the issue</h2>'
+        f'<p><strong>{repo_name}</strong> &middot; {ts}</p>'
+        '<p>The original error recurred in production logs after the Sentinel fix was confirmed deployed.</p>'
+        '<h3>Fix Details</h3>'
+        '<table>'
+        f'<tr><td class="label">Fingerprint</td><td class="mono">{fingerprint}</td></tr>'
+        f'<tr><td class="label">Commit</td><td class="mono">{fix.get("commit_hash", "")}</td></tr>'
+        f'<tr><td class="label">Branch</td><td class="mono">{fix.get("branch", "")}</td></tr>'
+        f'<tr><td class="label">Confirmed at</td><td>{fix.get("confirmed_at", "")}</td></tr>'
+        '</table>'
+        '<h3>Recurring Error</h3>'
+        '<table>'
+        f'<tr><td class="label">Source</td><td class="mono">{event.get("source", "")}</td></tr>'
+        f'<tr><td class="label">Message</td><td class="mono">{event.get("message", "")}</td></tr>'
+        '</table>'
+        f'<pre>{event.get("body", "")}</pre>'
+        '<p>Sentinel will not attempt another automatic fix. Please investigate manually.</p>'
+        '<hr><small>Sentinel &mdash; Autonomous DevOps Agent</small>'
+        '</body></html>'
+    )
+    _send_email(cfg, subject, html)
+    logger.info('Regression notification sent for %s', fingerprint)
+# ---- Startup notification ---------------------------------------------------
+def send_startup_notification(cfg: SentinelConfig, results: dict):
+    """Send startup summary email 5 minutes after Sentinel starts."""
+    if not cfg.mails:
+        return
+    ts = datetime.now(timezone.utc).strftime('%Y-%m-%d %H:%M UTC')
+    repos  = results.get('repos', [])
+    cairn  = results.get('cairn', [])
+    ssh    = results.get('ssh', [])
+    warns  = results.get('warnings', [])
+    has_errors = any(r['status'] == 'error' for r in repos + cairn + ssh)
+    status_label = '⚠ Started with warnings' if has_errors else '✅ Started successfully'
+    def row(label, value, ok=True):
+        color = '' if ok else ' style="color:#c62828"'
+        return f'<tr><td class="label"{color}>{label}</td><td class="mono"{color}>{value}</td></tr>'
+    repo_rows = ''.join(
+        row(r['name'],
+            f"{r['status'].upper()}: {r['message']}",
+            r['status'] != 'error')
+        for r in repos
+    )
+    cairn_rows = ''.join(
+        row(r['name'], r['message'], r['status'] == 'ok')
+        for r in cairn
+    )
+    ssh_rows = ''.join(
+        row(f"{r['name']} ({r['host']})",
+            r['message'] or 'OK',
+            r['status'] == 'ok')
+        for r in ssh
+    )
+    warn_html = (
+        '<h3>⚠ Warnings</h3><ul>' +
+        ''.join(f'<li>{w}</li>' for w in warns) +
+        '</ul>'
+    ) if warns else ''
+    html = (
+        '<!DOCTYPE html><html><head><meta charset="utf-8">'
+        '<style>'
+        'body{font-family:Arial,sans-serif;font-size:14px;color:#222}'
+        'h2{color:#1a73e8}'
+        'h3{color:#444;border-bottom:1px solid #ddd;padding-bottom:4px}'
+        'table{border-collapse:collapse;width:100%;margin-bottom:16px}'
+        'th{background:#f1f3f4;text-align:left;padding:6px 10px}'
+        'td{padding:5px 10px;border-bottom:1px solid #eee;vertical-align:top}'
+        '.label{font-weight:bold;width:200px}'
+        '.mono{font-family:monospace;font-size:12px}'
+        '</style></head><body>'
+        f'<h2>Sentinel {status_label}</h2>'
+        f'<p>{ts}</p>'
+    )
+    if repo_rows:
+        html += f'<h3>Repositories</h3><table>{repo_rows}</table>'
+    if cairn_rows:
+        html += f'<h3>Cairn Index</h3><table>{cairn_rows}</table>'
+    if ssh_rows:
+        html += f'<h3>SSH Connectivity</h3><table>{ssh_rows}</table>'
+    html += warn_html
+    html += '<hr><small>Sentinel — Autonomous DevOps Agent</small></body></html>'
+    subject = f'[Sentinel] {status_label} — {ts}'
+    _send_email(cfg, subject, html)
+    logger.info('Startup notification sent to %d recipient(s)', len(cfg.mails))

package/python/sentinel/state_store.py CHANGED Viewed

@@ -1,164 +1,275 @@
-"""
-state_store.py — SQLite-backed persistence for errors, fixes, and reports.
-"""
-import json
-import sqlite3
-import logging
-from contextlib import contextmanager
-from datetime import datetime, timezone
-logger = logging.getLogger(__name__)
-def _now() -> str:
-    return datetime.now(timezone.utc).isoformat()
-class StateStore:
-    def __init__(self, db_path: str = "./sentinel.db"):
-        self.db_path = db_path
-        self._init_db()
-    @contextmanager
-    def _conn(self):
-        conn = sqlite3.connect(self.db_path)
-        conn.row_factory = sqlite3.Row
-        try:
-            yield conn
-            conn.commit()
-        finally:
-            conn.close()
-    def _init_db(self):
-        with self._conn() as conn:
-            conn.executescript("""
-                CREATE TABLE IF NOT EXISTS errors (
-                    fingerprint   TEXT PRIMARY KEY,
-                    first_seen    TEXT NOT NULL,
-                    last_seen     TEXT NOT NULL,
-                    count         INTEGER NOT NULL DEFAULT 1,
-                    source        TEXT,
-                    message       TEXT
-                );
-                CREATE TABLE IF NOT EXISTS fixes (
-                    id            INTEGER PRIMARY KEY AUTOINCREMENT,
-                    fingerprint   TEXT NOT NULL,
-                    status        TEXT NOT NULL,   -- pending|applied|failed|skipped
-                    patch_path    TEXT,
-                    commit_hash   TEXT,
-                    branch        TEXT,
-                    pr_url        TEXT,
-                    repo_name     TEXT,
-                    timestamp     TEXT NOT NULL
-                );
-                CREATE TABLE IF NOT EXISTS reports (
-                    id              INTEGER PRIMARY KEY AUTOINCREMENT,
-                    sent_at         TEXT NOT NULL,
-                    recipient_count INTEGER NOT NULL DEFAULT 0,
-                    summary_json    TEXT
-                );
-            """)
-        logger.debug("StateStore initialised at %s", self.db_path)
-    # ── Errors ────────────────────────────────────────────────────────────────
-    def seen(self, fingerprint: str) -> bool:
-        with self._conn() as conn:
-            row = conn.execute(
-                "SELECT fingerprint FROM errors WHERE fingerprint = ?", (fingerprint,)
-            ).fetchone()
-            return row is not None
-    def record_error(self, fingerprint: str, source: str, message: str):
-        now = _now()
-        with self._conn() as conn:
-            existing = conn.execute(
-                "SELECT count FROM errors WHERE fingerprint = ?", (fingerprint,)
-            ).fetchone()
-            if existing:
-                conn.execute(
-                    "UPDATE errors SET last_seen=?, count=count+1 WHERE fingerprint=?",
-                    (now, fingerprint),
-                )
-            else:
-                conn.execute(
-                    "INSERT INTO errors (fingerprint, first_seen, last_seen, count, source, message) "
-                    "VALUES (?, ?, ?, 1, ?, ?)",
-                    (fingerprint, now, now, source, message),
-                )
-    def get_recent_errors(self, hours: int = 6) -> list[dict]:
-        with self._conn() as conn:
-            rows = conn.execute(
-                "SELECT * FROM errors WHERE last_seen >= datetime('now', ? || ' hours') "
-                "ORDER BY last_seen DESC",
-                (f"-{hours}",),
-            ).fetchall()
-            return [dict(r) for r in rows]
-    # ── Fixes ─────────────────────────────────────────────────────────────────
-    def record_fix(
-        self,
-        fingerprint: str,
-        status: str,
-        patch_path: str = "",
-        commit_hash: str = "",
-        branch: str = "",
-        pr_url: str = "",
-        repo_name: str = "",
-    ):
-        with self._conn() as conn:
-            conn.execute(
-                "INSERT INTO fixes (fingerprint, status, patch_path, commit_hash, branch, pr_url, repo_name, timestamp) "
-                "VALUES (?, ?, ?, ?, ?, ?, ?, ?)",
-                (fingerprint, status, patch_path, commit_hash, branch, pr_url, repo_name, _now()),
-            )
-    def get_open_prs(self) -> list[dict]:
-        """Returns fixes pushed as PRs that have not yet been merged (no commit_hash on main)."""
-        with self._conn() as conn:
-            rows = conn.execute(
-                "SELECT * FROM fixes WHERE status='pending' AND pr_url != '' "
-                "ORDER BY timestamp DESC"
-            ).fetchall()
-            return [dict(r) for r in rows]
-    def get_recent_fixes(self, hours: int = 6) -> list[dict]:
-        with self._conn() as conn:
-            rows = conn.execute(
-                "SELECT * FROM fixes WHERE timestamp >= datetime('now', ? || ' hours') "
-                "ORDER BY timestamp DESC",
-                (f"-{hours}",),
-            ).fetchall()
-            return [dict(r) for r in rows]
-    def fix_attempted_recently(self, fingerprint: str, hours: int = 24) -> bool:
-        with self._conn() as conn:
-            row = conn.execute(
-                "SELECT id FROM fixes WHERE fingerprint=? "
-                "AND timestamp >= datetime('now', ? || ' hours')",
-                (fingerprint, f"-{hours}"),
-            ).fetchone()
-            return row is not None
-    # ── Reports ───────────────────────────────────────────────────────────────
-    def record_report(self, recipient_count: int, summary: dict):
-        with self._conn() as conn:
-            conn.execute(
-                "INSERT INTO reports (sent_at, recipient_count, summary_json) VALUES (?, ?, ?)",
-                (_now(), recipient_count, json.dumps(summary)),
-            )
-    def last_report_time(self) -> datetime | None:
-        with self._conn() as conn:
-            row = conn.execute(
-                "SELECT sent_at FROM reports ORDER BY sent_at DESC LIMIT 1"
-            ).fetchone()
-            if row:
-                return datetime.fromisoformat(row["sent_at"])
-            return None
+"""
+state_store.py — SQLite-backed persistence for errors, fixes, and reports.
+"""
+import json
+import sqlite3
+import logging
+from contextlib import contextmanager
+from datetime import datetime, timezone
+logger = logging.getLogger(__name__)
+def _now() -> str:
+    return datetime.now(timezone.utc).isoformat()
+class StateStore:
+    def __init__(self, db_path: str = "./sentinel.db"):
+        self.db_path = db_path
+        self._init_db()
+    @contextmanager
+    def _conn(self):
+        conn = sqlite3.connect(self.db_path)
+        conn.row_factory = sqlite3.Row
+        try:
+            yield conn
+            conn.commit()
+        finally:
+            conn.close()
+    def _init_db(self):
+        with self._conn() as conn:
+            conn.executescript("""
+                CREATE TABLE IF NOT EXISTS errors (
+                    fingerprint   TEXT PRIMARY KEY,
+                    first_seen    TEXT NOT NULL,
+                    last_seen     TEXT NOT NULL,
+                    count         INTEGER NOT NULL DEFAULT 1,
+                    source        TEXT,
+                    message       TEXT
+                );
+                CREATE TABLE IF NOT EXISTS fixes (
+                    id              INTEGER PRIMARY KEY AUTOINCREMENT,
+                    fingerprint     TEXT NOT NULL,
+                    status          TEXT NOT NULL,   -- pending|applied|failed|skipped
+                    patch_path      TEXT,
+                    commit_hash     TEXT,
+                    branch          TEXT,
+                    pr_url          TEXT,
+                    repo_name       TEXT,
+                    timestamp       TEXT NOT NULL,
+                    sentinel_marker TEXT,            -- SENTINEL:#<fingerprint> injected into fix
+                    marker_seen_at  TEXT,            -- when marker was first seen in production logs
+                    confirmed_at    TEXT,            -- set after quiet period with no recurrence
+                    fix_outcome     TEXT             -- confirmed | regressed
+                );
+                -- Migration: add columns if upgrading from older schema
+                CREATE TABLE IF NOT EXISTS _sentinel_migrations (name TEXT PRIMARY KEY);
+                CREATE TABLE IF NOT EXISTS reports (
+                    id              INTEGER PRIMARY KEY AUTOINCREMENT,
+                    sent_at         TEXT NOT NULL,
+                    recipient_count INTEGER NOT NULL DEFAULT 0,
+                    summary_json    TEXT
+                );
+            """)
+        self._migrate()
+        logger.debug("StateStore initialised at %s", self.db_path)
+    def _migrate(self):
+        """Add new columns to existing DBs without breaking old installs."""
+        migrations = [
+            ("add_sentinel_marker",  "ALTER TABLE fixes ADD COLUMN sentinel_marker TEXT"),
+            ("add_confirmed_at",     "ALTER TABLE fixes ADD COLUMN confirmed_at TEXT"),
+            ("add_fix_outcome",      "ALTER TABLE fixes ADD COLUMN fix_outcome TEXT"),
+            ("add_marker_seen_at",   "ALTER TABLE fixes ADD COLUMN marker_seen_at TEXT"),
+        ]
+        with self._conn() as conn:
+            done = {r[0] for r in conn.execute("SELECT name FROM _sentinel_migrations").fetchall()}
+            for name, sql in migrations:
+                if name not in done:
+                    try:
+                        conn.execute(sql)
+                        conn.execute("INSERT INTO _sentinel_migrations VALUES (?)", (name,))
+                        logger.debug("Migration applied: %s", name)
+                    except Exception:
+                        pass  # column may already exist
+    # ── Errors ────────────────────────────────────────────────────────────────
+    def seen(self, fingerprint: str) -> bool:
+        with self._conn() as conn:
+            row = conn.execute(
+                "SELECT fingerprint FROM errors WHERE fingerprint = ?", (fingerprint,)
+            ).fetchone()
+            return row is not None
+    def record_error(self, fingerprint: str, source: str, message: str):
+        now = _now()
+        with self._conn() as conn:
+            existing = conn.execute(
+                "SELECT count FROM errors WHERE fingerprint = ?", (fingerprint,)
+            ).fetchone()
+            if existing:
+                conn.execute(
+                    "UPDATE errors SET last_seen=?, count=count+1 WHERE fingerprint=?",
+                    (now, fingerprint),
+                )
+            else:
+                conn.execute(
+                    "INSERT INTO errors (fingerprint, first_seen, last_seen, count, source, message) "
+                    "VALUES (?, ?, ?, 1, ?, ?)",
+                    (fingerprint, now, now, source, message),
+                )
+    def get_recent_errors(self, hours: int = 6) -> list[dict]:
+        with self._conn() as conn:
+            rows = conn.execute(
+                "SELECT * FROM errors WHERE last_seen >= datetime('now', ? || ' hours') "
+                "ORDER BY last_seen DESC",
+                (f"-{hours}",),
+            ).fetchall()
+            return [dict(r) for r in rows]
+    # ── Fixes ─────────────────────────────────────────────────────────────────
+    def record_fix(
+        self,
+        fingerprint: str,
+        status: str,
+        patch_path: str = "",
+        commit_hash: str = "",
+        branch: str = "",
+        pr_url: str = "",
+        repo_name: str = "",
+        sentinel_marker: str = "",
+    ):
+        with self._conn() as conn:
+            conn.execute(
+                "INSERT INTO fixes (fingerprint, status, patch_path, commit_hash, branch, "
+                "pr_url, repo_name, timestamp, sentinel_marker) "
+                "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)",
+                (fingerprint, status, patch_path, commit_hash, branch,
+                 pr_url, repo_name, _now(), sentinel_marker or None),
+            )
+    def get_open_prs(self) -> list[dict]:
+        """Returns fixes pushed as PRs that have not yet been merged (no commit_hash on main)."""
+        with self._conn() as conn:
+            rows = conn.execute(
+                "SELECT * FROM fixes WHERE status='pending' AND pr_url != '' "
+                "ORDER BY timestamp DESC"
+            ).fetchall()
+            return [dict(r) for r in rows]
+    def get_recent_fixes(self, hours: int = 6) -> list[dict]:
+        with self._conn() as conn:
+            rows = conn.execute(
+                "SELECT * FROM fixes WHERE timestamp >= datetime('now', ? || ' hours') "
+                "ORDER BY timestamp DESC",
+                (f"-{hours}",),
+            ).fetchall()
+            return [dict(r) for r in rows]
+    def fix_attempted_recently(self, fingerprint: str, hours: int = 24) -> bool:
+        with self._conn() as conn:
+            row = conn.execute(
+                "SELECT id FROM fixes WHERE fingerprint=? "
+                "AND timestamp >= datetime('now', ? || ' hours')",
+                (fingerprint, f"-{hours}"),
+            ).fetchone()
+            return row is not None
+    def mark_marker_seen(self, marker: str) -> dict | None:
+        """Record that a SENTINEL marker appeared in production logs."""
+        with self._conn() as conn:
+            row = conn.execute(
+                "SELECT * FROM fixes WHERE sentinel_marker=? AND marker_seen_at IS NULL",
+                (marker,),
+            ).fetchone()
+            if not row:
+                return None
+            conn.execute(
+                "UPDATE fixes SET marker_seen_at=? WHERE sentinel_marker=?",
+                (_now(), marker),
+            )
+            return dict(row)
+    def get_fixes_pending_confirmation(self, quiet_hours: int = 24) -> list[dict]:
+        """Return fixes whose marker was seen >= quiet_hours ago and are not yet confirmed/regressed."""
+        with self._conn() as conn:
+            rows = conn.execute(
+                "SELECT * FROM fixes WHERE marker_seen_at IS NOT NULL "
+                "AND confirmed_at IS NULL AND fix_outcome IS NULL "
+                "AND marker_seen_at <= datetime('now', ? || ' hours')",
+                (f"-{quiet_hours}",),
+            ).fetchall()
+            return [dict(r) for r in rows]
+    def confirm_fix(self, fingerprint: str) -> dict | None:
+        """Confirm a fix after quiet period — no recurrence observed."""
+        with self._conn() as conn:
+            row = conn.execute(
+                "SELECT * FROM fixes WHERE fingerprint=? AND marker_seen_at IS NOT NULL "
+                "AND confirmed_at IS NULL AND fix_outcome IS NULL",
+                (fingerprint,),
+            ).fetchone()
+            if not row:
+                return None
+            conn.execute(
+                "UPDATE fixes SET confirmed_at=?, fix_outcome='confirmed' WHERE fingerprint=?",
+                (_now(), fingerprint),
+            )
+            return dict(row)
+    def mark_regressed(self, fingerprint: str):
+        """Mark fix as regressed — error recurred after marker was seen."""
+        with self._conn() as conn:
+            conn.execute(
+                "UPDATE fixes SET fix_outcome='regressed' "
+                "WHERE fingerprint=? AND fix_outcome IS NULL AND marker_seen_at IS NOT NULL",
+                (fingerprint,),
+            )
+    def get_confirmed_fix(self, fingerprint: str) -> dict | None:
+        """Return a confirmed (not yet regressed) fix for this fingerprint."""
+        with self._conn() as conn:
+            row = conn.execute(
+                "SELECT * FROM fixes WHERE fingerprint=? AND fix_outcome='confirmed'",
+                (fingerprint,),
+            ).fetchone()
+            return dict(row) if row else None
+    def get_marker_seen_fix(self, fingerprint: str) -> dict | None:
+        """Return a fix for this fingerprint where marker was seen but not yet confirmed."""
+        with self._conn() as conn:
+            row = conn.execute(
+                "SELECT * FROM fixes WHERE fingerprint=? "
+                "AND marker_seen_at IS NOT NULL AND fix_outcome IS NULL",
+                (fingerprint,),
+            ).fetchone()
+            return dict(row) if row else None
+    def get_stale_markers(self, repo_name: str) -> list[str]:
+        """Return markers for confirmed/regressed fixes in a repo — safe to remove from code."""
+        with self._conn() as conn:
+            rows = conn.execute(
+                "SELECT sentinel_marker FROM fixes "
+                "WHERE repo_name=? AND fix_outcome IN ('confirmed', 'regressed') "
+                "AND sentinel_marker IS NOT NULL",
+                (repo_name,),
+            ).fetchall()
+            return [r[0] for r in rows]
+        # ── Reports ───────────────────────────────────────────────────────────────
+    def record_report(self, recipient_count: int, summary: dict):
+        with self._conn() as conn:
+            conn.execute(
+                "INSERT INTO reports (sent_at, recipient_count, summary_json) VALUES (?, ?, ?)",
+                (_now(), recipient_count, json.dumps(summary)),
+            )
+    def last_report_time(self) -> datetime | None:
+        with self._conn() as conn:
+            row = conn.execute(
+                "SELECT sent_at FROM reports ORDER BY sent_at DESC LIMIT 1"
+            ).fetchone()
+            if row:
+                return datetime.fromisoformat(row["sent_at"])
+            return None