nexo-brain 3.1.6 → 3.1.8

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "3.1.6",
+  "version": "3.1.8",
   "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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "3.1.6",
+  "version": "3.1.8",
   "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/auto_update.py

@@ -1200,6 +1200,7 @@ def _backup_runtime_tree(dest: Path = NEXO_HOME) -> str:
         "client_preferences.py", "agent_runner.py", "bootstrap_docs.py",
         "hook_guardrails.py", "protocol_settings.py", "public_evolution_queue.py",
         "auto_update.py", "tools_sessions.py", "tools_coordination.py",
+        "tools_hot_context.py",
         "tools_reminders.py", "tools_reminders_crud.py", "tools_learnings.py",
         "tools_credentials.py", "tools_task_history.py", "tools_menu.py",
         "cli.py", "script_registry.py", "skills_runtime.py", "user_context.py",
@@ -1251,6 +1252,7 @@ def _copy_runtime_from_source(src_dir: Path, repo_dir: Path, dest: Path = NEXO_H
         "client_preferences.py", "agent_runner.py", "bootstrap_docs.py",
         "hook_guardrails.py", "protocol_settings.py", "public_evolution_queue.py",
         "auto_update.py", "tools_sessions.py", "tools_coordination.py",
+        "tools_hot_context.py",
         "tools_reminders.py", "tools_reminders_crud.py", "tools_learnings.py",
         "tools_credentials.py", "tools_task_history.py", "tools_menu.py",
         "cli.py", "script_registry.py", "skills_runtime.py", "user_context.py",

package/src/dashboard/app.py

@@ -106,6 +106,7 @@ class ReminderUpdate(BaseModel):
     date: Optional[str] = None
     status: Optional[str] = None
     category: Optional[str] = None
+    read_token: Optional[str] = None
 
 class FollowupCreate(BaseModel):
     description: str
@@ -119,10 +120,12 @@ class FollowupUpdate(BaseModel):
     status: Optional[str] = None
     verification: Optional[str] = None
     reasoning: Optional[str] = None
+    read_token: Optional[str] = None
 
 class MoveRequest(BaseModel):
     id: str
     direction: str  # "to_followup" | "to_reminder"
+    read_token: Optional[str] = None
 
 class InboxCreate(BaseModel):
     direction: str  # "to_nexo" | "to_user"
@@ -181,6 +184,22 @@ def _dashboard_status_matches(status: object, requested: str | None) -> bool:
     return normalized == requested_key.upper()
 
 
+def _require_dashboard_item_read(item_type: str, item_id: str, read_token: str | None):
+    db = _db()
+    ok, message = db.validate_item_read_token(read_token or "", item_type, item_id)
+    if ok:
+        return None
+    prefix = "followup" if item_type == "followup" else "reminder"
+    return JSONResponse(
+        {
+            "error": f"{message} Read /api/{prefix}s/{item_id} first and reuse its read_token.",
+            "item_type": item_type,
+            "item_id": item_id,
+        },
+        status_code=409,
+    )
+
+
 def _latest_periodic_summary(kind: str) -> dict:
     root = _deep_sleep_dir()
     pattern = f"*-{kind}-summary.json"
@@ -807,6 +826,9 @@ async def api_reminders_update(rid: str, body: ReminderUpdate):
     row = db.get_reminder(rid)
     if not row:
         return JSONResponse({"error": f"Reminder {rid} not found"}, status_code=404)
+    read_error = _require_dashboard_item_read("reminder", rid, body.read_token)
+    if read_error:
+        return read_error
     fields = {}
     if body.description is not None:
         fields["description"] = body.description
@@ -825,12 +847,15 @@ async def api_reminders_update(rid: str, body: ReminderUpdate):
 
 
 @app.delete("/api/reminders/{rid}")
-async def api_reminders_delete(rid: str):
+async def api_reminders_delete(rid: str, read_token: str = Query("", description="Read token from GET /api/reminders/{rid}")):
     """Soft-delete a reminder."""
     db = _db()
     row = db.get_reminder(rid)
     if not row:
         return JSONResponse({"error": f"Reminder {rid} not found"}, status_code=404)
+    read_error = _require_dashboard_item_read("reminder", rid, read_token)
+    if read_error:
+        return read_error
     db.add_reminder_note(rid, "Soft-deleted from dashboard.", actor="dashboard")
     db.delete_reminder(rid)
     return {"success": True, "deleted_id": rid}
@@ -902,6 +927,9 @@ async def api_followups_update(fid: str, body: FollowupUpdate):
     row = db.get_followup(fid)
     if not row:
         return JSONResponse({"error": f"Followup {fid} not found"}, status_code=404)
+    read_error = _require_dashboard_item_read("followup", fid, body.read_token)
+    if read_error:
+        return read_error
     fields = {}
     if body.description is not None:
         fields["description"] = body.description
@@ -922,12 +950,15 @@ async def api_followups_update(fid: str, body: FollowupUpdate):
 
 
 @app.delete("/api/followups/{fid}")
-async def api_followups_delete(fid: str):
+async def api_followups_delete(fid: str, read_token: str = Query("", description="Read token from GET /api/followups/{fid}")):
     """Soft-delete a followup."""
     db = _db()
     row = db.get_followup(fid)
     if not row:
         return JSONResponse({"error": f"Followup {fid} not found"}, status_code=404)
+    read_error = _require_dashboard_item_read("followup", fid, read_token)
+    if read_error:
+        return read_error
     db.add_followup_note(fid, "Soft-deleted from dashboard.", actor="dashboard")
     db.delete_followup(fid)
     return {"success": True, "deleted_id": fid}
@@ -947,6 +978,9 @@ async def api_ops_move(body: MoveRequest):
         item = db.get_reminder(body.id)
         if not item:
             return JSONResponse({"error": f"Reminder {body.id} not found"}, status_code=404)
+        read_error = _require_dashboard_item_read("reminder", body.id, body.read_token)
+        if read_error:
+            return read_error
         fid = _next_followup_id(conn)
         created = db.create_followup(
             fid,
@@ -965,6 +999,9 @@ async def api_ops_move(body: MoveRequest):
         item = db.get_followup(body.id)
         if not item:
             return JSONResponse({"error": f"Followup {body.id} not found"}, status_code=404)
+        read_error = _require_dashboard_item_read("followup", body.id, body.read_token)
+        if read_error:
+            return read_error
         rid = _next_reminder_id(conn)
         created = db.create_reminder(
             rid,
@@ -1388,6 +1425,33 @@ async def api_memory_flow():
             "stm_recent": stm_recent, "ltm_recent": ltm_recent, "quarantine": quarantine}
 
 
+@app.get("/api/recent-context")
+async def api_recent_context(
+    query: str = Query("", description="Optional search query for hot context"),
+    hours: int = Query(24, ge=1, le=168, description="How many recent hours to inspect"),
+    limit: int = Query(8, ge=1, le=25, description="Max contexts/events to return"),
+):
+    """Expose recent hot context and event timeline for the last N hours."""
+    db = _db()
+    bundle = db.build_pre_action_context(query=query, hours=hours, limit=limit)
+    return {
+        "query": bundle.get("query") or "",
+        "hours": bundle.get("hours") or hours,
+        "has_matches": bool(bundle.get("has_matches")),
+        "counts": {
+            "contexts": len(bundle.get("contexts") or []),
+            "events": len(bundle.get("events") or []),
+            "reminders": len(bundle.get("reminders") or []),
+            "followups": len(bundle.get("followups") or []),
+        },
+        "contexts": bundle.get("contexts") or [],
+        "events": bundle.get("events") or [],
+        "reminders": bundle.get("reminders") or [],
+        "followups": bundle.get("followups") or [],
+        "excerpt": db.format_pre_action_context_bundle(bundle, compact=True) if bundle.get("has_matches") else "No recent context.",
+    }
+
+
 # ---------------------------------------------------------------------------
 # Dream Journal
 # ---------------------------------------------------------------------------

package/src/dashboard/templates/memory.html

@@ -126,6 +126,47 @@
   </div>
 </div>
 
+<!-- Hot Context -->
+<div class="mb-6">
+  <div class="flex flex-col gap-3 lg:flex-row lg:items-center lg:justify-between mb-3">
+    <div>
+      <h2 class="text-xs uppercase tracking-wider text-slate-500 font-semibold flex items-center gap-2">
+        <span class="w-2 h-2 rounded-full bg-emerald-400 glow-dot" style="color:#34d399"></span>
+        Hot Context 24h
+      </h2>
+      <p class="text-xs text-slate-600 mt-1">Recent operational memory shared across sessions, clients, and channels.</p>
+    </div>
+    <div class="flex items-center gap-2">
+      <input type="text" id="context-query" placeholder="Search recent context..."
+        class="bg-slate-800 border border-slate-700 rounded-lg px-3 py-1.5 text-xs text-slate-200 placeholder-slate-500 focus:outline-none focus:ring-1 focus:ring-emerald-500 w-64"
+        onkeydown="if(event.key==='Enter')loadRecentContext()">
+      <button onclick="loadRecentContext()" class="px-3 py-1.5 text-xs bg-emerald-600 text-white rounded-lg hover:bg-emerald-500 transition-colors font-medium">Refresh</button>
+    </div>
+  </div>
+
+  <div class="grid grid-cols-1 xl:grid-cols-2 gap-5">
+    <div class="bg-emerald-500/5 border border-emerald-500/20 rounded-xl p-4">
+      <div class="flex items-center justify-between mb-3">
+        <div class="text-xs uppercase tracking-wider text-emerald-400 font-semibold">Active Contexts</div>
+        <div class="text-[10px] text-slate-500 font-mono" id="hot-context-count">--</div>
+      </div>
+      <div class="space-y-2" id="hot-context-list">
+        <div class="text-xs text-slate-600 text-center py-6">Loading...</div>
+      </div>
+    </div>
+
+    <div class="bg-emerald-500/5 border border-emerald-500/20 rounded-xl p-4">
+      <div class="flex items-center justify-between mb-3">
+        <div class="text-xs uppercase tracking-wider text-emerald-400 font-semibold">Recent Events</div>
+        <div class="text-[10px] text-slate-500 font-mono" id="hot-event-count">--</div>
+      </div>
+      <div class="space-y-2" id="hot-event-list">
+        <div class="text-xs text-slate-600 text-center py-6">Loading...</div>
+      </div>
+    </div>
+  </div>
+</div>
+
 <!-- Two-column: STM and LTM Recent -->
 <div class="grid grid-cols-1 lg:grid-cols-2 gap-5 mb-6" id="columns-area">
   <!-- Recent STM -->
@@ -232,6 +273,65 @@
     </div>`;
   }
 
+  function recentTime(value) {
+    if (value === null || value === undefined || value === '') return '--';
+    if (typeof value === 'number') return relativeTime(new Date(value * 1000).toISOString());
+    if (/^\d+(\.\d+)?$/.test(String(value))) return relativeTime(new Date(parseFloat(value) * 1000).toISOString());
+    return relativeTime(value);
+  }
+
+  function renderHotContextCard(item) {
+    const title = item.title || item.context_key || '(untitled)';
+    const summary = item.summary || '';
+    const state = item.state || 'active';
+    const owner = item.owner || '';
+    const lastEvent = item.last_event_at ? recentTime(item.last_event_at) : '';
+    return `<div class="bg-slate-900/50 border border-emerald-500/15 rounded-xl p-4">
+      <div class="flex items-center gap-2 mb-2 flex-wrap">
+        <span class="text-[10px] px-1.5 py-0.5 rounded bg-emerald-500/10 text-emerald-400 font-medium">${escapeHtml(state)}</span>
+        ${owner ? `<span class="text-[10px] px-1.5 py-0.5 rounded bg-slate-800 text-slate-500">${escapeHtml(owner)}</span>` : ''}
+        <span class="text-[10px] text-slate-600 ml-auto font-mono">${escapeHtml(lastEvent)}</span>
+      </div>
+      <div class="text-sm text-slate-200 leading-relaxed">${escapeHtml(title)}</div>
+      ${summary ? `<div class="text-xs text-slate-400 leading-relaxed mt-2">${escapeHtml(summary)}</div>` : ''}
+      <div class="text-[10px] text-slate-600 font-mono mt-2">${escapeHtml(item.context_key || '')}</div>
+    </div>`;
+  }
+
+  function renderHotEventCard(event) {
+    const title = event.title || event.context_key || '(event)';
+    const summary = event.summary || event.body || '';
+    const created = event.created_at ? recentTime(event.created_at) : '';
+    return `<div class="bg-slate-900/50 border border-emerald-500/15 rounded-xl p-4">
+      <div class="flex items-center gap-2 mb-2 flex-wrap">
+        <span class="text-[10px] px-1.5 py-0.5 rounded bg-emerald-500/10 text-emerald-400 font-medium">${escapeHtml(event.event_type || 'event')}</span>
+        <span class="text-[10px] text-slate-600 ml-auto font-mono">${escapeHtml(created)}</span>
+      </div>
+      <div class="text-sm text-slate-200 leading-relaxed">${escapeHtml(title)}</div>
+      ${summary ? `<div class="text-xs text-slate-400 leading-relaxed mt-2 whitespace-pre-wrap">${escapeHtml(summary)}</div>` : ''}
+      <div class="text-[10px] text-slate-600 font-mono mt-2">${escapeHtml(event.context_key || '')}</div>
+    </div>`;
+  }
+
+  async function loadRecentContext() {
+    const q = document.getElementById('context-query').value.trim();
+    const url = '/api/recent-context?hours=24&limit=8' + (q ? `&query=${encodeURIComponent(q)}` : '');
+    const data = await fetchJSON(url);
+    if (!data) return;
+
+    document.getElementById('hot-context-count').textContent = formatNumber((data.counts && data.counts.contexts) || 0);
+    document.getElementById('hot-event-count').textContent = formatNumber((data.counts && data.counts.events) || 0);
+
+    const contexts = data.contexts || [];
+    const events = data.events || [];
+    document.getElementById('hot-context-list').innerHTML = contexts.length === 0
+      ? '<div class="text-xs text-slate-600 text-center py-6">No active hot context in the last 24h</div>'
+      : contexts.map(renderHotContextCard).join('');
+    document.getElementById('hot-event-list').innerHTML = events.length === 0
+      ? '<div class="text-xs text-slate-600 text-center py-6">No recent events in the last 24h</div>'
+      : events.map(renderHotEventCard).join('');
+  }
+
   async function loadFlow() {
     const data = await fetchJSON('/api/memory/flow');
     if (!data) return;
@@ -312,7 +412,9 @@
   }
 
   // Init
+  loadRecentContext();
   loadFlow();
+  setInterval(loadRecentContext, REFRESH_MS);
   setInterval(loadFlow, REFRESH_MS);
 </script>
 {% endblock %}

package/src/dashboard/templates/operations.html

@@ -129,6 +129,7 @@
       </div>
       <input type="hidden" name="type" id="modal-type">
       <input type="hidden" name="edit_id" id="modal-edit-id">
+      <input type="hidden" name="read_token" id="modal-read-token">
       <div class="flex items-center justify-end gap-2 pt-1">
         <button type="button" onclick="closeModal()" class="text-xs px-3 py-1.5 rounded-lg bg-slate-800 text-slate-400 hover:bg-slate-700 hover:text-slate-200 transition-colors">
           Cancel
@@ -229,6 +230,24 @@ function opsRelativeDate(dateStr) {
   return d.toLocaleDateString('en', { month: 'short', day: 'numeric' });
 }
 
+async function fetchItemDetail(id, type) {
+  const url = type === 'reminder' ? '/api/reminders/' + id : '/api/followups/' + id;
+  const data = await fetchJSON(url);
+  if (!data || !data.success) {
+    throw new Error((data && (data.error || data.detail)) || 'Failed to read item history');
+  }
+  return type === 'reminder' ? data.reminder : data.followup;
+}
+
+async function fetchReadToken(id, type) {
+  const item = await fetchItemDetail(id, type);
+  const token = item.read_token;
+  if (!token) {
+    throw new Error('Missing read token for ' + id);
+  }
+  return { item, token };
+}
+
 // -----------------------------------------------------------------------
 // Grouping
 // -----------------------------------------------------------------------
@@ -373,11 +392,12 @@ function filterOps() {
 // -----------------------------------------------------------------------
 async function completeItem(id, type) {
   try {
+    const { token } = await fetchReadToken(id, type);
     const url = type === 'reminder' ? '/api/reminders/' + id : '/api/followups/' + id;
     const res = await fetch(url, {
       method: 'PUT',
       headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ status: 'COMPLETED' })
+      body: JSON.stringify({ status: 'COMPLETED', read_token: token })
     });
     const data = await res.json();
     if (data.success) {
@@ -393,10 +413,12 @@ async function completeItem(id, type) {
 
 async function moveItem(id, direction) {
   try {
+    const type = direction === 'to_followup' ? 'reminder' : 'followup';
+    const { token } = await fetchReadToken(id, type);
     const res = await fetch('/api/ops/move', {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ id, direction })
+      body: JSON.stringify({ id, direction, read_token: token })
     });
     const data = await res.json();
     if (data.success) {
@@ -428,7 +450,8 @@ function deleteItem(id, type) {
   pendingConfirmAction = async () => {
     try {
       const url = type === 'reminder' ? '/api/reminders/' + id : '/api/followups/' + id;
-      const res = await fetch(url, { method: 'DELETE' });
+      const { token } = await fetchReadToken(id, type);
+      const res = await fetch(url + '?read_token=' + encodeURIComponent(token), { method: 'DELETE' });
       const data = await res.json();
       if (data.success) {
         opsToast('Marked ' + id + ' as deleted');
@@ -462,6 +485,7 @@ function openCreate(type) {
   form.reset();
   document.getElementById('modal-type').value = type;
   document.getElementById('modal-edit-id').value = '';
+  document.getElementById('modal-read-token').value = '';
   document.getElementById('modal-title').textContent = type === 'reminder' ? 'New Reminder' : 'New Followup';
   document.getElementById('modal-submit-btn').textContent = 'Create';
   document.getElementById('category-group').classList.toggle('hidden', type !== 'reminder');
@@ -470,17 +494,23 @@ function openCreate(type) {
   document.getElementById('ops-modal').classList.remove('hidden');
 }
 
-function editItem(id, type) {
-  const source = type === 'reminder' ? allReminders : allFollowups;
-  const item = source.find(i => i.id === id);
-  if (!item) return;
-
+async function editItem(id, type) {
+  let item;
+  try {
+    const detail = await fetchReadToken(id, type);
+    item = detail.item;
+    document.getElementById('modal-read-token').value = detail.token;
+  } catch (err) {
+    opsToast('Read history failed: ' + err.message, 'error');
+    return;
+  }
   const form = document.getElementById('modal-form');
   form.reset();
   document.getElementById('modal-type').value = type;
   document.getElementById('modal-edit-id').value = id;
   document.getElementById('modal-title').textContent = 'Edit ' + id;
   document.getElementById('modal-submit-btn').textContent = 'Save';
+  document.getElementById('modal-read-token').value = item.read_token || '';
   document.getElementById('category-group').classList.toggle('hidden', type !== 'reminder');
   document.getElementById('verification-group').classList.toggle('hidden', type !== 'followup');
   document.getElementById('reasoning-group').classList.toggle('hidden', type !== 'followup');
@@ -500,6 +530,7 @@ function editItem(id, type) {
 
 function closeModal() {
   document.getElementById('ops-modal').classList.add('hidden');
+  document.getElementById('modal-read-token').value = '';
 }
 
 async function submitForm(e) {
@@ -509,6 +540,7 @@ async function submitForm(e) {
   const type = fd.get('type');
   const editId = fd.get('edit_id');
   const isEdit = !!editId;
+  const readToken = fd.get('read_token');
 
   let url, method, body;
 
@@ -530,6 +562,9 @@ async function submitForm(e) {
       reasoning: fd.get('reasoning') || null
     };
   }
+  if (isEdit) {
+    body.read_token = readToken || '';
+  }
 
   try {
     const res = await fetch(url, {

package/src/db/__init__.py

@@ -3,8 +3,55 @@
 This package replaces the monolithic db.py. All public functions are
 re-exported here for full backwards compatibility:
     from db import get_db, create_learning, ...
+
+Important:
+`importlib.reload(db)` must also refresh the concrete submodules. The test
+suite and several runtime repair flows rely on switching database paths or
+runtime roots mid-process. If the package only re-exported functions from
+already-imported submodules, those callables would keep pointing at stale
+module state (especially old `db._core` connection globals).
 """
 
+from __future__ import annotations
+
+import importlib
+import sys
+
+
+def _load_submodule(name: str):
+    """Import or reload a db submodule and expose it on the package."""
+    module = sys.modules.get(name)
+    if module is None:
+        return importlib.import_module(name)
+    return importlib.reload(module)
+
+
+def _module(name: str):
+    module = sys.modules.get(name)
+    if module is None:
+        module = importlib.import_module(name)
+    return module
+
+
+_core = _load_submodule("db._core")
+_fts = _load_submodule("db._fts")
+_schema = _load_submodule("db._schema")
+_sessions = _load_submodule("db._sessions")
+_reminders = _load_submodule("db._reminders")
+_learnings = _load_submodule("db._learnings")
+_credentials = _load_submodule("db._credentials")
+_tasks = _load_submodule("db._tasks")
+_entities = _load_submodule("db._entities")
+_episodic = _load_submodule("db._episodic")
+_evolution = _load_submodule("db._evolution")
+_cron_runs = _load_submodule("db._cron_runs")
+_protocol = _load_submodule("db._protocol")
+_workflow = _load_submodule("db._workflow")
+_watchers = _load_submodule("db._watchers")
+_personal_scripts = _load_submodule("db._personal_scripts")
+_skills = _load_submodule("db._skills")
+_hot_context = _load_submodule("db._hot_context")
+
 # Core: connection, constants, init, utils
 from db._core import (
     DB_PATH, SESSION_STALE_SECONDS, MESSAGE_TTL_SECONDS, QUESTION_TTL_SECONDS,
@@ -139,3 +186,38 @@ from db._skills import (
     collect_skill_improvement_candidates, materialize_personal_skill_definition,
     get_skill_health_report,
 )
+
+# Hot context / recent continuity
+from db._hot_context import (
+    DEFAULT_CONTEXT_TTL_HOURS,
+    derive_context_key, clamp_ttl_hours,
+    cleanup_expired_hot_context,
+    remember_hot_context, record_recent_event, capture_context_event,
+    get_hot_context, search_hot_context, search_recent_events,
+    build_pre_action_context, format_pre_action_context_bundle,
+    resolve_hot_context,
+)
+
+
+def get_db():
+    return _module("db._core").get_db()
+
+
+def close_db():
+    return _module("db._core").close_db()
+
+
+def init_db():
+    return _module("db._core").init_db()
+
+
+def now_epoch():
+    return _module("db._core").now_epoch()
+
+
+def run_migrations():
+    return _module("db._schema").run_migrations()
+
+
+def get_schema_version():
+    return _module("db._schema").get_schema_version()