bareagent-cli 0.1.0__tar.gz → 0.2.0__tar.gz

bareagent_cli-0.2.0/.githooks/pre-push

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+# Pre-push gate: run the CI-equivalent checks before a push so failures surface
+# locally instead of turning main red. Activated by scripts/setup-hooks.sh
+# (git config core.hooksPath .githooks).
+#
+# Bypass: BAREAGENT_PREPUSH_SKIP=1 git push   or   git push --no-verify
+set -euo pipefail
+
+if [ "${BAREAGENT_PREPUSH_SKIP:-}" = "1" ]; then
+    echo "[pre-push] BAREAGENT_PREPUSH_SKIP=1 -- skipping CI-equivalent checks."
+    exit 0
+fi
+
+repo_root="$(git rev-parse --show-toplevel)"
+
+echo "[pre-push] Running CI-equivalent checks (ruff + uv run pytest)..."
+echo "[pre-push] Skip with BAREAGENT_PREPUSH_SKIP=1 or git push --no-verify."
+exec bash "$repo_root/scripts/ci-check.sh"

bareagent_cli-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  quality:
+    name: Complete Python quality gate
+    permissions:
+      contents: read
+    uses: ./.github/workflows/quality.yml
+
+  notify:
+    name: Track main status
+    needs: [quality]
+    # Only on pushes to main, regardless of whether the upstream jobs passed or
+    # failed, so we can both open the tracking issue on red and close it on recovery.
+    if: always() && github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      contents: read
+    steps:
+      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5
+      - name: Open / close the CI-failure tracking issue
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          python3 scripts/ci_notify.py \
+            --conclusion "quality:${{ needs.quality.result }}" \
+            --sha "${{ github.sha }}" \
+            --run-url "${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}"

bareagent_cli-0.2.0/.github/workflows/quality.yml

@@ -0,0 +1,69 @@
+name: Python quality
+
+on:
+  workflow_call:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    # Run the default suite on both the Linux CI target and the Windows dev
+    # platform, so platform-divergent bugs (paths, CRLF, encoding) surface in CI.
+    # fail-fast: false so one OS failing doesn't cancel the other's result.
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5
+
+      - name: Install uv (+ Python 3.12)
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          python-version: "3.12"
+          enable-cache: true
+
+      - name: Install dependencies
+        run: |
+          uv venv
+          uv pip install -e ".[dev]"
+
+      - name: Lint + format check (ruff)
+        # ruff results are platform-independent; run it once (on Linux) only.
+        # format --check enforces the pinned-ruff formatting so the tree can't drift.
+        if: runner.os == 'Linux'
+        run: |
+          uv run ruff check src tests
+          uv run ruff format --check src tests
+
+      - name: Type check (pyright)
+        # Type results are platform-independent; run once (on Linux) only.
+        if: runner.os == 'Linux'
+        run: uv run pyright
+
+      - name: Test (pytest)
+        run: uv run pytest
+
+  socket:
+    name: Socket tests (localhost)
+    # The localhost-socket suite is separate from the default run; keep it in the
+    # same reusable gate so PR, main, tag, and TestPyPI events cannot omit it.
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5
+
+      - name: Install uv (+ Python 3.12)
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          python-version: "3.12"
+          enable-cache: true
+
+      - name: Install dependencies
+        run: |
+          uv venv
+          uv pip install -e ".[dev]"
+
+      - name: Socket tests (pytest -m socket)
+        run: uv run pytest -m socket

bareagent_cli-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,204 @@
+name: Publish to PyPI
+
+# GitHub's tag filter is only a coarse trigger. The build job enforces strict
+# vMAJOR.MINOR.PATCH syntax and verifies hatch-vcs metadata before artifacts can
+# reach either Trusted Publishing job.
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch: {}
+
+permissions: {}
+
+concurrency:
+  group: release-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  quality:
+    name: Complete CI quality gate
+    permissions:
+      contents: read
+    uses: ./.github/workflows/quality.yml
+
+  build:
+    name: Build and validate distributions
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    outputs:
+      version: ${{ steps.contract.outputs.version }}
+    steps:
+      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5
+        with:
+          # hatch-vcs needs the complete tag history to derive the version.
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Install uv and Python 3.12
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          python-version: "3.12"
+
+      - name: Validate release ref
+        run: |
+          python scripts/release_contract.py \
+            --event-name "${{ github.event_name }}" \
+            --ref-type "${{ github.ref_type }}" \
+            --ref-name "${{ github.ref_name }}" \
+            --ref-only
+
+      - name: Clean distribution directory
+        run: |
+          rm -rf dist
+          mkdir dist
+
+      - name: Build one sdist and one wheel
+        run: uv build --out-dir dist --no-create-gitignore
+
+      - name: Validate artifact inventory and hatch-vcs version
+        id: contract
+        shell: bash
+        run: |
+          version=$(
+            python scripts/release_contract.py \
+              --event-name "${{ github.event_name }}" \
+              --ref-type "${{ github.ref_type }}" \
+              --ref-name "${{ github.ref_name }}" \
+              --dist-dir dist
+          )
+          echo "version=${version}" >> "${GITHUB_OUTPUT}"
+          echo "Validated bareagent-cli ${version}"
+
+      - name: Check distribution metadata
+        run: uvx twine check dist/*.whl dist/*.tar.gz
+
+      - name: Upload exact distributions
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5
+        with:
+          name: python-package-distributions
+          path: |
+            dist/*.whl
+            dist/*.tar.gz
+          if-no-files-found: error
+          retention-days: 7
+
+  smoke-wheel:
+    name: Install and smoke-test wheel
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5
+        with:
+          persist-credentials: false
+
+      - name: Install uv and Python 3.12
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          python-version: "3.12"
+
+      - name: Download distributions
+        uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
+        with:
+          name: python-package-distributions
+          path: dist
+
+      - name: Revalidate downloaded distributions
+        run: |
+          python scripts/release_contract.py \
+            --event-name "${{ github.event_name }}" \
+            --ref-type "${{ github.ref_type }}" \
+            --ref-name "${{ github.ref_name }}" \
+            --dist-dir dist
+
+      - name: Install wheel in a fresh environment
+        run: |
+          uv venv .smoke-wheel
+          uv pip install --python .smoke-wheel/bin/python dist/*.whl
+          .smoke-wheel/bin/python scripts/smoke_installed_package.py
+          .smoke-wheel/bin/bareagent --help
+
+  smoke-sdist:
+    name: Build, install, and smoke-test sdist
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5
+        with:
+          persist-credentials: false
+
+      - name: Install uv and Python 3.12
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          python-version: "3.12"
+
+      - name: Download distributions
+        uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
+        with:
+          name: python-package-distributions
+          path: dist
+
+      - name: Revalidate downloaded distributions
+        run: |
+          python scripts/release_contract.py \
+            --event-name "${{ github.event_name }}" \
+            --ref-type "${{ github.ref_type }}" \
+            --ref-name "${{ github.ref_name }}" \
+            --dist-dir dist
+
+      - name: Install sdist in a fresh environment
+        run: |
+          uv venv .smoke-sdist
+          uv pip install --python .smoke-sdist/bin/python dist/*.tar.gz
+          .smoke-sdist/bin/python scripts/smoke_installed_package.py
+          .smoke-sdist/bin/bareagent --help
+
+  publish-to-pypi:
+    name: Publish to PyPI
+    if: github.event_name == 'push' && github.ref_type == 'tag'
+    needs: [quality, build, smoke-wheel, smoke-sdist]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/bareagent-cli
+    permissions:
+      id-token: write
+    steps:
+      - name: Download validated distributions
+        uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
+        with:
+          name: python-package-distributions
+          path: dist
+
+      - name: Publish to PyPI with Trusted Publishing
+        uses: pypa/gh-action-pypi-publish@ba38be9e461d3875417946c167d0b5f3d385a247 # release/v1
+        with:
+          packages-dir: dist/
+
+  publish-to-testpypi:
+    name: Publish to TestPyPI (dry run)
+    if: github.event_name == 'workflow_dispatch'
+    needs: [quality, build, smoke-wheel, smoke-sdist]
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/bareagent-cli
+    permissions:
+      id-token: write
+    steps:
+      - name: Download validated distributions
+        uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6
+        with:
+          name: python-package-distributions
+          path: dist
+
+      - name: Publish to TestPyPI with Trusted Publishing
+        uses: pypa/gh-action-pypi-publish@ba38be9e461d3875417946c167d0b5f3d385a247 # release/v1
+        with:
+          packages-dir: dist/
+          repository-url: https://test.pypi.org/legacy/

bareagent_cli-0.2.0/.trellis/scripts/__init__.py

@@ -0,0 +1,5 @@
+"""
+Trellis Python Scripts
+
+This module provides Python implementations of Trellis workflow scripts.
+"""