codna 0.1.0__tar.gz → 0.1.2__tar.gz

{codna-0.1.0 → codna-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codna
-Version: 0.1.0
+Version: 0.1.2
 Summary: Local-first repo intelligence and agent fixing for Codna.
 Author: Thyn
 Maintainer: Thyn
@@ -35,7 +35,6 @@ Requires-Dist: pyarrow>=15.0.0
 Provides-Extra: mcp
 Provides-Extra: memory
 Requires-Dist: telys>=0.1.0b1; extra == "memory"
-Requires-Dist: telys-runtime>=0.1.0a1; extra == "memory"
 Requires-Dist: numpy>=1.24; extra == "memory"
 Requires-Dist: faiss-cpu>=1.7; extra == "memory"
 Requires-Dist: wordllama>=0.3; extra == "memory"
@@ -50,12 +49,6 @@ Requires-Dist: tree-sitter-cpp; extra == "memory"
 Requires-Dist: tree-sitter-c-sharp; extra == "memory"
 Requires-Dist: tree-sitter-php; extra == "memory"
 Requires-Dist: tree-sitter-ruby; extra == "memory"
-Provides-Extra: memory-algenta
-Requires-Dist: telys>=0.1.0b1; extra == "memory-algenta"
-Requires-Dist: telys-runtime>=0.1.0a1; extra == "memory-algenta"
-Requires-Dist: numpy>=1.24; extra == "memory-algenta"
-Requires-Dist: faiss-cpu>=1.7; extra == "memory-algenta"
-Requires-Dist: telys-algenta[algenta]>=0.1.0a1; extra == "memory-algenta"
 Provides-Extra: memory-rerank
 Requires-Dist: wordllama>=0.3; extra == "memory-rerank"
 Provides-Extra: memory-languages
@@ -131,9 +124,17 @@ Optional local code-memory support is available through:
 pip install "codna[memory]"
 ```
 
-The memory extra uses Telys for on-device retrieval. Release builds can include
-signed native Telys runtime artifacts for supported platforms. Source
-distributions intentionally exclude bundled native runtime artifacts.
+The memory extra uses the public Telys SDK for on-device retrieval. It installs
+public Python dependencies only; the signed native runtime is installed
+separately:
+
+```bash
+telys runtime install --file <bundle> --license <license.jwt>
+```
+
+Codna also supports release builds that include signed native Telys runtime
+artifacts for supported platforms. Source distributions intentionally exclude
+bundled native runtime artifacts.
 
 ## Security And Local Files
 

{codna-0.1.0 → codna-0.1.2}/README.md

@@ -58,9 +58,17 @@ Optional local code-memory support is available through:
 pip install "codna[memory]"
 ```
 
-The memory extra uses Telys for on-device retrieval. Release builds can include
-signed native Telys runtime artifacts for supported platforms. Source
-distributions intentionally exclude bundled native runtime artifacts.
+The memory extra uses the public Telys SDK for on-device retrieval. It installs
+public Python dependencies only; the signed native runtime is installed
+separately:
+
+```bash
+telys runtime install --file <bundle> --license <license.jwt>
+```
+
+Codna also supports release builds that include signed native Telys runtime
+artifacts for supported platforms. Source distributions intentionally exclude
+bundled native runtime artifacts.
 
 ## Security And Local Files
 

{codna-0.1.0 → codna-0.1.2}/codna/__init__.py

@@ -5,4 +5,4 @@ This package is the `codna` CLI. Users never touch "algenta" directly — the en
 is an internal dependency reached over HTTP.
 """
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"

{codna-0.1.0 → codna-0.1.2}/codna/memory.py

@@ -1,12 +1,13 @@
 """Codna's local, in-process code memory — a thin consumer seam over Telys.
 
-Telys is an OPTIONAL dependency: the public SDK distribution is ``telys`` and the on-device runtime
-distribution is ``telys-runtime`` (import package ``memengine``). Install it with
-``pip install 'codna[memory]'``. Codna resolves the native kernel from explicit ``$TELYS_KERNEL`` /
+Telys is an OPTIONAL dependency: ``pip install 'codna[memory]'`` installs the public ``telys`` SDK and
+local recall dependencies only. The signed on-device runtime is installed separately with
+``telys runtime install`` or bundled by a Codna release artifact; Codna does not depend on a private
+runtime wheel in public PyPI metadata. Codna resolves the native kernel from explicit ``$TELYS_KERNEL`` /
 ``$AME_KERNEL``, a packaged ``codna/_telys_runtime`` artifact, ``$CODNA_TELYS_INSTALL_ROOT``,
-``build/local-telys`` in a source checkout, or a verified ``telys runtime install``. Core codna never
-imports it — every telys import here is lazy, so ``from codna.memory import CodeMemory`` works without
-the extra and only fails (with a friendly message) when you actually use it.
+``build/local-telys`` in a source checkout, or a verified Telys runtime install. Core codna never imports
+it — every telys import here is lazy, so ``from codna.memory import CodeMemory`` works without the extra
+and only fails (with a friendly message) when you actually use it.
 
 OEM license handling is explicit and secret-safe: Codna reads ``CODNA_TELYS_LICENSE_JWT`` or
 ``CODNA_TELYS_LICENSE_PATH`` when configured, verifies it offline through Telys, and stores only metadata.
@@ -252,19 +253,31 @@ def _kernel_hint() -> str:
     )
 
 
+def _runtime_install_hint() -> str:
+    return (
+        "the Telys runtime is not installed. Install the public SDK with `pip install 'codna[memory]'`, "
+        "then run `telys runtime install --file <bundle> --license <license.jwt>`, use a Codna-packaged "
+        "runtime artifact, or set TELYS_KERNEL/CODNA_TELYS_INSTALL_ROOT to an installed local runtime."
+    )
+
+
 def _require_telys():
     """Lazily import the Telys surface. Raises CodeMemoryError with an install hint if absent."""
     try:
         from telys import Telys, scope_key
-        _configure_telys_kernel_env()
+    except ImportError as exc:
+        raise CodeMemoryError(
+            "code memory needs the optional Telys SDK — install it with `pip install 'codna[memory]'`; "
+            "if the SDK is already installed, install/activate the signed runtime with `telys runtime install`"
+        ) from exc
+    _configure_telys_kernel_env()
+    try:
         # Multigram fusion ([unigram|bigram|trigram], per-block L2): MC-validated to beat the plain bigram
         # by ~+12-17 pts recall@10 on NL->code and to tie a 16 MB on-device semantic model on recall, at
         # zero model cost. The local lexical default (no engine key) uses it.
         from telys.embedding import AlgentaMultigramEmbedder as _LocalEmbedder
     except ImportError as exc:
-        raise CodeMemoryError(
-            "code memory needs the optional Telys engine — install it with:  pip install 'codna[memory]'"
-        ) from exc
+        raise CodeMemoryError(_kernel_hint()) from exc
     return Telys, scope_key, _LocalEmbedder
 
 
@@ -430,7 +443,7 @@ def _embedder():
     _, _, LocalEmbedder = _require_telys()
     try:
         return LocalEmbedder()    # AlgentaMultigramEmbedder: unigram+bigram+trigram fusion, zero network
-    except OSError as exc:   # FileNotFoundError (kernel missing) / CDLL load failure
+    except (OSError, ImportError) as exc:   # FileNotFoundError / CDLL load / missing runtime kernel module
         raise CodeMemoryError(_kernel_hint()) from exc
 
 
@@ -608,7 +621,15 @@ class CodeMemory:
         self.license = _load_telys_license_metadata()
         self.kernel = _current_kernel_resolution()
         self._embedder = _embedder()                       # constructs (and validates) the kernel up-front
-        self._eng = self._Telys(self.db_path, embedding_providers={self._embedder.profile.model_id: self._embedder})
+        try:
+            self._eng = self._Telys(
+                self.db_path,
+                embedding_providers={self._embedder.profile.model_id: self._embedder},
+            )
+        except Exception as exc:  # noqa: BLE001
+            if exc.__class__.__name__ == "RuntimeNotInstalled":
+                raise CodeMemoryError(_runtime_install_hint()) from exc
+            raise
         self._col = None
 
     # ── collection lifecycle ──────────────────────────────────────────────────────────────────────

{codna-0.1.0 → codna-0.1.2}/codna/packaged_agent_runner.py

@@ -255,7 +255,7 @@ def _is_clean_git_repo(repo_root: Path) -> bool:
     if inside.returncode != 0 or inside.stdout.strip() != "true":
         return False
     status = subprocess.run(
-        ["git", "-C", str(repo_root), "status", "--porcelain=v1", "-z", "--untracked-files=all"],
+        ["git", "-C", str(repo_root), "status", "--porcelain=v1", "-z", "--untracked-files=no"],
         capture_output=True,
         check=False,
         timeout=30,

{codna-0.1.0 → codna-0.1.2}/codna/packaged_repository_advanced.py

@@ -324,11 +324,12 @@ class PackagedRepositoryAdvanced:
 
     def _apply_local_branch(self, repo_root: Path, plan_id: str, patch_diff: str) -> str:
         _require_git_repo(repo_root)
-        if _git_dirty(repo_root):
+        blockers = _apply_blockers(repo_root, patch_diff)
+        if blockers:
             raise PackagedRepositoryAdvancedError(
                 "repository_apply_dirty_worktree",
-                "local_branch apply requires a clean git worktree.",
-                {"repo_root": str(repo_root)},
+                "local_branch apply requires no tracked changes and no untracked files that conflict with the patch.",
+                {"repo_root": str(repo_root), **blockers},
             )
         branch = "codna/" + plan_id.removeprefix("plan_")[:16]
         _run_git(repo_root, ["checkout", "-b", branch])
@@ -562,9 +563,35 @@ def _require_git_repo(repo_root: Path) -> None:
         )
 
 
-def _git_dirty(repo_root: Path) -> bool:
-    result = _run_git(repo_root, ["status", "--porcelain=v1", "-z", "--untracked-files=all"])
-    return bool(result.stdout)
+def _apply_blockers(repo_root: Path, patch_diff: str) -> dict[str, Any]:
+    tracked = _git_status(repo_root, include_untracked=False)
+    if tracked:
+        return {"tracked_status": tracked}
+    patch_targets = set(_changed_files_from_patch(patch_diff))
+    if not patch_targets:
+        return {"patch_targets": []}
+    conflicts = _conflicting_untracked_files(repo_root, patch_targets)
+    if conflicts:
+        return {"conflicting_untracked_files": conflicts}
+    return {}
+
+
+def _git_status(repo_root: Path, *, include_untracked: bool) -> list[str]:
+    untracked = "all" if include_untracked else "no"
+    result = _run_git(repo_root, ["status", "--porcelain=v1", "-z", f"--untracked-files={untracked}"])
+    return [entry for entry in result.stdout.split("\0") if entry]
+
+
+def _conflicting_untracked_files(repo_root: Path, patch_targets: set[str]) -> list[str]:
+    result = _run_git(repo_root, ["ls-files", "--others", "--exclude-standard", "-z"])
+    conflicts: list[str] = []
+    for raw in result.stdout.split("\0"):
+        path = raw.strip()
+        if not path:
+            continue
+        if path in patch_targets:
+            conflicts.append(path)
+    return conflicts
 
 
 def _run_git(repo_root: Path, args: list[str]) -> subprocess.CompletedProcess:

{codna-0.1.0 → codna-0.1.2}/codna.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codna
-Version: 0.1.0
+Version: 0.1.2
 Summary: Local-first repo intelligence and agent fixing for Codna.
 Author: Thyn
 Maintainer: Thyn
@@ -35,7 +35,6 @@ Requires-Dist: pyarrow>=15.0.0
 Provides-Extra: mcp
 Provides-Extra: memory
 Requires-Dist: telys>=0.1.0b1; extra == "memory"
-Requires-Dist: telys-runtime>=0.1.0a1; extra == "memory"
 Requires-Dist: numpy>=1.24; extra == "memory"
 Requires-Dist: faiss-cpu>=1.7; extra == "memory"
 Requires-Dist: wordllama>=0.3; extra == "memory"
@@ -50,12 +49,6 @@ Requires-Dist: tree-sitter-cpp; extra == "memory"
 Requires-Dist: tree-sitter-c-sharp; extra == "memory"
 Requires-Dist: tree-sitter-php; extra == "memory"
 Requires-Dist: tree-sitter-ruby; extra == "memory"
-Provides-Extra: memory-algenta
-Requires-Dist: telys>=0.1.0b1; extra == "memory-algenta"
-Requires-Dist: telys-runtime>=0.1.0a1; extra == "memory-algenta"
-Requires-Dist: numpy>=1.24; extra == "memory-algenta"
-Requires-Dist: faiss-cpu>=1.7; extra == "memory-algenta"
-Requires-Dist: telys-algenta[algenta]>=0.1.0a1; extra == "memory-algenta"
 Provides-Extra: memory-rerank
 Requires-Dist: wordllama>=0.3; extra == "memory-rerank"
 Provides-Extra: memory-languages
@@ -131,9 +124,17 @@ Optional local code-memory support is available through:
 pip install "codna[memory]"
 ```
 
-The memory extra uses Telys for on-device retrieval. Release builds can include
-signed native Telys runtime artifacts for supported platforms. Source
-distributions intentionally exclude bundled native runtime artifacts.
+The memory extra uses the public Telys SDK for on-device retrieval. It installs
+public Python dependencies only; the signed native runtime is installed
+separately:
+
+```bash
+telys runtime install --file <bundle> --license <license.jwt>
+```
+
+Codna also supports release builds that include signed native Telys runtime
+artifacts for supported platforms. Source distributions intentionally exclude
+bundled native runtime artifacts.
 
 ## Security And Local Files
 

{codna-0.1.0 → codna-0.1.2}/codna.egg-info/requires.txt

@@ -6,7 +6,6 @@ pyarrow>=15.0.0
 
 [memory]
 telys>=0.1.0b1
-telys-runtime>=0.1.0a1
 numpy>=1.24
 faiss-cpu>=1.7
 wordllama>=0.3
@@ -22,13 +21,6 @@ tree-sitter-c-sharp
 tree-sitter-php
 tree-sitter-ruby
 
-[memory-algenta]
-telys>=0.1.0b1
-telys-runtime>=0.1.0a1
-numpy>=1.24
-faiss-cpu>=1.7
-telys-algenta[algenta]>=0.1.0a1
-
 [memory-languages]
 tree-sitter>=0.23
 tree-sitter-javascript

{codna-0.1.0 → codna-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codna"
-version = "0.1.0"
+version = "0.1.2"
 description = "Local-first repo intelligence and agent fixing for Codna."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -42,11 +42,11 @@ dependencies = ["httpx>=0.28.0", "mcp>=1.2.0", "pyarrow>=15.0.0"]
 [project.optional-dependencies]
 mcp = []
 # Local, in-process code memory & recall via Telys. Public PyPI metadata must
-# use normal distribution requirements only; local editable source overrides
-# stay in [tool.uv.sources] for development.
+# use normal, resolvable distribution requirements only. The signed Telys
+# on-device runtime is installed separately by `telys runtime install`; the
+# closed `telys-runtime` wheel is not a public dependency.
 memory = [
   "telys>=0.1.0b1",
-  "telys-runtime>=0.1.0a1",
   "numpy>=1.24",
   "faiss-cpu>=1.7",
   "wordllama>=0.3",   # on-device semantic reranker: the DEFAULT recall blend (alpha 0.7) uses it
@@ -58,14 +58,6 @@ memory = [
   "tree-sitter-java", "tree-sitter-c", "tree-sitter-cpp", "tree-sitter-c-sharp",
   "tree-sitter-php", "tree-sitter-ruby",
 ]
-# Adds the OPTIONAL governed layout tuner (AlgentaTuner) — uses the LOCAL Algenta SDK, no external calls.
-memory-algenta = [
-  "telys>=0.1.0b1",
-  "telys-runtime>=0.1.0a1",
-  "numpy>=1.24",
-  "faiss-cpu>=1.7",
-  "telys-algenta[algenta]>=0.1.0a1",
-]
 # OPTIONAL on-device semantic precision reranker (CODNA_MEMORY_RERANK=wordllama). 16 MB CPU model; imported
 # lazily by codna.memory — only needed when reranking is enabled. Lifts ranking precision over lexical fusion.
 memory-rerank = [
@@ -82,12 +74,11 @@ memory-languages = [
   "tree-sitter-php", "tree-sitter-ruby",
 ]
 
-# Local cross-repo dev: resolve the Telys packages from the sibling checkout instead of the (private)
-# git URL above. uv reads this; pip ignores it. cli/ is two levels under Developer/, hence ../../.
+# Local cross-repo dev: resolve the Telys public SDK from the sibling checkout.
+# uv reads this; pip ignores it. The runtime remains an explicit install step.
+# cli/ is two levels under Developer/, hence ../../.
 [tool.uv.sources]
 telys = { path = "../../memory-engine/packages/telys-sdk", editable = true }
-telys-runtime = { path = "../../memory-engine/packages/memengine-py", editable = true }
-telys-algenta = { path = "../../memory-engine/packages/telys-algenta", editable = true }
 
 [project.urls]
 Homepage = "https://codna.ai"

{codna-0.1.0 → codna-0.1.2}/tests/test_local_client.py

@@ -19,6 +19,17 @@ import codna.local_mojo_daemon as mojo_daemon_module
 import codna.local_mojo_pool as mojo_pool_module
 
 
+def _git(repo: Path, *args: str) -> str:
+    result = subprocess.run(
+        ["git", "-C", str(repo), *args],
+        capture_output=True,
+        text=True,
+        check=False,
+    )
+    assert result.returncode == 0, result.stderr
+    return result.stdout
+
+
 class _Dumpable:
     def __init__(self, payload):
         self.payload = payload
@@ -313,6 +324,148 @@ def test_local_client_packaged_backend_runs_packaged_fix_steps(tmp_path, monkeyp
     assert all(row["status"] == "succeeded" for row in rows)
 
 
+def test_packaged_local_branch_allows_unrelated_untracked_files(tmp_path, monkeypatch) -> None:
+    repo = tmp_path / "repo"
+    repo.mkdir()
+    (repo / "app.ts").write_text("export function price() { return 1 }\n", encoding="utf-8")
+    (repo / "__pycache__").mkdir()
+    (repo / "__pycache__" / "app.cpython-313.pyc").write_bytes(b"cache")
+    _git(repo, "init", "-b", "main")
+    _git(repo, "add", "app.ts")
+    _git(repo, "-c", "user.email=a@example.com", "-c", "user.name=Tester", "commit", "-m", "initial")
+    monkeypatch.delenv("ALGENTA_ENGINE_DIR", raising=False)
+    monkeypatch.setenv("CODNA_RUNTIME_ROOT", str(tmp_path / ".codna"))
+    monkeypatch.setattr(local_client_module, "_import_repository_modules", _raise_missing_apps_backend)
+
+    def fake_run(_runner, _request):
+        return PackagedAgentRunResult(
+            status="succeeded",
+            terminal_state="succeeded",
+            agent_run_id="run-1",
+            session_id="session-1",
+            text="Fixed price return value.",
+            files_changed=["app.ts"],
+            telemetry={"tokens_in_uncached": 12, "tokens_out": 5, "total_cost": 0.01},
+            artifacts={},
+            runtime={"kind": "cline", "is_stub": False},
+            patch_diff=(
+                "diff --git a/app.ts b/app.ts\n"
+                "--- a/app.ts\n"
+                "+++ b/app.ts\n"
+                "@@ -1 +1 @@\n"
+                "-export function price() { return 1 }\n"
+                "+export function price() { return 2 }\n"
+            ),
+        )
+
+    monkeypatch.setattr(local_client_module.SidecarPackagedAgentRunner, "run", fake_run)
+
+    client = LocalCodnaRuntimeClient()
+    connector = client.create_connector(name="repo", connector_type="local_repo", config={"path": str(repo)})
+    snapshot = client.create_repository_snapshot(connector["id"], {})
+    triage = client.triage_repository(
+        connector["id"],
+        {"snapshot_id": snapshot["snapshot_id"], "signals": {"issue_text": "price bug"}},
+    )
+    plan = client.create_repository_decision_plan(
+        connector["id"],
+        {
+            "snapshot_id": snapshot["snapshot_id"],
+            "workspace_evidence_bundle_ref": triage["workspace_evidence_bundle_ref"],
+            "signals": {"issue_text": "price bug"},
+        },
+    )
+    simulation = client.simulate_repository(
+        connector["id"],
+        {"snapshot_id": snapshot["snapshot_id"], "decision_plan_id": plan["decision_plan_id"]},
+    )
+
+    result = client.apply_repository(
+        connector["id"],
+        {
+            "mode": "local_branch",
+            "write_permission": True,
+            "decision_plan_id": plan["decision_plan_id"],
+            "simulation_id": simulation["validated_inputs"]["simulation_id"],
+        },
+    )
+
+    assert result["status"] == "applied"
+    assert result["branch_name"].startswith("codna/")
+    assert (repo / "app.ts").read_text(encoding="utf-8") == "export function price() { return 2 }\n"
+    assert (repo / "__pycache__" / "app.cpython-313.pyc").exists()
+
+
+def test_packaged_local_branch_rejects_conflicting_untracked_target(tmp_path, monkeypatch) -> None:
+    repo = tmp_path / "repo"
+    repo.mkdir()
+    _git(repo, "init", "-b", "main")
+    (repo / "README.md").write_text("repo\n", encoding="utf-8")
+    _git(repo, "add", "README.md")
+    _git(repo, "-c", "user.email=a@example.com", "-c", "user.name=Tester", "commit", "-m", "initial")
+    (repo / "app.ts").write_text("local untracked content\n", encoding="utf-8")
+    monkeypatch.delenv("ALGENTA_ENGINE_DIR", raising=False)
+    monkeypatch.setenv("CODNA_RUNTIME_ROOT", str(tmp_path / ".codna"))
+    monkeypatch.setattr(local_client_module, "_import_repository_modules", _raise_missing_apps_backend)
+
+    def fake_run(_runner, _request):
+        return PackagedAgentRunResult(
+            status="succeeded",
+            terminal_state="succeeded",
+            agent_run_id="run-1",
+            session_id="session-1",
+            text="Added app.",
+            files_changed=["app.ts"],
+            telemetry={"tokens_in_uncached": 12, "tokens_out": 5, "total_cost": 0.01},
+            artifacts={},
+            runtime={"kind": "cline", "is_stub": False},
+            patch_diff=(
+                "diff --git a/app.ts b/app.ts\n"
+                "new file mode 100644\n"
+                "--- /dev/null\n"
+                "+++ b/app.ts\n"
+                "@@ -0,0 +1 @@\n"
+                "+export function price() { return 2 }\n"
+            ),
+        )
+
+    monkeypatch.setattr(local_client_module.SidecarPackagedAgentRunner, "run", fake_run)
+
+    client = LocalCodnaRuntimeClient()
+    connector = client.create_connector(name="repo", connector_type="local_repo", config={"path": str(repo)})
+    snapshot = client.create_repository_snapshot(connector["id"], {})
+    triage = client.triage_repository(
+        connector["id"],
+        {"snapshot_id": snapshot["snapshot_id"], "signals": {"issue_text": "missing app"}},
+    )
+    plan = client.create_repository_decision_plan(
+        connector["id"],
+        {
+            "snapshot_id": snapshot["snapshot_id"],
+            "workspace_evidence_bundle_ref": triage["workspace_evidence_bundle_ref"],
+            "signals": {"issue_text": "missing app"},
+        },
+    )
+    simulation = client.simulate_repository(
+        connector["id"],
+        {"snapshot_id": snapshot["snapshot_id"], "decision_plan_id": plan["decision_plan_id"]},
+    )
+
+    with pytest.raises(PackagedRepositoryAdvancedError) as excinfo:
+        client.apply_repository(
+            connector["id"],
+            {
+                "mode": "local_branch",
+                "write_permission": True,
+                "decision_plan_id": plan["decision_plan_id"],
+                "simulation_id": simulation["validated_inputs"]["simulation_id"],
+            },
+        )
+
+    assert excinfo.value.code == "repository_apply_dirty_worktree"
+    assert excinfo.value.details["conflicting_untracked_files"] == ["app.ts"]
+
+
 def test_local_client_packaged_backend_fails_closed_when_agent_makes_no_patch(tmp_path, monkeypatch) -> None:
     repo = tmp_path / "repo"
     repo.mkdir()

{codna-0.1.0 → codna-0.1.2}/tests/test_memory_errors.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 import os
 import json
 import sys
+import types
 
 import pytest
 
@@ -32,6 +33,67 @@ def test_require_telys_missing_extra_is_friendly(monkeypatch):
     assert "codna[memory]" in str(ei.value)        # tells the user exactly how to fix it
 
 
+def test_require_telys_missing_embedding_runtime_is_friendly(monkeypatch):
+    _clear_kernel_env(monkeypatch)
+    fake_telys = types.ModuleType("telys")
+    fake_telys.__path__ = []
+    fake_telys.Telys = object
+    fake_telys.scope_key = lambda *_args: "scope"
+    monkeypatch.setitem(sys.modules, "telys", fake_telys)
+    monkeypatch.setitem(sys.modules, "telys.embedding", None)
+
+    with pytest.raises(CodeMemoryError) as ei:
+        _require_telys()
+
+    assert "Telys kernel could not be loaded" in str(ei.value)
+    assert "telys runtime install" in str(ei.value)
+
+
+def test_embedder_missing_runtime_import_is_friendly(monkeypatch):
+    class MissingKernelEmbedder:
+        def __init__(self):
+            raise ImportError("No module named 'telys.embedding._kernel'")
+
+    monkeypatch.setattr(memory_module, "_engine_embed_config", lambda: None)
+    monkeypatch.setattr(memory_module, "_require_telys", lambda: (object, object, MissingKernelEmbedder))
+    monkeypatch.setattr(memory_module, "_current_kernel_resolution", lambda: {"checked": []})
+
+    with pytest.raises(CodeMemoryError) as ei:
+        memory_module._embedder()  # noqa: SLF001
+
+    assert "Telys kernel could not be loaded" in str(ei.value)
+    assert "telys runtime install" in str(ei.value)
+
+
+def test_code_memory_missing_runtime_is_friendly(monkeypatch, tmp_path):
+    class RuntimeNotInstalled(Exception):
+        pass
+
+    class FakeTelys:
+        def __init__(self, *_args, **_kwargs):
+            raise RuntimeNotInstalled("runtime missing")
+
+    class FakeProfile:
+        model_id = "test.embedder"
+        dimension = 3
+
+    class FakeEmbedder:
+        profile = FakeProfile()
+
+    monkeypatch.setattr(memory_module, "_require_telys", lambda: (FakeTelys, lambda *_args: "scope", object))
+    monkeypatch.setattr(memory_module, "_load_telys_license_metadata", lambda: {"configured": False})
+    monkeypatch.setattr(memory_module, "_current_kernel_resolution", lambda: {"found": False})
+    monkeypatch.setattr(memory_module, "_embedder", lambda: FakeEmbedder())
+
+    with pytest.raises(CodeMemoryError) as ei:
+        memory_module.CodeMemory(str(tmp_path))
+
+    message = str(ei.value)
+    assert "Telys runtime is not installed" in message
+    assert "telys runtime install" in message
+    assert "CODNA_TELYS_INSTALL_ROOT" in message
+
+
 def test_code_memory_error_is_not_the_builtin():
     # Deliberately distinct from the Python builtin MemoryError (avoid shadowing / ambiguous excepts).
     assert CodeMemoryError is not MemoryError and issubclass(CodeMemoryError, Exception)

{codna-0.1.0 → codna-0.1.2}/tests/test_packaging.py

@@ -53,13 +53,13 @@ def _write_wheel(path: Path, *, root_is_purelib: bool, tag: str, names: tuple[st
 
 def test_memory_extras_declared():
     extras = _data()["project"]["optional-dependencies"]
-    assert "memory" in extras and "memory-algenta" in extras
+    assert "memory" in extras
+    assert "memory-algenta" not in extras
     mem = " ".join(extras["memory"])
-    assert "telys-runtime" in mem and "faiss-cpu" in mem and "numpy" in mem
+    assert "telys" in mem and "faiss-cpu" in mem and "numpy" in mem
+    assert "telys-runtime" not in mem
+    assert "telys-algenta" not in mem
     assert "memengine @" not in mem
-    alg = " ".join(extras["memory-algenta"])
-    assert "telys-runtime" in alg
-    assert "telys-algenta" in alg
     for extra_name, dependencies in extras.items():
         assert not any(" @ " in dependency or "git+" in dependency for dependency in dependencies), extra_name