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…

  • /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…

  • /ENVIRONMENT_VARIABLES/

    Environment Variables Reference Comprehensive guide to environment variables actually read by Bloqr Core's PowerShell wrapper and .NET apps today. Each section below is verified against the code that…

  • /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 This document previously described an aspirational design — a mandatory compile_with_validation() wrapper around a fictional @adguard/validation package, with…

  • /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. validation (src/validation…

  • /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 integration requirements for all rules compilers to ensure consistent security validation across the codebase, and describes the…

  • /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/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…

  • /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…