{
  "report_info": {
    "version": "9.0.1",
    "generated_at": "2026-06-08T16:22:02Z",
    "binary_name": "deps-checker"
  },
  "binary": {
    "name": "deps-checker",
    "path": "/opt/kodachi/dashboard/hooks/deps-checker",
    "timestamp": "2026-06-08T16:22:02Z",
    "file_info": {
      "size": 2954016,
      "sha256": "e32bcc67a595663f49615d641459351954c96f2ed4f9c9f1d0d22a770ef454f9"
    },
    "flag_n": {
      "command": "info",
      "data": {
        "author": "Warith Al Maawali",
        "copyright": "© 2026 Linux Kodachi",
        "description": "Dependency checker for Kodachi OS Rust binaries - Validates system dependencies and generates installation scripts",
        "features": [
          "Multi-profile dependency checking (minimal/full)",
          "Automatic missing package installation",
          "Installation script generation for multiple shells",
          "Software Bill of Materials (SBOM) generation",
          "External dependency database support",
          "Comprehensive JSON output for automation",
          "Strict mode for CI/CD pipelines",
          "Dry-run mode for safe previewing"
        ],
        "license": "Proprietary",
        "name": "deps-checker",
        "securityFeatures": {
          "authentication": "Secure package repository authentication",
          "encryption": "TLS for all package downloads",
          "inputValidation": "All user inputs are validated and sanitized",
          "rateLimiting": "Built-in rate limiting for package operations"
        },
        "systemRequirements": {
          "dependencies": [
            "apt-get",
            "dpkg",
            "curl"
          ],
          "os": "Linux (Debian-based, Kodachi OS)",
          "privileges": "root/sudo required for package installation"
        },
        "version": "9.0.1",
        "website": "https://www.digi77.com"
      },
      "errors": [],
      "metadata": {
        "executionTime": 0,
        "hostname": "REDACTED-BUILD-HOST",
        "user": "REDACTED-BUILD-USER"
      },
      "status": "success",
      "timestamp": "2026-06-08T16:22:02.141959381Z",
      "version": "9.0.1",
      "warnings": []
    },
    "flag_v": {
      "command": "version",
      "data": {
        "buildDate": "REDACTED-BUILD-TIME",
        "gitCommit": "unknown",
        "name": "deps-checker",
        "rustVersion": "rustc 1.96.0 (ac68faa20 2026-05-25)",
        "version": "9.0.1"
      },
      "errors": [],
      "metadata": {
        "executionTime": 0,
        "hostname": "REDACTED-BUILD-HOST",
        "user": "REDACTED-BUILD-USER"
      },
      "status": "success",
      "timestamp": "2026-06-08T16:22:02.203724489Z",
      "version": "9.0.1",
      "warnings": []
    },
    "flag_h": {
      "command": "help",
      "data": {
        "commandCategories": [
          {
            "category": "Dependency Checking",
            "commands": [
              {
                "description": "Check dependencies for a specific binary",
                "examples": [
                  "deps-checker check dns-switch",
                  "deps-checker check dns-switch --profile minimal",
                  "deps-checker check dns-switch --json",
                  "deps-checker check dns-switch --profile full --json"
                ],
                "name": "check",
                "options": [
                  {
                    "default": "full",
                    "description": "Dependency profile to use (default: full)",
                    "flag": "-p, --profile <NAME>",
                    "required": false
                  },
                  {
                    "description": "Path to external dependency database",
                    "flag": "--db <PATH>",
                    "required": false
                  }
                ],
                "requires_sudo": false,
                "usage": "deps-checker check [OPTIONS] <BINARY>"
              },
              {
                "description": "Check dependencies for all known binaries",
                "examples": [
                  "deps-checker check-all",
                  "deps-checker check-all --json",
                  "deps-checker check-all --sbom --json"
                ],
                "name": "check-all",
                "options": [
                  {
                    "default": "full",
                    "description": "Dependency profile to use (default: full)",
                    "flag": "-p, --profile <NAME>",
                    "required": false
                  },
                  {
                    "description": "Treat warnings as errors",
                    "flag": "--strict",
                    "required": false
                  },
                  {
                    "description": "Generate Software Bill of Materials (SBOM)",
                    "flag": "--sbom",
                    "required": false
                  }
                ],
                "requires_sudo": false,
                "usage": "deps-checker check-all [OPTIONS]"
              }
            ]
          },
          {
            "category": "Package Management",
            "commands": [
              {
                "description": "Install missing dependency packages",
                "examples": [
                  "sudo deps-checker install-missing",
                  "sudo deps-checker install-missing dns-switch",
                  "sudo deps-checker install-missing --dry-run"
                ],
                "name": "install-missing",
                "options": [
                  {
                    "description": "Show what would be installed without executing",
                    "flag": "--dry-run",
                    "required": false
                  }
                ],
                "requires_sudo": true,
                "usage": "sudo deps-checker install-missing [BINARY]"
              },
              {
                "description": "Generate installation script from check results (reads stdin)",
                "examples": [
                  "deps-checker check-all --json | deps-checker generate-script",
                  "deps-checker check-all --json | deps-checker generate-script --shell zsh"
                ],
                "name": "generate-script",
                "options": [
                  {
                    "default": "bash",
                    "description": "Shell syntax to use (bash, zsh, fish)",
                    "flag": "--shell <TYPE>",
                    "required": false
                  }
                ],
                "requires_sudo": false,
                "usage": "deps-checker check-all --json | deps-checker generate-script"
              }
            ]
          },
          {
            "category": "Information",
            "commands": [
              {
                "description": "List all known Kodachi binaries",
                "examples": [
                  "deps-checker list-binaries",
                  "deps-checker list-binaries --json"
                ],
                "name": "list-binaries",
                "options": [],
                "requires_sudo": false,
                "usage": "deps-checker list-binaries"
              },
              {
                "description": "List available dependency profiles for a binary",
                "examples": [
                  "deps-checker list-profiles dns-switch"
                ],
                "name": "list-profiles",
                "options": [],
                "requires_sudo": false,
                "usage": "deps-checker list-profiles <BINARY>"
              }
            ]
          }
        ],
        "description": "Dependency checker for Kodachi OS Rust binaries",
        "environmentVariables": [
          {
            "default": "unset",
            "description": "Enable debug output for dependency checking",
            "name": "DEPS_DEBUG",
            "values": "any non-empty string"
          }
        ],
        "exitCodes": {
          "0": "All dependencies satisfied",
          "1": "Missing dependencies or error"
        },
        "globalOptions": [
          {
            "description": "Output in JSON format",
            "flag": "--json"
          },
          {
            "description": "Output in pretty-printed JSON format",
            "flag": "--json-pretty"
          },
          {
            "description": "Output in human-friendly JSON format with colors",
            "flag": "--json-human"
          },
          {
            "description": "Save JSON output to auto-generated file in results/",
            "flag": "--json-save"
          },
          {
            "description": "Export JSON output to specified file within execution folder",
            "flag": "--json-export <FILE>"
          },
          {
            "description": "Dependency profile (minimal/full, default: full)",
            "flag": "-p, --profile <NAME>"
          },
          {
            "description": "Enable verbose output",
            "flag": "--verbose"
          },
          {
            "description": "Suppress non-essential output",
            "flag": "--quiet"
          },
          {
            "description": "Treat warnings as errors",
            "flag": "--strict"
          },
          {
            "description": "Show what would happen without executing",
            "flag": "--dry-run"
          }
        ],
        "name": "deps-checker",
        "usage": "deps-checker [OPTIONS] [COMMAND] [ARGS]"
      },
      "errors": [],
      "metadata": {
        "executionTime": 0,
        "hostname": "REDACTED-BUILD-HOST",
        "user": "REDACTED-BUILD-USER"
      },
      "status": "success",
      "timestamp": "2026-06-08T16:22:02.266209598Z",
      "version": "9.0.1",
      "warnings": []
    },
    "flag_e": {
      "command": "examples",
      "data": {
        "categories": [
          {
            "description": "Common dependency checking operations",
            "examples": [
              {
                "command": "sudo deps-checker check dns-switch",
                "description": "Dependency status report for dns-switch",
                "expectedOutput": "Shows all required packages and their status",
                "notes": "Shows all required packages and their status"
              },
              {
                "command": "sudo deps-checker check dns-switch --json",
                "description": "JSON formatted dependency report",
                "expectedOutput": "Includes exit codes and machine-readable format",
                "notes": "Includes exit codes and machine-readable format"
              },
              {
                "command": "sudo deps-checker check-all",
                "description": "Summary of all binaries and their dependency status",
                "expectedOutput": "Shows counts and overall system status",
                "notes": "Shows counts and overall system status"
              },
              {
                "command": "sudo deps-checker check-all --json -o report.json",
                "description": "JSON report saved to file",
                "expectedOutput": "Useful for automated processing and CI/CD",
                "notes": "Useful for automated processing and CI/CD"
              },
              {
                "command": "sudo deps-checker install-missing dns-leak",
                "description": "Package installation status",
                "expectedOutput": "Only installs packages needed by dns-leak",
                "notes": "Only installs packages needed by dns-leak"
              }
            ],
            "id": "1_basic",
            "title": "BASIC COMMANDS"
          },
          {
            "description": "Machine-readable JSON output options",
            "examples": [
              {
                "command": "deps-checker check dns-switch --json",
                "description": "Compact JSON output",
                "expectedOutput": "Single-line JSON"
              },
              {
                "command": "deps-checker check dns-switch --json-pretty",
                "description": "Pretty-printed JSON output",
                "expectedOutput": "Indented JSON for readability"
              },
              {
                "command": "deps-checker check dns-switch --json-human",
                "description": "Human-friendly colored JSON output",
                "expectedOutput": "Colored JSON output for terminals"
              },
              {
                "command": "deps-checker check-all --json --json-save",
                "description": "Save JSON output to auto-generated file",
                "expectedOutput": "File saved to results/ directory"
              }
            ],
            "id": "2_json",
            "title": "JSON OUTPUT"
          },
          {
            "description": "Generate installation scripts from check results",
            "examples": [
              {
                "command": "deps-checker check-all --json | deps-checker generate-script",
                "description": "Generate bash installation script",
                "expectedOutput": "Executable bash script"
              },
              {
                "command": "deps-checker check-all --json | deps-checker generate-script --shell zsh",
                "description": "Generate zsh installation script",
                "expectedOutput": "Executable zsh script"
              },
              {
                "command": "deps-checker generate-script --dry-run",
                "description": "Preview script without executing",
                "expectedOutput": "Script preview without changes"
              }
            ],
            "id": "3_script",
            "title": "SCRIPT GENERATION"
          },
          {
            "description": "List known binaries and available dependency profiles",
            "examples": [
              {
                "command": "deps-checker list-binaries",
                "description": "List all known Kodachi binaries",
                "expectedOutput": "Names of every binary deps-checker can check"
              },
              {
                "command": "deps-checker list-binaries --json",
                "description": "List all known Kodachi binaries as JSON",
                "expectedOutput": "Machine-readable array of binary names"
              },
              {
                "command": "deps-checker list-profiles dns-switch",
                "description": "List available dependency profiles for a binary",
                "expectedOutput": "Shows profiles such as minimal and full",
                "notes": "Requires a binary name argument"
              },
              {
                "command": "deps-checker list-profiles dns-switch --json",
                "description": "List dependency profiles for a binary as JSON",
                "expectedOutput": "Machine-readable profiles for the given binary"
              }
            ],
            "id": "4_information",
            "title": "INFORMATION"
          }
        ],
        "description": "Dependency checker for Kodachi OS Rust binaries",
        "name": "deps-checker",
        "quickReference": [
          "deps-checker check <BINARY>         # Check single binary",
          "deps-checker check-all              # Check all binaries",
          "deps-checker install-missing        # Install missing packages",
          "deps-checker list-binaries          # List known binaries",
          "deps-checker generate-script        # Generate install script from stdin"
        ]
      },
      "errors": [],
      "metadata": {
        "executionTime": 0,
        "hostname": "REDACTED-BUILD-HOST",
        "user": "REDACTED-BUILD-USER"
      },
      "status": "success",
      "timestamp": "2026-06-08T16:22:02.382604203Z",
      "version": "9.0.1",
      "warnings": []
    }
  }
}
