ltcai 11.1.0 → 11.4.0

package/latticeai/setup/wizard/recommend.py

@@ -0,0 +1,320 @@
+"""The wizard's recommendation: environment scan in, tailored checklist out.
+
+Pure function over the :func:`~latticeai.setup.wizard.detect.scan_environment`
+payload — no probing, no installing. It picks the preferred engine, filters the
+catalogue to what fits, and returns the component / engine / model / MCP groups
+the setup screen renders, each already carrying a confirmation-token plan.
+"""
+
+from __future__ import annotations
+
+import sys
+from typing import Any, Dict, List
+
+from latticeai.setup.wizard.catalog import (
+    _CROSS_PLATFORM_MODEL_CATALOG,
+    _MODEL_CATALOG,
+    _best_model_for_engine,
+    _filter_lower_family_versions,
+)
+from latticeai.setup.wizard.paths import OFFICIAL_DOWNLOADS
+from latticeai.setup.wizard.plans import _hydrate_install_actions
+
+# ── Recommendation Logic ──────────────────────────────────────────────────────
+
+def get_recommendations(env: Dict[str, Any]) -> Dict[str, Any]:
+    ram       = env["ram_gb"]
+    chip      = env["chip"]
+    mlx       = env["mlx"]
+    tools     = env["tools"]
+    api_keys  = env["api_keys"]
+    disk_free = env["disk_free_gb"]
+    is_apple  = chip["is_apple_silicon"]
+    gpu       = env.get("gpu", {})
+    cuda      = env.get("cuda", {})
+    wsl       = env.get("wsl", {})
+    cpu       = env.get("cpu", {})
+    os_name   = env.get("os", "")
+
+    max_model_gb = ram * 0.72  # ~28% headroom for OS + apps
+
+    if is_apple:
+        preferred_engine = "local_mlx"
+    elif gpu.get("vendor") == "nvidia" and cuda.get("available") and (os_name == "Linux" or wsl.get("is_wsl")):
+        preferred_engine = "vllm"
+    elif tools.get("lms"):
+        preferred_engine = "lmstudio"
+    elif tools.get("ollama"):
+        preferred_engine = "ollama"
+    else:
+        preferred_engine = "llamacpp"
+
+    apple_catalog = _filter_lower_family_versions(_MODEL_CATALOG)
+    engine_catalog = (
+        []
+        if is_apple
+        else _filter_lower_family_versions(_CROSS_PLATFORM_MODEL_CATALOG[preferred_engine])
+    )
+    best_id = _best_model_for_engine(
+        "local_mlx" if is_apple else preferred_engine,
+        ram,
+        apple_catalog if is_apple else engine_catalog,
+    )
+
+    # ── Engines ──────────────────────────────────────────────────────────────
+    engines: List[Dict] = []
+
+    if is_apple:
+        if mlx["available"] and mlx["mlx_vlm"]:
+            engines.append({
+                "id": "engine_mlx", "name": "MLX",
+                "subtitle": f"{chip['name']} GPU 가속 · MLX-VLM 멀티모달 실행",
+                "status": "installed", "priority": "recommended",
+                "checked": True, "action": None, "badge": "설치됨",
+            })
+        else:
+            engines.append({
+                "id": "engine_mlx", "name": "MLX",
+                "subtitle": f"{chip['name']} 전용 MLX-VLM 멀티모달 실행",
+                "status": "available", "priority": "recommended",
+                "checked": True,
+                "action": {"type": "pip", "packages": ["mlx-vlm"], "verify_modules": ["mlx", "mlx_vlm"]},
+                "badge": "설치 필요",
+            })
+
+    if tools.get("ollama"):
+        engines.append({
+            "id": "engine_ollama", "name": "Ollama",
+            "subtitle": "범용 로컬 LLM 서버 · 크로스 플랫폼",
+            "status": "installed", "priority": "recommended" if preferred_engine == "ollama" else "optional",
+            "checked": preferred_engine == "ollama", "action": None, "badge": "설치됨",
+        })
+    else:
+        hint = "brew install 가능" if (tools.get("brew") or env["os"] == "Darwin") else "수동 설치 필요"
+        engines.append({
+            "id": "engine_ollama", "name": "Ollama",
+            "subtitle": "범용 로컬 LLM 서버 · 크로스 플랫폼",
+            "status": "available", "priority": "recommended" if preferred_engine == "ollama" else "optional",
+            "checked": preferred_engine == "ollama",
+            "action": (
+                {"type": "brew", "package": "ollama", "binary": "ollama", "official_url": OFFICIAL_DOWNLOADS["ollama"]}
+                if tools.get("brew")
+                else {"type": "url", "url": OFFICIAL_DOWNLOADS["ollama"], "binary": "ollama"}
+            ),
+            "badge": hint,
+        })
+
+    if not is_apple:
+        lmstudio_installed = bool(tools.get("lms"))
+        engines.append({
+            "id": "engine_lmstudio", "name": "LM Studio",
+            "subtitle": "Windows/macOS/Linux 데스크톱 GPU 서버 · 모델 다운로드 UI 포함",
+            "status": "installed" if lmstudio_installed else "available",
+            "priority": "recommended" if preferred_engine == "lmstudio" else "optional",
+            "checked": preferred_engine == "lmstudio",
+            "action": None if lmstudio_installed else {"type": "url", "url": OFFICIAL_DOWNLOADS["lmstudio"], "binary": "lms"},
+            "badge": "설치됨" if lmstudio_installed else "설치 필요",
+        })
+        if gpu.get("vendor") == "nvidia":
+            engines.append({
+                "id": "engine_cuda", "name": "CUDA",
+                "subtitle": f"NVIDIA {gpu.get('name') or 'GPU'} · VRAM {gpu.get('vram_gb') or 0} GB",
+                "status": "installed" if cuda.get("available") else "available",
+                "priority": "recommended",
+                "checked": False,
+                "action": None if cuda.get("available") else {"type": "url", "url": OFFICIAL_DOWNLOADS["cuda"], "binary": "nvcc"},
+                "badge": cuda.get("version") or ("감지됨" if cuda.get("available") else "설치 필요"),
+            })
+            engines.append({
+                "id": "engine_vllm", "name": "vLLM",
+                "subtitle": "NVIDIA 서버형 추론 · Windows는 WSL/Linux 권장",
+                "status": "available",
+                "priority": "recommended" if preferred_engine == "vllm" else "optional",
+                "checked": preferred_engine == "vllm",
+                "action": {"type": "pip", "packages": ["vllm", "huggingface_hub[cli]"], "verify_modules": ["vllm", "huggingface_hub"]},
+                "badge": "WSL/Linux 권장" if os_name == "Windows" and not wsl.get("is_wsl") else "설치 가능",
+            })
+        elif gpu.get("vendor") in {"amd", "intel"}:
+            engines.append({
+                "id": "engine_vulkan_directml", "name": "Vulkan/DirectML",
+                "subtitle": f"{gpu.get('vendor', '').upper()} GPU 감지 · LM Studio 또는 llama.cpp 백엔드 권장",
+                "status": "available",
+                "priority": "recommended" if preferred_engine in {"lmstudio", "llamacpp"} else "optional",
+                "checked": False,
+                "action": None,
+                "badge": gpu.get("backend") or "GPU",
+            })
+
+    components: List[Dict] = []
+    component_specs = [
+        ("homebrew", "Homebrew", "macOS 패키지 관리자 · 자동 설치 기반", "brew", None, "recommended"),
+        ("git", "Git", "저장소 · 확장 · MCP 도구 연동에 필요", "git", "git", "recommended"),
+        ("node", "Node.js", "npm 패키지와 VS Code 확장 개발에 필요", "node", "node", "optional"),
+        ("tesseract", "Tesseract OCR", "이미지/PDF OCR 기능에 필요", "tesseract", "tesseract", "optional"),
+    ]
+    for cid, name, subtitle, binary, brew_pkg, priority in component_specs:
+        installed = bool(tools.get(binary))
+        if cid == "homebrew" and env["os"] != "Darwin":
+            continue
+        if installed:
+            components.append({
+                "id": f"component_{cid}", "name": name,
+                "subtitle": subtitle, "status": "installed",
+                "priority": priority, "checked": False, "action": None,
+                "badge": "설치됨",
+            })
+            continue
+        if cid == "homebrew":
+            action = {"type": "url", "url": OFFICIAL_DOWNLOADS["homebrew"], "binary": "brew"}
+        elif tools.get("brew") and brew_pkg:
+            action = {
+                "type": "brew",
+                "package": brew_pkg,
+                "binary": binary or "",
+                "official_url": OFFICIAL_DOWNLOADS.get(cid, ""),
+            }
+        else:
+            action = {
+                "type": "url",
+                "url": OFFICIAL_DOWNLOADS.get(cid, ""),
+                "binary": binary or "",
+            }
+        components.append({
+            "id": f"component_{cid}", "name": name,
+            "subtitle": subtitle, "status": "available",
+            "priority": priority, "checked": priority == "recommended",
+            "action": action, "badge": "설치 필요",
+        })
+
+    python_ok = sys.version_info >= (3, 11)
+    if not python_ok:
+        components.insert(0, {
+            "id": "component_python", "name": "Python 3.11+",
+            "subtitle": "Lattice AI 서버 실행에 필요한 Python 런타임",
+            "status": "available", "priority": "recommended", "checked": True,
+            "action": {"type": "url", "url": OFFICIAL_DOWNLOADS["python"], "binary": "python3"},
+            "badge": "업데이트 필요",
+        })
+
+    for provider, has_key in api_keys.items():
+        if has_key:
+            engines.append({
+                "id": f"engine_{provider}", "name": provider.title(),
+                "subtitle": f"{provider.upper()}_API_KEY 감지됨 · 클라우드 API",
+                "status": "ready", "priority": "optional",
+                "checked": False, "action": None, "badge": "준비됨",
+            })
+
+    # ── Models ───────────────────────────────────────────────────────────────
+    models: List[Dict] = []
+
+    if is_apple:
+        for mid, mname, size_gb, tag, desc, min_ram in apple_catalog:
+            fits    = ram >= min_ram and size_gb <= max_model_gb and disk_free >= size_gb + 2
+            is_best = mid == best_id
+            models.append({
+                "id":       f"model_{mid.replace('/', '__').replace('-', '_')}",
+                "model_id": mid,
+                "name":     mname,
+                "subtitle": desc,
+                "size_gb":  size_gb,
+                "tag":      tag,
+                "fits":     fits,
+                "priority": "recommended" if is_best else "optional",
+                "checked":  is_best and fits,
+                "disabled": not fits,
+                "badge":    f"{size_gb} GB",
+                "action":   {"type": "load_model", "model_id": mid} if fits else None,
+            })
+    else:
+        vram_gb = float(gpu.get("vram_gb") or 0)
+        gpu_budget_gb = vram_gb * 1.15 if gpu.get("vendor") in {"nvidia", "amd", "intel"} and vram_gb else max_model_gb
+        model_budget_gb = min(max_model_gb, gpu_budget_gb)
+        for mid, mname, size_gb, tag, desc, min_ram in engine_catalog:
+            fits = ram >= min_ram and size_gb <= model_budget_gb and disk_free >= size_gb + 2
+            is_best = mid == best_id
+            models.append({
+                "id":       f"model_{mid.replace('/', '__').replace(':', '__').replace('-', '_')}",
+                "model_id": mid,
+                "name":     mname,
+                "subtitle": desc,
+                "size_gb":  size_gb,
+                "tag":      tag,
+                "fits":     fits,
+                "priority": "recommended" if is_best else "optional",
+                "checked":  is_best and fits,
+                "disabled": not fits,
+                "badge":    f"{size_gb} GB · {preferred_engine}",
+                "action":   {"type": "load_model", "model_id": mid} if fits else None,
+            })
+    if models and not any(item.get("checked") for item in models):
+        for item in models:
+            if not item.get("disabled"):
+                item["priority"] = "recommended"
+                item["checked"] = True
+                break
+
+    # ── MCPs ─────────────────────────────────────────────────────────────────
+    mcps: List[Dict] = [
+        {
+            "id": "mcp_files", "name": "Workspace Files",
+            "subtitle": "파일 읽기/쓰기 · 코드 생성 · 미리보기",
+            "status": "active", "priority": "recommended",
+            "checked": True, "action": None,
+            "badge": "기본 탑재", "needs_auth": False,
+        },
+        {
+            "id": "mcp_presentations", "name": "Presentations",
+            "subtitle": "PPTX · 슬라이드 자동 생성",
+            "status": "active", "priority": "optional",
+            "checked": False, "action": None,
+            "badge": "기본 탑재", "needs_auth": False,
+        },
+        {
+            "id": "mcp_github", "name": "GitHub",
+            "subtitle": "저장소 · PR · 이슈 · CI 연동",
+            "status": "available", "priority": "optional",
+            "checked": False,
+            "action": {"type": "auth", "url": "https://github.com/apps", "mcp_id": "github"},
+            "badge": "인증 필요", "needs_auth": True,
+        },
+        {
+            "id": "mcp_googledrive", "name": "Google Drive",
+            "subtitle": "Docs · Sheets · Drive 파일 연동",
+            "status": "available", "priority": "optional",
+            "checked": False,
+            "action": {"type": "auth", "url": "https://chatgpt.com/connectors", "mcp_id": "google-drive"},
+            "badge": "인증 필요", "needs_auth": True,
+        },
+        {
+            "id": "mcp_slack", "name": "Slack",
+            "subtitle": "팀 채널 공유 · 알림 워크플로",
+            "status": "available", "priority": "optional",
+            "checked": False,
+            "action": {"type": "auth", "url": "https://chatgpt.com/connectors", "mcp_id": "slack"},
+            "badge": "인증 필요", "needs_auth": True,
+        },
+    ]
+
+    return _hydrate_install_actions({
+        "components": components,
+        "engines": engines,
+        "models":  models,
+        "mcps":    mcps,
+        "summary": {
+            "chip":            chip["name"],
+            "cpu_cores":       cpu.get("logical_cores"),
+            "cpu_instructions": cpu.get("instructions", []),
+            "gpu":             gpu.get("name") or gpu.get("vendor"),
+            "gpu_vendor":      gpu.get("vendor"),
+            "vram_gb":         gpu.get("vram_gb"),
+            "cuda":            cuda.get("available"),
+            "cuda_version":    cuda.get("version"),
+            "wsl":             wsl,
+            "preferred_engine": preferred_engine,
+            "ram_gb":          ram,
+            "disk_free_gb":    disk_free,
+            "is_apple_silicon": is_apple,
+            "max_model_gb":    round(max_model_gb, 1),
+        },
+    })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ltcai",
-  "version": "11.1.0",
+  "version": "11.4.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": {
@@ -24,7 +24,9 @@
     "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:i18n-namespaces && npm run check:bundle && npm run check:legacy-debt && npm run check:server-i18n && npm run test:browser-extension && npm run test:vscode-extension && node scripts/check_release_evidence_bound.mjs",
+    "lint": "npm run lint:python && npm run lint:visual && npm run lint:frontend && npm run frontend:openapi:check && node scripts/check_i18n_literals.mjs && npm run check:i18n-namespaces && npm run check:bundle && npm run check:legacy-debt && npm run check:server-i18n && npm run test:browser-extension && npm run test:vscode-extension && node scripts/check_release_evidence_bound.mjs && npm run check:max-file-lines",
+    "lint:visual": "for f in tests/visual/*.js tests/visual/*.cjs tests/visual/mock_server/*.cjs; do node --check \"$f\" || exit 1; done && echo 'visual syntax ok'",
+    "check:max-file-lines": "node scripts/check_max_file_lines.mjs",
     "check:release-evidence-bound": "node scripts/check_release_evidence_bound.mjs",
     "check:legacy-debt": "node scripts/check_legacy_debt.mjs",
     "check:server-i18n": "node scripts/check_server_i18n.mjs",
@@ -48,6 +50,8 @@
     "desktop:tauri": "tauri dev",
     "desktop:tauri:build": "tauri build",
     "desktop:tauri:check": "cd src-tauri && cargo check",
+    "rust:test": "cd rust && cargo test --workspace",
+    "rust:lint": "cd rust && cargo fmt --all -- --check && cargo clippy --workspace --all-targets -- -D warnings",
     "desktop:electron": "electron desktop/electron/main.cjs",
     "package:vsix": "node scripts/build_vsix.mjs",
     "check:screenshot-delta": "node scripts/run_python.mjs scripts/check_screenshot_pixel_delta.py",

package/scripts/bump_version.py

@@ -20,6 +20,14 @@ from pathlib import Path
 
 REPO = Path(__file__).resolve().parents[1]
 
+# The rust/ workspace crates carry `version.workspace = true`, so the workspace
+# root is the only hand-edited copy of the number. Both lockfiles still record
+# it per crate — src-tauri's too, since 11.4.0, because the desktop shell now
+# depends on lattice-host by path — and a lockfile left behind is a file the
+# next `cargo build` silently rewrites underneath a tagged release.
+RUST_CRATES = ("lattice-core", "lattice-host", "lattice-retrieval")
+RUST_LOCKFILES = ("rust/Cargo.lock", "src-tauri/Cargo.lock")
+
 # (path, kind, pattern) — pattern groups: (prefix, version)
 TARGETS = [
     ("latticeai/__init__.py", "regex", r'(__version__ = ")([^"]+)(")'),
@@ -40,6 +48,12 @@ TARGETS = [
     ("src-tauri/Cargo.toml", "regex", r'(^version = ")([^"]+)(")'),
     ("src-tauri/Cargo.lock", "regex", r'(name = "lattice-ai-desktop"\nversion = ")([^"]+)(")'),
     ("src-tauri/tauri.conf.json", "json", "version"),
+    ("rust/Cargo.toml", "regex", r'(^version = ")([^"]+)(")'),
+    *[
+        (lock, "regex", rf'(name = "{crate}"\nversion = ")([^"]+)(")')
+        for lock in RUST_LOCKFILES
+        for crate in RUST_CRATES
+    ],
     ("static/app/asset-manifest.json", "json", "version"),
 ]
 

package/scripts/capture_release_evidence.mjs

@@ -4,6 +4,12 @@ import { execFileSync, spawn } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
 
+import {
+  MOCK_SERVER_ENTRY,
+  MOCK_SERVER_LABEL,
+  mockServerFingerprint,
+} from "./lib/mock_server_fingerprint.mjs";
+
 const repoRoot = process.cwd();
 const version = JSON.parse(fs.readFileSync(path.join(repoRoot, "package.json"), "utf8")).version;
 const port = Number(process.env.LTCAI_RELEASE_EVIDENCE_PORT || 4936);
@@ -34,20 +40,10 @@ function assetManifestFingerprint() {
   };
 }
 
-const mockServerPath = path.join(repoRoot, "tests", "visual", "mock_server.cjs");
-
-function mockServerFingerprint() {
-  if (!fs.existsSync(mockServerPath)) {
-    return null;
-  }
-  const body = fs.readFileSync(mockServerPath);
-  const stat = fs.statSync(mockServerPath);
-  return {
-    sha256: createHash("sha256").update(body).digest("hex"),
-    mtime: stat.mtime.toISOString(),
-    bytes: body.length,
-  };
-}
+// The mock API surface is the entry file plus the route modules it composes;
+// the fingerprint covers all of them. Shared with
+// scripts/check_release_evidence_bound.mjs so the digest recorded here and the
+// digest verified there are computed by exactly one piece of code.
 
 /**
  * Refuse to overwrite published release screenshots for an already-tagged version.
@@ -99,7 +95,7 @@ function assertNotOverwritingTaggedRelease() {
  * Refuse to capture when the release lint gate is red.
  *
  * Failure mode this catches: lint is failing (e.g. ruff F841) but
- * capture still runs and writes 12 screenshots + SCREENSHOT_INDEX.md
+ * capture still runs and writes 13 screenshots + SCREENSHOT_INDEX.md
  * bound to the asset manifest — evidence that looks green while the
  * first CI stage would already have stopped. Capture is not proof that
  * the tree is releasable; lint must pass first.
@@ -253,7 +249,7 @@ fs.mkdirSync(screenshots, { recursive: true });
 fs.mkdirSync(videos, { recursive: true });
 fs.mkdirSync(gifs, { recursive: true });
 
-const server = spawn(process.execPath, ["tests/visual/mock_server.cjs"], {
+const server = spawn(process.execPath, [MOCK_SERVER_ENTRY], {
   cwd: repoRoot,
   env: { ...process.env, LTCAI_VISUAL_PORT: String(port) },
   stdio: ["ignore", "pipe", "pipe"],
@@ -444,6 +440,18 @@ async function main() {
   }
   await shot(page, "12-review-center.png");
 
+  // 연대기 (11.3.0). Waiting on the title alone would publish the loading or
+  // empty frame, which is precisely what this screen must never be caught in:
+  // "오늘부터 기록이 쌓입니다" is a true state and a useless screenshot. Wait for
+  // the drawn curve and a populated grid, both of which only exist once the
+  // overview read has landed.
+  await page.goto(`${baseURL}/app#/chronicle`, { waitUntil: "networkidle" });
+  await page.locator("h1.page-title", { hasText: "두뇌가 자라온 시간" }).waitFor();
+  await page.locator(".chronicle-growth-area[d^='M']").waitFor();
+  await page.getByTestId("chronicle-heatmap-cell").first().waitFor();
+  await page.getByTestId("chronicle-day").waitFor();
+  await shot(page, "13-chronicle.png");
+
   const video = page.video();
   await context.close();
   await browser.close();
@@ -473,13 +481,14 @@ async function main() {
   if (!fingerprint) {
     throw new Error("asset-manifest.json missing after capture — cannot bind evidence");
   }
-  const mockFp = mockServerFingerprint();
+  const mockFp = mockServerFingerprint(repoRoot);
   if (!mockFp) {
-    throw new Error("tests/visual/mock_server.cjs missing after capture — cannot bind evidence");
+    throw new Error(`${MOCK_SERVER_ENTRY} missing after capture — cannot bind evidence`);
   }
   // Post-capture binding: if a later build:assets changes the manifest hash,
-  // or mock_server.cjs changes the capture payloads, check_release_evidence_bound.mjs
-  // will refuse to trust these screenshots without a recapture.
+  // or any mock-server file changes the capture payloads,
+  // check_release_evidence_bound.mjs will refuse to trust these screenshots
+  // without a recapture.
   const index = `# v${version} Release Evidence
 
 Captured from the built React/Vite app served by the release visual API on ${new Date().toISOString()}.
@@ -487,7 +496,8 @@ Captured from the built React/Vite app served by the release visual API on ${new
 ## Build Binding
 
 Evidence is only trustworthy while this fingerprint matches
-\`static/app/asset-manifest.json\` **and** \`tests/visual/mock_server.cjs\`.
+\`static/app/asset-manifest.json\` **and** the mock API surface
+(\`${MOCK_SERVER_LABEL}\`).
 A later \`build:assets\` or mock-server edit without recapture invalidates the
 screenshots even when their mtimes look fresh.
 
@@ -497,6 +507,7 @@ screenshots even when their mtimes look fresh.
 - mock-server.sha256: \`${mockFp.sha256}\`
 - mock-server.mtime: \`${mockFp.mtime}\`
 - mock-server.bytes: ${mockFp.bytes}
+- mock-server.files: ${mockFp.files}
 
 ## Screenshots
 
@@ -514,6 +525,7 @@ screenshots even when their mtimes look fresh.
 | [10-admin-console.png](screenshots/10-admin-console.png) | Separate Admin Console |
 | [11-knowledge-journey.png](screenshots/11-knowledge-journey.png) | Material-to-memory steps |
 | [12-review-center.png](screenshots/12-review-center.png) | Automation Review Center |
+| [13-chronicle.png](screenshots/13-chronicle.png) | Brain Chronicle — growth, activity, one day's story |
 
 ## Motion Evidence
 

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 = "Product Intelligence";
+const releaseTheme = "Rust Foundation";
 const title = `${version} — ${releaseTheme}`;
 const escapedVersion = version.replaceAll(".", "\\.");
 

package/scripts/check_i18n_namespace_coverage.mjs

@@ -28,11 +28,48 @@ const NAMESPACES = readdirSync(i18nDir)
   .map((name) => name.replace(/\.ts$/, ""))
   .filter((name) => !["types", "registry"].includes(name));
 
+/**
+ * Every file that holds copy for a namespace.
+ *
+ * A namespace is one module — `brain.ts` — and that module is still the only
+ * thing that calls `registerCopy`. But a dictionary that outgrew one file keeps
+ * its domain parts in a directory beside it (`brain/home.ts`, `brain/chat.ts`,
+ * …), which `brain.ts` imports and merges. Those parts own keys; they are not
+ * namespaces of their own, and importing one does NOT make the namespace
+ * available (nothing registers). So they feed `keyOwner` below, and the
+ * availability check further down still only accepts the namespace module.
+ */
+function namespaceSources(ns) {
+  const files = [join(i18nDir, `${ns}.ts`)];
+  const partsDir = join(i18nDir, ns);
+  if (existsSync(partsDir) && statSync(partsDir).isDirectory()) {
+    const walk = (dir) => {
+      for (const name of readdirSync(dir)) {
+        const path = join(dir, name);
+        if (statSync(path).isDirectory()) walk(path);
+        else if (name.endsWith(".ts")) files.push(path);
+      }
+    };
+    walk(partsDir);
+  }
+  return files;
+}
+
+/** A file inside frontend/src/i18n holds copy, never key uses to check. */
+function insideI18n(file) {
+  const rel = relative(i18nDir, file);
+  return rel !== "" && !rel.startsWith("..");
+}
+
 // key -> namespace that defines it
 const keyOwner = new Map();
+let copyFiles = 0;
 for (const ns of NAMESPACES) {
-  const text = readFileSync(join(i18nDir, `${ns}.ts`), "utf8");
-  for (const match of text.matchAll(/^\s+"([^"]+)":/gm)) keyOwner.set(match[1], ns);
+  for (const file of namespaceSources(ns)) {
+    copyFiles += 1;
+    const text = readFileSync(file, "utf8");
+    for (const match of text.matchAll(/^\s+"([^"]+)":/gm)) keyOwner.set(match[1], ns);
+  }
 }
 
 // `shell` is registered by i18n.ts itself, so it is always available.
@@ -121,7 +158,7 @@ for (const [label, entry] of entries) {
     }
   }
   for (const file of modules) {
-    if (dirname(file) === i18nDir) continue;
+    if (insideI18n(file)) continue;
     for (const key of moduleInfo(file).keys) {
       const owner = keyOwner.get(key);
       if (!owner) {
@@ -144,5 +181,5 @@ if (errors.length) {
 
 console.log(
   `i18n namespace coverage: ${entries.size} entry chunk(s) verified against `
-  + `${NAMESPACES.length} namespaces (${keyOwner.size} keys).`,
+  + `${NAMESPACES.length} namespaces (${keyOwner.size} keys across ${copyFiles} copy file(s)).`,
 );