[security] Mitigate eMudhra/emSign CA incident in dependency resolution, CI, and CLI installs : Issue #79

.github/workflows/bump-version.yml

@@ -0,0 +1,85 @@
+name: Bump version
+
+# After a non-release PR merges to main, open (or refresh) a release PR that
+# bumps pyproject.toml + uv.lock ahead of PyPI. Merging that PR runs publish.yml.
+on:
+  pull_request:
+    types: [closed]
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      bump:
+        description: Semver component to increment
+        type: choice
+        options: [patch, minor, major]
+        default: patch
+
+concurrency:
+  group: bump-version
+  cancel-in-progress: true
+
+jobs:
+  bump:
+    if: >
+      github.event_name == 'workflow_dispatch' ||
+      (github.event.pull_request.merged == true &&
+       !contains(github.event.pull_request.labels.*.name, 'release'))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event_name == 'workflow_dispatch' && 'main' || github.event.pull_request.merge_commit_sha }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Plan and write bump
+        id: bump
+        run: |
+          set -euo pipefail
+          KIND="${{ github.event_name == 'workflow_dispatch' && inputs.bump || 'patch' }}"
+          VERSION=$(python scripts/bump_version.py --bump "$KIND" --write | tail -n 1)
+          if [ -z "$VERSION" ]; then
+            echo "skip=true" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          echo "skip=false" >> "$GITHUB_OUTPUT"
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Open or update release PR
+        if: steps.bump.outputs.skip != 'true'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VERSION: ${{ steps.bump.outputs.version }}
+        run: |
+          set -euo pipefail
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          BRANCH="release/${VERSION}"
+          git checkout -B "$BRANCH"
+          git add pyproject.toml uv.lock
+          git diff --staged --quiet && { echo "No version files changed"; exit 1; }
+          git commit -m "chore(release): ${VERSION}"
+          git push --force-with-lease origin "HEAD:refs/heads/${BRANCH}"
+          gh label create release --description "Version bump / PyPI release" --color 0E8A16 --force || true
+          EXISTING=$(gh pr list --base main --head "$BRANCH" --json number --jq '.[0].number // empty')
+          if [ -n "$EXISTING" ]; then
+            echo "Updated PR #${EXISTING}"
+            exit 0
+          fi
+          gh pr create --base main --head "$BRANCH" --title "chore(release): ${VERSION}" --label release --body "$(cat <<EOF
+          ## Summary
+          - Bump SDK version to **${VERSION}** in \`pyproject.toml\` and \`uv.lock\`.
+          - Merge this PR to publish \`${VERSION}\` to PyPI (see \`publish.yml\`).
+
+          ## Test plan
+          - [ ] Version in \`pyproject.toml\` is ${VERSION} and is not already on PyPI
+          - [ ] \`uv.lock\` editable \`nitrostack\` package version matches
+          EOF
+          )"

.github/workflows/publish.yml

@@ -0,0 +1,77 @@
+name: Publish to PyPI
+
+# Runs when main moves. Uploads only if [project].version is not already on PyPI
+# (the release PR merge). Feature merges no-op in the check job so a protected
+# `pypi` environment does not block ordinary merges.
+on:
+  push:
+    branches: [main]
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    outputs:
+      publish: ${{ steps.check.outputs.publish }}
+      version: ${{ steps.check.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - id: check
+        run: |
+          set -euo pipefail
+          if VERSION=$(python scripts/bump_version.py --if-unpublished); then
+            echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+            echo "publish=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "publish=false" >> "$GITHUB_OUTPUT"
+            echo "pyproject version is already on PyPI; skipping upload"
+          fi
+
+  publish:
+    needs: check
+    if: needs.check.outputs.publish == 'true'
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/nitrostack/
+    permissions:
+      id-token: write
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Secure pip bootstrap (eMudhra/emSign advisory)
+        run: |
+          python -m pip install "pip @ https://files.pythonhosted.org/packages/3f/06/3e4420302363fbb71be3c7f35ce042f54bfca330e3e66b3a2e3c4cca579f/pip-26.2.2-py3-none-any.whl#sha256=fd7f4dfa8190e014013b9f08f3e973f4e4c26ffd179a204895533a7254813a70"
+          python -m pip install --upgrade "certifi>=2026.10.19"
+
+      - name: Install build tools and build package
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+      - name: Secure pip bootstrap (eMudhra/emSign advisory)
+        run: |
+          python -m pip install "pip @ https://files.pythonhosted.org/packages/3f/06/3e4420302363fbb71be3c7f35ce042f54bfca330e3e66b3a2e3c4cca579f/pip-26.2.2-py3-none-any.whl#sha256=fd7f4dfa8190e014013b9f08f3e973f4e4c26ffd179a204895533a7254813a70"
+          python -m pip install --upgrade "certifi>=2026.10.19"
+      - run: python -m pip install -U build && python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+      - name: Tag release
+        env:
+          VERSION: ${{ needs.check.outputs.version }}
+        run: |
+          set -euo pipefail
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          TAG="v${VERSION}"
+          if git rev-parse "$TAG" >/dev/null 2>&1; then
+            echo "Tag $TAG already exists"
+            exit 0
+          fi
+          git tag -a "$TAG" -m "nitrostack ${VERSION}"
+          git push origin "$TAG"

.github/workflows/test.yml

@@ -21,10 +21,14 @@ jobs:
       with:
         python-version: ${{ matrix.python-version }}
 
+    - name: Secure pip bootstrap (eMudhra/emSign advisory)
+      run: |
+        python -m pip install "pip @ https://files.pythonhosted.org/packages/3f/06/3e4420302363fbb71be3c7f35ce042f54bfca330e3e66b3a2e3c4cca579f/pip-26.2.2-py3-none-any.whl#sha256=fd7f4dfa8190e014013b9f08f3e973f4e4c26ffd179a204895533a7254813a70"
+        python -m pip install --upgrade "certifi>=2026.10.19"
+
     - name: Install dependencies
       run: |
-        python -m pip install --upgrade pip
-        pip install -e ".[dev]"
+        python -m pip install -e ".[dev]"
 
     - name: Run pytest with coverage
       run: pytest tests --cov=nitrostack --cov-report=term-missing --timeout=60