ltcai 8.5.0 → 8.7.0

package/latticeai/services/model_runtime.py

@@ -16,6 +16,7 @@ import shutil
 import time
 import urllib.error
 import urllib.request
+import warnings
 from pathlib import Path
 from typing import AsyncIterator, Dict, List, Optional
 
@@ -100,6 +101,21 @@ class ModelRuntimeState:
         self.get_user_api_key = _missing_user_api_key
 
     def sync_to_module_globals(self):
+        """Sync to bare module globals for legacy external importers.
+
+        This is a compatibility surface only. Internal code should use STATE.
+        Emits DeprecationWarning (future removal in major after 8.x).
+        """
+        warnings.warn(
+            "sync_to_module_globals is a legacy compatibility shim and will be removed "
+            "after 8.x. Use latticeai.services.model_runtime.STATE or injected context instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        self._sync_globals()
+
+    def _sync_globals(self) -> None:
+        """Internal no-warning sync used at init."""
         global router, APP_MODE, DEFAULT_HOST, DEFAULT_PORT, DATA_DIR, BASE_DIR
         global ENABLE_TELEGRAM, ENABLE_GRAPH, AUTOLOAD_MODELS, MODEL_IDLE_UNLOAD_SECONDS
         global ALLOW_LOCAL_MODELS, REQUIRE_AUTH, INVITE_GATE_ENABLED, ALLOW_PLAINTEXT_API_KEYS
@@ -128,7 +144,7 @@ class ModelRuntimeState:
         get_user_api_key = self.get_user_api_key
 
 STATE = ModelRuntimeState()
-STATE.sync_to_module_globals()
+STATE._sync_globals()  # initial no-warning; public API warns on explicit legacy syncs
 
 # Configured by server_app.configure_model_runtime during app assembly.
 
@@ -141,7 +157,9 @@ def _env_bool(key: str, default: bool = False) -> bool:
 
 
 def _download_allowed(allow_download: bool = False) -> bool:
-    return bool(allow_download) or _env_bool("LATTICEAI_ALLOW_MODEL_DOWNLOADS", default=False) or bool(AUTOLOAD_MODELS)
+    # Prefer STATE (the source of truth) over bare module global for internal logic.
+    autoload = getattr(STATE, "AUTOLOAD_MODELS", AUTOLOAD_MODELS)
+    return bool(allow_download) or _env_bool("LATTICEAI_ALLOW_MODEL_DOWNLOADS", default=False) or bool(autoload)
 
 
 def _download_block(provider: str, model_name: str) -> None:
@@ -204,7 +222,7 @@ def configure_model_runtime(**deps) -> None:
         elif key == "get_user_api_key":
             STATE.get_user_api_key = value
 
-    STATE.sync_to_module_globals()
+    STATE._sync_globals()  # wiring path uses internal (no spurious deprecation in normal startup)
 
 
 # Catalog data + version-dedup helpers live in ``model_catalog``; re-exported
@@ -727,7 +745,8 @@ def engine_installed(engine: str) -> bool:
     return False
 
 def engine_status() -> List[Dict]:
-    cloud_models = router.detected_cloud_models()
+    r = getattr(STATE, "router", None) or router
+    cloud_models = r.detected_cloud_models() if r else []
     cloud_by_provider = {}
     for model in cloud_models:
         cloud_by_provider.setdefault(model["provider"], []).append(model)
@@ -887,37 +906,41 @@ def engine_status() -> List[Dict]:
     return engines
 
 def runtime_features() -> Dict:
+    # Read from STATE object (central) for implementation; bare globals kept only
+    # for external legacy consumers who import names directly from this module.
+    s = STATE
+    r = getattr(s, "router", None) or router
     return {
-        "mode": APP_MODE,
-        "public": IS_PUBLIC_MODE,
-        "host": DEFAULT_HOST,
-        "port": DEFAULT_PORT,
-        "data_dir": str(DATA_DIR),
-        "telegram_enabled": ENABLE_TELEGRAM,
-        "graph_enabled": ENABLE_GRAPH,
-        "autoload_models": AUTOLOAD_MODELS,
-        "model_idle_unload_seconds": MODEL_IDLE_UNLOAD_SECONDS,
-        "model_memory_policy": router.model_memory_policy(),
-        "allow_local_models": ALLOW_LOCAL_MODELS,
+        "mode": s.APP_MODE,
+        "public": s.IS_PUBLIC_MODE,
+        "host": s.DEFAULT_HOST,
+        "port": s.DEFAULT_PORT,
+        "data_dir": str(s.DATA_DIR),
+        "telegram_enabled": s.ENABLE_TELEGRAM,
+        "graph_enabled": s.ENABLE_GRAPH,
+        "autoload_models": s.AUTOLOAD_MODELS,
+        "model_idle_unload_seconds": s.MODEL_IDLE_UNLOAD_SECONDS,
+        "model_memory_policy": r.model_memory_policy() if r else None,
+        "allow_local_models": s.ALLOW_LOCAL_MODELS,
         "security": {
-            "host": DEFAULT_HOST,
-            "require_auth": REQUIRE_AUTH,
-            "invite_gate_enabled": INVITE_GATE_ENABLED,
-            "keyring_available": keyring is not None,
-            "plaintext_api_keys_allowed": ALLOW_PLAINTEXT_API_KEYS,
-            "cors_allow_network": CORS_ALLOW_NETWORK,
+            "host": s.DEFAULT_HOST,
+            "require_auth": s.REQUIRE_AUTH,
+            "invite_gate_enabled": s.INVITE_GATE_ENABLED,
+            "keyring_available": s.keyring is not None,
+            "plaintext_api_keys_allowed": s.ALLOW_PLAINTEXT_API_KEYS,
+            "cors_allow_network": s.CORS_ALLOW_NETWORK,
         },
-        "default_model": PUBLIC_MODEL if IS_PUBLIC_MODE else LOCAL_MODEL,
+        "default_model": s.PUBLIC_MODEL if s.IS_PUBLIC_MODE else s.LOCAL_MODEL,
         "local_only_features": {
-            "mlx": ALLOW_LOCAL_MODELS and not IS_PUBLIC_MODE,
-            "telegram_bridge": ENABLE_TELEGRAM,
-            "desktop_chrome_bridge": not IS_PUBLIC_MODE,
-            "computer_use_bridge": not IS_PUBLIC_MODE,
+            "mlx": s.ALLOW_LOCAL_MODELS and not s.IS_PUBLIC_MODE,
+            "telegram_bridge": s.ENABLE_TELEGRAM,
+            "desktop_chrome_bridge": not s.IS_PUBLIC_MODE,
+            "computer_use_bridge": not s.IS_PUBLIC_MODE,
         },
         "public_features": {
             "web_ui": True,
             "openai_compatible_models": True,
-            "persistent_data_dir": str(DATA_DIR),
+            "persistent_data_dir": str(s.DATA_DIR),
         },
     }
 
@@ -1099,7 +1122,8 @@ async def _probe_cloud_model(model_ref: str) -> Dict[str, object]:
 
 async def verify_cloud_models(force: bool = False, provider_filter: Optional[str] = None) -> Dict[str, Dict]:
     now = time.time()
-    cloud_items = [item for item in router.detected_cloud_models() if item.get("tag") == "cloud"]
+    r = getattr(STATE, "router", None) or router
+    cloud_items = [item for item in (r.detected_cloud_models() if r else []) if item.get("tag") == "cloud"]
     if provider_filter:
         cloud_items = [item for item in cloud_items if item.get("provider") == provider_filter]
 

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.5.0"
+PRODUCT_VERSION_TARGET = "8.7.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.5.0-py3-none-any.whl",
-            "README.md::dist/ltcai-8.5.0.tar.gz",
-            "README.md::dist/ltcai-8.5.0.vsix",
-            "README.md::ltcai-8.5.0.tgz",
+            "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",
             "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.5.0",
-            "SECURITY.md::8.5.x (latest)",
-            "vscode-extension/README.md::**8.5.0",
-            "docs/CHANGELOG.md::## [8.5.0]",
+            "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]",
             "FEATURE_STATUS.md",
-            "RELEASE_NOTES_v8.4.0.md",
+            "RELEASE_NOTES_v8.7.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.5.0",
+            "docs/COMMUNITY_AND_PLUGINS.md::8.7.0",
             "docs/PLUGIN_SDK.md",
             "plugins/README.md",
             "plugins/hello-world/plugin.json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ltcai",
-  "version": "8.5.0",
+  "version": "8.7.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": {
@@ -23,7 +23,8 @@
     "build:assets": "vite build && node scripts/build_frontend_assets.mjs",
     "build:python": "node scripts/run_python.mjs -m build",
     "check:python": "node scripts/run_python.mjs scripts/check_python.py",
-    "lint": "node --check tests/visual/mock_server.cjs && node --check tests/visual/v3.spec.js && npm run lint:frontend && node scripts/check_i18n_literals.mjs",
+    "lint": "npm run lint:python && node --check tests/visual/mock_server.cjs && node --check tests/visual/v3.spec.js && npm run lint:frontend && node scripts/check_i18n_literals.mjs",
+    "lint:python": "node scripts/run_python.mjs -m ruff check .",
     "lint:frontend": "node scripts/lint_frontend.mjs",
     "docs:check-links": "node scripts/check_markdown_links.mjs",
     "typecheck": "npm run typecheck:frontend && cd vscode-extension && npm run build",

package/scripts/bump_version.py

@@ -27,6 +27,8 @@ TARGETS = [
     ("latticeai/core/workspace_os.py", "regex", r'(WORKSPACE_OS_VERSION = ")([^"]+)(")'),
     ("latticeai/core/marketplace.py", "regex", r'(MARKETPLACE_VERSION = ")([^"]+)(")'),
     ("lattice_brain/runtime/multi_agent.py", "regex", r'(MULTI_AGENT_VERSION = ")([^"]+)(")'),
+    ("latticeai/services/architecture_readiness.py", "regex", r'(ARCHITECTURE_VERSION_TARGET = ")([^"]+)(")'),
+    ("latticeai/services/product_readiness.py", "regex", r'(PRODUCT_VERSION_TARGET = ")([^"]+)(")'),
     ("pyproject.toml", "regex", r'(^version = ")([^"]+)(")'),
     ("package.json", "json", "version"),
     ("package-lock.json", "package-lock", None),

package/scripts/check_python.py

@@ -1,23 +1,26 @@
 #!/usr/bin/env python3
-"""Discover-and-compile every first-party Python module.
+"""Discover-and-syntax-check every first-party Python module.
 
 Replaces the hand-maintained ``py_compile`` enumeration in CI and
 ``package.json``: walks the repository, skips vendored / virtualenv / build /
-cache / generated directories, and byte-compiles everything that remains. New
+cache / generated directories, and checks everything that remains. New
 modules are picked up automatically — there is nothing to update when a file is
 added, so the syntax gate can never silently fall behind the codebase.
 
+Unlike ``py_compile``, this script does not write ``.pyc`` files or create
+``__pycache__`` directories. Validation should not dirty a developer's working
+tree or leave generated files for later lint passes to trip over.
+
 Usage::
 
-    python scripts/check_python.py            # compile all discovered modules
-    python scripts/check_python.py --list     # just print what would be compiled
+    python scripts/check_python.py            # syntax-check all discovered modules
+    python scripts/check_python.py --list     # just print what would be checked
 
-Exit code is non-zero if any module fails to compile.
+Exit code is non-zero if any module fails to parse.
 """
 
 from __future__ import annotations
 
-import py_compile
 import sys
 from pathlib import Path
 
@@ -44,6 +47,7 @@ EXCLUDE_DIRS = {
     "playwright-report",
     "test-results",
     "ltcai.egg-info",
+    "output",
     ".ltcai",
     ".ltcai-brain",
     ".ltcai-test",
@@ -60,6 +64,16 @@ def iter_modules():
         yield path
 
 
+def check_syntax(path: Path) -> str | None:
+    """Return a human-readable failure string, or ``None`` when syntax is valid."""
+
+    try:
+        compile(path.read_bytes(), str(path), "exec", dont_inherit=True)
+    except (OSError, SyntaxError, ValueError) as exc:
+        return f"{path.relative_to(ROOT)}: {exc}"
+    return None
+
+
 def main(argv: list[str]) -> int:
     modules = sorted(iter_modules())
     if "--list" in argv:
@@ -69,17 +83,16 @@ def main(argv: list[str]) -> int:
 
     failures: list[str] = []
     for path in modules:
-        try:
-            py_compile.compile(str(path), doraise=True)
-        except py_compile.PyCompileError as exc:
-            failures.append(str(exc))
+        failure = check_syntax(path)
+        if failure:
+            failures.append(failure)
 
     if failures:
         print("\n".join(failures))
-        print(f"check:python FAILED — {len(failures)} of {len(modules)} module(s) did not compile")
+        print(f"check:python FAILED — {len(failures)} of {len(modules)} module(s) did not parse")
         return 1
 
-    print(f"check:python OK — compiled {len(modules)} modules")
+    print(f"check:python OK — syntax-checked {len(modules)} modules")
     return 0
 
 

package/src-tauri/Cargo.lock

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

package/src-tauri/Cargo.toml

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

package/src-tauri/capabilities/default.json

@@ -3,5 +3,8 @@
   "identifier": "default",
   "description": "Default Lattice AI desktop capability set.",
   "windows": ["main"],
+  "remote": {
+    "urls": ["http://127.0.0.1:*", "http://localhost:*"]
+  },
   "permissions": ["core:default"]
 }

package/src-tauri/src/main.rs

@@ -66,6 +66,36 @@ fn shutdown_backend(state: State<'_, BackendState>) -> BackendStatus {
     status_from_state(&state)
 }
 
+#[tauri::command]
+fn select_folder() -> Option<String> {
+    native_select_folder()
+}
+
+#[cfg(target_os = "macos")]
+fn native_select_folder() -> Option<String> {
+    let output = Command::new("osascript")
+        .args([
+            "-e",
+            r#"POSIX path of (choose folder with prompt "Choose a folder for Lattice AI")"#,
+        ])
+        .output()
+        .ok()?;
+    if !output.status.success() {
+        return None;
+    }
+    let path = String::from_utf8_lossy(&output.stdout).trim().to_string();
+    if path.is_empty() {
+        None
+    } else {
+        Some(path)
+    }
+}
+
+#[cfg(not(target_os = "macos"))]
+fn native_select_folder() -> Option<String> {
+    None
+}
+
 fn split_command(command: &str) -> Vec<String> {
     command.split_whitespace().map(|part| part.to_string()).collect()
 }
@@ -379,7 +409,8 @@ fn main() {
             backend_origin,
             backend_status,
             restart_backend,
-            shutdown_backend
+            shutdown_backend,
+            select_folder
         ])
         .setup(|app| {
             if let Some(window) = app.get_webview_window("main") {

package/src-tauri/tauri.conf.json

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

package/static/app/asset-manifest.json

@@ -1,19 +1,19 @@
 {
-  "version": "8.5.0",
+  "version": "8.7.0",
   "generated_at": "vite",
   "entrypoints": {
-    "app": "/static/app/assets/index-CoiuIFFP.js"
+    "app": "/static/app/assets/index-Bh7IIlyY.js"
   },
   "assets": {
     "../node_modules/@tauri-apps/api/core.js": "/static/app/assets/core-CwxXejkd.js",
-    "_primitives-BdsUNXa6.js": "/static/app/assets/primitives-BdsUNXa6.js",
-    "_textarea-e7qaj6Hm.js": "/static/app/assets/textarea-e7qaj6Hm.js",
-    "index.html": "/static/app/assets/index-CoiuIFFP.js",
-    "assets/index-ty1iGgZu.css": "/static/app/assets/index-ty1iGgZu.css",
-    "src/pages/Act.tsx": "/static/app/assets/Act-D5mo4tE4.js",
-    "src/pages/Brain.tsx": "/static/app/assets/Brain-BVWyQw8A.js",
-    "src/pages/Capture.tsx": "/static/app/assets/Capture-C1R6GT0t.js",
-    "src/pages/Library.tsx": "/static/app/assets/Library-C2wIxpTs.js",
-    "src/pages/System.tsx": "/static/app/assets/System-DE5GRyQR.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"
   }
 }