ltcai 12.3.0 → 12.5.0

package/README.md

@@ -12,7 +12,7 @@
 [![CD Status](https://github.com/TaeSooPark-PTS/LatticeAI/actions/workflows/publish.yml/badge.svg)](https://github.com/TaeSooPark-PTS/LatticeAI/actions/workflows/publish.yml)
 [![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 
-![v12.3.0 Living Brain walkthrough](output/release/v12.3.0/gifs/v12.3.0-living-brain-walkthrough.gif)
+![v12.5.0 Living Brain walkthrough](output/release/v12.5.0/gifs/v12.5.0-living-brain-walkthrough.gif)
 
 Lattice AI is a Digital Brain that lives on your computer. Chat, files,
 folders, notes, and web pages all land in one knowledge graph you own.
@@ -42,19 +42,19 @@ LTCAI                    # then open http://127.0.0.1:4825/app
 
 | | | |
 | --- | --- | --- |
-| ![Login](output/release/v12.3.0/screenshots/01-login.png) | ![Model install](output/release/v12.3.0/screenshots/03-install-load-progress.png) | ![Model library](output/release/v12.3.0/screenshots/07-model-library.png) |
+| ![Login](output/release/v12.5.0/screenshots/01-login.png) | ![Model install](output/release/v12.5.0/screenshots/03-install-load-progress.png) | ![Model library](output/release/v12.5.0/screenshots/07-model-library.png) |
 
 Screenshot index:
-[output/release/v12.3.0/SCREENSHOT_INDEX.md](output/release/v12.3.0/SCREENSHOT_INDEX.md)
+[output/release/v12.5.0/SCREENSHOT_INDEX.md](output/release/v12.5.0/SCREENSHOT_INDEX.md)
 
 ## What you can do
 
 | | |
 | --- | --- |
-| **See your Brain's story in time** — a growth curve, an activity heatmap, and each day's story ![Brain Chronicle](output/release/v12.3.0/screenshots/13-chronicle.png) | **Chat with a Brain that remembers** — every conversation grows durable, source-linked memory ![Brain Chat](output/release/v12.3.0/screenshots/04-brain-chat-home.png) |
-| **See how knowledge connects** — a real relationship graph, not a file list ![Memory Graph](output/release/v12.3.0/screenshots/05-memory-graph.png) | **Capture anything** — files, whole folders, notes, screenshots, web pages ![Capture](output/release/v12.3.0/screenshots/06-capture.png) |
-| **Automate with review** — agent changes become proposals you approve first ![Review Center](output/release/v12.3.0/screenshots/12-review-center.png) | **Pick a model in one click** — recommended local models for your hardware ![Recommended Models](output/release/v12.3.0/screenshots/02-recommended-models.png) |
-| **Watch a file become memory** — three named steps, not a pipeline diagram ![Material to memory](output/release/v12.3.0/screenshots/11-knowledge-journey.png) | **Say how much it may do alone** — one dial in plain words ![Settings](output/release/v12.3.0/screenshots/08-system.png) |
+| **See your Brain's story in time** — a growth curve, an activity heatmap, and each day's story ![Brain Chronicle](output/release/v12.5.0/screenshots/13-chronicle.png) | **Chat with a Brain that remembers** — every conversation grows durable, source-linked memory ![Brain Chat](output/release/v12.5.0/screenshots/04-brain-chat-home.png) |
+| **See how knowledge connects** — a real relationship graph, not a file list ![Memory Graph](output/release/v12.5.0/screenshots/05-memory-graph.png) | **Capture anything** — files, whole folders, notes, screenshots, web pages ![Capture](output/release/v12.5.0/screenshots/06-capture.png) |
+| **Automate with review** — agent changes become proposals you approve first ![Review Center](output/release/v12.5.0/screenshots/12-review-center.png) | **Pick a model in one click** — recommended local models for your hardware ![Recommended Models](output/release/v12.5.0/screenshots/02-recommended-models.png) |
+| **Watch a file become memory** — three named steps, not a pipeline diagram ![Material to memory](output/release/v12.5.0/screenshots/11-knowledge-journey.png) | **Say how much it may do alone** — one dial in plain words ![Settings](output/release/v12.5.0/screenshots/08-system.png) |
 
 ## Why this is yours
 
@@ -70,42 +70,27 @@ Screenshot index:
 
 ## Current Release
 
-The current release is **12.3.0 — Live Wire**:
-
-Model catalog routes, GGUF quantization tags, small-model tool/MCP calling,
-and HTML generation/inspection/download are verified end-to-end against live
-repositories and a loaded local model. The door is still **422 operations /
-41 families** over a **20-route worker**. Cloud is still optional and the
-default is still local.
-
-- **Verified Hugging Face GGUF tags & routes.** `ggml-org/gemma-4-*-GGUF`
-  uses `Q4_0`, `ggml-org/gpt-oss-20b-GGUF` uses `MXFP4`, and `Qwen3.5-9B` /
-  `Qwen3.6-35B-A3B` GGUF routes are wired across `ollama`, `lmstudio`, and
-  `llamacpp`.
-- **Auxiliary GGUF filtering, `--mmproj` companion load, and shard checks.**
-  `mmproj-`/`mtp-`/`dflash-`/`eagle3-`/`imatrix` GGUFs are excluded from
-  primary weight selection, companion `mmproj-*.gguf` files are downloaded
-  for `llama-server`, and `model.safetensors.index.json` shards are verified.
-- **Small-model tool calling & MCP calling hardening.** Expanded
-  `KNOWN_ACTIONS`, stringified `arguments` recovery, OpenAI `tool_calls`
-  array unwrapping, fenced HTML/code block salvage, and `adopt_named_args`
-  in `perform_action`.
-- **HTML structure inspection & RFC 5987 UTF-8 download.**
-  `POST /tools/inspect_html` extracts `title`, `links`, `scripts`,
-  `stylesheets`, `images`, `forms`, and `headings`; `GET /tools/download`
-  decodes UTF-8 paths and sends `filename*=UTF-8''...`.
+The current release is **12.5.0 — Deep Vector**:
+
+The embedding pipeline adds native **Google EmbeddingGemma 2** (`google/embeddinggemma-2`, 768-dim) support with Hugging Face mean-pooling and L2 normalization, adds **hardware-aware embedding model recommendations** that calculate host RAM/VRAM reservations before recommending LLMs, migrates screenshot pixel diffing to Pillow 13+ `get_flattened_data()`, upgrades GitHub Actions CI/CD to Node 24 native major versions, and automates full OpenAPI specification and fragment synchronization in `scripts/bump_version.py`. The door is still **422 operations / 41 families** over a **20-route worker**. Cloud is still optional and the default is still local.
+
+- **Google EmbeddingGemma 2 native integration.** Native Hugging Face embedding provider support (`google/embeddinggemma-2`, `embeddinggemma-2`, `embeddinggemma-2-4bit`, `embeddinggemma-2-8bit`, `embeddinggemma-300m`, 768-dimensional vectors) in `latticeai/core/embedding_providers/text.py` with mean pooling, L2 normalization, task instruction prefixes, and automatic semantic activation. Hash embedding fallback remains preserved when offline.
+- **Hardware-aware PC-tailored embedding recommendations.** Modularized `recommend_embedding_for_host` in `lattice-platform` and `latticeai/services/embedding_recommendation.py`. Systems with >=8GB RAM receive `google/embeddinggemma-2` with a 0.5GB–1.5GB reserved RAM budget; smaller hosts receive `google/embeddinggemma-300m`. The host probe calculates `effective_ram_gb` before LLM tier selection.
+- **Onboarding and Model Library embedding UI.** Added the PC-tailored EmbeddingGemma 2 recommendation card in `ProductFlow.tsx` with full i18n support, and surfaced Google EmbeddingGemma 2 in the Model Library (`Library.tsx`) embedding section with 1-click install and activation.
+- **Pillow 13+ flattened data & CI/CD modernisation.** Replaced Pillow 14-deprecated `diff.getdata()` calls in `scripts/check_screenshot_pixel_delta.py` with `diff.get_flattened_data()`, and pinned GitHub Actions to Node 24 native versions with `FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"`.
+- **OpenAPI specification and fixture version automation.** Extended `scripts/bump_version.py` to synchronize `frontend/openapi.json`, `rust/fixtures/openapi/_envelope.json`, all 13 OpenAPI fragment files, and `rust/fixtures/openapi/_index.json` with recomputed SHA-256 digests across 49 targets.
 
 Release notes live in [docs/releases/](docs/releases/). This version:
-[docs/releases/RELEASE_NOTES_v12.3.0.md](docs/releases/RELEASE_NOTES_v12.3.0.md).
+[docs/releases/RELEASE_NOTES_v12.5.0.md](docs/releases/RELEASE_NOTES_v12.5.0.md).
 Guide: [RELEASE.md](RELEASE.md) · History: [docs/CHANGELOG.md](docs/CHANGELOG.md).
 
-Expected artifacts for 12.3.0 must use exact filenames:
+Expected artifacts for 12.5.0 must use exact filenames:
 
-- `dist/ltcai-12.3.0-py3-none-any.whl`
-- `dist/ltcai-12.3.0.tar.gz`
-- `ltcai-12.3.0.tgz`
-- `dist/ltcai-12.3.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_12.3.0_aarch64.dmg`
+- `dist/ltcai-12.5.0-py3-none-any.whl`
+- `dist/ltcai-12.5.0.tar.gz`
+- `ltcai-12.5.0.tgz`
+- `dist/ltcai-12.5.0.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_12.5.0_aarch64.dmg`
 
 Do not use wildcard artifact uploads. Package registry publishing remains owner-run.
 
@@ -176,7 +161,7 @@ Validation via `npm run lint`, `npm run test:unit`, `npm run test:visual`.
   pending-only, no Self-Model refiner, `delete_node` leaving `PART_OF`,
   review events silent without an owner, KG-api ingest text-only, two
   store cycles per review mutation) are listed with their reasons in
-  [docs/releases/RELEASE_NOTES_v12.3.0.md](docs/releases/RELEASE_NOTES_v12.3.0.md)
+  [docs/releases/RELEASE_NOTES_v12.4.0.md](docs/releases/RELEASE_NOTES_v12.4.0.md)
   and prioritized in [docs/ROADMAP.md](docs/ROADMAP.md).
 
 ## Release History
@@ -188,6 +173,7 @@ same boundary. Earlier notes live in [docs/releases/](docs/releases/).
 
 | Version | Theme |
 | --- | --- |
+| 12.4.0 | Sharp Weight |
 | 12.3.0 | Live Wire |
 | 12.2.1 | True Count |
 | 12.2.0 | Small Voice |

package/docs/CHANGELOG.md

@@ -4,6 +4,50 @@ The top entry is either the current unreleased main-branch work or the current
 release line. Older entries are historical and may describe behavior as it
 existed at that release.
 
+## [12.5.0] - 2026-11-11 — Deep Vector
+
+### Added
+- Added native Hugging Face embedding provider for Google EmbeddingGemma 2 (`google/embeddinggemma-2`, `embeddinggemma-2`, `embeddinggemma-2-4bit`, `embeddinggemma-2-8bit`, `embeddinggemma-300m`, 768-dim) with mean-pooling, L2 normalization, task prefixes, and fallback protection in `latticeai/core/embedding_providers/text.py`.
+- Added hardware-aware PC-tailored embedding recommendations (`recommend_embedding_for_host`) in `rust/lattice-platform/src/modelops/models_catalog/embedding.rs` and `latticeai/services/embedding_recommendation.py` with memory reservation (0.5GB–1.5GB for Gemma 2, 0.3GB for 300M) before LLM selection.
+- Added PC-tailored EmbeddingGemma 2 recommendation card in `ProductFlow.tsx` (i18n supported) and surfaced Google EmbeddingGemma 2 in `Library.tsx` with 1-click prepare/download.
+- Added comprehensive visual E2E test suite `tests/visual/v3.all_buttons_inspection.spec.js` asserting all routes, controls, tabs, and buttons operate with 0 errors.
+
+### Changed
+- Migrated `scripts/check_screenshot_pixel_delta.py` from Pillow 14-deprecated `diff.getdata()` to `diff.get_flattened_data()`.
+- Upgraded all GitHub Actions workflows (`.github/workflows/*.yml`) to Node 24 native major versions with `FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"`.
+- Automated OpenAPI specification and fixture version synchronization across 49 targets in `scripts/bump_version.py`.
+
+## [12.4.0] - 2026-11-11 — Sharp Weight
+
+### Added
+- Added `mlx-community/Qwen3.8-27B-4bit` (`16.1GB`, `qwen3_5`) to the local
+  model capability registry, multi-engine GGUF/HF routes
+  (`ggml-org/Qwen3.8-27B-GGUF:Q4_K_M`, `Qwen/Qwen3.8-27B`), `together` and
+  `openrouter` cloud catalogs, and Rust `CATALOG_HINTS`.
+- Added `mlx-community/gemma-4-26B-A4B-it-qat-4bit` (`15.6GB`, routed to
+  Google's official QAT GGUF `google/gemma-4-26B-A4B-it-qat-q4_0-gguf:Q4_0` and
+  `google/gemma-4-26B-A4B-it-qat-q4_0-unquantized`) and
+  `mlx-community/gemma-4-26B-A4B-it-qat-OptiQ-4bit` (`21.9GB`, sensitivity-guided
+  mixed 4-bit/8-bit `mlx-optiq` build on Google's QAT base) to the capability
+  registry, engine routes, and Rust `CATALOG_HINTS`.
+
+### Changed
+- Upgraded `pillow` dependency constraint to `>=13,<14` in `pyproject.toml` and
+  `requirements.txt` (closing 39 CVEs in `pillow 12.3.0`), and synchronized
+  `reportlab>=4,<5` and `huggingface_hub>=1.0,<2` in `requirements.txt`.
+- Updated npm dependencies and lockfiles in root and `vscode-extension`
+  (`vitest` and `@vitest/coverage-v8` `^4.1.12`, `glob` `^14.0.4`, `minimatch`
+  `^11.0.7`) so `npm audit` reports 0 vulnerabilities.
+
+### Fixed
+- Hardened `_json_request` and `get_openai_compatible_server_models` in
+  `latticeai/services/model_engines.py` to reject non-`http(s)://` URL schemes.
+- Fixed `admin_log_retention` in `rust/lattice-platform/src/adminops/admin/handlers.rs`
+  to read `state.auth.clock().now()` instead of real wall-clock `unix_now()`,
+  eliminating wall-clock drift against deterministic audit fixtures.
+- Scoped `@import "tailwindcss" source("..");` in `frontend/src/styles.css` so
+  `@tailwindcss/oxide` only scans `frontend/` instead of walking `rust/target`.
+
 ## [12.3.0] - 2026-10-19 — Live Wire
 
 ### Added

package/docs/COMMUNITY_AND_PLUGINS.md

@@ -1,6 +1,6 @@
 # Community And Plugins
 
-Current release: **12.3.0 — Live Wire**.
+Current release: **12.5.0 — Deep Vector**.
 
 LatticeAI defines the path from a strong local-first framework (8.4.0
 action-aware baseline, 8.5.0 registry+DI hardening, 8.6.0 capture/navigation

package/docs/DEVELOPMENT.md

@@ -3,7 +3,7 @@
 > **Status: canonical** — current contributor guidance, kept in sync with the
 > current release.
 
-Current release: **12.3.0 — Live Wire**.
+Current release: **12.5.0 — Deep Vector**.
 
 This document is the contributor onboarding path: how to boot the tree, where
 a change belongs, which gates will go red, and the house rules that keep the
@@ -80,7 +80,7 @@ worker interpreter with `LTCAI_PYTHON` when both exist.
 `rust/target/release/lattice-host`, then `rust/target/debug/lattice-host`. If
 none exist it runs `cargo build -p lattice-host` (debug). A stale
 `rust/target/release/lattice-host` wins over a current debug binary — pin or
-rebuild (`cargo build -p lattice-host --release`) if `-V` is not 12.3.0.
+rebuild (`cargo build -p lattice-host --release`) if `-V` is not 12.4.0.
 
 Do not run `npm start` and `npm run dev` on the same port. The worker
 entrypoint defaults to `LATTICEAI_PORT` or **4825**, the same port as the
@@ -237,7 +237,7 @@ in `rust/`.
 Markdown) and `scripts/check_doc_status.mjs` (every relative link under the
 root canonical docs and `docs/**`). A red line is a broken relative path —
 fix the href or put the file where the href says. Canonical docs (this one
-included) must carry `Current release: **12.3.0 — …**` matching
+included) must carry `Current release: **12.5.0 — …**` matching
 `package.json`; do not bump that marker here ahead of the release lane.
 `npm run docs:check-current` is the release-set version pin
 ([`scripts/check_current_release_docs.mjs`](../scripts/check_current_release_docs.mjs)).
@@ -248,7 +248,7 @@ changelog entries that mention old versions stay.
 ### Release-evidence binding
 
 `scripts/check_release_evidence_bound.mjs` (lint member 9) checks that
-`output/release/v12.3.0/SCREENSHOT_INDEX.md` still names the live
+`output/release/v12.4.0/SCREENSHOT_INDEX.md` still names the live
 `static/app/asset-manifest.json` digest and the visual mock-server
 fingerprint. It exists so a later `npm run build:assets` cannot ship
 screenshots of an older UI, and so a mock-server edit cannot leave the
@@ -317,19 +317,19 @@ For user-facing, API, runtime, release, or packaging changes, check:
   appears
 
 The release-docs lane owns README / ARCHITECTURE / FEATURE_STATUS version
-bumps. Do not move this file's `Current release` marker off 12.3.0 ahead of
+bumps. Do not move this file's `Current release` marker off 12.5.0 ahead of
 that lane.
 
 Release/publish examples must use exact target-version filenames. Do not
 document wildcard artifact upload commands.
 
-For 12.3.0 release work, exact artifacts are:
+For 12.5.0 release work, exact artifacts are:
 
-- `dist/ltcai-12.3.0-py3-none-any.whl`
-- `dist/ltcai-12.3.0.tar.gz`
-- `ltcai-12.3.0.tgz`
-- `dist/ltcai-12.3.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_12.3.0_aarch64.dmg`
+- `dist/ltcai-12.5.0-py3-none-any.whl`
+- `dist/ltcai-12.5.0.tar.gz`
+- `ltcai-12.5.0.tgz`
+- `dist/ltcai-12.5.0.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_12.5.0_aarch64.dmg`
 
 The dmg is ad-hoc signed (effectively unsigned); `npm run release:validate`
 checks the names and presence, not a Developer ID signature.

package/docs/ONBOARDING.md

@@ -1,6 +1,6 @@
 # Lattice AI Onboarding
 
-Current release: **12.3.0 — Live Wire**.
+Current release: **12.5.0 — Deep Vector**.
 
 The first-run goal is a five-minute path from "I opened the app" to "my Brain
 has a source, a question, and proof." This page is the product contract behind

package/docs/OPERATIONS.md

@@ -1,4 +1,4 @@
-# Lattice AI — Operations Guide (v12.3.0)
+# Lattice AI — Operations Guide (v12.5.0)
 
 > **Status: canonical** — kept in sync with the current release. Storage layout
 > below reflects the SQLite live Brain store and workspace scoping, not the

package/docs/ROADMAP.md

@@ -3,7 +3,7 @@
 > **Status: reference** — point-in-time inventory, redated at v12.0.0. Not a
 > canonical current-release document; version gates do not bind it.
 
-As of **2026-10-19**, against the 12.3.0 — Live Wire tree. The rows below
+As of **2026-11-11**, against the 12.4.0 — Sharp Weight tree. The rows below
 were gathered against 11.9.0 and re-checked when 12.0.0 shipped; what that
 release closed is marked closed rather than deleted, so the ledger still
 shows what was owed.

package/docs/TRUST_MODEL.md

@@ -1,6 +1,6 @@
 # Lattice AI Trust Model
 
-Current release: **12.3.0 — Live Wire**.
+Current release: **12.5.0 — Deep Vector**.
 
 Lattice AI is local-first, explicit about external communication, and honest
 when a capability is unavailable.

package/docs/WHY_LATTICE.md

@@ -1,6 +1,6 @@
 # Why Lattice AI Exists
 
-Current release: **12.3.0 — Live Wire**.
+Current release: **12.5.0 — Deep Vector**.
 
 **Lattice AI is a local-first Digital Brain that keeps your knowledge durable
 across any AI model.**

package/docs/kg-schema.md

@@ -1,6 +1,6 @@
 # Knowledge Graph Schema
 
-Current release: **12.3.0 — Live Wire**.
+Current release: **12.5.0 — Deep Vector**.
 
 명세 출처: `lattice_ai_full_spec.pptx` 슬라이드 20·21·22
 구현: `lattice_brain/graph/schema.py`

package/lattice_brain/__init__.py

@@ -31,7 +31,7 @@ from .multimodal import (
     transcribe_audio,
 )
 
-__version__ = "12.3.0"
+__version__ = "12.5.0"
 
 __all__ = [
     "AudioFacts",

package/latticeai/__init__.py

@@ -1,3 +1,3 @@
 """Lattice AI - modular server package."""
 
-__version__ = "12.3.0"
+__version__ = "12.5.0"

package/latticeai/api/models.py

@@ -264,6 +264,11 @@ def create_models_router(
                 "size": item["size"],
                 "display_name": item.get("name") or item.get("id"),
                 "modality": item.get("modality") or "multimodal",
+                "category": item.get("category") or ("embedding" if item.get("task") == "embedding" else "chat"),
+                "task": item.get("task") or ("embedding" if item.get("category") == "embedding" else "chat"),
+                "role": item.get("role") or ("embedding" if item.get("category") == "embedding" else "chat"),
+                "dimensions": item.get("dimensions"),
+                "hf_repo_id": item.get("hf_repo_id") or item["id"],
                 "source_country": item.get("source_country"),
                 "source_company": item.get("source_company"),
                 "execution_method": item.get("execution_method"),
@@ -356,12 +361,27 @@ def create_models_router(
         )
         # 5.2.0: surface structured registry info (verified status, hf, hardware, strategies) for UX
         try:
-            from latticeai.services.model_catalog import get_verified_models
+            from latticeai.services.model_catalog import (
+                get_verified_models,
+                recommend_embedding_for_hardware,
+            )
             verified = get_verified_models()
+            embedding_rec = recommend_embedding_for_hardware()
         except Exception:
             verified = []
+            embedding_rec = {
+                "id": "google/embeddinggemma-2",
+                "hf_repo_id": "google/embeddinggemma-2",
+                "name": "Google EmbeddingGemma 2",
+                "category": "embedding",
+                "task": "embedding",
+                "role": "embedding",
+                "dimensions": 768,
+            }
         return {
             "recommended": recommended,
+            "embedding_model": embedding_rec.get("id") or "google/embeddinggemma-2",
+            "embedding_recommendation": embedding_rec,
             "cloud": _router.detected_cloud_models(),
             "engines": engines,
             "loaded": _router.loaded_model_ids,

package/latticeai/api/search.py

@@ -23,6 +23,10 @@ from typing import Any, Callable, Dict, NoReturn, Optional
 
 from fastapi import APIRouter, HTTPException, Request
 
+from latticeai.core.embedding_providers.profiles import (
+    RECOMMENDED_EMBEDDING_MODEL,
+    RECOMMENDED_EMBEDDING_PROFILE,
+)
 from latticeai.services.search_service import SearchService
 
 
@@ -44,8 +48,11 @@ def create_search_router(
         require_user(request)
         resolved = embedding_info() if embedding_info else {}
         try:
-            return service.embeddings_status(resolved=resolved, refresh=refresh)
+            payload = dict(service.embeddings_status(resolved=resolved, refresh=refresh))
         except ValueError as exc:
             _raise_embedder_error(exc)
+        payload.setdefault("recommended_model", RECOMMENDED_EMBEDDING_MODEL)
+        payload.setdefault("recommended_profile", RECOMMENDED_EMBEDDING_PROFILE)
+        return payload
 
     return router

package/latticeai/api/worker_compute.py

@@ -85,6 +85,10 @@ from pydantic import BaseModel, Field
 
 from latticeai.api.agent_worker_seam import SEAM_RATE_BUCKET
 from latticeai.api.agent_worker_seam import _seam_open as seam_open
+from latticeai.core.embedding_providers.profiles import (
+    RECOMMENDED_EMBEDDING_MODEL,
+    RECOMMENDED_EMBEDDING_PROFILE,
+)
 from latticeai.core.messages import MESSAGES, http_error, resolve_language
 from latticeai.core.quiet import quiet
 from latticeai.services.voice_capture import (
@@ -633,6 +637,7 @@ def create_worker_compute_router(
             if callable(role_aware)
             else await asyncio.to_thread(provider.embed_batch, texts)
         )
+        grade = getattr(provider, "grade", "fallback")
         return {
             "vectors": vectors,
             "dim": provider.dim,
@@ -641,7 +646,10 @@ def create_worker_compute_router(
             "kind": kind,
             # Additive (v12.0.0): `fallback` means these vectors are feature
             # hashes, not meaning. A caller that stores them can say so.
-            "grade": getattr(provider, "grade", "fallback"),
+            "grade": grade,
+            "semantic": grade != "fallback",
+            "recommended_model": RECOMMENDED_EMBEDDING_MODEL,
+            "recommended_profile": RECOMMENDED_EMBEDDING_PROFILE,
         }
 
     @router.post("/worker/parse")

package/latticeai/core/embedding_providers/__init__.py

@@ -70,9 +70,11 @@ from lattice_brain.embeddings import LocalEmbeddingModel as LocalEmbeddingModel
 
 from .autodetect import AUTO_PROVIDER as AUTO_PROVIDER
 from .autodetect import AUTODETECT_ENV as AUTODETECT_ENV
+from .autodetect import LOCAL_HF_MODELS as LOCAL_HF_MODELS
 from .autodetect import LOCAL_MLX_MODELS as LOCAL_MLX_MODELS
 from .autodetect import Detection as Detection
 from .autodetect import detect_embedder as detect_embedder
+from .autodetect import detect_local_hf as detect_local_hf
 from .autodetect import detect_local_mlx as detect_local_mlx
 from .autodetect import detect_ollama as detect_ollama
 from .autodetect import resolve_auto_provider as resolve_auto_provider
@@ -92,11 +94,16 @@ from .captions import VisionCaptioner as VisionCaptioner
 from .captions import resolve_vision_captioner as resolve_vision_captioner
 from .captions import vision_caption_port as vision_caption_port
 from .profiles import PRODUCTION_PROVIDER_PROFILES as PRODUCTION_PROVIDER_PROFILES
+from .profiles import RECOMMENDED_EMBEDDING_MODEL as RECOMMENDED_EMBEDDING_MODEL
+from .profiles import RECOMMENDED_EMBEDDING_PROFILE as RECOMMENDED_EMBEDDING_PROFILE
 from .profiles import embedding_provider_profiles as embedding_provider_profiles
 from .profiles import resolve_embedding_profile as resolve_embedding_profile
+from .text import DEFAULT_HF_EMBEDDING_MODEL as DEFAULT_HF_EMBEDDING_MODEL
+from .text import EMBEDDINGGEMMA_PREFIXES as EMBEDDINGGEMMA_PREFIXES
 from .text import PROVIDER_TYPES as PROVIDER_TYPES
 from .text import CustomEmbeddingProvider as CustomEmbeddingProvider
 from .text import HashEmbeddingProvider as HashEmbeddingProvider
+from .text import HuggingFaceEmbeddingProvider as HuggingFaceEmbeddingProvider
 from .text import MLXEmbeddingProvider as MLXEmbeddingProvider
 from .text import OllamaEmbeddingProvider as OllamaEmbeddingProvider
 from .text import OpenAICompatibleEmbeddingProvider as OpenAICompatibleEmbeddingProvider
@@ -123,9 +130,15 @@ from .vision import resolve_vision_embedder as resolve_vision_embedder
 __all__ = [
     "AUTODETECT_ENV",
     "AUTO_PROVIDER",
+    "DEFAULT_HF_EMBEDDING_MODEL",
+    "EMBEDDINGGEMMA_PREFIXES",
+    "LOCAL_HF_MODELS",
     "LOCAL_MLX_MODELS",
+    "RECOMMENDED_EMBEDDING_MODEL",
+    "RECOMMENDED_EMBEDDING_PROFILE",
     "Detection",
     "detect_embedder",
+    "detect_local_hf",
     "detect_local_mlx",
     "detect_ollama",
     "resolve_auto_provider",
@@ -151,6 +164,7 @@ __all__ = [
     "resolve_vision_embedder",
     "vision_caption_port",
     "HashEmbeddingProvider",
+    "HuggingFaceEmbeddingProvider",
     "MLXEmbeddingProvider",
     "OllamaEmbeddingProvider",
     "OpenAICompatibleEmbeddingProvider",