Merge remote changes and integrate AdBlock Compiler

Co-Authored-By: Warp <agent@warp.dev>

Author: jaypatrick

.github/copilot-instructions.md

@@ -39,7 +39,7 @@ Multi-language toolkit for ad-blocking and AdGuard DNS management with **identic
 - `adguard-validate` (CLI tool)
 
 ### Compiler Equivalence
-All four compilers (TypeScript, .NET, Python, Rust) wrap `@adguard/hostlist-compiler` and **must**:
+All four compilers (TypeScript, .NET, Python, Rust) use `@jk-com/adblock-compiler` and **must**:
 - Support JSON, YAML, TOML config formats (except PowerShell: JSON only)
 - Count rules identically (exclude empty lines and `!`/`#` comments)
 - Compute SHA-384 hash of output (96 hex chars)
@@ -402,7 +402,7 @@ All compilers return/output:
 ```
 
 ### Configuration Schema
-Supports 3 formats (JSON/YAML/TOML), mirrors `@adguard/hostlist-compiler`:
+Supports 3 formats (JSON/YAML/TOML), based on `@jk-com/adblock-compiler` schema:
 ```json
 {
   "output": "data/output/adguard_user_filter.txt",
@@ -493,11 +493,13 @@ cd src/rules-compiler-rust && cargo test
 - **Auth**: Bearer token in `Authorization` header
 - **Retry logic**: 3 attempts with exponential backoff (408, 429, 5xx)
 
-### @adguard/hostlist-compiler
-- **All compilers depend on this**: npm package must be globally installed
-- **Installation**: `npm install -g @adguard/hostlist-compiler`
+### @jk-com/adblock-compiler
+- **All compilers depend on this**: JSR package
+- **Installation**: `deno add @jk-com/adblock-compiler` or via JSR
+- **Source**: https://github.com/jaypatrick/hostlistcompiler
+- **Documentation**: https://jsr.io/@jk-com/adblock-compiler
 - Provides 11 transformations (RemoveComments, Compress, Validate, etc.)
-- Compilers wrap this, handling config parsing and result formatting
+- Compilers use this, handling config parsing and result formatting
 
 ### Docker Development
 - **Dockerfile**: `Dockerfile.warp` (multi-stage with .NET 8 SDK + Node 20 + PowerShell 7)

CLAUDE.md

@@ -28,7 +28,7 @@ This repository is a comprehensive multi-language toolkit for ad-blocking, netwo
 - **Linear Import Tool** (`src/linear/`) - TypeScript tool with Deno support
 
 ### Configuration Support
-All compilers support JSON, YAML, and TOML configuration formats with full @adguard/hostlist-compiler compatibility.
+All compilers support JSON, YAML, and TOML configuration formats with full @jk-com/adblock-compiler compatibility.
 
 ## Docker Development Environment
 
@@ -294,7 +294,7 @@ cargo test config::                       # Tests in module
 - `data/output/adguard_user_filter.txt` - Main tracked filter list consumed by AdGuard DNS
 
 ### Rules Compiler - TypeScript (`src/rules-compiler-typescript/`)
-- TypeScript wrapper around @adguard/hostlist-compiler
+- TypeScript compiler using @jk-com/adblock-compiler
 - Deno 2.0+ runtime with npm compatibility
 - Supports JSON, YAML, and TOML configuration formats
 - **Library API** (`src/lib/`):
@@ -324,7 +324,7 @@ cargo test config::                       # Tests in module
 - Supports JSON, YAML, TOML via external tools (yq, Python)
 
 ### Rules Compiler - .NET (`src/rules-compiler-dotnet/`)
-- .NET 10 library wrapping @adguard/hostlist-compiler
+- .NET 10 library for filter compilation
 - Supports JSON, YAML, and TOML configuration formats
 - `RulesCompiler` - Core library with abstractions, models, and services
 - `RulesCompiler.Console` - Spectre.Console interactive and CLI frontend
@@ -333,7 +333,7 @@ cargo test config::                       # Tests in module
 - Features: Configuration validation, verbose mode, dependency injection
 
 ### Rules Compiler - Python (`src/rules-compiler-python/`)
-- Python 3.9+ package wrapping @adguard/hostlist-compiler
+- Python 3.9+ package for filter compilation
 - Supports JSON, YAML, and TOML configuration formats
 - `rules_compiler/config.py` - Multi-format configuration reader
 - `rules_compiler/compiler.py` - Core `RulesCompiler` class and `compile_rules()` function
@@ -343,7 +343,7 @@ cargo test config::                       # Tests in module
 - Tools: pytest, mypy, ruff
 
 ### Rules Compiler - Rust (`src/rules-compiler-rust/`)
-- High-performance Rust library and CLI wrapping @adguard/hostlist-compiler
+- High-performance Rust library and CLI for filter compilation
 - Supports JSON, YAML, and TOML configuration formats
 - `src/config.rs` - Configuration structs and parsing
 - `src/compiler.rs` - `RulesCompiler` struct and `compile_rules()` function
@@ -400,7 +400,7 @@ cargo test config::                       # Tests in module
 
 ## Configuration Schema
 
-All compilers support the same @adguard/hostlist-compiler configuration schema:
+All compilers support the same @jk-com/adblock-compiler configuration schema:
 
 ### Root-Level Properties
 | Property | Type | Required | Description |
@@ -463,7 +463,7 @@ GitHub Actions workflows validate:
 | PowerShell | 7+ | PowerShell scripts |
 | Python | 3.9+ | Python compiler |
 | Rust | 1.85+ | Rust compiler (install via rustup) |
-| hostlist-compiler | Latest | All compilers (via Deno: `deno run npm:@adguard/hostlist-compiler`) |
+| adblock-compiler | 0.6.0 | TypeScript compiler (via JSR: `deno add @jk-com/adblock-compiler`) |
 | Docker | 24.0+ | Container development (optional but recommended) |
 
 ## Key File Locations

README.md

@@ -44,7 +44,7 @@ A comprehensive multi-language toolkit for ad-blocking, network protection, and
 | **Rust** | Native binary | Cargo/Binary | Zero-runtime deps, LTO optimization |
 | **PowerShell** | PowerShell 7+ | Module | Pipeline-friendly, Pester tests |
 
-All compilers wrap [@adguard/hostlist-compiler](https://github.com/AdguardTeam/HostlistCompiler) with **built-in security validation** and support:
+All compilers use [@jk-com/adblock-compiler](https://github.com/jaypatrick/hostlistcompiler) with **built-in security validation** and support:
 - **All 11 transformations**: Deduplicate, Validate, RemoveComments, Compress, RemoveModifiers, etc.
 - **Multi-format config**: JSON, YAML, and TOML configuration files
 - **Source-specific settings**: Per-source transformations, inclusions, exclusions
@@ -216,7 +216,7 @@ curl -fsSL https://deno.land/install.sh | sh
 irm https://deno.land/install.ps1 | iex
 ```
 
-The `@adguard/hostlist-compiler` package is accessed via Deno's npm compatibility.
+The `@jk-com/adblock-compiler` package is accessed via Deno's JSR integration.
 
 ### Clone and Setup
 
@@ -536,7 +536,7 @@ See [`data/archive/README.md`](data/archive/README.md) for detailed usage and re
                         │
                         ▼
 ┌─────────────────────────────────────────────────────┐
-│ 4. Compile with @adguard/hostlist-compiler         │
+│ 4. Compile with @jk-com/adblock-compiler         │
 │    - Merge all sources                             │
 │    - Apply transformations (dedupe, validate, etc) │
 │    - Convert hosts format to adblock if needed     │
@@ -562,7 +562,7 @@ See [`data/archive/README.md`](data/archive/README.md) for detailed usage and re
 
 ## Rules Compilers
 
-All compilers wrap [@adguard/hostlist-compiler](https://github.com/AdguardTeam/HostlistCompiler) and support:
+All compilers use [@jk-com/adblock-compiler](https://github.com/jaypatrick/hostlistcompiler) and support:
 
 - **Multi-format config**: JSON, YAML, TOML
 - **All 11 transformations**: Deduplicate, Validate, RemoveComments, Compress, etc.
@@ -744,7 +744,7 @@ println!("Compiled {} rules", result.rule_count);
 
 **Location**: `src/shell/`
 
-Cross-platform shell scripts that wrap `@adguard/hostlist-compiler` for simple automation and CI/CD pipelines.
+Cross-platform shell scripts that use `@jk-com/adblock-compiler` for simple automation and CI/CD pipelines.
 
 | Script | Platform | Shell | Features |
 |--------|----------|-------|----------|

data/input/README.md

@@ -173,7 +173,7 @@ data/input/
 2. **Validation**: Lint and verify syntax of each file
 3. **Hashing**: Compute SHA-384 hash for integrity verification
 4. **Remote fetch** (if applicable): Download internet lists with hash verification
-5. **Compilation**: Merge all sources using `@adguard/hostlist-compiler`
+5. **Compilation**: Merge all sources using `@jk-com/adblock-compiler`
 6. **Output**: Write final adblock-format list to `data/output/adguard_user_filter.txt`
 
 ## Security

docs/AGENTS.md

@@ -4,7 +4,7 @@
 
 - `data/` contains the tracked filter list (`data/output/adguard_user_filter.txt`) and compiler configuration files.
 - `src/` contains the multi-language toolchain:
-  - `src/rules-compiler-*` (TypeScript/Deno, .NET, Python, Rust, shell) compilers that wrap `@adguard/hostlist-compiler`.
+  - `src/rules-compiler-*` (TypeScript/Deno, .NET, Python, Rust, shell) compilers that use `@jk-com/adblock-compiler`.
   - `src/adguard-api-dotnet/`, `src/adguard-api-typescript/`, and `src/adguard-api-rust/` SDKs + interactive clients for the AdGuard DNS API.
   - `src/adguard-api-powershell/` PowerShell modules and Pester tests.
 - `docs/` holds guides and reference documentation.

docs/LINEAR_DOCUMENTATION.md

@@ -110,7 +110,7 @@ export ADGUARD_ARCHIVE_RETENTION_DAYS=90
 
 **Technology Stack:**
 - TypeScript 5.4.5
-- @adguard/hostlist-compiler v1.0.39
+- @jk-com/adblock-compiler v0.6.0
 - Deno test (testing)
 - Deno 2.0+
 
@@ -284,7 +284,7 @@ ad-blocking/
 | Technology | Version | Purpose |
 |------------|---------|---------|
 | TypeScript | 5.4.5 | Strongly-typed JavaScript |
-| @adguard/hostlist-compiler | 1.0.39 | Core compilation engine |
+| @jk-com/adblock-compiler | 0.6.0 | Core compilation engine |
 | Deno | 2.0+ | TypeScript/JavaScript runtime |
 | Deno test | built-in | Testing framework |
 

docs/README.md

@@ -138,6 +138,6 @@ All URIs are relative to `https://api.adguard-dns.io`
 
 - [AdGuard DNS](https://adguard-dns.io/)
 - [AdGuard DNS API Documentation](https://api.adguard-dns.io/static/swagger/swagger.json)
-- [@adguard/hostlist-compiler](https://github.com/AdguardTeam/HostlistCompiler)
+- [@jk-com/adblock-compiler](https://github.com/jaypatrick/hostlistcompiler)
 - [AdBlock Tester](https://adblock-tester.com/)
 - [AdGuard Tester](https://d3ward.github.io/toolz/adblock.html)

docs/RUNTIME_ENFORCEMENT.md

@@ -32,15 +32,16 @@
                  │
                  ▼
 ┌─────────────────────────────────────────┐
-│  @adguard/hostlist-compiler             │
+│  @jk-com/adblock-compiler               │
+│  (JSR package)                          │
 └─────────────────────────────────────────┘
 ```
 
 ## How It Works
 
 ### 1. Mandatory Wrapper Function
 
-All compilers **MUST** use `compile_with_validation()` instead of calling `@adguard/hostlist-compiler` directly:
+All compilers **MUST** use `compile_with_validation()` instead of calling `@jk-com/adblock-compiler` directly:
 
 **❌ FORBIDDEN - Direct compilation bypass:**
 ```typescript
@@ -280,7 +281,7 @@ module.exports = {
   rules: {
     'no-restricted-imports': ['error', {
       patterns: [{
-        group: ['@adguard/hostlist-compiler'],
+        group: ['@jk-com/adblock-compiler'],
         message: 'Do not import hostlist-compiler directly. Use compile_with_validation() from @adguard/validation instead.'
       }]
     }]

docs/RUST_WORKSPACE.md

@@ -19,7 +19,7 @@ Rust implementation of the AdGuard DNS API client.
 - **adguard-api-cli**: Interactive CLI for AdGuard DNS API
 
 ### 3. **rules-compiler-rust** (`src/rules-compiler-rust/`)
-Rust compiler for AdGuard filter rules using `@adguard/hostlist-compiler`.
+Rust compiler for AdGuard filter rules using `@jk-com/adblock-compiler`.
 
 - Library and CLI for compiling filter rules
 - Supports JSON, YAML, and TOML configurations

docs/VALIDATION_ENFORCEMENT.md

@@ -85,7 +85,7 @@ async function compile(config: CompilerConfig): Promise<CompilerResult> {
     }
   }
 
-  // 3. Proceed with compilation using @adguard/hostlist-compiler
+  // 3. Proceed with compilation using @jk-com/adblock-compiler
   const output = await hostlistCompiler.compile(config);
 
   // 4. MANDATORY: Handle file conflicts