codna 0.1.12__tar.gz → 0.1.13__tar.gz

{codna-0.1.12 → codna-0.1.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codna
-Version: 0.1.12
+Version: 0.1.13
 Summary: Local-first repo intelligence and agent fixing for Codna.
 Author: Thyn
 Maintainer: Thyn
@@ -37,21 +37,21 @@ Requires-Dist: pydantic>=2.6
 Requires-Dist: pyarrow>=17.0.0
 Requires-Dist: pyyaml>=6
 Requires-Dist: telys>=0.1.0b1
+Requires-Dist: tree-sitter>=0.23
+Requires-Dist: tree-sitter-javascript
+Requires-Dist: tree-sitter-typescript
+Requires-Dist: tree-sitter-go
+Requires-Dist: tree-sitter-rust
+Requires-Dist: tree-sitter-java
+Requires-Dist: tree-sitter-c
+Requires-Dist: tree-sitter-cpp
+Requires-Dist: tree-sitter-c-sharp
+Requires-Dist: tree-sitter-php
+Requires-Dist: tree-sitter-ruby
 Provides-Extra: mcp
 Provides-Extra: memory
 Requires-Dist: faiss-cpu>=1.7; extra == "memory"
 Requires-Dist: wordllama>=0.3; extra == "memory"
-Requires-Dist: tree-sitter>=0.23; extra == "memory"
-Requires-Dist: tree-sitter-javascript; extra == "memory"
-Requires-Dist: tree-sitter-typescript; extra == "memory"
-Requires-Dist: tree-sitter-go; extra == "memory"
-Requires-Dist: tree-sitter-rust; extra == "memory"
-Requires-Dist: tree-sitter-java; extra == "memory"
-Requires-Dist: tree-sitter-c; extra == "memory"
-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-rerank
 Requires-Dist: wordllama>=0.3; extra == "memory-rerank"
 Provides-Extra: memory-languages
@@ -123,11 +123,12 @@ repo understanding as a local tool.
 
 Base `pip install codna` includes Codna's local Telys recall path: the public
 Telys SDK, Codna's vendored local runtime package, and release-wheel native
-runtime artifacts for supported platforms.
+runtime artifacts for supported platforms. It also includes the generic
+tree-sitter language extractors used by local Telys recall for JS/TS, Go, Rust,
+Java, C/C++, C#, PHP, and Ruby; Python uses the stdlib AST extractor.
 
 The optional `codna[memory]` extra adds heavier recall enhancements such as
-FAISS, WordLlama reranking, and tree-sitter grammars. It is not required for
-basic on-device recall.
+FAISS and WordLlama reranking. It is not required for basic on-device recall.
 
 Source distributions intentionally exclude bundled native runtime artifacts and
 OEM licenses; platform wheels carry them at release time. Source-checkout and

{codna-0.1.12 → codna-0.1.13}/README.md

@@ -54,11 +54,12 @@ repo understanding as a local tool.
 
 Base `pip install codna` includes Codna's local Telys recall path: the public
 Telys SDK, Codna's vendored local runtime package, and release-wheel native
-runtime artifacts for supported platforms.
+runtime artifacts for supported platforms. It also includes the generic
+tree-sitter language extractors used by local Telys recall for JS/TS, Go, Rust,
+Java, C/C++, C#, PHP, and Ruby; Python uses the stdlib AST extractor.
 
 The optional `codna[memory]` extra adds heavier recall enhancements such as
-FAISS, WordLlama reranking, and tree-sitter grammars. It is not required for
-basic on-device recall.
+FAISS and WordLlama reranking. It is not required for basic on-device recall.
 
 Source distributions intentionally exclude bundled native runtime artifacts and
 OEM licenses; platform wheels carry them at release time. Source-checkout and

{codna-0.1.12 → codna-0.1.13}/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.12"
+__version__ = "0.1.13"

{codna-0.1.12 → codna-0.1.13}/codna/codeunits.py

@@ -1,9 +1,8 @@
 """Extract a repository into structural code units for Codna's local code memory.
 
 Codna has no symbol extractor of its own — the Algenta engine does that server-side. For the
-in-process ``codna memory`` capability we ship a small, dependency-free extractor: day-1 is Python
-(stdlib ``ast``) producing module / class / function / method / test units. Other languages plug in
-via :func:`register_extractor` — keeping multi-language support additive.
+in-process ``codna memory`` capability, Python uses stdlib ``ast`` and the common code languages use
+one generic tree-sitter seam when the packaged grammar wheels are installed.
 
 A :class:`CodeUnit` is a structural unit (not a fixed-size chunk): structure gives cleaner retrieval
 and provenance. ``id`` is a stable symbol path so a changed symbol re-indexes with ``upsert`` (no
@@ -167,15 +166,16 @@ def resolve_languages(languages: tuple[str, ...] | None) -> tuple[str, ...]:
         raise UnsupportedLanguageError(
             f"unsupported language extractor(s): {missing_text}. "
             f"Registered languages: {available_text}.{details} "
-            "Install `codna[memory-languages]` for JS/TS/Go/Rust/Java/C/C++/C#/PHP/Ruby."
+            "Reinstall `codna`, or use the backward-compatible `codna[memory-languages]` extra, "
+            "for JS/TS/Go/Rust/Java/C/C++/C#/PHP/Ruby."
         )
     return resolved
 
 
 register_extractor(PythonExtractor())
 
-# Optional multi-language support (additive): plug tree-sitter grammars into the same seam when the
-# `tree_sitter` wheels are installed. Falls back to Python-only (ast) if they're absent — non-breaking.
+# Multi-language support (additive): plug tree-sitter grammars into the same seam when the wheels are
+# installed. Base wheels declare them; source/dev installs still report explicit diagnostics if absent.
 try:
     from .codeunits_treesitter import register_treesitter
 

{codna-0.1.12 → codna-0.1.13}/codna/codeunits_treesitter.py

@@ -1,9 +1,9 @@
-"""Optional multi-language structural extraction via tree-sitter — ONE generic walk for every grammar.
+"""Multi-language structural extraction via tree-sitter — ONE generic walk for every grammar.
 
-Codna's day-1 extractor is stdlib-``ast`` Python only (:mod:`codna.codeunits`). This module plugs the
-other languages into the same ``register_extractor`` seam, so ``codna memory`` indexes any repo the
-Algenta engine already understands. It is **additive + optional**: if ``tree_sitter`` and the grammar
-wheels aren't installed, :func:`register_treesitter` is a no-op and codna stays Python-only.
+Python stays on the stdlib-``ast`` path (:mod:`codna.codeunits`). This module plugs common code
+languages into the same ``register_extractor`` seam. Base release wheels install these dependencies;
+source/dev installs can still run Python-only if the grammar wheels are absent, and explicit language
+requests report diagnostics.
 
 There is NO per-language logic: a node is a unit when its grammar type *contains* a function/type hint
 and has a name; the doc is the leading comment sibling(s), else a leading string literal in the body

{codna-0.1.12 → codna-0.1.13}/codna.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codna
-Version: 0.1.12
+Version: 0.1.13
 Summary: Local-first repo intelligence and agent fixing for Codna.
 Author: Thyn
 Maintainer: Thyn
@@ -37,21 +37,21 @@ Requires-Dist: pydantic>=2.6
 Requires-Dist: pyarrow>=17.0.0
 Requires-Dist: pyyaml>=6
 Requires-Dist: telys>=0.1.0b1
+Requires-Dist: tree-sitter>=0.23
+Requires-Dist: tree-sitter-javascript
+Requires-Dist: tree-sitter-typescript
+Requires-Dist: tree-sitter-go
+Requires-Dist: tree-sitter-rust
+Requires-Dist: tree-sitter-java
+Requires-Dist: tree-sitter-c
+Requires-Dist: tree-sitter-cpp
+Requires-Dist: tree-sitter-c-sharp
+Requires-Dist: tree-sitter-php
+Requires-Dist: tree-sitter-ruby
 Provides-Extra: mcp
 Provides-Extra: memory
 Requires-Dist: faiss-cpu>=1.7; extra == "memory"
 Requires-Dist: wordllama>=0.3; extra == "memory"
-Requires-Dist: tree-sitter>=0.23; extra == "memory"
-Requires-Dist: tree-sitter-javascript; extra == "memory"
-Requires-Dist: tree-sitter-typescript; extra == "memory"
-Requires-Dist: tree-sitter-go; extra == "memory"
-Requires-Dist: tree-sitter-rust; extra == "memory"
-Requires-Dist: tree-sitter-java; extra == "memory"
-Requires-Dist: tree-sitter-c; extra == "memory"
-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-rerank
 Requires-Dist: wordllama>=0.3; extra == "memory-rerank"
 Provides-Extra: memory-languages
@@ -123,11 +123,12 @@ repo understanding as a local tool.
 
 Base `pip install codna` includes Codna's local Telys recall path: the public
 Telys SDK, Codna's vendored local runtime package, and release-wheel native
-runtime artifacts for supported platforms.
+runtime artifacts for supported platforms. It also includes the generic
+tree-sitter language extractors used by local Telys recall for JS/TS, Go, Rust,
+Java, C/C++, C#, PHP, and Ruby; Python uses the stdlib AST extractor.
 
 The optional `codna[memory]` extra adds heavier recall enhancements such as
-FAISS, WordLlama reranking, and tree-sitter grammars. It is not required for
-basic on-device recall.
+FAISS and WordLlama reranking. It is not required for basic on-device recall.
 
 Source distributions intentionally exclude bundled native runtime artifacts and
 OEM licenses; platform wheels carry them at release time. Source-checkout and

{codna-0.1.12 → codna-0.1.13}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codna"
-version = "0.1.12"
+version = "0.1.13"
 description = "Local-first repo intelligence and agent fixing for Codna."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -50,33 +50,40 @@ dependencies = [
   "pyarrow>=17.0.0",
   "pyyaml>=6",
   "telys>=0.1.0b1",
+  # Base `pip install codna` must not degrade local Telys recall to Python-only.
+  # These wheels power one generic structural extractor for the common code
+  # languages Codna recalls locally; repository intelligence itself remains
+  # broader through the in-process Algenta SDK/core.
+  "tree-sitter>=0.23",
+  "tree-sitter-javascript",
+  "tree-sitter-typescript",
+  "tree-sitter-go",
+  "tree-sitter-rust",
+  "tree-sitter-java",
+  "tree-sitter-c",
+  "tree-sitter-cpp",
+  "tree-sitter-c-sharp",
+  "tree-sitter-php",
+  "tree-sitter-ruby",
 ]
 
 [project.optional-dependencies]
 mcp = []
 # Local, in-process code memory & recall via Telys. Base `codna` includes the
-# public SDK plus Codna's vendored local runtime package; this extra adds only
-# heavier optional retrieval/rerank/language packages.
+# public SDK, Codna's vendored local runtime package, the OEM license, and the
+# multi-language tree-sitter extractors. This extra adds heavier optional
+# retrieval/rerank packages for experiments.
 memory = [
   "faiss-cpu>=1.7",
   "wordllama>=0.3",   # on-device semantic reranker: the DEFAULT recall blend (alpha 0.7) uses it
-  # Multi-language structural extraction (tree-sitter) — codna's local memory indexes these languages,
-  # not just Python (ast). ONE generic walk, no per-language logic. Additive: codeunits.py registers
-  # whichever grammars are present and falls back to Python-only if tree-sitter is absent.
-  "tree-sitter>=0.23",
-  "tree-sitter-javascript", "tree-sitter-typescript", "tree-sitter-go", "tree-sitter-rust",
-  "tree-sitter-java", "tree-sitter-c", "tree-sitter-cpp", "tree-sitter-c-sharp",
-  "tree-sitter-php", "tree-sitter-ruby",
 ]
 # 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 = [
   "wordllama>=0.3",
 ]
-# OPTIONAL multi-language structural extraction (tree-sitter grammars), standalone. codna's local memory
-# is Python-`ast` by default; with these it indexes JS/TS/Go/Rust/Java/C/C++/C#/PHP/Ruby via ONE generic
-# tree-sitter walk (no per-language logic). Already bundled in [memory]; this is for installing just the
-# language grammars. codeunits.py registers whatever is present and stays Python-only if absent.
+# Backward-compatible extra name for older docs/scripts. These dependencies are
+# now also in base `codna` so normal installs get multi-language local memory.
 memory-languages = [
   "tree-sitter>=0.23",
   "tree-sitter-javascript", "tree-sitter-typescript", "tree-sitter-go", "tree-sitter-rust",

{codna-0.1.12 → codna-0.1.13}/tests/test_codeunits.py

@@ -71,6 +71,7 @@ def test_language_filter_rejects_unregistered_language(tmp_path, monkeypatch):
     msg = str(excinfo.value)
     assert "unsupported language extractor(s): go" in msg
     assert "Registered languages: python" in msg
+    assert "Reinstall `codna`" in msg
     assert "codna[memory-languages]" in msg
 
 

{codna-0.1.12 → codna-0.1.13}/tests/test_codeunits_treesitter.py

@@ -1,7 +1,7 @@
-"""Tests for the optional multi-language tree-sitter extractor.
+"""Tests for the multi-language tree-sitter extractor.
 
-Skipped cleanly when the tree-sitter grammar wheels aren't installed (offline CI stays green) — codna
-then runs Python-`ast` only. Install with `pip install 'codna[memory]'` or `'codna[memory-languages]'`.
+Skipped cleanly when the tree-sitter grammar wheels aren't installed in a source/dev checkout. Release
+base wheels install these grammars so normal `pip install codna` memory is not Python-only.
 """
 from __future__ import annotations
 

{codna-0.1.12 → codna-0.1.13}/tests/test_packaging.py

@@ -66,9 +66,12 @@ def _write_wheel(
 def test_memory_extras_declared():
     extras = _data()["project"]["optional-dependencies"]
     assert "memory" in extras
+    assert "memory-languages" in extras
     assert "memory-algenta" not in extras
     mem = " ".join(extras["memory"])
-    assert "faiss-cpu" in mem and "wordllama" in mem and "tree-sitter" in mem
+    assert "faiss-cpu" in mem and "wordllama" in mem
+    language_extra = " ".join(extras["memory-languages"])
+    assert "tree-sitter" in language_extra and "tree-sitter-go" in language_extra
     assert "telys-runtime" not in mem
     assert "telys-algenta" not in mem
     assert "memengine @" not in mem
@@ -76,15 +79,29 @@ def test_memory_extras_declared():
         assert not any(" @ " in dependency or "git+" in dependency for dependency in dependencies), extra_name
 
 
-def test_core_install_includes_telys_runtime_contract_without_heavy_addons():
+def test_core_install_includes_telys_runtime_contract_without_heavy_rerank_addons():
     deps = _data()["project"]["dependencies"]
     joined = " ".join(deps)
     assert "telys>=0.1.0b1" in deps
     assert "numpy>=1.24" in deps
     assert "pydantic>=2.6" in deps
     assert "pyarrow>=17.0.0" in deps
+    for dep in (
+        "tree-sitter>=0.23",
+        "tree-sitter-javascript",
+        "tree-sitter-typescript",
+        "tree-sitter-go",
+        "tree-sitter-rust",
+        "tree-sitter-java",
+        "tree-sitter-c",
+        "tree-sitter-cpp",
+        "tree-sitter-c-sharp",
+        "tree-sitter-php",
+        "tree-sitter-ruby",
+    ):
+        assert dep in deps
     assert "memengine" not in joined
-    assert all("faiss" not in dep and "wordllama" not in dep and "tree-sitter" not in dep for dep in deps)
+    assert all("faiss" not in dep and "wordllama" not in dep for dep in deps)
 
 
 def test_core_install_uses_public_dependencies_only():
@@ -122,6 +139,35 @@ def test_package_declares_local_readme_metadata():
     assert "Secrets, local runtime state, logs" in readme
 
 
+def test_public_docs_do_not_make_keys_txt_a_packaged_user_path():
+    """Installed users use env/keychain; keys.txt is source-checkout/dev-only."""
+    running = (ROOT / "RUNNING-CODNA.md").read_text(encoding="utf-8")
+    quickstart = (ROOT / "docs" / "quickstart.md").read_text(encoding="utf-8")
+    configuration = (ROOT / "docs" / "configuration.md").read_text(encoding="utf-8")
+
+    combined = "\n".join((running, quickstart, configuration))
+    assert "Codna reads `keys.txt` by default" not in combined
+    assert "Codna reads credentials from the environment or `keys.txt`" not in combined
+    assert "The package does not search for `keys.txt`" in quickstart
+    assert "installed package does not search for `keys.txt`" in configuration
+    assert "Installed users should use real environment variables or `codna key set`" in running
+
+
+def test_public_docs_do_not_advertise_missing_hosted_installer():
+    """codna.ai currently documents PyPI install; do not point users at a 404 route."""
+    paths = [
+        ROOT / "README.md",
+        ROOT / "docs" / "README.md",
+        ROOT / "docs" / "quickstart.md",
+        ROOT / "docs" / "troubleshooting.md",
+        ROOT / "install.sh",
+    ]
+    combined = "\n".join(path.read_text(encoding="utf-8") for path in paths)
+    assert "pip install codna" in combined
+    assert "curl -fsSL https://codna.ai/install.sh | bash" not in combined
+    assert "install.sh` one-liner" not in combined
+
+
 def test_package_version_matches_runtime_version():
     data = _data()["project"]
     init_text = (ROOT / "cli" / "codna" / "__init__.py").read_text(encoding="utf-8")
@@ -251,8 +297,16 @@ def test_github_action_preserves_codna_failure_status_without_forcing_remote_eng
     assert 'package_path="codna"' in action
     assert 'package_path="$GITHUB_ACTION_PATH/cli"' in action
     assert 'pipx install --force "$package_path"' in action
-    assert 'python3 -m pip install --user --upgrade "$package_path"' in action
+    assert "python_supports_codna()" in action
+    assert "python_is_virtualenv()" in action
+    assert "resolve_python()" in action
+    assert '"$PYTHON_BIN" -m pip install --upgrade "$package_path"' in action
+    assert '"$PYTHON_BIN" -m pip install --user --upgrade "$package_path"' in action
+    assert 'dirname "$PYTHON_BIN" >> "$GITHUB_PATH"' in action
     assert 'echo "$HOME/.local/bin" >> "$GITHUB_PATH"' in action
+    assert action.index('if [ -n "${PYTHON:-}" ] && python_is_virtualenv "$PYTHON_BIN"; then') < action.index(
+        'elif command -v pipx >/dev/null 2>&1; then'
+    )
     assert "bun install --frozen-lockfile" in action
     assert "bun run build:sdk" in action
     assert "bash algenta/postbuild.sh" in action
@@ -324,12 +378,136 @@ def test_public_action_examples_use_current_github_owner():
         ROOT / "docs" / "README.md",
         ROOT / "docs" / "configuration.md",
         ROOT / "docs" / "github-action.md",
+        ROOT / "docs" / "quickstart.md",
         ROOT / "examples" / "codna-autofix.yml",
     ]
     combined = "\n".join(path.read_text(encoding="utf-8") for path in paths)
     assert "thyn-ai/codna@v1" in combined
+    assert "https://github.com/thyn-ai/codna.git" in combined
     assert "escrypto-labs/codna@v1" not in combined
     assert "codna-ai/fix-action" not in combined
+    assert "codna-ai/codna" not in combined
+
+
+def test_install_script_is_local_first_and_non_invasive():
+    script = (ROOT / "install.sh").read_text(encoding="utf-8")
+
+    assert "pipx install --force \"$INSTALL_SPEC\"" in script
+    assert "python_supports_codna()" in script
+    assert "python_is_virtualenv()" in script
+    assert "resolve_python()" in script
+    assert "\"$PYTHON_BIN\" -m pip install --upgrade \"$INSTALL_SPEC\"" in script
+    assert "\"$PYTHON_BIN\" -m pip install --user --upgrade \"$INSTALL_SPEC\"" in script
+    assert "\"${PYTHON_BIN_DIR}/codna\"" in script
+    assert "codna[mcp]" not in script
+    assert "need docker" not in script
+    assert "docker compose" not in script
+    assert "Starting the codna engine" not in script
+    assert "CODNA_ENGINE_URL=http://127.0.0.1" not in script
+    assert "ALGENTA_AGENT_CORE_URL=http://127.0.0.1" not in script
+    assert "cat > \"$CODNA_DIR/.env\"" not in script
+    assert "No Docker stack was started and no engine URL was written." in script
+
+
+def test_install_script_uses_python_310_plus_for_pip_fallback(tmp_path):
+    """macOS system python3 can be 3.9; installer must select a compatible Python."""
+    fake_bin = tmp_path / "bin"
+    fake_bin.mkdir()
+    marker = tmp_path / "python312-pip-called"
+
+    old_python = fake_bin / "python3"
+    old_python.write_text(
+        "#!/bin/bash\n"
+        "if [ \"${1:-}\" = \"-c\" ]; then exit 1; fi\n"
+        "echo 'old python3 must not run pip' >&2\n"
+        "exit 99\n",
+        encoding="utf-8",
+    )
+    old_python.chmod(0o755)
+
+    good_python = fake_bin / "python3.12"
+    good_python.write_text(
+        "#!/bin/bash\n"
+        "if [ \"${1:-}\" = \"-c\" ]; then\n"
+        "  case \"${2:-}\" in\n"
+        "    *version_info*) exit 0 ;;\n"
+        "    *base_prefix*) exit 1 ;;\n"
+        "  esac\n"
+        "fi\n"
+        "if [ \"${1:-}\" = \"-m\" ] && [ \"${2:-}\" = \"pip\" ]; then\n"
+        f"  touch {marker}\n"
+        "  mkdir -p \"$HOME/.local/bin\"\n"
+        "  cat > \"$HOME/.local/bin/codna\" <<'SH'\n"
+        "#!/bin/bash\n"
+        "echo 'codna 0.1.12'\n"
+        "SH\n"
+        "  chmod +x \"$HOME/.local/bin/codna\"\n"
+        "  exit 0\n"
+        "fi\n"
+        "exit 2\n",
+        encoding="utf-8",
+    )
+    good_python.chmod(0o755)
+
+    env = {
+        "HOME": str(tmp_path / "home"),
+        "PATH": f"{fake_bin}:/bin:/usr/bin",
+        "CODNA_INSTALL_SPEC": "codna==0.1.12",
+    }
+    completed = subprocess.run(["/bin/bash", str(ROOT / "install.sh")], env=env, text=True, capture_output=True)
+
+    assert completed.returncode == 0, completed.stdout + completed.stderr
+    assert marker.exists()
+    assert "No Docker stack was started and no engine URL was written." in completed.stdout
+    assert not (Path(env["HOME"]) / ".codna" / ".env").exists()
+
+
+def test_install_script_explicit_virtualenv_python_takes_precedence_over_pipx(tmp_path):
+    """If PYTHON points to a venv, the installer must not ignore it just because pipx exists."""
+    fake_bin = tmp_path / "bin"
+    fake_bin.mkdir()
+    pip_marker = tmp_path / "python-pip-called"
+    pipx_marker = tmp_path / "pipx-called"
+
+    fake_python = fake_bin / "python-custom"
+    fake_python.write_text(
+        "#!/bin/bash\n"
+        "if [ \"${1:-}\" = \"-c\" ]; then exit 0; fi\n"
+        "if [ \"${1:-}\" = \"-m\" ] && [ \"${2:-}\" = \"pip\" ]; then\n"
+        f"  touch {pip_marker}\n"
+        "  cat > \"$(dirname \"$0\")/codna\" <<'SH'\n"
+        "#!/bin/bash\n"
+        "echo 'codna 0.1.12'\n"
+        "SH\n"
+        "  chmod +x \"$(dirname \"$0\")/codna\"\n"
+        "  exit 0\n"
+        "fi\n"
+        "exit 2\n",
+        encoding="utf-8",
+    )
+    fake_python.chmod(0o755)
+
+    fake_pipx = fake_bin / "pipx"
+    fake_pipx.write_text(
+        "#!/bin/bash\n"
+        f"touch {pipx_marker}\n"
+        "exit 88\n",
+        encoding="utf-8",
+    )
+    fake_pipx.chmod(0o755)
+
+    env = {
+        "HOME": str(tmp_path / "home"),
+        "PATH": f"{fake_bin}:/bin:/usr/bin",
+        "PYTHON": str(fake_python),
+        "CODNA_INSTALL_SPEC": "codna==0.1.12",
+    }
+    completed = subprocess.run(["/bin/bash", str(ROOT / "install.sh")], env=env, text=True, capture_output=True)
+
+    assert completed.returncode == 0, completed.stdout + completed.stderr
+    assert pip_marker.exists()
+    assert not pipx_marker.exists()
+    assert "codna 0.1.12" in completed.stdout
 
 
 def test_release_runbook_documents_exact_pypi_trusted_publisher_claims():