How gulbaki/jev-llm-guard works
Jev Guard is both a contextual LLM guardrail library and a demo application. Its main workflow accepts text plus trusted task and application context, validates those inputs, asks Jev System One for OWASP risk signals (with optional quotation clarification), applies a versioned policy, and returns an allow/review/block result with per-risk assessments. The browser demo adds origin checks and quotas before evaluation, then presents the result. The README also documents a CLI scenario demo and a separate research-evaluation capability. Some links are based on documented behavior or indexed imports because not every implementation was excerpted.
Main entry points: guard.js Guardrail evaluator · web-server.js Demo HTTP server · app.js Browser app · demo.js Scenario demo
Components 20
Web demo
- Browser app
web/app.js - API response reader
web/api.js - Demo HTTP server
src/web-server.js - Demo quotas
src/demo-quota.js
Guardrail engine
- Input validation
src/context.js - Guardrail evaluator
src/guard.js - Quotation clarification
src/quotation.js - Decision policy
src/policy.js
Evaluation tools
- Guard CLI
src/cli.js - Scenario demo
src/demo.js - Demo scenarios
src/scenarios.js - HTML report
src/report.js - Research evaluator CLI
bin/jev-research-eval.js - Research cases
src/research-cases.js - Quotation cases
src/quotation-cases.js - Research evaluation
src/research-eval.js
Result presentation
- Result view model
web/view.js
Other components
- Demo user
- Upstash Redis
- Jev System One
Connections 21
- Demo user → Browser app: submits text
README.md - Browser app → Demo HTTP server: posts evaluation
web/app.js - Demo HTTP server → Demo quotas: reserves quota
src/web-server.js - Demo quotas → Upstash Redis: stores counters
README.md - Demo HTTP server → Input validation: validates input
src/web-server.js - Demo HTTP server → Guardrail evaluator: evaluates request
src/web-server.js - Guardrail evaluator → Input validation: validates input
src/guard.js - Guardrail evaluator → Jev System One: requests risk scores
src/guard.js - Guardrail evaluator → Quotation clarification: clarifies quotes
src/guard.js - Guardrail evaluator → Decision policy: applies policy
src/guard.js - Demo HTTP server → Browser app: returns result
README.md - Browser app → API response reader: checks response
web/app.js - Browser app → Result view model: builds display
web/app.js - Guard CLI → Guardrail evaluator: evaluates text
src/cli.js - Scenario demo → Demo scenarios: runs scenarios
src/demo.js - Demo scenarios → Guardrail evaluator: evaluates cases
src/scenarios.js - Scenario demo → HTML report: writes report
src/demo.js - Research evaluator CLI → Research cases: selects cases
bin/jev-research-eval.js - Research evaluator CLI → Research evaluation: evaluates cases
bin/jev-research-eval.js - Research evaluation → Guardrail evaluator: evaluates cases
src/research-eval.js - Research cases → Quotation cases: uses suite
src/research-cases.js