← Back
devagrawal09

devagrawal09/jev-review

A staged code-review workflow and local dashboard built with TypeSafe Jev.

View on GitHub ↗
aicode-reviewjevtypesafe-aitypescript
Stars
653
Forks
43
Watchers
653
Open issues
7
Contributors
1
Language
TypeScript
License
MIT License
Default branch
main
Created Sep 16, 2026Updated Sep 17, 2026

Star growth

Today—
This week—
This month—

Star history will appear here once this repo has been tracked for a couple of days.

README

Jev Review

A small code-review workflow built with TypeSafe Jev. It can review a Git diff or scan a complete codebase, follows the strongest structured signals through focused model calls, and presents the result in a quiet local dashboard.

Jev Review dashboard

How It Works

The reviewer keeps orchestration in code and uses Jev for bounded judgments:

Noul risk matrix
  -> Choice + Score file profiles
  -> Choice evidence selection
  -> Choice mechanism classification
  -> Score severity
  -> conditional Choice reviewer routing
  • Exposes separate change-review and complete-codebase entry points.
  • Uses changed or related tests as context when judging test gaps.
  • Screens correctness, security, reliability, compatibility, and test coverage.
  • Selects concrete diff hunks or source regions before scoring impact.
  • Uses structured hints, counterexamples, and explicit decision boundaries.
  • Applies thresholds and workflow policy in code.
  • Shows large reports in collapsible dashboard sections.
  • Binds the dashboard to 127.0.0.1 and never serves environment files.

Quick Start

Requires Node.js 24+, Git, and a TypeSafe API key.

npm install
cp .env.example .env
# Add TYPESAFE_API_KEY to .env

# Review the current Git diff
npm run review:changes:save -- /path/to/git/repository

# Or scan every non-ignored source file under a scope
npm run review:codebase:save -- /path/to/git/repository-or-package
npm run dashboard

Open http://127.0.0.1:4317.

Commands

Command Purpose
npm run review:changes -- <path> Print a current-diff review as JSON
npm run review:changes:save -- <path> Save a current-diff review for the dashboard
npm run review:codebase -- <path> Print a complete codebase scan as JSON
npm run review:codebase:save -- <path> Save a complete codebase scan for the dashboard
npm run dashboard Start the local dashboard
npm run check Typecheck, verify dependency flow, and syntax-check the dashboard client

Architecture

Everything lives under src/, arranged in layers that only depend downward:

src/
  domain/      config.ts, types.ts, patch.ts   shared policy, report shapes, diff parsing
  adapters/    git.ts, repository-files.ts     change and complete-source discovery
               report-store.ts                 atomic report save/load
  review/      changes.ts, codebase.ts          mode-specific workflows
               *-judgments.ts, workflow.ts     Jev calls and shared staged orchestration
  cli/         review-*.ts, save-*.ts           explicit mode entry points
  dashboard/   server.ts, public/              local-only HTTP server and the plain client

Imports point toward lower layers only:

{ cli, dashboard } -> review -> adapters -> domain

scripts/check-dependencies.ts fails npm run check on any upward import, any import between cli and dashboard, or any cycle.

Current Scope

This is an experiment in composing fast typed judgments into a review workflow. It does not yet integrate compiler diagnostics, static analyzers, repository indexing, or generated explanations. Findings are review prompts, not proof of a defect.

License

MIT