cleveragents/cleveragents-core
4
0
Fork 3
Code Issues 6.0k Pull Requests 115 Actions Packages Projects Releases Wiki Activity

feat(ci): CI/CD pipeline definitions (#983)
CI / build (push) Successful in 21s
Details
CI / lint (push) Successful in 3m30s
Details
CI / typecheck (push) Successful in 3m55s
Details
CI / benchmark-regression (push) Has been skipped
Details
CI / security (push) Successful in 3m57s
Details
CI / quality (push) Successful in 3m59s
Details
CI / integration_tests (push) Successful in 5m52s
Details
CI / e2e_tests (push) Successful in 8m15s
Details
CI / coverage (push) Failing after 13m33s
Details
CI / unit_tests (push) Failing after 17m29s
Details
CI / benchmark-publish (push) Successful in 19m11s
Details
CI / docker (push) Has been skipped
Details
CI / status-check (push) Failing after 3s
Details

Browse Source 
## Summary

Complete CI/CD pipeline definitions: release workflow, caching, status-check consolidation, and documentation.

### Changes

**New: Release pipeline** (`.forgejo/workflows/release.yml`):
- Triggered on `v*` tags
- 3 jobs: `build-wheel` → `build-docker` → `create-release`
- Builds wheel via `nox -s build`, Docker image via multi-stage Dockerfile
- Creates Forgejo release via API with wheel artifact attached
- Configurable registry push via `REGISTRY_*` secrets

**Updated: CI pipeline** (`.forgejo/workflows/ci.yml`):
- Added `actions/cache@v3` for `~/.cache/uv` on all 8 primary jobs (keyed on `pyproject.toml` hash)
- Added `status-check` consolidation job depending on all required checks — single gate for branch protection

**Updated: CONTRIBUTING.md**:
- New CI/CD section: pipeline overview, job table, required merge checks, release process, secrets documentation

**Tests**:
- 13 new Behave scenarios validating workflow YAML structure, tag triggers, job definitions, dependencies
- 9 new Robot tests validating file existence, content, nox session references

### Quality Gates

| Session | Result |
|---|---|
| `nox -s lint` | PASS |
| `nox -s typecheck` | PASS (0 errors) |
| `nox -s unit_tests` | PASS (10,819 scenarios) |
| `nox -s coverage_report` | 97.9% (>= 97%) |

Closes #858

Reviewed-on: #983
Co-authored-by: Brent E. Edwards <brent.edwards@cleverthis.com>
Co-committed-by: Brent E. Edwards <brent.edwards@cleverthis.com>
This commit was merged in pull request #983.
This commit is contained in:
Brent Edwards
2026-03-21 00:29:49 +00:00
committed by Forgejo
parent fa3f2d6365
commit 00897be24a
6 changed files with 528 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.forgejo/workflows/ci.yml
+92
View File
@@ -27,6 +27,14 @@ jobs:
run: |
pip install -q uv==${{ env.UV_VERSION }} nox
- name: Cache uv packages
uses: actions/cache@v3
with:
path: ~/.cache/uv
key: uv-lint-${{ hashFiles('pyproject.toml') }}
restore-keys: |
uv-lint-
- name: Run lint via nox
run: |
nox -s lint
@@ -54,6 +62,14 @@ jobs:
run: |
pip install -q uv==${{ env.UV_VERSION }} nox
- name: Cache uv packages
uses: actions/cache@v3
with:
path: ~/.cache/uv
key: uv-typecheck-${{ hashFiles('pyproject.toml') }}
restore-keys: |
uv-typecheck-
- name: Run typecheck via nox
run: |
nox -s typecheck
@@ -75,6 +91,14 @@ jobs:
run: |
pip install -q uv==${{ env.UV_VERSION }} nox
- name: Cache uv packages
uses: actions/cache@v3
with:
path: ~/.cache/uv
key: uv-security-${{ hashFiles('pyproject.toml') }}
restore-keys: |
uv-security-
- name: Run security scan via nox
run: |
nox -s security_scan
@@ -102,6 +126,14 @@ jobs:
run: |
pip install -q uv==${{ env.UV_VERSION }} nox
- name: Cache uv packages
uses: actions/cache@v3
with:
path: ~/.cache/uv
key: uv-quality-${{ hashFiles('pyproject.toml') }}
restore-keys: |
uv-quality-
- name: Run complexity check via nox
run: |
nox -s complexity
@@ -123,6 +155,14 @@ jobs:
run: |
pip install -q uv==${{ env.UV_VERSION }} nox
- name: Cache uv packages
uses: actions/cache@v3
with:
path: ~/.cache/uv
key: uv-tests-${{ hashFiles('pyproject.toml') }}
restore-keys: |
uv-tests-
- name: Run unit tests via nox
run: |
nox -s unit_tests
@@ -144,6 +184,14 @@ jobs:
run: |
pip install -q uv==${{ env.UV_VERSION }} nox
- name: Cache uv packages
uses: actions/cache@v3
with:
path: ~/.cache/uv
key: uv-tests-${{ hashFiles('pyproject.toml') }}
restore-keys: |
uv-tests-
- name: Run integration tests via nox
run: |
nox -s integration_tests
@@ -171,6 +219,14 @@ jobs:
run: |
pip install -q uv==${{ env.UV_VERSION }} nox
- name: Cache uv packages
uses: actions/cache@v3
with:
path: ~/.cache/uv
key: uv-tests-${{ hashFiles('pyproject.toml') }}
restore-keys: |
uv-tests-
- name: Run E2E tests via nox
run: |
nox -s e2e_tests
@@ -196,6 +252,14 @@ jobs:
run: |
pip install -q uv==${{ env.UV_VERSION }} nox
- name: Cache uv packages
uses: actions/cache@v3
with:
path: ~/.cache/uv
key: uv-coverage-${{ hashFiles('pyproject.toml') }}
restore-keys: |
uv-coverage-
- name: Run coverage report via nox (fail-under 97%)
id: coverage
run: |
@@ -396,3 +460,31 @@ jobs:
- name: Test Docker image
run: |
docker run --rm cleverernie:test --version
status-check:
if: always()
needs: [lint, typecheck, security, quality, unit_tests, coverage, build, docker]
runs-on: docker
container:
image: python:3.13-slim
steps:
- name: Check required job results
run: |
echo "lint: ${{ needs.lint.result }}"
echo "typecheck: ${{ needs.typecheck.result }}"
echo "security: ${{ needs.security.result }}"
echo "quality: ${{ needs.quality.result }}"
echo "unit_tests: ${{ needs.unit_tests.result }}"
echo "coverage: ${{ needs.coverage.result }}"
echo "build: ${{ needs.build.result }}"
echo "docker: ${{ needs.docker.result }}"
if [ "${{ needs.lint.result }}" != "success" ] || \
[ "${{ needs.typecheck.result }}" != "success" ] || \
[ "${{ needs.security.result }}" != "success" ] || \
[ "${{ needs.unit_tests.result }}" != "success" ] || \
[ "${{ needs.coverage.result }}" != "success" ]; then
echo "FAILED: One or more required jobs did not succeed"
exit 1
fi
echo "All required CI checks passed"