ltcai 11.5.2 → 11.6.0

package/latticeai/setup/demo_corpus.py

@@ -1,98 +0,0 @@
-"""Built-in First Value Loop demo corpus (backlog #3, review §3.3 P0).
-
-Three small Korean-friendly documents shipped in-repo so a brand-new user can
-one-click seed the Brain and immediately experience a successful recall with
-source highlighting — no folder connection, no model download, fully offline.
-
-Contract:
-
-* Documents are ingested through the normal :class:`IngestionPipeline`
-  (``source_type="note"``) with ``source_uri = demo://<id>`` and metadata
-  ``{"demo_corpus": true}`` so they are identifiable and removable later.
-* Ingestion is idempotent — the graph layer dedupes by content hash, so
-  re-POSTing never duplicates documents.
-* :data:`SUGGESTED_QUESTIONS` are pre-filled questions whose answers exist in
-  the corpus (the UI renders them as "ask this" chips).
-"""
-
-from __future__ import annotations
-
-from typing import Any, Dict, List
-
-DEMO_URI_PREFIX = "demo://"
-DEMO_METADATA_FLAG = "demo_corpus"
-
-DEMO_DOCUMENTS: List[Dict[str, str]] = [
-    {
-        "id": "meeting-note",
-        "title": "주간 회의록 — 사이드 프로젝트 킥오프",
-        "text": (
-            "2026-07-20 주간 회의록.\n"
-            "참석: 나, 김민준(백엔드), 박서연(디자인).\n"
-            "핵심 결정: 사이드 프로젝트 '새싹 가든'의 첫 공개 버전을 8월 15일에 "
-            "출시하기로 결정했다. 범위는 식물 기록과 물주기 알림 두 가지로 줄인다.\n"
-            "김민준이 알림 백엔드를 맡고, 박서연이 온보딩 화면을 맡는다.\n"
-            "다음 회의 전까지 각자 프로토타입을 준비하기로 했다."
-        ),
-    },
-    {
-        "id": "project-doc",
-        "title": "프로젝트 개요 — 새싹 가든",
-        "text": (
-            "새싹 가든은 집에서 키우는 식물을 기록하는 작은 앱이다.\n"
-            "기술 스택: 프론트엔드는 React, 백엔드는 FastAPI, 데이터는 SQLite에 "
-            "로컬로 저장한다. 사진은 기기 밖으로 나가지 않는다.\n"
-            "첫 버전 목표: 식물 등록, 물주기 알림, 한 줄 관찰 일기.\n"
-            "수익화는 생각하지 않고, 주말에 만드는 것을 원칙으로 한다."
-        ),
-    },
-    {
-        "id": "personal-note",
-        "title": "개인 노트 — 독서 메모: 아주 작은 습관의 힘",
-        "text": (
-            "『아주 작은 습관의 힘』을 읽고 남긴 메모.\n"
-            "가장 기억에 남는 문장: 습관은 목표가 아니라 시스템으로 만들어진다.\n"
-            "적용해 볼 것: 매일 아침 10분 스트레칭을 양치 직후에 붙여서 시작한다.\n"
-            "핵심은 2분 규칙 — 새 습관은 2분 안에 끝나는 크기로 시작하는 것이다."
-        ),
-    },
-]
-
-# Pre-filled questions whose answers exist in the corpus above. ``source_uri``
-# lets the UI verify the recall cited the right demo document.
-SUGGESTED_QUESTIONS: List[Dict[str, str]] = [
-    {
-        "question": "회의에서 결정한 출시일이 언제야?",
-        "expected_source_uri": DEMO_URI_PREFIX + "meeting-note",
-        "expected_title": "주간 회의록 — 사이드 프로젝트 킥오프",
-    },
-    {
-        "question": "새싹 가든의 기술 스택이 뭐야?",
-        "expected_source_uri": DEMO_URI_PREFIX + "project-doc",
-        "expected_title": "프로젝트 개요 — 새싹 가든",
-    },
-    {
-        "question": "새 습관을 시작할 때 쓰는 2분 규칙이 뭐였지?",
-        "expected_source_uri": DEMO_URI_PREFIX + "personal-note",
-        "expected_title": "개인 노트 — 독서 메모: 아주 작은 습관의 힘",
-    },
-]
-
-
-def demo_source_uri(doc_id: str) -> str:
-    return DEMO_URI_PREFIX + str(doc_id)
-
-
-def suggested_questions() -> List[Dict[str, Any]]:
-    """Copy of the suggestion chips (callers may annotate freely)."""
-    return [dict(item) for item in SUGGESTED_QUESTIONS]
-
-
-__all__ = [
-    "DEMO_DOCUMENTS",
-    "DEMO_METADATA_FLAG",
-    "DEMO_URI_PREFIX",
-    "SUGGESTED_QUESTIONS",
-    "demo_source_uri",
-    "suggested_questions",
-]

package/latticeai/setup/wizard/__init__.py

@@ -1,126 +0,0 @@
-"""
-Smart Setup Wizard — Environment Scanner, Recommender & Auto-Installer
-Detects hardware, tools, and API keys; returns tailored recommendations;
-streams SSE installation progress.
-
-Formerly the root ``setup.py``; renamed in v4 so it no longer collides with
-the setuptools build entrypoint and actually ships in the wheel
-(``pyproject.toml`` py-modules). Packaging is owned entirely by
-``pyproject.toml`` — there is deliberately no root ``setup.py``.
-
-Split into cohesive submodules in v11.3.0 (no behaviour change): ``paths``
-(PATH repair + binary lookup + the module-level ``COMMON_PATH_DIRS``),
-``detect`` (hardware/OS/tool probes and ``scan_environment``), ``plans``
-(SSE framing + confirmation-token command plans), ``catalog`` (model tables),
-``recommend`` (``get_recommendations``) and ``install`` (verify/repair and the
-SSE ``install_stream``). This module re-exports every name the single file
-exposed, so ``latticeai.setup.wizard.X`` keeps working.
-
-Stubbing note: rebinding one of these names *here* changes only this module's
-name. The submodule that calls it holds its own reference, so a test standing
-in for a helper patches the submodule that uses it.
-"""
-
-from __future__ import annotations
-
-# The single file had no ``__all__``, so its public surface was "every module
-# global" — including the names it imported for its own use. Every re-export
-# below therefore uses the redundant-alias form: it reproduces exactly that
-# surface, and it marks each name as deliberate rather than a leftover import.
-from latticeai.core.quiet import quiet as quiet
-from latticeai.services.process_audit import (
-    CommandConfirmationError as CommandConfirmationError,
-)
-from latticeai.services.process_audit import (
-    append_process_audit_event as append_process_audit_event,
-)
-from latticeai.services.process_audit import command_plan as command_plan
-from latticeai.services.process_audit import (
-    command_plan_for_commands as command_plan_for_commands,
-)
-from latticeai.services.process_audit import (
-    require_command_confirmation as require_command_confirmation,
-)
-from latticeai.services.setup_detection import detect_cuda as detect_cuda
-from latticeai.services.setup_detection import detect_tools as detect_tools
-from latticeai.services.setup_detection import (
-    detect_wsl_from_text as detect_wsl_from_text,
-)
-from latticeai.setup.wizard.catalog import (
-    _BEST_MODEL_TIERS as _BEST_MODEL_TIERS,
-)
-from latticeai.setup.wizard.catalog import (
-    _CROSS_PLATFORM_MODEL_CATALOG as _CROSS_PLATFORM_MODEL_CATALOG,
-)
-from latticeai.setup.wizard.catalog import (
-    _MODEL_CATALOG as _MODEL_CATALOG,
-)
-from latticeai.setup.wizard.catalog import (
-    _VERSIONED_MODEL_PATTERNS as _VERSIONED_MODEL_PATTERNS,
-)
-from latticeai.setup.wizard.catalog import (
-    _best_model_for_engine as _best_model_for_engine,
-)
-from latticeai.setup.wizard.catalog import (
-    _catalog_row_family_version as _catalog_row_family_version,
-)
-from latticeai.setup.wizard.catalog import (
-    _filter_lower_family_versions as _filter_lower_family_versions,
-)
-from latticeai.setup.wizard.catalog import (
-    _version_tuple as _version_tuple,
-)
-from latticeai.setup.wizard.detect import _cmd as _cmd
-from latticeai.setup.wizard.detect import _detect_api_keys as _detect_api_keys
-from latticeai.setup.wizard.detect import _detect_chip as _detect_chip
-from latticeai.setup.wizard.detect import _detect_cpu as _detect_cpu
-from latticeai.setup.wizard.detect import _detect_cuda as _detect_cuda
-from latticeai.setup.wizard.detect import (
-    _detect_disk_free_gb as _detect_disk_free_gb,
-)
-from latticeai.setup.wizard.detect import _detect_gpu as _detect_gpu
-from latticeai.setup.wizard.detect import _detect_mlx as _detect_mlx
-from latticeai.setup.wizard.detect import _detect_ram_gb as _detect_ram_gb
-from latticeai.setup.wizard.detect import _detect_tools as _detect_tools
-from latticeai.setup.wizard.detect import _detect_wsl as _detect_wsl
-from latticeai.setup.wizard.detect import (
-    _parse_windows_video_controllers as _parse_windows_video_controllers,
-)
-from latticeai.setup.wizard.detect import scan_environment as scan_environment
-from latticeai.setup.wizard.install import _brew_install as _brew_install
-from latticeai.setup.wizard.install import _pip_install as _pip_install
-from latticeai.setup.wizard.install import _repair_action as _repair_action
-from latticeai.setup.wizard.install import _verify_action as _verify_action
-from latticeai.setup.wizard.install import _verify_binary as _verify_binary
-from latticeai.setup.wizard.install import _wait_for_binary as _wait_for_binary
-from latticeai.setup.wizard.install import install_stream as install_stream
-from latticeai.setup.wizard.install import open_url as open_url
-from latticeai.setup.wizard.paths import COMMON_PATH_DIRS as COMMON_PATH_DIRS
-from latticeai.setup.wizard.paths import OFFICIAL_DOWNLOADS as OFFICIAL_DOWNLOADS
-from latticeai.setup.wizard.paths import PACKAGE_MODULES as PACKAGE_MODULES
-from latticeai.setup.wizard.paths import (
-    WINDOWS_BINARY_CANDIDATES as WINDOWS_BINARY_CANDIDATES,
-)
-from latticeai.setup.wizard.paths import _component_detail as _component_detail
-from latticeai.setup.wizard.paths import _merge_path_dirs as _merge_path_dirs
-from latticeai.setup.wizard.paths import _module_available as _module_available
-from latticeai.setup.wizard.paths import _package_module as _package_module
-from latticeai.setup.wizard.paths import _persist_extra_path as _persist_extra_path
-from latticeai.setup.wizard.paths import _project_env_file as _project_env_file
-from latticeai.setup.wizard.paths import _update_env_file as _update_env_file
-from latticeai.setup.wizard.paths import _which_any as _which_any
-from latticeai.setup.wizard.paths import _which_detail as _which_detail
-from latticeai.setup.wizard.paths import repair_path_for as repair_path_for
-from latticeai.setup.wizard.plans import _action_command_plan as _action_command_plan
-from latticeai.setup.wizard.plans import _action_commands as _action_commands
-from latticeai.setup.wizard.plans import _attach_action_plan as _attach_action_plan
-from latticeai.setup.wizard.plans import (
-    _hydrate_install_actions as _hydrate_install_actions,
-)
-from latticeai.setup.wizard.plans import _sse as _sse
-from latticeai.setup.wizard.plans import (
-    _verify_action_confirmation as _verify_action_confirmation,
-)
-from latticeai.setup.wizard.recommend import (
-    get_recommendations as get_recommendations,
-)

package/latticeai/setup/wizard/catalog.py

@@ -1,175 +0,0 @@
-"""The wizard's model catalogue and the per-engine "best model" tiers.
-
-Data plus the two pure decisions that read it: hide superseded model
-*generations* (:func:`_filter_lower_family_versions`) and pick the best model a
-machine with this much RAM can actually hold (:func:`_best_model_for_engine`).
-"""
-
-from __future__ import annotations
-
-import re
-from typing import Dict, List, Tuple
-
-from latticeai.services.model_catalog import _version_tuple as _catalog_version_tuple
-
-# ── Model Catalog ─────────────────────────────────────────────────────────────
-# (model_id, display_name, size_gb, tag, description, min_ram_gb)
-# 11.2.0: 모든 repo id 를 2026-08-10 Hugging Face API 로 확인했다 — 존재 여부,
-# gated 여부, 정확한 대소문자, siblings 합계 크기. 크기 값은 측정값이다.
-# 삭제: Qwen3-VL 전 라인업(2025-10, Qwen3.5/3.6 이 상위 세대), Llama 4 Scout
-# (vLLM/LM Studio 경로가 gated 인 meta-llama 저장소를 가리켰다).
-_MODEL_CATALOG = [
-    ("mlx-community/LFM2.5-2.6B-4bit",               "LFM2.5 2.6B",          1.5,  "LLM",     "가장 가벼움 · 한국어 대화 (사진은 못 읽음)", 4),
-    ("mlx-community/gemma-4-e2b-it-4bit",            "Gemma 4 E2B",          3.6,  "VLM",     "사진을 읽는 가장 작은 모델",        8),
-    ("mlx-community/gemma-4-e4b-it-4bit",            "Gemma 4 E4B",          5.2,  "VLM",     "E2B 보다 한 단계 위 · 여전히 가벼움", 10),
-    ("mlx-community/Qwen3.5-9B-MLX-4bit",            "Qwen3.5 9B",           6.0,  "VLM",     "중형 멀티모달 · 균형 추천",         12),
-    ("mlx-community/gemma-4-12B-it-4bit",            "Gemma 4 12B",          6.8,  "VLM",     "Gemma 4 기본 추천 · 4bit",          16),
-    ("mlx-community/gpt-oss-20b-MXFP4-Q8",           "GPT-OSS 20B",         12.1,  "LLM",     "범용 · 다운로드 최다 (사진은 못 읽음)", 24),
-    ("mlx-community/gemma-4-26b-a4b-it-4bit",        "Gemma 4 26B A4B",     15.4,  "VLM",     "MoE · 대형 추천",                   32),
-    ("mlx-community/Qwen3.6-27B-4bit",               "Qwen3.6 27B",         16.1,  "VLM+",    "dense 최상위 · 느리지만 일정함",     48),
-    ("mlx-community/gemma-4-31b-it-4bit",            "Gemma 4 31B",         18.4,  "VLM+",    "Gemma 4 최대 모델",                 48),
-    ("mlx-community/Qwen3.6-35B-A3B-4bit",           "Qwen3.6 35B A3B",     20.4,  "VLM+",    "MoE 최상위",                        48),
-]
-
-_CROSS_PLATFORM_MODEL_CATALOG: Dict[str, List[Tuple[str, str, float, str, str, int]]] = {
-    "ollama": [
-        ("ollama:hf.co/LiquidAI/LFM2.5-2.6B-GGUF:Q4_K_M", "LFM2.5 2.6B Q4", 1.7, "LLM", "가장 가벼움 · 한국어 대화", 4),
-        ("ollama:hf.co/ggml-org/gemma-4-E2B-it-GGUF:Q4_K_M", "Gemma 4 E2B Q4", 3.8, "VLM", "Hugging Face GGUF 기반 Gemma 4", 8),
-        ("ollama:hf.co/ggml-org/gemma-4-E4B-it-GGUF:Q4_K_M", "Gemma 4 E4B Q4", 5.4, "VLM", "Hugging Face GGUF 기반 Gemma 4", 10),
-        ("ollama:hf.co/ggml-org/gemma-4-12B-it-GGUF:Q4_K_M", "Gemma 4 12B Q4", 7.9, "VLM", "Hugging Face GGUF 기반 Gemma 4", 16),
-        ("ollama:hf.co/ggml-org/gpt-oss-20b-GGUF:Q4_K_M", "GPT-OSS 20B Q4", 12.5, "LLM", "범용 · 다운로드 최다", 24),
-        ("ollama:hf.co/ggml-org/gemma-4-26B-A4B-it-GGUF:Q4_K_M", "Gemma 4 26B Q4", 16.0, "VLM", "MoE · 대형 추천", 32),
-        ("ollama:hf.co/ggml-org/Qwen3.6-27B-GGUF:Q4_K_M", "Qwen3.6 27B Q4", 16.6, "VLM+", "dense 최상위", 48),
-        ("ollama:hf.co/ggml-org/gemma-4-31B-it-GGUF:Q4_K_M", "Gemma 4 31B Q4", 18.7, "VLM+", "Gemma 4 최대 모델", 48),
-    ],
-    "lmstudio": [
-        ("lmstudio:LiquidAI/LFM2.5-2.6B-GGUF", "LFM2.5 2.6B", 1.7, "LLM", "가장 가벼움 · 한국어 대화", 4),
-        ("lmstudio:ggml-org/gemma-4-E2B-it-GGUF", "Gemma 4 E2B", 3.8, "VLM", "LM Studio GGUF Gemma 4", 8),
-        ("lmstudio:ggml-org/gemma-4-E4B-it-GGUF", "Gemma 4 E4B", 5.4, "VLM", "LM Studio GGUF Gemma 4", 10),
-        ("lmstudio:ggml-org/gemma-4-12B-it-GGUF", "Gemma 4 12B", 7.9, "VLM", "LM Studio GGUF Gemma 4", 16),
-        ("lmstudio:ggml-org/gpt-oss-20b-GGUF", "GPT-OSS 20B", 12.5, "LLM", "범용 · 다운로드 최다", 24),
-        ("lmstudio:ggml-org/gemma-4-26B-A4B-it-GGUF", "Gemma 4 26B", 16.0, "VLM", "MoE · 대형 추천", 32),
-        ("lmstudio:ggml-org/Qwen3.6-27B-GGUF", "Qwen3.6 27B", 16.6, "VLM+", "dense 최상위", 48),
-        ("lmstudio:ggml-org/gemma-4-31B-it-GGUF", "Gemma 4 31B", 18.7, "VLM+", "Gemma 4 최대 모델", 48),
-    ],
-    "vllm": [
-        ("vllm:LiquidAI/LFM2.5-2.6B", "LFM2.5 2.6B", 5.2, "LLM", "가장 가벼움 · 한국어 대화", 8),
-        ("vllm:google/gemma-4-E2B-it", "Gemma 4 E2B", 6.0, "VLM", "내 컴퓨터 GPU 실행 도구 권장", 12),
-        ("vllm:google/gemma-4-E4B-it", "Gemma 4 E4B", 9.0, "VLM", "내 컴퓨터 GPU 실행 도구 권장", 16),
-        ("vllm:Qwen/Qwen3.5-9B", "Qwen3.5 9B", 18.0, "VLM", "중형 멀티모달 · 균형 추천", 24),
-        ("vllm:google/gemma-4-12B-it", "Gemma 4 12B", 24.0, "VLM", "Gemma 4 기본 추천", 32),
-        ("vllm:openai/gpt-oss-20b", "GPT-OSS 20B", 13.5, "LLM", "범용 · 다운로드 최다", 24),
-        ("vllm:Qwen/Qwen3.6-27B", "Qwen3.6 27B", 54.0, "VLM+", "dense 최상위 · 24GB+ VRAM 권장", 64),
-        ("vllm:Qwen/Qwen3.6-35B-A3B", "Qwen3.6 35B A3B", 70.0, "VLM+", "MoE 최상위 · 24GB+ VRAM 권장", 80),
-    ],
-    "llamacpp": [
-        ("llamacpp:LiquidAI/LFM2.5-2.6B-GGUF", "LFM2.5 2.6B GGUF", 1.7, "GGUF", "CPU/Vulkan 백업 · 가장 가벼움", 4),
-        ("llamacpp:ggml-org/gemma-4-E2B-it-GGUF", "Gemma 4 E2B GGUF", 3.8, "GGUF", "Gemma 4 E2B Q4_K_M", 8),
-        ("llamacpp:ggml-org/gemma-4-E4B-it-GGUF", "Gemma 4 E4B GGUF", 5.4, "GGUF", "Gemma 4 E4B Q4_K_M", 10),
-        ("llamacpp:ggml-org/gemma-4-12B-it-GGUF", "Gemma 4 12B GGUF", 7.9, "GGUF", "Gemma 4 12B Q4_K_M", 16),
-        ("llamacpp:ggml-org/gpt-oss-20b-GGUF", "GPT-OSS 20B GGUF", 12.5, "GGUF", "범용 · 다운로드 최다", 24),
-        ("llamacpp:ggml-org/gemma-4-26B-A4B-it-GGUF", "Gemma 4 26B GGUF", 16.0, "GGUF", "MoE · 대형 추천", 32),
-        ("llamacpp:ggml-org/Qwen3.6-27B-GGUF", "Qwen3.6 27B GGUF", 16.6, "GGUF", "dense 최상위", 48),
-        ("llamacpp:ggml-org/gemma-4-31B-it-GGUF", "Gemma 4 31B GGUF", 18.7, "GGUF", "Gemma 4 31B Q4_K_M", 48),
-    ],
-}
-
-_VERSIONED_MODEL_PATTERNS = (
-    ("gemma", re.compile(r"\bgemma[-\s]?(\d+(?:\.\d+)?)", re.IGNORECASE)),
-    ("qwen", re.compile(r"\bqwen[-\s]?(\d+(?:\.\d+)?)", re.IGNORECASE)),
-    ("llama", re.compile(r"\bllama[-\s]?(\d+(?:\.\d+)?)", re.IGNORECASE)),
-)
-
-# RAM(GB) 내림차순 티어. 첫 번째로 조건을 만족하는 항목이 "이 컴퓨터에서 가장
-# 좋은 모델"이 된다. 초경량(≤8) / 경량(16) / 중형(24) / MoE(32) / 대형(48).
-_BEST_MODEL_TIERS: Dict[str, List[Tuple[int, str]]] = {
-    "local_mlx": [
-        (48, "mlx-community/gemma-4-31b-it-4bit"),
-        (32, "mlx-community/gemma-4-26b-a4b-it-4bit"),
-        (24, "mlx-community/gemma-4-12B-it-4bit"),
-        (16, "mlx-community/Qwen3.5-9B-MLX-4bit"),
-        (8, "mlx-community/gemma-4-e2b-it-4bit"),
-        (4, "mlx-community/LFM2.5-2.6B-4bit"),
-    ],
-    "ollama": [
-        (48, "ollama:hf.co/ggml-org/gemma-4-31B-it-GGUF:Q4_K_M"),
-        (32, "ollama:hf.co/ggml-org/gemma-4-26B-A4B-it-GGUF:Q4_K_M"),
-        (24, "ollama:hf.co/ggml-org/gemma-4-12B-it-GGUF:Q4_K_M"),
-        (16, "ollama:hf.co/ggml-org/gemma-4-E4B-it-GGUF:Q4_K_M"),
-        (8, "ollama:hf.co/ggml-org/gemma-4-E2B-it-GGUF:Q4_K_M"),
-        (4, "ollama:hf.co/LiquidAI/LFM2.5-2.6B-GGUF:Q4_K_M"),
-    ],
-    "lmstudio": [
-        (48, "lmstudio:ggml-org/gemma-4-31B-it-GGUF"),
-        (32, "lmstudio:ggml-org/gemma-4-26B-A4B-it-GGUF"),
-        (24, "lmstudio:ggml-org/gemma-4-12B-it-GGUF"),
-        (16, "lmstudio:ggml-org/gemma-4-E4B-it-GGUF"),
-        (8, "lmstudio:ggml-org/gemma-4-E2B-it-GGUF"),
-        (4, "lmstudio:LiquidAI/LFM2.5-2.6B-GGUF"),
-    ],
-    # vLLM serves the upstream bf16 repos, which are 3-4x the MLX 4-bit builds
-    # (Qwen3.6-27B is 54GB, not 16GB), so its thresholds sit far higher than the
-    # local_mlx ones. Picking by RAM alone would nominate a model no consumer
-    # GPU can hold.
-    "vllm": [
-        (96, "vllm:Qwen/Qwen3.6-27B"),
-        (32, "vllm:google/gemma-4-12B-it"),
-        (24, "vllm:Qwen/Qwen3.5-9B"),
-        (16, "vllm:google/gemma-4-E4B-it"),
-        (8, "vllm:LiquidAI/LFM2.5-2.6B"),
-    ],
-    "llamacpp": [
-        (48, "llamacpp:ggml-org/gemma-4-31B-it-GGUF"),
-        (32, "llamacpp:ggml-org/gemma-4-26B-A4B-it-GGUF"),
-        (24, "llamacpp:ggml-org/gemma-4-12B-it-GGUF"),
-        (16, "llamacpp:ggml-org/gemma-4-E4B-it-GGUF"),
-        (8, "llamacpp:ggml-org/gemma-4-E2B-it-GGUF"),
-        (4, "llamacpp:LiquidAI/LFM2.5-2.6B-GGUF"),
-    ],
-}
-
-
-
-#: The engine catalog owns this parse; the wizard compares the same strings.
-_version_tuple = _catalog_version_tuple
-
-
-def _catalog_row_family_version(row: Tuple[str, str, float, str, str, int]) -> Tuple[str, Tuple[int, ...]] | None:
-    text = f"{row[0]} {row[1]}"
-    for family, pattern in _VERSIONED_MODEL_PATTERNS:
-        match = pattern.search(text)
-        if match:
-            # Major version only — see model_catalog._model_family_version. The
-            # filter hides superseded *generations*; Qwen3.5 and Qwen3.6 are one
-            # generation filling two different RAM tiers and must coexist.
-            version = _version_tuple(match.group(1))[:1]
-            if version:
-                return family, version
-    return None
-
-
-def _filter_lower_family_versions(
-    rows: List[Tuple[str, str, float, str, str, int]],
-) -> List[Tuple[str, str, float, str, str, int]]:
-    max_versions: Dict[str, Tuple[int, ...]] = {}
-    detected: List[Tuple[Tuple[str, str, float, str, str, int], Tuple[str, Tuple[int, ...]] | None]] = []
-    for row in rows:
-        version_info = _catalog_row_family_version(row)
-        detected.append((row, version_info))
-        if not version_info:
-            continue
-        family, version = version_info
-        if version > max_versions.get(family, (0,)):
-            max_versions[family] = version
-    return [
-        row for row, version_info in detected
-        if not version_info or version_info[1] >= max_versions.get(version_info[0], version_info[1])
-    ]
-
-
-def _best_model_for_engine(engine: str, ram_gb: float, rows: List[Tuple[str, str, float, str, str, int]]) -> str:
-    available_ids = {row[0] for row in rows}
-    for min_ram, model_id in _BEST_MODEL_TIERS.get(engine, []):
-        if ram_gb >= min_ram and model_id in available_ids:
-            return model_id
-    return rows[0][0] if rows else ""