ltcai 8.2.0 → 8.4.0

package/latticeai/api/local_files.py

@@ -46,6 +46,7 @@ def create_local_files_router(
     require_graph,
     static_dir: Path,
     local_kg_watcher,
+    ingestion_pipeline=None,
     hooks=None,
     data_dir: Optional[Path] = None,
     allowed_workspaces_for=None,
@@ -212,6 +213,7 @@ def create_local_files_router(
             require_user=require_user,
             static_dir=static_dir,
             allowed_workspaces_for=allowed_workspaces_for,
+            ingestion_pipeline=ingestion_pipeline,
         )
     )
 

package/latticeai/api/tools.py

@@ -488,6 +488,7 @@ def create_tools_router(
         require_graph=_require_graph,
         static_dir=STATIC_DIR,
         local_kg_watcher=LOCAL_KG_WATCHER,
+        ingestion_pipeline=ingestion_pipeline,
         hooks=HOOKS,
         data_dir=DATA_DIR,
         allowed_workspaces_for=allowed_workspaces_for,

package/latticeai/api/workflow_designer.py

@@ -73,10 +73,11 @@ def create_workflow_designer_router(
 ) -> APIRouter:
     from lattice_brain.workflow import (
         WorkflowEngine,
+        WorkflowError,
         validate_definition,
         export_workflow,
         import_workflow,
-        WorkflowError,
+        legacy_steps_from_nodes,
     )
 
     router = APIRouter()
@@ -101,7 +102,7 @@ def create_workflow_designer_router(
             raise HTTPException(status_code=400, detail={"validation_errors": errors})
         workflow = store.create_workflow(
             name=req.name,
-            steps=[{"action": n.get("type"), "node": n.get("id")} for n in req.nodes],
+            steps=legacy_steps_from_nodes(req.nodes),
             nodes=req.nodes,
             metadata=req.metadata,
             user_email=current_user or None,
@@ -293,7 +294,7 @@ def create_workflow_designer_router(
             raise HTTPException(status_code=400, detail={"validation_errors": errors})
         workflow = store.create_workflow(
             name=definition["name"],
-            steps=[{"action": n.get("type"), "node": n.get("id")} for n in definition["nodes"]],
+            steps=legacy_steps_from_nodes(definition["nodes"]),
             nodes=definition["nodes"],
             metadata=definition["metadata"],
             user_email=current_user or None,
@@ -343,7 +344,7 @@ def create_workflow_designer_router(
             raise HTTPException(status_code=400, detail=str(exc)) from exc
         workflow = store.create_workflow(
             name=definition["name"],
-            steps=[{"action": n.get("type"), "node": n.get("id")} for n in definition["nodes"]],
+            steps=legacy_steps_from_nodes(definition["nodes"]),
             nodes=definition["nodes"],
             metadata=definition.get("metadata") or {},
             user_email=current_user or None,

package/latticeai/core/legacy_compatibility.py

@@ -0,0 +1,174 @@
+"""Managed legacy compatibility surface for legacy import shims.
+
+Compatibility modules are intentionally still present for old scripts, VS Code
+extension paths, historical integrations, and pre-graph-package imports. 8.4.0
+stops treating them as vague technical debt: every tracked shim has an owner,
+migration target, removal phase, and replacement import that can be surfaced in
+docs and tests.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any, Dict, List
+
+
+LEGACY_COMPATIBILITY_VERSION = "8.4.0"
+
+
+@dataclass(frozen=True)
+class LegacyShim:
+    path: str
+    owner: str
+    replacement: str
+    reason: str
+    removal_phase: str
+    layer: str = "root"
+    status: str = "managed"
+
+    def as_dict(self) -> Dict[str, str]:
+        return {
+            "path": self.path,
+            "owner": self.owner,
+            "replacement": self.replacement,
+            "reason": self.reason,
+            "removal_phase": self.removal_phase,
+            "layer": self.layer,
+            "status": self.status,
+        }
+
+
+LEGACY_SHIMS: List[LegacyShim] = [
+    LegacyShim(
+        path="knowledge_graph.py",
+        owner="lattice_brain.graph",
+        replacement="from lattice_brain.store import KnowledgeGraphStore",
+        reason="Historical scripts imported the graph store from the repo root.",
+        removal_phase="major-release-after-8.x",
+    ),
+    LegacyShim(
+        path="knowledge_graph_api.py",
+        owner="latticeai.api.knowledge_graph",
+        replacement="from latticeai.api.knowledge_graph import create_knowledge_graph_router",
+        reason="Older API composition roots imported the knowledge graph router from the repo root.",
+        removal_phase="major-release-after-8.x",
+    ),
+    LegacyShim(
+        path="kg_schema.py",
+        owner="lattice_brain.graph.schema",
+        replacement="from lattice_brain.schema import ...",
+        reason="Historical graph schema tests and tools referenced root schema symbols.",
+        removal_phase="major-release-after-8.x",
+    ),
+    LegacyShim(
+        path="ltcai_cli.py",
+        owner="latticeai.cli.entrypoint",
+        replacement="from latticeai.cli.entrypoint import main",
+        reason="Console entry points and older package installs imported the CLI root module.",
+        removal_phase="major-release-after-8.x",
+    ),
+    LegacyShim(
+        path="telegram_bot.py",
+        owner="latticeai.integrations.telegram_bot",
+        replacement="from latticeai.integrations.telegram_bot import run_bot",
+        reason="Existing Telegram automation setups still import the legacy root module.",
+        removal_phase="major-release-after-8.x",
+    ),
+    LegacyShim(
+        path="p_reinforce.py",
+        owner="latticeai.services.p_reinforce",
+        replacement="from latticeai.services.p_reinforce import PReinforceGardener",
+        reason="Old gardener scripts referenced the root reinforcement helper.",
+        removal_phase="major-release-after-8.x",
+    ),
+    LegacyShim(
+        path="server.py",
+        owner="latticeai.server_app",
+        replacement="from latticeai.server_app import app, main",
+        reason="Deployment docs and local launch scripts historically targeted server.py.",
+        removal_phase="major-release-after-8.x",
+    ),
+    LegacyShim(
+        path="local_knowledge_api.py",
+        owner="latticeai.api.local_files",
+        replacement="from latticeai.api.local_files import create_local_files_router",
+        reason="Local folder ingestion integrations used the root local knowledge API.",
+        removal_phase="requires-api-route-migration",
+    ),
+    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",
+        layer="brain-flat",
+    ),
+    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",
+        layer="brain-flat",
+    ),
+    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",
+        layer="brain-flat",
+    ),
+    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",
+        layer="deprecated-namespace",
+    ),
+    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",
+        layer="service-alias",
+    ),
+]
+
+
+def legacy_shim_report(root: Path | None = None) -> Dict[str, Any]:
+    if root is None:
+        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()]
+    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",
+        "remaining_count": len(LEGACY_SHIMS),
+        "missing": missing,
+        "removal_phases": phases,
+        "layers": layers,
+        "shims": entries,
+    }
+
+
+__all__ = [
+    "LEGACY_COMPATIBILITY_VERSION",
+    "LEGACY_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.2.0"
+MARKETPLACE_VERSION = "8.4.0"
 TEMPLATE_KINDS = ("plugin", "workflow", "agent")
 
 

package/latticeai/core/workspace_os.py

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

package/latticeai/services/architecture_readiness.py

@@ -1,7 +1,7 @@
 """Machine-checkable architecture readiness gates for release work.
 
-8.2.0 keeps the major architecture priorities under an explicit release
-contract while Brain Brief improves the product surface. AgentRuntime, ToolRegistry,
+8.4.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
 called complete.
@@ -14,8 +14,10 @@ from dataclasses import dataclass
 from pathlib import Path
 from typing import Any, Dict, List
 
+from latticeai.core.legacy_compatibility import legacy_shim_report
 
-ARCHITECTURE_VERSION_TARGET = "8.2.0"
+
+ARCHITECTURE_VERSION_TARGET = "8.4.0"
 
 PREFERRED_REFACTORING_ORDER = [
     "agent-runtime",
@@ -55,6 +57,7 @@ def _symbol_exists(dotted: str) -> bool:
 def architecture_readiness(root: Path | None = None) -> Dict[str, Any]:
     if root is None:
         root = Path(__file__).resolve().parents[2]
+    shim_report = legacy_shim_report(root)
 
     gates = [
         ArchitectureGate(
@@ -117,6 +120,35 @@ def architecture_readiness(root: Path | None = None) -> Dict[str, Any]:
                 "tests/visual/v3.spec.js first-run and Brain depth coverage",
             ],
         ),
+        ArchitectureGate(
+            id="legacy-compatibility",
+            title="Legacy shim sunset plan",
+            status="complete" if shim_report["status"] == "managed" else "incomplete",
+            evidence=[
+                "latticeai.core.legacy_compatibility.legacy_shim_report",
+                "docs/LEGACY_COMPATIBILITY.md",
+                "tests/unit/test_legacy_root_shims.py",
+            ],
+        ),
+        ArchitectureGate(
+            id="orchestration-maturity",
+            title="AgentRuntime and workflow orchestration maturity",
+            status="complete" if all(
+                _symbol_exists(s)
+                for s in [
+                    "lattice_brain.runtime.multi_agent.MultiAgentOrchestrator",
+                    "lattice_brain.workflow.WorkflowEngine",
+                    "latticeai.services.run_executor.RunExecutor",
+                ]
+            ) else "incomplete",
+            evidence=[
+                "lattice_brain.runtime.multi_agent.MultiAgentOrchestrator",
+                "lattice_brain.workflow.WorkflowEngine",
+                "latticeai.services.run_executor.RunExecutor",
+                "tests/unit/test_agent_platform_maturity.py",
+                "tests/unit/test_t7_async_run_executor.py",
+            ],
+        ),
     ]
 
     api_router_count = len(list((root / "latticeai" / "api").glob("*.py")))
@@ -159,5 +191,7 @@ def architecture_readiness(root: Path | None = None) -> Dict[str, Any]:
             "api_router_modules": api_router_count,
             "runtime_modules": runtime_module_count,
             "architecture_gates": len(gates),
+            "legacy_shims_remaining": shim_report["remaining_count"],
         },
+        "legacy_compatibility": shim_report,
     }

package/latticeai/services/model_catalog.py

@@ -102,6 +102,12 @@ MODEL_ENGINE_ALIASES = {
         "lmstudio": "ggml-org/gemma-4-12B-it-GGUF",
         "llamacpp": "ggml-org/gemma-4-12B-it-GGUF",
     },
+    "gemma-4-26b-it-4bit": {
+        "local_mlx": "mlx-community/gemma-4-26b-a4b-it-4bit",
+    },
+    "mlx-community/gemma-4-26b-a4b-it-4bit": {
+        "local_mlx": "mlx-community/gemma-4-26b-a4b-it-4bit",
+    },
     "gemma-4-31b-it-4bit": {
         "local_mlx": "mlx-community/gemma-4-31b-it-4bit",
         "ollama": "hf.co/ggml-org/gemma-4-31B-it-GGUF:Q4_K_M",

package/latticeai/services/model_engines.py

@@ -24,6 +24,14 @@ from typing import Any, Dict, List, Optional
 from fastapi import HTTPException
 
 
+def _progress_payload(*args, **kwargs) -> Dict[str, object]:
+    try:
+        from latticeai.services.model_runtime import model_download_progress_payload
+    except Exception:
+        return {}
+    return model_download_progress_payload(*args, **kwargs)
+
+
 LOCAL_SERVER_PROCESSES: Dict[str, subprocess.Popen] = {}
 VLLM_METAL_ENV = Path.home() / ".venv-vllm-metal"
 VLLM_METAL_BIN = VLLM_METAL_ENV / "bin" / "vllm"
@@ -335,12 +343,7 @@ def pull_ollama_model_with_progress(model_name: str, progress_emit=None) -> Dict
     if not ollama:
         raise HTTPException(status_code=400, detail="Ollama가 설치되지 않았습니다.")
     if progress_emit:
-        # use late import for progress payload
-        try:
-            from latticeai.services.model_runtime import model_download_progress_payload as _prog
-        except Exception:
-            _prog = lambda *a, **k: {}
-        progress_emit(_prog(
+        progress_emit(_progress_payload(
             "download",
             "Ollama 모델 다운로드를 시작합니다.",
             percent=0,
@@ -368,11 +371,7 @@ def pull_ollama_model_with_progress(model_name: str, progress_emit=None) -> Dict
                 if match:
                     last_percent = min(100.0, float(match.group(1)))
                     if progress_emit:
-                        try:
-                            from latticeai.services.model_runtime import model_download_progress_payload as _prog2
-                        except Exception:
-                            _prog2 = lambda *a, **k: {}
-                        progress_emit(_prog2(
+                        progress_emit(_progress_payload(
                             "download",
                             "Ollama 모델 다운로드 중입니다.",
                             percent=last_percent,
@@ -381,11 +380,7 @@ def pull_ollama_model_with_progress(model_name: str, progress_emit=None) -> Dict
                             indeterminate=False,
                         ))
                 elif progress_emit:
-                    try:
-                        from latticeai.services.model_runtime import model_download_progress_payload as _prog3
-                    except Exception:
-                        _prog3 = lambda *a, **k: {}
-                    progress_emit(_prog3(
+                    progress_emit(_progress_payload(
                         "download",
                         "Ollama 모델 다운로드 중입니다.",
                         percent=last_percent,
@@ -403,11 +398,7 @@ def pull_ollama_model_with_progress(model_name: str, progress_emit=None) -> Dict
         raise HTTPException(status_code=500, detail=tail[-2000:] or "Ollama 모델 다운로드 실패")
 
     if progress_emit:
-        try:
-            from latticeai.services.model_runtime import model_download_progress_payload as _prog4
-        except Exception:
-            _prog4 = lambda *a, **k: {}
-        progress_emit(_prog4(
+        progress_emit(_progress_payload(
             "download",
             "Ollama 모델 다운로드가 완료되었습니다.",
             percent=100,

package/latticeai/services/model_runtime.py

@@ -12,12 +12,7 @@ import importlib.util
 import json
 import logging
 import os
-import platform
-import queue
 import shutil
-import subprocess
-import sys
-import threading
 import time
 import urllib.error
 import urllib.request
@@ -26,14 +21,6 @@ from typing import AsyncIterator, Dict, List, Optional
 
 from fastapi import HTTPException, Request
 
-def _missing_current_user(_request: Request) -> Optional[str]:
-    return None
-
-
-def _missing_user_api_key(_email: Optional[str], _provider: str) -> Optional[str]:
-    return None
-
-
 from latticeai.models.router import (
     AsyncOpenAI,
     HF_MODELS_ROOT,
@@ -43,11 +30,12 @@ from latticeai.models.router import (
     hf_model_dir,
     parse_model_ref,
 )
+from latticeai.core.model_resolution import ModelResolution as _ModelResolution
 from latticeai.core.model_compat import (
     friendly_model_runtime_error as _friendly_model_runtime_error,
     model_runtime_compatibility as _model_runtime_compatibility,
+    SMOKE_PROMPT as _SMOKE_PROMPT,
 )
-from latticeai.core.model_resolution import ModelResolution as _ModelResolution
 from .model_engines import (
     ensure_lmstudio_server as _ensure_lmstudio_server,
     ensure_ollama_server as _ensure_ollama_server,
@@ -67,15 +55,21 @@ from .model_engines import (
     LOCAL_SERVER_PROCESSES as _LOCAL_SERVER_PROCESSES,
 )
 
-# Rebind extracted engines for legacy module globals
-ensure_lmstudio_server = _ensure_lmstudio_server
-ensure_ollama_server = _ensure_ollama_server
-ensure_vllm_server = _ensure_vllm_server
-ensure_llamacpp_server = _ensure_llamacpp_server
-pull_ollama_model_with_progress = _pull_ollama_model_with_progress
-get_ollama_pulled_models = _get_ollama_pulled_models
-engine_support_status = _engine_support_status
-install_engine = _install_engine
+# ``model_loading._get_model_runtime_deps`` imports these private names from
+# this module to preserve the historical model_runtime wiring surface.
+_MODEL_LOADING_COMPAT_EXPORTS = (
+    _friendly_model_runtime_error,
+    _model_runtime_compatibility,
+    _SMOKE_PROMPT,
+)
+
+
+def _missing_current_user(_request: Request) -> Optional[str]:
+    return None
+
+
+def _missing_user_api_key(_email: Optional[str], _provider: str) -> Optional[str]:
+    return None
 
 # Server decomp: proper ModelRuntimeState class for globals/wiring
 class ModelRuntimeState:

package/latticeai/services/product_readiness.py

@@ -1,9 +1,9 @@
-"""Machine-checkable *product* readiness gates for the 8.2 line.
+"""Machine-checkable *product* readiness gates for the 8.4 line.
 
 Where ``architecture_readiness`` proves the internal structure is sound, this
-module answers the product question the 8.2 release exists to settle: *is the
-Brain experience still release-ready now that the home screen explains what to
-notice and what to do next?* It does so honestly: every gate is backed by
+module answers the product question the 8.4 release exists to settle: *does the
+app now feel like a finished product rather than only a strong framework?*
+It does so honestly: every gate is backed by
 evidence that is probed on disk, so a gate only reports ``complete`` when its
 evidence actually resolves. The same report can be printed by
 ``scripts/product_readiness.py`` and re-run after every change, which is the
@@ -18,7 +18,7 @@ from typing import Any, Dict, List
 
 from latticeai.services.architecture_readiness import architecture_readiness
 
-PRODUCT_VERSION_TARGET = "8.2.0"
+PRODUCT_VERSION_TARGET = "8.4.0"
 
 
 @dataclass(frozen=True)
@@ -35,6 +35,7 @@ PRODUCT_GATES: List[ProductGate] = [
         id="first-run",
         title="First five minutes lands without a manual",
         evidence=[
+            "docs/ONBOARDING.md::five-minute",
             "frontend/src/components/ProductFlow.tsx::WakeBrainScreen",
             "frontend/src/features/brain/BrainConversation.tsx::ProductCommandCenter",
             "frontend/src/features/brain/BrainConversation.tsx::BrainBriefPanel",
@@ -51,6 +52,15 @@ PRODUCT_GATES: List[ProductGate] = [
             "scripts/brain_quality_eval.py",
         ],
     ),
+    ProductGate(
+        id="action-aware-chat",
+        title="File action requests create artifacts instead of code-only answers",
+        evidence=[
+            "latticeai/api/chat.py::is_file_action_request",
+            "latticeai/api/chat.py::direct_write_file",
+            "tests/unit/test_chat_telegram_decoupling.py::test_chat_file_creation_intent_writes_real_file",
+        ],
+    ),
     ProductGate(
         id="local-first-trust",
         title="Local-first privacy is stated and bounded",
@@ -66,10 +76,10 @@ PRODUCT_GATES: List[ProductGate] = [
         evidence=[
             "package.json::release:artifacts",
             "package.json::release:validate",
-            "README.md::dist/ltcai-8.2.0-py3-none-any.whl",
-            "README.md::dist/ltcai-8.2.0.tar.gz",
-            "README.md::dist/ltcai-8.2.0.vsix",
-            "README.md::ltcai-8.2.0.tgz",
+            "README.md::dist/ltcai-8.4.0-py3-none-any.whl",
+            "README.md::dist/ltcai-8.4.0.tar.gz",
+            "README.md::dist/ltcai-8.4.0.vsix",
+            "README.md::ltcai-8.4.0.tgz",
             "scripts/validate_release_artifacts.py",
             "scripts/release_smoke.py",
             "Dockerfile",
@@ -85,12 +95,12 @@ PRODUCT_GATES: List[ProductGate] = [
         title="Release story is documented and honest",
         evidence=[
             "README.md",
-            "README.md::The current release is **8.2.0",
-            "SECURITY.md::8.2.x (latest)",
-            "vscode-extension/README.md::**8.2.0",
-            "docs/CHANGELOG.md::## [8.2.0]",
+            "README.md::The current release is **8.4.0",
+            "SECURITY.md::8.4.x (latest)",
+            "vscode-extension/README.md::**8.4.0",
+            "docs/CHANGELOG.md::## [8.4.0]",
             "FEATURE_STATUS.md",
-            "RELEASE_NOTES_v8.2.0.md",
+            "RELEASE_NOTES_v8.4.0.md",
             "latticeai/core/agent.py::SingleAgentRuntime",
             "latticeai/core/agent.py::AgentRuntime = SingleAgentRuntime",
             "lattice_brain/runtime/contracts.py::runtime-boundary/v1",
@@ -101,6 +111,27 @@ PRODUCT_GATES: List[ProductGate] = [
             "latticeai/services/tool_dispatch.py::rollback_file",
         ],
     ),
+    ProductGate(
+        id="ecosystem-path",
+        title="Community and plugin growth path is explicit",
+        evidence=[
+            "docs/COMMUNITY_AND_PLUGINS.md::LatticeAI 8.4.0",
+            "docs/PLUGIN_SDK.md",
+            "plugins/README.md",
+            "plugins/hello-world/plugin.json",
+        ],
+    ),
+    ProductGate(
+        id="ingestion-graph-coverage",
+        title="Graph and ingestion integration coverage guards the Brain",
+        evidence=[
+            "tests/unit/test_ingestion_pipeline.py::test_upload_result_enters_unified_ingestion_pipeline",
+            "tests/unit/test_ingestion_pipeline.py::test_ingestion_preserves_workspace_scope_for_duplicate_content",
+            "tests/integration/test_ingest_graph_retrieval.py",
+            "tests/unit/test_lattice_brain_isolation.py",
+            "tests/unit/test_retrieval_benchmark_corpus.py",
+        ],
+    ),
     ProductGate(
         id="quality-gates",
         title="Quality is guarded by repeatable gates",

package/llm_router.py

@@ -1,32 +1,11 @@
-"""Deprecation shim — the LLM router moved to ``latticeai.models.router`` in v4.
+"""Compatibility shim: physically moved to ``latticeai.models.router``.
 
-This root module remains importable for the deprecation window and will be
-removed in a future major release. Import from ``latticeai.models.router``.
+Aliases itself to the physical module so router globals, identity checks, and
+monkeypatching keep working through the old import path.
 """
 
-from latticeai.models.router import *  # noqa: F401,F403
-from latticeai.models.router import (  # noqa: F401 — explicit key surface
-    AsyncOpenAI,
-    BRAND_NAME,
-    HF_MODELS_ROOT,
-    LLMRouter,
-    OPENAI_COMPATIBLE_PROVIDERS,
-    SYSTEM_PROMPT,
-    ensure_mlx_runtime,
-    hf_model_dir,
-    normalize_branding,
-    parse_model_ref,
-)
+import sys
 
-__all__ = [
-    "AsyncOpenAI",
-    "BRAND_NAME",
-    "HF_MODELS_ROOT",
-    "LLMRouter",
-    "OPENAI_COMPATIBLE_PROVIDERS",
-    "SYSTEM_PROMPT",
-    "ensure_mlx_runtime",
-    "hf_model_dir",
-    "normalize_branding",
-    "parse_model_ref",
-]
+import latticeai.models.router as _impl
+
+sys.modules[__name__] = _impl

package/mcp_registry.py

@@ -1,28 +1,11 @@
-"""Deprecation shim — the MCP registry moved to ``latticeai.core.mcp_registry`` in v4.
+"""Compatibility shim: physically moved to ``latticeai.core.mcp_registry``.
 
-This root module remains importable for the deprecation window and will be
-removed in a future major release. Import from ``latticeai.core.mcp_registry``.
-
-Note: the remote-registry cache lives in ``latticeai.core.mcp_registry``
-module globals — code that *assigns* cache attributes (e.g.
-``_REMOTE_REGISTRY_FETCHED_AT``) must import the real module, not this shim.
+Aliases itself to the physical module so registry cache state, identity checks,
+and monkeypatching keep working through the old import path.
 """
 
-from latticeai.core.mcp_registry import *  # noqa: F401,F403
-from latticeai.core.mcp_registry import (  # noqa: F401 — explicit key surface
-    MCP_REGISTRY,
-    SKILLS_DIR,
-    _KNOWN_REPO_LICENSES,
-    _MARKETPLACE_API,
-    _MARKETPLACE_RAW,
-    _THIRD_PARTY_SKILL_SOURCES,
-    _extract_skill_desc,
-    _fetch_plugin_directory,
-    _fetch_plugin_skills,
-    _fetch_remote_mcp_registry,
-    _fetch_skills_marketplace,
-    _get_combined_registry,
-    install_skill,
-)
+import sys
+
+import latticeai.core.mcp_registry as _impl
 
-__all__ = ["MCP_REGISTRY", "SKILLS_DIR", "install_skill"]
+sys.modules[__name__] = _impl