code-context-control 2.37.0__tar.gz → 2.38.1__tar.gz

{code_context_control-2.37.0/code_context_control.egg-info → code_context_control-2.38.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-context-control
-Version: 2.37.0
+Version: 2.38.1
 Summary: Local code-intelligence layer for AI coding tools (Claude Code, Codex, Gemini, Copilot). Retrieve less, read less, edit safer.
 Author-email: Dimitri Tselenchuk <dtselenc@gmail.com>
 License-Expression: Apache-2.0
@@ -334,6 +334,10 @@ Only **read** and **safe-action** tools are exposed (no code editing); requests
 default. Generate, rotate, and copy the token from the dashboard's **Settings →
 Discovery API** tab. See the [Oracle Discovery API guide](oracle-guide/discovery-api.md).
 
+As of v2.38.0 the Oracle also reports a **cross-project activity digest** — sessions,
+tool calls, edits, git mutations, and token/cost for a day — via the `activity_report`
+discovery tool, the `GET /api/activity/digest` endpoint, and the dashboard's **Activity** tab.
+
 ---
 
 ## Tiered local AI (optional)

{code_context_control-2.37.0 → code_context_control-2.38.1}/README.md

@@ -272,6 +272,10 @@ Only **read** and **safe-action** tools are exposed (no code editing); requests
 default. Generate, rotate, and copy the token from the dashboard's **Settings →
 Discovery API** tab. See the [Oracle Discovery API guide](oracle-guide/discovery-api.md).
 
+As of v2.38.0 the Oracle also reports a **cross-project activity digest** — sessions,
+tool calls, edits, git mutations, and token/cost for a day — via the `activity_report`
+discovery tool, the `GET /api/activity/digest` endpoint, and the dashboard's **Activity** tab.
+
 ---
 
 ## Tiered local AI (optional)

{code_context_control-2.37.0 → code_context_control-2.38.1}/cli/c3.py

@@ -85,7 +85,7 @@ console = Console() if HAS_RICH else None
 # Config
 CONFIG_DIR = ".c3"
 CONFIG_FILE = ".c3/config.json"
-__version__ = "2.37.0"
+__version__ = "2.38.1"
 
 
 def _command_deps() -> CommandDeps:

{code_context_control-2.37.0 → code_context_control-2.38.1}/cli/guide/oracle.html

@@ -269,6 +269,7 @@ curl -X POST \
           <tr><td class="grp-read"><code>c3_status</code></td>       <td>Project health / budget / sessions overview</td></tr>
           <tr><td class="grp-read"><code>c3_memory_query</code></td> <td>Read-only memory query (recall/list/score/graph/trends)</td></tr>
           <tr><td class="grp-read"><code>c3_edits</code> / <code>c3_edits_cross</code></td><td>Query the edit ledger (one / all projects)</td></tr>
+          <tr><td class="grp-read"><code>activity_report</code></td><td>Cross-project daily digest: sessions, tool calls, edits, git mutations, token/cost (optional LLM narration)</td></tr>
         </tbody>
       </table>
 

{code_context_control-2.37.0 → code_context_control-2.38.1}/cli/mcp_server.py

@@ -120,12 +120,19 @@ async def lifespan(server):
                 services.indexer.build_index()
             except Exception:
                 pass
-            # After code index is built, build embedding index
-            if services.embedding_index and services.embedding_index.ready:
+            # After code index is built, build embedding index. build() lazily
+            # inits its chromadb/ollama backends, kept off the handshake path.
+            if services.embedding_index:
                 try:
                     services.embedding_index.build(services.indexer)
                 except Exception:
                     pass
+            # Warm SLTM vector store so the first memory call isn't slow.
+            if services.vector_store:
+                try:
+                    services.vector_store.warm()
+                except Exception:
+                    pass
             # Build doc index for Local RAG Pipeline
             if services.doc_index:
                 try:
@@ -136,15 +143,23 @@ async def lifespan(server):
         threading.Thread(target=_bg_build, daemon=True, name="c3-initial-index").start()
     else:
         services.indexer._load_index()
-        # Build/update embedding index in background
-        if services.embedding_index and services.embedding_index.ready:
+        # Build/update embedding index + warm SLTM in background. Deferred off
+        # the handshake path: build()/warm() lazily init the heavy backends, so
+        # this must NOT gate on .ready synchronously here.
+        if services.embedding_index or services.vector_store:
             import threading
 
             def _bg_embed():
-                try:
-                    services.embedding_index.build(services.indexer)
-                except Exception:
-                    pass
+                if services.embedding_index:
+                    try:
+                        services.embedding_index.build(services.indexer)
+                    except Exception:
+                        pass
+                if services.vector_store:
+                    try:
+                        services.vector_store.warm()
+                    except Exception:
+                        pass
 
             threading.Thread(target=_bg_embed, daemon=True, name="c3-embed-index").start()
 

{code_context_control-2.37.0 → code_context_control-2.38.1/code_context_control.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-context-control
-Version: 2.37.0
+Version: 2.38.1
 Summary: Local code-intelligence layer for AI coding tools (Claude Code, Codex, Gemini, Copilot). Retrieve less, read less, edit safer.
 Author-email: Dimitri Tselenchuk <dtselenc@gmail.com>
 License-Expression: Apache-2.0
@@ -334,6 +334,10 @@ Only **read** and **safe-action** tools are exposed (no code editing); requests
 default. Generate, rotate, and copy the token from the dashboard's **Settings →
 Discovery API** tab. See the [Oracle Discovery API guide](oracle-guide/discovery-api.md).
 
+As of v2.38.0 the Oracle also reports a **cross-project activity digest** — sessions,
+tool calls, edits, git mutations, and token/cost for a day — via the `activity_report`
+discovery tool, the `GET /api/activity/digest` endpoint, and the dashboard's **Activity** tab.
+
 ---
 
 ## Tiered local AI (optional)

{code_context_control-2.37.0 → code_context_control-2.38.1}/code_context_control.egg-info/SOURCES.txt

@@ -84,6 +84,7 @@ oracle/mcp_oracle.py
 oracle/oracle.html
 oracle/oracle_server.py
 oracle/services/__init__.py
+oracle/services/activity_reporter.py
 oracle/services/api_auth.py
 oracle/services/c3_bridge.py
 oracle/services/chat_engine.py
@@ -153,6 +154,7 @@ services/bench/__init__.py
 services/bench/external/__init__.py
 services/bench/external/aider_polyglot.py
 services/bench/external/swe_bench.py
+tests/test_activity_reporter.py
 tests/test_aider_polyglot.py
 tests/test_bitbucket_cli_smoke.py
 tests/test_bitbucket_client.py
@@ -169,6 +171,7 @@ tests/test_ghost_files.py
 tests/test_git_branch_awareness.py
 tests/test_hub_server_smoke.py
 tests/test_install_mcp_entrypoint.py
+tests/test_lazy_store_init.py
 tests/test_mcp_host_guard.py
 tests/test_mcp_server_smoke.py
 tests/test_mcp_toml.py

{code_context_control-2.37.0 → code_context_control-2.38.1}/oracle/oracle.html

@@ -841,6 +841,7 @@
   <div class="tab active" data-tab="chat">Chat</div>
   <div class="tab" data-tab="projects">Projects</div>
   <div class="tab" data-tab="insights">Insights</div>
+  <div class="tab" data-tab="activity">Activity</div>
   <div class="tab" data-tab="crossgraph">Cross-Graph</div>
   <div class="tab" data-tab="suggestions">Suggestions</div>
   <div class="tab" data-tab="agents">Team / Agents</div>
@@ -975,6 +976,27 @@
     <div id="insightsEmpty" class="empty" style="display:none">No insights yet. Click "Generate" with 2+ projects.</div>
   </div>
 
+  <!-- ── Activity ── -->
+  <div class="panel" id="panel-activity">
+    <div style="display:flex;justify-content:space-between;align-items:center;margin-bottom:16px;flex-wrap:wrap;gap:10px">
+      <div>
+        <h2 style="font-size:16px;font-weight:600">Activity Digest</h2>
+        <p style="font-size:12px;color:var(--text2);margin-top:4px">Cross-project sessions, tool calls, edits, git mutations and token/cost for one day (UTC).</p>
+      </div>
+      <div style="display:flex;gap:8px;align-items:center;flex-wrap:wrap">
+        <input type="date" id="actDate" style="padding:4px 6px" onchange="loadActivity()">
+        <label style="font-size:11px;color:var(--text2);display:flex;align-items:center;gap:6px">
+          <input type="checkbox" id="actNarrate"> Narrate
+        </label>
+        <button class="btn btn-primary btn-sm" id="btnLoadActivity" onclick="loadActivity()">Refresh</button>
+      </div>
+    </div>
+    <div id="actSummary" style="display:flex;gap:10px;flex-wrap:wrap;margin-bottom:14px"></div>
+    <div id="actNarrative" class="card" style="display:none;margin-bottom:14px"></div>
+    <div id="actProjects"></div>
+    <div id="actEmpty" class="empty" style="display:none">No activity recorded for this day.</div>
+  </div>
+
   <!-- ── Cross-Graph ── -->
   <div class="panel" id="panel-crossgraph">
     <div style="display:flex;justify-content:space-between;align-items:center;margin-bottom:12px;flex-wrap:wrap;gap:10px">
@@ -1279,6 +1301,9 @@ document.querySelectorAll('.tab').forEach(tab => {
     } else {
       mainEl.classList.remove('wide');
     }
+    if (tab.dataset.tab === 'activity' && !window._actLoaded) {
+      loadActivity(); window._actLoaded = true;
+    }
   });
 });
 
@@ -1899,6 +1924,89 @@ async function dismissInsight(id) {
   }, { successMsg: 'Insight dismissed', silent: false });
 }
 
+// ═══════════════════════════════════════════════════════════
+// ── Activity Digest ──
+// ═══════════════════════════════════════════════════════════
+async function loadActivity() {
+  const dateEl = document.getElementById('actDate');
+  if (dateEl && !dateEl.value) dateEl.value = new Date().toISOString().slice(0, 10);
+  const date = dateEl ? dateEl.value : '';
+  const narrate = document.getElementById('actNarrate')?.checked ? 'true' : 'false';
+  const btn = document.getElementById('btnLoadActivity');
+  if (btn) btn.disabled = true;
+  try {
+    const qs = new URLSearchParams({ date, narrate }).toString();
+    renderActivity(await api('/api/activity/digest?' + qs));
+  } catch (e) {
+    renderActivity({ error: (e && e.message) || 'Failed to load activity.' });
+  } finally {
+    if (btn) btn.disabled = false;
+  }
+}
+
+function _actCard(label, value) {
+  return `<div class="card" style="flex:1;min-width:110px;text-align:center">
+    <div style="font-size:22px;font-weight:700">${value}</div>
+    <div style="font-size:11px;color:var(--text2);text-transform:uppercase;letter-spacing:.04em">${label}</div>
+  </div>`;
+}
+
+function renderActivity(data) {
+  const summary = document.getElementById('actSummary');
+  const projects = document.getElementById('actProjects');
+  const empty = document.getElementById('actEmpty');
+  const narrEl = document.getElementById('actNarrative');
+  if (!data || data.error) {
+    summary.innerHTML = ''; projects.innerHTML = ''; narrEl.style.display = 'none';
+    empty.style.display = ''; empty.textContent = (data && data.error) || 'Failed to load activity.';
+    return;
+  }
+  const t = data.totals || {};
+  summary.innerHTML = [
+    _actCard('Projects', t.projects_active || 0),
+    _actCard('Sessions', t.sessions || 0),
+    _actCard('Tool Calls', t.tool_calls || 0),
+    _actCard('Edits', t.edits || 0),
+    _actCard('Git', t.git_mutations || 0),
+    _actCard('Cost $', (t.cost_usd || 0).toFixed(2)),
+  ].join('');
+
+  if (data.narrative) {
+    narrEl.style.display = '';
+    narrEl.innerHTML = `<div style="font-size:11px;color:var(--text2);text-transform:uppercase;margin-bottom:6px">${esc(data.window && data.window.label || '')}</div>
+      <p style="font-size:13px;line-height:1.6;white-space:pre-wrap">${esc(data.narrative)}</p>`;
+  } else {
+    narrEl.style.display = 'none';
+  }
+
+  const rows = data.projects || [];
+  if (!rows.length) {
+    projects.innerHTML = ''; empty.style.display = '';
+    empty.textContent = 'No activity recorded for ' + (data.window && data.window.label || 'this day') + '.';
+    return;
+  }
+  empty.style.display = 'none';
+  projects.innerHTML = `
+    <table style="width:100%;border-collapse:collapse;font-size:13px">
+      <thead><tr style="text-align:left;color:var(--text2);font-size:11px;text-transform:uppercase">
+        <th style="padding:6px">Project</th><th style="padding:6px">Sessions</th>
+        <th style="padding:6px">Tools</th><th style="padding:6px">Edits</th>
+        <th style="padding:6px">Git</th><th style="padding:6px">Tokens</th>
+        <th style="padding:6px">Cost $</th><th style="padding:6px">Last activity</th>
+      </tr></thead>
+      <tbody>${rows.map(p => `<tr style="border-top:1px solid var(--border)">
+        <td style="padding:6px;font-weight:600">${esc(p.name)}</td>
+        <td style="padding:6px">${(p.sessions || []).length}</td>
+        <td style="padding:6px">${p.tool_calls || 0}</td>
+        <td style="padding:6px">${p.edits || 0}</td>
+        <td style="padding:6px">${p.git_mutations || 0}</td>
+        <td style="padding:6px">${(((p.tokens || {}).input || 0) + ((p.tokens || {}).output || 0)).toLocaleString()}</td>
+        <td style="padding:6px">${(p.cost_usd || 0).toFixed(2)}</td>
+        <td style="padding:6px;color:var(--text2);font-size:11px">${esc((p.last_activity || '').replace('T', ' ').slice(0, 19))}</td>
+      </tr>`).join('')}</tbody>
+    </table>`;
+}
+
 // ═══════════════════════════════════════════════════════════
 // ── Suggestions ──
 // ═══════════════════════════════════════════════════════════

{code_context_control-2.37.0 → code_context_control-2.38.1}/oracle/oracle_server.py

@@ -21,6 +21,7 @@ from flask import Flask, Response, jsonify, request, send_from_directory  # noqa
 from oracle.config import ORACLE_DIR, load_config, save_config  # noqa: E402
 from oracle.mcp_oracle import mcp_url, start_mcp_thread  # noqa: E402
 from oracle.services import api_auth  # noqa: E402
+from oracle.services.activity_reporter import ActivityReporter  # noqa: E402
 from oracle.services.api_auth import extract_bearer  # noqa: E402
 from oracle.services.api_auth import verify as verify_api_key  # noqa: E402
 from oracle.services.c3_bridge import C3Bridge  # noqa: E402
@@ -57,10 +58,11 @@ _chat_engine: ChatEngine | None = None
 _c3_bridge: C3Bridge | None = None
 _federated: FederatedGraph | None = None
 _tool_registry: ToolRegistry | None = None
+_activity_reporter: ActivityReporter | None = None
 
 
 def _init_services():
-    global _cfg, _bridge, _scanner, _reader, _checker, _writer, _cross_memory, _engine, _agent, _model_verified, _chat_store, _chat_engine, _c3_bridge, _federated, _tool_registry
+    global _cfg, _bridge, _scanner, _reader, _checker, _writer, _cross_memory, _engine, _agent, _model_verified, _chat_store, _chat_engine, _c3_bridge, _federated, _tool_registry, _activity_reporter
     _cfg = load_config()
     _bridge = OllamaBridge(
         base_url=_cfg.get("ollama_base_url", "https://ollama.com"),
@@ -97,6 +99,7 @@ def _init_services():
         interval=int(_cfg.get("review_interval_seconds", 1800)),
         federated_graph=_federated,
     )
+    _activity_reporter = ActivityReporter(scanner=_scanner, ollama_bridge=_bridge)
     _chat_engine = ChatEngine(
         bridge=_bridge,
         reader=_reader,
@@ -107,6 +110,7 @@ def _init_services():
         scanner=_scanner,
         store=_chat_store,
         c3_bridge=_c3_bridge,
+        activity_reporter=_activity_reporter,
     )
     _tool_registry = ToolRegistry(
         ToolExecutor(_chat_engine),
@@ -608,6 +612,26 @@ def api_chat_conversation_state(conv_id):
     return jsonify({"state": _chat_store.get_state(conv_id)})
 
 
+# ── Activity digest (Oracle UI) ───────────────────────────
+@app.route("/api/activity/digest", methods=["GET"])
+def api_activity_digest():
+    """Cross-project activity digest for the Oracle UI.
+
+    Query params: date=YYYY-MM-DD, since, until, project (single-project path),
+    narrate=true|false. Defaults to today (UTC) across all registered projects.
+    """
+    if not _activity_reporter:
+        return jsonify({"error": "not initialized"}), 500
+    narrate = str(request.args.get("narrate", "")).lower() in ("1", "true", "yes", "on")
+    return jsonify(_activity_reporter.report(
+        date=request.args.get("date", ""),
+        since=request.args.get("since", ""),
+        until=request.args.get("until", ""),
+        project_path=request.args.get("project", ""),
+        narrate=narrate,
+    ))
+
+
 # ── Discovery API (external LLM tool surface) ─────────────
 @app.route("/api/discovery/tools", methods=["GET"])
 def api_discovery_tools():
@@ -801,8 +825,19 @@ def _is_oracle_running(port: int) -> bool:
         return False
 
 
+def _force_utf8_console() -> None:
+    """Make stdout/stderr UTF-8 so banner/log output can't crash on legacy
+    Windows code pages (cp1252 raises UnicodeEncodeError on chars like '→')."""
+    for stream in (sys.stdout, sys.stderr):
+        try:
+            stream.reconfigure(encoding="utf-8", errors="replace")
+        except (AttributeError, ValueError, OSError):
+            pass
+
+
 def run_oracle(port: int = None, open_browser: bool = None):
     """Main entry point for Oracle server."""
+    _force_utf8_console()
     _init_services()
 
     cfg = load_config()

code_context_control-2.38.1/oracle/services/activity_reporter.py

@@ -0,0 +1,256 @@
+"""Cross-project activity reporting for the Oracle.
+
+Aggregates per-project C3 activity (sessions, tool calls, edits, git mutations,
+token/cost) into a single daily digest.  Reads the same ``.c3`` JSONL artifacts
+the local UI uses, directly per project — no C3Runtime build required (mirrors
+how ``MemoryReader`` / ``ProjectManager`` read project data straight off disk).
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+from datetime import datetime, timezone
+from pathlib import Path
+
+from services.activity_log import ActivityLog
+from services.edit_ledger import EditLedger
+from services.session_manager import SessionManager
+
+log = logging.getLogger("oracle")
+
+# Lexicographic sentinels for an open-ended window (ISO-8601 keeps string order).
+_MIN_TS = "0000-01-01T00:00:00"
+_MAX_TS = "9999-12-31T23:59:59"
+
+_NARRATE_SYSTEM = (
+    "You are C3's activity reporter. Given a JSON digest of a developer's work "
+    "across their projects for a time window, write a concise, friendly summary "
+    "(3-6 sentences). Lead with the headline (busiest project and the totals), "
+    "then call out notable specifics. Use ONLY the numbers provided — never "
+    "invent data. If everything is zero, say it was a quiet period."
+)
+
+
+class ActivityReporter:
+    """Builds cross-project (or single-project) activity digests.
+
+    Construct with an Oracle ``ProjectScanner`` and, optionally, an
+    ``OllamaBridge`` for prose narration (``narrate=True``).
+    """
+
+    def __init__(self, scanner, ollama_bridge=None):
+        self.scanner = scanner
+        self.ollama_bridge = ollama_bridge
+
+    # ── Public API ───────────────────────────────────────────────
+
+    def report(self, date: str = "", since: str = "", until: str = "",
+               project_path: str = "", narrate: bool = False) -> dict:
+        """Aggregate activity into a digest dict.
+
+        date: UTC day ``YYYY-MM-DD`` (default today). since/until: ISO bounds
+        that override ``date``. project_path: limit to one project (else all
+        registered projects with a ``.c3`` dir). narrate: add an LLM prose
+        summary (best-effort; never fails the structured result).
+        """
+        lo, hi, window = self._resolve_window(date, since, until)
+
+        proj_reports = []
+        for proj in self._target_projects(project_path):
+            pr = self._report_project(proj, lo, hi)
+            if (pr["tool_calls"] or pr["edits"] or pr["git_mutations"]
+                    or pr["sessions"] or pr["decisions"]):
+                proj_reports.append(pr)
+
+        digest = {
+            "window": window,
+            "totals": self._aggregate_totals(proj_reports),
+            "projects": proj_reports,
+            "narrative": None,
+        }
+        if narrate:
+            digest["narrative"] = self._narrate(digest)
+        return digest
+
+    # ── Window resolution ────────────────────────────────────────
+
+    @staticmethod
+    def _resolve_window(date: str, since: str, until: str):
+        """Return (lo, hi, window_dict).
+
+        Bounds are naive (no tz suffix) on purpose: the date/time prefix
+        dominates lexicographically, so the same bounds correctly window both
+        naive ledger timestamps and tz-aware ``+00:00`` activity timestamps.
+        """
+        if since or until:
+            lo = since or _MIN_TS
+            hi = until or _MAX_TS
+            window = {
+                "since": since or None,
+                "until": until or None,
+                "label": f"{since or 'beginning'} → {until or 'now'}",
+                "tz": "as-given",
+            }
+            return lo, hi, window
+
+        day = date.strip() if date else datetime.now(timezone.utc).strftime("%Y-%m-%d")
+        lo = f"{day}T00:00:00"
+        hi = f"{day}T23:59:59.999999"
+        today = datetime.now(timezone.utc).strftime("%Y-%m-%d")
+        window = {
+            "since": lo,
+            "until": hi,
+            "label": f"{day}{' (today)' if day == today else ''}, UTC",
+            "tz": "UTC",
+        }
+        return lo, hi, window
+
+    # ── Project selection ────────────────────────────────────────
+
+    def _target_projects(self, project_path: str) -> list[dict]:
+        if project_path:
+            p = Path(project_path)
+            return [{"path": str(p), "name": p.name, "has_c3": (p / ".c3").is_dir()}]
+        return [p for p in self.scanner.discover() if p.get("has_c3")]
+
+    # ── Per-project aggregation ──────────────────────────────────
+
+    def _report_project(self, proj: dict, lo: str, hi: str) -> dict:
+        path = proj.get("path", "")
+        base = {
+            "name": proj.get("name") or Path(path).name,
+            "path": path,
+            "sessions": [],
+            "tool_calls": 0,
+            "edits": 0,
+            "git_mutations": 0,
+            "decisions": 0,
+            "events": {},
+            "tokens": {"input": 0, "output": 0},
+            "cost_usd": 0.0,
+            "first_activity": None,
+            "last_activity": None,
+        }
+        # Guard: only read projects that already have a .c3 dir — never create
+        # one as a side effect (ActivityLog/SessionManager mkdir on init).
+        if not path or not (Path(path) / ".c3").is_dir():
+            return base
+
+        timestamps: list[str] = []
+
+        # Activity log → per-type event counts.
+        try:
+            counts: dict[str, int] = {}
+            for e in ActivityLog(path).get_recent(limit=10000, since=lo, until=hi):
+                etype = e.get("type", "unknown")
+                counts[etype] = counts.get(etype, 0) + 1
+                if e.get("timestamp"):
+                    timestamps.append(e["timestamp"])
+            base["events"] = counts
+            base["tool_calls"] = counts.get("tool_call", 0)
+            base["decisions"] = counts.get("decision", 0)
+        except Exception as exc:  # pragma: no cover - defensive
+            log.debug("activity_log read failed for %s: %s", path, exc)
+
+        try:
+            sm = SessionManager(path)
+            # Sessions started within the window.
+            for s in sm.list_sessions(100):
+                started = s.get("started", "")
+                if started and lo <= started <= hi:
+                    base["sessions"].append({
+                        "id": s.get("id"),
+                        "started": started,
+                        "ended": s.get("ended", ""),
+                        "description": s.get("description", ""),
+                        "tool_calls": s.get("tool_calls", 0),
+                        "duration": s.get("duration", ""),
+                    })
+                    timestamps.append(started)
+            # Token / cost from hook-captured session stats.
+            for st in sm.get_session_stats(500):
+                ts = st.get("ts", "")
+                if ts and lo <= ts <= hi:
+                    base["tokens"]["input"] += int(st.get("input_tokens", 0) or 0)
+                    base["tokens"]["output"] += int(st.get("output_tokens", 0) or 0)
+                    base["cost_usd"] += float(st.get("cost_usd", 0) or 0)
+        except Exception as exc:  # pragma: no cover - defensive
+            log.debug("session read failed for %s: %s", path, exc)
+
+        # Edit ledger → edits vs git mutations (get_history filters >= lo only).
+        try:
+            for en in EditLedger(path).get_history(since=lo, limit=10000):
+                ts = en.get("timestamp", "")
+                if ts and ts > hi:
+                    continue
+                if en.get("change_type") == "shell_git":
+                    base["git_mutations"] += 1
+                else:
+                    base["edits"] += 1
+                if ts:
+                    timestamps.append(ts)
+        except Exception as exc:  # pragma: no cover - defensive
+            log.debug("edit ledger read failed for %s: %s", path, exc)
+
+        base["cost_usd"] = round(base["cost_usd"], 4)
+        if timestamps:
+            timestamps.sort()
+            base["first_activity"] = timestamps[0]
+            base["last_activity"] = timestamps[-1]
+        return base
+
+    @staticmethod
+    def _aggregate_totals(reports: list[dict]) -> dict:
+        totals = {
+            "projects_active": len(reports),
+            "sessions": 0,
+            "tool_calls": 0,
+            "edits": 0,
+            "git_mutations": 0,
+            "decisions": 0,
+            "input_tokens": 0,
+            "output_tokens": 0,
+            "cost_usd": 0.0,
+        }
+        for r in reports:
+            totals["sessions"] += len(r["sessions"])
+            totals["tool_calls"] += r["tool_calls"]
+            totals["edits"] += r["edits"]
+            totals["git_mutations"] += r["git_mutations"]
+            totals["decisions"] += r["decisions"]
+            totals["input_tokens"] += r["tokens"]["input"]
+            totals["output_tokens"] += r["tokens"]["output"]
+            totals["cost_usd"] += r["cost_usd"]
+        totals["cost_usd"] = round(totals["cost_usd"], 4)
+        return totals
+
+    # ── Narration (best-effort) ──────────────────────────────────
+
+    def _narrate(self, digest: dict) -> str | None:
+        if self.ollama_bridge is None:
+            digest["narrative_error"] = "No Ollama bridge configured."
+            return None
+        payload = {
+            "window": digest["window"]["label"],
+            "totals": digest["totals"],
+            "projects": [
+                {
+                    "name": p["name"],
+                    "tool_calls": p["tool_calls"],
+                    "edits": p["edits"],
+                    "git_mutations": p["git_mutations"],
+                    "sessions": len(p["sessions"]),
+                    "cost_usd": p["cost_usd"],
+                }
+                for p in digest["projects"]
+            ],
+        }
+        prompt = "Summarize this developer activity digest:\n\n" + json.dumps(payload, indent=2)
+        try:
+            text = self.ollama_bridge.generate(prompt, system=_NARRATE_SYSTEM)
+            return (text or "").strip() or None
+        except Exception as exc:
+            log.warning("activity narration failed: %s", exc)
+            digest["narrative_error"] = str(exc)
+            return None