@misterhuydo/sentinel 1.0.96 → 1.0.98

package/.cairn/session.json

@@ -1,6 +1,6 @@
 {
-  "message": "Auto-checkpoint at 2026-03-23T07:31:47.535Z",
-  "checkpoint_at": "2026-03-23T07:31:47.537Z",
+  "message": "Auto-checkpoint at 2026-03-23T07:36:48.429Z",
+  "checkpoint_at": "2026-03-23T07:36:48.430Z",
   "active_files": [],
   "notes": [],
   "mtime_snapshot": {}

package/package.json

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

package/python/sentinel/sentinel_boss.py

@@ -172,8 +172,26 @@ reply with a short summary grouped by category:
 Tone: direct, professional, like a senior engineer who owns the system.
 Don't pad responses. Don't say "Great question!" or "Certainly!".
 If you don't know something, use a tool to find out before saying you don't know.
-CRITICAL: Never narrate what you are about to do ("I'll check that now", "Stand by", "Requesting...").
-Just call the tool immediately and reply with the results. No pre-action commentary.
+
+When to act vs. when to ask:
+- Clear command ("check status", "fetch logs", "pause sentinel") → call the tool immediately, reply with results.
+- Ambiguous or exploratory ("what does get_repo_status do?", "tell me about search_logs") → explain the tool naturally, then ask: "Want me to run it?"
+- Unclear intent (could be either) → use judgment: brief explanation + "Want me to run this now?"
+Never say "Stand by" or "Requesting..." and then return nothing. Either act, or ask.
+
+Issue identification — before calling create_issue:
+1. Determine if the message is a REAL issue/task (bug report, feature request, investigation ask)
+   vs. a status question, tool query, or casual chat. If not an issue, just answer normally.
+2. If it IS an issue, gather what's needed before creating:
+   - Project: which project? If unclear, ask. Use list_projects if you need to check names.
+   - Context: what's the problem? Include everything: description, error text, steps to reproduce.
+   - Attachments: summarise any files/screenshots the user shared.
+   - Support URL: note any ticket/doc/link the user mentioned.
+   - Identity: always captured automatically from the Slack session.
+3. Before calling the tool, confirm with the user in natural language:
+   e.g. "I'll create an issue for project *1881* — here's what I have: [summary]. Look right?"
+   Wait for their confirmation before proceeding.
+4. After creating, tell them the issue was queued and Sentinel will pick it up on the next poll.
 
 When the engineer's request is fully handled, end your LAST message with the token: [DONE]
 IMPORTANT: Always write your actual reply text FIRST, then append [DONE] at the end. Example: "Hello! I'm Sentinel. [DONE]". Never output [DONE] as your only content.
@@ -205,26 +223,35 @@ _TOOLS = [
     {
         "name": "create_issue",
         "description": (
-            "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."
+            "Deliver a confirmed issue/task to a Sentinel project instance. "
+            "Only call this after you have: (1) confirmed the message is a real issue or task, "
+            "(2) identified the target project, (3) gathered enough context, and "
+            "(4) confirmed with the user ('I'll create this issue for project X — does that look right?'). "
+            "Do NOT call this for status questions, tool queries, or casual chat."
         ),
         "input_schema": {
             "type": "object",
             "properties": {
                 "description": {
                     "type": "string",
-                    "description": "Full task/problem description — everything the engineer told you",
+                    "description": "Full problem/task description — include all context the user gave you",
                 },
                 "project": {
                     "type": "string",
-                    "description": "Project short name to deliver to (e.g. '1881', 'elprint'). Omit for current project.",
+                    "description": "Project short name (e.g. '1881', 'elprint'). Ask if unclear.",
                 },
                 "target_repo": {
                     "type": "string",
                     "description": "Specific repo within the project (omit to let Sentinel auto-route)",
                 },
+                "support_url": {
+                    "type": "string",
+                    "description": "Any URL the user shared (ticket, doc, screenshot link, etc.)",
+                },
+                "attachments_summary": {
+                    "type": "string",
+                    "description": "Summary of any files/screenshots the user attached",
+                },
             },
             "required": ["description"],
         },
@@ -792,10 +819,29 @@ async def _run_tool(name: str, inputs: dict, cfg_loader, store, slack_client=Non
         else:
             project_dir = Path(".")
 
+        support_url          = inputs.get("support_url", "").strip()
+        attachments_summary  = inputs.get("attachments_summary", "").strip()
+
         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
+        fname = f"slack-{uuid.uuid4().hex[:8]}.txt"
+
+        from datetime import datetime, timezone as _tz
+        submitter_name = store.get_user_name(user_id) if user_id else ""
+        submitter_line = f"SUBMITTED_BY: {submitter_name} ({user_id})" if user_id else ""
+        lines = []
+        if submitter_line:
+            lines.append(submitter_line)
+        if target_repo:
+            lines.append(f"TARGET_REPO: {target_repo}")
+        if support_url:
+            lines.append(f"SUPPORT_URL: {support_url}")
+        lines.append(f"SUBMITTED_AT: {datetime.now(_tz.utc).isoformat()}")
+        lines.append("")
+        lines.append(description)
+        if attachments_summary:
+            lines.append(f"\nATTACHMENTS:\n{attachments_summary}")
+        content = "\n".join(lines)
         (issues_dir / fname).write_text(content, encoding="utf-8")
 
         # Touch SENTINEL_POLL_NOW so the target instance picks it up immediately
@@ -807,7 +853,7 @@ async def _run_tool(name: str, inputs: dict, cfg_loader, store, slack_client=Non
             try:
                 store.record_submitted_issue(
                     user_id=user_id,
-                    user_name="",        # resolved by caller if needed
+                    user_name=submitter_name,
                     project=project_label,
                     fname=fname,
                     description=description,