@misterhuydo/sentinel 1.0.97 → 1.0.98

package/.cairn/session.json

@@ -1,6 +1,6 @@
 {
-  "message": "Auto-checkpoint at 2026-03-23T07:34:25.856Z",
-  "checkpoint_at": "2026-03-23T07:34:25.857Z",
+  "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.97",
+  "version": "1.0.98",
   "description": "Sentinel — Autonomous DevOps Agent installer and manager",
   "bin": {
     "sentinel": "./bin/sentinel.js"

package/python/sentinel/sentinel_boss.py

@@ -179,6 +179,20 @@ When to act vs. when to ask:
 - 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.
 For greetings like "hello" or empty messages, introduce yourself briefly and offer help, then end with [DONE].
@@ -209,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"],
         },
@@ -796,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
@@ -811,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,