Q-GATE

A Jev-powered quality gate for GitHub issues, pull requests, and commits.

Q-GATE turns repository activity into typed, explainable decisions. It uses TypeSafe AI's Jev/System One model when configured, applies deterministic policy thresholds, and keeps humans in control through review, calibration, and policy simulation.

What it does

• Analyzes a public GitHub repository's latest commit, issue, or pull request
• Produces an auto_approved, needs_review, or blocked decision
• Shows confidence, severity, category, rationale, and atomic decision signals
• Supports human approval/block decisions and review notes
• Tracks agreement and false-approval calibration metrics
• Simulates policy changes against historical runs before applying them
• Supports shadow mode for evaluating Jev without changing live decisions
• Falls back to deterministic heuristics when Jev is unavailable
• Persists analysis and calibration history across server restarts

How it works

Public GitHub URL
       |
       v
GitHub issue / pull request / latest commit
       |
       +----------------------+
       |                      |
       v                      v
Heuristic evaluator     Jev/System One
       |                      |
       +----------+-----------+
                  |
                  v
       Deterministic policy layer
                  |
                  v
  Decision + confidence + risk + signals
                  |
                  v
       Human review and calibration

The model evaluates repository evidence. Q-GATE's policy layer decides what the evaluation means operationally. This separation keeps thresholds explicit, auditable, and testable.

Stack

• React 19, Vite, TypeScript, Tailwind CSS
• TanStack Query and Recharts
• Express 5 and Zod
• OpenAPI with generated React Query clients and validation schemas
• Drizzle ORM
• TypeSafe AI Jev/System One
• pnpm workspace monorepo

Repository structure

artifacts/
  github-quality-gate/  React dashboard
  api-server/           Express API
lib/
  api-spec/             OpenAPI contract and code generation
  api-client-react/     Generated React Query client
  api-zod/              Generated Zod schemas
  db/                   Persistence layer
scripts/                Workspace utilities

Local development

Requirements:

• Node.js 20+
• pnpm

Install dependencies:

pnpm install

Run the API:

PORT=8080 pnpm --filter @workspace/api-server run dev

Run the web app in another terminal:

PORT=5173 BASE_PATH=/ pnpm --filter @workspace/github-quality-gate run dev

Run type checks:

pnpm run typecheck

Jev configuration

Q-GATE supports TypeSafe Jev through either:

• AI_GATEWAY_API_KEY for Vercel AI Gateway
• TYPESAFE_API_KEY for direct TypeSafe access

Keep credentials in environment variables or a secret manager. Never commit them to the repository. If neither provider is configured, Q-GATE continues with its deterministic heuristic evaluator.

API

The API contract lives in lib/api-spec/openapi.yaml. After changing it, regenerate clients and schemas:

pnpm --filter @workspace/api-spec run codegen

License

MIT