dexpot 0.1.0__tar.gz

dexpot-0.1.0/.github/dependabot.yml

@@ -0,0 +1,39 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    commit-message:
+      prefix: "chore"
+      include: "scope"
+    labels:
+      - "dependencies"
+      - "skip-changelog"
+
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    commit-message:
+      prefix: "chore"
+      include: "scope"
+    labels:
+      - "dependencies"
+      - "skip-changelog"
+    groups:
+      dev-dependencies:
+        patterns:
+          - "pytest*"
+          - "ruff"
+          - "pyright"
+          - "pre-commit"
+          - "towncrier"
+          - "pyyaml"
+      runtime-dependencies:
+        patterns:
+          - "msgspec"
+          - "typer"
+          - "httpx"

dexpot-0.1.0/.github/labeler.yml

@@ -0,0 +1,33 @@
+ci:
+  - changed-files:
+      - any-glob-to-any-file:
+          - ".github/**/*"
+          - "Makefile"
+          - ".pre-commit-config.yaml"
+
+documentation:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "README.md"
+          - "CONTRIBUTING.md"
+          - "ROADMAP.md"
+          - "docs/**/*"
+
+source:
+  - changed-files:
+      - any-glob-to-any-file: "src/**/*"
+
+tests:
+  - changed-files:
+      - any-glob-to-any-file: "tests/**/*"
+
+dependencies:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "pyproject.toml"
+          - "uv.lock"
+          - ".github/dependabot.yml"
+
+examples:
+  - changed-files:
+      - any-glob-to-any-file: "examples/**/*"

dexpot-0.1.0/.github/workflows/changelog.yml

@@ -0,0 +1,41 @@
+name: Changelog
+
+on:
+  pull_request:
+    branches: [main]
+    types: [opened, synchronize, reopened, labeled, unlabeled]
+
+permissions:
+  contents: read
+  pull-requests: read # Required to inspect the pull request's changed files.
+
+concurrency:
+  group: changelog-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  changelog:
+    name: changelog
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    env:
+      GH_TOKEN: ${{ github.token }}
+      PR_NUMBER: ${{ github.event.pull_request.number }}
+      REPOSITORY: ${{ github.repository }}
+    steps:
+      - name: Skip non-user-facing changes
+        if: contains(github.event.pull_request.labels.*.name, 'skip-changelog')
+        run: echo "skip-changelog label present"
+      - name: Require this pull request's changelog fragment
+        if: ${{ !contains(github.event.pull_request.labels.*.name, 'skip-changelog') }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          pattern="^changelog\.d/${PR_NUMBER}\.(added|changed|deprecated|removed|fixed)\.md$"
+          if gh api "repos/${REPOSITORY}/pulls/${PR_NUMBER}/files" \
+            --paginate --jq '.[].filename' | grep -Eq "$pattern"; then
+            echo "changelog fragment found for PR #${PR_NUMBER}"
+            exit 0
+          fi
+          echo "::error::no changelog fragment for PR #${PR_NUMBER} — add changelog.d/${PR_NUMBER}.<type>.md or apply the skip-changelog label"
+          exit 1

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

@@ -0,0 +1,125 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_call:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: lint
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+      - run: uv sync --all-extras --locked
+      - run: uv run ruff check src/ tests/
+      - run: uv run ruff format --check src/ tests/
+
+  typecheck:
+    name: typecheck
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+      - run: uv sync --all-extras --locked
+      - run: uv run pyright src/ tests/
+
+  test:
+    name: test (${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13", "3.14", "3.14t"]
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: uv sync --all-extras --locked
+      - name: Verify interpreter mode
+        env:
+          EXPECTED_PYTHON: ${{ matrix.python-version }}
+        run: |
+          uv run python - <<'PY'
+          import os
+          import sys
+
+          expected = os.environ["EXPECTED_PYTHON"]
+          is_gil_enabled = getattr(sys, "_is_gil_enabled", lambda: True)()
+          print(sys.version)
+          print(f"gil_enabled={is_gil_enabled}")
+          if expected.endswith("t") and is_gil_enabled:
+              raise SystemExit("expected a free-threaded interpreter")
+          if not expected.endswith("t") and not is_gil_enabled:
+              raise SystemExit("expected a GIL-enabled interpreter")
+          PY
+      - run: >-
+          uv run pytest tests/ -v
+          --cov=src/dexpot
+          --cov-report=term-missing
+          --cov-fail-under=65
+
+  build:
+    name: build
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+      - run: uv build
+      - name: Verify distribution artifacts
+        run: |
+          python3 - <<'PY'
+          import glob
+          import tarfile
+          import zipfile
+
+          wheels = glob.glob("dist/*.whl")
+          sdists = glob.glob("dist/*.tar.gz")
+          assert len(wheels) == 1, f"expected one wheel, found {wheels}"
+          assert len(sdists) == 1, f"expected one sdist, found {sdists}"
+
+          with zipfile.ZipFile(wheels[0]) as archive:
+              names = archive.namelist()
+              for required in (
+                  "dexpot/__init__.py",
+                  "dexpot/templates/skills/dexpot.md",
+              ):
+                  assert required in names, f"{required} missing from wheel"
+
+          with tarfile.open(sdists[0]) as archive:
+              names = archive.getnames()
+              for suffix in (
+                  "/src/dexpot/__init__.py",
+                  "/README.md",
+                  "/ROADMAP.md",
+                  "/CONTRIBUTING.md",
+              ):
+                  assert any(name.endswith(suffix) for name in names), (
+                      f"{suffix} missing from sdist"
+                  )
+
+          print(f"verified {wheels[0]} and {sdists[0]}")
+          PY

dexpot-0.1.0/.github/workflows/labeler.yml

@@ -0,0 +1,26 @@
+name: Auto-label pull requests
+
+on:
+  pull_request_target:
+    types: [opened, synchronize, reopened, ready_for_review]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: labeler-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  label:
+    name: label
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      contents: read
+      pull-requests: write # Required to apply labels to pull requests.
+    steps:
+      - uses: actions/labeler@bf12e9b00b37c5c0ca2b87b79b2daf7891dbda13 # v7.0.0
+        with:
+          repo-token: ${{ github.token }}
+          sync-labels: true

dexpot-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,182 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  ci:
+    name: CI
+    uses: ./.github/workflows/ci.yml
+
+  verify-version:
+    name: verify version and changelog
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+          fetch-depth: 0
+      - name: Verify release commit is on main
+        run: |
+          if ! git merge-base --is-ancestor "$GITHUB_SHA" origin/main; then
+            echo "::error::release tags must point to a commit reachable from main"
+            exit 1
+          fi
+      - name: Verify tag, package version, and changelog
+        env:
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: |
+          python3 - <<'PY'
+          import os
+          import pathlib
+          import re
+          import sys
+          import tomllib
+
+          tag = os.environ["RELEASE_TAG"]
+          if not tag.startswith("v") or len(tag) == 1:
+              print(f"::error::release tag must be v<version>, got {tag!r}")
+              sys.exit(1)
+
+          version = tag[1:]
+          package_version = tomllib.loads(
+              pathlib.Path("pyproject.toml").read_text()
+          )["project"]["version"]
+          if version != package_version:
+              print(
+                  f"::error::tag {tag} does not match pyproject.toml version "
+                  f"{package_version} — run 'uv version {version}' on main first"
+              )
+              sys.exit(1)
+
+          changelog = pathlib.Path("CHANGELOG.md").read_text()
+          heading = re.compile(rf"^## \[{re.escape(version)}\](?:\s|$)", re.MULTILINE)
+          if heading.search(changelog) is None:
+              print(
+                  f"::error::CHANGELOG.md has no exact '## [{version}]' section — "
+                  "run 'make changelog' and commit it before tagging"
+              )
+              sys.exit(1)
+
+          print(f"{tag} matches pyproject.toml and CHANGELOG.md")
+          PY
+
+  build:
+    name: build release artifacts
+    needs: [ci, verify-version]
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@20cfd1bf945f4377ade1205e4dbc17946fc9a30d # v10.0.1
+        with:
+          enable-cache: false
+      - run: uv build
+      - name: Verify release artifacts
+        run: |
+          python3 - <<'PY'
+          import glob
+          import tarfile
+          import zipfile
+
+          wheels = glob.glob("dist/*.whl")
+          sdists = glob.glob("dist/*.tar.gz")
+          assert len(wheels) == 1, f"expected one wheel, found {wheels}"
+          assert len(sdists) == 1, f"expected one sdist, found {sdists}"
+          with zipfile.ZipFile(wheels[0]) as archive:
+              names = archive.namelist()
+              assert "dexpot/__init__.py" in names
+              assert "dexpot/templates/skills/dexpot.md" in names
+          with tarfile.open(sdists[0]) as archive:
+              names = archive.getnames()
+              assert any(name.endswith("/src/dexpot/__init__.py") for name in names)
+              assert any(name.endswith("/ROADMAP.md") for name in names)
+          print(f"verified {wheels[0]} and {sdists[0]}")
+          PY
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write # Required for PyPI trusted publishing through OIDC.
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        with:
+          attestations: true
+
+  github-release:
+    name: create GitHub Release
+    needs: publish
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: write # Required to create the GitHub Release and upload assets.
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: dist
+          path: dist/
+      - name: Extract release notes from changelog
+        env:
+          RELEASE_VERSION: ${{ github.ref_name }}
+        run: |
+          python3 - <<'PY' > release-notes.md
+          import os
+          import pathlib
+          import re
+          import sys
+
+          version = os.environ["RELEASE_VERSION"].removeprefix("v")
+          text = pathlib.Path("CHANGELOG.md").read_text()
+          match = re.search(
+              rf"^## \[{re.escape(version)}\][^\n]*\n(.*?)(?=^## \[|\Z)",
+              text,
+              re.MULTILINE | re.DOTALL,
+          )
+          if match is None:
+              sys.exit(f"no exact '## [{version}]' section in CHANGELOG.md")
+          print(match.group(1).strip())
+          PY
+          cat release-notes.md
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: |
+          set -euo pipefail
+          version="${RELEASE_TAG#v}"
+          args=()
+          case "$version" in *-*) args+=(--prerelease) ;; esac
+          gh release create "$RELEASE_TAG" \
+            --title "$RELEASE_TAG" \
+            --notes-file release-notes.md \
+            --verify-tag \
+            "${args[@]}" \
+            dist/*

dexpot-0.1.0/.github/workflows/stale.yml

@@ -0,0 +1,40 @@
+name: Stale issue and pull request management
+
+on:
+  schedule:
+    - cron: "30 1 * * *"
+  workflow_dispatch:
+
+permissions: {}
+
+concurrency:
+  group: stale-management
+  cancel-in-progress: false
+
+jobs:
+  stale:
+    name: stale
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      issues: write # Required to label, comment on, and close stale issues.
+      pull-requests: write # Required to manage stale pull requests.
+    steps:
+      - uses: actions/stale@4391f3da665fdf50b6810c1a66712fb9ba21aa93 # v11.0.0
+        with:
+          stale-issue-message: >
+            This issue has been marked stale because it has not had recent activity.
+            It will close in 14 days unless new information is added.
+          stale-pr-message: >
+            This pull request has been marked stale because it has not had recent activity.
+            It will close in 14 days unless work resumes.
+          close-issue-message: This issue was closed due to inactivity.
+          close-pr-message: This pull request was closed due to inactivity.
+          stale-issue-label: stale
+          stale-pr-label: stale
+          days-before-stale: 60
+          days-before-close: 14
+          days-before-pr-stale: 30
+          days-before-pr-close: 14
+          exempt-issue-labels: enhancement,pinned,security
+          exempt-pr-labels: pinned,security,dependencies

dexpot-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+.venv-ft/
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# tooling
+.DS_Store

dexpot-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,14 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.16.4
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-toml
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - id: trailing-whitespace

dexpot-0.1.0/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to dexpot will be documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and versions
+follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+Unreleased changes live as files in [`changelog.d/`](changelog.d/) until release
+preparation assembles them here. Run `make changelog-draft` to preview the next release.
+
+<!-- towncrier release notes start -->
+
+## [0.1.0] - 2026-08-25
+
+### Added
+
+- Add the initial dexpot serving core, typed routing API, adaptive scheduler, CLI, tests, and CI. ([#1](https://github.com/tugrulguner/dexpot/pull/1))
+- Add `dexpot add skills` for six coding agents, expanded framework documentation and roadmap, and release-ready repository automation. ([#3](https://github.com/tugrulguner/dexpot/pull/3))
+
+### Changed
+
+- Add compiled endpoint plans, duplicate-route detection, and DEXPOT_WORKERS multiprocess serving on GIL builds. ([#2](https://github.com/tugrulguner/dexpot/pull/2))

dexpot-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,95 @@
+# Contributing to dexpot
+
+Thanks for helping build dexpot as a synchronous API framework for GIL and free-threaded
+CPython.
+
+## Development setup
+
+```bash
+git clone https://github.com/tugrulguner/dexpot.git
+cd dexpot
+uv sync --all-extras
+uv run pre-commit install
+make check
+```
+
+Use `make format` before committing.
+
+## What a change must preserve
+
+- Plain synchronous handlers; no coroutine bridge in the request path.
+- Route and argument errors fail during registration when they can be known then.
+- A worker owns a keep-alive connection until close.
+- GIL admission remains bounded and returns 503 instead of accumulating unlimited work.
+- Free-threaded and GIL behavior are tested deliberately rather than assumed equivalent.
+- Public performance claims come from reproducible, correctness-matched benchmarks.
+
+The rules above come from the route-binding, keep-alive, signal, and multiprocess bugs
+already exercised by the end-to-end suite. Treat them as architecture contracts rather
+than style preferences.
+
+## Tests
+
+Run the complete gate:
+
+```bash
+make check
+```
+
+The gate includes lint, formatting, type checking, real HTTP tests, and coverage. Useful
+narrower commands are:
+
+```bash
+uv run pytest tests/test_e2e.py -v
+uv run pytest tests/test_multiprocess.py -v
+uv run pytest tests/test_add_skills.py tests/test_skills_content.py -v
+```
+
+A behavior change needs an end-to-end test against the real socket server. A unit test of a
+private helper is not enough by itself. Multiprocess, signal, restart, and drain behavior
+must run in a subprocess because Python only permits signal handlers in the main thread.
+
+## Pull requests
+
+1. Branch from the latest `main`.
+2. Keep the change focused on one concern.
+3. Add or update real-user tests and executable examples when behavior changes.
+4. Update README, roadmap, agent skill, and contributor guidance in the same change when
+   their contract changes.
+5. Add a changelog fragment for a user-facing change.
+6. Run `make check`, `make build`, and the workflow checks in
+   [`docs/reviewing.md`](docs/reviewing.md).
+7. Open a pull request with the current behavior, the change, and verification evidence.
+
+## Changelog fragments
+
+User-facing changes require one file named for the pull request:
+
+```text
+changelog.d/<pr-number>.<type>.md
+```
+
+Types are `added`, `changed`, `deprecated`, `removed`, and `fixed`. Write one sentence about
+what changed for a user. Do not edit `CHANGELOG.md` directly; Towncrier assembles it during
+release preparation. For maintenance with no user-visible effect, a maintainer may apply
+the `skip-changelog` label.
+
+## Releasing
+
+Maintainers follow [`docs/releasing.md`](docs/releasing.md). Do not bump the version or tag a
+feature pull request. `pyproject.toml` is the one editable version source; `uv version`
+updates it and the lockfile together.
+
+## Reporting issues
+
+Search existing issues first. A useful bug report includes:
+
+- Python version and whether `sys._is_gil_enabled()` is true or false;
+- operating system;
+- a minimal runnable application;
+- the exact request and observed response;
+- concurrency settings such as `DEXPOT_POOL`, `DEXPOT_MAX_QUEUE`, and `DEXPOT_WORKERS`;
+- whether the failure reproduces with a single connection and a single process.
+
+For substantial API or scheduler changes, open an issue and align on the contract before
+implementation.

dexpot-0.1.0/LICENSE

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