Merge pull request 'P12: uv hygiene — build-system, link-mode, version pins, auto-recovery' (#62) from feature/uv-hygiene into main

.gitignore

@@ -1,3 +1,6 @@
+# Virtual environment
+.venv/
+
 # Data directories (user data, not tracked)
 data/
 zotero/data/

.python-version

@@ -1 +1 @@
-cpython-3.13.12-linux-x86_64-gnu
+3.13

.woodpecker/ci.yml

@@ -13,9 +13,7 @@ steps:
       UV_LINK_MODE: copy
       UV_PROJECT_ENVIRONMENT: .venv
     commands:
-      - uv python pin 3.13.11
       - uv sync --dev
-      - uv pip install -e .
       - uv run ruff check src/ tests/ --output-format=concise
       - uv run ruff format --check src/ tests/
 

pyproject.toml

@@ -38,6 +38,10 @@ dev = [
     "altair>=6.0.0",
     "pandas>=3.0.1",
 ]
+[build-system]
+requires = ["uv_build>=0.7,<1"]
+build-backend = "uv_build"
+
 [tool.ruff]
 line-length = 88
 

uv.lock

@@ -2040,7 +2040,7 @@ wheels = [
 [[package]]
 name = "stack"
 version = "0.1.0"
-source = { virtual = "." }
+source = { editable = "." }
 dependencies = [
     { name = "databricks-cli" },
     { name = "databricks-sdk" },

uv.toml

@@ -0,0 +1,4 @@
+# Project-level uv configuration.
+# Prevents broken .venv symlinks when uv runs under different users.
+link-mode = "copy"
+python-preference = "managed"