django-due 0.1.0__tar.gz

django_due-0.1.0/.github/dependabot.yml

@@ -0,0 +1,8 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly
+    commit-message:
+      prefix: ci

django_due-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,9 @@
+## Behavior
+
+Describe the concrete problem and resulting behavior, including the relevant
+failure or recovery history.
+
+## Validation
+
+Name the checks run and the limits of what they prove. For an obligation-contract
+change, include the profile report and any newly unassessed guarantees.

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

@@ -0,0 +1,132 @@
+name: CI
+on:
+  push:
+    branches: [main]
+  pull_request:
+permissions:
+  contents: read
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - run: uv sync --locked --only-group lint
+      - run: uv run --no-sync ruff check .
+      - run: uv run --no-sync ruff format --check .
+      - run: uv run --no-sync pre-commit validate-config
+      - name: Validate GitHub Actions
+        run: docker run --rm -v "$PWD:/repo" -w /repo rhysd/actionlint:1.7.7 -color
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - run: uv sync --locked
+      - run: uv run --no-sync pyrefly check
+
+  tests:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    strategy:
+      fail-fast: false
+      matrix:
+        django: [locked, minimum]
+    services:
+      postgres:
+        image: postgres:17
+        env:
+          POSTGRES_USER: due
+          POSTGRES_PASSWORD: due
+          POSTGRES_DB: due
+        ports: ["5432:5432"]
+        options: >-
+          --health-cmd "pg_isready -U due"
+          --health-interval 5s
+          --health-timeout 5s
+          --health-retries 10
+      redis:
+        image: redis:7
+        ports: ["6379:6379"]
+        options: >-
+          --health-cmd "redis-cli ping"
+          --health-interval 5s
+          --health-timeout 5s
+          --health-retries 10
+    env:
+      DUE_DATABASE_URL: postgresql://due:due@localhost:5432/due
+      DUE_BROKER_URL: redis://localhost:6379/0
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - run: uv sync --locked
+      - name: Exercise the declared Django lower bound
+        if: matrix.django == 'minimum'
+        run: uv pip install 'django==6.0.8'
+      - name: Run full suite including live web, worker and Beat recovery
+        run: uv run --no-sync pytest --due-work-check-fixtures --basetemp=test-results -p due.django.conformance.reporting --due-work-debt-baseline=tests/conformance/debt_baseline.yaml --due-work-profile-report=profiles.json --durable-work-report=effects.json --durable-observation-report=observations.json
+      - name: Require executed obligation guarantees
+        run: uv run --no-sync python scripts/check_adoption_report.py profiles.json --contract "Due replay-safe work table" --verified A B D I J
+      - name: Require complete application conformance
+        run: uv run --no-sync python scripts/check_adoption_report.py profiles.json --contract publish_document --verified A B D E H I J --effect-report effects.json --effect publish_document --required-effect-case "test_due_work_contract[process-document process death-assert_process_deaths_converge]"
+      - name: Require complete book indexing conformance
+        run: uv run --no-sync python scripts/check_adoption_report.py profiles.json --contract index_book --verified A B D H I J --effect-report effects.json --effect index_book --required-effect-case "test_immutable_inputs_hold[admission-create book]" --required-effect-case "test_immutable_inputs_hold[admission_failure-create book]" --required-effect-case "test_due_work_contract[process-book indexing and publication process death-assert_process_deaths_converge]"
+      - name: Require complete book publication conformance
+        run: uv run --no-sync python scripts/check_adoption_report.py profiles.json --contract publish_book --verified A B D H J --effect-report effects.json --effect publish_book --required-effect-case "test_immutable_inputs_hold[producer-index settlement]"
+      - name: Require catalog projection conformance
+        run: uv run --no-sync python scripts/check_adoption_report.py profiles.json --contract project_catalog --verified A B D E H I J --effect-report effects.json --effect project_catalog
+      # Non-repeatable orders decline harmless replay and retain evidence indefinitely.
+      - name: Require observed print-order conformance
+        run: uv run --no-sync python scripts/check_adoption_report.py profiles.json --contract print_order --verified A B C I J --effect-report effects.json --effect print_order
+      - name: Require scheduled publication conformance
+        run: uv run --no-sync python scripts/check_adoption_report.py profiles.json --contract publish_at_deadline --verified A B E H I J --effect-report effects.json --effect publish_at_deadline --required-effect-case "test_due_work_contract[process-scheduled publication process death-assert_process_deaths_converge]"
+      - name: Validate application setup
+        run: uv run --no-sync python -m django due_check
+        env:
+          DJANGO_SETTINGS_MODULE: examples.settings
+      - run: uv run --no-sync python -m django makemigrations --check --dry-run
+        env:
+          DJANGO_SETTINGS_MODULE: examples.settings
+      - uses: actions/upload-artifact@v7
+        if: always()
+        with:
+          name: obligation-profiles-${{ matrix.django }}
+          path: |
+            profiles.json
+            effects.json
+            observations.json
+            test-results/**/*.log
+          if-no-files-found: error
+
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+      - run: uv build
+      - run: uvx --from twine twine check --strict dist/*
+      - name: Install the wheel without development dependencies
+        run: |
+          uv venv /tmp/due-wheel
+          uv pip install --python /tmp/due-wheel dist/*.whl
+          /tmp/due-wheel/bin/python -I scripts/check_wheel.py
+      - uses: actions/upload-artifact@v7
+        with:
+          name: distributions
+          path: dist/
+          if-no-files-found: error

django_due-0.1.0/.github/workflows/pr-title.yml

@@ -0,0 +1,32 @@
+name: PR title
+
+# Conventional titles keep the public change history readable.
+
+on:
+  pull_request_target:
+    types: [opened, edited, synchronize, reopened]
+
+permissions:
+  pull-requests: read
+
+jobs:
+  conventional-commit:
+    runs-on: ubuntu-latest
+    steps:
+      # Reads only the title through the API; it never checks out the pull request's code.
+      - uses: amannn/action-semantic-pull-request@v6
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          types: |
+            feat
+            fix
+            perf
+            revert
+            docs
+            refactor
+            test
+            build
+            ci
+            chore
+          requireScope: false

django_due-0.1.0/.github/workflows/release.yaml

@@ -0,0 +1,224 @@
+name: Release
+
+# After normal CI succeeds on main, release-please updates a release PR holding the next
+# SemVer version and changelog, derived from Conventional Commit messages.
+# Merging that PR tags vX.Y.Z and creates the GitHub release; this workflow
+# then builds that exact tag and publishes it to PyPI with Trusted Publishing
+# (OIDC, no stored token). See RELEASING.md.
+#
+# workflow_dispatch publishes an existing tag to TestPyPI or PyPI (a rehearsal,
+# or a publish that failed after tagging), or, with no tag and TestPyPI, the
+# dispatched commit's .devN version, which PyPI never receives.
+
+on:
+  workflow_run:
+    workflows: [CI]
+    branches: [main]
+    types: [completed]
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Release tag to publish, for example v0.1.0. Empty with testpypi: publish this commit's dev version"
+        required: false
+        default: ""
+      index:
+        description: "Where to publish"
+        type: choice
+        options: [testpypi, pypi]
+        default: testpypi
+
+permissions: {}
+
+concurrency:
+  group: release
+  cancel-in-progress: false
+
+jobs:
+  release-please:
+    if: >-
+      github.event_name == 'workflow_run'
+      && github.event.workflow_run.event == 'push'
+      && github.event.workflow_run.conclusion == 'success'
+      && github.event.workflow_run.head_repository.full_name == github.repository
+    environment: release-automation
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+    steps:
+      - name: Only release the tested main head
+        id: current
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const {data: branch} = await github.rest.repos.getBranch({...context.repo, branch: 'main'});
+            core.setOutput('matches', branch.commit.sha === context.payload.workflow_run.head_sha);
+      - name: Require release PR authentication
+        env:
+          HAS_RELEASE_TOKEN: ${{ secrets.RELEASE_PLEASE_TOKEN != '' }}
+        run: |
+          if [[ "$HAS_RELEASE_TOKEN" != "true" ]]; then
+            echo "::error::Configure RELEASE_PLEASE_TOKEN in the main-only release-automation environment."
+            exit 1
+          fi
+      - id: release
+        if: steps.current.outputs.matches == 'true'
+        uses: googleapis/release-please-action@v4
+        with:
+          # A non-GITHUB_TOKEN credential triggers ordinary PR CI. The main-only
+          # environment keeps it unavailable to pull-request test jobs.
+          token: ${{ secrets.RELEASE_PLEASE_TOKEN }}
+          target-branch: main
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json
+
+  build:
+    needs: release-please
+    if: >-
+      always() && (
+        (github.event_name == 'workflow_run' && needs.release-please.result == 'success' && needs.release-please.outputs.release_created == 'true')
+        || github.event_name == 'workflow_dispatch'
+      )
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      actions: read
+    outputs:
+      tag: ${{ steps.tag.outputs.tag }}
+      version: ${{ steps.built.outputs.version }}
+    steps:
+      - id: tag
+        env:
+          TAG: ${{ needs.release-please.outputs.tag_name || inputs.tag }}
+          INDEX: ${{ inputs.index || 'pypi' }}
+        run: |
+          if [[ -z "$TAG" ]]; then
+            # Only a TestPyPI rehearsal may publish an untagged commit, as its .devN version.
+            if [[ "$INDEX" != "testpypi" ]]; then
+              echo "::error::publishing to PyPI needs a release tag" >&2
+              exit 1
+            fi
+            echo "tag=" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          # A release is a plain SemVer core version: vMAJOR.MINOR.PATCH.
+          if [[ ! "$TAG" =~ ^v(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)$ ]]; then
+            echo "::error::'$TAG' is not a release tag of the form vMAJOR.MINOR.PATCH" >&2
+            exit 1
+          fi
+          echo "tag=$TAG" >> "$GITHUB_OUTPUT"
+          echo "version=${TAG#v}" >> "$GITHUB_OUTPUT"
+      - uses: actions/checkout@v7
+        with:
+          ref: ${{ steps.tag.outputs.tag || github.sha }}
+          # The version is read from the tag, so the tag must be present.
+          fetch-depth: 0
+      # Check the resolved tag, including on manual retries: a green run for a
+      # different commit (or a PR) must never authorize a production release.
+      - name: Require normal CI on the exact release commit
+        if: inputs.index != 'testpypi'
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          source_sha=$(git rev-parse HEAD)
+          count=$(gh api "repos/$GITHUB_REPOSITORY/actions/workflows/ci.yml/runs?branch=main&event=push&status=success&head_sha=$source_sha" --jq '.total_count')
+          if [[ "$count" -lt 1 ]]; then
+            echo "::error::No successful main CI run for release commit $source_sha. Re-run its CI before publishing."
+            exit 1
+          fi
+      - uses: astral-sh/setup-uv@v7
+      - run: uv build
+      - run: uvx --from twine twine check --strict dist/*
+      - name: The built version is the tag
+        if: steps.tag.outputs.tag != ''
+        env:
+          VERSION: ${{ steps.tag.outputs.version }}
+        run: |
+          ls dist
+          test -f "dist/django_due-${VERSION}-py3-none-any.whl"
+          test -f "dist/django_due-${VERSION}.tar.gz"
+      - name: An untagged build is a dev release
+        if: steps.tag.outputs.tag == ''
+        run: |
+          ls dist
+          wheel=$(basename dist/*.whl)
+          [[ "$wheel" =~ ^django_due-[0-9]+\.[0-9]+(\.[0-9]+)?\.dev[0-9]+-py3-none-any\.whl$ ]]
+      - id: built
+        run: |
+          wheel=$(basename dist/*.whl)
+          version=${wheel#django_due-}
+          echo "version=${version%-py3-none-any.whl}" >> "$GITHUB_OUTPUT"
+      - name: Install the wheel without development dependencies
+        run: |
+          uv venv /tmp/wheel && uv pip install --python /tmp/wheel dist/*.whl
+          /tmp/wheel/bin/python -I scripts/check_wheel.py
+      - name: Require the testing extra to resolve from published packages
+        # Development CI uses the reviewed Git source. A release must also be
+        # installable by ordinary PyPI consumers, without uv.sources or Git.
+        run: |
+          wheel=(dist/*.whl)
+          uv pip install --no-sources --default-index https://pypi.org/simple --python /tmp/wheel "${wheel[0]}[testing]"
+          uv pip check --python /tmp/wheel
+      - uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  publish-pypi:
+    needs: build
+    if: >-
+      always() && needs.build.result == 'success'
+      && (github.event_name == 'workflow_run' || inputs.index == 'pypi')
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/django-due/${{ needs.build.outputs.version }}/
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  publish-testpypi:
+    needs: build
+    if: >-
+      always() && needs.build.result == 'success'
+      && github.event_name == 'workflow_dispatch' && inputs.index == 'testpypi'
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/project/django-due/${{ needs.build.outputs.version }}/
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  attach-to-release:
+    needs: [build, publish-pypi]
+    if: always() && needs.publish-pypi.result == 'success' && needs.build.outputs.tag != ''
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+      - env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ needs.build.outputs.tag }}
+        run: gh release upload "$TAG" dist/* --clobber --repo "$GITHUB_REPOSITORY"
+

django_due-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+dist/
+*.egg-info/
+.env
+
+profiles.json
+celerybeat-schedule*
+
+effects.json
+observations.json
+test-results/

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

@@ -0,0 +1,20 @@
+minimum_pre_commit_version: '4.3.0'
+repos:
+  - repo: local
+    hooks:
+      - id: ruff-check
+        name: Ruff lint (uv.lock)
+        entry: uv run --locked ruff check --fix
+        language: system
+        types_or: [python, pyi]
+      - id: ruff-format
+        name: Ruff format (uv.lock)
+        entry: uv run --locked ruff format
+        language: system
+        types_or: [python, pyi, markdown]
+      - id: pyrefly
+        name: Pyrefly project check (uv.lock)
+        entry: uv run --locked pyrefly check
+        language: system
+        pass_filenames: false
+        files: '(^pyproject\.toml$|^uv\.lock$|\.pyi?$)'

django_due-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

django_due-0.1.0/.release-please-manifest.json

@@ -0,0 +1 @@
+{".":"0.1.0"}

django_due-0.1.0/CHANGELOG.md

@@ -0,0 +1,99 @@
+# Changelog
+
+## 0.1.0 (2026-10-12)
+
+
+### Features
+
+* add a runnable books example with recovery proofs ([57b94db](https://github.com/gigaverse-app/due/commit/57b94dbc98fda1d95745d63d81b7408cdb940ee3))
+* add books indexing demo and recoverable handoff proofs ([dd941a3](https://github.com/gigaverse-app/due/commit/dd941a317638938e424e823e07a5bee74841ee37))
+* add comparative recovery demos and setup diagnostics ([20adee4](https://github.com/gigaverse-app/due/commit/20adee48526f247690dc7e088434e68f3a09f6ed))
+* add executable Celery comparison and pin Books port reference ([3d62279](https://github.com/gigaverse-app/due/commit/3d6227905e20554b851ed8bdaab09b9fffdaf810))
+* add executable migration demo comparisons ([5e2aba9](https://github.com/gigaverse-app/due/commit/5e2aba9cf79d9481b4327e099b2fbb11634edf1c))
+* add scheduled publication with deadline hints and submission keys ([5795f0c](https://github.com/gigaverse-app/due/commit/5795f0c5db8c49618ddb806ec189d64e17a19140))
+* complete backend harness adapters and proof controls ([141af43](https://github.com/gigaverse-app/due/commit/141af432f6cd1a2203c9d9ead0caa518274edf47))
+* complete discovery proofs and provider seam bindings ([87e7b12](https://github.com/gigaverse-app/due/commit/87e7b120396796c0733e411fdf503797c3a90d3a))
+* complete work-table tooling and contributor workflow ([aa5fbfc](https://github.com/gigaverse-app/due/commit/aa5fbfcd8aac919696430e94915a2643f78fbb14))
+* demonstrate and compare application recovery guarantees ([0a19778](https://github.com/gigaverse-app/due/commit/0a19778975824c735a784b60ad204468b388a39b))
+* demonstrate scheduled publication with cancellation and recovery proofs ([0a3e38a](https://github.com/gigaverse-app/due/commit/0a3e38a91f93b72e89a8aa00d174fe52852a65a6))
+* every work table can declare its provider outcome matrix ([#27](https://github.com/gigaverse-app/due/issues/27)) ([5ee2b7b](https://github.com/gigaverse-app/due/commit/5ee2b7b1d3d6d9f49f4bf21cbe965e3f603b17a2))
+* extract Django work-table execution and recovery into Due ([a1e30be](https://github.com/gigaverse-app/due/commit/a1e30bec92dd03fd382ded0a6ad799b87c320914))
+* finish Beat and interleaving harness adapters ([ed3de62](https://github.com/gigaverse-app/due/commit/ed3de62ea03b8755cd53c913652b75a5d57eb9f9))
+* integrate adopter proofs and recover lifecycle tooling ([1204181](https://github.com/gigaverse-app/due/commit/1204181e06018dc5778bf146444824595ed6f5ec))
+* port application-bound work-table conformance harness ([65e0bcf](https://github.com/gigaverse-app/due/commit/65e0bcfe426c9e663aec4ae5c71398965dde3269))
+* port application-bound work-table conformance harness ([d682f93](https://github.com/gigaverse-app/due/commit/d682f93cd8c1862f0f5b49e2e6cca9957db2f742))
+* preserve application fatal recovery errors and bind host proofs ([96d7ab2](https://github.com/gigaverse-app/due/commit/96d7ab2427076a810ff687766ac88e725c579064))
+* preserve application recovery failures and document proof integration ([ab8ff31](https://github.com/gigaverse-app/due/commit/ab8ff31104fa2e42a997a3637e04982665789a13))
+* preserve backend handoff recovery and harness mutation controls ([43b88af](https://github.com/gigaverse-app/due/commit/43b88af5f92ab324f9e49c576eb3599c8bb53e32))
+* preserve deployment contracts and stronger work-table bindings ([a241d70](https://github.com/gigaverse-app/due/commit/a241d70e5e3110ee3c78e389d415b76e838f33ed))
+* preserve discovery completeness and failed recovery evidence ([65d4a86](https://github.com/gigaverse-app/due/commit/65d4a8688fc78b4ec7d83b1f66c63ce9b9fb9c4f))
+* prove application outcomes and publish immutable files without replay writes ([92bfacd](https://github.com/gigaverse-app/due/commit/92bfacdb2f23b1b1959e40ae02364fef9103edee))
+* prove books input stability and require demo replay outcomes ([b19425e](https://github.com/gigaverse-app/due/commit/b19425eeda04c2a090e300faab733269caafcd53))
+* prove immutable input claims against admission and recovery ([ac847ca](https://github.com/gigaverse-app/due/commit/ac847ca05ef3bf7afbe2f3c54c684e5014ce7de6))
+* publish django-due through manually approved releases ([#26](https://github.com/gigaverse-app/due/issues/26)) ([bdcb1e6](https://github.com/gigaverse-app/due/commit/bdcb1e657861412bf85b8ed56dec393b4454b230))
+* restore work-table operator tooling and harden contributor checks ([2766c33](https://github.com/gigaverse-app/due/commit/2766c33f2456886bba0f9b6c29b17018dcd2178f))
+* share typed provider probes and complete Celery setup ([6765a0a](https://github.com/gigaverse-app/due/commit/6765a0ab7f079d5fe2543e26bb9915848f7a43b2))
+* simplify runtime and provider bindings ([d1ebe81](https://github.com/gigaverse-app/due/commit/d1ebe81bb815ccdd96070c84d17fb8db5718143b))
+* unbounded work tables claim profile J through the persistent-failure proof ([d6c8a4b](https://github.com/gigaverse-app/due/commit/d6c8a4b9ddfb3215560b938c3dcd49dd7759a088))
+* unbounded work tables claim profile J through the persistent-failure proof ([c642482](https://github.com/gigaverse-app/due/commit/c642482a7853dd130719382f3cb16f01c21b84ed))
+* upstream native lifecycle and cutover integration improvements ([93ca10c](https://github.com/gigaverse-app/due/commit/93ca10cb8ae11a93e1e13b21f78e7a9a0e64ce4e))
+* verify immutable input claims through production admission ([533530e](https://github.com/gigaverse-app/due/commit/533530e7377d3d32e749caaef387a38a6dcf919f))
+* wake near deadlines without SQL hints and deduplicate submissions ([eaa043f](https://github.com/gigaverse-app/due/commit/eaa043f5140b531f044212065bcc596c59d5bb1d))
+
+
+### Bug fixes
+
+* consume queued recovery in the comparison harness ([9a3003e](https://github.com/gigaverse-app/due/commit/9a3003e07389f1cdbd8b53bea1cebca84f100ad7))
+* failing_external_call counts every provider entry ([f4c8202](https://github.com/gigaverse-app/due/commit/f4c820257a7211ca53d1ce2e65f4812dcb8ddf05))
+* initialize the example Celery app in Django processes ([5baa593](https://github.com/gigaverse-app/due/commit/5baa5938bf8c731bfe808ba8fc6ba1dbd5721c95))
+* keep gate recovery on the harness-owned broker ([286e694](https://github.com/gigaverse-app/due/commit/286e6943afbc1efce1fb1e35c49fdf17f3deb400))
+* preserve delivery verdicts and consolidate recovery ownership ([810c0c0](https://github.com/gigaverse-app/due/commit/810c0c0e9591e04aa853f69e5d52f512e47fd586))
+* preserve proof failures through adopter cleanup ([b862931](https://github.com/gigaverse-app/due/commit/b8629317003551c78c518ba899a721752d152497))
+* register deadline recovery proof and validate final harness candidate ([424a446](https://github.com/gigaverse-app/due/commit/424a44635c2ffacf01e499d4d6c710fdc5f6b31f))
+* retain adopter environment throughout crash histories ([f7b8713](https://github.com/gigaverse-app/due/commit/f7b871301d6ca376f39d43ae59449e0da343b9e1))
+
+
+### Performance
+
+* publish immutable revisions cheaply with application outcome proofs ([f68e3e4](https://github.com/gigaverse-app/due/commit/f68e3e41098134c33fc0aab3fe351885c9157e30))
+* remove per-publication staging directories without weakening recovery ([4ce9e34](https://github.com/gigaverse-app/due/commit/4ce9e3495068a3496e38f57587a23aa251f7f7bc))
+
+
+### Documentation
+
+* add coming-from guides for Python background-work libraries ([a65ee04](https://github.com/gigaverse-app/due/commit/a65ee0471ab51b28a4cde5897ff928f3fee5e806))
+* add focused coming-from guides for Python work libraries ([054e65c](https://github.com/gigaverse-app/due/commit/054e65c2a86101ca9ba7fa7c440e957788660222))
+* audit backend migration readiness ([#6](https://github.com/gigaverse-app/due/issues/6)) ([07e4b8b](https://github.com/gigaverse-app/due/commit/07e4b8be06563130475679a6c81484aa3632a5c4))
+* compare Python queues and document migration and shim boundaries ([0893cd5](https://github.com/gigaverse-app/due/commit/0893cd5797961c731dc12eeb79737f6756599e4d))
+* establish in-repository example catalog ([599c43f](https://github.com/gigaverse-app/due/commit/599c43f637d6eb97e6513a2ee9c169a2c719c1e9))
+* explain Due strengths, tradeoffs and evidence boundaries ([4e635bc](https://github.com/gigaverse-app/due/commit/4e635bcfd1dde336ff4a5ddd9bd5b5f3f5c8c5ae))
+* explain Due strengths, tradeoffs and evidence boundaries ([2d8e2dd](https://github.com/gigaverse-app/due/commit/2d8e2dd7a7c0aca2eeacc1ee78fd87a3561854a8))
+* explain Temporal parity gaps and scheduled demo tradeoffs ([4998a18](https://github.com/gigaverse-app/due/commit/4998a18de69f6946728796d413a60964a6c70efa))
+* format migration examples and check Markdown before commit ([fc6978d](https://github.com/gigaverse-app/due/commit/fc6978dfd751daf892c0edae6e96ce8573f1d088))
+* guide conformance adoption and separate public authoring APIs ([6e0c061](https://github.com/gigaverse-app/due/commit/6e0c061c3a339e96803ffa3d81fb30817f5a6bcb))
+* introduce Due durable obligations library ([3ac929f](https://github.com/gigaverse-app/due/commit/3ac929f175d25de951125a219d41c20d1b3b00b4))
+* keep concurrent runtime adoption audit separate ([118486f](https://github.com/gigaverse-app/due/commit/118486f7a430bbb56864342870522dffd302efd8))
+* link deadline wakeup evidence and completed recovery checks ([3752750](https://github.com/gigaverse-app/due/commit/37527507b6c4a79a30ad635ae390bfe11a6039dd))
+* pin the companion harness audit reference ([2f48257](https://github.com/gigaverse-app/due/commit/2f48257ee403f91009a29c6df015c9f89d758fd7))
+* plan application outcome and provider replay proofs ([b06ba90](https://github.com/gigaverse-app/due/commit/b06ba90322f9bc2cee3af19c5a1a7f5ebbef6464))
+* plan audit-driven integration and recovery guides ([62f8688](https://github.com/gigaverse-app/due/commit/62f868824649409407963ea4427396d5a9da7087))
+* plan backend replacement contract parity ([086b1be](https://github.com/gigaverse-app/due/commit/086b1bead3aa5c09524f7db732f71cea6b94f77a))
+* plan checked immutable-input parity ([10e9eb0](https://github.com/gigaverse-app/due/commit/10e9eb031645ee38b68dc349a1333ce4bcce852a))
+* plan comparative recovery and richer application demos ([a9cde2a](https://github.com/gigaverse-app/due/commit/a9cde2a9f3263d51ceaf19f82553426438c2afd0))
+* plan current backend parity controls ([f8bb0e7](https://github.com/gigaverse-app/due/commit/f8bb0e762e9f1175ddecb1d925c4d9a5c4baf98f))
+* plan executable books convergence guarantees ([9bc29d7](https://github.com/gigaverse-app/due/commit/9bc29d7e9156747eaf35daafdfe8f2cef1184382))
+* plan real adopter integration and third source audit ([24428dc](https://github.com/gigaverse-app/due/commit/24428dc029b04e15bff70567f8545587afb2a34d))
+* plan runtime and provider binding improvements ([3d79a87](https://github.com/gigaverse-app/due/commit/3d79a8789ba1d0a68bbc853950fe5a0b087aca2a))
+* plan scheduled publication demo and recovery proofs ([8fdd8a6](https://github.com/gigaverse-app/due/commit/8fdd8a64822b70a521b5b83f728daae0039731fe))
+* plan work-table parity and contributor workflow ([3d581ef](https://github.com/gigaverse-app/due/commit/3d581ef78a0886a89e0690c4102ded8739ac2b02))
+* record audit port verification and migration limits ([a6d9d1a](https://github.com/gigaverse-app/due/commit/a6d9d1aeab4646be4d210f5aa333d50c88688d46))
+* record binding integrity and integration evidence ([bf95077](https://github.com/gigaverse-app/due/commit/bf95077a634f70d0e94e000e64930e7537d8f5ed))
+* record comparison and recovery validation evidence ([65f7cdc](https://github.com/gigaverse-app/due/commit/65f7cdcedcb5997f056b586293f9bd98f9c755bb))
+* record complete serial consumer validation ([92433ad](https://github.com/gigaverse-app/due/commit/92433adfb9934f8c6d758434edbc7571cb14960d))
+* record completed package and backend parity checks ([d779b1c](https://github.com/gigaverse-app/due/commit/d779b1cc8d838865883a6915c3713dcf7fbe55e4))
+* record scheduled publication recovery evidence ([ff87b07](https://github.com/gigaverse-app/due/commit/ff87b074a9e44391189a5246c356a9321f2139bb))
+* record standalone verification and supported Django baseline ([22153f1](https://github.com/gigaverse-app/due/commit/22153f1281c7fe87b4a64f688bc246994c2f8c4f))
+* record the publication demo Procrastinate provenance ([a896b12](https://github.com/gigaverse-app/due/commit/a896b128102aaf01dbe0df497259e893f188c9fc))
+* record work-table parity verification ([f5b4464](https://github.com/gigaverse-app/due/commit/f5b446407d3fba8e428725067d722069e89fd2c0))
+* show concrete APIs and code changes in migration guides ([205bde7](https://github.com/gigaverse-app/due/commit/205bde743c989bd1721cbd543cdef4dd9a453f4e))
+* start competitor migration audit ([7d625a8](https://github.com/gigaverse-app/due/commit/7d625a82af8477abf6f0428ae9373dde1afb1e8d))

django_due-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,75 @@
+# Contributing to Due
+
+Due uses Python 3.14 and uv. Install Docker (or supply dedicated PostgreSQL and
+Redis instances), then:
+
+```bash
+uv sync --locked
+uv run pre-commit install
+docker compose up -d --wait
+uv run pre-commit run --all-files
+uv run pytest --due-work-require-assessed --due-work-profile-report=profiles.json
+uv run python scripts/check_adoption_report.py profiles.json --contract "Due replay-safe work table" --verified A B D I J
+DJANGO_SETTINGS_MODULE=examples.settings uv run python -m django makemigrations --check --dry-run
+uv build
+```
+
+`uv.lock` is committed. Dependency edits need `uv lock`; normal development and
+CI use `--locked`. Pre-commit runs Ruff lint/format on staged Python files and
+Pyrefly on the whole project. Hooks can modify formatting; review and stage those
+changes before committing again. Database and worker tests run separately from
+commit hooks so a commit does not depend on Docker availability.
+
+Tests use real PostgreSQL. `pytest-django` creates and drops its test database;
+the configured user must be allowed to create databases. The worker integration
+tests also use Redis and separate Celery prefork processes. The live books
+journeys additionally start a real Django HTTP server and Celery Beat, verifying
+normal form submission and scheduled recovery of either lost notification. Set
+`DUE_DATABASE_URL` and `DUE_BROKER_URL` for dedicated test services, or use the defaults in
+[compose.yaml](compose.yaml). Stop local services with `docker compose down`.
+
+## Changes and proofs
+
+Keep the public API focused on work tables. The delivery lease in
+`runtime/_delivery.py` is private machinery for observation workers; it is not a
+public native-table composition API. Use [the capability guide](docs/capabilities.md)
+to find the existing owner of behavior before adding another abstraction.
+
+For behavioral fixes, first write a failing history at the boundary that broke:
+commit, publication, provider call, evidence, or local settlement. Prefer real
+transactions and selectors. Fault injection may replace transport or the
+provider; it must not replace the production decision being proved. Include a
+control that demonstrates the fault was reached, and observe the product result.
+
+## Pull requests and CI
+
+Use Conventional Commit titles (`feat:`, `fix:`, `docs:`, `test:`, `ci:`,
+`refactor:`, `build:`, `perf:`, `revert:`, `chore:`), enforced by the PR-title
+workflow. Explain the resulting behavior, relevant validation and limitations.
+
+CI has independent lint/workflow validation, Pyrefly, distribution, and
+PostgreSQL/Redis test jobs. The test suite runs against locked Django and the
+minimum supported Django version, including the live HTTP/worker/Beat journeys.
+Obligation reports, process logs and distributions are retained as run artifacts.
+The distribution job builds through the sdist, then imports the wheel with
+isolated Python and no development dependencies.
+
+`main` requires `lint`, `typecheck`, `tests (locked)`, `tests (minimum)`,
+`build` and `conventional-commit` to pass from GitHub Actions, with the branch
+up to date before merging. These repository protections apply to administrators
+too. Preserve these check names when changing CI, or update branch protection
+together with the workflow.
+
+To reproduce the installed-wheel check:
+
+```bash
+uv build
+uv venv /tmp/due-wheel
+uv pip install --python /tmp/due-wheel dist/*.whl
+/tmp/due-wheel/bin/python -I scripts/check_wheel.py
+```
+
+Releases are not automatic yet; the GitHub installation in the README is the
+supported distribution path. Creating a public repository does not reserve its
+PyPI package name. Configure and verify PyPI ownership and Trusted Publishing
+before adding a release workflow that uploads distributions.