ltcai 9.9.0 → 9.9.1

package/latticeai/core/legacy_compatibility.py

@@ -14,7 +14,7 @@ from pathlib import Path
 from typing import Any, Dict, List
 
 
-LEGACY_COMPATIBILITY_VERSION = "9.9.0"
+LEGACY_COMPATIBILITY_VERSION = "9.9.1"
 
 
 @dataclass(frozen=True)
@@ -40,106 +40,130 @@ class LegacyShim:
 
 
 LEGACY_SHIMS: List[LegacyShim] = [
+    LegacyShim(
+        path="server.py",
+        owner="latticeai.server_app",
+        replacement="from latticeai.server_app import app, main",
+        reason="Deployment docs, Docker CMD, start scripts, and uvicorn targets still use server:app.",
+        removal_phase="major-release-after-9.x",
+    ),
+]
+
+# 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="knowledge_graph.py",
-        owner="lattice_brain.graph",
+        owner="lattice_brain.graph.store",
         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",
+        reason="Root compatibility shims completed their window; removed in 9.9.1.",
+        removal_phase="removed-9.9.1",
+        layer="root",
+        status="removed",
     ),
     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",
+        reason="Root compatibility shims completed their window; removed in 9.9.1.",
+        removal_phase="removed-9.9.1",
+        layer="root",
+        status="removed",
     ),
     LegacyShim(
         path="kg_schema.py",
         owner="lattice_brain.graph.schema",
         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",
+        reason="Root compatibility shims completed their window; removed in 9.9.1.",
+        removal_phase="removed-9.9.1",
+        layer="root",
+        status="removed",
     ),
     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",
+        reason="Root compatibility shims completed their window; removed in 9.9.1.",
+        removal_phase="removed-9.9.1",
+        layer="root",
+        status="removed",
     ),
     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",
+        reason="Root compatibility shims completed their window; removed in 9.9.1.",
+        removal_phase="removed-9.9.1",
+        layer="root",
+        status="removed",
     ),
     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",
+        reason="Root compatibility shims completed their window; removed in 9.9.1.",
+        removal_phase="removed-9.9.1",
+        layer="root",
+        status="removed",
     ),
     LegacyShim(
         path="mcp_registry.py",
         owner="latticeai.core.mcp_registry",
         replacement="import latticeai.core.mcp_registry",
-        reason="Older integrations imported the MCP registry from the repo root.",
-        removal_phase="major-release-after-9.x",
+        reason="Root compatibility shims completed their window; removed in 9.9.1.",
+        removal_phase="removed-9.9.1",
+        layer="root",
+        status="removed",
     ),
     LegacyShim(
         path="llm_router.py",
         owner="latticeai.models.router",
         replacement="import latticeai.models.router",
-        reason="Historical scripts and tests imported the LLM router from the repo root.",
-        removal_phase="major-release-after-9.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="tools/",
-        owner="latticeai.tools",
-        replacement="from latticeai.tools import execute_tool",
-        reason="Existing integrations and tests import the historical root tools package.",
-        removal_phase="major-release-after-9.x",
+        reason="Root compatibility shims completed their window; removed in 9.9.1.",
+        removal_phase="removed-9.9.1",
+        layer="root",
+        status="removed",
     ),
     LegacyShim(
         path="local_knowledge_api.py",
         owner="latticeai.services.local_knowledge",
         replacement="from latticeai.services.local_knowledge import create_local_knowledge_router",
-        reason="Local folder ingestion integrations used the root local knowledge API.",
-        removal_phase="requires-api-route-migration",
+        reason="Root compatibility shims completed their window; removed in 9.9.1.",
+        removal_phase="removed-9.9.1",
+        layer="root",
+        status="removed",
     ),
     LegacyShim(
         path="auto_setup.py",
         owner="latticeai.setup.auto_setup",
         replacement="from latticeai.setup.auto_setup import probe, recommend",
-        reason="Historical scripts invoke the zero-config setup module from the repo root.",
-        removal_phase="major-release-after-9.x",
+        reason="Root compatibility shims completed their window; removed in 9.9.1.",
+        removal_phase="removed-9.9.1",
+        layer="root",
+        status="removed",
     ),
     LegacyShim(
         path="setup_wizard.py",
         owner="latticeai.setup.wizard",
         replacement="from latticeai.setup.wizard import scan_environment",
-        reason="Older integrations imported the setup wizard from the repo root.",
-        removal_phase="major-release-after-9.x",
+        reason="Root compatibility shims completed their window; removed in 9.9.1.",
+        removal_phase="removed-9.9.1",
+        layer="root",
+        status="removed",
+    ),
+    LegacyShim(
+        path="tools/",
+        owner="latticeai.tools",
+        replacement="from latticeai.tools import execute_tool",
+        reason="Root compatibility shims completed their window; removed in 9.9.1.",
+        removal_phase="removed-9.9.1",
+        layer="root",
+        status="removed",
     ),
-]
-
-# 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",

package/latticeai/core/marketplace.py

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

package/latticeai/core/workspace_os.py

@@ -49,7 +49,7 @@ __all__ = [
     "remove_skill_directory",
 ]
 
-WORKSPACE_OS_VERSION = "9.9.0"
+WORKSPACE_OS_VERSION = "9.9.1"
 
 # 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

@@ -17,7 +17,7 @@ from typing import Any, Dict, List
 from latticeai.core.legacy_compatibility import legacy_shim_report
 
 
-ARCHITECTURE_VERSION_TARGET = "9.9.0"
+ARCHITECTURE_VERSION_TARGET = "9.9.1"
 
 PREFERRED_REFACTORING_ORDER = [
     "agent-runtime",

package/latticeai/services/product_readiness.py

@@ -18,7 +18,7 @@ from typing import Any, Dict, List
 
 from latticeai.services.architecture_readiness import architecture_readiness
 
-PRODUCT_VERSION_TARGET = "9.9.0"
+PRODUCT_VERSION_TARGET = "9.9.1"
 
 
 @dataclass(frozen=True)
@@ -140,7 +140,7 @@ PRODUCT_GATES: List[ProductGate] = [
         evidence=[
             "scripts/brain_quality_eval.py",
             "scripts/product_readiness.py",
-            "tests/unit/test_v78_product_readiness.py",
+            "tests/unit/test_product_readiness.py",
             "tests/visual/v3.spec.js::Brain Chat Home",
             ".github/workflows/ci.yml::scripts/product_readiness.py",
             ".github/workflows/release.yml::npm run lint",

package/latticeai/tools/__init__.py

@@ -23,7 +23,7 @@ from pathlib import Path
 from typing import Any, Callable, Dict, List, Optional
 
 from latticeai.core.tool_registry import ToolRegistry
-from p_reinforce import BRAIN_DIR, STRUCTURE
+from latticeai.services.p_reinforce import BRAIN_DIR, STRUCTURE
 
 _PLATFORM = platform.system()  # "Darwin" | "Windows" | "Linux"
 

package/latticeai/tools/knowledge.py

@@ -6,7 +6,7 @@ import hashlib
 from pathlib import Path
 from typing import Any, Dict, List, Optional
 
-from p_reinforce import BRAIN_DIR, STRUCTURE
+from latticeai.services.p_reinforce import BRAIN_DIR, STRUCTURE
 from latticeai.tools import MAX_FILE_BYTES, ToolError
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ltcai",
-  "version": "9.9.0",
+  "version": "9.9.1",
   "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": {
@@ -16,7 +16,7 @@
   },
   "scripts": {
     "start": "LTCAI",
-    "dev": "python3 ltcai_cli.py --reload",
+    "dev": "python3 -m latticeai.cli.entrypoint --reload",
     "build": "npm run build:assets && npm run build:python",
     "frontend:dev": "vite --host 127.0.0.1",
     "frontend:openapi": "node scripts/run_python.mjs scripts/export_openapi.py frontend/openapi.json && npx openapi-typescript frontend/openapi.json -o frontend/src/api/openapi.ts",
@@ -24,7 +24,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": "npm run lint:python && node --check tests/visual/mock_server.cjs && node --check tests/visual/v3.spec.js && npm run lint:frontend && npm run frontend:openapi:check && node scripts/check_i18n_literals.mjs && npm run check:bundle && npm run test:browser-extension",
+    "lint": "npm run lint:python && node --check tests/visual/mock_server.cjs && node --check tests/visual/v3.spec.js && npm run lint:frontend && npm run frontend:openapi:check && node scripts/check_i18n_literals.mjs && npm run check:bundle && npm run check:legacy-debt && npm run test:browser-extension",
+    "check:legacy-debt": "node scripts/check_legacy_debt.mjs",
     "lint:python": "node scripts/run_python.mjs -m ruff check .",
     "lint:frontend": "node scripts/lint_frontend.mjs",
     "check:bundle": "node scripts/check_bundle_budget.mjs",
@@ -46,7 +47,8 @@
     "desktop:tauri:check": "cd src-tauri && cargo check",
     "desktop:electron": "electron desktop/electron/main.cjs",
     "package:vsix": "node scripts/build_vsix.mjs",
-    "release:evidence": "node scripts/capture_release_evidence.mjs",
+    "release:evidence": "node scripts/capture_release_evidence.mjs && node scripts/prune_release_evidence.mjs",
+    "release:evidence:prune": "node scripts/prune_release_evidence.mjs",
     "release:artifacts": "node scripts/clean_release_artifacts.mjs $npm_package_version && npm run build:assets && npm run build:python && npm pack && npm run package:vsix && npm run desktop:tauri:build",
     "release:validate": "node scripts/run_python.mjs scripts/validate_release_artifacts.py $npm_package_version --require-vsix --require-tgz --require-dmg",
     "release:smoke": "node scripts/run_python.mjs scripts/release_smoke.py $npm_package_version",
@@ -76,17 +78,7 @@
     "bin/ltcai.js",
     "LICENSE",
     "requirements.txt",
-    "ltcai_cli.py",
-    "auto_setup.py",
     "server.py",
-    "kg_schema.py",
-    "knowledge_graph.py",
-    "local_knowledge_api.py",
-    "llm_router.py",
-    "p_reinforce.py",
-    "telegram_bot.py",
-    "tools/",
-    "mcp_registry.py",
     "latticeai/**/*.py",
     "lattice_brain/**/*.py",
     "skills/",
@@ -113,8 +105,6 @@
     "!**/*.pyc",
     "!**/*.map",
     "README.md",
-    "setup_wizard.py",
-    "knowledge_graph_api.py",
     "static/vendor/",
     "src-tauri/",
     "!src-tauri/gen/",

package/scripts/check_current_release_docs.mjs

@@ -6,7 +6,7 @@ const root = process.cwd();
 const pkg = JSON.parse(readFileSync(path.join(root, "package.json"), "utf8"));
 const version = pkg.version;
 const releaseDir = `output/release/v${version}`;
-const releaseTheme = "Fail-Closed Trust";
+const releaseTheme = "Clean Foundations";
 const title = `${version} — ${releaseTheme}`;
 const escapedVersion = version.replaceAll(".", "\\.");
 
@@ -71,6 +71,25 @@ for (const rel of [
   requireIncludes(rel, version);
 }
 
+// The Release Artifact Map in ARCHITECTURE.md must name current-version
+// artifacts exactly — this block drifted silently before 9.9.1.
+requireIncludes("ARCHITECTURE.md", `${version} exact artifact names:`);
+for (const artifact of [
+  `dist/ltcai-${version}-py3-none-any.whl`,
+  `dist/ltcai-${version}.tar.gz`,
+  `ltcai-${version}.tgz`,
+  `dist/ltcai-${version}.vsix`,
+  `src-tauri/target/release/bundle/dmg/Lattice AI_${version}_aarch64.dmg`,
+]) {
+  requireIncludes("ARCHITECTURE.md", artifact);
+}
+const architecture = read("ARCHITECTURE.md");
+for (const match of architecture.matchAll(/ltcai-(\d+\.\d+\.\d+)/g)) {
+  if (match[1] !== version) {
+    errors.push(`ARCHITECTURE.md: stale artifact version reference ${match[0]}`);
+  }
+}
+
 requireIncludes("README.md", `The current release is **${title}**`);
 requireIncludes("README.md", `![v${version} Living Brain walkthrough]`);
 requireIncludes("RELEASE.md", `## v${version} — ${releaseTheme}`);

package/scripts/check_legacy_debt.mjs

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+// Legacy debt gate (9.9.1): the root shim layer stays removed.
+//
+// Fails when:
+//  1. a Python module other than server.py appears at the repository root;
+//  2. any source tree imports a removed root shim module;
+//  3. a removed shim directory (tools/) reappears at the root.
+//
+// Mirror of tests/unit/test_legacy_root_shims.py, but static and runnable in
+// `npm run lint` without a Python environment.
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { join, relative } from "node:path";
+
+const repo = join(import.meta.dirname, "..");
+
+const ALLOWED_ROOT_MODULES = new Set(["server.py"]);
+const REMOVED_ROOT_DIRS = ["tools"];
+const REMOVED_MODULES = [
+  "ltcai_cli",
+  "auto_setup",
+  "setup_wizard",
+  "mcp_registry",
+  "kg_schema",
+  "knowledge_graph",
+  "knowledge_graph_api",
+  "local_knowledge_api",
+  "llm_router",
+  "p_reinforce",
+  "telegram_bot",
+  "tools",
+];
+// Trees that must not import removed shims. static/app and node_modules are
+// build output; src-tauri/target is compiler output.
+const SOURCE_TREES = ["latticeai", "lattice_brain", "tests", "scripts", "bin", "desktop/electron"];
+
+const failures = [];
+
+for (const entry of readdirSync(repo)) {
+  if (entry.endsWith(".py") && !ALLOWED_ROOT_MODULES.has(entry)) {
+    failures.push(`root module reappeared: ${entry} — put code in latticeai/ or lattice_brain/`);
+  }
+}
+for (const dir of REMOVED_ROOT_DIRS) {
+  if (existsSync(join(repo, dir))) {
+    failures.push(`removed root package reappeared: ${dir}/ — use latticeai.${dir} instead`);
+  }
+}
+
+const modulePattern = REMOVED_MODULES.join("|");
+const pyImport = new RegExp(`^\\s*(?:import\\s+(?:${modulePattern})\\b|from\\s+(?:${modulePattern})\\s+import\\b)`);
+const jsSpawn = new RegExp(`(?:${modulePattern})\\.py\\b`);
+
+function* walk(dir) {
+  for (const entry of readdirSync(dir)) {
+    if (entry === "__pycache__" || entry === "node_modules" || entry === ".venv") continue;
+    const full = join(dir, entry);
+    const st = statSync(full);
+    if (st.isDirectory()) yield* walk(full);
+    else yield full;
+  }
+}
+
+for (const tree of SOURCE_TREES) {
+  const base = join(repo, tree);
+  if (!existsSync(base)) continue;
+  for (const file of walk(base)) {
+    const rel = relative(repo, file);
+    if (/\.py$/.test(file)) {
+      const lines = readFileSync(file, "utf8").split("\n");
+      lines.forEach((line, i) => {
+        if (pyImport.test(line)) {
+          failures.push(`${rel}:${i + 1} imports a removed root shim: ${line.trim()}`);
+        }
+      });
+    } else if (/\.(mjs|cjs|js)$/.test(file) && !/\.min\.js$/.test(file)) {
+      const lines = readFileSync(file, "utf8").split("\n");
+      lines.forEach((line, i) => {
+        if (jsSpawn.test(line) && !line.includes("check_legacy_debt")) {
+          failures.push(`${rel}:${i + 1} references a removed root shim file: ${line.trim()}`);
+        }
+      });
+    }
+  }
+}
+
+if (failures.length > 0) {
+  console.error("legacy debt gate FAILED:");
+  for (const failure of failures) console.error(`  - ${failure}`);
+  process.exit(1);
+}
+console.log("legacy debt gate ok: root shim layer stays removed (server.py only)");

package/scripts/prune_release_evidence.mjs

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+// Retention policy for output/release/: keep the newest N versioned evidence
+// directories (default 3, override with LTCAI_RELEASE_EVIDENCE_KEEP or argv).
+// Older captures are reproducible on demand via `npm run release:evidence`,
+// so keeping the full history only burns disk (13 versions ≈ 90MB).
+import { existsSync, readdirSync, rmSync, statSync } from "node:fs";
+import { join } from "node:path";
+
+const repo = join(import.meta.dirname, "..");
+const releaseDir = join(repo, "output", "release");
+const keep = Math.max(1, Number(process.argv[2] || process.env.LTCAI_RELEASE_EVIDENCE_KEEP || 3));
+
+if (!existsSync(releaseDir)) {
+  console.log(`release evidence: nothing to prune (${releaseDir} missing)`);
+  process.exit(0);
+}
+
+const semver = (name) => {
+  const m = /^v(\d+)\.(\d+)\.(\d+)$/.exec(name);
+  return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
+};
+
+const versioned = readdirSync(releaseDir)
+  .filter((name) => semver(name) && statSync(join(releaseDir, name)).isDirectory())
+  .sort((a, b) => {
+    const [a1, a2, a3] = semver(a);
+    const [b1, b2, b3] = semver(b);
+    return b1 - a1 || b2 - a2 || b3 - a3;
+  });
+
+const stale = versioned.slice(keep);
+for (const name of stale) {
+  rmSync(join(releaseDir, name), { recursive: true, force: true });
+  console.log(`release evidence: pruned ${name}`);
+}
+console.log(
+  `release evidence: keeping ${Math.min(keep, versioned.length)} of ${versioned.length} versions (policy: newest ${keep})`,
+);

package/scripts/wheel_smoke.py

@@ -32,7 +32,6 @@ REPO_ROOT = Path(__file__).resolve().parents[1]
 
 # Every importable module the wheel ships (pyproject py-modules + packages).
 WHEEL_MODULES = [
-    "setup_wizard",
     "lattice_brain",
     "lattice_brain.graph",
     "lattice_brain.graph.store",
@@ -55,9 +54,18 @@ WHEEL_MODULES = [
     "latticeai.services.p_reinforce",
     "latticeai.tools",
     "latticeai.tools.knowledge",
+    "latticeai.setup.auto_setup",
+    "latticeai.setup.wizard",
+    "latticeai.services.local_knowledge",
+    "lattice_brain.graph.schema",
+    "server",
+]
+
+# Root shims removed in 9.9.1 — the wheel must NOT ship them anymore.
+REMOVED_ROOT_MODULES = [
     "ltcai_cli",
     "auto_setup",
-    "server",
+    "setup_wizard",
     "mcp_registry",
     "kg_schema",
     "knowledge_graph",
@@ -67,15 +75,23 @@ WHEEL_MODULES = [
     "p_reinforce",
     "telegram_bot",
     "tools",
-    "tools.knowledge",
 ]
 
 IMPORT_CHECK = (
     "import importlib\n"
     + "".join(f"importlib.import_module({mod!r})\n" for mod in WHEEL_MODULES)
-    + "assert importlib.import_module('tools') is importlib.import_module('latticeai.tools')\n"
-    + "assert importlib.import_module('tools.knowledge') is importlib.import_module('latticeai.tools.knowledge')\n"
-    + f"print('wheel imports ok: {len(WHEEL_MODULES)} modules')\n"
+    + "".join(
+        f"""
+try:
+    importlib.import_module({mod!r})
+except ImportError:
+    pass
+else:
+    raise AssertionError('removed root shim {mod} is still shipped in the wheel')
+"""
+        for mod in REMOVED_ROOT_MODULES
+    )
+    + f"print('wheel imports ok: {len(WHEEL_MODULES)} modules, {len(REMOVED_ROOT_MODULES)} shims gone')\n"
 )
 
 HEALTH_CHECK = """

package/src-tauri/Cargo.lock

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

package/src-tauri/Cargo.toml

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

package/src-tauri/src/main.rs

@@ -164,9 +164,9 @@ fn resource_dir() -> Option<PathBuf> {
 fn bundled_python_root() -> Option<PathBuf> {
     let resources = resource_dir()?;
     let up = resources.join("_up_");
-    if up.join("ltcai_cli.py").is_file() {
+    if up.join("latticeai").join("cli").join("entrypoint.py").is_file() {
         Some(up)
-    } else if resources.join("ltcai_cli.py").is_file() {
+    } else if resources.join("latticeai").join("cli").join("entrypoint.py").is_file() {
         Some(resources)
     } else {
         None
@@ -222,13 +222,13 @@ fn backend_launch(origin: &str) -> BackendLaunch {
     }
 
     for python in python_candidates() {
-        if module_importable(&python, "ltcai_cli") {
+        if module_importable(&python, "latticeai.cli.entrypoint") {
             return BackendLaunch {
-                command: format!("{python} -m ltcai_cli --host 127.0.0.1 --port {port}"),
+                command: format!("{python} -m latticeai.cli.entrypoint --host 127.0.0.1 --port {port}"),
                 program: python,
                 args: vec![
                     "-m".into(),
-                    "ltcai_cli".into(),
+                    "latticeai.cli.entrypoint".into(),
                     "--host".into(),
                     "127.0.0.1".into(),
                     "--port".into(),
@@ -240,27 +240,27 @@ fn backend_launch(origin: &str) -> BackendLaunch {
     }
 
     if let Some(resources) = bundled_python_root() {
-        let launcher = resources.join("ltcai_cli.py");
-        if launcher.is_file() {
+        if resources.join("latticeai").join("cli").join("entrypoint.py").is_file() {
             if let Some(python) = python_candidates().into_iter().next() {
                 return BackendLaunch {
-                    command: format!("{python} {} --host 127.0.0.1 --port {port}", launcher.display()),
+                    command: format!("{python} -m latticeai.cli.entrypoint --host 127.0.0.1 --port {port}"),
                     program: python,
                     args: vec![
-                        launcher.to_string_lossy().to_string(),
+                        "-m".into(),
+                        "latticeai.cli.entrypoint".into(),
                         "--host".into(),
                         "127.0.0.1".into(),
                         "--port".into(),
                         port,
                     ],
-                    cwd: None,
+                    cwd: Some(resources),
                 };
             }
         }
     }
 
     BackendLaunch {
-        command: "unavailable: LTCAI executable or importable ltcai_cli module not found".to_string(),
+        command: "unavailable: LTCAI executable or importable latticeai.cli.entrypoint module not found".to_string(),
         program: String::new(),
         args: Vec::new(),
         cwd: None,
@@ -278,7 +278,7 @@ fn spawn_backend(origin: &str, launch: &BackendLaunch) -> Result<Option<Child>,
         return Ok(None);
     }
     if launch.program.is_empty() {
-        return Err("Desktop backend unavailable: LTCAI executable or importable ltcai_cli module not found.".to_string());
+        return Err("Desktop backend unavailable: LTCAI executable or importable latticeai.cli.entrypoint module not found.".to_string());
     }
 
     let mut cmd = Command::new(&launch.program);