refactor: migrate to modern Python project structure with uv

.github/ISSUE_TEMPLATE/ai-task.yml

@@ -0,0 +1,53 @@
+name: AI Task
+description: Define a task for AI agent execution
+labels: [ai-task]
+body:
+  - type: dropdown
+    id: task-type
+    attributes:
+      label: Task Type
+      options:
+        - feature
+        - bugfix
+        - refactor
+        - documentation
+        - test
+        - maintenance
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What needs to be done and why
+    validations:
+      required: true
+  - type: textarea
+    id: criteria
+    attributes:
+      label: Acceptance Criteria
+      description: Checkboxes of what 'done' looks like
+    validations:
+      required: true
+  - type: textarea
+    id: files
+    attributes:
+      label: Files Likely Involved
+    validations:
+      required: false
+  - type: dropdown
+    id: scope
+    attributes:
+      label: Scope Assessment
+      options:
+        - small (1-2 files)
+        - medium (3-5 files)
+        - large (6+ files)
+    validations:
+      required: true
+  - type: textarea
+    id: out-of-scope
+    attributes:
+      label: Explicitly Out of Scope
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,35 @@
+name: Bug Report
+description: Report a bug
+labels: [bug]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      placeholder: "Python 3.12, Ubuntu 22.04"
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,2 @@
+blank_issues_enabled: true
+contact_links: []

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -0,0 +1,29 @@
+name: Feature Request
+description: Suggest a new feature
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this solve?
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+    validations:
+      required: false
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+    validations:
+      required: false

.github/pull_request_template.md

@@ -0,0 +1,68 @@
+## Summary
+
+<!-- 2-3 sentences describing the changes -->
+
+## Linked Issue (Optional)
+
+Closes #
+
+## Type of Change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Refactor
+- [ ] Documentation
+- [ ] Test
+- [ ] CI/CD
+- [ ] Other
+
+## What Changed
+
+<!-- List specific file-level changes -->
+
+## Verification Performed
+
+### Lint
+```
+<output of uv run ruff check src/ tests/ >
+```
+
+### Type Check
+```
+<output of uv run mypy src/ >
+```
+
+### Tests
+```
+<output of uv run pytest>
+```
+
+## Self-Review Checklist
+
+- [ ] Code follows project style (ruff passes)
+- [ ] Types are correct (mypy passes)
+- [ ] Tests pass and cover new behavior
+- [ ] No secrets or credentials in code
+- [ ] No unnecessary dependencies added
+- [ ] Documentation updated if needed
+- [ ] Changes are within the scope of the linked issue
+
+## Agent Metadata
+
+```yaml
+agent:
+model:
+exec_plan:
+files_changed:
+```
+
+## Risks & Considerations
+
+<!-- Known risks, trade-offs, areas needing extra review -->
+
+## Human Reviewer Checklist
+
+- [ ] Intent matches the issue/plan
+- [ ] No scope creep beyond the plan
+- [ ] Architecture decisions are sound
+- [ ] Edge cases considered

.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: .python-version
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Lint
+        run: uv run ruff check src/ tests/
+
+      - name: Format check
+        run: uv run ruff format --check src/ tests/
+
+      - name: Type check
+        run: uv run mypy src/
+
+      - name: Test
+        run: uv run pytest