@misterhuydo/sentinel 1.0.45 → 1.0.47

package/.cairn/session.json

@@ -1,6 +1,6 @@
 {
-  "message": "Auto-checkpoint at 2026-03-22T05:36:04.794Z",
-  "checkpoint_at": "2026-03-22T05:36:04.795Z",
+  "message": "Auto-checkpoint at 2026-03-22T05:48:46.579Z",
+  "checkpoint_at": "2026-03-22T05:48:46.580Z",
   "active_files": [],
   "notes": [],
   "mtime_snapshot": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@misterhuydo/sentinel",
-  "version": "1.0.45",
+  "version": "1.0.47",
   "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

@@ -29,17 +29,20 @@ and opens GitHub PRs for admin review (or pushes directly if AUTO_PUBLISH=true).
 Your job:
 - Understand what the DevOps engineer needs in natural language
 - Query Sentinel's live state (errors, fixes, open PRs) on their behalf
-- Create issue reports when asked to investigate or fix something
+- Deliver tasks/issues to the right project — you know all projects in this workspace
 - Control Sentinel (pause/resume) when asked
 - Give honest, concise answers — you know this system inside out
+- If a project name is unclear or ambiguous, ask the engineer to clarify — never guess
 
 What you can do (tools available):
 
 1. get_status        — Show recent errors detected, fixes applied/pending, open PRs.
                        e.g. "what happened today?", "any issues?", "show open PRs"
 
-2. create_issue      — Queue a manual fix request for Sentinel to investigate next poll.
-                       e.g. "look into this bug: ...", "investigate order creation failures"
+2. create_issue      — Deliver a fix/task to any project in this workspace by short name.
+                       You know all project names — use list_projects if you're unsure.
+                       If the project name is ambiguous or not found, ask to clarify.
+                       e.g. "tell 1881 to fix X", "look into Y in elprint", "investigate Z"
 
 3. pause_sentinel    — Create SENTINEL_PAUSE file to halt all auto-fix activity.
                        e.g. "pause sentinel", "stop auto-fixing"
@@ -69,8 +72,11 @@ What you can do (tools available):
 11. list_errors      — List recent errors from the state store, optionally filtered by repo or source.
                        e.g. "show all errors today", "what errors hit elprint this week?"
 
-12. pull_repo        — Run git pull on one or all managed repos.
-                       e.g. "pull changes for sentinel-1881", "git pull all repos", "update the code"
+12. pull_repo        — Run git pull on one or all managed application repos.
+                       e.g. "pull changes", "git pull all repos", "update the code"
+
+13. pull_config      — Run git pull on one or all Sentinel project config dirs.
+                       e.g. "pull config for 1881", "update sentinel config", "pull all configs"
 
 Tone: direct, professional, like a senior engineer who owns the system.
 Don't pad responses. Don't say "Great question!" or "Certainly!".
@@ -104,20 +110,25 @@ _TOOLS = [
     {
         "name": "create_issue",
         "description": (
-            "Queue a fix request for Sentinel to investigate on the next poll cycle. "
-            "Use whenever the engineer reports a bug, customer complaint, or asks you "
-            "to look into something specific. Include every detail they gave you."
+            "Deliver a fix/task request to a Sentinel project instance. "
+            "Use when the engineer says 'tell 1881 to do X', 'look into Y in project elprint', "
+            "'implement this in 1881: ...'. Can target any project by short name. "
+            "Defaults to the current project if no project is specified."
         ),
         "input_schema": {
             "type": "object",
             "properties": {
                 "description": {
                     "type": "string",
-                    "description": "Full problem description — everything the engineer told you",
+                    "description": "Full task/problem description — everything the engineer told you",
+                },
+                "project": {
+                    "type": "string",
+                    "description": "Project short name to deliver to (e.g. '1881', 'elprint'). Omit for current project.",
                 },
                 "target_repo": {
                     "type": "string",
-                    "description": "Repo name to assign to (omit to let Sentinel auto-route)",
+                    "description": "Specific repo within the project (omit to let Sentinel auto-route)",
                 },
             },
             "required": ["description"],
@@ -279,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:
@@ -290,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:
@@ -349,16 +379,43 @@ def _run_tool(name: str, inputs: dict, cfg_loader, store) -> str:
     if name == "create_issue":
         description = inputs["description"]
         target_repo = inputs.get("target_repo", "")
-        issues_dir  = Path("issues")
+        project_arg = inputs.get("project", "")
+
+        if project_arg:
+            project_dirs = _find_project_dirs(project_arg)
+            if not 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 = [_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.",
+                })
+            project_dir = project_dirs[0]
+        else:
+            project_dir = Path(".")
+
+        issues_dir = project_dir / "issues"
         issues_dir.mkdir(exist_ok=True)
         fname   = f"slack-{uuid.uuid4().hex[:8]}.txt"
         content = (f"TARGET_REPO: {target_repo}\n\n" if target_repo else "") + description
         (issues_dir / fname).write_text(content, encoding="utf-8")
-        logger.info("Boss created issue: %s", fname)
+
+        # Touch SENTINEL_POLL_NOW so the target instance picks it up immediately
+        (project_dir / "SENTINEL_POLL_NOW").touch()
+
+        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",
-            "file":   fname,
-            "note":   "Sentinel will pick this up on the next poll cycle.",
+            "status":  "queued",
+            "project": project_label,
+            "file":    fname,
+            "note":    f"Delivered to '{project_label}'. Sentinel will process it on the next poll cycle.",
         })
 
     if name == "get_fix_details":
@@ -413,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(),
@@ -523,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})
 
@@ -662,14 +719,16 @@ async def handle_message(
     client = anthropic.Anthropic(api_key=api_key)
 
     # Build system context snapshot
-    paused    = Path("SENTINEL_PAUSE").exists()
-    repos     = list(cfg_loader.repos.keys())
-    ts        = datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M UTC")
+    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 = [_read_project_name(d) for d in _find_project_dirs()]
     system    = (
         _SYSTEM
         + f"\n\nCurrent time: {ts}"
         + f"\nSentinel status: {'⏸ PAUSED' if paused else '▶ RUNNING'}"
         + f"\nManaged repos: {', '.join(repos) if repos else '(none configured)'}"
+        + (f"\nKnown projects in workspace: {', '.join(known_projects)}" if known_projects else "")
     )
 
     history.append({"role": "user", "content": message})

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