@misterhuydo/sentinel 1.0.46 → 1.0.48

package/.cairn/session.json

@@ -1,6 +1,6 @@
 {
-  "message": "Auto-checkpoint at 2026-03-22T05:40:32.023Z",
-  "checkpoint_at": "2026-03-22T05:40:32.024Z",
+  "message": "Auto-checkpoint at 2026-03-22T05:57:18.189Z",
+  "checkpoint_at": "2026-03-22T05:57:18.190Z",
   "active_files": [],
   "notes": [],
   "mtime_snapshot": {}

package/package.json

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

package/python/sentinel/config_loader.py

@@ -60,6 +60,7 @@ class SentinelConfig:
     slack_bot_token: str = ""        # xoxb-...
     slack_app_token: str = ""        # xapp-... (Socket Mode)
     slack_channel: str = ""          # optional: restrict to one channel ID or name
+    project_name: str = ""           # optional: friendly name used by Sentinel Boss (e.g. "1881")
 
 
 @dataclass
@@ -152,6 +153,7 @@ class ConfigLoader:
         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", "")
+        c.project_name = d.get("PROJECT_NAME", "")
         self.sentinel = c
 
     def _load_log_sources(self):

package/python/sentinel/sentinel_boss.py

@@ -290,8 +290,24 @@ def _short_name(dir_name: str) -> str:
         return dir_name[len("sentinel-"):]
     return dir_name
 
+def _read_project_name(project_dir: Path) -> str:
+    """Return PROJECT_NAME from sentinel.properties if set, else fall back to _short_name(dir)."""
+    props = project_dir / "config" / "sentinel.properties"
+    if props.exists():
+        try:
+            for line in props.read_text(encoding="utf-8", errors="ignore").splitlines():
+                line = line.strip()
+                if line.startswith("PROJECT_NAME"):
+                    _, _, val = line.partition("=")
+                    val = val.partition("#")[0].strip()
+                    if val:
+                        return val
+        except Exception:
+            pass
+    return _short_name(project_dir.name)
+
 def _find_project_dirs(target: str = "") -> list[Path]:
-    """Return project dirs matching target (short or full name), or all if target empty."""
+    """Return project dirs matching target (PROJECT_NAME, short name, or full dir name), or all if target empty."""
     workspace = _workspace_dir()
     results = []
     try:
@@ -301,7 +317,10 @@ def _find_project_dirs(target: str = "") -> list[Path]:
             if not (d / "config").exists():
                 continue
             if target:
-                if target.lower() not in d.name.lower() and target.lower() not in _short_name(d.name).lower():
+                t = target.lower()
+                if (t not in d.name.lower()
+                        and t not in _short_name(d.name).lower()
+                        and t not in _read_project_name(d).lower()):
                     continue
             results.append(d)
     except Exception:
@@ -365,14 +384,14 @@ def _run_tool(name: str, inputs: dict, cfg_loader, store) -> str:
         if project_arg:
             project_dirs = _find_project_dirs(project_arg)
             if not project_dirs:
-                all_names = [_short_name(d.name) for d in _find_project_dirs()]
+                all_names = [_read_project_name(d) for d in _find_project_dirs()]
                 return json.dumps({
                     "error": f"No project found matching '{project_arg}'",
                     "available_projects": all_names,
                     "action_needed": "Ask the user which project they meant.",
                 })
             if len(project_dirs) > 1:
-                matches = [_short_name(d.name) for d in project_dirs]
+                matches = [_read_project_name(d) for d in project_dirs]
                 return json.dumps({
                     "error": f"Ambiguous project name '{project_arg}' — matches: {matches}",
                     "action_needed": "Ask the user to clarify which project they mean.",
@@ -390,7 +409,7 @@ def _run_tool(name: str, inputs: dict, cfg_loader, store) -> str:
         # Touch SENTINEL_POLL_NOW so the target instance picks it up immediately
         (project_dir / "SENTINEL_POLL_NOW").touch()
 
-        project_label = _short_name(project_dir.resolve().name) if project_arg else "this project"
+        project_label = _read_project_name(project_dir.resolve()) if project_arg else "this project"
         logger.info("Boss created issue for %s: %s", project_label, fname)
         return json.dumps({
             "status":  "queued",
@@ -451,7 +470,7 @@ def _run_tool(name: str, inputs: dict, cfg_loader, store) -> str:
                             break
                     repos_in_project.append({"repo": p.stem, "url": repo_url})
             projects.append({
-                "project": _short_name(d.name),
+                "project": _read_project_name(d),
                 "dir":     d.name,
                 "running": (d / "sentinel.pid").exists(),
                 "this":    d.resolve() == Path(".").resolve(),
@@ -561,7 +580,7 @@ def _run_tool(name: str, inputs: dict, cfg_loader, store) -> str:
         results = []
         for d in dirs:
             res = _git_pull(d)
-            results.append({"project": _short_name(d.name), "dir": d.name, **res})
+            results.append({"project": _read_project_name(d), "dir": d.name, **res})
             logger.info("Boss: pull_config %s → %s", d.name, res["status"])
         return json.dumps({"results": results})
 
@@ -703,7 +722,7 @@ async def handle_message(
     paused       = Path("SENTINEL_PAUSE").exists()
     repos        = list(cfg_loader.repos.keys())
     ts           = datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M UTC")
-    known_projects = [_short_name(d.name) for d in _find_project_dirs()]
+    known_projects = [_read_project_name(d) for d in _find_project_dirs()]
     system    = (
         _SYSTEM
         + f"\n\nCurrent time: {ts}"

package/templates/sentinel.properties

@@ -2,6 +2,10 @@
 # Shared settings (SMTP, schedule, etc.) live in the workspace-level sentinel.properties
 # one directory above this project. Values here override workspace defaults.
 
+# Friendly project name for Sentinel Boss (optional).
+# Boss will match this name when you say "tell 1881 to do X". If omitted, derived from dir name.
+# PROJECT_NAME=1881
+
 # Who receives fix notifications and health reports for this project
 MAILS=you@yourdomain.com
 
@@ -9,8 +13,10 @@ MAILS=you@yourdomain.com
 SEND_HEALTH=disabled
 REPORT_INTERVAL_HOURS=1
 
-# GitHub token for opening PRs (required when AUTO_PUBLISH=false)
-GITHUB_TOKEN=<github-pat>
+# GitHub token for opening PRs (when AUTO_PUBLISH=false).
+# Usually set once in the workspace sentinel.properties and shared across all projects.
+# Uncomment here only if this project needs a different token.
+# GITHUB_TOKEN=<github-pat>
 
 # State DB and workspace paths (relative to this project dir)
 STATE_DB=./sentinel.db

package/templates/workspace-sentinel.properties

@@ -10,6 +10,10 @@ SMTP_PORT=587
 SMTP_USER=sentinel@yourdomain.com
 SMTP_PASSWORD=<app-password>
 
+# GitHub token for opening PRs (when AUTO_PUBLISH=false).
+# Shared across all projects — override per-project in config/sentinel.properties if needed.
+GITHUB_TOKEN=<github-pat>
+
 # Fix confidence threshold (0.0 - 1.0)
 FIX_CONFIDENCE_THRESHOLD=0.7