@misterhuydo/sentinel 1.4.97 → 1.4.99

package/.cairn/session.json

@@ -1,6 +1,6 @@
 {
-  "message": "Auto-checkpoint at 2026-03-30T05:44:22.167Z",
-  "checkpoint_at": "2026-03-30T05:44:22.168Z",
+  "message": "Auto-checkpoint at 2026-03-30T05:55:15.774Z",
+  "checkpoint_at": "2026-03-30T05:55:15.775Z",
   "active_files": [],
   "notes": [],
   "mtime_snapshot": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@misterhuydo/sentinel",
-  "version": "1.4.97",
+  "version": "1.4.99",
   "description": "Sentinel — Autonomous DevOps Agent installer and manager",
   "bin": {
     "sentinel": "./bin/sentinel.js"

package/python/sentinel/cairn_client.py

@@ -38,5 +38,29 @@ def ensure_installed() -> bool:
 
 
 def index_repo(repo: RepoConfig) -> bool:
-    """No-op: Cairn indexes automatically via hooks when Claude Code runs."""
-    return True
+    """Run `cairn install` in the repo if not already initialised.
+
+    Cairn indexes automatically via hooks once installed — this just ensures
+    the .cairn project file and MCP registration exist before the first fix attempt.
+    """
+    import os
+    cairn_marker = os.path.join(repo.local_path, ".cairn", ".cairn-project")
+    if os.path.exists(cairn_marker):
+        logger.debug("cairn already installed in %s", repo.local_path)
+        return True
+    try:
+        r = subprocess.run(
+            [CAIRN_BIN, "install"],
+            cwd=repo.local_path,
+            capture_output=True,
+            text=True,
+            timeout=30,
+        )
+        if r.returncode == 0:
+            logger.info("cairn installed in %s", repo.local_path)
+            return True
+        logger.warning("cairn install failed in %s: %s", repo.local_path, r.stderr.strip())
+        return False
+    except Exception as e:
+        logger.warning("cairn install error in %s: %s", repo.local_path, e)
+        return False

package/python/sentinel/config_loader.py

@@ -57,8 +57,8 @@ class SentinelConfig:
     auto_upgrade: bool = True        # auto-upgrade on new patch versions
     version_pin: str = ""            # if set, never upgrade beyond this version
     upgrade_check_hours: int = 6     # hours between npm upgrade checks
-    smtp_from: str = ""          # sender address (required for SES; defaults to smtp_user)
-    slack_bot_token: str = ""
+    smtp_from: str = ""          # sender address (required for SES; defaults to smtp_user)
+    slack_bot_token: str = ""
     slack_app_token: str = ""        # xapp-... (Socket Mode)
     slack_channel: str = ""          # optional: restrict to one channel ID or name
     slack_dm_submitter: bool = True  # DM the submitter when a fix is applied or blocked
@@ -66,6 +66,7 @@ class SentinelConfig:
     slack_allowed_users: list[str] = field(default_factory=list)  # if set, only these Slack user IDs can talk to Boss
     slack_admin_users: list[str] = field(default_factory=list)   # subset of allowed users with admin privileges
     project_name: str = ""           # optional: friendly name used by Sentinel Boss (e.g. "1881")
+    instance_name: str = "Sentinel"  # label used in email subjects, e.g. "Sentinel-Personal"
     # Auth strategy:
     #   ANTHROPIC_API_KEY  — used by Sentinel Boss conversation (structured tools, cheap per-token)
     #   Claude Pro / OAuth — used by fix_engine + ask_codebase when CLAUDE_PRO_FOR_TASKS=true
@@ -191,7 +192,7 @@ class ConfigLoader:
         c.auto_upgrade = d.get("AUTO_UPGRADE", "true").lower() != "false"
         c.version_pin = d.get("VERSION_PIN", "")
         c.upgrade_check_hours = int(d.get("UPGRADE_CHECK_HOURS", 6))
-        c.smtp_from = d.get("SMTP_FROM", "")
+        c.smtp_from = d.get("SMTP_FROM", "")
         c.slack_bot_token = d.get("SLACK_BOT_TOKEN", "")
         c.slack_app_token = d.get("SLACK_APP_TOKEN", "")
         c.slack_channel = d.get("SLACK_CHANNEL", "")
@@ -200,6 +201,7 @@ class ConfigLoader:
         c.slack_allowed_users = _csv(d.get("SLACK_ALLOWED_USERS", ""))
         c.slack_admin_users = _csv(d.get("SLACK_ADMIN_USERS", ""))
         c.project_name = d.get("PROJECT_NAME", "") or Path(self.config_dir).resolve().parent.name
+        c.instance_name = d.get("INSTANCE_NAME", "Sentinel") or "Sentinel"
         # If CLAUDE_PRO_FOR_TASKS is explicitly set anywhere, respect it.
         # Otherwise: if the project supplies its own ANTHROPIC_API_KEY, default to False
         # (bill against their key, not the Claude Pro subscription).

package/python/sentinel/reporter.py

@@ -43,7 +43,7 @@ def send_fix_notification(cfg: SentinelConfig, fix: dict):
     auto_publish = fix.get("auto_publish", False)
     source       = fix.get("source", "unknown")
     verb         = "fix" if auto_publish else "PR"
-    subject      = f"[Sentinel] {verb}({source}): {fix.get('message', '')[:80]}"
+    subject      = f"[{cfg.instance_name}] {verb}({source}): {fix.get('message', '')[:80]}"
 
     html = _FIX_TEMPLATE.render(
         generated_at=datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M UTC"),
@@ -91,7 +91,7 @@ def build_and_send(cfg: SentinelConfig, store: StateStore):
         hours=hours, stats=stats, open_prs=open_prs,
     )
     subject = (
-        f"[Sentinel] Health Digest -- "
+        f"[{cfg.instance_name}] Health Digest -- "
         f"{stats['applied']} fixed, {stats['failed']} failed, "
         f"{stats['errors']} detected"
     )
@@ -153,7 +153,7 @@ def send_failure_notification(cfg: SentinelConfig, details: dict):
     body      = details.get('body', '')[:1000]
     ts        = datetime.now(timezone.utc).strftime('%Y-%m-%d %H:%M UTC')
 
-    subject = f'[Sentinel] UNRESOLVED ({source}): {message[:80]}'
+    subject = f'[{cfg.instance_name}] UNRESOLVED ({source}): {message[:80]}'
 
     ctx_html = f'<h3>Context</h3><pre>{body}</pre>' if body else ''
     html = (
@@ -198,7 +198,7 @@ def send_confirmed_notification(cfg: SentinelConfig, fix: dict):
     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]})'
+    subject = f'[{cfg.instance_name}] ✅ Fix confirmed in production: {repo_name} ({fingerprint[:8]})'
     html = (
         '<!DOCTYPE html><html><head><meta charset="utf-8">'
         '<style>'
@@ -236,7 +236,7 @@ def send_regression_notification(cfg: SentinelConfig, fix: dict, event: dict):
     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}'
+    subject = f'[{cfg.instance_name}] ⚠ Regression: fix did not resolve issue in {repo_name}'
     html = (
         '<!DOCTYPE html><html><head><meta charset="utf-8">'
         '<style>'
@@ -342,7 +342,7 @@ def send_startup_notification(cfg: SentinelConfig, results: dict):
     html += warn_html
     html += '<hr><small>Sentinel — Autonomous DevOps Agent</small></body></html>'
 
-    subject = f'[Sentinel] {status_label} — {ts}'
+    subject = f'[{cfg.instance_name}] {status_label} — {ts}'
     _send_email(cfg, subject, html)
     logger.info('Startup notification sent to %d recipient(s)', len(cfg.mails))
 
@@ -351,7 +351,7 @@ def send_upgrade_notification(cfg: SentinelConfig, old_version: str, new_version
     if not cfg.mails:
         return
     ts = datetime.now(timezone.utc).strftime('%Y-%m-%d %H:%M UTC')
-    subject = f'[Sentinel] Upgraded {old_version} → {new_version}'
+    subject = f'[{cfg.instance_name}] Upgraded {old_version} → {new_version}'
     html = (
         '<!DOCTYPE html><html><head><meta charset="utf-8">'
         '<style>'

package/templates/workspace-sentinel.properties

@@ -1,6 +1,10 @@
 # Sentinel workspace config — shared across all projects in this workspace.
 # Per-project sentinel.properties can override any of these.
 
+# Label used in email subjects — e.g. "Sentinel-Personal", "Sentinel-Oracle", "Sentinel-1881"
+# Defaults to "Sentinel" if not set.
+# INSTANCE_NAME=Sentinel
+
 # Schedule
 POLL_INTERVAL_SECONDS=120