Skip to content

Run CI Gates and Publish artefacts

Context

Local workflows must match CI behavior. The pipeline should run deterministic checks for PRs and produce publishable outputs on main.

Goal

Provide CI gates for quality, and publish bilingual site outputs (Zensical-first).

Steps

  1. PR pipeline: 2) Run formatting in check mode. 3) Run lint rules and i18n lint. 4) Run trace scan and coverage.
  2. Main pipeline: 6) Run PR gates. 7) Build sites for EN and DE via Zensical. 8) Upload artefacts and/or deploy to GitHub Pages.

Outputs

  • CI status (pass/fail) with actionable diagnostics
  • Site artefacts for EN and DE
  • Optional deployment to GitHub Pages (EN root, DE under /de)

Failure Modes

  • External tool not available (Zensical, renderer).
  • Non-deterministic outputs causing CI noise.
  • Missing translation or drift fails i18n checks (if enforced).
  • arqix fmt --check
  • arqix lint run
  • arqix trace scan
  • arqix trace coverage
  • arqix publish site --lang en|de

Automation

  • CI: .github/workflows/ci.yml runs the build, cargo tests, the dogfooded arqix verify (the corpus gate), markdownlint, and the Rust lints on every PR and push to main
  • just: just ci mirrors the pipeline locally