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

{code_context_control-2.36.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.36.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
@@ -231,6 +231,8 @@ Every session you've ever run, with duration, decision count, file count, tool c
 
 Manage `CLAUDE.md`, `AGENTS.md` (Codex), `GEMINI.md`, and `.github/copilot-instructions.md` from one editor. Generate from project state, run a Health Check (drift detection vs the actual codebase), Compact stale sections, or Promote insights captured during sessions. **One source of truth** instead of four out-of-sync files.
 
+C3-generated content is wrapped in a `<!-- C3:BEGIN … -->` / `<!-- C3:END -->` block. Regenerating (or `Compact`) only rewrites that block — **anything you write outside it is preserved**, so it's safe to keep your own notes in the same file.
+
 ### 7. Chat — browse prior AI conversations
 
 <p align="center">
@@ -332,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)
@@ -370,6 +376,8 @@ c3 permissions show
 c3 permissions standard
 ```
 
+Applying or switching a tier **preserves your own `allow`/`deny` rules** (and keys like `ask`/`defaultMode`) — only C3-managed entries are replaced. Likewise, C3 never clobbers your other entries in `.mcp.json` (only its own `c3` server) or the hooks you've added to `settings.local.json` (only its own hooks).
+
 ---
 
 ## Benchmarks

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

@@ -169,6 +169,8 @@ Every session you've ever run, with duration, decision count, file count, tool c
 
 Manage `CLAUDE.md`, `AGENTS.md` (Codex), `GEMINI.md`, and `.github/copilot-instructions.md` from one editor. Generate from project state, run a Health Check (drift detection vs the actual codebase), Compact stale sections, or Promote insights captured during sessions. **One source of truth** instead of four out-of-sync files.
 
+C3-generated content is wrapped in a `<!-- C3:BEGIN … -->` / `<!-- C3:END -->` block. Regenerating (or `Compact`) only rewrites that block — **anything you write outside it is preserved**, so it's safe to keep your own notes in the same file.
+
 ### 7. Chat — browse prior AI conversations
 
 <p align="center">
@@ -270,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)
@@ -308,6 +314,8 @@ c3 permissions show
 c3 permissions standard
 ```
 
+Applying or switching a tier **preserves your own `allow`/`deny` rules** (and keys like `ask`/`defaultMode`) — only C3-managed entries are replaced. Likewise, C3 never clobbers your other entries in `.mcp.json` (only its own `c3` server) or the hooks you've added to `settings.local.json` (only its own hooks).
+
 ---
 
 ## Benchmarks

{code_context_control-2.36.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.36.0"
+__version__ = "2.38.1"
 
 
 def _command_deps() -> CommandDeps:
@@ -379,6 +379,44 @@ def _build_permission_tier(tier: str, include_mcp_wildcard: bool = False) -> dic
     }}
 
 
+def _c3_managed_permission_entries() -> tuple[set, set]:
+    """Return (allow, deny) sets of every entry any C3 tier can emit.
+
+    Used to tell C3-managed permission rules apart from user-added ones so a
+    tier change replaces only the former and preserves the latter.
+    """
+    managed_allow: set = set()
+    managed_deny: set = set()
+    for _tier in PERMISSION_TIERS:
+        perms = _build_permission_tier(_tier, include_mcp_wildcard=True)["permissions"]
+        managed_allow.update(perms.get("allow", []))
+        managed_deny.update(perms.get("deny", []))
+    return managed_allow, managed_deny
+
+
+def _merge_permission_tier(existing: dict, tier_perms: dict) -> dict:
+    """Merge a tier's permissions into existing ones, preserving user rules.
+
+    C3 owns every entry a tier can emit: those are replaced by the chosen tier.
+    Any other allow/deny entry the user added is kept, and non-list permission
+    keys (e.g. ``ask``, ``defaultMode``, ``additionalDirectories``) are left
+    untouched. Mirrors how hooks and .mcp.json preserve non-C3 content.
+    """
+    existing = existing if isinstance(existing, dict) else {}
+    managed = dict(zip(("allow", "deny"), _c3_managed_permission_entries()))
+    merged = dict(existing)  # preserve unknown sub-keys (ask, defaultMode, ...)
+    for key in ("allow", "deny"):
+        user_custom = [e for e in (existing.get(key) or []) if e not in managed[key]]
+        out: list = []
+        seen: set = set()
+        for entry in user_custom + list(tier_perms.get(key) or []):
+            if entry not in seen:
+                seen.add(entry)
+                out.append(entry)
+        merged[key] = out
+    return merged
+
+
 def _detect_current_tier(settings_path) -> str | None:
     """Detect which permission tier is active in settings_path, or None.
 
@@ -456,9 +494,12 @@ def _apply_permission_tier(project_path: str, tier: str,
     settings_path = Path(project_path) / ".claude" / "settings.local.json"
     settings_path.parent.mkdir(parents=True, exist_ok=True)
     settings = _safe_read_json(settings_path, str(settings_path))
-    settings["permissions"] = _build_permission_tier(
+    tier_perms = _build_permission_tier(
         tier, include_mcp_wildcard=include_mcp_wildcard
     )["permissions"]
+    settings["permissions"] = _merge_permission_tier(
+        settings.get("permissions") or {}, tier_perms
+    )
     # Persist chosen tier in .c3/config.json
     c3_config_path = Path(project_path) / ".c3" / "config.json"
     c3_config = _safe_read_json(c3_config_path, str(c3_config_path))
@@ -5139,10 +5180,23 @@ def cmd_install_mcp(args):
             },
         ]
         stop_event = "Stop"
-        # Replace any existing C3 stop hooks (matcher=""), keep user-added ones
+        # Replace only C3's own stop hooks (identified by our hook scripts) and
+        # keep every user-added stop hook — including matcher-less ones, which
+        # are the normal shape for Stop hooks.
+        _c3_stop_scripts = (
+            "hook_session_stats.py", "hook_auto_snapshot.py", "hook_terse_advisor.py",
+        )
+
+        def _is_c3_stop_hook(entry: dict) -> bool:
+            return any(
+                script in (hk.get("command") or "")
+                for hk in entry.get("hooks", [])
+                for script in _c3_stop_scripts
+            )
+
         existing_stop = [
             h for h in settings.get("hooks", {}).get(stop_event, [])
-            if h.get("matcher")  # keep entries with a non-empty matcher
+            if not _is_c3_stop_hook(h)
         ]
         existing_stop.extend(desired_stop_hooks)
         settings.setdefault("hooks", {})[stop_event] = existing_stop
@@ -5160,9 +5214,12 @@ def cmd_install_mcp(args):
         include_wildcard = bool(getattr(args, "include_mcp_wildcard", False))
         if perm_tier and profile.name == "claude-code":
             if perm_tier in PERMISSION_TIERS:
-                settings["permissions"] = _build_permission_tier(
-                    perm_tier, include_mcp_wildcard=include_wildcard
-                )["permissions"]
+                settings["permissions"] = _merge_permission_tier(
+                    settings.get("permissions") or {},
+                    _build_permission_tier(
+                        perm_tier, include_mcp_wildcard=include_wildcard
+                    )["permissions"],
+                )
                 # Persist tier choice in .c3/config.json
                 _c3cfg = _safe_read_json(c3_config_path, str(c3_config_path))
                 _c3cfg["permission_tier"] = perm_tier

{code_context_control-2.36.0 → code_context_control-2.38.1}/cli/commands/common.py

@@ -200,13 +200,9 @@ def cmd_claudemd(args, deps: CommandDeps):
             print(content)
         else:
             output_path = Path(project_path) / instructions_file
-            output_path.parent.mkdir(parents=True, exist_ok=True)
-            if output_path.exists():
-                existing = output_path.read_text(encoding="utf-8", errors="replace")
-                if "# User Notes" in existing:
-                    user_section = existing[existing.index("# User Notes"):]
-                    content += f"\n\n{user_section}"
-            output_path.write_text(content, encoding="utf-8")
+            # Wrap in the C3 managed block; preserve user content outside it.
+            from services.claude_md import write_c3_instruction_doc
+            write_c3_instruction_doc(output_path, content)
             print(f"{instructions_file} saved to {output_path} ({tokens} tokens)")
 
     elif args.claudemd_cmd == "check":

{code_context_control-2.36.0 → code_context_control-2.38.1}/cli/guide/getting-started.html

@@ -188,6 +188,14 @@ c3 init</code></pre>
 
       <h3>Re-init / upgrade</h3>
       <p>Running <code>c3 init</code> on an existing project is safe — it merges new config without overwriting your customizations.</p>
+
+      <div class="callout callout-info">
+        <span class="callout-icon">🛡️</span>
+        <div class="callout-body">
+          <strong>Your hand-written content is preserved</strong>
+          Generated instruction files (<code>CLAUDE.md</code>, <code>AGENTS.md</code>, <code>GEMINI.md</code>) wrap C3 content in a <code>&lt;!-- C3:BEGIN … --&gt;</code> / <code>&lt;!-- C3:END --&gt;</code> block. Re-running init (or <code>c3 claudemd save</code> / the <strong>Compact</strong> action) rewrites only that block — anything you add outside it stays put. An existing hand-written file with no block is kept and the C3 block is appended below it.
+        </div>
+      </div>
     </section>
 
     <hr class="divider">
@@ -200,7 +208,7 @@ c3 init</code></pre>
 
       <h3>Claude Code (primary)</h3>
       <pre><code>c3 install-mcp claude</code></pre>
-      <p>This writes to <code>.mcp.json</code> (project scope) and optionally configures PreToolUse / PostToolUse hooks in <code>.claude/settings.local.json</code>.</p>
+      <p>This writes to <code>.mcp.json</code> (project scope) and optionally configures PreToolUse / PostToolUse hooks in <code>.claude/settings.local.json</code>. Both are merged, not overwritten: C3 only touches its own <code>c3</code> server entry and its own hooks, leaving any other MCP servers, hooks, and top-level keys you've added in place.</p>
 
       <h3>VS Code Copilot</h3>
       <pre><code>c3 install-mcp vscode</code></pre>
@@ -358,6 +366,14 @@ c3_session(action='snapshot')   <span class="com"># before /clear</span></code><
           The <code>standard</code> tier blocks destructive shell commands (rm -rf, git reset --hard, etc.) while allowing safe operations. Upgrade to <code>unrestricted</code> only when needed.
         </div>
       </div>
+
+      <div class="callout callout-info">
+        <span class="callout-icon">🛡️</span>
+        <div class="callout-body">
+          <strong>Your custom rules survive a tier change</strong>
+          Applying or switching a tier preserves <code>allow</code>/<code>deny</code> entries you added yourself, plus keys like <code>ask</code> and <code>defaultMode</code>. C3 only replaces the entries it manages, so you can mix a tier with project-specific permissions.
+        </div>
+      </div>
     </section>
 
     <hr class="divider">

{code_context_control-2.36.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.36.0 → code_context_control-2.38.1}/cli/hub_server.py

@@ -1206,7 +1206,7 @@ def api_projects_permissions_get():
 @app.route("/api/projects/permissions/apply", methods=["POST"])
 def api_projects_permissions_put():
     """Apply permission tier to a project. Body: {path, tier}"""
-    from cli.c3 import PERMISSION_TIERS, _build_permission_tier
+    from cli.c3 import PERMISSION_TIERS, _build_permission_tier, _merge_permission_tier
     data = request.get_json(force=True) or {}
     path = (data.get("path") or "").strip()
     tier = (data.get("tier") or "").strip()
@@ -1228,7 +1228,9 @@ def api_projects_permissions_put():
                 settings = json.load(f)
         except Exception:
             pass
-    settings["permissions"] = tier_perms["permissions"]
+    settings["permissions"] = _merge_permission_tier(
+        settings.get("permissions") or {}, tier_perms["permissions"]
+    )
     with open(settings_path, "w", encoding="utf-8") as f:
         json.dump(settings, f, indent=2)
 

{code_context_control-2.36.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.36.0 → code_context_control-2.38.1}/cli/server.py

@@ -1121,16 +1121,11 @@ def api_claudemd_save():
         return jsonify({"error": "Generation produced empty content"}), 500
 
     output_path = PROJECT_PATH / claude_md_mgr.instructions_file
-    output_path.parent.mkdir(parents=True, exist_ok=True)
 
-    # Preserve user-written sections
-    if output_path.exists():
-        existing = output_path.read_text(encoding="utf-8", errors="replace")
-        if "# User Notes" in existing:
-            user_section = existing[existing.index("# User Notes"):]
-            content += f"\n\n{user_section}"
+    # Wrap in the C3 managed block; never clobber user content outside it.
+    from services.claude_md import write_c3_instruction_doc
+    write_c3_instruction_doc(output_path, content)
 
-    output_path.write_text(content, encoding="utf-8")
     return jsonify({
         "path": str(output_path),
         "tokens": gen.get("tokens", 0),
@@ -2021,7 +2016,12 @@ def api_permissions_get():
 @app.route('/api/permissions', methods=['PUT'])
 def api_permissions_put():
     """Apply a permission tier. Body: {tier: "read-only"|"standard"|"permissive"}"""
-    from cli.c3 import PERMISSION_TIERS, _build_permission_tier, _safe_read_json
+    from cli.c3 import (
+        PERMISSION_TIERS,
+        _build_permission_tier,
+        _merge_permission_tier,
+        _safe_read_json,
+    )
     data = request.get_json() or {}
     tier = data.get("tier", "").strip()
     if tier not in PERMISSION_TIERS:
@@ -2031,7 +2031,9 @@ def api_permissions_put():
     settings_path = PROJECT_PATH / ".claude" / "settings.local.json"
     settings_path.parent.mkdir(parents=True, exist_ok=True)
     settings = _safe_read_json(settings_path, str(settings_path))
-    settings["permissions"] = tier_perms["permissions"]
+    settings["permissions"] = _merge_permission_tier(
+        settings.get("permissions") or {}, tier_perms["permissions"]
+    )
     with open(settings_path, "w", encoding="utf-8") as f:
         json.dump(settings, f, indent=2)
 

{code_context_control-2.36.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.36.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
@@ -231,6 +231,8 @@ Every session you've ever run, with duration, decision count, file count, tool c
 
 Manage `CLAUDE.md`, `AGENTS.md` (Codex), `GEMINI.md`, and `.github/copilot-instructions.md` from one editor. Generate from project state, run a Health Check (drift detection vs the actual codebase), Compact stale sections, or Promote insights captured during sessions. **One source of truth** instead of four out-of-sync files.
 
+C3-generated content is wrapped in a `<!-- C3:BEGIN … -->` / `<!-- C3:END -->` block. Regenerating (or `Compact`) only rewrites that block — **anything you write outside it is preserved**, so it's safe to keep your own notes in the same file.
+
 ### 7. Chat — browse prior AI conversations
 
 <p align="center">
@@ -332,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)
@@ -370,6 +376,8 @@ c3 permissions show
 c3 permissions standard
 ```
 
+Applying or switching a tier **preserves your own `allow`/`deny` rules** (and keys like `ask`/`defaultMode`) — only C3-managed entries are replaced. Likewise, C3 never clobbers your other entries in `.mcp.json` (only its own `c3` server) or the hooks you've added to `settings.local.json` (only its own hooks).
+
 ---
 
 ## Benchmarks

{code_context_control-2.36.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,12 +154,14 @@ 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
 tests/test_bitbucket_credentials.py
 tests/test_bitbucket_tool.py
 tests/test_c3_shell.py
+tests/test_claude_md_merge.py
 tests/test_cli_smoke.py
 tests/test_e2e_benchmark.py
 tests/test_edit_normalization.py
@@ -168,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.36.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.36.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()