ltcai 9.4.0 → 9.6.0

package/latticeai/services/command_center.py

@@ -0,0 +1,433 @@
+"""Command Center: daily briefing + universal command search (v9.5.0).
+
+The Brain accumulates a lot of surfaces — knowledge, conversations,
+automations, review queue, health. The Command Center condenses them into two
+deterministic, local, read-only entry points:
+
+* **briefing** — one payload answering "what does my Brain know about today?":
+  recent knowledge, conversation activity, automation state, pending reviews,
+  a health snapshot, and top automation suggestions. Each section degrades
+  independently — a missing backend never breaks the briefing.
+* **search** — one query across every surface at once: knowledge nodes
+  (graph keyword search), the user's own conversations, and installed
+  automations. Powers the Cmd+K command palette.
+* **quick_actions** — state-derived next steps ("N items waiting for review",
+  "enable your draft automation") with stable ids, so the UI can render
+  one-click jumps without guessing.
+
+Everything here is scoped to the requesting user and workspace, mirrors the
+scoped-read conventions of the automation intelligence service, and never
+calls a model.
+"""
+
+from __future__ import annotations
+
+import logging
+from typing import Any, Dict, List, Optional
+
+from latticeai.core.timeutil import now_iso as _now
+
+LOGGER = logging.getLogger(__name__)
+
+_RECENT_NODE_LIMIT = 6
+_SEARCH_HISTORY_LIMIT = 2000
+_BRIEFING_HISTORY_LIMIT = 2000
+
+
+def _clip(text: Any, limit: int = 160) -> str:
+    value = str(text or "").strip()
+    return value[:limit]
+
+
+class CommandCenterService:
+    def __init__(
+        self,
+        *,
+        conversation_store: Any = None,
+        knowledge_graph: Any = None,
+        store: Any = None,
+        search_service: Any = None,
+        brain_intelligence: Any = None,
+        automation_intelligence: Any = None,
+        review_queue: Any = None,
+        enable_graph: bool = True,
+    ) -> None:
+        self._conversations = conversation_store
+        self._kg = knowledge_graph
+        self._store = store
+        self._search = search_service
+        self._brain = brain_intelligence
+        self._automation = automation_intelligence
+        self._review_queue = review_queue
+        self._enable_graph = bool(enable_graph and knowledge_graph is not None)
+
+    # ── scoped reads ─────────────────────────────────────────────────────
+
+    def _scope_kwargs(self, workspace_id: Optional[str]) -> Dict[str, Any]:
+        return {
+            "allowed_workspaces": {workspace_id} if workspace_id is not None else None,
+            "include_legacy_global": workspace_id is None,
+        }
+
+    def _history(
+        self, *, user_email: Optional[str], workspace_id: Optional[str], limit: int
+    ) -> List[Dict[str, Any]]:
+        if self._conversations is None:
+            return []
+        try:
+            return list(
+                self._conversations.history(
+                    user_email=user_email,
+                    limit=limit,
+                    **self._scope_kwargs(workspace_id),
+                )
+            )
+        except Exception:
+            LOGGER.exception("command center history read failed")
+            return []
+
+    def _workflows(self, *, workspace_id: Optional[str]) -> List[Dict[str, Any]]:
+        if self._store is None:
+            return []
+        try:
+            return list(self._store.list_workflows(workspace_id=workspace_id).get("workflows") or [])
+        except Exception:
+            LOGGER.exception("command center workflow read failed")
+            return []
+
+    # ── briefing sections ────────────────────────────────────────────────
+
+    def _knowledge_section(self, *, workspace_id: Optional[str]) -> Dict[str, Any]:
+        if not self._enable_graph or not hasattr(self._kg, "graph"):
+            return {"available": False, "recent": []}
+        try:
+            snapshot = self._kg.graph(limit=50, **self._scope_kwargs(workspace_id))
+        except Exception:
+            LOGGER.exception("command center knowledge read failed")
+            return {"available": False, "recent": []}
+        nodes = list(snapshot.get("nodes") or [])
+        recent = [
+            {
+                "id": node.get("id"),
+                "title": _clip(node.get("title"), 120),
+                "type": node.get("type"),
+                "updated_at": node.get("updated_at"),
+            }
+            for node in nodes[:_RECENT_NODE_LIMIT]
+        ]
+        return {"available": True, "recent": recent, "sampled_nodes": len(nodes)}
+
+    def _conversation_section(
+        self, *, user_email: Optional[str], workspace_id: Optional[str]
+    ) -> Dict[str, Any]:
+        items = self._history(
+            user_email=user_email, workspace_id=workspace_id, limit=_BRIEFING_HISTORY_LIMIT
+        )
+        if not items:
+            return {"available": self._conversations is not None, "messages": 0, "questions": 0}
+        user_items = [item for item in items if item.get("role") == "user"]
+        last = items[-1]
+        return {
+            "available": True,
+            "messages": len(items),
+            "questions": len(user_items),
+            "last_active": str(last.get("timestamp") or ""),
+            "last_question": _clip(
+                next(
+                    (item.get("content") for item in reversed(user_items)),
+                    "",
+                ),
+                120,
+            ),
+        }
+
+    def _automation_section(self, *, workspace_id: Optional[str]) -> Dict[str, Any]:
+        if self._store is None:
+            return {"available": False, "total": 0, "enabled": 0, "drafts": 0}
+        workflows = self._workflows(workspace_id=workspace_id)
+        enabled = 0
+        drafts = 0
+        for workflow in workflows:
+            metadata = (workflow or {}).get("metadata") or {}
+            if metadata.get("automation_state") == "enabled":
+                enabled += 1
+            elif metadata.get("automation_state") == "draft_disabled":
+                drafts += 1
+        return {
+            "available": True,
+            "total": len(workflows),
+            "enabled": enabled,
+            "drafts": drafts,
+        }
+
+    def _review_section(
+        self, *, user_email: Optional[str], workspace_id: Optional[str]
+    ) -> Dict[str, Any]:
+        if self._review_queue is None:
+            return {"available": False, "pending": 0}
+        try:
+            listed = self._review_queue.list(
+                workspace_id=workspace_id, user_email=user_email, status="pending"
+            )
+        except Exception:
+            LOGGER.exception("command center review read failed")
+            return {"available": False, "pending": 0}
+        return {"available": True, "pending": len(listed.get("items") or [])}
+
+    def _health_section(
+        self, *, user_email: Optional[str], workspace_id: Optional[str]
+    ) -> Dict[str, Any]:
+        if self._brain is None:
+            return {"available": False}
+        try:
+            report = self._brain.health_report(
+                user_email=user_email, workspace_id=workspace_id
+            )
+        except Exception:
+            LOGGER.exception("command center health read failed")
+            return {"available": False}
+        overall = report.get("overall") or {}
+        return {
+            "available": overall.get("score") is not None,
+            "grade": overall.get("grade"),
+            "score": overall.get("score"),
+            "recommended_actions": list(report.get("recommended_actions") or [])[:3],
+        }
+
+    def _suggestion_section(
+        self, *, user_email: Optional[str], workspace_id: Optional[str]
+    ) -> Dict[str, Any]:
+        if self._automation is None:
+            return {"available": False, "count": 0, "top": []}
+        try:
+            payload = self._automation.suggestions(
+                user_email=user_email, workspace_id=workspace_id
+            )
+        except Exception:
+            LOGGER.exception("command center suggestion read failed")
+            return {"available": False, "count": 0, "top": []}
+        suggestions = [
+            item
+            for item in (payload.get("suggestions") or [])
+            if not item.get("installed")
+        ]
+        top = [
+            {
+                "id": item.get("id"),
+                "kind": item.get("kind"),
+                "title": _clip(item.get("title"), 120),
+            }
+            for item in suggestions[:3]
+        ]
+        return {"available": True, "count": len(suggestions), "top": top}
+
+    # ── quick actions ────────────────────────────────────────────────────
+
+    def _quick_actions(self, sections: Dict[str, Dict[str, Any]]) -> List[Dict[str, Any]]:
+        """State-derived next steps with stable ids and app hash targets."""
+        actions: List[Dict[str, Any]] = []
+        review = sections.get("review") or {}
+        if review.get("pending"):
+            actions.append(
+                {
+                    "id": "review-pending",
+                    "kind": "review",
+                    "count": review["pending"],
+                    "target": "/act/review",
+                }
+            )
+        automations = sections.get("automations") or {}
+        if automations.get("drafts"):
+            actions.append(
+                {
+                    "id": "enable-drafts",
+                    "kind": "automation",
+                    "count": automations["drafts"],
+                    "target": "/act/workflows",
+                }
+            )
+        suggestions = sections.get("suggestions") or {}
+        if suggestions.get("count"):
+            actions.append(
+                {
+                    "id": "install-suggestion",
+                    "kind": "suggestion",
+                    "count": suggestions["count"],
+                    "target": "/act/workflows",
+                }
+            )
+        knowledge = sections.get("knowledge") or {}
+        if knowledge.get("available") and not knowledge.get("recent"):
+            actions.append(
+                {
+                    "id": "connect-knowledge",
+                    "kind": "capture",
+                    "count": 0,
+                    "target": "/capture/files",
+                }
+            )
+        health = sections.get("health") or {}
+        if health.get("available") and isinstance(health.get("score"), (int, float)) and health["score"] < 70:
+            actions.append(
+                {
+                    "id": "check-health",
+                    "kind": "health",
+                    "count": 0,
+                    "target": "/brain/graph",
+                }
+            )
+        if not actions:
+            actions.append(
+                {"id": "ask-brain", "kind": "chat", "count": 0, "target": "/brain"}
+            )
+        return actions
+
+    def briefing(
+        self, *, user_email: Optional[str] = None, workspace_id: Optional[str] = None
+    ) -> Dict[str, Any]:
+        sections = {
+            "knowledge": self._knowledge_section(workspace_id=workspace_id),
+            "conversations": self._conversation_section(
+                user_email=user_email, workspace_id=workspace_id
+            ),
+            "automations": self._automation_section(workspace_id=workspace_id),
+            "review": self._review_section(
+                user_email=user_email, workspace_id=workspace_id
+            ),
+            "health": self._health_section(
+                user_email=user_email, workspace_id=workspace_id
+            ),
+            "suggestions": self._suggestion_section(
+                user_email=user_email, workspace_id=workspace_id
+            ),
+        }
+        return {
+            "generated_at": _now(),
+            "sections": sections,
+            "quick_actions": self._quick_actions(sections),
+        }
+
+    # ── universal search ─────────────────────────────────────────────────
+
+    def _search_knowledge(
+        self, query: str, *, workspace_id: Optional[str], limit: int
+    ) -> List[Dict[str, Any]]:
+        if self._search is None or not self._enable_graph:
+            return []
+        try:
+            payload = self._search.keyword_search(
+                query, limit=limit, **self._scope_kwargs(workspace_id)
+            )
+        except Exception:
+            LOGGER.exception("command center knowledge search failed")
+            return []
+        return [
+            {
+                "id": item.get("id"),
+                "title": _clip(item.get("title"), 120),
+                "summary": _clip(item.get("summary"), 160),
+                "type": item.get("type"),
+            }
+            for item in (payload.get("results") or [])[:limit]
+        ]
+
+    def _search_conversations(
+        self,
+        query: str,
+        *,
+        user_email: Optional[str],
+        workspace_id: Optional[str],
+        limit: int,
+    ) -> List[Dict[str, Any]]:
+        needle = query.lower()
+        matches: List[Dict[str, Any]] = []
+        seen_conversations: set = set()
+        items = self._history(
+            user_email=user_email, workspace_id=workspace_id, limit=_SEARCH_HISTORY_LIMIT
+        )
+        for item in reversed(items):
+            content = str(item.get("content") or "")
+            if needle not in content.lower():
+                continue
+            conversation_id = str(item.get("conversation_id") or "")
+            if conversation_id and conversation_id in seen_conversations:
+                continue
+            if conversation_id:
+                seen_conversations.add(conversation_id)
+            matches.append(
+                {
+                    "conversation_id": conversation_id,
+                    "role": item.get("role"),
+                    "snippet": _clip(content, 140),
+                    "timestamp": str(item.get("timestamp") or ""),
+                }
+            )
+            if len(matches) >= limit:
+                break
+        return matches
+
+    def _search_automations(
+        self, query: str, *, workspace_id: Optional[str], limit: int
+    ) -> List[Dict[str, Any]]:
+        needle = query.lower()
+        matches: List[Dict[str, Any]] = []
+        for workflow in self._workflows(workspace_id=workspace_id):
+            name = str(workflow.get("name") or "")
+            if needle not in name.lower():
+                continue
+            metadata = (workflow or {}).get("metadata") or {}
+            matches.append(
+                {
+                    "id": workflow.get("id"),
+                    "name": _clip(name, 120),
+                    "enabled": metadata.get("automation_state") == "enabled",
+                }
+            )
+            if len(matches) >= limit:
+                break
+        return matches
+
+    def search(
+        self,
+        query: str,
+        *,
+        user_email: Optional[str] = None,
+        workspace_id: Optional[str] = None,
+        limit: int = 8,
+    ) -> Dict[str, Any]:
+        query = str(query or "").strip()
+        limit = max(1, min(int(limit or 8), 20))
+        if not query:
+            return {"query": "", "groups": [], "generated_at": _now()}
+        groups = [
+            {
+                "kind": "knowledge",
+                "items": self._search_knowledge(
+                    query, workspace_id=workspace_id, limit=limit
+                ),
+            },
+            {
+                "kind": "conversation",
+                "items": self._search_conversations(
+                    query,
+                    user_email=user_email,
+                    workspace_id=workspace_id,
+                    limit=limit,
+                ),
+            },
+            {
+                "kind": "automation",
+                "items": self._search_automations(
+                    query, workspace_id=workspace_id, limit=limit
+                ),
+            },
+        ]
+        return {
+            "query": query,
+            "groups": [group for group in groups if group["items"]],
+            "total": sum(len(group["items"]) for group in groups),
+            "generated_at": _now(),
+        }
+
+
+__all__ = ["CommandCenterService"]

package/latticeai/services/product_readiness.py

@@ -18,7 +18,7 @@ from typing import Any, Dict, List
 
 from latticeai.services.architecture_readiness import architecture_readiness
 
-PRODUCT_VERSION_TARGET = "9.4.0"
+PRODUCT_VERSION_TARGET = "9.6.0"
 
 
 @dataclass(frozen=True)

package/latticeai/services/review_queue.py

@@ -28,7 +28,10 @@ OPEN_STATUSES = {"pending", "snoozed"}
 TERMINAL_STATUSES = {"approved", "dismissed"}
 ALL_STATUSES = OPEN_STATUSES | TERMINAL_STATUSES
 
-REVIEW_SOURCES = frozenset({"workflow_run", "trigger", "kg_change_digest", "chat_followup", "agent_followup"})
+REVIEW_SOURCES = frozenset({
+    "workflow_run", "trigger", "kg_change_digest", "chat_followup",
+    "agent_followup", "change_proposal",
+})
 
 # Which source statuses each action is allowed from.
 _ALLOWED_FROM: Dict[str, set] = {

package/latticeai/tools/__init__.py

@@ -124,6 +124,11 @@ def _resolve_path(path: str = "") -> Path:
     return candidate
 
 
+def resolve_workspace_path(path: str = "") -> Path:
+    """Public alias of the sandboxed workspace path resolver (v9.6.0)."""
+    return _resolve_path(path)
+
+
 def _relative(path: Path) -> str:
     return str(path.relative_to(AGENT_ROOT))
 
@@ -259,7 +264,7 @@ def execute_tool(action: str, args: Dict[str, Any]) -> Dict[str, Any]:
 
 
 __all__ = [
-    "AGENT_ROOT", "ToolError", "ensure_agent_root",
+    "AGENT_ROOT", "ToolError", "ensure_agent_root", "resolve_workspace_path",
     "list_dir", "workspace_tree", "read_file", "write_file", "edit_file", "grep",
     "search_files", "inspect_html", "preview_url", "create_web_project",
     "todo_read", "todo_write",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ltcai",
-  "version": "9.4.0",
+  "version": "9.6.0",
   "description": "Lattice AI — local-first Digital Brain that keeps your knowledge durable across any AI model.",
   "homepage": "https://github.com/TaeSooPark-PTS/LatticeAI#readme",
   "repository": {

package/scripts/agent_eval.py

@@ -0,0 +1,46 @@
+#!/usr/bin/env python3
+"""Agent-loop evaluation gate (v9.6.0).
+
+Runs the deterministic scenario suite in ``latticeai.core.agent_eval``
+against the real SingleAgentRuntime state machine (scripted model, fake
+ports) and fails the release when any scenario regresses.
+
+Usage: .venv/bin/python scripts/agent_eval.py [--verbose]
+"""
+
+from __future__ import annotations
+
+import json
+import sys
+from pathlib import Path
+
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+
+from latticeai.core.agent_eval import run_agent_eval  # noqa: E402
+
+
+def main() -> int:
+    verbose = "--verbose" in sys.argv
+    report = run_agent_eval()
+    headline = {
+        "scenarios": report["scenarios"],
+        "passed": report["passed"],
+        "success_rate": report["success_rate"],
+        "parse_errors": report["parse_errors"],
+        "parse_recovered": report["parse_recovered"],
+        "recovery_rate": report["recovery_rate"],
+    }
+    if verbose:
+        print(json.dumps(report, ensure_ascii=False, indent=2))
+    failures = [r for r in report["results"] if not r["ok"]]
+    if failures:
+        print(f"agent-loop-eval: FAIL {headline}")
+        for result in failures:
+            print(f"  ✗ {result['name']}: {'; '.join(result['failures'])}")
+        return 1
+    print(f"agent-loop-eval: OK {headline}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/scripts/check_current_release_docs.mjs

@@ -6,11 +6,12 @@ const root = process.cwd();
 const pkg = JSON.parse(readFileSync(path.join(root, "package.json"), "utf8"));
 const version = pkg.version;
 const releaseDir = `output/release/v${version}`;
-const releaseTheme = "Question-Driven Everyday Automation";
+const releaseTheme = "Trusted Agent Loop";
 const title = `${version} — ${releaseTheme}`;
 const escapedVersion = version.replaceAll(".", "\\.");
 
 const currentReleaseFiles = [
+  "AGENTS.md",
   "README.md",
   "ARCHITECTURE.md",
   "FEATURE_STATUS.md",

package/src-tauri/Cargo.lock

@@ -1584,7 +1584,7 @@ dependencies = [
 
 [[package]]
 name = "lattice-ai-desktop"
-version = "9.4.0"
+version = "9.6.0"
 dependencies = [
  "plist",
  "serde",

package/src-tauri/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "lattice-ai-desktop"
-version = "9.4.0"
+version = "9.6.0"
 description = "Lattice AI Digital Brain desktop shell"
 authors = ["TaeSoo Park"]
 edition = "2021"

package/src-tauri/tauri.conf.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "Lattice AI",
-  "version": "9.4.0",
+  "version": "9.6.0",
   "identifier": "ai.lattice.desktop",
   "build": {
     "beforeDevCommand": "npm run frontend:dev",

package/static/app/asset-manifest.json

@@ -1,19 +1,19 @@
 {
-  "version": "9.4.0",
+  "version": "9.6.0",
   "generated_at": "vite",
   "entrypoints": {
-    "app": "/static/app/assets/index-BeQ77vPs.js"
+    "app": "/static/app/assets/index-AF0-4XVv.js"
   },
   "assets": {
     "../node_modules/@tauri-apps/api/core.js": "/static/app/assets/core-CwxXejkd.js",
-    "_primitives-DawfkPR4.js": "/static/app/assets/primitives-DawfkPR4.js",
-    "_textarea-a4Ir3SZS.js": "/static/app/assets/textarea-a4Ir3SZS.js",
-    "index.html": "/static/app/assets/index-BeQ77vPs.js",
-    "assets/index-Cl4S_9Id.css": "/static/app/assets/index-Cl4S_9Id.css",
-    "src/pages/Act.tsx": "/static/app/assets/Act-t9oveJO7.js",
-    "src/pages/Brain.tsx": "/static/app/assets/Brain-DP-gpcEJ.js",
-    "src/pages/Capture.tsx": "/static/app/assets/Capture-DYknDKy8.js",
-    "src/pages/Library.tsx": "/static/app/assets/Library-DLyc_g8c.js",
-    "src/pages/System.tsx": "/static/app/assets/System-BZgJ7tGu.js"
+    "_primitives-jbb2qv4Q.js": "/static/app/assets/primitives-jbb2qv4Q.js",
+    "_textarea-CFoo0OxJ.js": "/static/app/assets/textarea-CFoo0OxJ.js",
+    "index.html": "/static/app/assets/index-AF0-4XVv.js",
+    "assets/index-85wQvEie.css": "/static/app/assets/index-85wQvEie.css",
+    "src/pages/Act.tsx": "/static/app/assets/Act-BkOEmwBi.js",
+    "src/pages/Brain.tsx": "/static/app/assets/Brain-C9ITUsQ_.js",
+    "src/pages/Capture.tsx": "/static/app/assets/Capture-C-ppTeud.js",
+    "src/pages/Library.tsx": "/static/app/assets/Library-CGQbgWTu.js",
+    "src/pages/System.tsx": "/static/app/assets/System-djmj0n2_.js"
   }
 }