AGENTS.md

## Agent skills

### Issue tracker

Issues are tracked in this repository on Gitea using a GitHub-style issue workflow. See docs/agents/issue-tracker.md.

### Triage labels

Triage uses default labels: needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix. See docs/agents/triage-labels.md.

### Domain docs

Domain docs use a single-context layout at repo root. See docs/agents/domain.md.
Backend runtime upgraded to Python 3.14 with exact dependency pinning (#57) Signed-off-by: Cliff Hill <xlorep@darkhelm.org> ## Summary Upgrades backend runtime baseline and dependency management for issue #10. ### Changes 1. Python Baseline: Updated from 3.13 to 3.14 - Updated `backend/pyproject.toml` requires-python constraint - Updated `backend/pyrightconfig.json` pythonVersion - Updated all Dockerfile and CI references 2. Dependency Pinning: Switched to exact version pins in `backend/pyproject.toml` - All dev and runtime dependencies now use `==` instead of `>=` - `fastapi==0.120.2`, `uvicorn==0.38.0` - ruff, pyright, pytest suite pinned to current resolved versions - Regenerated `backend/uv.lock` under Python 3.14 3. Startup Compatibility Guard (TDD via RED→GREEN) - New `compatibility_status()` function evaluates runtime and pinned deps - Startup raises `RuntimeError` if policy fails - Implemented via FastAPI lifespan (non-deprecated) handler 4. Compatibility Status Endpoint - New `GET /compatibility` returns policy status, runtime version, and package checks - Shares single source of truth with startup validation 5. Integration Tests - Added failing-then-passing tests for startup guard and endpoint behavior - 100% coverage maintained 6. Direnv Configuration - Added `UV_PYTHON="3.14"` pin to repo `.envrc` - Ensures direnv creates/recreates venv with correct Python version ### Validation - ✅ ruff format/check - ✅ pyright strict (0 errors) - ✅ pytest: 8 passed, 100% coverage (>=95 gate) - ✅ pydoclint: pass - ✅ xdoctest: pass ### Notes - SQLAlchemy/SQLModel introduction deferred to next pass per scope - Compatibility logic currently validates fastapi/uvicorn pins (runtime deps) - Ready for container build validation and Renovate bot testing Co-authored-by: copilotcoder <copilotcoder@darkhelm.org> Reviewed-on: https://dogar.darkhelm.org/DarkHelm.org/plex-playlist/pulls/57 Co-authored-by: Cliff Hill <xlorep@darkhelm.org> Co-committed-by: Cliff Hill <xlorep@darkhelm.org> 2026-06-18 11:19:24 -04:00			`## Agent skills`

			`### Issue tracker`

			`Issues are tracked in this repository on Gitea using a GitHub-style issue workflow. See docs/agents/issue-tracker.md.`

			`### Triage labels`

			`Triage uses default labels: needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix. See docs/agents/triage-labels.md.`

			`### Domain docs`

			`Domain docs use a single-context layout at repo root. See docs/agents/domain.md.`