Project name must match PyPi

.bumpversion.cfg

@@ -0,0 +1,5 @@
+[bumpversion]
+current_version = 1.0.0
+parse = (?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)
+serialize =
+	{major}.{minor}.{patch}

.cursor/BUGBOT.md

@@ -0,0 +1,10 @@
+# Bugbot Review Rules
+
+## Core Principle: Comprehensive First-Pass Reviews
+
+**CRITICAL INSTRUCTION**: You must perform a complete, exhaustive analysis on the FIRST review of any changeset. Do NOT hold back observations or defer issues to later reviews. All feedback must be provided upfront.
+
+## Expected Behavior
+
+Your first review should be comprehensive enough that subsequent reviews only need to address newly changed code. The goal is to eliminate "surprise" feedback on code that was part of the initial changeset but somehow escaped earlier review.
+

.github/dependabot.yml

@@ -1,9 +1,11 @@
 version: 2
 updates:
-- package-ecosystem: pip
- directory: "/"
- schedule:
- interval: daily
- open-pull-requests-limit: 10
- reviewers:
- - heitorsampaio
+ - package-ecosystem: github-actions
+ directory: "/"
+ schedule:
+ interval: weekly
+
+ - package-ecosystem: pip
+ directory: "/"
+ schedule:
+ interval: weekly

.github/workflows/build.yml

@@ -0,0 +1,34 @@
+name: Build
+
+on:
+ push:
+ branches:
+ - main
+ pull_request:
+ workflow_dispatch:
+
+permissions:
+ contents: read
+
+jobs:
+ package:
+ name: Build distribution
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v7
+ with:
+ fetch-depth: 0
+ - name: Set up Python
+ uses: actions/setup-python@v6
+ with:
+ python-version: "3.14"
+ cache: pip
+ cache-dependency-path: pyproject.toml
+ - name: Install build tools
+ run: |
+ python -m pip install --upgrade pip
+ python -m pip install -e ".[dev]"
+ - name: Build and verify package
+ run: |
+ python -m build
+ python -m twine check dist/*

.github/workflows/lint.yml

@@ -0,0 +1,35 @@
+name: Lint
+
+on:
+ push:
+ branches:
+ - main
+ pull_request:
+ workflow_dispatch:
+
+permissions:
+ contents: read
+
+jobs:
+ lint:
+ name: Lint
+
+ runs-on: ubuntu-latest
+
+ steps:
+ - uses: actions/checkout@v7
+ with:
+ fetch-depth: 0
+
+ - uses: actions/setup-python@v6
+ with:
+ python-version: "3.14"
+ cache: 'pip'
+ cache-dependency-path: pyproject.toml
+
+ - name: Install dependencies
+ run: |
+ python -m pip install --upgrade pip
+ python -m pip install -e ".[dev]"
+ - name: Run lint
+ run: make lint-ci

.github/workflows/publish.yml

@@ -0,0 +1,37 @@
+name: Publish to PyPI
+
+on:
+ release:
+ types: [published]
+
+permissions:
+ contents: read
+ id-token: write
+
+jobs:
+ publish:
+ name: Build and publish
+ runs-on: ubuntu-latest
+ environment: pypi
+ steps:
+ - uses: actions/checkout@v7
+ with:
+ fetch-depth: 0
+
+ - name: Set up Python
+ uses: actions/setup-python@v6
+ with:
+ python-version: "3.14"
+ cache: pip
+ cache-dependency-path: pyproject.toml
+
+ - name: Install build tools
+ run: |
+ python -m pip install --upgrade pip
+ python -m pip install build
+
+ - name: Build package
+ run: python -m build
+
+ - name: Publish to PyPI
+ uses: pypa/gh-action-pypi-publish@release/v1

.github/workflows/test.yml

@@ -0,0 +1,40 @@
+name: Test
+
+on:
+ push:
+ branches:
+ - main
+ pull_request:
+ workflow_dispatch:
+
+permissions:
+ contents: read
+
+jobs:
+ test:
+ name: Test Python ${{ matrix.python-version }}
+
+ runs-on: ubuntu-latest
+
+ strategy:
+ fail-fast: false
+ matrix:
+ python-version: [ "3.9", "3.10", "3.11", "3.12", "3.13", "3.14" ]
+
+ steps:
+ - uses: actions/checkout@v7
+ with:
+ fetch-depth: 0
+
+ - uses: actions/setup-python@v6
+ with:
+ python-version: ${{ matrix.python-version }}
+ cache: 'pip'
+ cache-dependency-path: pyproject.toml
+
+ - name: Install dependencies
+ run: |
+ python -m pip install --upgrade pip
+ python -m pip install -e .
+ - name: Run tests
+ run: make test

.gitignore

@@ -10,3 +10,5 @@ build
 .vscode/
 .idea/
 .python-version
+venv
+.venv

.mise.toml

@@ -0,0 +1,20 @@
+[env]
+MISE_FETCH_REMOTE_VERSIONS_TIMEOUT = "30s"
+
+_.python.venv = {
+ path = ".venv",
+ create = true,
+}
+
+[settings]
+python.uv_venv_auto = false
+python.venv_stdlib = true
+
+[tools]
+python = "3.11"
+
+[tasks.test]
+run = 'make install test'
+
+[tasks.lint]
+run = 'make install lint'