{
  "report_info": {
    "version": "9.0.1",
    "generated_at": "2026-08-10T13:22:57Z",
    "binary_name": "kodachi-soc-notifier"
  },
  "binary": {
    "name": "kodachi-soc-notifier",
    "path": "/opt/kodachi/dashboard/hooks/kodachi-soc-notifier",
    "timestamp": "2026-08-10T13:22:57Z",
    "file_info": {
      "size": 1231208,
      "sha256": "4061e507507f63d5261397cca98155cf7ccfdcf5cb507b686d85f3fd200d0552"
    },
    "flag_n": {
      "command": "info",
      "data": {
        "author": "Warith Al Maawali",
        "copyright": "Copyright 2026 Kodachi OS",
        "description": "Bounded local user-session notifier for Kodachi host exposure findings",
        "features": [
          "Dashboard-independent visual delivery for unread warning and critical findings",
          "Fail-visible degraded, untrusted, unsupported, stale, malformed, and unavailable coverage alerts",
          "Strict schema, freshness, size, path-ownership, and subprocess-timeout validation",
          "Bounded delivered-ID memory with retry after temporary session-bus failure",
          "No network client, payload capture, telemetry, approval, or containment actions",
          "Kodachi-standard help, info, version, examples, and JSON output via cli-core"
        ],
        "license": "Proprietary",
        "name": "kodachi-soc-notifier",
        "securityFeatures": {
          "authentication": "Root-owned local kodachi-soc consumer path; no remote authentication",
          "encryption": "Not applicable; local metadata and session-bus delivery only",
          "inputValidation": "Schema, size, freshness, path ownership, and local evidence trust validation",
          "rateLimiting": "One-second bounded polling with critical-first notification burst limits"
        },
        "systemRequirements": {
          "dependencies": [
            "kodachi-soc exposure summary",
            "notify-send",
            "graphical D-Bus notification service"
          ],
          "os": "Kodachi OS/Linux with a graphical systemd user session",
          "privileges": "Unprivileged user session; no root or sudo required"
        },
        "version": "9.8.4",
        "website": "https://www.digi77.com"
      },
      "errors": [],
      "metadata": {
        "executionTime": 0,
        "hostname": "REDACTED-BUILD-HOST",
        "user": "REDACTED-BUILD-USER"
      },
      "status": "success",
      "timestamp": "2026-08-10T13:22:57.047265303Z",
      "version": "9.8.4",
      "warnings": []
    },
    "flag_v": {
      "command": "version",
      "data": {
        "buildDate": "REDACTED-BUILD-TIME",
        "gitCommit": "unknown",
        "name": "kodachi-soc-notifier",
        "rustVersion": "1.82.0",
        "version": "9.8.4"
      },
      "errors": [],
      "metadata": {
        "executionTime": 0,
        "hostname": "REDACTED-BUILD-HOST",
        "user": "REDACTED-BUILD-USER"
      },
      "status": "success",
      "timestamp": "2026-08-10T13:22:57.133854212Z",
      "version": "9.8.4",
      "warnings": []
    },
    "flag_h": {
      "command": "help",
      "data": {
        "commandCategories": [],
        "description": "Bounded local user-session notifier for Kodachi host exposure findings",
        "environmentVariables": [
          {
            "default": "unset",
            "description": "Disable all colored output when set",
            "name": "NO_COLOR",
            "values": "1|true|yes (any value disables color)"
          }
        ],
        "exitCodes": {
          "0": "Success",
          "1": "General error",
          "2": "Invalid arguments",
          "3": "Permission denied",
          "4": "Network error",
          "5": "File not found"
        },
        "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": "Force output format (text|json)",
            "flag": "-o, --output-format <FORMAT>"
          },
          {
            "description": "Pretty-print JSON output with indentation",
            "flag": "--json-pretty"
          },
          {
            "description": "Enhanced JSON output with improved formatting (like jq)",
            "flag": "--json-human"
          }
        ],
        "name": "kodachi-soc-notifier",
        "usage": "kodachi-soc-notifier [OPTIONS] [COMMAND] [ARGS]"
      },
      "errors": [],
      "metadata": {
        "executionTime": 0,
        "hostname": "REDACTED-BUILD-HOST",
        "user": "REDACTED-BUILD-USER"
      },
      "status": "success",
      "timestamp": "2026-08-10T13:22:57.209224372Z",
      "version": "9.8.4",
      "warnings": []
    },
    "flag_e": {
      "command": "examples",
      "data": {
        "categories": [
          {
            "description": "The notifier is an unprivileged graphical-session consumer of the local kodachi-soc exposure summary. It delivers visual warning, critical, degraded, untrusted, and unsupported alerts while the dashboard is closed. It does not inspect traffic, read socket payloads, contact reputation services, acknowledge findings, approve behavior, terminate processes, block endpoints, isolate networking, or alter firewall rules. The watcher remains the sole authority for rule IDs, severity, deduplication, retained evidence, and unread state. The user service is bounded by MemoryHigh=24M, MemoryMax=32M, CPUQuota=5%, OOMScoreAdjust=500, and TasksMax=32.",
            "examples": [
              {
                "command": "kodachi-soc-notifier -h",
                "description": "Show the notifier contract, privacy boundary, and resource cage",
                "expectedOutput": "Kodachi-standard text help generated by cli-core",
                "notes": "The systemd user service normally starts the notifier."
              },
              {
                "command": "kodachi-soc-notifier -n --json",
                "description": "Read machine-readable notifier identity and feature metadata",
                "expectedOutput": "A schema-versioned cli-core information envelope"
              },
              {
                "command": "kodachi-soc-notifier -e --json-pretty",
                "description": "Read the complete notifier example catalog as formatted JSON",
                "expectedOutput": "A cli-core examples envelope with the session-notifier category"
              },
              {
                "command": "kodachi-soc-notifier",
                "description": "Run the foreground notification loop for service-manager use",
                "expectedOutput": "No normal stdout; visual alerts are delivered through the local session bus",
                "notes": "Use the installed systemd user unit for normal operation; Ctrl+C stops a foreground diagnostic run."
              }
            ],
            "id": "1_session_notifier",
            "title": "Session Notifier"
          }
        ],
        "description": "Usage examples for kodachi-soc-notifier",
        "name": "kodachi-soc-notifier",
        "quickReference": [
          "kodachi-soc-notifier -h",
          "kodachi-soc-notifier -e",
          "kodachi-soc-notifier -n --json",
          "kodachi-soc-notifier -v --json"
        ]
      },
      "errors": [],
      "metadata": {
        "executionTime": 0,
        "hostname": "REDACTED-BUILD-HOST",
        "user": "REDACTED-BUILD-USER"
      },
      "status": "success",
      "timestamp": "2026-08-10T13:22:57.376733052Z",
      "version": "9.8.4",
      "warnings": []
    }
  }
}