Recent Improvements

Discover the latest enhancements and features added to the AdGuard Tools and Utilities over the past few weeks.

Phase 2 Implementation

Shell reorganization and environment variable standardization across all components.

Rust Modernization

Unified Rust workspace with shared dependencies and improved build performance.

Test Infrastructure Updates

Enhanced testing across all language ecosystems with comprehensive coverage.

Runtime Enforcement

Cryptographic validation ensuring security measures are actually executed.

Validation Security

Enhanced security validation with hash verification and URL security checks.

Environment Variable Migration

Standardized environment variables across .NET, TypeScript, Rust, and PowerShell.

All Technical Documentation

  • /AGENTS/

    Repository Guidelines Project Structure & Module Organization The tracked filter list and compiler configuration files live in BloqrAI/bloqr-blocklists (formerly data/ in this repo). src/ contains the…

  • /ENVIRONMENT_VARIABLES/

    Environment Variables Reference Comprehensive guide to environment variables supported by AdGuard scripts and modules. Overview All AdGuard scripts and modules support environment variables for…

  • /RESTRUCTURING_RETROSPECTIVE/

    Restructuring Retrospective (2026-08) A record of the multi-day effort that took this repo from bloqr-lists — a monolith holding compiled filter lists, API clients, and every rules compiler — to bloqr…

  • /RUNTIME_ENFORCEMENT/

    Runtime Enforcement of Validation Library Implementation status note: this document describes the aspirational design (a mandatory compile_with_validation() wrapper with signed metadata). The .NET…

  • /RUST_WORKSPACE/

    Rust Workspace This directory contains a unified Rust workspace for all Rust projects in the ad-blocking repository. Projects The workspace includes the following crates: 1. rules-validator (src/rules…

  • /DENO_CONFIG/

    Shared Deno Configuration This repository uses a centralized Deno configuration pattern to ensure consistency across all Deno-based projects. Overview Similar to how .NET projects use Directory.Build…

  • /TYPESCRIPT_TYPE_DEFINITIONS/

    TypeScript Type Definitions (.d.ts) Generation Overview This document describes the implementation of .d.ts type definition file generation for all TypeScript projects in the repository. Why .d.ts…

  • /VALIDATION_ENFORCEMENT/

    Validation Library Integration Requirements This document defines the mandatory integration requirements for all rules compilers to ensure consistent security validation across the codebase…

  • /WARP/

    WARP.md This file provides guidance to WARP (warp.dev) when working with code in this repository. Project scope This repo houses the multi-language rules-compiler toolkit: TypeScript/Deno, C#/.NET 1…

  • /WHY_VALIDATION_MATTERS/

    Why Validation Matters: Protecting Your Network and Privacy For Everyone: This document explains why our validation system is essential for keeping your network safe and your data private. Written for…

  • /archive/PHASE2_IMPLEMENTATION/

    Phase 2: Shell Reorganization + Environment Variables Status: IN PROGRESS This document tracks the implementation of Phase 2 of the PowerShell/Shell modernization project. Completed ✅ Directory…

  • /archive/ENVIRONMENT_VARIABLE_MIGRATION/

    Environment Variable Migration Guide Overview The ad-blocking repository has standardized on a single, universal environment variable format that works consistently across all programming languages…

  • /archive/RUST_MODERNIZATION_SUMMARY/

    Rust Workspace Modernization - Summary Overview This document summarizes the modernization of Rust projects in the ad-blocking repository. All Rust projects have been unified into a single workspace…

  • /archive/RESTRUCTURING_SUMMARY/

    Repository Restructuring Summary Overview This document summarizes the repository structure improvements made to consolidate and organize the ad-blocking multi-language monorepo according to 202…

  • /archive/TEST_UPDATES_SUMMARY/

    .NET Unit Test Updates - Summary Report Overview Updated all .NET unit tests to ensure they compile and pass. Added additional tests to improve code coverage. Test Results All Tests Passing ✅ Project…