Chapter 10 — CI/CD across the whole ecosystem on Ocarina — manual

10.01 — Workflow summary matrix

Wed, 20 May 2026 00:00:00 +0000

10.01 — Workflow summary matrix#

Synthetic overview of every ecosystem workflow.

Recap#

Repo	Workflow	Trigger	OS	Stack	Effect	Detail
`ocarina`	`main_ci.yml`	push/PR main, dispatch	ubuntu + windows × py 3.14 (option 3.15-dev)	venv cache, make install-on-ci	make check-coding-style + make test + Allure history + Pages deploy	`02-ocarina-workflows.md`
`ocarina`	`dev_ci.yml`	push dev/feature/fix, PR dev, dispatch	ubuntu × py 3.14	venv cache	check-coding-style + test + coverage summary (non-gating)	`02-ocarina-workflows.md`
`ocarina`	`unstable_python_full_build.yml`	cron (monthly), dispatch	ubuntu + windows × py 3.15-dev	`PIP_ONLY_BINARY=":all:"`	full build on pre-release Python	`02-ocarina-workflows.md`
`ocarina-example`	`main_ci.yml`	push/PR main, dispatch	ubuntu + windows × py 3.14	venv cache	check-coding-style	`03-example-workflows.md`
`ocarina-example`	`dev_ci.yml`	push dev, dispatch	ubuntu × py 3.14	venv cache	check-coding-style	`03-example-workflows.md`
`ocarina-example`	`e2e.yml`	dispatch (env `OC`)	ubuntu + service `redis:8.x` + Firefox + geckodriver 0.35.0	venv cache	full run, upload traces	`03-example-workflows.md`
`ocarina-with-ai-example`	`ai_proof_ci.yml`	push main, PR, dispatch	ubuntu × py 3.14	venv cache	ruff format check + ruff check + mypy	`04-ai-workflows.md`
`ocarina-with-ai-example`	`ai_proof_e2e.yml`	dispatch	ubuntu × firefox+chrome matrix	venv cache, geckodriver 0.36.0 / auto-matched chromedriver	Heroku dyno warm-up, run, sed-filter ChromeDriver stacktraces, upload	`04-ai-workflows.md`
`igoristan`	`ci-pr.yml`	PR `**`, dispatch	ubuntu × node 24 + pnpm 11	wireit	format check + lint + typecheck (parallelized)	`05-igoristan-workflows.md`
`igoristan`	`deploy.yml`	push main, dispatch	ubuntu × node 24 + pnpm 11	concurrency group `pages`	`pnpm install --frozen-lockfile` + `pnpm build` + upload Pages	`05-igoristan-workflows.md`
`ocarina-holy-book`	`deploy.yml`	push main, PR, dispatch	ubuntu × node 24 + pnpm 11	`TZ=Europe/Paris`, concurrency group `pages`	`pnpm install` + `pnpm build` + upload Pages	`06-holy-book-workflow.md`
`tests-workers`	none	—	—	Vercel	`vercel deploy`	`07-tests-workers-vercel.md`

Composite action#

Action	Location	Use
`allure-history`	`ocarina/.github/actions/allure-history/action.yml`	Composite: 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)

Wed, 20 May 2026 00:00:00 +0000

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

Wed, 20 May 2026 00:00:00 +0000

10.03 — `ocarina-example` workflows#

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

Overview#

Workflow	Trigger	OS	Effect	Note
`main_ci.yml`	push/PR main, dispatch	ubuntu + windows × py 3.14	`make check-coding-style` (mypy + ruff).	Fast PR gate
`dev_ci.yml`	push dev, dispatch	ubuntu × py 3.14	Same	For dev branches
`e2e.yml`	`workflow_dispatch` (env `OC`)	ubuntu + Redis service + Firefox + geckodriver 0.35.0	Full suite run + upload `.screenshots/` `.ocarina_logs/` `.reports/`	Manual only

vs `ocarina/main_ci.yml`#

Aspect	`ocarina/main_ci.yml`	`ocarina-example/main_ci.yml`
Unit tests	Yes (pytest + cram)	No
Allure history	Yes	No
GitHub Pages deploy	Yes (Allure report)	No
OS matrix	Yes (ubuntu + windows)	Yes (same)
Python matrix	Optional (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

Wed, 20 May 2026 00:00:00 +0000

10.04 — `ocarina-with-ai-example` workflows#

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

Overview#

Workflow	Trigger	OS	Effect	Note
`ai_proof_ci.yml`	push main, PR, dispatch	ubuntu × py 3.14	`ruff format src/ --check` + `ruff check src/` + `mypy src/`	PR gate, fast
`ai_proof_e2e.yml`	dispatch	ubuntu × firefox+chrome matrix	Heroku warm-up + run + sed filter ChromeDriver C++ stacks + upload	Manual only

Differences vs `ocarina-example`#

Aspect	`ocarina-example`	`ocarina-with-ai-example`
Browser matrix	Firefox only (e2e.yml)	Firefox + Chrome (parallelized)
SUT	Igoristan (GitHub Pages)	CURA (Heroku eco-dyno)
Pre-run	warm-up Redis client	warm-up Heroku dyno
Output filter	none	sed filters ChromeDriver C++ stack frames
`WAIT_TIMEOUT`	default 10	15 (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

Wed, 20 May 2026 00:00:00 +0000

10.05 — `igoristan` workflows#

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

Overview#

Workflow	Trigger	OS	Effect	Note
`ci-pr.yml`	PR `**`, dispatch	ubuntu × node 24 + pnpm 10	3 parallelized jobs: `wireit ci:format-check` + `wireit lint` + `wireit typecheck`	PR gate
`deploy.yml`	push main, dispatch	ubuntu × node 24 + pnpm 10	`pnpm install --frozen-lockfile` + `pnpm build` + upload Pages	Production

`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

Job	Additional cache
`format-check`	wireit
`lint`	wireit + `.eslintcache` (actions/cache)
`typecheck`	wireit + `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

Wed, 20 May 2026 00:00:00 +0000

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

Wed, 20 May 2026 00:00:00 +0000

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.

Chapter 10 — CI/CD across the whole ecosystem on Ocarina — manual

10.01 — Workflow summary matrix

10.01 — Workflow summary matrix#

Recap#

Composite action#

Patterns#

PR workflows (light, auto)#

10.02 — ocarina workflows (framework)

10.02 — ocarina workflows (framework)#

main_ci.yml#

Trigger#

10.03 — ocarina-example workflows

10.03 — ocarina-example workflows#

Overview#

vs ocarina/main_ci.yml#

10.04 — ocarina-with-ai-example workflows

10.04 — ocarina-with-ai-example workflows#

Overview#

Differences vs ocarina-example#

Heroku warm-up#

10.05 — igoristan workflows

10.05 — igoristan workflows#

Overview#

ci-pr.yml#

WIREIT_CACHE: github#

10.06 — ocarina-holy-book workflow

10.06 — ocarina-holy-book workflow#

Code#

Analysis#

1. TZ: Europe/Paris#

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

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

Content of .github/#

vercel.json#

package.json#scripts#

10.02 — `ocarina` workflows (framework)#

`main_ci.yml`#

10.03 — `ocarina-example` workflows#

vs `ocarina/main_ci.yml`#

10.04 — `ocarina-with-ai-example` workflows#

Differences vs `ocarina-example`#

10.05 — `igoristan` workflows#

`ci-pr.yml`#

`WIREIT_CACHE: github`#

10.06 — `ocarina-holy-book` workflow#

1. `TZ: Europe/Paris`#

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

Content of `.github/`#

`vercel.json`#

`package.json#scripts`#