ltcai 10.2.0 → 10.3.0

package/latticeai/runtime/history_writer.py

@@ -0,0 +1,138 @@
+"""Persisting one chat turn: redact, audit, store, then grow the Brain.
+
+Extracted from the `app_factory._build` closure in 10.3.0. It was 66 lines
+deep inside a 1,343-line composition root, which meant the one function that
+decides what a chat message looks like *after* redaction — and what the audit
+log records about it — could not be exercised without standing up the whole
+application.
+
+The order here is the contract, and it is deliberate:
+
+1. **Redact first.** Everything downstream (the audit preview, the durable
+   store, the knowledge graph) sees the redacted text, never the original.
+2. **Audit before storing.** The audit row carries a masked preview and the
+   sensitivity verdict, so a message that should not have been sent is
+   visible in the log even if the store write later fails.
+3. **Ingest through the pipeline, not the store.** Chat messages enter the
+   Brain the same way files and web pages do, so they get provenance and the
+   hook lifecycle rather than a direct write that bypasses both.
+4. **A failed ingest does not lose the message.** Graph growth is best-effort;
+   the conversation store is not.
+"""
+
+from __future__ import annotations
+
+import logging
+from dataclasses import dataclass
+from datetime import datetime
+from typing import Any, Callable, Dict, Optional
+
+logger = logging.getLogger(__name__)
+
+
+@dataclass(frozen=True)
+class HistoryWriterDeps:
+    """Everything one chat turn needs, injected so this is testable in isolation."""
+
+    conversations: Any
+    append_audit_event: Callable[..., None]
+    classify_sensitive_message: Callable[[Dict[str, Any], int], Dict[str, Any]]
+    redact_secret_text: Callable[[str], str]
+    normalize_branding: Callable[[str], str]
+    ingestion_pipeline: Any = None
+    ingestion_item_factory: Any = None
+    enable_graph: bool = False
+    knowledge_graph: Any = None
+
+
+def write_chat_turn(
+    role: str,
+    message: str,
+    *,
+    user_email: Optional[str] = None,
+    user_nickname: Optional[str] = None,
+    source: Optional[str] = None,
+    conversation_id: Optional[str] = None,
+    workspace_id: Optional[str] = None,
+    deps: HistoryWriterDeps,
+) -> None:
+    """Persist one chat turn. Never raises: a failure here must not lose a reply."""
+    redact_secret_text = deps.redact_secret_text
+    normalize_branding = deps.normalize_branding
+    classify_sensitive_message = deps.classify_sensitive_message
+    append_audit_event = deps.append_audit_event
+    conversations = deps.conversations
+    ingestion_pipeline = deps.ingestion_pipeline
+    ingestion_item_factory = deps.ingestion_item_factory
+    enable_graph = deps.enable_graph
+    knowledge_graph = deps.knowledge_graph
+
+    try:
+        # 1. Redact before anything else sees the text.
+        message = redact_secret_text(message)
+        if role == "assistant":
+            message = normalize_branding(message)
+
+        item: Dict[str, Any] = {
+            "role": role,
+            "content": message,
+            "timestamp": datetime.now().isoformat(),
+        }
+        for key, value in (
+            ("user_email", user_email),
+            ("user_nickname", user_nickname),
+            ("source", source),
+            ("conversation_id", conversation_id),
+            ("workspace_id", workspace_id),
+        ):
+            if value:
+                item[key] = value
+
+        # 2. Audit carries a masked preview and the verdict, never the body.
+        sensitive = classify_sensitive_message(item, -1)
+        append_audit_event(
+            "chat_message",
+            role=role,
+            user_email=user_email,
+            user_nickname=user_nickname,
+            source=source,
+            conversation_id=conversation_id,
+            workspace_id=workspace_id,
+            content_preview=sensitive.get("preview"),
+            content_chars=len(message or ""),
+            sensitivity=sensitive.get("sensitivity"),
+            sensitive_labels=sensitive.get("labels") or [],
+        )
+
+        # 3. Durable episodic memory. Unbounded SQLite; the old 50-message
+        #    chat_history.json cap is gone.
+        conversations.append(item)
+
+        # 4. Best-effort Brain growth through the unified pipeline.
+        if enable_graph and knowledge_graph and ingestion_pipeline and ingestion_item_factory:
+            try:
+                ingestion_pipeline.ingest(
+                    ingestion_item_factory(
+                        source_type="chat_message",
+                        text=message,
+                        owner=user_email,
+                        workspace_id=workspace_id,
+                        conversation_id=conversation_id,
+                        metadata={
+                            "role": role,
+                            "user_nickname": user_nickname,
+                            "source": source,
+                            "raw": item,
+                        },
+                    ),
+                    user_email=user_email,
+                )
+            except Exception as graph_error:  # noqa: BLE001
+                # The message is already stored; a graph failure must not
+                # look like a lost turn.
+                logger.warning("knowledge graph message ingest failed: %s", graph_error)
+    except Exception as exc:  # noqa: BLE001
+        logger.warning("save_to_history failed: %s", exc)
+
+
+__all__ = ["HistoryWriterDeps", "write_chat_turn"]

package/latticeai/services/architecture_readiness.py

@@ -16,7 +16,7 @@ from typing import Any, Dict, List
 
 from latticeai.core.legacy_compatibility import legacy_shim_report
 
-ARCHITECTURE_VERSION_TARGET = "10.2.0"
+ARCHITECTURE_VERSION_TARGET = "10.3.0"
 
 PREFERRED_REFACTORING_ORDER = [
     "agent-runtime",

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 = "10.2.0"
+PRODUCT_VERSION_TARGET = "10.3.0"
 
 
 @dataclass(frozen=True)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ltcai",
-  "version": "10.2.0",
+  "version": "10.3.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": {
@@ -61,7 +61,8 @@
     "test:vscode-extension": "cd vscode-extension && npm run build && cd .. && node --test tests/vscode-extension.test.cjs",
     "check:i18n-namespaces": "node scripts/check_i18n_namespace_coverage.mjs",
     "typecheck:python": "node scripts/run_python.mjs -m mypy",
-    "test:coverage": "node scripts/run_python.mjs -m pytest tests/ -q --cov --cov-report=term:skip-covered"
+    "test:coverage": "node scripts/run_python.mjs -m pytest tests/ -q --cov --cov-report=term:skip-covered",
+    "test:frontend:coverage": "vitest run --coverage"
   },
   "keywords": [
     "ltcai",
@@ -137,6 +138,7 @@
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^6.0.2",
+    "@vitest/coverage-v8": "^4.1.10",
     "autoprefixer": "^10.5.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",

package/scripts/check_current_release_docs.mjs

@@ -6,7 +6,7 @@ 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 = "Load-Bearing Fixes";
+const releaseTheme = "Measured Ground";
 const title = `${version} — ${releaseTheme}`;
 const escapedVersion = version.replaceAll(".", "\\.");
 

package/src-tauri/Cargo.lock

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

package/src-tauri/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "lattice-ai-desktop"
-version = "10.2.0"
+version = "10.3.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": "10.2.0",
+  "version": "10.3.0",
   "identifier": "ai.lattice.desktop",
   "build": {
     "beforeDevCommand": "npm run frontend:dev",

package/static/app/asset-manifest.json

@@ -1,45 +1,45 @@
 {
-  "version": "10.2.0",
+  "version": "10.3.0",
   "generated_at": "vite",
   "entrypoints": {
-    "app": "/static/app/assets/index-DDV2YZwM.js"
+    "app": "/static/app/assets/index-Dm9VXl1o.js"
   },
   "assets": {
     "../node_modules/@tauri-apps/api/core.js": "/static/app/assets/core-CwxXejkd.js",
-    "_BrainSignals-ChxAYHtj.js": "/static/app/assets/BrainSignals-ChxAYHtj.js",
-    "_LivingBrain-CNz-6NSd.js": "/static/app/assets/LivingBrain-CNz-6NSd.js",
-    "_ReviewCard-C4mpvkwH.js": "/static/app/assets/ReviewCard-C4mpvkwH.js",
-    "_activity-CiauPV_3.js": "/static/app/assets/activity-CiauPV_3.js",
-    "_bot-Dwct-Q1x.js": "/static/app/assets/bot-Dwct-Q1x.js",
-    "_brain-BKDW1F0T.js": "/static/app/assets/brain-BKDW1F0T.js",
-    "_button-CCB9Kuw7.js": "/static/app/assets/button-CCB9Kuw7.js",
-    "_circle-pause-DNa8WHC5.js": "/static/app/assets/circle-pause-DNa8WHC5.js",
-    "_circle-play-8jmxn5mf.js": "/static/app/assets/circle-play-8jmxn5mf.js",
-    "_cpu-mxvF3V1I.js": "/static/app/assets/cpu-mxvF3V1I.js",
-    "_download--SmCcx0p.js": "/static/app/assets/download--SmCcx0p.js",
-    "_folder-open-D4Wy5roo.js": "/static/app/assets/folder-open-D4Wy5roo.js",
-    "_hard-drive-BwQcSPlS.js": "/static/app/assets/hard-drive-BwQcSPlS.js",
-    "_input-DFhSjmLS.js": "/static/app/assets/input-DFhSjmLS.js",
-    "_network-Bts7VO94.js": "/static/app/assets/network-Bts7VO94.js",
-    "_primitives-BuSMEJY8.js": "/static/app/assets/primitives-BuSMEJY8.js",
-    "_search-DZzxhWaQ.js": "/static/app/assets/search-DZzxhWaQ.js",
-    "_shield-alert-BfTO6X_G.js": "/static/app/assets/shield-alert-BfTO6X_G.js",
-    "_textarea-BjctW1oh.js": "/static/app/assets/textarea-BjctW1oh.js",
-    "_useFocusTrap-CE43-LrA.js": "/static/app/assets/useFocusTrap-CE43-LrA.js",
-    "_useQuery-Bv3ejLL5.js": "/static/app/assets/useQuery-Bv3ejLL5.js",
-    "_users-CsNqLZAj.js": "/static/app/assets/users-CsNqLZAj.js",
-    "_utils-KFFdVG_t.js": "/static/app/assets/utils-KFFdVG_t.js",
-    "_workspace-wdCvdyPF.js": "/static/app/assets/workspace-wdCvdyPF.js",
-    "index.html": "/static/app/assets/index-DDV2YZwM.js",
-    "assets/index-CQWdDU3z.css": "/static/app/assets/index-CQWdDU3z.css",
-    "src/components/ProductFlow.tsx": "/static/app/assets/ProductFlow-ePX-Y73J.js",
-    "src/features/admin/AdminConsole.tsx": "/static/app/assets/AdminConsole-LgCkXpnf.js",
-    "src/features/brain/BrainHome.tsx": "/static/app/assets/BrainHome-gVnaxSwp.js",
-    "src/features/command/CommandPalette.tsx": "/static/app/assets/CommandPalette-Ovtv5I0Y.js",
-    "src/pages/Act.tsx": "/static/app/assets/Act-CbdGD-2i.js",
-    "src/pages/Brain.tsx": "/static/app/assets/Brain-CoPGJI1L.js",
-    "src/pages/Capture.tsx": "/static/app/assets/Capture-DBtgkHZg.js",
-    "src/pages/Library.tsx": "/static/app/assets/Library-CBia2Fvm.js",
-    "src/pages/System.tsx": "/static/app/assets/System-BvWNK1zc.js"
+    "_BrainSignals-O4s6R7av.js": "/static/app/assets/BrainSignals-O4s6R7av.js",
+    "_LivingBrain-D9Iei2ZJ.js": "/static/app/assets/LivingBrain-D9Iei2ZJ.js",
+    "_ReviewCard-QQly2bTV.js": "/static/app/assets/ReviewCard-QQly2bTV.js",
+    "_activity-CxRPOQ2F.js": "/static/app/assets/activity-CxRPOQ2F.js",
+    "_bot-1bcsWB2s.js": "/static/app/assets/bot-1bcsWB2s.js",
+    "_brain-CxaeKCRM.js": "/static/app/assets/brain-CxaeKCRM.js",
+    "_button-ZYFqGan7.js": "/static/app/assets/button-ZYFqGan7.js",
+    "_circle-pause-B5NOIqvk.js": "/static/app/assets/circle-pause-B5NOIqvk.js",
+    "_circle-play-BiJVFXf7.js": "/static/app/assets/circle-play-BiJVFXf7.js",
+    "_cpu-Vvq0OKTr.js": "/static/app/assets/cpu-Vvq0OKTr.js",
+    "_download-SEcXzkx1.js": "/static/app/assets/download-SEcXzkx1.js",
+    "_folder-open-Dw1ff_Qa.js": "/static/app/assets/folder-open-Dw1ff_Qa.js",
+    "_hard-drive-B00fR7_r.js": "/static/app/assets/hard-drive-B00fR7_r.js",
+    "_input-DtdWYQEa.js": "/static/app/assets/input-DtdWYQEa.js",
+    "_network-CpjBu0kI.js": "/static/app/assets/network-CpjBu0kI.js",
+    "_primitives-CwsudBwc.js": "/static/app/assets/primitives-CwsudBwc.js",
+    "_search-CwEJWBEA.js": "/static/app/assets/search-CwEJWBEA.js",
+    "_shield-alert-CpjBc-gQ.js": "/static/app/assets/shield-alert-CpjBc-gQ.js",
+    "_textarea-DUPyjHQs.js": "/static/app/assets/textarea-DUPyjHQs.js",
+    "_useFocusTrap-BWcMtCWH.js": "/static/app/assets/useFocusTrap-BWcMtCWH.js",
+    "_useQuery-Dg5fPqTS.js": "/static/app/assets/useQuery-Dg5fPqTS.js",
+    "_users-BgcdTQGM.js": "/static/app/assets/users-BgcdTQGM.js",
+    "_utils-a3YXFtEO.js": "/static/app/assets/utils-a3YXFtEO.js",
+    "_workspace-BMUEiXUm.js": "/static/app/assets/workspace-BMUEiXUm.js",
+    "index.html": "/static/app/assets/index-Dm9VXl1o.js",
+    "assets/index-CEkL4_M-.css": "/static/app/assets/index-CEkL4_M-.css",
+    "src/components/ProductFlow.tsx": "/static/app/assets/ProductFlow-JlXiDfMM.js",
+    "src/features/admin/AdminConsole.tsx": "/static/app/assets/AdminConsole-CEV1VefA.js",
+    "src/features/brain/BrainHome.tsx": "/static/app/assets/BrainHome-CEBd86k6.js",
+    "src/features/command/CommandPalette.tsx": "/static/app/assets/CommandPalette-CeqBjCn2.js",
+    "src/pages/Act.tsx": "/static/app/assets/Act-DrKIGZeJ.js",
+    "src/pages/Brain.tsx": "/static/app/assets/Brain-BZSXnwWU.js",
+    "src/pages/Capture.tsx": "/static/app/assets/Capture-AGbOxsg-.js",
+    "src/pages/Library.tsx": "/static/app/assets/Library-CXnbNiQW.js",
+    "src/pages/System.tsx": "/static/app/assets/System-Bp9ZY4ER.js"
   }
 }