@misterhuydo/sentinel 1.0.67 → 1.0.69

package/.cairn/.hint-lock

@@ -1 +1 @@
-2026-03-22T15:53:29.003Z
+2026-03-22T16:24:09.877Z

package/.cairn/session.json

@@ -1,6 +1,6 @@
 {
-  "message": "Auto-checkpoint at 2026-03-22T16:08:22.876Z",
-  "checkpoint_at": "2026-03-22T16:08:22.877Z",
+  "message": "Auto-checkpoint at 2026-03-22T16:26:17.040Z",
+  "checkpoint_at": "2026-03-22T16:26:17.042Z",
   "active_files": [],
   "notes": [],
   "mtime_snapshot": {}

package/package.json

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

package/python/sentinel/sentinel_boss.py

@@ -100,11 +100,10 @@ What you can do (tools available):
                        process. Safe to run at any time — no restart if already up to date.
                        e.g. "upgrade sentinel", "update sentinel", "upgrade yourself"
 
-19. query_codebase   — Use Cairn MCP (via Claude Code) to analyse a managed repo. Operations:
-                       describe=summarize architecture & purpose, search=find by concept/symbol,
-                       outline=full structure + issue detection, security=vulnerability scan.
-                       e.g. "summarize the 1881 repo", "find PIN validation in elprint",
-                            "what does the cairn backend do?", "scan elprint for security issues"
+19. ask_codebase     — Ask any natural-language question about a managed repo's codebase.
+                       Claude Code answers using its full knowledge of the code.
+                       e.g. "what does the 1881 backend do?", "find PIN validation in elprint",
+                            "any TODOs in cairn?", "are there security issues in elprint-sales?"
 
 20. restart_project  — Stop and restart a specific project instance (stop.sh + start.sh).
                        e.g. "restart 1881", "reboot elprint", "restart the cairn project"
@@ -125,11 +124,8 @@ reply with a short summary grouped by category:
 • `search_logs` — live SSH grep on production servers — "search logs for illegal PIN in 1881"
 • `tail_log` — last N lines of a log source, no filter — "show recent SSOLWA logs"
 
-*Codebase intelligence (Cairn MCP)*
-• `query_codebase describe` — summarize what a repo does — "what does the 1881 backend do?"
-• `query_codebase search` — find classes/functions by concept — "find PIN validation in elprint"
-• `query_codebase outline` — full structure + issue detection — "outline the cairn repo"
-• `query_codebase security` — vulnerability scan — "scan elprint for security issues"
+*Codebase questions*
+• `ask_codebase` — any question about a repo's code — "what does 1881 do?", "find PIN validation", "any TODOs?", "security issues?"
 
 *Fix management*
 • `get_fix_details` — full details of a specific fix — "show fix abc123"
@@ -456,36 +452,28 @@ _TOOLS = [
         "input_schema": {"type": "object", "properties": {}},
     },
     {
-        "name": "query_codebase",
+        "name": "ask_codebase",
         "description": (
-            "Use Cairn MCP (via Claude Code) to deeply understand a managed repo's codebase. "
-            "Operations: 'describe' — summarize what the repo does (architecture, key classes); "
-            "'search' — find classes/functions/components by name or concept; "
-            "'outline' — full structural overview + heuristic issue detection; "
-            "'security' — scan for XSS, SQLi, hardcoded secrets, weak crypto. "
-            "Use for: 'what does the 1881 backend do?', 'find the PIN validation code in elprint', "
-            "'summarize the cairn repo', 'scan elprint-sales for security issues', "
-            "'what classes handle auth in 1881?'"
+            "Ask any natural-language question about a managed repo's codebase. "
+            "Claude Code answers using its full codebase knowledge — no need to specify how. "
+            "Use for any codebase question: 'what does the 1881 backend do?', "
+            "'find PIN validation code in elprint', 'are there TODOs in cairn?', "
+            "'what classes handle auth?', 'any security issues in elprint-sales?', "
+            "'summarize the architecture of 1881', 'show me the dependency graph'."
         ),
         "input_schema": {
             "type": "object",
             "properties": {
                 "repo": {
                     "type": "string",
-                    "description": "Repo name (partial match, e.g. '1881', 'elprint-sales')",
+                    "description": "Repo name (partial match, e.g. '1881', 'elprint-sales', 'cairn')",
                 },
-                "operation": {
+                "question": {
                     "type": "string",
-                    "enum": ["describe", "search", "outline", "security"],
-                    "description": "describe=summarize, search=find by concept, outline=structure+issues, security=vuln scan",
-                    "default": "describe",
-                },
-                "query": {
-                    "type": "string",
-                    "description": "For 'search': the concept or symbol to look for (e.g. 'PIN validation', 'AuthService')",
+                    "description": "Natural language question about the codebase",
                 },
             },
-            "required": ["repo"],
+            "required": ["repo", "question"],
         },
     },
     {
@@ -1045,59 +1033,29 @@ async def _run_tool(name: str, inputs: dict, cfg_loader, store, slack_client=Non
             "note":   "Upgrade started — pulling latest version via npm and restarting. Give me ~30 seconds then I'll be back.",
         })
 
-    if name == "query_codebase":
+    if name == "ask_codebase":
         repo_name = inputs.get("repo", "").lower()
-        operation = inputs.get("operation", "describe")
-        query     = inputs.get("query", "")
+        question  = inputs.get("question", "")
 
-        # Match repo by name
         repo_cfg = next(
             (r for rn, r in cfg_loader.repos.items() if repo_name in rn.lower()),
             None,
         )
         if not repo_cfg:
-            available = list(cfg_loader.repos.keys())
-            return json.dumps({"error": f"Repo '{repo_name}' not found", "available": available})
+            return json.dumps({"error": f"Repo '{repo_name}' not found", "available": list(cfg_loader.repos.keys())})
 
         local_path = Path(repo_cfg.local_path)
         if not local_path.exists():
             return json.dumps({"error": f"Repo not cloned yet at {local_path}. Run pull_repo first."})
 
-        # Build a targeted prompt for Claude Code + Cairn MCP
-        if operation == "describe":
-            prompt = (
-                f"You are analysing the codebase at: {local_path}\n"
-                f"Use the cairn_describe MCP tool to summarise what this project does — "
-                f"its purpose, main architecture, key classes/services, and tech stack. "
-                f"Be concise but informative. Output plain text only."
-            )
-        elif operation == "search":
-            if not query:
-                return json.dumps({"error": "query is required for operation=search"})
-            prompt = (
-                f"You are analysing the codebase at: {local_path}\n"
-                f"Use the cairn_search MCP tool to find '{query}'. "
-                f"List matching classes, functions, files, and a brief description of each. "
-                f"Output plain text only."
-            )
-        elif operation == "outline":
-            prompt = (
-                f"You are analysing the codebase at: {local_path}\n"
-                f"Use the cairn_outline MCP tool to give a full structural overview. "
-                f"Include key modules, packages, detected issues (god classes, gaps, etc.). "
-                f"Output plain text only."
-            )
-        elif operation == "security":
-            prompt = (
-                f"You are analysing the codebase at: {local_path}\n"
-                f"Use the cairn_security MCP tool to scan for vulnerabilities. "
-                f"List findings grouped by severity. Output plain text only."
-            )
-        else:
-            return json.dumps({"error": f"Unknown operation '{operation}'"})
+        prompt = (
+            f"You are a code analyst. Answer the following question about the codebase at: {local_path}\n\n"
+            f"Question: {question}\n\n"
+            f"Use whatever tools you need to answer accurately. Be concise and direct. Plain text only."
+        )
 
-        cfg     = cfg_loader.sentinel
-        env     = os.environ.copy()
+        cfg = cfg_loader.sentinel
+        env = os.environ.copy()
         if cfg.anthropic_api_key:
             env["ANTHROPIC_API_KEY"] = cfg.anthropic_api_key
 
@@ -1113,13 +1071,10 @@ async def _run_tool(name: str, inputs: dict, cfg_loader, store, slack_client=Non
                     "error": f"`claude --print` failed (rc={r.returncode})",
                     "stderr": (r.stderr or "").strip()[:300],
                 })
-            return json.dumps({
-                "repo":      repo_cfg.repo_name,
-                "operation": operation,
-                "result":    output[:4000],
-            })
+            logger.info("Boss ask_codebase %s rc=%d len=%d", repo_cfg.repo_name, r.returncode, len(output))
+            return json.dumps({"repo": repo_cfg.repo_name, "answer": output[:4000]})
         except subprocess.TimeoutExpired:
-            return json.dumps({"error": "Cairn query timed out after 180s"})
+            return json.dumps({"error": "Codebase query timed out after 180s"})
         except Exception as e:
             return json.dumps({"error": str(e)})
 

package/python/sentinel/slack_bot.py

@@ -318,9 +318,15 @@ async def _dispatch(event: dict, client, cfg_loader, store) -> None:
 
 # ── Turn processor ────────────────────────────────────────────────────────────
 
+_MAX_HISTORY_TURNS = 20   # keep last 20 exchanges (~40 messages) to stay well within context limits
+
 async def _run_turn(session: _Session, message: str, client, cfg_loader, store) -> None:
     channel = session.channel
 
+    # Trim history to avoid context overflow on long conversations
+    if len(session.history) > _MAX_HISTORY_TURNS * 2:
+        session.history = session.history[-(_MAX_HISTORY_TURNS * 2):]
+
     # Typing indicator
     await _post(client, channel, "_thinking..._")