10.01 — Workflow summary matrix

10.01 — Workflow summary matrix#

Synthetic overview of every ecosystem workflow.

Recap#

RepoWorkflowTriggerOSStackEffectDetail
ocarinamain_ci.ymlpush/PR main, dispatchubuntu + windows × py 3.14 (option 3.15-dev)venv cache, make install-on-cimake check-coding-style + make test + Allure history + Pages deploy02-ocarina-workflows.md
ocarinadev_ci.ymlpush dev/feature/fix, PR dev, dispatchubuntu × py 3.14venv cachecheck-coding-style + test + coverage summary (non-gating)02-ocarina-workflows.md
ocarinaunstable_python_full_build.ymlcron (monthly), dispatchubuntu + windows × py 3.15-devPIP_ONLY_BINARY=":all:"full build on pre-release Python02-ocarina-workflows.md
ocarina-examplemain_ci.ymlpush/PR main, dispatchubuntu + windows × py 3.14venv cachecheck-coding-style03-example-workflows.md
ocarina-exampledev_ci.ymlpush dev, dispatchubuntu × py 3.14venv cachecheck-coding-style03-example-workflows.md
ocarina-examplee2e.ymldispatch (env OC)ubuntu + service redis:8.x + Firefox + geckodriver 0.35.0venv cachefull run, upload traces03-example-workflows.md
ocarina-with-ai-exampleai_proof_ci.ymlpush main, PR, dispatchubuntu × py 3.14venv cacheruff format check + ruff check + mypy04-ai-workflows.md
ocarina-with-ai-exampleai_proof_e2e.ymldispatchubuntu × firefox+chrome matrixvenv cache, geckodriver 0.36.0 / auto-matched chromedriverHeroku dyno warm-up, run, sed-filter ChromeDriver stacktraces, upload04-ai-workflows.md
igoristanci-pr.ymlPR **, dispatchubuntu × node 24 + pnpm 11wireitformat check + lint + typecheck (parallelized)05-igoristan-workflows.md
igoristandeploy.ymlpush main, dispatchubuntu × node 24 + pnpm 11concurrency group pagespnpm install --frozen-lockfile + pnpm build + upload Pages05-igoristan-workflows.md
ocarina-holy-bookdeploy.ymlpush main, PR, dispatchubuntu × node 24 + pnpm 11TZ=Europe/Paris, concurrency group pagespnpm install + pnpm build + upload Pages06-holy-book-workflow.md
tests-workersnone —  — Vercelvercel deploy07-tests-workers-vercel.md

Composite action#

ActionLocationUse
allure-historyocarina/.github/actions/allure-history/action.ymlComposite: Bun + Allure 3.9.0 + restore/save history.jsonl on a dedicated branch

Patterns#

PR workflows (light, auto)#

ocarina/main_ci.yml                                       # python 3.14
ocarina/dev_ci.yml
ocarina-example/main_ci.yml
ocarina-example/dev_ci.yml
ocarina-with-ai-example/ai_proof_ci.yml
igoristan/ci-pr.yml

All run fast.

10.02 — ocarina workflows (framework)

10.02 — ocarina workflows (framework)#

Three workflows: main_ci.yml (production), dev_ci.yml (dev/feature/fix branches), unstable_python_full_build.yml (monthly cron on Python 3.15-dev).

main_ci.yml#

Trigger#

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
  workflow_dispatch:
    inputs:
      python_versions:
        description: "Python versions to test"
        type: choice
        required: false
        default: "Stable only"
        options:
          - "Stable only"
          - "Stable + unstable (uses pre-built wheels)"

workflow_dispatch with a Python-version choice. Lets the user trigger a build with 3.15-dev (pre-built wheels only) without waiting for the monthly cron.

10.03 — ocarina-example workflows

10.03 — ocarina-example workflows#

See also ../07-ocarina-example/11-ci.md

Overview#

WorkflowTriggerOSEffectNote
main_ci.ymlpush/PR main, dispatchubuntu + windows × py 3.14make check-coding-style (mypy + ruff).Fast PR gate
dev_ci.ymlpush dev, dispatchubuntu × py 3.14SameFor dev branches
e2e.ymlworkflow_dispatch (env OC)ubuntu + Redis service + Firefox + geckodriver 0.35.0Full suite run + upload .screenshots/ .ocarina_logs/ .reports/Manual only

vs ocarina/main_ci.yml#

Aspectocarina/main_ci.ymlocarina-example/main_ci.yml
Unit testsYes (pytest + cram)No
Allure historyYesNo
GitHub Pages deployYes (Allure report)No
OS matrixYes (ubuntu + windows)Yes (same)
Python matrixOptional (3.14 or 3.14+3.15)No (3.14 only)

ocarina tests itself (unit tests) in CI. ocarina-example only runs static checks in CI; its e2e tests are fired on demand via e2e.yml.

10.04 — ocarina-with-ai-example workflows

10.04 — ocarina-with-ai-example workflows#

See also ../08-ai-example/09-ci-matrix.md

Overview#

WorkflowTriggerOSEffectNote
ai_proof_ci.ymlpush main, PR, dispatchubuntu × py 3.14ruff format src/ --check + ruff check src/ + mypy src/PR gate, fast
ai_proof_e2e.ymldispatchubuntu × firefox+chrome matrixHeroku warm-up + run + sed filter ChromeDriver C++ stacks + uploadManual only

Differences vs ocarina-example#

Aspectocarina-exampleocarina-with-ai-example
Browser matrixFirefox only (e2e.yml)Firefox + Chrome (parallelized)
SUTIgoristan (GitHub Pages)CURA (Heroku eco-dyno)
Pre-runwarm-up Redis clientwarm-up Heroku dyno
Output filternonesed filters ChromeDriver C++ stack frames
WAIT_TIMEOUTdefault 1015 (compensates for Heroku latency)

Heroku warm-up#

curl -sf --retry 6 --retry-delay 5 --retry-all-errors \
  --max-time 30 https://katalon-demo-cura.herokuapp.com/ > /dev/null
echo "Dyno is warm"

CURA runs on a Heroku dyno that sleeps after inactivity. Tests hitting a cold dyno produce timeouts (false fails) and slow confirmations (false passes on gap tests). Wake it explicitly before any browser opens.

10.05 — igoristan workflows

10.05 — igoristan workflows#

See also ../05-igoristan/07-ci-deploy.md

Overview#

WorkflowTriggerOSEffectNote
ci-pr.ymlPR **, dispatchubuntu × node 24 + pnpm 103 parallelized jobs: wireit ci:format-check + wireit lint + wireit typecheckPR gate
deploy.ymlpush main, dispatchubuntu × node 24 + pnpm 10pnpm install --frozen-lockfile + pnpm build + upload PagesProduction

ci-pr.yml#

jobs:
  format-check:
    env:
      WIREIT_CACHE: github
    steps:
      - uses: actions/checkout@v6
      - uses: pnpm/action-setup@v5
        with: { version: 11 }
      - uses: actions/setup-node@v6
        with: { node-version: 24, cache: "pnpm" }
      - uses: google/wireit@setup-github-actions-caching/v2
      - run: make install
      - name: Formatcheck
        run: make ci:format-check

  lint:
    env:
      WIREIT_CACHE: github
    steps:
      # ... same setup ...
      - uses: actions/cache@v5
        with:
          path: .eslintcache
          key: eslint-cache-${{ hashFiles('eslint.config.ts', 'src/**/*.*', 'package.json') }}
      - name: Lint
        run: pnpm lint

  typecheck:
    env:
      WIREIT_CACHE: github
    steps:
      # ... same setup ...
      - name: Typecheck
        run: pnpm typecheck
JobAdditional cache
format-checkwireit
lintwireit + .eslintcache (actions/cache)
typecheckwireit + tsbuildinfo (via wireit)

WIREIT_CACHE: github#

env:
  WIREIT_CACHE: github
steps:
  - uses: google/wireit@setup-github-actions-caching/v2

Enables the wireit cache. Subsequent runs reuse wireit artifacts.

10.06 — ocarina-holy-book workflow

10.06 — ocarina-holy-book workflow#

A single workflow: deploy.yml. On push main → VitePress build → upload Pages.

Code#

name: Deploy Ocarina Holy Book

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
  workflow_dispatch:

env:
  TZ: Europe/Paris

permissions:
  contents: read
  pages: write
  id-token: write

concurrency:
  group: pages
  cancel-in-progress: false

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 0 # ← full clone

      - uses: pnpm/action-setup@fcf821c621167805dd63a29662bd7cb5676c81a8
        name: Install pnpm
        with:
          version: 11

      - name: Use Node.js
        uses: actions/setup-node@v6
        with:
          node-version: 24
          cache: "pnpm"

      - name: Install dependencies
        run: pnpm install --frozen-lockfile

      - name: Build
        run: pnpm build

      - uses: actions/upload-pages-artifact@v4
        with:
          path: docs/.vitepress/dist

  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - id: deployment
        uses: actions/deploy-pages@v5

Analysis#

1. TZ: Europe/Paris#

env:
  TZ: Europe/Paris

Forces the runner timezone to Europe/Paris. Dates rendered by VitePress ("Last update: 05/18/2026 11h42") are in Paris time, not UTC. Leaving it in UTC would cause mysterious date bugs.

10.07 — tests-workers: no GitHub CI, auto Vercel deploy

10.07 — tests-workers: no GitHub CI, auto Vercel deploy#

The only repo in the ecosystem without a GitHub Actions workflow. Everything goes through Vercel.

Content of .github/#

tests-workers/
└── (no .github/ — no workflows)

No ci.yml. No deploy.yml. No GitHub action.

vercel.json#

{
  "version": 2,
  "buildCommand": "echo 'No build required'",
  "outputDirectory": ".",
  "framework": null
}

Vercel detects the project as TypeScript Edge Functions, builds on the fly (transpiles TS at runtime).

package.json#scripts#

{
  "scripts": {
    "vercel-build": "echo 'Build skipped'"
  }
}

vercel-build hook: echo no-op.
Vercel doesn’t try to build.