Cline rules

1---
2paths:
3  - "pyproject.toml"
4  - "src/__init__.py"
5  - "uv.lock"
6  - "Dockerfile"
7  - "vscode-extension/package.json"
8  - "vscode-extension/package-lock.json"
9  - "CHANGELOG.md"
10  - ".github/workflows/release.yml"
11---
12 
13# Release Rules
14 
15## Version Sources (must stay in sync)
16- Python: `pyproject.toml`, `src/__init__.py`
17- Docker label: `Dockerfile`
18- VS Code extension: `vscode-extension/package.json` + `package-lock.json`
19- Lockfile: `uv.lock` (regenerate with `uv lock` when needed)
20- Changelog: `CHANGELOG.md` (add a dated section)
21 
22## Minimum Pre-Tag Verification
23- `uv run ruff check .`
24- `uv run ruff format --check .`
25- `uv run mypy src --ignore-missing-imports`
26- `uv run pytest`
27- `(cd vscode-extension && npm run test:ci)` (includes VSIX package-contents guard)
28- VSIX install smoke test (recommended; required in CI): `npm run test:install-smoke` (Linux activation: `xvfb-run -a npm run test:install-smoke -- --require-activation`)
29- Docker smoke import: `docker build ...` + `python -c "import src.presentation.server"`
30- `uv build`
31- `git diff --check`
32 
33## Tag Format
34- Annotated tags: `vX.Y.Z`
35- Push commit first, then push the tag.
36 
37Tip: use the workflow `/release-publish.md` in `.clinerules/workflows/` for a guided release.
38