Skip to content

DevGuard v1.0.0 — Zero-Leniency Hybrid Adversarial Code Auditor

Choose a tag to compare

@OkyWoww OkyWoww released this 06 Nov 02:04
· 57 commits to main since this release

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 HS256 algorithms.
    • System Ping Tool (Python): Subprocess timeout enforcement and private/loopback SSRF blocking.
    • File Server (Node.js): path.relative containment validation and realpath checks.
    • Checkout Cart (JavaScript): Safe integer range enforcement and server-authoritative catalog locking.
  • 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: