nexo-brain 7.15.1 → 7.16.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "7.15.1",
+  "version": "7.16.0",
   "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,11 @@
 
 [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.15.1` is the current packaged-runtime line. Patch release over v7.15.0 - Brain drains larger self-audit clusters, bounds hook history with update-time cleanup, filters normal Codex bootstrap reads, routes email-monitor effort by message complexity, and locks morning briefings by local date and recipient.
+Version `7.16.0` is the current packaged-runtime line. Minor release over v7.15.2 - Brain adds Memory Observations v2: evidence-backed event capture, derived observations, update-safe backfill, MCP retrieval, dashboard visibility, and safer refusal when memory lacks evidence.
+
+Previously in `7.15.2`: patch release over v7.15.1 - Brain treats normal Codex startup context reads of calibration and project atlas files as healthy bootstrap activity instead of conditioned-file drift.
+
+Previously in `7.15.1`: patch release over v7.15.0 - Brain drains larger self-audit clusters, bounds hook history with update-time cleanup, filters normal Codex bootstrap reads, routes email-monitor effort by message complexity, and locks morning briefings by local date and recipient.
 
 Previously in `7.15.0`: minor release — Brain unifies sent-email continuity across send paths, moves cognitive recall to multilingual embeddings, forces tagged learnings into context, hardens email loop guards and headless runners, exposes learning creation dates, and adds AUTO-N burst postmortems.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "7.15.1",
+  "version": "7.16.0",
   "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/dashboard/app.py

@@ -704,6 +704,77 @@ async def api_memories(
     return {"query": q, "store": store, "count": len(serialized), "results": serialized}
 
 
+@app.get("/api/memory/observations")
+async def api_memory_observations(
+    q: str = Query("", description="Search query"),
+    observation_type: str = Query("", description="Filter by observation type"),
+    project_key: str = Query("", description="Filter by project key"),
+    limit: int = Query(20, ge=1, le=100),
+):
+    """Operational view of Memory Observations v2."""
+    db = _db()
+    try:
+        queue_result = db.process_memory_observation_queue(limit=50)
+    except Exception as exc:
+        queue_result = {"ok": False, "error": str(exc)}
+    observations = db.list_memory_observations(
+        query=q,
+        observation_type=observation_type,
+        project_key=project_key,
+        limit=limit,
+    )
+    events = db.list_memory_events(
+        query=q,
+        project_key=project_key,
+        limit=min(limit, 50),
+    )
+    return {
+        "query": q,
+        "observation_type": observation_type,
+        "project_key": project_key,
+        "count": len(observations),
+        "event_count": len(events),
+        "queue": queue_result,
+        "stats": db.memory_observation_stats(days=7),
+        "event_stats": db.memory_event_stats(days=7),
+        "observations": observations,
+        "events": events,
+    }
+
+
+@app.get("/api/memory/search-v2")
+async def api_memory_search_v2(
+    query: str = Query("", description="Search query"),
+    project_hint: str = Query("", description="Project hint"),
+    time_range: str = Query("", description="today, yesterday, anteayer, last N h/d"),
+    depth: str = Query("brief", description="brief, timeline, evidence, or raw"),
+    limit: int = Query(10, ge=1, le=50),
+):
+    """Evidence-first Memory Observations v2 search."""
+    if not query:
+        return {"query": query, "count": 0, "candidates": [], "has_evidence": False}
+    from memory_retrieval import memory_search
+
+    return memory_search(
+        query,
+        project_hint=project_hint,
+        time_range=time_range,
+        depth=depth,
+        limit=limit,
+    )
+
+
+@app.post("/api/memory/backfill")
+async def api_memory_backfill(
+    sources: str = Query("", description="Comma-separated source list"),
+    limit: int = Query(100, ge=1, le=1000),
+):
+    """Run idempotent Memory Observations v2 backfill from durable Brain tables."""
+    requested = [item.strip() for item in (sources or "").split(",") if item.strip()]
+    result = _db().backfill_memory_observations(sources=requested or None, limit=limit)
+    return result
+
+
 @app.get("/api/somatic")
 async def api_somatic():
     """Somatic marker risk scores."""

package/src/dashboard/templates/memory.html

@@ -167,6 +167,70 @@
   </div>
 </div>
 
+<!-- Memory Observations -->
+<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-sky-400 glow-dot" style="color:#38bdf8"></span>
+        Memory Observations
+      </h2>
+      <p class="text-xs text-slate-600 mt-1">Evidence-backed operational memory captured from tasks, edits, and durable context.</p>
+    </div>
+    <div class="flex flex-wrap items-center gap-2">
+      <input type="text" id="obs-query" placeholder="Search observations..."
+        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-sky-500 w-56"
+        onkeydown="if(event.key==='Enter')loadMemoryObservations()">
+      <input type="text" id="obs-project" placeholder="Project"
+        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-sky-500 w-32"
+        onkeydown="if(event.key==='Enter')loadMemoryObservations()">
+      <button onclick="loadMemoryObservations()" class="px-3 py-1.5 text-xs bg-sky-600 text-white rounded-lg hover:bg-sky-500 transition-colors font-medium">Refresh</button>
+      <button onclick="runMemoryBackfill()" class="px-3 py-1.5 text-xs bg-slate-800 text-slate-200 border border-slate-700 rounded-lg hover:bg-slate-700 transition-colors font-medium">Backfill</button>
+    </div>
+  </div>
+
+  <div class="grid grid-cols-2 md:grid-cols-4 gap-3 mb-4">
+    <div class="bg-slate-900/50 border border-slate-800/60 rounded-xl p-3">
+      <div class="text-[10px] uppercase tracking-wider text-slate-500">Observations</div>
+      <div class="text-2xl font-display font-bold text-sky-300" id="obs-count">--</div>
+    </div>
+    <div class="bg-slate-900/50 border border-slate-800/60 rounded-xl p-3">
+      <div class="text-[10px] uppercase tracking-wider text-slate-500">Raw Events</div>
+      <div class="text-2xl font-display font-bold text-violet-300" id="obs-event-count">--</div>
+    </div>
+    <div class="bg-slate-900/50 border border-slate-800/60 rounded-xl p-3">
+      <div class="text-[10px] uppercase tracking-wider text-slate-500">Queue Pending</div>
+      <div class="text-2xl font-display font-bold text-amber-300" id="obs-queue-count">--</div>
+    </div>
+    <div class="bg-slate-900/50 border border-slate-800/60 rounded-xl p-3">
+      <div class="text-[10px] uppercase tracking-wider text-slate-500">Last Process</div>
+      <div class="text-2xl font-display font-bold text-emerald-300" id="obs-processed-count">--</div>
+    </div>
+  </div>
+
+  <div class="grid grid-cols-1 xl:grid-cols-2 gap-5">
+    <div class="bg-sky-500/5 border border-sky-500/20 rounded-xl p-4">
+      <div class="flex items-center justify-between mb-3">
+        <div class="text-xs uppercase tracking-wider text-sky-400 font-semibold">Observations</div>
+        <div class="text-[10px] text-slate-500 font-mono" id="obs-list-count">--</div>
+      </div>
+      <div class="space-y-2" id="obs-list">
+        <div class="text-xs text-slate-600 text-center py-6">Loading...</div>
+      </div>
+    </div>
+
+    <div class="bg-violet-500/5 border border-violet-500/20 rounded-xl p-4">
+      <div class="flex items-center justify-between mb-3">
+        <div class="text-xs uppercase tracking-wider text-violet-400 font-semibold">Evidence Events</div>
+        <div class="text-[10px] text-slate-500 font-mono" id="obs-raw-count">--</div>
+      </div>
+      <div class="space-y-2" id="obs-events">
+        <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 -->
@@ -313,6 +377,41 @@
     </div>`;
   }
 
+  function renderObservationCard(item) {
+    const refs = item.evidence_refs || [];
+    const entities = item.entities || [];
+    const created = item.created_at ? recentTime(item.created_at) : '';
+    const score = item.salience != null ? Number(item.salience).toFixed(2) : '--';
+    return `<div class="bg-slate-900/50 border border-sky-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-sky-500/10 text-sky-400 font-medium">${escapeHtml(item.observation_type || 'observation')}</span>
+        ${item.project_key ? `<span class="text-[10px] px-1.5 py-0.5 rounded bg-slate-800 text-slate-500">${escapeHtml(item.project_key)}</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(item.summary || '')}</div>
+      <div class="flex items-center gap-2 mt-2 flex-wrap">
+        <span class="text-[10px] text-slate-600 font-mono">score ${escapeHtml(score)}</span>
+        ${entities.slice(0, 3).map(e => `<span class="text-[10px] px-1.5 py-0.5 rounded bg-slate-800 text-slate-500">${escapeHtml(e)}</span>`).join('')}
+      </div>
+      <div class="text-[10px] text-slate-600 font-mono mt-2 break-all">${escapeHtml(refs.slice(0, 3).join(' | '))}</div>
+    </div>`;
+  }
+
+  function renderMemoryEventCard(item) {
+    const created = item.created_at ? recentTime(item.created_at) : '';
+    const paths = item.file_paths || [];
+    const source = `${item.source_type || '?'}:${item.source_id || ''}`;
+    return `<div class="bg-slate-900/50 border border-violet-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-violet-500/10 text-violet-400 font-medium">${escapeHtml(item.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(source)}</div>
+      ${paths.length ? `<div class="text-xs text-slate-500 mt-2">${escapeHtml(paths.slice(0, 4).join(', '))}</div>` : ''}
+      <div class="text-[10px] text-slate-600 font-mono mt-2 break-all">${escapeHtml(item.event_uid || '')}</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)}` : '');
@@ -332,6 +431,45 @@
       : events.map(renderHotEventCard).join('');
   }
 
+  async function loadMemoryObservations() {
+    const q = document.getElementById('obs-query').value.trim();
+    const project = document.getElementById('obs-project').value.trim();
+    const url = '/api/memory/observations?limit=12'
+      + (q ? `&q=${encodeURIComponent(q)}` : '')
+      + (project ? `&project_key=${encodeURIComponent(project)}` : '');
+    const data = await fetchJSON(url);
+    if (!data) return;
+
+    const stats = data.stats || {};
+    const queue = stats.queue || {};
+    const processed = (data.queue && data.queue.processed) || 0;
+    const observations = data.observations || [];
+    const events = data.events || [];
+    document.getElementById('obs-count').textContent = formatNumber(stats.total || observations.length);
+    document.getElementById('obs-event-count').textContent = formatNumber((data.event_stats && data.event_stats.total) || events.length);
+    document.getElementById('obs-queue-count').textContent = formatNumber(queue.pending || 0);
+    document.getElementById('obs-processed-count').textContent = formatNumber(processed);
+    document.getElementById('obs-list-count').textContent = formatNumber(observations.length);
+    document.getElementById('obs-raw-count').textContent = formatNumber(events.length);
+    document.getElementById('obs-list').innerHTML = observations.length === 0
+      ? '<div class="text-xs text-slate-600 text-center py-6">No observations found</div>'
+      : observations.map(renderObservationCard).join('');
+    document.getElementById('obs-events').innerHTML = events.length === 0
+      ? '<div class="text-xs text-slate-600 text-center py-6">No evidence events found</div>'
+      : events.map(renderMemoryEventCard).join('');
+  }
+
+  async function runMemoryBackfill() {
+    const res = await fetch('/api/memory/backfill?sources=protocol_tasks,change_log,session_diary,recent_events&limit=200', { method: 'POST' });
+    if (!res.ok) {
+      showToast('Backfill failed');
+      return;
+    }
+    const data = await res.json();
+    showToast(`Backfill ${data.created_or_updated || 0}/${data.seen || 0}`);
+    loadMemoryObservations();
+  }
+
   async function loadFlow() {
     const data = await fetchJSON('/api/memory/flow');
     if (!data) return;
@@ -413,8 +551,10 @@
 
   // Init
   loadRecentContext();
+  loadMemoryObservations();
   loadFlow();
   setInterval(loadRecentContext, REFRESH_MS);
+  setInterval(loadMemoryObservations, REFRESH_MS);
   setInterval(loadFlow, REFRESH_MS);
 </script>
 {% endblock %}

package/src/db/__init__.py

@@ -55,6 +55,7 @@ _drive = _load_submodule("db._drive")
 _outcomes = _load_submodule("db._outcomes")
 _goal_profiles = _load_submodule("db._goal_profiles")
 _continuity = _load_submodule("db._continuity")
+_memory_v2 = _load_submodule("db._memory_v2")
 
 # Core: connection, constants, init, utils
 from db._core import (
@@ -93,6 +94,21 @@ from db._continuity import (
     latest_continuity_snapshot,
 )
 
+from db._memory_v2 import (
+    build_memory_event_uid,
+    record_memory_event,
+    list_memory_events,
+    memory_event_stats,
+    upsert_memory_observation,
+    process_memory_observation_queue,
+    list_memory_observations,
+    search_memory_observations_fts,
+    backfill_memory_observations,
+    memory_observation_health,
+    maintain_memory_observations,
+    memory_observation_stats,
+)
+
 # PostToolUse inbox-reminder rate limit (v6.0.1)
 _hook_inbox_reminders = _load_submodule("db._hook_inbox_reminders")
 from db._hook_inbox_reminders import (