Workflow¶

Who this is for: maintainers and contributors who want to understand the CI gate matrix, the pre-commit hook, and the branch + release flow.

In this section¶

Page	What it covers
CI gates	Every check that runs on a PR, what fails it, where to look for the log
Pre-commit hook	12 quality gates run in parallel before any commit lands locally
Pre-push hook	Opt-in PR-body validator mirroring the `Validate PR body sections` CI gate
Branch flow & release-please	Branch policy, PR rules, release-please automated versioning
Code-review tooling	How to query CodeRabbit + SonarCloud findings via API + the OSS rate-limit posture in `.coderabbit.yaml`

Two lines of defense¶

flowchart LR
    DEV[Developer
git commit]
    PCH[Pre-commit hook
12 gates parallel
~3-5 min]
    PR[Push + PR]
    CI[GitHub Actions
same gates + bank-tests]
    MERGE[Squash merge]
    RP[release-please]
    PUB[npm publish]

    DEV --> PCH
    PCH -.->|"fail"| DEV
    PCH -->|"pass"| PR
    PR --> CI
    CI -.->|"fail"| DEV
    CI -->|"pass"| MERGE
    MERGE --> RP --> PUB

The pre-commit hook gives developers fast local feedback (3-5 min); the CI re-runs the same gates as a second safety net. Either failing rolls back the change.