ltcai 8.7.0 → 8.8.0

package/latticeai/core/legacy_compatibility.py

@@ -14,7 +14,7 @@ from pathlib import Path
 from typing import Any, Dict, List
 
 
-LEGACY_COMPATIBILITY_VERSION = "8.5.0"
+LEGACY_COMPATIBILITY_VERSION = "8.8.0"
 
 
 @dataclass(frozen=True)
@@ -43,7 +43,7 @@ LEGACY_SHIMS: List[LegacyShim] = [
     LegacyShim(
         path="knowledge_graph.py",
         owner="lattice_brain.graph",
-        replacement="from lattice_brain.store import KnowledgeGraphStore",
+        replacement="from lattice_brain.graph.store import KnowledgeGraphStore",
         reason="Historical scripts imported the graph store from the repo root.",
         removal_phase="major-release-after-8.x",
     ),
@@ -57,7 +57,7 @@ LEGACY_SHIMS: List[LegacyShim] = [
     LegacyShim(
         path="kg_schema.py",
         owner="lattice_brain.graph.schema",
-        replacement="from lattice_brain.schema import ...",
+        replacement="from lattice_brain.graph.schema import ...",
         reason="Historical graph schema tests and tools referenced root schema symbols.",
         removal_phase="major-release-after-8.x",
     ),
@@ -96,53 +96,59 @@ LEGACY_SHIMS: List[LegacyShim] = [
         reason="Local folder ingestion integrations used the root local knowledge API.",
         removal_phase="requires-api-route-migration",
     ),
+]
+
+# Shim layers that have completed their compatibility window and were
+# physically deleted. Kept in the report so consumers (docs, tests, release
+# notes) can tell "removed on purpose" apart from "missing by accident".
+# Removing the internal-only layers is the first step of extracting
+# ``lattice_brain`` as a standalone Brain Core package: the package now has
+# exactly one import surface (``lattice_brain.*`` physical paths).
+REMOVED_SHIMS: List[LegacyShim] = [
     LegacyShim(
         path="lattice_brain/store.py",
         owner="lattice_brain.graph.store",
         replacement="from lattice_brain.graph.store import KnowledgeGraphStore",
-        reason="Pre-graph-package imports used the flat Brain store module.",
-        removal_phase="major-release-after-8.x",
+        reason="Pre-graph-package flat modules were internal-only; removed in 8.8.0.",
+        removal_phase="removed-8.8.0",
         layer="brain-flat",
+        status="removed",
     ),
     LegacyShim(
         path="lattice_brain/ingest.py",
         owner="lattice_brain.graph.ingest",
         replacement="from lattice_brain.graph.ingest import KnowledgeGraphIngestMixin",
-        reason="Pre-graph-package imports used the flat Brain ingest module.",
-        removal_phase="major-release-after-8.x",
+        reason="Pre-graph-package flat modules were internal-only; removed in 8.8.0.",
+        removal_phase="removed-8.8.0",
         layer="brain-flat",
+        status="removed",
     ),
     LegacyShim(
         path="lattice_brain/retrieval.py",
         owner="lattice_brain.graph.retrieval",
         replacement="from lattice_brain.graph.retrieval import KnowledgeGraphRetrievalMixin",
-        reason="Pre-graph-package imports used the flat Brain retrieval module.",
-        removal_phase="major-release-after-8.x",
+        reason="Pre-graph-package flat modules were internal-only; removed in 8.8.0.",
+        removal_phase="removed-8.8.0",
         layer="brain-flat",
+        status="removed",
     ),
     LegacyShim(
-        path="latticeai/brain/store.py",
-        owner="lattice_brain.graph.store",
-        replacement="from lattice_brain.graph.store import KnowledgeGraphStore",
-        reason="The deprecated latticeai.brain namespace remains for package users.",
-        removal_phase="major-release-after-8.x",
-        layer="deprecated-namespace",
-    ),
-    LegacyShim(
-        path="latticeai/brain/ingest.py",
-        owner="lattice_brain.graph.ingest",
-        replacement="from lattice_brain.graph.ingest import KnowledgeGraphIngestMixin",
-        reason="The deprecated latticeai.brain namespace remains for package users.",
-        removal_phase="major-release-after-8.x",
+        path="latticeai/brain/",
+        owner="lattice_brain",
+        replacement="import lattice_brain",
+        reason="The deprecated latticeai.brain namespace completed its window; removed in 8.8.0.",
+        removal_phase="removed-8.8.0",
         layer="deprecated-namespace",
+        status="removed",
     ),
     LegacyShim(
         path="latticeai/services/agent_runtime.py",
         owner="lattice_brain.runtime.agent_runtime",
         replacement="from lattice_brain.runtime.agent_runtime import AgentRuntime",
-        reason="Service-layer imports existed before AgentRuntime moved into Brain runtime.",
-        removal_phase="major-release-after-8.x",
+        reason="The service-layer alias completed its window; removed in 8.8.0.",
+        removal_phase="removed-8.8.0",
         layer="service-alias",
+        status="removed",
     ),
 ]
 
@@ -152,23 +158,28 @@ def legacy_shim_report(root: Path | None = None) -> Dict[str, Any]:
         root = Path(__file__).resolve().parents[2]
     entries = [shim.as_dict() for shim in LEGACY_SHIMS]
     missing = [shim.path for shim in LEGACY_SHIMS if not (root / shim.path).exists()]
+    lingering = [shim.path for shim in REMOVED_SHIMS if (root / shim.path).exists()]
     phases = sorted({shim.removal_phase for shim in LEGACY_SHIMS})
     layers = sorted({shim.layer for shim in LEGACY_SHIMS})
     return {
         "schema_version": "legacy-compatibility/v1",
         "version_target": LEGACY_COMPATIBILITY_VERSION,
-        "status": "managed" if not missing else "incomplete",
+        "status": "managed" if not missing and not lingering else "incomplete",
         "remaining_count": len(LEGACY_SHIMS),
+        "removed_count": len(REMOVED_SHIMS),
         "missing": missing,
+        "lingering": lingering,
         "removal_phases": phases,
         "layers": layers,
         "shims": entries,
+        "removed": [shim.as_dict() for shim in REMOVED_SHIMS],
     }
 
 
 __all__ = [
     "LEGACY_COMPATIBILITY_VERSION",
     "LEGACY_SHIMS",
+    "REMOVED_SHIMS",
     "LegacyShim",
     "legacy_shim_report",
 ]

package/latticeai/core/marketplace.py

@@ -11,7 +11,7 @@ from copy import deepcopy
 from typing import Any, Dict, List, Optional
 
 
-MARKETPLACE_VERSION = "8.7.0"
+MARKETPLACE_VERSION = "8.8.0"
 TEMPLATE_KINDS = ("plugin", "workflow", "agent")
 
 

package/latticeai/core/workspace_os.py

@@ -49,7 +49,7 @@ __all__ = [
     "remove_skill_directory",
 ]
 
-WORKSPACE_OS_VERSION = "8.7.0"
+WORKSPACE_OS_VERSION = "8.8.0"
 
 # Workspace types separate single-user Personal workspaces from shared
 # Organization workspaces. Both keep the same local-first JSON store; the type

package/latticeai/runtime/persistence_runtime.py

@@ -27,7 +27,7 @@ def build_persistence_runtime(
     import os
     from pathlib import Path
 
-    from lattice_brain.identity import DeviceIdentity
+    from lattice_brain.graph.identity import DeviceIdentity
     from lattice_brain.ingestion import IngestionPipeline
     from lattice_brain.portability import KGPortabilityService
     from latticeai.core.agent_registry import AgentRegistry

package/latticeai/runtime/platform_services_runtime.py

@@ -30,7 +30,7 @@ def build_brain_network(
 ) -> Any:
     """Construct peer sync/network service for brain portability routes."""
 
-    from lattice_brain.network import BrainNetwork
+    from lattice_brain.graph.network import BrainNetwork
 
     return BrainNetwork(
         identity=identity,

package/latticeai/services/architecture_readiness.py

@@ -1,6 +1,6 @@
 """Machine-checkable architecture readiness gates for release work.
 
-8.7.0 keeps the major architecture priorities under an explicit release
+8.8.0 keeps the major architecture priorities under an explicit release
 contract while product maturity work reduces visible beta seams. AgentRuntime, ToolRegistry,
 central Config, decomposed server runtime, and Knowledge Graph stabilization
 must remain discoverable, ordered, and backed by tests before the release can be
@@ -17,7 +17,7 @@ from typing import Any, Dict, List
 from latticeai.core.legacy_compatibility import legacy_shim_report
 
 
-ARCHITECTURE_VERSION_TARGET = "8.7.0"
+ARCHITECTURE_VERSION_TARGET = "8.8.0"
 
 PREFERRED_REFACTORING_ORDER = [
     "agent-runtime",

package/latticeai/services/memory_service.py

@@ -533,6 +533,10 @@ class MemoryService:
                 "title": item.get("title"),
                 "snippet": item.get("snippet"),
                 "score": item.get("score", 0),
+                # Evidence explainability: why this item was recalled, so the
+                # citation UI can show the matched terms instead of a bare score.
+                "matched_terms": item.get("matched_terms") or [],
+                "confidence": item.get("confidence") or "low",
             }
             for item in recall.get("results", [])[: max(1, min(limit, 8))]
         ]
@@ -616,15 +620,17 @@ class MemoryService:
         q = str(query or "").strip()
         query_tokens = [tok for tok in q.lower().split() if tok]
 
-        def _lexical_score(*texts: Any) -> float:
+        def _matched_terms(*texts: Any) -> List[str]:
+            haystack = " ".join(str(t or "") for t in texts).lower()
+            return [tok for tok in query_tokens if tok in haystack]
+
+        def _lexical_score(matched: List[str]) -> float:
             # Honest, comparable relevance: fraction of query tokens present.
             # Both tiers share this scorer so the cross-tier ranking is real,
             # not an artifact of per-tier constants.
             if not query_tokens:
                 return 0.0
-            haystack = " ".join(str(t or "") for t in texts).lower()
-            hits = sum(1 for tok in query_tokens if tok in haystack)
-            return round(hits / len(query_tokens), 4)
+            return round(len(matched) / len(query_tokens), 4)
 
         results: List[Dict[str, Any]] = []
 
@@ -633,13 +639,15 @@ class MemoryService:
         except Exception:
             mem = []
         for m in mem:
+            matched = _matched_terms(m.get("content"), " ".join(m.get("tags") or []), m.get("kind"))
             results.append({
                 "source": "workspace",
                 "id": m.get("id"),
                 "title": (m.get("kind") or "memory"),
                 "snippet": str(m.get("content") or "")[:240],
                 "kind": m.get("kind"),
-                "score": _lexical_score(m.get("content"), " ".join(m.get("tags") or []), m.get("kind")),
+                "score": _lexical_score(matched),
+                "matched_terms": matched,
                 "tags": m.get("tags") or [],
             })
 
@@ -650,17 +658,40 @@ class MemoryService:
             except Exception:
                 hits = []
             for hit in hits[:limit]:
+                matched = _matched_terms(hit.get("title"), hit.get("name"), hit.get("summary"), hit.get("content"))
                 results.append({
                     "source": "graph",
                     "id": hit.get("id") or hit.get("node_id"),
                     "title": hit.get("title") or hit.get("name") or "node",
                     "snippet": str(hit.get("summary") or hit.get("content") or "")[:240],
                     "kind": hit.get("type") or "node",
-                    "score": _lexical_score(hit.get("title"), hit.get("name"), hit.get("summary"), hit.get("content")),
+                    "score": _lexical_score(matched),
+                    "matched_terms": matched,
                 })
 
+        # Quality gate: when at least one result carries real lexical evidence,
+        # zero-score rows are noise relative to it and are dropped. When nothing
+        # scores (e.g. tokenization mismatch), everything is kept so the tiers'
+        # own search filters still decide — the gate never empties a recall.
+        candidates = len(results)
+        if query_tokens and any(r.get("score", 0) > 0 for r in results):
+            results = [r for r in results if r.get("score", 0) > 0]
+        for r in results:
+            r["confidence"] = "high" if r.get("score", 0) >= 0.65 else "medium" if r.get("score", 0) >= 0.3 else "low"
+
         results.sort(key=lambda r: r.get("score", 0), reverse=True)
-        return {"query": q, "results": results[: max(1, min(limit, 100))], "count": len(results), "source": "live"}
+        return {
+            "query": q,
+            "results": results[: max(1, min(limit, 100))],
+            "count": len(results),
+            "source": "live",
+            "quality_gate": {
+                "candidates": candidates,
+                "passed": len(results),
+                "filtered": candidates - len(results),
+                "gate": "lexical-evidence/v1",
+            },
+        }
 
     # ── inspect a single tier ─────────────────────────────────────────────
     def inspect(self, source: str, *, user_email: Optional[str] = None, workspace_id: Optional[str] = None, limit: int = 50) -> Dict[str, Any]:

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 = "8.7.0"
+PRODUCT_VERSION_TARGET = "8.8.0"
 
 
 @dataclass(frozen=True)
@@ -76,10 +76,10 @@ PRODUCT_GATES: List[ProductGate] = [
         evidence=[
             "package.json::release:artifacts",
             "package.json::release:validate",
-            "README.md::dist/ltcai-8.7.0-py3-none-any.whl",
-            "README.md::dist/ltcai-8.7.0.tar.gz",
-            "README.md::dist/ltcai-8.7.0.vsix",
-            "README.md::ltcai-8.7.0.tgz",
+            "README.md::dist/ltcai-8.8.0-py3-none-any.whl",
+            "README.md::dist/ltcai-8.8.0.tar.gz",
+            "README.md::dist/ltcai-8.8.0.vsix",
+            "README.md::ltcai-8.8.0.tgz",
             "scripts/validate_release_artifacts.py",
             "scripts/release_smoke.py",
             "Dockerfile",
@@ -95,12 +95,12 @@ PRODUCT_GATES: List[ProductGate] = [
         title="Release story is documented and honest",
         evidence=[
             "README.md",
-            "README.md::The current release is **8.7.0",
-            "SECURITY.md::8.7.x (latest)",
-            "vscode-extension/README.md::**8.7.0",
-            "docs/CHANGELOG.md::## [8.7.0]",
+            "README.md::The current release is **8.8.0",
+            "SECURITY.md::8.8.x (latest)",
+            "vscode-extension/README.md::**8.8.0",
+            "docs/CHANGELOG.md::## [8.8.0]",
             "FEATURE_STATUS.md",
-            "RELEASE_NOTES_v8.7.0.md",
+            "RELEASE_NOTES_v8.8.0.md",
             "latticeai/core/agent.py::SingleAgentRuntime",
             "latticeai/core/agent.py::AgentRuntime = SingleAgentRuntime",
             "lattice_brain/runtime/contracts.py::runtime-boundary/v1",
@@ -115,7 +115,7 @@ PRODUCT_GATES: List[ProductGate] = [
         id="ecosystem-path",
         title="Community and plugin growth path is explicit",
         evidence=[
-            "docs/COMMUNITY_AND_PLUGINS.md::8.7.0",
+            "docs/COMMUNITY_AND_PLUGINS.md::8.8.0",
             "docs/PLUGIN_SDK.md",
             "plugins/README.md",
             "plugins/hello-world/plugin.json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ltcai",
-  "version": "8.7.0",
+  "version": "8.8.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/src-tauri/Cargo.lock

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

package/src-tauri/Cargo.toml

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

package/static/app/asset-manifest.json

@@ -1,19 +1,19 @@
 {
-  "version": "8.7.0",
+  "version": "8.8.0",
   "generated_at": "vite",
   "entrypoints": {
-    "app": "/static/app/assets/index-Bh7IIlyY.js"
+    "app": "/static/app/assets/index--P0ksosz.js"
   },
   "assets": {
     "../node_modules/@tauri-apps/api/core.js": "/static/app/assets/core-CwxXejkd.js",
-    "_primitives-BywkNS3f.js": "/static/app/assets/primitives-BywkNS3f.js",
-    "_textarea-CQ61Rycp.js": "/static/app/assets/textarea-CQ61Rycp.js",
-    "index.html": "/static/app/assets/index-Bh7IIlyY.js",
-    "assets/index-_M5aCv21.css": "/static/app/assets/index-_M5aCv21.css",
-    "src/pages/Act.tsx": "/static/app/assets/Act-_U7mhXir.js",
-    "src/pages/Brain.tsx": "/static/app/assets/Brain-BxyTHZ21.js",
-    "src/pages/Capture.tsx": "/static/app/assets/Capture-DyDKWNh9.js",
-    "src/pages/Library.tsx": "/static/app/assets/Library-DJ8KioFM.js",
-    "src/pages/System.tsx": "/static/app/assets/System-C0FIb3OO.js"
+    "_primitives-BLqaKk5g.js": "/static/app/assets/primitives-BLqaKk5g.js",
+    "_textarea-CVQkN2Tk.js": "/static/app/assets/textarea-CVQkN2Tk.js",
+    "index.html": "/static/app/assets/index--P0ksosz.js",
+    "assets/index-DCh5AoXt.css": "/static/app/assets/index-DCh5AoXt.css",
+    "src/pages/Act.tsx": "/static/app/assets/Act-C7K9wsO9.js",
+    "src/pages/Brain.tsx": "/static/app/assets/Brain-I1OSzxJu.js",
+    "src/pages/Capture.tsx": "/static/app/assets/Capture-B3V4_5Xp.js",
+    "src/pages/Library.tsx": "/static/app/assets/Library-Cgj-EF50.js",
+    "src/pages/System.tsx": "/static/app/assets/System-D1Lkei3I.js"
   }
 }