quality-gate — Shift-Left Local Quality Gates

Pre-commit & pre-push hooks. Zero project files. Install once, use everywhere.

Install

npm install -g github:hpuhsp/quality-gate

Usage

cd my-project
quality-gate enable       # Activate hooks
quality-gate status       # Show status + project detection
quality-gate gen-tests    # AI generate tests for changed code
quality-gate disable      # Deactivate hooks

What it checks

pre-commit (< 5s, deterministic, no API):

• Secret scan (AWS keys, private keys, tokens, passwords)
• Auto-format (ktlint for Kotlin, prettier for JS)

pre-push (< 2min, deterministic, no API):

• Unit tests (JUnit5 for Kotlin/Java, Vitest/Jest for JS)
• Coverage threshold (default 60%)

gen-tests (requires API, on-demand):

• AI generates unit tests for changed source files
• Needs ANTHROPIC_API_KEY environment variable
• Usage: quality-gate gen-tests [target-file]

Multi-project config

# Team-wide config from a shared GitLab repo:
export QG_REMOTE_REPO=https://gitlab.com/ci/shared-pipeline.git
quality-gate enable

Architecture

Same as the CI pipeline — "install once, use everywhere":

• CI: Docker Runner image + include:project
• Local: npm global install + git core.hooksPath