nexo-brain 7.30.14 → 7.30.15

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "7.30.14",
+  "version": "7.30.15",
   "description": "Local cognitive runtime for Claude Code \u2014 persistent memory, overnight learning, doctor diagnostics, personal scripts, recovery-aware jobs, startup preflight, and optional dashboard/power helper.",
   "author": {
     "name": "NEXO Brain",

package/README.md

@@ -18,7 +18,9 @@
 
 [Watch the overview video](https://nexo-brain.com/watch/) · [Watch on YouTube](https://www.youtube.com/watch?v=i2lkGhKyVqI) · [Open the infographic](https://nexo-brain.com/assets/nexo-brain-infographic-v5.png)
 
-Version `7.30.14` is the current packaged-runtime line. Patch release over v7.30.13 - support tickets, provider capability discovery, task-close rearming, internal audit followups, and the memory-observation watchdog are aligned for Desktop-managed agents.
+Version `7.30.15` is the current packaged-runtime line. Patch release over v7.30.14 - Email NEXO reply lifecycle closure now handles affirmative actionable replies and prevents already-closed processed threads from reopening.
+
+Previously in `7.30.14`: patch release over v7.30.13 - support tickets, provider capability discovery, task-close rearming, internal audit followups, and the memory-observation watchdog are aligned for Desktop-managed agents.
 
 Previously in `7.30.13`: patch release over v7.30.12 - Email NEXO monitor prompts now require a full IMAP body fetch before replying, and managed email defaults use the MXroute `Sent` folder instead of `INBOX.Sent`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "7.30.14",
+  "version": "7.30.15",
   "mcpName": "io.github.wazionapps/nexo",
   "description": "NEXO Brain — Shared brain for AI agents. Persistent memory, semantic RAG, natural forgetting, metacognitive guard, trust scoring, 150+ MCP tools. Works with Claude Code, Codex, Claude Desktop & any MCP client. 100% local, free.",
   "homepage": "https://nexo-brain.com",

package/src/scripts/nexo-email-monitor.py

@@ -109,6 +109,8 @@ CREATE INDEX IF NOT EXISTS idx_ee_email ON email_events(email_id);
 CREATE INDEX IF NOT EXISTS idx_ee_event ON email_events(event);
 CREATE INDEX IF NOT EXISTS idx_ee_ts ON email_events(timestamp);
 """
+ACTION_CLOSURE_EVENTS = ("action_done", "resolution")
+SENT_REPLY_EVENTS = ("action_done", "resolution", "replied")
 EMAIL_LOOP_GUARD_SQL = """
 CREATE TABLE IF NOT EXISTS email_loop_guards (
     thread_key TEXT PRIMARY KEY,
@@ -902,20 +904,74 @@ def _has_active_processing_within(conn, email_id, *, hours=ZOMBIE_TIMEOUT_HOURS)
 
 
 def _has_action_done_after(conn, email_id, reference_ts):
+    return _has_email_event_after(conn, email_id, ACTION_CLOSURE_EVENTS, reference_ts)
+
+
+def _has_email_event_after(conn, email_id, events, reference_ts):
+    if not email_id or not reference_ts:
+        return False
+    event_list = tuple(events or ())
+    if not event_list:
+        return False
+    placeholders = ",".join("?" for _ in event_list)
     row = conn.execute(
-        """
+        f"""
+        SELECT 1
+        FROM email_events
+        WHERE email_id = ?
+          AND event IN ({placeholders})
+          AND datetime(replace(timestamp, 'T', ' ')) > datetime(replace(?, 'T', ' '))
+        LIMIT 1
+        """,
+        (email_id, *event_list, reference_ts),
+    ).fetchone()
+    return bool(row)
+
+
+def _has_sent_reply_event(conn, email_id):
+    if not email_id:
+        return False
+    placeholders = ",".join("?" for _ in SENT_REPLY_EVENTS)
+    row = conn.execute(
+        f"""
         SELECT 1
         FROM email_events
         WHERE email_id = ?
-          AND event IN ('action_done', 'resolution')
-          AND timestamp > ?
+          AND event IN ({placeholders})
         LIMIT 1
         """,
-        (email_id, reference_ts),
+        (email_id, *SENT_REPLY_EVENTS),
     ).fetchone()
     return bool(row)
 
 
+def _mark_processing_email_processed(conn, email_id, *, completed_at):
+    cols = _email_table_columns(conn)
+    updates = [
+        "status = 'processed'",
+        "started_at = NULL",
+    ]
+    params = []
+    if "completed_at" in cols:
+        updates.append(
+            "completed_at = CASE WHEN completed_at IS NULL OR trim(completed_at) = '' THEN ? ELSE completed_at END"
+        )
+        params.append(completed_at)
+    if "error" in cols:
+        updates.append("error = NULL")
+    params.append(email_id)
+    cur = conn.execute(
+        f"""
+        UPDATE emails
+        SET {', '.join(updates)}
+        WHERE message_id = ?
+          AND status = 'processing'
+        """,
+        tuple(params),
+    )
+    return cur.rowcount > 0
+
+
 def scan_debt(db_path=EMAIL_DB_PATH, *, max_items=5):
     conn = sqlite3.connect(db_path)
     conn.row_factory = sqlite3.Row
@@ -998,7 +1054,12 @@ def scan_debt(db_path=EMAIL_DB_PATH, *, max_items=5):
         """
     ).fetchall()
     recovered = []
+    sent_reconciled = []
     for row in stuck_rows:
+        if _has_sent_reply_event(conn, row["message_id"]):
+            if _mark_processing_email_processed(conn, row["message_id"], completed_at=now_label):
+                sent_reconciled.append(row)
+            continue
         conn.execute(
             """
             UPDATE emails
@@ -1053,6 +1114,11 @@ def scan_debt(db_path=EMAIL_DB_PATH, *, max_items=5):
     if recovered:
         lines.append("")
         lines.append(f"Auto-recovery applied: {len(recovered)} processing-stuck email(s) were reset to pending.")
+    if sent_reconciled:
+        lines.append("")
+        lines.append(
+            f"Reconciled {len(sent_reconciled)} processing email(s) with already-sent reply events; no re-open applied."
+        )
     total_reconciled = len(live_reconciled) + len(finished_reconciled)
     if total_reconciled:
         lines.append(f"Reconciled {total_reconciled} email(s) with inconsistent lifecycle state.")
@@ -1665,7 +1731,7 @@ def _recover_unreplied_processed(config, hours=24):
               AND NOT EXISTS (
                   SELECT 1 FROM email_events ev
                   WHERE ev.email_id = e.message_id
-                    AND ev.event IN ('replied', 'resolution')
+                    AND ev.event IN ('replied', 'resolution', 'action_done')
               )
             ORDER BY e.rowid DESC
             LIMIT 20

package/src/scripts/nexo-send-reply.py

@@ -270,7 +270,7 @@ def _has_open_action(conn, email_id):
     return not latest_done or latest_done < latest_open
 
 
-def record_reply_lifecycle(in_reply_to, references, body_text, *, subject="", to="", cc="", message_id="", db_path=EMAIL_DB_PATH):
+def record_reply_lifecycle(in_reply_to, references, body_text, *, subject="", to="", cc="", message_id="", db_path=EMAIL_DB_PATH, classify_override=""):
     try:
         conn = sqlite3.connect(db_path)
         conn.row_factory = sqlite3.Row
@@ -280,7 +280,7 @@ def record_reply_lifecycle(in_reply_to, references, body_text, *, subject="", to
             conn.close()
             return None
 
-        event = classify_reply_event(body_text)
+        event = (classify_override or "").strip() or classify_reply_event(body_text)
         detail = normalize_reply_text(body_text)[:200]
         meta = json.dumps(
             {
@@ -476,6 +476,18 @@ def build_parser():
     parser.add_argument("--quote-date", default="")
     parser.add_argument("--thread-file", default="", help="Full thread history file (all previous messages)")
     parser.add_argument("--attach", "--attachment", dest="attach", action="append", default=[], help="File to attach (can repeat)")
+    parser.add_argument(
+        "--classify-as",
+        dest="classify_as",
+        default="",
+        choices=["", "resolution", "ack", "commitment", "replied", "debt_flagged"],
+        help=(
+            "Force the reply lifecycle event instead of heuristic auto-classification. "
+            "Use when the reply is substantive but opens with a short affirmation that the "
+            "text heuristic would mis-read as 'ack' (escalation -> debt_flagged). "
+            "Empty (default) keeps automatic classification."
+        ),
+    )
     return parser
 
 
@@ -536,6 +548,7 @@ def main(argv=None):
             to=args.to,
             cc=args.cc,
             message_id=msg_id,
+            classify_override=(args.classify_as or "").strip(),
         )
         try:
             record_sent_email(

package/templates/core-prompts/email-monitor.md

@@ -40,6 +40,9 @@ You MUST register read-side lifecycle events, not send-side events:
 - When you open/analyze a new email seriously, add an `opened` event for that `message_id`.
 - When you change `emails.status` to `processing`, also add a `processing` event.
 - Do NOT register `ack` / `commitment` / `resolution` manually when replying: `nexo-send-reply.py` already does that.
+- When the reply closes or answers a real actionable instruction, pass `--classify-as resolution`.
+  This is mandatory when the body starts with a short affirmation (`sí`, `de acuerdo`, `perfecto`, etc.) but then contains substantive instructions or completed work.
+- Use `--classify-as ack` only for a pure receipt/started-working acknowledgement, and `--classify-as commitment` only for a real future commitment.
 - Use sqlite3 or local python3+sqlite3; tracking is best-effort, append-only, and never deletes historical entries.
 
 == WHEN THERE IS DEBT BUT NO UNREAD EMAIL ==
@@ -169,7 +172,9 @@ Mandatory steps before sending:
    The bottom of the email must preserve message -> reply -> message -> reply without dropping previous answers.
 
 == SEND VIA `nexo-send-reply.py` ==
-[[python_executable]] [[send_reply_script]] --to X --cc Y --subject 'Re: Z' --in-reply-to '<msgid>' --references '<refs>' --body-file /tmp/nexo-reply-UID.txt --quote-file /tmp/nexo-quote-UID.txt --quote-from 'Name <email>' --quote-date 'date' --thread-file /tmp/nexo-thread-UID.txt [--attach /path/to/file]
+[[python_executable]] [[send_reply_script]] --to X --cc Y --subject 'Re: Z' --in-reply-to '<msgid>' --references '<refs>' --body-file /tmp/nexo-reply-UID.txt --quote-file /tmp/nexo-quote-UID.txt --quote-from 'Name <email>' --quote-date 'date' --thread-file /tmp/nexo-thread-UID.txt --classify-as resolution [--attach /path/to/file]
+
+Use a different `--classify-as` value only when the lifecycle is truly different (`ack`, `commitment`, `replied`, `debt_flagged`).
 
 == ANTI-LOOP PROTECTION ==
 Do not reply to auto-replies, [[agent_email_label]] itself, `noreply@`,