ltcai 8.0.0 → 8.1.0

package/README.md

@@ -64,9 +64,9 @@ You need Lattice AI when:
 
 ## Living Brain Flow
 
-The screenshots below are release evidence captures. The 8.0 line keeps the
-same first-run flow and rebuilds the Brain Chat Home layout so chat and the
-composer are the first visible action.
+The screenshots below are release evidence captures. The 8.1 line keeps the
+first-run flow and refreshes Brain Home so the living Brain, recent memory,
+next action, and composer are understandable in one glance.
 
 ### 1. Wake Brain
 
@@ -78,43 +78,36 @@ confirm owner, check the computer, choose the Brain voice.
 Choose the owner of the Brain. The profile is not a SaaS account by default; it
 is the local identity for the knowledge you keep.
 
-![Login](output/release/v7.8.0/screenshots/01-login.png)
+![Login](output/release/v8.1.0/screenshots/01-login.png)
 
-### 3. Environment Analysis
-
-See what kind of local AI experience this computer can support before choosing a
-model.
-
-![Environment Analysis](output/release/v7.8.0/screenshots/02-environment-analysis.png)
-
-### 4. Recommended Models
+### 3. Recommended Models
 
 Start with a short list: safest recommendation, faster model, stronger model.
 Advanced details stay available without overwhelming first-time users.
 
-![Recommended Models](output/release/v7.8.0/screenshots/03-recommended-models.png)
+![Recommended Models](output/release/v8.1.0/screenshots/02-recommended-models.png)
 
-### 5. Install And Load
+### 4. Install And Load
 
 Download and load only after consent. Lattice explains model size, local
 execution, and network use before work starts.
 
-![Install and Load](output/release/v7.8.0/screenshots/04-install-load-progress.png)
+![Install and Load](output/release/v8.1.0/screenshots/03-install-load-progress.png)
 
-### 6. Brain Chat
+### 5. Brain Chat
 
 Talk normally. Useful decisions and context become memory, then appear later as
 topics, relationships, graph structure, and the concentric memory rings around
 the Brain.
 
-![Brain Chat Home](output/release/v7.8.0/screenshots/05-brain-chat-home.png)
+![Brain Chat Home](output/release/v8.1.0/screenshots/04-brain-chat-home.png)
 
-### 7. Review Center
+### 6. Review Center
 
 Automation results are staged for review before they become durable decisions.
 Snooze, unsnooze, run now, approve, and dismiss actions stay explicit.
 
-![Review Center](output/release/v7.8.0/screenshots/13-review-center.png)
+![Review Center](output/release/v8.1.0/screenshots/12-review-center.png)
 
 ## Brain Depths
 
@@ -130,10 +123,10 @@ The user travels inward from everyday memory to deeper structure:
 
 Walkthrough:
 
-![v7.8.0 Living Brain walkthrough](output/release/v7.8.0/gifs/v7.8.0-living-brain-walkthrough.gif)
+![v8.1.0 Living Brain walkthrough](output/release/v8.1.0/gifs/v8.1.0-living-brain-walkthrough.gif)
 
 Screenshot index and capture notes:
-[output/release/v7.8.0/SCREENSHOT_INDEX.md](output/release/v7.8.0/SCREENSHOT_INDEX.md)
+[output/release/v8.1.0/SCREENSHOT_INDEX.md](output/release/v8.1.0/SCREENSHOT_INDEX.md)
 
 ## Install
 
@@ -210,39 +203,27 @@ See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for developer workflow details.
 
 ## Current Release
 
-The current release is **8.0.0 — Runtime Architecture Contract**:
-
-- `architecture_readiness()` now emits `lattice-architecture-contract/v1`,
-  including the preferred refactoring order and concrete ownership for
-  AgentRuntime, ToolRegistry, central Config, server decomposition, and KG
-  hardening.
-- The product AgentRuntime facade in `lattice_brain.runtime.agent_runtime`
-  remains the unambiguous `/agents` execution and observability boundary.
-- ToolRegistry manifest output now carries `tool-registry-contract/v1` with
-  dispatch, policy, and permission ownership, so runtime/admin surfaces can
-  detect catalog drift from one source of truth.
-- Knowledge Graph hardening is represented as an additive reprojection strategy
-  with legacy read compatibility and non-destructive rollback/export paths.
-- KG v2 read-equivalence is locked for document listing, node lookup,
-  relationship search, and traversal, while logical imports preserve colliding
-  legacy edge labels without breaking native canonical dedupe.
-- Product readiness is machine-checkable through `product_readiness()`, which
-  composes the architecture contract with exact artifact/docs/workflow evidence.
-- CI and release workflows continue to run frontend lint/typecheck/build gates
-  plus the 8.0 product readiness score before a tag can be treated as release-safe.
-
-Expected artifacts for 8.0.0 release must use exact filenames:
-
-- `dist/ltcai-8.0.0-py3-none-any.whl`
-- `dist/ltcai-8.0.0.tar.gz`
-- `ltcai-8.0.0.tgz`
-- `dist/ltcai-8.0.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_8.0.0_aarch64.dmg`
+The current release is **8.1.0 — Intuitive Brain Home**:
+
+- Brain Home now opens with the living Brain directly above the conversation composer, so the primary action is visible before users read any utility panels.
+- The previous dashboard-style growth strip is replaced by a product narrative: Brain state, what was just remembered, the strongest connected topic, and the next best action.
+- Primary actions are explicit and click-tested: talk to Brain, add sources, or open the memory graph.
+- Mobile and narrow layouts keep the Brain and composer in the first viewport, avoiding the previous clipped/overcrowded first screen.
+- The 8.0 runtime architecture contract remains active: AgentRuntime, ToolRegistry, Config, server decomposition, and KG hardening stay machine-checkable through readiness gates.
+- CI and release workflows continue to run frontend lint/typecheck/build gates plus product readiness before a tag can be treated as release-safe.
+
+Expected artifacts for 8.1.0 release must use exact filenames:
+
+- `dist/ltcai-8.1.0-py3-none-any.whl`
+- `dist/ltcai-8.1.0.tar.gz`
+- `ltcai-8.1.0.tgz`
+- `dist/ltcai-8.1.0.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_8.1.0_aarch64.dmg`
 
 Do not use wildcard artifact uploads. Package registry publishing remains owner-run.
 
 See [docs/ROADMAP_RECOMMENDATIONS.md](docs/ROADMAP_RECOMMENDATIONS.md) for the
-strategic roadmap slices applied through 8.0.0 and the follow-up tracks.
+strategic roadmap slices applied through 8.1.0 and the follow-up tracks.
 
 ## Known Limitations
 
@@ -259,6 +240,7 @@ strategic roadmap slices applied through 8.0.0 and the follow-up tracks.
 
 | Version | Theme |
 | --- | --- |
+| 8.1.0 | Intuitive Brain Home: living Brain, recent memory, connected topic, next action, and composer are visible in one product-first screen with refreshed 8.1.0 evidence and artifacts |
 | 8.0.0 | Runtime Architecture Contract: AgentRuntime, ToolRegistry, central Config, server decomposition, and KG hardening are captured as machine-checkable release boundaries with exact 8.0.0 artifacts |
 | 7.9.0 | Agent Runtime Boundary Hardening: explicit `SingleAgentRuntime`, compatibility alias preservation, injected rollback port, and release/readiness docs aligned to the product AgentRuntime facade |
 | 7.8.0 | Brain Chat Home UX Simplification: chat-first first viewport, visible workspace navigation, collapsed source/status utilities, hidden default depth controls, and removal of obsolete Brain UX components |

package/docs/CHANGELOG.md

@@ -6,6 +6,20 @@ existed at that release.
 
 ## [Unreleased]
 
+## [8.1.0] - 2026-06-27
+
+### Changed
+- Rebuilt Brain Home around an intuitive first screen with LivingBrain, recent
+  memory, connected topic, next-best action, and the composer visible together.
+- Replaced dashboard-style Brain growth metrics with narrative, product-facing
+  copy and focused primary actions.
+- Tightened mobile and narrow viewport behavior so the Brain and composer remain
+  visible without horizontal overflow.
+- Refreshed release screenshots, walkthrough GIF/WebM, static app assets, and
+  exact 8.1.0 artifact metadata.
+- Synchronized Python, npm, VS Code extension, Tauri, workspace, readiness, and
+  current-release documentation versions to 8.1.0.
+
 ## [8.0.0] - 2026-06-24
 
 ### Changed

package/docs/V3_FRONTEND.md

@@ -1,10 +1,15 @@
 # Lattice AI v3 — Frontend Product Shell
 
+> Historical v3 shell notes. The current product shell is the React/Vite app
+> built from `frontend/` into `static/app/` with `npm run build:assets`; current
+> linting uses `scripts/lint_frontend.mjs`.
+
 > A token-native single-page workspace shell for Lattice AI v3. It ships as the
 > primary product experience and calls the real v3 retrieval/chat APIs while
 > rendering clear unavailable states for local services that are not running.
 
 Entry point: **`/app`** (served by `latticeai/api/static_routes.py` →
+the current `static/app/index.html` bundle; the historical v3 shell used
 `static/v3/index.html`). Login, auto-login after registration, SSO callback, and
 the PWA manifest land on `/app`. Legacy multi-page static screens have been
 deleted; compatibility routes (`/workspace`, `/chat`, `/graph`, `/admin`, …)
@@ -27,7 +32,8 @@ Deep-linking into an `admin/*` route auto-promotes the shell to Admin mode.
 
 ## Information architecture
 
-One declarative table (`static/v3/js/core/routes.js`) drives the nav rail, the
+One declarative table (historically `static/v3/js/core/routes.js`, now
+represented by the React routes under `frontend/src/`) drives the nav rail, the
 command palette, the router, breadcrumbs, and lazy view loading.
 
 ```
@@ -50,8 +56,8 @@ Administration Users · Permissions · Audit Logs · Security · Policies · Pri
 Token-native, layered on the existing **single color source**
 (`static/css/tokens.css`, `data-lt-theme` light/dark). No legacy override layers
 (`responsive.css` / `workspace.css` / `platform.css`) are loaded by v3.
-Runtime assets are loaded through `static/v3/asset-manifest.json`; the build
-step writes hashed CSS/JS siblings and `/app` reads the manifest instead of
+Runtime assets are loaded through `static/app/asset-manifest.json`; the build
+step writes hashed CSS/JS assets and `/app` reads the manifest instead of
 using manual `?v=` query strings.
 
 | File | Responsibility |
@@ -133,8 +139,8 @@ focus rings, skip link, keyboard command palette (⌘K / Ctrl-K).
 
 ## Validation
 
-- `npm run lint` (extended to cover `static/v3/**` via `scripts/lint_v3.mjs`).
-- `npm run build:assets` (writes hashed v3 assets and `asset-manifest.json`).
+- `npm run lint` (covers the current frontend through `scripts/lint_frontend.mjs`).
+- `npm run build:assets` (writes hashed `static/app` assets and `asset-manifest.json`).
 - `npm run test:visual` (`tests/visual/v3.spec.js` against the mock server, which
   serves `/app` and mocks the future API surfaces).
 - Browser-rendered smoke checks of every route in light and dark themes.

package/lattice_brain/__init__.py

@@ -26,7 +26,7 @@ from .storage import (
     storage_from_env,
 )
 
-__version__ = "8.0.0"
+__version__ = "8.1.0"
 
 __all__ = [
     "AgentRuntime",

package/lattice_brain/embeddings.py

@@ -15,6 +15,10 @@ DEFAULT_EMBEDDING_DIM = int(os.getenv("LATTICEAI_VECTOR_DIM", "384"))
 EMBEDDING_MODEL_ID = f"lattice-local-hash-v1:{DEFAULT_EMBEDDING_DIM}"
 
 
+def embedding_model_id(dim: int) -> str:
+    return f"lattice-local-hash-v1:{int(dim)}"
+
+
 def _tokenize(text: str) -> List[str]:
     raw = str(text or "").lower()
     tokens = re.findall(r"[a-z0-9][a-z0-9_.:/+-]{1,}|[가-힣]{2,}", raw)
@@ -49,6 +53,10 @@ class LocalEmbeddingModel:
     dim: int = DEFAULT_EMBEDDING_DIM
     model_id: str = EMBEDDING_MODEL_ID
 
+    def __post_init__(self) -> None:
+        if self.model_id == EMBEDDING_MODEL_ID and self.dim != DEFAULT_EMBEDDING_DIM:
+            object.__setattr__(self, "model_id", embedding_model_id(self.dim))
+
     def embed(self, text: str) -> List[float]:
         vector = [0.0] * self.dim
         features = _tokenize(text)
@@ -79,4 +87,4 @@ class LocalEmbeddingModel:
         return list(struct.unpack(f"<{count}f", payload[: count * 4]))
 
 
-__all__ = ["DEFAULT_EMBEDDING_DIM", "EMBEDDING_MODEL_ID", "LocalEmbeddingModel"]
+__all__ = ["DEFAULT_EMBEDDING_DIM", "EMBEDDING_MODEL_ID", "LocalEmbeddingModel", "embedding_model_id"]

package/lattice_brain/runtime/multi_agent.py

@@ -21,7 +21,7 @@ from typing import Any, Callable, Dict, List, Optional
 from .contracts import multi_agent_contract
 
 
-MULTI_AGENT_VERSION = "8.0.0"
+MULTI_AGENT_VERSION = "8.1.0"
 
 AGENT_ROLES = ("researcher", "planner", "executor", "reviewer", "release")
 CORE_PIPELINE = ("planner", "executor", "reviewer")

package/latticeai/__init__.py

@@ -1,3 +1,3 @@
 """Lattice AI - modular server package."""
 
-__version__ = "8.0.0"
+__version__ = "8.1.0"

package/latticeai/app_factory.py

@@ -77,8 +77,6 @@ def _build(config: "Optional[Config]" = None) -> Dict[str, Any]:
     import re
     import secrets
     import threading
-    import subprocess
-    import sys
     import time
     from pathlib import Path
 
@@ -195,8 +193,10 @@ def _build(config: "Optional[Config]" = None) -> Dict[str, Any]:
     )
     from latticeai.core.tool_registry import TOOL_CATALOG_BRIEF as _TOOL_CATALOG_BRIEF  # noqa: F401
     from latticeai.core.mcp_registry import (
-        _get_combined_registry,
-        _fetch_skills_marketplace, install_skill, SKILLS_DIR,
+        _fetch_skills_marketplace,
+        install_skill,
+        SKILLS_DIR,
+        create_mcp_install_state,
     )
     from latticeai.services.p_reinforce import PReinforceGardener
     from setup_wizard import get_recommendations, scan_environment
@@ -322,6 +322,15 @@ def _build(config: "Optional[Config]" = None) -> Dict[str, Any]:
     MCP_FILE = DATA_DIR / "mcp_installs.json"
     AUDIT_FILE = DATA_DIR / "audit_log.json"
     SSO_FILE = DATA_DIR / "sso_config.json"
+
+    # MCP state extracted to mcp_registry.create_mcp_install_state (server decomp)
+    _mcp_state = create_mcp_install_state(DATA_DIR)
+    load_mcp_installs = _mcp_state["load_mcp_installs"]
+    save_mcp_installs = _mcp_state["save_mcp_installs"]
+    mcp_public_item = _mcp_state["mcp_public_item"]
+    recommend_mcps = _mcp_state["recommend_mcps"]
+    install_mcp = _mcp_state["install_mcp"]
+
     # Resolve the configured embedding provider once at startup. Degrades to the
     # offline hash fallback when the requested provider is unavailable, while
     # recording the requested-vs-active provider for the Embeddings status surface.
@@ -546,136 +555,6 @@ def _build(config: "Optional[Config]" = None) -> Dict[str, Any]:
         with open(VPC_FILE, "w", encoding="utf-8") as f:
             json.dump(config, f, ensure_ascii=False, indent=2)
 
-    def load_mcp_installs() -> Dict:
-        if not os.path.exists(MCP_FILE):
-            return {"installed": {}, "updated_at": None}
-        try:
-            with open(MCP_FILE, "r", encoding="utf-8") as f:
-                data = json.load(f)
-            if "installed" not in data:
-                data["installed"] = {}
-            return data
-        except Exception as e:
-            logging.warning("load_mcp_installs failed: %s", e)
-            return {"installed": {}, "updated_at": None}
-
-    def save_mcp_installs(data: Dict):
-        data["updated_at"] = datetime.now().isoformat()
-        with open(MCP_FILE, "w", encoding="utf-8") as f:
-            json.dump(data, f, ensure_ascii=False, indent=2)
-
-    def mcp_public_item(item: Dict, installed_state: Dict) -> Dict:
-        state = installed_state.get(item["id"]) or {}
-        installed = item["install_mode"] in {"builtin", "bundled"} or bool(state.get("installed"))
-        connector_pending = item["install_mode"] == "connector" and not state.get("authenticated")
-        authenticated = item["install_mode"] != "connector" or bool(state.get("authenticated"))
-        return {
-            "id": item["id"],
-            "name": item["name"],
-            "category": item.get("category", ""),
-            "install_mode": item["install_mode"],
-            "description": item.get("description", ""),
-            "capabilities": item.get("capabilities", []),
-            "connector_url": item.get("connector_url"),
-            "external_url": item.get("external_url"),
-            "package": item.get("package"),
-            "homepage": item.get("homepage"),
-            "source": item.get("source", "local"),
-            "installed": installed,
-            "status": state.get("status") or ("active" if installed and not connector_pending else "needs_auth" if connector_pending else "available"),
-            "authenticated": authenticated,
-            "updated_at": state.get("updated_at"),
-        }
-
-    async def recommend_mcps(query: str, limit: int = 5) -> List[Dict]:
-        text = (query or "").lower()
-        installed = load_mcp_installs().get("installed", {})
-        registry = await _get_combined_registry()
-        scored = []
-        for item in registry:
-            score = 0
-            hits = []
-            for keyword in item.get("keywords", []):
-                if keyword.lower() in text:
-                    score += 3 if len(keyword) > 2 else 1
-                    hits.append(keyword)
-            # description 키워드 매칭 (remote 항목 보완)
-            if not hits and text:
-                desc_words = item.get("description", "").lower().split()
-                for word in text.split():
-                    if len(word) > 2 and word in desc_words:
-                        score += 1
-                        hits.append(word)
-            if item["id"] == "filesystem" and any(word in text for word in ["만들", "구현", "build", "deploy", "코드", "앱"]):
-                score += 2
-            if score:
-                public = mcp_public_item(item, installed)
-                public["score"] = score
-                public["matched_keywords"] = hits[:6]
-                scored.append(public)
-        if not scored:
-            fallback_ids = ["filesystem", "browser", "documents"]
-            scored = [
-                {**mcp_public_item(item, installed), "score": 1, "matched_keywords": []}
-                for item in registry
-                if item["id"] in fallback_ids
-            ]
-        return sorted(scored, key=lambda item: item["score"], reverse=True)[: max(1, min(limit, 24))]
-
-    async def install_mcp(mcp_id: str) -> Dict:
-        registry = await _get_combined_registry()
-        item = next((entry for entry in registry if entry["id"] == mcp_id), None)
-        if not item:
-            raise HTTPException(status_code=404, detail="MCP를 찾을 수 없습니다.")
-        data = load_mcp_installs()
-        state = data.setdefault("installed", {})
-        status = "active"
-        message = "MCP가 활성화되었습니다."
-        if item["install_mode"] == "connector":
-            status = "needs_auth"
-            message = "커넥터 인증이 필요합니다. Codex 앱의 connector 설정에서 계정을 연결하면 바로 사용할 수 있습니다."
-        elif item["install_mode"] == "pip":
-            packages = item.get("pip_packages") or []
-            for pkg in packages:
-                completed = subprocess.run(
-                    [sys.executable, "-m", "pip", "install", "--upgrade", pkg],
-                    capture_output=True, text=True, timeout=900, check=False,
-                )
-                if completed.returncode != 0:
-                    raise HTTPException(status_code=500, detail=completed.stderr[-2000:] or f"{pkg} 설치 실패")
-            message = f"필수 패키지 설치 완료: {', '.join(packages)}"
-        elif item["install_mode"] == "pypi":
-            pkg = item.get("package", "")
-            version = item.get("package_version")
-            pkg_str = f"{pkg}=={version}" if version else pkg
-            completed = subprocess.run(
-                [sys.executable, "-m", "pip", "install", pkg_str],
-                capture_output=True, text=True, timeout=300, check=False,
-            )
-            if completed.returncode != 0:
-                raise HTTPException(status_code=500, detail=completed.stderr[-2000:] or f"{pkg} 설치 실패")
-            message = f"pip 패키지 설치 완료: {pkg_str}"
-        elif item["install_mode"] == "npm":
-            pkg = item.get("package", "")
-            version = item.get("package_version")
-            pkg_str = f"{pkg}@{version}" if version else pkg
-            completed = subprocess.run(
-                ["npm", "install", "-g", pkg_str],
-                capture_output=True, text=True, timeout=300, check=False,
-            )
-            if completed.returncode != 0:
-                raise HTTPException(status_code=500, detail=completed.stderr[-2000:] or f"{pkg} 설치 실패")
-            message = f"npm 패키지 설치 완료: {pkg_str}"
-        state[mcp_id] = {
-            "installed": True,
-            "status": status,
-            "authenticated": item["install_mode"] != "connector",
-            "updated_at": datetime.now().isoformat(),
-        }
-        save_mcp_installs(data)
-        public = mcp_public_item(item, state)
-        public["message"] = message
-        return public
 
     _history_lock = threading.Lock()
 

package/latticeai/core/local_embeddings.py

@@ -23,6 +23,10 @@ DEFAULT_EMBEDDING_DIM = 384
 EMBEDDING_MODEL_ID = f"lattice-local-hash-v1:{DEFAULT_EMBEDDING_DIM}"
 
 
+def embedding_model_id(dim: int) -> str:
+    return f"lattice-local-hash-v1:{int(dim)}"
+
+
 def _tokenize(text: str) -> List[str]:
     raw = str(text or "").lower()
     tokens = re.findall(r"[a-z0-9][a-z0-9_.:/+-]{1,}|[가-힣]{2,}", raw)
@@ -57,6 +61,10 @@ class LocalEmbeddingModel:
     dim: int = DEFAULT_EMBEDDING_DIM
     model_id: str = EMBEDDING_MODEL_ID
 
+    def __post_init__(self) -> None:
+        if self.model_id == EMBEDDING_MODEL_ID and self.dim != DEFAULT_EMBEDDING_DIM:
+            object.__setattr__(self, "model_id", embedding_model_id(self.dim))
+
     def embed(self, text: str) -> List[float]:
         vector = [0.0] * self.dim
         features = _tokenize(text)

package/latticeai/core/marketplace.py

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

package/latticeai/core/mcp_registry.py

@@ -6,9 +6,12 @@ Extracted from server.py to reduce module size.
 
 import json
 import logging
+import os
+import subprocess
+import sys
 from datetime import datetime, timedelta
 from pathlib import Path
-from typing import Dict, List, Optional
+from typing import Callable, Dict, List, Optional
 
 import httpx
 from fastapi import HTTPException
@@ -789,3 +792,139 @@ async def install_skill(plugin: str, skill: str) -> Dict:
         "license": entry["license"],
         "author":  entry["author"],
     }
+
+
+def create_mcp_install_state(data_dir: Path) -> Dict[str, Callable]:
+    """Return bound MCP state helpers for given data_dir. No global side effects."""
+    MCP_FILE = Path(data_dir) / "mcp_installs.json"
+
+    def load_mcp_installs() -> Dict:
+        if not os.path.exists(MCP_FILE):
+            return {"installed": {}, "updated_at": None}
+        try:
+            with open(MCP_FILE, "r", encoding="utf-8") as f:
+                data = json.load(f)
+            if "installed" not in data:
+                data["installed"] = {}
+            return data
+        except Exception as e:
+            logging.warning("load_mcp_installs failed: %s", e)
+            return {"installed": {}, "updated_at": None}
+
+    def save_mcp_installs(data: Dict) -> None:
+        data["updated_at"] = datetime.now().isoformat()
+        with open(MCP_FILE, "w", encoding="utf-8") as f:
+            json.dump(data, f, ensure_ascii=False, indent=2)
+
+    def mcp_public_item(item: Dict, installed_state: Dict) -> Dict:
+        state = installed_state.get(item.get("id"), {}) or {}
+        installed = item.get("install_mode") in {"builtin", "bundled"} or bool(state.get("installed"))
+        connector_pending = item.get("install_mode") == "connector" and not state.get("authenticated")
+        authenticated = item.get("install_mode") != "connector" or bool(state.get("authenticated"))
+        return {
+            "id": item.get("id"),
+            "name": item.get("name"),
+            "category": item.get("category", ""),
+            "install_mode": item.get("install_mode"),
+            "description": item.get("description", ""),
+            "capabilities": item.get("capabilities", []),
+            "connector_url": item.get("connector_url"),
+            "external_url": item.get("external_url"),
+            "package": item.get("package"),
+            "homepage": item.get("homepage"),
+            "source": item.get("source", "local"),
+            "installed": installed,
+            "status": state.get("status") or ("active" if installed and not connector_pending else "needs_auth" if connector_pending else "available"),
+            "authenticated": authenticated,
+            "updated_at": state.get("updated_at"),
+        }
+
+    async def recommend_mcps(query: str, limit: int = 5) -> List[Dict]:
+        text = (query or "").lower()
+        installed = load_mcp_installs().get("installed", {})
+        registry = await _get_combined_registry()
+        scored: List[Dict] = []
+        for item in registry:
+            score = 0
+            hits: List[str] = []
+            for keyword in item.get("keywords", []):
+                if keyword.lower() in text:
+                    score += 3 if len(keyword) > 2 else 1
+                    hits.append(keyword)
+            if not hits and text:
+                desc_words = item.get("description", "").lower().split()
+                for word in text.split():
+                    if len(word) > 2 and word in desc_words:
+                        score += 1
+                        hits.append(word)
+            if item.get("id") == "filesystem" and any(w in text for w in ["만들", "구현", "build", "deploy", "코드", "앱"]):
+                score += 2
+            if score:
+                public = mcp_public_item(item, installed)
+                public["score"] = score
+                public["matched_keywords"] = hits[:6]
+                scored.append(public)
+        if not scored:
+            fallback_ids = ["filesystem", "browser", "documents"]
+            scored = [
+                {**mcp_public_item(item, installed), "score": 1, "matched_keywords": []}
+                for item in registry if item.get("id") in fallback_ids
+            ]
+        return sorted(scored, key=lambda x: x["score"], reverse=True)[:max(1, min(limit, 24))]
+
+    async def install_mcp(mcp_id: str) -> Dict:
+        registry = await _get_combined_registry()
+        item = next((entry for entry in registry if entry.get("id") == mcp_id), None)
+        if not item:
+            raise HTTPException(status_code=404, detail="MCP를 찾을 수 없습니다.")
+        data = load_mcp_installs()
+        state = data.setdefault("installed", {})
+        status = "active"
+        message = "MCP가 활성화되었습니다."
+        if item.get("install_mode") == "connector":
+            status = "needs_auth"
+            message = "커넥터 인증이 필요합니다. Codex 앱의 connector 설정에서 계정을 연결하면 바로 사용할 수 있습니다."
+        elif item.get("install_mode") == "pip":
+            packages = item.get("pip_packages") or []
+            for pkg in packages:
+                completed = subprocess.run(
+                    [sys.executable, "-m", "pip", "install", "--upgrade", pkg],
+                    capture_output=True, text=True, timeout=900, check=False,
+                )
+                if completed.returncode != 0:
+                    raise HTTPException(status_code=500, detail=(completed.stderr or "")[-2000:] or f"{pkg} 설치 실패")
+            message = f"필수 패키지 설치 완료: {', '.join(packages)}"
+        elif item.get("install_mode") == "pypi":
+            pkg = item.get("package", "")
+            version = item.get("package_version")
+            pkg_str = f"{pkg}=={version}" if version else pkg
+            completed = subprocess.run([sys.executable, "-m", "pip", "install", pkg_str], capture_output=True, text=True, timeout=300, check=False)
+            if completed.returncode != 0:
+                raise HTTPException(status_code=500, detail=(completed.stderr or "")[-2000:] or f"{pkg} 설치 실패")
+            message = f"pip 패키지 설치 완료: {pkg_str}"
+        elif item.get("install_mode") == "npm":
+            pkg = item.get("package", "")
+            version = item.get("package_version")
+            pkg_str = f"{pkg}@{version}" if version else pkg
+            completed = subprocess.run(["npm", "install", "-g", pkg_str], capture_output=True, text=True, timeout=300, check=False)
+            if completed.returncode != 0:
+                raise HTTPException(status_code=500, detail=(completed.stderr or "")[-2000:] or f"{pkg} 설치 실패")
+            message = f"npm 패키지 설치 완료: {pkg_str}"
+        state[mcp_id] = {
+            "installed": True,
+            "status": status,
+            "authenticated": item.get("install_mode") != "connector",
+            "updated_at": datetime.now().isoformat(),
+        }
+        save_mcp_installs(data)
+        public = mcp_public_item(item, state)
+        public["message"] = message
+        return public
+
+    return {
+        "load_mcp_installs": load_mcp_installs,
+        "save_mcp_installs": save_mcp_installs,
+        "mcp_public_item": mcp_public_item,
+        "recommend_mcps": recommend_mcps,
+        "install_mcp": install_mcp,
+    }

package/latticeai/core/workspace_os.py

@@ -21,7 +21,7 @@ from typing import Any, Callable, Dict, Iterable, List, Optional
 from lattice_brain.runtime.contracts import realtime_event_contract, run_record_contract, workflow_run_contract
 
 
-WORKSPACE_OS_VERSION = "8.0.0"
+WORKSPACE_OS_VERSION = "8.1.0"
 
 # Workspace types separate single-user Personal workspaces from shared
 # Organization workspaces. Both keep the same local-first JSON store; the type