🎉 Welcome to IntegrityZ!

We're excited to announce the initial release of IntegrityZ, a modern cross-platform filesystem integrity monitoring tool written in Zig. IntegrityZ provides comprehensive file system monitoring with enterprise-grade performance optimizations.

🌟 What's New in v1.0.0

Core Features

• Baseline Creation & Integrity Checking: Create snapshots of directories and detect unauthorized changes
• BLAKE3 Cryptographic Hashing: Ultra-fast and secure checksum validation
• Real-time Monitoring: Live filesystem watching with inotify (Linux) and kqueue (macOS)
• JSON Export: Machine-readable reports for automation and integration
• Web Dashboard: Visual reporting interface for integrity analysis
• Configuration Management: Flexible configuration with include/exclude patterns
• HTTP Webhook Integration: Instant notifications for third-party systems

🚀 Performance Optimizations

• Adaptive Buffer Sizing: Automatically optimizes I/O based on storage type (SSD/HDD/Network)
• Parallel Directory Traversal: Multi-threaded scanning with configurable worker pools
• String Interning & Memory Pooling: Reduces memory allocation overhead for large filesystems
• Batched Database Operations: Optimized I/O for handling large datasets
• Large File Handling: Specialized optimizations for files over performance thresholds

🧪 Quality Assurance

• 190+ Unit Tests: Comprehensive test coverage across all modules
• Memory Safety: Built with Zig's compile-time safety guarantees
• Cross-platform Compatibility: Single codebase supporting multiple operating systems

📋 CLI Commands

integrityz init <paths...>        # Create baseline for specified paths
integrityz check [--json] [paths] # Check filesystem against baseline
integrityz watch [paths]          # Watch for real-time changes with webhooks
integrityz config [--init]        # Show or initialize configuration

🛠 Installation

Build from Source

git clone https://github.com/yourname/integrityz.git
cd integrityz
make build

The binary will be available at ./zig-out/bin/integrityz

Quick Start

# Create baseline
integrityz init /etc /usr/bin

# Check for changes
integrityz check --json

# Real-time monitoring
integrityz watch /etc

📊 Performance Highlights

• Adaptive Performance: Automatically detects storage type and optimizes buffer sizes
• Parallel Processing: Utilizes multiple cores for large directory scanning
• Memory Efficient: String pooling reduces memory usage by up to 40% on large filesystems
• Scalable: Handles enterprise-scale filesystems with millions of files

🔧 Technical Specifications

• Language: Zig 0.13.0
• Hash Algorithm: BLAKE3 (cryptographically secure)
• Supported Platforms: Linux (inotify), macOS (kqueue)
• Configuration: INI-style configuration files
• Output Formats: Human-readable text, JSON
• Dependencies: Zero external runtime dependencies

📁 Project Structure

integrityz/
├── src/                 # Core Zig modules
│   ├── main.zig         # CLI entry point
│   ├── crypto.zig       # BLAKE3 hashing with adaptive optimizations
│   ├── scanner.zig      # Parallel filesystem scanning
│   ├── string_pool.zig  # String interning for memory optimization
│   ├── database.zig     # Batched I/O operations
│   ├── watcher.zig      # Real-time monitoring
│   ├── checker.zig      # Integrity verification
│   ├── reporter.zig     # JSON reporting
│   └── config.zig       # Configuration management
├── web-dashboard/       # Visualization interface
└── build.zig           # Build system with comprehensive tests

🧪 Testing

Run the comprehensive test suite:

make test

🤝 Contributing

We welcome contributions! Please see our contributing guidelines and open an issue for major changes.

📄 License

Licensed under the Apache License 2.0. See LICENSE file for details.

🔗 Links

• GitHub Repository: https://github.com/yourname/integrityz
• Live Dashboard: https://integrityz.linkzip.app
• Documentation: See README.md for detailed usage instructions

IntegrityZ v1.0.0 - Secure your filesystem with confidence! 🔒