{
  "report_info": {
    "version": "9.0.1",
    "generated_at": "2026-06-28T11:16:27Z",
    "binary_name": "integrity-check"
  },
  "binary": {
    "name": "integrity-check",
    "path": "/opt/kodachi/dashboard/hooks/integrity-check",
    "timestamp": "2026-06-28T11:16:27Z",
    "file_info": {
      "size": 3826592,
      "sha256": "58a32691ed45489f600c95f33c2904abd6da0df53ff8754d65379bfd7b7dccbf"
    },
    "flag_n": {
      "command": "info",
      "data": {
        "author": "Warith Al Maawali",
        "copyright": "© 2026 Linux Kodachi",
        "description": "A system integrity checker for verifying script and configuration files",
        "features": [
          "File integrity verification using SHA-256 hashes",
          "Cryptographic signature verification",
          "Version checking against remote repositories",
          "Configuration file validation",
          "Offline mode support",
          "Comprehensive logging and reporting"
        ],
        "license": "Proprietary",
        "name": "integrity-check",
        "securityFeatures": {
          "authentication": "Certificate pinning for secure connections",
          "encryption": "TLS 1.3 for all network communications",
          "inputValidation": "All inputs validated and sanitized",
          "rateLimiting": "Maximum 3 retries with configurable timeouts"
        },
        "systemRequirements": {
          "dependencies": [
            "OpenSSL",
            "curl"
          ],
          "os": "Linux (Debian-based)",
          "privileges": "sudo only for 'generate' and 'check-signatures' commands"
        },
        "version": "9.8.4 (build 319)",
        "website": "https://digi77.com"
      },
      "errors": [],
      "metadata": {
        "executionTime": 0,
        "hostname": "REDACTED-BUILD-HOST",
        "user": "REDACTED-BUILD-USER"
      },
      "status": "success",
      "timestamp": "2026-06-28T11:16:27.775279604Z",
      "version": "9.8.4 (build 319)",
      "warnings": []
    },
    "flag_v": {
      "command": "version",
      "data": {
        "buildDate": "REDACTED-BUILD-TIME",
        "gitCommit": "unknown",
        "name": "integrity-check",
        "rustVersion": "1.82.0",
        "version": "9.8.4 (build 319)"
      },
      "errors": [],
      "metadata": {
        "executionTime": 0,
        "hostname": "REDACTED-BUILD-HOST",
        "user": "REDACTED-BUILD-USER"
      },
      "status": "success",
      "timestamp": "2026-06-28T11:16:27.865983371Z",
      "version": "9.8.4 (build 319)",
      "warnings": []
    },
    "flag_h": {
      "command": "help",
      "data": {
        "commandCategories": [
          {
            "category": "Integrity Operations",
            "commands": [
              {
                "description": "Verify file integrity for scripts, binaries, and configs",
                "examples": [
                  "integrity-check check-integrity",
                  "integrity-check check-integrity --json"
                ],
                "name": "check-integrity",
                "options": [],
                "requires_sudo": false,
                "usage": "integrity-check check-integrity [OPTIONS]"
              },
              {
                "description": "Generate new hash file for all tracked files",
                "examples": [
                  "integrity-check generate",
                  "integrity-check generate --json"
                ],
                "name": "generate",
                "options": [],
                "requires_sudo": true,
                "usage": "integrity-check generate [OPTIONS]"
              },
              {
                "description": "Verify cryptographic signatures of tracked files",
                "examples": [
                  "integrity-check check-signatures",
                  "integrity-check check-signatures --json"
                ],
                "name": "check-signatures",
                "options": [],
                "requires_sudo": true,
                "usage": "integrity-check check-signatures [OPTIONS]"
              }
            ]
          },
          {
            "category": "Verification Operations",
            "commands": [
              {
                "description": "Compare local package versions against remote repositories",
                "examples": [
                  "integrity-check check-version",
                  "integrity-check check-version --json"
                ],
                "name": "check-version",
                "options": [],
                "requires_sudo": false,
                "usage": "integrity-check check-version [OPTIONS]"
              },
              {
                "description": "Verify the integrity and format of configuration files",
                "examples": [
                  "integrity-check check-config",
                  "integrity-check check-config --json"
                ],
                "name": "check-config",
                "options": [],
                "requires_sudo": false,
                "usage": "integrity-check check-config [OPTIONS]"
              },
              {
                "description": "Perform comprehensive check including integrity, versions, and signatures",
                "examples": [
                  "integrity-check check-all",
                  "integrity-check check-all --json"
                ],
                "name": "check-all",
                "options": [],
                "requires_sudo": true,
                "usage": "integrity-check check-all [OPTIONS]"
              }
            ]
          },
          {
            "category": "Utility Operations",
            "commands": [
              {
                "description": "Display the most recent integrity check logs",
                "examples": [
                  "integrity-check view-logs",
                  "integrity-check view-logs --json"
                ],
                "name": "view-logs",
                "options": [],
                "requires_sudo": false,
                "usage": "integrity-check view-logs [OPTIONS]"
              }
            ]
          }
        ],
        "description": "A system integrity checker for verifying script and configuration files",
        "environmentVariables": [
          {
            "default": "info",
            "description": "Set logging level",
            "name": "RUST_LOG",
            "values": "error|warn|info|debug|trace"
          },
          {
            "default": "unset",
            "description": "Disable all colored output when set",
            "name": "NO_COLOR",
            "values": "1|true|yes (any value disables color)"
          },
          {
            "default": "unset",
            "description": "HTTP proxy for network requests",
            "name": "HTTP_PROXY",
            "values": "http://proxy:port"
          },
          {
            "default": "unset",
            "description": "HTTPS proxy for secure requests",
            "name": "HTTPS_PROXY",
            "values": "https://proxy:port"
          }
        ],
        "exitCodes": {
          "0": "Success",
          "1": "General error",
          "10": "Check failure - integrity/version issues found",
          "2": "Invalid arguments",
          "3": "Permission denied",
          "4": "Network error",
          "5": "File not found",
          "6": "Timeout error",
          "7": "Authentication error",
          "8": "Internal error",
          "9": "Validation error"
        },
        "globalOptions": [
          {
            "description": "Print help information",
            "flag": "-h, --help"
          },
          {
            "description": "Print version information",
            "flag": "-v, --version"
          },
          {
            "description": "Display detailed information",
            "flag": "-n, --info"
          },
          {
            "description": "Show usage examples",
            "flag": "-e, --examples"
          },
          {
            "description": "Output in JSON format",
            "flag": "--json"
          },
          {
            "description": "Pretty-print JSON output",
            "flag": "--json-pretty"
          },
          {
            "description": "Filter JSON output fields",
            "flag": "--json-filter <FIELDS>"
          },
          {
            "description": "Enable verbose output",
            "flag": "--verbose"
          },
          {
            "description": "Suppress non-essential output",
            "flag": "--quiet"
          },
          {
            "description": "Disable colored output",
            "flag": "--no-color"
          },
          {
            "description": "Use custom configuration file",
            "flag": "--config <FILE>"
          },
          {
            "description": "Set timeout (default: 30)",
            "flag": "--timeout <SECS>"
          },
          {
            "description": "Retry attempts (default: 3)",
            "flag": "--retry <COUNT>"
          },
          {
            "description": "Maximum retry attempts (0-10) [default: 3]",
            "flag": "--max-retries <COUNT>"
          },
          {
            "description": "Output format (text|json) [default: text]",
            "flag": "-o, --output-format <FORMAT>"
          },
          {
            "description": "Base directory for the application",
            "flag": "--base-dir <DIR>"
          },
          {
            "description": "Verbosity level (0-3) [default: 1]",
            "flag": "-V, --verbosity <LEVEL>"
          },
          {
            "description": "Logging level (error|warn|info|debug|trace)",
            "flag": "--log-level <LEVEL>"
          },
          {
            "description": "Disable network operations",
            "flag": "--no-network"
          },
          {
            "description": "Enable strict validation mode",
            "flag": "--strict"
          }
        ],
        "name": "integrity-check",
        "usage": "integrity-check [OPTIONS] [COMMAND] [ARGS]"
      },
      "errors": [],
      "metadata": {
        "executionTime": 0,
        "hostname": "REDACTED-BUILD-HOST",
        "user": "REDACTED-BUILD-USER"
      },
      "status": "success",
      "timestamp": "2026-06-28T11:16:27.941616884Z",
      "version": "9.8.4 (build 319)",
      "warnings": []
    },
    "flag_e": {
      "command": "examples",
      "data": {
        "categories": [
          {
            "description": "Core integrity checking operations",
            "examples": [
              {
                "command": "integrity-check check-integrity",
                "description": "Verify integrity of all tracked files",
                "expectedOutput": "Shows pass/fail status for each file"
              },
              {
                "command": "integrity-check check-integrity --json",
                "description": "Integrity check with JSON output",
                "expectedOutput": "JSON response with detailed results"
              },
              {
                "command": "integrity-check check-integrity --base-dir /path/to/custom/dir",
                "description": "Check integrity using custom base directory",
                "expectedOutput": "Integrity results for custom location"
              },
              {
                "command": "integrity-check check-integrity --base-dir /path/to/custom/dir --json",
                "description": "Custom directory check with JSON output",
                "expectedOutput": "JSON results for custom location"
              }
            ],
            "id": "1_basic_usage",
            "title": "Basic Usage"
          },
          {
            "description": "Advanced multi-component verification",
            "examples": [
              {
                "command": "sudo integrity-check check-all",
                "description": "Complete system verification",
                "expectedOutput": "Full system verification report"
              },
              {
                "command": "sudo integrity-check check-all --timeout 300",
                "description": "Full system verification with extended timeout",
                "expectedOutput": "Comprehensive system check",
                "notes": "For thorough system checks"
              }
            ],
            "id": "2_comprehensive_checks",
            "title": "Comprehensive System Checks"
          },
          {
            "description": "Creating and managing file integrity hashes",
            "examples": [
              {
                "command": "sudo integrity-check generate",
                "description": "Create new hash file for all tracked files",
                "expectedOutput": "Hash database created/updated",
                "notes": "Run after system updates"
              },
              {
                "command": "sudo integrity-check generate --json",
                "description": "Hash generation with JSON output for automation",
                "expectedOutput": "JSON response with generation status"
              }
            ],
            "id": "3_hash_generation",
            "title": "Hash Generation"
          },
          {
            "description": "Package version verification against remote repositories",
            "examples": [
              {
                "command": "integrity-check check-version",
                "description": "Compare local package versions against remote repositories",
                "expectedOutput": "Version comparison results"
              },
              {
                "command": "integrity-check check-version --json",
                "description": "Version check with JSON output for scripting",
                "expectedOutput": "JSON response with version data"
              }
            ],
            "id": "4_version_checking",
            "title": "Version Checking"
          },
          {
            "description": "Configuration file verification and validation",
            "examples": [
              {
                "command": "integrity-check check-config",
                "description": "Verify the integrity and format of configuration files",
                "expectedOutput": "Configuration validation results"
              },
              {
                "command": "integrity-check check-config --json",
                "description": "Configuration check with JSON output",
                "expectedOutput": "JSON configuration status"
              }
            ],
            "id": "5_configuration_management",
            "title": "Configuration Management"
          },
          {
            "description": "Cryptographic signature validation",
            "examples": [
              {
                "command": "sudo integrity-check check-signatures",
                "description": "Verify cryptographic signatures of tracked files",
                "expectedOutput": "Signature verification results"
              },
              {
                "command": "sudo integrity-check check-signatures --json",
                "description": "Signature verification with JSON output",
                "expectedOutput": "Structured signature status data"
              },
              {
                "command": "sudo integrity-check check-signatures --strict",
                "description": "Strict signature verification",
                "expectedOutput": "Cryptographic verification results",
                "notes": "Fails on any signature mismatch"
              }
            ],
            "id": "6_signature_verification",
            "title": "Signature Verification"
          },
          {
            "description": "Viewing and managing integrity check logs",
            "examples": [
              {
                "command": "integrity-check view-logs",
                "description": "Display the most recent integrity check logs",
                "expectedOutput": "Recent log entries"
              },
              {
                "command": "integrity-check view-logs --json",
                "description": "View logs in JSON format for parsing",
                "expectedOutput": "Structured log data",
                "notes": "Useful for log analysis tools"
              }
            ],
            "id": "7_log_management",
            "title": "Log Management"
          }
        ],
        "description": "Usage examples for integrity-check",
        "name": "integrity-check",
        "quickReference": [
          "integrity-check check-integrity",
          "sudo integrity-check check-all",
          "sudo integrity-check generate",
          "integrity-check check-version",
          "integrity-check check-config",
          "sudo integrity-check check-signatures",
          "integrity-check view-logs",
          "integrity-check --help",
          "integrity-check --version",
          "integrity-check --info",
          "integrity-check --examples"
        ]
      },
      "errors": [],
      "metadata": {
        "executionTime": 0,
        "hostname": "REDACTED-BUILD-HOST",
        "user": "REDACTED-BUILD-USER"
      },
      "status": "success",
      "timestamp": "2026-06-28T11:16:28.094117203Z",
      "version": "9.8.4 (build 319)",
      "warnings": []
    }
  }
}