@misterhuydo/sentinel 1.0.87 → 1.0.89

package/.cairn/.hint-lock

@@ -1 +1 @@
-2026-03-23T05:33:10.957Z
+2026-03-23T06:03:48.001Z

package/.cairn/session.json

@@ -1,6 +1,6 @@
 {
-  "message": "Auto-checkpoint at 2026-03-23T05:55:20.486Z",
-  "checkpoint_at": "2026-03-23T05:55:20.487Z",
+  "message": "Auto-checkpoint at 2026-03-23T06:04:44.021Z",
+  "checkpoint_at": "2026-03-23T06:04:44.022Z",
   "active_files": [],
   "notes": [],
   "mtime_snapshot": {}

package/package.json

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

package/python/sentinel/sentinel_boss.py

@@ -1435,9 +1435,15 @@ async def _handle_with_cli(
             )
         history_text += f"\n{role}: {content}"
 
+    slack_mention = f"<@{user_id}>" if user_id else (user_name or "")
+    known_users   = store.get_all_users()
+    users_hint    = ", ".join(f"<@{uid}> = {name}" for uid, name in known_users.items())
     prompt = (
         _SYSTEM
-        + (f"\nYou are speaking with: {user_name}" if user_name else "")
+        + (f"\nYou are speaking with: {user_name} (Slack mention: {slack_mention})" if user_name else "")
+        + "\nAlways start your reply by addressing the user directly using their Slack mention, e.g. \"<@U123> here is what I found...\"."
+        + " Never use their plain name — always use the <@USER_ID> format so Slack highlights it."
+        + (f"\nKnown Slack users: {users_hint}" if users_hint else "")
         + f"\n\nCurrent time: {ts}"
         + f"\nSentinel status: {'⏸ PAUSED' if paused else '▶ RUNNING'}"
         + f"\nManaged repos: {', '.join(repos) if repos else '(none configured)'}"
@@ -1532,9 +1538,15 @@ async def _handle_with_api(
     ts             = datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M UTC")
     known_projects = [_read_project_name(d) for d in _find_project_dirs()]
     log_sources    = list(cfg_loader.log_sources.keys())
+    slack_mention = f"<@{user_id}>" if user_id else (user_name or "")
+    known_users   = store.get_all_users()   # {user_id: display_name}
+    users_hint    = ", ".join(f"<@{uid}> = {name}" for uid, name in known_users.items())
     system = (
         _SYSTEM
-        + (f"\nYou are speaking with: {user_name}" if user_name else "")
+        + (f"\nYou are speaking with: {user_name} (Slack mention: {slack_mention})" if user_name else "")
+        + "\nAlways start your reply by addressing the user directly using their Slack mention, e.g. \"<@U123> here is what I found...\"."
+        + " Never use their plain name — always use the <@USER_ID> format so Slack highlights it."
+        + (f"\nKnown Slack users: {users_hint}" if users_hint else "")
         + f"\n\nCurrent time: {ts}"
         + f"\nSentinel status: {'⏸ PAUSED' if paused else '▶ RUNNING'}"
         + f"\nManaged repos: {', '.join(repos) if repos else '(none configured)'}"

package/python/sentinel/slack_bot.py

@@ -342,6 +342,7 @@ async def _dispatch(event: dict, client, cfg_loader, store) -> None:
         return
 
     user_name = await _resolve_name(client, user_id)
+    store.upsert_user(user_id, user_name)
     session   = await _get_or_create_session(user_id, user_name, channel)
 
     if session.busy:

package/python/sentinel/state_store.py

@@ -391,6 +391,43 @@ class StateStore:
                 ).fetchall()
             return [dict(r) for r in rows]
 
+    def upsert_user(self, user_id: str, display_name: str) -> None:
+        """Store or update the display name for a Slack user ID."""
+        with self._conn() as conn:
+            conn.execute(
+                "CREATE TABLE IF NOT EXISTS slack_users "
+                "(user_id TEXT PRIMARY KEY, display_name TEXT, updated_at TEXT)"
+            )
+            conn.execute(
+                "INSERT OR REPLACE INTO slack_users (user_id, display_name, updated_at) "
+                "VALUES (?, ?, ?)",
+                (user_id, display_name, _now()),
+            )
+
+    def get_user_name(self, user_id: str) -> str:
+        """Return the stored display name for a user ID, or the ID itself if unknown."""
+        with self._conn() as conn:
+            conn.execute(
+                "CREATE TABLE IF NOT EXISTS slack_users "
+                "(user_id TEXT PRIMARY KEY, display_name TEXT, updated_at TEXT)"
+            )
+            row = conn.execute(
+                "SELECT display_name FROM slack_users WHERE user_id = ?", (user_id,)
+            ).fetchone()
+        return row[0] if row else user_id
+
+    def get_all_users(self) -> dict[str, str]:
+        """Return all known {user_id: display_name} mappings."""
+        with self._conn() as conn:
+            conn.execute(
+                "CREATE TABLE IF NOT EXISTS slack_users "
+                "(user_id TEXT PRIMARY KEY, display_name TEXT, updated_at TEXT)"
+            )
+            rows = conn.execute(
+                "SELECT user_id, display_name FROM slack_users ORDER BY display_name"
+            ).fetchall()
+        return {r[0]: r[1] for r in rows}
+
     def save_conversation(self, user_id: str, history: list):
         """Persist the last N messages of a user conversation to SQLite."""
         trimmed = history[-self._MAX_HISTORY_MESSAGES:]