Cline rules

1---
2paths:
3  - "mcp-server/**/*.py"
4  - "mcp-server/pyproject.toml"
5  - "mcp-server/uv.lock"
6  - "scripts/**/*.py"
7---
8 
9# Zotero Python Rules
10 
11## Environment
12 
13- Use `uv` for Python package and command execution.
14- Prefer `uv run ...` from `mcp-server/` so commands use the correct dependency set.
15- Avoid ad-hoc global installs.
16 
17## Architecture Guardrails
18 
19- Keep `domain/` free of I/O and infrastructure imports.
20- Put Zotero HTTP access in `infrastructure/zotero_client/`.
21- Keep MCP tool registration and validation in `infrastructure/mcp/`.
22- Keep PubMed-specific mapping isolated in `infrastructure/mappers/pubmed_mapper.py` and bridge tools.
23 
24## Validation Gates
25 
26- Lint: `cd mcp-server && uv run ruff check .`
27- Types: `cd mcp-server && uv run mypy src --ignore-missing-imports`
28- Tests: `cd mcp-server && uv run pytest`
29 
30## Behavioral Rules
31 
32- Preserve duplicate detection by DOI, PMID, title, and Zotero item identity.
33- Keep collection writes explicit; do not silently import into arbitrary collections.
34- Return structured MCP responses that agents can parse without scraping prose.
35- Add focused tests for tool behavior changes, especially import, saved-search, and collection flows.
36