[codex] Harden compatibility docs and automation

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @aviadr1

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -30,8 +30,8 @@ body:
   - type: input
     id: python
     attributes:
-      label: Python version
-      placeholder: "3.12.11"
+      label: Python version and implementation
+      placeholder: "CPython 3.12.11"
     validations:
       required: true
   - type: input
@@ -41,6 +41,14 @@ body:
       placeholder: "Windows 11, Ubuntu 24.04, macOS 15"
     validations:
       required: true
+  - type: textarea
+    id: diagnostics
+    attributes:
+      label: Diagnostics
+      description: Paste the output of the diagnostic snippet from the README, if import succeeds.
+      render: text
+    validations:
+      required: false
   - type: textarea
     id: reproduction
     attributes:

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: uvloop issues
+    url: https://github.com/MagicStack/uvloop/issues
+    about: Report Linux, macOS, or POSIX backend bugs that reproduce with uvloop directly.
+  - name: winloop issues
+    url: https://github.com/Vizonex/Winloop/issues
+    about: Report Windows backend bugs that reproduce with winloop directly.

.github/dependabot.yml

@@ -7,6 +7,7 @@ updates:
       day: "monday"
       time: "08:00"
       timezone: "Asia/Jerusalem"
+    rebase-strategy: "auto"
     open-pull-requests-limit: 10
     groups:
       upstream-event-loops:
@@ -40,6 +41,7 @@ updates:
       day: "monday"
       time: "08:30"
       timezone: "Asia/Jerusalem"
+    rebase-strategy: "auto"
     open-pull-requests-limit: 5
     groups:
       github-actions:

.github/pull_request_template.md

@@ -2,9 +2,16 @@
 
 -
 
+## Compatibility
+
+- [ ] Wrapper behavior is covered with fake-backend tests where practical
+- [ ] Real-backend smoke behavior still works on the relevant platform
+- [ ] User-facing behavior or support guidance is reflected in docs/changelog
+
 ## Checks
 
 - [ ] `uv run ruff check .`
+- [ ] `uv run ruff format --check .`
 - [ ] `uv run pytest`
 - [ ] `uv build`
 - [ ] `uv run twine check dist/*`

.github/workflows/auto-release.yml

@@ -1,8 +1,10 @@
 name: Auto Release
 
 on:
-  push:
+  workflow_run:
+    workflows: ["CI"]
     branches: [main]
+    types: [completed]
   workflow_dispatch:
 
 permissions:
@@ -16,12 +18,14 @@ concurrency:
 jobs:
   tag:
     name: Tag new project version
+    if: github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success'
     runs-on: ubuntu-latest
     steps:
       - name: Check out repository
         uses: actions/checkout@v6
         with:
           fetch-depth: 0
+          ref: ${{ github.event.workflow_run.head_sha || github.ref }}
 
       - name: Read project version
         id: version

.github/workflows/ci.yml

@@ -5,11 +5,16 @@ on:
     branches: [main]
   pull_request:
     branches: [main]
+  merge_group:
   workflow_dispatch:
 
 permissions:
   contents: read
 
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   lint:
     name: Lint and lock
@@ -35,6 +40,12 @@ jobs:
       - name: Run ruff
         run: uv run ruff check .
 
+      - name: Check formatting
+        run: uv run ruff format --check .
+
+      - name: Compile package
+        run: uv run python -m compileall -q src tests
+
   test:
     name: Test ${{ matrix.os }} / Python ${{ matrix.python-version }}
     runs-on: ${{ matrix.os }}

.github/workflows/release.yml

@@ -9,9 +9,45 @@ on:
 permissions:
   contents: read
 
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
 jobs:
+  test:
+    name: Smoke test ${{ matrix.os }} / Python ${{ matrix.python-version }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            python-version: "3.12"
+          - os: macos-latest
+            python-version: "3.12"
+          - os: windows-latest
+            python-version: "3.12"
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --frozen
+
+      - name: Run tests
+        run: uv run pytest
+
   build:
     name: Build distributions
+    needs: test
     runs-on: ubuntu-latest
     steps:
       - name: Check out repository
@@ -28,9 +64,6 @@ jobs:
       - name: Install dependencies
         run: uv sync --frozen
 
-      - name: Run tests
-        run: uv run pytest
-
       - name: Build distributions
         run: uv build
 

CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to `winuvloop` are documented here.
 ## 0.2.2 - Unreleased
 
 - Add public API stubs for better editor and type-checker ergonomics.
+- Add `backend_version()` for support logs and diagnostics.
+- Improve missing-backend import errors with Python implementation context.
+- Expand README guidance for `uvloop`, `winloop`, and `winuvloop` selection.
+- Gate automatic release tagging on successful `main` CI runs.
+- Add release smoke tests on Linux, macOS, and Windows before publishing.
+- Add formatting and bytecode compilation checks to CI.
+- Add upstream issue routing links and stronger pull request guidance.
+- Include tests and maintenance docs in the source distribution.
 
 ## 0.2.1 - 2026-04-25
 

CONTRIBUTING.md

@@ -16,11 +16,16 @@ Before opening a pull request, run:
 
 ```bash
 uv run ruff check .
+uv run ruff format --check .
 uv run pytest
 uv build
 uv run twine check dist/*
 ```
 
+Pull requests are gated by the GitHub Actions CI workflow. CI checks the
+lockfile, linting, formatting, package build metadata, fake-backend unit tests,
+and real-backend smoke tests on Linux, macOS, and Windows.
+
 ## Version Policy
 
 `winuvloop` follows semantic versioning:
@@ -31,9 +36,10 @@ uv run twine check dist/*
 
 Releases are automatic after a version change lands on `main`. If
 `pyproject.toml` contains a version without a matching `vX.Y.Z` tag, GitHub
-Actions creates the tag and dispatches `release.yml`. The release workflow
-builds, validates, publishes to PyPI through trusted publishing or the
-`PYPI_API_TOKEN` fallback secret, and creates a GitHub Release.
+Actions creates the tag after CI has passed for `main` and dispatches
+`release.yml`. The release workflow builds, validates, publishes to PyPI
+through trusted publishing or the `PYPI_API_TOKEN` fallback secret, and creates
+a GitHub Release.
 
 ## Dependency Policy
 
@@ -44,10 +50,21 @@ can block users from receiving fixed wheels and security releases.
 Development dependencies are locked with `uv.lock` and updated by Dependabot.
 Dependabot pull requests are merged automatically after CI passes.
 
+Dependency updates should preserve the package's compatibility promise:
+
+- keep runtime dependencies aligned with the latest usable `uvloop` and
+  `winloop` releases
+- keep CI covering at least one oldest-supported CPython, one current CPython,
+  one pre-release/new CPython when available, and all three runner families
+- prefer improving diagnostics over adding fallback event-loop behavior that
+  differs from upstream
+
 ## Pull Request Guidelines
 
 - Keep changes focused.
 - Add tests for runtime behavior.
 - Update `README.md` or `CHANGELOG.md` when user-facing behavior changes.
 - Do not vendor code from `uvloop` or `winloop`; this package should remain a
   thin selector and compatibility wrapper.
+- When reporting backend bugs, first try to reproduce with `uvloop` or
+  `winloop` imported directly so the issue can be routed to the right project.