Repository navigation
DevGuard v1.0.0: Initial Release
Initial public release of DevGuard, an adversarial code review and security gatekeeper powered by Google Gemini 3.8 Flash and deterministic AST heuristics.
🛡️ Key Features
- Dual-Layer Evaluation Engine:
- Layer 1 (Offline / Deterministic): AST & heuristic analysis detecting dangerous sinks, missing type checks, and TOCTOU vulnerabilities with zero API dependency.
- Layer 2 (Semantic Reasoning): Adversarial analysis via Gemini 3.8 Flash evaluating untrusted snippets inside
<code_to_review>data isolation tags.
- Zero-Gimmick Scoring: Eliminates hardcoded bypasses and applies realistic scoring (93–95/100 caps) with actionable Defense-in-Depth architectural recommendations.
- Hardened Vulnerability Presets:
- Banking Ledger (Python): Strict type guards (
type(x) is int) and atomic conditional queries. - JWT Auth & IDOR (TypeScript): Explicit interface typing and pinned
HS256algorithms. - System Ping Tool (Python): Subprocess timeout enforcement and private/loopback SSRF blocking.
- File Server (Node.js):
path.relativecontainment validation and realpath checks. - Checkout Cart (JavaScript): Safe integer range enforcement and server-authoritative catalog locking.
- Banking Ledger (Python): Strict type guards (
- Empirical SQLite Test Harness: Validated 6/6 deterministic ACID transaction scenarios against concurrent race conditions and tampering attempts.
🚀 Usage as a GitHub Action
Add DevGuard to your CI workflow (.github/workflows/devguard.yml):
name: DevGuard Security Audit
on:
pull_request:
branches: [ main ]
jobs:
audit:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: OkyWoww/DevGuard@v1.0.0
with:
gemini_api_key: ${{ secrets.GEMINI_API_KEY }} # Optional: falls back to 100% offline Layer 1 if omitted
min_score: '85'branding: