coodie 1.0.0__tar.gz

coodie-1.0.0/.all-contributorsrc

@@ -0,0 +1,27 @@
+{
+  "projectName": "coodie",
+  "projectOwner": "scylladb",
+  "repoType": "github",
+  "repoHost": "https://github.com",
+  "files": [
+    "README.md"
+  ],
+  "imageSize": 80,
+  "commit": true,
+  "commitConvention": "angular",
+  "contributors": [
+    {
+      "login": "fruch",
+      "name": "Israel Fruchter",
+      "avatar_url": "https://avatars.githubusercontent.com/u/340979?v=4",
+      "profile": "http://fruch.github.io/",
+      "contributions": [
+        "code",
+        "ideas",
+        "doc"
+      ]
+    }
+  ],
+  "contributorsPerLine": 7,
+  "skipCi": true
+}

coodie-1.0.0/.editorconfig

@@ -0,0 +1,21 @@
+# http://editorconfig.org
+
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+insert_final_newline = true
+charset = utf-8
+end_of_line = lf
+
+[*.bat]
+indent_style = tab
+end_of_line = crlf
+
+[LICENSE]
+insert_final_newline = false
+
+[Makefile]
+indent_style = tab

coodie-1.0.0/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: ["scylladb"]

coodie-1.0.0/.github/ISSUE_TEMPLATE/1-bug_report.md

@@ -0,0 +1,14 @@
+---
+name: Bug report
+about: Create a report to help us improve
+labels: bug
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+
+**Additional context**
+Add any other context about the problem here.

coodie-1.0.0/.github/ISSUE_TEMPLATE/2-feature-request.md

@@ -0,0 +1,14 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+labels: enhancement
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

coodie-1.0.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,43 @@
+## Description
+
+<!-- Describe the changes in this PR. -->
+
+## Related Issue
+
+<!-- Link any related GitHub issues: Fixes #123 -->
+
+## Plan Reference
+
+<!--
+If this PR implements a phase of a multi-phase plan, add a `Plan:` line below.
+The Plan Phase Continuation workflow uses this to automatically delegate the
+next phase to Copilot after merge.
+
+Format:
+  Plan: docs/plans/<plan-name>.md
+  Phase: N        ← optional: the phase number this PR completes
+
+Example:
+  Plan: docs/plans/udt-support.md
+  Phase: 2
+
+Leave blank if this PR is not part of a plan.
+-->
+
+## Type of Change
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Refactor / code cleanup
+- [ ] Test improvements
+- [ ] CI / workflow changes
+
+## Checklist
+
+- [ ] My code follows the project's coding style
+- [ ] I have added/updated tests that prove my fix/feature works
+- [ ] All existing tests pass (`uv run pytest tests/`)
+- [ ] I have run `uv run pre-commit run --all-files` and fixed any issues
+- [ ] My commit messages follow the Conventional Commits format

coodie-1.0.0/.github/hooks/setup-shims.bats

@@ -0,0 +1,121 @@
+#!/usr/bin/env bats
+# Tests for setup-shims.sh — supports Claude Code (CLAUDE_ENV_FILE)
+# and GitHub Actions / Copilot coding agent (GITHUB_PATH)
+
+SETUP_SCRIPT="${BATS_TEST_DIRNAME}/setup-shims.sh"
+
+setup() {
+  export CLAUDE_ENV_FILE
+  CLAUDE_ENV_FILE="$(mktemp)"
+  # Create a fake uv so the guard passes
+  FAKE_BIN="$(mktemp -d)"
+  echo '#!/usr/bin/env bash' >"$FAKE_BIN/uv"
+  chmod +x "$FAKE_BIN/uv"
+  export FAKE_BIN
+  # Save original PATH
+  export ORIG_PATH="$PATH"
+}
+
+teardown() {
+  rm -f "$CLAUDE_ENV_FILE"
+  rm -rf "$FAKE_BIN"
+}
+
+@test "exits silently when neither env file is set" {
+  run env -u CLAUDE_ENV_FILE -u GITHUB_PATH PATH="${FAKE_BIN}:${ORIG_PATH}" \
+    bash "$SETUP_SCRIPT"
+  [[ $status -eq 0 ]]
+}
+
+@test "exits silently when uv is not available" {
+  # Remove fake uv dir from PATH; keep rest so bash/coreutils work
+  local path_without_uv=""
+  local IFS=:
+  for dir in $ORIG_PATH; do
+    [[ "$dir" == "$FAKE_BIN" ]] && continue
+    # Also skip dirs with real uv
+    [[ -x "$dir/uv" ]] && continue
+    path_without_uv="${path_without_uv:+${path_without_uv}:}$dir"
+  done
+  run env PATH="$path_without_uv" CLAUDE_ENV_FILE="$CLAUDE_ENV_FILE" \
+    bash "$SETUP_SCRIPT"
+  [[ $status -eq 0 ]]
+  [[ ! -s "$CLAUDE_ENV_FILE" ]]
+}
+
+# ── Claude Code (CLAUDE_ENV_FILE) ───────────────────────────────────────────
+
+@test "writes PATH export to CLAUDE_ENV_FILE" {
+  run env -u GITHUB_PATH PATH="${FAKE_BIN}:${ORIG_PATH}" bash "$SETUP_SCRIPT"
+  [[ $status -eq 0 ]]
+  grep -q 'export PATH=' "$CLAUDE_ENV_FILE"
+}
+
+@test "shims dir appears in CLAUDE_ENV_FILE PATH export" {
+  env -u GITHUB_PATH PATH="${FAKE_BIN}:${ORIG_PATH}" bash "$SETUP_SCRIPT"
+  local shims_dir
+  shims_dir="$(cd "${BATS_TEST_DIRNAME}/shims" && pwd)"
+  grep -q "$shims_dir" "$CLAUDE_ENV_FILE"
+}
+
+@test "CLAUDE_ENV_FILE PATH export is absolute" {
+  env -u GITHUB_PATH PATH="${FAKE_BIN}:${ORIG_PATH}" bash "$SETUP_SCRIPT"
+  local line
+  line="$(cat "$CLAUDE_ENV_FILE")"
+  [[ "$line" =~ export\ PATH=\"/ ]]
+}
+
+@test "appends to existing CLAUDE_ENV_FILE content" {
+  echo 'export FOO=bar' >"$CLAUDE_ENV_FILE"
+  env -u GITHUB_PATH PATH="${FAKE_BIN}:${ORIG_PATH}" bash "$SETUP_SCRIPT"
+  grep -q 'export FOO=bar' "$CLAUDE_ENV_FILE"
+  grep -q 'export PATH=' "$CLAUDE_ENV_FILE"
+}
+
+# ── GitHub Actions / Copilot coding agent (GITHUB_PATH) ─────────────────────
+
+@test "writes shims dir to GITHUB_PATH" {
+  local gh_path_file
+  gh_path_file="$(mktemp)"
+  run env -u CLAUDE_ENV_FILE GITHUB_PATH="$gh_path_file" \
+    PATH="${FAKE_BIN}:${ORIG_PATH}" bash "$SETUP_SCRIPT"
+  [[ $status -eq 0 ]]
+  [[ -s "$gh_path_file" ]]
+  rm -f "$gh_path_file"
+}
+
+@test "shims dir appears in GITHUB_PATH file" {
+  local gh_path_file
+  gh_path_file="$(mktemp)"
+  env -u CLAUDE_ENV_FILE GITHUB_PATH="$gh_path_file" \
+    PATH="${FAKE_BIN}:${ORIG_PATH}" bash "$SETUP_SCRIPT"
+  local shims_dir
+  shims_dir="$(cd "${BATS_TEST_DIRNAME}/shims" && pwd)"
+  grep -q "$shims_dir" "$gh_path_file"
+  rm -f "$gh_path_file"
+}
+
+@test "GITHUB_PATH entry is absolute path" {
+  local gh_path_file
+  gh_path_file="$(mktemp)"
+  env -u CLAUDE_ENV_FILE GITHUB_PATH="$gh_path_file" \
+    PATH="${FAKE_BIN}:${ORIG_PATH}" bash "$SETUP_SCRIPT"
+  local line
+  line="$(cat "$gh_path_file")"
+  [[ "$line" == /* ]]
+  rm -f "$gh_path_file"
+}
+
+@test "GITHUB_PATH takes precedence over CLAUDE_ENV_FILE" {
+  local gh_path_file
+  gh_path_file="$(mktemp)"
+  env GITHUB_PATH="$gh_path_file" CLAUDE_ENV_FILE="$CLAUDE_ENV_FILE" \
+    PATH="${FAKE_BIN}:${ORIG_PATH}" bash "$SETUP_SCRIPT"
+  # shims dir written to GITHUB_PATH
+  local shims_dir
+  shims_dir="$(cd "${BATS_TEST_DIRNAME}/shims" && pwd)"
+  grep -q "$shims_dir" "$gh_path_file"
+  # CLAUDE_ENV_FILE NOT written (early exit after GITHUB_PATH)
+  [[ ! -s "$CLAUDE_ENV_FILE" ]]
+  rm -f "$gh_path_file"
+}

coodie-1.0.0/.github/hooks/setup-shims.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Prepend the shims directory to PATH so that bare python/pip/pipx/uv-pip
+# invocations are intercepted with uv suggestions.
+#
+# Supported environments:
+#   - Claude Code (SessionStart hook): uses CLAUDE_ENV_FILE
+#   - GitHub Actions / Copilot coding agent: uses GITHUB_PATH
+#
+# Exits cleanly (no-op) in any other environment.
+#
+# `uv run` is unaffected because it prepends its managed virtualenv's
+# bin/ to PATH, shadowing the shims.
+
+# Guard: only activate when uv is available
+command -v uv &>/dev/null || exit 0
+
+shims_dir="$(cd "$(dirname "$0")/shims" && pwd)" || {
+  echo "modern-python: shims directory not found" >&2
+  exit 1
+}
+
+# GitHub Actions / Copilot coding agent: prepend to PATH via $GITHUB_PATH
+if [[ -n "${GITHUB_PATH:-}" ]]; then
+  echo "${shims_dir}" >>"$GITHUB_PATH"
+  exit 0
+fi
+
+# Claude Code SessionStart hook: export PATH via $CLAUDE_ENV_FILE
+if [[ -n "${CLAUDE_ENV_FILE:-}" ]]; then
+  echo "export PATH=\"${shims_dir}:\${PATH}\"" >>"$CLAUDE_ENV_FILE"
+  exit 0
+fi
+
+echo "modern-python: neither GITHUB_PATH nor CLAUDE_ENV_FILE set; shims will not be installed" >&2
+exit 0

coodie-1.0.0/.github/hooks/shims/pip

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# PATH shim for pip/pip3 — intercepts bare invocations and
+# suggests the uv equivalent.  Works for both names via $0.
+cmd="$(basename "$0")"
+
+case "${1:-}" in
+  install)
+    echo "ERROR: Use \`uv add <package>\` instead of \`$cmd install\`" >&2
+    echo "  For one-off usage without adding to project: uv run --with <package> ..." >&2
+    ;;
+  uninstall)
+    echo "ERROR: Use \`uv remove <package>\` instead of \`$cmd uninstall\`" >&2
+    ;;
+  freeze)
+    echo "ERROR: Use \`uv export\` instead of \`$cmd freeze\`" >&2
+    ;;
+  *)
+    echo "ERROR: Use \`uv\` commands instead of \`$cmd\`" >&2
+    echo "  uv add <package>       # install a dependency" >&2
+    echo "  uv remove <package>    # remove a dependency" >&2
+    echo "  uv sync                # sync environment" >&2
+    ;;
+esac
+
+exit 1

coodie-1.0.0/.github/hooks/shims/pip-shim.bats

@@ -0,0 +1,45 @@
+#!/usr/bin/env bats
+# Tests for pip/pip3 PATH shim
+
+SHIM="${BATS_TEST_DIRNAME}/pip"
+
+@test "exits non-zero for pip install" {
+  run "$SHIM" install requests
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv add"* ]]
+}
+
+@test "suggests uv run --with for one-off usage" {
+  run "$SHIM" install requests
+  [[ "$output" == *"uv run --with"* ]]
+}
+
+@test "exits non-zero for pip uninstall" {
+  run "$SHIM" uninstall requests
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv remove"* ]]
+}
+
+@test "exits non-zero for pip freeze" {
+  run "$SHIM" freeze
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv export"* ]]
+}
+
+@test "exits non-zero for bare pip" {
+  run "$SHIM"
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv"* ]]
+}
+
+@test "exits non-zero for pip show" {
+  run "$SHIM" show requests
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv"* ]]
+}
+
+@test "works when invoked as pip3 via symlink" {
+  run "${BATS_TEST_DIRNAME}/pip3" install foo
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv add"* ]]
+}

coodie-1.0.0/.github/hooks/shims/pip3

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# PATH shim for pip/pip3 — intercepts bare invocations and
+# suggests the uv equivalent.  Works for both names via $0.
+cmd="$(basename "$0")"
+
+case "${1:-}" in
+  install)
+    echo "ERROR: Use \`uv add <package>\` instead of \`$cmd install\`" >&2
+    echo "  For one-off usage without adding to project: uv run --with <package> ..." >&2
+    ;;
+  uninstall)
+    echo "ERROR: Use \`uv remove <package>\` instead of \`$cmd uninstall\`" >&2
+    ;;
+  freeze)
+    echo "ERROR: Use \`uv export\` instead of \`$cmd freeze\`" >&2
+    ;;
+  *)
+    echo "ERROR: Use \`uv\` commands instead of \`$cmd\`" >&2
+    echo "  uv add <package>       # install a dependency" >&2
+    echo "  uv remove <package>    # remove a dependency" >&2
+    echo "  uv sync                # sync environment" >&2
+    ;;
+esac
+
+exit 1

coodie-1.0.0/.github/hooks/shims/pipx

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# PATH shim for pipx — intercepts bare invocations and
+# suggests the uv tool equivalent.
+
+case "${1:-}" in
+  install)
+    echo "ERROR: Use \`uv tool install <package>\` instead of \`pipx install\`" >&2
+    ;;
+  uninstall)
+    echo "ERROR: Use \`uv tool uninstall <package>\` instead of \`pipx uninstall\`" >&2
+    ;;
+  run)
+    echo "ERROR: Use \`uvx <package>\` instead of \`pipx run\`" >&2
+    ;;
+  upgrade)
+    echo "ERROR: Use \`uv tool upgrade <package>\` instead of \`pipx upgrade\`" >&2
+    ;;
+  upgrade-all)
+    echo "ERROR: Use \`uv tool upgrade --all\` instead of \`pipx upgrade-all\`" >&2
+    ;;
+  ensurepath)
+    echo "ERROR: Use \`uv tool update-shell\` instead of \`pipx ensurepath\`" >&2
+    ;;
+  inject)
+    echo "ERROR: Use \`uv tool install --with <dep> <package>\` instead of \`pipx inject\`" >&2
+    ;;
+  list)
+    echo "ERROR: Use \`uv tool list\` instead of \`pipx list\`" >&2
+    ;;
+  *)
+    echo "ERROR: Use \`uv tool\` commands instead of \`pipx\`" >&2
+    echo "  uv tool install <package>   # install a CLI tool" >&2
+    echo "  uv tool uninstall <package> # uninstall a CLI tool" >&2
+    echo "  uvx <package>               # run a tool without installing" >&2
+    echo "  uv tool list                # list installed tools" >&2
+    ;;
+esac
+
+exit 1

coodie-1.0.0/.github/hooks/shims/pipx-shim.bats

@@ -0,0 +1,64 @@
+#!/usr/bin/env bats
+# Tests for pipx PATH shim
+
+SHIM="${BATS_TEST_DIRNAME}/pipx"
+
+@test "exits non-zero for pipx install" {
+  run "$SHIM" install black
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv tool install"* ]]
+}
+
+@test "exits non-zero for pipx uninstall" {
+  run "$SHIM" uninstall black
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv tool uninstall"* ]]
+}
+
+@test "exits non-zero for pipx run" {
+  run "$SHIM" run black
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uvx"* ]]
+}
+
+@test "exits non-zero for pipx upgrade" {
+  run "$SHIM" upgrade black
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv tool upgrade"* ]]
+}
+
+@test "exits non-zero for pipx inject" {
+  run "$SHIM" inject black click
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv tool install --with"* ]]
+}
+
+@test "exits non-zero for pipx list" {
+  run "$SHIM" list
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv tool list"* ]]
+}
+
+@test "exits non-zero for pipx upgrade-all" {
+  run "$SHIM" upgrade-all
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv tool upgrade --all"* ]]
+}
+
+@test "exits non-zero for pipx ensurepath" {
+  run "$SHIM" ensurepath
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv tool update-shell"* ]]
+}
+
+@test "exits non-zero for bare pipx" {
+  run "$SHIM"
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv tool"* ]]
+}
+
+@test "exits non-zero for unknown pipx subcommand" {
+  run "$SHIM" completions
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv tool"* ]]
+}

coodie-1.0.0/.github/hooks/shims/python

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# PATH shim for python/python3 — intercepts bare invocations and
+# suggests the uv equivalent.  Works for both names via $0.
+cmd="$(basename "$0")"
+
+case "${1:-}" in
+  -m)
+    case "${2:-}" in
+      pip)
+        echo "ERROR: \`$cmd -m pip\` is not supported. Use:" >&2
+        echo "  uv add <package>       # add a dependency" >&2
+        echo "  uv remove <package>    # remove a dependency" >&2
+        ;;
+      *)
+        echo "ERROR: Use \`uv run $cmd -m ${2:-<module>}\` instead of \`$cmd -m ${2:-<module>}\`" >&2
+        ;;
+    esac
+    ;;
+  *)
+    echo "ERROR: Use \`uv run $cmd ${*:-}\` instead of \`$cmd ${*:-}\`" >&2
+    ;;
+esac
+
+exit 1

coodie-1.0.0/.github/hooks/shims/python-shim.bats

@@ -0,0 +1,53 @@
+#!/usr/bin/env bats
+# Tests for python/python3 PATH shim
+
+SHIM="${BATS_TEST_DIRNAME}/python"
+
+@test "exits non-zero for bare python" {
+  run "$SHIM"
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv run python"* ]]
+}
+
+@test "exits non-zero for python script.py" {
+  run "$SHIM" script.py
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv run python script.py"* ]]
+}
+
+@test "exits non-zero for python -c" {
+  run "$SHIM" -c 'print(1)'
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv run python"* ]]
+}
+
+@test "exits non-zero for python -m pytest" {
+  run "$SHIM" -m pytest
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv run python -m pytest"* ]]
+}
+
+@test "exits non-zero for python -m pip install" {
+  run "$SHIM" -m pip install requests
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv add"* ]]
+  [[ "$output" == *"uv remove"* ]]
+}
+
+@test "suggests uv run python -m <module> for arbitrary modules" {
+  run "$SHIM" -m http.server
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv run python -m http.server"* ]]
+}
+
+@test "works when invoked as python3 via symlink" {
+  run "${BATS_TEST_DIRNAME}/python3"
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv run python3"* ]]
+}
+
+@test "python3 -m pip suggests uv add" {
+  run "${BATS_TEST_DIRNAME}/python3" -m pip install foo
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv add"* ]]
+}

coodie-1.0.0/.github/hooks/shims/python3

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# PATH shim for python/python3 — intercepts bare invocations and
+# suggests the uv equivalent.  Works for both names via $0.
+cmd="$(basename "$0")"
+
+case "${1:-}" in
+  -m)
+    case "${2:-}" in
+      pip)
+        echo "ERROR: \`$cmd -m pip\` is not supported. Use:" >&2
+        echo "  uv add <package>       # add a dependency" >&2
+        echo "  uv remove <package>    # remove a dependency" >&2
+        ;;
+      *)
+        echo "ERROR: Use \`uv run $cmd -m ${2:-<module>}\` instead of \`$cmd -m ${2:-<module>}\`" >&2
+        ;;
+    esac
+    ;;
+  *)
+    echo "ERROR: Use \`uv run $cmd ${*:-}\` instead of \`$cmd ${*:-}\`" >&2
+    ;;
+esac
+
+exit 1

coodie-1.0.0/.github/hooks/shims/uv

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# PATH shim for uv — intercepts `uv pip` (legacy interface) and passes
+# everything else through to the real uv binary.
+
+if [[ "${1:-}" == "pip" ]]; then
+  echo "ERROR: \`uv pip\` is the legacy interface. Use instead:" >&2
+  echo "  uv add <package>       # instead of uv pip install" >&2
+  echo "  uv remove <package>    # instead of uv pip uninstall" >&2
+  echo "  uv sync                # instead of uv pip sync" >&2
+  exit 1
+fi
+
+# Find the real uv by skipping this shim's directory in PATH
+shim_dir="$(cd "$(dirname "$0")" && pwd)"
+IFS=: read -ra path_entries <<<"${PATH:-}"
+for dir in "${path_entries[@]}"; do
+  resolved="$(cd "$dir" 2>/dev/null && pwd)" || continue
+  [[ "$resolved" == "$shim_dir" ]] && continue
+  if [[ -x "$dir/uv" ]]; then
+    exec "$dir/uv" "$@"
+  fi
+done
+
+echo "ERROR: real uv binary not found on PATH" >&2
+exit 127

coodie-1.0.0/.github/hooks/shims/uv-shim.bats

@@ -0,0 +1,47 @@
+#!/usr/bin/env bats
+# Tests for uv PATH shim
+# Requires: nix shell nixpkgs#uv -c bats ...
+
+SHIM="${BATS_TEST_DIRNAME}/uv"
+
+setup() {
+  command -v uv &>/dev/null || skip "uv not available — run via: nix shell nixpkgs#uv -c bats ..."
+}
+
+@test "exits non-zero for uv pip install" {
+  run "$SHIM" pip install requests
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv add"* ]]
+}
+
+@test "exits non-zero for uv pip sync" {
+  run "$SHIM" pip sync
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv sync"* ]]
+}
+
+@test "exits non-zero for uv pip freeze" {
+  run "$SHIM" pip freeze
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"legacy"* ]]
+}
+
+@test "suggests uv remove for uv pip uninstall" {
+  run "$SHIM" pip uninstall foo
+  [[ $status -ne 0 ]]
+  [[ "$output" == *"uv remove"* ]]
+}
+
+@test "passes through to real uv for non-pip subcommands" {
+  run "$SHIM" --version
+  [[ $status -eq 0 ]]
+  [[ "$output" == *"uv"* ]]
+}
+
+@test "exits 127 with error when real uv is not found" {
+  # Include /usr/bin for coreutils but exclude dirs with a real uv
+  local path_no_uv="${BATS_TEST_DIRNAME}:/usr/bin:/bin"
+  run env PATH="$path_no_uv" "$SHIM" --version
+  [[ $status -eq 127 ]]
+  [[ "$output" == *"real uv binary not found"* ]]
+}