chore: initial commit — fresh repo

Author: DiogoRibeiro7

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @diogoribeiro7

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,21 @@
+---
+name: Bug report
+about: Report a reproducible defect
+labels: bug
+---
+
+## Summary
+
+## Steps to reproduce
+
+## Expected behavior
+
+## Actual behavior
+
+## Environment
+
+- Python version:
+- OS:
+- Commit/branch:
+
+## Additional context

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Platform architecture discussion
+    url: https://example.com/architecture-discussion
+    about: Use this channel for platform-wide design discussions.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,15 @@
+---
+name: Feature request
+about: Propose an enhancement
+labels: enhancement
+---
+
+## Problem statement
+
+## Proposed solution
+
+## Analytics or observability impact
+
+## Contract or schema impact
+
+## Additional context

.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10

.github/pull_request_template.md

@@ -0,0 +1,18 @@
+## Summary
+
+## What changed
+
+## Why it changed
+
+## Validation
+
+- [ ] `make lint`
+- [ ] `make typecheck`
+- [ ] `make test`
+
+## Contract impact
+
+- [ ] No shared contract changes
+- [ ] Shared contract fields changed (describe below)
+
+## Notes

.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches: ["main", "master"]
+  pull_request:
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e .[dev]
+
+      - name: Lint
+        run: make lint
+
+      - name: Type check
+        run: make typecheck
+
+      - name: Test
+        run: make test

.gitignore

@@ -0,0 +1,30 @@
+__pycache__/
+*.py[cod]
+*$py.class
+
+.Python
+build/
+dist/
+*.egg-info/
+.eggs/
+
+.venv/
+venv/
+env/
+
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+.mypy_cache/
+.ruff_cache/
+
+.vscode/
+.idea/
+
+.DS_Store
+Thumbs.db
+
+*.local.yaml
+*.local.yml

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LLM Data Platform Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Makefile

@@ -0,0 +1,24 @@
+PYTHON ?= python
+
+.PHONY: install format lint typecheck test ci clean
+
+install:
+	$(PYTHON) -m pip install -U pip
+	$(PYTHON) -m pip install -e .[dev]
+
+format:
+	$(PYTHON) -m ruff format src tests
+
+lint:
+	$(PYTHON) -m ruff check src tests
+
+typecheck:
+	$(PYTHON) -m mypy src
+
+test:
+	$(PYTHON) -m pytest
+
+ci: lint typecheck test
+
+clean:
+	$(PYTHON) -c "import shutil, pathlib; [shutil.rmtree(p, ignore_errors=True) for p in ['.pytest_cache','.mypy_cache','.ruff_cache','htmlcov','build','dist']]; [p.unlink() for p in pathlib.Path('.').glob('.coverage*') if p.is_file()]"