tempest-cli 0.1.0__tar.gz

tempest_cli-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,40 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches:
+      - main
+      - "feat/**"
+      - "fix/**"
+      - "ref/**"
+
+permissions:
+  contents: read
+
+jobs:
+  python:
+    name: Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install project
+        run: uv sync --all-extras
+
+      # The gate runs itself: a break in the runners fails here first.
+      - name: Quality gate (dogfooded)
+        run: uv run tempest-cli check

tempest_cli-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,63 @@
+name: Deploy docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - "README.md"
+      - "CHANGELOG.md"
+      - "tempest_cli/**"
+      - ".github/workflows/docs.yml"
+      - "pyproject.toml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build site
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install docs dependencies
+        run: uv sync --group docs
+
+      - name: Build site
+        run: uv run mkdocs build --strict --site-dir site
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

tempest_cli-0.1.0/.github/workflows/release-pypi.yml

@@ -0,0 +1,135 @@
+name: Release to PyPI
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Verify tag matches project version
+        run: |
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          PYPROJECT_VERSION=$(python -c "import tomllib; print(tomllib.loads(open('pyproject.toml','rb').read().decode())['project']['version'])")
+          PACKAGE_VERSION=$(python -c "import re; print(re.search(r'__version__:\s*str\s*=\s*\"([^\"]+)\"', open('tempest_cli/__init__.py').read()).group(1))")
+          echo "Tag:         $TAG_VERSION"
+          echo "pyproject:   $PYPROJECT_VERSION"
+          echo "__version__: $PACKAGE_VERSION"
+          if [ "$TAG_VERSION" != "$PYPROJECT_VERSION" ] || [ "$TAG_VERSION" != "$PACKAGE_VERSION" ]; then
+            echo "Version mismatch — bump pyproject.toml AND tempest_cli/__init__.py to match the tag before retagging."
+            exit 1
+          fi
+
+      - name: Install project
+        run: uv sync --all-extras
+
+      - name: Quality gate (dogfooded)
+        run: uv run tempest-cli check
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      - name: Verify metadata
+        run: |
+          uv tool install twine
+          uv tool run twine check dist/*
+
+      - name: Verify wheel carries the package and the PR templates
+        run: |
+          python -c "import zipfile, glob; \
+            wheel = glob.glob('dist/*.whl')[0]; \
+            members = zipfile.ZipFile(wheel).namelist(); \
+            py_files = [n for n in members if n.startswith('tempest_cli/') and n.endswith('.py')]; \
+            templates = [n for n in members if n.endswith('.md') and '_templates' in n]; \
+            print('Python files:', len(py_files), '| PR templates:', len(templates)); \
+            assert len(py_files) >= 5, f'wheel suspiciously empty ({len(py_files)} files)'; \
+            assert len(templates) == 2, 'bundled PR templates missing from wheel'; \
+            print('OK')"
+
+      - name: Smoke-install built wheel in a clean venv
+        run: |
+          uv venv --python 3.11 /tmp/smoke-venv
+          uv pip install --python /tmp/smoke-venv/bin/python --quiet "$(ls dist/*.whl)"
+          /tmp/smoke-venv/bin/python -c "import sys, tempest_cli as m; \
+            assert m.__version__, 'no __version__'; \
+            assert m.run_full_check and m.load_tempest_config and m.generate_pr_prompt, 'surface missing'; \
+            heavy = {'fastapi', 'sqlalchemy', 'alembic', 'starlette', 'pydantic'}; \
+            import tempest_cli.main; \
+            loaded = {name.split('.')[0] for name in sys.modules}; \
+            assert not (heavy & loaded), f'pulled a web framework: {sorted(heavy & loaded)}'; \
+            print('Smoke OK · version =', m.__version__)"
+          /tmp/smoke-venv/bin/tempest-cli --version
+
+      - name: Upload distributions artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/tempest-cli
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distributions artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: python-dist
+          path: dist
+
+      - name: Publish to PyPI (Trusted Publishing)
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github_release:
+    name: GitHub Release
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Create GitHub Release from the CHANGELOG section
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          python - "$VERSION" > notes.md <<'PY'
+          import re, sys
+          version = sys.argv[1]
+          changelog = open("CHANGELOG.md").read()
+          match = re.search(
+              r"## \[" + re.escape(version) + r"\][^\n]*\n(.*?)(?=\n## \[|\Z)",
+              changelog,
+              re.DOTALL,
+          )
+          print(match.group(1).strip() if match else "See CHANGELOG.md.")
+          PY
+          if gh release view "$GITHUB_REF_NAME" >/dev/null 2>&1; then
+            gh release edit "$GITHUB_REF_NAME" --notes-file notes.md --latest
+          else
+            gh release create "$GITHUB_REF_NAME" \
+              --title "$GITHUB_REF_NAME" --notes-file notes.md --verify-tag --latest
+          fi

tempest_cli-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+site/

tempest_cli-0.1.0/CHANGELOG.md

@@ -0,0 +1,53 @@
+# Changelog
+
+All notable changes to **tempest-cli** are listed below.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] — 2026-08-15
+
+First release. Extracted from
+[`tempest-fastapi-sdk`](https://github.com/mauriciobenjamin700/tempest-fastapi-sdk),
+where the same gate shipped as `tempest check` — reachable only by
+installing a FastAPI SDK.
+
+### Added
+
+- **The quality gate**: `lint`, `fix`, `format`, `fmt-check`, `type`,
+  `test` and `check`, over `ruff` / `mypy` / `pytest`. Each returns the
+  underlying tool's exit code; `check` runs the four in order and stops
+  at the first failure.
+
+- **Typing strictness as configuration**, read from `[tool.tempest]
+  typing_strictness` in `pyproject.toml` (`lenient` | `standard` |
+  `strict`, defaulting to `standard`), with a `--strictness` / `-s`
+  override per run. Levels only ever **add** flags on top of the
+  project's own `[tool.ruff]` / `[tool.mypy]`. `ANN401` is never enabled
+  at any level: `Any` is a legitimate annotation.
+
+- **`pr-prompt`** — builds the prompt that makes an AI write a branch's
+  pull-request description, carrying the repository's own PR template
+  (or a bundled PT-BR / EN-US default), the rules that stop a model from
+  returning the template unfilled, and the branch context read as
+  `base...head`.
+
+- **A library surface**: `run_full_check`, `run_ruff_check`,
+  `run_ruff_fix`, `run_ruff_format`, `run_mypy`, `run_pytest`,
+  `load_tempest_config`, `find_pyproject`, `generate_pr_prompt`.
+
+- **`register_commands(app)`** mounts the whole gate onto an existing
+  `typer.Typer`, so another CLI exposes these commands under its own
+  name without copying a body. `tempest-fastapi-sdk` uses exactly this,
+  which is what keeps `tempest check` and `tempest-cli check` identical.
+
+### Notes
+
+- The only runtime dependency is `typer`. `ruff`, `mypy` and `pytest`
+  are invoked from the active environment (or through `uv run` when they
+  are not on `PATH`), so the project pins the versions it wants. The
+  `[tools]` extra installs all three for whoever prefers that.
+- Measured against the SDK it came from: reaching these commands there
+  loaded 38.7 MB of dependencies and about 0.5 s of import time per
+  invocation — for four commands that touch none of it. A test in this
+  package asserts that importing it pulls no web framework.

tempest_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mauricio Benjamin
+
+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.

tempest_cli-0.1.0/Makefile

@@ -0,0 +1,57 @@
+.DEFAULT_GOAL := help
+PACKAGE := tempest_cli
+
+.PHONY: help install check lint fix fmt fmt-check type test docs docs-serve build smoke clean
+
+help: ## Show this help
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-12s\033[0m %s\n", $$1, $$2}'
+
+install: ## Sync every dependency group
+	uv sync --all-extras --group docs
+
+check: ## Run the gate on itself (lint + fmt-check + type + test)
+	uv run tempest-cli check
+
+lint: ## ruff check
+	uv run tempest-cli lint
+
+fix: ## Every ruff autofix, then format
+	uv run tempest-cli fix
+
+fmt: ## ruff format (writes)
+	uv run tempest-cli format
+
+fmt-check: ## ruff format --check
+	uv run tempest-cli fmt-check
+
+type: ## mypy
+	uv run tempest-cli type
+
+test: ## pytest
+	uv run tempest-cli test
+
+docs: ## Build the bilingual site (strict)
+	uv run --group docs mkdocs build --strict
+
+docs-serve: ## Serve the docs locally
+	uv run --group docs mkdocs serve
+
+build: ## Build sdist + wheel
+	uv build
+
+smoke: ## Install the built wheel in a clean venv and import it
+	@rm -rf /tmp/$(PACKAGE)-smoke dist
+	uv build
+	uv venv --python 3.11 /tmp/$(PACKAGE)-smoke
+	uv pip install --python /tmp/$(PACKAGE)-smoke/bin/python --quiet "$$(ls dist/*.whl)"
+	/tmp/$(PACKAGE)-smoke/bin/python -c "import sys, tempest_cli as m, tempest_cli.main; \
+		assert m.__version__, 'no __version__'; \
+		heavy = {'fastapi', 'sqlalchemy', 'alembic', 'starlette', 'pydantic'}; \
+		loaded = {name.split('.')[0] for name in sys.modules}; \
+		assert not (heavy & loaded), f'pulled a web framework: {sorted(heavy & loaded)}'; \
+		print('Smoke OK · version =', m.__version__)"
+	/tmp/$(PACKAGE)-smoke/bin/tempest-cli --version
+	@rm -rf /tmp/$(PACKAGE)-smoke
+
+clean: ## Remove build and cache artifacts
+	rm -rf dist build site .pytest_cache .mypy_cache .ruff_cache htmlcov .coverage

tempest_cli-0.1.0/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.5
+Name: tempest-cli
+Version: 0.1.0
+Summary: Framework-agnostic quality gate for Python projects: ruff + mypy + pytest behind one command, with a typing-strictness dial and a PR-description prompt generator.
+Project-URL: Homepage, https://github.com/mauriciobenjamin700/tempest-cli
+Project-URL: Repository, https://github.com/mauriciobenjamin700/tempest-cli
+Project-URL: Issues, https://github.com/mauriciobenjamin700/tempest-cli/issues
+Project-URL: Documentation, https://mauriciobenjamin700.github.io/tempest-cli/
+Author-email: Mauricio Benjamin <mauricio.benjamin@reloverelations.com>
+License: MIT
+License-File: LICENSE
+Keywords: cli,lint,mypy,pytest,quality,ruff,typing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: typer>=0.12.0
+Provides-Extra: tools
+Requires-Dist: mypy>=1.13.0; extra == 'tools'
+Requires-Dist: pytest>=8.3.3; extra == 'tools'
+Requires-Dist: ruff>=0.8.0; extra == 'tools'
+Description-Content-Type: text/markdown
+
+# tempest-cli
+
+[![PyPI](https://img.shields.io/pypi/v/tempest-cli.svg)](https://pypi.org/project/tempest-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/tempest-cli.svg)](https://pypi.org/project/tempest-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**Documentação: [Português (BR)](https://mauriciobenjamin700.github.io/tempest-cli/) · [English (US)](https://mauriciobenjamin700.github.io/tempest-cli/en/)**
+
+One command for the quality gate of any Python project — `ruff` +
+`mypy` + `pytest`, with a typing-strictness dial that lives in your
+`pyproject.toml` instead of in four different Makefile targets.
+
+Framework-agnostic on purpose: Django, Flask, Litestar, FastAPI, a
+library, a script. The only runtime dependency is `typer`.
+
+```bash
+uv add --dev tempest-cli
+
+tempest-cli check          # lint + fmt-check + type + test, in order, stops at the first failure
+tempest-cli fix            # every ruff autofix, then format
+tempest-cli type -s strict # override the configured strictness for one run
+```
+
+## Why it exists
+
+The four commands are always the same, and every project rewrites them
+slightly differently — a Makefile here, a `tox.ini` there, a CI job that
+drifts from what runs locally. `tempest-cli check` is the same gate on
+your machine and in CI, and `--strictness` makes "how much typing do we
+enforce" a value in `pyproject.toml` rather than a flag someone
+remembered to pass.
+
+## Commands
+
+| Command | Runs |
+| --- | --- |
+| `tempest-cli lint` | `ruff check` |
+| `tempest-cli fix` | `ruff check --fix` then `ruff format` (`--unsafe` for the risky autofixes) |
+| `tempest-cli format` | `ruff format` (writes) |
+| `tempest-cli fmt-check` | `ruff format --check` (read-only) |
+| `tempest-cli type` | `mypy` |
+| `tempest-cli test` | `pytest` |
+| `tempest-cli check` | all four, in order, stopping at the first failure |
+| `tempest-cli pr-prompt` | builds the prompt that makes an AI write this branch's PR description |
+
+Every command takes an optional path (`tempest-cli lint src/`) and
+returns the underlying tool's exit code, so CI reads it exactly as it
+would read `ruff` directly.
+
+## Typing strictness
+
+```toml
+[tool.tempest]
+typing_strictness = "strict"   # lenient | standard | strict
+```
+
+The level **adds** flags on top of your own `[tool.ruff]` /
+`[tool.mypy]` — it never relaxes what you already configured:
+
+| Level | ruff (extra `ANN` rules) | mypy |
+| --- | --- | --- |
+| `lenient` | none | none |
+| `standard` | `ANN001`, `ANN201`, `ANN202`, `ANN205`, `ANN206` | `--disallow-untyped-defs --disallow-incomplete-defs` |
+| `strict` | the above plus `ANN204` | `--strict` |
+
+`ANN401` is never enabled at any level: `Any` is a legitimate
+annotation. The levels enforce that things *are* annotated, never that
+they avoid `Any`.
+
+Override per run with `--strictness` / `-s`. Absent config means
+`standard`.
+
+## PR descriptions from the branch itself
+
+```bash
+tempest-cli pr-prompt | claude -p
+tempest-cli pr-prompt develop --lang en --out pr_prompt.txt
+```
+
+The prompt carries the repository's own pull-request template (or a
+bundled PT-BR / EN-US default), the rules that stop a model from handing
+back the template with its placeholders intact, and the branch context:
+commit subjects, changed files, and a bounded excerpt of each patch.
+
+Diffs are read as `base...head` — the merge-base diff the forge shows —
+so commits that landed on the base after the branch started are not
+attributed to it. Whatever the bounds leave out is stated inside the
+prompt, so a partial diff reads as partial.
+
+## Use it as a library
+
+```python
+from tempest_cli import load_tempest_config, run_full_check
+
+config = load_tempest_config()
+exit_code = run_full_check(".", config=config)
+```
+
+And to expose the same gate from your own CLI, without copying command
+bodies:
+
+```python
+import typer
+
+from tempest_cli.main import register_commands
+
+cli: typer.Typer = typer.Typer(name="mytool")
+register_commands(cli)
+```
+
+## Installing the tools
+
+`tempest-cli` shells out to whatever `ruff`, `mypy` and `pytest` it
+finds — it does not pin them, so your project chooses the versions. To
+install them alongside it:
+
+```bash
+uv add --dev "tempest-cli[tools]"
+```
+
+## Relationship with tempest-fastapi-sdk
+
+This package was extracted from
+[`tempest-fastapi-sdk`](https://github.com/mauriciobenjamin700/tempest-fastapi-sdk),
+where the same gate shipped as `tempest check`. Getting it meant
+installing FastAPI, SQLAlchemy, Alembic and Pydantic — 38.7 MB of
+dependencies and roughly 0.5 s of import time per invocation, for four
+commands that never touch any of it.
+
+`tempest check` keeps working: the SDK depends on this package and
+registers the same commands. Both stay in sync because there is now one
+implementation.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

tempest_cli-0.1.0/README.md

@@ -0,0 +1,136 @@
+# tempest-cli
+
+[![PyPI](https://img.shields.io/pypi/v/tempest-cli.svg)](https://pypi.org/project/tempest-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/tempest-cli.svg)](https://pypi.org/project/tempest-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**Documentação: [Português (BR)](https://mauriciobenjamin700.github.io/tempest-cli/) · [English (US)](https://mauriciobenjamin700.github.io/tempest-cli/en/)**
+
+One command for the quality gate of any Python project — `ruff` +
+`mypy` + `pytest`, with a typing-strictness dial that lives in your
+`pyproject.toml` instead of in four different Makefile targets.
+
+Framework-agnostic on purpose: Django, Flask, Litestar, FastAPI, a
+library, a script. The only runtime dependency is `typer`.
+
+```bash
+uv add --dev tempest-cli
+
+tempest-cli check          # lint + fmt-check + type + test, in order, stops at the first failure
+tempest-cli fix            # every ruff autofix, then format
+tempest-cli type -s strict # override the configured strictness for one run
+```
+
+## Why it exists
+
+The four commands are always the same, and every project rewrites them
+slightly differently — a Makefile here, a `tox.ini` there, a CI job that
+drifts from what runs locally. `tempest-cli check` is the same gate on
+your machine and in CI, and `--strictness` makes "how much typing do we
+enforce" a value in `pyproject.toml` rather than a flag someone
+remembered to pass.
+
+## Commands
+
+| Command | Runs |
+| --- | --- |
+| `tempest-cli lint` | `ruff check` |
+| `tempest-cli fix` | `ruff check --fix` then `ruff format` (`--unsafe` for the risky autofixes) |
+| `tempest-cli format` | `ruff format` (writes) |
+| `tempest-cli fmt-check` | `ruff format --check` (read-only) |
+| `tempest-cli type` | `mypy` |
+| `tempest-cli test` | `pytest` |
+| `tempest-cli check` | all four, in order, stopping at the first failure |
+| `tempest-cli pr-prompt` | builds the prompt that makes an AI write this branch's PR description |
+
+Every command takes an optional path (`tempest-cli lint src/`) and
+returns the underlying tool's exit code, so CI reads it exactly as it
+would read `ruff` directly.
+
+## Typing strictness
+
+```toml
+[tool.tempest]
+typing_strictness = "strict"   # lenient | standard | strict
+```
+
+The level **adds** flags on top of your own `[tool.ruff]` /
+`[tool.mypy]` — it never relaxes what you already configured:
+
+| Level | ruff (extra `ANN` rules) | mypy |
+| --- | --- | --- |
+| `lenient` | none | none |
+| `standard` | `ANN001`, `ANN201`, `ANN202`, `ANN205`, `ANN206` | `--disallow-untyped-defs --disallow-incomplete-defs` |
+| `strict` | the above plus `ANN204` | `--strict` |
+
+`ANN401` is never enabled at any level: `Any` is a legitimate
+annotation. The levels enforce that things *are* annotated, never that
+they avoid `Any`.
+
+Override per run with `--strictness` / `-s`. Absent config means
+`standard`.
+
+## PR descriptions from the branch itself
+
+```bash
+tempest-cli pr-prompt | claude -p
+tempest-cli pr-prompt develop --lang en --out pr_prompt.txt
+```
+
+The prompt carries the repository's own pull-request template (or a
+bundled PT-BR / EN-US default), the rules that stop a model from handing
+back the template with its placeholders intact, and the branch context:
+commit subjects, changed files, and a bounded excerpt of each patch.
+
+Diffs are read as `base...head` — the merge-base diff the forge shows —
+so commits that landed on the base after the branch started are not
+attributed to it. Whatever the bounds leave out is stated inside the
+prompt, so a partial diff reads as partial.
+
+## Use it as a library
+
+```python
+from tempest_cli import load_tempest_config, run_full_check
+
+config = load_tempest_config()
+exit_code = run_full_check(".", config=config)
+```
+
+And to expose the same gate from your own CLI, without copying command
+bodies:
+
+```python
+import typer
+
+from tempest_cli.main import register_commands
+
+cli: typer.Typer = typer.Typer(name="mytool")
+register_commands(cli)
+```
+
+## Installing the tools
+
+`tempest-cli` shells out to whatever `ruff`, `mypy` and `pytest` it
+finds — it does not pin them, so your project chooses the versions. To
+install them alongside it:
+
+```bash
+uv add --dev "tempest-cli[tools]"
+```
+
+## Relationship with tempest-fastapi-sdk
+
+This package was extracted from
+[`tempest-fastapi-sdk`](https://github.com/mauriciobenjamin700/tempest-fastapi-sdk),
+where the same gate shipped as `tempest check`. Getting it meant
+installing FastAPI, SQLAlchemy, Alembic and Pydantic — 38.7 MB of
+dependencies and roughly 0.5 s of import time per invocation, for four
+commands that never touch any of it.
+
+`tempest check` keeps working: the SDK depends on this package and
+registers the same commands. Both stay in sync because there is now one
+implementation.
+
+## License
+
+MIT — see [LICENSE](LICENSE).