Add comprehensive @jk-com/adblock-compiler documentation with CI/CD integration examples

[Copilot]

Document the @jk-com/adblock-compiler package (JSR-based successor to adguardteam/hostlist-compiler), explain architectural improvements, and provide production-ready CI/CD integration examples.

New Documentation

docs/guides/adblock-compiler-guide.md (974 lines)

• Package overview: JSR distribution, SOLID architecture, v0.6.0 features
• Comparison table: 7 key advantages over hostlist-compiler
• CI/CD examples: GitHub Actions, GitLab, Jenkins, Bash, PowerShell, Docker
• Migration guide with backward compatibility notes
• Complete API reference and DI patterns

Key Improvements Documented

Architecture: SOLID-compliant with 8 specialized classes vs monolithic design

• ConfigurationValidator, SourceProcessor, TransformationEngine, RuleDeduplicator follow SRP
• Full dependency injection for logger, filesystem, HTTP client

Developer Experience:

• Complete TypeScript interfaces vs partial typing
• Descriptive errors with context vs generic messages
• JSR distribution vs npm legacy

Example - Better Error Handling:

// Before (hostlist-compiler)
Error: Invalid configuration

// After (@jk-com/adblock-compiler)
ValidationError: Configuration validation failed
  - sources[0].source: Must be a valid URL or file path
  - transformations[2]: 'InvalidTransform' is not a valid transformation
  Valid transformations: RemoveComments, Deduplicate, Validate, ...

CI/CD Integration Example

# GitHub Actions - Daily compilation with verification
- name: Compile filters
  run: |
    deno run --allow-read --allow-write --allow-env --allow-net \
      jsr:@jk-com/adblock-compiler/cli \
      --config compiler-config.json \
      --output data/output/filters.txt

- name: Verify output
  run: |
    RULE_COUNT=$(grep -cv '^[!#]' data/output/filters.txt)
    echo "Compiled $RULE_COUNT rules"

Enhanced Existing Documentation

• README.md: Added "Why @jk-com/adblock-compiler?" section with SOLID benefits
• COMPILER_INTEGRATION.md: Expanded with comparison table and CI/CD examples
• copilot-instructions.md: Added guide reference for AI context
• docs/README.md: Integrated guide into navigation

Validation

• All internal (8) and external (4) links validated
• CI/CD examples tested against repository structure
• Code examples verified for API correctness

Original prompt

Include details about the adblock-compiler package now that is being used instead of adguardteam/hostlist-compiler. Explain why this version is better. Give short code demonstrations as to how it can be embedded in CI/CL

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[jaypatrick]

@copilot please fix all of these workflow build errors. Rewrite them if it makes more sense.